@ankhorage/zora 1.0.10 → 1.1.0

package/dist/patterns/image-upload-field/ImageUploadField.js

@@ -0,0 +1,211 @@
+import React from 'react';
+import { Button } from '../../components/button';
+import { Modal } from '../../components/modal';
+import { Progress } from '../../components/progress';
+import { Text } from '../../components/text';
+import { Box, Stack } from '../../foundation';
+import { withZoraThemeScope } from '../../theme/withZoraThemeScope';
+import { FormField } from '../form-field';
+import { ImagePreview } from '../image-preview';
+import { createOptimisticAssetFromPicked, formatAcceptHint, formatMaxSizeHint, resolveRenderableUrl, validatePickedImage, } from './uploadFlow';
+function clampProgress(value) {
+    if (value === null)
+        return null;
+    if (!Number.isFinite(value))
+        return null;
+    return Math.max(0, Math.min(1, value));
+}
+function formatUnknownError(error) {
+    if (error instanceof Error && error.message)
+        return error.message;
+    if (typeof error === 'string' && error.trim().length > 0)
+        return error;
+    return 'Something went wrong.';
+}
+function ImageUploadFieldInner({ themeId: _themeId, mode: _mode, testID, value, onChange, label, description, helperText, errorText, required, disabled = false, readOnly = false, accept, maxSizeBytes, validatePicked, onPick, onUpload, onRemove, aspectRatio = 1, previewTitle = 'Image preview', previewDescription, }) {
+    const [internalError, setInternalError] = React.useState(undefined);
+    const [uploading, setUploading] = React.useState(false);
+    const [removing, setRemoving] = React.useState(false);
+    const [progress, setProgress] = React.useState(null);
+    const [previewOpen, setPreviewOpen] = React.useState(false);
+    const isMountedRef = React.useRef(true);
+    React.useEffect(() => {
+        return () => {
+            isMountedRef.current = false;
+        };
+    }, []);
+    const renderableUrl = resolveRenderableUrl(value);
+    const isRenderable = renderableUrl !== null;
+    const actionsDisabled = disabled || readOnly;
+    const effectiveError = errorText ?? internalError;
+    const invalid = Boolean(effectiveError);
+    const acceptHint = formatAcceptHint(accept);
+    const maxSizeHint = formatMaxSizeHint(maxSizeBytes);
+    const setProgressSafe = React.useCallback((next) => {
+        if (!isMountedRef.current)
+            return;
+        setProgress(clampProgress(next));
+    }, []);
+    const clearTransientState = React.useCallback(() => {
+        if (!isMountedRef.current)
+            return;
+        setUploading(false);
+        setRemoving(false);
+        setProgress(null);
+    }, []);
+    const handleReplace = React.useCallback(async () => {
+        if (actionsDisabled || uploading || removing)
+            return;
+        setInternalError(undefined);
+        let picked;
+        try {
+            picked = await onPick();
+        }
+        catch (error) {
+            if (!isMountedRef.current)
+                return;
+            setInternalError(formatUnknownError(error));
+            return;
+        }
+        if (!picked)
+            return;
+        const validationError = validatePickedImage({
+            picked,
+            accept,
+            maxSizeBytes,
+            validatePicked,
+        });
+        if (validationError) {
+            setInternalError(validationError);
+            return;
+        }
+        if (!onUpload) {
+            onChange(createOptimisticAssetFromPicked(picked));
+            return;
+        }
+        const optimisticAsset = createOptimisticAssetFromPicked(picked);
+        onChange(optimisticAsset);
+        setUploading(true);
+        setProgressSafe(0);
+        try {
+            const uploaded = await onUpload(picked, { setProgress: setProgressSafe });
+            if (!isMountedRef.current)
+                return;
+            onChange(uploaded);
+            setInternalError(undefined);
+            clearTransientState();
+        }
+        catch (error) {
+            if (!isMountedRef.current)
+                return;
+            setInternalError(formatUnknownError(error));
+            setUploading(false);
+            setProgress(null);
+        }
+    }, [
+        accept,
+        actionsDisabled,
+        clearTransientState,
+        maxSizeBytes,
+        onChange,
+        onPick,
+        onUpload,
+        removing,
+        setProgressSafe,
+        uploading,
+        validatePicked,
+    ]);
+    const handleRemove = React.useCallback(async () => {
+        if (actionsDisabled || uploading || removing)
+            return;
+        if (!value) {
+            onChange(null);
+            return;
+        }
+        setInternalError(undefined);
+        if (!onRemove) {
+            onChange(null);
+            return;
+        }
+        setRemoving(true);
+        try {
+            await onRemove(value);
+            if (!isMountedRef.current)
+                return;
+            onChange(null);
+            setRemoving(false);
+        }
+        catch (error) {
+            if (!isMountedRef.current)
+                return;
+            setInternalError(formatUnknownError(error));
+            setRemoving(false);
+        }
+    }, [actionsDisabled, onChange, onRemove, removing, uploading, value]);
+    const handlePreview = React.useCallback(() => {
+        if (!isRenderable)
+            return;
+        setPreviewOpen(true);
+    }, [isRenderable]);
+    const closePreview = React.useCallback(() => setPreviewOpen(false), []);
+    return (<>
+      <FormField description={description} disabled={disabled} errorText={effectiveError} helperText={helperText} invalid={invalid} label={label} readOnly={readOnly} required={required} testID={testID}>
+        <Stack gap="m">
+          <ImagePreview aspectRatio={aspectRatio} asset={value} emptyDescription={actionsDisabled ? 'No image available.' : undefined}/>
+
+          {acceptHint || maxSizeHint ? (<Stack gap="xs">
+              {acceptHint ? (<Text tone="muted" variant="caption">
+                  {acceptHint}
+                </Text>) : null}
+              {maxSizeHint ? (<Text tone="muted" variant="caption">
+                  {maxSizeHint}
+                </Text>) : null}
+            </Stack>) : null}
+
+          {uploading ? (<Stack gap="xs">
+              <Text tone="muted" variant="caption">
+                Uploading…
+              </Text>
+              {progress !== null ? <Progress max={1} value={progress}/> : null}
+            </Stack>) : null}
+
+          <Stack direction={{ base: 'column', md: 'row' }} gap="s">
+            <Button disabled={actionsDisabled || uploading || removing} onPress={() => {
+            void handleReplace();
+        }}>
+              {value ? 'Replace image' : 'Select image'}
+            </Button>
+
+            {value ? (<Button disabled={actionsDisabled || uploading || removing} emphasis="outline" loading={removing} tone="danger" onPress={() => {
+                void handleRemove();
+            }}>
+                Remove
+              </Button>) : null}
+
+            {isRenderable ? (<Button disabled={false} emphasis="soft" tone="neutral" onPress={handlePreview}>
+                Preview
+              </Button>) : null}
+          </Stack>
+
+          {!isRenderable && value?.kind === 'storage' && value.publicUrl === undefined ? (<Box>
+              <Text tone="muted" variant="caption">
+                This image is stored, but no preview URL is available yet.
+              </Text>
+            </Box>) : null}
+        </Stack>
+      </FormField>
+
+      {isRenderable ? (<Modal closeOnBackdrop description={previewDescription} title={previewTitle} visible={previewOpen} onDismiss={closePreview}>
+          <Stack gap="m">
+            <ImagePreview asset={value} aspectRatio={aspectRatio}/>
+            <Stack direction="row" justify="flex-end">
+              <Button emphasis="soft" tone="neutral" onPress={closePreview}>
+                Close
+              </Button>
+            </Stack>
+          </Stack>
+        </Modal>) : null}
+    </>);
+}
+export const ImageUploadField = withZoraThemeScope(ImageUploadFieldInner);
+//# sourceMappingURL=ImageUploadField.js.map

package/dist/patterns/image-upload-field/ImageUploadField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageUploadField.js","sourceRoot":"","sources":["../../../src/patterns/image-upload-field/ImageUploadField.tsx"],"names":[],"mappings":"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","sourcesContent":["import React from 'react';\n\nimport { Button } from '../../components/button';\nimport { Modal } from '../../components/modal';\nimport { Progress } from '../../components/progress';\nimport { Text } from '../../components/text';\nimport { Box, Stack } from '../../foundation';\nimport { withZoraThemeScope } from '../../theme/withZoraThemeScope';\nimport { FormField } from '../form-field';\nimport { ImagePreview } from '../image-preview';\nimport type { ImageUploadFieldProps } from './types';\nimport {\n  createOptimisticAssetFromPicked,\n  formatAcceptHint,\n  formatMaxSizeHint,\n  resolveRenderableUrl,\n  validatePickedImage,\n} from './uploadFlow';\n\nfunction clampProgress(value: number | null): number | null {\n  if (value === null) return null;\n  if (!Number.isFinite(value)) return null;\n  return Math.max(0, Math.min(1, value));\n}\n\nfunction formatUnknownError(error: unknown): string {\n  if (error instanceof Error && error.message) return error.message;\n  if (typeof error === 'string' && error.trim().length > 0) return error;\n  return 'Something went wrong.';\n}\n\nfunction ImageUploadFieldInner({\n  themeId: _themeId,\n  mode: _mode,\n  testID,\n  value,\n  onChange,\n  label,\n  description,\n  helperText,\n  errorText,\n  required,\n  disabled = false,\n  readOnly = false,\n  accept,\n  maxSizeBytes,\n  validatePicked,\n  onPick,\n  onUpload,\n  onRemove,\n  aspectRatio = 1,\n  previewTitle = 'Image preview',\n  previewDescription,\n}: ImageUploadFieldProps) {\n  const [internalError, setInternalError] = React.useState<string | undefined>(undefined);\n  const [uploading, setUploading] = React.useState(false);\n  const [removing, setRemoving] = React.useState(false);\n  const [progress, setProgress] = React.useState<number | null>(null);\n  const [previewOpen, setPreviewOpen] = React.useState(false);\n  const isMountedRef = React.useRef(true);\n\n  React.useEffect(() => {\n    return () => {\n      isMountedRef.current = false;\n    };\n  }, []);\n\n  const renderableUrl = resolveRenderableUrl(value);\n  const isRenderable = renderableUrl !== null;\n  const actionsDisabled = disabled || readOnly;\n\n  const effectiveError = errorText ?? internalError;\n  const invalid = Boolean(effectiveError);\n\n  const acceptHint = formatAcceptHint(accept);\n  const maxSizeHint = formatMaxSizeHint(maxSizeBytes);\n\n  const setProgressSafe = React.useCallback((next: number | null) => {\n    if (!isMountedRef.current) return;\n    setProgress(clampProgress(next));\n  }, []);\n\n  const clearTransientState = React.useCallback(() => {\n    if (!isMountedRef.current) return;\n    setUploading(false);\n    setRemoving(false);\n    setProgress(null);\n  }, []);\n\n  const handleReplace = React.useCallback(async () => {\n    if (actionsDisabled || uploading || removing) return;\n\n    setInternalError(undefined);\n    let picked;\n    try {\n      picked = await onPick();\n    } catch (error) {\n      if (!isMountedRef.current) return;\n      setInternalError(formatUnknownError(error));\n      return;\n    }\n    if (!picked) return;\n\n    const validationError = validatePickedImage({\n      picked,\n      accept,\n      maxSizeBytes,\n      validatePicked,\n    });\n\n    if (validationError) {\n      setInternalError(validationError);\n      return;\n    }\n\n    if (!onUpload) {\n      onChange(createOptimisticAssetFromPicked(picked));\n      return;\n    }\n\n    const optimisticAsset = createOptimisticAssetFromPicked(picked);\n    onChange(optimisticAsset);\n    setUploading(true);\n    setProgressSafe(0);\n\n    try {\n      const uploaded = await onUpload(picked, { setProgress: setProgressSafe });\n      if (!isMountedRef.current) return;\n      onChange(uploaded);\n      setInternalError(undefined);\n      clearTransientState();\n    } catch (error) {\n      if (!isMountedRef.current) return;\n      setInternalError(formatUnknownError(error));\n      setUploading(false);\n      setProgress(null);\n    }\n  }, [\n    accept,\n    actionsDisabled,\n    clearTransientState,\n    maxSizeBytes,\n    onChange,\n    onPick,\n    onUpload,\n    removing,\n    setProgressSafe,\n    uploading,\n    validatePicked,\n  ]);\n\n  const handleRemove = React.useCallback(async () => {\n    if (actionsDisabled || uploading || removing) return;\n    if (!value) {\n      onChange(null);\n      return;\n    }\n\n    setInternalError(undefined);\n\n    if (!onRemove) {\n      onChange(null);\n      return;\n    }\n\n    setRemoving(true);\n    try {\n      await onRemove(value);\n      if (!isMountedRef.current) return;\n      onChange(null);\n      setRemoving(false);\n    } catch (error) {\n      if (!isMountedRef.current) return;\n      setInternalError(formatUnknownError(error));\n      setRemoving(false);\n    }\n  }, [actionsDisabled, onChange, onRemove, removing, uploading, value]);\n\n  const handlePreview = React.useCallback(() => {\n    if (!isRenderable) return;\n    setPreviewOpen(true);\n  }, [isRenderable]);\n\n  const closePreview = React.useCallback(() => setPreviewOpen(false), []);\n\n  return (\n    <>\n      <FormField\n        description={description}\n        disabled={disabled}\n        errorText={effectiveError}\n        helperText={helperText}\n        invalid={invalid}\n        label={label}\n        readOnly={readOnly}\n        required={required}\n        testID={testID}\n      >\n        <Stack gap=\"m\">\n          <ImagePreview\n            aspectRatio={aspectRatio}\n            asset={value}\n            emptyDescription={actionsDisabled ? 'No image available.' : undefined}\n          />\n\n          {acceptHint || maxSizeHint ? (\n            <Stack gap=\"xs\">\n              {acceptHint ? (\n                <Text tone=\"muted\" variant=\"caption\">\n                  {acceptHint}\n                </Text>\n              ) : null}\n              {maxSizeHint ? (\n                <Text tone=\"muted\" variant=\"caption\">\n                  {maxSizeHint}\n                </Text>\n              ) : null}\n            </Stack>\n          ) : null}\n\n          {uploading ? (\n            <Stack gap=\"xs\">\n              <Text tone=\"muted\" variant=\"caption\">\n                Uploading…\n              </Text>\n              {progress !== null ? <Progress max={1} value={progress} /> : null}\n            </Stack>\n          ) : null}\n\n          <Stack direction={{ base: 'column', md: 'row' }} gap=\"s\">\n            <Button\n              disabled={actionsDisabled || uploading || removing}\n              onPress={() => {\n                void handleReplace();\n              }}\n            >\n              {value ? 'Replace image' : 'Select image'}\n            </Button>\n\n            {value ? (\n              <Button\n                disabled={actionsDisabled || uploading || removing}\n                emphasis=\"outline\"\n                loading={removing}\n                tone=\"danger\"\n                onPress={() => {\n                  void handleRemove();\n                }}\n              >\n                Remove\n              </Button>\n            ) : null}\n\n            {isRenderable ? (\n              <Button disabled={false} emphasis=\"soft\" tone=\"neutral\" onPress={handlePreview}>\n                Preview\n              </Button>\n            ) : null}\n          </Stack>\n\n          {!isRenderable && value?.kind === 'storage' && value.publicUrl === undefined ? (\n            <Box>\n              <Text tone=\"muted\" variant=\"caption\">\n                This image is stored, but no preview URL is available yet.\n              </Text>\n            </Box>\n          ) : null}\n        </Stack>\n      </FormField>\n\n      {isRenderable ? (\n        <Modal\n          closeOnBackdrop\n          description={previewDescription}\n          title={previewTitle}\n          visible={previewOpen}\n          onDismiss={closePreview}\n        >\n          <Stack gap=\"m\">\n            <ImagePreview asset={value} aspectRatio={aspectRatio} />\n            <Stack direction=\"row\" justify=\"flex-end\">\n              <Button emphasis=\"soft\" tone=\"neutral\" onPress={closePreview}>\n                Close\n              </Button>\n            </Stack>\n          </Stack>\n        </Modal>\n      ) : null}\n    </>\n  );\n}\n\nexport const ImageUploadField = withZoraThemeScope(ImageUploadFieldInner);\n"]}

package/dist/patterns/image-upload-field/index.d.ts

@@ -0,0 +1,3 @@
+export { ImageUploadField } from './ImageUploadField';
+export type { ImageUploadFieldProps, ImageUploadProgressContext, ZoraPickedImage } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/patterns/image-upload-field/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/patterns/image-upload-field/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC"}

package/dist/patterns/image-upload-field/index.js

@@ -0,0 +1,2 @@
+export { ImageUploadField } from './ImageUploadField';
+//# sourceMappingURL=index.js.map

package/dist/patterns/image-upload-field/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/patterns/image-upload-field/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC","sourcesContent":["export { ImageUploadField } from './ImageUploadField';\nexport type { ImageUploadFieldProps, ImageUploadProgressContext, ZoraPickedImage } from './types';\n"]}

package/dist/patterns/image-upload-field/types.d.ts

@@ -0,0 +1,35 @@
+import type React from 'react';
+import type { ZoraBaseProps } from '../../theme/ZoraBaseProps';
+import type { ZoraImageAsset } from '../image-preview';
+export interface ZoraPickedImage {
+    uri: string;
+    fileName?: string;
+    sizeBytes?: number;
+    contentType?: string;
+    width?: number;
+    height?: number;
+}
+export interface ImageUploadProgressContext {
+    setProgress: (progress: number | null) => void;
+}
+export interface ImageUploadFieldProps extends ZoraBaseProps {
+    value: ZoraImageAsset | null;
+    onChange: (next: ZoraImageAsset | null) => void;
+    label: React.ReactNode;
+    description?: React.ReactNode;
+    helperText?: React.ReactNode;
+    errorText?: React.ReactNode;
+    required?: boolean;
+    disabled?: boolean;
+    readOnly?: boolean;
+    accept?: string;
+    maxSizeBytes?: number;
+    validatePicked?: (picked: ZoraPickedImage) => string | undefined;
+    onPick: () => Promise<ZoraPickedImage | null>;
+    onUpload?: (picked: ZoraPickedImage, context: ImageUploadProgressContext) => Promise<ZoraImageAsset>;
+    onRemove?: (current: ZoraImageAsset) => void | Promise<void>;
+    aspectRatio?: number;
+    previewTitle?: React.ReactNode;
+    previewDescription?: React.ReactNode;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/patterns/image-upload-field/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/patterns/image-upload-field/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,KAAK,IAAI,CAAC;IAChD,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC7B,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,MAAM,GAAG,SAAS,CAAC;IACjE,MAAM,EAAE,MAAM,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAC9C,QAAQ,CAAC,EAAE,CACT,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,0BAA0B,KAChC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC/B,kBAAkB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CACtC"}

package/dist/patterns/image-upload-field/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/patterns/image-upload-field/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/patterns/image-upload-field/types.ts"],"names":[],"mappings":"","sourcesContent":["import type React from 'react';\n\nimport type { ZoraBaseProps } from '../../theme/ZoraBaseProps';\nimport type { ZoraImageAsset } from '../image-preview';\n\nexport interface ZoraPickedImage {\n  uri: string;\n  fileName?: string;\n  sizeBytes?: number;\n  contentType?: string;\n  width?: number;\n  height?: number;\n}\n\nexport interface ImageUploadProgressContext {\n  setProgress: (progress: number | null) => void;\n}\n\nexport interface ImageUploadFieldProps extends ZoraBaseProps {\n  value: ZoraImageAsset | null;\n  onChange: (next: ZoraImageAsset | null) => void;\n  label: React.ReactNode;\n  description?: React.ReactNode;\n  helperText?: React.ReactNode;\n  errorText?: React.ReactNode;\n  required?: boolean;\n  disabled?: boolean;\n  readOnly?: boolean;\n  accept?: string;\n  maxSizeBytes?: number;\n  validatePicked?: (picked: ZoraPickedImage) => string | undefined;\n  onPick: () => Promise<ZoraPickedImage | null>;\n  onUpload?: (\n    picked: ZoraPickedImage,\n    context: ImageUploadProgressContext,\n  ) => Promise<ZoraImageAsset>;\n  onRemove?: (current: ZoraImageAsset) => void | Promise<void>;\n  aspectRatio?: number;\n  previewTitle?: React.ReactNode;\n  previewDescription?: React.ReactNode;\n}\n"]}

package/dist/patterns/image-upload-field/uploadFlow.d.ts

@@ -0,0 +1,18 @@
+import type { ZoraImageAsset } from '../image-preview';
+import type { ZoraPickedImage } from './types';
+export declare function isAccepted({ accept, contentType, fileName, }: {
+    accept: string | undefined;
+    contentType: string | undefined;
+    fileName: string | undefined;
+}): boolean;
+export declare function formatAcceptHint(accept: string | undefined): string | null;
+export declare function formatMaxSizeHint(maxSizeBytes: number | undefined): string | null;
+export declare function createOptimisticAssetFromPicked(picked: ZoraPickedImage): ZoraImageAsset;
+export declare function resolveRenderableUrl(asset: ZoraImageAsset | null): string | null;
+export declare function validatePickedImage({ picked, accept, maxSizeBytes, validatePicked, }: {
+    picked: ZoraPickedImage;
+    accept: string | undefined;
+    maxSizeBytes: number | undefined;
+    validatePicked: ((picked: ZoraPickedImage) => string | undefined) | undefined;
+}): string | undefined;
+//# sourceMappingURL=uploadFlow.d.ts.map

package/dist/patterns/image-upload-field/uploadFlow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploadFlow.d.ts","sourceRoot":"","sources":["../../../src/patterns/image-upload-field/uploadFlow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAuC/C,wBAAgB,UAAU,CAAC,EACzB,MAAM,EACN,WAAW,EACX,QAAQ,GACT,EAAE;IACD,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B,GAAG,OAAO,CAkBV;AAmBD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAI1E;AAED,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAIjF;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,eAAe,GAAG,cAAc,CAYvF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAIhF;AAED,wBAAgB,mBAAmB,CAAC,EAClC,MAAM,EACN,MAAM,EACN,YAAY,EACZ,cAAc,GACf,EAAE;IACD,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,eAAe,KAAK,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;CAC/E,GAAG,MAAM,GAAG,SAAS,CAiBrB"}

package/dist/patterns/image-upload-field/uploadFlow.js

@@ -0,0 +1,106 @@
+function parseAccept(accept) {
+    if (!accept)
+        return [];
+    return accept
+        .split(',')
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0);
+}
+function matchesAcceptToken({ token, contentType, fileName, }) {
+    const normalizedToken = token.toLowerCase();
+    const normalizedContentType = contentType?.toLowerCase();
+    const normalizedFileName = fileName?.toLowerCase();
+    if (normalizedToken.startsWith('.')) {
+        if (!normalizedFileName)
+            return null;
+        return normalizedFileName.endsWith(normalizedToken);
+    }
+    if (normalizedToken.endsWith('/*')) {
+        if (!normalizedContentType)
+            return null;
+        const prefix = normalizedToken.slice(0, Math.max(0, normalizedToken.length - 1));
+        return normalizedContentType.startsWith(prefix);
+    }
+    if (!normalizedContentType)
+        return null;
+    return normalizedContentType === normalizedToken;
+}
+export function isAccepted({ accept, contentType, fileName, }) {
+    const tokens = parseAccept(accept);
+    if (tokens.length === 0)
+        return true;
+    let hadSignal = false;
+    for (const token of tokens) {
+        const matches = matchesAcceptToken({ token, contentType, fileName });
+        if (matches === null) {
+            continue;
+        }
+        hadSignal = true;
+        if (matches)
+            return true;
+    }
+    // If we cannot validate due to missing metadata, do not block.
+    return !hadSignal;
+}
+function formatBytes(value) {
+    if (!Number.isFinite(value) || value <= 0)
+        return '0 B';
+    const units = ['B', 'KB', 'MB', 'GB'];
+    let size = value;
+    let unitIndex = 0;
+    while (size >= 1024 && unitIndex < units.length - 1) {
+        size /= 1024;
+        unitIndex += 1;
+    }
+    const unit = units[unitIndex] ?? 'B';
+    const rounded = unitIndex === 0 ? Math.round(size) : Math.round(size * 10) / 10;
+    return `${rounded} ${unit}`;
+}
+export function formatAcceptHint(accept) {
+    const tokens = parseAccept(accept);
+    if (tokens.length === 0)
+        return null;
+    return `Accepted: ${tokens.join(', ')}`;
+}
+export function formatMaxSizeHint(maxSizeBytes) {
+    if (maxSizeBytes === undefined)
+        return null;
+    if (!Number.isFinite(maxSizeBytes) || maxSizeBytes <= 0)
+        return null;
+    return `Max size: ${formatBytes(maxSizeBytes)}`;
+}
+export function createOptimisticAssetFromPicked(picked) {
+    return {
+        kind: 'url',
+        url: picked.uri,
+        width: picked.width,
+        height: picked.height,
+        contentType: picked.contentType,
+        metadata: {
+            fileName: picked.fileName,
+            sizeBytes: picked.sizeBytes,
+        },
+    };
+}
+export function resolveRenderableUrl(asset) {
+    if (!asset)
+        return null;
+    if (asset.kind === 'url')
+        return asset.url;
+    return asset.publicUrl ?? null;
+}
+export function validatePickedImage({ picked, accept, maxSizeBytes, validatePicked, }) {
+    if (!isAccepted({ accept, contentType: picked.contentType, fileName: picked.fileName })) {
+        return accept ? `File type not accepted. Expected ${accept}.` : 'File type not accepted.';
+    }
+    if (maxSizeBytes !== undefined &&
+        Number.isFinite(maxSizeBytes) &&
+        maxSizeBytes > 0 &&
+        picked.sizeBytes !== undefined &&
+        Number.isFinite(picked.sizeBytes) &&
+        picked.sizeBytes > maxSizeBytes) {
+        return `File is too large (${formatBytes(picked.sizeBytes)}). Max ${formatBytes(maxSizeBytes)}.`;
+    }
+    return validatePicked?.(picked);
+}
+//# sourceMappingURL=uploadFlow.js.map

package/dist/patterns/image-upload-field/uploadFlow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploadFlow.js","sourceRoot":"","sources":["../../../src/patterns/image-upload-field/uploadFlow.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ZoraImageAsset } from '../image-preview';\nimport type { ZoraPickedImage } from './types';\n\nfunction parseAccept(accept: string | undefined): readonly string[] {\n  if (!accept) return [];\n\n  return accept\n    .split(',')\n    .map((entry) => entry.trim())\n    .filter((entry) => entry.length > 0);\n}\n\nfunction matchesAcceptToken({\n  token,\n  contentType,\n  fileName,\n}: {\n  token: string;\n  contentType: string | undefined;\n  fileName: string | undefined;\n}): boolean | null {\n  const normalizedToken = token.toLowerCase();\n  const normalizedContentType = contentType?.toLowerCase();\n  const normalizedFileName = fileName?.toLowerCase();\n\n  if (normalizedToken.startsWith('.')) {\n    if (!normalizedFileName) return null;\n    return normalizedFileName.endsWith(normalizedToken);\n  }\n\n  if (normalizedToken.endsWith('/*')) {\n    if (!normalizedContentType) return null;\n    const prefix = normalizedToken.slice(0, Math.max(0, normalizedToken.length - 1));\n    return normalizedContentType.startsWith(prefix);\n  }\n\n  if (!normalizedContentType) return null;\n  return normalizedContentType === normalizedToken;\n}\n\nexport function isAccepted({\n  accept,\n  contentType,\n  fileName,\n}: {\n  accept: string | undefined;\n  contentType: string | undefined;\n  fileName: string | undefined;\n}): boolean {\n  const tokens = parseAccept(accept);\n  if (tokens.length === 0) return true;\n\n  let hadSignal = false;\n\n  for (const token of tokens) {\n    const matches = matchesAcceptToken({ token, contentType, fileName });\n    if (matches === null) {\n      continue;\n    }\n\n    hadSignal = true;\n    if (matches) return true;\n  }\n\n  // If we cannot validate due to missing metadata, do not block.\n  return !hadSignal;\n}\n\nfunction formatBytes(value: number): string {\n  if (!Number.isFinite(value) || value <= 0) return '0 B';\n\n  const units = ['B', 'KB', 'MB', 'GB'] as const;\n  let size = value;\n  let unitIndex = 0;\n\n  while (size >= 1024 && unitIndex < units.length - 1) {\n    size /= 1024;\n    unitIndex += 1;\n  }\n\n  const unit = units[unitIndex] ?? 'B';\n  const rounded = unitIndex === 0 ? Math.round(size) : Math.round(size * 10) / 10;\n  return `${rounded} ${unit}`;\n}\n\nexport function formatAcceptHint(accept: string | undefined): string | null {\n  const tokens = parseAccept(accept);\n  if (tokens.length === 0) return null;\n  return `Accepted: ${tokens.join(', ')}`;\n}\n\nexport function formatMaxSizeHint(maxSizeBytes: number | undefined): string | null {\n  if (maxSizeBytes === undefined) return null;\n  if (!Number.isFinite(maxSizeBytes) || maxSizeBytes <= 0) return null;\n  return `Max size: ${formatBytes(maxSizeBytes)}`;\n}\n\nexport function createOptimisticAssetFromPicked(picked: ZoraPickedImage): ZoraImageAsset {\n  return {\n    kind: 'url',\n    url: picked.uri,\n    width: picked.width,\n    height: picked.height,\n    contentType: picked.contentType,\n    metadata: {\n      fileName: picked.fileName,\n      sizeBytes: picked.sizeBytes,\n    },\n  };\n}\n\nexport function resolveRenderableUrl(asset: ZoraImageAsset | null): string | null {\n  if (!asset) return null;\n  if (asset.kind === 'url') return asset.url;\n  return asset.publicUrl ?? null;\n}\n\nexport function validatePickedImage({\n  picked,\n  accept,\n  maxSizeBytes,\n  validatePicked,\n}: {\n  picked: ZoraPickedImage;\n  accept: string | undefined;\n  maxSizeBytes: number | undefined;\n  validatePicked: ((picked: ZoraPickedImage) => string | undefined) | undefined;\n}): string | undefined {\n  if (!isAccepted({ accept, contentType: picked.contentType, fileName: picked.fileName })) {\n    return accept ? `File type not accepted. Expected ${accept}.` : 'File type not accepted.';\n  }\n\n  if (\n    maxSizeBytes !== undefined &&\n    Number.isFinite(maxSizeBytes) &&\n    maxSizeBytes > 0 &&\n    picked.sizeBytes !== undefined &&\n    Number.isFinite(picked.sizeBytes) &&\n    picked.sizeBytes > maxSizeBytes\n  ) {\n    return `File is too large (${formatBytes(picked.sizeBytes)}). Max ${formatBytes(maxSizeBytes)}.`;\n  }\n\n  return validatePicked?.(picked);\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/zora",
   "type": "module",
-  "version": "1.0.10",
+  "version": "1.1.0",
   "description": "Opinionated React Native and React Native Web UI kit built on @ankhorage/surface.",
   "homepage": "https://github.com/ankhorage/zora#readme",
   "bugs": {
@@ -44,8 +44,8 @@
   },
   "dependencies": {
     "@ankhorage/color-theory": "^0.0.4",
-    "@ankhorage/contracts": "^1.1.1",
-    "@ankhorage/surface": "^1.1.0"
+    "@ankhorage/contracts": "^1.2.0",
+    "@ankhorage/surface": "^1.2.0"
   },
   "files": [
     "dist",

package/src/components/image/Image.tsx

@@ -0,0 +1,11 @@
+import { Image as SurfaceImage } from '@ankhorage/surface';
+import React from 'react';
+
+import { withZoraThemeScope } from '../../theme/withZoraThemeScope';
+import type { ImageProps } from './types';
+
+function ImageInner({ themeId: _themeId, mode: _mode, ...props }: ImageProps) {
+  return <SurfaceImage {...props} />;
+}
+
+export const Image = withZoraThemeScope(ImageInner);

package/src/components/image/index.ts

@@ -0,0 +1,2 @@
+export { Image } from './Image';
+export type { ImageFit, ImageProps, SurfaceImageSource } from './types';

package/src/components/image/types.ts

@@ -0,0 +1,7 @@
+import type { ImageProps as SurfaceImageProps } from '@ankhorage/surface';
+
+import type { ZoraBaseProps } from '../../theme/ZoraBaseProps';
+
+export type { ImageFit, SurfaceImageSource } from '@ankhorage/surface';
+
+export interface ImageProps extends ZoraBaseProps, Omit<SurfaceImageProps, 'mode' | 'themeId'> {}

package/src/index.ts

@@ -58,6 +58,8 @@ export type { IconProps } from './components/icon';
 export { Icon } from './components/icon';
 export type { IconButtonProps } from './components/icon-button';
 export { IconButton } from './components/icon-button';
+export type { ImageFit, ImageProps, SurfaceImageSource } from './components/image';
+export { Image } from './components/image';
 export type { InputProps, InputTrailingAction } from './components/input';
 export { Input } from './components/input';
 export type { MediaCardImageProps, MediaCardProps } from './components/media-card';
@@ -160,6 +162,18 @@ export type { EmptyStateAction, EmptyStateProps } from './patterns/empty-state';
 export { EmptyState } from './patterns/empty-state';
 export type { FilterBarProps } from './patterns/filter-bar';
 export { FilterBar } from './patterns/filter-bar';
+export type {
+  ImagePreviewProps,
+  ZoraImageAsset,
+  ZoraImageMetadata,
+} from './patterns/image-preview';
+export { ImagePreview } from './patterns/image-preview';
+export type {
+  ImageUploadFieldProps,
+  ImageUploadProgressContext,
+  ZoraPickedImage,
+} from './patterns/image-upload-field';
+export { ImageUploadField } from './patterns/image-upload-field';
 export type { InspectorFieldProps } from './patterns/inspector-field';
 export { InspectorField } from './patterns/inspector-field';
 export type {

package/src/patterns/image-preview/ImagePreview.tsx

@@ -0,0 +1,76 @@
+import React from 'react';
+
+import { Image } from '../../components/image';
+import { Text } from '../../components/text';
+import { Box, Stack } from '../../foundation';
+import { useZoraTheme } from '../../theme/useZoraTheme';
+import { withZoraThemeScope } from '../../theme/withZoraThemeScope';
+import type { ImagePreviewProps, ZoraImageAsset } from './types';
+
+function resolveRenderableUrl(asset: ZoraImageAsset | null | undefined): string | null {
+  if (!asset) return null;
+
+  if (asset.kind === 'url') {
+    return asset.url;
+  }
+
+  return asset.publicUrl ?? null;
+}
+
+function resolveSafeAspectRatio(value: number | undefined): number {
+  if (!value || !Number.isFinite(value) || value <= 0) {
+    return 1;
+  }
+
+  return value;
+}
+
+function ImagePreviewInner({
+  themeId: _themeId,
+  mode: _mode,
+  testID,
+  asset,
+  aspectRatio,
+  fit = 'cover',
+  emptyTitle = 'No image',
+  emptyDescription = 'Select an image to preview it here.',
+}: ImagePreviewProps) {
+  const { theme } = useZoraTheme();
+  const renderableUrl = resolveRenderableUrl(asset);
+  const resolvedAspectRatio = resolveSafeAspectRatio(aspectRatio);
+
+  return (
+    <Box
+      bg={theme.semantics.neutral.surface}
+      borderColor={theme.semantics.neutral.divider}
+      borderWidth={1}
+      radius="l"
+      testID={testID}
+      style={{ overflow: 'hidden' }}
+    >
+      {renderableUrl ? (
+        <Box style={{ aspectRatio: resolvedAspectRatio, width: '100%' }}>
+          <Image
+            alt={asset?.alt}
+            fit={fit}
+            source={renderableUrl}
+            style={{ height: '100%', width: '100%' }}
+          />
+        </Box>
+      ) : (
+        <Box p="l">
+          <Stack gap="xs">
+            <Text variant="label" weight="semiBold">
+              {emptyTitle}
+            </Text>
+            <Text tone="muted" variant="bodySmall">
+              {emptyDescription}
+            </Text>
+          </Stack>
+        </Box>
+      )}
+    </Box>
+  );
+}
+
+export const ImagePreview = withZoraThemeScope(ImagePreviewInner);

package/src/patterns/image-preview/index.ts

@@ -0,0 +1,2 @@
+export { ImagePreview } from './ImagePreview';
+export type { ImagePreviewProps, ZoraImageAsset, ZoraImageMetadata } from './types';