@dxos/react-ui-attention 0.8.2-main.fbd8ed0 → 0.8.2-staging.4d6ad0f

package/dist/lib/node-esm/chunk-GBD6BNIC.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/attention.ts", "../../../src/components/AttentionGlyph.tsx", "../../../src/components/AttentionProvider.tsx", "../../../src/selection.ts", "../../../src/components/SelectionProvider.tsx"],
+  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport { untracked } from '@preact/signals-core';\nimport { Schema } from 'effect';\n\nimport { live, type Live } from '@dxos/live-object';\nimport { ComplexMap } from '@dxos/util';\n\n// NOTE: Chosen from RFC 1738’s `safe` characters: http://www.faqs.org/rfcs/rfc1738.html\nexport const ATTENDABLE_PATH_SEPARATOR = '~';\n\nexport const AttentionSchema = Schema.mutable(\n  Schema.Struct({\n    hasAttention: Schema.Boolean,\n    isAncestor: Schema.Boolean,\n    isRelated: Schema.Boolean,\n  }),\n);\n\nexport type Attention = Schema.Schema.Type<typeof AttentionSchema>;\n\n// TODO(wittjosiah): Use mosaic path utility?\nconst stringKey = (key: string[]) => key.join(',');\n\n/**\n * Manages attention state for an application.\n */\n// TODO(wittjosiah): Write unit tests.\nexport class AttentionManager {\n  // Each attention path is associated with an attention object.\n  // The lookup is not a reactive object to ensure that attention for each path is subscribable independently.\n  private readonly _map = new ComplexMap<string[], Live<Attention>>(stringKey);\n  private readonly _state = live<{ current: string[] }>({ current: [] });\n\n  constructor(initial: string[] = []) {\n    if (initial.length > 0) {\n      this.update(initial);\n    }\n  }\n\n  /**\n   * Currently attended element.\n   *\n   * @reactive\n   */\n  get current(): Live<readonly string[]> {\n    return this._state.current;\n  }\n\n  /**\n   * All attention paths.\n   */\n  keys(): string[][] {\n    return Array.from(this._map.keys());\n  }\n\n  /**\n   * Get the attention state for a given path.\n   */\n  get(key: string[]): Live<Attention> {\n    const object = this._map.get(key);\n    if (object) {\n      return object;\n    }\n\n    const newObject = live(AttentionSchema, { hasAttention: false, isAncestor: false, isRelated: false });\n    this._map.set(key, newObject);\n    return newObject;\n  }\n\n  /**\n   * Update the currently attended element.\n   *\n   * @internal\n   */\n  update(nextKey: string[]): void {\n    const currentKey = untracked(() => this.current);\n    const currentRelatedTo = currentKey[0];\n    const nextRelatedTo = nextKey[0];\n\n    // Ensure related attention object is initialized.\n    this.get([nextRelatedTo]);\n\n    const currentRelatedKeys = this.keys().filter((key) => key[0] === currentRelatedTo);\n    const nextRelatedKeys = this.keys().filter(\n      (key) => key[0] === nextRelatedTo && stringKey(key) !== stringKey(nextKey),\n    );\n    const prevRelatedKeys = currentRelatedKeys.filter(\n      (curr) => !nextRelatedKeys.find((next) => stringKey(curr) === stringKey(next)),\n    );\n\n    const currentAncestorKeys = currentKey.slice(1).map((_, i) => currentKey.slice(i + 1, currentKey.length));\n    const nextAncestorKeys = nextKey.slice(1).map((_, i) => nextKey.slice(i + 1, nextKey.length));\n    const prevAncestorKeys = currentAncestorKeys.filter(\n      (curr) => !nextAncestorKeys.find((next) => stringKey(curr) === stringKey(next)),\n    );\n\n    this._state.current = nextKey;\n    prevRelatedKeys.forEach((key) => this._set(key, {}));\n    prevAncestorKeys.forEach((key) => this._set(key, {}));\n    nextRelatedKeys.forEach((key) => this._set(key, { isRelated: true }));\n    nextAncestorKeys.forEach((key) => this._set(key, { isAncestor: true }));\n    this._set(nextKey, { hasAttention: true });\n  }\n\n  private _set(key: string[], attention: Partial<Attention>): void {\n    const object = this.get(key);\n    object.hasAttention = attention.hasAttention ?? false;\n    object.isAncestor = attention.isAncestor ?? false;\n    object.isRelated = attention.isRelated ?? false;\n  }\n}\n\n/**\n * Accumulates all attendable id’s between the element provided and the root, inclusive.\n */\nexport const getAttendables = (selector: string, cursor: Element, acc: string[] = []): string[] => {\n  // Find the closest element with `data-attendable-id`, if any; start from cursor and move up the DOM tree.\n  const closestAttendable = cursor.closest(selector);\n  if (closestAttendable) {\n    const attendableId = closestAttendable.getAttribute('data-attendable-id');\n    if (!attendableId) {\n      // This has an id of an aria-controls elsewhere on the page, move cursor to that trigger.\n      const trigger = document.querySelector(`[aria-controls=\"${closestAttendable.getAttribute('id')}\"]`);\n      if (!trigger) {\n        return acc;\n      } else {\n        return getAttendables(selector, trigger, acc);\n      }\n    } else {\n      acc.push(...attendableId.split(ATTENDABLE_PATH_SEPARATOR));\n      // TODO: Attempt tail recursion.\n      return !closestAttendable.parentElement ? acc : getAttendables(selector, closestAttendable.parentElement, acc);\n    }\n  }\n\n  return [...new Set(acc)];\n};\n\nexport type AttendableId = { attendableId?: string };\n\nexport type Related = { related?: boolean };\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { type Primitive } from '@radix-ui/react-primitive';\nimport React, { type ComponentPropsWithRef, type CSSProperties, forwardRef, useMemo } from 'react';\n\nimport { Icon, type ThemedClassName } from '@dxos/react-ui';\nimport { mx } from '@dxos/react-ui-theme';\n\nconst attentionGlyphStyles =\n  'inline-block rounded-sm is-3 bs-3 bg-transparent text-accentText transition-colors [[data-contains-attended=true]_&]:bg-attentionRelated [[data-attention=true]_&]:bg-accentSurface [[data-attention=true]_&]:text-accentSurfaceText [[aria-current][data-attention=true]_&]:bg-accentSurface [[aria-current][data-attention=true]_&]:text-accentSurfaceText';\n\nconst presenceIconStyles =\n  'is-3 bs-3 group-[[aria-current]_&:hover]/attentionGlyphButton:hidden group-[[aria-current]_&:focus]/attentionGlyphButton:hidden group-[[data-attention=true]_&:hover]/attentionGlyphButton:hidden group-[[data-attention=true]_&:focus]/attentionGlyphButton:hidden group-[[aria-current][data-attention=true]_&:hover]/attentionGlyphButton:hidden group-[[aria-current][data-attention=true]_&:focus]/attentionGlyphButton:hidden';\n\nconst PresenceOne = () => {\n  return (\n    <svg\n      width='12'\n      height='12'\n      viewBox='0 0 12 12'\n      className={presenceIconStyles}\n      fill='none'\n      xmlns='http://www.w3.org/2000/svg'\n    >\n      <circle cx='6' cy='6' r='2.5' fill='currentColor' />\n    </svg>\n  );\n};\n\nconst PresenceMany = () => {\n  return (\n    <svg\n      width='12'\n      height='12'\n      viewBox='0 0 12 12'\n      className={presenceIconStyles}\n      fill='none'\n      xmlns='http://www.w3.org/2000/svg'\n    >\n      <path\n        d='M6.75 8.27311C7.38815 7.72296 7.79212 6.90866 7.79212 6C7.79212 5.09134 7.38815 4.27704 6.75 3.72689C7.06722 3.58122 7.42019 3.5 7.79212 3.5C9.17283 3.5 10.2921 4.61929 10.2921 6C10.2921 7.38071 9.17283 8.5 7.79212 8.5C7.42019 8.5 7.06723 8.41878 6.75 8.27311Z'\n        fill='currentColor'\n      />\n      <circle cx='4.25' cy='6' r='2.5' fill='currentColor' />\n    </svg>\n  );\n};\n\nexport const Syncing = () => {\n  const animationProps = useMemo<CSSProperties>(\n    () => ({\n      // Synchronize animations.\n      animationDelay: `-${Date.now() % 2_000}ms`,\n    }),\n    [],\n  );\n\n  return (\n    <div role='status' className='flex items-center'>\n      <Icon\n        icon='ph--circle-notch--bold'\n        size={3}\n        style={animationProps}\n        classNames='text-subdued animate-[spin_2s_linear_infinite]'\n      />\n    </div>\n  );\n};\n\nexport type AttentionGlyphProps = {\n  attended?: boolean;\n  containsAttended?: boolean;\n  syncing?: boolean;\n  presence?: 'none' | 'one' | 'many';\n} & ThemedClassName<Omit<ComponentPropsWithRef<typeof Primitive.span>, 'children'>>;\n\nexport const AttentionGlyph = forwardRef<HTMLSpanElement, AttentionGlyphProps>(\n  ({ presence, attended, syncing, containsAttended, classNames, ...props }, forwardedRef) => {\n    const icon = syncing ? (\n      <Syncing />\n    ) : presence === 'many' ? (\n      <PresenceMany />\n    ) : presence === 'one' ? (\n      <PresenceOne />\n    ) : null;\n\n    return (\n      <div role='none' className='flex' data-attention={attended} data-contains-attended={containsAttended}>\n        <span role='none' {...props} className={mx(attentionGlyphStyles, classNames)} ref={forwardedRef}>\n          {icon}\n        </span>\n      </div>\n    );\n  },\n);\n", "//\n// Copyright 2024 DXOS.org\n//\n\n// NOTE(thure): The following unused imports quell TS2742 (“likely not portable”).\n\n// eslint-disable-next-line unused-imports/no-unused-imports\nimport { createContext, type Scope, type CreateScope } from '@radix-ui/react-context';\nimport { Primitive } from '@radix-ui/react-primitive';\nimport { Slot } from '@radix-ui/react-slot';\nimport React, { useMemo, type FocusEvent, type PropsWithChildren, type ComponentPropsWithRef, forwardRef } from 'react';\n\nimport { useDefaultValue, type ThemedClassName } from '@dxos/react-ui';\nimport { mx } from '@dxos/react-ui-theme';\n\nimport { ATTENDABLE_PATH_SEPARATOR, type Attention, AttentionManager, getAttendables } from '../attention';\n\nconst ATTENTION_NAME = 'Attention';\nconst ATTENABLE_ATTRIBUTE = 'data-attendable-id';\nconst ATTENTION_SOURCE_ATTRIBUTE = 'data-is-attention-source';\n\ntype AttentionContextValue = {\n  attention: AttentionManager;\n  path: string[];\n};\n\nconst [AttentionContextProvider, useAttentionContext] = createContext<AttentionContextValue>(ATTENTION_NAME, {\n  attention: new AttentionManager(),\n  path: [],\n});\n\nconst UNKNOWN_ATTENDABLE = { hasAttention: false, isAncestor: false, isRelated: false };\n\nconst useAttention = (attendableId?: string): Attention => {\n  const { attention, path } = useAttentionContext(ATTENTION_NAME);\n  if (!attendableId) {\n    return UNKNOWN_ATTENDABLE;\n  }\n\n  const current = [...attendableId.split(ATTENDABLE_PATH_SEPARATOR), ...path];\n  return attention.get(current);\n};\n\nconst useAttended = () => {\n  const { attention } = useAttentionContext(ATTENTION_NAME);\n  return attention.current;\n};\n\n/**\n * Computes HTML element attributes to apply so the attention system can detect changes\n * @param attendableId\n */\nconst useAttendableAttributes = (attendableId?: string) => {\n  const { hasAttention } = useAttention(attendableId);\n  return useMemo(() => {\n    const attributes: Record<string, string | undefined> = { [ATTENABLE_ATTRIBUTE]: attendableId };\n    if (hasAttention) {\n      attributes[ATTENTION_SOURCE_ATTRIBUTE] = 'true';\n    }\n\n    return attributes;\n  }, [attendableId, hasAttention]);\n};\n\nconst useAttentionPath = () => {\n  const { path } = useAttentionContext(ATTENTION_NAME);\n  return path;\n};\n\nconst RootAttentionProvider = ({\n  children,\n  attention: propsAttention,\n  onChange,\n}: PropsWithChildren<\n  Partial<{\n    attention: AttentionManager;\n    onChange: (nextAttended: string[]) => void;\n  }>\n>) => {\n  const attention = useDefaultValue(propsAttention, () => new AttentionManager());\n  const handleFocus = (event: FocusEvent) => {\n    const selector = [\n      '[data-attendable-id]',\n      ...Array.from(document.querySelectorAll('[aria-controls]')).map(\n        (el) => `[id=\"${el.getAttribute('aria-controls')}\"]`,\n      ),\n    ].join(',');\n    const prev = attention.current;\n    const next = getAttendables(selector, event.target);\n    // TODO(wittjosiah): Not allowing empty state means that the attended item is not strictly guaranteed to be in the DOM.\n    //   Currently this depends on the deck in order to ensure that when the attended item is removed something else is attended.\n    // Only update state if the result is different and not empty.\n    if (next.length > 0 && (prev.length !== next.length || !!prev.find((id, index) => next[index] !== id))) {\n      attention.update(next);\n      onChange?.(next);\n    }\n  };\n\n  // NOTE(thure): Use the following to debug the macOS package issue #8540\n\n  // const [startEl, setStartEl] = useState<HTMLElement | null>(null);\n  // const [endEl, setEndEl] = useState<HTMLElement | null>(null);\n  //\n  // const handleEventDebug = useCallback((event: any) => {\n  //   console.log(`[${event.type}]`, event.target, event.currentTarget, [event.clientX, event.clientY]);\n  // }, []);\n  //\n  // const handleStartDebug = useCallback(\n  //   (event: any) => {\n  //     setStartEl(event.target);\n  //     handleEventDebug(event);\n  //   },\n  //   [handleEventDebug],\n  // );\n  //\n  // const handleEndDebug = useCallback(\n  //   (event: any) => {\n  //     setEndEl(event.target);\n  //     handleEventDebug(event);\n  //   },\n  //   [handleEventDebug],\n  // );\n  //\n  // const handleClickDebug = useCallback(\n  //   (event: any) => {\n  //     console.log('[click compare]', startEl, endEl, startEl === endEl);\n  //     handleEventDebug(event);\n  //   },\n  //   [startEl, endEl, handleEventDebug],\n  // );\n\n  return (\n    <AttentionContextProvider attention={attention} path={[]}>\n      <div\n        role='none'\n        className='contents'\n        onFocusCapture={handleFocus}\n        // onClick={handleClickDebug}\n        // onMouseDown={handleStartDebug}\n        // onMouseUp={handleEndDebug}\n      >\n        {children}\n      </div>\n    </AttentionContextProvider>\n  );\n};\n\nconst AttentionProvider = ({ id, children }: PropsWithChildren<{ id: string }>) => {\n  const { attention, path } = useAttentionContext(ATTENTION_NAME);\n  const nextPath = useMemo(() => [id, ...path], [id, path]);\n\n  return (\n    <AttentionContextProvider attention={attention} path={nextPath}>\n      {children}\n    </AttentionContextProvider>\n  );\n};\n\nexport type AttendableContainerProps = ThemedClassName<\n  ComponentPropsWithRef<'div'> & { id: string; asChild?: boolean }\n>;\n\n/**\n * Note that DeckPlugin and StackPlugin both handle attention on their own, and when rendering content in those cases it\n * is not necessary to also render an `AttendableContainer`. This component is primarily for Storybook stories and other\n * testing scenarios, or the rare cases where an attendable entity is rendered outside of either of those plugins.\n */\nconst AttendableContainer = forwardRef<HTMLDivElement, AttendableContainerProps>(\n  ({ id, classNames, children, asChild, ...props }, forwardedRef) => {\n    const attendableAttrs = useAttendableAttributes(id);\n    const Root = asChild ? Slot : Primitive.div;\n    return (\n      <Root\n        role='none'\n        {...attendableAttrs}\n        {...props}\n        className={mx('attention-surface', props.tabIndex === 0 && 'dx-focus-ring-inset-over-all', classNames)}\n        ref={forwardedRef}\n      >\n        {children}\n      </Root>\n    );\n  },\n);\n\nexport {\n  RootAttentionProvider,\n  AttentionProvider,\n  AttendableContainer,\n  useAttentionContext,\n  useAttention,\n  useAttended,\n  useAttendableAttributes,\n  useAttentionPath,\n  ATTENTION_NAME,\n  ATTENABLE_ATTRIBUTE,\n  ATTENTION_SOURCE_ATTRIBUTE,\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { untracked } from '@preact/signals-core';\nimport { Match } from 'effect';\n\nimport { invariant } from '@dxos/invariant';\nimport { live, type Live } from '@dxos/live-object';\n\nexport type SelectionMode = 'single' | 'multi' | 'range' | 'multi-range';\n\nexport type Selection =\n  | { mode: 'single'; id?: string }\n  | { mode: 'multi'; ids: string[] }\n  | { mode: 'range'; from?: string; to?: string }\n  | { mode: 'multi-range'; ranges: { from: string; to: string }[] };\n\nexport const defaultSelection = Match.type<SelectionMode>().pipe(\n  Match.when('single', () => ({ mode: 'single' }) as Selection),\n  Match.when('multi', () => ({ mode: 'multi', ids: [] }) as Selection),\n  Match.when('range', () => ({ mode: 'range' }) as Selection),\n  Match.when('multi-range', () => ({ mode: 'multi-range', ranges: [] }) as Selection),\n  Match.exhaustive,\n);\n\n/**\n * Manages selection state for different contexts.\n * Each context maintains its own selection mode and state.\n */\nexport class SelectionManager {\n  private readonly _state = live<{ selections: Record<string, Selection> }>({ selections: {} });\n\n  constructor(initial: Record<string, Selection> = {}) {\n    if (Object.keys(initial).length > 0) {\n      untracked(() => {\n        this._state.selections = initial;\n      });\n    }\n  }\n\n  getSelection<T extends SelectionMode | undefined>(\n    contextId: string,\n    mode: T = undefined as T,\n  ): T extends undefined ? Live<Selection> | undefined : Live<Selection> {\n    const selection = untracked(() => this._state.selections[contextId]);\n    if (!mode || selection) {\n      return selection;\n    }\n\n    return untracked(() => {\n      this._state.selections[contextId] = defaultSelection(mode);\n      return this._state.selections[contextId];\n    });\n  }\n\n  getSelected<T extends SelectionMode>(\n    contextId: string,\n    mode: T = 'multi' as T,\n  ): T extends 'single'\n    ? string | undefined\n    : T extends 'multi'\n      ? string[]\n      : T extends 'range'\n        ? { from: string; to: string } | undefined\n        : T extends 'multi-range'\n          ? { from: string; to: string }[]\n          : never {\n    const selection = this.getSelection(contextId, mode);\n    invariant(selection?.mode === mode, 'Selection mode mismatch');\n    return Match.type<Selection>().pipe(\n      Match.when({ mode: 'single' }, (s) => s.id),\n      Match.when({ mode: 'multi' }, (s) => s.ids),\n      Match.when({ mode: 'range' }, (s) => (s.from && s.to ? { from: s.from, to: s.to } : undefined)),\n      Match.when({ mode: 'multi-range' }, (s) => s.ranges),\n      Match.exhaustive,\n    )(selection) as any;\n  }\n\n  updateSingle(contextId: string, id: string): void {\n    untracked(() => {\n      const selection = this.getSelection(contextId, 'single');\n      invariant(selection?.mode === 'single', 'Selection mode is not single');\n      selection.id = id;\n    });\n  }\n\n  updateMulti(contextId: string, ids: string[]) {\n    untracked(() => {\n      const selection = this.getSelection(contextId, 'multi');\n      invariant(selection?.mode === 'multi', 'Selection mode is not multi');\n      selection.ids = ids;\n    });\n  }\n\n  updateRange(contextId: string, from: string, to: string) {\n    untracked(() => {\n      const selection = this.getSelection(contextId, 'range');\n      invariant(selection?.mode === 'range', 'Selection mode is not range');\n      selection.from = from;\n      selection.to = to;\n    });\n  }\n\n  updateMultiRange(contextId: string, ranges: { from: string; to: string }[]) {\n    untracked(() => {\n      const selection = this.getSelection(contextId, 'multi-range');\n      invariant(selection?.mode === 'multi-range', 'Selection mode is not multi-range');\n      selection.ranges = ranges;\n    });\n  }\n\n  clearSelection(contextId: string): void {\n    untracked(() => {\n      const selection = this.getSelection(contextId);\n      if (selection) {\n        this._state.selections[contextId] = defaultSelection(selection.mode);\n      }\n    });\n  }\n\n  toggleSelection(contextId: string, id: string): void {\n    untracked(() => {\n      const selection = this.getSelection(contextId, 'multi');\n      invariant(selection?.mode === 'multi', 'Selection mode is not multi');\n\n      if (selection.ids.includes(id)) {\n        const index = selection.ids.indexOf(id);\n        selection.ids.splice(index, 1);\n      } else {\n        selection.ids.push(id);\n      }\n    });\n  }\n}\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { createContext } from '@radix-ui/react-context';\nimport { Match } from 'effect';\nimport React, { useCallback, useMemo, type PropsWithChildren } from 'react';\n\nimport { useDefaultValue } from '@dxos/react-ui';\n\nimport { defaultSelection, SelectionManager, type Selection, type SelectionMode } from '../selection';\n\nconst SELECTION_NAME = 'Selection';\n\ntype SelectionContextValue = {\n  selection: SelectionManager;\n};\n\nconst [SelectionContextProvider, useSelectionContext] = createContext<SelectionContextValue>(SELECTION_NAME, {\n  selection: new SelectionManager(),\n});\n\n/**\n * Manages selection state across the app for multiple contexts.\n */\n// TODO(burdon): When is the selection removed?\nexport const SelectionProvider = ({\n  children,\n  selection: propsSelection,\n}: PropsWithChildren<{ selection?: SelectionManager }>) => {\n  const selection = useDefaultValue(propsSelection, () => new SelectionManager());\n  return <SelectionContextProvider selection={selection}>{children}</SelectionContextProvider>;\n};\n\nexport const useSelected = <T extends SelectionMode>(\n  contextId?: string,\n  mode: T = 'multi' as T,\n): T extends 'single'\n  ? string | undefined\n  : T extends 'multi'\n    ? string[]\n    : T extends 'range'\n      ? { from: string; to: string } | undefined\n      : T extends 'multi-range'\n        ? { from: string; to: string }[]\n        : never => {\n  const { selection } = useSelectionContext(SELECTION_NAME);\n  if (contextId) {\n    return selection.getSelected(contextId, mode);\n  }\n\n  return Match.type<Selection>().pipe(\n    Match.when({ mode: 'single' }, (s) => s.id),\n    Match.when({ mode: 'multi' }, (s) => s.ids),\n    Match.when({ mode: 'range' }, (s) => (s.from && s.to ? { from: s.from, to: s.to } : undefined)),\n    Match.when({ mode: 'multi-range' }, (s) => s.ranges),\n    Match.exhaustive,\n  )(defaultSelection(mode)) as any;\n};\n\n/**\n * Provides functions to manage the selection state for multiple contexts.\n */\nexport const useSelectionActions = (contextIds: string[], mode: SelectionMode = 'multi') => {\n  const stableContextIds = useMemo(() => contextIds, [JSON.stringify(contextIds)]); // TODO(burdon): Avoid stringify.\n  const { selection } = useSelectionContext(SELECTION_NAME);\n\n  const singleSelect = useCallback(\n    (id: string) => {\n      for (const contextId of stableContextIds) {\n        selection.updateSingle(contextId, id);\n      }\n    },\n    [selection, stableContextIds],\n  );\n\n  const multiSelect = useCallback(\n    (ids: string[]) => {\n      for (const contextId of stableContextIds) {\n        selection.updateMulti(contextId, ids);\n      }\n    },\n    [selection, stableContextIds],\n  );\n\n  const rangeSelect = useCallback(\n    (from: string, to: string) => {\n      for (const contextId of stableContextIds) {\n        selection.updateRange(contextId, from, to);\n      }\n    },\n    [selection, stableContextIds],\n  );\n\n  const toggle = useCallback(\n    (id: string) => {\n      for (const contextId of stableContextIds) {\n        selection.toggleSelection(contextId, id);\n      }\n    },\n    [selection, stableContextIds],\n  );\n\n  const clear = useCallback(() => {\n    for (const contextId of stableContextIds) {\n      selection.clearSelection(contextId);\n    }\n  }, [selection, stableContextIds]);\n\n  return { singleSelect, multiSelect, rangeSelect, toggle, clear };\n};\n"],
+  "mappings": "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",
+  "names": ["untracked", "Schema", "live", "ComplexMap", "ATTENDABLE_PATH_SEPARATOR", "AttentionSchema", "Schema", "mutable", "Struct", "hasAttention", "Boolean", "isAncestor", "isRelated", "stringKey", "key", "join", "AttentionManager", "initial", "_map", "ComplexMap", "_state", "live", "current", "length", "update", "keys", "Array", "from", "get", "object", "newObject", "set", "nextKey", "currentKey", "untracked", "currentRelatedTo", "nextRelatedTo", "currentRelatedKeys", "filter", "nextRelatedKeys", "prevRelatedKeys", "curr", "find", "next", "currentAncestorKeys", "slice", "map", "_", "i", "nextAncestorKeys", "prevAncestorKeys", "forEach", "_set", "attention", "getAttendables", "selector", "cursor", "acc", "closestAttendable", "closest", "attendableId", "getAttribute", "trigger", "document", "querySelector", "push", "split", "parentElement", "Set", "React", "forwardRef", "useMemo", "Icon", "mx", "attentionGlyphStyles", "presenceIconStyles", "PresenceOne", "svg", "width", "height", "viewBox", "className", "fill", "xmlns", "circle", "cx", "cy", "r", "PresenceMany", "path", "d", "Syncing", "animationProps", "useMemo", "animationDelay", "Date", "now", "div", "role", "Icon", "icon", "size", "style", "classNames", "AttentionGlyph", "forwardRef", "presence", "attended", "syncing", "containsAttended", "props", "forwardedRef", "data-attention", "data-contains-attended", "span", "mx", "ref", "createContext", "Primitive", "Slot", "React", "useMemo", "forwardRef", "useDefaultValue", "mx", "ATTENTION_NAME", "ATTENABLE_ATTRIBUTE", "ATTENTION_SOURCE_ATTRIBUTE", "AttentionContextProvider", "useAttentionContext", "createContext", "attention", "AttentionManager", "path", "UNKNOWN_ATTENDABLE", "hasAttention", "isAncestor", "isRelated", "useAttention", "attendableId", "current", "split", "ATTENDABLE_PATH_SEPARATOR", "get", "useAttended", "useAttendableAttributes", "useMemo", "attributes", "useAttentionPath", "RootAttentionProvider", "children", "propsAttention", "onChange", "useDefaultValue", "handleFocus", "event", "selector", "Array", "from", "document", "querySelectorAll", "map", "el", "getAttribute", "join", "prev", "next", "getAttendables", "target", "length", "find", "id", "index", "update", "React", "div", "role", "className", "onFocusCapture", "AttentionProvider", "nextPath", "AttendableContainer", "forwardRef", "classNames", "asChild", "props", "forwardedRef", "attendableAttrs", "Root", "Slot", "Primitive", "mx", "tabIndex", "ref", "untracked", "Match", "invariant", "live", "defaultSelection", "type", "pipe", "when", "mode", "ids", "ranges", "exhaustive", "SelectionManager", "initial", "_state", "selections", "Object", "keys", "length", "getSelection", "contextId", "undefined", "selection", "getSelected", "s", "id", "from", "to", "updateSingle", "updateMulti", "updateRange", "updateMultiRange", "clearSelection", "toggleSelection", "includes", "index", "indexOf", "splice", "push", "createContext", "Match", "React", "useCallback", "useMemo", "useDefaultValue", "SELECTION_NAME", "SelectionContextProvider", "useSelectionContext", "createContext", "selection", "SelectionManager", "SelectionProvider", "children", "propsSelection", "useDefaultValue", "React", "useSelected", "contextId", "mode", "getSelected", "Match", "type", "pipe", "when", "s", "id", "ids", "from", "to", "undefined", "ranges", "exhaustive", "defaultSelection", "useSelectionActions", "contextIds", "stableContextIds", "useMemo", "JSON", "stringify", "singleSelect", "useCallback", "updateSingle", "multiSelect", "updateMulti", "rangeSelect", "updateRange", "toggle", "toggleSelection", "clear", "clearSelection"]
+}

package/dist/lib/node-esm/index.mjs

@@ -13,15 +13,16 @@ import {
   SelectionManager,
   SelectionProvider,
   Syncing,
+  defaultSelection,
   getAttendables,
   useAttendableAttributes,
   useAttended,
   useAttention,
   useAttentionContext,
   useAttentionPath,
-  useSelectedItems,
+  useSelected,
   useSelectionActions
-} from "./chunk-ZDSNYE3Y.mjs";
+} from "./chunk-GBD6BNIC.mjs";
 export {
   ATTENABLE_ATTRIBUTE,
   ATTENDABLE_PATH_SEPARATOR,
@@ -36,13 +37,14 @@ export {
   SelectionManager,
   SelectionProvider,
   Syncing,
+  defaultSelection,
   getAttendables,
   useAttendableAttributes,
   useAttended,
   useAttention,
   useAttentionContext,
   useAttentionPath,
-  useSelectedItems,
+  useSelected,
   useSelectionActions
 };
 //# sourceMappingURL=index.mjs.map

package/dist/lib/node-esm/meta.json

@@ -1 +1 @@
-{"inputs":{"packages/ui/react-ui-attention/src/attention.ts":{"bytes":16721,"imports":[{"path":"@preact/signals-core","kind":"import-statement","external":true},{"path":"effect","kind":"import-statement","external":true},{"path":"@dxos/live-object","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"format":"esm"},"packages/ui/react-ui-attention/src/components/AttentionGlyph.tsx":{"bytes":10664,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/react-ui","kind":"import-statement","external":true},{"path":"@dxos/react-ui-theme","kind":"import-statement","external":true}],"format":"esm"},"packages/ui/react-ui-attention/src/components/AttentionProvider.tsx":{"bytes":20377,"imports":[{"path":"@radix-ui/react-context","kind":"import-statement","external":true},{"path":"@radix-ui/react-primitive","kind":"import-statement","external":true},{"path":"@radix-ui/react-slot","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/react-ui","kind":"import-statement","external":true},{"path":"@dxos/react-ui-theme","kind":"import-statement","external":true},{"path":"packages/ui/react-ui-attention/src/attention.ts","kind":"import-statement","original":"../attention"}],"format":"esm"},"packages/ui/react-ui-attention/src/selection.ts":{"bytes":5776,"imports":[{"path":"@preact/signals-core","kind":"import-statement","external":true},{"path":"@dxos/live-object","kind":"import-statement","external":true}],"format":"esm"},"packages/ui/react-ui-attention/src/components/SelectionProvider.tsx":{"bytes":7671,"imports":[{"path":"@radix-ui/react-context","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/react-ui","kind":"import-statement","external":true},{"path":"packages/ui/react-ui-attention/src/selection.ts","kind":"import-statement","original":"../selection"}],"format":"esm"},"packages/ui/react-ui-attention/src/components/index.ts":{"bytes":757,"imports":[{"path":"packages/ui/react-ui-attention/src/components/AttentionGlyph.tsx","kind":"import-statement","original":"./AttentionGlyph"},{"path":"packages/ui/react-ui-attention/src/components/AttentionProvider.tsx","kind":"import-statement","original":"./AttentionProvider"},{"path":"packages/ui/react-ui-attention/src/components/SelectionProvider.tsx","kind":"import-statement","original":"./SelectionProvider"}],"format":"esm"},"packages/ui/react-ui-attention/src/index.ts":{"bytes":690,"imports":[{"path":"packages/ui/react-ui-attention/src/attention.ts","kind":"import-statement","original":"./attention"},{"path":"packages/ui/react-ui-attention/src/components/index.ts","kind":"import-statement","original":"./components"},{"path":"packages/ui/react-ui-attention/src/selection.ts","kind":"import-statement","original":"./selection"}],"format":"esm"},"packages/ui/react-ui-attention/src/testing/decorators/withAttention.ts":{"bytes":1386,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"packages/ui/react-ui-attention/src/components/index.ts","kind":"import-statement","original":"../../components"}],"format":"esm"},"packages/ui/react-ui-attention/src/testing/decorators/index.ts":{"bytes":534,"imports":[{"path":"packages/ui/react-ui-attention/src/testing/decorators/withAttention.ts","kind":"import-statement","original":"./withAttention"}],"format":"esm"},"packages/ui/react-ui-attention/src/testing/index.ts":{"bytes":516,"imports":[{"path":"packages/ui/react-ui-attention/src/testing/decorators/index.ts","kind":"import-statement","original":"./decorators"}],"format":"esm"}},"outputs":{"packages/ui/react-ui-attention/dist/lib/node-esm/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":93},"packages/ui/react-ui-attention/dist/lib/node-esm/index.mjs":{"imports":[{"path":"packages/ui/react-ui-attention/dist/lib/node-esm/chunk-ZDSNYE3Y.mjs","kind":"import-statement"}],"exports":["ATTENABLE_ATTRIBUTE","ATTENDABLE_PATH_SEPARATOR","ATTENTION_NAME","ATTENTION_SOURCE_ATTRIBUTE","AttendableContainer","AttentionGlyph","AttentionManager","AttentionProvider","AttentionSchema","RootAttentionProvider","SelectionManager","SelectionProvider","Syncing","getAttendables","useAttendableAttributes","useAttended","useAttention","useAttentionContext","useAttentionPath","useSelectedItems","useSelectionActions"],"entryPoint":"packages/ui/react-ui-attention/src/index.ts","inputs":{"packages/ui/react-ui-attention/src/index.ts":{"bytesInOutput":0}},"bytes":1057},"packages/ui/react-ui-attention/dist/lib/node-esm/testing/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":698},"packages/ui/react-ui-attention/dist/lib/node-esm/testing/index.mjs":{"imports":[{"path":"packages/ui/react-ui-attention/dist/lib/node-esm/chunk-ZDSNYE3Y.mjs","kind":"import-statement"},{"path":"react","kind":"import-statement","external":true}],"exports":["withAttention"],"entryPoint":"packages/ui/react-ui-attention/src/testing/index.ts","inputs":{"packages/ui/react-ui-attention/src/testing/decorators/withAttention.ts":{"bytesInOutput":164},"packages/ui/react-ui-attention/src/testing/decorators/index.ts":{"bytesInOutput":0},"packages/ui/react-ui-attention/src/testing/index.ts":{"bytesInOutput":0}},"bytes":459},"packages/ui/react-ui-attention/dist/lib/node-esm/chunk-ZDSNYE3Y.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":30586},"packages/ui/react-ui-attention/dist/lib/node-esm/chunk-ZDSNYE3Y.mjs":{"imports":[{"path":"@preact/signals-core","kind":"import-statement","external":true},{"path":"effect","kind":"import-statement","external":true},{"path":"@dxos/live-object","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/react-ui","kind":"import-statement","external":true},{"path":"@dxos/react-ui-theme","kind":"import-statement","external":true},{"path":"@radix-ui/react-context","kind":"import-statement","external":true},{"path":"@radix-ui/react-primitive","kind":"import-statement","external":true},{"path":"@radix-ui/react-slot","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/react-ui","kind":"import-statement","external":true},{"path":"@dxos/react-ui-theme","kind":"import-statement","external":true},{"path":"@preact/signals-core","kind":"import-statement","external":true},{"path":"@dxos/live-object","kind":"import-statement","external":true},{"path":"@radix-ui/react-context","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/react-ui","kind":"import-statement","external":true}],"exports":["ATTENABLE_ATTRIBUTE","ATTENDABLE_PATH_SEPARATOR","ATTENTION_NAME","ATTENTION_SOURCE_ATTRIBUTE","AttendableContainer","AttentionGlyph","AttentionManager","AttentionProvider","AttentionSchema","RootAttentionProvider","SelectionManager","SelectionProvider","Syncing","getAttendables","useAttendableAttributes","useAttended","useAttention","useAttentionContext","useAttentionPath","useSelectedItems","useSelectionActions"],"inputs":{"packages/ui/react-ui-attention/src/attention.ts":{"bytesInOutput":3644},"packages/ui/react-ui-attention/src/components/AttentionGlyph.tsx":{"bytesInOutput":3229},"packages/ui/react-ui-attention/src/components/AttentionProvider.tsx":{"bytesInOutput":3318},"packages/ui/react-ui-attention/src/selection.ts":{"bytesInOutput":1193},"packages/ui/react-ui-attention/src/components/SelectionProvider.tsx":{"bytesInOutput":1662},"packages/ui/react-ui-attention/src/components/index.ts":{"bytesInOutput":0}},"bytes":13951}}}
+{"inputs":{"packages/ui/react-ui-attention/src/attention.ts":{"bytes":16529,"imports":[{"path":"@preact/signals-core","kind":"import-statement","external":true},{"path":"effect","kind":"import-statement","external":true},{"path":"@dxos/live-object","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"format":"esm"},"packages/ui/react-ui-attention/src/components/AttentionGlyph.tsx":{"bytes":11213,"imports":[{"path":"@preact-signals/safe-react/tracking","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/react-ui","kind":"import-statement","external":true},{"path":"@dxos/react-ui-theme","kind":"import-statement","external":true}],"format":"esm"},"packages/ui/react-ui-attention/src/components/AttentionProvider.tsx":{"bytes":20821,"imports":[{"path":"@preact-signals/safe-react/tracking","kind":"import-statement","external":true},{"path":"@radix-ui/react-context","kind":"import-statement","external":true},{"path":"@radix-ui/react-primitive","kind":"import-statement","external":true},{"path":"@radix-ui/react-slot","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/react-ui","kind":"import-statement","external":true},{"path":"@dxos/react-ui-theme","kind":"import-statement","external":true},{"path":"packages/ui/react-ui-attention/src/attention.ts","kind":"import-statement","original":"../attention"}],"format":"esm"},"packages/ui/react-ui-attention/src/selection.ts":{"bytes":15715,"imports":[{"path":"@preact/signals-core","kind":"import-statement","external":true},{"path":"effect","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/live-object","kind":"import-statement","external":true}],"format":"esm"},"packages/ui/react-ui-attention/src/components/SelectionProvider.tsx":{"bytes":11475,"imports":[{"path":"@preact-signals/safe-react/tracking","kind":"import-statement","external":true},{"path":"@radix-ui/react-context","kind":"import-statement","external":true},{"path":"effect","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/react-ui","kind":"import-statement","external":true},{"path":"packages/ui/react-ui-attention/src/selection.ts","kind":"import-statement","original":"../selection"}],"format":"esm"},"packages/ui/react-ui-attention/src/components/index.ts":{"bytes":721,"imports":[{"path":"packages/ui/react-ui-attention/src/components/AttentionGlyph.tsx","kind":"import-statement","original":"./AttentionGlyph"},{"path":"packages/ui/react-ui-attention/src/components/AttentionProvider.tsx","kind":"import-statement","original":"./AttentionProvider"},{"path":"packages/ui/react-ui-attention/src/components/SelectionProvider.tsx","kind":"import-statement","original":"./SelectionProvider"}],"format":"esm"},"packages/ui/react-ui-attention/src/index.ts":{"bytes":658,"imports":[{"path":"packages/ui/react-ui-attention/src/attention.ts","kind":"import-statement","original":"./attention"},{"path":"packages/ui/react-ui-attention/src/components/index.ts","kind":"import-statement","original":"./components"},{"path":"packages/ui/react-ui-attention/src/selection.ts","kind":"import-statement","original":"./selection"}],"format":"esm"},"packages/ui/react-ui-attention/src/testing/decorators/withAttention.ts":{"bytes":1350,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"packages/ui/react-ui-attention/src/components/index.ts","kind":"import-statement","original":"../../components"}],"format":"esm"},"packages/ui/react-ui-attention/src/testing/decorators/index.ts":{"bytes":506,"imports":[{"path":"packages/ui/react-ui-attention/src/testing/decorators/withAttention.ts","kind":"import-statement","original":"./withAttention"}],"format":"esm"},"packages/ui/react-ui-attention/src/testing/index.ts":{"bytes":484,"imports":[{"path":"packages/ui/react-ui-attention/src/testing/decorators/index.ts","kind":"import-statement","original":"./decorators"}],"format":"esm"}},"outputs":{"packages/ui/react-ui-attention/dist/lib/node-esm/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":93},"packages/ui/react-ui-attention/dist/lib/node-esm/index.mjs":{"imports":[{"path":"packages/ui/react-ui-attention/dist/lib/node-esm/chunk-GBD6BNIC.mjs","kind":"import-statement"}],"exports":["ATTENABLE_ATTRIBUTE","ATTENDABLE_PATH_SEPARATOR","ATTENTION_NAME","ATTENTION_SOURCE_ATTRIBUTE","AttendableContainer","AttentionGlyph","AttentionManager","AttentionProvider","AttentionSchema","RootAttentionProvider","SelectionManager","SelectionProvider","Syncing","defaultSelection","getAttendables","useAttendableAttributes","useAttended","useAttention","useAttentionContext","useAttentionPath","useSelected","useSelectionActions"],"entryPoint":"packages/ui/react-ui-attention/src/index.ts","inputs":{"packages/ui/react-ui-attention/src/index.ts":{"bytesInOutput":0}},"bytes":1087},"packages/ui/react-ui-attention/dist/lib/node-esm/testing/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":698},"packages/ui/react-ui-attention/dist/lib/node-esm/testing/index.mjs":{"imports":[{"path":"packages/ui/react-ui-attention/dist/lib/node-esm/chunk-GBD6BNIC.mjs","kind":"import-statement"},{"path":"react","kind":"import-statement","external":true}],"exports":["withAttention"],"entryPoint":"packages/ui/react-ui-attention/src/testing/index.ts","inputs":{"packages/ui/react-ui-attention/src/testing/decorators/withAttention.ts":{"bytesInOutput":164},"packages/ui/react-ui-attention/src/testing/decorators/index.ts":{"bytesInOutput":0},"packages/ui/react-ui-attention/src/testing/index.ts":{"bytesInOutput":0}},"bytes":459},"packages/ui/react-ui-attention/dist/lib/node-esm/chunk-GBD6BNIC.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":37366},"packages/ui/react-ui-attention/dist/lib/node-esm/chunk-GBD6BNIC.mjs":{"imports":[{"path":"@preact/signals-core","kind":"import-statement","external":true},{"path":"effect","kind":"import-statement","external":true},{"path":"@dxos/live-object","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"@preact-signals/safe-react/tracking","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/react-ui","kind":"import-statement","external":true},{"path":"@dxos/react-ui-theme","kind":"import-statement","external":true},{"path":"@preact-signals/safe-react/tracking","kind":"import-statement","external":true},{"path":"@radix-ui/react-context","kind":"import-statement","external":true},{"path":"@radix-ui/react-primitive","kind":"import-statement","external":true},{"path":"@radix-ui/react-slot","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/react-ui","kind":"import-statement","external":true},{"path":"@dxos/react-ui-theme","kind":"import-statement","external":true},{"path":"@preact/signals-core","kind":"import-statement","external":true},{"path":"effect","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/live-object","kind":"import-statement","external":true},{"path":"@preact-signals/safe-react/tracking","kind":"import-statement","external":true},{"path":"@radix-ui/react-context","kind":"import-statement","external":true},{"path":"effect","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/react-ui","kind":"import-statement","external":true}],"exports":["ATTENABLE_ATTRIBUTE","ATTENDABLE_PATH_SEPARATOR","ATTENTION_NAME","ATTENTION_SOURCE_ATTRIBUTE","AttendableContainer","AttentionGlyph","AttentionManager","AttentionProvider","AttentionSchema","RootAttentionProvider","SelectionManager","SelectionProvider","Syncing","defaultSelection","getAttendables","useAttendableAttributes","useAttended","useAttention","useAttentionContext","useAttentionPath","useSelected","useSelectionActions"],"inputs":{"packages/ui/react-ui-attention/src/attention.ts":{"bytesInOutput":3644},"packages/ui/react-ui-attention/src/components/AttentionGlyph.tsx":{"bytesInOutput":3714},"packages/ui/react-ui-attention/src/components/AttentionProvider.tsx":{"bytesInOutput":3709},"packages/ui/react-ui-attention/src/selection.ts":{"bytesInOutput":4356},"packages/ui/react-ui-attention/src/components/SelectionProvider.tsx":{"bytesInOutput":2644},"packages/ui/react-ui-attention/src/components/index.ts":{"bytesInOutput":0}},"bytes":18987}}}

package/dist/lib/node-esm/testing/index.mjs

@@ -1,7 +1,7 @@
 import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
 import {
   RootAttentionProvider
-} from "../chunk-ZDSNYE3Y.mjs";
+} from "../chunk-GBD6BNIC.mjs";
 
 // packages/ui/react-ui-attention/src/testing/decorators/withAttention.ts
 import { createElement } from "react";

package/dist/types/src/components/SelectionProvider.d.ts

@@ -1,17 +1,25 @@
 import React, { type PropsWithChildren } from 'react';
-import { SelectionManager } from '../selection';
+import { SelectionManager, type SelectionMode } from '../selection';
 /**
  * Manages selection state across the app for multiple contexts.
  */
 export declare const SelectionProvider: ({ children, selection: propsSelection, }: PropsWithChildren<{
     selection?: SelectionManager;
 }>) => React.JSX.Element;
-export declare const useSelectedItems: (contextId?: string) => Set<string>;
+export declare const useSelected: <T extends SelectionMode>(contextId?: string, mode?: T) => T extends "single" ? string | undefined : T extends "multi" ? string[] : T extends "range" ? {
+    from: string;
+    to: string;
+} | undefined : T extends "multi-range" ? {
+    from: string;
+    to: string;
+}[] : never;
 /**
  * Provides functions to manage the selection state for multiple contexts.
  */
-export declare const useSelectionActions: (contextIds: string[]) => {
-    select: (ids: string[]) => void;
+export declare const useSelectionActions: (contextIds: string[], mode?: SelectionMode) => {
+    singleSelect: (id: string) => void;
+    multiSelect: (ids: string[]) => void;
+    rangeSelect: (from: string, to: string) => void;
     toggle: (id: string) => void;
     clear: () => void;
 };

package/dist/types/src/components/SelectionProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SelectionProvider.d.ts","sourceRoot":"","sources":["../../../../src/components/SelectionProvider.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,EAAwB,KAAK,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAI5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAYhD;;GAEG;AAGH,eAAO,MAAM,iBAAiB,GAAI,0CAG/B,iBAAiB,CAAC;IAAE,SAAS,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAAC,sBAGrD,CAAC;AAKF,eAAO,MAAM,gBAAgB,GAAI,YAAY,MAAM,KAAG,GAAG,CAAC,MAAM,CAG/D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,YAAY,MAAM,EAAE;kBAK9C,MAAM,EAAE;iBAST,MAAM;;CAed,CAAC"}
+{"version":3,"file":"SelectionProvider.d.ts","sourceRoot":"","sources":["../../../../src/components/SelectionProvider.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,EAAwB,KAAK,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAI5E,OAAO,EAAoB,gBAAgB,EAAkB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAYtG;;GAEG;AAEH,eAAO,MAAM,iBAAiB,GAAI,0CAG/B,iBAAiB,CAAC;IAAE,SAAS,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAAC,sBAGrD,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,aAAa,EACjD,YAAY,MAAM,EAClB,OAAM,CAAgB,KACrB,CAAC,SAAS,QAAQ,GACjB,MAAM,GAAG,SAAS,GAClB,CAAC,SAAS,OAAO,GACf,MAAM,EAAE,GACR,CAAC,SAAS,OAAO,GACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GACxC,CAAC,SAAS,aAAa,GACrB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,GAC9B,KAaT,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,YAAY,MAAM,EAAE,EAAE,OAAM,aAAuB;uBAK9E,MAAM;uBASL,MAAM,EAAE;wBASP,MAAM,MAAM,MAAM;iBASpB,MAAM;;CAed,CAAC"}

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

@@ -1,14 +1,45 @@
 import { type Live } from '@dxos/live-object';
+export type SelectionMode = 'single' | 'multi' | 'range' | 'multi-range';
+export type Selection = {
+    mode: 'single';
+    id?: string;
+} | {
+    mode: 'multi';
+    ids: string[];
+} | {
+    mode: 'range';
+    from?: string;
+    to?: string;
+} | {
+    mode: 'multi-range';
+    ranges: {
+        from: string;
+        to: string;
+    }[];
+};
+export declare const defaultSelection: (u: SelectionMode) => Selection;
 /**
  * Manages selection state for different contexts.
- * Each context maintains its own list of selected IDs.
+ * Each context maintains its own selection mode and state.
  */
 export declare class SelectionManager {
     private readonly _state;
-    constructor(initial?: Record<string, Set<string>>);
-    get selections(): Live<Record<string, Set<string>>>;
-    getSelection(contextId: string): Set<string>;
-    updateSelection(contextId: string, selectedIds: Set<string> | string[]): void;
+    constructor(initial?: Record<string, Selection>);
+    getSelection<T extends SelectionMode | undefined>(contextId: string, mode?: T): T extends undefined ? Live<Selection> | undefined : Live<Selection>;
+    getSelected<T extends SelectionMode>(contextId: string, mode?: T): T extends 'single' ? string | undefined : T extends 'multi' ? string[] : T extends 'range' ? {
+        from: string;
+        to: string;
+    } | undefined : T extends 'multi-range' ? {
+        from: string;
+        to: string;
+    }[] : never;
+    updateSingle(contextId: string, id: string): void;
+    updateMulti(contextId: string, ids: string[]): void;
+    updateRange(contextId: string, from: string, to: string): void;
+    updateMultiRange(contextId: string, ranges: {
+        from: string;
+        to: string;
+    }[]): void;
     clearSelection(contextId: string): void;
     toggleSelection(contextId: string, id: string): void;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../../src/selection.ts"],"names":[],"mappings":"AAMA,OAAO,EAAQ,KAAK,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;GAGG;AAEH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyE;gBAEpF,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAM;IAQrD,IAAI,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAElD;IAED,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAS5C,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE;IAMtE,cAAc,CAAC,SAAS,EAAE,MAAM;IAMhC,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;CAU9C"}
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../../src/selection.ts"],"names":[],"mappings":"AAQA,OAAO,EAAQ,KAAK,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,aAAa,CAAC;AAEzE,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,EAAE,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAAC;AAEpE,eAAO,MAAM,gBAAgB,iCAM5B,CAAC;AAEF;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuE;gBAElF,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAM;IAQnD,YAAY,CAAC,CAAC,SAAS,aAAa,GAAG,SAAS,EAC9C,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,CAAkB,GACvB,CAAC,SAAS,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IAYtE,WAAW,CAAC,CAAC,SAAS,aAAa,EACjC,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,CAAgB,GACrB,CAAC,SAAS,QAAQ,GACjB,MAAM,GAAG,SAAS,GAClB,CAAC,SAAS,OAAO,GACf,MAAM,EAAE,GACR,CAAC,SAAS,OAAO,GACf;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,GACxC,CAAC,SAAS,aAAa,GACrB;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,GAC9B,KAAK;IAYf,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAQjD,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE;IAQ5C,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;IASvD,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE;IAQ1E,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IASvC,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;CAarD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/react-ui-attention",
-  "version": "0.8.2-main.fbd8ed0",
+  "version": "0.8.2-staging.4d6ad0f",
   "description": "Signifier components and providers for attention system.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -33,7 +33,8 @@
     "src"
   ],
   "dependencies": {
-    "@preact/signals-core": "^1.6.0",
+    "@preact-signals/safe-react": "^0.9.0",
+    "@preact/signals-core": "^1.9.0",
     "@radix-ui/primitive": "1.1.1",
     "@radix-ui/react-compose-refs": "1.1.1",
     "@radix-ui/react-context": "1.1.1",
@@ -42,9 +43,11 @@
     "@radix-ui/react-slot": "1.1.2",
     "@radix-ui/react-use-controllable-state": "1.1.0",
     "effect": "3.14.21",
-    "@dxos/echo-schema": "0.8.2-main.fbd8ed0",
-    "@dxos/live-object": "0.8.2-main.fbd8ed0",
-    "@dxos/util": "0.8.2-main.fbd8ed0"
+    "@dxos/echo-schema": "0.8.2-staging.4d6ad0f",
+    "@dxos/live-object": "0.8.2-staging.4d6ad0f",
+    "@dxos/invariant": "0.8.2-staging.4d6ad0f",
+    "@dxos/log": "0.8.2-staging.4d6ad0f",
+    "@dxos/util": "0.8.2-staging.4d6ad0f"
   },
   "devDependencies": {
     "@phosphor-icons/react": "^2.1.5",
@@ -53,19 +56,19 @@
     "react": "~18.2.0",
     "react-dom": "~18.2.0",
     "vite": "5.4.7",
-    "@dxos/app-graph": "0.8.2-main.fbd8ed0",
-    "@dxos/random": "0.8.2-main.fbd8ed0",
-    "@dxos/react-ui": "0.8.2-main.fbd8ed0",
-    "@dxos/react-ui-theme": "0.8.2-main.fbd8ed0",
-    "@dxos/storybook-utils": "0.8.2-main.fbd8ed0"
+    "@dxos/app-graph": "0.8.2-staging.4d6ad0f",
+    "@dxos/react-ui": "0.8.2-staging.4d6ad0f",
+    "@dxos/random": "0.8.2-staging.4d6ad0f",
+    "@dxos/react-ui-theme": "0.8.2-staging.4d6ad0f",
+    "@dxos/storybook-utils": "0.8.2-staging.4d6ad0f"
   },
   "peerDependencies": {
     "@phosphor-icons/react": "^2.1.5",
     "effect": "^3.13.3",
     "react": "~18.2.0",
     "react-dom": "~18.2.0",
-    "@dxos/react-ui-theme": "0.8.2-main.fbd8ed0",
-    "@dxos/react-ui": "0.8.2-main.fbd8ed0"
+    "@dxos/react-ui": "0.8.2-staging.4d6ad0f",
+    "@dxos/react-ui-theme": "0.8.2-staging.4d6ad0f"
   },
   "publishConfig": {
     "access": "public"

package/src/attention.ts

@@ -75,7 +75,7 @@ export class AttentionManager {
    *
    * @internal
    */
-  update(nextKey: string[]) {
+  update(nextKey: string[]): void {
     const currentKey = untracked(() => this.current);
     const currentRelatedTo = currentKey[0];
     const nextRelatedTo = nextKey[0];
@@ -105,7 +105,7 @@ export class AttentionManager {
     this._set(nextKey, { hasAttention: true });
   }
 
-  private _set(key: string[], attention: Partial<Attention>) {
+  private _set(key: string[], attention: Partial<Attention>): void {
     const object = this.get(key);
     object.hasAttention = attention.hasAttention ?? false;
     object.isAncestor = attention.isAncestor ?? false;

package/src/components/SelectionProvider.tsx

@@ -3,11 +3,12 @@
 //
 
 import { createContext } from '@radix-ui/react-context';
+import { Match } from 'effect';
 import React, { useCallback, useMemo, type PropsWithChildren } from 'react';
 
 import { useDefaultValue } from '@dxos/react-ui';
 
-import { SelectionManager } from '../selection';
+import { defaultSelection, SelectionManager, type Selection, type SelectionMode } from '../selection';
 
 const SELECTION_NAME = 'Selection';
 
@@ -22,7 +23,6 @@ const [SelectionContextProvider, useSelectionContext] = createContext<SelectionC
 /**
  * Manages selection state across the app for multiple contexts.
  */
-// TODO(burdon): Review/remove this.
 // TODO(burdon): When is the selection removed?
 export const SelectionProvider = ({
   children,
@@ -32,25 +32,61 @@ export const SelectionProvider = ({
   return <SelectionContextProvider selection={selection}>{children}</SelectionContextProvider>;
 };
 
-const emptySet = new Set<string>();
-
-// TODO(burdon): Return array?
-export const useSelectedItems = (contextId?: string): Set<string> => {
+export const useSelected = <T extends SelectionMode>(
+  contextId?: string,
+  mode: T = 'multi' as T,
+): T extends 'single'
+  ? string | undefined
+  : T extends 'multi'
+    ? string[]
+    : T extends 'range'
+      ? { from: string; to: string } | undefined
+      : T extends 'multi-range'
+        ? { from: string; to: string }[]
+        : never => {
   const { selection } = useSelectionContext(SELECTION_NAME);
-  return contextId ? selection.getSelection(contextId) : emptySet;
+  if (contextId) {
+    return selection.getSelected(contextId, mode);
+  }
+
+  return Match.type<Selection>().pipe(
+    Match.when({ mode: 'single' }, (s) => s.id),
+    Match.when({ mode: 'multi' }, (s) => s.ids),
+    Match.when({ mode: 'range' }, (s) => (s.from && s.to ? { from: s.from, to: s.to } : undefined)),
+    Match.when({ mode: 'multi-range' }, (s) => s.ranges),
+    Match.exhaustive,
+  )(defaultSelection(mode)) as any;
 };
 
 /**
  * Provides functions to manage the selection state for multiple contexts.
  */
-export const useSelectionActions = (contextIds: string[]) => {
-  const stableContextIds = useMemo(() => contextIds, [JSON.stringify(contextIds)]);
+export const useSelectionActions = (contextIds: string[], mode: SelectionMode = 'multi') => {
+  const stableContextIds = useMemo(() => contextIds, [JSON.stringify(contextIds)]); // TODO(burdon): Avoid stringify.
   const { selection } = useSelectionContext(SELECTION_NAME);
 
-  const select = useCallback(
+  const singleSelect = useCallback(
+    (id: string) => {
+      for (const contextId of stableContextIds) {
+        selection.updateSingle(contextId, id);
+      }
+    },
+    [selection, stableContextIds],
+  );
+
+  const multiSelect = useCallback(
     (ids: string[]) => {
       for (const contextId of stableContextIds) {
-        selection.updateSelection(contextId, ids);
+        selection.updateMulti(contextId, ids);
+      }
+    },
+    [selection, stableContextIds],
+  );
+
+  const rangeSelect = useCallback(
+    (from: string, to: string) => {
+      for (const contextId of stableContextIds) {
+        selection.updateRange(contextId, from, to);
       }
     },
     [selection, stableContextIds],
@@ -71,5 +107,5 @@ export const useSelectionActions = (contextIds: string[]) => {
     }
   }, [selection, stableContextIds]);
 
-  return { select, toggle, clear };
+  return { singleSelect, multiSelect, rangeSelect, toggle, clear };
 };