npm - @ankhorage/zora - Versions diffs - 25.0.1 → 25.2.0 - Mend

@ankhorage/zora 25.0.1 → 25.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (86) hide show

package/dist/features/explorer/meta.d.ts CHANGED Viewed

@@ -38,6 +38,19 @@ export declare const mediaExplorerMeta: {
                 readonly type: "string";
             }];
         };
+        readonly loadMore: {
+            readonly label: "Load more";
+            readonly eventType: "explorer.loadMore";
+            readonly payloadFields: readonly [{
+                readonly path: "loadedItemCount";
+                readonly type: "number";
+            }];
+        };
+        readonly requestPermission: {
+            readonly label: "Request permission";
+            readonly eventType: "explorer.requestPermission";
+            readonly payloadFields: readonly [];
+        };
     };
     readonly props: {
         readonly items: {
@@ -110,6 +123,14 @@ export declare const mediaExplorerMeta: {
             readonly type: "array";
             readonly category: "Selection";
         };
+        readonly defaultSelectedIds: {
+            readonly type: "array";
+            readonly category: "Selection";
+        };
+        readonly width: {
+            readonly type: "number";
+            readonly category: "Layout";
+        };
         readonly tileSize: {
             readonly type: "number";
             readonly category: "Layout";
@@ -129,6 +150,32 @@ export declare const mediaExplorerMeta: {
             readonly type: "boolean";
             readonly category: "State";
         };
+        readonly hasMore: {
+            readonly type: "boolean";
+            readonly category: "Paging";
+        };
+        readonly loadingMore: {
+            readonly type: "boolean";
+            readonly category: "Paging";
+        };
+        readonly pagingCollectionId: {
+            readonly type: "string";
+            readonly category: "Paging";
+        };
+        readonly pagingRetryToken: {
+            readonly type: "string";
+            readonly category: "Paging";
+        };
+        readonly permissionStatus: {
+            readonly type: "enum";
+            readonly category: "Permission";
+            readonly enum: readonly ["granted", "limited", "denied", "unavailable"];
+            readonly default: "granted";
+        };
+        readonly permissionText: {
+            readonly type: "string";
+            readonly category: "Permission";
+        };
         readonly errorText: {
             readonly type: "string";
             readonly category: "State";
@@ -153,6 +200,14 @@ export declare const mediaExplorerMeta: {
             readonly type: "action";
             readonly category: "Events";
         };
+        readonly onLoadMore: {
+            readonly type: "action";
+            readonly category: "Events";
+        };
+        readonly onRequestPermission: {
+            readonly type: "action";
+            readonly category: "Events";
+        };
     };
 };
 export declare const fileExplorerMeta: {
@@ -186,6 +241,19 @@ export declare const fileExplorerMeta: {
                 readonly type: "string";
             }];
         };
+        readonly loadMore: {
+            readonly label: "Load more";
+            readonly eventType: "explorer.loadMore";
+            readonly payloadFields: readonly [{
+                readonly path: "loadedItemCount";
+                readonly type: "number";
+            }];
+        };
+        readonly requestPermission: {
+            readonly label: "Request permission";
+            readonly eventType: "explorer.requestPermission";
+            readonly payloadFields: readonly [];
+        };
     };
     readonly props: {
         readonly items: {
@@ -258,6 +326,14 @@ export declare const fileExplorerMeta: {
             readonly type: "array";
             readonly category: "Selection";
         };
+        readonly defaultSelectedIds: {
+            readonly type: "array";
+            readonly category: "Selection";
+        };
+        readonly width: {
+            readonly type: "number";
+            readonly category: "Layout";
+        };
         readonly tileSize: {
             readonly type: "number";
             readonly category: "Layout";
@@ -277,6 +353,32 @@ export declare const fileExplorerMeta: {
             readonly type: "boolean";
             readonly category: "State";
         };
+        readonly hasMore: {
+            readonly type: "boolean";
+            readonly category: "Paging";
+        };
+        readonly loadingMore: {
+            readonly type: "boolean";
+            readonly category: "Paging";
+        };
+        readonly pagingCollectionId: {
+            readonly type: "string";
+            readonly category: "Paging";
+        };
+        readonly pagingRetryToken: {
+            readonly type: "string";
+            readonly category: "Paging";
+        };
+        readonly permissionStatus: {
+            readonly type: "enum";
+            readonly category: "Permission";
+            readonly enum: readonly ["granted", "limited", "denied", "unavailable"];
+            readonly default: "granted";
+        };
+        readonly permissionText: {
+            readonly type: "string";
+            readonly category: "Permission";
+        };
         readonly errorText: {
             readonly type: "string";
             readonly category: "State";
@@ -301,6 +403,14 @@ export declare const fileExplorerMeta: {
             readonly type: "action";
             readonly category: "Events";
         };
+        readonly onLoadMore: {
+            readonly type: "action";
+            readonly category: "Events";
+        };
+        readonly onRequestPermission: {
+            readonly type: "action";
+            readonly category: "Events";
+        };
     };
 };
 //# sourceMappingURL=meta.d.ts.map

package/dist/features/explorer/meta.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../src/features/explorer/meta.ts"],"names":[],"mappings":"~~AAyDA~~,0FAA0F;AAC1F,eAAO,MAAM,YAAY;;;;;;;CAOa,CAAC;AAEvC,eAAO,MAAM,iBAAiB~~;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;~~CAYQ,CAAC;AAEvC,eAAO,MAAM,gBAAgB~~;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;~~CAYS,CAAC"}
1	+ {"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../src/features/explorer/meta.ts"],"names":[],"mappings":"AAkFA,0FAA0F;AAC1F,eAAO,MAAM,YAAY;;;;;;;CAOa,CAAC;AAEvC,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAYQ,CAAC;AAEvC,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAYS,CAAC"}

package/dist/features/explorer/meta.js CHANGED Viewed

@@ -28,16 +28,31 @@ const explorerProps = {
         default: 'single',
     },
     selectedIds: { type: 'array', category: 'Selection' },
+    defaultSelectedIds: { type: 'array', category: 'Selection' },
+    width: { type: 'number', category: 'Layout' },
     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' },
+    hasMore: { type: 'boolean', category: 'Paging' },
+    loadingMore: { type: 'boolean', category: 'Paging' },
+    pagingCollectionId: { type: 'string', category: 'Paging' },
+    pagingRetryToken: { type: 'string', category: 'Paging' },
+    permissionStatus: {
+        type: 'enum',
+        category: 'Permission',
+        enum: ['granted', 'limited', 'denied', 'unavailable'],
+        default: 'granted',
+    },
+    permissionText: { type: 'string', category: 'Permission' },
     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' },
+    onLoadMore: { type: 'action', category: 'Events' },
+    onRequestPermission: { type: 'action', category: 'Events' },
 };
 const explorerEvents = {
     selectionChange: {
@@ -50,6 +65,16 @@ const explorerEvents = {
         eventType: 'explorer.activate',
         payloadFields: [{ path: 'id', type: 'string' }],
     },
+    loadMore: {
+        label: 'Load more',
+        eventType: 'explorer.loadMore',
+        payloadFields: [{ path: 'loadedItemCount', type: 'number' }],
+    },
+    requestPermission: {
+        label: 'Request permission',
+        eventType: 'explorer.requestPermission',
+        payloadFields: [],
+    },
 };
 /** Framework-bound Explorer is a composition primitive, not a separate manifest shape. */
 export const explorerMeta = {

package/dist/features/explorer/meta.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"meta.js","sourceRoot":"","sources":["../../../src/features/explorer/meta.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAAG;IACpB,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,MAAM;QAChB,UAAU,EAAE;YACV,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE;YAC/D;gBACE,GAAG,EAAE,MAAM;gBACX,MAAM,EAAE;oBACN,IAAI,EAAE,MAAM;oBACZ,QAAQ,EAAE,MAAM;oBAChB,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC;iBAChE;aACF;YACD,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE;YAChE,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;YAC5D,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;YACtE,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;YACpE,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;YAClE,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE;YACvE,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;SACpE;KACF;IACD,aAAa,EAAE;QACb,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,WAAW;QACrB,IAAI,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;QACzB,OAAO,EAAE,QAAQ;KAClB;IACD,WAAW,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE;IACrD,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE;IAC9D,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE;IAC5D,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE;IACxD,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE;IAC/C,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE;IAChD,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE;IAClD,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE;IAChD,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE;IAChD,iBAAiB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE;IACzD,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE;~~CAC1C~~,CAAC;AAEX,MAAM,cAAc,GAAG;IACrB,eAAe,EAAE;QACf,KAAK,EAAE,kBAAkB;QACzB,SAAS,EAAE,0BAA0B;QACrC,aAAa,EAAE,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KAC1D;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,eAAe;QACtB,SAAS,EAAE,mBAAmB;QAC9B,aAAa,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;KAChD;CACO,CAAC;AAEX,0FAA0F;AAC1F,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,SAAS;IACnB,kBAAkB,EAAE,KAAK;IACzB,IAAI,EAAE,oGAAoG;IAC1G,eAAe,EAAE,EAAE;IACnB,KAAK,EAAE,EAAE;CAC2B,CAAC;AAEvC,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,eAAe;IACrB,QAAQ,EAAE,SAAS;IACnB,WAAW,EAAE,4EAA4E;IACzF,kBAAkB,EAAE,IAAI;IACxB,eAAe,EAAE,EAAE;IACnB,SAAS,EAAE;QACT,KAAK,EAAE,gBAAgB;QACvB,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE;KACpE;IACD,MAAM,EAAE,cAAc;IACtB,KAAK,EAAE,aAAa;CACgB,CAAC;AAEvC,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,cAAc;IACpB,QAAQ,EAAE,SAAS;IACnB,WAAW,EAAE,kFAAkF;IAC/F,kBAAkB,EAAE,IAAI;IACxB,eAAe,EAAE,EAAE;IACnB,SAAS,EAAE;QACT,KAAK,EAAE,eAAe;QACtB,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE;KACpE;IACD,MAAM,EAAE,cAAc;IACtB,KAAK,EAAE,aAAa;CACgB,CAAC","sourcesContent":["import type { ZoraComponentMeta } from '../../types/authoring';\n\nconst explorerProps = {\n items: {\n type: 'array',\n category: 'Data',\n itemSchema: [\n { key: 'id', schema: { type: 'string', category: 'Identity' } },\n {\n key: 'kind',\n schema: {\n type: 'enum',\n category: 'Data',\n enum: ['image', 'video', 'audio', 'document', 'file', 'folder'],\n },\n },\n { key: 'name', schema: { type: 'string', category: 'Content' } },\n { key: 'uri', schema: { type: 'string', category: 'Data' } },\n { key: 'thumbnailUri', schema: { type: 'string', category: 'Media' } },\n { key: 'contentType', schema: { type: 'string', category: 'Data' } },\n { key: 'sizeBytes', schema: { type: 'number', category: 'Data' } },\n { key: 'providerId', schema: { type: 'string', category: 'Identity' } },\n { key: 'disabled', schema: { type: 'boolean', category: 'State' } },\n ],\n },\n selectionMode: {\n type: 'enum',\n category: 'Selection',\n enum: ['single', 'multi'],\n default: 'single',\n },\n selectedIds: { type: 'array', category: 'Selection' },\n tileSize: { type: 'number', category: 'Layout', default: 120 },\n height: { type: 'number', category: 'Layout', default: 440 },\n zoom: { type: 'number', category: 'Layout', default: 1 },\n loading: { type: 'boolean', category: 'State' },\n errorText: { type: 'string', category: 'State' },\n emptyText: { type: 'string', category: 'Content' },\n disabled: { type: 'boolean', category: 'State' },\n readOnly: { type: 'boolean', category: 'State' },\n onSelectionChange: { type: 'action', category: 'Events' },\n onActivate: { type: 'action', category: 'Events' },\n} as const;\n\nconst explorerEvents = {\n selectionChange: {\n label: 'Selection change',\n eventType: 'explorer.selectionChange',\n payloadFields: [{ path: 'selectedIds', type: 'unknown' }],\n },\n activate: {\n label: 'Activate item',\n eventType: 'explorer.activate',\n payloadFields: [{ path: 'id', type: 'string' }],\n },\n} as const;\n\n/** Framework-bound Explorer is a composition primitive, not a separate manifest shape. */\nexport const explorerMeta = {\n name: 'Explorer',\n category: 'pattern',\n directManifestNode: false,\n note: 'Shared code-only Explorer composition; MediaExplorer and FileExplorer own manifest representation.',\n allowedChildren: [],\n props: {},\n} as const satisfies ZoraComponentMeta;\n\nexport const mediaExplorerMeta = {\n name: 'MediaExplorer',\n category: 'pattern',\n description: 'Virtualized media library with normalized selection and activation events.',\n directManifestNode: true,\n allowedChildren: [],\n blueprint: {\n label: 'Media explorer',\n defaultProps: { items: [], selectionMode: 'single', tileSize: 120 },\n },\n events: explorerEvents,\n props: explorerProps,\n} as const satisfies ZoraComponentMeta;\n\nexport const fileExplorerMeta = {\n name: 'FileExplorer',\n category: 'pattern',\n description: 'Virtualized file and folder collection with normalized selection and activation.',\n directManifestNode: true,\n allowedChildren: [],\n blueprint: {\n label: 'File explorer',\n defaultProps: { items: [], selectionMode: 'single', tileSize: 120 },\n },\n events: explorerEvents,\n props: explorerProps,\n} as const satisfies ZoraComponentMeta;\n"]}
1	+ {"version":3,"file":"meta.js","sourceRoot":"","sources":["../../../src/features/explorer/meta.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAAG;IACpB,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,MAAM;QAChB,UAAU,EAAE;YACV,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE;YAC/D;gBACE,GAAG,EAAE,MAAM;gBACX,MAAM,EAAE;oBACN,IAAI,EAAE,MAAM;oBACZ,QAAQ,EAAE,MAAM;oBAChB,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC;iBAChE;aACF;YACD,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE;YAChE,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;YAC5D,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;YACtE,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;YACpE,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;YAClE,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE;YACvE,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;SACpE;KACF;IACD,aAAa,EAAE;QACb,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,WAAW;QACrB,IAAI,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;QACzB,OAAO,EAAE,QAAQ;KAClB;IACD,WAAW,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE;IACrD,kBAAkB,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE;IAC5D,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE;IAC7C,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE;IAC9D,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE;IAC5D,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE;IACxD,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE;IAC/C,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE;IAChD,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE;IACpD,kBAAkB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE;IAC1D,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE;IACxD,gBAAgB,EAAE;QAChB,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,YAAY;QACtB,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,CAAC;QACrD,OAAO,EAAE,SAAS;KACnB;IACD,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE;IAC1D,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE;IAChD,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE;IAClD,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE;IAChD,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE;IAChD,iBAAiB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE;IACzD,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE;IAClD,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE;IAClD,mBAAmB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE;CACnD,CAAC;AAEX,MAAM,cAAc,GAAG;IACrB,eAAe,EAAE;QACf,KAAK,EAAE,kBAAkB;QACzB,SAAS,EAAE,0BAA0B;QACrC,aAAa,EAAE,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KAC1D;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,eAAe;QACtB,SAAS,EAAE,mBAAmB;QAC9B,aAAa,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;KAChD;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,WAAW;QAClB,SAAS,EAAE,mBAAmB;QAC9B,aAAa,EAAE,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;KAC7D;IACD,iBAAiB,EAAE;QACjB,KAAK,EAAE,oBAAoB;QAC3B,SAAS,EAAE,4BAA4B;QACvC,aAAa,EAAE,EAAE;KAClB;CACO,CAAC;AAEX,0FAA0F;AAC1F,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,SAAS;IACnB,kBAAkB,EAAE,KAAK;IACzB,IAAI,EAAE,oGAAoG;IAC1G,eAAe,EAAE,EAAE;IACnB,KAAK,EAAE,EAAE;CAC2B,CAAC;AAEvC,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,eAAe;IACrB,QAAQ,EAAE,SAAS;IACnB,WAAW,EAAE,4EAA4E;IACzF,kBAAkB,EAAE,IAAI;IACxB,eAAe,EAAE,EAAE;IACnB,SAAS,EAAE;QACT,KAAK,EAAE,gBAAgB;QACvB,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE;KACpE;IACD,MAAM,EAAE,cAAc;IACtB,KAAK,EAAE,aAAa;CACgB,CAAC;AAEvC,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,cAAc;IACpB,QAAQ,EAAE,SAAS;IACnB,WAAW,EAAE,kFAAkF;IAC/F,kBAAkB,EAAE,IAAI;IACxB,eAAe,EAAE,EAAE;IACnB,SAAS,EAAE;QACT,KAAK,EAAE,eAAe;QACtB,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE;KACpE;IACD,MAAM,EAAE,cAAc;IACtB,KAAK,EAAE,aAAa;CACgB,CAAC","sourcesContent":["import type { ZoraComponentMeta } from '../../types/authoring';\n\nconst explorerProps = {\n items: {\n type: 'array',\n category: 'Data',\n itemSchema: [\n { key: 'id', schema: { type: 'string', category: 'Identity' } },\n {\n key: 'kind',\n schema: {\n type: 'enum',\n category: 'Data',\n enum: ['image', 'video', 'audio', 'document', 'file', 'folder'],\n },\n },\n { key: 'name', schema: { type: 'string', category: 'Content' } },\n { key: 'uri', schema: { type: 'string', category: 'Data' } },\n { key: 'thumbnailUri', schema: { type: 'string', category: 'Media' } },\n { key: 'contentType', schema: { type: 'string', category: 'Data' } },\n { key: 'sizeBytes', schema: { type: 'number', category: 'Data' } },\n { key: 'providerId', schema: { type: 'string', category: 'Identity' } },\n { key: 'disabled', schema: { type: 'boolean', category: 'State' } },\n ],\n },\n selectionMode: {\n type: 'enum',\n category: 'Selection',\n enum: ['single', 'multi'],\n default: 'single',\n },\n selectedIds: { type: 'array', category: 'Selection' },\n defaultSelectedIds: { type: 'array', category: 'Selection' },\n width: { type: 'number', category: 'Layout' },\n tileSize: { type: 'number', category: 'Layout', default: 120 },\n height: { type: 'number', category: 'Layout', default: 440 },\n zoom: { type: 'number', category: 'Layout', default: 1 },\n loading: { type: 'boolean', category: 'State' },\n hasMore: { type: 'boolean', category: 'Paging' },\n loadingMore: { type: 'boolean', category: 'Paging' },\n pagingCollectionId: { type: 'string', category: 'Paging' },\n pagingRetryToken: { type: 'string', category: 'Paging' },\n permissionStatus: {\n type: 'enum',\n category: 'Permission',\n enum: ['granted', 'limited', 'denied', 'unavailable'],\n default: 'granted',\n },\n permissionText: { type: 'string', category: 'Permission' },\n errorText: { type: 'string', category: 'State' },\n emptyText: { type: 'string', category: 'Content' },\n disabled: { type: 'boolean', category: 'State' },\n readOnly: { type: 'boolean', category: 'State' },\n onSelectionChange: { type: 'action', category: 'Events' },\n onActivate: { type: 'action', category: 'Events' },\n onLoadMore: { type: 'action', category: 'Events' },\n onRequestPermission: { type: 'action', category: 'Events' },\n} as const;\n\nconst explorerEvents = {\n selectionChange: {\n label: 'Selection change',\n eventType: 'explorer.selectionChange',\n payloadFields: [{ path: 'selectedIds', type: 'unknown' }],\n },\n activate: {\n label: 'Activate item',\n eventType: 'explorer.activate',\n payloadFields: [{ path: 'id', type: 'string' }],\n },\n loadMore: {\n label: 'Load more',\n eventType: 'explorer.loadMore',\n payloadFields: [{ path: 'loadedItemCount', type: 'number' }],\n },\n requestPermission: {\n label: 'Request permission',\n eventType: 'explorer.requestPermission',\n payloadFields: [],\n },\n} as const;\n\n/** Framework-bound Explorer is a composition primitive, not a separate manifest shape. */\nexport const explorerMeta = {\n name: 'Explorer',\n category: 'pattern',\n directManifestNode: false,\n note: 'Shared code-only Explorer composition; MediaExplorer and FileExplorer own manifest representation.',\n allowedChildren: [],\n props: {},\n} as const satisfies ZoraComponentMeta;\n\nexport const mediaExplorerMeta = {\n name: 'MediaExplorer',\n category: 'pattern',\n description: 'Virtualized media library with normalized selection and activation events.',\n directManifestNode: true,\n allowedChildren: [],\n blueprint: {\n label: 'Media explorer',\n defaultProps: { items: [], selectionMode: 'single', tileSize: 120 },\n },\n events: explorerEvents,\n props: explorerProps,\n} as const satisfies ZoraComponentMeta;\n\nexport const fileExplorerMeta = {\n name: 'FileExplorer',\n category: 'pattern',\n description: 'Virtualized file and folder collection with normalized selection and activation.',\n directManifestNode: true,\n allowedChildren: [],\n blueprint: {\n label: 'File explorer',\n defaultProps: { items: [], selectionMode: 'single', tileSize: 120 },\n },\n events: explorerEvents,\n props: explorerProps,\n} as const satisfies ZoraComponentMeta;\n"]}

package/dist/features/explorer/public.d.ts CHANGED Viewed

@@ -1,6 +1,7 @@
-export type { ExplorerActivateEvent, ExplorerItem, ExplorerItemKind, ExplorerProps, ExplorerSelectionChangeEvent, ExplorerSelectionMode, } from '../../types/explorer';
+export type { ExplorerActivateEvent, ExplorerItem, ExplorerItemKind, ExplorerPageRequestEvent, ExplorerPermissionStatus, 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 { getExplorerNextFocusId } from './application/getExplorerNextFocusId';
 export { resolveExplorerSelection } from './application/resolveExplorerSelection';
 //# sourceMappingURL=public.d.ts.map

package/dist/features/explorer/public.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../src/features/explorer/public.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC"}
1	+ {"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../src/features/explorer/public.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,EACxB,wBAAwB,EACxB,aAAa,EACb,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC"}

package/dist/features/explorer/public.js CHANGED Viewed

@@ -1,5 +1,6 @@
 export { Explorer } from './adapters/inbound/Explorer';
 export { FileExplorer } from './adapters/inbound/FileExplorer';
 export { MediaExplorer } from './adapters/inbound/MediaExplorer';
+export { getExplorerNextFocusId } from './application/getExplorerNextFocusId';
 export { resolveExplorerSelection } from './application/resolveExplorerSelection';
 //# sourceMappingURL=public.js.map

package/dist/features/explorer/public.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"public.js","sourceRoot":"","sources":["../../../src/features/explorer/public.ts"],"names":[],"mappings":"~~AAQA~~,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC","sourcesContent":["export type {\n ExplorerActivateEvent,\n ExplorerItem,\n ExplorerItemKind,\n ExplorerProps,\n ExplorerSelectionChangeEvent,\n ExplorerSelectionMode,\n} from '../../types/explorer';\nexport { Explorer } from './adapters/inbound/Explorer';\nexport { FileExplorer } from './adapters/inbound/FileExplorer';\nexport { MediaExplorer } from './adapters/inbound/MediaExplorer';\nexport { resolveExplorerSelection } from './application/resolveExplorerSelection';\n"]}
1	+ {"version":3,"file":"public.js","sourceRoot":"","sources":["../../../src/features/explorer/public.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC","sourcesContent":["export type {\n ExplorerActivateEvent,\n ExplorerItem,\n ExplorerItemKind,\n ExplorerPageRequestEvent,\n ExplorerPermissionStatus,\n ExplorerProps,\n ExplorerSelectionChangeEvent,\n ExplorerSelectionMode,\n} from '../../types/explorer';\nexport { Explorer } from './adapters/inbound/Explorer';\nexport { FileExplorer } from './adapters/inbound/FileExplorer';\nexport { MediaExplorer } from './adapters/inbound/MediaExplorer';\nexport { getExplorerNextFocusId } from './application/getExplorerNextFocusId';\nexport { resolveExplorerSelection } from './application/resolveExplorerSelection';\n"]}

package/dist/features/grid-view/adapters/inbound/GridView.d.ts CHANGED Viewed

@@ -6,5 +6,5 @@ import type { GridViewProps } from '../../../../types/grid-view';
  * This first renderer uses nested native scroll regions. Only visible items are mounted;
  * logical cells and invisible elements are never rendered.
  */
-export declare function GridView({ items, contentWidth, contentHeight, width, height, zoom, overscanPixels, interactionPolicy, onViewportChange, renderItem, testID, }: GridViewProps): React.JSX.Element;
+export declare function GridView({ items, contentWidth, contentHeight, width, height, zoom, overscanPixels, focusedItemId, revealPaddingPixels, interactionPolicy, onViewportChange, onVisibleItemIdsChange, renderItem, testID, }: GridViewProps): React.JSX.Element;
 //# sourceMappingURL=GridView.d.ts.map

package/dist/features/grid-view/adapters/inbound/GridView.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"GridView.d.ts","sourceRoot":"","sources":["../../../../../src/features/grid-view/adapters/inbound/GridView.tsx"],"names":[],"mappings":"~~AACA~~,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,YAAY,EACZ,aAAa,EACb,KAAK,EACL,MAAM,EACN,IAAQ,EACR,cAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACV,MAAM,GACP,EAAE,aAAa,~~qBAsEf~~"}
1	+ {"version":3,"file":"GridView.d.ts","sourceRoot":"","sources":["../../../../../src/features/grid-view/adapters/inbound/GridView.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,YAAY,EACZ,aAAa,EACb,KAAK,EACL,MAAM,EACN,IAAQ,EACR,cAAoB,EACpB,aAAa,EACb,mBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,UAAU,EACV,MAAM,GACP,EAAE,aAAa,qBA8Gf"}

package/dist/features/grid-view/adapters/inbound/GridView.js CHANGED Viewed

@@ -1,4 +1,4 @@
-import { getVisibleGridItems, worldToViewport } from '@ankhorage/grid-view';
+import { getVisibleGridItems, revealWorldRect, worldToViewport, } from '@ankhorage/grid-view';
 import React from 'react';
 import { ScrollView as NativeScrollView, View as NativeView } from 'react-native';
 /***
@@ -7,9 +7,11 @@ import { ScrollView as NativeScrollView, View as NativeView } from 'react-native
  * 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, }) {
+export function GridView({ items, contentWidth, contentHeight, width, height, zoom = 1, overscanPixels = 160, focusedItemId, revealPaddingPixels = 8, interactionPolicy, onViewportChange, onVisibleItemIdsChange, renderItem, testID, }) {
     const [scrollX, setScrollX] = React.useState(0);
     const [scrollY, setScrollY] = React.useState(0);
+    const horizontalScrollRef = React.useRef(null);
+    const verticalScrollRef = React.useRef(null);
     const scale = Math.max(0.01, zoom);
     const viewport = React.useMemo(() => ({
         width,
@@ -20,11 +22,41 @@ export function GridView({ items, contentWidth, contentHeight, width, height, zo
         pixelsPerUnitY: scale,
     }), [height, scale, scrollX, scrollY, width]);
     const visibleItems = React.useMemo(() => getVisibleGridItems(items, viewport, overscanPixels), [items, overscanPixels, viewport]);
+    const viewportVisibleIds = React.useMemo(() => getVisibleGridItems(visibleItems, viewport).map((item) => item.id), [viewport, visibleItems]);
+    const previousVisibleIdsRef = React.useRef([]);
+    React.useEffect(() => {
+        if (!onVisibleItemIdsChange)
+            return;
+        const previous = previousVisibleIdsRef.current;
+        if (previous.length === viewportVisibleIds.length &&
+            previous.every((id, index) => id === viewportVisibleIds.at(index))) {
+            return;
+        }
+        previousVisibleIdsRef.current = viewportVisibleIds;
+        onVisibleItemIdsChange(viewportVisibleIds);
+    }, [onVisibleItemIdsChange, viewportVisibleIds]);
     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)}>
+    const viewportRef = React.useRef(viewport);
+    React.useEffect(() => {
+        viewportRef.current = viewport;
+    }, [viewport]);
+    React.useEffect(() => {
+        const currentViewport = viewportRef.current;
+        const focusedItem = items.find((item) => item.id === focusedItemId);
+        if (!focusedItem)
+            return;
+        const revealed = revealWorldRect(currentViewport, focusedItem, revealPaddingPixels);
+        if (revealed.offsetX !== currentViewport.offsetX) {
+            horizontalScrollRef.current?.scrollTo({ x: revealed.offsetX * scale, animated: true });
+        }
+        if (revealed.offsetY !== currentViewport.offsetY) {
+            verticalScrollRef.current?.scrollTo({ y: revealed.offsetY * scale, animated: true });
+        }
+    }, [focusedItemId, height, items, revealPaddingPixels, scale, width]);
+    return (<NativeScrollView ref={horizontalScrollRef} horizontal scrollEnabled={interactionPolicy !== 'passive'} scrollEventThrottle={32} showsHorizontalScrollIndicator style={{ width, height }} testID={testID} onScroll={(event) => setScrollX(event.nativeEvent.contentOffset.x)}>
+      <NativeScrollView ref={verticalScrollRef} 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 }, {

package/dist/features/grid-view/adapters/inbound/GridView.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"GridView.js","sourceRoot":"","sources":["../../../../../src/features/grid-view/adapters/inbound/GridView.tsx"],"names":[],"mappings":"AAAA,OAAO,~~EAAE~~,mBAAmB,~~EAAqB~~,eAAe,~~EAAE~~,MAAM,sBAAsB,CAAC;~~AAC/F~~,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,UAAU,IAAI,gBAAgB,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AAIlF;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,EACvB,KAAK,EACL,YAAY,EACZ,aAAa,EACb,KAAK,EACL,MAAM,EACN,IAAI,GAAG,CAAC,EACR,cAAc,GAAG,GAAG,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACV,MAAM,GACQ;IACd,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAC5B,GAAG,EAAE,CAAC,CAAC;QACL,KAAK;QACL,MAAM;QACN,OAAO,EAAE,OAAO,GAAG,KAAK;QACxB,OAAO,EAAE,OAAO,GAAG,KAAK;QACxB,cAAc,EAAE,KAAK;QACrB,cAAc,EAAE,KAAK;KACtB,CAAC,EACF,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CACzC,CAAC;IACF,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAChC,GAAG,EAAE,CAAC,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,cAAc,CAAC,EAC1D,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,CAAC,CAClC,CAAC;~~IAEF~~,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,gBAAgB,EAAE,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC,EAAE,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEjC,OAAO,CACL,CAAC,gBAAgB,CACf,UAAU,CACV,aAAa,CAAC,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAC/C,mBAAmB,CAAC,CAAC,EAAE,CAAC,CACxB,8BAA8B,CAC9B,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CACzB,MAAM,CAAC,CAAC,MAAM,CAAC,CACf,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAEnE;MAAA,CAAC,gBAAgB,CACf,aAAa,CAAC,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAC/C,mBAAmB,CAAC,CAAC,EAAE,CAAC,CACxB,4BAA4B,CAC5B,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,GAAG,KAAK,EAAE,MAAM,EAAE,CAAC,CAC/C,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAEnE;QAAA,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,GAAG,KAAK,EAAE,MAAM,EAAE,aAAa,GAAG,KAAK,EAAE,CAAC,CAChF;UAAA,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACzB,MAAM,QAAQ,GAAG,eAAe,CAC9B,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,EACxB;gBACE,GAAG,QAAQ;gBACX,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,CAAC;aACX,CACF,CAAC;YACF,OAAO,CACL,CAAC,UAAU,CACT,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CACb,KAAK,CAAC,CAAC;oBACL,QAAQ,EAAE,UAAU;oBACpB,IAAI,EAAE,QAAQ,CAAC,CAAC;oBAChB,GAAG,EAAE,QAAQ,CAAC,CAAC;oBACf,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,KAAK;oBACzB,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,KAAK;iBAC5B,CAAC,CAEF;gBAAA,CAAC,UAAU,CAAC,IAAI,CAAC,CACnB;cAAA,EAAE,UAAU,CAAC,CACd,CAAC;QACJ,CAAC,CAAC,CACJ;QAAA,EAAE,UAAU,CACd;MAAA,EAAE,gBAAgB,CACpB;IAAA,EAAE,gBAAgB,CAAC,CACpB,CAAC;AACJ,CAAC","sourcesContent":["import { getVisibleGridItems, type GridViewport, worldToViewport } from '@ankhorage/grid-view';\nimport React from 'react';\nimport { ScrollView as NativeScrollView, View as NativeView } from 'react-native';\n\nimport type { GridViewProps } from '../../../../types/grid-view';\n\n/**\n Renders world-positioned items on native and web using the canonical viewport/culling engine.\n \n This first renderer uses nested native scroll regions. Only visible items are mounted;\n * logical cells and invisible elements are never rendered.\n /\nexport function GridView({\n items,\n contentWidth,\n contentHeight,\n width,\n height,\n zoom = 1,\n overscanPixels = 160,\n interactionPolicy,\n onViewportChange,\n renderItem,\n testID,\n}: GridViewProps) {\n const [scrollX, setScrollX] = React.useState(0);\n const [scrollY, setScrollY] = React.useState(0);\n const scale = Math.max(0.01, zoom);\n const viewport = React.useMemo<GridViewport>(\n () => ({\n width,\n height,\n offsetX: scrollX / scale,\n offsetY: scrollY / scale,\n pixelsPerUnitX: scale,\n pixelsPerUnitY: scale,\n }),\n [height, scale, scrollX, scrollY, width],\n );\n const visibleItems = React.useMemo(\n () => getVisibleGridItems(items, viewport, overscanPixels),\n [items, overscanPixels, viewport],\n );\n\n React.useEffect(() => {\n onViewportChange?.(viewport);\n }, [onViewportChange, viewport]);\n\n return (\n <NativeScrollView\n horizontal\n scrollEnabled={interactionPolicy !== 'passive'}\n scrollEventThrottle={32}\n showsHorizontalScrollIndicator\n style={{ width, height }}\n testID={testID}\n onScroll={(event) => setScrollX(event.nativeEvent.contentOffset.x)}\n >\n <NativeScrollView\n scrollEnabled={interactionPolicy !== 'passive'}\n scrollEventThrottle={32}\n showsVerticalScrollIndicator\n style={{ width: contentWidth scale, height }}\n onScroll={(event) => setScrollY(event.nativeEvent.contentOffset.y)}\n >\n <NativeView style={{ width: contentWidth * scale, height: contentHeight * scale }}>\n {visibleItems.map((item) => {\n const position = worldToViewport(\n { x: item.x, y: item.y },\n {\n ...viewport,\n offsetX: 0,\n offsetY: 0,\n },\n );\n return (\n <NativeView\n key={item.id}\n style={{\n position: 'absolute',\n left: position.x,\n top: position.y,\n width: item.width * scale,\n height: item.height * scale,\n }}\n >\n {renderItem(item)}\n </NativeView>\n );\n })}\n </NativeView>\n </NativeScrollView>\n </NativeScrollView>\n );\n}\n"]}
1	+ {"version":3,"file":"GridView.js","sourceRoot":"","sources":["../../../../../src/features/grid-view/adapters/inbound/GridView.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n getVisibleGridItems,\n type GridViewport,\n revealWorldRect,\n worldToViewport,\n} from '@ankhorage/grid-view';\nimport React from 'react';\nimport { ScrollView as NativeScrollView, View as NativeView } from 'react-native';\n\nimport type { GridViewProps } from '../../../../types/grid-view';\n\n/**\n Renders world-positioned items on native and web using the canonical viewport/culling engine.\n \n This first renderer uses nested native scroll regions. Only visible items are mounted;\n * logical cells and invisible elements are never rendered.\n /\nexport function GridView({\n items,\n contentWidth,\n contentHeight,\n width,\n height,\n zoom = 1,\n overscanPixels = 160,\n focusedItemId,\n revealPaddingPixels = 8,\n interactionPolicy,\n onViewportChange,\n onVisibleItemIdsChange,\n renderItem,\n testID,\n}: GridViewProps) {\n const [scrollX, setScrollX] = React.useState(0);\n const [scrollY, setScrollY] = React.useState(0);\n const horizontalScrollRef = React.useRef<NativeScrollView>(null);\n const verticalScrollRef = React.useRef<NativeScrollView>(null);\n const scale = Math.max(0.01, zoom);\n const viewport = React.useMemo<GridViewport>(\n () => ({\n width,\n height,\n offsetX: scrollX / scale,\n offsetY: scrollY / scale,\n pixelsPerUnitX: scale,\n pixelsPerUnitY: scale,\n }),\n [height, scale, scrollX, scrollY, width],\n );\n const visibleItems = React.useMemo(\n () => getVisibleGridItems(items, viewport, overscanPixels),\n [items, overscanPixels, viewport],\n );\n const viewportVisibleIds = React.useMemo(\n () => getVisibleGridItems(visibleItems, viewport).map((item) => item.id),\n [viewport, visibleItems],\n );\n const previousVisibleIdsRef = React.useRef<readonly string[]>([]);\n\n React.useEffect(() => {\n if (!onVisibleItemIdsChange) return;\n const previous = previousVisibleIdsRef.current;\n if (\n previous.length === viewportVisibleIds.length &&\n previous.every((id, index) => id === viewportVisibleIds.at(index))\n ) {\n return;\n }\n previousVisibleIdsRef.current = viewportVisibleIds;\n onVisibleItemIdsChange(viewportVisibleIds);\n }, [onVisibleItemIdsChange, viewportVisibleIds]);\n\n React.useEffect(() => {\n onViewportChange?.(viewport);\n }, [onViewportChange, viewport]);\n\n const viewportRef = React.useRef(viewport);\n React.useEffect(() => {\n viewportRef.current = viewport;\n }, [viewport]);\n\n React.useEffect(() => {\n const currentViewport = viewportRef.current;\n const focusedItem = items.find((item) => item.id === focusedItemId);\n if (!focusedItem) return;\n const revealed = revealWorldRect(currentViewport, focusedItem, revealPaddingPixels);\n if (revealed.offsetX !== currentViewport.offsetX) {\n horizontalScrollRef.current?.scrollTo({ x: revealed.offsetX scale, animated: true });\n }\n if (revealed.offsetY !== currentViewport.offsetY) {\n verticalScrollRef.current?.scrollTo({ y: revealed.offsetY * scale, animated: true });\n }\n }, [focusedItemId, height, items, revealPaddingPixels, scale, width]);\n\n return (\n <NativeScrollView\n ref={horizontalScrollRef}\n horizontal\n scrollEnabled={interactionPolicy !== 'passive'}\n scrollEventThrottle={32}\n showsHorizontalScrollIndicator\n style={{ width, height }}\n testID={testID}\n onScroll={(event) => setScrollX(event.nativeEvent.contentOffset.x)}\n >\n <NativeScrollView\n ref={verticalScrollRef}\n scrollEnabled={interactionPolicy !== 'passive'}\n scrollEventThrottle={32}\n showsVerticalScrollIndicator\n style={{ width: contentWidth * scale, height }}\n onScroll={(event) => setScrollY(event.nativeEvent.contentOffset.y)}\n >\n <NativeView style={{ width: contentWidth * scale, height: contentHeight * scale }}>\n {visibleItems.map((item) => {\n const position = worldToViewport(\n { x: item.x, y: item.y },\n {\n ...viewport,\n offsetX: 0,\n offsetY: 0,\n },\n );\n return (\n <NativeView\n key={item.id}\n style={{\n position: 'absolute',\n left: position.x,\n top: position.y,\n width: item.width * scale,\n height: item.height * scale,\n }}\n >\n {renderItem(item)}\n </NativeView>\n );\n })}\n </NativeView>\n </NativeScrollView>\n </NativeScrollView>\n );\n}\n"]}

package/dist/features/grid-view/adapters/inbound/TileGrid.d.ts CHANGED Viewed

@@ -1,5 +1,5 @@
 import React from 'react';
 import type { TileGridProps } from '../../../../types/grid-view';
 /*** Composes a responsive, virtualized tile presentation over the generic GridView renderer. */
-export declare function TileGrid({ items, width, height, tileSize, gap, zoom, overscanPixels, renderItem, interactionPolicy, testID, }: TileGridProps): React.JSX.Element;
+export declare function TileGrid({ items, width, height, tileSize, gap, zoom, overscanPixels, focusedItemId, revealPaddingPixels, onColumnsChange, onVisibleItemIdsChange, renderItem, interactionPolicy, testID, }: TileGridProps): React.JSX.Element;
 //# sourceMappingURL=TileGrid.d.ts.map

package/dist/features/grid-view/adapters/inbound/TileGrid.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"TileGrid.d.ts","sourceRoot":"","sources":["../../../../../src/features/grid-view/adapters/inbound/TileGrid.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAIjE,gGAAgG;AAChG,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,KAAK,EACL,MAAY,EACZ,QAAc,EACd,GAAQ,EACR,IAAQ,EACR,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,MAAM,GACP,EAAE,aAAa,~~qBAiCf~~"}
1	+ {"version":3,"file":"TileGrid.d.ts","sourceRoot":"","sources":["../../../../../src/features/grid-view/adapters/inbound/TileGrid.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAIjE,gGAAgG;AAChG,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,KAAK,EACL,MAAY,EACZ,QAAc,EACd,GAAQ,EACR,IAAQ,EACR,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,UAAU,EACV,iBAAiB,EACjB,MAAM,GACP,EAAE,aAAa,qBAwCf"}

package/dist/features/grid-view/adapters/inbound/TileGrid.js CHANGED Viewed

@@ -3,16 +3,20 @@ import { View as NativeView } from 'react-native';
 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, }) {
+export function TileGrid({ items, width, height = 440, tileSize = 120, gap = 12, zoom = 1, overscanPixels, focusedItemId, revealPaddingPixels, onColumnsChange, onVisibleItemIdsChange, renderItem, interactionPolicy, testID, }) {
     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]);
+    React.useEffect(() => {
+        if (resolvedWidth > 0)
+            onColumnsChange?.(layout.columns);
+    }, [layout.columns, onColumnsChange, resolvedWidth]);
     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) => {
+      {resolvedWidth > 0 ? (<GridView contentHeight={layout.height} contentWidth={Math.max(resolvedWidth / zoom, layout.width)} height={height} focusedItemId={focusedItemId} interactionPolicy={interactionPolicy} items={layout.items} onVisibleItemIdsChange={onVisibleItemIdsChange} overscanPixels={overscanPixels} renderItem={(item) => {
                 const source = itemLookup.get(item.id);
                 return source ? renderItem(source) : null;
-            }} width={resolvedWidth} zoom={zoom}/>) : null}
+            }} revealPaddingPixels={revealPaddingPixels} width={resolvedWidth} zoom={zoom}/>) : null}
     </NativeView>);
 }
 //# sourceMappingURL=TileGrid.js.map

package/dist/features/grid-view/adapters/inbound/TileGrid.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"TileGrid.js","sourceRoot":"","sources":["../../../../../src/features/grid-view/adapters/inbound/TileGrid.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AAGlD,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,gGAAgG;AAChG,MAAM,UAAU,QAAQ,CAAC,EACvB,KAAK,EACL,KAAK,EACL,MAAM,GAAG,GAAG,EACZ,QAAQ,GAAG,GAAG,EACd,GAAG,GAAG,EAAE,EACR,IAAI,GAAG,CAAC,EACR,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,MAAM,GACQ;IACd,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC5D,MAAM,aAAa,GAAG,KAAK,IAAI,aAAa,CAAC;IAC7C,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAC1B,GAAG,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,CAAC,EAC/D,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,CAAC,CAC5C,CAAC;IACF,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAE/F,OAAO,CACL,CAAC,UAAU,CACT,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CACtE,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAC7C,MAAM,CAAC,CAAC,MAAM,CAAC,CAEf;MAAA,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,CACnB,CAAC,QAAQ,CACP,aAAa,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAC7B,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAC3D,MAAM,CAAC,CAAC,MAAM,CAAC,CACf,iBAAiB,CAAC,CAAC,iBAAiB,CAAC,CACrC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACpB,cAAc,CAAC,CAAC,cAAc,CAAC,CAC/B,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE;gBACnB,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACvC,OAAO,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC5C,CAAC,CAAC,CACF,KAAK,CAAC,CAAC,aAAa,CAAC,CACrB,IAAI,CAAC,CAAC,IAAI,CAAC,EACX,CACH,CAAC,CAAC,CAAC,IAAI,CACV;IAAA,EAAE,UAAU,CAAC,CACd,CAAC;AACJ,CAAC","sourcesContent":["import React from 'react';\nimport { View as NativeView } from 'react-native';\n\nimport type { TileGridProps } from '../../../../types/grid-view';\nimport { layoutTileGrid } from '../../application/layoutTileGrid';\nimport { GridView } from './GridView';\n\n/*** Composes a responsive, virtualized tile presentation over the generic GridView renderer. */\nexport function TileGrid({\n items,\n width,\n height = 440,\n tileSize = 120,\n gap = 12,\n zoom = 1,\n overscanPixels,\n renderItem,\n interactionPolicy,\n testID,\n}: TileGridProps) {\n const [measuredWidth, setMeasuredWidth] = React.useState(0);\n const resolvedWidth = width ?? measuredWidth;\n const layout = React.useMemo(\n () => layoutTileGrid(items, resolvedWidth, tileSize, gap, zoom),\n [items, resolvedWidth, tileSize, gap, zoom],\n );\n const itemLookup = React.useMemo(() => new Map(items.map((item) => [item.id, item])), [items]);\n\n return (\n <NativeView\n onLayout={(event) => setMeasuredWidth(event.nativeEvent.layout.width)}\n style={{ width, height, overflow: 'hidden' }}\n testID={testID}\n >\n {resolvedWidth > 0 ? (\n <GridView\n contentHeight={layout.height}\n contentWidth={Math.max(resolvedWidth / zoom, layout.width)}\n height={height}\n interactionPolicy={interactionPolicy}\n items={layout.items}\n overscanPixels={overscanPixels}\n renderItem={(item) => {\n const source = itemLookup.get(item.id);\n return source ? renderItem(source) : null;\n }}\n width={resolvedWidth}\n zoom={zoom}\n />\n ) : null}\n </NativeView>\n );\n}\n"]}
1	+ {"version":3,"file":"TileGrid.js","sourceRoot":"","sources":["../../../../../src/features/grid-view/adapters/inbound/TileGrid.tsx"],"names":[],"mappings":"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","sourcesContent":["import React from 'react';\nimport { View as NativeView } from 'react-native';\n\nimport type { TileGridProps } from '../../../../types/grid-view';\nimport { layoutTileGrid } from '../../application/layoutTileGrid';\nimport { GridView } from './GridView';\n\n/*** Composes a responsive, virtualized tile presentation over the generic GridView renderer. */\nexport function TileGrid({\n items,\n width,\n height = 440,\n tileSize = 120,\n gap = 12,\n zoom = 1,\n overscanPixels,\n focusedItemId,\n revealPaddingPixels,\n onColumnsChange,\n onVisibleItemIdsChange,\n renderItem,\n interactionPolicy,\n testID,\n}: TileGridProps) {\n const [measuredWidth, setMeasuredWidth] = React.useState(0);\n const resolvedWidth = width ?? measuredWidth;\n const layout = React.useMemo(\n () => layoutTileGrid(items, resolvedWidth, tileSize, gap, zoom),\n [items, resolvedWidth, tileSize, gap, zoom],\n );\n const itemLookup = React.useMemo(() => new Map(items.map((item) => [item.id, item])), [items]);\n\n React.useEffect(() => {\n if (resolvedWidth > 0) onColumnsChange?.(layout.columns);\n }, [layout.columns, onColumnsChange, resolvedWidth]);\n\n return (\n <NativeView\n onLayout={(event) => setMeasuredWidth(event.nativeEvent.layout.width)}\n style={{ width, height, overflow: 'hidden' }}\n testID={testID}\n >\n {resolvedWidth > 0 ? (\n <GridView\n contentHeight={layout.height}\n contentWidth={Math.max(resolvedWidth / zoom, layout.width)}\n height={height}\n focusedItemId={focusedItemId}\n interactionPolicy={interactionPolicy}\n items={layout.items}\n onVisibleItemIdsChange={onVisibleItemIdsChange}\n overscanPixels={overscanPixels}\n renderItem={(item) => {\n const source = itemLookup.get(item.id);\n return source ? renderItem(source) : null;\n }}\n revealPaddingPixels={revealPaddingPixels}\n width={resolvedWidth}\n zoom={zoom}\n />\n ) : null}\n </NativeView>\n );\n}\n"]}

package/dist/types/explorer.d.ts CHANGED Viewed

@@ -14,12 +14,18 @@ export interface ExplorerItem {
     readonly disabled?: boolean;
 }
 export type ExplorerSelectionMode = 'single' | 'multi';
+/** Provider-owned access state projected into the portable explorer presentation. */
+export type ExplorerPermissionStatus = 'granted' | 'limited' | 'denied' | 'unavailable';
 export interface ExplorerActivateEvent {
     readonly id: string;
 }
 export interface ExplorerSelectionChangeEvent {
     readonly selectedIds: readonly string[];
 }
+/** Requests the next provider page without exposing a provider cursor or native object. */
+export interface ExplorerPageRequestEvent {
+    readonly loadedItemCount: number;
+}
 export interface ExplorerProps extends ZoraBaseProps {
     items: readonly ExplorerItem[];
     selectionMode?: ExplorerSelectionMode;
@@ -32,6 +38,28 @@ export interface ExplorerProps extends ZoraBaseProps {
     tileSize?: number;
     zoom?: number;
     loading?: boolean;
+    /** Provider paging remains application-owned; Explorer only requests the next page near its end. */
+    hasMore?: boolean;
+    loadingMore?: boolean;
+    /**
+     * Stable serializable identity for a provider collection.
+     *
+     * Supply this whenever paging is enabled so a replacement collection with the same number of
+     * loaded rows receives its own initial page request.
+     */
+    pagingCollectionId?: string;
+    /**
+     * Provider-controlled retry token for the current page boundary.
+     *
+     * Change this after a failed request to permit one deliberate retry without causing automatic
+     * retry loops.
+     */
+    pagingRetryToken?: string;
+    onLoadMore?: (event: ExplorerPageRequestEvent) => void;
+    /** Never pass a native permission object through this presentation boundary. */
+    permissionStatus?: ExplorerPermissionStatus;
+    permissionText?: string;
+    onRequestPermission?: () => void;
     errorText?: string;
     emptyText?: string;
     disabled?: boolean;

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

	@@ -1 +1 @@
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"}
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,qFAAqF;AACrF,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,aAAa,CAAC;AAExF,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,2FAA2F;AAC3F,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;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,oGAAoG;IACpG,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,IAAI,CAAC;IACvD,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAC;IACjC,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.map CHANGED Viewed

	@@ -1 +1 @@
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"]}
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\n/* Provider-owned access state projected into the portable explorer presentation. /\nexport type ExplorerPermissionStatus = 'granted' \| 'limited' \| 'denied' \| 'unavailable';\n\nexport interface ExplorerActivateEvent {\n readonly id: string;\n}\n\nexport interface ExplorerSelectionChangeEvent {\n readonly selectedIds: readonly string[];\n}\n\n/* Requests the next provider page without exposing a provider cursor or native object. /\nexport interface ExplorerPageRequestEvent {\n readonly loadedItemCount: number;\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 /* Provider paging remains application-owned; Explorer only requests the next page near its end. /\n hasMore?: boolean;\n loadingMore?: boolean;\n /\n Stable serializable identity for a provider collection.\n \n Supply this whenever paging is enabled so a replacement collection with the same number of\n * loaded rows receives its own initial page request.\n /\n pagingCollectionId?: string;\n /\n Provider-controlled retry token for the current page boundary.\n \n Change this after a failed request to permit one deliberate retry without causing automatic\n * retry loops.\n /\n pagingRetryToken?: string;\n onLoadMore?: (event: ExplorerPageRequestEvent) => void;\n /* Never pass a native permission object through this presentation boundary. */\n permissionStatus?: ExplorerPermissionStatus;\n permissionText?: string;\n onRequestPermission?: () => void;\n errorText?: string;\n emptyText?: string;\n disabled?: boolean;\n readOnly?: boolean;\n}\n"]}

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

@@ -10,7 +10,12 @@ export interface GridViewProps extends ZoraBaseProps {
     height: number;
     zoom?: number;
     overscanPixels?: number;
+    /** Stable item identity that must be scrolled into view without duplicating viewport geometry. */
+    focusedItemId?: string;
+    /** Pixel inset retained around a revealed focused item. */
+    revealPaddingPixels?: number;
     onViewportChange?: (viewport: GridViewport) => void;
+    onVisibleItemIdsChange?: (ids: readonly string[]) => void;
     renderItem: (item: GridRectItem) => React.ReactNode;
 }
 /** An item needs a stable ID; visual positioning belongs to the TileGrid composition. */
@@ -26,6 +31,11 @@ export interface TileGridProps extends ZoraBaseProps {
     gap?: number;
     zoom?: number;
     overscanPixels?: number;
+    focusedItemId?: string;
+    revealPaddingPixels?: number;
+    /** Reports the same measured column count used to position tiles. */
+    onColumnsChange?: (columns: number) => void;
+    onVisibleItemIdsChange?: (ids: readonly string[]) => void;
     renderItem: (item: TileGridItem) => React.ReactNode;
 }
 //# sourceMappingURL=grid-view.d.ts.map

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

	@@ -1 +1 @@
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"}
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,kGAAkG;IAClG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;IACpD,sBAAsB,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;IAC1D,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,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,qEAAqE;IACrE,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,sBAAsB,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;IAC1D,UAAU,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,KAAK,CAAC,SAAS,CAAC;CACrD"}

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

	@@ -1 +1 @@
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"]}
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 /* Stable item identity that must be scrolled into view without duplicating viewport geometry. /\n focusedItemId?: string;\n /* Pixel inset retained around a revealed focused item. /\n revealPaddingPixels?: number;\n onViewportChange?: (viewport: GridViewport) => void;\n onVisibleItemIdsChange?: (ids: readonly string[]) => 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 focusedItemId?: string;\n revealPaddingPixels?: number;\n /* Reports the same measured column count used to position tiles. */\n onColumnsChange?: (columns: number) => void;\n onVisibleItemIdsChange?: (ids: readonly string[]) => void;\n renderItem: (item: TileGridItem) => React.ReactNode;\n}\n"]}

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/zora",
   "type": "module",
-  "version": "25.0.1",
+  "version": "25.2.0",
   "description": "Opinionated React Native and React Native Web UI kit built on @ankhorage/surface.",
   "homepage": "https://github.com/ankhorage/zora#readme",
   "bugs": {