@dxos/react-ui-attention 0.10.0 → 0.11.0

package/dist/lib/chunk-ViewStateProvider.mjs

@@ -0,0 +1,308 @@
+import { a as Manager, c as ATTENDABLE_SELECTOR, d as getAttendables, i as toggle, l as AttentionManager, n as aspect, r as resolve, s as ATTENDABLE_ATTRIBUTE } from "./chunk-types.mjs";
+import { forwardRef, useCallback, useContext, useEffect, useMemo, useState } from "react";
+import { mx } from "@dxos/ui-theme";
+import { jsx } from "react/jsx-runtime";
+import { createContext } from "@radix-ui/react-context";
+import { Atom } from "@effect-atom/atom";
+import { RegistryContext } from "@effect-atom/atom-react";
+import { Primitive } from "@radix-ui/react-primitive";
+import { Slot } from "@radix-ui/react-slot";
+import { log } from "@dxos/log";
+import { useDefaultValue } from "@dxos/react-hooks";
+import { invariant } from "@dxos/invariant";
+import * as Schema from "effect/Schema";
+//#region src/components/AttentionProvider/attention-context.ts
+var ATTENTION_NAME = "Attention";
+var ATTENTION_SOURCE_ATTRIBUTE = "data-w-attention-source";
+var [AttentionContextProvider, useAttentionContext] = createContext(ATTENTION_NAME, { attention: void 0 });
+var UNKNOWN_ATTENDABLE = {
+	hasAttention: false,
+	isAncestor: false,
+	isRelated: false
+};
+/**
+* Subscribe to the attention state for a qualified graph ID.
+*/
+var useAttention = (attendableId) => {
+	const { attention } = useAttentionContext(ATTENTION_NAME);
+	const [state, setState] = useState(UNKNOWN_ATTENDABLE);
+	useEffect(() => {
+		if (!attendableId || !attention) {
+			setState(UNKNOWN_ATTENDABLE);
+			return;
+		}
+		const currentState = attention.get(attendableId);
+		setState(currentState);
+		return attention.subscribe(attendableId, (newState) => {
+			setState(newState);
+		});
+	}, [attention, attendableId]);
+	return state;
+};
+var useAttended = () => {
+	const { attention } = useAttentionContext(ATTENTION_NAME);
+	const [current, setCurrent] = useState([]);
+	useEffect(() => {
+		if (!attention) return;
+		setCurrent(attention.getCurrent());
+		return attention.subscribeCurrent((newCurrent) => {
+			setCurrent(newCurrent);
+		});
+	}, [attention]);
+	return current;
+};
+/**
+* Computes HTML element attributes to apply so the attention system can detect changes.
+*/
+var useAttentionAttributes = (attendableId) => {
+	const { hasAttention } = useAttention(attendableId);
+	return useMemo(() => {
+		const attributes = { [ATTENDABLE_ATTRIBUTE]: attendableId };
+		if (hasAttention) attributes[ATTENTION_SOURCE_ATTRIBUTE] = "true";
+		return attributes;
+	}, [attendableId, hasAttention]);
+};
+//#endregion
+//#region src/components/AttentionProvider/AttentionProvider.tsx
+var __dxlog_file$1 = "/__w/dxos/dxos/packages/ui/react-ui-attention/src/components/AttentionProvider/AttentionProvider.tsx";
+var RootAttentionProvider = ({ children, attention: propsAttention, onChange }) => {
+	const registry = useContext(RegistryContext);
+	const attention = useDefaultValue(propsAttention, () => new AttentionManager(registry));
+	return /* @__PURE__ */ jsx(AttentionContextProvider, {
+		attention,
+		children: /* @__PURE__ */ jsx("div", {
+			className: "contents",
+			onFocusCapture: useCallback((event) => {
+				log("focus", {
+					related: event.relatedTarget,
+					target: event.target
+				}, {
+					"~LogMeta": "~LogMeta",
+					F: __dxlog_file$1,
+					L: 37,
+					S: void 0
+				});
+				const selector = [ATTENDABLE_SELECTOR, ...Array.from(document.querySelectorAll("[aria-controls]")).map((el) => `[id="${el.getAttribute("aria-controls")}"]`)].join(",");
+				const prev = attention.getCurrent();
+				const next = getAttendables(selector, event.target);
+				if (next.length > 0 && (prev.length !== next.length || !!prev.find((id, index) => next[index] !== id))) {
+					attention.update(next);
+					onChange?.(next);
+				}
+			}, [attention, onChange]),
+			children
+		})
+	});
+};
+/**
+* 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.
+*/
+var AttendableContainer = forwardRef(({ id, classNames, children, asChild, ...props }, forwardedRef) => {
+	const attentionAttrs = useAttentionAttributes(id);
+	return /* @__PURE__ */ jsx(asChild ? Slot : Primitive.div, {
+		...props,
+		...attentionAttrs,
+		className: mx("dx-attention-surface", props.tabIndex === 0 && "dx-focus-ring-inset-over-all", classNames),
+		ref: forwardedRef,
+		children
+	});
+});
+//#endregion
+//#region src/components/ViewStateProvider/view-state-hooks.ts
+var __dxlog_file = "/__w/dxos/dxos/packages/ui/react-ui-attention/src/components/ViewStateProvider/view-state-hooks.ts";
+var VIEW_STATE_NAME = "ViewState";
+var [ViewStateContextProvider, useViewStateContext] = createContext(VIEW_STATE_NAME, { manager: void 0 });
+/** Access the underlying Manager from context. Throws when used outside a `ViewStateProvider`. */
+var useManager = () => {
+	const { manager } = useViewStateContext(VIEW_STATE_NAME);
+	invariant(manager, "useManager() requires a ViewStateProvider ancestor.", {
+		"~LogMeta": "~LogMeta",
+		F: __dxlog_file,
+		L: 28,
+		S: void 0,
+		A: ["manager", "'useManager() requires a ViewStateProvider ancestor.'"]
+	});
+	return manager;
+};
+/** Access the Manager if a provider is present; `undefined` otherwise (e.g. isolated stories/tests). */
+var useManagerOptional = () => {
+	const { manager } = useViewStateContext(VIEW_STATE_NAME);
+	return manager;
+};
+/** Reactive read of an aspect value for a context; yields the aspect default when unset or unprovided. */
+var useViewState = (aspect, contextId) => {
+	const { manager } = useViewStateContext(VIEW_STATE_NAME);
+	const [value, setValue] = useState(() => contextId && manager ? manager.get(aspect, contextId) : aspect.defaultValue());
+	useEffect(() => {
+		if (!contextId || !manager) {
+			setValue(aspect.defaultValue());
+			return;
+		}
+		setValue(manager.get(aspect, contextId));
+		return manager.subscribe(aspect, contextId, setValue);
+	}, [
+		manager,
+		aspect,
+		contextId
+	]);
+	return value;
+};
+var useViewStateActions = (aspect, contextId) => {
+	const { manager } = useViewStateContext(VIEW_STATE_NAME);
+	return useMemo(() => ({
+		set: (value) => {
+			if (contextId) manager?.set(aspect, contextId, value);
+		},
+		update: (fn) => {
+			if (contextId) manager?.update(aspect, contextId, fn);
+		},
+		clear: () => {
+			if (contextId) manager?.set(aspect, contextId, aspect.defaultValue());
+		}
+	}), [
+		manager,
+		aspect,
+		contextId
+	]);
+};
+/** Resolved selection value for `contextId` in the requested `mode` (default `multi`). */
+var useSelection = (contextId, mode = "multi") => resolve(useViewState(aspect, contextId), mode);
+/** Selection mutators for a single context, built on the generic ViewState actions. */
+var useSelectionActions = (contextId) => {
+	const { update, clear } = useViewStateActions(aspect, contextId);
+	return useMemo(() => ({
+		single: (id) => update(() => ({
+			mode: "single",
+			id
+		})),
+		multi: (ids) => update(() => ({
+			mode: "multi",
+			ids: [...ids]
+		})),
+		range: (from, to) => update(() => ({
+			mode: "range",
+			from,
+			to
+		})),
+		toggle: (id) => update((prev) => toggle(prev, id)),
+		clear
+	}), [update, clear]);
+};
+//#endregion
+//#region src/core/backends.ts
+var cacheKey = (aspect, contextId) => `${aspect.key}:${contextId}`;
+/** In-memory backend: state is ephemeral and scoped to the session (never persisted). */
+var MemoryBackend = class {
+	#atoms = /* @__PURE__ */ new Map();
+	atom(aspect, contextId) {
+		const key = cacheKey(aspect, contextId);
+		let atom = this.#atoms.get(key);
+		if (!atom) {
+			atom = Atom.make(aspect.defaultValue()).pipe(Atom.keepAlive);
+			this.#atoms.set(key, atom);
+		}
+		return atom;
+	}
+	contexts(aspect) {
+		const prefix = `${aspect.key}:`;
+		return [...this.#atoms.keys()].filter((key) => key.startsWith(prefix)).map((key) => key.slice(prefix.length));
+	}
+};
+var STORAGE_PREFIX = "dxos:view-state:";
+var storageKeyFor = (aspect, contextId) => `${STORAGE_PREFIX}${aspect.key}:${contextId}`;
+var safeLocalStorage = () => {
+	try {
+		return globalThis.localStorage;
+	} catch {
+		return;
+	}
+};
+/** localStorage-backed backend: seeds atoms from storage, persists on set, syncs across tabs. */
+var LocalBackend = class {
+	#registry;
+	#storage;
+	#atoms = /* @__PURE__ */ new Map();
+	#byStorageKey = /* @__PURE__ */ new Map();
+	#storageListener;
+	constructor({ registry, storage }) {
+		this.#registry = registry;
+		this.#storage = storage ?? safeLocalStorage();
+		if (this.#storage && typeof globalThis.addEventListener === "function") {
+			this.#storageListener = (event) => {
+				if (!event.key || !event.key.startsWith(STORAGE_PREFIX)) return;
+				const entry = this.#byStorageKey.get(event.key);
+				const atom = entry && this.#atoms.get(cacheKey(entry.aspect, entry.contextId));
+				if (entry && atom) this.#registry.set(atom, this.#read(entry.aspect, event.key));
+			};
+			globalThis.addEventListener("storage", this.#storageListener);
+		}
+	}
+	atom(aspect, contextId) {
+		const key = cacheKey(aspect, contextId);
+		let atom = this.#atoms.get(key);
+		if (!atom) {
+			const storageKey = storageKeyFor(aspect, contextId);
+			atom = Atom.make(this.#read(aspect, storageKey)).pipe(Atom.keepAlive);
+			this.#atoms.set(key, atom);
+			this.#byStorageKey.set(storageKey, {
+				aspect,
+				contextId
+			});
+		}
+		return atom;
+	}
+	persist(aspect, contextId, value) {
+		this.#storage?.setItem(storageKeyFor(aspect, contextId), JSON.stringify(Schema.encodeSync(aspect.schema)(value)));
+	}
+	contexts(aspect) {
+		if (!this.#storage) {
+			const prefix = `${aspect.key}:`;
+			return [...this.#atoms.keys()].filter((key) => key.startsWith(prefix)).map((key) => key.slice(prefix.length));
+		}
+		const prefix = storageKeyFor(aspect, "");
+		const ids = [];
+		for (let index = 0; index < this.#storage.length; index++) {
+			const key = this.#storage.key(index);
+			if (key?.startsWith(prefix)) ids.push(key.slice(prefix.length));
+		}
+		return ids;
+	}
+	dispose() {
+		if (this.#storageListener && typeof globalThis.removeEventListener === "function") globalThis.removeEventListener("storage", this.#storageListener);
+		this.#atoms.clear();
+		this.#byStorageKey.clear();
+	}
+	#read(aspect, storageKey) {
+		const raw = this.#storage?.getItem(storageKey);
+		if (raw == null) return aspect.defaultValue();
+		try {
+			return Schema.decodeUnknownSync(aspect.schema)(JSON.parse(raw));
+		} catch {
+			return aspect.defaultValue();
+		}
+	}
+};
+var createDefaultBackends = (registry) => ({
+	memory: new MemoryBackend(),
+	local: new LocalBackend({ registry })
+});
+//#endregion
+//#region src/components/ViewStateProvider/ViewStateProvider.tsx
+/** Provides the per-context UI state manager. Replaces the former `SelectionProvider`. */
+var ViewStateProvider = ({ children, manager: managerProp }) => {
+	const registry = useContext(RegistryContext);
+	return /* @__PURE__ */ jsx(ViewStateContextProvider, {
+		manager: useDefaultValue(managerProp, () => new Manager({
+			registry,
+			backends: createDefaultBackends(registry)
+		})),
+		children
+	});
+};
+//#endregion
+export { useManager as a, useSelectionActions as c, AttendableContainer as d, RootAttentionProvider as f, useAttentionContext as g, useAttentionAttributes as h, createDefaultBackends as i, useViewState as l, useAttention as m, LocalBackend as n, useManagerOptional as o, useAttended as p, MemoryBackend as r, useSelection as s, ViewStateProvider as t, useViewStateActions as u };
+
+//# sourceMappingURL=chunk-ViewStateProvider.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-ViewStateProvider.mjs","names":[],"sources":["../../src/components/AttentionProvider/attention-context.ts","../../src/components/AttentionProvider/AttentionProvider.tsx","../../src/components/ViewStateProvider/view-state-hooks.ts","../../src/core/backends.ts","../../src/components/ViewStateProvider/ViewStateProvider.tsx"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport { createContext } from '@radix-ui/react-context';\nimport { useEffect, useMemo, useState } from 'react';\n\nimport { ATTENDABLE_ATTRIBUTE, type Attention, AttentionManager } from '../../types/Attention';\n\n// Kept out of `AttentionProvider.tsx`: react-refresh only fast-refreshes a module whose exports are\n// all components, so the context and hooks exported beside them force a full page reload on every edit.\n\nexport const ATTENTION_NAME = 'Attention';\nexport const ATTENTION_SOURCE_ATTRIBUTE = 'data-w-attention-source';\n\nexport type AttentionContextValue = {\n  attention: AttentionManager;\n};\n\nexport const [AttentionContextProvider, useAttentionContext] = createContext<AttentionContextValue>(ATTENTION_NAME, {\n  attention: undefined as unknown as AttentionManager,\n});\n\nexport const UNKNOWN_ATTENDABLE = { hasAttention: false, isAncestor: false, isRelated: false } as Attention;\n\n/**\n * Subscribe to the attention state for a qualified graph ID.\n */\n// TODO(burdon): Unify with selection state and change to contextId?\nexport const useAttention = (attendableId?: string): Attention => {\n  const { attention } = useAttentionContext(ATTENTION_NAME);\n  const [state, setState] = useState<Attention>(UNKNOWN_ATTENDABLE);\n  useEffect(() => {\n    if (!attendableId || !attention) {\n      setState(UNKNOWN_ATTENDABLE);\n      return;\n    }\n\n    const currentState = attention.get(attendableId);\n    setState(currentState);\n\n    return attention.subscribe(attendableId, (newState) => {\n      setState(newState);\n    });\n  }, [attention, attendableId]);\n\n  return state;\n};\n\nexport const useAttended = () => {\n  const { attention } = useAttentionContext(ATTENTION_NAME);\n  const [current, setCurrent] = useState<readonly string[]>([]);\n  useEffect(() => {\n    if (!attention) {\n      return;\n    }\n\n    setCurrent(attention.getCurrent());\n\n    return attention.subscribeCurrent((newCurrent) => {\n      setCurrent(newCurrent);\n    });\n  }, [attention]);\n\n  return current;\n};\n\n/**\n * Computes HTML element attributes to apply so the attention system can detect changes.\n */\nexport const useAttentionAttributes = (attendableId?: string) => {\n  const { hasAttention } = useAttention(attendableId);\n  return useMemo(() => {\n    const attributes: Record<string, string | undefined> = { [ATTENDABLE_ATTRIBUTE]: attendableId };\n    if (hasAttention) {\n      attributes[ATTENTION_SOURCE_ATTRIBUTE] = 'true';\n    }\n\n    return attributes;\n  }, [attendableId, hasAttention]);\n};\n","//\n// Copyright 2024 DXOS.org\n//\n\nimport { RegistryContext } from '@effect-atom/atom-react';\nimport { Primitive } from '@radix-ui/react-primitive';\nimport { Slot } from '@radix-ui/react-slot';\nimport React, {\n  type ComponentPropsWithRef,\n  type FocusEvent,\n  type PropsWithChildren,\n  forwardRef,\n  useCallback,\n  useContext,\n} from 'react';\n\nimport { log } from '@dxos/log';\nimport { useDefaultValue } from '@dxos/react-hooks';\nimport { type ThemedClassName } from '@dxos/react-ui';\nimport { mx } from '@dxos/ui-theme';\n\nimport { ATTENDABLE_SELECTOR, AttentionManager, getAttendables } from '../../types/Attention';\nimport { AttentionContextProvider, useAttentionAttributes } from './attention-context';\n\ntype RootAttentionProviderProps = PropsWithChildren<{\n  attention?: AttentionManager;\n  onChange?: (nextAttended: string[]) => void;\n}>;\n\nconst RootAttentionProvider = ({ children, attention: propsAttention, onChange }: RootAttentionProviderProps) => {\n  const registry = useContext(RegistryContext);\n  const attention = useDefaultValue(propsAttention, () => new AttentionManager(registry));\n\n  const handleFocus = useCallback(\n    (event: FocusEvent) => {\n      // NOTE(thure): Use the following to debug focus movement across the app:\n      log('focus', { related: event.relatedTarget, target: event.target });\n\n      const selector = [\n        ATTENDABLE_SELECTOR,\n        ...Array.from(document.querySelectorAll('[aria-controls]')).map(\n          (el) => `[id=\"${el.getAttribute('aria-controls')}\"]`,\n        ),\n      ].join(',');\n      const prev = attention.getCurrent();\n      const next = getAttendables(selector, event.target);\n      // TODO(wittjosiah): Not allowing empty state means that the attended item is not strictly guaranteed to be in the DOM.\n      //   Currently this depends on the deck in order to ensure that when the attended item is removed something else is attended.\n      // Only update state if the result is different and not empty.\n      if (next.length > 0 && (prev.length !== next.length || !!prev.find((id, index) => next[index] !== id))) {\n        attention.update(next);\n        onChange?.(next);\n      }\n    },\n    [attention, onChange],\n  );\n\n  return (\n    <AttentionContextProvider attention={attention}>\n      <div className='contents' onFocusCapture={handleFocus}>\n        {children}\n      </div>\n    </AttentionContextProvider>\n  );\n};\n\nexport type AttendableContainerProps = ThemedClassName<\n  ComponentPropsWithRef<'div'> & { id: string; asChild?: boolean }\n>;\n\n/**\n * Note that DeckPlugin and StackPlugin both handle attention on their own,\n * and when rendering content in those cases it is not necessary to also render an `AttendableContainer`.\n * This component is primarily for Storybook stories and other testing scenarios,\n * or the rare cases where an attendable entity is rendered outside of either of those plugins.\n */\nconst AttendableContainer = forwardRef<HTMLDivElement, AttendableContainerProps>(\n  ({ id, classNames, children, asChild, ...props }, forwardedRef) => {\n    const attentionAttrs = useAttentionAttributes(id);\n    const Comp = asChild ? Slot : Primitive.div;\n    return (\n      <Comp\n        {...props}\n        {...attentionAttrs}\n        className={mx('dx-attention-surface', props.tabIndex === 0 && 'dx-focus-ring-inset-over-all', classNames)}\n        ref={forwardedRef}\n      >\n        {children}\n      </Comp>\n    );\n  },\n);\n\nexport { AttendableContainer, RootAttentionProvider };\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport { createContext } from '@radix-ui/react-context';\nimport { useEffect, useMemo, useState } from 'react';\n\nimport { invariant } from '@dxos/invariant';\n\nimport { Selection, ViewState } from '../../types';\n\n// Kept out of `ViewStateProvider.tsx`: react-refresh only fast-refreshes a module whose exports are\n// all components, so the context and hooks exported beside it force a full page reload on every edit.\n\nexport const VIEW_STATE_NAME = 'ViewState';\n\nexport type ViewStateContextValue = { manager?: ViewState.Manager };\n\n// Default value lets consumers render outside a provider (isolated stories/tests) without throwing;\n// `manager` reads as `undefined` and hooks fall back to aspect defaults / no-op actions.\nexport const [ViewStateContextProvider, useViewStateContext] = createContext<ViewStateContextValue>(VIEW_STATE_NAME, {\n  manager: undefined,\n});\n\n/** Access the underlying Manager from context. Throws when used outside a `ViewStateProvider`. */\nexport const useManager = (): ViewState.Manager => {\n  const { manager } = useViewStateContext(VIEW_STATE_NAME);\n  invariant(manager, 'useManager() requires a ViewStateProvider ancestor.');\n  return manager;\n};\n\n/** Access the Manager if a provider is present; `undefined` otherwise (e.g. isolated stories/tests). */\nexport const useManagerOptional = (): ViewState.Manager | undefined => {\n  const { manager } = useViewStateContext(VIEW_STATE_NAME);\n  return manager;\n};\n\n/** Reactive read of an aspect value for a context; yields the aspect default when unset or unprovided. */\nexport const useViewState = <T, Encoded = T>(aspect: ViewState.Aspect<T, Encoded>, contextId?: string): T => {\n  const { manager } = useViewStateContext(VIEW_STATE_NAME);\n  const [value, setValue] = useState<T>(() =>\n    contextId && manager ? manager.get(aspect, contextId) : aspect.defaultValue(),\n  );\n  useEffect(() => {\n    if (!contextId || !manager) {\n      setValue(aspect.defaultValue());\n      return;\n    }\n    setValue(manager.get(aspect, contextId));\n    return manager.subscribe(aspect, contextId, setValue);\n  }, [manager, aspect, contextId]);\n  return value;\n};\n\nexport type UseViewStateActions<T> = {\n  set: (value: T) => void;\n  update: (fn: (prev: T) => T) => void;\n  clear: () => void;\n};\n\nexport const useViewStateActions = <T, Encoded = T>(\n  aspect: ViewState.Aspect<T, Encoded>,\n  contextId?: string,\n): UseViewStateActions<T> => {\n  const { manager } = useViewStateContext(VIEW_STATE_NAME);\n  return useMemo<UseViewStateActions<T>>(\n    () => ({\n      set: (value) => {\n        if (contextId) {\n          manager?.set(aspect, contextId, value);\n        }\n      },\n      update: (fn) => {\n        if (contextId) {\n          manager?.update(aspect, contextId, fn);\n        }\n      },\n      clear: () => {\n        if (contextId) {\n          manager?.set(aspect, contextId, aspect.defaultValue());\n        }\n      },\n    }),\n    [manager, aspect, contextId],\n  );\n};\n\n/** Resolved selection value for `contextId` in the requested `mode` (default `multi`). */\nexport const useSelection = <T extends Selection.SelectionMode>(\n  contextId?: string,\n  mode: T = 'multi' as T,\n): Selection.Result<T> => Selection.resolve(useViewState(Selection.aspect, contextId), mode);\n\nexport type UseSelectionActions = {\n  single: (id: string) => void;\n  multi: (ids: string[]) => void;\n  range: (from: string, to: string) => void;\n  toggle: (id: string) => void;\n  clear: () => void;\n};\n\n/** Selection mutators for a single context, built on the generic ViewState actions. */\nexport const useSelectionActions = (contextId?: string): UseSelectionActions => {\n  const { update, clear } = useViewStateActions(Selection.aspect, contextId);\n  return useMemo<UseSelectionActions>(\n    () => ({\n      single: (id) => update(() => ({ mode: 'single', id })),\n      multi: (ids) => update(() => ({ mode: 'multi', ids: [...ids] })),\n      range: (from, to) => update(() => ({ mode: 'range', from, to })),\n      toggle: (id) => update((prev) => Selection.toggle(prev, id)),\n      clear,\n    }),\n    [update, clear],\n  );\n};\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport { Atom, type Registry } from '@effect-atom/atom';\nimport * as Schema from 'effect/Schema';\n\nimport { ViewState } from '../types';\n\n// Only the stable `key` string is needed to form the map key; avoids variance issues with Aspect<T>.\nconst cacheKey = (aspect: { key: string }, contextId: string) => `${aspect.key}:${contextId}`;\n\n/** In-memory backend: state is ephemeral and scoped to the session (never persisted). */\nexport class MemoryBackend implements ViewState.Backend {\n  readonly #atoms = new Map<string, Atom.Writable<unknown>>();\n\n  atom<T, Encoded>(aspect: ViewState.Aspect<T, Encoded>, contextId: string): Atom.Writable<T> {\n    const key = cacheKey(aspect, contextId);\n    let atom = this.#atoms.get(key);\n    if (!atom) {\n      // `keepAlive` pins the node so a written value survives for the session; without it the registry\n      // sweeps the unsubscribed atom back to its default, dropping state that no UI happens to observe\n      // (e.g. a selection read on-demand by an agent tool rather than a live subscriber).\n      atom = Atom.make<unknown>(aspect.defaultValue()).pipe(Atom.keepAlive);\n      this.#atoms.set(key, atom);\n    }\n    // Cast bridges the per-aspect value type erased by the shared atom map; safe by construction.\n    return atom as Atom.Writable<T>;\n  }\n\n  contexts<T, Encoded>(aspect: ViewState.Aspect<T, Encoded>): string[] {\n    const prefix = `${aspect.key}:`;\n    return [...this.#atoms.keys()].filter((key) => key.startsWith(prefix)).map((key) => key.slice(prefix.length));\n  }\n}\n\nconst STORAGE_PREFIX = 'dxos:view-state:';\n\nconst storageKeyFor = (aspect: { key: string }, contextId: string) => `${STORAGE_PREFIX}${aspect.key}:${contextId}`;\n\n// Accessing `globalThis.localStorage` can throw a SecurityError in sandboxed iframes or when\n// storage is blocked; degrade to in-memory behaviour instead of crashing.\nconst safeLocalStorage = (): Storage | undefined => {\n  try {\n    return globalThis.localStorage;\n  } catch {\n    return undefined;\n  }\n};\n\nexport interface LocalBackendOptions {\n  readonly registry: Registry.Registry;\n  /** Injectable for tests; defaults to `window.localStorage`. */\n  readonly storage?: Storage;\n}\n\n/** localStorage-backed backend: seeds atoms from storage, persists on set, syncs across tabs. */\nexport class LocalBackend implements ViewState.Backend {\n  readonly #registry: Registry.Registry;\n  // Absent in non-browser contexts (SSR/tests without injection); the backend then degrades to\n  // ephemeral, in-memory behaviour rather than crashing on a missing `localStorage`.\n  readonly #storage: Storage | undefined;\n  readonly #atoms = new Map<string, Atom.Writable<unknown>>();\n  // Reverse map: storage key -> (aspect, contextId) so `storage` events can target the right atom.\n  readonly #byStorageKey = new Map<string, { aspect: ViewState.Aspect<unknown, unknown>; contextId: string }>();\n  #storageListener?: (event: StorageEvent) => void;\n\n  constructor({ registry, storage }: LocalBackendOptions) {\n    this.#registry = registry;\n    this.#storage = storage ?? safeLocalStorage();\n    if (this.#storage && typeof globalThis.addEventListener === 'function') {\n      this.#storageListener = (event) => {\n        if (!event.key || !event.key.startsWith(STORAGE_PREFIX)) {\n          return;\n        }\n        const entry = this.#byStorageKey.get(event.key);\n        const atom = entry && this.#atoms.get(cacheKey(entry.aspect, entry.contextId));\n        if (entry && atom) {\n          this.#registry.set(atom, this.#read(entry.aspect, event.key));\n        }\n      };\n      globalThis.addEventListener('storage', this.#storageListener);\n    }\n  }\n\n  atom<T, Encoded>(aspect: ViewState.Aspect<T, Encoded>, contextId: string): Atom.Writable<T> {\n    const key = cacheKey(aspect, contextId);\n    let atom = this.#atoms.get(key);\n    if (!atom) {\n      const storageKey = storageKeyFor(aspect, contextId);\n      // `keepAlive` pins the node so the in-memory value stays consistent with storage without a live\n      // subscriber; otherwise the registry sweeps the unsubscribed atom back to its creation-time seed.\n      atom = Atom.make<unknown>(this.#read(aspect, storageKey)).pipe(Atom.keepAlive);\n      this.#atoms.set(key, atom);\n      // Cast erases the per-aspect value type so the reverse map can hold aspects of any `T`; the\n      // stored aspect is only used to re-read/decode its own value, so the erasure is safe.\n      this.#byStorageKey.set(storageKey, { aspect: aspect as ViewState.Aspect<unknown, unknown>, contextId });\n    }\n    // Cast bridges the per-aspect value type erased by the shared atom map; safe by construction.\n    return atom as Atom.Writable<T>;\n  }\n\n  persist<T, Encoded>(aspect: ViewState.Aspect<T, Encoded>, contextId: string, value: T): void {\n    this.#storage?.setItem(storageKeyFor(aspect, contextId), JSON.stringify(Schema.encodeSync(aspect.schema)(value)));\n  }\n\n  contexts<T, Encoded>(aspect: ViewState.Aspect<T, Encoded>): string[] {\n    if (!this.#storage) {\n      // No persistent storage: fall back to the in-memory atoms (mirrors `atom()`'s ephemeral path).\n      const prefix = `${aspect.key}:`;\n      return [...this.#atoms.keys()].filter((key) => key.startsWith(prefix)).map((key) => key.slice(prefix.length));\n    }\n    const prefix = storageKeyFor(aspect, '');\n    const ids: string[] = [];\n    for (let index = 0; index < this.#storage.length; index++) {\n      const key = this.#storage.key(index);\n      if (key?.startsWith(prefix)) {\n        ids.push(key.slice(prefix.length));\n      }\n    }\n    return ids;\n  }\n\n  dispose(): void {\n    if (this.#storageListener && typeof globalThis.removeEventListener === 'function') {\n      globalThis.removeEventListener('storage', this.#storageListener);\n    }\n    // Allow safe reuse after disposal: drop cached atoms and their reverse-key entries.\n    this.#atoms.clear();\n    this.#byStorageKey.clear();\n  }\n\n  #read<T, Encoded>(aspect: ViewState.Aspect<T, Encoded>, storageKey: string): T {\n    const raw = this.#storage?.getItem(storageKey);\n    if (raw == null) {\n      return aspect.defaultValue();\n    }\n    try {\n      return Schema.decodeUnknownSync(aspect.schema)(JSON.parse(raw));\n    } catch {\n      // Tolerate stale/corrupt entries (e.g., a prior schema shape) by falling back to the default.\n      return aspect.defaultValue();\n    }\n  }\n}\n\nexport const createDefaultBackends = (\n  registry: Registry.Registry,\n): Record<ViewState.BackendName, ViewState.Backend> => ({\n  memory: new MemoryBackend(),\n  local: new LocalBackend({ registry }),\n});\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport { RegistryContext } from '@effect-atom/atom-react';\nimport React, { type PropsWithChildren, useContext } from 'react';\n\nimport { useDefaultValue } from '@dxos/react-hooks';\n\nimport { createDefaultBackends } from '../../core';\nimport { ViewState } from '../../types';\nimport { ViewStateContextProvider } from './view-state-hooks';\n\n/** Provides the per-context UI state manager. Replaces the former `SelectionProvider`. */\nexport const ViewStateProvider = ({\n  children,\n  manager: managerProp,\n}: PropsWithChildren<{ manager?: ViewState.Manager }>) => {\n  const registry = useContext(RegistryContext);\n  const manager = useDefaultValue(\n    managerProp,\n    () => new ViewState.Manager({ registry, backends: createDefaultBackends(registry) }),\n  );\n  return <ViewStateContextProvider manager={manager}>{children}</ViewStateContextProvider>;\n};\n"],"mappings":"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"}