@dxos/react-ui-attention 0.10.0 → 0.11.0

package/dist/lib/chunk-types.mjs

@@ -0,0 +1,351 @@
+import { Atom } from "@effect-atom/atom";
+import * as Match from "effect/Match";
+import * as Schema from "effect/Schema";
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+//#region src/types/Attention.ts
+var Attention_exports = /* @__PURE__ */ __exportAll({
+	ATTENDABLE_ATTRIBUTE: () => ATTENDABLE_ATTRIBUTE,
+	ATTENDABLE_SELECTOR: () => ATTENDABLE_SELECTOR,
+	AttentionManager: () => AttentionManager,
+	expandAttendableId: () => expandAttendableId,
+	getAttendables: () => getAttendables,
+	getLinkedVariant: () => getLinkedVariant,
+	getParentId: () => getParentId,
+	getRootAttendableId: () => getRootAttendableId,
+	getSegmentId: () => getSegmentId,
+	isLinkedSegment: () => isLinkedSegment,
+	linkedSegment: () => linkedSegment
+});
+/**
+* Manages attention state for an application.
+* Attention keys are slash-qualified graph IDs; ancestry is derived from progressive prefixes.
+*/
+var AttentionManager = class {
+	_registry;
+	_map = /* @__PURE__ */ new Map();
+	_currentAtom;
+	constructor(_registry, initial = []) {
+		this._registry = _registry;
+		this._currentAtom = Atom.make([]).pipe(Atom.keepAlive);
+		if (initial.length > 0) this.update(initial);
+	}
+	/**
+	* Atom for the currently attended element IDs.
+	*/
+	get current() {
+		return this._currentAtom;
+	}
+	/**
+	* Gets the currently attended element IDs.
+	*/
+	getCurrent() {
+		return this._registry.get(this._currentAtom);
+	}
+	/**
+	* Subscribe to changes in the current attention IDs.
+	*/
+	subscribeCurrent(cb) {
+		this._registry.get(this._currentAtom);
+		return this._registry.subscribe(this._currentAtom, () => {
+			cb(this._registry.get(this._currentAtom));
+		});
+	}
+	/**
+	* All tracked qualified IDs.
+	*/
+	keys() {
+		return Array.from(this._map.keys());
+	}
+	/**
+	* Get the attention state for a given qualified ID.
+	*/
+	get(id) {
+		const atom = this._getAtom(id);
+		return this._registry.get(atom);
+	}
+	/**
+	* Subscribe to changes in the attention state for a given qualified ID.
+	*/
+	subscribe(id, cb) {
+		const atom = this._getAtom(id);
+		this._registry.get(atom);
+		return this._registry.subscribe(atom, () => {
+			cb(this._registry.get(atom));
+		});
+	}
+	_getAtom(id) {
+		const existing = this._map.get(id);
+		if (existing) return existing;
+		const newAtom = Atom.make({
+			hasAttention: false,
+			isAncestor: false,
+			isRelated: false
+		}).pipe(Atom.keepAlive);
+		this._map.set(id, newAtom);
+		return newAtom;
+	}
+	/**
+	* Update the currently attended element.
+	* Takes the array of qualified IDs collected from the DOM; the first element is the primary attended item.
+	* Ancestry is derived from the progressive prefixes of the primary ID.
+	* Relatedness is derived from the segment ID: any tracked key whose last `/` segment matches the
+	* attended ID's segment ID is marked `isRelated`. Additionally, if the primary ID is a linked segment
+	* (starts with `~`), its immediate parent gets `isRelated` alongside `isAncestor`.
+	*
+	* @internal
+	*/
+	update(nextIds) {
+		const primaryId = nextIds[0];
+		if (!primaryId) return;
+		const prevPrimaryId = this.getCurrent()[0];
+		if (prevPrimaryId) {
+			const prevPrefixes = expandAttendableId(prevPrimaryId);
+			for (const prefix of prevPrefixes) this._set(prefix, {});
+			const prevSegmentId = getSegmentId(prevPrimaryId);
+			for (const key of this.keys()) if (getSegmentId(key) === prevSegmentId) this._set(key, {});
+		}
+		this._registry.set(this._currentAtom, nextIds);
+		const prefixes = expandAttendableId(primaryId);
+		const prefixSet = new Set(prefixes);
+		const linkedParent = isLinkedSegment(primaryId) ? getParentId(primaryId) : void 0;
+		for (const prefix of prefixes) if (prefix === primaryId) this._set(prefix, { hasAttention: true });
+		else if (prefix === linkedParent) this._set(prefix, {
+			isAncestor: true,
+			isRelated: true
+		});
+		else this._set(prefix, { isAncestor: true });
+		const segmentId = getSegmentId(primaryId);
+		for (const key of this.keys()) if (!prefixSet.has(key) && getSegmentId(key) === segmentId) this._set(key, { isRelated: true });
+	}
+	_set(id, attention) {
+		const atom = this._getAtom(id);
+		this._registry.set(atom, {
+			hasAttention: attention.hasAttention ?? false,
+			isAncestor: attention.isAncestor ?? false,
+			isRelated: attention.isRelated ?? false
+		});
+	}
+};
+/** The attribute marking an element as attendable, carrying its qualified id. */
+var ATTENDABLE_ATTRIBUTE = "data-attendable-id";
+/** Selector matching any attendable element. */
+var ATTENDABLE_SELECTOR = `[${ATTENDABLE_ATTRIBUTE}]`;
+/**
+* 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).
+*/
+var getAttendables = (selector, cursor, acc = []) => {
+	const closestAttendable = cursor.closest(selector);
+	if (closestAttendable) {
+		const attendableId = closestAttendable.getAttribute(ATTENDABLE_ATTRIBUTE);
+		if (!attendableId) {
+			const trigger = document.querySelector(`[aria-controls="${closestAttendable.getAttribute("id")}"]`);
+			if (!trigger) return acc;
+			else return getAttendables(selector, trigger, acc);
+		} else {
+			acc.push(attendableId);
+			return !closestAttendable.parentElement ? acc : getAttendables(selector, closestAttendable.parentElement, acc);
+		}
+	}
+	return [...new Set(acc)];
+};
+/**
+* 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.
+*/
+var getRootAttendableId = (element) => getAttendables(ATTENDABLE_SELECTOR, element).at(-1);
+/**
+* Prefix for linked segments. A linked segment's attention state is shared with its parent:
+* when a linked node has attention, the parent is marked as both ancestor and related.
+*/
+var LINKED_PREFIX = "~";
+/**
+* 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']`.
+*/
+var expandAttendableId = (qualifiedId) => {
+	const segments = qualifiedId.split("/");
+	return segments.map((_, index) => segments.slice(0, index + 1).join("/"));
+};
+/**
+* Whether the last segment of a qualified ID is a linked segment (starts with `~`).
+* Linked segments share their attention state with the parent node.
+*/
+var isLinkedSegment = (qualifiedId) => {
+	return (qualifiedId.split("/").pop() ?? "").startsWith(LINKED_PREFIX);
+};
+/**
+* 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.
+*/
+var linkedSegment = (variant) => `${LINKED_PREFIX}${variant}`;
+/**
+* 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.
+*/
+var getLinkedVariant = (qualifiedId) => {
+	const lastSegment = qualifiedId.split("/").pop() ?? "";
+	return lastSegment.startsWith(LINKED_PREFIX) ? lastSegment.slice(1) : lastSegment;
+};
+/**
+* Get the parent qualified ID (everything before the last `/` segment).
+*/
+var getParentId = (qualifiedId) => {
+	if (!qualifiedId) return;
+	const lastSlash = qualifiedId.lastIndexOf("/");
+	return lastSlash > 0 ? qualifiedId.slice(0, lastSlash) : void 0;
+};
+/**
+* Extract the segment ID (last segment) of a qualified ID.
+*/
+var getSegmentId = (qualifiedId) => {
+	return qualifiedId.split("/").pop() ?? qualifiedId;
+};
+//#endregion
+//#region src/types/ViewState.ts
+var ViewState_exports = /* @__PURE__ */ __exportAll({
+	Manager: () => Manager,
+	define: () => define
+});
+/**
+* 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
+*/
+var define = (def) => def;
+/**
+* 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.
+*/
+var Manager = class {
+	#registry;
+	#backends;
+	constructor({ registry, backends }) {
+		this.#registry = registry;
+		this.#backends = backends;
+	}
+	/** Reactive atom for `(aspect, contextId)`; pass to `registry.get` inside derived atoms/hooks. */
+	atom(aspect, contextId) {
+		return this.#backends[aspect.backend].atom(aspect, contextId);
+	}
+	get(aspect, contextId) {
+		return this.#registry.get(this.atom(aspect, contextId));
+	}
+	set(aspect, contextId, value) {
+		const backend = this.#backends[aspect.backend];
+		this.#registry.set(backend.atom(aspect, contextId), value);
+		backend.persist?.(aspect, contextId, value);
+	}
+	update(aspect, contextId, fn) {
+		this.set(aspect, contextId, fn(this.get(aspect, contextId)));
+	}
+	subscribe(aspect, contextId, cb) {
+		const atom = this.atom(aspect, contextId);
+		return this.#registry.subscribe(atom, () => cb(this.#registry.get(atom)));
+	}
+	contexts(aspect) {
+		return this.#backends[aspect.backend].contexts(aspect);
+	}
+};
+//#endregion
+//#region src/types/Selection.ts
+var Selection_exports = /* @__PURE__ */ __exportAll({
+	Selection: () => Selection,
+	aspect: () => aspect,
+	defaultValue: () => defaultValue,
+	getValue: () => getValue,
+	resolve: () => resolve,
+	toAnchors: () => toAnchors,
+	toggle: () => toggle
+});
+var Selection = Schema.Union(Schema.Struct({
+	mode: Schema.Literal("single"),
+	id: Schema.optional(Schema.String)
+}).pipe(Schema.mutable), Schema.Struct({
+	mode: Schema.Literal("multi"),
+	ids: Schema.Array(Schema.String).pipe(Schema.mutable)
+}).pipe(Schema.mutable), Schema.Struct({
+	mode: Schema.Literal("range"),
+	from: Schema.optional(Schema.String),
+	to: Schema.optional(Schema.String)
+}).pipe(Schema.mutable), Schema.Struct({
+	mode: Schema.Literal("multi-range"),
+	ranges: Schema.Array(Schema.Struct({
+		from: Schema.String,
+		to: Schema.String
+	})).pipe(Schema.mutable)
+}).pipe(Schema.mutable)).pipe(Schema.mutable);
+var defaultValue = Match.type().pipe(Match.withReturnType(), Match.when("single", () => ({ mode: "single" })), Match.when("multi", () => ({
+	mode: "multi",
+	ids: []
+})), Match.when("range", () => ({ mode: "range" })), Match.when("multi-range", () => ({
+	mode: "multi-range",
+	ranges: []
+})), Match.exhaustive);
+/** Selection state for a context, stored in memory (ephemeral, per-device session). */
+var aspect = define({
+	key: "selection",
+	backend: "memory",
+	schema: Selection,
+	defaultValue: () => ({
+		mode: "multi",
+		ids: []
+	})
+});
+/**
+* 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.
+*/
+var resolve = (selection, mode) => {
+	const value = selection?.mode === mode ? selection : defaultValue(mode);
+	return Match.type().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
+	} : void 0), Match.when({ mode: "multi-range" }, (s) => s.ranges), Match.exhaustive)(value);
+};
+/** Toggle `id` within a multi selection; resets to a multi selection if the current value differs. */
+var toggle = (selection, id) => {
+	const ids = selection?.mode === "multi" ? selection.ids : [];
+	return {
+		mode: "multi",
+		ids: ids.includes(id) ? ids.filter((existing) => existing !== id) : [...ids, id]
+	};
+};
+/** Anchor strings for a selection: ids for single/multi modes, `"${from}:${to}"` cursor pairs for range modes. */
+var toAnchors = (selection) => selection == null ? [] : Match.type().pipe(Match.when({ mode: "single" }, (value) => value.id ? [value.id] : []), Match.when({ mode: "multi" }, (value) => [...value.ids]), Match.when({ mode: "range" }, (value) => value.from && value.to ? [`${value.from}:${value.to}`] : []), Match.when({ mode: "multi-range" }, (value) => value.ranges.map((range) => `${range.from}:${range.to}`)), Match.exhaustive)(selection);
+/** Union of all multi-selected ids across every selection context, plus an optional explicit id. */
+var getValue = (manager, contextId) => {
+	const ids = new Set(contextId ? [contextId] : []);
+	for (const context of manager.contexts(aspect)) {
+		const selection = manager.get(aspect, context);
+		if (selection.mode === "multi") for (const id of selection.ids) ids.add(id);
+	}
+	return ids;
+};
+//#endregion
+export { Manager as a, ATTENDABLE_SELECTOR as c, getAttendables as d, toggle as i, AttentionManager as l, aspect as n, ViewState_exports as o, resolve as r, ATTENDABLE_ATTRIBUTE as s, Selection_exports as t, Attention_exports as u };
+
+//# sourceMappingURL=chunk-types.mjs.map

package/dist/lib/chunk-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-types.mjs","names":[],"sources":["../../src/types/Attention.ts","../../src/types/ViewState.ts","../../src/types/Selection.ts"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport { Atom, type Registry } from '@effect-atom/atom';\n\nexport type Attention = {\n  hasAttention: boolean;\n  isAncestor: boolean;\n  isRelated: boolean;\n};\n\n/**\n * Manages attention state for an application.\n * Attention keys are slash-qualified graph IDs; ancestry is derived from progressive prefixes.\n */\nexport class AttentionManager {\n  private readonly _map = new Map<string, Atom.Writable<Attention>>();\n  private readonly _currentAtom: Atom.Writable<string[]>;\n\n  constructor(\n    private readonly _registry: Registry.Registry,\n    initial: string[] = [],\n  ) {\n    this._currentAtom = Atom.make<string[]>([]).pipe(Atom.keepAlive);\n    if (initial.length > 0) {\n      this.update(initial);\n    }\n  }\n\n  /**\n   * Atom for the currently attended element IDs.\n   */\n  get current(): Atom.Atom<string[]> {\n    return this._currentAtom;\n  }\n\n  /**\n   * Gets the currently attended element IDs.\n   */\n  getCurrent(): readonly string[] {\n    return this._registry.get(this._currentAtom);\n  }\n\n  /**\n   * Subscribe to changes in the current attention IDs.\n   */\n  subscribeCurrent(cb: (current: readonly string[]) => void): () => void {\n    this._registry.get(this._currentAtom);\n    return this._registry.subscribe(this._currentAtom, () => {\n      cb(this._registry.get(this._currentAtom));\n    });\n  }\n\n  /**\n   * All tracked qualified IDs.\n   */\n  keys(): string[] {\n    return Array.from(this._map.keys());\n  }\n\n  /**\n   * Get the attention state for a given qualified ID.\n   */\n  get(id: string): Attention {\n    const atom = this._getAtom(id);\n    return this._registry.get(atom);\n  }\n\n  /**\n   * Subscribe to changes in the attention state for a given qualified ID.\n   */\n  subscribe(id: string, cb: (attention: Attention) => void): () => void {\n    const atom = this._getAtom(id);\n    this._registry.get(atom);\n    return this._registry.subscribe(atom, () => {\n      cb(this._registry.get(atom));\n    });\n  }\n\n  private _getAtom(id: string): Atom.Writable<Attention> {\n    const existing = this._map.get(id);\n    if (existing) {\n      return existing;\n    }\n\n    const newAtom = Atom.make<Attention>({ hasAttention: false, isAncestor: false, isRelated: false }).pipe(\n      Atom.keepAlive,\n    );\n    this._map.set(id, newAtom);\n    return newAtom;\n  }\n\n  /**\n   * Update the currently attended element.\n   * Takes the array of qualified IDs collected from the DOM; the first element is the primary attended item.\n   * Ancestry is derived from the progressive prefixes of the primary ID.\n   * Relatedness is derived from the segment ID: any tracked key whose last `/` segment matches the\n   * attended ID's segment ID is marked `isRelated`. Additionally, if the primary ID is a linked segment\n   * (starts with `~`), its immediate parent gets `isRelated` alongside `isAncestor`.\n   *\n   * @internal\n   */\n  update(nextIds: string[]): void {\n    const primaryId = nextIds[0];\n    if (!primaryId) {\n      return;\n    }\n\n    const currentIds = this.getCurrent();\n    const prevPrimaryId = currentIds[0];\n    // Clear previous attention state: ancestors, primary, and related keys.\n    if (prevPrimaryId) {\n      const prevPrefixes = expandAttendableId(prevPrimaryId);\n      for (const prefix of prevPrefixes) {\n        this._set(prefix, {});\n      }\n      const prevSegmentId = getSegmentId(prevPrimaryId);\n      for (const key of this.keys()) {\n        if (getSegmentId(key) === prevSegmentId) {\n          this._set(key, {});\n        }\n      }\n    }\n\n    this._registry.set(this._currentAtom, nextIds);\n\n    // Set ancestors and primary.\n    const prefixes = expandAttendableId(primaryId);\n    const prefixSet = new Set(prefixes);\n    const linkedParent = isLinkedSegment(primaryId) ? getParentId(primaryId) : undefined;\n\n    for (const prefix of prefixes) {\n      if (prefix === primaryId) {\n        this._set(prefix, { hasAttention: true });\n      } else if (prefix === linkedParent) {\n        this._set(prefix, { isAncestor: true, isRelated: true });\n      } else {\n        this._set(prefix, { isAncestor: true });\n      }\n    }\n\n    // Set related keys: any tracked key sharing the same segment ID.\n    const segmentId = getSegmentId(primaryId);\n    for (const key of this.keys()) {\n      if (!prefixSet.has(key) && getSegmentId(key) === segmentId) {\n        this._set(key, { isRelated: true });\n      }\n    }\n  }\n\n  private _set(id: string, attention: Partial<Attention>): void {\n    const atom = this._getAtom(id);\n    this._registry.set(atom, {\n      hasAttention: attention.hasAttention ?? false,\n      isAncestor: attention.isAncestor ?? false,\n      isRelated: attention.isRelated ?? false,\n    });\n  }\n}\n\n/** The attribute marking an element as attendable, carrying its qualified id. */\nexport const ATTENDABLE_ATTRIBUTE = 'data-attendable-id';\n\n/** Selector matching any attendable element. */\nexport const ATTENDABLE_SELECTOR = `[${ATTENDABLE_ATTRIBUTE}]`;\n\n/**\n * Accumulates all attendable IDs between the element provided and the root, inclusive.\n * Each `data-attendable-id` value is treated as a single qualified ID (no splitting).\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(ATTENDABLE_ATTRIBUTE);\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);\n      return !closestAttendable.parentElement ? acc : getAttendables(selector, closestAttendable.parentElement, acc);\n    }\n  }\n\n  return [...new Set(acc)];\n};\n\n/**\n * The outermost attendable ancestor of `element` — the root of any nested attendables (e.g. a section\n * within a stack). Structural (real DOM ancestry), so it is independent of what currently has attention.\n * Resolve it from an in-DOM element: a portaled subtree (a menu, a popover) is not under its own\n * attendable, so walk from the trigger or anchor instead.\n */\nexport const getRootAttendableId = (element: Element): string | undefined =>\n  getAttendables(ATTENDABLE_SELECTOR, element).at(-1);\n\nexport type AttendableId = { attendableId?: string };\n\nexport type Related = { related?: boolean };\n\n/**\n * Prefix for linked segments. A linked segment's attention state is shared with its parent:\n * when a linked node has attention, the parent is marked as both ancestor and related.\n */\nconst LINKED_PREFIX = '~';\n\n/**\n * Decompose a qualified graph ID into progressive prefixes for ancestry tracking.\n * e.g. `root/a/b/c` yields `['root', 'root/a', 'root/a/b', 'root/a/b/c']`.\n */\nexport const expandAttendableId = (qualifiedId: string): string[] => {\n  const segments = qualifiedId.split('/');\n  return segments.map((_, index) => segments.slice(0, index + 1).join('/'));\n};\n\n/**\n * Whether the last segment of a qualified ID is a linked segment (starts with `~`).\n * Linked segments share their attention state with the parent node.\n */\nexport const isLinkedSegment = (qualifiedId: string): boolean => {\n  const lastSegment = qualifiedId.split('/').pop() ?? '';\n  return lastSegment.startsWith(LINKED_PREFIX);\n};\n\n/**\n * Build a linked segment ID from a variant name (e.g., `'settings'` -> `'~settings'`).\n * Nodes identified by linked segments share their attention state with the parent node.\n */\nexport const linkedSegment = (variant: string): string => `${LINKED_PREFIX}${variant}`;\n\n/**\n * Extract the variant name from the last segment of a qualified ID, stripping the linked prefix.\n * e.g. `'root/space/obj/~settings'` -> `'settings'`.\n * If the segment is not linked (no `~` prefix), returns the segment as-is.\n */\nexport const getLinkedVariant = (qualifiedId: string): string => {\n  const lastSegment = qualifiedId.split('/').pop() ?? '';\n  return lastSegment.startsWith(LINKED_PREFIX) ? lastSegment.slice(LINKED_PREFIX.length) : lastSegment;\n};\n\n/**\n * Get the parent qualified ID (everything before the last `/` segment).\n */\nexport const getParentId = (qualifiedId: string | undefined): string | undefined => {\n  if (!qualifiedId) {\n    return undefined;\n  }\n\n  const lastSlash = qualifiedId.lastIndexOf('/');\n  return lastSlash > 0 ? qualifiedId.slice(0, lastSlash) : undefined;\n};\n\n/**\n * Extract the segment ID (last segment) of a qualified ID.\n */\nexport const getSegmentId = (qualifiedId: string): string => {\n  return qualifiedId.split('/').pop() ?? qualifiedId;\n};\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport { type Atom, type Registry } from '@effect-atom/atom';\nimport type * as Schema from 'effect/Schema';\n\n/**\n * Persistence backend identifier. `personal` (ECHO/personal-space) is reserved for a future backend.\n */\nexport type BackendName = 'memory' | 'local';\n\n/**\n * Declares a kind of per-context UI state. The value type `T` and its persisted wire type `Encoded`\n * are inferred from the schema; `Encoded` defaults to `T` for the common no-transform case.\n */\nexport interface Aspect<T, Encoded = T> {\n  readonly key: string;\n  readonly backend: BackendName;\n  readonly schema: Schema.Schema<T, Encoded>;\n  readonly defaultValue: () => T;\n}\n\n/**\n * Identity helper that pins the value type from the schema while keeping the literal `key`/`backend`.\n * Declares an aspect of per-context UI state (selection, scroll, view mode, split) read/written via\n * {@link Manager} — through `useViewState`/`useViewStateActions` in React or the\n * `AttentionCapabilities.ViewState` capability in operations. Durability is the `backend`'s: `local`\n * survives reloads (best-effort — degrades to in-memory when storage is blocked), `memory` is\n * session-only.\n *\n * @idiom org.dxos.react-ui-attention.viewState\n *   applies: Holding per-context UI state (selection, view mode, scroll, split) that survives navigation (and reloads with the `local` backend)\n *   instead-of: ad-hoc `useState` that resets on remount, or stuffing per-context state into the plugin Settings store\n *   uses: {@link define}, {@link Manager}\n *   related: org.dxos.effect.kvsStore\n */\nexport const define = <T, Encoded = T>(def: Aspect<T, Encoded>): Aspect<T, Encoded> => def;\n\n/**\n * A backend produces a reactive, writable atom for each `(aspect, contextId)` pair. Backends may\n * hydrate asynchronously (an ECHO backend would), yielding `aspect.defaultValue()` until loaded;\n * the memory and local backends resolve synchronously.\n */\nexport interface Backend {\n  /** Stable atom for the pair; created (and seeded) on first access, cached thereafter. */\n  atom: <T, Encoded>(aspect: Aspect<T, Encoded>, contextId: string) => Atom.Writable<T>;\n  /** Persist a value after the atom is updated. No-op for in-memory backends. */\n  persist?: <T, Encoded>(aspect: Aspect<T, Encoded>, contextId: string, value: T) => void;\n  /** Context ids that currently hold a value for the aspect. */\n  contexts: <T, Encoded>(aspect: Aspect<T, Encoded>) => string[];\n  /** Release listeners/timers (used by tests; app-lifetime managers do not call this). */\n  dispose?: () => void;\n}\n\nexport interface ManagerOptions {\n  readonly registry: Registry.Registry;\n  readonly backends: Record<BackendName, Backend>;\n}\n\n/**\n * Routes per-context UI state to the backend declared by each aspect. Reads/writes go through the\n * effect-atom registry so React hooks and graph atoms observe changes uniformly.\n */\nexport class Manager {\n  readonly #registry: Registry.Registry;\n  readonly #backends: Record<BackendName, Backend>;\n\n  constructor({ registry, backends }: ManagerOptions) {\n    this.#registry = registry;\n    this.#backends = backends;\n  }\n\n  /** Reactive atom for `(aspect, contextId)`; pass to `registry.get` inside derived atoms/hooks. */\n  atom<T, Encoded>(aspect: Aspect<T, Encoded>, contextId: string): Atom.Writable<T> {\n    return this.#backends[aspect.backend].atom(aspect, contextId);\n  }\n\n  get<T, Encoded>(aspect: Aspect<T, Encoded>, contextId: string): T {\n    return this.#registry.get(this.atom(aspect, contextId));\n  }\n\n  set<T, Encoded>(aspect: Aspect<T, Encoded>, contextId: string, value: T): void {\n    const backend = this.#backends[aspect.backend];\n    this.#registry.set(backend.atom(aspect, contextId), value);\n    backend.persist?.(aspect, contextId, value);\n  }\n\n  update<T, Encoded>(aspect: Aspect<T, Encoded>, contextId: string, fn: (prev: T) => T): void {\n    this.set(aspect, contextId, fn(this.get(aspect, contextId)));\n  }\n\n  subscribe<T, Encoded>(aspect: Aspect<T, Encoded>, contextId: string, cb: (value: T) => void): () => void {\n    const atom = this.atom(aspect, contextId);\n    return this.#registry.subscribe(atom, () => cb(this.#registry.get(atom)));\n  }\n\n  contexts<T, Encoded>(aspect: Aspect<T, Encoded>): string[] {\n    return this.#backends[aspect.backend].contexts(aspect);\n  }\n}\n","//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Match from 'effect/Match';\nimport * as Schema from 'effect/Schema';\n\nimport { type Aspect, type Manager, define } from './ViewState';\n\nexport type SelectionMode = 'single' | 'multi' | 'range' | 'multi-range';\n\nexport const Selection = Schema.Union(\n  Schema.Struct({\n    mode: Schema.Literal('single'),\n    id: Schema.optional(Schema.String),\n  }).pipe(Schema.mutable),\n  Schema.Struct({\n    mode: Schema.Literal('multi'),\n    ids: Schema.Array(Schema.String).pipe(Schema.mutable),\n  }).pipe(Schema.mutable),\n  Schema.Struct({\n    mode: Schema.Literal('range'),\n    from: Schema.optional(Schema.String),\n    to: Schema.optional(Schema.String),\n  }).pipe(Schema.mutable),\n  Schema.Struct({\n    mode: Schema.Literal('multi-range'),\n    ranges: Schema.Array(Schema.Struct({ from: Schema.String, to: Schema.String })).pipe(Schema.mutable),\n  }).pipe(Schema.mutable),\n).pipe(Schema.mutable);\n\nexport type Selection = Schema.Schema.Type<typeof Selection>;\n\nexport const defaultValue = Match.type<SelectionMode>().pipe(\n  Match.withReturnType<Selection>(),\n  Match.when('single', () => ({ mode: 'single' })),\n  Match.when('multi', () => ({ mode: 'multi', ids: [] })),\n  Match.when('range', () => ({ mode: 'range' })),\n  Match.when('multi-range', () => ({ mode: 'multi-range', ranges: [] })),\n  Match.exhaustive,\n);\n\nexport type Result<T extends SelectionMode> = 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\n/** Selection state for a context, stored in memory (ephemeral, per-device session). */\nexport const aspect: Aspect<Selection> = define<Selection>({\n  key: 'selection',\n  backend: 'memory',\n  schema: Selection,\n  defaultValue: () => ({ mode: 'multi', ids: [] }),\n});\n\n/**\n * Extract the typed result for `mode` from a stored selection value, returning the requested\n * mode's default when the stored value is absent or holds a different mode.\n */\nexport const resolve = <T extends SelectionMode>(selection: Selection | undefined, mode: T): Result<T> => {\n  const value = selection?.mode === mode ? selection : defaultValue(mode);\n  // Cast required because TypeScript cannot relate the `Match` result to the generic `T`.\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  )(value) as Result<T>;\n};\n\n/** Toggle `id` within a multi selection; resets to a multi selection if the current value differs. */\nexport const toggle = (selection: Selection | undefined, id: string): Selection => {\n  const ids = selection?.mode === 'multi' ? selection.ids : [];\n  return { mode: 'multi', ids: ids.includes(id) ? ids.filter((existing) => existing !== id) : [...ids, id] };\n};\n\n/** Anchor strings for a selection: ids for single/multi modes, `\"${from}:${to}\"` cursor pairs for range modes. */\nexport const toAnchors = (selection: Selection | undefined): string[] =>\n  selection == null\n    ? []\n    : Match.type<Selection>().pipe(\n        Match.when({ mode: 'single' }, (value) => (value.id ? [value.id] : [])),\n        Match.when({ mode: 'multi' }, (value) => [...value.ids]),\n        Match.when({ mode: 'range' }, (value) => (value.from && value.to ? [`${value.from}:${value.to}`] : [])),\n        Match.when({ mode: 'multi-range' }, (value) => value.ranges.map((range) => `${range.from}:${range.to}`)),\n        Match.exhaustive,\n      )(selection);\n\n/** Union of all multi-selected ids across every selection context, plus an optional explicit id. */\nexport const getValue = (manager: Manager, contextId?: string): Set<string> => {\n  const ids = new Set<string>(contextId ? [contextId] : []);\n  for (const context of manager.contexts(aspect)) {\n    const selection = manager.get(aspect, context);\n    if (selection.mode === 'multi') {\n      for (const id of selection.ids) {\n        ids.add(id);\n      }\n    }\n  }\n\n  return ids;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgBA,IAAa,mBAAb,MAA8B;CAKT;CAJnB,uBAAwB,IAAI,IAAsC;CAClE;CAEA,YACE,WACA,UAAoB,CAAC,GACrB;EAFiB,KAAA,YAAA;EAGjB,KAAK,eAAe,KAAK,KAAe,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS;EAC/D,IAAI,QAAQ,SAAS,GACnB,KAAK,OAAO,OAAO;CAEvB;;;;CAKA,IAAI,UAA+B;EACjC,OAAO,KAAK;CACd;;;;CAKA,aAAgC;EAC9B,OAAO,KAAK,UAAU,IAAI,KAAK,YAAY;CAC7C;;;;CAKA,iBAAiB,IAAsD;EACrE,KAAK,UAAU,IAAI,KAAK,YAAY;EACpC,OAAO,KAAK,UAAU,UAAU,KAAK,oBAAoB;GACvD,GAAG,KAAK,UAAU,IAAI,KAAK,YAAY,CAAC;EAC1C,CAAC;CACH;;;;CAKA,OAAiB;EACf,OAAO,MAAM,KAAK,KAAK,KAAK,KAAK,CAAC;CACpC;;;;CAKA,IAAI,IAAuB;EACzB,MAAM,OAAO,KAAK,SAAS,EAAE;EAC7B,OAAO,KAAK,UAAU,IAAI,IAAI;CAChC;;;;CAKA,UAAU,IAAY,IAAgD;EACpE,MAAM,OAAO,KAAK,SAAS,EAAE;EAC7B,KAAK,UAAU,IAAI,IAAI;EACvB,OAAO,KAAK,UAAU,UAAU,YAAY;GAC1C,GAAG,KAAK,UAAU,IAAI,IAAI,CAAC;EAC7B,CAAC;CACH;CAEA,SAAiB,IAAsC;EACrD,MAAM,WAAW,KAAK,KAAK,IAAI,EAAE;EACjC,IAAI,UACF,OAAO;EAGT,MAAM,UAAU,KAAK,KAAgB;GAAE,cAAc;GAAO,YAAY;GAAO,WAAW;EAAM,CAAC,CAAC,CAAC,KACjG,KAAK,SACP;EACA,KAAK,KAAK,IAAI,IAAI,OAAO;EACzB,OAAO;CACT;;;;;;;;;;;CAYA,OAAO,SAAyB;EAC9B,MAAM,YAAY,QAAQ;EAC1B,IAAI,CAAC,WACH;EAIF,MAAM,gBADa,KAAK,WACF,CAAA,CAAW;EAEjC,IAAI,eAAe;GACjB,MAAM,eAAe,mBAAmB,aAAa;GACrD,KAAK,MAAM,UAAU,cACnB,KAAK,KAAK,QAAQ,CAAC,CAAC;GAEtB,MAAM,gBAAgB,aAAa,aAAa;GAChD,KAAK,MAAM,OAAO,KAAK,KAAK,GAC1B,IAAI,aAAa,GAAG,MAAM,eACxB,KAAK,KAAK,KAAK,CAAC,CAAC;EAGvB;EAEA,KAAK,UAAU,IAAI,KAAK,cAAc,OAAO;EAG7C,MAAM,WAAW,mBAAmB,SAAS;EAC7C,MAAM,YAAY,IAAI,IAAI,QAAQ;EAClC,MAAM,eAAe,gBAAgB,SAAS,IAAI,YAAY,SAAS,IAAI,KAAA;EAE3E,KAAK,MAAM,UAAU,UACnB,IAAI,WAAW,WACb,KAAK,KAAK,QAAQ,EAAE,cAAc,KAAK,CAAC;OACnC,IAAI,WAAW,cACpB,KAAK,KAAK,QAAQ;GAAE,YAAY;GAAM,WAAW;EAAK,CAAC;OAEvD,KAAK,KAAK,QAAQ,EAAE,YAAY,KAAK,CAAC;EAK1C,MAAM,YAAY,aAAa,SAAS;EACxC,KAAK,MAAM,OAAO,KAAK,KAAK,GAC1B,IAAI,CAAC,UAAU,IAAI,GAAG,KAAK,aAAa,GAAG,MAAM,WAC/C,KAAK,KAAK,KAAK,EAAE,WAAW,KAAK,CAAC;CAGxC;CAEA,KAAa,IAAY,WAAqC;EAC5D,MAAM,OAAO,KAAK,SAAS,EAAE;EAC7B,KAAK,UAAU,IAAI,MAAM;GACvB,cAAc,UAAU,gBAAgB;GACxC,YAAY,UAAU,cAAc;GACpC,WAAW,UAAU,aAAa;EACpC,CAAC;CACH;AACF;;AAGA,IAAa,uBAAuB;;AAGpC,IAAa,sBAAsB,IAAI,qBAAqB;;;;;AAM5D,IAAa,kBAAkB,UAAkB,QAAiB,MAAgB,CAAC,MAAgB;CAEjG,MAAM,oBAAoB,OAAO,QAAQ,QAAQ;CACjD,IAAI,mBAAmB;EACrB,MAAM,eAAe,kBAAkB,aAAa,oBAAoB;EACxE,IAAI,CAAC,cAAc;GAEjB,MAAM,UAAU,SAAS,cAAc,mBAAmB,kBAAkB,aAAa,IAAI,EAAE,GAAG;GAClG,IAAI,CAAC,SACH,OAAO;QAEP,OAAO,eAAe,UAAU,SAAS,GAAG;EAEhD,OAAO;GACL,IAAI,KAAK,YAAY;GACrB,OAAO,CAAC,kBAAkB,gBAAgB,MAAM,eAAe,UAAU,kBAAkB,eAAe,GAAG;EAC/G;CACF;CAEA,OAAO,CAAC,GAAG,IAAI,IAAI,GAAG,CAAC;AACzB;;;;;;;AAQA,IAAa,uBAAuB,YAClC,eAAe,qBAAqB,OAAO,CAAC,CAAC,GAAG,EAAE;;;;;AAUpD,IAAM,gBAAgB;;;;;AAMtB,IAAa,sBAAsB,gBAAkC;CACnE,MAAM,WAAW,YAAY,MAAM,GAAG;CACtC,OAAO,SAAS,KAAK,GAAG,UAAU,SAAS,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC;AAC1E;;;;;AAMA,IAAa,mBAAmB,gBAAiC;CAE/D,QADoB,YAAY,MAAM,GAAG,CAAC,CAAC,IAAI,KAAK,GAAA,CACjC,WAAW,aAAa;AAC7C;;;;;AAMA,IAAa,iBAAiB,YAA4B,GAAG,gBAAgB;;;;;;AAO7E,IAAa,oBAAoB,gBAAgC;CAC/D,MAAM,cAAc,YAAY,MAAM,GAAG,CAAC,CAAC,IAAI,KAAK;CACpD,OAAO,YAAY,WAAW,aAAa,IAAI,YAAY,MAAM,CAAoB,IAAI;AAC3F;;;;AAKA,IAAa,eAAe,gBAAwD;CAClF,IAAI,CAAC,aACH;CAGF,MAAM,YAAY,YAAY,YAAY,GAAG;CAC7C,OAAO,YAAY,IAAI,YAAY,MAAM,GAAG,SAAS,IAAI,KAAA;AAC3D;;;;AAKA,IAAa,gBAAgB,gBAAgC;CAC3D,OAAO,YAAY,MAAM,GAAG,CAAC,CAAC,IAAI,KAAK;AACzC;;;;;;;;;;;;;;;;;;;;;AClOA,IAAa,UAA0B,QAAgD;;;;;AA2BvF,IAAa,UAAb,MAAqB;CACnB;CACA;CAEA,YAAY,EAAE,UAAU,YAA4B;EAClD,KAAK,YAAY;EACjB,KAAK,YAAY;CACnB;;CAGA,KAAiB,QAA4B,WAAqC;EAChF,OAAO,KAAK,UAAU,OAAO,QAAQ,CAAC,KAAK,QAAQ,SAAS;CAC9D;CAEA,IAAgB,QAA4B,WAAsB;EAChE,OAAO,KAAK,UAAU,IAAI,KAAK,KAAK,QAAQ,SAAS,CAAC;CACxD;CAEA,IAAgB,QAA4B,WAAmB,OAAgB;EAC7E,MAAM,UAAU,KAAK,UAAU,OAAO;EACtC,KAAK,UAAU,IAAI,QAAQ,KAAK,QAAQ,SAAS,GAAG,KAAK;EACzD,QAAQ,UAAU,QAAQ,WAAW,KAAK;CAC5C;CAEA,OAAmB,QAA4B,WAAmB,IAA0B;EAC1F,KAAK,IAAI,QAAQ,WAAW,GAAG,KAAK,IAAI,QAAQ,SAAS,CAAC,CAAC;CAC7D;CAEA,UAAsB,QAA4B,WAAmB,IAAoC;EACvG,MAAM,OAAO,KAAK,KAAK,QAAQ,SAAS;EACxC,OAAO,KAAK,UAAU,UAAU,YAAY,GAAG,KAAK,UAAU,IAAI,IAAI,CAAC,CAAC;CAC1E;CAEA,SAAqB,QAAsC;EACzD,OAAO,KAAK,UAAU,OAAO,QAAQ,CAAC,SAAS,MAAM;CACvD;AACF;;;;;;;;;;;;ACzFA,IAAa,YAAY,OAAO,MAC9B,OAAO,OAAO;CACZ,MAAM,OAAO,QAAQ,QAAQ;CAC7B,IAAI,OAAO,SAAS,OAAO,MAAM;AACnC,CAAC,CAAC,CAAC,KAAK,OAAO,OAAO,GACtB,OAAO,OAAO;CACZ,MAAM,OAAO,QAAQ,OAAO;CAC5B,KAAK,OAAO,MAAM,OAAO,MAAM,CAAC,CAAC,KAAK,OAAO,OAAO;AACtD,CAAC,CAAC,CAAC,KAAK,OAAO,OAAO,GACtB,OAAO,OAAO;CACZ,MAAM,OAAO,QAAQ,OAAO;CAC5B,MAAM,OAAO,SAAS,OAAO,MAAM;CACnC,IAAI,OAAO,SAAS,OAAO,MAAM;AACnC,CAAC,CAAC,CAAC,KAAK,OAAO,OAAO,GACtB,OAAO,OAAO;CACZ,MAAM,OAAO,QAAQ,aAAa;CAClC,QAAQ,OAAO,MAAM,OAAO,OAAO;EAAE,MAAM,OAAO;EAAQ,IAAI,OAAO;CAAO,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,OAAO;AACrG,CAAC,CAAC,CAAC,KAAK,OAAO,OAAO,CACxB,CAAC,CAAC,KAAK,OAAO,OAAO;AAIrB,IAAa,eAAe,MAAM,KAAoB,CAAC,CAAC,KACtD,MAAM,eAA0B,GAChC,MAAM,KAAK,iBAAiB,EAAE,MAAM,SAAS,EAAE,GAC/C,MAAM,KAAK,gBAAgB;CAAE,MAAM;CAAS,KAAK,CAAC;AAAE,EAAE,GACtD,MAAM,KAAK,gBAAgB,EAAE,MAAM,QAAQ,EAAE,GAC7C,MAAM,KAAK,sBAAsB;CAAE,MAAM;CAAe,QAAQ,CAAC;AAAE,EAAE,GACrE,MAAM,UACR;;AAaA,IAAa,SAA4B,OAAkB;CACzD,KAAK;CACL,SAAS;CACT,QAAQ;CACR,qBAAqB;EAAE,MAAM;EAAS,KAAK,CAAC;CAAE;AAChD,CAAC;;;;;AAMD,IAAa,WAAoC,WAAkC,SAAuB;CACxG,MAAM,QAAQ,WAAW,SAAS,OAAO,YAAY,aAAa,IAAI;CAEtE,OAAO,MAAM,KAAgB,CAAC,CAAC,KAC7B,MAAM,KAAK,EAAE,MAAM,SAAS,IAAI,MAAM,EAAE,EAAE,GAC1C,MAAM,KAAK,EAAE,MAAM,QAAQ,IAAI,MAAM,EAAE,GAAG,GAC1C,MAAM,KAAK,EAAE,MAAM,QAAQ,IAAI,MAAO,EAAE,QAAQ,EAAE,KAAK;EAAE,MAAM,EAAE;EAAM,IAAI,EAAE;CAAG,IAAI,KAAA,CAAU,GAC9F,MAAM,KAAK,EAAE,MAAM,cAAc,IAAI,MAAM,EAAE,MAAM,GACnD,MAAM,UACR,CAAC,CAAC,KAAK;AACT;;AAGA,IAAa,UAAU,WAAkC,OAA0B;CACjF,MAAM,MAAM,WAAW,SAAS,UAAU,UAAU,MAAM,CAAC;CAC3D,OAAO;EAAE,MAAM;EAAS,KAAK,IAAI,SAAS,EAAE,IAAI,IAAI,QAAQ,aAAa,aAAa,EAAE,IAAI,CAAC,GAAG,KAAK,EAAE;CAAE;AAC3G;;AAGA,IAAa,aAAa,cACxB,aAAa,OACT,CAAC,IACD,MAAM,KAAgB,CAAC,CAAC,KACtB,MAAM,KAAK,EAAE,MAAM,SAAS,IAAI,UAAW,MAAM,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAE,GACtE,MAAM,KAAK,EAAE,MAAM,QAAQ,IAAI,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,GACvD,MAAM,KAAK,EAAE,MAAM,QAAQ,IAAI,UAAW,MAAM,QAAQ,MAAM,KAAK,CAAC,GAAG,MAAM,KAAK,GAAG,MAAM,IAAI,IAAI,CAAC,CAAE,GACtG,MAAM,KAAK,EAAE,MAAM,cAAc,IAAI,UAAU,MAAM,OAAO,KAAK,UAAU,GAAG,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GACvG,MAAM,UACR,CAAC,CAAC,SAAS;;AAGjB,IAAa,YAAY,SAAkB,cAAoC;CAC7E,MAAM,MAAM,IAAI,IAAY,YAAY,CAAC,SAAS,IAAI,CAAC,CAAC;CACxD,KAAK,MAAM,WAAW,QAAQ,SAAS,MAAM,GAAG;EAC9C,MAAM,YAAY,QAAQ,IAAI,QAAQ,OAAO;EAC7C,IAAI,UAAU,SAAS,SACrB,KAAK,MAAM,MAAM,UAAU,KACzB,IAAI,IAAI,EAAE;CAGhB;CAEA,OAAO;AACT"}

package/dist/lib/index.mjs

@@ -0,0 +1,149 @@
+import { o as ViewState_exports, t as Selection_exports, u as Attention_exports } from "./chunk-types.mjs";
+import { a as useManager, c as useSelectionActions, d as AttendableContainer, f as RootAttentionProvider, g as useAttentionContext, h as useAttentionAttributes, i as createDefaultBackends, l as useViewState, m as useAttention, n as LocalBackend, o as useManagerOptional, p as useAttended, r as MemoryBackend, s as useSelection, t as ViewStateProvider, u as useViewStateActions } from "./chunk-ViewStateProvider.mjs";
+import { forwardRef, useEffect, useMemo } from "react";
+import { Icon } from "@dxos/react-ui";
+import { mx } from "@dxos/ui-theme";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Keyboard, nestKeyboardContext } from "@dxos/keyboard";
+//#region src/components/AttentionGlyph/AttentionGlyph.tsx
+var attentionGlyphStyles = mx("inline-block rounded-xs w-3 h-3 bg-transparent text-accent-text transition-colors", "[[data-contains-attended=true]_&]:bg-attention-contains", "[[data-attention=true]_&]:bg-accent-bg", "[[data-attention=true]_&]:text-accent-fg", "[[aria-current][data-attention=true]_&]:bg-accent-bg", "[[aria-current][data-attention=true]_&]:text-accent-fg", "[[aria-selected=\"true\"][data-attention=true]_&]:bg-accent-bg", "[[aria-selected=\"true\"][data-attention=true]_&]:text-accent-fg");
+var presenceIconStyles = mx("w-3 h-3");
+var PresenceOne = () => {
+	return /* @__PURE__ */ jsx("svg", {
+		width: "12",
+		height: "12",
+		viewBox: "0 0 12 12",
+		className: presenceIconStyles,
+		fill: "none",
+		xmlns: "http://www.w3.org/2000/svg",
+		children: /* @__PURE__ */ jsx("circle", {
+			cx: "6",
+			cy: "6",
+			r: "2.5",
+			fill: "currentColor"
+		})
+	});
+};
+var PresenceMany = () => {
+	return /* @__PURE__ */ jsxs("svg", {
+		width: "12",
+		height: "12",
+		viewBox: "0 0 12 12",
+		className: presenceIconStyles,
+		fill: "none",
+		xmlns: "http://www.w3.org/2000/svg",
+		children: [/* @__PURE__ */ jsx("path", {
+			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",
+			fill: "currentColor"
+		}), /* @__PURE__ */ jsx("circle", {
+			cx: "4.25",
+			cy: "6",
+			r: "2.5",
+			fill: "currentColor"
+		})]
+	});
+};
+var Syncing = () => {
+	return /* @__PURE__ */ jsx("div", {
+		role: "status",
+		className: "flex items-center",
+		children: /* @__PURE__ */ jsx(Icon, {
+			icon: "ph--circle-notch--bold",
+			size: 3,
+			style: useMemo(() => ({ animationDelay: `-${Date.now() % 2e3}ms` }), []),
+			classNames: "text-subdued animate-[spin_2s_linear_infinite]"
+		})
+	});
+};
+var AttentionGlyph = forwardRef(({ presence, attended, syncing, containsAttended, classNames, ...props }, forwardedRef) => {
+	const icon = syncing ? /* @__PURE__ */ jsx(Syncing, {}) : presence === "many" ? /* @__PURE__ */ jsx(PresenceMany, {}) : presence === "one" ? /* @__PURE__ */ jsx(PresenceOne, {}) : null;
+	return /* @__PURE__ */ jsx("div", {
+		className: "flex group",
+		"data-attention": attended,
+		"data-contains-attended": containsAttended,
+		children: /* @__PURE__ */ jsx("span", {
+			...props,
+			className: mx(attentionGlyphStyles, classNames),
+			ref: forwardedRef,
+			children: icon
+		})
+	});
+});
+//#endregion
+//#region src/hooks/useArticleKeyboardNavigation.ts
+/**
+* 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.
+*/
+var advance = ({ ids, currentId, delta }) => {
+	if (ids.length === 0) return;
+	const idx = currentId ? ids.indexOf(currentId) : -1;
+	if (idx === -1) return delta === 1 ? ids[0] : ids[ids.length - 1];
+	return ids[Math.max(0, Math.min(ids.length - 1, idx + delta))];
+};
+/**
+* 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.
+*/
+var useArticleKeyboardNavigation = ({ articleId, items, currentId, getId, onSelect }) => {
+	const { hasAttention } = useAttention(articleId);
+	const ids = useMemo(() => items.map((item) => getId ? getId(item) : item.id), [items, getId]);
+	useEffect(() => {
+		if (!hasAttention) return;
+		const contextPath = nestKeyboardContext(articleId);
+		const context = Keyboard.singleton.getContext(contextPath);
+		const prevContext = Keyboard.singleton.getCurrentContext();
+		Keyboard.singleton.setCurrentContext(contextPath);
+		const nextBinding = {
+			shortcut: "j",
+			handler: () => {
+				const target = advance({
+					ids,
+					currentId,
+					delta: 1
+				});
+				if (target !== void 0) onSelect(target);
+			},
+			data: "Next item",
+			disableInput: true
+		};
+		const prevBinding = {
+			shortcut: "k",
+			handler: () => {
+				const target = advance({
+					ids,
+					currentId,
+					delta: -1
+				});
+				if (target !== void 0) onSelect(target);
+			},
+			data: "Previous item",
+			disableInput: true
+		};
+		context.bind(nextBinding);
+		context.bind(prevBinding);
+		return () => {
+			context.unbind("j");
+			context.unbind("k");
+			if (Keyboard.singleton.getCurrentContext() === contextPath) Keyboard.singleton.setCurrentContext(prevContext);
+		};
+	}, [
+		articleId,
+		ids,
+		currentId,
+		onSelect,
+		hasAttention
+	]);
+};
+//#endregion
+export { AttendableContainer, Attention_exports as Attention, AttentionGlyph, LocalBackend, MemoryBackend, RootAttentionProvider, Selection_exports as Selection, Syncing, ViewState_exports as ViewState, ViewStateProvider, advance, createDefaultBackends, useArticleKeyboardNavigation, useAttended, useAttention, useAttentionAttributes, useAttentionContext, useManager, useManagerOptional, useSelection, useSelectionActions, useViewState, useViewStateActions };
+
+//# sourceMappingURL=index.mjs.map

package/dist/lib/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/components/AttentionGlyph/AttentionGlyph.tsx","../../src/hooks/useArticleKeyboardNavigation.ts"],"sourcesContent":["//\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/ui-theme';\n\nconst attentionGlyphStyles = mx(\n  'inline-block rounded-xs w-3 h-3 bg-transparent text-accent-text transition-colors',\n  '[[data-contains-attended=true]_&]:bg-attention-contains',\n  '[[data-attention=true]_&]:bg-accent-bg',\n  '[[data-attention=true]_&]:text-accent-fg',\n  '[[aria-current][data-attention=true]_&]:bg-accent-bg',\n  '[[aria-current][data-attention=true]_&]:text-accent-fg',\n  '[[aria-selected=\"true\"][data-attention=true]_&]:bg-accent-bg',\n  '[[aria-selected=\"true\"][data-attention=true]_&]:text-accent-fg',\n);\n\nconst presenceIconStyles = mx('w-3 h-3');\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 className='flex group' data-attention={attended} data-contains-attended={containsAttended}>\n        <span {...props} className={mx(attentionGlyphStyles, classNames)} ref={forwardedRef}>\n          {icon}\n        </span>\n      </div>\n    );\n  },\n);\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport { useEffect, useMemo } from 'react';\n\nimport { Keyboard, nestKeyboardContext } from '@dxos/keyboard';\n\nimport { useAttention } from '../components';\n\n/**\n * Compute the id to select after pressing 'j' (delta = 1) or 'k' (delta = -1).\n * Clamps at the list ends — pressing 'j' on the last item keeps the last item\n * selected (vim-style), and 'k' on the first item keeps the first.\n *\n * When no current selection exists, returns the first id (for delta = 1) or the\n * last id (for delta = -1) so the user can enter the list with either key.\n */\nexport const advance = ({\n  ids,\n  currentId,\n  delta,\n}: {\n  ids: readonly string[];\n  currentId: string | undefined;\n  delta: 1 | -1;\n}): string | undefined => {\n  if (ids.length === 0) {\n    return undefined;\n  }\n\n  const idx = currentId ? ids.indexOf(currentId) : -1;\n  if (idx === -1) {\n    return delta === 1 ? ids[0] : ids[ids.length - 1];\n  }\n\n  const next = Math.max(0, Math.min(ids.length - 1, idx + delta));\n  return ids[next];\n};\n\nexport type UseArticleKeyboardNavigationOptions<T> = {\n  /** Stable id for the article (used as the keyboard context path). */\n  articleId: string;\n  /** Ordered list of selectable items as they appear in the article. */\n  items: readonly T[];\n  /** Currently-selected id, if any. */\n  currentId: string | undefined;\n  /** Extracts the id from an item. Defaults to `item.id`. */\n  getId?: (item: T) => string;\n  /** Called with the id to select when the user presses 'j' or 'k'. */\n  onSelect: (id: string) => void;\n};\n\n/**\n * Wire 'j' (next) and 'k' (previous) keyboard shortcuts for an article that\n * navigates a list of items (e.g., messages, events). Bindings are scoped to\n * the article's keyboard context so they only fire while the article has attention.\n *\n * Pass the items directly; ids are derived via `getId` (defaults to `item.id`).\n * Clamps at list boundaries. Active only when the article is attended.\n */\nexport const useArticleKeyboardNavigation: {\n  <T extends { id: string }>(options: UseArticleKeyboardNavigationOptions<T>): void;\n  <T>(options: UseArticleKeyboardNavigationOptions<T> & { getId: (item: T) => string }): void;\n} = <T>({ articleId, items, currentId, getId, onSelect }: UseArticleKeyboardNavigationOptions<T>): void => {\n  const { hasAttention } = useAttention(articleId);\n\n  // `getId` is optional only when `T extends { id: string }` (enforced by the overloads above),\n  // so the fallback is sound; the cast bridges the generic erased by the implementation signature.\n  const ids = useMemo(() => items.map((item) => (getId ? getId(item) : (item as { id: string }).id)), [items, getId]);\n\n  useEffect(() => {\n    if (!hasAttention) {\n      return;\n    }\n\n    const contextPath = nestKeyboardContext(articleId);\n    const context = Keyboard.singleton.getContext(contextPath);\n    const prevContext = Keyboard.singleton.getCurrentContext();\n    Keyboard.singleton.setCurrentContext(contextPath);\n\n    const nextBinding = {\n      shortcut: 'j',\n      handler: () => {\n        const target = advance({ ids, currentId, delta: 1 });\n        if (target !== undefined) {\n          onSelect(target);\n        }\n      },\n      data: 'Next item',\n      disableInput: true,\n    };\n    const prevBinding = {\n      shortcut: 'k',\n      handler: () => {\n        const target = advance({ ids, currentId, delta: -1 });\n        if (target !== undefined) {\n          onSelect(target);\n        }\n      },\n      data: 'Previous item',\n      disableInput: true,\n    };\n\n    context.bind(nextBinding);\n    context.bind(prevBinding);\n\n    return () => {\n      context.unbind('j');\n      context.unbind('k');\n      // Restore the prior context if we were the ones who set it.\n      if (Keyboard.singleton.getCurrentContext() === contextPath) {\n        Keyboard.singleton.setCurrentContext(prevContext);\n      }\n    };\n  }, [articleId, ids, currentId, onSelect, hasAttention]);\n};\n"],"mappings":"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"}

package/dist/lib/testing.mjs

@@ -0,0 +1,20 @@
+import { l as AttentionManager } from "./chunk-types.mjs";
+import { f as RootAttentionProvider, t as ViewStateProvider } from "./chunk-ViewStateProvider.mjs";
+import { createElement, useMemo } from "react";
+import { Registry, RegistryContext } from "@effect-atom/atom-react";
+//#region src/testing/decorators/withAttention.ts
+/**
+* Storybook decorator that provides attention context.
+* @param initialAttendedId Optional ID to set as initially attended.
+*/
+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(ViewStateProvider, {}, createElement(Story))));
+	};
+};
+//#endregion
+export { withAttention };
+
+//# sourceMappingURL=testing.mjs.map

package/dist/lib/testing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.mjs","names":[],"sources":["../../src/testing/decorators/withAttention.ts"],"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 { RootAttentionProvider, ViewStateProvider } from '../../components';\nimport { Attention } from '../../types';\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 Attention.AttentionManager(registry, [initialAttendedId]) : undefined),\n      [registry],\n    );\n\n    return createElement(\n      RegistryContext.Provider,\n      { value: registry },\n      createElement(RootAttentionProvider, { attention }, createElement(ViewStateProvider, {}, createElement(Story))),\n    );\n  };\n};\n"],"mappings":";;;;;;;;;AAeA,IAAa,iBAAiB,sBAA0C;CACtE,QAAQ,UAAU;EAChB,MAAM,WAAW,cAAc,SAAS,KAAK,GAAG,CAAC,CAAC;EAClD,MAAM,YAAY,cACT,oBAAoB,IAAI,iBAA2B,UAAU,CAAC,iBAAiB,CAAC,IAAI,KAAA,GAC3F,CAAC,QAAQ,CACX;EAEA,OAAO,cACL,gBAAgB,UAChB,EAAE,OAAO,SAAS,GAClB,cAAc,uBAAuB,EAAE,UAAU,GAAG,cAAc,mBAAmB,CAAC,GAAG,cAAc,KAAK,CAAC,CAAC,CAChH;CACF;AACF"}

package/dist/lib/types.mjs

@@ -0,0 +1,2 @@
+import { o as ViewState_exports, t as Selection_exports, u as Attention_exports } from "./chunk-types.mjs";
+export { Attention_exports as Attention, Selection_exports as Selection, ViewState_exports as ViewState };

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

@@ -1,19 +1,6 @@
 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>;
+import { AttentionManager } from '../../types/Attention';
 type RootAttentionProviderProps = PropsWithChildren<{
     attention?: AttentionManager;
     onChange?: (nextAttended: string[]) => void;
@@ -30,5 +17,5 @@ export type AttendableContainerProps = ThemedClassName<ComponentPropsWithRef<'di
  * 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 { AttendableContainer, RootAttentionProvider, useAttended, useAttention, useAttentionAttributes, useAttentionContext, };
+export { AttendableContainer, RootAttentionProvider };
 //# sourceMappingURL=AttentionProvider.d.ts.map

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

@@ -1 +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,mBAAmB,EACnB,qBAAqB,EACrB,WAAW,EACX,YAAY,EACZ,sBAAsB,EACtB,mBAAmB,GACpB,CAAC"}
+{"version":3,"file":"AttentionProvider.d.ts","sourceRoot":"","sources":["../../../../../src/components/AttentionProvider/AttentionProvider.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,EACZ,KAAK,qBAAqB,EAE1B,KAAK,iBAAiB,EAIvB,MAAM,OAAO,CAAC;AAIf,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGtD,OAAO,EAAuB,gBAAgB,EAAkB,MAAM,uBAAuB,CAAC;AAG9F,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,8GAexB,CAAC;AAEF,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,CAAC"}