npm - @ankhorage/zora - Versions diffs - 25.6.2 → 25.8.0 - Mend

@ankhorage/zora 25.6.2 → 25.8.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 (295) hide show

package/dist/features/matrix-grid/adapters/inbound/MatrixGrid.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"MatrixGrid.d.ts","sourceRoot":"","sources":["../../../../../src/features/matrix-grid/adapters/inbound/MatrixGrid.tsx"],"names":[],"mappings":"~~AAMA~~,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;~~AAmIrE~~,gGAAgG;AAChG,eAAO,MAAM,UAAU,uDAAsC,CAAC"}
1	+ {"version":3,"file":"MatrixGrid.d.ts","sourceRoot":"","sources":["../../../../../src/features/matrix-grid/adapters/inbound/MatrixGrid.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AA4NrE,gGAAgG;AAChG,eAAO,MAAM,UAAU,uDAAsC,CAAC"}

package/dist/features/matrix-grid/adapters/inbound/MatrixGrid.js CHANGED Viewed

@@ -1,55 +1,109 @@
-import { getVisibleMatrixCells, } from '@ankhorage/grid-view';
-import { Pressable } from '@ankhorage/surface';
+import { getMatrixCellPlacement, getVisibleMatrixCells, } from '@ankhorage/grid-view';
+import { isRecord } from '@ankhorage/utility/object';
 import React from 'react';
-import { StyleSheet, View } from 'react-native';
+import { Platform, Pressable as NativePressable, StyleSheet, View } from 'react-native';
 import { GridView } from '../../../grid-view/public';
 import { resolveSelectionEventIntent } from '../../../selection/public';
 import { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';
 import { useZoraTheme } from '../../../theme/composition/useZoraTheme';
+import { createMatrixGridSparseIndex } from '../../application/createMatrixGridSparseIndex';
 import { resolveMatrixGridContentSize } from '../../application/resolveMatrixGridContentSize';
 import { resolveMatrixGridSelection } from '../../application/resolveMatrixGridSelection';
+import { MatrixGridKeyboardProxy } from './MatrixGridKeyboardProxy';
+import { useMatrixGridKeyboardFocus } from './useMatrixGridKeyboardFocus';
 /*** Compose the canonical GridView around released sparse matrix placement and culling geometry. */
-function MatrixGridInner({ accessibilityLabel = 'Matrix grid', cells, height, interactionPolicy, layout, onSelectionChange, onViewportChange, overscanPixels = 160, renderCell, selectedCellIds = [], selectionMode = 'single', testID, viewport: controlledViewport, width, zoomX = 1, zoomY = 1, }) {
+function MatrixGridInner({ accessibilityLabel = 'Matrix grid', cells, height, interactionPolicy, layout, onSelectionChange, onViewportChange, overscanPixels = 160, readOnly = false, renderCell, selectedCellIds = [], selectionMode = 'single', testID, viewport: controlledViewport, width, zoomX = 1, zoomY = 1, }) {
     const { theme } = useZoraTheme();
     const contentSize = React.useMemo(() => resolveMatrixGridContentSize(layout), [layout]);
     const initialViewport = React.useMemo(() => ({ height, offsetX: 0, offsetY: 0, pixelsPerUnitX: zoomX, pixelsPerUnitY: zoomY, width }), [height, width, zoomX, zoomY]);
     const [uncontrolledViewport, setUncontrolledViewport] = React.useState(initialViewport);
     const viewport = controlledViewport ?? uncontrolledViewport;
-    const visibleCells = React.useMemo(() => getVisibleMatrixCells(layout, cells, viewport, overscanPixels), [cells, layout, overscanPixels, viewport]);
-    const visibleCellById = React.useMemo(() => new Map(visibleCells.map((cell) => [cell.id, cell])), [visibleCells]);
+    const sparseIndex = React.useMemo(() => createMatrixGridSparseIndex(layout, cells), [cells, layout]);
+    const cellPlacements = React.useMemo(() => getVisibleMatrixCells(layout, cells, viewport, overscanPixels), [cells, layout, overscanPixels, viewport]);
+    const [visibleIds, setVisibleIds] = React.useState([]);
+    const anchorId = React.useRef(null);
     const handleViewportChange = React.useCallback((proposal) => {
         if (controlledViewport === undefined)
             setUncontrolledViewport(proposal);
         onViewportChange?.(proposal);
     }, [controlledViewport, onViewportChange]);
     const activateCell = React.useCallback((cell, event) => {
-        if (interactionPolicy === 'passive')
+        if (interactionPolicy === 'passive' || readOnly)
             return;
-        const intent = resolveSelectionEventIntent(event, 'pointer');
-        onSelectionChange?.(resolveMatrixGridSelection(selectedCellIds, cell.id, intent, selectionMode));
-    }, [interactionPolicy, onSelectionChange, selectedCellIds, selectionMode]);
+        const intent = isRangeSelectionEvent(event)
+            ? 'range'
+            : resolveSelectionEventIntent(event, 'pointer');
+        onSelectionChange?.(resolveMatrixGridSelection(sparseIndex.entries, selectedCellIds, cell.id, anchorId.current, intent, selectionMode));
+        if (intent !== 'range')
+            anchorId.current = cell.id;
+    }, [
+        interactionPolicy,
+        onSelectionChange,
+        readOnly,
+        selectedCellIds,
+        selectionMode,
+        sparseIndex.entries,
+    ]);
+    const handleKeyboardNavigation = React.useCallback((targetId, originId, shiftKey) => {
+        anchorId.current ??= originId;
+        if (!shiftKey)
+            return;
+        const cell = sparseIndex.cellById.get(targetId);
+        if (cell)
+            activateCell(getMatrixCellPlacement(layout, cell), { shiftKey: true });
+    }, [activateCell, layout, sparseIndex]);
+    const keyboard = useMatrixGridKeyboardFocus(sparseIndex, interactionPolicy === 'passive', visibleIds, handleKeyboardNavigation);
+    const focusedPlacement = React.useMemo(() => {
+        const focusedCell = keyboard.focusedId === null ? undefined : sparseIndex.cellById.get(keyboard.focusedId);
+        return focusedCell ? getMatrixCellPlacement(layout, focusedCell) : undefined;
+    }, [keyboard.focusedId, layout, sparseIndex.cellById]);
+    const gridItems = React.useMemo(() => focusedPlacement && !cellPlacements.some((cell) => cell.id === focusedPlacement.id)
+        ? [...cellPlacements, focusedPlacement]
+        : cellPlacements, [cellPlacements, focusedPlacement]);
+    const cellById = React.useMemo(() => new Map(gridItems.map((cell) => [cell.id, cell])), [gridItems]);
     return (<View accessibilityLabel={accessibilityLabel}>
-      <GridView contentHeight={contentSize.height} contentWidth={contentSize.width} height={height} interactionPolicy={interactionPolicy} items={visibleCells} overscanPixels={0} renderItem={(item) => {
-            const cell = visibleCellById.get(item.id);
+      <GridView contentHeight={contentSize.height} contentWidth={contentSize.width} height={height} interactionPolicy={interactionPolicy} items={gridItems} focusedItemId={keyboard.focusedId ?? undefined} overscanPixels={0} onVisibleItemIdsChange={setVisibleIds} renderItem={(item) => {
+            const cell = cellById.get(item.id);
             if (!cell)
                 return null;
-            return renderMatrixCell(cell, selectedCellIds, theme.semantics.neutral.divider, theme.colors.primary, renderCell, activateCell, testID);
+            return renderMatrixCell(cell, selectedCellIds, theme.semantics.neutral.divider, theme.colors.primary, renderCell, activateCell, keyboard, interactionPolicy === 'passive', readOnly, testID);
         }} testID={testID} viewport={viewport} width={width} onViewportChange={handleViewportChange}/>
     </View>);
 }
 /*** Render one positioned sparse cell with native/web accessible selection semantics. */
-function renderMatrixCell(cell, selectedCellIds, dividerColor, selectedColor, renderCell, activateCell, testID) {
+function renderMatrixCell(cell, selectedCellIds, dividerColor, selectedColor, renderCell, activateCell, keyboard, passive, readOnly, testID) {
     const selected = selectedCellIds.includes(cell.id);
-    return (<Pressable key={cell.id} accessibilityLabel={`Cell ${cell.id}`} accessibilityRole="button" accessibilityState={{ selected }} style={[
+    const canInteract = keyboard.tabStopId === cell.id;
+    return (<MatrixGridKeyboardProxy onKeyDown={(event) => {
+            if (keyboard.onKeyDown(cell.id, event.key, event.shiftKey))
+                return true;
+            if (!['Enter', ' '].includes(event.key))
+                return false;
+            if (passive || readOnly)
+                return false;
+            activateCell(cell, event);
+            return true;
+        }}>
+      <NativePressable key={cell.id} accessibilityActions={[{ name: 'activate' }]} accessibilityLabel={`Cell ${cell.id}`} accessibilityRole="button" accessibilityState={{ disabled: passive, selected }} disabled={passive} focusable={Platform.OS !== 'web' || canInteract} style={[
             styles.cell,
             {
-                borderColor: selected ? selectedColor : dividerColor,
+                borderColor: selected || keyboard.focusedId === cell.id ? selectedColor : dividerColor,
                 height: '100%',
                 width: '100%',
             },
-        ]} testID={testID === undefined ? undefined : `${testID}-cell-${cell.id}`} onPress={(event) => activateCell(cell, event)}>
-      {renderCell(cell)}
-    </Pressable>);
+        ]} testID={testID === undefined ? undefined : `${testID}-cell-${cell.id}`} onAccessibilityAction={() => activateCell(cell, {})} onFocus={() => keyboard.onFocus(cell.id)} onPress={(event) => activateCell(cell, event)} ref={(node) => keyboard.registerCell(cell.id, node)}>
+        {renderCell(cell)}
+      </NativePressable>
+    </MatrixGridKeyboardProxy>);
+}
+/*** Recognize range intent without changing the shared replace-or-toggle selection contract. */
+function isRangeSelectionEvent(event) {
+    if (!isRecord(event))
+        return false;
+    if (event.shiftKey === true)
+        return true;
+    return ((isRecord(event.nativeEvent) && event.nativeEvent.shiftKey === true) ||
+        (isRecord(event.originalEvent) && event.originalEvent.shiftKey === true));
 }
 const styles = StyleSheet.create({
     cell: { borderWidth: 1, height: '100%', overflow: 'hidden', width: '100%' },

package/dist/features/matrix-grid/adapters/inbound/MatrixGrid.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"MatrixGrid.js","sourceRoot":"","sources":["../../../../../src/features/matrix-grid/adapters/inbound/MatrixGrid.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n getVisibleMatrixCells,\n type GridMatrixCellPlacement,\n type GridViewport,\n} from '@ankhorage/grid-view';\nimport { Pressable } from '@ankhorage/surface';\nimport React from 'react';\nimport { StyleSheet, View } from 'react-native';\n\nimport type { MatrixGridProps } from '../../../../types/matrix-grid';\nimport { GridView } from '../../../grid-view/public';\nimport { resolveSelectionEventIntent } from '../../../selection/public';\nimport { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';\nimport { useZoraTheme } from '../../../theme/composition/useZoraTheme';\nimport { resolveMatrixGridContentSize } from '../../application/resolveMatrixGridContentSize';\nimport { resolveMatrixGridSelection } from '../../application/resolveMatrixGridSelection';\n\n/*** Compose the canonical GridView around released sparse matrix placement and culling geometry. /\nfunction MatrixGridInner({\n accessibilityLabel = 'Matrix grid',\n cells,\n height,\n interactionPolicy,\n layout,\n onSelectionChange,\n onViewportChange,\n overscanPixels = 160,\n renderCell,\n selectedCellIds = [],\n selectionMode = 'single',\n testID,\n viewport: controlledViewport,\n width,\n zoomX = 1,\n zoomY = 1,\n}: MatrixGridProps) {\n const { theme } = useZoraTheme();\n const contentSize = React.useMemo(() => resolveMatrixGridContentSize(layout), [layout]);\n const initialViewport = React.useMemo<GridViewport>(\n () => ({ height, offsetX: 0, offsetY: 0, pixelsPerUnitX: zoomX, pixelsPerUnitY: zoomY, width }),\n [height, width, zoomX, zoomY],\n );\n const [uncontrolledViewport, setUncontrolledViewport] = React.useState(initialViewport);\n const viewport = controlledViewport ?? uncontrolledViewport;\n const visibleCells = React.useMemo(\n () => getVisibleMatrixCells(layout, cells, viewport, overscanPixels),\n [cells, layout, overscanPixels, viewport],\n );\n\n const visibleCellById = React.useMemo(\n () => new Map(visibleCells.map((cell) => [cell.id, cell])),\n [visibleCells],\n );\n\n const handleViewportChange = React.useCallback(\n (proposal: GridViewport) => {\n if (controlledViewport === undefined) setUncontrolledViewport(proposal);\n onViewportChange?.(proposal);\n },\n [controlledViewport, onViewportChange],\n );\n\n const activateCell = React.useCallback(\n (cell: GridMatrixCellPlacement, event: unknown) => {\n if (interactionPolicy === 'passive') return;\n const intent = resolveSelectionEventIntent(event, 'pointer');\n onSelectionChange?.(\n resolveMatrixGridSelection(selectedCellIds, cell.id, intent, selectionMode),\n );\n },\n [interactionPolicy, onSelectionChange, selectedCellIds, selectionMode],\n );\n return (\n <View accessibilityLabel={accessibilityLabel}>\n <GridView\n contentHeight={contentSize.height}\n contentWidth={contentSize.width}\n height={height}\n interactionPolicy={interactionPolicy}\n items={visibleCells}\n overscanPixels={0}\n renderItem={(item) => {\n const cell = visibleCellById.get(item.id);\n if (!cell) return null;\n return renderMatrixCell(\n cell,\n selectedCellIds,\n theme.semantics.neutral.divider,\n theme.colors.primary,\n renderCell,\n activateCell,\n testID,\n );\n }}\n testID={testID}\n viewport={viewport}\n width={width}\n onViewportChange={handleViewportChange}\n />\n </View>\n );\n}\n\n/** Render one positioned sparse cell with native/web accessible selection semantics. /\nfunction renderMatrixCell(\n cell: GridMatrixCellPlacement,\n selectedCellIds: readonly string[],\n dividerColor: string,\n selectedColor: string,\n renderCell: MatrixGridProps['renderCell'],\n activateCell: (cell: GridMatrixCellPlacement, event: unknown) => void,\n testID: string \| undefined,\n) {\n const selected = selectedCellIds.includes(cell.id);\n return (\n <Pressable\n key={cell.id}\n accessibilityLabel={`Cell ${cell.id}`}\n accessibilityRole=\"button\"\n accessibilityState={{ selected }}\n style={[\n styles.cell,\n {\n borderColor: selected ? selectedColor : dividerColor,\n height: '100%',\n width: '100%',\n },\n ]}\n testID={testID === undefined ? undefined : `${testID}-cell-${cell.id}`}\n onPress={(event) => activateCell(cell, event)}\n >\n {renderCell(cell)}\n </Pressable>\n );\n}\n\nconst styles = StyleSheet.create({\n cell: { borderWidth: 1, height: '100%', overflow: 'hidden', width: '100%' },\n});\n\n/** A code-first generic sparse matrix grid; formulas and domain vocabulary remain external. */\nexport const MatrixGrid = withZoraThemeScope(MatrixGridInner);\n"]}
1	+ {"version":3,"file":"MatrixGrid.js","sourceRoot":"","sources":["../../../../../src/features/matrix-grid/adapters/inbound/MatrixGrid.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n getMatrixCellPlacement,\n getVisibleMatrixCells,\n type GridMatrixCellPlacement,\n type GridViewport,\n} from '@ankhorage/grid-view';\nimport { isRecord } from '@ankhorage/utility/object';\nimport React from 'react';\nimport { Platform, Pressable as NativePressable, StyleSheet, View } from 'react-native';\n\nimport type { MatrixGridProps } from '../../../../types/matrix-grid';\nimport { GridView } from '../../../grid-view/public';\nimport { resolveSelectionEventIntent } from '../../../selection/public';\nimport { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';\nimport { useZoraTheme } from '../../../theme/composition/useZoraTheme';\nimport { createMatrixGridSparseIndex } from '../../application/createMatrixGridSparseIndex';\nimport { resolveMatrixGridContentSize } from '../../application/resolveMatrixGridContentSize';\nimport { resolveMatrixGridSelection } from '../../application/resolveMatrixGridSelection';\nimport { MatrixGridKeyboardProxy } from './MatrixGridKeyboardProxy';\nimport { useMatrixGridKeyboardFocus } from './useMatrixGridKeyboardFocus';\n\n/*** Compose the canonical GridView around released sparse matrix placement and culling geometry. /\nfunction MatrixGridInner({\n accessibilityLabel = 'Matrix grid',\n cells,\n height,\n interactionPolicy,\n layout,\n onSelectionChange,\n onViewportChange,\n overscanPixels = 160,\n readOnly = false,\n renderCell,\n selectedCellIds = [],\n selectionMode = 'single',\n testID,\n viewport: controlledViewport,\n width,\n zoomX = 1,\n zoomY = 1,\n}: MatrixGridProps) {\n const { theme } = useZoraTheme();\n const contentSize = React.useMemo(() => resolveMatrixGridContentSize(layout), [layout]);\n const initialViewport = React.useMemo<GridViewport>(\n () => ({ height, offsetX: 0, offsetY: 0, pixelsPerUnitX: zoomX, pixelsPerUnitY: zoomY, width }),\n [height, width, zoomX, zoomY],\n );\n const [uncontrolledViewport, setUncontrolledViewport] = React.useState(initialViewport);\n const viewport = controlledViewport ?? uncontrolledViewport;\n const sparseIndex = React.useMemo(\n () => createMatrixGridSparseIndex(layout, cells),\n [cells, layout],\n );\n const cellPlacements = React.useMemo(\n () => getVisibleMatrixCells(layout, cells, viewport, overscanPixels),\n [cells, layout, overscanPixels, viewport],\n );\n const [visibleIds, setVisibleIds] = React.useState<readonly string[]>([]);\n const anchorId = React.useRef<string \| null>(null);\n\n const handleViewportChange = React.useCallback(\n (proposal: GridViewport) => {\n if (controlledViewport === undefined) setUncontrolledViewport(proposal);\n onViewportChange?.(proposal);\n },\n [controlledViewport, onViewportChange],\n );\n\n const activateCell = React.useCallback(\n (cell: GridMatrixCellPlacement, event: unknown) => {\n if (interactionPolicy === 'passive' \|\| readOnly) return;\n const intent = isRangeSelectionEvent(event)\n ? 'range'\n : resolveSelectionEventIntent(event, 'pointer');\n onSelectionChange?.(\n resolveMatrixGridSelection(\n sparseIndex.entries,\n selectedCellIds,\n cell.id,\n anchorId.current,\n intent,\n selectionMode,\n ),\n );\n if (intent !== 'range') anchorId.current = cell.id;\n },\n [\n interactionPolicy,\n onSelectionChange,\n readOnly,\n selectedCellIds,\n selectionMode,\n sparseIndex.entries,\n ],\n );\n const handleKeyboardNavigation = React.useCallback(\n (targetId: string, originId: string, shiftKey: boolean) => {\n anchorId.current ??= originId;\n if (!shiftKey) return;\n const cell = sparseIndex.cellById.get(targetId);\n if (cell) activateCell(getMatrixCellPlacement(layout, cell), { shiftKey: true });\n },\n [activateCell, layout, sparseIndex],\n );\n const keyboard = useMatrixGridKeyboardFocus(\n sparseIndex,\n interactionPolicy === 'passive',\n visibleIds,\n handleKeyboardNavigation,\n );\n const focusedPlacement = React.useMemo(() => {\n const focusedCell =\n keyboard.focusedId === null ? undefined : sparseIndex.cellById.get(keyboard.focusedId);\n return focusedCell ? getMatrixCellPlacement(layout, focusedCell) : undefined;\n }, [keyboard.focusedId, layout, sparseIndex.cellById]);\n const gridItems = React.useMemo(\n () =>\n focusedPlacement && !cellPlacements.some((cell) => cell.id === focusedPlacement.id)\n ? [...cellPlacements, focusedPlacement]\n : cellPlacements,\n [cellPlacements, focusedPlacement],\n );\n const cellById = React.useMemo(\n () => new Map(gridItems.map((cell) => [cell.id, cell])),\n [gridItems],\n );\n\n return (\n <View accessibilityLabel={accessibilityLabel}>\n <GridView\n contentHeight={contentSize.height}\n contentWidth={contentSize.width}\n height={height}\n interactionPolicy={interactionPolicy}\n items={gridItems}\n focusedItemId={keyboard.focusedId ?? undefined}\n overscanPixels={0}\n onVisibleItemIdsChange={setVisibleIds}\n renderItem={(item) => {\n const cell = cellById.get(item.id);\n if (!cell) return null;\n return renderMatrixCell(\n cell,\n selectedCellIds,\n theme.semantics.neutral.divider,\n theme.colors.primary,\n renderCell,\n activateCell,\n keyboard,\n interactionPolicy === 'passive',\n readOnly,\n testID,\n );\n }}\n testID={testID}\n viewport={viewport}\n width={width}\n onViewportChange={handleViewportChange}\n />\n </View>\n );\n}\n\n/** Render one positioned sparse cell with native/web accessible selection semantics. /\nfunction renderMatrixCell(\n cell: GridMatrixCellPlacement,\n selectedCellIds: readonly string[],\n dividerColor: string,\n selectedColor: string,\n renderCell: MatrixGridProps['renderCell'],\n activateCell: (cell: GridMatrixCellPlacement, event: unknown) => void,\n keyboard: ReturnType<typeof useMatrixGridKeyboardFocus>,\n passive: boolean,\n readOnly: boolean,\n testID: string \| undefined,\n) {\n const selected = selectedCellIds.includes(cell.id);\n const canInteract = keyboard.tabStopId === cell.id;\n return (\n <MatrixGridKeyboardProxy\n onKeyDown={(event) => {\n if (keyboard.onKeyDown(cell.id, event.key, event.shiftKey)) return true;\n if (!['Enter', ' '].includes(event.key)) return false;\n if (passive \|\| readOnly) return false;\n activateCell(cell, event);\n return true;\n }}\n >\n <NativePressable\n key={cell.id}\n accessibilityActions={[{ name: 'activate' }]}\n accessibilityLabel={`Cell ${cell.id}`}\n accessibilityRole=\"button\"\n accessibilityState={{ disabled: passive, selected }}\n disabled={passive}\n focusable={Platform.OS !== 'web' \|\| canInteract}\n style={[\n styles.cell,\n {\n borderColor: selected \|\| keyboard.focusedId === cell.id ? selectedColor : dividerColor,\n height: '100%',\n width: '100%',\n },\n ]}\n testID={testID === undefined ? undefined : `${testID}-cell-${cell.id}`}\n onAccessibilityAction={() => activateCell(cell, {})}\n onFocus={() => keyboard.onFocus(cell.id)}\n onPress={(event) => activateCell(cell, event)}\n ref={(node) => keyboard.registerCell(cell.id, node)}\n >\n {renderCell(cell)}\n </NativePressable>\n </MatrixGridKeyboardProxy>\n );\n}\n\n/** Recognize range intent without changing the shared replace-or-toggle selection contract. /\nfunction isRangeSelectionEvent(event: unknown): boolean {\n if (!isRecord(event)) return false;\n if (event.shiftKey === true) return true;\n return (\n (isRecord(event.nativeEvent) && event.nativeEvent.shiftKey === true) \|\|\n (isRecord(event.originalEvent) && event.originalEvent.shiftKey === true)\n );\n}\n\nconst styles = StyleSheet.create({\n cell: { borderWidth: 1, height: '100%', overflow: 'hidden', width: '100%' },\n});\n\n/** A code-first generic sparse matrix grid; formulas and domain vocabulary remain external. */\nexport const MatrixGrid = withZoraThemeScope(MatrixGridInner);\n"]}

package/dist/features/matrix-grid/adapters/inbound/MatrixGridKeyboardProxy.d.ts ADDED Viewed

@@ -0,0 +1,9 @@
+import type React from 'react';
+/*** Provides the native fallback type surface; RNW resolves the web adapter at runtime. */
+export declare function MatrixGridKeyboardProxy({ children }: MatrixGridKeyboardProxyProps): React.JSX.Element;
+interface MatrixGridKeyboardProxyProps {
+    readonly children: React.ReactNode;
+    readonly onKeyDown: (event: React.KeyboardEvent<HTMLDivElement>) => boolean;
+}
+export {};
+//# sourceMappingURL=MatrixGridKeyboardProxy.d.ts.map

package/dist/features/matrix-grid/adapters/inbound/MatrixGridKeyboardProxy.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"MatrixGridKeyboardProxy.d.ts","sourceRoot":"","sources":["../../../../../src/features/matrix-grid/adapters/inbound/MatrixGridKeyboardProxy.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,2FAA2F;AAC3F,wBAAgB,uBAAuB,CAAC,EAAE,QAAQ,EAAE,EAAE,4BAA4B,qBAEjF;AAED,UAAU,4BAA4B;IACpC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,cAAc,CAAC,KAAK,OAAO,CAAC;CAC7E"}

package/dist/features/matrix-grid/adapters/inbound/MatrixGridKeyboardProxy.js ADDED Viewed

@@ -0,0 +1,5 @@
+/*** Provides the native fallback type surface; RNW resolves the web adapter at runtime. */
+export function MatrixGridKeyboardProxy({ children }) {
+    return <>{children}</>;
+}
+//# sourceMappingURL=MatrixGridKeyboardProxy.js.map

package/dist/features/matrix-grid/adapters/inbound/MatrixGridKeyboardProxy.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"MatrixGridKeyboardProxy.js","sourceRoot":"","sources":["../../../../../src/features/matrix-grid/adapters/inbound/MatrixGridKeyboardProxy.tsx"],"names":[],"mappings":"AAEA,2FAA2F;AAC3F,MAAM,UAAU,uBAAuB,CAAC,EAAE,QAAQ,EAAgC;IAChF,OAAO,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC;AACzB,CAAC","sourcesContent":["import type React from 'react';\n\n/*** Provides the native fallback type surface; RNW resolves the web adapter at runtime. */\nexport function MatrixGridKeyboardProxy({ children }: MatrixGridKeyboardProxyProps) {\n return <>{children}</>;\n}\n\ninterface MatrixGridKeyboardProxyProps {\n readonly children: React.ReactNode;\n readonly onKeyDown: (event: React.KeyboardEvent<HTMLDivElement>) => boolean;\n}\n"]}

package/dist/features/matrix-grid/adapters/inbound/MatrixGridKeyboardProxy.native.d.ts ADDED Viewed

@@ -0,0 +1,9 @@
+import type React from 'react';
+/*** Retain native accessibility focus while physical-key dispatch remains a web host concern. */
+export declare function MatrixGridKeyboardProxy({ children }: MatrixGridKeyboardProxyProps): React.JSX.Element;
+interface MatrixGridKeyboardProxyProps {
+    readonly children: React.ReactNode;
+    readonly onKeyDown: (event: React.KeyboardEvent<HTMLDivElement>) => boolean;
+}
+export {};
+//# sourceMappingURL=MatrixGridKeyboardProxy.native.d.ts.map

package/dist/features/matrix-grid/adapters/inbound/MatrixGridKeyboardProxy.native.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"MatrixGridKeyboardProxy.native.d.ts","sourceRoot":"","sources":["../../../../../src/features/matrix-grid/adapters/inbound/MatrixGridKeyboardProxy.native.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,iGAAiG;AACjG,wBAAgB,uBAAuB,CAAC,EAAE,QAAQ,EAAE,EAAE,4BAA4B,qBAEjF;AAED,UAAU,4BAA4B;IACpC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,cAAc,CAAC,KAAK,OAAO,CAAC;CAC7E"}

package/dist/features/matrix-grid/adapters/inbound/MatrixGridKeyboardProxy.native.js ADDED Viewed

@@ -0,0 +1,5 @@
+/*** Retain native accessibility focus while physical-key dispatch remains a web host concern. */
+export function MatrixGridKeyboardProxy({ children }) {
+    return <>{children}</>;
+}
+//# sourceMappingURL=MatrixGridKeyboardProxy.native.js.map

package/dist/features/matrix-grid/adapters/inbound/MatrixGridKeyboardProxy.native.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"MatrixGridKeyboardProxy.native.js","sourceRoot":"","sources":["../../../../../src/features/matrix-grid/adapters/inbound/MatrixGridKeyboardProxy.native.tsx"],"names":[],"mappings":"AAEA,iGAAiG;AACjG,MAAM,UAAU,uBAAuB,CAAC,EAAE,QAAQ,EAAgC;IAChF,OAAO,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC;AACzB,CAAC","sourcesContent":["import type React from 'react';\n\n/*** Retain native accessibility focus while physical-key dispatch remains a web host concern. */\nexport function MatrixGridKeyboardProxy({ children }: MatrixGridKeyboardProxyProps) {\n return <>{children}</>;\n}\n\ninterface MatrixGridKeyboardProxyProps {\n readonly children: React.ReactNode;\n readonly onKeyDown: (event: React.KeyboardEvent<HTMLDivElement>) => boolean;\n}\n"]}

package/dist/features/matrix-grid/adapters/inbound/MatrixGridKeyboardProxy.web.d.ts ADDED Viewed

@@ -0,0 +1,9 @@
+import type React from 'react';
+/*** Bridge browser keyboard events into the matrix's platform-neutral focus policy. */
+export declare function MatrixGridKeyboardProxy({ children, onKeyDown }: MatrixGridKeyboardProxyProps): React.JSX.Element;
+interface MatrixGridKeyboardProxyProps {
+    readonly children: React.ReactNode;
+    readonly onKeyDown: (event: React.KeyboardEvent<HTMLDivElement>) => boolean;
+}
+export {};
+//# sourceMappingURL=MatrixGridKeyboardProxy.web.d.ts.map

package/dist/features/matrix-grid/adapters/inbound/MatrixGridKeyboardProxy.web.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"MatrixGridKeyboardProxy.web.d.ts","sourceRoot":"","sources":["../../../../../src/features/matrix-grid/adapters/inbound/MatrixGridKeyboardProxy.web.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,uFAAuF;AACvF,wBAAgB,uBAAuB,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,4BAA4B,qBAY5F;AAwBD,UAAU,4BAA4B;IACpC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,cAAc,CAAC,KAAK,OAAO,CAAC;CAC7E"}

package/dist/features/matrix-grid/adapters/inbound/MatrixGridKeyboardProxy.web.js ADDED Viewed

@@ -0,0 +1,28 @@
+/*** Bridge browser keyboard events into the matrix's platform-neutral focus policy. */
+export function MatrixGridKeyboardProxy({ children, onKeyDown }) {
+    return (<div onKeyDownCapture={(event) => {
+            if (isNestedInteractiveElement(event.target, event.currentTarget))
+                return;
+            if (onKeyDown(event))
+                event.preventDefault();
+        }} style={{ display: 'flex', flex: 1 }}>
+      {children}
+    </div>);
+}
+/*** Leave editable and independently interactive cell content in control of its own keyboard events. */
+function isNestedInteractiveElement(target, boundary) {
+    if (target === boundary || !hasClosest(target))
+        return false;
+    const interactiveElement = target.closest(interactiveSelector);
+    return interactiveElement !== null && interactiveElement !== getFirstElementChild(boundary);
+}
+/*** Recognize the browser-only closest capability without leaking DOM globals into shared code. */
+function hasClosest(target) {
+    return 'closest' in target && typeof target.closest === 'function';
+}
+/*** Exempt the cell's own Pressable while preserving keyboard ownership for nested controls. */
+function getFirstElementChild(boundary) {
+    return 'firstElementChild' in boundary ? boundary.firstElementChild : undefined;
+}
+const interactiveSelector = 'a, button, input, select, textarea, [contenteditable="true"], [role="button"], [role="checkbox"], [role="combobox"], [role="link"], [role="menuitem"], [role="option"], [role="slider"], [role="spinbutton"], [role="switch"], [role="tab"]';
+//# sourceMappingURL=MatrixGridKeyboardProxy.web.js.map

package/dist/features/matrix-grid/adapters/inbound/MatrixGridKeyboardProxy.web.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"MatrixGridKeyboardProxy.web.js","sourceRoot":"","sources":["../../../../../src/features/matrix-grid/adapters/inbound/MatrixGridKeyboardProxy.web.tsx"],"names":[],"mappings":"AAEA,uFAAuF;AACvF,MAAM,UAAU,uBAAuB,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAgC;IAC3F,OAAO,CACL,CAAC,GAAG,CACF,gBAAgB,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE;YAC1B,IAAI,0BAA0B,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC;gBAAE,OAAO;YAC1E,IAAI,SAAS,CAAC,KAAK,CAAC;gBAAE,KAAK,CAAC,cAAc,EAAE,CAAC;QAC/C,CAAC,CAAC,CACF,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAEpC;MAAA,CAAC,QAAQ,CACX;IAAA,EAAE,GAAG,CAAC,CACP,CAAC;AACJ,CAAC;AAED,wGAAwG;AACxG,SAAS,0BAA0B,CAAC,MAAmB,EAAE,QAAqB;IAC5E,IAAI,MAAM,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7D,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC/D,OAAO,kBAAkB,KAAK,IAAI,IAAI,kBAAkB,KAAK,oBAAoB,CAAC,QAAQ,CAAC,CAAC;AAC9F,CAAC;AAED,mGAAmG;AACnG,SAAS,UAAU,CACjB,MAAmB;IAEnB,OAAO,SAAS,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU,CAAC;AACrE,CAAC;AAED,gGAAgG;AAChG,SAAS,oBAAoB,CAAC,QAAqB;IACjD,OAAO,mBAAmB,IAAI,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC;AAClF,CAAC;AAED,MAAM,mBAAmB,GACvB,6OAA6O,CAAC","sourcesContent":["import type React from 'react';\n\n/*** Bridge browser keyboard events into the matrix's platform-neutral focus policy. */\nexport function MatrixGridKeyboardProxy({ children, onKeyDown }: MatrixGridKeyboardProxyProps) {\n return (\n <div\n onKeyDownCapture={(event) => {\n if (isNestedInteractiveElement(event.target, event.currentTarget)) return;\n if (onKeyDown(event)) event.preventDefault();\n }}\n style={{ display: 'flex', flex: 1 }}\n >\n {children}\n </div>\n );\n}\n\n/*** Leave editable and independently interactive cell content in control of its own keyboard events. */\nfunction isNestedInteractiveElement(target: EventTarget, boundary: EventTarget): boolean {\n if (target === boundary || !hasClosest(target)) return false;\n const interactiveElement = target.closest(interactiveSelector);\n return interactiveElement !== null && interactiveElement !== getFirstElementChild(boundary);\n}\n\n/*** Recognize the browser-only closest capability without leaking DOM globals into shared code. */\nfunction hasClosest(\n target: EventTarget,\n): target is EventTarget & { closest: (selector: string) => unknown } {\n return 'closest' in target && typeof target.closest === 'function';\n}\n\n/*** Exempt the cell's own Pressable while preserving keyboard ownership for nested controls. */\nfunction getFirstElementChild(boundary: EventTarget): unknown {\n return 'firstElementChild' in boundary ? boundary.firstElementChild : undefined;\n}\n\nconst interactiveSelector =\n 'a, button, input, select, textarea, [contenteditable=\"true\"], [role=\"button\"], [role=\"checkbox\"], [role=\"combobox\"], [role=\"link\"], [role=\"menuitem\"], [role=\"option\"], [role=\"slider\"], [role=\"spinbutton\"], [role=\"switch\"], [role=\"tab\"]';\n\ninterface MatrixGridKeyboardProxyProps {\n readonly children: React.ReactNode;\n readonly onKeyDown: (event: React.KeyboardEvent<HTMLDivElement>) => boolean;\n}\n"]}

package/dist/features/matrix-grid/adapters/inbound/useMatrixGridKeyboardFocus.d.ts ADDED Viewed

@@ -0,0 +1,14 @@
+import type { MatrixGridSparseIndex } from '../../application/createMatrixGridSparseIndex';
+/*** Keep one roving focus target and restore it after GridView virtualizes a sparse cell. */
+export declare function useMatrixGridKeyboardFocus(index: MatrixGridSparseIndex, disabled: boolean, visibleIds: readonly string[], onNavigate: (targetId: string, originId: string, shiftKey: boolean) => void): {
+    focusedId: string | null;
+    onFocus: (id: string) => void;
+    onKeyDown: (id: string, key: string, shiftKey: boolean) => boolean;
+    registerCell: (id: string, node: FocusableCell | null) => void;
+    tabStopId: string | undefined;
+};
+interface FocusableCell {
+    focus: () => void;
+}
+export {};
+//# sourceMappingURL=useMatrixGridKeyboardFocus.d.ts.map

package/dist/features/matrix-grid/adapters/inbound/useMatrixGridKeyboardFocus.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"useMatrixGridKeyboardFocus.d.ts","sourceRoot":"","sources":["../../../../../src/features/matrix-grid/adapters/inbound/useMatrixGridKeyboardFocus.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AAG3F,6FAA6F;AAC7F,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,qBAAqB,EAC5B,QAAQ,EAAE,OAAO,EACjB,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI;;kBAYpC,MAAM;oBAmBtC,MAAM,OAAO,MAAM,YAAY,OAAO,KAAG,OAAO;uBAbX,MAAM,QAAQ,aAAa,GAAG,IAAI;;EAqC/E;AAED,UAAU,aAAa;IACrB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB"}

package/dist/features/matrix-grid/adapters/inbound/useMatrixGridKeyboardFocus.js ADDED Viewed

@@ -0,0 +1,50 @@
+import React from 'react';
+import { getMatrixGridNextFocusId } from '../../application/getMatrixGridNextFocusId';
+/*** Keep one roving focus target and restore it after GridView virtualizes a sparse cell. */
+export function useMatrixGridKeyboardFocus(index, disabled, visibleIds, onNavigate) {
+    const [focusedId, setFocusedId] = React.useState(null);
+    const focusedRef = React.useRef(null);
+    const pendingFocusRef = React.useRef(null);
+    const cellRefs = React.useRef(new Map());
+    const visibleIdSet = React.useMemo(() => new Set(visibleIds), [visibleIds]);
+    const tabStopId = focusedId !== null && visibleIdSet.has(focusedId)
+        ? focusedId
+        : visibleIds.find((id) => index.positionById.has(id));
+    const onFocus = React.useCallback((id) => {
+        pendingFocusRef.current = null;
+        focusedRef.current = id;
+        setFocusedId(id);
+    }, []);
+    const registerCell = React.useCallback((id, node) => {
+        if (node === null) {
+            cellRefs.current.delete(id);
+            return;
+        }
+        cellRefs.current.set(id, node);
+        if (pendingFocusRef.current === id) {
+            pendingFocusRef.current = null;
+            node.focus();
+        }
+    }, []);
+    const onKeyDown = React.useCallback((id, key, shiftKey) => {
+        if (disabled || !['ArrowLeft', 'ArrowRight', 'ArrowUp', 'ArrowDown'].includes(key)) {
+            return false;
+        }
+        const originId = focusedRef.current ?? id;
+        const nextId = getMatrixGridNextFocusId(index, originId, key);
+        if (nextId === null || nextId === originId)
+            return true;
+        focusedRef.current = nextId;
+        pendingFocusRef.current = nextId;
+        setFocusedId(nextId);
+        onNavigate(nextId, originId, shiftKey);
+        const mounted = cellRefs.current.get(nextId);
+        if (mounted) {
+            pendingFocusRef.current = null;
+            mounted.focus();
+        }
+        return true;
+    }, [disabled, index, onNavigate]);
+    return { focusedId, onFocus, onKeyDown, registerCell, tabStopId };
+}
+//# sourceMappingURL=useMatrixGridKeyboardFocus.js.map

package/dist/features/matrix-grid/adapters/inbound/useMatrixGridKeyboardFocus.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"useMatrixGridKeyboardFocus.js","sourceRoot":"","sources":["../../../../../src/features/matrix-grid/adapters/inbound/useMatrixGridKeyboardFocus.ts"],"names":[],"mappings":"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","sourcesContent":["import React from 'react';\n\nimport type { MatrixGridSparseIndex } from '../../application/createMatrixGridSparseIndex';\nimport { getMatrixGridNextFocusId } from '../../application/getMatrixGridNextFocusId';\n\n/*** Keep one roving focus target and restore it after GridView virtualizes a sparse cell. */\nexport function useMatrixGridKeyboardFocus(\n index: MatrixGridSparseIndex,\n disabled: boolean,\n visibleIds: readonly string[],\n onNavigate: (targetId: string, originId: string, shiftKey: boolean) => void,\n) {\n const [focusedId, setFocusedId] = React.useState<string | null>(null);\n const focusedRef = React.useRef<string | null>(null);\n const pendingFocusRef = React.useRef<string | null>(null);\n const cellRefs = React.useRef(new Map<string, FocusableCell>());\n const visibleIdSet = React.useMemo(() => new Set(visibleIds), [visibleIds]);\n const tabStopId =\n focusedId !== null && visibleIdSet.has(focusedId)\n ? focusedId\n : visibleIds.find((id) => index.positionById.has(id));\n\n const onFocus = React.useCallback((id: string) => {\n pendingFocusRef.current = null;\n focusedRef.current = id;\n setFocusedId(id);\n }, []);\n\n const registerCell = React.useCallback((id: string, node: FocusableCell | null) => {\n if (node === null) {\n cellRefs.current.delete(id);\n return;\n }\n cellRefs.current.set(id, node);\n if (pendingFocusRef.current === id) {\n pendingFocusRef.current = null;\n node.focus();\n }\n }, []);\n\n const onKeyDown = React.useCallback(\n (id: string, key: string, shiftKey: boolean): boolean => {\n if (disabled || !['ArrowLeft', 'ArrowRight', 'ArrowUp', 'ArrowDown'].includes(key)) {\n return false;\n }\n const originId = focusedRef.current ?? id;\n const nextId = getMatrixGridNextFocusId(index, originId, key);\n if (nextId === null || nextId === originId) return true;\n\n focusedRef.current = nextId;\n pendingFocusRef.current = nextId;\n setFocusedId(nextId);\n onNavigate(nextId, originId, shiftKey);\n\n const mounted = cellRefs.current.get(nextId);\n if (mounted) {\n pendingFocusRef.current = null;\n mounted.focus();\n }\n return true;\n },\n [disabled, index, onNavigate],\n );\n\n return { focusedId, onFocus, onKeyDown, registerCell, tabStopId };\n}\n\ninterface FocusableCell {\n focus: () => void;\n}\n"]}

package/dist/features/matrix-grid/application/createMatrixGridSparseIndex.d.ts ADDED Viewed

@@ -0,0 +1,18 @@
+import type { GridMatrixCell, GridMatrixLayout } from '@ankhorage/grid-view';
+/*** Build a geometry-independent lookup for sparse matrix navigation, selection, and focus recovery. */
+export declare function createMatrixGridSparseIndex(layout: GridMatrixLayout, cells: readonly GridMatrixCell[]): MatrixGridSparseIndex;
+export type MatrixGridSparseIndex = Readonly<{
+    cellById: ReadonlyMap<string, GridMatrixCell>;
+    entries: readonly MatrixGridSparseIndexEntry[];
+    entriesByColumn: ReadonlyMap<number, readonly MatrixGridSparseIndexEntry[]>;
+    entriesByRow: ReadonlyMap<number, readonly MatrixGridSparseIndexEntry[]>;
+    firstId: string | null;
+    positionById: ReadonlyMap<string, MatrixGridSparseIndexEntry>;
+}>;
+export type MatrixGridSparseIndexEntry = Readonly<{
+    cell: GridMatrixCell;
+    columnIndex: number;
+    id: string;
+    rowIndex: number;
+}>;
+//# sourceMappingURL=createMatrixGridSparseIndex.d.ts.map

package/dist/features/matrix-grid/application/createMatrixGridSparseIndex.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"createMatrixGridSparseIndex.d.ts","sourceRoot":"","sources":["../../../../src/features/matrix-grid/application/createMatrixGridSparseIndex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7E,wGAAwG;AACxG,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,SAAS,cAAc,EAAE,GAC/B,qBAAqB,CAgBvB;AAoED,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC3C,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC9C,OAAO,EAAE,SAAS,0BAA0B,EAAE,CAAC;IAC/C,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,0BAA0B,EAAE,CAAC,CAAC;IAC5E,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,0BAA0B,EAAE,CAAC,CAAC;IACzE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;CAC/D,CAAC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IAChD,IAAI,EAAE,cAAc,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC"}

package/dist/features/matrix-grid/application/createMatrixGridSparseIndex.js ADDED Viewed

@@ -0,0 +1,56 @@
+/*** Build a geometry-independent lookup for sparse matrix navigation, selection, and focus recovery. */
+export function createMatrixGridSparseIndex(layout, cells) {
+    const rowIndexes = new Map(layout.rows.map((row, index) => [row.id, index]));
+    const columnIndexes = new Map(layout.columns.map((column, index) => [column.id, index]));
+    const entries = cells.map((cell) => createSparseEntry(cell, rowIndexes, columnIndexes));
+    const entriesByRow = groupEntries(entries, 'columnIndex');
+    const entriesByColumn = groupEntries(entries, 'rowIndex');
+    const orderedEntries = [...entries].sort(compareRowThenColumn);
+    return {
+        cellById: new Map(entries.map((entry) => [entry.id, entry.cell])),
+        entries,
+        entriesByColumn,
+        entriesByRow,
+        firstId: orderedEntries.at(0)?.id ?? null,
+        positionById: new Map(entries.map((entry) => [entry.id, entry])),
+    };
+}
+/*** Resolve validated matrix coordinates once without materializing every cell rectangle. */
+function createSparseEntry(cell, rowIndexes, columnIndexes) {
+    const rowIndex = rowIndexes.get(cell.rowId);
+    const columnIndex = columnIndexes.get(cell.columnId);
+    if (rowIndex === undefined || columnIndex === undefined) {
+        throw new Error(`Matrix cell ${cell.id} references an unknown row or column.`);
+    }
+    return { cell, columnIndex, id: cell.id, rowIndex };
+}
+/*** Group and sort directional neighbours so arrow navigation is logarithmic within one axis. */
+function groupEntries(entries, axis) {
+    const groups = new Map();
+    for (const entry of entries) {
+        const groupKey = axis === 'columnIndex' ? entry.rowIndex : entry.columnIndex;
+        const group = groups.get(groupKey) ?? [];
+        group.push(entry);
+        groups.set(groupKey, group);
+    }
+    return new Map([...groups].map(([key, group]) => [
+        key,
+        group.sort((left, right) => compareAxisThenId(left, right, axis)),
+    ]));
+}
+/*** Keep the initial roving target deterministic even when sparse input arrives in arbitrary order. */
+function compareRowThenColumn(left, right) {
+    return (left.rowIndex - right.rowIndex ||
+        left.columnIndex - right.columnIndex ||
+        left.id.localeCompare(right.id));
+}
+/*** Sort a row or column by its navigated coordinate and stable identity. */
+function compareAxisThenId(left, right, axis) {
+    return (getAxisCoordinate(left, axis) - getAxisCoordinate(right, axis) ||
+        left.id.localeCompare(right.id));
+}
+/*** Read a selected coordinate without dynamically indexing an object. */
+function getAxisCoordinate(entry, axis) {
+    return axis === 'columnIndex' ? entry.columnIndex : entry.rowIndex;
+}
+//# sourceMappingURL=createMatrixGridSparseIndex.js.map

package/dist/features/matrix-grid/application/createMatrixGridSparseIndex.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"createMatrixGridSparseIndex.js","sourceRoot":"","sources":["../../../../src/features/matrix-grid/application/createMatrixGridSparseIndex.ts"],"names":[],"mappings":"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","sourcesContent":["import type { GridMatrixCell, GridMatrixLayout } from '@ankhorage/grid-view';\n\n/*** Build a geometry-independent lookup for sparse matrix navigation, selection, and focus recovery. */\nexport function createMatrixGridSparseIndex(\n layout: GridMatrixLayout,\n cells: readonly GridMatrixCell[],\n): MatrixGridSparseIndex {\n const rowIndexes = new Map(layout.rows.map((row, index) => [row.id, index]));\n const columnIndexes = new Map(layout.columns.map((column, index) => [column.id, index]));\n const entries = cells.map((cell) => createSparseEntry(cell, rowIndexes, columnIndexes));\n const entriesByRow = groupEntries(entries, 'columnIndex');\n const entriesByColumn = groupEntries(entries, 'rowIndex');\n const orderedEntries = [...entries].sort(compareRowThenColumn);\n\n return {\n cellById: new Map(entries.map((entry) => [entry.id, entry.cell])),\n entries,\n entriesByColumn,\n entriesByRow,\n firstId: orderedEntries.at(0)?.id ?? null,\n positionById: new Map(entries.map((entry) => [entry.id, entry])),\n };\n}\n\n/*** Resolve validated matrix coordinates once without materializing every cell rectangle. */\nfunction createSparseEntry(\n cell: GridMatrixCell,\n rowIndexes: ReadonlyMap<string, number>,\n columnIndexes: ReadonlyMap<string, number>,\n): MatrixGridSparseIndexEntry {\n const rowIndex = rowIndexes.get(cell.rowId);\n const columnIndex = columnIndexes.get(cell.columnId);\n if (rowIndex === undefined || columnIndex === undefined) {\n throw new Error(`Matrix cell ${cell.id} references an unknown row or column.`);\n }\n return { cell, columnIndex, id: cell.id, rowIndex };\n}\n\n/*** Group and sort directional neighbours so arrow navigation is logarithmic within one axis. */\nfunction groupEntries(\n entries: readonly MatrixGridSparseIndexEntry[],\n axis: 'columnIndex' | 'rowIndex',\n): ReadonlyMap<number, readonly MatrixGridSparseIndexEntry[]> {\n const groups = new Map<number, MatrixGridSparseIndexEntry[]>();\n for (const entry of entries) {\n const groupKey = axis === 'columnIndex' ? entry.rowIndex : entry.columnIndex;\n const group = groups.get(groupKey) ?? [];\n group.push(entry);\n groups.set(groupKey, group);\n }\n return new Map(\n [...groups].map(([key, group]) => [\n key,\n group.sort((left, right) => compareAxisThenId(left, right, axis)),\n ]),\n );\n}\n\n/*** Keep the initial roving target deterministic even when sparse input arrives in arbitrary order. */\nfunction compareRowThenColumn(\n left: MatrixGridSparseIndexEntry,\n right: MatrixGridSparseIndexEntry,\n): number {\n return (\n left.rowIndex - right.rowIndex ||\n left.columnIndex - right.columnIndex ||\n left.id.localeCompare(right.id)\n );\n}\n\n/*** Sort a row or column by its navigated coordinate and stable identity. */\nfunction compareAxisThenId(\n left: MatrixGridSparseIndexEntry,\n right: MatrixGridSparseIndexEntry,\n axis: 'columnIndex' | 'rowIndex',\n): number {\n return (\n getAxisCoordinate(left, axis) - getAxisCoordinate(right, axis) ||\n left.id.localeCompare(right.id)\n );\n}\n\n/*** Read a selected coordinate without dynamically indexing an object. */\nfunction getAxisCoordinate(\n entry: MatrixGridSparseIndexEntry,\n axis: 'columnIndex' | 'rowIndex',\n): number {\n return axis === 'columnIndex' ? entry.columnIndex : entry.rowIndex;\n}\n\nexport type MatrixGridSparseIndex = Readonly<{\n cellById: ReadonlyMap<string, GridMatrixCell>;\n entries: readonly MatrixGridSparseIndexEntry[];\n entriesByColumn: ReadonlyMap<number, readonly MatrixGridSparseIndexEntry[]>;\n entriesByRow: ReadonlyMap<number, readonly MatrixGridSparseIndexEntry[]>;\n firstId: string | null;\n positionById: ReadonlyMap<string, MatrixGridSparseIndexEntry>;\n}>;\n\nexport type MatrixGridSparseIndexEntry = Readonly<{\n cell: GridMatrixCell;\n columnIndex: number;\n id: string;\n rowIndex: number;\n}>;\n"]}

package/dist/features/matrix-grid/application/getMatrixGridNextFocusId.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+import type { MatrixGridSparseIndex } from './createMatrixGridSparseIndex';
+/*** Resolve arrow-key focus among existing sparse cells without inventing placeholder geometry. */
+export declare function getMatrixGridNextFocusId(index: MatrixGridSparseIndex, currentId: string | null, key: string): string | null;
+//# sourceMappingURL=getMatrixGridNextFocusId.d.ts.map

package/dist/features/matrix-grid/application/getMatrixGridNextFocusId.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"getMatrixGridNextFocusId.d.ts","sourceRoot":"","sources":["../../../../src/features/matrix-grid/application/getMatrixGridNextFocusId.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EAEtB,MAAM,+BAA+B,CAAC;AAEvC,mGAAmG;AACnG,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,qBAAqB,EAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,IAAI,CAKf"}

package/dist/features/matrix-grid/application/getMatrixGridNextFocusId.js ADDED Viewed

@@ -0,0 +1,65 @@
+/*** Resolve arrow-key focus among existing sparse cells without inventing placeholder geometry. */
+export function getMatrixGridNextFocusId(index, currentId, key) {
+    const current = currentId === null ? undefined : index.positionById.get(currentId);
+    if (!current)
+        return index.firstId;
+    return resolveDirectionalCandidate(index, current, key)?.id ?? current.id;
+}
+/*** Find the closest existing sparse cell along the requested matrix axis. */
+function resolveDirectionalCandidate(index, current, key) {
+    switch (key) {
+        case 'ArrowLeft':
+            return findDirectionalNeighbour(index.entriesByRow.get(current.rowIndex), current, 'columnIndex', -1);
+        case 'ArrowRight':
+            return findDirectionalNeighbour(index.entriesByRow.get(current.rowIndex), current, 'columnIndex', 1);
+        case 'ArrowUp':
+            return findDirectionalNeighbour(index.entriesByColumn.get(current.columnIndex), current, 'rowIndex', -1);
+        case 'ArrowDown':
+            return findDirectionalNeighbour(index.entriesByColumn.get(current.columnIndex), current, 'rowIndex', 1);
+        default:
+            return undefined;
+    }
+}
+/*** Read the nearest strictly directional neighbour from a pre-sorted sparse axis. */
+function findDirectionalNeighbour(entries, current, axis, direction) {
+    if (!entries)
+        return undefined;
+    const coordinate = getAxisCoordinate(current, axis);
+    const insertionIndex = findFirstGreaterOrEqual(entries, coordinate, axis);
+    if (direction === -1)
+        return insertionIndex === 0 ? undefined : entries[insertionIndex - 1];
+    return entries[findFirstGreater(entries, coordinate, axis)];
+}
+/*** Locate the first entry strictly after a matrix coordinate in a sorted sparse axis. */
+function findFirstGreater(entries, coordinate, axis) {
+    let lower = 0;
+    let upper = entries.length;
+    while (lower < upper) {
+        const middle = Math.floor((lower + upper) / 2);
+        const entry = entries.at(middle);
+        if (entry && getAxisCoordinate(entry, axis) <= coordinate)
+            lower = middle + 1;
+        else
+            upper = middle;
+    }
+    return lower;
+}
+/*** Locate the first index at or after a matrix coordinate in a sorted sparse axis. */
+function findFirstGreaterOrEqual(entries, coordinate, axis) {
+    let lower = 0;
+    let upper = entries.length;
+    while (lower < upper) {
+        const middle = Math.floor((lower + upper) / 2);
+        const entry = entries.at(middle);
+        if (entry && getAxisCoordinate(entry, axis) < coordinate)
+            lower = middle + 1;
+        else
+            upper = middle;
+    }
+    return lower;
+}
+/*** Read a selected coordinate without dynamically indexing sparse entries. */
+function getAxisCoordinate(entry, axis) {
+    return axis === 'columnIndex' ? entry.columnIndex : entry.rowIndex;
+}
+//# sourceMappingURL=getMatrixGridNextFocusId.js.map

package/dist/features/matrix-grid/application/getMatrixGridNextFocusId.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"getMatrixGridNextFocusId.js","sourceRoot":"","sources":["../../../../src/features/matrix-grid/application/getMatrixGridNextFocusId.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n MatrixGridSparseIndex,\n MatrixGridSparseIndexEntry,\n} from './createMatrixGridSparseIndex';\n\n/*** Resolve arrow-key focus among existing sparse cells without inventing placeholder geometry. */\nexport function getMatrixGridNextFocusId(\n index: MatrixGridSparseIndex,\n currentId: string | null,\n key: string,\n): string | null {\n const current = currentId === null ? undefined : index.positionById.get(currentId);\n if (!current) return index.firstId;\n\n return resolveDirectionalCandidate(index, current, key)?.id ?? current.id;\n}\n\n/*** Find the closest existing sparse cell along the requested matrix axis. */\nfunction resolveDirectionalCandidate(\n index: MatrixGridSparseIndex,\n current: MatrixGridSparseIndexEntry,\n key: string,\n): MatrixGridSparseIndexEntry | undefined {\n switch (key) {\n case 'ArrowLeft':\n return findDirectionalNeighbour(\n index.entriesByRow.get(current.rowIndex),\n current,\n 'columnIndex',\n -1,\n );\n case 'ArrowRight':\n return findDirectionalNeighbour(\n index.entriesByRow.get(current.rowIndex),\n current,\n 'columnIndex',\n 1,\n );\n case 'ArrowUp':\n return findDirectionalNeighbour(\n index.entriesByColumn.get(current.columnIndex),\n current,\n 'rowIndex',\n -1,\n );\n case 'ArrowDown':\n return findDirectionalNeighbour(\n index.entriesByColumn.get(current.columnIndex),\n current,\n 'rowIndex',\n 1,\n );\n default:\n return undefined;\n }\n}\n\n/*** Read the nearest strictly directional neighbour from a pre-sorted sparse axis. */\nfunction findDirectionalNeighbour(\n entries: readonly MatrixGridSparseIndexEntry[] | undefined,\n current: MatrixGridSparseIndexEntry,\n axis: 'columnIndex' | 'rowIndex',\n direction: -1 | 1,\n): MatrixGridSparseIndexEntry | undefined {\n if (!entries) return undefined;\n const coordinate = getAxisCoordinate(current, axis);\n const insertionIndex = findFirstGreaterOrEqual(entries, coordinate, axis);\n if (direction === -1) return insertionIndex === 0 ? undefined : entries[insertionIndex - 1];\n return entries[findFirstGreater(entries, coordinate, axis)];\n}\n\n/*** Locate the first entry strictly after a matrix coordinate in a sorted sparse axis. */\nfunction findFirstGreater(\n entries: readonly MatrixGridSparseIndexEntry[],\n coordinate: number,\n axis: 'columnIndex' | 'rowIndex',\n): number {\n let lower = 0;\n let upper = entries.length;\n while (lower < upper) {\n const middle = Math.floor((lower + upper) / 2);\n const entry = entries.at(middle);\n if (entry && getAxisCoordinate(entry, axis) <= coordinate) lower = middle + 1;\n else upper = middle;\n }\n return lower;\n}\n\n/*** Locate the first index at or after a matrix coordinate in a sorted sparse axis. */\nfunction findFirstGreaterOrEqual(\n entries: readonly MatrixGridSparseIndexEntry[],\n coordinate: number,\n axis: 'columnIndex' | 'rowIndex',\n): number {\n let lower = 0;\n let upper = entries.length;\n while (lower < upper) {\n const middle = Math.floor((lower + upper) / 2);\n const entry = entries.at(middle);\n if (entry && getAxisCoordinate(entry, axis) < coordinate) lower = middle + 1;\n else upper = middle;\n }\n return lower;\n}\n\n/*** Read a selected coordinate without dynamically indexing sparse entries. */\nfunction getAxisCoordinate(\n entry: MatrixGridSparseIndexEntry,\n axis: 'columnIndex' | 'rowIndex',\n): number {\n return axis === 'columnIndex' ? entry.columnIndex : entry.rowIndex;\n}\n"]}

package/dist/features/matrix-grid/application/resolveMatrixGridSelection.d.ts CHANGED Viewed

@@ -1,5 +1,12 @@
 import { type SelectionIntent } from '@ankhorage/utility/selection';
 import type { SelectionMode } from '../../../types/selection';
+type MatrixGridSelectionIntent = SelectionIntent | 'range';
 /*** Apply ZORA's canonical selection intent while retaining the configured selection mode. */
-export declare function resolveMatrixGridSelection(selectedIds: readonly string[], cellId: string, intent: SelectionIntent, mode: SelectionMode): readonly string[];
+export declare function resolveMatrixGridSelection(cells: readonly MatrixGridSelectionCell[], selectedIds: readonly string[], cellId: string, anchorId: string | null, intent: MatrixGridSelectionIntent, mode: SelectionMode): readonly string[];
+type MatrixGridSelectionCell = Readonly<{
+    columnIndex: number;
+    id: string;
+    rowIndex: number;
+}>;
+export {};
 //# sourceMappingURL=resolveMatrixGridSelection.d.ts.map

package/dist/features/matrix-grid/application/resolveMatrixGridSelection.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"resolveMatrixGridSelection.d.ts","sourceRoot":"","sources":["../../../../src/features/matrix-grid/application/resolveMatrixGridSelection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE1F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,8FAA8F;AAC9F,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,MAAM,EAAE,MAAM,EACd,~~MAAM~~,EAAE,~~eAAe~~,EACvB,IAAI,EAAE,aAAa,GAClB,SAAS,MAAM,EAAE,~~CAInB~~"}
1	+ {"version":3,"file":"resolveMatrixGridSelection.d.ts","sourceRoot":"","sources":["../../../../src/features/matrix-grid/application/resolveMatrixGridSelection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE1F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,KAAK,yBAAyB,GAAG,eAAe,GAAG,OAAO,CAAC;AAE3D,8FAA8F;AAC9F,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,SAAS,uBAAuB,EAAE,EACzC,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,MAAM,EAAE,yBAAyB,EACjC,IAAI,EAAE,aAAa,GAClB,SAAS,MAAM,EAAE,CAiBnB;AAED,KAAK,uBAAuB,GAAG,QAAQ,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC"}