@dxos/react-ui-attention 0.6.13 → 0.6.14-main.2b6a0f3

package/dist/lib/browser/index.mjs

@@ -1,7 +1,108 @@
+// packages/ui/react-ui-attention/src/attention.ts
+import { untracked } from "@preact/signals-core";
+import { create, S } from "@dxos/echo-schema";
+import { ComplexMap } from "@dxos/util";
+var AttentionSchema = S.mutable(S.Struct({
+  hasAttention: S.Boolean,
+  isAncestor: S.Boolean,
+  isRelated: S.Boolean
+}));
+var stringKey = (key) => key.join(",");
+var AttentionManager = class {
+  constructor(initial = []) {
+    // Each attention path is associated with an attention object.
+    // The lookup is not a reactive object to ensure that attention for each path is subscribable independently.
+    this._map = new ComplexMap(stringKey);
+    this._state = create({
+      current: initial
+    });
+  }
+  /**
+  * Currently attended element.
+  */
+  get current() {
+    return this._state.current;
+  }
+  /**
+  * All attention paths.
+  */
+  keys() {
+    return this._map.keys();
+  }
+  /**
+  * Get the attention state for a given path.
+  */
+  get(key) {
+    const object = this._map.get(key);
+    if (object) {
+      return object;
+    }
+    const newObject = create(AttentionSchema, {
+      hasAttention: false,
+      isAncestor: false,
+      isRelated: false
+    });
+    this._map.set(key, newObject);
+    return newObject;
+  }
+  /**
+  * Update the currently attended element.
+  */
+  update(nextKey) {
+    const currentKey = untracked(() => this.current);
+    const currentRelatedTo = currentKey[0];
+    const nextRelatedTo = nextKey[0];
+    const currentRelatedKeys = this.keys().filter((key) => key[0] === currentRelatedTo);
+    const nextRelatedKeys = this.keys().filter((key) => key[0] === nextRelatedTo && stringKey(key) !== stringKey(nextKey));
+    const prevRelatedKeys = currentRelatedKeys.filter((curr) => !nextRelatedKeys.find((next) => stringKey(curr) === stringKey(next)));
+    const currentAncestorKeys = currentKey.slice(1).map((_, i) => currentKey.slice(i + 1, currentKey.length));
+    const nextAncestorKeys = nextKey.slice(1).map((_, i) => nextKey.slice(i + 1, nextKey.length));
+    const prevAncestorKeys = currentAncestorKeys.filter((curr) => !nextAncestorKeys.find((next) => stringKey(curr) === stringKey(next)));
+    this._state.current = nextKey;
+    prevRelatedKeys.forEach((key) => this._set(key, {}));
+    prevAncestorKeys.forEach((key) => this._set(key, {}));
+    nextRelatedKeys.forEach((key) => this._set(key, {
+      isRelated: true
+    }));
+    nextAncestorKeys.forEach((key) => this._set(key, {
+      isAncestor: true
+    }));
+    this._set(nextKey, {
+      hasAttention: true
+    });
+  }
+  _set(key, attention) {
+    const object = this.get(key);
+    object.hasAttention = attention.hasAttention ?? false;
+    object.isAncestor = attention.isAncestor ?? false;
+    object.isRelated = attention.isRelated ?? false;
+  }
+};
+var getAttendables = (selector, cursor, acc = []) => {
+  const closestAttendable = cursor.closest(selector);
+  if (closestAttendable) {
+    const attendableId = closestAttendable.getAttribute("data-attendable-id");
+    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)
+  ];
+};
+
 // packages/ui/react-ui-attention/src/components/AttentionGlyph.tsx
 import React, { forwardRef } from "react";
 import { mx } from "@dxos/react-ui-theme";
-var attentionGlyphStyles = "inline-block rounded-sm is-3 bs-3 bg-transparent text-accentText transition-colors [[data-attention=true]_&]:bg-accentSurface [[data-attention=true]_&]:fg-inverse [[aria-current][data-attention=true]_&]:bg-accentSurface [[aria-current][data-attention=true]_&]:fg-inverse";
+var attentionGlyphStyles = "inline-block rounded-sm is-3 bs-3 bg-transparent text-accentText transition-colors [[data-attention=true]_&]:bg-accentSurface [[data-attention=true]_&]:text-inverse [[aria-current][data-attention=true]_&]:bg-accentSurface [[aria-current][data-attention=true]_&]:text-inverse";
 var presenceIconStyles = "is-3 bs-3 group-[[aria-current]_&:hover]/attentionGlyphButton:hidden group-[[aria-current]_&:focus]/attentionGlyphButton:hidden group-[[data-attention=true]_&:hover]/attentionGlyphButton:hidden group-[[data-attention=true]_&:focus]/attentionGlyphButton:hidden group-[[aria-current][data-attention=true]_&:hover]/attentionGlyphButton:hidden group-[[aria-current][data-attention=true]_&:focus]/attentionGlyphButton:hidden";
 var PresenceOne = () => {
   return /* @__PURE__ */ React.createElement("svg", {
@@ -47,72 +148,105 @@ var AttentionGlyph = /* @__PURE__ */ forwardRef(({ presence, classNames, ...prop
 
 // packages/ui/react-ui-attention/src/components/AttentionProvider.tsx
 import { createContext } from "@radix-ui/react-context";
-import { useControllableState } from "@radix-ui/react-use-controllable-state";
-import React2 from "react";
+import React2, { useMemo } from "react";
+import { useDefaultValue } from "@dxos/react-ui";
 var ATTENTION_NAME = "Attention";
+var ATTENABLE_ATTRIBUTE = "data-attendable-id";
+var ATTENTION_SOURCE_ATTRIBUTE = "data-is-attention-source";
 var [AttentionContextProvider, useAttentionContext] = createContext(ATTENTION_NAME, {
-  attended: /* @__PURE__ */ new Set()
+  attention: new AttentionManager(),
+  path: []
 });
-var useHasAttention = (attendableId) => {
-  const { attended } = useAttentionContext(ATTENTION_NAME);
-  return attendableId ? attended.has(attendableId) : false;
+var UNKNOWN_ATTENDABLE = {
+  hasAttention: false,
+  isAncestor: false,
+  isRelated: false
 };
-var createAttendableAttributes = (attendableId) => {
-  return {
-    "data-attendable-id": attendableId
-  };
+var useAttention = (attendableId) => {
+  const { attention, path } = useAttentionContext(ATTENTION_NAME);
+  if (!attendableId) {
+    return UNKNOWN_ATTENDABLE;
+  }
+  const current = [
+    attendableId,
+    ...path
+  ];
+  return attention.get(current);
 };
-var getAttendables = (selector, cursor, acc = []) => {
-  const closestAttendable = cursor.closest(selector);
-  if (!closestAttendable) {
-    return acc;
-  } else {
-    const attendableId = closestAttendable.getAttribute("data-attendable-id");
-    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);
+var useAttended = () => {
+  const { attention } = useAttentionContext(ATTENTION_NAME);
+  return attention.current;
+};
+var useAttendableAttributes = (attendableId) => {
+  const { hasAttention } = useAttention(attendableId);
+  return useMemo(() => {
+    const attributes = {
+      [ATTENABLE_ATTRIBUTE]: attendableId
+    };
+    if (hasAttention) {
+      attributes[ATTENTION_SOURCE_ATTRIBUTE] = "true";
     }
-  }
+    return attributes;
+  }, [
+    attendableId,
+    hasAttention
+  ]);
+};
+var useAttentionPath = () => {
+  const { path } = useAttentionContext(ATTENTION_NAME);
+  return path;
 };
-var AttentionProvider = ({ children, attended: propsAttended, defaultAttended, onChangeAttend }) => {
-  const [attended = /* @__PURE__ */ new Set(), setAttended] = useControllableState({
-    prop: propsAttended,
-    defaultProp: defaultAttended,
-    onChange: onChangeAttend
-  });
+var RootAttentionProvider = ({ children, attention: propsAttention, onChange }) => {
+  const attention = useDefaultValue(propsAttention, () => new AttentionManager());
   const handleFocus = (event) => {
     const selector = [
       "[data-attendable-id]",
       ...Array.from(document.querySelectorAll("[aria-controls]")).map((el) => `[id="${el.getAttribute("aria-controls")}"]`)
     ].join(",");
-    const nextAttended = new Set(getAttendables(selector, event.target));
-    const [prev, next] = [
-      Array.from(attended),
-      Array.from(nextAttended)
-    ];
-    (prev.length !== next.length || !!prev.find((id, index) => next[index] !== id)) && setAttended(nextAttended);
+    const prev = attention.current;
+    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);
+    }
   };
   return /* @__PURE__ */ React2.createElement(AttentionContextProvider, {
-    attended
+    attention,
+    path: []
   }, /* @__PURE__ */ React2.createElement("div", {
     role: "none",
     className: "contents",
     onFocusCapture: handleFocus
   }, children));
 };
+var AttentionProvider = ({ id, children }) => {
+  const { attention, path } = useAttentionContext(ATTENTION_NAME);
+  const nextPath = useMemo(() => [
+    id,
+    ...path
+  ], [
+    id,
+    path
+  ]);
+  return /* @__PURE__ */ React2.createElement(AttentionContextProvider, {
+    attention,
+    path: nextPath
+  }, children);
+};
 export {
+  ATTENABLE_ATTRIBUTE,
   ATTENTION_NAME,
+  ATTENTION_SOURCE_ATTRIBUTE,
   AttentionGlyph,
+  AttentionManager,
   AttentionProvider,
-  createAttendableAttributes,
+  AttentionSchema,
+  RootAttentionProvider,
+  getAttendables,
+  useAttendableAttributes,
+  useAttended,
+  useAttention,
   useAttentionContext,
-  useHasAttention
+  useAttentionPath
 };
 //# sourceMappingURL=index.mjs.map

package/dist/lib/browser/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../../src/components/AttentionGlyph.tsx", "../../../src/components/AttentionProvider.tsx"],
-  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport { type Primitive } from '@radix-ui/react-primitive';\nimport React, { type ComponentPropsWithRef, forwardRef } from 'react';\n\nimport { type ThemedClassName } from '@dxos/react-ui';\nimport { mx } from '@dxos/react-ui-theme';\n\nconst attentionGlyphStyles =\n  'inline-block rounded-sm is-3 bs-3 bg-transparent text-accentText transition-colors [[data-attention=true]_&]:bg-accentSurface [[data-attention=true]_&]:fg-inverse [[aria-current][data-attention=true]_&]:bg-accentSurface [[aria-current][data-attention=true]_&]:fg-inverse';\n\nconst presenceIconStyles =\n  'is-3 bs-3 group-[[aria-current]_&:hover]/attentionGlyphButton:hidden group-[[aria-current]_&:focus]/attentionGlyphButton:hidden group-[[data-attention=true]_&:hover]/attentionGlyphButton:hidden group-[[data-attention=true]_&:focus]/attentionGlyphButton:hidden group-[[aria-current][data-attention=true]_&:hover]/attentionGlyphButton:hidden group-[[aria-current][data-attention=true]_&:focus]/attentionGlyphButton:hidden';\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 type AttentionGlyphProps = {\n  presence?: 'none' | 'one' | 'many';\n} & ThemedClassName<Omit<ComponentPropsWithRef<typeof Primitive.span>, 'children'>>;\n\nexport const AttentionGlyph = forwardRef<HTMLSpanElement, AttentionGlyphProps>(\n  ({ presence, classNames, ...props }, forwardedRef) => {\n    return (\n      <span role='none' {...props} className={mx(attentionGlyphStyles, classNames)} ref={forwardedRef}>\n        {presence === 'many' && <PresenceMany />}\n        {presence === 'one' && <PresenceOne />}\n      </span>\n    );\n  },\n);\n", "//\n// Copyright 2024 DXOS.org\n//\n\n// NOTE(thure): The following unused imports quell TS2742 (“likely not portable”).\n\n// eslint-disable-next-line unused-imports/no-unused-imports\nimport { createContext, type Scope, type CreateScope } from '@radix-ui/react-context';\nimport { useControllableState } from '@radix-ui/react-use-controllable-state';\n// eslint-disable-next-line unused-imports/no-unused-imports\nimport React, { ComponentProps, type FocusEvent, type HTMLAttributes, type PropsWithChildren, useState } from 'react';\n\nconst ATTENTION_NAME = 'Attention';\n\ntype AttentionContextValue = {\n  attended: Set<string>;\n};\n\nconst [AttentionContextProvider, useAttentionContext] = createContext<AttentionContextValue>(ATTENTION_NAME, {\n  attended: new Set(),\n});\n\nconst useHasAttention = (attendableId?: string) => {\n  const { attended } = useAttentionContext(ATTENTION_NAME);\n  return attendableId ? attended.has(attendableId) : false;\n};\n\n/**\n * Computes HTML element attributes to apply so the attention system can detect changes\n * @param attendableId\n */\nconst createAttendableAttributes = (attendableId?: string) => {\n  return { 'data-attendable-id': attendableId };\n};\n\n/**\n * Accumulates all attendable id’s between the element provided and the root, inclusive.\n */\nconst 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    return acc;\n  } else {\n    const attendableId = closestAttendable.getAttribute('data-attendable-id');\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      // (attempt tail recursion)\n      return !closestAttendable.parentElement ? acc : getAttendables(selector, closestAttendable.parentElement, acc);\n    }\n  }\n};\n\nconst AttentionProvider = ({\n  children,\n  attended: propsAttended,\n  defaultAttended,\n  onChangeAttend,\n}: PropsWithChildren<\n  Partial<{\n    attended: Set<string>;\n    onChangeAttend: (nextAttended: Set<string>) => void;\n    defaultAttended: Set<string>;\n  }>\n>) => {\n  const [attended = new Set(), setAttended] = useControllableState<Set<string>>({\n    prop: propsAttended,\n    defaultProp: defaultAttended,\n    onChange: onChangeAttend,\n  });\n  const handleFocus = (event: FocusEvent) => {\n    const selector = [\n      '[data-attendable-id]',\n      ...Array.from(document.querySelectorAll('[aria-controls]')).map(\n        (el) => `[id=\"${el.getAttribute('aria-controls')}\"]`,\n      ),\n    ].join(',');\n    const nextAttended = new Set(getAttendables(selector, event.target));\n    const [prev, next] = [Array.from(attended), Array.from(nextAttended)];\n    // Only update state if the result is different.\n    (prev.length !== next.length || !!prev.find((id, index) => next[index] !== id)) && setAttended(nextAttended);\n  };\n  return (\n    <AttentionContextProvider attended={attended}>\n      <div role='none' className='contents' onFocusCapture={handleFocus}>\n        {children}\n      </div>\n    </AttentionContextProvider>\n  );\n};\n\nexport { AttentionProvider, useAttentionContext, useHasAttention, createAttendableAttributes, ATTENTION_NAME };\n\nexport type { AttentionContextValue };\n"],
-  "mappings": "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",
-  "names": ["React", "forwardRef", "mx", "attentionGlyphStyles", "presenceIconStyles", "PresenceOne", "svg", "width", "height", "viewBox", "className", "fill", "xmlns", "circle", "cx", "cy", "r", "PresenceMany", "path", "d", "AttentionGlyph", "forwardRef", "presence", "classNames", "props", "forwardedRef", "span", "role", "mx", "ref", "createContext", "useControllableState", "React", "ATTENTION_NAME", "AttentionContextProvider", "useAttentionContext", "createContext", "attended", "Set", "useHasAttention", "attendableId", "has", "createAttendableAttributes", "getAttendables", "selector", "cursor", "acc", "closestAttendable", "closest", "getAttribute", "trigger", "document", "querySelector", "push", "parentElement", "AttentionProvider", "children", "propsAttended", "defaultAttended", "onChangeAttend", "setAttended", "useControllableState", "prop", "defaultProp", "onChange", "handleFocus", "event", "Array", "from", "querySelectorAll", "map", "el", "join", "nextAttended", "target", "prev", "next", "length", "find", "id", "index", "React", "div", "role", "className", "onFocusCapture"]
+  "sources": ["../../../src/attention.ts", "../../../src/components/AttentionGlyph.tsx", "../../../src/components/AttentionProvider.tsx"],
+  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport { untracked } from '@preact/signals-core';\n\nimport { create, type ReactiveObject, S } from '@dxos/echo-schema';\nimport { ComplexMap } from '@dxos/util';\n\nexport const AttentionSchema = S.mutable(\n  S.Struct({\n    hasAttention: S.Boolean,\n    isAncestor: S.Boolean,\n    isRelated: S.Boolean,\n  }),\n);\n\nexport type Attention = S.Schema.Type<typeof AttentionSchema>;\n\nconst stringKey = (key: string[]) => key.join(',');\n\n/**\n * Manages attention state for an application.\n */\nexport class AttentionManager {\n  // Each attention path is associated with an attention object.\n  // The lookup is not a reactive object to ensure that attention for each path is subscribable independently.\n  private readonly _map = new ComplexMap<string[], ReactiveObject<Attention>>(stringKey);\n  private readonly _state: ReactiveObject<{ current: string[] }>;\n\n  constructor(initial: string[] = []) {\n    this._state = create({ current: initial });\n  }\n\n  /**\n   * Currently attended element.\n   */\n  get current() {\n    return this._state.current;\n  }\n\n  /**\n   * All attention paths.\n   */\n  keys() {\n    return this._map.keys();\n  }\n\n  /**\n   * Get the attention state for a given path.\n   */\n  get(key: string[]): ReactiveObject<Attention> {\n    const object = this._map.get(key);\n    if (object) {\n      return object;\n    }\n\n    const newObject = create(AttentionSchema, { hasAttention: false, isAncestor: false, isRelated: false });\n    this._map.set(key, newObject);\n    return newObject;\n  }\n\n  /**\n   * Update the currently attended element.\n   */\n  update(nextKey: string[]) {\n    const currentKey = untracked(() => this.current);\n    const currentRelatedTo = currentKey[0];\n    const nextRelatedTo = nextKey[0];\n\n    const currentRelatedKeys = this.keys().filter((key) => key[0] === currentRelatedTo);\n    const nextRelatedKeys = this.keys().filter(\n      (key) => key[0] === nextRelatedTo && stringKey(key) !== stringKey(nextKey),\n    );\n    const prevRelatedKeys = currentRelatedKeys.filter(\n      (curr) => !nextRelatedKeys.find((next) => stringKey(curr) === stringKey(next)),\n    );\n\n    const currentAncestorKeys = currentKey.slice(1).map((_, i) => currentKey.slice(i + 1, currentKey.length));\n    const nextAncestorKeys = nextKey.slice(1).map((_, i) => nextKey.slice(i + 1, nextKey.length));\n    const prevAncestorKeys = currentAncestorKeys.filter(\n      (curr) => !nextAncestorKeys.find((next) => stringKey(curr) === stringKey(next)),\n    );\n\n    this._state.current = nextKey;\n    prevRelatedKeys.forEach((key) => this._set(key, {}));\n    prevAncestorKeys.forEach((key) => this._set(key, {}));\n    nextRelatedKeys.forEach((key) => this._set(key, { isRelated: true }));\n    nextAncestorKeys.forEach((key) => this._set(key, { isAncestor: true }));\n    this._set(nextKey, { hasAttention: true });\n  }\n\n  private _set(key: string[], attention: Partial<Attention>) {\n    const object = this.get(key);\n    object.hasAttention = attention.hasAttention ?? false;\n    object.isAncestor = attention.isAncestor ?? false;\n    object.isRelated = attention.isRelated ?? false;\n  }\n}\n\n/**\n * Accumulates all attendable id’s between the element provided and the root, inclusive.\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('data-attendable-id');\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      // (attempt tail recursion)\n      return !closestAttendable.parentElement ? acc : getAttendables(selector, closestAttendable.parentElement, acc);\n    }\n  }\n\n  return [...new Set(acc)];\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { type Primitive } from '@radix-ui/react-primitive';\nimport React, { type ComponentPropsWithRef, forwardRef } from 'react';\n\nimport { type ThemedClassName } from '@dxos/react-ui';\nimport { mx } from '@dxos/react-ui-theme';\n\nconst attentionGlyphStyles =\n  'inline-block rounded-sm is-3 bs-3 bg-transparent text-accentText transition-colors [[data-attention=true]_&]:bg-accentSurface [[data-attention=true]_&]:text-inverse [[aria-current][data-attention=true]_&]:bg-accentSurface [[aria-current][data-attention=true]_&]:text-inverse';\n\nconst presenceIconStyles =\n  'is-3 bs-3 group-[[aria-current]_&:hover]/attentionGlyphButton:hidden group-[[aria-current]_&:focus]/attentionGlyphButton:hidden group-[[data-attention=true]_&:hover]/attentionGlyphButton:hidden group-[[data-attention=true]_&:focus]/attentionGlyphButton:hidden group-[[aria-current][data-attention=true]_&:hover]/attentionGlyphButton:hidden group-[[aria-current][data-attention=true]_&:focus]/attentionGlyphButton:hidden';\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 type AttentionGlyphProps = {\n  presence?: 'none' | 'one' | 'many';\n} & ThemedClassName<Omit<ComponentPropsWithRef<typeof Primitive.span>, 'children'>>;\n\nexport const AttentionGlyph = forwardRef<HTMLSpanElement, AttentionGlyphProps>(\n  ({ presence, classNames, ...props }, forwardedRef) => {\n    return (\n      <span role='none' {...props} className={mx(attentionGlyphStyles, classNames)} ref={forwardedRef}>\n        {presence === 'many' && <PresenceMany />}\n        {presence === 'one' && <PresenceOne />}\n      </span>\n    );\n  },\n);\n", "//\n// Copyright 2024 DXOS.org\n//\n\n// NOTE(thure): The following unused imports quell TS2742 (“likely not portable”).\n\n// eslint-disable-next-line unused-imports/no-unused-imports\nimport { createContext, type Scope, type CreateScope } from '@radix-ui/react-context';\nimport React, { useMemo, type FocusEvent, type PropsWithChildren } from 'react';\n\nimport { useDefaultValue } from '@dxos/react-ui';\n\nimport { type Attention, AttentionManager, getAttendables } from '../attention';\n\nconst ATTENTION_NAME = 'Attention';\nconst ATTENABLE_ATTRIBUTE = 'data-attendable-id';\nconst ATTENTION_SOURCE_ATTRIBUTE = 'data-is-attention-source';\n\ntype AttentionContextValue = {\n  attention: AttentionManager;\n  path: string[];\n};\n\nconst [AttentionContextProvider, useAttentionContext] = createContext<AttentionContextValue>(ATTENTION_NAME, {\n  attention: new AttentionManager(),\n  path: [],\n});\n\nconst UNKNOWN_ATTENDABLE = { hasAttention: false, isAncestor: false, isRelated: false };\n\nconst useAttention = (attendableId?: string): Attention => {\n  const { attention, path } = useAttentionContext(ATTENTION_NAME);\n  if (!attendableId) {\n    return UNKNOWN_ATTENDABLE;\n  }\n\n  const current = [attendableId, ...path];\n  return attention.get(current);\n};\n\nconst useAttended = () => {\n  const { attention } = useAttentionContext(ATTENTION_NAME);\n  return attention.current;\n};\n\n/**\n * Computes HTML element attributes to apply so the attention system can detect changes\n * @param attendableId\n */\nconst useAttendableAttributes = (attendableId?: string) => {\n  const { hasAttention } = useAttention(attendableId);\n  return useMemo(() => {\n    const attributes: Record<string, string | undefined> = { [ATTENABLE_ATTRIBUTE]: attendableId };\n    if (hasAttention) {\n      attributes[ATTENTION_SOURCE_ATTRIBUTE] = 'true';\n    }\n\n    return attributes;\n  }, [attendableId, hasAttention]);\n};\n\nconst useAttentionPath = () => {\n  const { path } = useAttentionContext(ATTENTION_NAME);\n  return path;\n};\n\nconst RootAttentionProvider = ({\n  children,\n  attention: propsAttention,\n  onChange,\n}: PropsWithChildren<\n  Partial<{\n    attention: AttentionManager;\n    onChange: (nextAttended: string[]) => void;\n  }>\n>) => {\n  const attention = useDefaultValue(propsAttention, () => new AttentionManager());\n  const handleFocus = (event: FocusEvent) => {\n    const selector = [\n      '[data-attendable-id]',\n      ...Array.from(document.querySelectorAll('[aria-controls]')).map(\n        (el) => `[id=\"${el.getAttribute('aria-controls')}\"]`,\n      ),\n    ].join(',');\n    const prev = attention.current;\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  return (\n    <AttentionContextProvider attention={attention} path={[]}>\n      <div role='none' className='contents' onFocusCapture={handleFocus}>\n        {children}\n      </div>\n    </AttentionContextProvider>\n  );\n};\n\nconst AttentionProvider = ({ id, children }: PropsWithChildren<{ id: string }>) => {\n  const { attention, path } = useAttentionContext(ATTENTION_NAME);\n  const nextPath = useMemo(() => [id, ...path], [id, path]);\n\n  return (\n    <AttentionContextProvider attention={attention} path={nextPath}>\n      {children}\n    </AttentionContextProvider>\n  );\n};\n\nexport {\n  RootAttentionProvider,\n  AttentionProvider,\n  useAttentionContext,\n  useAttention,\n  useAttended,\n  useAttendableAttributes,\n  useAttentionPath,\n  ATTENTION_NAME,\n  ATTENABLE_ATTRIBUTE,\n  ATTENTION_SOURCE_ATTRIBUTE,\n};\n"],
+  "mappings": "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",
+  "names": ["untracked", "create", "S", "ComplexMap", "AttentionSchema", "S", "mutable", "Struct", "hasAttention", "Boolean", "isAncestor", "isRelated", "stringKey", "key", "join", "AttentionManager", "constructor", "initial", "_map", "ComplexMap", "_state", "create", "current", "keys", "get", "object", "newObject", "set", "update", "nextKey", "currentKey", "untracked", "currentRelatedTo", "nextRelatedTo", "currentRelatedKeys", "filter", "nextRelatedKeys", "prevRelatedKeys", "curr", "find", "next", "currentAncestorKeys", "slice", "map", "_", "i", "length", "nextAncestorKeys", "prevAncestorKeys", "forEach", "_set", "attention", "getAttendables", "selector", "cursor", "acc", "closestAttendable", "closest", "attendableId", "getAttribute", "trigger", "document", "querySelector", "push", "parentElement", "Set", "React", "forwardRef", "mx", "attentionGlyphStyles", "presenceIconStyles", "PresenceOne", "svg", "width", "height", "viewBox", "className", "fill", "xmlns", "circle", "cx", "cy", "r", "PresenceMany", "path", "d", "AttentionGlyph", "forwardRef", "presence", "classNames", "props", "forwardedRef", "span", "role", "mx", "ref", "createContext", "React", "useMemo", "useDefaultValue", "ATTENTION_NAME", "ATTENABLE_ATTRIBUTE", "ATTENTION_SOURCE_ATTRIBUTE", "AttentionContextProvider", "useAttentionContext", "createContext", "attention", "AttentionManager", "path", "UNKNOWN_ATTENDABLE", "hasAttention", "isAncestor", "isRelated", "useAttention", "attendableId", "current", "get", "useAttended", "useAttendableAttributes", "useMemo", "attributes", "useAttentionPath", "RootAttentionProvider", "children", "propsAttention", "onChange", "useDefaultValue", "handleFocus", "event", "selector", "Array", "from", "document", "querySelectorAll", "map", "el", "getAttribute", "join", "prev", "next", "getAttendables", "target", "length", "find", "id", "index", "update", "React", "div", "role", "className", "onFocusCapture", "AttentionProvider", "nextPath"]
 }

package/dist/lib/browser/meta.json

@@ -1 +1 @@
-{"inputs":{"packages/ui/react-ui-attention/src/components/AttentionGlyph.tsx":{"bytes":7591,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/react-ui-theme","kind":"import-statement","external":true}],"format":"esm"},"packages/ui/react-ui-attention/src/components/AttentionProvider.tsx":{"bytes":11985,"imports":[{"path":"@radix-ui/react-context","kind":"import-statement","external":true},{"path":"@radix-ui/react-use-controllable-state","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true}],"format":"esm"},"packages/ui/react-ui-attention/src/components/index.ts":{"bytes":644,"imports":[{"path":"packages/ui/react-ui-attention/src/components/AttentionGlyph.tsx","kind":"import-statement","original":"./AttentionGlyph"},{"path":"packages/ui/react-ui-attention/src/components/AttentionProvider.tsx","kind":"import-statement","original":"./AttentionProvider"}],"format":"esm"},"packages/ui/react-ui-attention/src/index.ts":{"bytes":508,"imports":[{"path":"packages/ui/react-ui-attention/src/components/index.ts","kind":"import-statement","original":"./components"}],"format":"esm"}},"outputs":{"packages/ui/react-ui-attention/dist/lib/browser/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":9875},"packages/ui/react-ui-attention/dist/lib/browser/index.mjs":{"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/react-ui-theme","kind":"import-statement","external":true},{"path":"@radix-ui/react-context","kind":"import-statement","external":true},{"path":"@radix-ui/react-use-controllable-state","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true}],"exports":["ATTENTION_NAME","AttentionGlyph","AttentionProvider","createAttendableAttributes","useAttentionContext","useHasAttention"],"entryPoint":"packages/ui/react-ui-attention/src/index.ts","inputs":{"packages/ui/react-ui-attention/src/components/AttentionGlyph.tsx":{"bytesInOutput":2345},"packages/ui/react-ui-attention/src/components/index.ts":{"bytesInOutput":0},"packages/ui/react-ui-attention/src/components/AttentionProvider.tsx":{"bytesInOutput":2302},"packages/ui/react-ui-attention/src/index.ts":{"bytesInOutput":0}},"bytes":4962}}}
+{"inputs":{"packages/ui/react-ui-attention/src/attention.ts":{"bytes":14976,"imports":[{"path":"@preact/signals-core","kind":"import-statement","external":true},{"path":"@dxos/echo-schema","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"format":"esm"},"packages/ui/react-ui-attention/src/components/AttentionGlyph.tsx":{"bytes":7599,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/react-ui-theme","kind":"import-statement","external":true}],"format":"esm"},"packages/ui/react-ui-attention/src/components/AttentionProvider.tsx":{"bytes":13329,"imports":[{"path":"@radix-ui/react-context","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/react-ui","kind":"import-statement","external":true},{"path":"packages/ui/react-ui-attention/src/attention.ts","kind":"import-statement","original":"../attention"}],"format":"esm"},"packages/ui/react-ui-attention/src/components/index.ts":{"bytes":644,"imports":[{"path":"packages/ui/react-ui-attention/src/components/AttentionGlyph.tsx","kind":"import-statement","original":"./AttentionGlyph"},{"path":"packages/ui/react-ui-attention/src/components/AttentionProvider.tsx","kind":"import-statement","original":"./AttentionProvider"}],"format":"esm"},"packages/ui/react-ui-attention/src/index.ts":{"bytes":597,"imports":[{"path":"packages/ui/react-ui-attention/src/attention.ts","kind":"import-statement","original":"./attention"},{"path":"packages/ui/react-ui-attention/src/components/index.ts","kind":"import-statement","original":"./components"}],"format":"esm"}},"outputs":{"packages/ui/react-ui-attention/dist/lib/browser/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":18097},"packages/ui/react-ui-attention/dist/lib/browser/index.mjs":{"imports":[{"path":"@preact/signals-core","kind":"import-statement","external":true},{"path":"@dxos/echo-schema","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/react-ui-theme","kind":"import-statement","external":true},{"path":"@radix-ui/react-context","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@dxos/react-ui","kind":"import-statement","external":true}],"exports":["ATTENABLE_ATTRIBUTE","ATTENTION_NAME","ATTENTION_SOURCE_ATTRIBUTE","AttentionGlyph","AttentionManager","AttentionProvider","AttentionSchema","RootAttentionProvider","getAttendables","useAttendableAttributes","useAttended","useAttention","useAttentionContext","useAttentionPath"],"entryPoint":"packages/ui/react-ui-attention/src/index.ts","inputs":{"packages/ui/react-ui-attention/src/attention.ts":{"bytesInOutput":3372},"packages/ui/react-ui-attention/src/index.ts":{"bytesInOutput":0},"packages/ui/react-ui-attention/src/components/AttentionGlyph.tsx":{"bytesInOutput":2349},"packages/ui/react-ui-attention/src/components/AttentionProvider.tsx":{"bytesInOutput":2605}},"bytes":8857}}}

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

@@ -0,0 +1,37 @@
+import { type ReactiveObject, S } from '@dxos/echo-schema';
+export declare const AttentionSchema: S.mutable<S.Struct<{
+    hasAttention: typeof S.Boolean;
+    isAncestor: typeof S.Boolean;
+    isRelated: typeof S.Boolean;
+}>>;
+export type Attention = S.Schema.Type<typeof AttentionSchema>;
+/**
+ * Manages attention state for an application.
+ */
+export declare class AttentionManager {
+    private readonly _map;
+    private readonly _state;
+    constructor(initial?: string[]);
+    /**
+     * Currently attended element.
+     */
+    get current(): string[];
+    /**
+     * All attention paths.
+     */
+    keys(): SetIterator<string[]>;
+    /**
+     * Get the attention state for a given path.
+     */
+    get(key: string[]): ReactiveObject<Attention>;
+    /**
+     * Update the currently attended element.
+     */
+    update(nextKey: string[]): void;
+    private _set;
+}
+/**
+ * Accumulates all attendable id’s between the element provided and the root, inclusive.
+ */
+export declare const getAttendables: (selector: string, cursor: Element, acc?: string[]) => string[];
+//# sourceMappingURL=attention.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attention.d.ts","sourceRoot":"","sources":["../../../src/attention.ts"],"names":[],"mappings":"AAMA,OAAO,EAAU,KAAK,cAAc,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAGnE,eAAO,MAAM,eAAe;;;;GAM3B,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,eAAe,CAAC,CAAC;AAI9D;;GAEG;AACH,qBAAa,gBAAgB;IAG3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkE;IACvF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;gBAEnD,OAAO,GAAE,MAAM,EAAO;IAIlC;;OAEG;IACH,IAAI,OAAO,aAEV;IAED;;OAEG;IACH,IAAI;IAIJ;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC,SAAS,CAAC;IAW7C;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE;IA2BxB,OAAO,CAAC,IAAI;CAMb;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,aAAc,MAAM,UAAU,OAAO,QAAO,MAAM,EAAE,KAAQ,MAAM,EAqB5F,CAAC"}

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

@@ -1,12 +1,13 @@
 import '@dxos-theme';
 import React from 'react';
-type StorybookAttentionGlyphProps = {
+type StoryProps = {
     current?: boolean;
     attention?: boolean;
 };
 declare const _default: {
     title: string;
-    component: ({ current, attention }: StorybookAttentionGlyphProps) => React.JSX.Element;
+    component: React.ForwardRefExoticComponent<Omit<import("./AttentionGlyph").AttentionGlyphProps, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+    render: ({ current, attention }: StoryProps) => React.JSX.Element;
     decorators: import("@storybook/react/*").Decorator[];
 };
 export default _default;

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

@@ -1 +1 @@
-{"version":3,"file":"AttentionGlyph.stories.d.ts","sourceRoot":"","sources":["../../../../src/components/AttentionGlyph.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,aAAa,CAAC;AAErB,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B,KAAK,4BAA4B,GAAG;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;;;wCAEuD,4BAA4B;;;AAoBrF,wBAIE;AAEF,eAAO,MAAM,OAAO;;CAEnB,CAAC;AACF,eAAO,MAAM,OAAO;;;;CAEnB,CAAC;AACF,eAAO,MAAM,SAAS;;;;;CAErB,CAAC"}
+{"version":3,"file":"AttentionGlyph.stories.d.ts","sourceRoot":"","sources":["../../../../src/components/AttentionGlyph.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,aAAa,CAAC;AAErB,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B,KAAK,UAAU,GAAG;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;;;;qCAEqC,UAAU;;;AAoBjD,wBAKE;AAEF,eAAO,MAAM,OAAO;;CAEnB,CAAC;AAEF,eAAO,MAAM,OAAO;;;;CAEnB,CAAC;AAEF,eAAO,MAAM,SAAS;;;;;CAErB,CAAC"}

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

@@ -1,22 +1,27 @@
 import React, { type PropsWithChildren } from 'react';
+import { type Attention, AttentionManager } from '../attention';
 declare const ATTENTION_NAME = "Attention";
+declare const ATTENABLE_ATTRIBUTE = "data-attendable-id";
+declare const ATTENTION_SOURCE_ATTRIBUTE = "data-is-attention-source";
 type AttentionContextValue = {
-    attended: Set<string>;
+    attention: AttentionManager;
+    path: string[];
 };
 declare const useAttentionContext: (consumerName: string) => AttentionContextValue;
-declare const useHasAttention: (attendableId?: string) => boolean;
+declare const useAttention: (attendableId?: string) => Attention;
+declare const useAttended: () => string[];
 /**
  * Computes HTML element attributes to apply so the attention system can detect changes
  * @param attendableId
  */
-declare const createAttendableAttributes: (attendableId?: string) => {
-    'data-attendable-id': string | undefined;
-};
-declare const AttentionProvider: ({ children, attended: propsAttended, defaultAttended, onChangeAttend, }: PropsWithChildren<Partial<{
-    attended: Set<string>;
-    onChangeAttend: (nextAttended: Set<string>) => void;
-    defaultAttended: Set<string>;
+declare const useAttendableAttributes: (attendableId?: string) => Record<string, string | undefined>;
+declare const useAttentionPath: () => string[];
+declare const RootAttentionProvider: ({ children, attention: propsAttention, onChange, }: PropsWithChildren<Partial<{
+    attention: AttentionManager;
+    onChange: (nextAttended: string[]) => void;
 }>>) => React.JSX.Element;
-export { AttentionProvider, useAttentionContext, useHasAttention, createAttendableAttributes, ATTENTION_NAME };
-export type { AttentionContextValue };
+declare const AttentionProvider: ({ id, children }: PropsWithChildren<{
+    id: string;
+}>) => React.JSX.Element;
+export { RootAttentionProvider, AttentionProvider, useAttentionContext, useAttention, useAttended, useAttendableAttributes, useAttentionPath, ATTENTION_NAME, ATTENABLE_ATTRIBUTE, ATTENTION_SOURCE_ATTRIBUTE, };
 //# sourceMappingURL=AttentionProvider.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AttentionProvider.d.ts","sourceRoot":"","sources":["../../../../src/components/AttentionProvider.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,EAAwD,KAAK,iBAAiB,EAAY,MAAM,OAAO,CAAC;AAEtH,QAAA,MAAM,cAAc,cAAc,CAAC;AAEnC,KAAK,qBAAqB,GAAG;IAC3B,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACvB,CAAC;AAEF,QAAA,MAAiC,mBAAmB,iDAElD,CAAC;AAEH,QAAA,MAAM,eAAe,kBAAmB,MAAM,YAG7C,CAAC;AAEF;;;GAGG;AACH,QAAA,MAAM,0BAA0B,kBAAmB,MAAM;;CAExD,CAAC;AA4BF,QAAA,MAAM,iBAAiB,4EAKpB,iBAAiB,CAClB,OAAO,CAAC;IACN,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,cAAc,EAAE,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACpD,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC9B,CAAC,CACH,sBAyBA,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,eAAe,EAAE,0BAA0B,EAAE,cAAc,EAAE,CAAC;AAE/G,YAAY,EAAE,qBAAqB,EAAE,CAAC"}
+{"version":3,"file":"AttentionProvider.d.ts","sourceRoot":"","sources":["../../../../src/components/AttentionProvider.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,EAA4B,KAAK,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAIhF,OAAO,EAAE,KAAK,SAAS,EAAE,gBAAgB,EAAkB,MAAM,cAAc,CAAC;AAEhF,QAAA,MAAM,cAAc,cAAc,CAAC;AACnC,QAAA,MAAM,mBAAmB,uBAAuB,CAAC;AACjD,QAAA,MAAM,0BAA0B,6BAA6B,CAAC;AAE9D,KAAK,qBAAqB,GAAG;IAC3B,SAAS,EAAE,gBAAgB,CAAC;IAC5B,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAEF,QAAA,MAAiC,mBAAmB,iDAGlD,CAAC;AAIH,QAAA,MAAM,YAAY,kBAAmB,MAAM,KAAG,SAQ7C,CAAC;AAEF,QAAA,MAAM,WAAW,gBAGhB,CAAC;AAEF;;;GAGG;AACH,QAAA,MAAM,uBAAuB,kBAAmB,MAAM,uCAUrD,CAAC;AAEF,QAAA,MAAM,gBAAgB,gBAGrB,CAAC;AAEF,QAAA,MAAM,qBAAqB,uDAIxB,iBAAiB,CAClB,OAAO,CAAC;IACN,SAAS,EAAE,gBAAgB,CAAC;IAC5B,QAAQ,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CAC5C,CAAC,CACH,sBA0BA,CAAC;AAEF,QAAA,MAAM,iBAAiB,qBAAsB,iBAAiB,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,sBAS7E,CAAC;AAEF,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,uBAAuB,EACvB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,0BAA0B,GAC3B,CAAC"}

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

@@ -0,0 +1,10 @@
+import '@dxos-theme';
+import React from 'react';
+declare const _default: {
+    title: string;
+    render: () => React.JSX.Element;
+    decorators: import("@storybook/react/*").Decorator[];
+};
+export default _default;
+export declare const Default: {};
+//# sourceMappingURL=AttentionProvider.stories.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AttentionProvider.stories.d.ts","sourceRoot":"","sources":["../../../../src/components/AttentionProvider.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,aAAa,CAAC;AAErB,OAAO,KAAK,MAAM,OAAO,CAAC;;;;;;AA4B1B,wBAIE;AAEF,eAAO,MAAM,OAAO,IAAK,CAAC"}

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

@@ -1,2 +1,3 @@
+export * from './attention';
 export * from './components';
 //# 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,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

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

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

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

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

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

@@ -0,0 +1,3 @@
+import { type Decorator } from '@storybook/react';
+export declare const withAttention: Decorator;
+//# sourceMappingURL=withAttention.d.ts.map

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

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

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

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

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

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

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@dxos/react-ui-attention",
-  "version": "0.6.13",
+  "version": "0.6.14-main.2b6a0f3",
   "description": "Signifier components and providers for attention system.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
   "license": "MIT",
   "author": "DXOS.org",
+  "sideEffects": false,
   "exports": {
     ".": {
       "browser": "./dist/lib/browser/index.mjs",
@@ -21,6 +22,7 @@
     "src"
   ],
   "dependencies": {
+    "@preact/signals-core": "^1.6.0",
     "@radix-ui/primitive": "^1.0.0",
     "@radix-ui/react-compose-refs": "^1.0.0",
     "@radix-ui/react-context": "^1.0.0",
@@ -28,9 +30,8 @@
     "@radix-ui/react-primitive": "^1.0.2",
     "@radix-ui/react-slot": "^1.0.1",
     "@radix-ui/react-use-controllable-state": "^1.0.0",
-    "@dxos/react-ui": "0.6.13",
-    "@dxos/util": "0.6.13",
-    "@dxos/react-ui-theme": "0.6.13"
+    "@dxos/echo-schema": "0.6.14-main.2b6a0f3",
+    "@dxos/util": "0.6.14-main.2b6a0f3"
   },
   "devDependencies": {
     "@phosphor-icons/react": "^2.1.5",
@@ -38,15 +39,19 @@
     "@types/react-dom": "~18.2.0",
     "react": "~18.2.0",
     "react-dom": "~18.2.0",
-    "vite": "^5.3.4",
-    "@dxos/random": "0.6.13",
-    "@dxos/storybook-utils": "0.6.13",
-    "@dxos/app-graph": "0.6.13"
+    "vite": "5.4.7",
+    "@dxos/random": "0.6.14-main.2b6a0f3",
+    "@dxos/app-graph": "0.6.14-main.2b6a0f3",
+    "@dxos/react-ui": "0.6.14-main.2b6a0f3",
+    "@dxos/react-ui-theme": "0.6.14-main.2b6a0f3",
+    "@dxos/storybook-utils": "0.6.14-main.2b6a0f3"
   },
   "peerDependencies": {
     "@phosphor-icons/react": "^2.1.5",
-    "react": "^18.0.0",
-    "react-dom": "^18.0.0"
+    "react": "~18.2.0",
+    "react-dom": "~18.2.0",
+    "@dxos/react-ui": "0.6.14-main.2b6a0f3",
+    "@dxos/react-ui-theme": "0.6.14-main.2b6a0f3"
   },
   "publishConfig": {
     "access": "public"

package/src/attention.ts

@@ -0,0 +1,125 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { untracked } from '@preact/signals-core';
+
+import { create, type ReactiveObject, S } from '@dxos/echo-schema';
+import { ComplexMap } from '@dxos/util';
+
+export const AttentionSchema = S.mutable(
+  S.Struct({
+    hasAttention: S.Boolean,
+    isAncestor: S.Boolean,
+    isRelated: S.Boolean,
+  }),
+);
+
+export type Attention = S.Schema.Type<typeof AttentionSchema>;
+
+const stringKey = (key: string[]) => key.join(',');
+
+/**
+ * Manages attention state for an application.
+ */
+export class AttentionManager {
+  // Each attention path is associated with an attention object.
+  // The lookup is not a reactive object to ensure that attention for each path is subscribable independently.
+  private readonly _map = new ComplexMap<string[], ReactiveObject<Attention>>(stringKey);
+  private readonly _state: ReactiveObject<{ current: string[] }>;
+
+  constructor(initial: string[] = []) {
+    this._state = create({ current: initial });
+  }
+
+  /**
+   * Currently attended element.
+   */
+  get current() {
+    return this._state.current;
+  }
+
+  /**
+   * All attention paths.
+   */
+  keys() {
+    return this._map.keys();
+  }
+
+  /**
+   * Get the attention state for a given path.
+   */
+  get(key: string[]): ReactiveObject<Attention> {
+    const object = this._map.get(key);
+    if (object) {
+      return object;
+    }
+
+    const newObject = create(AttentionSchema, { hasAttention: false, isAncestor: false, isRelated: false });
+    this._map.set(key, newObject);
+    return newObject;
+  }
+
+  /**
+   * Update the currently attended element.
+   */
+  update(nextKey: string[]) {
+    const currentKey = untracked(() => this.current);
+    const currentRelatedTo = currentKey[0];
+    const nextRelatedTo = nextKey[0];
+
+    const currentRelatedKeys = this.keys().filter((key) => key[0] === currentRelatedTo);
+    const nextRelatedKeys = this.keys().filter(
+      (key) => key[0] === nextRelatedTo && stringKey(key) !== stringKey(nextKey),
+    );
+    const prevRelatedKeys = currentRelatedKeys.filter(
+      (curr) => !nextRelatedKeys.find((next) => stringKey(curr) === stringKey(next)),
+    );
+
+    const currentAncestorKeys = currentKey.slice(1).map((_, i) => currentKey.slice(i + 1, currentKey.length));
+    const nextAncestorKeys = nextKey.slice(1).map((_, i) => nextKey.slice(i + 1, nextKey.length));
+    const prevAncestorKeys = currentAncestorKeys.filter(
+      (curr) => !nextAncestorKeys.find((next) => stringKey(curr) === stringKey(next)),
+    );
+
+    this._state.current = nextKey;
+    prevRelatedKeys.forEach((key) => this._set(key, {}));
+    prevAncestorKeys.forEach((key) => this._set(key, {}));
+    nextRelatedKeys.forEach((key) => this._set(key, { isRelated: true }));
+    nextAncestorKeys.forEach((key) => this._set(key, { isAncestor: true }));
+    this._set(nextKey, { hasAttention: true });
+  }
+
+  private _set(key: string[], attention: Partial<Attention>) {
+    const object = this.get(key);
+    object.hasAttention = attention.hasAttention ?? false;
+    object.isAncestor = attention.isAncestor ?? false;
+    object.isRelated = attention.isRelated ?? false;
+  }
+}
+
+/**
+ * Accumulates all attendable id’s between the element provided and the root, inclusive.
+ */
+export const getAttendables = (selector: string, cursor: Element, acc: string[] = []): string[] => {
+  // Find the closest element with `data-attendable-id`, if any; start from cursor and move up the DOM tree.
+  const closestAttendable = cursor.closest(selector);
+  if (closestAttendable) {
+    const attendableId = closestAttendable.getAttribute('data-attendable-id');
+    if (!attendableId) {
+      // this has an id of an aria-controls elsewhere on the page, move cursor to that trigger
+      const trigger = document.querySelector(`[aria-controls="${closestAttendable.getAttribute('id')}"]`);
+      if (!trigger) {
+        return acc;
+      } else {
+        return getAttendables(selector, trigger, acc);
+      }
+    } else {
+      acc.push(attendableId);
+      // (attempt tail recursion)
+      return !closestAttendable.parentElement ? acc : getAttendables(selector, closestAttendable.parentElement, acc);
+    }
+  }
+
+  return [...new Set(acc)];
+};

package/src/components/AttentionGlyph.stories.tsx

@@ -10,12 +10,12 @@ import { withTheme } from '@dxos/storybook-utils';
 
 import { AttentionGlyph } from './AttentionGlyph';
 
-type StorybookAttentionGlyphProps = {
+type StoryProps = {
   current?: boolean;
   attention?: boolean;
 };
 
-const StorybookAttentionGlyph = ({ current, attention }: StorybookAttentionGlyphProps) => {
+const Story = ({ current, attention }: StoryProps) => {
   const itemAttrs = {
     ...(current && { 'aria-current': 'page' as const }),
     ...(attention && { 'data-attention': 'true' }),
@@ -36,17 +36,20 @@ const StorybookAttentionGlyph = ({ current, attention }: StorybookAttentionGlyph
 };
 
 export default {
-  title: 'react-ui-deck/AttentionGlyph',
-  component: StorybookAttentionGlyph,
+  title: 'ui/react-ui-attention/AttentionGlyph',
+  component: AttentionGlyph,
+  render: Story,
   decorators: [withTheme],
 };
 
 export const Default = {
   args: {},
 };
+
 export const Current = {
   args: { current: true },
 };
+
 export const Attention = {
   args: { current: true, attention: true },
 };

package/src/components/AttentionGlyph.tsx

@@ -9,7 +9,7 @@ import { type ThemedClassName } from '@dxos/react-ui';
 import { mx } from '@dxos/react-ui-theme';
 
 const attentionGlyphStyles =
-  'inline-block rounded-sm is-3 bs-3 bg-transparent text-accentText transition-colors [[data-attention=true]_&]:bg-accentSurface [[data-attention=true]_&]:fg-inverse [[aria-current][data-attention=true]_&]:bg-accentSurface [[aria-current][data-attention=true]_&]:fg-inverse';
+  'inline-block rounded-sm is-3 bs-3 bg-transparent text-accentText transition-colors [[data-attention=true]_&]:bg-accentSurface [[data-attention=true]_&]:text-inverse [[aria-current][data-attention=true]_&]:bg-accentSurface [[aria-current][data-attention=true]_&]:text-inverse';
 
 const presenceIconStyles =
   'is-3 bs-3 group-[[aria-current]_&:hover]/attentionGlyphButton:hidden group-[[aria-current]_&:focus]/attentionGlyphButton:hidden group-[[data-attention=true]_&:hover]/attentionGlyphButton:hidden group-[[data-attention=true]_&:focus]/attentionGlyphButton:hidden group-[[aria-current][data-attention=true]_&:hover]/attentionGlyphButton:hidden group-[[aria-current][data-attention=true]_&:focus]/attentionGlyphButton:hidden';

package/src/components/AttentionProvider.stories.tsx

@@ -0,0 +1,41 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import '@dxos-theme';
+
+import React from 'react';
+
+import { withTheme } from '@dxos/storybook-utils';
+
+import { useAttendableAttributes } from './AttentionProvider';
+import { withAttention } from '../testing';
+
+const Attendable = ({ id }: { id: string }) => {
+  const attendableAttrs = useAttendableAttributes(id);
+
+  return (
+    <div {...attendableAttrs}>
+      <textarea className='attention-surface resize-none' placeholder={id} />
+    </div>
+  );
+};
+
+const Story = () => {
+  return (
+    <div className='flex justify-between'>
+      <Attendable id='1' />
+      <Attendable id='2' />
+      <Attendable id='3' />
+      <Attendable id='4' />
+    </div>
+  );
+};
+
+export default {
+  title: 'react-ui-attention/AttentionProvider',
+  render: Story,
+  decorators: [withTheme, withAttention],
+};
+
+export const Default = {};

package/src/components/AttentionProvider.tsx

@@ -6,76 +6,75 @@
 
 // eslint-disable-next-line unused-imports/no-unused-imports
 import { createContext, type Scope, type CreateScope } from '@radix-ui/react-context';
-import { useControllableState } from '@radix-ui/react-use-controllable-state';
-// eslint-disable-next-line unused-imports/no-unused-imports
-import React, { ComponentProps, type FocusEvent, type HTMLAttributes, type PropsWithChildren, useState } from 'react';
+import React, { useMemo, type FocusEvent, type PropsWithChildren } from 'react';
+
+import { useDefaultValue } from '@dxos/react-ui';
+
+import { type Attention, AttentionManager, getAttendables } from '../attention';
 
 const ATTENTION_NAME = 'Attention';
+const ATTENABLE_ATTRIBUTE = 'data-attendable-id';
+const ATTENTION_SOURCE_ATTRIBUTE = 'data-is-attention-source';
 
 type AttentionContextValue = {
-  attended: Set<string>;
+  attention: AttentionManager;
+  path: string[];
 };
 
 const [AttentionContextProvider, useAttentionContext] = createContext<AttentionContextValue>(ATTENTION_NAME, {
-  attended: new Set(),
+  attention: new AttentionManager(),
+  path: [],
 });
 
-const useHasAttention = (attendableId?: string) => {
-  const { attended } = useAttentionContext(ATTENTION_NAME);
-  return attendableId ? attended.has(attendableId) : false;
+const UNKNOWN_ATTENDABLE = { hasAttention: false, isAncestor: false, isRelated: false };
+
+const useAttention = (attendableId?: string): Attention => {
+  const { attention, path } = useAttentionContext(ATTENTION_NAME);
+  if (!attendableId) {
+    return UNKNOWN_ATTENDABLE;
+  }
+
+  const current = [attendableId, ...path];
+  return attention.get(current);
+};
+
+const useAttended = () => {
+  const { attention } = useAttentionContext(ATTENTION_NAME);
+  return attention.current;
 };
 
 /**
  * Computes HTML element attributes to apply so the attention system can detect changes
  * @param attendableId
  */
-const createAttendableAttributes = (attendableId?: string) => {
-  return { 'data-attendable-id': attendableId };
+const useAttendableAttributes = (attendableId?: string) => {
+  const { hasAttention } = useAttention(attendableId);
+  return useMemo(() => {
+    const attributes: Record<string, string | undefined> = { [ATTENABLE_ATTRIBUTE]: attendableId };
+    if (hasAttention) {
+      attributes[ATTENTION_SOURCE_ATTRIBUTE] = 'true';
+    }
+
+    return attributes;
+  }, [attendableId, hasAttention]);
 };
 
-/**
- * Accumulates all attendable id’s between the element provided and the root, inclusive.
- */
-const getAttendables = (selector: string, cursor: Element, acc: string[] = []): string[] => {
-  // Find the closest element with `data-attendable-id`, if any; start from cursor and move up the DOM tree.
-  const closestAttendable = cursor.closest(selector);
-  if (!closestAttendable) {
-    return acc;
-  } else {
-    const attendableId = closestAttendable.getAttribute('data-attendable-id');
-    if (!attendableId) {
-      // this has an id of an aria-controls elsewhere on the page, move cursor to that trigger
-      const trigger = document.querySelector(`[aria-controls="${closestAttendable.getAttribute('id')}"]`);
-      if (!trigger) {
-        return acc;
-      } else {
-        return getAttendables(selector, trigger, acc);
-      }
-    } else {
-      acc.push(attendableId);
-      // (attempt tail recursion)
-      return !closestAttendable.parentElement ? acc : getAttendables(selector, closestAttendable.parentElement, acc);
-    }
-  }
+const useAttentionPath = () => {
+  const { path } = useAttentionContext(ATTENTION_NAME);
+  return path;
 };
 
-const AttentionProvider = ({
+const RootAttentionProvider = ({
   children,
-  attended: propsAttended,
-  defaultAttended,
-  onChangeAttend,
+  attention: propsAttention,
+  onChange,
 }: PropsWithChildren<
   Partial<{
-    attended: Set<string>;
-    onChangeAttend: (nextAttended: Set<string>) => void;
-    defaultAttended: Set<string>;
+    attention: AttentionManager;
+    onChange: (nextAttended: string[]) => void;
   }>
 >) => {
-  const [attended = new Set(), setAttended] = useControllableState<Set<string>>({
-    prop: propsAttended,
-    defaultProp: defaultAttended,
-    onChange: onChangeAttend,
-  });
+  const attention = useDefaultValue(propsAttention, () => new AttentionManager());
   const handleFocus = (event: FocusEvent) => {
     const selector = [
       '[data-attendable-id]',
@@ -83,13 +82,18 @@ const AttentionProvider = ({
         (el) => `[id="${el.getAttribute('aria-controls')}"]`,
       ),
     ].join(',');
-    const nextAttended = new Set(getAttendables(selector, event.target));
-    const [prev, next] = [Array.from(attended), Array.from(nextAttended)];
-    // Only update state if the result is different.
-    (prev.length !== next.length || !!prev.find((id, index) => next[index] !== id)) && setAttended(nextAttended);
+    const prev = attention.current;
+    const next = getAttendables(selector, event.target);
+    // TODO(wittjosiah): Not allowing empty state means that the attended item is not strictly guaranteed to be in the DOM.
+    //   Currently this depends on the deck in order to ensure that when the attended item is removed something else is attended.
+    // Only update state if the result is different and not empty.
+    if (next.length > 0 && (prev.length !== next.length || !!prev.find((id, index) => next[index] !== id))) {
+      attention.update(next);
+      onChange?.(next);
+    }
   };
   return (
-    <AttentionContextProvider attended={attended}>
+    <AttentionContextProvider attention={attention} path={[]}>
       <div role='none' className='contents' onFocusCapture={handleFocus}>
         {children}
       </div>
@@ -97,6 +101,26 @@ const AttentionProvider = ({
   );
 };
 
-export { AttentionProvider, useAttentionContext, useHasAttention, createAttendableAttributes, ATTENTION_NAME };
+const AttentionProvider = ({ id, children }: PropsWithChildren<{ id: string }>) => {
+  const { attention, path } = useAttentionContext(ATTENTION_NAME);
+  const nextPath = useMemo(() => [id, ...path], [id, path]);
+
+  return (
+    <AttentionContextProvider attention={attention} path={nextPath}>
+      {children}
+    </AttentionContextProvider>
+  );
+};
 
-export type { AttentionContextValue };
+export {
+  RootAttentionProvider,
+  AttentionProvider,
+  useAttentionContext,
+  useAttention,
+  useAttended,
+  useAttendableAttributes,
+  useAttentionPath,
+  ATTENTION_NAME,
+  ATTENABLE_ATTRIBUTE,
+  ATTENTION_SOURCE_ATTRIBUTE,
+};

package/src/index.ts

@@ -2,4 +2,5 @@
 // Copyright 2024 DXOS.org
 //
 
+export * from './attention';
 export * from './components';

package/src/testing/decorators/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+export * from './withAttention';

package/src/testing/decorators/withAttention.ts

@@ -0,0 +1,12 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { type Decorator } from '@storybook/react';
+import { createElement } from 'react';
+
+import { RootAttentionProvider } from '../../components';
+
+export const withAttention: Decorator = (Story) => {
+  return createElement(RootAttentionProvider, { children: createElement(Story) });
+};

package/src/testing/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+export * from './decorators';