@dxos/react-ui-attention 0.10.0 → 0.11.0

package/dist/types/src/components/AttentionProvider/attention-context.d.ts

@@ -0,0 +1,20 @@
+import { type Attention, AttentionManager } from '../../types/Attention';
+export declare const ATTENTION_NAME = "Attention";
+export declare const ATTENTION_SOURCE_ATTRIBUTE = "data-w-attention-source";
+export type AttentionContextValue = {
+    attention: AttentionManager;
+};
+export declare const AttentionContextProvider: import("react").FC<AttentionContextValue & {
+    children: React.ReactNode;
+}>, useAttentionContext: (consumerName: string) => AttentionContextValue;
+export declare const UNKNOWN_ATTENDABLE: Attention;
+/**
+ * Subscribe to the attention state for a qualified graph ID.
+ */
+export declare const useAttention: (attendableId?: string) => Attention;
+export declare const useAttended: () => readonly string[];
+/**
+ * Computes HTML element attributes to apply so the attention system can detect changes.
+ */
+export declare const useAttentionAttributes: (attendableId?: string) => Record<string, string | undefined>;
+//# sourceMappingURL=attention-context.d.ts.map

package/dist/types/src/components/AttentionProvider/attention-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attention-context.d.ts","sourceRoot":"","sources":["../../../../../src/components/AttentionProvider/attention-context.ts"],"names":[],"mappings":"AAOA,OAAO,EAAwB,KAAK,SAAS,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAK/F,eAAO,MAAM,cAAc,cAAc,CAAC;AAC1C,eAAO,MAAM,0BAA0B,4BAA4B,CAAC;AAEpE,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,gBAAgB,CAAC;CAC7B,CAAC;AAEF,eAAO,MAAO,wBAAwB;;IAAE,mBAAmB,iDAEzD,CAAC;AAEH,eAAO,MAAM,kBAAkB,EAAmE,SAAS,CAAC;AAE5G;;GAEG;AAEH,eAAO,MAAM,YAAY,kBAAmB,MAAM,KAAG,SAkBpD,CAAC;AAEF,eAAO,MAAM,WAAW,yBAgBvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,kBAAmB,MAAM,uCAU3D,CAAC"}

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

@@ -1,2 +1,3 @@
+export { useAttended, useAttention, useAttentionAttributes, useAttentionContext } from './attention-context';
 export * from './AttentionProvider';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/AttentionProvider/index.ts"],"names":[],"mappings":"AAIA,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/AttentionProvider/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE7G,cAAc,qBAAqB,CAAC"}

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

@@ -1,31 +1,7 @@
 import React, { type PropsWithChildren } from 'react';
-import { type SelectionMode, type SelectionResult } from '../../selection';
-import { type AspectDef, ViewStateManager } from '../../view-state';
+import { ViewState } from '../../types';
 /** Provides the per-context UI state manager. Replaces the former `SelectionProvider`. */
 export declare const ViewStateProvider: ({ children, manager: managerProp, }: PropsWithChildren<{
-    manager?: ViewStateManager;
+    manager?: ViewState.Manager;
 }>) => React.JSX.Element;
-/** Access the underlying ViewStateManager from context. Throws when used outside a `ViewStateProvider`. */
-export declare const useViewStateManager: () => ViewStateManager;
-/** Access the ViewStateManager if a provider is present; `undefined` otherwise (e.g. isolated stories/tests). */
-export declare const useViewStateManagerOptional: () => ViewStateManager | undefined;
-/** Reactive read of an aspect value for a context; yields the aspect default when unset or unprovided. */
-export declare const useViewState: <T>(aspect: AspectDef<T>, contextId?: string) => T;
-export type UseViewStateActions<T> = {
-    set: (value: T) => void;
-    update: (fn: (prev: T) => T) => void;
-    clear: () => void;
-};
-export declare const useViewStateActions: <T>(aspect: AspectDef<T>, contextId?: string) => UseViewStateActions<T>;
-/** Resolved selection value for `contextId` in the requested `mode` (default `multi`). */
-export declare const useSelection: <T extends SelectionMode>(contextId?: string, mode?: T) => SelectionResult<T>;
-export type UseSelectionActions = {
-    single: (id: string) => void;
-    multi: (ids: string[]) => void;
-    range: (from: string, to: string) => void;
-    toggle: (id: string) => void;
-    clear: () => void;
-};
-/** Selection mutators for a single context, built on the generic ViewState actions. */
-export declare const useSelectionActions: (contextId?: string) => UseSelectionActions;
 //# sourceMappingURL=ViewStateProvider.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ViewStateProvider.d.ts","sourceRoot":"","sources":["../../../../../src/components/ViewStateProvider/ViewStateProvider.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAA4C,MAAM,OAAO,CAAC;AAKhG,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,eAAe,EAIrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,SAAS,EAAE,gBAAgB,EAAyB,MAAM,kBAAkB,CAAC;AAY3F,0FAA0F;AAC1F,eAAO,MAAM,iBAAiB,wCAG3B,iBAAiB,CAAC;IAAE,OAAO,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAAC,sBAOnD,CAAC;AAEF,2GAA2G;AAC3G,eAAO,MAAM,mBAAmB,QAAO,gBAItC,CAAC;AAEF,iHAAiH;AACjH,eAAO,MAAM,2BAA2B,QAAO,gBAAgB,GAAG,SAGjE,CAAC;AAEF,0GAA0G;AAC1G,eAAO,MAAM,YAAY,GAAI,CAAC,UAAW,SAAS,CAAC,CAAC,CAAC,cAAc,MAAM,KAAG,CAc3E,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI;IACnC,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IACxB,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IACrC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,CAAC,UAAW,SAAS,CAAC,CAAC,CAAC,cAAc,MAAM,KAAG,mBAAmB,CAAC,CAAC,CAsBvG,CAAC;AAEF,0FAA0F;AAC1F,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,aAAa,cAAc,MAAM,SAAQ,CAAC,KAAkB,eAAe,CAAC,CAAC,CAClD,CAAC;AAEnE,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC/B,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,mBAAmB,eAAgB,MAAM,KAAG,mBAYxD,CAAC"}
+{"version":3,"file":"ViewStateProvider.d.ts","sourceRoot":"","sources":["../../../../../src/components/ViewStateProvider/ViewStateProvider.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAc,MAAM,OAAO,CAAC;AAKlE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,0FAA0F;AAC1F,eAAO,MAAM,iBAAiB,wCAG3B,iBAAiB,CAAC;IAAE,OAAO,CAAC,EAAE,SAAS,CAAC,OAAO,CAAA;CAAE,CAAC,sBAOpD,CAAC"}

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

@@ -1,2 +1,3 @@
+export { useManager, useManagerOptional, useSelection, useSelectionActions, useViewState, useViewStateActions, } from './view-state-hooks';
 export * from './ViewStateProvider';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/ViewStateProvider/index.ts"],"names":[],"mappings":"AAIA,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/ViewStateProvider/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,cAAc,qBAAqB,CAAC"}

package/dist/types/src/components/ViewStateProvider/view-state-hooks.d.ts

@@ -0,0 +1,32 @@
+import { Selection, ViewState } from '../../types';
+export declare const VIEW_STATE_NAME = "ViewState";
+export type ViewStateContextValue = {
+    manager?: ViewState.Manager;
+};
+export declare const ViewStateContextProvider: import("react").FC<ViewStateContextValue & {
+    children: React.ReactNode;
+}>, useViewStateContext: (consumerName: string) => ViewStateContextValue;
+/** Access the underlying Manager from context. Throws when used outside a `ViewStateProvider`. */
+export declare const useManager: () => ViewState.Manager;
+/** Access the Manager if a provider is present; `undefined` otherwise (e.g. isolated stories/tests). */
+export declare const useManagerOptional: () => ViewState.Manager | undefined;
+/** Reactive read of an aspect value for a context; yields the aspect default when unset or unprovided. */
+export declare const useViewState: <T, Encoded = T>(aspect: ViewState.Aspect<T, Encoded>, contextId?: string) => T;
+export type UseViewStateActions<T> = {
+    set: (value: T) => void;
+    update: (fn: (prev: T) => T) => void;
+    clear: () => void;
+};
+export declare const useViewStateActions: <T, Encoded = T>(aspect: ViewState.Aspect<T, Encoded>, contextId?: string) => UseViewStateActions<T>;
+/** Resolved selection value for `contextId` in the requested `mode` (default `multi`). */
+export declare const useSelection: <T extends Selection.SelectionMode>(contextId?: string, mode?: T) => Selection.Result<T>;
+export type UseSelectionActions = {
+    single: (id: string) => void;
+    multi: (ids: string[]) => void;
+    range: (from: string, to: string) => void;
+    toggle: (id: string) => void;
+    clear: () => void;
+};
+/** Selection mutators for a single context, built on the generic ViewState actions. */
+export declare const useSelectionActions: (contextId?: string) => UseSelectionActions;
+//# sourceMappingURL=view-state-hooks.d.ts.map

package/dist/types/src/components/ViewStateProvider/view-state-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-state-hooks.d.ts","sourceRoot":"","sources":["../../../../../src/components/ViewStateProvider/view-state-hooks.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAKnD,eAAO,MAAM,eAAe,cAAc,CAAC;AAE3C,MAAM,MAAM,qBAAqB,GAAG;IAAE,OAAO,CAAC,EAAE,SAAS,CAAC,OAAO,CAAA;CAAE,CAAC;AAIpE,eAAO,MAAO,wBAAwB;;IAAE,mBAAmB,iDAEzD,CAAC;AAEH,kGAAkG;AAClG,eAAO,MAAM,UAAU,QAAO,SAAS,CAAC,OAIvC,CAAC;AAEF,wGAAwG;AACxG,eAAO,MAAM,kBAAkB,QAAO,SAAS,CAAC,OAAO,GAAG,SAGzD,CAAC;AAEF,0GAA0G;AAC1G,eAAO,MAAM,YAAY,GAAI,CAAC,EAAE,OAAO,GAAG,CAAC,UAAU,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,cAAc,MAAM,KAAG,CAcvG,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI;IACnC,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IACxB,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IACrC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,CAAC,EAAE,OAAO,GAAG,CAAC,UACxC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,cACxB,MAAM,KACjB,mBAAmB,CAAC,CAAC,CAsBvB,CAAC;AAEF,0FAA0F;AAC1F,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,SAAS,CAAC,aAAa,cAChD,MAAM,SACZ,CAAC,KACN,SAAS,CAAC,MAAM,CAAC,CAAC,CAAuE,CAAC;AAE7F,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC/B,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,mBAAmB,eAAgB,MAAM,KAAG,mBAYxD,CAAC"}

package/dist/types/src/core/backends.d.ts

@@ -0,0 +1,24 @@
+import { Atom, type Registry } from '@effect-atom/atom';
+import { ViewState } from '../types';
+/** In-memory backend: state is ephemeral and scoped to the session (never persisted). */
+export declare class MemoryBackend implements ViewState.Backend {
+    #private;
+    atom<T, Encoded>(aspect: ViewState.Aspect<T, Encoded>, contextId: string): Atom.Writable<T>;
+    contexts<T, Encoded>(aspect: ViewState.Aspect<T, Encoded>): string[];
+}
+export interface LocalBackendOptions {
+    readonly registry: Registry.Registry;
+    /** Injectable for tests; defaults to `window.localStorage`. */
+    readonly storage?: Storage;
+}
+/** localStorage-backed backend: seeds atoms from storage, persists on set, syncs across tabs. */
+export declare class LocalBackend implements ViewState.Backend {
+    #private;
+    constructor({ registry, storage }: LocalBackendOptions);
+    atom<T, Encoded>(aspect: ViewState.Aspect<T, Encoded>, contextId: string): Atom.Writable<T>;
+    persist<T, Encoded>(aspect: ViewState.Aspect<T, Encoded>, contextId: string, value: T): void;
+    contexts<T, Encoded>(aspect: ViewState.Aspect<T, Encoded>): string[];
+    dispose(): void;
+}
+export declare const createDefaultBackends: (registry: Registry.Registry) => Record<ViewState.BackendName, ViewState.Backend>;
+//# sourceMappingURL=backends.d.ts.map

package/dist/types/src/core/backends.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backends.d.ts","sourceRoot":"","sources":["../../../../src/core/backends.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAKrC,yFAAyF;AACzF,qBAAa,aAAc,YAAW,SAAS,CAAC,OAAO;;IAGrD,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAY1F;IAED,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAGnE;CACF;AAgBD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACrC,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,iGAAiG;AACjG,qBAAa,YAAa,YAAW,SAAS,CAAC,OAAO;;IAUpD,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,mBAAmB,EAgBrD;IAED,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAe1F;IAED,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAE3F;IAED,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAenE;IAED,OAAO,IAAI,IAAI,CAOd;CAcF;AAED,eAAO,MAAM,qBAAqB,aACtB,QAAQ,CAAC,QAAQ,KAC1B,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,OAAO,CAGhD,CAAC"}

package/dist/types/src/core/backends.test.d.ts.map

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"useArticleKeyboardNavigation.d.ts","sourceRoot":"","sources":["../../../../src/hooks/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;CAqD7F,CAAC"}

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

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

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

@@ -1,6 +1,5 @@
-export * from './attention';
 export * from './components';
-export * from './selection';
-export * from './useArticleKeyboardNavigation';
-export * from './view-state';
+export * from './core';
+export * from './hooks';
+export * from './types';
 //# 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;AAC5B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

package/dist/types/src/{attention.d.ts → types/Attention.d.ts}

@@ -1,4 +1,4 @@
-import { Atom, type Registry } from '@effect-atom/atom-react';
+import { Atom, type Registry } from '@effect-atom/atom';
 export type Attention = {
     hasAttention: boolean;
     isAncestor: boolean;
@@ -40,11 +40,22 @@ export declare class AttentionManager {
     private _getAtom;
     private _set;
 }
+/** The attribute marking an element as attendable, carrying its qualified id. */
+export declare const ATTENDABLE_ATTRIBUTE = "data-attendable-id";
+/** Selector matching any attendable element. */
+export declare const ATTENDABLE_SELECTOR = "[data-attendable-id]";
 /**
  * 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[];
+/**
+ * The outermost attendable ancestor of `element` — the root of any nested attendables (e.g. a section
+ * within a stack). Structural (real DOM ancestry), so it is independent of what currently has attention.
+ * Resolve it from an in-DOM element: a portaled subtree (a menu, a popover) is not under its own
+ * attendable, so walk from the trigger or anchor instead.
+ */
+export declare const getRootAttendableId: (element: Element) => string | undefined;
 export type AttendableId = {
     attendableId?: string;
 };
@@ -80,4 +91,4 @@ export declare const getParentId: (qualifiedId: string | undefined) => string |
  * Extract the segment ID (last segment) of a qualified ID.
  */
 export declare const getSegmentId: (qualifiedId: string) => string;
-//# sourceMappingURL=attention.d.ts.map
+//# sourceMappingURL=Attention.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Attention.d.ts","sourceRoot":"","sources":["../../../../src/types/Attention.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAExD,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,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AAEzD,gDAAgD;AAChD,eAAO,MAAM,mBAAmB,yBAA8B,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,cAAc,aAAc,MAAM,UAAU,OAAO,QAAO,MAAM,EAAE,KAAQ,MAAM,EAoB5F,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,YAAa,OAAO,KAAG,MAAM,GAAG,SACX,CAAC;AAEtD,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/types/Attention.test.d.ts

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

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

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

package/dist/types/src/{selection.d.ts → types/Selection.d.ts}

@@ -1,7 +1,7 @@
 import * as Schema from 'effect/Schema';
-import { type AspectDef, type ViewStateManager } from './view-state';
+import { type Aspect, type Manager } from './ViewState';
 export type SelectionMode = 'single' | 'multi' | 'range' | 'multi-range';
-export declare const SelectionSchema: Schema.mutable<Schema.Union<[Schema.mutable<Schema.Struct<{
+export declare const Selection: Schema.mutable<Schema.Union<[Schema.mutable<Schema.Struct<{
     mode: Schema.Literal<["single"]>;
     id: Schema.optional<typeof Schema.String>;
 }>>, Schema.mutable<Schema.Struct<{
@@ -18,8 +18,8 @@ export declare const SelectionSchema: Schema.mutable<Schema.Union<[Schema.mutabl
         to: typeof Schema.String;
     }>>>;
 }>>]>>;
-export type Selection = Schema.Schema.Type<typeof SelectionSchema>;
-export declare const defaultSelection: (u: SelectionMode) => {
+export type Selection = Schema.Schema.Type<typeof Selection>;
+export declare const defaultValue: (u: SelectionMode) => {
     mode: "single";
 } | {
     mode: "multi";
@@ -30,7 +30,7 @@ export declare const defaultSelection: (u: SelectionMode) => {
     mode: "multi-range";
     ranges: never[];
 };
-export type SelectionResult<T extends SelectionMode> = T extends 'single' ? string | undefined : T extends 'multi' ? string[] : T extends 'range' ? {
+export type Result<T extends SelectionMode> = T extends 'single' ? string | undefined : T extends 'multi' ? string[] : T extends 'range' ? {
     from: string;
     to: string;
 } | undefined : T extends 'multi-range' ? {
@@ -38,14 +38,16 @@ export type SelectionResult<T extends SelectionMode> = T extends 'single' ? stri
     to: string;
 }[] : never;
 /** Selection state for a context, stored in memory (ephemeral, per-device session). */
-export declare const selectionAspect: AspectDef<Selection>;
+export declare const aspect: Aspect<Selection>;
 /**
  * Extract the typed result for `mode` from a stored selection value, returning the requested
  * mode's default when the stored value is absent or holds a different mode.
  */
-export declare const resolveSelection: <T extends SelectionMode>(selection: Selection | undefined, mode: T) => SelectionResult<T>;
+export declare const resolve: <T extends SelectionMode>(selection: Selection | undefined, mode: T) => Result<T>;
 /** Toggle `id` within a multi selection; resets to a multi selection if the current value differs. */
-export declare const toggleSelection: (selection: Selection | undefined, id: string) => Selection;
+export declare const toggle: (selection: Selection | undefined, id: string) => Selection;
+/** Anchor strings for a selection: ids for single/multi modes, `"${from}:${to}"` cursor pairs for range modes. */
+export declare const toAnchors: (selection: Selection | undefined) => string[];
 /** Union of all multi-selected ids across every selection context, plus an optional explicit id. */
-export declare const getSelectionSet: (manager: ViewStateManager, contextId?: string) => Set<string>;
-//# sourceMappingURL=selection.d.ts.map
+export declare const getValue: (manager: Manager, contextId?: string) => Set<string>;
+//# sourceMappingURL=Selection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Selection.d.ts","sourceRoot":"","sources":["../../../../src/types/Selection.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,OAAO,EAAU,MAAM,aAAa,CAAC;AAEhE,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,aAAa,CAAC;AAEzE,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;MAkBA,CAAC;AAEvB,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC,CAAC;AAE7D,eAAO,MAAM,YAAY;;;;;;;;;;CAOxB,CAAC;AAEF,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,aAAa,IAAI,CAAC,SAAS,QAAQ,GAC5D,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,uFAAuF;AACvF,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,SAAS,CAKnC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,OAAO,GAAI,CAAC,SAAS,aAAa,aAAa,SAAS,GAAG,SAAS,QAAQ,CAAC,KAAG,MAAM,CAAC,CAAC,CAUpG,CAAC;AAEF,sGAAsG;AACtG,eAAO,MAAM,MAAM,cAAe,SAAS,GAAG,SAAS,MAAM,MAAM,KAAG,SAGrE,CAAC;AAEF,kHAAkH;AAClH,eAAO,MAAM,SAAS,cAAe,SAAS,GAAG,SAAS,KAAG,MAAM,EASjD,CAAC;AAEnB,oGAAoG;AACpG,eAAO,MAAM,QAAQ,YAAa,OAAO,cAAc,MAAM,KAAG,GAAG,CAAC,MAAM,CAYzE,CAAC"}

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

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

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

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

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

@@ -0,0 +1,66 @@
+import { type Atom, type Registry } from '@effect-atom/atom';
+import type * as Schema from 'effect/Schema';
+/**
+ * Persistence backend identifier. `personal` (ECHO/personal-space) is reserved for a future backend.
+ */
+export type BackendName = 'memory' | 'local';
+/**
+ * Declares a kind of per-context UI state. The value type `T` and its persisted wire type `Encoded`
+ * are inferred from the schema; `Encoded` defaults to `T` for the common no-transform case.
+ */
+export interface Aspect<T, Encoded = T> {
+    readonly key: string;
+    readonly backend: BackendName;
+    readonly schema: Schema.Schema<T, Encoded>;
+    readonly defaultValue: () => T;
+}
+/**
+ * Identity helper that pins the value type from the schema while keeping the literal `key`/`backend`.
+ * Declares an aspect of per-context UI state (selection, scroll, view mode, split) read/written via
+ * {@link Manager} — through `useViewState`/`useViewStateActions` in React or the
+ * `AttentionCapabilities.ViewState` capability in operations. Durability is the `backend`'s: `local`
+ * survives reloads (best-effort — degrades to in-memory when storage is blocked), `memory` is
+ * session-only.
+ *
+ * @idiom org.dxos.react-ui-attention.viewState
+ *   applies: Holding per-context UI state (selection, view mode, scroll, split) that survives navigation (and reloads with the `local` backend)
+ *   instead-of: ad-hoc `useState` that resets on remount, or stuffing per-context state into the plugin Settings store
+ *   uses: {@link define}, {@link Manager}
+ *   related: org.dxos.effect.kvsStore
+ */
+export declare const define: <T, Encoded = T>(def: Aspect<T, Encoded>) => Aspect<T, Encoded>;
+/**
+ * A backend produces a reactive, writable atom for each `(aspect, contextId)` pair. Backends may
+ * hydrate asynchronously (an ECHO backend would), yielding `aspect.defaultValue()` until loaded;
+ * the memory and local backends resolve synchronously.
+ */
+export interface Backend {
+    /** Stable atom for the pair; created (and seeded) on first access, cached thereafter. */
+    atom: <T, Encoded>(aspect: Aspect<T, Encoded>, contextId: string) => Atom.Writable<T>;
+    /** Persist a value after the atom is updated. No-op for in-memory backends. */
+    persist?: <T, Encoded>(aspect: Aspect<T, Encoded>, contextId: string, value: T) => void;
+    /** Context ids that currently hold a value for the aspect. */
+    contexts: <T, Encoded>(aspect: Aspect<T, Encoded>) => string[];
+    /** Release listeners/timers (used by tests; app-lifetime managers do not call this). */
+    dispose?: () => void;
+}
+export interface ManagerOptions {
+    readonly registry: Registry.Registry;
+    readonly backends: Record<BackendName, Backend>;
+}
+/**
+ * Routes per-context UI state to the backend declared by each aspect. Reads/writes go through the
+ * effect-atom registry so React hooks and graph atoms observe changes uniformly.
+ */
+export declare class Manager {
+    #private;
+    constructor({ registry, backends }: ManagerOptions);
+    /** Reactive atom for `(aspect, contextId)`; pass to `registry.get` inside derived atoms/hooks. */
+    atom<T, Encoded>(aspect: Aspect<T, Encoded>, contextId: string): Atom.Writable<T>;
+    get<T, Encoded>(aspect: Aspect<T, Encoded>, contextId: string): T;
+    set<T, Encoded>(aspect: Aspect<T, Encoded>, contextId: string, value: T): void;
+    update<T, Encoded>(aspect: Aspect<T, Encoded>, contextId: string, fn: (prev: T) => T): void;
+    subscribe<T, Encoded>(aspect: Aspect<T, Encoded>, contextId: string, cb: (value: T) => void): () => void;
+    contexts<T, Encoded>(aspect: Aspect<T, Encoded>): string[];
+}
+//# sourceMappingURL=ViewState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ViewState.d.ts","sourceRoot":"","sources":["../../../../src/types/ViewState.ts"],"names":[],"mappings":"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"}

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

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

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

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

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

@@ -1,4 +1,4 @@
-export * from '../attention';
-export * from '../selection';
-export * from '../view-state';
+export * as Attention from './Attention';
+export * as Selection from './Selection';
+export * as ViewState from './ViewState';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/index.ts"],"names":[],"mappings":"AAOA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC"}