{"version":3,"file":"index.mjs","names":[],"sources":["../../src/ListContext.ts","../../src/List.tsx","../../src/ListItemContext.ts","../../src/ListItem.tsx"],"sourcesContent":["//\n// Copyright 2023 DXOS.org\n//\n\nimport { ark } from '@ark-ui/react/factory';\nimport { type ComponentPropsWithRef } from 'react';\n\nimport { createContext } from '@dxos/react-hooks';\n\n// Kept out of `List.tsx`: react-refresh only fast-refreshes a module whose exports are all\n// components, so a context and its hook exported beside them force a full page reload on every edit.\n\nexport const LIST_NAME = 'List';\n\nexport type ListVariant = 'ordered' | 'unordered';\n\nexport type ListItemSizes = 'one' | 'many';\n\nexport type ListProps = ComponentPropsWithRef<typeof ark.ol> & {\n  /**\n   * If true, render as `role=\"listbox\"` and let `ListItem` children become\n   * `role=\"option\"` + `aria-selected`. If false (default) the list is a\n   * plain `<ol>` / `<ul>` with no selection semantics — pick this for\n   * static lists.\n   */\n  selectable?: boolean;\n  /**\n   * If true, the listbox advertises multi-select via\n   * `aria-multiselectable=\"true\"`. Defaults to false (single-select).\n   * Has no effect unless `selectable` is also true.\n   */\n  multiSelectable?: boolean;\n  variant?: ListVariant;\n  itemSizes?: ListItemSizes;\n};\n\nexport type ListContextValue = {\n  selectable: Exclude<ListProps['selectable'], undefined>;\n  variant: Exclude<ListProps['variant'], undefined>;\n  itemSizes?: ListItemSizes;\n};\n\nexport const [ListProvider, useListContext] = createContext<ListContextValue>(LIST_NAME);\n","//\n// Copyright 2023 DXOS.org\n//\n\n// Elemental list / listbox primitive.\n//\n// This is the ARIA-only foundation of the DXOS list stack. It renders a\n// semantically-correct `<ol>` / `<ul>` (or, when `selectable={true}`, a\n// `role=\"listbox\"` element with `role=\"option\"` children carrying\n// `aria-selected`). It applies no styling, no keyboard navigation, and\n// no `dx-*` utility classes — those are layered above in\n// `@dxos/react-ui-list`.\n//\n// Layering:\n//   - `@dxos/react-list`      — this package; ARIA + structure only.\n//   - `@dxos/react-ui-list`   — adds `dx-*` styling, keyboard nav, and\n//                               opinionated containers (Listbox, OrderedList,\n//                               Tree, Accordion, Combobox, Picker) plus the\n//                               reusable navigation/selection/disclosure aspects.\n//   - `@dxos/react-ui-mosaic` — virtualized / draggable / card-board\n//                               layouts; composes the above where useful.\n//\n// Most app code should reach for `@dxos/react-ui-list`. Use this primitive\n// directly only when building a *new* selectable surface that needs full\n// control over styling and keyboard handling (e.g. a custom Combobox).\n//\n// See:\n//   - `packages/ui/ui-theme/src/css/components/state.md` for the\n//     `aria-selected` ↔ `dx-selected` pairing rules.\n//   - `packages/ui/react-ui-list/AUDIT.md` for why this layering exists.\n//   - https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/listbox_role\n\nimport { ark } from '@ark-ui/react/factory';\nimport React, { forwardRef } from 'react';\n\nimport { LIST_NAME, type ListProps, ListProvider } from './ListContext.ts';\n\nconst List = forwardRef<HTMLOListElement, ListProps>((props: ListProps, forwardedRef) => {\n  const { variant = 'ordered', selectable = false, multiSelectable = false, itemSizes, children, ...rootProps } = props;\n  const ListRoot = variant === 'ordered' ? ark.ol : ark.ul;\n  return (\n    <ListRoot\n      // `aria-multiselectable` is only meaningful on `role=\"listbox\"`,\n      // and even there is omitted in the single-select default to keep\n      // assistive tech announcements concise.\n      {...(selectable && {\n        role: 'listbox',\n        ...(multiSelectable && { 'aria-multiselectable': true as const }),\n      })}\n      {...rootProps}\n      ref={forwardedRef}\n    >\n      <ListProvider\n        {...{\n          variant,\n          selectable,\n          itemSizes,\n        }}\n      >\n        {children}\n      </ListProvider>\n    </ListRoot>\n  );\n});\n\nList.displayName = LIST_NAME;\n\nexport { List };\n","//\n// Copyright 2023 DXOS.org\n//\n\nimport {\n  type ComponentPropsWithoutRef,\n  type ComponentRef,\n  type Dispatch,\n  type RefAttributes,\n  type SetStateAction,\n} from 'react';\n\nimport { createContext } from '@dxos/react-hooks';\n\n// Kept out of `ListItem.tsx`: react-refresh only fast-refreshes a module whose exports are all\n// components, so a context and its hook exported beside them force a full page reload on every edit.\n\nexport const LIST_ITEM_NAME = 'ListItem';\n\nexport type CheckedState = boolean | 'indeterminate';\n\nexport interface ListItemData {\n  id: string;\n  labelId?: string;\n  selected?: CheckedState;\n  open?: boolean;\n}\n\nexport type ListItemProps = Omit<ListItemData, 'id'> & { collapsible?: boolean } & RefAttributes<HTMLLIElement> &\n  ComponentPropsWithoutRef<'li'> & {\n    defaultOpen?: boolean;\n    onOpenChange?: (nextOpen: boolean) => void;\n  } & {\n    onSelectedChange?(checked: CheckedState): void;\n    defaultSelected?: CheckedState;\n  };\n\nexport type ListItemElement = ComponentRef<'li'>;\n\nexport type ListItemContextValue = {\n  headingId: string;\n  open: boolean;\n  selected: CheckedState | undefined;\n  setSelected: Dispatch<SetStateAction<CheckedState | undefined>>;\n};\n\nexport const [ListItemProvider, useListItemContext] = createContext<ListItemContextValue>(LIST_ITEM_NAME);\n\nexport type ListItemHeadingProps = Omit<ComponentPropsWithoutRef<'p'>, 'id'> &\n  RefAttributes<HTMLParagraphElement> & {\n    asChild?: boolean;\n  };\n","//\n// Copyright 2023 DXOS.org\n//\n\nimport { Collapsible } from '@ark-ui/react/collapsible';\nimport { ark } from '@ark-ui/react/factory';\nimport React, { type ComponentProps, forwardRef } from 'react';\n\nimport { useControllableState, useId } from '@dxos/react-hooks';\n\nimport { LIST_NAME, useListContext } from './ListContext.ts';\nimport {\n  LIST_ITEM_NAME,\n  type ListItemElement,\n  type ListItemHeadingProps,\n  type ListItemProps,\n  ListItemProvider,\n  useListItemContext,\n} from './ListItemContext.ts';\n\nconst ListItemHeading = forwardRef<HTMLDivElement, ListItemHeadingProps>(\n  ({ children, asChild, ...props }, forwardedRef) => {\n    const { headingId } = useListItemContext(LIST_ITEM_NAME);\n    return (\n      <ark.div asChild={asChild} {...props} id={headingId} ref={forwardedRef}>\n        {children}\n      </ark.div>\n    );\n  },\n);\n\ntype ListItemOpenTriggerProps = ComponentProps<typeof Collapsible.Trigger>;\n\nconst ListItemOpenTrigger = Collapsible.Trigger;\n\ntype ListItemCollapsibleContentProps = ComponentProps<typeof Collapsible.Content>;\n\nconst ListItemCollapsibleContent = Collapsible.Content;\n\nconst ListItem = forwardRef<ListItemElement, ListItemProps>((props: ListItemProps, forwardedRef) => {\n  const id = useId('listItem', props.id);\n\n  const {\n    children,\n    selected: propsSelected,\n    defaultSelected,\n    onSelectedChange,\n    open: propsOpen,\n    defaultOpen,\n    onOpenChange,\n    collapsible,\n    labelId,\n    ...listItemProps\n  } = props;\n  const { selectable } = useListContext(LIST_NAME);\n\n  const [selected = false, setSelected] = useControllableState({\n    prop: propsSelected,\n    defaultProp: defaultSelected,\n    onChange: onSelectedChange,\n  });\n\n  const [open = false, setOpen] = useControllableState({\n    prop: propsOpen,\n    defaultProp: defaultOpen,\n    onChange: onOpenChange,\n  });\n\n  const headingId = useId('listItem__heading', labelId);\n\n  const listItem = (\n    <ark.li\n      {...listItemProps}\n      id={id}\n      ref={forwardedRef}\n      aria-labelledby={headingId}\n      {...(selectable && { 'role': 'option', 'aria-selected': !!selected })}\n      {...(open && { 'aria-expanded': true })}\n    >\n      {children}\n    </ark.li>\n  );\n\n  return (\n    <ListItemProvider headingId={headingId} open={open} selected={selected} setSelected={setSelected}>\n      {collapsible ? (\n        <Collapsible.Root asChild open={open} onOpenChange={({ open }) => setOpen(open)}>\n          {listItem}\n        </Collapsible.Root>\n      ) : (\n        listItem\n      )}\n    </ListItemProvider>\n  );\n});\n\nListItem.displayName = LIST_ITEM_NAME;\n\nexport { ListItem, ListItemCollapsibleContent, ListItemHeading, ListItemOpenTrigger };\n\nexport type { ListItemCollapsibleContentProps, ListItemOpenTriggerProps };\n"],"mappings":";;;;;;AAYA,IAAa,YAAY;AA8BzB,IAAa,CAAC,cAAc,kBAAkB,cAAgC,SAAS;;;ACLvF,IAAM,OAAO,YAAyC,OAAkB,iBAAiB;CACvF,MAAM,EAAE,UAAU,WAAW,aAAa,OAAO,kBAAkB,OAAO,WAAW,UAAU,GAAG,cAAc;CAChH,MAAM,WAAW,YAAY,YAAY,IAAI,KAAK,IAAI;CACtD,OACE,oBAAC,UAAD;EAIE,GAAK,cAAc;GACjB,MAAM;GACN,GAAI,mBAAmB,EAAE,wBAAwB,KAAc;EACjE;EACA,GAAI;EACJ,KAAK;EAEL,UAAA,oBAAC,cAAD;GAEI;GACA;GACA;GAGD;EACW,CAAA;CACN,CAAA;AAEd,CAAC;AAED,KAAK,cAAc;;;AChDnB,IAAa,iBAAiB;AA6B9B,IAAa,CAAC,kBAAkB,sBAAsB,cAAoC,cAAc;;;AC1BxG,IAAM,kBAAkB,YACrB,EAAE,UAAU,SAAS,GAAG,SAAS,iBAAiB;CACjD,MAAM,EAAE,cAAc,mBAAmB,cAAc;CACvD,OACE,oBAAC,IAAI,KAAL;EAAkB;EAAS,GAAI;EAAO,IAAI;EAAW,KAAK;EACvD;CACM,CAAA;AAEb,CACF;AAIA,IAAM,sBAAsB,YAAY;AAIxC,IAAM,6BAA6B,YAAY;AAE/C,IAAM,WAAW,YAA4C,OAAsB,iBAAiB;CAClG,MAAM,KAAK,MAAM,YAAY,MAAM,EAAE;CAErC,MAAM,EACJ,UACA,UAAU,eACV,iBACA,kBACA,MAAM,WACN,aACA,cACA,aACA,SACA,GAAG,kBACD;CACJ,MAAM,EAAE,eAAe,eAAe,SAAS;CAE/C,MAAM,CAAC,WAAW,OAAO,eAAe,qBAAqB;EAC3D,MAAM;EACN,aAAa;EACb,UAAU;CACZ,CAAC;CAED,MAAM,CAAC,OAAO,OAAO,WAAW,qBAAqB;EACnD,MAAM;EACN,aAAa;EACb,UAAU;CACZ,CAAC;CAED,MAAM,YAAY,MAAM,qBAAqB,OAAO;CAEpD,MAAM,WACJ,oBAAC,IAAI,IAAL;EACE,GAAI;EACA;EACJ,KAAK;EACL,mBAAiB;EACjB,GAAK,cAAc;GAAE,QAAQ;GAAU,iBAAiB,CAAC,CAAC;EAAS;EACnE,GAAK,QAAQ,EAAE,iBAAiB,KAAK;EAEpC;CACK,CAAA;CAGV,OACE,oBAAC,kBAAD;EAA6B;EAAiB;EAAgB;EAAuB;EAClF,UAAA,cACC,oBAAC,YAAY,MAAb;GAAkB,SAAA;GAAc;GAAM,eAAe,EAAE,WAAW,QAAQ,IAAI;GAC3E,UAAA;EACe,CAAA,IAElB;CAEc,CAAA;AAEtB,CAAC;AAED,SAAS,cAAc"}