feat: add image.verticalAlign option to htmlStyle

ios/EnrichedTextInputView.mm

@@ -678,6 +678,14 @@ - (void)updateProps:(Props::Shared const &)props
     }
   }
 
+  if (newViewProps.htmlStyle.image.verticalAlign !=
+      oldViewProps.htmlStyle.image.verticalAlign) {
+    [newConfig setImageVerticalAlign:
+                   [NSString fromCppString:newViewProps.htmlStyle.image
+                                               .verticalAlign]];
+    stylePropChanged = YES;
+  }
+
   if (newViewProps.htmlStyle.a.textDecorationLine !=
       oldViewProps.htmlStyle.a.textDecorationLine) {
     NSString *objcString =
@@ -2320,9 +2328,15 @@ - (CGRect)frameForAttachment:(ImageAttachment *)attachment
     font = [config primaryFont];
   }
 
-  // Calculate (Baseline Alignment)
-  CGFloat targetY =
-      CGRectGetMaxY(lineRect) + font.descender - attachmentSize.height;
+  // Calculate vertical position based on config
+  CGFloat targetY;
+  if ([[config imageVerticalAlign] isEqualToString:@"bottom"]) {
+    targetY = CGRectGetMaxY(lineRect) - attachmentSize.height;
+  } else {
+    // baseline (default): align image bottom with the descender
+    targetY =
+        CGRectGetMaxY(lineRect) + font.descender - attachmentSize.height;
+  }
   CGRect rect =
       CGRectMake(glyphRect.origin.x + textView.textContainerInset.left,
                  targetY + textView.textContainerInset.top,

ios/config/InputConfig.h

@@ -101,4 +101,6 @@
 - (void)setCheckboxListBoxColor:(UIColor *)newValue;
 - (UIImage *)checkboxCheckedImage;
 - (UIImage *)checkboxUncheckedImage;
+- (NSString *)imageVerticalAlign;
+- (void)setImageVerticalAlign:(NSString *)newValue;
 @end

ios/config/InputConfig.mm

@@ -54,6 +54,7 @@ @implementation InputConfig {
   UIColor *_checkboxListBoxColor;
   UIImage *_checkboxCheckedImage;
   UIImage *_checkboxUncheckedImage;
+  NSString *_imageVerticalAlign;
 }
 
 - (instancetype)init {
@@ -115,6 +116,7 @@ - (id)copyWithZone:(NSZone *)zone {
   copy->_checkboxListBoxColor = [_checkboxListBoxColor copy];
   copy->_checkboxCheckedImage = _checkboxCheckedImage;
   copy->_checkboxUncheckedImage = _checkboxUncheckedImage;
+  copy->_imageVerticalAlign = [_imageVerticalAlign copy];
   return copy;
 }
 
@@ -661,4 +663,12 @@ - (UIImage *)generateCheckboxImage:(BOOL)isChecked {
   return result;
 }
 
+- (NSString *)imageVerticalAlign {
+  return _imageVerticalAlign ?: @"baseline";
+}
+
+- (void)setImageVerticalAlign:(NSString *)newValue {
+  _imageVerticalAlign = newValue;
+}
+
 @end

ios/interfaces/ImageAttachment.mm

@@ -1,4 +1,5 @@
 #import "ImageAttachment.h"
+#import "EnrichedTextInputView.h"
 #import "ImageExtension.h"
 
 // NSTextStorage frequently recreates NSTextAttachment objects during attribute
@@ -62,12 +63,24 @@ - (CGRect)attachmentBoundsForTextContainer:(NSTextContainer *)textContainer
     return baseBounds;
   }
 
-  // Extend the layout bounds below the baseline by the font's descender.
-  // Without this, a line containing only the attachment has no descender space
-  // below the baseline, but adding a text character introduces it — causing
-  // the line height to jump.  By reserving descender space upfront the line
-  // height stays consistent regardless of whether text is present.
   CGFloat descender = font.descender;
+
+  // Check vertical alignment config
+  NSString *verticalAlign = @"baseline";
+  if ([self.delegate isKindOfClass:[EnrichedTextInputView class]]) {
+    EnrichedTextInputView *inputView = (EnrichedTextInputView *)self.delegate;
+    verticalAlign = [inputView->config imageVerticalAlign];
+  }
+
+  if ([verticalAlign isEqualToString:@"bottom"]) {
+    // Align glyph to line fragment bottom — no descender offset on y,
+    // but include descender in height so the line fragment is tall enough.
+    return CGRectMake(baseBounds.origin.x, 0, baseBounds.size.width,
+                      baseBounds.size.height);
+  }
+
+  // Default baseline: extend layout bounds below the baseline by the font's
+  // descender so the line height stays consistent.
   return CGRectMake(baseBounds.origin.x, descender, baseBounds.size.width,
                     baseBounds.size.height - descender);
 }

src/spec/EnrichedTextInputNativeComponent.ts

@@ -348,6 +348,9 @@ export interface HtmlStyleInternal {
     marginLeft?: Float;
     boxColor?: ColorValue;
   };
+  image?: {
+    verticalAlign?: string;
+  };
 }
 
 export interface NativeProps extends ViewProps {

src/types.ts

@@ -232,6 +232,9 @@ export interface HtmlStyle {
     marginLeft?: number;
     boxColor?: ColorValue;
   };
+  image?: {
+    verticalAlign?: 'baseline' | 'bottom';
+  };
 }
 
 // Event types

src/utils/normalizeHtmlStyle.ts

@@ -69,6 +69,9 @@ const defaultStyle: Required<HtmlStyle> = {
     marginLeft: 16,
     boxColor: 'blue',
   },
+  image: {
+    verticalAlign: 'baseline',
+  },
 };
 
 const isMentionStyleRecord = (