@ankhorage/zora 25.8.13 → 25.8.14

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 25.8.14
+
+### Patch Changes
+
+- 2ba10d7: Prevent protected MatrixGrid cells from receiving focus or changing selection.
+
 ## 25.8.13
 
 ### Patch Changes

package/README.md

@@ -3,7 +3,7 @@
 
 # @ankhorage/zora
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v25.8.13](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![paradox: warnings](././paradox/badges/docs.svg)
+![license: MIT](././paradox/badges/license.svg) ![npm: v25.8.14](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![paradox: warnings](././paradox/badges/docs.svg)
 
 Opinionated React Native and React Native Web UI kit built on @ankhorage/surface.
 

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

@@ -1 +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"}
+{"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;AAuOrE,gGAAgG;AAChG,eAAO,MAAM,UAAU,uDAAsC,CAAC"}

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

@@ -12,7 +12,7 @@ import { resolveMatrixGridSelection } from '../../application/resolveMatrixGridS
 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, readOnly = false, 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, protectedCellIds = [], 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]);
@@ -22,18 +22,20 @@ function MatrixGridInner({ accessibilityLabel = 'Matrix grid', cells, height, in
     const cellPlacements = React.useMemo(() => getVisibleMatrixCells(layout, cells, viewport, overscanPixels), [cells, layout, overscanPixels, viewport]);
     const [visibleIds, setVisibleIds] = React.useState([]);
     const anchorId = React.useRef(null);
+    const protectedCellIdSet = React.useMemo(() => new Set(protectedCellIds), [protectedCellIds]);
+    const isNavigable = React.useCallback((id) => !protectedCellIdSet.has(id), [protectedCellIdSet]);
     const handleViewportChange = React.useCallback((proposal) => {
         if (controlledViewport === undefined)
             setUncontrolledViewport(proposal);
         onViewportChange?.(proposal);
     }, [controlledViewport, onViewportChange]);
     const activateCell = React.useCallback((cell, event) => {
-        if (interactionPolicy === 'passive' || readOnly)
+        if (interactionPolicy === 'passive' || readOnly || protectedCellIdSet.has(cell.id))
             return;
         const intent = isRangeSelectionEvent(event)
             ? 'range'
             : resolveSelectionEventIntent(event, 'pointer');
-        onSelectionChange?.(resolveMatrixGridSelection(sparseIndex.entries, selectedCellIds, cell.id, anchorId.current, intent, selectionMode));
+        onSelectionChange?.(resolveMatrixGridSelection(sparseIndex.entries, selectedCellIds, cell.id, anchorId.current, intent, selectionMode, protectedCellIdSet));
         if (intent !== 'range')
             anchorId.current = cell.id;
     }, [
@@ -43,6 +45,7 @@ function MatrixGridInner({ accessibilityLabel = 'Matrix grid', cells, height, in
         selectedCellIds,
         selectionMode,
         sparseIndex.entries,
+        protectedCellIdSet,
     ]);
     const handleKeyboardNavigation = React.useCallback((targetId, originId, shiftKey) => {
         anchorId.current ??= originId;
@@ -52,7 +55,7 @@ function MatrixGridInner({ accessibilityLabel = 'Matrix grid', cells, height, in
         if (cell)
             activateCell(getMatrixCellPlacement(layout, cell), { shiftKey: true });
     }, [activateCell, layout, sparseIndex]);
-    const keyboard = useMatrixGridKeyboardFocus(sparseIndex, interactionPolicy === 'passive', visibleIds, handleKeyboardNavigation);
+    const keyboard = useMatrixGridKeyboardFocus(sparseIndex, interactionPolicy === 'passive', visibleIds, isNavigable, handleKeyboardNavigation);
     const focusedPlacement = React.useMemo(() => {
         const focusedCell = keyboard.focusedId === null ? undefined : sparseIndex.cellById.get(keyboard.focusedId);
         return focusedCell ? getMatrixCellPlacement(layout, focusedCell) : undefined;
@@ -66,12 +69,12 @@ function MatrixGridInner({ accessibilityLabel = 'Matrix grid', cells, height, in
             const cell = cellById.get(item.id);
             if (!cell)
                 return null;
-            return renderMatrixCell(cell, selectedCellIds, theme.semantics.neutral.divider, theme.colors.primary, renderCell, activateCell, keyboard, interactionPolicy === 'passive', readOnly, testID);
+            return renderMatrixCell(cell, selectedCellIds, theme.semantics.neutral.divider, theme.colors.primary, renderCell, activateCell, keyboard, interactionPolicy === 'passive', protectedCellIdSet.has(cell.id), 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, keyboard, passive, readOnly, testID) {
+function renderMatrixCell(cell, selectedCellIds, dividerColor, selectedColor, renderCell, activateCell, keyboard, passive, protectedCell, readOnly, testID) {
     const selected = selectedCellIds.includes(cell.id);
     const canInteract = keyboard.tabStopId === cell.id;
     return (<MatrixGridKeyboardProxy onKeyDown={(event) => {
@@ -79,12 +82,12 @@ function renderMatrixCell(cell, selectedCellIds, dividerColor, selectedColor, re
                 return true;
             if (!['Enter', ' '].includes(event.key))
                 return false;
-            if (passive || readOnly)
+            if (passive || protectedCell || 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={[
+      <NativePressable key={cell.id} accessibilityActions={[{ name: 'activate' }]} accessibilityLabel={`Cell ${cell.id}`} accessibilityRole="button" accessibilityState={{ disabled: passive || protectedCell, selected }} disabled={passive || protectedCell} focusable={!protectedCell && (Platform.OS !== 'web' || canInteract)} style={[
             styles.cell,
             {
                 borderColor: selected || keyboard.focusedId === cell.id ? selectedColor : dividerColor,

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

@@ -1 +1 @@
-{"version":3,"file":"MatrixGrid.js","sourceRoot":"","sources":["../../../../../src/features/matrix-grid/adapters/inbound/MatrixGrid.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GAGtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,SAAS,IAAI,eAAe,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAGxF,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AACxF,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,+CAA+C,CAAC;AAC5F,OAAO,EAAE,4BAA4B,EAAE,MAAM,gDAAgD,CAAC;AAC9F,OAAO,EAAE,0BAA0B,EAAE,MAAM,8CAA8C,CAAC;AAC1F,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE1E,oGAAoG;AACpG,SAAS,eAAe,CAAC,EACvB,kBAAkB,GAAG,aAAa,EAClC,KAAK,EACL,MAAM,EACN,iBAAiB,EACjB,MAAM,EACN,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,GAAG,GAAG,EACpB,QAAQ,GAAG,KAAK,EAChB,UAAU,EACV,eAAe,GAAG,EAAE,EACpB,aAAa,GAAG,QAAQ,EACxB,MAAM,EACN,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EACL,KAAK,GAAG,CAAC,EACT,KAAK,GAAG,CAAC,GACO;IAChB,MAAM,EAAE,KAAK,EAAE,GAAG,YAAY,EAAE,CAAC;IACjC,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,4BAA4B,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IACxF,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,CACnC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAC/F,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAC9B,CAAC;IACF,MAAM,CAAC,oBAAoB,EAAE,uBAAuB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IACxF,MAAM,QAAQ,GAAG,kBAAkB,IAAI,oBAAoB,CAAC;IAC5D,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAC/B,GAAG,EAAE,CAAC,2BAA2B,CAAC,MAAM,EAAE,KAAK,CAAC,EAChD,CAAC,KAAK,EAAE,MAAM,CAAC,CAChB,CAAC;IACF,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAClC,GAAG,EAAE,CAAC,qBAAqB,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,CAAC,EACpE,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,CAAC,CAC1C,CAAC;IACF,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAoB,EAAE,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAgB,IAAI,CAAC,CAAC;IAEnD,MAAM,oBAAoB,GAAG,KAAK,CAAC,WAAW,CAC5C,CAAC,QAAsB,EAAE,EAAE;QACzB,IAAI,kBAAkB,KAAK,SAAS;YAAE,uBAAuB,CAAC,QAAQ,CAAC,CAAC;QACxE,gBAAgB,EAAE,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC,EACD,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CACvC,CAAC;IAEF,MAAM,YAAY,GAAG,KAAK,CAAC,WAAW,CACpC,CAAC,IAA6B,EAAE,KAAc,EAAE,EAAE;QAChD,IAAI,iBAAiB,KAAK,SAAS,IAAI,QAAQ;YAAE,OAAO;QACxD,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,CAAC;YACzC,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,2BAA2B,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAClD,iBAAiB,EAAE,CACjB,0BAA0B,CACxB,WAAW,CAAC,OAAO,EACnB,eAAe,EACf,IAAI,CAAC,EAAE,EACP,QAAQ,CAAC,OAAO,EAChB,MAAM,EACN,aAAa,CACd,CACF,CAAC;QACF,IAAI,MAAM,KAAK,OAAO;YAAE,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC;IACrD,CAAC,EACD;QACE,iBAAiB;QACjB,iBAAiB;QACjB,QAAQ;QACR,eAAe;QACf,aAAa;QACb,WAAW,CAAC,OAAO;KACpB,CACF,CAAC;IACF,MAAM,wBAAwB,GAAG,KAAK,CAAC,WAAW,CAChD,CAAC,QAAgB,EAAE,QAAgB,EAAE,QAAiB,EAAE,EAAE;QACxD,QAAQ,CAAC,OAAO,KAAK,QAAQ,CAAC;QAC9B,IAAI,CAAC,QAAQ;YAAE,OAAO;QACtB,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,IAAI;YAAE,YAAY,CAAC,sBAAsB,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACnF,CAAC,EACD,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,CAAC,CACpC,CAAC;IACF,MAAM,QAAQ,GAAG,0BAA0B,CACzC,WAAW,EACX,iBAAiB,KAAK,SAAS,EAC/B,UAAU,EACV,wBAAwB,CACzB,CAAC;IACF,MAAM,gBAAgB,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE;QAC1C,MAAM,WAAW,GACf,QAAQ,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACzF,OAAO,WAAW,CAAC,CAAC,CAAC,sBAAsB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/E,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvD,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAC7B,GAAG,EAAE,CACH,gBAAgB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,gBAAgB,CAAC,EAAE,CAAC;QACjF,CAAC,CAAC,CAAC,GAAG,cAAc,EAAE,gBAAgB,CAAC;QACvC,CAAC,CAAC,cAAc,EACpB,CAAC,cAAc,EAAE,gBAAgB,CAAC,CACnC,CAAC;IACF,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAC5B,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EACvD,CAAC,SAAS,CAAC,CACZ,CAAC;IAEF,OAAO,CACL,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,kBAAkB,CAAC,CAC3C;MAAA,CAAC,QAAQ,CACP,aAAa,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAClC,YAAY,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAChC,MAAM,CAAC,CAAC,MAAM,CAAC,CACf,iBAAiB,CAAC,CAAC,iBAAiB,CAAC,CACrC,KAAK,CAAC,CAAC,SAAS,CAAC,CACjB,aAAa,CAAC,CAAC,QAAQ,CAAC,SAAS,IAAI,SAAS,CAAC,CAC/C,cAAc,CAAC,CAAC,CAAC,CAAC,CAClB,sBAAsB,CAAC,CAAC,aAAa,CAAC,CACtC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE;YACnB,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnC,IAAI,CAAC,IAAI;gBAAE,OAAO,IAAI,CAAC;YACvB,OAAO,gBAAgB,CACrB,IAAI,EACJ,eAAe,EACf,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,EAC/B,KAAK,CAAC,MAAM,CAAC,OAAO,EACpB,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,iBAAiB,KAAK,SAAS,EAC/B,QAAQ,EACR,MAAM,CACP,CAAC;QACJ,CAAC,CAAC,CACF,MAAM,CAAC,CAAC,MAAM,CAAC,CACf,QAAQ,CAAC,CAAC,QAAQ,CAAC,CACnB,KAAK,CAAC,CAAC,KAAK,CAAC,CACb,gBAAgB,CAAC,CAAC,oBAAoB,CAAC,EAE3C;IAAA,EAAE,IAAI,CAAC,CACR,CAAC;AACJ,CAAC;AAED,yFAAyF;AACzF,SAAS,gBAAgB,CACvB,IAA6B,EAC7B,eAAkC,EAClC,YAAoB,EACpB,aAAqB,EACrB,UAAyC,EACzC,YAAqE,EACrE,QAAuD,EACvD,OAAgB,EAChB,QAAiB,EACjB,MAA0B;IAE1B,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,QAAQ,CAAC,SAAS,KAAK,IAAI,CAAC,EAAE,CAAC;IACnD,OAAO,CACL,CAAC,uBAAuB,CACtB,SAAS,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE;YACnB,IAAI,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC;gBAAE,OAAO,IAAI,CAAC;YACxE,IAAI,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC;gBAAE,OAAO,KAAK,CAAC;YACtD,IAAI,OAAO,IAAI,QAAQ;gBAAE,OAAO,KAAK,CAAC;YACtC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC1B,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAEF;MAAA,CAAC,eAAe,CACd,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CACb,oBAAoB,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAC7C,kBAAkB,CAAC,CAAC,QAAQ,IAAI,CAAC,EAAE,EAAE,CAAC,CACtC,iBAAiB,CAAC,QAAQ,CAC1B,kBAAkB,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CACpD,QAAQ,CAAC,CAAC,OAAO,CAAC,CAClB,SAAS,CAAC,CAAC,QAAQ,CAAC,EAAE,KAAK,KAAK,IAAI,WAAW,CAAC,CAChD,KAAK,CAAC,CAAC;YACL,MAAM,CAAC,IAAI;YACX;gBACE,WAAW,EAAE,QAAQ,IAAI,QAAQ,CAAC,SAAS,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY;gBACtF,MAAM,EAAE,MAAM;gBACd,KAAK,EAAE,MAAM;aACd;SACF,CAAC,CACF,MAAM,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,SAAS,IAAI,CAAC,EAAE,EAAE,CAAC,CACvE,qBAAqB,CAAC,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CACpD,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CACzC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAC9C,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAEpD;QAAA,CAAC,UAAU,CAAC,IAAI,CAAC,CACnB;MAAA,EAAE,eAAe,CACnB;IAAA,EAAE,uBAAuB,CAAC,CAC3B,CAAC;AACJ,CAAC;AAED,gGAAgG;AAChG,SAAS,qBAAqB,CAAC,KAAc;IAC3C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,CACL,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,QAAQ,KAAK,IAAI,CAAC;QACpE,CAAC,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,aAAa,CAAC,QAAQ,KAAK,IAAI,CAAC,CACzE,CAAC;AACJ,CAAC;AAED,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;IAC/B,IAAI,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE;CAC5E,CAAC,CAAC;AAEH,gGAAgG;AAChG,MAAM,CAAC,MAAM,UAAU,GAAG,kBAAkB,CAAC,eAAe,CAAC,CAAC","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"]}
+{"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  protectedCellIds = [],\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  const protectedCellIdSet = React.useMemo(() => new Set(protectedCellIds), [protectedCellIds]);\n  const isNavigable = React.useCallback(\n    (id: string) => !protectedCellIdSet.has(id),\n    [protectedCellIdSet],\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' || readOnly || protectedCellIdSet.has(cell.id)) 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          protectedCellIdSet,\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      protectedCellIdSet,\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    isNavigable,\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            protectedCellIdSet.has(cell.id),\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  protectedCell: 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 || protectedCell || 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 || protectedCell, selected }}\n        disabled={passive || protectedCell}\n        focusable={!protectedCell && (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/useMatrixGridKeyboardFocus.d.ts

@@ -1,6 +1,6 @@
 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): {
+export declare function useMatrixGridKeyboardFocus(index: MatrixGridSparseIndex, disabled: boolean, visibleIds: readonly string[], isNavigable: (id: string) => boolean, onNavigate: (targetId: string, originId: string, shiftKey: boolean) => void): {
     focusedId: string | null;
     onFocus: (id: string) => void;
     onKeyDown: (id: string, key: string, shiftKey: boolean) => boolean;

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

@@ -1 +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"}
+{"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,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,EACpC,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI;;kBAsBpC,MAAM;oBAmBtC,MAAM,OAAO,MAAM,YAAY,OAAO,KAAG,OAAO;uBAbX,MAAM,QAAQ,aAAa,GAAG,IAAI;;EAqC/E;AAkBD,UAAU,aAAa;IACrB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB"}

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

@@ -1,15 +1,24 @@
 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) {
+export function useMatrixGridKeyboardFocus(index, disabled, visibleIds, isNavigable, 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)
+    const tabStopId = focusedId !== null && visibleIdSet.has(focusedId) && isNavigable(focusedId)
         ? focusedId
-        : visibleIds.find((id) => index.positionById.has(id));
+        : visibleIds.find((id) => index.positionById.has(id) && isNavigable(id));
+    React.useEffect(() => {
+        if (focusedRef.current !== null && !isNavigable(focusedRef.current)) {
+            focusedRef.current = null;
+            setFocusedId(null);
+        }
+        if (pendingFocusRef.current !== null && !isNavigable(pendingFocusRef.current)) {
+            pendingFocusRef.current = null;
+        }
+    }, [isNavigable]);
     const onFocus = React.useCallback((id) => {
         pendingFocusRef.current = null;
         focusedRef.current = id;
@@ -31,7 +40,7 @@ export function useMatrixGridKeyboardFocus(index, disabled, visibleIds, onNaviga
             return false;
         }
         const originId = focusedRef.current ?? id;
-        const nextId = getMatrixGridNextFocusId(index, originId, key);
+        const nextId = resolveNextNavigableId(index, originId, key, isNavigable);
         if (nextId === null || nextId === originId)
             return true;
         focusedRef.current = nextId;
@@ -44,7 +53,18 @@ export function useMatrixGridKeyboardFocus(index, disabled, visibleIds, onNaviga
             mounted.focus();
         }
         return true;
-    }, [disabled, index, onNavigate]);
+    }, [disabled, index, isNavigable, onNavigate]);
     return { focusedId, onFocus, onKeyDown, registerCell, tabStopId };
 }
+/*** Skip protected sparse cells while retaining the nearest deterministic directional navigation. */
+function resolveNextNavigableId(index, originId, key, isNavigable) {
+    let candidate = getMatrixGridNextFocusId(index, originId, key);
+    while (candidate !== null && candidate !== originId && !isNavigable(candidate)) {
+        const nextCandidate = getMatrixGridNextFocusId(index, candidate, key);
+        if (nextCandidate === candidate)
+            return originId;
+        candidate = nextCandidate;
+    }
+    return candidate;
+}
 //# sourceMappingURL=useMatrixGridKeyboardFocus.js.map

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

@@ -1 +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"]}
+{"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  isNavigable: (id: string) => boolean,\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) && isNavigable(focusedId)\n      ? focusedId\n      : visibleIds.find((id) => index.positionById.has(id) && isNavigable(id));\n\n  React.useEffect(() => {\n    if (focusedRef.current !== null && !isNavigable(focusedRef.current)) {\n      focusedRef.current = null;\n      setFocusedId(null);\n    }\n    if (pendingFocusRef.current !== null && !isNavigable(pendingFocusRef.current)) {\n      pendingFocusRef.current = null;\n    }\n  }, [isNavigable]);\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 = resolveNextNavigableId(index, originId, key, isNavigable);\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, isNavigable, onNavigate],\n  );\n\n  return { focusedId, onFocus, onKeyDown, registerCell, tabStopId };\n}\n\n/*** Skip protected sparse cells while retaining the nearest deterministic directional navigation. */\nfunction resolveNextNavigableId(\n  index: MatrixGridSparseIndex,\n  originId: string,\n  key: string,\n  isNavigable: (id: string) => boolean,\n): string | null {\n  let candidate = getMatrixGridNextFocusId(index, originId, key);\n  while (candidate !== null && candidate !== originId && !isNavigable(candidate)) {\n    const nextCandidate = getMatrixGridNextFocusId(index, candidate, key);\n    if (nextCandidate === candidate) return originId;\n    candidate = nextCandidate;\n  }\n  return candidate;\n}\n\ninterface FocusableCell {\n  focus: () => void;\n}\n"]}

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

@@ -2,7 +2,7 @@ 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(cells: readonly MatrixGridSelectionCell[], selectedIds: readonly string[], cellId: string, anchorId: string | null, intent: MatrixGridSelectionIntent, mode: SelectionMode): readonly string[];
+export declare function resolveMatrixGridSelection(cells: readonly MatrixGridSelectionCell[], selectedIds: readonly string[], cellId: string, anchorId: string | null, intent: MatrixGridSelectionIntent, mode: SelectionMode, protectedCellIds: ReadonlySet<string>): readonly string[];
 type MatrixGridSelectionCell = Readonly<{
     columnIndex: number;
     id: string;

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

@@ -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,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"}
+{"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,EACnB,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAC,GACpC,SAAS,MAAM,EAAE,CAmBnB;AAED,KAAK,uBAAuB,GAAG,QAAQ,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC"}

package/dist/features/matrix-grid/application/resolveMatrixGridSelection.js

@@ -1,6 +1,8 @@
 import { applySelectionIntent } from '@ankhorage/utility/selection';
 /*** Apply ZORA's canonical selection intent while retaining the configured selection mode. */
-export function resolveMatrixGridSelection(cells, selectedIds, cellId, anchorId, intent, mode) {
+export function resolveMatrixGridSelection(cells, selectedIds, cellId, anchorId, intent, mode, protectedCellIds) {
+    if (protectedCellIds.has(cellId))
+        return selectedIds;
     if (mode === 'single')
         return applySelectionIntent(selectedIds, cellId, 'replace');
     if (intent !== 'range')
@@ -10,7 +12,8 @@ export function resolveMatrixGridSelection(cells, selectedIds, cellId, anchorId,
     if (!anchor || !target)
         return applySelectionIntent(selectedIds, cellId, 'replace');
     return cells
-        .filter((cell) => cell.rowIndex >= Math.min(anchor.rowIndex, target.rowIndex) &&
+        .filter((cell) => !protectedCellIds.has(cell.id) &&
+        cell.rowIndex >= Math.min(anchor.rowIndex, target.rowIndex) &&
         cell.rowIndex <= Math.max(anchor.rowIndex, target.rowIndex) &&
         cell.columnIndex >= Math.min(anchor.columnIndex, target.columnIndex) &&
         cell.columnIndex <= Math.max(anchor.columnIndex, target.columnIndex))

package/dist/features/matrix-grid/application/resolveMatrixGridSelection.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolveMatrixGridSelection.js","sourceRoot":"","sources":["../../../../src/features/matrix-grid/application/resolveMatrixGridSelection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAwB,MAAM,8BAA8B,CAAC;AAM1F,8FAA8F;AAC9F,MAAM,UAAU,0BAA0B,CACxC,KAAyC,EACzC,WAA8B,EAC9B,MAAc,EACd,QAAuB,EACvB,MAAiC,EACjC,IAAmB;IAEnB,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IACnF,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjF,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM;QAAE,OAAO,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAEpF,OAAO,KAAK;SACT,MAAM,CACL,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;QAC3D,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;QAC3D,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC;QACpE,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,CACvE;SACA,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC5B,CAAC","sourcesContent":["import { applySelectionIntent, type SelectionIntent } from '@ankhorage/utility/selection';\n\nimport type { SelectionMode } from '../../../types/selection';\n\ntype MatrixGridSelectionIntent = SelectionIntent | 'range';\n\n/*** Apply ZORA's canonical selection intent while retaining the configured selection mode. */\nexport function resolveMatrixGridSelection(\n  cells: readonly MatrixGridSelectionCell[],\n  selectedIds: readonly string[],\n  cellId: string,\n  anchorId: string | null,\n  intent: MatrixGridSelectionIntent,\n  mode: SelectionMode,\n): readonly string[] {\n  if (mode === 'single') return applySelectionIntent(selectedIds, cellId, 'replace');\n  if (intent !== 'range') return applySelectionIntent(selectedIds, cellId, intent);\n\n  const anchor = cells.find((cell) => cell.id === anchorId);\n  const target = cells.find((cell) => cell.id === cellId);\n  if (!anchor || !target) return applySelectionIntent(selectedIds, cellId, 'replace');\n\n  return cells\n    .filter(\n      (cell) =>\n        cell.rowIndex >= Math.min(anchor.rowIndex, target.rowIndex) &&\n        cell.rowIndex <= Math.max(anchor.rowIndex, target.rowIndex) &&\n        cell.columnIndex >= Math.min(anchor.columnIndex, target.columnIndex) &&\n        cell.columnIndex <= Math.max(anchor.columnIndex, target.columnIndex),\n    )\n    .map((cell) => cell.id);\n}\n\ntype MatrixGridSelectionCell = Readonly<{\n  columnIndex: number;\n  id: string;\n  rowIndex: number;\n}>;\n"]}
+{"version":3,"file":"resolveMatrixGridSelection.js","sourceRoot":"","sources":["../../../../src/features/matrix-grid/application/resolveMatrixGridSelection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAwB,MAAM,8BAA8B,CAAC;AAM1F,8FAA8F;AAC9F,MAAM,UAAU,0BAA0B,CACxC,KAAyC,EACzC,WAA8B,EAC9B,MAAc,EACd,QAAuB,EACvB,MAAiC,EACjC,IAAmB,EACnB,gBAAqC;IAErC,IAAI,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC;QAAE,OAAO,WAAW,CAAC;IACrD,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IACnF,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjF,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM;QAAE,OAAO,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAEpF,OAAO,KAAK;SACT,MAAM,CACL,CAAC,IAAI,EAAE,EAAE,CACP,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;QAC3D,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;QAC3D,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC;QACpE,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,CACvE;SACA,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC5B,CAAC","sourcesContent":["import { applySelectionIntent, type SelectionIntent } from '@ankhorage/utility/selection';\n\nimport type { SelectionMode } from '../../../types/selection';\n\ntype MatrixGridSelectionIntent = SelectionIntent | 'range';\n\n/*** Apply ZORA's canonical selection intent while retaining the configured selection mode. */\nexport function resolveMatrixGridSelection(\n  cells: readonly MatrixGridSelectionCell[],\n  selectedIds: readonly string[],\n  cellId: string,\n  anchorId: string | null,\n  intent: MatrixGridSelectionIntent,\n  mode: SelectionMode,\n  protectedCellIds: ReadonlySet<string>,\n): readonly string[] {\n  if (protectedCellIds.has(cellId)) return selectedIds;\n  if (mode === 'single') return applySelectionIntent(selectedIds, cellId, 'replace');\n  if (intent !== 'range') return applySelectionIntent(selectedIds, cellId, intent);\n\n  const anchor = cells.find((cell) => cell.id === anchorId);\n  const target = cells.find((cell) => cell.id === cellId);\n  if (!anchor || !target) return applySelectionIntent(selectedIds, cellId, 'replace');\n\n  return cells\n    .filter(\n      (cell) =>\n        !protectedCellIds.has(cell.id) &&\n        cell.rowIndex >= Math.min(anchor.rowIndex, target.rowIndex) &&\n        cell.rowIndex <= Math.max(anchor.rowIndex, target.rowIndex) &&\n        cell.columnIndex >= Math.min(anchor.columnIndex, target.columnIndex) &&\n        cell.columnIndex <= Math.max(anchor.columnIndex, target.columnIndex),\n    )\n    .map((cell) => cell.id);\n}\n\ntype MatrixGridSelectionCell = Readonly<{\n  columnIndex: number;\n  id: string;\n  rowIndex: number;\n}>;\n"]}

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

@@ -15,6 +15,8 @@ export interface MatrixGridProps extends ZoraBaseProps {
     readonly overscanPixels?: number;
     /** Retains focus navigation while suppressing cell-selection mutations. */
     readonly readOnly?: boolean;
+    /** Cells that remain visible but cannot receive focus or change the controlled selection. */
+    readonly protectedCellIds?: readonly string[];
     readonly selectedCellIds?: readonly string[];
     readonly selectionMode?: SelectionMode;
     readonly onSelectionChange?: (ids: readonly string[]) => void;

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

@@ -1 +1 @@
-{"version":3,"file":"matrix-grid.d.ts","sourceRoot":"","sources":["../../src/types/matrix-grid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,uBAAuB,EACvB,gBAAgB,EAChB,YAAY,EACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,mGAAmG;AACnG,MAAM,WAAW,eAAgB,SAAQ,aAAa;IACpD,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;IACvC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;IAC9D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;IAC7D,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,uBAAuB,KAAK,KAAK,CAAC,SAAS,CAAC;IACxE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC"}
+{"version":3,"file":"matrix-grid.d.ts","sourceRoot":"","sources":["../../src/types/matrix-grid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,uBAAuB,EACvB,gBAAgB,EAChB,YAAY,EACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,mGAAmG;AACnG,MAAM,WAAW,eAAgB,SAAQ,aAAa;IACpD,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,6FAA6F;IAC7F,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;IACvC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;IAC9D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;IAC7D,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,uBAAuB,KAAK,KAAK,CAAC,SAAS,CAAC;IACxE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC"}

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

@@ -1 +1 @@
-{"version":3,"file":"matrix-grid.js","sourceRoot":"","sources":["../../src/types/matrix-grid.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  GridMatrixCell,\n  GridMatrixCellPlacement,\n  GridMatrixLayout,\n  GridViewport,\n} from '@ankhorage/grid-view';\nimport type React from 'react';\n\nimport type { ZoraBaseProps } from './base';\nimport type { SelectionMode } from './selection';\n\n/** Code-first virtualized sparse-matrix presentation over the published grid-view geometry API. */\nexport interface MatrixGridProps extends ZoraBaseProps {\n  readonly layout: GridMatrixLayout;\n  readonly cells: readonly GridMatrixCell[];\n  readonly width: number;\n  readonly height: number;\n  /** A supplied viewport is controlled by the caller, including independent axis zoom. */\n  readonly viewport?: GridViewport;\n  readonly zoomX?: number;\n  readonly zoomY?: number;\n  readonly overscanPixels?: number;\n  /** Retains focus navigation while suppressing cell-selection mutations. */\n  readonly readOnly?: boolean;\n  readonly selectedCellIds?: readonly string[];\n  readonly selectionMode?: SelectionMode;\n  readonly onSelectionChange?: (ids: readonly string[]) => void;\n  readonly onViewportChange?: (viewport: GridViewport) => void;\n  readonly renderCell: (cell: GridMatrixCellPlacement) => React.ReactNode;\n  readonly accessibilityLabel?: string;\n}\n"]}
+{"version":3,"file":"matrix-grid.js","sourceRoot":"","sources":["../../src/types/matrix-grid.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  GridMatrixCell,\n  GridMatrixCellPlacement,\n  GridMatrixLayout,\n  GridViewport,\n} from '@ankhorage/grid-view';\nimport type React from 'react';\n\nimport type { ZoraBaseProps } from './base';\nimport type { SelectionMode } from './selection';\n\n/** Code-first virtualized sparse-matrix presentation over the published grid-view geometry API. */\nexport interface MatrixGridProps extends ZoraBaseProps {\n  readonly layout: GridMatrixLayout;\n  readonly cells: readonly GridMatrixCell[];\n  readonly width: number;\n  readonly height: number;\n  /** A supplied viewport is controlled by the caller, including independent axis zoom. */\n  readonly viewport?: GridViewport;\n  readonly zoomX?: number;\n  readonly zoomY?: number;\n  readonly overscanPixels?: number;\n  /** Retains focus navigation while suppressing cell-selection mutations. */\n  readonly readOnly?: boolean;\n  /** Cells that remain visible but cannot receive focus or change the controlled selection. */\n  readonly protectedCellIds?: readonly string[];\n  readonly selectedCellIds?: readonly string[];\n  readonly selectionMode?: SelectionMode;\n  readonly onSelectionChange?: (ids: readonly string[]) => void;\n  readonly onViewportChange?: (viewport: GridViewport) => void;\n  readonly renderCell: (cell: GridMatrixCellPlacement) => React.ReactNode;\n  readonly accessibilityLabel?: string;\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/zora",
   "type": "module",
-  "version": "25.8.13",
+  "version": "25.8.14",
   "description": "Opinionated React Native and React Native Web UI kit built on @ankhorage/surface.",
   "homepage": "https://github.com/ankhorage/zora#readme",
   "bugs": {
@@ -129,7 +129,7 @@
     "format": "ankhorage-prettier --write .",
     "format:check": "ankhorage-prettier --check .",
     "prepack": "bun run build",
-    "test": "bun run build && bun test src examples/grid-workspaces/time --isolate",
+    "test": "bun run build && bun test src examples/grid-workspaces/time examples/grid-workspaces/plugins --isolate",
     "typecheck": "bun x tsc --noEmit -p tsconfig.json && bun x tsc --noEmit -p tsconfig.scripts.json",
     "version-packages": "ankhorage-changeset version"
   },

package/src/features/matrix-grid/adapters/inbound/MatrixGrid.protected-focus.test.tsx

@@ -0,0 +1,252 @@
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+
+import { expect, test } from 'bun:test';
+import { Window } from 'happy-dom';
+import React, { act } from 'react';
+import { createRoot } from 'react-dom/client';
+
+const browserKeys = [
+  'window',
+  'document',
+  'Node',
+  'navigator',
+  'ShadowRoot',
+  'IS_REACT_ACT_ENVIRONMENT',
+] as const;
+const webDistRoot = join(import.meta.dir, '../../../../../web-dist');
+const load = (path: string) => import(pathToFileURL(join(webDistRoot, path)).href);
+
+interface MatrixCell {
+  readonly columnId: string;
+  readonly id: string;
+  readonly rowId: string;
+}
+
+interface MatrixLayout {
+  readonly columns: readonly { readonly id: string; readonly size: number }[];
+  readonly rows: readonly { readonly id: string; readonly size: number }[];
+}
+type MatrixGridComponent = React.ComponentType<{
+  readonly cells: readonly MatrixCell[];
+  readonly height: number;
+  readonly layout: MatrixLayout;
+  readonly protectedCellIds?: readonly string[];
+  readonly renderCell: (cell: MatrixCell) => React.ReactNode;
+  readonly testID: string;
+  readonly width: number;
+}>;
+type ZoraProviderComponent = React.ComponentType<{ readonly children: React.ReactNode }>;
+
+/*** Mount MatrixGrid through React Native Web and restore the ambient DOM after each assertion. */
+async function withMatrixDom(assertion: (host: HTMLElement, browser: Window) => Promise<void>) {
+  const browser = new Window();
+  const previous = browserKeys.map(
+    (key) => [key, Object.getOwnPropertyDescriptor(globalThis, key)] as const,
+  );
+  Object.assign(globalThis, {
+    IS_REACT_ACT_ENVIRONMENT: true,
+    window: browser,
+    document: browser.document,
+    Node: browser.Node,
+    navigator: browser.navigator,
+    ShadowRoot: browser.ShadowRoot,
+  });
+  const host = document.createElement('div');
+  document.body.appendChild(host);
+  try {
+    await assertion(host, browser);
+  } finally {
+    browser.close();
+    for (const [key, descriptor] of previous) {
+      if (descriptor) Object.defineProperty(globalThis, key, descriptor);
+      else Reflect.deleteProperty(globalThis, key);
+    }
+  }
+}
+
+/*** Load the compiled MatrixGrid and provider used by React Native Web interaction tests. */
+async function loadMatrixGrid() {
+  const { MatrixGrid } = (await load('components/matrix-grid/MatrixGrid.js')) as {
+    MatrixGrid: MatrixGridComponent;
+  };
+  const { ZoraProvider } = (await load('runtime/ZoraProvider.js')) as {
+    ZoraProvider: ZoraProviderComponent;
+  };
+  return { MatrixGrid, ZoraProvider };
+}
+
+test('retains focus when protected terminal cells block all four arrow directions', async () => {
+  await withMatrixDom(async (host, browser) => {
+    const root = createRoot(host);
+    const { MatrixGrid, ZoraProvider } = await loadMatrixGrid();
+    const layout = {
+      columns: Array.from({ length: 3 }, (_, index) => ({ id: `column-${index}`, size: 20 })),
+      rows: Array.from({ length: 3 }, (_, index) => ({ id: `row-${index}`, size: 20 })),
+    };
+    const cells = [
+      { columnId: 'column-1', id: 'up', rowId: 'row-0' },
+      { columnId: 'column-0', id: 'left', rowId: 'row-1' },
+      { columnId: 'column-1', id: 'origin', rowId: 'row-1' },
+      { columnId: 'column-2', id: 'right', rowId: 'row-1' },
+      { columnId: 'column-1', id: 'down', rowId: 'row-2' },
+    ];
+    try {
+      act(() =>
+        root.render(
+          <ZoraProvider>
+            <MatrixGrid
+              cells={cells}
+              height={60}
+              layout={layout}
+              protectedCellIds={['left', 'right', 'up', 'down']}
+              testID="terminal-protected-matrix"
+              width={60}
+              renderCell={(cell) => <span>{cell.id}</span>}
+            />
+          </ZoraProvider>,
+        ),
+      );
+      const origin = host.querySelector<HTMLElement>(
+        '[data-testid="terminal-protected-matrix-cell-origin"]',
+      );
+      if (!origin) throw new Error('Missing terminal-protected focus origin.');
+      act(() => origin.focus());
+      for (const key of ['ArrowLeft', 'ArrowRight', 'ArrowUp', 'ArrowDown']) {
+        act(() => {
+          void origin.dispatchEvent(new browser.KeyboardEvent('keydown', { bubbles: true, key }));
+        });
+        expect(document.activeElement).toBe(origin);
+      }
+    } finally {
+      act(() => root.unmount());
+    }
+  });
+});
+
+test('skips consecutive protected cells and retains the origin when a direction has no navigable cell', async () => {
+  await withMatrixDom(async (host, browser) => {
+    const root = createRoot(host);
+    const { MatrixGrid, ZoraProvider } = await loadMatrixGrid();
+    const layout = {
+      columns: Array.from({ length: 4 }, (_, index) => ({ id: `column-${index}`, size: 20 })),
+      rows: [{ id: 'row-0', size: 20 }],
+    };
+    const cells = ['a', 'b', 'c', 'd'].map((id, index) => ({
+      columnId: `column-${index}`,
+      id,
+      rowId: 'row-0',
+    }));
+    const render = (protectedCellIds: readonly string[], testID: string) => (
+      <ZoraProvider>
+        <MatrixGrid
+          cells={cells}
+          height={20}
+          layout={layout}
+          protectedCellIds={protectedCellIds}
+          testID={testID}
+          width={80}
+          renderCell={(cell) => <span>{cell.id}</span>}
+        />
+      </ZoraProvider>
+    );
+    try {
+      act(() => root.render(render(['b', 'c'], 'consecutive-protected-matrix')));
+      const a = host.querySelector<HTMLElement>(
+        '[data-testid="consecutive-protected-matrix-cell-a"]',
+      );
+      const d = host.querySelector<HTMLElement>(
+        '[data-testid="consecutive-protected-matrix-cell-d"]',
+      );
+      if (!a || !d) throw new Error('Missing consecutive-protected cells.');
+      act(() => {
+        a.focus();
+        void a.dispatchEvent(
+          new browser.KeyboardEvent('keydown', { bubbles: true, key: 'ArrowRight' }),
+        );
+      });
+      expect(document.activeElement).toBe(d);
+
+      act(() => root.render(render(['b', 'c', 'd'], 'blocked-direction-matrix')));
+      const blockedOrigin = host.querySelector<HTMLElement>(
+        '[data-testid="blocked-direction-matrix-cell-a"]',
+      );
+      if (!blockedOrigin) throw new Error('Missing blocked-direction focus origin.');
+      act(() => {
+        blockedOrigin.focus();
+        void blockedOrigin.dispatchEvent(
+          new browser.KeyboardEvent('keydown', { bubbles: true, key: 'ArrowRight' }),
+        );
+      });
+      expect(document.activeElement).toBe(blockedOrigin);
+    } finally {
+      act(() => root.unmount());
+    }
+  });
+});
+
+test('reconciles roving focus when protected cells change and leaves fully protected matrices without a tab stop', async () => {
+  await withMatrixDom(async (host, browser) => {
+    const root = createRoot(host);
+    const { MatrixGrid, ZoraProvider } = await loadMatrixGrid();
+    const layout = {
+      columns: Array.from({ length: 3 }, (_, index) => ({ id: `column-${index}`, size: 20 })),
+      rows: [{ id: 'row-0', size: 20 }],
+    };
+    const cells = ['a', 'b', 'c'].map((id, index) => ({
+      columnId: `column-${index}`,
+      id,
+      rowId: 'row-0',
+    }));
+    let setProtectedCellIds: React.Dispatch<React.SetStateAction<readonly string[]>> | undefined;
+
+    function DynamicProtectionMatrix() {
+      const [protectedCellIds, setProtected] = React.useState<readonly string[]>([]);
+      setProtectedCellIds = setProtected;
+      return (
+        <ZoraProvider>
+          <MatrixGrid
+            cells={cells}
+            height={20}
+            layout={layout}
+            protectedCellIds={protectedCellIds}
+            testID="dynamic-protected-matrix"
+            width={60}
+            renderCell={(cell) => <span>{cell.id}</span>}
+          />
+        </ZoraProvider>
+      );
+    }
+
+    try {
+      act(() => root.render(<DynamicProtectionMatrix />));
+      const a = host.querySelector<HTMLElement>('[data-testid="dynamic-protected-matrix-cell-a"]');
+      if (!a) throw new Error('Missing dynamic-protection focus origin.');
+      act(() => a.focus());
+      act(() => setProtectedCellIds?.(['a']));
+      const protectedA = host.querySelector<HTMLElement>(
+        '[data-testid="dynamic-protected-matrix-cell-a"]',
+      );
+      const b = host.querySelector<HTMLElement>('[data-testid="dynamic-protected-matrix-cell-b"]');
+      if (!protectedA || !b) throw new Error('Missing dynamic-protection cells.');
+      expect(protectedA.getAttribute('aria-disabled')).toBe('true');
+      expect(protectedA.getAttribute('tabindex')).not.toBe('0');
+      expect(b.getAttribute('tabindex')).toBe('0');
+      act(() => {
+        b.focus();
+        void b.dispatchEvent(
+          new browser.KeyboardEvent('keydown', { bubbles: true, key: 'ArrowRight' }),
+        );
+      });
+      const c = host.querySelector<HTMLElement>('[data-testid="dynamic-protected-matrix-cell-c"]');
+      expect(document.activeElement).toBe(c);
+
+      act(() => setProtectedCellIds?.(['a', 'b', 'c']));
+      expect(
+        host.querySelectorAll('[data-testid^="dynamic-protected-matrix-cell-"][tabindex="0"]'),
+      ).toHaveLength(0);
+    } finally {
+      act(() => root.unmount());
+    }
+  });
+});

package/src/features/matrix-grid/adapters/inbound/MatrixGrid.test.tsx

@@ -67,6 +67,7 @@ type MatrixGridComponent = React.ComponentType<{
   readonly layout: typeof layout;
   readonly onSelectionChange?: (ids: readonly string[]) => void;
   readonly onViewportChange?: (viewport: unknown) => void;
+  readonly protectedCellIds?: readonly string[];
   readonly renderCell: (cell: { readonly id: string }) => React.ReactNode;
   readonly readOnly?: boolean;
   readonly selectedCellIds?: readonly string[];
@@ -320,6 +321,84 @@ test('navigates sparse cells by keyboard and applies range and modifier selectio
   });
 });
 
+test('keeps protected cells disabled, unselected, and out of keyboard ranges', async () => {
+  await withMatrixDom(async (host, browser) => {
+    const selections: (readonly string[])[] = [];
+    const root = createRoot(host);
+    const { MatrixGrid } = (await load('components/matrix-grid/MatrixGrid.js')) as {
+      MatrixGrid: MatrixGridComponent;
+    };
+    const { ZoraProvider } = (await load('runtime/ZoraProvider.js')) as {
+      ZoraProvider: ZoraProviderComponent;
+    };
+    const protectedLayout = {
+      columns: [
+        { id: 'column-0', size: 20 },
+        { id: 'column-1', size: 20 },
+        { id: 'column-2', size: 20 },
+      ],
+      rows: [{ id: 'row-0', size: 20 }],
+    };
+    const protectedCells = [
+      { columnId: 'column-0', id: 'a1', rowId: 'row-0' },
+      { columnId: 'column-1', id: 'b1', rowId: 'row-0' },
+      { columnId: 'column-2', id: 'c1', rowId: 'row-0' },
+    ];
+
+    function ProtectedMatrix() {
+      const [selectedIds, setSelectedIds] = React.useState<readonly string[]>(['a1']);
+      return (
+        <ZoraProvider>
+          <MatrixGrid
+            cells={protectedCells}
+            height={40}
+            layout={protectedLayout}
+            protectedCellIds={['b1']}
+            selectedCellIds={selectedIds}
+            selectionMode="multi"
+            testID="protected-matrix"
+            width={60}
+            onSelectionChange={(ids) => {
+              selections.push(ids);
+              setSelectedIds(ids);
+            }}
+            renderCell={(cell) => <span>{cell.id}</span>}
+          />
+        </ZoraProvider>
+      );
+    }
+
+    try {
+      act(() => root.render(<ProtectedMatrix />));
+      const a1 = host.querySelector<HTMLElement>('[data-testid="protected-matrix-cell-a1"]');
+      const b1 = host.querySelector<HTMLElement>('[data-testid="protected-matrix-cell-b1"]');
+      if (!a1 || !b1) throw new Error('Missing protected matrix cells.');
+      expect(b1.getAttribute('aria-disabled')).toBe('true');
+      act(() => {
+        void b1.dispatchEvent(new browser.MouseEvent('click', { bubbles: true }));
+        void b1.dispatchEvent(
+          new browser.KeyboardEvent('keydown', { bubbles: true, key: 'Enter' }),
+        );
+        void b1.dispatchEvent(new browser.KeyboardEvent('keydown', { bubbles: true, key: ' ' }));
+        a1.focus();
+        void a1.dispatchEvent(
+          new browser.KeyboardEvent('keydown', {
+            bubbles: true,
+            key: 'ArrowRight',
+            shiftKey: true,
+          }),
+        );
+      });
+      const c1 = host.querySelector<HTMLElement>('[data-testid="protected-matrix-cell-c1"]');
+      expect(c1).not.toBeNull();
+      expect(document.activeElement).toBe(c1);
+      expect(selections).toEqual([['a1', 'c1']]);
+    } finally {
+      act(() => root.unmount());
+    }
+  });
+});
+
 test('does not capture keyboard input from interactive cell content and respects read-only selection', async () => {
   await withMatrixDom(async (host, browser) => {
     const selections: (readonly string[])[] = [];

package/src/features/matrix-grid/adapters/inbound/MatrixGrid.tsx

@@ -29,6 +29,7 @@ function MatrixGridInner({
   onSelectionChange,
   onViewportChange,
   overscanPixels = 160,
+  protectedCellIds = [],
   readOnly = false,
   renderCell,
   selectedCellIds = [],
@@ -57,6 +58,11 @@ function MatrixGridInner({
   );
   const [visibleIds, setVisibleIds] = React.useState<readonly string[]>([]);
   const anchorId = React.useRef<string | null>(null);
+  const protectedCellIdSet = React.useMemo(() => new Set(protectedCellIds), [protectedCellIds]);
+  const isNavigable = React.useCallback(
+    (id: string) => !protectedCellIdSet.has(id),
+    [protectedCellIdSet],
+  );
 
   const handleViewportChange = React.useCallback(
     (proposal: GridViewport) => {
@@ -68,7 +74,7 @@ function MatrixGridInner({
 
   const activateCell = React.useCallback(
     (cell: GridMatrixCellPlacement, event: unknown) => {
-      if (interactionPolicy === 'passive' || readOnly) return;
+      if (interactionPolicy === 'passive' || readOnly || protectedCellIdSet.has(cell.id)) return;
       const intent = isRangeSelectionEvent(event)
         ? 'range'
         : resolveSelectionEventIntent(event, 'pointer');
@@ -80,6 +86,7 @@ function MatrixGridInner({
           anchorId.current,
           intent,
           selectionMode,
+          protectedCellIdSet,
         ),
       );
       if (intent !== 'range') anchorId.current = cell.id;
@@ -91,6 +98,7 @@ function MatrixGridInner({
       selectedCellIds,
       selectionMode,
       sparseIndex.entries,
+      protectedCellIdSet,
     ],
   );
   const handleKeyboardNavigation = React.useCallback(
@@ -106,6 +114,7 @@ function MatrixGridInner({
     sparseIndex,
     interactionPolicy === 'passive',
     visibleIds,
+    isNavigable,
     handleKeyboardNavigation,
   );
   const focusedPlacement = React.useMemo(() => {
@@ -148,6 +157,7 @@ function MatrixGridInner({
             activateCell,
             keyboard,
             interactionPolicy === 'passive',
+            protectedCellIdSet.has(cell.id),
             readOnly,
             testID,
           );
@@ -171,6 +181,7 @@ function renderMatrixCell(
   activateCell: (cell: GridMatrixCellPlacement, event: unknown) => void,
   keyboard: ReturnType<typeof useMatrixGridKeyboardFocus>,
   passive: boolean,
+  protectedCell: boolean,
   readOnly: boolean,
   testID: string | undefined,
 ) {
@@ -181,7 +192,7 @@ function renderMatrixCell(
       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;
+        if (passive || protectedCell || readOnly) return false;
         activateCell(cell, event);
         return true;
       }}
@@ -191,9 +202,9 @@ function renderMatrixCell(
         accessibilityActions={[{ name: 'activate' }]}
         accessibilityLabel={`Cell ${cell.id}`}
         accessibilityRole="button"
-        accessibilityState={{ disabled: passive, selected }}
-        disabled={passive}
-        focusable={Platform.OS !== 'web' || canInteract}
+        accessibilityState={{ disabled: passive || protectedCell, selected }}
+        disabled={passive || protectedCell}
+        focusable={!protectedCell && (Platform.OS !== 'web' || canInteract)}
         style={[
           styles.cell,
           {

package/src/features/matrix-grid/adapters/inbound/useMatrixGridKeyboardFocus.ts

@@ -8,6 +8,7 @@ export function useMatrixGridKeyboardFocus(
   index: MatrixGridSparseIndex,
   disabled: boolean,
   visibleIds: readonly string[],
+  isNavigable: (id: string) => boolean,
   onNavigate: (targetId: string, originId: string, shiftKey: boolean) => void,
 ) {
   const [focusedId, setFocusedId] = React.useState<string | null>(null);
@@ -16,9 +17,19 @@ export function useMatrixGridKeyboardFocus(
   const cellRefs = React.useRef(new Map<string, FocusableCell>());
   const visibleIdSet = React.useMemo(() => new Set(visibleIds), [visibleIds]);
   const tabStopId =
-    focusedId !== null && visibleIdSet.has(focusedId)
+    focusedId !== null && visibleIdSet.has(focusedId) && isNavigable(focusedId)
       ? focusedId
-      : visibleIds.find((id) => index.positionById.has(id));
+      : visibleIds.find((id) => index.positionById.has(id) && isNavigable(id));
+
+  React.useEffect(() => {
+    if (focusedRef.current !== null && !isNavigable(focusedRef.current)) {
+      focusedRef.current = null;
+      setFocusedId(null);
+    }
+    if (pendingFocusRef.current !== null && !isNavigable(pendingFocusRef.current)) {
+      pendingFocusRef.current = null;
+    }
+  }, [isNavigable]);
 
   const onFocus = React.useCallback((id: string) => {
     pendingFocusRef.current = null;
@@ -44,7 +55,7 @@ export function useMatrixGridKeyboardFocus(
         return false;
       }
       const originId = focusedRef.current ?? id;
-      const nextId = getMatrixGridNextFocusId(index, originId, key);
+      const nextId = resolveNextNavigableId(index, originId, key, isNavigable);
       if (nextId === null || nextId === originId) return true;
 
       focusedRef.current = nextId;
@@ -59,12 +70,28 @@ export function useMatrixGridKeyboardFocus(
       }
       return true;
     },
-    [disabled, index, onNavigate],
+    [disabled, index, isNavigable, onNavigate],
   );
 
   return { focusedId, onFocus, onKeyDown, registerCell, tabStopId };
 }
 
+/*** Skip protected sparse cells while retaining the nearest deterministic directional navigation. */
+function resolveNextNavigableId(
+  index: MatrixGridSparseIndex,
+  originId: string,
+  key: string,
+  isNavigable: (id: string) => boolean,
+): string | null {
+  let candidate = getMatrixGridNextFocusId(index, originId, key);
+  while (candidate !== null && candidate !== originId && !isNavigable(candidate)) {
+    const nextCandidate = getMatrixGridNextFocusId(index, candidate, key);
+    if (nextCandidate === candidate) return originId;
+    candidate = nextCandidate;
+  }
+  return candidate;
+}
+
 interface FocusableCell {
   focus: () => void;
 }

package/src/features/matrix-grid/application/resolveMatrixGridSelection.test.ts

@@ -51,21 +51,28 @@ const cells = [
 
 describe('resolveMatrixGridSelection', () => {
   test('preserves the canonical single and multi selection intent rules', () => {
-    expect(resolveMatrixGridSelection(cells, ['a1'], 'b1', 'a1', 'toggle', 'single')).toEqual([
-      'b1',
-    ]);
-    expect(resolveMatrixGridSelection(cells, ['a1'], 'b1', 'a1', 'toggle', 'multi')).toEqual([
-      'a1',
-      'b1',
-    ]);
+    expect(
+      resolveMatrixGridSelection(cells, ['a1'], 'b1', 'a1', 'toggle', 'single', new Set()),
+    ).toEqual(['b1']);
+    expect(
+      resolveMatrixGridSelection(cells, ['a1'], 'b1', 'a1', 'toggle', 'multi', new Set()),
+    ).toEqual(['a1', 'b1']);
   });
 
   test('uses the selection contract for a sparse rectangular shift range', () => {
-    expect(resolveMatrixGridSelection(cells, ['a1'], 'b2', 'a1', 'range', 'multi')).toEqual([
-      'a1',
-      'b1',
-      'a2',
-      'b2',
-    ]);
+    expect(
+      resolveMatrixGridSelection(cells, ['a1'], 'b2', 'a1', 'range', 'multi', new Set()),
+    ).toEqual(['a1', 'b1', 'a2', 'b2']);
+  });
+
+  test('excludes protected cells from direct and range selection proposals', () => {
+    const protectedCellIds = new Set(['b1', 'a2']);
+
+    expect(
+      resolveMatrixGridSelection(cells, ['a1'], 'b1', 'a1', 'replace', 'multi', protectedCellIds),
+    ).toEqual(['a1']);
+    expect(
+      resolveMatrixGridSelection(cells, ['a1'], 'b2', 'a1', 'range', 'multi', protectedCellIds),
+    ).toEqual(['a1', 'b2']);
   });
 });

package/src/features/matrix-grid/application/resolveMatrixGridSelection.ts

@@ -12,7 +12,9 @@ export function resolveMatrixGridSelection(
   anchorId: string | null,
   intent: MatrixGridSelectionIntent,
   mode: SelectionMode,
+  protectedCellIds: ReadonlySet<string>,
 ): readonly string[] {
+  if (protectedCellIds.has(cellId)) return selectedIds;
   if (mode === 'single') return applySelectionIntent(selectedIds, cellId, 'replace');
   if (intent !== 'range') return applySelectionIntent(selectedIds, cellId, intent);
 
@@ -23,6 +25,7 @@ export function resolveMatrixGridSelection(
   return cells
     .filter(
       (cell) =>
+        !protectedCellIds.has(cell.id) &&
         cell.rowIndex >= Math.min(anchor.rowIndex, target.rowIndex) &&
         cell.rowIndex <= Math.max(anchor.rowIndex, target.rowIndex) &&
         cell.columnIndex >= Math.min(anchor.columnIndex, target.columnIndex) &&

package/src/types/matrix-grid.ts

@@ -22,6 +22,8 @@ export interface MatrixGridProps extends ZoraBaseProps {
   readonly overscanPixels?: number;
   /** Retains focus navigation while suppressing cell-selection mutations. */
   readonly readOnly?: boolean;
+  /** Cells that remain visible but cannot receive focus or change the controlled selection. */
+  readonly protectedCellIds?: readonly string[];
   readonly selectedCellIds?: readonly string[];
   readonly selectionMode?: SelectionMode;
   readonly onSelectionChange?: (ids: readonly string[]) => void;

package/web-dist/components/matrix-grid/MatrixGrid.js

@@ -110,7 +110,9 @@ function resolveMatrixGridContentSize(layout) {
 }
 
 // src/features/matrix-grid/application/resolveMatrixGridSelection.ts
-function resolveMatrixGridSelection(cells, selectedIds, cellId, anchorId, intent, mode) {
+function resolveMatrixGridSelection(cells, selectedIds, cellId, anchorId, intent, mode, protectedCellIds) {
+  if (protectedCellIds.has(cellId))
+    return selectedIds;
   if (mode === "single")
     return applySelectionIntent(selectedIds, cellId, "replace");
   if (intent !== "range")
@@ -119,7 +121,7 @@ function resolveMatrixGridSelection(cells, selectedIds, cellId, anchorId, intent
   const target = cells.find((cell) => cell.id === cellId);
   if (!anchor || !target)
     return applySelectionIntent(selectedIds, cellId, "replace");
-  return cells.filter((cell) => cell.rowIndex >= Math.min(anchor.rowIndex, target.rowIndex) && cell.rowIndex <= Math.max(anchor.rowIndex, target.rowIndex) && cell.columnIndex >= Math.min(anchor.columnIndex, target.columnIndex) && cell.columnIndex <= Math.max(anchor.columnIndex, target.columnIndex)).map((cell) => cell.id);
+  return cells.filter((cell) => !protectedCellIds.has(cell.id) && cell.rowIndex >= Math.min(anchor.rowIndex, target.rowIndex) && cell.rowIndex <= Math.max(anchor.rowIndex, target.rowIndex) && cell.columnIndex >= Math.min(anchor.columnIndex, target.columnIndex) && cell.columnIndex <= Math.max(anchor.columnIndex, target.columnIndex)).map((cell) => cell.id);
 }
 
 // src/features/matrix-grid/adapters/inbound/MatrixGridKeyboardProxy.web.tsx
@@ -214,13 +216,22 @@ function getAxisCoordinate2(entry, axis) {
 }
 
 // src/features/matrix-grid/adapters/inbound/useMatrixGridKeyboardFocus.ts
-function useMatrixGridKeyboardFocus(index, disabled, visibleIds, onNavigate) {
+function useMatrixGridKeyboardFocus(index, disabled, visibleIds, isNavigable, 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 tabStopId = focusedId !== null && visibleIdSet.has(focusedId) && isNavigable(focusedId) ? focusedId : visibleIds.find((id) => index.positionById.has(id) && isNavigable(id));
+  React.useEffect(() => {
+    if (focusedRef.current !== null && !isNavigable(focusedRef.current)) {
+      focusedRef.current = null;
+      setFocusedId(null);
+    }
+    if (pendingFocusRef.current !== null && !isNavigable(pendingFocusRef.current)) {
+      pendingFocusRef.current = null;
+    }
+  }, [isNavigable]);
   const onFocus = React.useCallback((id) => {
     pendingFocusRef.current = null;
     focusedRef.current = id;
@@ -242,7 +253,7 @@ function useMatrixGridKeyboardFocus(index, disabled, visibleIds, onNavigate) {
       return false;
     }
     const originId = focusedRef.current ?? id;
-    const nextId = getMatrixGridNextFocusId(index, originId, key);
+    const nextId = resolveNextNavigableId(index, originId, key, isNavigable);
     if (nextId === null || nextId === originId)
       return true;
     focusedRef.current = nextId;
@@ -255,9 +266,19 @@ function useMatrixGridKeyboardFocus(index, disabled, visibleIds, onNavigate) {
       mounted.focus();
     }
     return true;
-  }, [disabled, index, onNavigate]);
+  }, [disabled, index, isNavigable, onNavigate]);
   return { focusedId, onFocus, onKeyDown, registerCell, tabStopId };
 }
+function resolveNextNavigableId(index, originId, key, isNavigable) {
+  let candidate = getMatrixGridNextFocusId(index, originId, key);
+  while (candidate !== null && candidate !== originId && !isNavigable(candidate)) {
+    const nextCandidate = getMatrixGridNextFocusId(index, candidate, key);
+    if (nextCandidate === candidate)
+      return originId;
+    candidate = nextCandidate;
+  }
+  return candidate;
+}
 
 // src/features/matrix-grid/adapters/inbound/MatrixGrid.tsx
 import { jsx as jsx2 } from "react/jsx-runtime";
@@ -270,6 +291,7 @@ function MatrixGridInner({
   onSelectionChange,
   onViewportChange,
   overscanPixels = 160,
+  protectedCellIds = [],
   readOnly = false,
   renderCell,
   selectedCellIds = [],
@@ -289,16 +311,18 @@ function MatrixGridInner({
   const cellPlacements = React2.useMemo(() => getVisibleMatrixCells(layout, cells, viewport, overscanPixels), [cells, layout, overscanPixels, viewport]);
   const [visibleIds, setVisibleIds] = React2.useState([]);
   const anchorId = React2.useRef(null);
+  const protectedCellIdSet = React2.useMemo(() => new Set(protectedCellIds), [protectedCellIds]);
+  const isNavigable = React2.useCallback((id) => !protectedCellIdSet.has(id), [protectedCellIdSet]);
   const handleViewportChange = React2.useCallback((proposal) => {
     if (controlledViewport === undefined)
       setUncontrolledViewport(proposal);
     onViewportChange?.(proposal);
   }, [controlledViewport, onViewportChange]);
   const activateCell = React2.useCallback((cell, event) => {
-    if (interactionPolicy === "passive" || readOnly)
+    if (interactionPolicy === "passive" || readOnly || protectedCellIdSet.has(cell.id))
       return;
     const intent = isRangeSelectionEvent(event) ? "range" : resolveSelectionEventIntent(event, "pointer");
-    onSelectionChange?.(resolveMatrixGridSelection(sparseIndex.entries, selectedCellIds, cell.id, anchorId.current, intent, selectionMode));
+    onSelectionChange?.(resolveMatrixGridSelection(sparseIndex.entries, selectedCellIds, cell.id, anchorId.current, intent, selectionMode, protectedCellIdSet));
     if (intent !== "range")
       anchorId.current = cell.id;
   }, [
@@ -307,7 +331,8 @@ function MatrixGridInner({
     readOnly,
     selectedCellIds,
     selectionMode,
-    sparseIndex.entries
+    sparseIndex.entries,
+    protectedCellIdSet
   ]);
   const handleKeyboardNavigation = React2.useCallback((targetId, originId, shiftKey) => {
     anchorId.current ??= originId;
@@ -317,7 +342,7 @@ function MatrixGridInner({
     if (cell)
       activateCell(getMatrixCellPlacement(layout, cell), { shiftKey: true });
   }, [activateCell, layout, sparseIndex]);
-  const keyboard = useMatrixGridKeyboardFocus(sparseIndex, interactionPolicy === "passive", visibleIds, handleKeyboardNavigation);
+  const keyboard = useMatrixGridKeyboardFocus(sparseIndex, interactionPolicy === "passive", visibleIds, isNavigable, handleKeyboardNavigation);
   const focusedPlacement = React2.useMemo(() => {
     const focusedCell = keyboard.focusedId === null ? undefined : sparseIndex.cellById.get(keyboard.focusedId);
     return focusedCell ? getMatrixCellPlacement(layout, focusedCell) : undefined;
@@ -339,7 +364,7 @@ function MatrixGridInner({
         const cell = cellById.get(item.id);
         if (!cell)
           return null;
-        return renderMatrixCell(cell, selectedCellIds, theme.semantics.neutral.divider, theme.colors.primary, renderCell, activateCell, keyboard, interactionPolicy === "passive", readOnly, testID);
+        return renderMatrixCell(cell, selectedCellIds, theme.semantics.neutral.divider, theme.colors.primary, renderCell, activateCell, keyboard, interactionPolicy === "passive", protectedCellIdSet.has(cell.id), readOnly, testID);
       },
       testID,
       viewport,
@@ -348,7 +373,7 @@ function MatrixGridInner({
     })
   });
 }
-function renderMatrixCell(cell, selectedCellIds, dividerColor, selectedColor, renderCell, activateCell, keyboard, passive, readOnly, testID) {
+function renderMatrixCell(cell, selectedCellIds, dividerColor, selectedColor, renderCell, activateCell, keyboard, passive, protectedCell, readOnly, testID) {
   const selected = selectedCellIds.includes(cell.id);
   const canInteract = keyboard.tabStopId === cell.id;
   return /* @__PURE__ */ jsx2(MatrixGridKeyboardProxy, {
@@ -357,7 +382,7 @@ function renderMatrixCell(cell, selectedCellIds, dividerColor, selectedColor, re
         return true;
       if (!["Enter", " "].includes(event.key))
         return false;
-      if (passive || readOnly)
+      if (passive || protectedCell || readOnly)
         return false;
       activateCell(cell, event);
       return true;
@@ -366,9 +391,9 @@ function renderMatrixCell(cell, selectedCellIds, dividerColor, selectedColor, re
       accessibilityActions: [{ name: "activate" }],
       accessibilityLabel: `Cell ${cell.id}`,
       accessibilityRole: "button",
-      accessibilityState: { disabled: passive, selected },
-      disabled: passive,
-      focusable: import_react_native.Platform.OS !== "web" || canInteract,
+      accessibilityState: { disabled: passive || protectedCell, selected },
+      disabled: passive || protectedCell,
+      focusable: !protectedCell && (import_react_native.Platform.OS !== "web" || canInteract),
       style: [
         styles.cell,
         {