@dxos/react-ui-attention 0.8.4-main.dedc0f3 → 0.8.4-main.dfabb4ec29

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

@@ -1,37 +1,48 @@
-import { Schema } from 'effect';
-import { type Live } from '@dxos/live-object';
-export declare const ATTENDABLE_PATH_SEPARATOR = "~";
-export declare const AttentionSchema: Schema.mutable<Schema.Struct<{
-    hasAttention: typeof Schema.Boolean;
-    isAncestor: typeof Schema.Boolean;
-    isRelated: typeof Schema.Boolean;
-}>>;
-export type Attention = Schema.Schema.Type<typeof AttentionSchema>;
+import { Atom, type Registry } from '@effect-atom/atom-react';
+export type Attention = {
+    hasAttention: boolean;
+    isAncestor: boolean;
+    isRelated: boolean;
+};
 /**
  * Manages attention state for an application.
+ * Attention keys are slash-qualified graph IDs; ancestry is derived from progressive prefixes.
  */
 export declare class AttentionManager {
+    private readonly _registry;
     private readonly _map;
-    private readonly _state;
-    constructor(initial?: string[]);
+    private readonly _currentAtom;
+    constructor(_registry: Registry.Registry, initial?: string[]);
+    /**
+     * Atom for the currently attended element IDs.
+     */
+    get current(): Atom.Atom<string[]>;
+    /**
+     * Gets the currently attended element IDs.
+     */
+    getCurrent(): readonly string[];
     /**
-     * Currently attended element.
-     *
-     * @reactive
+     * Subscribe to changes in the current attention IDs.
      */
-    get current(): Live<readonly string[]>;
+    subscribeCurrent(cb: (current: readonly string[]) => void): () => void;
     /**
-     * All attention paths.
+     * All tracked qualified IDs.
      */
-    keys(): string[][];
+    keys(): string[];
     /**
-     * Get the attention state for a given path.
+     * Get the attention state for a given qualified ID.
      */
-    get(key: string[]): Live<Attention>;
+    get(id: string): Attention;
+    /**
+     * Subscribe to changes in the attention state for a given qualified ID.
+     */
+    subscribe(id: string, cb: (attention: Attention) => void): () => void;
+    private _getAtom;
     private _set;
 }
 /**
- * Accumulates all attendable id’s between the element provided and the root, inclusive.
+ * Accumulates all attendable IDs between the element provided and the root, inclusive.
+ * Each `data-attendable-id` value is treated as a single qualified ID (no splitting).
  */
 export declare const getAttendables: (selector: string, cursor: Element, acc?: string[]) => string[];
 export type AttendableId = {
@@ -40,4 +51,33 @@ export type AttendableId = {
 export type Related = {
     related?: boolean;
 };
+/**
+ * Decompose a qualified graph ID into progressive prefixes for ancestry tracking.
+ * e.g. `root/a/b/c` yields `['root', 'root/a', 'root/a/b', 'root/a/b/c']`.
+ */
+export declare const expandAttendableId: (qualifiedId: string) => string[];
+/**
+ * Whether the last segment of a qualified ID is a linked segment (starts with `~`).
+ * Linked segments share their attention state with the parent node.
+ */
+export declare const isLinkedSegment: (qualifiedId: string) => boolean;
+/**
+ * Build a linked segment ID from a variant name (e.g., `'settings'` -> `'~settings'`).
+ * Nodes identified by linked segments share their attention state with the parent node.
+ */
+export declare const linkedSegment: (variant: string) => string;
+/**
+ * Extract the variant name from the last segment of a qualified ID, stripping the linked prefix.
+ * e.g. `'root/space/obj/~settings'` -> `'settings'`.
+ * If the segment is not linked (no `~` prefix), returns the segment as-is.
+ */
+export declare const getLinkedVariant: (qualifiedId: string) => string;
+/**
+ * Get the parent qualified ID (everything before the last `/` segment).
+ */
+export declare const getParentId: (qualifiedId: string | undefined) => string | undefined;
+/**
+ * Extract the segment ID (last segment) of a qualified ID.
+ */
+export declare const getSegmentId: (qualifiedId: string) => string;
 //# sourceMappingURL=attention.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"attention.d.ts","sourceRoot":"","sources":["../../../src/attention.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,KAAK,IAAI,EAAQ,MAAM,mBAAmB,CAAC;AAIpD,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C,eAAO,MAAM,eAAe;;;;GAM3B,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,eAAe,CAAC,CAAC;AAKnE;;GAEG;AAEH,qBAAa,gBAAgB;IAG3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwD;IAC7E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgD;gBAE3D,OAAO,GAAE,MAAM,EAAO;IAMlC;;;;OAIG;IACH,IAAI,OAAO,IAAI,IAAI,CAAC,SAAS,MAAM,EAAE,CAAC,CAErC;IAED;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE,EAAE;IAIlB;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC;IA8CnC,OAAO,CAAC,IAAI;CAMb;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,EAAE,QAAQ,OAAO,EAAE,MAAK,MAAM,EAAO,KAAG,MAAM,EAqB5F,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAErD,MAAM,MAAM,OAAO,GAAG;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC"}
+{"version":3,"file":"attention.d.ts","sourceRoot":"","sources":["../../../src/attention.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAE9D,MAAM,MAAM,SAAS,GAAG;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,qBAAa,gBAAgB;IAKzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+C;IACpE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0B;IAEvD,YACmB,SAAS,EAAE,QAAQ,CAAC,QAAQ,EAC7C,OAAO,GAAE,MAAM,EAAO,EAMvB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAEjC;IAED;;OAEG;IACH,UAAU,IAAI,SAAS,MAAM,EAAE,CAE9B;IAED;;OAEG;IACH,gBAAgB,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,GAAG,MAAM,IAAI,CAKrE;IAED;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE,CAEf;IAED;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAGzB;IAED;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,GAAG,MAAM,IAAI,CAMpE;IAED,OAAO,CAAC,QAAQ;IAuEhB,OAAO,CAAC,IAAI;CAQb;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,aAAc,MAAM,UAAU,OAAO,QAAO,MAAM,EAAE,KAAQ,MAAM,EAoB5F,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAErD,MAAM,MAAM,OAAO,GAAG;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAQ5C;;;GAGG;AACH,eAAO,MAAM,kBAAkB,gBAAiB,MAAM,KAAG,MAAM,EAG9D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,gBAAiB,MAAM,KAAG,OAGrD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,YAAa,MAAM,KAAG,MAAsC,CAAC;AAEvF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,gBAAiB,MAAM,KAAG,MAGtD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,gBAAiB,MAAM,GAAG,SAAS,KAAG,MAAM,GAAG,SAOtE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,gBAAiB,MAAM,KAAG,MAElD,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"AttentionGlyph.d.ts","sourceRoot":"","sources":["../../../../../src/components/AttentionGlyph/AttentionGlyph.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,EAAsB,KAAK,qBAAqB,EAAuB,MAAM,OAAO,CAAC;AAEnG,OAAO,EAAQ,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAkD5D,eAAO,MAAM,OAAO,yBAmBnB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;CACpC,GAAG,eAAe,CAAC,IAAI,CAAC,qBAAqB,CAAC,OAAO,SAAS,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;AAEpF,eAAO,MAAM,cAAc,0GAkB1B,CAAC"}

package/dist/types/src/components/{AttentionGlyph.stories.d.ts → AttentionGlyph/AttentionGlyph.stories.d.ts}

@@ -1,4 +1,3 @@
-import '@dxos-theme';
 import { type StoryObj } from '@storybook/react-vite';
 import React from 'react';
 import { type AttentionGlyphProps } from './AttentionGlyph';

package/dist/types/src/components/AttentionGlyph/AttentionGlyph.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttentionGlyph.stories.d.ts","sourceRoot":"","sources":["../../../../../src/components/AttentionGlyph/AttentionGlyph.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAA2C,MAAM,OAAO,CAAC;AAMhE,OAAO,EAAkB,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAkB5E,QAAA,MAAM,IAAI;;eAEqB,GAAG;oBAlBL,mBAAmB;;CAqBX,CAAC;eAEvB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAErB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KAEvB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,KAEtB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,KAqCrB,CAAC"}

package/dist/types/src/components/AttentionGlyph/index.d.ts

@@ -0,0 +1,2 @@
+export * from './AttentionGlyph';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/components/AttentionGlyph/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/AttentionGlyph/index.ts"],"names":[],"mappings":"AAIA,cAAc,kBAAkB,CAAC"}

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

@@ -0,0 +1,34 @@
+import React, { type ComponentPropsWithRef, type PropsWithChildren } from 'react';
+import { type ThemedClassName } from '@dxos/react-ui';
+import { type Attention, AttentionManager } from '../../attention';
+type AttentionContextValue = {
+    attention: AttentionManager;
+};
+declare const useAttentionContext: (consumerName: string) => AttentionContextValue;
+/**
+ * Subscribe to the attention state for a qualified graph ID.
+ */
+declare const useAttention: (attendableId?: string) => Attention;
+declare const useAttended: () => readonly string[];
+/**
+ * Computes HTML element attributes to apply so the attention system can detect changes.
+ */
+declare const useAttentionAttributes: (attendableId?: string) => Record<string, string | undefined>;
+type RootAttentionProviderProps = PropsWithChildren<{
+    attention?: AttentionManager;
+    onChange?: (nextAttended: string[]) => void;
+}>;
+declare const RootAttentionProvider: ({ children, attention: propsAttention, onChange }: RootAttentionProviderProps) => React.JSX.Element;
+export type AttendableContainerProps = ThemedClassName<ComponentPropsWithRef<'div'> & {
+    id: string;
+    asChild?: boolean;
+}>;
+/**
+ * Note that DeckPlugin and StackPlugin both handle attention on their own,
+ * and when rendering content in those cases it is not necessary to also render an `AttendableContainer`.
+ * This component is primarily for Storybook stories and other testing scenarios,
+ * or the rare cases where an attendable entity is rendered outside of either of those plugins.
+ */
+declare const AttendableContainer: React.ForwardRefExoticComponent<Omit<AttendableContainerProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export { RootAttentionProvider, AttendableContainer, useAttentionContext, useAttention, useAttended, useAttentionAttributes, };
+//# sourceMappingURL=AttentionProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AttentionProvider.d.ts","sourceRoot":"","sources":["../../../../../src/components/AttentionProvider/AttentionProvider.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,EACZ,KAAK,qBAAqB,EAE1B,KAAK,iBAAiB,EAOvB,MAAM,OAAO,CAAC;AAIf,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGtD,OAAO,EAAE,KAAK,SAAS,EAAE,gBAAgB,EAAkB,MAAM,iBAAiB,CAAC;AAMnF,KAAK,qBAAqB,GAAG;IAC3B,SAAS,EAAE,gBAAgB,CAAC;CAC7B,CAAC;AAEF,QAAA,MAAiC,mBAAmB,iDAElD,CAAC;AAIH;;GAEG;AAEH,QAAA,MAAM,YAAY,kBAAmB,MAAM,KAAG,SAkB7C,CAAC;AAEF,QAAA,MAAM,WAAW,yBAgBhB,CAAC;AAEF;;GAEG;AACH,QAAA,MAAM,sBAAsB,kBAAmB,MAAM,uCAUpD,CAAC;AAEF,KAAK,0BAA0B,GAAG,iBAAiB,CAAC;IAClD,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,QAAQ,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CAC7C,CAAC,CAAC;AAEH,QAAA,MAAM,qBAAqB,sDAAuD,0BAA0B,sBAmC3G,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,eAAe,CACpD,qBAAqB,CAAC,KAAK,CAAC,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CACjE,CAAC;AAEF;;;;;GAKG;AACH,QAAA,MAAM,mBAAmB,8GAgBxB,CAAC;AAEF,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,sBAAsB,GACvB,CAAC"}

package/dist/types/src/components/{AttentionProvider.stories.d.ts → AttentionProvider/AttentionProvider.stories.d.ts}

@@ -1,4 +1,3 @@
-import '@dxos-theme';
 import { type StoryObj } from '@storybook/react-vite';
 import React from 'react';
 declare const Story: () => React.JSX.Element;

package/dist/types/src/components/AttentionProvider/AttentionProvider.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttentionProvider.stories.d.ts","sourceRoot":"","sources":["../../../../../src/components/AttentionProvider/AttentionProvider.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,MAAM,OAAO,CAAC;AAiB1B,QAAA,MAAM,KAAK,yBASV,CAAC;AAEF,QAAA,MAAM,IAAI;;;;CAIM,CAAC;eAEF,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAAU,CAAC"}

package/dist/types/src/components/AttentionProvider/index.d.ts

@@ -0,0 +1,2 @@
+export * from './AttentionProvider';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/components/AttentionProvider/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/AttentionProvider/index.ts"],"names":[],"mappings":"AAIA,cAAc,qBAAqB,CAAC"}

package/dist/types/src/components/{SelectionProvider.d.ts → SelectionProvider/SelectionProvider.d.ts}

@@ -1,9 +1,9 @@
 import React, { type PropsWithChildren } from 'react';
-import { SelectionManager, type SelectionMode, type SelectionResult } from '../selection';
+import { SelectionManager, type SelectionMode, type SelectionResult } from '../../selection';
 /**
  * Manages selection state across the app for multiple contexts.
  */
-export declare const SelectionProvider: ({ children, selection: propsSelection, }: PropsWithChildren<{
+export declare const SelectionProvider: ({ children, selection: selectionProp, }: PropsWithChildren<{
     selection?: SelectionManager;
 }>) => React.JSX.Element;
 /**
@@ -14,14 +14,15 @@ export declare const useSelectionManager: () => SelectionManager;
  * Get the selected objects for a given context.
  */
 export declare const useSelected: <T extends SelectionMode>(contextId?: string, mode?: T) => SelectionResult<T>;
-/**
- * Provides functions to manage the selection state for multiple contexts.
- */
-export declare const useSelectionActions: (contextIds: string[], mode?: SelectionMode) => {
+export type UseSelectionActions = {
     singleSelect: (id: string) => void;
     multiSelect: (ids: string[]) => void;
     rangeSelect: (from: string, to: string) => void;
     toggle: (id: string) => void;
     clear: () => void;
 };
+/**
+ * Provides functions to manage the selection state for multiple contexts.
+ */
+export declare const useSelectionActions: (contextIds: string[]) => UseSelectionActions;
 //# sourceMappingURL=SelectionProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SelectionProvider.d.ts","sourceRoot":"","sources":["../../../../../src/components/SelectionProvider/SelectionProvider.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAyD,MAAM,OAAO,CAAC;AAI7G,OAAO,EAEL,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,eAAe,EAErB,MAAM,iBAAiB,CAAC;AAiBzB;;GAEG;AACH,eAAO,MAAM,iBAAiB,4CAG3B,iBAAiB,CAAC;IAAE,SAAS,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAAC,sBAKrD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,QAAO,gBAGtC,CAAC;AAcF;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,aAAa,cACrC,MAAM,SACZ,CAAC,KACN,eAAe,CAAC,CAAC,CAsBnB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACrC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,eAAgB,MAAM,EAAE,KAAG,mBAiE1D,CAAC"}

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

@@ -0,0 +1,2 @@
+export * from './SelectionProvider';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/SelectionProvider/index.ts"],"names":[],"mappings":"AAIA,cAAc,qBAAqB,CAAC"}

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

@@ -1,5 +1,5 @@
-import { Schema } from 'effect';
-import { type Live } from '@dxos/live-object';
+import { Atom, type Registry } from '@effect-atom/atom-react';
+import * as Schema from 'effect/Schema';
 export type SelectionMode = 'single' | 'multi' | 'range' | 'multi-range';
 export declare const SelectionSchema: Schema.mutable<Schema.Union<[Schema.mutable<Schema.Struct<{
     mode: Schema.Literal<["single"]>;
@@ -43,10 +43,30 @@ export declare const getSelectionSet: (selectionManager: SelectionManager, conte
  * Each context maintains its own selection mode and state.
  */
 export declare class SelectionManager {
+    private readonly _registry;
     private readonly _state;
-    constructor(initial?: Record<string, Selection>);
+    constructor(_registry: Registry.Registry, initial?: Record<string, Selection>);
+    /**
+     * Get the state atom for reactive access in the graph system.
+     */
+    get state(): Atom.Atom<{
+        selections: Record<string, Selection>;
+    }>;
+    /**
+     * Gets the current state.
+     */
+    getState(): {
+        selections: Record<string, Selection>;
+    };
+    /**
+     * Subscribe to changes in the selection state.
+     */
+    subscribe(cb: (state: {
+        selections: Record<string, Selection>;
+    }) => void): () => void;
     getSelectionContexts(): string[];
-    getSelection<T extends SelectionMode | undefined>(contextId: string, mode?: T): T extends undefined ? Live<Selection> | undefined : Live<Selection>;
+    getSelection(contextId: string): Selection | undefined;
+    getSelection<T extends SelectionMode>(contextId: string, mode: T): Selection;
     getSelected<T extends SelectionMode>(contextId: string, mode?: T): SelectionResult<T>;
     updateSingle(contextId: string, id: string): void;
     updateMulti(contextId: string, ids: 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":"AAKA,OAAO,EAAS,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGvC,OAAO,EAAE,KAAK,IAAI,EAAQ,MAAM,mBAAmB,CAAC;AAIpD,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,aAAa,CAAC;AAEzE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;MAcN,CAAC;AAEvB,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,eAAe,CAAC,CAAC;AAEnE,eAAO,MAAM,gBAAgB;;;;;;;;;;CAO5B,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,aAAa,IAAI,CAAC,SAAS,QAAQ,GACrE,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,KAAK,CAAC;AAGhB,eAAO,MAAM,eAAe,GAAI,kBAAkB,gBAAgB,EAAE,YAAY,MAAM,gBAYrF,CAAC;AAEF;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuE;gBAElF,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAM;IAQnD,oBAAoB,IAAI,MAAM,EAAE;IAIhC,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;IAatE,WAAW,CAAC,CAAC,SAAS,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,CAAgB,GAAG,eAAe,CAAC,CAAC,CAAC;IAYnG,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;IAyBvC,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;CAarD"}
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../../src/selection.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAE9D,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,aAAa,CAAC;AAEzE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;MAkBN,CAAC;AAEvB,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,eAAe,CAAC,CAAC;AAEnE,eAAO,MAAM,gBAAgB;;;;;;;;;;CAO5B,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,aAAa,IAAI,CAAC,SAAS,QAAQ,GACrE,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,KAAK,CAAC;AAEhB,eAAO,MAAM,eAAe,qBAAsB,gBAAgB,cAAc,MAAM,gBAYrF,CAAC;AAEF;;;GAGG;AACH,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAH5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2D;IAElF,YACmB,SAAS,EAAE,QAAQ,CAAC,QAAQ,EAC7C,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAM,EAKxC;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;KAAE,CAAC,CAEhE;IAED;;OAEG;IACH,QAAQ,IAAI;QAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;KAAE,CAEpD;IAED;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;KAAE,KAAK,IAAI,GAAG,MAAM,IAAI,CAKpF;IAED,oBAAoB,IAAI,MAAM,EAAE,CAE/B;IAED,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IACvD,YAAY,CAAC,CAAC,SAAS,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC;IAoB7E,WAAW,CAAC,CAAC,SAAS,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,CAAgB,GAAG,eAAe,CAAC,CAAC,CAAC,CAYlG;IAED,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAShD;IAED,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAS3C;IAED,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAStD;IAED,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,QASzE;IAED,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAoBtC;IAED,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAcnD;CACF"}

package/dist/types/src/testing/decorators/withAttention.d.ts

@@ -1,3 +1,7 @@
 import { type Decorator } from '@storybook/react';
-export declare const withAttention: Decorator;
+/**
+ * Storybook decorator that provides attention context.
+ * @param initialAttendedId Optional ID to set as initially attended.
+ */
+export declare const withAttention: (initialAttendedId?: string) => Decorator;
 //# sourceMappingURL=withAttention.d.ts.map

package/dist/types/src/testing/decorators/withAttention.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withAttention.d.ts","sourceRoot":"","sources":["../../../../../src/testing/decorators/withAttention.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAKlD,eAAO,MAAM,aAAa,EAAE,SAE3B,CAAC"}
+{"version":3,"file":"withAttention.d.ts","sourceRoot":"","sources":["../../../../../src/testing/decorators/withAttention.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAMlD;;;GAGG;AACH,eAAO,MAAM,aAAa,uBAAwB,MAAM,KAAG,SAc1D,CAAC"}

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

@@ -0,0 +1,3 @@
+export * from '../attention';
+export * from '../selection';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/index.ts"],"names":[],"mappings":"AAOA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}