@ankhorage/zora 24.0.3 → 24.1.1

package/dist/types/explorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explorer.d.ts","sourceRoot":"","sources":["../../src/types/explorer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAE5C,4FAA4F;AAC5F,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE5F,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEvD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IAC/B,aAAa,CAAC,EAAE,qBAAqB,CAAC;IACtC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,4BAA4B,KAAK,IAAI,CAAC;IAClE,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/types/explorer.js

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

package/dist/types/explorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explorer.js","sourceRoot":"","sources":["../../src/types/explorer.ts"],"names":[],"mappings":"","sourcesContent":["import type { ZoraBaseProps } from './base';\n\n/** Portable catalogue row. Providers retain permissions, pagination and storage objects. */\nexport type ExplorerItemKind = 'image' | 'video' | 'audio' | 'document' | 'file' | 'folder';\n\nexport interface ExplorerItem {\n  readonly id: string;\n  readonly kind: ExplorerItemKind;\n  readonly name: string;\n  readonly thumbnailUri?: string;\n  readonly uri?: string;\n  readonly contentType?: string;\n  readonly sizeBytes?: number;\n  readonly durationSeconds?: number;\n  readonly providerId?: string;\n  readonly disabled?: boolean;\n}\n\nexport type ExplorerSelectionMode = 'single' | 'multi';\n\nexport interface ExplorerActivateEvent {\n  readonly id: string;\n}\n\nexport interface ExplorerSelectionChangeEvent {\n  readonly selectedIds: readonly string[];\n}\n\nexport interface ExplorerProps extends ZoraBaseProps {\n  items: readonly ExplorerItem[];\n  selectionMode?: ExplorerSelectionMode;\n  selectedIds?: readonly string[];\n  defaultSelectedIds?: readonly string[];\n  onSelectionChange?: (event: ExplorerSelectionChangeEvent) => void;\n  onActivate?: (event: ExplorerActivateEvent) => void;\n  width?: number;\n  height?: number;\n  tileSize?: number;\n  zoom?: number;\n  loading?: boolean;\n  errorText?: string;\n  emptyText?: string;\n  disabled?: boolean;\n  readOnly?: boolean;\n}\n"]}

package/dist/types/grid-view.d.ts

@@ -0,0 +1,31 @@
+import type { GridRectItem, GridViewport } from '@ankhorage/grid-view';
+import type React from 'react';
+import type { ZoraBaseProps } from './base';
+/** The renderer owns presentation only; world geometry comes from grid-view. */
+export interface GridViewProps extends ZoraBaseProps {
+    items: readonly GridRectItem[];
+    contentWidth: number;
+    contentHeight: number;
+    width: number;
+    height: number;
+    zoom?: number;
+    overscanPixels?: number;
+    onViewportChange?: (viewport: GridViewport) => void;
+    renderItem: (item: GridRectItem) => React.ReactNode;
+}
+/** An item needs a stable ID; visual positioning belongs to the TileGrid composition. */
+export interface TileGridItem {
+    readonly id: string;
+}
+/** Reusable tile presentation based on the generic world/viewport engine. */
+export interface TileGridProps extends ZoraBaseProps {
+    items: readonly TileGridItem[];
+    width?: number;
+    height?: number;
+    tileSize?: number;
+    gap?: number;
+    zoom?: number;
+    overscanPixels?: number;
+    renderItem: (item: TileGridItem) => React.ReactNode;
+}
+//# sourceMappingURL=grid-view.d.ts.map

package/dist/types/grid-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid-view.d.ts","sourceRoot":"","sources":["../../src/types/grid-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAE5C,gFAAgF;AAChF,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;IACpD,UAAU,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,KAAK,CAAC,SAAS,CAAC;CACrD;AAED,yFAAyF;AACzF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,6EAA6E;AAC7E,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,KAAK,CAAC,SAAS,CAAC;CACrD"}

package/dist/types/grid-view.js

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

package/dist/types/grid-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid-view.js","sourceRoot":"","sources":["../../src/types/grid-view.ts"],"names":[],"mappings":"","sourcesContent":["import type { GridRectItem, GridViewport } from '@ankhorage/grid-view';\nimport type React from 'react';\n\nimport type { ZoraBaseProps } from './base';\n\n/** The renderer owns presentation only; world geometry comes from grid-view. */\nexport interface GridViewProps extends ZoraBaseProps {\n  items: readonly GridRectItem[];\n  contentWidth: number;\n  contentHeight: number;\n  width: number;\n  height: number;\n  zoom?: number;\n  overscanPixels?: number;\n  onViewportChange?: (viewport: GridViewport) => void;\n  renderItem: (item: GridRectItem) => React.ReactNode;\n}\n\n/** An item needs a stable ID; visual positioning belongs to the TileGrid composition. */\nexport interface TileGridItem {\n  readonly id: string;\n}\n\n/** Reusable tile presentation based on the generic world/viewport engine. */\nexport interface TileGridProps extends ZoraBaseProps {\n  items: readonly TileGridItem[];\n  width?: number;\n  height?: number;\n  tileSize?: number;\n  gap?: number;\n  zoom?: number;\n  overscanPixels?: number;\n  renderItem: (item: TileGridItem) => React.ReactNode;\n}\n"]}

package/dist/types/upload.d.ts

@@ -1,5 +1,6 @@
 import type React from 'react';
 import type { ZoraBaseProps } from './base';
+import type { ExplorerItem } from './explorer';
 export type UploadType = 'image' | 'video' | 'document' | 'file';
 export interface UploadAssetBase {
     fileName?: string;
@@ -32,6 +33,9 @@ export interface ValidateUploadAssetInput {
     maxSizeBytes?: number;
     validate?: (asset: UploadAsset) => string | undefined;
 }
+export type UploaderExplorerItem = ExplorerItem & {
+    readonly uploadAsset: UploadAsset;
+};
 export interface UploaderProps extends ZoraBaseProps {
     value?: UploadAsset | null;
     onChange?: (next: UploadAsset | null) => void;
@@ -58,6 +62,8 @@ export interface UploaderProps extends ZoraBaseProps {
     disabled?: boolean;
     readOnly?: boolean;
     validatePicked?: (asset: UploadAsset) => string | undefined;
+    /** If supplied, Uploader opens the canonical app-owned Explorer instead of an OS picker. */
+    explorerItems?: readonly UploaderExplorerItem[];
     onUpload?: (asset: UploadAsset, context: UploadProgressContext) => Promise<UploadAsset>;
     onRemove?: (current: UploadAsset) => void | Promise<void>;
     aspectRatio?: number;

package/dist/types/upload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../src/types/upload.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../src/types/upload.ts"],"names":[],"mappings":"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"}

package/dist/types/upload.js.map

@@ -1 +1 @@
-{"version":3,"file":"upload.js","sourceRoot":"","sources":["../../src/types/upload.ts"],"names":[],"mappings":"","sourcesContent":["import type React from 'react';\n\nimport type { ZoraBaseProps } from './base';\n\nexport type UploadType = 'image' | 'video' | 'document' | 'file';\n\nexport interface UploadAssetBase {\n  fileName?: string;\n  sizeBytes?: number;\n  contentType?: string;\n  width?: number;\n  height?: number;\n  alt?: string;\n  createdAt?: string;\n}\n\nexport type UploadAsset =\n  | (UploadAssetBase & {\n      kind: 'local';\n      uri: string;\n    })\n  | (UploadAssetBase & {\n      kind: 'url';\n      url: string;\n    })\n  | (UploadAssetBase & {\n      kind: 'storage';\n      storageId?: string;\n      bucket: string;\n      path: string;\n      publicUrl?: string;\n    });\n\nexport interface UploadProgressContext {\n  setProgress: (progress: number | null) => void;\n}\n\nexport interface ValidateUploadAssetInput {\n  asset: UploadAsset;\n  accept?: string;\n  maxSizeBytes?: number;\n  validate?: (asset: UploadAsset) => string | undefined;\n}\n\nexport interface UploaderProps extends ZoraBaseProps {\n  value?: UploadAsset | null;\n  onChange?: (next: UploadAsset | null) => void;\n  onValueChange?: (next: UploadAsset | null) => void;\n  onUploadRequest?: (event: { asset: UploadAsset }) => void;\n  onRemoveRequest?: (event: { asset: UploadAsset }) => void;\n  onValidationError?: (event: { message: string }) => void;\n  uploadState?: 'idle' | 'uploading' | 'removing';\n  uploadProgress?: number;\n  label?: React.ReactNode;\n  description?: React.ReactNode;\n  helperText?: React.ReactNode;\n  errorText?: React.ReactNode;\n  type?: UploadType;\n  accept?: string;\n  maxSizeBytes?: number;\n  required?: boolean;\n  disabled?: boolean;\n  readOnly?: boolean;\n  validatePicked?: (asset: UploadAsset) => string | undefined;\n  onUpload?: (asset: UploadAsset, context: UploadProgressContext) => Promise<UploadAsset>;\n  onRemove?: (current: UploadAsset) => void | Promise<void>;\n  aspectRatio?: number;\n}\n"]}
+{"version":3,"file":"upload.js","sourceRoot":"","sources":["../../src/types/upload.ts"],"names":[],"mappings":"","sourcesContent":["import type React from 'react';\n\nimport type { ZoraBaseProps } from './base';\nimport type { ExplorerItem } from './explorer';\n\nexport type UploadType = 'image' | 'video' | 'document' | 'file';\n\nexport interface UploadAssetBase {\n  fileName?: string;\n  sizeBytes?: number;\n  contentType?: string;\n  width?: number;\n  height?: number;\n  alt?: string;\n  createdAt?: string;\n}\n\nexport type UploadAsset =\n  | (UploadAssetBase & {\n      kind: 'local';\n      uri: string;\n    })\n  | (UploadAssetBase & {\n      kind: 'url';\n      url: string;\n    })\n  | (UploadAssetBase & {\n      kind: 'storage';\n      storageId?: string;\n      bucket: string;\n      path: string;\n      publicUrl?: string;\n    });\n\nexport interface UploadProgressContext {\n  setProgress: (progress: number | null) => void;\n}\n\nexport interface ValidateUploadAssetInput {\n  asset: UploadAsset;\n  accept?: string;\n  maxSizeBytes?: number;\n  validate?: (asset: UploadAsset) => string | undefined;\n}\n\nexport type UploaderExplorerItem = ExplorerItem & { readonly uploadAsset: UploadAsset };\n\nexport interface UploaderProps extends ZoraBaseProps {\n  value?: UploadAsset | null;\n  onChange?: (next: UploadAsset | null) => void;\n  onValueChange?: (next: UploadAsset | null) => void;\n  onUploadRequest?: (event: { asset: UploadAsset }) => void;\n  onRemoveRequest?: (event: { asset: UploadAsset }) => void;\n  onValidationError?: (event: { message: string }) => void;\n  uploadState?: 'idle' | 'uploading' | 'removing';\n  uploadProgress?: number;\n  label?: React.ReactNode;\n  description?: React.ReactNode;\n  helperText?: React.ReactNode;\n  errorText?: React.ReactNode;\n  type?: UploadType;\n  accept?: string;\n  maxSizeBytes?: number;\n  required?: boolean;\n  disabled?: boolean;\n  readOnly?: boolean;\n  validatePicked?: (asset: UploadAsset) => string | undefined;\n  /** If supplied, Uploader opens the canonical app-owned Explorer instead of an OS picker. */\n  explorerItems?: readonly UploaderExplorerItem[];\n  onUpload?: (asset: UploadAsset, context: UploadProgressContext) => Promise<UploadAsset>;\n  onRemove?: (current: UploadAsset) => void | Promise<void>;\n  aspectRatio?: number;\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/zora",
   "type": "module",
-  "version": "24.0.3",
+  "version": "24.1.1",
   "description": "Opinionated React Native and React Native Web UI kit built on @ankhorage/surface.",
   "homepage": "https://github.com/ankhorage/zora#readme",
   "bugs": {
@@ -42,15 +42,16 @@
   "dependencies": {
     "@ankhorage/ankh": "^0.12.2",
     "@ankhorage/color-theory": "^0.3.1",
-    "@ankhorage/contracts": "^24.2.0",
+    "@ankhorage/contracts": "^24.2.1",
     "@ankhorage/game": "^0.1.2",
-    "@ankhorage/runtime": "^4.0.5",
+    "@ankhorage/grid-view": "^0.1.1",
+    "@ankhorage/reader": "^0.1.0",
+    "@ankhorage/runtime": "^4.0.6",
     "@ankhorage/surface": "^9.4.1",
     "@ankhorage/utility": "^1.9.85",
     "chess.js": "^1.4.0",
     "expo-document-picker": "~57.0.3",
-    "expo-image-picker": "~57.0.20",
-    "@ankhorage/reader": "^0.1.0"
+    "expo-image-picker": "~57.0.20"
   },
   "files": [
     "dist",
@@ -152,7 +153,7 @@
     "react-native-reanimated": "4.5.1",
     "react-native-safe-area-context": "~5.7.0",
     "react-native-svg": "15.15.4",
-    "react-native-web": "~0.21.3",
+    "react-native-web": "~0.21.4",
     "react-native-worklets": "0.10.1",
     "typescript": "~6.0.3"
   },

package/src/constants/authoring.ts

@@ -28,6 +28,7 @@ export const FEATURE_MANIFEST_ELEMENTS = {
   chip: ['Chip', 'ChipGroup'],
   'data-table': ['DataTable'],
   'date-picker': ['DatePicker'],
+  explorer: ['MediaExplorer', 'FileExplorer'],
   dialog: ['Dialog'],
   form: ['Form', 'FormError', 'Field'],
   gradient: ['Gradient'],
@@ -85,6 +86,8 @@ export const CONTAINER_ALLOWED_CHILDREN = [
   'SkeletonText',
   'IconButton',
   'Uploader',
+  'MediaExplorer',
+  'FileExplorer',
   'FlatList',
   'SectionList',
   'BottomSheet',

package/src/features/explorer/adapters/inbound/Explorer.tsx

@@ -0,0 +1,136 @@
+import React from 'react';
+import { Pressable as NativePressable, View as NativeView } from 'react-native';
+
+import type { ExplorerItem, ExplorerProps } from '../../../../types/explorer';
+import { TileGrid } from '../../../grid-view/public';
+import { Icon } from '../../../icon/public';
+import { Image } from '../../../image/public';
+import { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';
+import { useZoraTheme } from '../../../theme/composition/useZoraTheme';
+import { Text } from '../../../typography/public';
+import { resolveExplorerSelection } from '../../application/resolveExplorerSelection';
+
+/*** Single canonical Explorer implementation for media and file catalogue presentation. */
+export const Explorer = withZoraThemeScope(ExplorerInner);
+
+/*** Presents provider-neutral asset tiles with controlled or uncontrolled selection. */
+function ExplorerInner({
+  items,
+  selectedIds,
+  defaultSelectedIds = [],
+  selectionMode = 'single',
+  onSelectionChange,
+  onActivate,
+  width,
+  height,
+  tileSize = 120,
+  zoom = 1,
+  loading = false,
+  errorText,
+  emptyText = 'No items',
+  disabled = false,
+  readOnly = false,
+  interactionPolicy,
+  testID,
+}: ExplorerProps) {
+  const { theme } = useZoraTheme();
+  const [internalSelectedIds, setInternalSelectedIds] =
+    React.useState<readonly string[]>(defaultSelectedIds);
+  const anchorId = React.useRef<string | null>(null);
+  const effectiveSelectedIds = selectedIds ?? internalSelectedIds;
+  const itemLookup = React.useMemo(() => new Map(items.map((item) => [item.id, item])), [items]);
+  const ids = items.filter((item) => !item.disabled).map((item) => item.id);
+  const selected = new Set(effectiveSelectedIds);
+  const passive = interactionPolicy === 'passive' || disabled || readOnly;
+
+  const select = (item: ExplorerItem, intent: 'replace' | 'toggle' | 'range') => {
+    if (passive || item.disabled) return;
+    const next = resolveExplorerSelection(
+      ids,
+      effectiveSelectedIds,
+      item.id,
+      anchorId.current,
+      intent,
+      selectionMode,
+    );
+    if (intent !== 'range') anchorId.current = item.id;
+    if (selectedIds === undefined) setInternalSelectedIds(next);
+    onSelectionChange?.({ selectedIds: next });
+  };
+
+  const renderTile = (tile: { readonly id: string }) => {
+    const item = itemLookup.get(tile.id);
+    if (!item) return null;
+    const isSelected = selected.has(item.id);
+    const canInteract = !passive && !item.disabled;
+    return (
+      <NativePressable
+        accessibilityLabel={item.name}
+        accessibilityRole="button"
+        accessibilityState={{ selected: isSelected, disabled: !canInteract }}
+        disabled={!canInteract}
+        onLongPress={() => select(item, 'toggle')}
+        onPress={(event) => {
+          const intent = resolveExplorerPressIntent(event.nativeEvent);
+          select(item, intent);
+          if (selectionMode === 'single' && intent === 'replace') {
+            onActivate?.({ id: item.id });
+          }
+        }}
+        style={{
+          flex: 1,
+          overflow: 'hidden',
+          borderRadius: 8,
+          borderWidth: isSelected ? 2 : 1,
+          borderColor: isSelected ? theme.colors.primary : theme.semantics.neutral.divider,
+          backgroundColor: theme.semantics.neutral.surface,
+          padding: 8,
+          gap: 4,
+        }}
+        testID={`explorer-item-${item.id}`}
+      >
+        <NativeView style={{ flex: 1, alignItems: 'center', justifyContent: 'center' }}>
+          {item.thumbnailUri ? (
+            <Image
+              accessibilityLabel={item.name}
+              aspectRatio={1}
+              source={item.thumbnailUri}
+              width="100%"
+            />
+          ) : (
+            <Icon name={item.kind === 'folder' ? 'folder-outline' : 'document-outline'} size={32} />
+          )}
+        </NativeView>
+        <Text numberOfLines={1} variant="caption">
+          {item.name}
+        </Text>
+      </NativePressable>
+    );
+  };
+
+  if (errorText) return <Text testID={testID}>{errorText}</Text>;
+  if (loading) return <Text testID={testID}>Loading…</Text>;
+  if (items.length === 0) return <Text testID={testID}>{emptyText}</Text>;
+
+  return (
+    <TileGrid
+      height={height}
+      interactionPolicy={interactionPolicy}
+      items={items}
+      renderItem={renderTile}
+      testID={testID}
+      tileSize={tileSize}
+      width={width}
+      zoom={zoom}
+    />
+  );
+}
+
+/*** Normalize platform press modifiers for multi-selection without passing event objects into contracts. */
+function resolveExplorerPressIntent(event: unknown): 'replace' | 'toggle' | 'range' {
+  if (typeof event !== 'object' || event === null) return 'replace';
+  if ('shiftKey' in event && event.shiftKey === true) return 'range';
+  if ('ctrlKey' in event && event.ctrlKey === true) return 'toggle';
+  if ('metaKey' in event && event.metaKey === true) return 'toggle';
+  return 'replace';
+}

package/src/features/explorer/adapters/inbound/FileExplorer.tsx

@@ -0,0 +1,9 @@
+import React from 'react';
+
+import type { ExplorerProps } from '../../../../types/explorer';
+import { Explorer } from './Explorer';
+
+/*** File and folder presentation using the exact same TileGrid and selection model. */
+export function FileExplorer(props: ExplorerProps) {
+  return <Explorer {...props} />;
+}

package/src/features/explorer/adapters/inbound/MediaExplorer.tsx

@@ -0,0 +1,16 @@
+import React from 'react';
+
+import type { ExplorerProps } from '../../../../types/explorer';
+import { Explorer } from './Explorer';
+
+/*** Specialized media catalogue presentation sharing the canonical Explorer/TileGrid path. */
+export function MediaExplorer(props: ExplorerProps) {
+  return (
+    <Explorer
+      {...props}
+      items={props.items.filter(
+        (item) => item.kind === 'image' || item.kind === 'video' || item.kind === 'audio',
+      )}
+    />
+  );
+}

package/src/features/explorer/application/resolveExplorerSelection.test.ts

@@ -0,0 +1,35 @@
+import { describe, expect, test } from 'bun:test';
+
+import { resolveExplorerSelection } from './resolveExplorerSelection';
+
+const ordered = ['a', 'b', 'c', 'd', 'e'];
+
+describe('Explorer selection', () => {
+  test('supports single selection', () => {
+    expect(resolveExplorerSelection(ordered, ['a'], 'c', 'a', 'toggle', 'single')).toEqual(['c']);
+  });
+  test('supports toggle and deselect in multi mode', () => {
+    expect(resolveExplorerSelection(ordered, ['a'], 'b', 'a', 'toggle', 'multi')).toEqual([
+      'a',
+      'b',
+    ]);
+    expect(resolveExplorerSelection(ordered, ['a', 'b'], 'a', 'a', 'toggle', 'multi')).toEqual([
+      'b',
+    ]);
+  });
+  test('supports contiguous range regardless of direction', () => {
+    expect(resolveExplorerSelection(ordered, ['a'], 'd', 'b', 'range', 'multi')).toEqual([
+      'b',
+      'c',
+      'd',
+    ]);
+    expect(resolveExplorerSelection(ordered, ['a'], 'b', 'd', 'range', 'multi')).toEqual([
+      'b',
+      'c',
+      'd',
+    ]);
+  });
+  test('ignores targets absent from catalogue', () => {
+    expect(resolveExplorerSelection(ordered, ['a'], 'z', 'a', 'replace', 'multi')).toEqual(['a']);
+  });
+});

package/src/features/explorer/application/resolveExplorerSelection.ts

@@ -0,0 +1,29 @@
+import { applySelectionIntent } from '@ankhorage/utility/selection';
+
+import type { ExplorerSelectionMode } from '../../../types/explorer';
+
+/***
+ * Resolve selection against ordered stable identities; shift-range extends from the last anchor.
+ * Range may replace or extend a multi-selection, but never affects the underlying catalogue.
+ */
+export function resolveExplorerSelection(
+  orderedIds: readonly string[],
+  currentIds: readonly string[],
+  targetId: string,
+  anchorId: string | null,
+  intent: 'replace' | 'toggle' | 'range',
+  mode: ExplorerSelectionMode,
+): readonly string[] {
+  const targetIndex = orderedIds.indexOf(targetId);
+  if (targetIndex < 0) return currentIds;
+  if (mode === 'single' || intent === 'replace')
+    return applySelectionIntent(currentIds, targetId, 'replace');
+  if (intent === 'toggle') {
+    return applySelectionIntent(currentIds, targetId, 'toggle');
+  }
+  const anchorIndex = anchorId === null ? -1 : orderedIds.indexOf(anchorId);
+  if (anchorIndex < 0) return [targetId];
+  const start = Math.min(anchorIndex, targetIndex);
+  const end = Math.max(anchorIndex, targetIndex);
+  return orderedIds.slice(start, end + 1);
+}

package/src/features/explorer/meta.ts

@@ -0,0 +1,94 @@
+import type { ZoraComponentMeta } from '../../types/authoring';
+
+const explorerProps = {
+  items: {
+    type: 'array',
+    category: 'Data',
+    itemSchema: [
+      { key: 'id', schema: { type: 'string', category: 'Identity' } },
+      {
+        key: 'kind',
+        schema: {
+          type: 'enum',
+          category: 'Data',
+          enum: ['image', 'video', 'audio', 'document', 'file', 'folder'],
+        },
+      },
+      { key: 'name', schema: { type: 'string', category: 'Content' } },
+      { key: 'uri', schema: { type: 'string', category: 'Data' } },
+      { key: 'thumbnailUri', schema: { type: 'string', category: 'Media' } },
+      { key: 'contentType', schema: { type: 'string', category: 'Data' } },
+      { key: 'sizeBytes', schema: { type: 'number', category: 'Data' } },
+      { key: 'providerId', schema: { type: 'string', category: 'Identity' } },
+      { key: 'disabled', schema: { type: 'boolean', category: 'State' } },
+    ],
+  },
+  selectionMode: {
+    type: 'enum',
+    category: 'Selection',
+    enum: ['single', 'multi'],
+    default: 'single',
+  },
+  selectedIds: { type: 'array', category: 'Selection' },
+  tileSize: { type: 'number', category: 'Layout', default: 120 },
+  height: { type: 'number', category: 'Layout', default: 440 },
+  zoom: { type: 'number', category: 'Layout', default: 1 },
+  loading: { type: 'boolean', category: 'State' },
+  errorText: { type: 'string', category: 'State' },
+  emptyText: { type: 'string', category: 'Content' },
+  disabled: { type: 'boolean', category: 'State' },
+  readOnly: { type: 'boolean', category: 'State' },
+  onSelectionChange: { type: 'action', category: 'Events' },
+  onActivate: { type: 'action', category: 'Events' },
+} as const;
+
+const explorerEvents = {
+  selectionChange: {
+    label: 'Selection change',
+    eventType: 'explorer.selectionChange',
+    payloadFields: [{ path: 'selectedIds', type: 'unknown' }],
+  },
+  activate: {
+    label: 'Activate item',
+    eventType: 'explorer.activate',
+    payloadFields: [{ path: 'id', type: 'string' }],
+  },
+} as const;
+
+/** Framework-bound Explorer is a composition primitive, not a separate manifest shape. */
+export const explorerMeta = {
+  name: 'Explorer',
+  category: 'pattern',
+  directManifestNode: false,
+  note: 'Shared code-only Explorer composition; MediaExplorer and FileExplorer own manifest representation.',
+  allowedChildren: [],
+  props: {},
+} as const satisfies ZoraComponentMeta;
+
+export const mediaExplorerMeta = {
+  name: 'MediaExplorer',
+  category: 'pattern',
+  description: 'Virtualized media library with normalized selection and activation events.',
+  directManifestNode: true,
+  allowedChildren: [],
+  blueprint: {
+    label: 'Media explorer',
+    defaultProps: { items: [], selectionMode: 'single', tileSize: 120 },
+  },
+  events: explorerEvents,
+  props: explorerProps,
+} as const satisfies ZoraComponentMeta;
+
+export const fileExplorerMeta = {
+  name: 'FileExplorer',
+  category: 'pattern',
+  description: 'Virtualized file and folder collection with normalized selection and activation.',
+  directManifestNode: true,
+  allowedChildren: [],
+  blueprint: {
+    label: 'File explorer',
+    defaultProps: { items: [], selectionMode: 'single', tileSize: 120 },
+  },
+  events: explorerEvents,
+  props: explorerProps,
+} as const satisfies ZoraComponentMeta;

package/src/features/explorer/public.ts

@@ -0,0 +1,12 @@
+export type {
+  ExplorerActivateEvent,
+  ExplorerItem,
+  ExplorerItemKind,
+  ExplorerProps,
+  ExplorerSelectionChangeEvent,
+  ExplorerSelectionMode,
+} from '../../types/explorer';
+export { Explorer } from './adapters/inbound/Explorer';
+export { FileExplorer } from './adapters/inbound/FileExplorer';
+export { MediaExplorer } from './adapters/inbound/MediaExplorer';
+export { resolveExplorerSelection } from './application/resolveExplorerSelection';

package/src/features/grid-view/adapters/inbound/GridView.tsx

@@ -0,0 +1,95 @@
+import { getVisibleGridItems, type GridViewport, worldToViewport } from '@ankhorage/grid-view';
+import React from 'react';
+import { ScrollView as NativeScrollView, View as NativeView } from 'react-native';
+
+import type { GridViewProps } from '../../../../types/grid-view';
+
+/***
+ * Renders world-positioned items on native and web using the canonical viewport/culling engine.
+ *
+ * This first renderer uses nested native scroll regions. Only visible items are mounted;
+ * logical cells and invisible elements are never rendered.
+ */
+export function GridView({
+  items,
+  contentWidth,
+  contentHeight,
+  width,
+  height,
+  zoom = 1,
+  overscanPixels = 160,
+  interactionPolicy,
+  onViewportChange,
+  renderItem,
+  testID,
+}: GridViewProps) {
+  const [scrollX, setScrollX] = React.useState(0);
+  const [scrollY, setScrollY] = React.useState(0);
+  const scale = Math.max(0.01, zoom);
+  const viewport = React.useMemo<GridViewport>(
+    () => ({
+      width,
+      height,
+      offsetX: scrollX / scale,
+      offsetY: scrollY / scale,
+      pixelsPerUnitX: scale,
+      pixelsPerUnitY: scale,
+    }),
+    [height, scale, scrollX, scrollY, width],
+  );
+  const visibleItems = React.useMemo(
+    () => getVisibleGridItems(items, viewport, overscanPixels),
+    [items, overscanPixels, viewport],
+  );
+
+  React.useEffect(() => {
+    onViewportChange?.(viewport);
+  }, [onViewportChange, viewport]);
+
+  return (
+    <NativeScrollView
+      horizontal
+      scrollEnabled={interactionPolicy !== 'passive'}
+      scrollEventThrottle={32}
+      showsHorizontalScrollIndicator
+      style={{ width, height }}
+      testID={testID}
+      onScroll={(event) => setScrollX(event.nativeEvent.contentOffset.x)}
+    >
+      <NativeScrollView
+        scrollEnabled={interactionPolicy !== 'passive'}
+        scrollEventThrottle={32}
+        showsVerticalScrollIndicator
+        style={{ width: contentWidth * scale, height }}
+        onScroll={(event) => setScrollY(event.nativeEvent.contentOffset.y)}
+      >
+        <NativeView style={{ width: contentWidth * scale, height: contentHeight * scale }}>
+          {visibleItems.map((item) => {
+            const position = worldToViewport(
+              { x: item.x, y: item.y },
+              {
+                ...viewport,
+                offsetX: 0,
+                offsetY: 0,
+              },
+            );
+            return (
+              <NativeView
+                key={item.id}
+                style={{
+                  position: 'absolute',
+                  left: position.x,
+                  top: position.y,
+                  width: item.width * scale,
+                  height: item.height * scale,
+                }}
+              >
+                {renderItem(item)}
+              </NativeView>
+            );
+          })}
+        </NativeView>
+      </NativeScrollView>
+    </NativeScrollView>
+  );
+}

package/src/features/grid-view/adapters/inbound/TileGrid.tsx

@@ -0,0 +1,53 @@
+import React from 'react';
+import { View as NativeView } from 'react-native';
+
+import type { TileGridProps } from '../../../../types/grid-view';
+import { layoutTileGrid } from '../../application/layoutTileGrid';
+import { GridView } from './GridView';
+
+/*** Composes a responsive, virtualized tile presentation over the generic GridView renderer. */
+export function TileGrid({
+  items,
+  width,
+  height = 440,
+  tileSize = 120,
+  gap = 12,
+  zoom = 1,
+  overscanPixels,
+  renderItem,
+  interactionPolicy,
+  testID,
+}: TileGridProps) {
+  const [measuredWidth, setMeasuredWidth] = React.useState(0);
+  const resolvedWidth = width ?? measuredWidth;
+  const layout = React.useMemo(
+    () => layoutTileGrid(items, resolvedWidth, tileSize, gap, zoom),
+    [items, resolvedWidth, tileSize, gap, zoom],
+  );
+  const itemLookup = React.useMemo(() => new Map(items.map((item) => [item.id, item])), [items]);
+
+  return (
+    <NativeView
+      onLayout={(event) => setMeasuredWidth(event.nativeEvent.layout.width)}
+      style={{ width, height, overflow: 'hidden' }}
+      testID={testID}
+    >
+      {resolvedWidth > 0 ? (
+        <GridView
+          contentHeight={layout.height}
+          contentWidth={Math.max(resolvedWidth / zoom, layout.width)}
+          height={height}
+          interactionPolicy={interactionPolicy}
+          items={layout.items}
+          overscanPixels={overscanPixels}
+          renderItem={(item) => {
+            const source = itemLookup.get(item.id);
+            return source ? renderItem(source) : null;
+          }}
+          width={resolvedWidth}
+          zoom={zoom}
+        />
+      ) : null}
+    </NativeView>
+  );
+}