@ankhorage/zora 22.1.3 → 23.0.0

package/dist/features/selection/adapters/inbound/SelectableItem.js.map

@@ -1 +1 @@
-{"version":3,"file":"SelectableItem.js","sourceRoot":"","sources":["../../../../../src/features/selection/adapters/inbound/SelectableItem.tsx"],"names":[],"mappings":"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","sourcesContent":["import { Pressable } from '@ankhorage/surface';\nimport React from 'react';\nimport type { GestureResponderEvent } from 'react-native';\n\nimport type {\n  SelectableItemProps,\n  SelectableItemState,\n  SelectionTrigger,\n} from '../../../../types/selection';\nimport { useSelection } from './SelectionProvider';\n\nfunction resolveTrigger(trigger: SelectionTrigger | undefined): SelectionTrigger {\n  return trigger ?? 'manual';\n}\n\nfunction isRenderProp(\n  children: SelectableItemProps['children'],\n): children is (state: SelectableItemState) => React.ReactNode {\n  return typeof children === 'function';\n}\n\n/***\n * Adds selection behavior to arbitrary child content via render props.\n *\n \n */\nexport function SelectableItem({\n  id,\n  trigger,\n  disabled = false,\n  interactionPolicy,\n  children,\n}: SelectableItemProps) {\n  const selection = useSelection();\n  const resolvedTrigger = resolveTrigger(trigger);\n  const resolvedDisabled = selection.disabled || disabled;\n  const selected = selection.isSelected(id);\n\n  const select = React.useCallback(() => {\n    if (resolvedDisabled) return;\n    if (interactionPolicy === 'passive') return;\n    selection.select(id);\n  }, [id, resolvedDisabled, interactionPolicy, selection]);\n\n  const toggle = React.useCallback(() => {\n    if (resolvedDisabled) return;\n    if (interactionPolicy === 'passive') return;\n    selection.toggle(id);\n  }, [id, resolvedDisabled, interactionPolicy, selection]);\n\n  const clear = React.useCallback(() => {\n    if (selection.disabled) return;\n    if (interactionPolicy === 'passive') return;\n    selection.clear();\n  }, [interactionPolicy, selection]);\n\n  const itemState = React.useMemo<SelectableItemState>(() => {\n    return {\n      id,\n      selected,\n      disabled: resolvedDisabled,\n      mode: selection.mode,\n      select,\n      toggle,\n      clear,\n    };\n  }, [clear, id, resolvedDisabled, select, selected, selection.mode, toggle]);\n\n  // IMPORTANT:\n  // Do not pass `children` directly into Pressable. Pressable also supports function children,\n  // but its function signature receives interaction state, not SelectableItemState.\n  const content = isRenderProp(children) ? children(itemState) : children;\n\n  if (resolvedTrigger === 'manual') {\n    return <>{content}</>;\n  }\n\n  const handlePress = (event: GestureResponderEvent) => {\n    event.stopPropagation();\n    if (resolvedDisabled) return;\n    if (interactionPolicy === 'passive') return;\n    if (selection.mode === 'single') {\n      selection.select(id);\n      return;\n    }\n\n    selection.toggle(id);\n  };\n\n  const handleLongPress = (event: GestureResponderEvent) => {\n    event.stopPropagation();\n    if (resolvedDisabled) return;\n    if (interactionPolicy === 'passive') return;\n    if (selection.mode === 'single') {\n      selection.select(id);\n      return;\n    }\n\n    selection.toggle(id);\n  };\n\n  return (\n    <Pressable\n      interactionPolicy={interactionPolicy}\n      accessibilityRole=\"button\"\n      accessibilityState={{ disabled: resolvedDisabled, selected }}\n      disabled={resolvedDisabled}\n      onLongPress={resolvedTrigger === 'longPress' ? handleLongPress : undefined}\n      onPress={resolvedTrigger === 'press' ? handlePress : undefined}\n    >\n      {content}\n    </Pressable>\n  );\n}\n"]}
+{"version":3,"file":"SelectableItem.js","sourceRoot":"","sources":["../../../../../src/features/selection/adapters/inbound/SelectableItem.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAA8B,QAAQ,EAAE,MAAM,cAAc,CAAC;AAOpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,+CAA+C,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,iDAAiD;AACjD,SAAS,cAAc,CAAC,OAAqC;IAC3D,OAAO,OAAO,IAAI,QAAQ,CAAC;AAC7B,CAAC;AAED,kFAAkF;AAClF,SAAS,YAAY,CACnB,QAAyC;IAEzC,OAAO,OAAO,QAAQ,KAAK,UAAU,CAAC;AACxC,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,cAAc,CAAC,EAC7B,EAAE,EACF,OAAO,EACP,QAAQ,GAAG,KAAK,EAChB,iBAAiB,EACjB,QAAQ,GACY;IACpB,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,MAAM,eAAe,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,gBAAgB,GAAG,SAAS,CAAC,QAAQ,IAAI,QAAQ,CAAC;IACxD,MAAM,QAAQ,GAAG,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAE1C,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAChC,CAAC,MAAuB,EAAE,EAAE;QAC1B,IAAI,gBAAgB,IAAI,iBAAiB,KAAK,SAAS;YAAE,OAAO;QAChE,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACjC,CAAC,EACD,CAAC,EAAE,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,SAAS,CAAC,CACrD,CAAC;IACF,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE;QACpC,IAAI,gBAAgB,IAAI,iBAAiB,KAAK,SAAS;YAAE,OAAO;QAChE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC,EAAE,CAAC,EAAE,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,SAAS,CAAC,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE;QACpC,IAAI,gBAAgB,IAAI,iBAAiB,KAAK,SAAS;YAAE,OAAO;QAChE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC,EAAE,CAAC,EAAE,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,SAAS,CAAC,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE;QACnC,IAAI,SAAS,CAAC,QAAQ,IAAI,iBAAiB,KAAK,SAAS;YAAE,OAAO;QAClE,SAAS,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC,EAAE,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC,CAAC;IAEnC,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAC7B,GAAG,EAAE,CAAC,CAAC;QACL,EAAE;QACF,QAAQ;QACR,QAAQ,EAAE,gBAAgB;QAC1B,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,QAAQ;QACR,MAAM;QACN,MAAM;QACN,KAAK;KACN,CAAC,EACF,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAClF,CAAC;IAEF,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACxE,IAAI,eAAe,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;IAExD,MAAM,gBAAgB,GAAG,CAAC,KAA4B,EAAE,EAAE;QACxD,KAAK,CAAC,eAAe,EAAE,CAAC;QACxB,IAAI,gBAAgB,IAAI,iBAAiB,KAAK,SAAS;YAAE,OAAO;QAChE,SAAS,CAAC,QAAQ,CAChB,EAAE,EACF,2BAA2B,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAChF,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO,CACL,CAAC,SAAS,CACR,iBAAiB,CAAC,CAAC,iBAAiB,CAAC,CACrC,iBAAiB,CAAC,QAAQ,CAC1B,kBAAkB,CAAC,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,CAAC,CAC7D,QAAQ,CAAC,CAAC,gBAAgB,CAAC,CAC3B,WAAW,CAAC,CAAC,eAAe,KAAK,WAAW,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,CAC5E,OAAO,CAAC,CAAC,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,CAEpE;MAAA,CAAC,OAAO,CACV;IAAA,EAAE,SAAS,CAAC,CACb,CAAC;AACJ,CAAC","sourcesContent":["import { Pressable } from '@ankhorage/surface';\nimport type { SelectionIntent } from '@ankhorage/utility/selection';\nimport React from 'react';\nimport { type GestureResponderEvent, Platform } from 'react-native';\n\nimport type {\n  SelectableItemProps,\n  SelectableItemState,\n  SelectionTrigger,\n} from '../../../../types/selection';\nimport { resolveSelectionEventIntent } from '../../application/resolveSelectionEventIntent';\nimport { useSelection } from './SelectionProvider';\n\n/*** Resolve the configured selection trigger. */\nfunction resolveTrigger(trigger: SelectionTrigger | undefined): SelectionTrigger {\n  return trigger ?? 'manual';\n}\n\n/*** Narrow render-prop children without changing ordinary React-node children. */\nfunction isRenderProp(\n  children: SelectableItemProps['children'],\n): children is (state: SelectableItemState) => React.ReactNode {\n  return typeof children === 'function';\n}\n\n/*** Adds selection behavior to arbitrary child content via render props. */\nexport function SelectableItem({\n  id,\n  trigger,\n  disabled = false,\n  interactionPolicy,\n  children,\n}: SelectableItemProps) {\n  const selection = useSelection();\n  const resolvedTrigger = resolveTrigger(trigger);\n  const resolvedDisabled = selection.disabled || disabled;\n  const selected = selection.isSelected(id);\n\n  const activate = React.useCallback(\n    (intent: SelectionIntent) => {\n      if (resolvedDisabled || interactionPolicy === 'passive') return;\n      selection.activate(id, intent);\n    },\n    [id, interactionPolicy, resolvedDisabled, selection],\n  );\n  const select = React.useCallback(() => {\n    if (resolvedDisabled || interactionPolicy === 'passive') return;\n    selection.select(id);\n  }, [id, interactionPolicy, resolvedDisabled, selection]);\n  const toggle = React.useCallback(() => {\n    if (resolvedDisabled || interactionPolicy === 'passive') return;\n    selection.toggle(id);\n  }, [id, interactionPolicy, resolvedDisabled, selection]);\n  const clear = React.useCallback(() => {\n    if (selection.disabled || interactionPolicy === 'passive') return;\n    selection.clear();\n  }, [interactionPolicy, selection]);\n\n  const itemState = React.useMemo<SelectableItemState>(\n    () => ({\n      id,\n      selected,\n      disabled: resolvedDisabled,\n      mode: selection.mode,\n      activate,\n      select,\n      toggle,\n      clear,\n    }),\n    [activate, clear, id, resolvedDisabled, select, selected, selection.mode, toggle],\n  );\n\n  const content = isRenderProp(children) ? children(itemState) : children;\n  if (resolvedTrigger === 'manual') return <>{content}</>;\n\n  const handleActivation = (event: GestureResponderEvent) => {\n    event.stopPropagation();\n    if (resolvedDisabled || interactionPolicy === 'passive') return;\n    selection.activate(\n      id,\n      resolveSelectionEventIntent(event, Platform.OS === 'web' ? 'pointer' : 'touch'),\n    );\n  };\n\n  return (\n    <Pressable\n      interactionPolicy={interactionPolicy}\n      accessibilityRole=\"button\"\n      accessibilityState={{ disabled: resolvedDisabled, selected }}\n      disabled={resolvedDisabled}\n      onLongPress={resolvedTrigger === 'longPress' ? handleActivation : undefined}\n      onPress={resolvedTrigger === 'press' ? handleActivation : undefined}\n    >\n      {content}\n    </Pressable>\n  );\n}\n"]}

package/dist/features/selection/adapters/inbound/SelectionProvider.d.ts

@@ -1,11 +1,7 @@
 import React from 'react';
 import type { SelectionProviderProps, UseSelectionResult } from '../../../../types/selection';
-/***
- * Accesses selection state provided by `SelectionProvider`.
- */
+/*** Accesses selection state provided by `SelectionProvider`. */
 export declare function useSelection(): UseSelectionResult;
-/***
- * Provides selection state for building selectable lists and grids.
- */
+/*** Provides selection state for building selectable lists and grids. */
 export declare function SelectionProvider({ children, selectedIds, defaultSelectedIds, mode, disabled, onSelectionChange, interactionPolicy, }: SelectionProviderProps): React.JSX.Element;
 //# sourceMappingURL=SelectionProvider.d.ts.map

package/dist/features/selection/adapters/inbound/SelectionProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SelectionProvider.d.ts","sourceRoot":"","sources":["../../../../../src/features/selection/adapters/inbound/SelectionProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAEV,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,6BAA6B,CAAC;AA0BrC;;GAEG;AACH,wBAAgB,YAAY,IAAI,kBAAkB,CAOjD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,WAAW,EACX,kBAAkB,EAClB,IAAI,EACJ,QAAQ,EACR,iBAAiB,EACjB,iBAAiB,GAClB,EAAE,sBAAsB,qBAkExB"}
+{"version":3,"file":"SelectionProvider.d.ts","sourceRoot":"","sources":["../../../../../src/features/selection/adapters/inbound/SelectionProvider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAEV,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,6BAA6B,CAAC;AAoBrC,iEAAiE;AACjE,wBAAgB,YAAY,IAAI,kBAAkB,CAIjD;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,WAAW,EACX,kBAAkB,EAClB,IAAI,EACJ,QAAQ,EACR,iBAAiB,EACjB,iBAAiB,GAClB,EAAE,sBAAsB,qBA6ExB"}

package/dist/features/selection/adapters/inbound/SelectionProvider.js

@@ -1,5 +1,6 @@
+import { applySelectionIntent } from '@ankhorage/utility/selection';
 import React from 'react';
-import { areIdsEqual, clearIds, normalizeIds, selectId, toggleId, } from '../../utils/resolveSelectionNextIds';
+import { areIdsEqual, clearIds, normalizeIds, selectId } from '../../utils/resolveSelectionNextIds';
 const MISSING_CONTEXT_MESSAGE = 'ZORA selection context is missing. Wrap this tree in <SelectionProvider>.';
 const SelectionContext = React.createContext(null);
 /*** Resolve the effective selection mode. */
@@ -10,19 +11,14 @@ function resolveMode(mode) {
 function resolveDisabled(disabled) {
     return disabled ?? false;
 }
-/***
- * Accesses selection state provided by `SelectionProvider`.
- */
+/*** Accesses selection state provided by `SelectionProvider`. */
 export function useSelection() {
     const value = React.use(SelectionContext);
-    if (!value) {
+    if (!value)
         throw new Error(MISSING_CONTEXT_MESSAGE);
-    }
     return value;
 }
-/***
- * Provides selection state for building selectable lists and grids.
- */
+/*** Provides selection state for building selectable lists and grids. */
 export function SelectionProvider({ children, selectedIds, defaultSelectedIds, mode, disabled, onSelectionChange, interactionPolicy, }) {
     const resolvedMode = resolveMode(mode);
     const resolvedDisabled = resolveDisabled(disabled);
@@ -32,43 +28,51 @@ export function SelectionProvider({ children, selectedIds, defaultSelectedIds, m
     const currentNormalizedIds = normalizeIds(rawIds, resolvedMode);
     const selectedIdSet = React.useMemo(() => new Set(currentNormalizedIds), [currentNormalizedIds]);
     const commitSelectionChange = React.useCallback((nextNormalizedIds) => {
-        if (resolvedDisabled)
-            return;
-        if (interactionPolicy === 'passive')
+        if (resolvedDisabled || interactionPolicy === 'passive')
             return;
         if (areIdsEqual(nextNormalizedIds, currentNormalizedIds))
             return;
         onSelectionChange?.(nextNormalizedIds);
-        if (!isControlled) {
+        if (!isControlled)
             setUncontrolledIds(nextNormalizedIds);
-        }
     }, [currentNormalizedIds, interactionPolicy, isControlled, onSelectionChange, resolvedDisabled]);
     const clear = React.useCallback(() => {
         commitSelectionChange(normalizeIds(clearIds(), resolvedMode));
     }, [commitSelectionChange, resolvedMode]);
     const select = React.useCallback((id) => {
         const nextIds = selectId({ mode: resolvedMode, ids: currentNormalizedIds, id });
-        const nextNormalizedIds = normalizeIds(nextIds, resolvedMode);
-        commitSelectionChange(nextNormalizedIds);
+        commitSelectionChange(normalizeIds(nextIds, resolvedMode));
     }, [commitSelectionChange, currentNormalizedIds, resolvedMode]);
     const toggle = React.useCallback((id) => {
-        const nextIds = toggleId({ mode: resolvedMode, ids: currentNormalizedIds, id });
-        const nextNormalizedIds = normalizeIds(nextIds, resolvedMode);
-        commitSelectionChange(nextNormalizedIds);
+        const nextIds = applySelectionIntent(currentNormalizedIds, id, 'toggle');
+        commitSelectionChange(normalizeIds(nextIds, resolvedMode));
+    }, [commitSelectionChange, currentNormalizedIds, resolvedMode]);
+    const activate = React.useCallback((id, intent) => {
+        const effectiveIntent = resolvedMode === 'single' ? 'replace' : intent;
+        const nextIds = applySelectionIntent(currentNormalizedIds, id, effectiveIntent);
+        commitSelectionChange(normalizeIds(nextIds, resolvedMode));
     }, [commitSelectionChange, currentNormalizedIds, resolvedMode]);
-    const value = React.useMemo(() => {
-        return {
-            mode: resolvedMode,
-            disabled: resolvedDisabled,
-            selectedIds: currentNormalizedIds,
-            selectedCount: currentNormalizedIds.length,
-            hasSelection: currentNormalizedIds.length > 0,
-            isSelected: (id) => selectedIdSet.has(id),
-            select,
-            toggle,
-            clear,
-        };
-    }, [clear, currentNormalizedIds, resolvedDisabled, resolvedMode, select, selectedIdSet, toggle]);
+    const value = React.useMemo(() => ({
+        mode: resolvedMode,
+        disabled: resolvedDisabled,
+        selectedIds: currentNormalizedIds,
+        selectedCount: currentNormalizedIds.length,
+        hasSelection: currentNormalizedIds.length > 0,
+        isSelected: (id) => selectedIdSet.has(id),
+        activate,
+        select,
+        toggle,
+        clear,
+    }), [
+        activate,
+        clear,
+        currentNormalizedIds,
+        resolvedDisabled,
+        resolvedMode,
+        select,
+        selectedIdSet,
+        toggle,
+    ]);
     return <SelectionContext value={value}>{children}</SelectionContext>;
 }
 //# sourceMappingURL=SelectionProvider.js.map

package/dist/features/selection/adapters/inbound/SelectionProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"SelectionProvider.js","sourceRoot":"","sources":["../../../../../src/features/selection/adapters/inbound/SelectionProvider.tsx"],"names":[],"mappings":"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","sourcesContent":["import React from 'react';\n\nimport type {\n  SelectionMode,\n  SelectionProviderProps,\n  UseSelectionResult,\n} from '../../../../types/selection';\nimport {\n  areIdsEqual,\n  clearIds,\n  normalizeIds,\n  selectId,\n  toggleId,\n} from '../../utils/resolveSelectionNextIds';\n\nconst MISSING_CONTEXT_MESSAGE =\n  'ZORA selection context is missing. Wrap this tree in <SelectionProvider>.';\n\ntype SelectionContextValue = UseSelectionResult;\n\nconst SelectionContext = React.createContext<SelectionContextValue | null>(null);\n\n/*** Resolve the effective selection mode. */\nfunction resolveMode(mode: SelectionMode | undefined): SelectionMode {\n  return mode ?? 'single';\n}\n\n/*** Resolve the effective disabled state. */\nfunction resolveDisabled(disabled: boolean | undefined): boolean {\n  return disabled ?? false;\n}\n\n/***\n * Accesses selection state provided by `SelectionProvider`.\n */\nexport function useSelection(): UseSelectionResult {\n  const value = React.use(SelectionContext);\n  if (!value) {\n    throw new Error(MISSING_CONTEXT_MESSAGE);\n  }\n\n  return value;\n}\n\n/***\n * Provides selection state for building selectable lists and grids.\n */\nexport function SelectionProvider({\n  children,\n  selectedIds,\n  defaultSelectedIds,\n  mode,\n  disabled,\n  onSelectionChange,\n  interactionPolicy,\n}: SelectionProviderProps) {\n  const resolvedMode = resolveMode(mode);\n  const resolvedDisabled = resolveDisabled(disabled);\n  const isControlled = selectedIds !== undefined;\n\n  const [uncontrolledIds, setUncontrolledIds] = React.useState<readonly string[]>(\n    defaultSelectedIds ?? [],\n  );\n\n  const rawIds = isControlled ? selectedIds : uncontrolledIds;\n  const currentNormalizedIds = normalizeIds(rawIds, resolvedMode);\n\n  const selectedIdSet = React.useMemo(() => new Set(currentNormalizedIds), [currentNormalizedIds]);\n\n  const commitSelectionChange = React.useCallback(\n    (nextNormalizedIds: readonly string[]) => {\n      if (resolvedDisabled) return;\n      if (interactionPolicy === 'passive') return;\n      if (areIdsEqual(nextNormalizedIds, currentNormalizedIds)) return;\n\n      onSelectionChange?.(nextNormalizedIds);\n\n      if (!isControlled) {\n        setUncontrolledIds(nextNormalizedIds);\n      }\n    },\n    [currentNormalizedIds, interactionPolicy, isControlled, onSelectionChange, resolvedDisabled],\n  );\n\n  const clear = React.useCallback(() => {\n    commitSelectionChange(normalizeIds(clearIds(), resolvedMode));\n  }, [commitSelectionChange, resolvedMode]);\n\n  const select = React.useCallback(\n    (id: string) => {\n      const nextIds = selectId({ mode: resolvedMode, ids: currentNormalizedIds, id });\n      const nextNormalizedIds = normalizeIds(nextIds, resolvedMode);\n      commitSelectionChange(nextNormalizedIds);\n    },\n    [commitSelectionChange, currentNormalizedIds, resolvedMode],\n  );\n\n  const toggle = React.useCallback(\n    (id: string) => {\n      const nextIds = toggleId({ mode: resolvedMode, ids: currentNormalizedIds, id });\n      const nextNormalizedIds = normalizeIds(nextIds, resolvedMode);\n      commitSelectionChange(nextNormalizedIds);\n    },\n    [commitSelectionChange, currentNormalizedIds, resolvedMode],\n  );\n\n  const value = React.useMemo<UseSelectionResult>(() => {\n    return {\n      mode: resolvedMode,\n      disabled: resolvedDisabled,\n      selectedIds: currentNormalizedIds,\n      selectedCount: currentNormalizedIds.length,\n      hasSelection: currentNormalizedIds.length > 0,\n      isSelected: (id: string) => selectedIdSet.has(id),\n      select,\n      toggle,\n      clear,\n    };\n  }, [clear, currentNormalizedIds, resolvedDisabled, resolvedMode, select, selectedIdSet, toggle]);\n\n  return <SelectionContext value={value}>{children}</SelectionContext>;\n}\n"]}
+{"version":3,"file":"SelectionProvider.js","sourceRoot":"","sources":["../../../../../src/features/selection/adapters/inbound/SelectionProvider.tsx"],"names":[],"mappings":"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","sourcesContent":["import { applySelectionIntent, type SelectionIntent } from '@ankhorage/utility/selection';\nimport React from 'react';\n\nimport type {\n  SelectionMode,\n  SelectionProviderProps,\n  UseSelectionResult,\n} from '../../../../types/selection';\nimport { areIdsEqual, clearIds, normalizeIds, selectId } from '../../utils/resolveSelectionNextIds';\n\nconst MISSING_CONTEXT_MESSAGE =\n  'ZORA selection context is missing. Wrap this tree in <SelectionProvider>.';\n\ntype SelectionContextValue = UseSelectionResult;\n\nconst SelectionContext = React.createContext<SelectionContextValue | null>(null);\n\n/*** Resolve the effective selection mode. */\nfunction resolveMode(mode: SelectionMode | undefined): SelectionMode {\n  return mode ?? 'single';\n}\n\n/*** Resolve the effective disabled state. */\nfunction resolveDisabled(disabled: boolean | undefined): boolean {\n  return disabled ?? false;\n}\n\n/*** Accesses selection state provided by `SelectionProvider`. */\nexport function useSelection(): UseSelectionResult {\n  const value = React.use(SelectionContext);\n  if (!value) throw new Error(MISSING_CONTEXT_MESSAGE);\n  return value;\n}\n\n/*** Provides selection state for building selectable lists and grids. */\nexport function SelectionProvider({\n  children,\n  selectedIds,\n  defaultSelectedIds,\n  mode,\n  disabled,\n  onSelectionChange,\n  interactionPolicy,\n}: SelectionProviderProps) {\n  const resolvedMode = resolveMode(mode);\n  const resolvedDisabled = resolveDisabled(disabled);\n  const isControlled = selectedIds !== undefined;\n  const [uncontrolledIds, setUncontrolledIds] = React.useState<readonly string[]>(\n    defaultSelectedIds ?? [],\n  );\n\n  const rawIds = isControlled ? selectedIds : uncontrolledIds;\n  const currentNormalizedIds = normalizeIds(rawIds, resolvedMode);\n  const selectedIdSet = React.useMemo(() => new Set(currentNormalizedIds), [currentNormalizedIds]);\n\n  const commitSelectionChange = React.useCallback(\n    (nextNormalizedIds: readonly string[]) => {\n      if (resolvedDisabled || interactionPolicy === 'passive') return;\n      if (areIdsEqual(nextNormalizedIds, currentNormalizedIds)) return;\n      onSelectionChange?.(nextNormalizedIds);\n      if (!isControlled) setUncontrolledIds(nextNormalizedIds);\n    },\n    [currentNormalizedIds, interactionPolicy, isControlled, onSelectionChange, resolvedDisabled],\n  );\n\n  const clear = React.useCallback(() => {\n    commitSelectionChange(normalizeIds(clearIds(), resolvedMode));\n  }, [commitSelectionChange, resolvedMode]);\n\n  const select = React.useCallback(\n    (id: string) => {\n      const nextIds = selectId({ mode: resolvedMode, ids: currentNormalizedIds, id });\n      commitSelectionChange(normalizeIds(nextIds, resolvedMode));\n    },\n    [commitSelectionChange, currentNormalizedIds, resolvedMode],\n  );\n\n  const toggle = React.useCallback(\n    (id: string) => {\n      const nextIds = applySelectionIntent(currentNormalizedIds, id, 'toggle');\n      commitSelectionChange(normalizeIds(nextIds, resolvedMode));\n    },\n    [commitSelectionChange, currentNormalizedIds, resolvedMode],\n  );\n\n  const activate = React.useCallback(\n    (id: string, intent: SelectionIntent) => {\n      const effectiveIntent = resolvedMode === 'single' ? 'replace' : intent;\n      const nextIds = applySelectionIntent(currentNormalizedIds, id, effectiveIntent);\n      commitSelectionChange(normalizeIds(nextIds, resolvedMode));\n    },\n    [commitSelectionChange, currentNormalizedIds, resolvedMode],\n  );\n\n  const value = React.useMemo<UseSelectionResult>(\n    () => ({\n      mode: resolvedMode,\n      disabled: resolvedDisabled,\n      selectedIds: currentNormalizedIds,\n      selectedCount: currentNormalizedIds.length,\n      hasSelection: currentNormalizedIds.length > 0,\n      isSelected: (id: string) => selectedIdSet.has(id),\n      activate,\n      select,\n      toggle,\n      clear,\n    }),\n    [\n      activate,\n      clear,\n      currentNormalizedIds,\n      resolvedDisabled,\n      resolvedMode,\n      select,\n      selectedIdSet,\n      toggle,\n    ],\n  );\n\n  return <SelectionContext value={value}>{children}</SelectionContext>;\n}\n"]}

package/dist/features/selection/application/resolveSelectionEventIntent.d.ts

@@ -0,0 +1,5 @@
+import { type SelectionActivationKind } from '@ankhorage/utility/interaction';
+import type { SelectionIntent } from '@ankhorage/utility/selection';
+/*** Normalize DOM, React Native, and renderer events into one semantic selection intent. */
+export declare function resolveSelectionEventIntent(event: unknown, fallbackKind: SelectionActivationKind): SelectionIntent;
+//# sourceMappingURL=resolveSelectionEventIntent.d.ts.map

package/dist/features/selection/application/resolveSelectionEventIntent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveSelectionEventIntent.d.ts","sourceRoot":"","sources":["../../../../src/features/selection/application/resolveSelectionEventIntent.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,uBAAuB,EAE7B,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,4FAA4F;AAC5F,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,EACd,YAAY,EAAE,uBAAuB,GACpC,eAAe,CAejB"}

package/dist/features/selection/application/resolveSelectionEventIntent.js

@@ -0,0 +1,49 @@
+import { resolveSelectionIntent, } from '@ankhorage/utility/interaction';
+import { isRecord } from '@ankhorage/utility/object';
+/*** Normalize DOM, React Native, and renderer events into one semantic selection intent. */
+export function resolveSelectionEventIntent(event, fallbackKind) {
+    const source = readEventSource(event);
+    const kind = isTouchActivation(source) ? 'touch' : fallbackKind;
+    const sourceModifiers = readInteractionModifiers(source);
+    const wrapperModifiers = readInteractionModifiers(event);
+    const input = {
+        kind,
+        modifiers: {
+            altKey: sourceModifiers.altKey === true || wrapperModifiers.altKey === true,
+            ctrlKey: sourceModifiers.ctrlKey === true || wrapperModifiers.ctrlKey === true,
+            metaKey: sourceModifiers.metaKey === true || wrapperModifiers.metaKey === true,
+            shiftKey: sourceModifiers.shiftKey === true || wrapperModifiers.shiftKey === true,
+        },
+    };
+    return resolveSelectionIntent(input);
+}
+/*** Prefer one nested native/renderer event while preserving structural event compatibility. */
+function readEventSource(event) {
+    if (!isRecord(event))
+        return {};
+    if (isRecord(event.originalEvent))
+        return event.originalEvent;
+    if (isRecord(event.nativeEvent))
+        return event.nativeEvent;
+    return event;
+}
+/*** Recognize pointer and native/browser touch event shapes without depending on platform event types. */
+function isTouchActivation(source) {
+    if (source.pointerType === 'touch')
+        return true;
+    if (typeof source.type === 'string' && source.type.startsWith('touch'))
+        return true;
+    return 'touches' in source || 'changedTouches' in source;
+}
+/*** Read known modifiers explicitly so arbitrary event properties never become dynamic input keys. */
+function readInteractionModifiers(value) {
+    if (!isRecord(value))
+        return {};
+    return {
+        altKey: value.altKey === true,
+        ctrlKey: value.ctrlKey === true,
+        metaKey: value.metaKey === true,
+        shiftKey: value.shiftKey === true,
+    };
+}
+//# sourceMappingURL=resolveSelectionEventIntent.js.map

package/dist/features/selection/application/resolveSelectionEventIntent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveSelectionEventIntent.js","sourceRoot":"","sources":["../../../../src/features/selection/application/resolveSelectionEventIntent.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,sBAAsB,GAGvB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAGrD,4FAA4F;AAC5F,MAAM,UAAU,2BAA2B,CACzC,KAAc,EACd,YAAqC;IAErC,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,IAAI,GAA4B,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC;IACzF,MAAM,eAAe,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACzD,MAAM,gBAAgB,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IACzD,MAAM,KAAK,GAA8B;QACvC,IAAI;QACJ,SAAS,EAAE;YACT,MAAM,EAAE,eAAe,CAAC,MAAM,KAAK,IAAI,IAAI,gBAAgB,CAAC,MAAM,KAAK,IAAI;YAC3E,OAAO,EAAE,eAAe,CAAC,OAAO,KAAK,IAAI,IAAI,gBAAgB,CAAC,OAAO,KAAK,IAAI;YAC9E,OAAO,EAAE,eAAe,CAAC,OAAO,KAAK,IAAI,IAAI,gBAAgB,CAAC,OAAO,KAAK,IAAI;YAC9E,QAAQ,EAAE,eAAe,CAAC,QAAQ,KAAK,IAAI,IAAI,gBAAgB,CAAC,QAAQ,KAAK,IAAI;SAClF;KACF,CAAC;IACF,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,gGAAgG;AAChG,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,IAAI,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC;QAAE,OAAO,KAAK,CAAC,aAAa,CAAC;IAC9D,IAAI,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC;QAAE,OAAO,KAAK,CAAC,WAAW,CAAC;IAC1D,OAAO,KAAK,CAAC;AACf,CAAC;AAED,0GAA0G;AAC1G,SAAS,iBAAiB,CAAC,MAAyC;IAClE,IAAI,MAAM,CAAC,WAAW,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IAChD,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACpF,OAAO,SAAS,IAAI,MAAM,IAAI,gBAAgB,IAAI,MAAM,CAAC;AAC3D,CAAC;AAED,sGAAsG;AACtG,SAAS,wBAAwB,CAAC,KAAc;IAC9C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,MAAM,KAAK,IAAI;QAC7B,OAAO,EAAE,KAAK,CAAC,OAAO,KAAK,IAAI;QAC/B,OAAO,EAAE,KAAK,CAAC,OAAO,KAAK,IAAI;QAC/B,QAAQ,EAAE,KAAK,CAAC,QAAQ,KAAK,IAAI;KAClC,CAAC;AACJ,CAAC","sourcesContent":["import {\n  type InteractionModifiers,\n  resolveSelectionIntent,\n  type SelectionActivationKind,\n  type SelectionInteractionInput,\n} from '@ankhorage/utility/interaction';\nimport { isRecord } from '@ankhorage/utility/object';\nimport type { SelectionIntent } from '@ankhorage/utility/selection';\n\n/*** Normalize DOM, React Native, and renderer events into one semantic selection intent. */\nexport function resolveSelectionEventIntent(\n  event: unknown,\n  fallbackKind: SelectionActivationKind,\n): SelectionIntent {\n  const source = readEventSource(event);\n  const kind: SelectionActivationKind = isTouchActivation(source) ? 'touch' : fallbackKind;\n  const sourceModifiers = readInteractionModifiers(source);\n  const wrapperModifiers = readInteractionModifiers(event);\n  const input: SelectionInteractionInput = {\n    kind,\n    modifiers: {\n      altKey: sourceModifiers.altKey === true || wrapperModifiers.altKey === true,\n      ctrlKey: sourceModifiers.ctrlKey === true || wrapperModifiers.ctrlKey === true,\n      metaKey: sourceModifiers.metaKey === true || wrapperModifiers.metaKey === true,\n      shiftKey: sourceModifiers.shiftKey === true || wrapperModifiers.shiftKey === true,\n    },\n  };\n  return resolveSelectionIntent(input);\n}\n\n/*** Prefer one nested native/renderer event while preserving structural event compatibility. */\nfunction readEventSource(event: unknown): Readonly<Record<string, unknown>> {\n  if (!isRecord(event)) return {};\n  if (isRecord(event.originalEvent)) return event.originalEvent;\n  if (isRecord(event.nativeEvent)) return event.nativeEvent;\n  return event;\n}\n\n/*** Recognize pointer and native/browser touch event shapes without depending on platform event types. */\nfunction isTouchActivation(source: Readonly<Record<string, unknown>>): boolean {\n  if (source.pointerType === 'touch') return true;\n  if (typeof source.type === 'string' && source.type.startsWith('touch')) return true;\n  return 'touches' in source || 'changedTouches' in source;\n}\n\n/*** Read known modifiers explicitly so arbitrary event properties never become dynamic input keys. */\nfunction readInteractionModifiers(value: unknown): InteractionModifiers {\n  if (!isRecord(value)) return {};\n  return {\n    altKey: value.altKey === true,\n    ctrlKey: value.ctrlKey === true,\n    metaKey: value.metaKey === true,\n    shiftKey: value.shiftKey === true,\n  };\n}\n"]}

package/dist/features/selection/public.d.ts

@@ -1,4 +1,6 @@
 export type { SelectableItemProps, SelectableItemState, SelectionMode, SelectionProviderProps, SelectionTrigger, UseSelectionResult, } from '../../types/selection';
 export { SelectableItem } from './adapters/inbound/SelectableItem';
 export { SelectionProvider, useSelection } from './adapters/inbound/SelectionProvider';
+export { resolveSelectionEventIntent } from './application/resolveSelectionEventIntent';
+export type { SelectionIntent } from '@ankhorage/utility/selection';
 //# sourceMappingURL=public.d.ts.map

package/dist/features/selection/public.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../src/features/selection/public.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC"}
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../src/features/selection/public.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AACxF,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/features/selection/public.js

@@ -1,3 +1,4 @@
 export { SelectableItem } from './adapters/inbound/SelectableItem';
 export { SelectionProvider, useSelection } from './adapters/inbound/SelectionProvider';
+export { resolveSelectionEventIntent } from './application/resolveSelectionEventIntent';
 //# sourceMappingURL=public.js.map

package/dist/features/selection/public.js.map

@@ -1 +1 @@
-{"version":3,"file":"public.js","sourceRoot":"","sources":["../../../src/features/selection/public.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC","sourcesContent":["export type {\n  SelectableItemProps,\n  SelectableItemState,\n  SelectionMode,\n  SelectionProviderProps,\n  SelectionTrigger,\n  UseSelectionResult,\n} from '../../types/selection';\nexport { SelectableItem } from './adapters/inbound/SelectableItem';\nexport { SelectionProvider, useSelection } from './adapters/inbound/SelectionProvider';\n"]}
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../../../src/features/selection/public.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC","sourcesContent":["export type {\n  SelectableItemProps,\n  SelectableItemState,\n  SelectionMode,\n  SelectionProviderProps,\n  SelectionTrigger,\n  UseSelectionResult,\n} from '../../types/selection';\nexport { SelectableItem } from './adapters/inbound/SelectableItem';\nexport { SelectionProvider, useSelection } from './adapters/inbound/SelectionProvider';\nexport { resolveSelectionEventIntent } from './application/resolveSelectionEventIntent';\nexport type { SelectionIntent } from '@ankhorage/utility/selection';\n"]}

package/dist/features/selection/utils/resolveSelectionNextIds.d.ts

@@ -1,15 +1,14 @@
 import type { SelectionMode } from '../../../types/selection';
+/*** Normalize selected ids to stable unique membership within the configured selection mode. */
 export declare function normalizeIds(ids: readonly string[] | undefined, mode: SelectionMode): readonly string[];
+/*** Compare ordered selection ids without allocating replacement arrays. */
 export declare function areIdsEqual(a: readonly string[], b: readonly string[]): boolean;
+/*** Produce the canonical empty selection. */
 export declare function clearIds(): readonly string[];
+/*** Ensure one id is selected while preserving multi-selection membership. */
 export declare function selectId({ mode, ids, id, }: {
     mode: SelectionMode;
     ids: readonly string[];
     id: string;
 }): readonly string[];
-export declare function toggleId({ mode, ids, id, }: {
-    mode: SelectionMode;
-    ids: readonly string[];
-    id: string;
-}): readonly string[];
 //# sourceMappingURL=resolveSelectionNextIds.d.ts.map

package/dist/features/selection/utils/resolveSelectionNextIds.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolveSelectionNextIds.d.ts","sourceRoot":"","sources":["../../../../src/features/selection/utils/resolveSelectionNextIds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,wBAAgB,YAAY,CAC1B,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAClC,IAAI,EAAE,aAAa,GAClB,SAAS,MAAM,EAAE,CAYnB;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,SAAS,MAAM,EAAE,EAAE,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAO/E;AAED,wBAAgB,QAAQ,IAAI,SAAS,MAAM,EAAE,CAE5C;AAED,wBAAgB,QAAQ,CAAC,EACvB,IAAI,EACJ,GAAG,EACH,EAAE,GACH,EAAE;IACD,IAAI,EAAE,aAAa,CAAC;IACpB,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IACvB,EAAE,EAAE,MAAM,CAAC;CACZ,GAAG,SAAS,MAAM,EAAE,CAUpB;AAED,wBAAgB,QAAQ,CAAC,EACvB,IAAI,EACJ,GAAG,EACH,EAAE,GACH,EAAE;IACD,IAAI,EAAE,aAAa,CAAC;IACpB,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IACvB,EAAE,EAAE,MAAM,CAAC;CACZ,GAAG,SAAS,MAAM,EAAE,CAUpB"}
+{"version":3,"file":"resolveSelectionNextIds.d.ts","sourceRoot":"","sources":["../../../../src/features/selection/utils/resolveSelectionNextIds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,gGAAgG;AAChG,wBAAgB,YAAY,CAC1B,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAClC,IAAI,EAAE,aAAa,GAClB,SAAS,MAAM,EAAE,CAYnB;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,CAAC,EAAE,SAAS,MAAM,EAAE,EAAE,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAO/E;AAED,8CAA8C;AAC9C,wBAAgB,QAAQ,IAAI,SAAS,MAAM,EAAE,CAE5C;AAED,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,EACvB,IAAI,EACJ,GAAG,EACH,EAAE,GACH,EAAE;IACD,IAAI,EAAE,aAAa,CAAC;IACpB,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IACvB,EAAE,EAAE,MAAM,CAAC;CACZ,GAAG,SAAS,MAAM,EAAE,CAIpB"}

package/dist/features/selection/utils/resolveSelectionNextIds.js

@@ -1,3 +1,4 @@
+/*** Normalize selected ids to stable unique membership within the configured selection mode. */
 export function normalizeIds(ids, mode) {
     const uniqueIds = [];
     const seen = new Set();
@@ -11,6 +12,7 @@ export function normalizeIds(ids, mode) {
     }
     return uniqueIds;
 }
+/*** Compare ordered selection ids without allocating replacement arrays. */
 export function areIdsEqual(a, b) {
     if (a.length !== b.length)
         return false;
@@ -20,25 +22,16 @@ export function areIdsEqual(a, b) {
     }
     return true;
 }
+/*** Produce the canonical empty selection. */
 export function clearIds() {
     return [];
 }
+/*** Ensure one id is selected while preserving multi-selection membership. */
 export function selectId({ mode, ids, id, }) {
-    if (mode === 'single') {
+    if (mode === 'single')
         return [id];
-    }
-    if (ids.includes(id)) {
+    if (ids.includes(id))
         return ids;
-    }
-    return [...ids, id];
-}
-export function toggleId({ mode, ids, id, }) {
-    if (ids.includes(id)) {
-        return ids.filter((existingId) => existingId !== id);
-    }
-    if (mode === 'single') {
-        return [id];
-    }
     return [...ids, id];
 }
 //# sourceMappingURL=resolveSelectionNextIds.js.map

package/dist/features/selection/utils/resolveSelectionNextIds.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolveSelectionNextIds.js","sourceRoot":"","sources":["../../../../src/features/selection/utils/resolveSelectionNextIds.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAC1B,GAAkC,EAClC,IAAmB;IAEnB,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,SAAS;QAC3B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACb,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnB,IAAI,IAAI,KAAK,QAAQ;YAAE,MAAM;IAC/B,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,CAAoB,EAAE,CAAoB;IACpE,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACxC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;IAChD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,EACvB,IAAI,EACJ,GAAG,EACH,EAAE,GAKH;IACC,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO,CAAC,EAAE,CAAC,CAAC;IACd,CAAC;IAED,IAAI,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QACrB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,OAAO,CAAC,GAAG,GAAG,EAAE,EAAE,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,EACvB,IAAI,EACJ,GAAG,EACH,EAAE,GAKH;IACC,IAAI,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QACrB,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO,CAAC,EAAE,CAAC,CAAC;IACd,CAAC;IAED,OAAO,CAAC,GAAG,GAAG,EAAE,EAAE,CAAC,CAAC;AACtB,CAAC","sourcesContent":["import type { SelectionMode } from '../../../types/selection';\n\nexport function normalizeIds(\n  ids: readonly string[] | undefined,\n  mode: SelectionMode,\n): readonly string[] {\n  const uniqueIds: string[] = [];\n  const seen = new Set<string>();\n\n  for (const id of ids ?? []) {\n    if (seen.has(id)) continue;\n    seen.add(id);\n    uniqueIds.push(id);\n    if (mode === 'single') break;\n  }\n\n  return uniqueIds;\n}\n\nexport function areIdsEqual(a: readonly string[], b: readonly string[]): boolean {\n  if (a.length !== b.length) return false;\n  for (let index = 0; index < a.length; index += 1) {\n    if (a.at(index) !== b.at(index)) return false;\n  }\n\n  return true;\n}\n\nexport function clearIds(): readonly string[] {\n  return [];\n}\n\nexport function selectId({\n  mode,\n  ids,\n  id,\n}: {\n  mode: SelectionMode;\n  ids: readonly string[];\n  id: string;\n}): readonly string[] {\n  if (mode === 'single') {\n    return [id];\n  }\n\n  if (ids.includes(id)) {\n    return ids;\n  }\n\n  return [...ids, id];\n}\n\nexport function toggleId({\n  mode,\n  ids,\n  id,\n}: {\n  mode: SelectionMode;\n  ids: readonly string[];\n  id: string;\n}): readonly string[] {\n  if (ids.includes(id)) {\n    return ids.filter((existingId) => existingId !== id);\n  }\n\n  if (mode === 'single') {\n    return [id];\n  }\n\n  return [...ids, id];\n}\n"]}
+{"version":3,"file":"resolveSelectionNextIds.js","sourceRoot":"","sources":["../../../../src/features/selection/utils/resolveSelectionNextIds.ts"],"names":[],"mappings":"AAEA,gGAAgG;AAChG,MAAM,UAAU,YAAY,CAC1B,GAAkC,EAClC,IAAmB;IAEnB,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,SAAS;QAC3B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACb,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnB,IAAI,IAAI,KAAK,QAAQ;YAAE,MAAM;IAC/B,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,WAAW,CAAC,CAAoB,EAAE,CAAoB;IACpE,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACxC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;IAChD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,QAAQ;IACtB,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,QAAQ,CAAC,EACvB,IAAI,EACJ,GAAG,EACH,EAAE,GAKH;IACC,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IACnC,IAAI,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAAE,OAAO,GAAG,CAAC;IACjC,OAAO,CAAC,GAAG,GAAG,EAAE,EAAE,CAAC,CAAC;AACtB,CAAC","sourcesContent":["import type { SelectionMode } from '../../../types/selection';\n\n/*** Normalize selected ids to stable unique membership within the configured selection mode. */\nexport function normalizeIds(\n  ids: readonly string[] | undefined,\n  mode: SelectionMode,\n): readonly string[] {\n  const uniqueIds: string[] = [];\n  const seen = new Set<string>();\n\n  for (const id of ids ?? []) {\n    if (seen.has(id)) continue;\n    seen.add(id);\n    uniqueIds.push(id);\n    if (mode === 'single') break;\n  }\n\n  return uniqueIds;\n}\n\n/*** Compare ordered selection ids without allocating replacement arrays. */\nexport function areIdsEqual(a: readonly string[], b: readonly string[]): boolean {\n  if (a.length !== b.length) return false;\n  for (let index = 0; index < a.length; index += 1) {\n    if (a.at(index) !== b.at(index)) return false;\n  }\n\n  return true;\n}\n\n/*** Produce the canonical empty selection. */\nexport function clearIds(): readonly string[] {\n  return [];\n}\n\n/*** Ensure one id is selected while preserving multi-selection membership. */\nexport function selectId({\n  mode,\n  ids,\n  id,\n}: {\n  mode: SelectionMode;\n  ids: readonly string[];\n  id: string;\n}): readonly string[] {\n  if (mode === 'single') return [id];\n  if (ids.includes(id)) return ids;\n  return [...ids, id];\n}\n"]}

package/dist/features/tree-view/adapters/inbound/TreeItem.d.ts

@@ -1,3 +1,4 @@
+import type { SelectionIntent } from '@ankhorage/utility/selection';
 import React from 'react';
 import type { ZoraBaseProps } from '../../../../types/base';
 import type { TreeItemNode, TreeItemRenderProps } from '../../../../types/tree-view';
@@ -5,9 +6,9 @@ interface TreeItemProps<TId extends string = string> extends ZoraBaseProps {
     node: TreeItemNode<TId>;
     depth: number;
     expansionIndicator: 'chevron' | 'folder';
-    selectedId?: TId;
+    selectedIds: readonly TId[];
     expandedIds: readonly TId[];
-    onSelect?: (id: TId) => void;
+    onSelect?: (id: TId, intent: SelectionIntent) => void;
     onToggleExpand: (id: TId) => void;
     renderItem?: (props: TreeItemRenderProps<TId>) => React.ReactNode;
 }

package/dist/features/tree-view/adapters/inbound/TreeItem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TreeItem.d.ts","sourceRoot":"","sources":["../../../../../src/features/tree-view/adapters/inbound/TreeItem.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAOrF,UAAU,aAAa,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,aAAa;IACxE,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,EAAE,SAAS,GAAG,QAAQ,CAAC;IACzC,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,WAAW,EAAE,SAAS,GAAG,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,IAAI,CAAC;IAC7B,cAAc,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,IAAI,CAAC;IAClC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC;CACnE;AAuGD,oDAAoD;AACpD,eAAO,MAAM,QAAQ,GArGE,GAAG,SAAS,MAAM,kEAqGgB,CAAC"}
+{"version":3,"file":"TreeItem.d.ts","sourceRoot":"","sources":["../../../../../src/features/tree-view/adapters/inbound/TreeItem.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAQrF,UAAU,aAAa,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,aAAa;IACxE,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,EAAE,SAAS,GAAG,QAAQ,CAAC;IACzC,WAAW,EAAE,SAAS,GAAG,EAAE,CAAC;IAC5B,WAAW,EAAE,SAAS,GAAG,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;IACtD,cAAc,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,IAAI,CAAC;IAClC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC;CACnE;AAmHD,oDAAoD;AACpD,eAAO,MAAM,QAAQ,GAjHE,GAAG,SAAS,MAAM,kEAiHgB,CAAC"}

package/dist/features/tree-view/adapters/inbound/TreeItem.js

@@ -1,14 +1,17 @@
+import { Pressable } from '@ankhorage/surface';
 import React from 'react';
+import { Platform } from 'react-native';
 import { IconButton } from '../../../button/public';
 import { Icon } from '../../../icon/public';
 import { View } from '../../../layout/public';
 import { ListItem } from '../../../list/public';
+import { resolveSelectionEventIntent } from '../../../selection/public';
 import { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';
 /*** Render one recursive themed tree row and keep row selection separate from expansion controls. */
-function TreeItemInner({ themeId: _themeId, mode: _mode, node, depth, expansionIndicator, selectedId, expandedIds, onSelect, onToggleExpand, renderItem, testID, interactionPolicy, }) {
+function TreeItemInner({ themeId: _themeId, mode: _mode, node, depth, expansionIndicator, selectedIds, expandedIds, onSelect, onToggleExpand, renderItem, testID, interactionPolicy, }) {
     const hasChildren = node.children !== undefined && node.children.length > 0;
     const isExpanded = expandedIds.includes(node.id);
-    const isSelected = selectedId === node.id;
+    const isSelected = selectedIds.includes(node.id);
     /*** Compose custom content or the selectable row independently of the expansion control. */
     const renderContent = () => {
         if (renderItem) {
@@ -28,7 +31,11 @@ function TreeItemInner({ themeId: _themeId, mode: _mode, node, depth, expansionI
             selected: isSelected,
             trailing: node.actions,
         };
-        return onSelect === undefined ? (<ListItem {...listItemProps}/>) : (<ListItem {...listItemProps} onPress={() => onSelect(node.id)}/>);
+        if (onSelect === undefined)
+            return <ListItem {...listItemProps}/>;
+        return (<Pressable accessibilityRole="button" accessibilityState={{ disabled: node.disabled, selected: isSelected }} disabled={node.disabled} interactionPolicy={interactionPolicy} onPress={(event) => onSelect(node.id, resolveSelectionEventIntent(event, Platform.OS === 'web' ? 'pointer' : 'touch'))}>
+        <ListItem {...listItemProps}/>
+      </Pressable>);
     };
     return (<View testID={testID}>
       <View direction="row" align="center" style={{ paddingLeft: depth * 16 }}>
@@ -46,7 +53,7 @@ function TreeItemInner({ themeId: _themeId, mode: _mode, node, depth, expansionI
         <View style={{ flex: 1, minWidth: 0 }}>{renderContent()}</View>
       </View>
       {hasChildren && isExpanded ? (<View>
-          {node.children?.map((child) => (<TreeItem key={child.id} depth={depth + 1} expandedIds={expandedIds} expansionIndicator={expansionIndicator} interactionPolicy={interactionPolicy} node={child} onSelect={onSelect} onToggleExpand={onToggleExpand} renderItem={renderItem} selectedId={selectedId}/>))}
+          {node.children?.map((child) => (<TreeItem key={child.id} depth={depth + 1} expandedIds={expandedIds} expansionIndicator={expansionIndicator} interactionPolicy={interactionPolicy} node={child} onSelect={onSelect} onToggleExpand={onToggleExpand} renderItem={renderItem} selectedIds={selectedIds}/>))}
         </View>) : null}
     </View>);
 }

package/dist/features/tree-view/adapters/inbound/TreeItem.js.map

@@ -1 +1 @@
-{"version":3,"file":"TreeItem.js","sourceRoot":"","sources":["../../../../../src/features/tree-view/adapters/inbound/TreeItem.tsx"],"names":[],"mappings":"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","sourcesContent":["import React from 'react';\n\nimport type { ZoraBaseProps } from '../../../../types/base';\nimport type { TreeItemNode, TreeItemRenderProps } from '../../../../types/tree-view';\nimport { IconButton } from '../../../button/public';\nimport { Icon } from '../../../icon/public';\nimport { View } from '../../../layout/public';\nimport { ListItem } from '../../../list/public';\nimport { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';\n\ninterface TreeItemProps<TId extends string = string> extends ZoraBaseProps {\n  node: TreeItemNode<TId>;\n  depth: number;\n  expansionIndicator: 'chevron' | 'folder';\n  selectedId?: TId;\n  expandedIds: readonly TId[];\n  onSelect?: (id: TId) => void;\n  onToggleExpand: (id: TId) => void;\n  renderItem?: (props: TreeItemRenderProps<TId>) => React.ReactNode;\n}\n\n/*** Render one recursive themed tree row and keep row selection separate from expansion controls. */\nfunction TreeItemInner<TId extends string = string>({\n  themeId: _themeId,\n  mode: _mode,\n  node,\n  depth,\n  expansionIndicator,\n  selectedId,\n  expandedIds,\n  onSelect,\n  onToggleExpand,\n  renderItem,\n  testID,\n  interactionPolicy,\n}: TreeItemProps<TId>) {\n  const hasChildren = node.children !== undefined && node.children.length > 0;\n  const isExpanded = expandedIds.includes(node.id);\n  const isSelected = selectedId === node.id;\n\n  /*** Compose custom content or the selectable row independently of the expansion control. */\n  const renderContent = () => {\n    if (renderItem) {\n      return renderItem({\n        node,\n        depth,\n        selected: isSelected,\n        expanded: isExpanded,\n        hasChildren,\n      });\n    }\n\n    const listItemProps = {\n      title: node.label,\n      leading:\n        expansionIndicator === 'folder' || node.icon === undefined ? undefined : (\n          <Icon {...node.icon} size=\"s\" />\n        ),\n      meta: node.meta,\n      disabled: node.disabled,\n      selected: isSelected,\n      trailing: node.actions,\n    };\n\n    return onSelect === undefined ? (\n      <ListItem {...listItemProps} />\n    ) : (\n      <ListItem {...listItemProps} onPress={() => onSelect(node.id)} />\n    );\n  };\n\n  return (\n    <View testID={testID}>\n      <View direction=\"row\" align=\"center\" style={{ paddingLeft: depth * 16 }}>\n        {hasChildren ? (\n          <IconButton\n            icon={{\n              name:\n                expansionIndicator === 'folder'\n                  ? isExpanded\n                    ? 'folder-open-outline'\n                    : 'folder-outline'\n                  : isExpanded\n                    ? 'chevron-down-outline'\n                    : 'chevron-forward-outline',\n            }}\n            disabled={node.disabled}\n            interactionPolicy={interactionPolicy}\n            label={isExpanded ? 'Collapse' : 'Expand'}\n            onPress={() => onToggleExpand(node.id)}\n            size=\"s\"\n            variant=\"ghost\"\n          />\n        ) : (\n          <View style={{ width: 32 }} align=\"center\">\n            {expansionIndicator === 'folder' ? <Icon name=\"document-outline\" size=\"s\" /> : null}\n          </View>\n        )}\n        <View style={{ flex: 1, minWidth: 0 }}>{renderContent()}</View>\n      </View>\n      {hasChildren && isExpanded ? (\n        <View>\n          {node.children?.map((child) => (\n            <TreeItem\n              key={child.id}\n              depth={depth + 1}\n              expandedIds={expandedIds}\n              expansionIndicator={expansionIndicator}\n              interactionPolicy={interactionPolicy}\n              node={child}\n              onSelect={onSelect}\n              onToggleExpand={onToggleExpand}\n              renderItem={renderItem}\n              selectedId={selectedId}\n            />\n          ))}\n        </View>\n      ) : null}\n    </View>\n  );\n}\n\n/*** Single tree node row used within `TreeView`. */\nexport const TreeItem = withZoraThemeScope(TreeItemInner);\n"]}
+{"version":3,"file":"TreeItem.js","sourceRoot":"","sources":["../../../../../src/features/tree-view/adapters/inbound/TreeItem.tsx"],"names":[],"mappings":"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","sourcesContent":["import { Pressable } from '@ankhorage/surface';\nimport type { SelectionIntent } from '@ankhorage/utility/selection';\nimport React from 'react';\nimport { Platform } from 'react-native';\n\nimport type { ZoraBaseProps } from '../../../../types/base';\nimport type { TreeItemNode, TreeItemRenderProps } from '../../../../types/tree-view';\nimport { IconButton } from '../../../button/public';\nimport { Icon } from '../../../icon/public';\nimport { View } from '../../../layout/public';\nimport { ListItem } from '../../../list/public';\nimport { resolveSelectionEventIntent } from '../../../selection/public';\nimport { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';\n\ninterface TreeItemProps<TId extends string = string> extends ZoraBaseProps {\n  node: TreeItemNode<TId>;\n  depth: number;\n  expansionIndicator: 'chevron' | 'folder';\n  selectedIds: readonly TId[];\n  expandedIds: readonly TId[];\n  onSelect?: (id: TId, intent: SelectionIntent) => void;\n  onToggleExpand: (id: TId) => void;\n  renderItem?: (props: TreeItemRenderProps<TId>) => React.ReactNode;\n}\n\n/*** Render one recursive themed tree row and keep row selection separate from expansion controls. */\nfunction TreeItemInner<TId extends string = string>({\n  themeId: _themeId,\n  mode: _mode,\n  node,\n  depth,\n  expansionIndicator,\n  selectedIds,\n  expandedIds,\n  onSelect,\n  onToggleExpand,\n  renderItem,\n  testID,\n  interactionPolicy,\n}: TreeItemProps<TId>) {\n  const hasChildren = node.children !== undefined && node.children.length > 0;\n  const isExpanded = expandedIds.includes(node.id);\n  const isSelected = selectedIds.includes(node.id);\n\n  /*** Compose custom content or the selectable row independently of the expansion control. */\n  const renderContent = () => {\n    if (renderItem) {\n      return renderItem({\n        node,\n        depth,\n        selected: isSelected,\n        expanded: isExpanded,\n        hasChildren,\n      });\n    }\n\n    const listItemProps = {\n      title: node.label,\n      leading:\n        expansionIndicator === 'folder' || node.icon === undefined ? undefined : (\n          <Icon {...node.icon} size=\"s\" />\n        ),\n      meta: node.meta,\n      disabled: node.disabled,\n      selected: isSelected,\n      trailing: node.actions,\n    };\n\n    if (onSelect === undefined) return <ListItem {...listItemProps} />;\n    return (\n      <Pressable\n        accessibilityRole=\"button\"\n        accessibilityState={{ disabled: node.disabled, selected: isSelected }}\n        disabled={node.disabled}\n        interactionPolicy={interactionPolicy}\n        onPress={(event) =>\n          onSelect(\n            node.id,\n            resolveSelectionEventIntent(event, Platform.OS === 'web' ? 'pointer' : 'touch'),\n          )\n        }\n      >\n        <ListItem {...listItemProps} />\n      </Pressable>\n    );\n  };\n\n  return (\n    <View testID={testID}>\n      <View direction=\"row\" align=\"center\" style={{ paddingLeft: depth * 16 }}>\n        {hasChildren ? (\n          <IconButton\n            icon={{\n              name:\n                expansionIndicator === 'folder'\n                  ? isExpanded\n                    ? 'folder-open-outline'\n                    : 'folder-outline'\n                  : isExpanded\n                    ? 'chevron-down-outline'\n                    : 'chevron-forward-outline',\n            }}\n            disabled={node.disabled}\n            interactionPolicy={interactionPolicy}\n            label={isExpanded ? 'Collapse' : 'Expand'}\n            onPress={() => onToggleExpand(node.id)}\n            size=\"s\"\n            variant=\"ghost\"\n          />\n        ) : (\n          <View style={{ width: 32 }} align=\"center\">\n            {expansionIndicator === 'folder' ? <Icon name=\"document-outline\" size=\"s\" /> : null}\n          </View>\n        )}\n        <View style={{ flex: 1, minWidth: 0 }}>{renderContent()}</View>\n      </View>\n      {hasChildren && isExpanded ? (\n        <View>\n          {node.children?.map((child) => (\n            <TreeItem\n              key={child.id}\n              depth={depth + 1}\n              expandedIds={expandedIds}\n              expansionIndicator={expansionIndicator}\n              interactionPolicy={interactionPolicy}\n              node={child}\n              onSelect={onSelect}\n              onToggleExpand={onToggleExpand}\n              renderItem={renderItem}\n              selectedIds={selectedIds}\n            />\n          ))}\n        </View>\n      ) : null}\n    </View>\n  );\n}\n\n/*** Single tree node row used within `TreeView`. */\nexport const TreeItem = withZoraThemeScope(TreeItemInner);\n"]}

package/dist/features/tree-view/adapters/inbound/TreeView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TreeView.d.ts","sourceRoot":"","sources":["../../../../../src/features/tree-view/adapters/inbound/TreeView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AA0DjE;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAxDE,GAAG,SAAS,MAAM,kEAwDgB,CAAC"}
+{"version":3,"file":"TreeView.d.ts","sourceRoot":"","sources":["../../../../../src/features/tree-view/adapters/inbound/TreeView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAwDjE;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAtDE,GAAG,SAAS,MAAM,kEAsDgB,CAAC"}

package/dist/features/tree-view/adapters/inbound/TreeView.js

@@ -3,8 +3,8 @@ import { View } from '../../../layout/public';
 import { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';
 import { toggleExpandedIds } from '../../utils/toggleExpandedIds';
 import { TreeItem } from './TreeItem';
-/*** Render the themed TreeView while supporting controlled or internal expansion state. */
-function TreeViewInner({ themeId: _themeId, mode: _mode, nodes, selectedId, expandedIds: controlledExpandedIds, defaultExpandedIds, onSelect, onExpandedChange, renderItem, expansionIndicator = 'folder', testID, interactionPolicy, }) {
+/*** Render the themed TreeView while supporting controlled selection and expansion state. */
+function TreeViewInner({ themeId: _themeId, mode: _mode, nodes, selectedIds = [], expandedIds: controlledExpandedIds, defaultExpandedIds, onSelect, onExpandedChange, renderItem, expansionIndicator = 'folder', testID, interactionPolicy, }) {
     const [internalExpandedIds, setInternalExpandedIds] = React.useState(defaultExpandedIds ?? []);
     const isControlled = controlledExpandedIds !== undefined;
     const expandedIds = isControlled ? controlledExpandedIds : internalExpandedIds;
@@ -12,13 +12,12 @@ function TreeViewInner({ themeId: _themeId, mode: _mode, nodes, selectedId, expa
         if (interactionPolicy === 'passive')
             return;
         const nextExpandedIds = toggleExpandedIds(expandedIds, id);
-        if (!isControlled) {
+        if (!isControlled)
             setInternalExpandedIds(nextExpandedIds);
-        }
         onExpandedChange?.(nextExpandedIds);
     };
     return (<View gap="none" testID={testID}>
-      {nodes.map((node) => (<TreeItem key={node.id} depth={0} expandedIds={expandedIds} expansionIndicator={expansionIndicator} node={node} onSelect={onSelect} onToggleExpand={handleToggleExpand} renderItem={renderItem} selectedId={selectedId} interactionPolicy={interactionPolicy}/>))}
+      {nodes.map((node) => (<TreeItem key={node.id} depth={0} expandedIds={expandedIds} expansionIndicator={expansionIndicator} node={node} onSelect={onSelect} onToggleExpand={handleToggleExpand} renderItem={renderItem} selectedIds={selectedIds} interactionPolicy={interactionPolicy}/>))}
     </View>);
 }
 /***

package/dist/features/tree-view/adapters/inbound/TreeView.js.map

@@ -1 +1 @@
-{"version":3,"file":"TreeView.js","sourceRoot":"","sources":["../../../../../src/features/tree-view/adapters/inbound/TreeView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,2FAA2F;AAC3F,SAAS,aAAa,CAA8B,EAClD,OAAO,EAAE,QAAQ,EACjB,IAAI,EAAE,KAAK,EACX,KAAK,EACL,UAAU,EACV,WAAW,EAAE,qBAAqB,EAClC,kBAAkB,EAClB,QAAQ,EACR,gBAAgB,EAChB,UAAU,EACV,kBAAkB,GAAG,QAAQ,EAC7B,MAAM,EACN,iBAAiB,GACE;IACnB,MAAM,CAAC,mBAAmB,EAAE,sBAAsB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAClE,kBAAkB,IAAI,EAAE,CACzB,CAAC;IAEF,MAAM,YAAY,GAAG,qBAAqB,KAAK,SAAS,CAAC;IACzD,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,mBAAmB,CAAC;IAE/E,MAAM,kBAAkB,GAAG,CAAC,EAAO,EAAE,EAAE;QACrC,IAAI,iBAAiB,KAAK,SAAS;YAAE,OAAO;QAC5C,MAAM,eAAe,GAAG,iBAAiB,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAE3D,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,sBAAsB,CAAC,eAAe,CAAC,CAAC;QAC1C,CAAC;QACD,gBAAgB,EAAE,CAAC,eAAe,CAAC,CAAC;IACtC,CAAC,CAAC;IAEF,OAAO,CACL,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAC9B;MAAA,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CACnB,CAAC,QAAQ,CACP,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CACb,KAAK,CAAC,CAAC,CAAC,CAAC,CACT,WAAW,CAAC,CAAC,WAAW,CAAC,CACzB,kBAAkB,CAAC,CAAC,kBAAkB,CAAC,CACvC,IAAI,CAAC,CAAC,IAAI,CAAC,CACX,QAAQ,CAAC,CAAC,QAAQ,CAAC,CACnB,cAAc,CAAC,CAAC,kBAAkB,CAAC,CACnC,UAAU,CAAC,CAAC,UAAU,CAAC,CACvB,UAAU,CAAC,CAAC,UAAU,CAAC,CACvB,iBAAiB,CAAC,CAAC,iBAAiB,CAAC,EACrC,CACH,CAAC,CACJ;IAAA,EAAE,IAAI,CAAC,CACR,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,aAAa,CAAC,CAAC","sourcesContent":["import React from 'react';\n\nimport type { TreeViewProps } from '../../../../types/tree-view';\nimport { View } from '../../../layout/public';\nimport { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';\nimport { toggleExpandedIds } from '../../utils/toggleExpandedIds';\nimport { TreeItem } from './TreeItem';\n\n/*** Render the themed TreeView while supporting controlled or internal expansion state. */\nfunction TreeViewInner<TId extends string = string>({\n  themeId: _themeId,\n  mode: _mode,\n  nodes,\n  selectedId,\n  expandedIds: controlledExpandedIds,\n  defaultExpandedIds,\n  onSelect,\n  onExpandedChange,\n  renderItem,\n  expansionIndicator = 'folder',\n  testID,\n  interactionPolicy,\n}: TreeViewProps<TId>) {\n  const [internalExpandedIds, setInternalExpandedIds] = React.useState<readonly TId[]>(\n    defaultExpandedIds ?? [],\n  );\n\n  const isControlled = controlledExpandedIds !== undefined;\n  const expandedIds = isControlled ? controlledExpandedIds : internalExpandedIds;\n\n  const handleToggleExpand = (id: TId) => {\n    if (interactionPolicy === 'passive') return;\n    const nextExpandedIds = toggleExpandedIds(expandedIds, id);\n\n    if (!isControlled) {\n      setInternalExpandedIds(nextExpandedIds);\n    }\n    onExpandedChange?.(nextExpandedIds);\n  };\n\n  return (\n    <View gap=\"none\" testID={testID}>\n      {nodes.map((node) => (\n        <TreeItem\n          key={node.id}\n          depth={0}\n          expandedIds={expandedIds}\n          expansionIndicator={expansionIndicator}\n          node={node}\n          onSelect={onSelect}\n          onToggleExpand={handleToggleExpand}\n          renderItem={renderItem}\n          selectedId={selectedId}\n          interactionPolicy={interactionPolicy}\n        />\n      ))}\n    </View>\n  );\n}\n\n/***\n * Tree view pattern for hierarchical navigation and expandable lists.\n * expansionIndicator Select `folder` (default) or `chevron` for leading expansion controls.\n * Expansion controls are separate from row selection, including when rendering custom row content.\n */\nexport const TreeView = withZoraThemeScope(TreeViewInner);\n"]}
+{"version":3,"file":"TreeView.js","sourceRoot":"","sources":["../../../../../src/features/tree-view/adapters/inbound/TreeView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,6FAA6F;AAC7F,SAAS,aAAa,CAA8B,EAClD,OAAO,EAAE,QAAQ,EACjB,IAAI,EAAE,KAAK,EACX,KAAK,EACL,WAAW,GAAG,EAAE,EAChB,WAAW,EAAE,qBAAqB,EAClC,kBAAkB,EAClB,QAAQ,EACR,gBAAgB,EAChB,UAAU,EACV,kBAAkB,GAAG,QAAQ,EAC7B,MAAM,EACN,iBAAiB,GACE;IACnB,MAAM,CAAC,mBAAmB,EAAE,sBAAsB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAClE,kBAAkB,IAAI,EAAE,CACzB,CAAC;IAEF,MAAM,YAAY,GAAG,qBAAqB,KAAK,SAAS,CAAC;IACzD,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,mBAAmB,CAAC;IAE/E,MAAM,kBAAkB,GAAG,CAAC,EAAO,EAAE,EAAE;QACrC,IAAI,iBAAiB,KAAK,SAAS;YAAE,OAAO;QAC5C,MAAM,eAAe,GAAG,iBAAiB,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAE3D,IAAI,CAAC,YAAY;YAAE,sBAAsB,CAAC,eAAe,CAAC,CAAC;QAC3D,gBAAgB,EAAE,CAAC,eAAe,CAAC,CAAC;IACtC,CAAC,CAAC;IAEF,OAAO,CACL,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAC9B;MAAA,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CACnB,CAAC,QAAQ,CACP,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CACb,KAAK,CAAC,CAAC,CAAC,CAAC,CACT,WAAW,CAAC,CAAC,WAAW,CAAC,CACzB,kBAAkB,CAAC,CAAC,kBAAkB,CAAC,CACvC,IAAI,CAAC,CAAC,IAAI,CAAC,CACX,QAAQ,CAAC,CAAC,QAAQ,CAAC,CACnB,cAAc,CAAC,CAAC,kBAAkB,CAAC,CACnC,UAAU,CAAC,CAAC,UAAU,CAAC,CACvB,WAAW,CAAC,CAAC,WAAW,CAAC,CACzB,iBAAiB,CAAC,CAAC,iBAAiB,CAAC,EACrC,CACH,CAAC,CACJ;IAAA,EAAE,IAAI,CAAC,CACR,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,aAAa,CAAC,CAAC","sourcesContent":["import React from 'react';\n\nimport type { TreeViewProps } from '../../../../types/tree-view';\nimport { View } from '../../../layout/public';\nimport { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';\nimport { toggleExpandedIds } from '../../utils/toggleExpandedIds';\nimport { TreeItem } from './TreeItem';\n\n/*** Render the themed TreeView while supporting controlled selection and expansion state. */\nfunction TreeViewInner<TId extends string = string>({\n  themeId: _themeId,\n  mode: _mode,\n  nodes,\n  selectedIds = [],\n  expandedIds: controlledExpandedIds,\n  defaultExpandedIds,\n  onSelect,\n  onExpandedChange,\n  renderItem,\n  expansionIndicator = 'folder',\n  testID,\n  interactionPolicy,\n}: TreeViewProps<TId>) {\n  const [internalExpandedIds, setInternalExpandedIds] = React.useState<readonly TId[]>(\n    defaultExpandedIds ?? [],\n  );\n\n  const isControlled = controlledExpandedIds !== undefined;\n  const expandedIds = isControlled ? controlledExpandedIds : internalExpandedIds;\n\n  const handleToggleExpand = (id: TId) => {\n    if (interactionPolicy === 'passive') return;\n    const nextExpandedIds = toggleExpandedIds(expandedIds, id);\n\n    if (!isControlled) setInternalExpandedIds(nextExpandedIds);\n    onExpandedChange?.(nextExpandedIds);\n  };\n\n  return (\n    <View gap=\"none\" testID={testID}>\n      {nodes.map((node) => (\n        <TreeItem\n          key={node.id}\n          depth={0}\n          expandedIds={expandedIds}\n          expansionIndicator={expansionIndicator}\n          node={node}\n          onSelect={onSelect}\n          onToggleExpand={handleToggleExpand}\n          renderItem={renderItem}\n          selectedIds={selectedIds}\n          interactionPolicy={interactionPolicy}\n        />\n      ))}\n    </View>\n  );\n}\n\n/***\n * Tree view pattern for hierarchical navigation and expandable lists.\n * expansionIndicator Select `folder` (default) or `chevron` for leading expansion controls.\n * Expansion controls are separate from row selection, including when rendering custom row content.\n */\nexport const TreeView = withZoraThemeScope(TreeViewInner);\n"]}

package/dist/features/tree-view/adapters/inbound/web-artifact/TreeItemRow.d.ts

@@ -1,3 +1,4 @@
+import type { SelectionIntent } from '@ankhorage/utility/selection';
 import React from 'react';
 import type { TreeItemNode, TreeItemRenderProps } from './TreeView';
 /*** Render one recursive browser tree row while keeping selection and expansion independent. */
@@ -6,9 +7,9 @@ interface TreeItemRowProps<TId extends string> {
     readonly node: TreeItemNode<TId>;
     readonly depth: number;
     readonly expansionIndicator: 'chevron' | 'folder';
-    readonly selectedId?: TId;
+    readonly selectedIds: readonly TId[];
     readonly expandedIds: readonly TId[];
-    readonly onSelect?: (id: TId) => void;
+    readonly onSelect?: (id: TId, intent: SelectionIntent) => void;
     readonly onToggleExpand: (id: TId) => void;
     readonly renderItem?: (props: TreeItemRenderProps<TId>) => React.ReactNode;
 }

package/dist/features/tree-view/adapters/inbound/web-artifact/TreeItemRow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TreeItemRow.d.ts","sourceRoot":"","sources":["../../../../../../src/features/tree-view/adapters/inbound/web-artifact/TreeItemRow.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEpE,gGAAgG;AAChG,wBAAgB,WAAW,CAAC,GAAG,SAAS,MAAM,EAAE,KAAK,EAAE,gBAAgB,CAAC,GAAG,CAAC,qBAuC3E;AAED,UAAU,gBAAgB,CAAC,GAAG,SAAS,MAAM;IAC3C,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,kBAAkB,EAAE,SAAS,GAAG,QAAQ,CAAC;IAClD,QAAQ,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,SAAS,GAAG,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,IAAI,CAAC;IACtC,QAAQ,CAAC,cAAc,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,IAAI,CAAC;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC;CAC5E"}
+{"version":3,"file":"TreeItemRow.d.ts","sourceRoot":"","sources":["../../../../../../src/features/tree-view/adapters/inbound/web-artifact/TreeItemRow.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEpE,gGAAgG;AAChG,wBAAgB,WAAW,CAAC,GAAG,SAAS,MAAM,EAAE,KAAK,EAAE,gBAAgB,CAAC,GAAG,CAAC,qBAwC3E;AAED,UAAU,gBAAgB,CAAC,GAAG,SAAS,MAAM;IAC3C,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,kBAAkB,EAAE,SAAS,GAAG,QAAQ,CAAC;IAClD,QAAQ,CAAC,WAAW,EAAE,SAAS,GAAG,EAAE,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,SAAS,GAAG,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;IAC/D,QAAQ,CAAC,cAAc,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,IAAI,CAAC;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC;CAC5E"}