@hanzogui/image 2.0.0

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@hanzogui/image",
+  "version": "2.0.0",
+  "source": "src/index.ts",
+  "files": [
+    "src",
+    "types",
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": [
+    "*.css"
+  ],
+  "main": "dist/cjs",
+  "module": "dist/esm",
+  "types": "./types/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./types/index.d.ts",
+      "react-native": "./dist/esm/index.native.js",
+      "browser": "./dist/esm/index.mjs",
+      "module": "./dist/esm/index.mjs",
+      "import": "./dist/esm/index.mjs",
+      "require": "./dist/cjs/index.cjs",
+      "default": "./dist/esm/index.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "hanzo-gui-build",
+    "watch": "hanzo-gui-build --watch",
+    "clean": "hanzo-gui-build clean",
+    "clean:build": "hanzo-gui-build clean:build"
+  },
+  "dependencies": {
+    "@hanzogui/constants": "2.0.0-rc.29",
+    "@hanzogui/core": "2.0.0-rc.29",
+    "@hanzogui/web": "2.0.0-rc.29"
+  },
+  "devDependencies": {
+    "@hanzogui/build": "2.0.0-rc.29",
+    "react": ">=19",
+    "react-native": "0.83.2"
+  },
+  "peerDependencies": {
+    "react": ">=19",
+    "react-native": "*"
+  },
+  "module:jsx": "dist/jsx"
+}

package/src/Image.native.tsx

@@ -0,0 +1,6 @@
+import { Image as RNImage } from 'react-native'
+import { createImage } from './createImage'
+
+export const Image = createImage({
+  Component: RNImage,
+})

package/src/Image.tsx

@@ -0,0 +1,41 @@
+import { View, styled } from '@hanzogui/web'
+import type { ImageProps, ImageType } from './types'
+
+const StyledImage = styled(View, {
+  name: 'Image',
+  render: 'img',
+})
+
+export const Image = StyledImage.styleable<ImageProps>(
+  (inProps, ref) => {
+    const {
+      // exclude native only props
+      blurRadius,
+      capInsets,
+      defaultSource,
+      fadeDuration,
+      loadingIndicatorSource,
+      onLoadEnd,
+      onPartialLoad,
+      progressiveRenderingEnabled,
+      resizeMethod,
+      tintColor,
+      ...rest
+    } = inProps
+    return <StyledImage ref={ref} {...rest} />
+  },
+  {
+    staticConfig: {
+      memo: true,
+    },
+  }
+) as unknown as ImageType
+
+const func = (() => {}) as any
+
+Image.getSize = func
+Image.getSizeWithHeaders = func
+Image.prefetch = func
+Image.prefetchWithMetadata = func
+Image.abortPrefetch = func
+Image.queryCache = func

package/src/createImage.tsx

@@ -0,0 +1,236 @@
+import { getTokenValue, styled } from '@hanzogui/web'
+import type { ComponentType } from 'react'
+import type { ImageResizeMode } from 'react-native'
+import type { ImageProps, ImageType } from './types'
+
+type GetProps<T> = T extends ComponentType<infer P> ? P : never
+
+export type CreateImageOptions<C extends ComponentType<any>> = {
+  /**
+   * The underlying image component to use.
+   * Can be React Native Image, expo-image, react-native-fast-image, or any compatible component.
+   */
+  Component: C
+  /**
+   * Map objectFit CSS values to the component's resize mode prop.
+   * Default maps to React Native's resizeMode.
+   */
+  mapObjectFitToResizeMode?: (objectFit: string) => string
+  /**
+   * The prop name used for resize mode.
+   * Default: 'resizeMode' (React Native)
+   * expo-image uses: 'contentFit'
+   */
+  resizeModePropName?: string
+  /**
+   * The prop name used for object position.
+   * Default: undefined (React Native doesn't support it)
+   * expo-image uses: 'contentPosition'
+   */
+  objectPositionPropName?: string
+  /**
+   * Custom source transformation.
+   * Useful for expo-image which has a different source format.
+   */
+  transformSource?: (props: {
+    src?: string | number
+    source?: any
+    width?: any
+    height?: any
+  }) => any
+}
+
+const defaultObjectFitMap = (objectFit: string): ImageResizeMode => {
+  switch (objectFit) {
+    case 'fill':
+      return 'stretch'
+    case 'none':
+      return 'center'
+    case 'scale-down':
+      return 'contain'
+    case 'contain':
+      return 'contain'
+    default:
+      return 'cover'
+  }
+}
+
+const defaultTransformSource = (props: {
+  src?: string | number
+  source?: any
+  width?: any
+  height?: any
+}) => {
+  const { src, source, width, height } = props
+  if (source) return source
+  if (src && typeof src !== 'string') return src
+  return {
+    uri: src,
+    width,
+    height,
+  }
+}
+
+/**
+ * Create a custom Image component with a pluggable underlying implementation.
+ *
+ * @example
+ * Using with expo-image
+ * import { Image as ExpoImage } from 'expo-image'
+ * import { createImage } from '@hanzogui/image'
+ *
+ * export const Image = createImage({
+ *   Component: ExpoImage,
+ *   resizeModePropName: 'contentFit',
+ *   objectPositionPropName: 'contentPosition',
+ * })
+ *
+ * Now you get all expo-image props (transition, placeholder, etc.)
+ * plus Gui's unified API (src, objectFit, objectPosition)
+ * <Image
+ *   src="https://example.com/photo.jpg"
+ *   objectFit="cover"
+ *   transition={300}
+ *   placeholder={blurhash}
+ * />
+ */
+export function createImage<C extends ComponentType<any>>(
+  options: CreateImageOptions<C>
+) {
+  const {
+    Component,
+    mapObjectFitToResizeMode = defaultObjectFitMap,
+    resizeModePropName = 'resizeMode',
+    objectPositionPropName,
+    transformSource = defaultTransformSource,
+  } = options
+
+  // Props that should pass directly to the underlying component without Gui processing
+  const inlinePropsSet = new Set([
+    'source',
+    'placeholder',
+    'transition',
+    'contentFit',
+    'contentPosition',
+    'cachePolicy',
+    'recyclingKey',
+    'allowDownscaling',
+    'autoplay',
+    'blurRadius',
+    'priority',
+    'placeholderContentFit',
+    'responsivePolicy',
+    'onLoadStart',
+    'onProgress',
+    'onLoadEnd',
+  ])
+
+  const StyledImage = styled(
+    Component as ComponentType<any>,
+    {
+      name: 'Image',
+    },
+    {
+      inlineProps: inlinePropsSet,
+    }
+  )
+
+  // Combined props: ImageProps (Gui) + Component's native props
+  type CombinedProps = ImageProps & Omit<GetProps<C>, keyof ImageProps>
+
+  const ImageComponent = StyledImage.styleable<CombinedProps>((incomingProps, ref) => {
+    const props = incomingProps as any
+    const {
+      src,
+      width,
+      height,
+      objectFit,
+      objectPosition,
+      // web only props - filter out on native
+      decoding,
+      elementTiming,
+      fetchpriority,
+      isMap,
+      loading,
+      sizes,
+      useMap,
+      onLoad,
+      onError,
+      ...rest
+    } = props
+
+    const resolvedWidth =
+      typeof width === 'string' && width[0] === '$' ? getTokenValue(width as any) : width
+    const resolvedHeight =
+      typeof height === 'string' && height[0] === '$'
+        ? getTokenValue(height as any)
+        : height
+
+    const finalSource = transformSource({
+      src,
+      width: resolvedWidth,
+      height: resolvedHeight,
+    })
+
+    const incomingStyle = Array.isArray(rest.style)
+      ? Object.assign({}, ...rest.style.flat())
+      : rest.style
+
+    const finalProps: any = {
+      ...rest,
+      source: finalSource,
+      style: {
+        ...incomingStyle,
+        ...(resolvedWidth !== undefined && { width: resolvedWidth }),
+        ...(resolvedHeight !== undefined && { height: resolvedHeight }),
+      },
+    }
+
+    // Set resize mode / content fit
+    if (objectFit) {
+      finalProps[resizeModePropName] = mapObjectFitToResizeMode(objectFit)
+    }
+
+    // Add object position if supported
+    if (objectPositionPropName && objectPosition) {
+      finalProps[objectPositionPropName] = objectPosition
+    }
+
+    // Normalize onLoad event
+    if (onLoad) {
+      finalProps.onLoad = (e: any) => {
+        const source = e?.nativeEvent?.source || e?.source || {}
+        onLoad({
+          target: {
+            naturalHeight: source?.height,
+            naturalWidth: source?.width,
+          },
+          type: 'load',
+        } as any)
+      }
+    }
+
+    // Normalize onError event
+    if (onError) {
+      finalProps.onError = () => {
+        onError({
+          type: 'error',
+        } as any)
+      }
+    }
+
+    // Render the underlying Component directly to ensure all props pass through
+    return <Component ref={ref} {...finalProps} />
+  }) as unknown as ImageType & React.FC<CombinedProps>
+
+  // Add static methods if the component has them
+  const comp = Component as any
+  ImageComponent.getSize = comp.getSize || (() => {})
+  ImageComponent.getSizeWithHeaders = comp.getSizeWithHeaders || (() => {})
+  ImageComponent.prefetch = comp.prefetch || (() => {})
+  ImageComponent.prefetchWithMetadata = comp.prefetchWithMetadata || (() => {})
+  ImageComponent.abortPrefetch = comp.abortPrefetch || (() => {})
+  ImageComponent.queryCache = comp.queryCache || (() => {})
+
+  return ImageComponent
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export * from './Image'
+export * from './createImage'
+export type { ImageProps, ImageType } from './types'

package/src/types.ts

@@ -0,0 +1,54 @@
+import type { ViewProps } from '@hanzogui/web'
+import type {
+  ImageResizeMode,
+  ImageSourcePropType,
+  Image as RNImage,
+  ImageProps as RNImageProps,
+} from 'react-native'
+
+type RNImageType = typeof RNImage
+
+type KeyofViewProps = keyof ViewProps
+
+export type ImageProps = ViewProps &
+  Omit<RNImageProps, KeyofViewProps | 'source' | 'resizeMode' | 'style'> & {
+    /**
+     * The image source URL or require() result.
+     * Preferred over `source` for better web alignment.
+     */
+    src?: string | number
+    /**
+     * @deprecated
+     * use src instead
+     */
+    source?: ImageSourcePropType
+    /**
+     * @deprecated
+     * use objectFit instead
+     */
+    resizeMode?: ImageResizeMode
+    /**
+     * How the image should be resized to fit its container.
+     * Maps to CSS object-fit on web and resizeMode on native.
+     */
+    objectFit?: React.CSSProperties['objectFit']
+    /**
+     * How the image should be positioned within its container.
+     * Maps to CSS object-position on web.
+     * On native, requires expo-image or similar for full support.
+     */
+    objectPosition?: React.CSSProperties['objectPosition']
+  } & Omit<
+    React.ImgHTMLAttributes<HTMLImageElement>,
+    'width' | 'height' | KeyofViewProps | 'src'
+  > &
+  Omit<React.ImgHTMLAttributes<HTMLImageElement>, 'width' | 'height' | 'style' | 'src'>
+
+export type ImageType = React.FC<Partial<ImageProps>> & {
+  getSize: RNImageType['getSize']
+  getSizeWithHeaders: RNImageType['getSizeWithHeaders']
+  prefetch: RNImageType['prefetch']
+  prefetchWithMetadata: RNImageType['prefetchWithMetadata']
+  abortPrefetch: RNImageType['abortPrefetch']
+  queryCache: RNImageType['queryCache']
+}

package/src/v1/Image.tsx

@@ -0,0 +1,144 @@
+import React from 'react'
+import { isWeb } from '@hanzogui/constants'
+import type {
+  GetProps,
+  RadiusTokens,
+  SizeTokens,
+  ViewProps,
+  ThemeValueFallback,
+} from '@hanzogui/web'
+import { styled, usePropsAndStyle } from '@hanzogui/web'
+import type { FC } from 'react'
+import { Image as RNImage } from 'react-native'
+
+const StyledImage = styled(RNImage, {
+  name: 'Image',
+})
+
+type StyledImageProps = Omit<GetProps<typeof StyledImage>, 'borderRadius'> & {
+  borderRadius?: RadiusTokens
+}
+
+type BaseProps = Omit<
+  StyledImageProps,
+  'width' | 'height' | 'style' | 'onLayout' | 'resizeMode'
+> & {
+  width?: string | number | SizeTokens | ThemeValueFallback
+  height?: string | number | SizeTokens | ThemeValueFallback
+
+  /**
+   * @deprecated use `source` instead to disambiguate width/height style from width/height of the actual image
+   */
+  src?: string | StyledImageProps['source']
+  /** @deprecated use objectFit instead */
+  resizeMode?: StyledImageProps['resizeMode']
+  objectFit?: React.CSSProperties['objectFit']
+}
+
+export type ImageProps = BaseProps & Omit<ViewProps, keyof BaseProps>
+
+type RNImageType = typeof RNImage
+
+type ImageType = FC<ImageProps> & {
+  getSize: RNImageType['getSize']
+  getSizeWithHeaders: RNImageType['getSizeWithHeaders']
+  prefetch: RNImageType['prefetch']
+  prefetchWithMetadata: RNImageType['prefetchWithMetadata']
+  abortPrefetch: RNImageType['abortPrefetch']
+  queryCache: RNImageType['queryCache']
+}
+
+let hasWarned = false
+
+/**
+ * @summary An image is a component that displays an image.
+ * @see — Docs https://gui.dev/ui/image
+ */
+export const Image = StyledImage.styleable<ImageProps>((inProps, ref) => {
+  const [props, style] = usePropsAndStyle(inProps)
+  const { src, source, objectFit, ...rest } = props
+
+  if (process.env.NODE_ENV === 'development') {
+    if (typeof src === 'string') {
+      if (
+        (typeof props.width === 'string' && props.width[0] !== '$') ||
+        (typeof props.height === 'string' && props.height[0] !== '$')
+      ) {
+        if (!hasWarned) {
+          hasWarned = true
+          console.warn(
+            `React Native expects a numerical width/height. If you want to use a percent you must define the "source" prop with width, height, and uri.`
+          )
+        }
+      }
+    }
+  }
+
+  let finalSource =
+    typeof src === 'string'
+      ? {
+          uri: src,
+          ...(isWeb && {
+            width: props.width || style?.width,
+            height: props.height || style?.height,
+          }),
+        }
+      : (source ?? src)
+
+  if (finalSource && typeof finalSource === 'object') {
+    if (process.env.HANZO_GUI_TARGET === 'native') {
+      // fix: normalize import style images
+      if (!Array.isArray(finalSource)) {
+        if (typeof finalSource.uri === 'number') {
+          finalSource = finalSource.uri
+          if (source && typeof source === 'object' && !Array.isArray(source)) {
+            // @ts-ignore
+            style.width ??= source.width
+            // @ts-ignore
+            style.height ??= source.height
+          }
+        }
+      }
+    }
+
+    if (process.env.NODE_ENV === 'development' && process.env.HANZO_GUI_IMAGE_CHECK_ERROR) {
+      // lets add an onload timeout and warning if it fails to load in console
+      React.useEffect(() => {
+        async function run() {
+          if (typeof src === 'string') {
+            try {
+              await fetch(src).then((res) => res.text())
+            } catch (err) {
+              console.error(`Error loading image: ${src}`, { props })
+            }
+          }
+        }
+
+        run()
+      }, [src])
+    }
+
+    // require compat across native/web
+    if (finalSource['default']) {
+      finalSource = finalSource['default']
+    }
+  }
+
+  // must set defaultSource to allow SSR, default it to the same as src
+  return (
+    <RNImage
+      resizeMode={objectFit}
+      ref={ref}
+      source={finalSource}
+      style={style}
+      {...(rest as any)}
+    />
+  )
+}) as any as ImageType
+
+Image.getSize = RNImage.getSize
+Image.getSizeWithHeaders = RNImage.getSizeWithHeaders
+Image.prefetch = RNImage.prefetch
+Image.prefetchWithMetadata = RNImage.prefetchWithMetadata
+Image.abortPrefetch = RNImage.abortPrefetch
+Image.queryCache = RNImage.queryCache

package/src/v1/index.ts

@@ -0,0 +1 @@
+export * from './Image'

package/types/Image.d.ts

@@ -0,0 +1,3 @@
+import type { ImageType } from './types';
+export declare const Image: ImageType;
+//# sourceMappingURL=Image.d.ts.map

package/types/Image.native.d.ts

@@ -0,0 +1,16 @@
+import { Image as RNImage } from 'react-native';
+export declare const Image: import("react").FC<Partial<import("./types").ImageProps>> & {
+    getSize: typeof RNImage.getSize;
+    getSizeWithHeaders: typeof RNImage.getSizeWithHeaders;
+    prefetch: typeof RNImage.prefetch;
+    prefetchWithMetadata: typeof RNImage.prefetchWithMetadata;
+    abortPrefetch: typeof RNImage.abortPrefetch | undefined;
+    queryCache: typeof RNImage.queryCache | undefined;
+} & import("react").FC<import("@gui/web").StackNonStyleProps & import("@gui/web").WithThemeValues<import("@gui/web").StackStyleBase> & import("@gui/web").WithShorthands<import("@gui/web").WithThemeValues<import("@gui/web").StackStyleBase>> & import("@gui/web").WithPseudoProps<import("@gui/web").WithThemeValues<import("@gui/web").StackStyleBase> & import("@gui/web").WithShorthands<import("@gui/web").WithThemeValues<import("@gui/web").StackStyleBase>>> & import("@gui/web").WithMediaProps<import("@gui/web").WithThemeShorthandsAndPseudos<import("@gui/web").StackStyleBase, {}>> & Omit<import("react-native").ImageProps, `$${string}` | `$${number}` | import("@gui/web").GroupMediaKeys | `$theme-${string}` | `$theme-${number}` | keyof import("@gui/web").StackStyleBase | keyof import("@gui/web").StackNonStyleProps | keyof import("@gui/web").WithPseudoProps<import("@gui/web").WithThemeValues<import("@gui/web").StackStyleBase> & import("@gui/web").WithShorthands<import("@gui/web").WithThemeValues<import("@gui/web").StackStyleBase>>> | "source" | "resizeMode"> & {
+    src?: string | number;
+    source?: import("react-native").ImageSourcePropType;
+    resizeMode?: import("react-native").ImageResizeMode;
+    objectFit?: React.CSSProperties["objectFit"];
+    objectPosition?: React.CSSProperties["objectPosition"];
+} & Omit<import("react").ImgHTMLAttributes<HTMLImageElement>, `$${string}` | `$${number}` | import("@gui/web").GroupMediaKeys | `$theme-${string}` | `$theme-${number}` | keyof import("@gui/web").StackStyleBase | keyof import("@gui/web").StackNonStyleProps | keyof import("@gui/web").WithPseudoProps<import("@gui/web").WithThemeValues<import("@gui/web").StackStyleBase> & import("@gui/web").WithShorthands<import("@gui/web").WithThemeValues<import("@gui/web").StackStyleBase>>> | "src"> & Omit<import("react").ImgHTMLAttributes<HTMLImageElement>, "style" | "height" | "width" | "src"> & Omit<import("react-native").ImageProps, `$${string}` | `$${number}` | import("@gui/web").GroupMediaKeys | `$theme-${string}` | `$theme-${number}` | "onLayout" | "rel" | "dir" | keyof import("@gui/web").StackStyleBase | keyof import("@gui/web").StackNonStyleProps | keyof import("@gui/web").WithPseudoProps<import("@gui/web").WithThemeValues<import("@gui/web").StackStyleBase> & import("@gui/web").WithShorthands<import("@gui/web").WithThemeValues<import("@gui/web").StackStyleBase>>> | "source" | "resizeMode" | "onError" | "onLoad" | "onLoadEnd" | "onLoadStart" | "progressiveRenderingEnabled" | "src" | "srcSet" | "loadingIndicatorSource" | "defaultSource" | "alt" | "crossOrigin" | "tintColor" | "referrerPolicy" | "blurRadius" | "capInsets" | "onProgress" | "onPartialLoad" | "resizeMethod" | "fadeDuration" | "objectPosition" | "decoding" | "fetchPriority" | "loading" | "sizes" | "useMap" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "autoCapitalize" | "autoFocus" | "contentEditable" | "contextMenu" | "draggable" | "enterKeyHint" | "hidden" | "lang" | "nonce" | "slot" | "spellCheck" | "title" | "translate" | "radioGroup" | "about" | "datatype" | "inlist" | "prefix" | "property" | "resource" | "rev" | "typeof" | "vocab" | "autoCorrect" | "autoSave" | "color" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "popover" | "popoverTargetAction" | "popoverTarget" | "inert" | "inputMode" | "is" | "exportparts" | "part" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-braillelabel" | "aria-brailleroledescription" | "aria-colcount" | "aria-colindex" | "aria-colindextext" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-description" | "aria-details" | "aria-dropeffect" | "aria-errormessage" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-invalid" | "aria-keyshortcuts" | "aria-level" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowindextext" | "aria-rowspan" | "aria-setsize" | "aria-sort" | "onCopyCapture" | "onCutCapture" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocusCapture" | "onBlurCapture" | "onChangeCapture" | "onBeforeInputCapture" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoadCapture" | "onErrorCapture" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClickCapture" | "onContextMenuCapture" | "onDoubleClickCapture" | "onDragCapture" | "onDragEndCapture" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeaveCapture" | "onDragOverCapture" | "onDragStartCapture" | "onDropCapture" | "onMouseDownCapture" | "onMouseMoveCapture" | "onMouseOutCapture" | "onMouseOverCapture" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancelCapture" | "onTouchMoveCapture" | "onTouchStartCapture" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScrollCapture" | "onScrollEnd" | "onScrollEndCapture" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onToggle" | "onBeforeToggle" | "onTransitionCancel" | "onTransitionCancelCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "onTransitionRun" | "onTransitionRunCapture" | "onTransitionStart" | "onTransitionStartCapture">>;
+//# sourceMappingURL=Image.native.d.ts.map

package/types/createImage.d.ts

@@ -0,0 +1,77 @@
+import type { ComponentType } from 'react';
+import type { ImageResizeMode } from 'react-native';
+import type { ImageProps } from './types';
+type GetProps<T> = T extends ComponentType<infer P> ? P : never;
+export type CreateImageOptions<C extends ComponentType<any>> = {
+    /**
+     * The underlying image component to use.
+     * Can be React Native Image, expo-image, react-native-fast-image, or any compatible component.
+     */
+    Component: C;
+    /**
+     * Map objectFit CSS values to the component's resize mode prop.
+     * Default maps to React Native's resizeMode.
+     */
+    mapObjectFitToResizeMode?: (objectFit: string) => string;
+    /**
+     * The prop name used for resize mode.
+     * Default: 'resizeMode' (React Native)
+     * expo-image uses: 'contentFit'
+     */
+    resizeModePropName?: string;
+    /**
+     * The prop name used for object position.
+     * Default: undefined (React Native doesn't support it)
+     * expo-image uses: 'contentPosition'
+     */
+    objectPositionPropName?: string;
+    /**
+     * Custom source transformation.
+     * Useful for expo-image which has a different source format.
+     */
+    transformSource?: (props: {
+        src?: string | number;
+        source?: any;
+        width?: any;
+        height?: any;
+    }) => any;
+};
+/**
+ * Create a custom Image component with a pluggable underlying implementation.
+ *
+ * @example
+ * Using with expo-image
+ * import { Image as ExpoImage } from 'expo-image'
+ * import { createImage } from '@gui/image'
+ *
+ * export const Image = createImage({
+ *   Component: ExpoImage,
+ *   resizeModePropName: 'contentFit',
+ *   objectPositionPropName: 'contentPosition',
+ * })
+ *
+ * Now you get all expo-image props (transition, placeholder, etc.)
+ * plus Gui's unified API (src, objectFit, objectPosition)
+ * <Image
+ *   src="https://example.com/photo.jpg"
+ *   objectFit="cover"
+ *   transition={300}
+ *   placeholder={blurhash}
+ * />
+ */
+export declare function createImage<C extends ComponentType<any>>(options: CreateImageOptions<C>): import("react").FC<Partial<ImageProps>> & {
+    getSize: typeof import("react-native").Image.getSize;
+    getSizeWithHeaders: typeof import("react-native").Image.getSizeWithHeaders;
+    prefetch: typeof import("react-native").Image.prefetch;
+    prefetchWithMetadata: typeof import("react-native").Image.prefetchWithMetadata;
+    abortPrefetch: typeof import("react-native").Image.abortPrefetch | undefined;
+    queryCache: typeof import("react-native").Image.queryCache | undefined;
+} & import("react").FC<import("@gui/web").StackNonStyleProps & import("@gui/web").WithThemeValues<import("@gui/web").StackStyleBase> & import("@gui/web").WithShorthands<import("@gui/web").WithThemeValues<import("@gui/web").StackStyleBase>> & import("@gui/web").WithPseudoProps<import("@gui/web").WithThemeValues<import("@gui/web").StackStyleBase> & import("@gui/web").WithShorthands<import("@gui/web").WithThemeValues<import("@gui/web").StackStyleBase>>> & import("@gui/web").WithMediaProps<import("@gui/web").WithThemeShorthandsAndPseudos<import("@gui/web").StackStyleBase, {}>> & Omit<import("react-native").ImageProps, `$${string}` | `$${number}` | import("@gui/web").GroupMediaKeys | `$theme-${string}` | `$theme-${number}` | keyof import("@gui/web").StackStyleBase | keyof import("@gui/web").StackNonStyleProps | keyof import("@gui/web").WithPseudoProps<import("@gui/web").WithThemeValues<import("@gui/web").StackStyleBase> & import("@gui/web").WithShorthands<import("@gui/web").WithThemeValues<import("@gui/web").StackStyleBase>>> | "source" | "resizeMode"> & {
+    src?: string | number;
+    source?: import("react-native").ImageSourcePropType;
+    resizeMode?: ImageResizeMode;
+    objectFit?: React.CSSProperties["objectFit"];
+    objectPosition?: React.CSSProperties["objectPosition"];
+} & Omit<import("react").ImgHTMLAttributes<HTMLImageElement>, `$${string}` | `$${number}` | import("@gui/web").GroupMediaKeys | `$theme-${string}` | `$theme-${number}` | keyof import("@gui/web").StackStyleBase | keyof import("@gui/web").StackNonStyleProps | keyof import("@gui/web").WithPseudoProps<import("@gui/web").WithThemeValues<import("@gui/web").StackStyleBase> & import("@gui/web").WithShorthands<import("@gui/web").WithThemeValues<import("@gui/web").StackStyleBase>>> | "src"> & Omit<import("react").ImgHTMLAttributes<HTMLImageElement>, "style" | "height" | "width" | "src"> & Omit<GetProps<C>, `$${string}` | `$${number}` | import("@gui/web").GroupMediaKeys | `$theme-${string}` | `$theme-${number}` | "onLayout" | "rel" | "dir" | keyof import("@gui/web").StackStyleBase | keyof import("@gui/web").StackNonStyleProps | keyof import("@gui/web").WithPseudoProps<import("@gui/web").WithThemeValues<import("@gui/web").StackStyleBase> & import("@gui/web").WithShorthands<import("@gui/web").WithThemeValues<import("@gui/web").StackStyleBase>>> | "source" | "resizeMode" | "onError" | "onLoad" | "onLoadEnd" | "onLoadStart" | "progressiveRenderingEnabled" | "src" | "srcSet" | "loadingIndicatorSource" | "defaultSource" | "alt" | "crossOrigin" | "tintColor" | "referrerPolicy" | "blurRadius" | "capInsets" | "onProgress" | "onPartialLoad" | "resizeMethod" | "fadeDuration" | "objectPosition" | "decoding" | "fetchPriority" | "loading" | "sizes" | "useMap" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "autoCapitalize" | "autoFocus" | "contentEditable" | "contextMenu" | "draggable" | "enterKeyHint" | "hidden" | "lang" | "nonce" | "slot" | "spellCheck" | "title" | "translate" | "radioGroup" | "about" | "datatype" | "inlist" | "prefix" | "property" | "resource" | "rev" | "typeof" | "vocab" | "autoCorrect" | "autoSave" | "color" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "popover" | "popoverTargetAction" | "popoverTarget" | "inert" | "inputMode" | "is" | "exportparts" | "part" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-braillelabel" | "aria-brailleroledescription" | "aria-colcount" | "aria-colindex" | "aria-colindextext" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-description" | "aria-details" | "aria-dropeffect" | "aria-errormessage" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-invalid" | "aria-keyshortcuts" | "aria-level" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowindextext" | "aria-rowspan" | "aria-setsize" | "aria-sort" | "onCopyCapture" | "onCutCapture" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocusCapture" | "onBlurCapture" | "onChangeCapture" | "onBeforeInputCapture" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoadCapture" | "onErrorCapture" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClickCapture" | "onContextMenuCapture" | "onDoubleClickCapture" | "onDragCapture" | "onDragEndCapture" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeaveCapture" | "onDragOverCapture" | "onDragStartCapture" | "onDropCapture" | "onMouseDownCapture" | "onMouseMoveCapture" | "onMouseOutCapture" | "onMouseOverCapture" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancelCapture" | "onTouchMoveCapture" | "onTouchStartCapture" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScrollCapture" | "onScrollEnd" | "onScrollEndCapture" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onToggle" | "onBeforeToggle" | "onTransitionCancel" | "onTransitionCancelCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "onTransitionRun" | "onTransitionRunCapture" | "onTransitionStart" | "onTransitionStartCapture">>;
+export {};
+//# sourceMappingURL=createImage.d.ts.map