@ankhorage/zora 1.2.0 → 1.3.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 1.3.0
+
+### Minor Changes
+
+- 93791a4: Add `SelectionProvider`, `useSelection`, and `SelectableItem` primitives for contextual selection workflows.
+
 ## 1.2.0
 
 ### Minor Changes

package/README.md

@@ -1612,6 +1612,78 @@ No inherited props. `FilterBarProps` is declared directly by ZORA.
 
 </details>
 
+### `SelectionProvider` / `useSelection` / `SelectableItem`
+
+Scoped selection state for contextual app bar workflows. Selection state is local interaction state and must not live in `ZoraProvider`.
+
+Basic usage (selection mode for `AppBar` stays prop-driven):
+
+```tsx
+function SelectionHeader() {
+  const selection = useSelection();
+
+  return (
+    <AppBar
+      title={selection.hasSelection ? undefined : 'Inbox'}
+      appMode={
+        selection.hasSelection
+          ? {
+              type: 'selection',
+              label: 'Selected',
+              count: selection.selectedCount,
+              onCancel: selection.clear,
+            }
+          : undefined
+      }
+    />
+  );
+}
+
+<SelectionProvider mode="single">
+  <SelectionHeader />
+  <SelectableItem id="message-1" trigger="press">
+    {({ selected }) => <Card compact title={selected ? 'Selected' : 'Tap to select'} />}
+  </SelectableItem>
+</SelectionProvider>;
+```
+
+Trigger strategies:
+
+- `trigger="press"` selects on press.
+- `trigger="longPress"` selects on long press.
+- `trigger="manual"` does not bind automatic triggers; consumers call `select`, `toggle`, or `clear` explicitly.
+
+Nested providers are isolated by default: `useSelection()` always reads the nearest `SelectionProvider`.
+
+<details>
+<summary>Props</summary>
+
+`SelectionProvider` props:
+
+| Prop                 | Type                               | Default    | Notes                                             |
+| -------------------- | ---------------------------------- | ---------- | ------------------------------------------------- |
+| `children`           | `React.ReactNode`                  | -          | Required region subtree.                          |
+| `selectedIds`        | `readonly string[]`                | -          | Controlled selected ids (string ids).             |
+| `defaultSelectedIds` | `readonly string[]`                | -          | Uncontrolled initial selected ids.                |
+| `mode`               | `'single' \| 'multi'`              | `'single'` | Selection mode.                                   |
+| `disabled`           | `boolean`                          | `false`    | Disables selection updates (select/toggle/clear). |
+| `onSelectionChange`  | `(ids: readonly string[]) => void` | -          | Called on selection changes (no-op ignored).      |
+
+`SelectableItem` props:
+
+| Prop       | Type                                                     | Default    | Notes                                                                                                                   |
+| ---------- | -------------------------------------------------------- | ---------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `id`       | `string`                                                 | -          | Required item id.                                                                                                       |
+| `trigger`  | `'press' \| 'longPress' \| 'manual'`                     | `'manual'` | Automatic selection trigger strategy.                                                                                   |
+| `disabled` | `boolean`                                                | `false`    | Disables item `select`/`toggle` and automatic triggers (render-prop `clear()` still works unless provider is disabled). |
+| `children` | `ReactNode \| (state: SelectableItemState) => ReactNode` | -          | Render-prop receives selection state and helpers.                                                                       |
+
+Accessibility note:
+
+- For `trigger="manual"`, `SelectableItem` renders no interactive wrapper and does not apply accessibility props automatically. Consumers are responsible for `accessibilityState`, roles, and handlers.
+
+</details>
+
 ### `List`
 
 List wrapper that renders `ListRow` items with dividers or spacing, or accepts custom children.

package/dist/index.d.ts

@@ -104,6 +104,8 @@ export type { ResponsivePanelDesktopMode, ResponsivePanelMobileMode, ResponsiveP
 export { ResponsivePanel } from './patterns/responsive-panel';
 export type { SectionHeaderProps } from './patterns/section-header';
 export { SectionHeader } from './patterns/section-header';
+export type { SelectableItemProps, SelectableItemState, SelectionMode, SelectionProviderProps, SelectionTrigger, UseSelectionResult, } from './patterns/selection';
+export { SelectableItem, SelectionProvider, useSelection } from './patterns/selection';
 export type { SettingsRowProps } from './patterns/settings-row';
 export { SettingsRow } from './patterns/settings-row';
 export type { SwitchFieldProps } from './patterns/switch-field';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACpE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACpG,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAChE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,SAAS,EACT,oBAAoB,EACpB,oBAAoB,EACpB,UAAU,EACV,wBAAwB,EACxB,uBAAuB,EACvB,cAAc,GACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,IAAI,EACJ,WAAW,EACX,SAAS,EACT,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,aAAa,GACd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,YAAY,EACV,mBAAmB,EACnB,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,YAAY,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAChG,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACxF,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACjG,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC9F,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC9D,YAAY,EACV,QAAQ,EACR,WAAW,EACX,cAAc,EACd,YAAY,EACZ,SAAS,EACT,WAAW,EACX,SAAS,EACT,WAAW,EACX,UAAU,EACV,YAAY,EACZ,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,GAAG,EACH,MAAM,EACN,SAAS,EACT,OAAO,EACP,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,MAAM,EACN,KAAK,EACL,OAAO,GACR,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACtF,YAAY,EACV,qBAAqB,EACrB,+BAA+B,GAChC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,YAAY,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,YAAY,EACV,qBAAqB,EACrB,0BAA0B,EAC1B,eAAe,GAChB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,YAAY,EACZ,cAAc,EACd,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC7D,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACvF,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC7D,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC7F,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -51,6 +51,7 @@ export { Notice } from './patterns/notice';
 export { Panel } from './patterns/panel';
 export { ResponsivePanel } from './patterns/responsive-panel';
 export { SectionHeader } from './patterns/section-header';
+export { SelectableItem, SelectionProvider, useSelection } from './patterns/selection';
 export { SettingsRow } from './patterns/settings-row';
 export { SwitchField } from './patterns/switch-field';
 export { ThemeComposer } from './patterns/theme-composer';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["export type { AppBarMode, AppBarOverflowAction, AppBarProps } from './components/app-bar';\nexport { AppBar } from './components/app-bar';\nexport type { AvatarProps, AvatarShape, AvatarSize } from './components/avatar';\nexport { Avatar, resolveAvatarInitials } from './components/avatar';\nexport type { AvatarGroupItem, AvatarGroupProps } from './components/avatar-group';\nexport { AvatarGroup } from './components/avatar-group';\nexport type { BadgeProps } from './components/badge';\nexport { Badge } from './components/badge';\nexport type { ButtonProps } from './components/button';\nexport { Button } from './components/button';\nexport type { CardProps } from './components/card';\nexport { Card } from './components/card';\nexport type { CheckboxGroupOption, CheckboxGroupProps, CheckboxProps } from './components/checkbox';\nexport { Checkbox, CheckboxGroup } from './components/checkbox';\nexport type { ChipProps } from './components/chip';\nexport { Chip } from './components/chip';\nexport type { ChipGroupItem, ChipGroupProps } from './components/chip-group';\nexport { ChipGroup } from './components/chip-group';\nexport type { DrawerProps } from './components/drawer';\nexport { Drawer } from './components/drawer';\nexport type {\n  FormActionsProps,\n  FormErrorProps,\n  FormErrors,\n  FormFieldConfig,\n  FormFieldControlProps,\n  FormFieldInputType,\n  FormFieldProps,\n  FormFieldValue,\n  FormFieldWrapperProps,\n  FormProps,\n  FormValidationErrors,\n  FormValidationResult,\n  FormValues,\n  UseFormControllerOptions,\n  UseFormControllerResult,\n  ValidationRule,\n} from './components/form';\nexport {\n  Form,\n  FormActions,\n  FormError,\n  FormField,\n  hasRequiredRule,\n  useFormController,\n  validateField,\n  validateFields,\n  validateValue,\n} from './components/form';\nexport type {\n  HeadingAlign,\n  HeadingLevel,\n  HeadingProps,\n  HeadingSize,\n  HeadingTone,\n  HeadingWeight,\n} from './components/heading';\nexport { Heading } from './components/heading';\nexport type { IconProps } from './components/icon';\nexport { Icon } from './components/icon';\nexport type { IconButtonProps } from './components/icon-button';\nexport { IconButton } from './components/icon-button';\nexport type { ImageFit, ImageProps, SurfaceImageSource } from './components/image';\nexport { Image } from './components/image';\nexport type { InputProps, InputTrailingAction } from './components/input';\nexport { Input } from './components/input';\nexport type { MediaCardImageProps, MediaCardProps } from './components/media-card';\nexport { MediaCard } from './components/media-card';\nexport type { MetricCardProps } from './components/metric-card';\nexport { MetricCard } from './components/metric-card';\nexport type { ModalProps } from './components/modal';\nexport { Modal } from './components/modal';\nexport type {\n  NavigationItemProps,\n  ZoraNavigationRouteMetadata,\n  ZoraNavigationRouteState,\n} from './components/navigation-item';\nexport { NavigationItem } from './components/navigation-item';\nexport type { NavigationListProps, ZoraNavigationRouteMap } from './components/navigation-list';\nexport { NavigationList } from './components/navigation-list';\nexport type { ProgressProps } from './components/progress';\nexport { Progress } from './components/progress';\nexport type { RadioGroupOption, RadioGroupProps, RadioProps } from './components/radio';\nexport { Radio, RadioGroup } from './components/radio';\nexport type { RatingProps } from './components/rating';\nexport { Rating } from './components/rating';\nexport type { SearchBarProps } from './components/search-bar';\nexport { SearchBar } from './components/search-bar';\nexport type { SelectOption, SelectProps } from './components/select';\nexport { Select } from './components/select';\nexport type { TabItem, TabsProps, TabsVariant } from './components/tabs';\nexport { Tabs } from './components/tabs';\nexport type { TextAlign, TextProps, TextTone, TextVariant, TextWeight } from './components/text';\nexport { Text } from './components/text';\nexport type { TextareaProps } from './components/textarea';\nexport { Textarea } from './components/textarea';\nexport type { ToolbarActionProps, ToolbarPosition, ToolbarProps } from './components/toolbar';\nexport { Toolbar, ToolbarAction } from './components/toolbar';\nexport type {\n  BoxProps,\n  CenterProps,\n  ContainerProps,\n  DividerProps,\n  GridProps,\n  InlineProps,\n  ShowProps,\n  SpacerProps,\n  StackProps,\n  SurfaceProps,\n  SurfaceVariant,\n} from './foundation';\nexport {\n  Box,\n  Center,\n  Container,\n  Divider,\n  Grid,\n  Inline,\n  Show,\n  Spacer,\n  Stack,\n  Surface,\n} from './foundation';\nexport type { AppShellProps } from './layout/app-shell';\nexport { AppShell } from './layout/app-shell';\nexport type { AuthLayoutProps } from './layout/auth-layout';\nexport { AuthLayout } from './layout/auth-layout';\nexport type { PageProps } from './layout/page';\nexport { Page } from './layout/page';\nexport type { PageHeaderProps } from './layout/page-header';\nexport { PageHeader } from './layout/page-header';\nexport type { PageSectionProps } from './layout/page-section';\nexport { PageSection } from './layout/page-section';\nexport type { SettingsLayoutProps } from './layout/settings-layout';\nexport { SettingsLayout } from './layout/settings-layout';\nexport type { SidebarLayoutProps } from './layout/sidebar-layout';\nexport { SidebarLayout } from './layout/sidebar-layout';\nexport type { TopbarLayoutProps } from './layout/topbar-layout';\nexport { TopbarLayout } from './layout/topbar-layout';\nexport type {\n  AuthFormBaseProps,\n  AuthIdentifierKind,\n  ForgotPasswordFormProps,\n  ForgotPasswordFormValues,\n  OtpFormProps,\n  OtpFormValues,\n  SignInFormProps,\n  SignInFormValues,\n  SignUpFormField,\n  SignUpFormProps,\n  SignUpFormValues,\n} from './patterns/auth';\nexport { ForgotPasswordForm, OtpForm, SignInForm, SignUpForm } from './patterns/auth';\nexport type {\n  CollectionEditorProps,\n  CollectionEditorRenderItemProps,\n} from './patterns/collection-editor';\nexport { CollectionEditor } from './patterns/collection-editor';\nexport type { ConfirmDialogProps } from './patterns/confirm-dialog';\nexport { ConfirmDialog } from './patterns/confirm-dialog';\nexport type { DisclosureSectionProps } from './patterns/disclosure-section';\nexport { DisclosureSection } from './patterns/disclosure-section';\nexport type { EmptyStateAction, EmptyStateProps } from './patterns/empty-state';\nexport { EmptyState } from './patterns/empty-state';\nexport type { FilterBarProps } from './patterns/filter-bar';\nexport { FilterBar } from './patterns/filter-bar';\nexport type {\n  ImagePreviewProps,\n  ZoraImageAsset,\n  ZoraImageMetadata,\n} from './patterns/image-preview';\nexport { ImagePreview } from './patterns/image-preview';\nexport type {\n  ImageUploadFieldProps,\n  ImageUploadProgressContext,\n  ZoraPickedImage,\n} from './patterns/image-upload-field';\nexport { ImageUploadField } from './patterns/image-upload-field';\nexport type { InspectorFieldProps } from './patterns/inspector-field';\nexport { InspectorField } from './patterns/inspector-field';\nexport type {\n  ListChildrenProps,\n  ListItemsProps,\n  ListProps,\n  ListRowProps,\n  ListRowVariant,\n  ListSectionProps,\n} from './patterns/list';\nexport { List, ListRow, ListSection } from './patterns/list';\nexport type { NoticeProps } from './patterns/notice';\nexport { Notice } from './patterns/notice';\nexport type { PanelProps } from './patterns/panel';\nexport { Panel } from './patterns/panel';\nexport type {\n  ResponsivePanelDesktopMode,\n  ResponsivePanelMobileMode,\n  ResponsivePanelProps,\n  ResponsivePanelSide,\n} from './patterns/responsive-panel';\nexport { ResponsivePanel } from './patterns/responsive-panel';\nexport type { SectionHeaderProps } from './patterns/section-header';\nexport { SectionHeader } from './patterns/section-header';\nexport type { SettingsRowProps } from './patterns/settings-row';\nexport { SettingsRow } from './patterns/settings-row';\nexport type { SwitchFieldProps } from './patterns/switch-field';\nexport { SwitchField } from './patterns/switch-field';\nexport type { ThemeComposerProps } from './patterns/theme-composer';\nexport { ThemeComposer } from './patterns/theme-composer';\nexport type { PaletteItemProps, TileGridProps } from './patterns/tile-grid';\nexport { PaletteItem, TileGrid } from './patterns/tile-grid';\nexport type { TimelineItem, TimelineProps } from './patterns/timeline';\nexport { Timeline } from './patterns/timeline';\nexport type { TreeItemNode, TreeItemRenderProps, TreeViewProps } from './patterns/tree-view';\nexport { TreeItem, TreeView } from './patterns/tree-view';\nexport type { ZoraDrawerContentProps } from './patterns/zora-drawer-content';\nexport { ZoraDrawerContent } from './patterns/zora-drawer-content';\nexport type { ZoraTabBarProps } from './patterns/zora-tab-bar';\nexport { ZoraTabBar } from './patterns/zora-tab-bar';\nexport * from './theme';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["export type { AppBarMode, AppBarOverflowAction, AppBarProps } from './components/app-bar';\nexport { AppBar } from './components/app-bar';\nexport type { AvatarProps, AvatarShape, AvatarSize } from './components/avatar';\nexport { Avatar, resolveAvatarInitials } from './components/avatar';\nexport type { AvatarGroupItem, AvatarGroupProps } from './components/avatar-group';\nexport { AvatarGroup } from './components/avatar-group';\nexport type { BadgeProps } from './components/badge';\nexport { Badge } from './components/badge';\nexport type { ButtonProps } from './components/button';\nexport { Button } from './components/button';\nexport type { CardProps } from './components/card';\nexport { Card } from './components/card';\nexport type { CheckboxGroupOption, CheckboxGroupProps, CheckboxProps } from './components/checkbox';\nexport { Checkbox, CheckboxGroup } from './components/checkbox';\nexport type { ChipProps } from './components/chip';\nexport { Chip } from './components/chip';\nexport type { ChipGroupItem, ChipGroupProps } from './components/chip-group';\nexport { ChipGroup } from './components/chip-group';\nexport type { DrawerProps } from './components/drawer';\nexport { Drawer } from './components/drawer';\nexport type {\n  FormActionsProps,\n  FormErrorProps,\n  FormErrors,\n  FormFieldConfig,\n  FormFieldControlProps,\n  FormFieldInputType,\n  FormFieldProps,\n  FormFieldValue,\n  FormFieldWrapperProps,\n  FormProps,\n  FormValidationErrors,\n  FormValidationResult,\n  FormValues,\n  UseFormControllerOptions,\n  UseFormControllerResult,\n  ValidationRule,\n} from './components/form';\nexport {\n  Form,\n  FormActions,\n  FormError,\n  FormField,\n  hasRequiredRule,\n  useFormController,\n  validateField,\n  validateFields,\n  validateValue,\n} from './components/form';\nexport type {\n  HeadingAlign,\n  HeadingLevel,\n  HeadingProps,\n  HeadingSize,\n  HeadingTone,\n  HeadingWeight,\n} from './components/heading';\nexport { Heading } from './components/heading';\nexport type { IconProps } from './components/icon';\nexport { Icon } from './components/icon';\nexport type { IconButtonProps } from './components/icon-button';\nexport { IconButton } from './components/icon-button';\nexport type { ImageFit, ImageProps, SurfaceImageSource } from './components/image';\nexport { Image } from './components/image';\nexport type { InputProps, InputTrailingAction } from './components/input';\nexport { Input } from './components/input';\nexport type { MediaCardImageProps, MediaCardProps } from './components/media-card';\nexport { MediaCard } from './components/media-card';\nexport type { MetricCardProps } from './components/metric-card';\nexport { MetricCard } from './components/metric-card';\nexport type { ModalProps } from './components/modal';\nexport { Modal } from './components/modal';\nexport type {\n  NavigationItemProps,\n  ZoraNavigationRouteMetadata,\n  ZoraNavigationRouteState,\n} from './components/navigation-item';\nexport { NavigationItem } from './components/navigation-item';\nexport type { NavigationListProps, ZoraNavigationRouteMap } from './components/navigation-list';\nexport { NavigationList } from './components/navigation-list';\nexport type { ProgressProps } from './components/progress';\nexport { Progress } from './components/progress';\nexport type { RadioGroupOption, RadioGroupProps, RadioProps } from './components/radio';\nexport { Radio, RadioGroup } from './components/radio';\nexport type { RatingProps } from './components/rating';\nexport { Rating } from './components/rating';\nexport type { SearchBarProps } from './components/search-bar';\nexport { SearchBar } from './components/search-bar';\nexport type { SelectOption, SelectProps } from './components/select';\nexport { Select } from './components/select';\nexport type { TabItem, TabsProps, TabsVariant } from './components/tabs';\nexport { Tabs } from './components/tabs';\nexport type { TextAlign, TextProps, TextTone, TextVariant, TextWeight } from './components/text';\nexport { Text } from './components/text';\nexport type { TextareaProps } from './components/textarea';\nexport { Textarea } from './components/textarea';\nexport type { ToolbarActionProps, ToolbarPosition, ToolbarProps } from './components/toolbar';\nexport { Toolbar, ToolbarAction } from './components/toolbar';\nexport type {\n  BoxProps,\n  CenterProps,\n  ContainerProps,\n  DividerProps,\n  GridProps,\n  InlineProps,\n  ShowProps,\n  SpacerProps,\n  StackProps,\n  SurfaceProps,\n  SurfaceVariant,\n} from './foundation';\nexport {\n  Box,\n  Center,\n  Container,\n  Divider,\n  Grid,\n  Inline,\n  Show,\n  Spacer,\n  Stack,\n  Surface,\n} from './foundation';\nexport type { AppShellProps } from './layout/app-shell';\nexport { AppShell } from './layout/app-shell';\nexport type { AuthLayoutProps } from './layout/auth-layout';\nexport { AuthLayout } from './layout/auth-layout';\nexport type { PageProps } from './layout/page';\nexport { Page } from './layout/page';\nexport type { PageHeaderProps } from './layout/page-header';\nexport { PageHeader } from './layout/page-header';\nexport type { PageSectionProps } from './layout/page-section';\nexport { PageSection } from './layout/page-section';\nexport type { SettingsLayoutProps } from './layout/settings-layout';\nexport { SettingsLayout } from './layout/settings-layout';\nexport type { SidebarLayoutProps } from './layout/sidebar-layout';\nexport { SidebarLayout } from './layout/sidebar-layout';\nexport type { TopbarLayoutProps } from './layout/topbar-layout';\nexport { TopbarLayout } from './layout/topbar-layout';\nexport type {\n  AuthFormBaseProps,\n  AuthIdentifierKind,\n  ForgotPasswordFormProps,\n  ForgotPasswordFormValues,\n  OtpFormProps,\n  OtpFormValues,\n  SignInFormProps,\n  SignInFormValues,\n  SignUpFormField,\n  SignUpFormProps,\n  SignUpFormValues,\n} from './patterns/auth';\nexport { ForgotPasswordForm, OtpForm, SignInForm, SignUpForm } from './patterns/auth';\nexport type {\n  CollectionEditorProps,\n  CollectionEditorRenderItemProps,\n} from './patterns/collection-editor';\nexport { CollectionEditor } from './patterns/collection-editor';\nexport type { ConfirmDialogProps } from './patterns/confirm-dialog';\nexport { ConfirmDialog } from './patterns/confirm-dialog';\nexport type { DisclosureSectionProps } from './patterns/disclosure-section';\nexport { DisclosureSection } from './patterns/disclosure-section';\nexport type { EmptyStateAction, EmptyStateProps } from './patterns/empty-state';\nexport { EmptyState } from './patterns/empty-state';\nexport type { FilterBarProps } from './patterns/filter-bar';\nexport { FilterBar } from './patterns/filter-bar';\nexport type {\n  ImagePreviewProps,\n  ZoraImageAsset,\n  ZoraImageMetadata,\n} from './patterns/image-preview';\nexport { ImagePreview } from './patterns/image-preview';\nexport type {\n  ImageUploadFieldProps,\n  ImageUploadProgressContext,\n  ZoraPickedImage,\n} from './patterns/image-upload-field';\nexport { ImageUploadField } from './patterns/image-upload-field';\nexport type { InspectorFieldProps } from './patterns/inspector-field';\nexport { InspectorField } from './patterns/inspector-field';\nexport type {\n  ListChildrenProps,\n  ListItemsProps,\n  ListProps,\n  ListRowProps,\n  ListRowVariant,\n  ListSectionProps,\n} from './patterns/list';\nexport { List, ListRow, ListSection } from './patterns/list';\nexport type { NoticeProps } from './patterns/notice';\nexport { Notice } from './patterns/notice';\nexport type { PanelProps } from './patterns/panel';\nexport { Panel } from './patterns/panel';\nexport type {\n  ResponsivePanelDesktopMode,\n  ResponsivePanelMobileMode,\n  ResponsivePanelProps,\n  ResponsivePanelSide,\n} from './patterns/responsive-panel';\nexport { ResponsivePanel } from './patterns/responsive-panel';\nexport type { SectionHeaderProps } from './patterns/section-header';\nexport { SectionHeader } from './patterns/section-header';\nexport type {\n  SelectableItemProps,\n  SelectableItemState,\n  SelectionMode,\n  SelectionProviderProps,\n  SelectionTrigger,\n  UseSelectionResult,\n} from './patterns/selection';\nexport { SelectableItem, SelectionProvider, useSelection } from './patterns/selection';\nexport type { SettingsRowProps } from './patterns/settings-row';\nexport { SettingsRow } from './patterns/settings-row';\nexport type { SwitchFieldProps } from './patterns/switch-field';\nexport { SwitchField } from './patterns/switch-field';\nexport type { ThemeComposerProps } from './patterns/theme-composer';\nexport { ThemeComposer } from './patterns/theme-composer';\nexport type { PaletteItemProps, TileGridProps } from './patterns/tile-grid';\nexport { PaletteItem, TileGrid } from './patterns/tile-grid';\nexport type { TimelineItem, TimelineProps } from './patterns/timeline';\nexport { Timeline } from './patterns/timeline';\nexport type { TreeItemNode, TreeItemRenderProps, TreeViewProps } from './patterns/tree-view';\nexport { TreeItem, TreeView } from './patterns/tree-view';\nexport type { ZoraDrawerContentProps } from './patterns/zora-drawer-content';\nexport { ZoraDrawerContent } from './patterns/zora-drawer-content';\nexport type { ZoraTabBarProps } from './patterns/zora-tab-bar';\nexport { ZoraTabBar } from './patterns/zora-tab-bar';\nexport * from './theme';\n"]}

package/dist/patterns/selection/SelectableItem.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import type { SelectableItemProps } from './types';
+export declare function SelectableItem({ id, trigger, disabled, children }: SelectableItemProps): React.JSX.Element;
+//# sourceMappingURL=SelectableItem.d.ts.map

package/dist/patterns/selection/SelectableItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelectableItem.d.ts","sourceRoot":"","sources":["../../../src/patterns/selection/SelectableItem.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,KAAK,EAAE,mBAAmB,EAAyC,MAAM,SAAS,CAAC;AAY1F,wBAAgB,cAAc,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,QAAgB,EAAE,QAAQ,EAAE,EAAE,mBAAmB,qBA2E9F"}

package/dist/patterns/selection/SelectableItem.js

@@ -0,0 +1,72 @@
+import { ButtonBase } from '@ankhorage/surface';
+import React from 'react';
+import { useSelection } from './SelectionProvider';
+function resolveTrigger(trigger) {
+    return trigger ?? 'manual';
+}
+function isRenderProp(children) {
+    return typeof children === 'function';
+}
+export function SelectableItem({ id, trigger, disabled = false, children }) {
+    const selection = useSelection();
+    const resolvedTrigger = resolveTrigger(trigger);
+    const resolvedDisabled = selection.disabled || disabled;
+    const selected = selection.isSelected(id);
+    const select = React.useCallback(() => {
+        if (resolvedDisabled)
+            return;
+        selection.select(id);
+    }, [id, resolvedDisabled, selection]);
+    const toggle = React.useCallback(() => {
+        if (resolvedDisabled)
+            return;
+        selection.toggle(id);
+    }, [id, resolvedDisabled, selection]);
+    const clear = React.useCallback(() => {
+        if (selection.disabled)
+            return;
+        selection.clear();
+    }, [selection]);
+    const itemState = React.useMemo(() => {
+        return {
+            id,
+            selected,
+            disabled: resolvedDisabled,
+            mode: selection.mode,
+            select,
+            toggle,
+            clear,
+        };
+    }, [clear, id, resolvedDisabled, select, selected, selection.mode, toggle]);
+    // IMPORTANT:
+    // Do not pass `children` directly into ButtonBase. ButtonBase also supports function children,
+    // but its function signature receives interaction state, not SelectableItemState.
+    const content = isRenderProp(children) ? children(itemState) : children;
+    if (resolvedTrigger === 'manual') {
+        return <>{content}</>;
+    }
+    const handlePress = (event) => {
+        event.stopPropagation();
+        if (resolvedDisabled)
+            return;
+        if (selection.mode === 'single') {
+            selection.select(id);
+            return;
+        }
+        selection.toggle(id);
+    };
+    const handleLongPress = (event) => {
+        event.stopPropagation();
+        if (resolvedDisabled)
+            return;
+        if (selection.mode === 'single') {
+            selection.select(id);
+            return;
+        }
+        selection.toggle(id);
+    };
+    return (<ButtonBase accessibilityRole="button" accessibilityState={{ disabled: resolvedDisabled, selected }} disabled={resolvedDisabled} onLongPress={resolvedTrigger === 'longPress' ? handleLongPress : undefined} onPress={resolvedTrigger === 'press' ? handlePress : undefined}>
+      {content}
+    </ButtonBase>);
+}
+//# sourceMappingURL=SelectableItem.js.map

package/dist/patterns/selection/SelectableItem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelectableItem.js","sourceRoot":"","sources":["../../../src/patterns/selection/SelectableItem.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,SAAS,cAAc,CAAC,OAAqC;IAC3D,OAAO,OAAO,IAAI,QAAQ,CAAC;AAC7B,CAAC;AAED,SAAS,YAAY,CACnB,QAAyC;IAEzC,OAAO,OAAO,QAAQ,KAAK,UAAU,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,GAAG,KAAK,EAAE,QAAQ,EAAuB;IAC7F,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,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE;QACpC,IAAI,gBAAgB;YAAE,OAAO;QAC7B,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC,EAAE,CAAC,EAAE,EAAE,gBAAgB,EAAE,SAAS,CAAC,CAAC,CAAC;IAEtC,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE;QACpC,IAAI,gBAAgB;YAAE,OAAO;QAC7B,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC,EAAE,CAAC,EAAE,EAAE,gBAAgB,EAAE,SAAS,CAAC,CAAC,CAAC;IAEtC,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE;QACnC,IAAI,SAAS,CAAC,QAAQ;YAAE,OAAO;QAC/B,SAAS,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhB,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAsB,GAAG,EAAE;QACxD,OAAO;YACL,EAAE;YACF,QAAQ;YACR,QAAQ,EAAE,gBAAgB;YAC1B,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,MAAM;YACN,MAAM;YACN,KAAK;SACN,CAAC;IACJ,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAE5E,aAAa;IACb,+FAA+F;IAC/F,kFAAkF;IAClF,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAExE,IAAI,eAAe,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;IACxB,CAAC;IAED,MAAM,WAAW,GAAG,CAAC,KAA4B,EAAE,EAAE;QACnD,KAAK,CAAC,eAAe,EAAE,CAAC;QACxB,IAAI,gBAAgB;YAAE,OAAO;QAC7B,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC,CAAC;IAEF,MAAM,eAAe,GAAG,CAAC,KAA4B,EAAE,EAAE;QACvD,KAAK,CAAC,eAAe,EAAE,CAAC;QACxB,IAAI,gBAAgB;YAAE,OAAO;QAC7B,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC,CAAC;IAEF,OAAO,CACL,CAAC,UAAU,CACT,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,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAC3E,OAAO,CAAC,CAAC,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAE/D;MAAA,CAAC,OAAO,CACV;IAAA,EAAE,UAAU,CAAC,CACd,CAAC;AACJ,CAAC","sourcesContent":["import { ButtonBase } from '@ankhorage/surface';\nimport React from 'react';\nimport type { GestureResponderEvent } from 'react-native';\n\nimport { useSelection } from './SelectionProvider';\nimport type { SelectableItemProps, SelectableItemState, SelectionTrigger } from './types';\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\nexport function SelectableItem({ id, trigger, disabled = false, children }: 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    selection.select(id);\n  }, [id, resolvedDisabled, selection]);\n\n  const toggle = React.useCallback(() => {\n    if (resolvedDisabled) return;\n    selection.toggle(id);\n  }, [id, resolvedDisabled, selection]);\n\n  const clear = React.useCallback(() => {\n    if (selection.disabled) return;\n    selection.clear();\n  }, [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 ButtonBase. ButtonBase 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 (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 (selection.mode === 'single') {\n      selection.select(id);\n      return;\n    }\n\n    selection.toggle(id);\n  };\n\n  return (\n    <ButtonBase\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    </ButtonBase>\n  );\n}\n"]}

package/dist/patterns/selection/SelectionProvider.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { SelectionProviderProps, UseSelectionResult } from './types';
+export declare function useSelection(): UseSelectionResult;
+export declare function SelectionProvider({ children, selectedIds, defaultSelectedIds, mode, disabled, onSelectionChange, }: SelectionProviderProps): React.JSX.Element;
+//# sourceMappingURL=SelectionProvider.d.ts.map

package/dist/patterns/selection/SelectionProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelectionProvider.d.ts","sourceRoot":"","sources":["../../../src/patterns/selection/SelectionProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAiB,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAiBzF,wBAAgB,YAAY,IAAI,kBAAkB,CAOjD;AAED,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,WAAW,EACX,kBAAkB,EAClB,IAAI,EACJ,QAAQ,EACR,iBAAiB,GAClB,EAAE,sBAAsB,qBAiExB"}

package/dist/patterns/selection/SelectionProvider.js

@@ -0,0 +1,64 @@
+import React from 'react';
+import { areIdsEqual, clearIds, normalizeIds, selectId, toggleId } from './resolveSelectionNextIds';
+const MISSING_CONTEXT_MESSAGE = 'ZORA selection context is missing. Wrap this tree in <SelectionProvider>.';
+const SelectionContext = React.createContext(null);
+function resolveMode(mode) {
+    return mode ?? 'single';
+}
+function resolveDisabled(disabled) {
+    return disabled ?? false;
+}
+export function useSelection() {
+    const value = React.useContext(SelectionContext);
+    if (!value) {
+        throw new Error(MISSING_CONTEXT_MESSAGE);
+    }
+    return value;
+}
+export function SelectionProvider({ children, selectedIds, defaultSelectedIds, mode, disabled, onSelectionChange, }) {
+    const resolvedMode = resolveMode(mode);
+    const resolvedDisabled = resolveDisabled(disabled);
+    const isControlled = selectedIds !== undefined;
+    const [uncontrolledIds, setUncontrolledIds] = React.useState(defaultSelectedIds ?? []);
+    const rawIds = isControlled ? selectedIds : uncontrolledIds;
+    const currentNormalizedIds = normalizeIds(rawIds, resolvedMode);
+    const selectedIdSet = React.useMemo(() => new Set(currentNormalizedIds), [currentNormalizedIds]);
+    const commitSelectionChange = React.useCallback((nextNormalizedIds) => {
+        if (resolvedDisabled)
+            return;
+        if (areIdsEqual(nextNormalizedIds, currentNormalizedIds))
+            return;
+        onSelectionChange?.(nextNormalizedIds);
+        if (!isControlled) {
+            setUncontrolledIds(nextNormalizedIds);
+        }
+    }, [currentNormalizedIds, 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, currentNormalizedIds, resolvedMode]);
+    const toggle = React.useCallback((id) => {
+        const nextIds = toggleId({ mode: resolvedMode, ids: currentNormalizedIds, id });
+        const nextNormalizedIds = normalizeIds(nextIds, resolvedMode);
+        commitSelectionChange(nextNormalizedIds);
+    }, [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]);
+    return <SelectionContext.Provider value={value}>{children}</SelectionContext.Provider>;
+}
+//# sourceMappingURL=SelectionProvider.js.map

package/dist/patterns/selection/SelectionProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelectionProvider.js","sourceRoot":"","sources":["../../../src/patterns/selection/SelectionProvider.tsx"],"names":[],"mappings":"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","sourcesContent":["import React from 'react';\n\nimport { areIdsEqual, clearIds, normalizeIds, selectId, toggleId } from './resolveSelectionNextIds';\nimport type { SelectionMode, SelectionProviderProps, UseSelectionResult } from './types';\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\nfunction resolveMode(mode: SelectionMode | undefined): SelectionMode {\n  return mode ?? 'single';\n}\n\nfunction resolveDisabled(disabled: boolean | undefined): boolean {\n  return disabled ?? false;\n}\n\nexport function useSelection(): UseSelectionResult {\n  const value = React.useContext(SelectionContext);\n  if (!value) {\n    throw new Error(MISSING_CONTEXT_MESSAGE);\n  }\n\n  return value;\n}\n\nexport function SelectionProvider({\n  children,\n  selectedIds,\n  defaultSelectedIds,\n  mode,\n  disabled,\n  onSelectionChange,\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 (areIdsEqual(nextNormalizedIds, currentNormalizedIds)) return;\n\n      onSelectionChange?.(nextNormalizedIds);\n\n      if (!isControlled) {\n        setUncontrolledIds(nextNormalizedIds);\n      }\n    },\n    [currentNormalizedIds, 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.Provider value={value}>{children}</SelectionContext.Provider>;\n}\n"]}

package/dist/patterns/selection/index.d.ts

@@ -0,0 +1,4 @@
+export { SelectableItem } from './SelectableItem';
+export { SelectionProvider, useSelection } from './SelectionProvider';
+export type { SelectableItemProps, SelectableItemState, SelectionMode, SelectionProviderProps, SelectionTrigger, UseSelectionResult, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/patterns/selection/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/patterns/selection/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACtE,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,SAAS,CAAC"}

package/dist/patterns/selection/index.js

@@ -0,0 +1,3 @@
+export { SelectableItem } from './SelectableItem';
+export { SelectionProvider, useSelection } from './SelectionProvider';
+//# sourceMappingURL=index.js.map

package/dist/patterns/selection/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/patterns/selection/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC","sourcesContent":["export { SelectableItem } from './SelectableItem';\nexport { SelectionProvider, useSelection } from './SelectionProvider';\nexport type {\n  SelectableItemProps,\n  SelectableItemState,\n  SelectionMode,\n  SelectionProviderProps,\n  SelectionTrigger,\n  UseSelectionResult,\n} from './types';\n"]}

package/dist/patterns/selection/resolveSelectionNextIds.d.ts

@@ -0,0 +1,15 @@
+import type { SelectionMode } from './types';
+export declare function normalizeIds(ids: readonly string[] | undefined, mode: SelectionMode): readonly string[];
+export declare function areIdsEqual(a: readonly string[], b: readonly string[]): boolean;
+export declare function clearIds(): readonly string[];
+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/patterns/selection/resolveSelectionNextIds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveSelectionNextIds.d.ts","sourceRoot":"","sources":["../../../src/patterns/selection/resolveSelectionNextIds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,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"}

package/dist/patterns/selection/resolveSelectionNextIds.js

@@ -0,0 +1,44 @@
+export function normalizeIds(ids, mode) {
+    const uniqueIds = [];
+    const seen = new Set();
+    for (const id of ids ?? []) {
+        if (seen.has(id))
+            continue;
+        seen.add(id);
+        uniqueIds.push(id);
+        if (mode === 'single')
+            break;
+    }
+    return uniqueIds;
+}
+export function areIdsEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let index = 0; index < a.length; index += 1) {
+        if (a[index] !== b[index])
+            return false;
+    }
+    return true;
+}
+export function clearIds() {
+    return [];
+}
+export function selectId({ mode, ids, id, }) {
+    if (mode === 'single') {
+        return [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/patterns/selection/resolveSelectionNextIds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveSelectionNextIds.js","sourceRoot":"","sources":["../../../src/patterns/selection/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,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;IAC1C,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';\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[index] !== b[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"]}

package/dist/patterns/selection/types.d.ts

@@ -0,0 +1,38 @@
+import type React from 'react';
+export type SelectionMode = 'single' | 'multi';
+export type SelectionTrigger = 'press' | 'longPress' | 'manual';
+export interface SelectionProviderProps {
+    children: React.ReactNode;
+    selectedIds?: readonly string[];
+    defaultSelectedIds?: readonly string[];
+    mode?: SelectionMode;
+    disabled?: boolean;
+    onSelectionChange?: (ids: readonly string[]) => void;
+}
+export interface UseSelectionResult {
+    mode: SelectionMode;
+    disabled: boolean;
+    selectedIds: readonly string[];
+    selectedCount: number;
+    hasSelection: boolean;
+    isSelected: (id: string) => boolean;
+    select: (id: string) => void;
+    toggle: (id: string) => void;
+    clear: () => void;
+}
+export interface SelectableItemState {
+    id: string;
+    selected: boolean;
+    disabled: boolean;
+    mode: SelectionMode;
+    select: () => void;
+    toggle: () => void;
+    clear: () => void;
+}
+export interface SelectableItemProps {
+    id: string;
+    trigger?: SelectionTrigger;
+    disabled?: boolean;
+    children: React.ReactNode | ((state: SelectableItemState) => React.ReactNode);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/patterns/selection/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/patterns/selection/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE/C,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEhE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IACpC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,mBAAmB,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC;CAC/E"}

package/dist/patterns/selection/types.js

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

package/dist/patterns/selection/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/patterns/selection/types.ts"],"names":[],"mappings":"","sourcesContent":["import type React from 'react';\n\nexport type SelectionMode = 'single' | 'multi';\n\nexport type SelectionTrigger = 'press' | 'longPress' | 'manual';\n\nexport interface SelectionProviderProps {\n  children: React.ReactNode;\n  selectedIds?: readonly string[];\n  defaultSelectedIds?: readonly string[];\n  mode?: SelectionMode;\n  disabled?: boolean;\n  onSelectionChange?: (ids: readonly string[]) => void;\n}\n\nexport interface UseSelectionResult {\n  mode: SelectionMode;\n  disabled: boolean;\n  selectedIds: readonly string[];\n  selectedCount: number;\n  hasSelection: boolean;\n  isSelected: (id: string) => boolean;\n  select: (id: string) => void;\n  toggle: (id: string) => void;\n  clear: () => void;\n}\n\nexport interface SelectableItemState {\n  id: string;\n  selected: boolean;\n  disabled: boolean;\n  mode: SelectionMode;\n  select: () => void;\n  toggle: () => void;\n  clear: () => void;\n}\n\nexport interface SelectableItemProps {\n  id: string;\n  trigger?: SelectionTrigger;\n  disabled?: boolean;\n  children: React.ReactNode | ((state: SelectableItemState) => React.ReactNode);\n}\n"]}

package/package.json

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

package/src/index.ts

@@ -200,6 +200,15 @@ export type {
 export { ResponsivePanel } from './patterns/responsive-panel';
 export type { SectionHeaderProps } from './patterns/section-header';
 export { SectionHeader } from './patterns/section-header';
+export type {
+  SelectableItemProps,
+  SelectableItemState,
+  SelectionMode,
+  SelectionProviderProps,
+  SelectionTrigger,
+  UseSelectionResult,
+} from './patterns/selection';
+export { SelectableItem, SelectionProvider, useSelection } from './patterns/selection';
 export type { SettingsRowProps } from './patterns/settings-row';
 export { SettingsRow } from './patterns/settings-row';
 export type { SwitchFieldProps } from './patterns/switch-field';

package/src/patterns/selection/SelectableItem.tsx

@@ -0,0 +1,93 @@
+import { ButtonBase } from '@ankhorage/surface';
+import React from 'react';
+import type { GestureResponderEvent } from 'react-native';
+
+import { useSelection } from './SelectionProvider';
+import type { SelectableItemProps, SelectableItemState, SelectionTrigger } from './types';
+
+function resolveTrigger(trigger: SelectionTrigger | undefined): SelectionTrigger {
+  return trigger ?? 'manual';
+}
+
+function isRenderProp(
+  children: SelectableItemProps['children'],
+): children is (state: SelectableItemState) => React.ReactNode {
+  return typeof children === 'function';
+}
+
+export function SelectableItem({ id, trigger, disabled = false, children }: SelectableItemProps) {
+  const selection = useSelection();
+  const resolvedTrigger = resolveTrigger(trigger);
+  const resolvedDisabled = selection.disabled || disabled;
+  const selected = selection.isSelected(id);
+
+  const select = React.useCallback(() => {
+    if (resolvedDisabled) return;
+    selection.select(id);
+  }, [id, resolvedDisabled, selection]);
+
+  const toggle = React.useCallback(() => {
+    if (resolvedDisabled) return;
+    selection.toggle(id);
+  }, [id, resolvedDisabled, selection]);
+
+  const clear = React.useCallback(() => {
+    if (selection.disabled) return;
+    selection.clear();
+  }, [selection]);
+
+  const itemState = React.useMemo<SelectableItemState>(() => {
+    return {
+      id,
+      selected,
+      disabled: resolvedDisabled,
+      mode: selection.mode,
+      select,
+      toggle,
+      clear,
+    };
+  }, [clear, id, resolvedDisabled, select, selected, selection.mode, toggle]);
+
+  // IMPORTANT:
+  // Do not pass `children` directly into ButtonBase. ButtonBase also supports function children,
+  // but its function signature receives interaction state, not SelectableItemState.
+  const content = isRenderProp(children) ? children(itemState) : children;
+
+  if (resolvedTrigger === 'manual') {
+    return <>{content}</>;
+  }
+
+  const handlePress = (event: GestureResponderEvent) => {
+    event.stopPropagation();
+    if (resolvedDisabled) return;
+    if (selection.mode === 'single') {
+      selection.select(id);
+      return;
+    }
+
+    selection.toggle(id);
+  };
+
+  const handleLongPress = (event: GestureResponderEvent) => {
+    event.stopPropagation();
+    if (resolvedDisabled) return;
+    if (selection.mode === 'single') {
+      selection.select(id);
+      return;
+    }
+
+    selection.toggle(id);
+  };
+
+  return (
+    <ButtonBase
+      accessibilityRole="button"
+      accessibilityState={{ disabled: resolvedDisabled, selected }}
+      disabled={resolvedDisabled}
+      onLongPress={resolvedTrigger === 'longPress' ? handleLongPress : undefined}
+      onPress={resolvedTrigger === 'press' ? handlePress : undefined}
+    >
+      {content}
+    </ButtonBase>
+  );
+}

package/src/patterns/selection/SelectionProvider.tsx

@@ -0,0 +1,102 @@
+import React from 'react';
+
+import { areIdsEqual, clearIds, normalizeIds, selectId, toggleId } from './resolveSelectionNextIds';
+import type { SelectionMode, SelectionProviderProps, UseSelectionResult } from './types';
+
+const MISSING_CONTEXT_MESSAGE =
+  'ZORA selection context is missing. Wrap this tree in <SelectionProvider>.';
+
+type SelectionContextValue = UseSelectionResult;
+
+const SelectionContext = React.createContext<SelectionContextValue | null>(null);
+
+function resolveMode(mode: SelectionMode | undefined): SelectionMode {
+  return mode ?? 'single';
+}
+
+function resolveDisabled(disabled: boolean | undefined): boolean {
+  return disabled ?? false;
+}
+
+export function useSelection(): UseSelectionResult {
+  const value = React.useContext(SelectionContext);
+  if (!value) {
+    throw new Error(MISSING_CONTEXT_MESSAGE);
+  }
+
+  return value;
+}
+
+export function SelectionProvider({
+  children,
+  selectedIds,
+  defaultSelectedIds,
+  mode,
+  disabled,
+  onSelectionChange,
+}: SelectionProviderProps) {
+  const resolvedMode = resolveMode(mode);
+  const resolvedDisabled = resolveDisabled(disabled);
+  const isControlled = selectedIds !== undefined;
+
+  const [uncontrolledIds, setUncontrolledIds] = React.useState<readonly string[]>(
+    defaultSelectedIds ?? [],
+  );
+
+  const rawIds = isControlled ? selectedIds : uncontrolledIds;
+  const currentNormalizedIds = normalizeIds(rawIds, resolvedMode);
+
+  const selectedIdSet = React.useMemo(() => new Set(currentNormalizedIds), [currentNormalizedIds]);
+
+  const commitSelectionChange = React.useCallback(
+    (nextNormalizedIds: readonly string[]) => {
+      if (resolvedDisabled) return;
+      if (areIdsEqual(nextNormalizedIds, currentNormalizedIds)) return;
+
+      onSelectionChange?.(nextNormalizedIds);
+
+      if (!isControlled) {
+        setUncontrolledIds(nextNormalizedIds);
+      }
+    },
+    [currentNormalizedIds, isControlled, onSelectionChange, resolvedDisabled],
+  );
+
+  const clear = React.useCallback(() => {
+    commitSelectionChange(normalizeIds(clearIds(), resolvedMode));
+  }, [commitSelectionChange, resolvedMode]);
+
+  const select = React.useCallback(
+    (id: string) => {
+      const nextIds = selectId({ mode: resolvedMode, ids: currentNormalizedIds, id });
+      const nextNormalizedIds = normalizeIds(nextIds, resolvedMode);
+      commitSelectionChange(nextNormalizedIds);
+    },
+    [commitSelectionChange, currentNormalizedIds, resolvedMode],
+  );
+
+  const toggle = React.useCallback(
+    (id: string) => {
+      const nextIds = toggleId({ mode: resolvedMode, ids: currentNormalizedIds, id });
+      const nextNormalizedIds = normalizeIds(nextIds, resolvedMode);
+      commitSelectionChange(nextNormalizedIds);
+    },
+    [commitSelectionChange, currentNormalizedIds, resolvedMode],
+  );
+
+  const value = React.useMemo<UseSelectionResult>(() => {
+    return {
+      mode: resolvedMode,
+      disabled: resolvedDisabled,
+      selectedIds: currentNormalizedIds,
+      selectedCount: currentNormalizedIds.length,
+      hasSelection: currentNormalizedIds.length > 0,
+      isSelected: (id: string) => selectedIdSet.has(id),
+      select,
+      toggle,
+      clear,
+    };
+  }, [clear, currentNormalizedIds, resolvedDisabled, resolvedMode, select, selectedIdSet, toggle]);
+
+  return <SelectionContext.Provider value={value}>{children}</SelectionContext.Provider>;
+}

package/src/patterns/selection/index.ts

@@ -0,0 +1,10 @@
+export { SelectableItem } from './SelectableItem';
+export { SelectionProvider, useSelection } from './SelectionProvider';
+export type {
+  SelectableItemProps,
+  SelectableItemState,
+  SelectionMode,
+  SelectionProviderProps,
+  SelectionTrigger,
+  UseSelectionResult,
+} from './types';

package/src/patterns/selection/resolveSelectionNextIds.test.ts

@@ -0,0 +1,61 @@
+import { describe, expect, test } from 'bun:test';
+
+import { areIdsEqual, clearIds, normalizeIds, selectId, toggleId } from './resolveSelectionNextIds';
+import type { SelectionMode } from './types';
+
+describe('resolveSelectionNextIds', () => {
+  test('normalizeIds removes duplicates, preserves order', () => {
+    expect(normalizeIds(['a', 'b', 'a', 'c'], 'multi')).toEqual(['a', 'b', 'c']);
+  });
+
+  test('normalizeIds keeps only first id in single mode', () => {
+    expect(normalizeIds(['a', 'b', 'c'], 'single')).toEqual(['a']);
+  });
+
+  test('normalizeIds treats undefined as empty', () => {
+    expect(normalizeIds(undefined, 'multi')).toEqual([]);
+  });
+
+  test('areIdsEqual compares order', () => {
+    expect(areIdsEqual(['a'], ['a'])).toBeTrue();
+    expect(areIdsEqual(['a'], ['b'])).toBeFalse();
+    expect(areIdsEqual(['a', 'b'], ['a', 'b'])).toBeTrue();
+    expect(areIdsEqual(['a', 'b'], ['b', 'a'])).toBeFalse();
+  });
+
+  test('clearIds returns empty selection', () => {
+    expect(clearIds()).toEqual([]);
+  });
+
+  test('selectId replaces selection in single mode', () => {
+    expect(selectId({ mode: 'single', ids: ['a'], id: 'b' })).toEqual(['b']);
+  });
+
+  test('selectId adds id in multi mode when missing', () => {
+    expect(selectId({ mode: 'multi', ids: ['a'], id: 'b' })).toEqual(['a', 'b']);
+  });
+
+  test('selectId is no-op in multi mode when already selected', () => {
+    const ids = ['a', 'b'];
+    expect(selectId({ mode: 'multi', ids, id: 'b' })).toBe(ids);
+  });
+
+  test('toggleId clears id when already selected (single mode)', () => {
+    expect(toggleId({ mode: 'single', ids: ['a'], id: 'a' })).toEqual([]);
+  });
+
+  test('toggleId selects id when not selected (single mode)', () => {
+    expect(toggleId({ mode: 'single', ids: [], id: 'a' })).toEqual(['a']);
+  });
+
+  test('toggleId toggles membership (multi mode)', () => {
+    expect(toggleId({ mode: 'multi', ids: ['a'], id: 'b' })).toEqual(['a', 'b']);
+    expect(toggleId({ mode: 'multi', ids: ['a', 'b'], id: 'b' })).toEqual(['a']);
+  });
+
+  test('mode-change normalization example', () => {
+    const internalIds = ['a', 'b'];
+    const mode: SelectionMode = 'single';
+    expect(normalizeIds(internalIds, mode)).toEqual(['a']);
+  });
+});

package/src/patterns/selection/resolveSelectionNextIds.ts

@@ -0,0 +1,71 @@
+import type { SelectionMode } from './types';
+
+export function normalizeIds(
+  ids: readonly string[] | undefined,
+  mode: SelectionMode,
+): readonly string[] {
+  const uniqueIds: string[] = [];
+  const seen = new Set<string>();
+
+  for (const id of ids ?? []) {
+    if (seen.has(id)) continue;
+    seen.add(id);
+    uniqueIds.push(id);
+    if (mode === 'single') break;
+  }
+
+  return uniqueIds;
+}
+
+export function areIdsEqual(a: readonly string[], b: readonly string[]): boolean {
+  if (a.length !== b.length) return false;
+  for (let index = 0; index < a.length; index += 1) {
+    if (a[index] !== b[index]) return false;
+  }
+
+  return true;
+}
+
+export function clearIds(): readonly string[] {
+  return [];
+}
+
+export function selectId({
+  mode,
+  ids,
+  id,
+}: {
+  mode: SelectionMode;
+  ids: readonly string[];
+  id: string;
+}): readonly string[] {
+  if (mode === 'single') {
+    return [id];
+  }
+
+  if (ids.includes(id)) {
+    return ids;
+  }
+
+  return [...ids, id];
+}
+
+export function toggleId({
+  mode,
+  ids,
+  id,
+}: {
+  mode: SelectionMode;
+  ids: readonly string[];
+  id: string;
+}): readonly string[] {
+  if (ids.includes(id)) {
+    return ids.filter((existingId) => existingId !== id);
+  }
+
+  if (mode === 'single') {
+    return [id];
+  }
+
+  return [...ids, id];
+}

package/src/patterns/selection/types.ts

@@ -0,0 +1,43 @@
+import type React from 'react';
+
+export type SelectionMode = 'single' | 'multi';
+
+export type SelectionTrigger = 'press' | 'longPress' | 'manual';
+
+export interface SelectionProviderProps {
+  children: React.ReactNode;
+  selectedIds?: readonly string[];
+  defaultSelectedIds?: readonly string[];
+  mode?: SelectionMode;
+  disabled?: boolean;
+  onSelectionChange?: (ids: readonly string[]) => void;
+}
+
+export interface UseSelectionResult {
+  mode: SelectionMode;
+  disabled: boolean;
+  selectedIds: readonly string[];
+  selectedCount: number;
+  hasSelection: boolean;
+  isSelected: (id: string) => boolean;
+  select: (id: string) => void;
+  toggle: (id: string) => void;
+  clear: () => void;
+}
+
+export interface SelectableItemState {
+  id: string;
+  selected: boolean;
+  disabled: boolean;
+  mode: SelectionMode;
+  select: () => void;
+  toggle: () => void;
+  clear: () => void;
+}
+
+export interface SelectableItemProps {
+  id: string;
+  trigger?: SelectionTrigger;
+  disabled?: boolean;
+  children: React.ReactNode | ((state: SelectableItemState) => React.ReactNode);
+}

package/src/showcaseCoverage.test.ts

@@ -86,6 +86,9 @@ const REQUIRED_SHOWCASE_COVERAGE = {
     'DisclosureSection',
     'EmptyState',
     'FilterBar',
+    'SelectableItem',
+    'SelectionProvider',
+    'useSelection',
     'List',
     'ListRow',
     'ListSection',