@dxos/react-ui-attention 0.9.1-staging.ee54ba693a → 0.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (115) hide show
  1. package/dist/lib/chunk-ViewStateProvider.mjs +308 -0
  2. package/dist/lib/chunk-ViewStateProvider.mjs.map +1 -0
  3. package/dist/lib/chunk-types.mjs +351 -0
  4. package/dist/lib/chunk-types.mjs.map +1 -0
  5. package/dist/lib/index.mjs +149 -0
  6. package/dist/lib/index.mjs.map +1 -0
  7. package/dist/lib/testing.mjs +20 -0
  8. package/dist/lib/testing.mjs.map +1 -0
  9. package/dist/lib/types.mjs +2 -0
  10. package/dist/types/src/components/AttentionProvider/AttentionProvider.d.ts +2 -15
  11. package/dist/types/src/components/AttentionProvider/AttentionProvider.d.ts.map +1 -1
  12. package/dist/types/src/components/AttentionProvider/attention-context.d.ts +20 -0
  13. package/dist/types/src/components/AttentionProvider/attention-context.d.ts.map +1 -0
  14. package/dist/types/src/components/AttentionProvider/index.d.ts +1 -0
  15. package/dist/types/src/components/AttentionProvider/index.d.ts.map +1 -1
  16. package/dist/types/src/components/ViewStateProvider/ViewStateProvider.d.ts +2 -26
  17. package/dist/types/src/components/ViewStateProvider/ViewStateProvider.d.ts.map +1 -1
  18. package/dist/types/src/components/ViewStateProvider/index.d.ts +1 -0
  19. package/dist/types/src/components/ViewStateProvider/index.d.ts.map +1 -1
  20. package/dist/types/src/components/ViewStateProvider/view-state-hooks.d.ts +32 -0
  21. package/dist/types/src/components/ViewStateProvider/view-state-hooks.d.ts.map +1 -0
  22. package/dist/types/src/core/backends.d.ts +24 -0
  23. package/dist/types/src/core/backends.d.ts.map +1 -0
  24. package/dist/types/src/core/backends.test.d.ts.map +1 -0
  25. package/dist/types/src/core/index.d.ts +2 -0
  26. package/dist/types/src/core/index.d.ts.map +1 -0
  27. package/dist/types/src/hooks/index.d.ts +2 -0
  28. package/dist/types/src/hooks/index.d.ts.map +1 -0
  29. package/dist/types/src/hooks/useArticleKeyboardNavigation.d.ts.map +1 -0
  30. package/dist/types/src/hooks/useArticleKeyboardNavigation.test.d.ts.map +1 -0
  31. package/dist/types/src/index.d.ts +3 -4
  32. package/dist/types/src/index.d.ts.map +1 -1
  33. package/dist/types/src/{attention.d.ts → types/Attention.d.ts} +13 -2
  34. package/dist/types/src/types/Attention.d.ts.map +1 -0
  35. package/dist/types/src/types/Attention.test.d.ts +2 -0
  36. package/dist/types/src/types/Attention.test.d.ts.map +1 -0
  37. package/dist/types/src/{selection.d.ts → types/Selection.d.ts} +12 -10
  38. package/dist/types/src/types/Selection.d.ts.map +1 -0
  39. package/dist/types/src/types/Selection.test.d.ts +2 -0
  40. package/dist/types/src/types/Selection.test.d.ts.map +1 -0
  41. package/dist/types/src/types/ViewState.d.ts +66 -0
  42. package/dist/types/src/types/ViewState.d.ts.map +1 -0
  43. package/dist/types/src/types/ViewState.test.d.ts +2 -0
  44. package/dist/types/src/types/ViewState.test.d.ts.map +1 -0
  45. package/dist/types/src/types/index.d.ts +3 -3
  46. package/dist/types/src/types/index.d.ts.map +1 -1
  47. package/dist/types/tsconfig.tsbuildinfo +1 -1
  48. package/package.json +18 -20
  49. package/src/components/AttentionProvider/AttentionProvider.stories.tsx +1 -1
  50. package/src/components/AttentionProvider/AttentionProvider.tsx +4 -86
  51. package/src/components/AttentionProvider/attention-context.ts +81 -0
  52. package/src/components/AttentionProvider/index.ts +2 -0
  53. package/src/components/ViewStateProvider/ViewStateProvider.test.tsx +7 -5
  54. package/src/components/ViewStateProvider/ViewStateProvider.tsx +6 -110
  55. package/src/components/ViewStateProvider/index.ts +9 -0
  56. package/src/components/ViewStateProvider/view-state-hooks.ts +115 -0
  57. package/src/{view-state → core}/backends.test.ts +5 -5
  58. package/src/{view-state → core}/backends.ts +24 -17
  59. package/src/{view-state → core}/index.ts +0 -1
  60. package/src/hooks/index.ts +5 -0
  61. package/src/{useArticleKeyboardNavigation.ts → hooks/useArticleKeyboardNavigation.ts} +1 -1
  62. package/src/index.ts +3 -4
  63. package/src/testing/decorators/withAttention.ts +2 -2
  64. package/src/{attention.test.ts → types/Attention.test.ts} +2 -2
  65. package/src/{attention.ts → types/Attention.ts} +17 -2
  66. package/src/types/Selection.test.ts +100 -0
  67. package/src/{selection.ts → types/Selection.ts} +27 -17
  68. package/src/{view-state/view-state.test.ts → types/ViewState.test.ts} +6 -6
  69. package/src/types/ViewState.ts +101 -0
  70. package/src/types/index.ts +8 -7
  71. package/dist/lib/browser/chunk-4HYAJ4IO.mjs +0 -434
  72. package/dist/lib/browser/chunk-4HYAJ4IO.mjs.map +0 -7
  73. package/dist/lib/browser/chunk-I4FDY4AZ.mjs +0 -236
  74. package/dist/lib/browser/chunk-I4FDY4AZ.mjs.map +0 -7
  75. package/dist/lib/browser/index.mjs +0 -218
  76. package/dist/lib/browser/index.mjs.map +0 -7
  77. package/dist/lib/browser/meta.json +0 -1
  78. package/dist/lib/browser/testing/index.mjs +0 -30
  79. package/dist/lib/browser/testing/index.mjs.map +0 -7
  80. package/dist/lib/browser/types/index.mjs +0 -43
  81. package/dist/lib/browser/types/index.mjs.map +0 -7
  82. package/dist/lib/node-esm/chunk-DLBZMHST.mjs +0 -237
  83. package/dist/lib/node-esm/chunk-DLBZMHST.mjs.map +0 -7
  84. package/dist/lib/node-esm/chunk-HWN7KJDX.mjs +0 -436
  85. package/dist/lib/node-esm/chunk-HWN7KJDX.mjs.map +0 -7
  86. package/dist/lib/node-esm/index.mjs +0 -219
  87. package/dist/lib/node-esm/index.mjs.map +0 -7
  88. package/dist/lib/node-esm/meta.json +0 -1
  89. package/dist/lib/node-esm/testing/index.mjs +0 -31
  90. package/dist/lib/node-esm/testing/index.mjs.map +0 -7
  91. package/dist/lib/node-esm/types/index.mjs +0 -44
  92. package/dist/lib/node-esm/types/index.mjs.map +0 -7
  93. package/dist/types/src/attention.d.ts.map +0 -1
  94. package/dist/types/src/attention.test.d.ts +0 -2
  95. package/dist/types/src/attention.test.d.ts.map +0 -1
  96. package/dist/types/src/selection.d.ts.map +0 -1
  97. package/dist/types/src/selection.test.d.ts +0 -2
  98. package/dist/types/src/selection.test.d.ts.map +0 -1
  99. package/dist/types/src/useArticleKeyboardNavigation.d.ts.map +0 -1
  100. package/dist/types/src/useArticleKeyboardNavigation.test.d.ts.map +0 -1
  101. package/dist/types/src/view-state/backends.d.ts +0 -24
  102. package/dist/types/src/view-state/backends.d.ts.map +0 -1
  103. package/dist/types/src/view-state/backends.test.d.ts.map +0 -1
  104. package/dist/types/src/view-state/index.d.ts +0 -3
  105. package/dist/types/src/view-state/index.d.ts.map +0 -1
  106. package/dist/types/src/view-state/view-state.d.ts +0 -54
  107. package/dist/types/src/view-state/view-state.d.ts.map +0 -1
  108. package/dist/types/src/view-state/view-state.test.d.ts +0 -2
  109. package/dist/types/src/view-state/view-state.test.d.ts.map +0 -1
  110. package/src/selection.test.ts +0 -67
  111. package/src/view-state/view-state.ts +0 -91
  112. /package/dist/types/src/{view-state → core}/backends.test.d.ts +0 -0
  113. /package/dist/types/src/{useArticleKeyboardNavigation.d.ts → hooks/useArticleKeyboardNavigation.d.ts} +0 -0
  114. /package/dist/types/src/{useArticleKeyboardNavigation.test.d.ts → hooks/useArticleKeyboardNavigation.test.d.ts} +0 -0
  115. /package/src/{useArticleKeyboardNavigation.test.ts → hooks/useArticleKeyboardNavigation.test.ts} +0 -0
@@ -1,7 +0,0 @@
1
- {
2
- "version": 3,
3
- "sources": [],
4
- "sourcesContent": [],
5
- "mappings": "",
6
- "names": []
7
- }
@@ -1,237 +0,0 @@
1
- import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
2
- import {
3
- AttentionManager,
4
- ViewStateManager,
5
- createDefaultBackends,
6
- getAttendables,
7
- resolveSelection,
8
- selectionAspect,
9
- toggleSelection
10
- } from "./chunk-HWN7KJDX.mjs";
11
-
12
- // src/components/AttentionProvider/AttentionProvider.tsx
13
- import { RegistryContext } from "@effect-atom/atom-react";
14
- import { createContext } from "@radix-ui/react-context";
15
- import { Primitive } from "@radix-ui/react-primitive";
16
- import { Slot } from "@radix-ui/react-slot";
17
- import React, { forwardRef, useCallback, useContext, useEffect, useMemo, useState } from "react";
18
- import { log } from "@dxos/log";
19
- import { useDefaultValue } from "@dxos/react-hooks";
20
- import { mx } from "@dxos/ui-theme";
21
- var __dxlog_file = "/__w/dxos/dxos/packages/ui/react-ui-attention/src/components/AttentionProvider/AttentionProvider.tsx";
22
- var ATTENTION_NAME = "Attention";
23
- var ATTENDABLE_ATTRIBUTE = "data-attendable-id";
24
- var ATTENTION_SOURCE_ATTRIBUTE = "data-w-attention-source";
25
- var [AttentionContextProvider, useAttentionContext] = createContext(ATTENTION_NAME, {
26
- attention: void 0
27
- });
28
- var UNKNOWN_ATTENDABLE = {
29
- hasAttention: false,
30
- isAncestor: false,
31
- isRelated: false
32
- };
33
- var useAttention = (attendableId) => {
34
- const { attention } = useAttentionContext(ATTENTION_NAME);
35
- const [state, setState] = useState(UNKNOWN_ATTENDABLE);
36
- useEffect(() => {
37
- if (!attendableId || !attention) {
38
- setState(UNKNOWN_ATTENDABLE);
39
- return;
40
- }
41
- const currentState = attention.get(attendableId);
42
- setState(currentState);
43
- return attention.subscribe(attendableId, (newState) => {
44
- setState(newState);
45
- });
46
- }, [
47
- attention,
48
- attendableId
49
- ]);
50
- return state;
51
- };
52
- var useAttended = () => {
53
- const { attention } = useAttentionContext(ATTENTION_NAME);
54
- const [current, setCurrent] = useState([]);
55
- useEffect(() => {
56
- if (!attention) {
57
- return;
58
- }
59
- setCurrent(attention.getCurrent());
60
- return attention.subscribeCurrent((newCurrent) => {
61
- setCurrent(newCurrent);
62
- });
63
- }, [
64
- attention
65
- ]);
66
- return current;
67
- };
68
- var useAttentionAttributes = (attendableId) => {
69
- const { hasAttention } = useAttention(attendableId);
70
- return useMemo(() => {
71
- const attributes = {
72
- [ATTENDABLE_ATTRIBUTE]: attendableId
73
- };
74
- if (hasAttention) {
75
- attributes[ATTENTION_SOURCE_ATTRIBUTE] = "true";
76
- }
77
- return attributes;
78
- }, [
79
- attendableId,
80
- hasAttention
81
- ]);
82
- };
83
- var RootAttentionProvider = ({ children, attention: propsAttention, onChange }) => {
84
- const registry = useContext(RegistryContext);
85
- const attention = useDefaultValue(propsAttention, () => new AttentionManager(registry));
86
- const handleFocus = useCallback((event) => {
87
- log("focus", {
88
- related: event.relatedTarget,
89
- target: event.target
90
- }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 84, S: void 0 });
91
- const selector = [
92
- "[data-attendable-id]",
93
- ...Array.from(document.querySelectorAll("[aria-controls]")).map((el) => `[id="${el.getAttribute("aria-controls")}"]`)
94
- ].join(",");
95
- const prev = attention.getCurrent();
96
- const next = getAttendables(selector, event.target);
97
- if (next.length > 0 && (prev.length !== next.length || !!prev.find((id, index) => next[index] !== id))) {
98
- attention.update(next);
99
- onChange?.(next);
100
- }
101
- }, [
102
- attention,
103
- onChange
104
- ]);
105
- return /* @__PURE__ */ React.createElement(AttentionContextProvider, {
106
- attention
107
- }, /* @__PURE__ */ React.createElement("div", {
108
- className: "contents",
109
- onFocusCapture: handleFocus
110
- }, children));
111
- };
112
- var AttendableContainer = /* @__PURE__ */ forwardRef(({ id, classNames, children, asChild, ...props }, forwardedRef) => {
113
- const attentionAttrs = useAttentionAttributes(id);
114
- const Comp = asChild ? Slot : Primitive.div;
115
- return /* @__PURE__ */ React.createElement(Comp, {
116
- role: "none",
117
- ...props,
118
- ...attentionAttrs,
119
- className: mx("dx-attention-surface", props.tabIndex === 0 && "dx-focus-ring-inset-over-all", classNames),
120
- ref: forwardedRef
121
- }, children);
122
- });
123
-
124
- // src/components/ViewStateProvider/ViewStateProvider.tsx
125
- import { RegistryContext as RegistryContext2 } from "@effect-atom/atom-react";
126
- import { createContext as createContext2 } from "@radix-ui/react-context";
127
- import React2, { useContext as useContext2, useEffect as useEffect2, useMemo as useMemo2, useState as useState2 } from "react";
128
- import { invariant } from "@dxos/invariant";
129
- import { useDefaultValue as useDefaultValue2 } from "@dxos/react-hooks";
130
- var __dxlog_file2 = "/__w/dxos/dxos/packages/ui/react-ui-attention/src/components/ViewStateProvider/ViewStateProvider.tsx";
131
- var VIEW_STATE_NAME = "ViewState";
132
- var [ViewStateContextProvider, useViewStateContext] = createContext2(VIEW_STATE_NAME, {
133
- manager: void 0
134
- });
135
- var ViewStateProvider = ({ children, manager: managerProp }) => {
136
- const registry = useContext2(RegistryContext2);
137
- const manager = useDefaultValue2(managerProp, () => new ViewStateManager({
138
- registry,
139
- backends: createDefaultBackends(registry)
140
- }));
141
- return /* @__PURE__ */ React2.createElement(ViewStateContextProvider, {
142
- manager
143
- }, children);
144
- };
145
- var useViewStateManager = () => {
146
- const { manager } = useViewStateContext(VIEW_STATE_NAME);
147
- invariant(manager, "useViewStateManager() requires a ViewStateProvider ancestor.", { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 29, S: void 0, A: ["manager", "'useViewStateManager() requires a ViewStateProvider ancestor.'"] });
148
- return manager;
149
- };
150
- var useViewStateManagerOptional = () => {
151
- const { manager } = useViewStateContext(VIEW_STATE_NAME);
152
- return manager;
153
- };
154
- var useViewState = (aspect, contextId) => {
155
- const { manager } = useViewStateContext(VIEW_STATE_NAME);
156
- const [value, setValue] = useState2(() => contextId && manager ? manager.get(aspect, contextId) : aspect.defaultValue());
157
- useEffect2(() => {
158
- if (!contextId || !manager) {
159
- setValue(aspect.defaultValue());
160
- return;
161
- }
162
- setValue(manager.get(aspect, contextId));
163
- return manager.subscribe(aspect, contextId, setValue);
164
- }, [
165
- manager,
166
- aspect,
167
- contextId
168
- ]);
169
- return value;
170
- };
171
- var useViewStateActions = (aspect, contextId) => {
172
- const { manager } = useViewStateContext(VIEW_STATE_NAME);
173
- return useMemo2(() => ({
174
- set: (value) => {
175
- if (contextId) {
176
- manager?.set(aspect, contextId, value);
177
- }
178
- },
179
- update: (fn) => {
180
- if (contextId) {
181
- manager?.update(aspect, contextId, fn);
182
- }
183
- },
184
- clear: () => {
185
- if (contextId) {
186
- manager?.set(aspect, contextId, aspect.defaultValue());
187
- }
188
- }
189
- }), [
190
- manager,
191
- aspect,
192
- contextId
193
- ]);
194
- };
195
- var useSelection = (contextId, mode = "multi") => resolveSelection(useViewState(selectionAspect, contextId), mode);
196
- var useSelectionActions = (contextId) => {
197
- const { update, clear } = useViewStateActions(selectionAspect, contextId);
198
- return useMemo2(() => ({
199
- single: (id) => update(() => ({
200
- mode: "single",
201
- id
202
- })),
203
- multi: (ids) => update(() => ({
204
- mode: "multi",
205
- ids: [
206
- ...ids
207
- ]
208
- })),
209
- range: (from, to) => update(() => ({
210
- mode: "range",
211
- from,
212
- to
213
- })),
214
- toggle: (id) => update((prev) => toggleSelection(prev, id)),
215
- clear
216
- }), [
217
- update,
218
- clear
219
- ]);
220
- };
221
-
222
- export {
223
- useAttentionContext,
224
- useAttention,
225
- useAttended,
226
- useAttentionAttributes,
227
- RootAttentionProvider,
228
- AttendableContainer,
229
- ViewStateProvider,
230
- useViewStateManager,
231
- useViewStateManagerOptional,
232
- useViewState,
233
- useViewStateActions,
234
- useSelection,
235
- useSelectionActions
236
- };
237
- //# sourceMappingURL=chunk-DLBZMHST.mjs.map
@@ -1,7 +0,0 @@
1
- {
2
- "version": 3,
3
- "sources": ["../../../src/components/AttentionProvider/AttentionProvider.tsx", "../../../src/components/ViewStateProvider/ViewStateProvider.tsx"],
4
- "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport { RegistryContext } from '@effect-atom/atom-react';\nimport { createContext } from '@radix-ui/react-context';\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 useEffect,\n useMemo,\n useState,\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 { type Attention, AttentionManager, getAttendables } from '../../attention';\n\nconst ATTENTION_NAME = 'Attention';\nconst ATTENDABLE_ATTRIBUTE = 'data-attendable-id';\nconst ATTENTION_SOURCE_ATTRIBUTE = 'data-w-attention-source';\n\ntype AttentionContextValue = {\n attention: AttentionManager;\n};\n\nconst [AttentionContextProvider, useAttentionContext] = createContext<AttentionContextValue>(ATTENTION_NAME, {\n attention: undefined as unknown as AttentionManager,\n});\n\nconst 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 seleciton and change to contextId?\nconst 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\nconst 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 */\nconst 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\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 '[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.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 role='none'\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 {\n AttendableContainer,\n RootAttentionProvider,\n useAttended,\n useAttention,\n useAttentionAttributes,\n useAttentionContext,\n};\n", "//\n// Copyright 2026 DXOS.org\n//\n\nimport { RegistryContext } from '@effect-atom/atom-react';\nimport { createContext } from '@radix-ui/react-context';\nimport React, { type PropsWithChildren, useContext, useEffect, useMemo, useState } from 'react';\n\nimport { invariant } from '@dxos/invariant';\nimport { useDefaultValue } from '@dxos/react-hooks';\n\nimport {\n type SelectionMode,\n type SelectionResult,\n resolveSelection,\n selectionAspect,\n toggleSelection,\n} from '../../selection';\nimport { type AspectDef, ViewStateManager, createDefaultBackends } from '../../view-state';\n\nconst VIEW_STATE_NAME = 'ViewState';\n\ntype ViewStateContextValue = { manager?: ViewStateManager };\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.\nconst [ViewStateContextProvider, useViewStateContext] = createContext<ViewStateContextValue>(VIEW_STATE_NAME, {\n manager: undefined,\n});\n\n/** Provides the per-context UI state manager. Replaces the former `SelectionProvider`. */\nexport const ViewStateProvider = ({\n children,\n manager: managerProp,\n}: PropsWithChildren<{ manager?: ViewStateManager }>) => {\n const registry = useContext(RegistryContext);\n const manager = useDefaultValue(\n managerProp,\n () => new ViewStateManager({ registry, backends: createDefaultBackends(registry) }),\n );\n return <ViewStateContextProvider manager={manager}>{children}</ViewStateContextProvider>;\n};\n\n/** Access the underlying ViewStateManager from context. Throws when used outside a `ViewStateProvider`. */\nexport const useViewStateManager = (): ViewStateManager => {\n const { manager } = useViewStateContext(VIEW_STATE_NAME);\n invariant(manager, 'useViewStateManager() requires a ViewStateProvider ancestor.');\n return manager;\n};\n\n/** Access the ViewStateManager if a provider is present; `undefined` otherwise (e.g. isolated stories/tests). */\nexport const useViewStateManagerOptional = (): ViewStateManager | 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,>(aspect: AspectDef<T>, 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,>(aspect: AspectDef<T>, contextId?: string): 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 SelectionMode>(contextId?: string, mode: T = 'multi' as T): SelectionResult<T> =>\n resolveSelection(useViewState(selectionAspect, 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(selectionAspect, 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) => toggleSelection(prev, id)),\n clear,\n }),\n [update, clear],\n );\n};\n"],
5
- "mappings": ";;;;;;;;;;;;AAIA,SAASA,uBAAuB;AAChC,SAASC,qBAAqB;AAC9B,SAASC,iBAAiB;AAC1B,SAASC,YAAY;AACrB,OAAOC,SAILC,YACAC,aACAC,YACAC,WACAC,SACAC,gBACK;AAEP,SAASC,WAAW;AACpB,SAASC,uBAAuB;AAEhC,SAASC,UAAU;AAInB,IAAA,eAAMC;AAEN,IAAMC,iBAAAA;AAMN,IAAM,uBAACC;IACLC,6BAAWC;AACb,IAAA,CAAA,0BAAA,mBAAA,IAAA,cAAA,gBAAA;EAEA,WAAMC;;IAA4CC,qBAAY;EAAOC,cAAW;EAAM,YAAA;EAEtF,WAAA;;IAME,eAAcC,CAAAA,iBAAYC;AAC1BC,QAAAA,EAAAA,UAAU,IAAA,oBAAA,cAAA;QACR,CAAA,OAAKC,QAAAA,IAAiBR,SAAAA,kBAAW;YAC/BK,MAAAA;QACA,CAAA,gBAAA,CAAA,WAAA;AACF,eAAA,kBAAA;AAEA;IACAA;AAEA,UAAA,eAAiBI,UAAUD,IAAAA,YAAeE;aACxCL,YAASK;AACX,WAAA,UAAA,UAAA,cAAA,CAAA,aAAA;AACC,eAAA,QAAA;IAACV,CAAAA;;IAAwB;IAE5B;EACF,CAAA;AAEA,SAAMW;;IAEJ,cAAgBC,MAAAA;AAChBL,QAAAA,EAAAA,UAAU,IAAA,oBAAA,cAAA;QACR,CAAA,SAAKP,UAAW,IAAA,SAAA,CAAA,CAAA;YACd,MAAA;AACF,QAAA,CAAA,WAAA;AAEAY;IAEA;eACEA,UAAWC,WAAAA,CAAAA;AACb,WAAA,UAAA,iBAAA,CAAA,eAAA;AACC,iBAAA,UAAA;IAACb,CAAAA;KAAU;IAEd;EACF,CAAA;AAEA,SAAA;;AAKE,IAAA,yBAAe,CAAA,iBAAA;QACb,EAAA,aAAMc,IAAiD,aAAA,YAAA;iBAAGC,MAAAA;AAAoC,UAAA,aAAA;MAC1FC,CAAAA,oBAAc,GAAA;;AAElB,QAAA,cAAA;AAEA,iBAAOF,0BAAAA,IAAAA;IACN;AAACN,WAAAA;;IAA2B;IACjC;EAOA,CAAA;;IAEE,wBAAkBS,CAAAA,EAAAA,UAAgBC,WAAgB,gBAAUC,SAAiBC,MAAAA;AAE7E,QAAMC,WAAAA,WAAcC,eACjBC;QACC,YAAA,gBAAA,gBAAA,MAAA,IAAA,iBAAA,QAAyE,CAAA;QACzEC,cAAa,YAAA,CAAA,UAAA;QAAgCC,SAAQF;MAAa,SAAA,MAAA;MAElE,QAAMG,MAAW;qBACf,YAAA,GAAA,cAAA,GAAA,IAAA,GAAA,OAAA,CAAA;qBACa;MAGbC;MACF,GAAMC,MAAO5B,KAAAA,SAAU6B,iBAAU,iBAAA,CAAA,EAAA,IAAA,CAAA,OAAA,QAAA,GAAA,aAAA,eAAA,CAAA,IAAA;IACjC,EAAA,KAAMC,GAAAA;AACN,UAAA,OAAA,UAAA,WAAA;AACA,UAAA,OAAA,eAAA,UAAA,MAAA,MAAA;QAIEC,KAAAA,SAAWD,MAAAA,KAAAA,WAAAA,KAAAA,UAAAA,CAAAA,CAAAA,KAAAA,KAAAA,CAAAA,IAAAA,UAAAA,KAAAA,KAAAA,MAAAA,EAAAA,IAAAA;AACb,gBAAA,OAAA,IAAA;AAEF,iBAAA,IAAA;IAAC9B;;IAAoB;IAGvB;;SAEI,sBAAA,cAACgC,0BAAAA;IAAIC;KAAqBC,sBAAgBb,cAAAA,OAAAA;IACvCc,WAAAA;IAIT,gBAAA;EAMA,GAAA,QAAA,CAAA;;AASI,IAAMC,sBAAkCJ,2BAAG,CAAA,EAAA,IAAA,YAAA,UAAA,SAAA,GAAA,MAAA,GAAA,iBAAA;AAC3C,QAAA,iBACE,uBAACI,EAAAA;QACCC,OAAK,UAAA,OAAA,UAAA;SACI,sBAAA,cAAA,MAAA;IACR,MAAGC;IACJL,GAAAA;IACAM,GAAAA;IAECJ,WAAAA,GAAAA,wBAAAA,MAAAA,aAAAA,KAAAA,gCAAAA,UAAAA;IAGP,KAAA;EAGF,GAAA,QACEK;;;;ACrKF,SAASC,mBAAAA,wBAAuB;AAChC,SAASC,iBAAAA,sBAAqB;AAC9B,OAAOC,UAAiCC,cAAAA,aAAYC,aAAAA,YAAWC,WAAAA,UAASC,YAAAA,iBAAgB;AAExF,SAASC,iBAAiB;AAC1B,SAASC,mBAAAA,wBAAuB;AAWhC,IAAAC,gBAAMC;AAKN,IAAA,kBAAA;AAGA,IAAA,CAAA,0BAAA,mBAAA,IAAAC,eAAA,iBAAA;EAEA,SAAA;;AAQ+B,IAAA,oBAAA,CAAA,EAAA,UAAA,SAAA,YAAA,MAAA;mBAAEC,YAAAA,gBAAAA;kBAAUC,iBAAUC,aAAsBF,MAAAA,IAAAA,iBAAAA;IAAU;IAEnF,UAAA,sBAAO,QAACG;EAAyBC,CAAAA,CAAAA;SAAmBC,gBAAAA,OAAAA,cAAAA,0BAAAA;IACpD;EAEF,GAAA,QAAA;;AAGqB,IAAA,sBAAA,MAAA;AACnB,QAAA,EAAOD,QAAAA,IAAAA,oBAAAA,eAAAA;AACP,YAAA,SAAA,gEAAA,EAAA,YAAA,YAAA,GAAAP,eAAA,GAAA,IAAA,GAAA,QAAA,GAAA,CAAA,WAAA,gEAAA,EAAA,CAAA;AAEF,SAAA;;AAGSO,IAAAA,8BAAAA,MAAAA;AACP,QAAA,EAAA,QAAA,IAAA,oBAAA,eAAA;AAEF,SAAA;;AAImEE,IAAY,eAAA,CAAA,QAAA,cAAA;AAE7EC,QAAAA,EAAAA,QAAU,IAAA,oBAAA,eAAA;QACR,CAAA,OAAKC,QAAa,IAACJ,UAAS,MAAA,aAAA,UAAA,QAAA,IAAA,QAAA,SAAA,IAAA,OAAA,aAAA,CAAA;aAC1BK,MAAAA;QACA,CAAA,aAAA,CAAA,SAAA;AACF,eAAA,OAAA,aAAA,CAAA;AACAA;IACA;AACC,aAAA,QAAA,IAAA,QAAA,SAAA,CAAA;AAACL,WAAAA,QAAAA,UAAAA,QAAAA,WAAAA,QAAAA;;IAAiBI;IAAU;IAC/B;EACA,CAAA;AAQF,SAAO;;AAEL,IAAOE,sBACE,CAAA,QAAA,cAAA;UACLC,QAAMC,IAAAA,oBAAAA,eAAAA;kBACJ,OAAIJ;oBACFJ;AACF,UAAA,WAAA;AACF,iBAAA,IAAA,QAAA,WAAA,KAAA;MACAS;;YAEIT,CAAAA,OAAAA;AACF,UAAA,WAAA;AACF,iBAAA,OAAA,QAAA,WAAA,EAAA;MACAU;;iBAEIV;AACF,UAAA,WAAA;AACF,iBAAA,IAAA,QAAA,WAAA,OAAA,aAAA,CAAA;MAEF;IAACA;EAASW,IAAAA;IAAQP;IAAU;IAE9B;EAEF,CAAA;AAYA;AAEiEA,IAAAA,eAAAA,CAAAA,WAAAA,OAAAA,YAAAA,iBAAAA,aAAAA,iBAAAA,SAAAA,GAAAA,IAAAA;AAEtD,IAAA,sBAAA,CAAA,cAAA;UACLQ,QAAQ,MAAQH,IAAAA,oBAAc,iBAAA,SAAA;yBAAEI;oBAAgBC,OAAAA,OAAAA;MAAG,MAAA;MAC3CC;;oBAAuCA,OAAK,OAAA;;WAAQ;QAAC,GAAA;MACrDC;;kBAA4CA,OAAAA,OAAAA,OAAAA;MAAMC,MAAAA;MAAG;MACpDH;IACTJ,EAAAA;IAEF,QAAA,CAAA,OAAA,OAAA,CAAA,SAAA,gBAAA,MAAA,EAAA,CAAA;IAACD;EAAQC,IAAAA;IAAM;IAEjB;;;",
6
- "names": ["RegistryContext", "createContext", "Primitive", "Slot", "React", "forwardRef", "useCallback", "useContext", "useEffect", "useMemo", "useState", "log", "useDefaultValue", "mx", "ATTENTION_NAME", "ATTENTION_SOURCE_ATTRIBUTE", "AttentionContextProvider", "attention", "undefined", "UNKNOWN_ATTENDABLE", "isAncestor", "isRelated", "setState", "useState", "useEffect", "attendableId", "subscribe", "newState", "useAttended", "setCurrent", "newCurrent", "attributes", "ATTENDABLE_ATTRIBUTE", "hasAttention", "useDefaultValue", "propsAttention", "AttentionManager", "registry", "handleFocus", "useCallback", "event", "log", "target", "selector", "join", "prev", "getCurrent", "next", "onChange", "div", "className", "onFocusCapture", "children", "Comp", "role", "attentionAttrs", "ref", "AttendableContainer", "RegistryContext", "createContext", "React", "useContext", "useEffect", "useMemo", "useState", "invariant", "useDefaultValue", "__dxlog_file", "VIEW_STATE_NAME", "createContext", "registry", "backends", "createDefaultBackends", "ViewStateContextProvider", "manager", "children", "defaultValue", "useEffect", "contextId", "setValue", "useMemo", "set", "value", "update", "clear", "aspect", "single", "mode", "id", "ids", "from", "to"]
7
- }