@dxos/react-ui-attention 0.8.4-main.fd6878d → 0.8.4-staging.60fe92afc8

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

@@ -1,12 +1,29 @@
 import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
 import {
-  RootAttentionProvider
-} from "../chunk-V2PNA7ZV.mjs";
+  RootAttentionProvider,
+  SelectionProvider
+} from "../chunk-ZTUVSH4P.mjs";
+import {
+  AttentionManager
+} from "../chunk-6INLBC62.mjs";
 
 // src/testing/decorators/withAttention.ts
-import { createElement } from "react";
-var withAttention = (Story) => {
-  return createElement(RootAttentionProvider, {}, createElement(Story));
+import { Registry, RegistryContext } from "@effect-atom/atom-react";
+import { createElement, useMemo } from "react";
+var withAttention = (initialAttendedId) => {
+  return (Story) => {
+    const registry = useMemo(() => Registry.make(), []);
+    const attention = useMemo(() => initialAttendedId ? new AttentionManager(registry, [
+      initialAttendedId
+    ]) : void 0, [
+      registry
+    ]);
+    return createElement(RegistryContext.Provider, {
+      value: registry
+    }, createElement(RootAttentionProvider, {
+      attention
+    }, createElement(SelectionProvider, {}, createElement(Story))));
+  };
 };
 export {
   withAttention

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/testing/decorators/withAttention.ts"],
-  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport { type Decorator } from '@storybook/react';\nimport { createElement } from 'react';\n\nimport { RootAttentionProvider } from '../../components';\n\nexport const withAttention: Decorator = (Story) => {\n  return createElement(RootAttentionProvider, {}, createElement(Story));\n};\n"],
-  "mappings": ";;;;;;AAKA,SAASA,qBAAqB;AAIvB,IAAMC,gBAA2B,CAACC,UAAAA;AACvC,SAAOC,cAAcC,uBAAuB,CAAC,GAAGD,cAAcD,KAAAA,CAAAA;AAChE;",
-  "names": ["createElement", "withAttention", "Story", "createElement", "RootAttentionProvider"]
+  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport { Registry, RegistryContext } from '@effect-atom/atom-react';\nimport { type Decorator } from '@storybook/react';\nimport { createElement, useMemo } from 'react';\n\nimport { AttentionManager } from '../../attention';\nimport { RootAttentionProvider, SelectionProvider } from '../../components';\n\n/**\n * Storybook decorator that provides attention context.\n * @param initialAttendedId Optional ID to set as initially attended.\n */\nexport const withAttention = (initialAttendedId?: string): Decorator => {\n  return (Story) => {\n    const registry = useMemo(() => Registry.make(), []);\n    const attention = useMemo(\n      () => (initialAttendedId ? new AttentionManager(registry, [initialAttendedId]) : undefined),\n      [registry],\n    );\n\n    return createElement(\n      RegistryContext.Provider,\n      { value: registry },\n      createElement(RootAttentionProvider, { attention }, createElement(SelectionProvider, {}, createElement(Story))),\n    );\n  };\n};\n"],
+  "mappings": ";;;;;;;;;;AAIA,SAASA,UAAUC,uBAAuB;AAE1C,SAASC,eAAeC,eAAe;AAShC,IAAMC,gBAAgB,CAACC,sBAAAA;AAC5B,SAAO,CAACC,UAAAA;AACN,UAAMC,WAAWC,QAAQ,MAAMC,SAASC,KAAI,GAAI,CAAA,CAAE;AAClD,UAAMC,YAAYH,QAChB,MAAOH,oBAAoB,IAAIO,iBAAiBL,UAAU;MAACF;KAAkB,IAAIQ,QACjF;MAACN;KAAS;AAGZ,WAAOO,cACLC,gBAAgBC,UAChB;MAAEC,OAAOV;IAAS,GAClBO,cAAcI,uBAAuB;MAAEP;IAAU,GAAGG,cAAcK,mBAAmB,CAAC,GAAGL,cAAcR,KAAAA,CAAAA,CAAAA,CAAAA;EAE3G;AACF;",
+  "names": ["Registry", "RegistryContext", "createElement", "useMemo", "withAttention", "initialAttendedId", "Story", "registry", "useMemo", "Registry", "make", "attention", "AttentionManager", "undefined", "createElement", "RegistryContext", "Provider", "value", "RootAttentionProvider", "SelectionProvider"]
 }

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

@@ -0,0 +1,30 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+import {
+  AttentionManager,
+  SelectionManager,
+  SelectionSchema,
+  defaultSelection,
+  expandAttendableId,
+  getAttendables,
+  getLinkedVariant,
+  getParentId,
+  getSegmentId,
+  getSelectionSet,
+  isLinkedSegment,
+  linkedSegment
+} from "../chunk-6INLBC62.mjs";
+export {
+  AttentionManager,
+  SelectionManager,
+  SelectionSchema,
+  defaultSelection,
+  expandAttendableId,
+  getAttendables,
+  getLinkedVariant,
+  getParentId,
+  getSegmentId,
+  getSelectionSet,
+  isLinkedSegment,
+  linkedSegment
+};
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

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/AttentionGlyph.stories.d.ts

@@ -0,0 +1,16 @@
+import { type StoryObj } from '@storybook/react-vite';
+import React from 'react';
+import { type AttentionGlyphProps } from './AttentionGlyph';
+declare const meta: {
+    title: string;
+    component: any;
+    render: (props: AttentionGlyphProps) => React.JSX.Element;
+    decorators: import("@storybook/react").Decorator[];
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const Default: Story;
+export declare const Attention: Story;
+export declare const Contains: Story;
+export declare const Syncing: Story;
+//# sourceMappingURL=AttentionGlyph.stories.d.ts.map

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/AttentionProvider.stories.d.ts

@@ -0,0 +1,12 @@
+import { type StoryObj } from '@storybook/react-vite';
+import React from 'react';
+declare const Story: () => React.JSX.Element;
+declare const meta: {
+    title: string;
+    render: () => React.JSX.Element;
+    decorators: import("@storybook/react").Decorator[];
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const Default: Story;
+//# sourceMappingURL=AttentionProvider.stories.d.ts.map

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/index.d.ts

@@ -1,4 +1,5 @@
 export * from './attention';
 export * from './components';
 export * from './selection';
+export * from './useArticleKeyboardNavigation';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gCAAgC,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"}

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

@@ -0,0 +1,42 @@
+/**
+ * Compute the id to select after pressing 'j' (delta = 1) or 'k' (delta = -1).
+ * Clamps at the list ends — pressing 'j' on the last item keeps the last item
+ * selected (vim-style), and 'k' on the first item keeps the first.
+ *
+ * When no current selection exists, returns the first id (for delta = 1) or the
+ * last id (for delta = -1) so the user can enter the list with either key.
+ */
+export declare const advance: ({ ids, currentId, delta, }: {
+    ids: readonly string[];
+    currentId: string | undefined;
+    delta: 1 | -1;
+}) => string | undefined;
+export type UseArticleKeyboardNavigationOptions<T> = {
+    /** Stable id for the article (used as the keyboard context path). */
+    articleId: string;
+    /** Ordered list of selectable items as they appear in the article. */
+    items: readonly T[];
+    /** Currently-selected id, if any. */
+    currentId: string | undefined;
+    /** Extracts the id from an item. Defaults to `item.id`. */
+    getId?: (item: T) => string;
+    /** Called with the id to select when the user presses 'j' or 'k'. */
+    onSelect: (id: string) => void;
+};
+/**
+ * Wire 'j' (next) and 'k' (previous) keyboard shortcuts for an article that
+ * navigates a list of items (e.g., messages, events). Bindings are scoped to
+ * the article's keyboard context so they only fire while the article has attention.
+ *
+ * Pass the items directly; ids are derived via `getId` (defaults to `item.id`).
+ * Clamps at list boundaries. Active only when the article is attended.
+ */
+export declare const useArticleKeyboardNavigation: {
+    <T extends {
+        id: string;
+    }>(options: UseArticleKeyboardNavigationOptions<T>): void;
+    <T>(options: UseArticleKeyboardNavigationOptions<T> & {
+        getId: (item: T) => string;
+    }): void;
+};
+//# sourceMappingURL=useArticleKeyboardNavigation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useArticleKeyboardNavigation.d.ts","sourceRoot":"","sources":["../../../src/useArticleKeyboardNavigation.ts"],"names":[],"mappings":"AAUA;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,+BAIjB;IACD,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACf,KAAG,MAAM,GAAG,SAYZ,CAAC;AAEF,MAAM,MAAM,mCAAmC,CAAC,CAAC,IAAI;IACnD,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;IACpB,qCAAqC;IACrC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,2DAA2D;IAC3D,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAC5B,qEAAqE;IACrE,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,EAAE;IACzC,CAAC,CAAC,SAAS;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,OAAO,EAAE,mCAAmC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAClF,CAAC,CAAC,EAAE,OAAO,EAAE,mCAAmC,CAAC,CAAC,CAAC,GAAG;QAAE,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAoD7F,CAAC"}

package/dist/types/src/useArticleKeyboardNavigation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=useArticleKeyboardNavigation.test.d.ts.map

package/dist/types/src/useArticleKeyboardNavigation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useArticleKeyboardNavigation.test.d.ts","sourceRoot":"","sources":["../../../src/useArticleKeyboardNavigation.test.ts"],"names":[],"mappings":""}