@dxos/plugin-deck 0.8.4-main.5ad4a44 → 0.8.4-main.66e292d

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 (108) hide show
  1. package/dist/lib/browser/{app-graph-builder-YYP67JHW.mjs → app-graph-builder-D74NTOMK.mjs} +8 -33
  2. package/dist/lib/browser/app-graph-builder-D74NTOMK.mjs.map +7 -0
  3. package/dist/lib/browser/{check-app-scheme-GCOL6YDT.mjs → check-app-scheme-HIEVFAAX.mjs} +2 -2
  4. package/dist/lib/browser/{chunk-HUWUYTOI.mjs → chunk-5KMJPIQC.mjs} +2 -2
  5. package/dist/lib/browser/{chunk-A4SRCSJX.mjs → chunk-F3VCCHVL.mjs} +5 -3
  6. package/dist/lib/browser/chunk-F3VCCHVL.mjs.map +7 -0
  7. package/dist/lib/browser/{chunk-YRDCQS7E.mjs → chunk-QKCGZ45E.mjs} +17 -16
  8. package/dist/lib/browser/chunk-QKCGZ45E.mjs.map +7 -0
  9. package/dist/lib/browser/chunk-UXLU6CMW.mjs +16 -0
  10. package/dist/lib/browser/chunk-UXLU6CMW.mjs.map +7 -0
  11. package/dist/lib/browser/{chunk-JH4ZCG5I.mjs → chunk-VBYJ664A.mjs} +8 -5
  12. package/dist/lib/browser/chunk-VBYJ664A.mjs.map +7 -0
  13. package/dist/lib/browser/{chunk-3SV2V3AN.mjs → chunk-VUJ6UNIJ.mjs} +384 -326
  14. package/dist/lib/browser/chunk-VUJ6UNIJ.mjs.map +7 -0
  15. package/dist/lib/browser/index.mjs +7 -6
  16. package/dist/lib/browser/index.mjs.map +2 -2
  17. package/dist/lib/browser/{intent-resolver-2NFDKRFG.mjs → intent-resolver-UA4YQGAC.mjs} +6 -6
  18. package/dist/lib/browser/{intent-resolver-2NFDKRFG.mjs.map → intent-resolver-UA4YQGAC.mjs.map} +2 -2
  19. package/dist/lib/browser/meta.json +1 -1
  20. package/dist/lib/browser/{react-root-JTWYCDJT.mjs → react-root-JAMHKYWN.mjs} +9 -8
  21. package/dist/lib/browser/react-root-JAMHKYWN.mjs.map +7 -0
  22. package/dist/lib/browser/{react-surface-PZKJ73JS.mjs → react-surface-6LW337ZT.mjs} +7 -7
  23. package/dist/lib/browser/{settings-JK7UIZSB.mjs → settings-SDPTOCCM.mjs} +5 -4
  24. package/dist/lib/browser/{settings-JK7UIZSB.mjs.map → settings-SDPTOCCM.mjs.map} +3 -3
  25. package/dist/lib/browser/state-7IFAGZQO.mjs +12 -0
  26. package/dist/lib/browser/toolkit-L5CFXJCF.mjs +52 -0
  27. package/dist/lib/browser/toolkit-L5CFXJCF.mjs.map +7 -0
  28. package/dist/lib/browser/types/index.mjs +2 -2
  29. package/dist/lib/browser/{url-handler-MRYBE3HF.mjs → url-handler-QEYGYE2H.mjs} +4 -4
  30. package/dist/types/src/capabilities/intent-resolver.d.ts.map +1 -1
  31. package/dist/types/src/capabilities/react-root.d.ts.map +1 -1
  32. package/dist/types/src/capabilities/settings.d.ts.map +1 -1
  33. package/dist/types/src/capabilities/state.d.ts +3 -0
  34. package/dist/types/src/capabilities/state.d.ts.map +1 -1
  35. package/dist/types/src/capabilities/toolkit.d.ts +21 -2
  36. package/dist/types/src/capabilities/toolkit.d.ts.map +1 -1
  37. package/dist/types/src/components/DeckLayout/DeckLayout.d.ts +2 -3
  38. package/dist/types/src/components/DeckLayout/DeckLayout.d.ts.map +1 -1
  39. package/dist/types/src/components/DeckLayout/DeckLayout.stories.d.ts +74 -0
  40. package/dist/types/src/components/DeckLayout/DeckLayout.stories.d.ts.map +1 -0
  41. package/dist/types/src/components/DeckLayout/DeckMain.d.ts +3 -0
  42. package/dist/types/src/components/DeckLayout/DeckMain.d.ts.map +1 -0
  43. package/dist/types/src/components/DeckLayout/Popover.d.ts.map +1 -1
  44. package/dist/types/src/components/DeckLayout/Toast.d.ts +5 -0
  45. package/dist/types/src/components/DeckLayout/Toast.d.ts.map +1 -1
  46. package/dist/types/src/components/DeckSettings/DeckSettings.d.ts.map +1 -1
  47. package/dist/types/src/components/Plank/Plank.d.ts.map +1 -1
  48. package/dist/types/src/components/Plank/Plank.stories.d.ts +2 -1
  49. package/dist/types/src/components/Plank/Plank.stories.d.ts.map +1 -1
  50. package/dist/types/src/components/Plank/PlankControls.d.ts.map +1 -1
  51. package/dist/types/src/components/Plank/PlankHeading.d.ts.map +1 -1
  52. package/dist/types/src/components/Sidebar/ComplementarySidebar.d.ts.map +1 -1
  53. package/dist/types/src/components/Sidebar/SidebarButton.d.ts.map +1 -1
  54. package/dist/types/src/hooks/useDeckCompanions.d.ts.map +1 -1
  55. package/dist/types/src/hooks/useHoistStatusbar.d.ts.map +1 -1
  56. package/dist/types/src/meta.d.ts.map +1 -1
  57. package/dist/types/src/translations.d.ts +2 -1
  58. package/dist/types/src/translations.d.ts.map +1 -1
  59. package/dist/types/src/types/schema.d.ts +1 -0
  60. package/dist/types/src/types/schema.d.ts.map +1 -1
  61. package/dist/types/tsconfig.tsbuildinfo +1 -1
  62. package/package.json +33 -33
  63. package/src/capabilities/app-graph-builder.ts +22 -22
  64. package/src/capabilities/intent-resolver.ts +0 -1
  65. package/src/capabilities/react-root.tsx +2 -1
  66. package/src/capabilities/settings.ts +1 -0
  67. package/src/capabilities/state.ts +8 -0
  68. package/src/capabilities/toolkit.ts +23 -14
  69. package/src/components/DeckLayout/ActiveNode.tsx +1 -1
  70. package/src/components/DeckLayout/Banner.tsx +1 -1
  71. package/src/components/DeckLayout/ContentEmpty.tsx +1 -1
  72. package/src/components/DeckLayout/DeckLayout.stories.tsx +63 -0
  73. package/src/components/DeckLayout/DeckLayout.tsx +8 -278
  74. package/src/components/DeckLayout/DeckMain.tsx +281 -0
  75. package/src/components/DeckLayout/Dialog.tsx +1 -1
  76. package/src/components/DeckLayout/Fallback.tsx +1 -1
  77. package/src/components/DeckLayout/Popover.tsx +4 -13
  78. package/src/components/DeckLayout/StatusBar.tsx +1 -1
  79. package/src/components/DeckLayout/Toast.tsx +26 -1
  80. package/src/components/DeckSettings/DeckSettings.tsx +6 -0
  81. package/src/components/Plank/Plank.tsx +65 -31
  82. package/src/components/Plank/PlankControls.tsx +3 -2
  83. package/src/components/Plank/PlankHeading.tsx +5 -4
  84. package/src/components/Sidebar/ComplementarySidebar.tsx +31 -11
  85. package/src/components/Sidebar/Sidebar.tsx +1 -1
  86. package/src/components/Sidebar/SidebarButton.tsx +10 -9
  87. package/src/hooks/useCompanions.ts +1 -1
  88. package/src/hooks/useDeckCompanions.ts +2 -1
  89. package/src/hooks/useHoistStatusbar.ts +5 -3
  90. package/src/meta.ts +5 -0
  91. package/src/translations.ts +2 -1
  92. package/src/types/schema.ts +2 -0
  93. package/dist/lib/browser/app-graph-builder-YYP67JHW.mjs.map +0 -7
  94. package/dist/lib/browser/chunk-3SV2V3AN.mjs.map +0 -7
  95. package/dist/lib/browser/chunk-A4SRCSJX.mjs.map +0 -7
  96. package/dist/lib/browser/chunk-JH4ZCG5I.mjs.map +0 -7
  97. package/dist/lib/browser/chunk-MHP4GPX5.mjs +0 -11
  98. package/dist/lib/browser/chunk-MHP4GPX5.mjs.map +0 -7
  99. package/dist/lib/browser/chunk-YRDCQS7E.mjs.map +0 -7
  100. package/dist/lib/browser/react-root-JTWYCDJT.mjs.map +0 -7
  101. package/dist/lib/browser/state-IFKFOBBX.mjs +0 -12
  102. package/dist/lib/browser/toolkit-L7C3UAEU.mjs +0 -63
  103. package/dist/lib/browser/toolkit-L7C3UAEU.mjs.map +0 -7
  104. /package/dist/lib/browser/{check-app-scheme-GCOL6YDT.mjs.map → check-app-scheme-HIEVFAAX.mjs.map} +0 -0
  105. /package/dist/lib/browser/{chunk-HUWUYTOI.mjs.map → chunk-5KMJPIQC.mjs.map} +0 -0
  106. /package/dist/lib/browser/{react-surface-PZKJ73JS.mjs.map → react-surface-6LW337ZT.mjs.map} +0 -0
  107. /package/dist/lib/browser/{state-IFKFOBBX.mjs.map → state-7IFAGZQO.mjs.map} +0 -0
  108. /package/dist/lib/browser/{url-handler-MRYBE3HF.mjs.map → url-handler-QEYGYE2H.mjs.map} +0 -0
@@ -2,301 +2,31 @@
2
2
  // Copyright 2023 DXOS.org
3
3
  //
4
4
 
5
- import { untracked } from '@preact/signals-core';
6
- import React, { Fragment, type UIEvent, useCallback, useEffect, useMemo, useRef } from 'react';
5
+ import React from 'react';
7
6
 
8
- import {
9
- Capabilities,
10
- LayoutAction,
11
- createIntent,
12
- useCapability,
13
- useIntentDispatcher,
14
- usePluginManager,
15
- } from '@dxos/app-framework';
16
- import { AttentionCapabilities } from '@dxos/plugin-attention';
17
- import { Main, type MainProps, useMediaQuery, useOnTransition } from '@dxos/react-ui';
18
- import { DEFAULT_HORIZONTAL_SIZE, Stack, StackContext } from '@dxos/react-ui-stack';
19
- import { mainPaddingTransitions } from '@dxos/react-ui-theme';
7
+ import { useCapability } from '@dxos/app-framework/react';
20
8
 
21
9
  import { DeckCapabilities } from '../../capabilities';
22
- import { useBreakpoints, useHoistStatusbar } from '../../hooks';
23
- import { meta } from '../../meta';
24
- import { type DeckSettingsProps, getMode } from '../../types';
25
- import { calculateOverscroll, layoutAppliesTopbar } from '../../util';
26
- import { fixedComplementarySidebarToggleStyles, fixedSidebarToggleStyles } from '../fragments';
27
- import { Plank } from '../Plank';
28
- import { ComplementarySidebar, Sidebar, ToggleComplementarySidebarButton, ToggleSidebarButton } from '../Sidebar';
29
10
 
30
11
  import { ActiveNode } from './ActiveNode';
31
- import { ContentEmpty } from './ContentEmpty';
12
+ import { DeckMain } from './DeckMain';
32
13
  import { Dialog } from './Dialog';
33
14
  import { PopoverContent, PopoverRoot } from './Popover';
34
- import { StatusBar } from './StatusBar';
35
- import { Toast } from './Toast';
36
- import { Topbar } from './Topbar';
15
+ import { Toaster, type ToasterProps } from './Toast';
37
16
 
38
- export type DeckLayoutProps = {
39
- onDismissToast: (id: string) => void;
40
- };
41
-
42
- const PlankSeparator = ({ order }: { order: number }) =>
43
- order > 0 ? <span role='separator' className='row-span-2 bg-deckSurface is-4' style={{ gridColumn: order }} /> : null;
17
+ export type DeckLayoutProps = Pick<ToasterProps, 'onDismissToast'>;
44
18
 
45
19
  export const DeckLayout = ({ onDismissToast }: DeckLayoutProps) => {
46
- const { dispatchPromise: dispatch } = useIntentDispatcher();
47
- const settings = useCapability(Capabilities.SettingsStore).getStore<DeckSettingsProps>(meta.id)!.value;
48
20
  const context = useCapability(DeckCapabilities.MutableDeckState);
49
- const { sidebarState, complementarySidebarState, complementarySidebarPanel, deck, toasts } = context;
50
- const { active, activeCompanions, fullscreen, solo, plankSizing } = deck;
51
- const breakpoint = useBreakpoints();
52
- const layoutMode = getMode(deck);
53
- const topbar = layoutAppliesTopbar(breakpoint, layoutMode);
54
- const hoistStatusbar = useHoistStatusbar(breakpoint, layoutMode);
55
- const pluginManager = usePluginManager();
56
-
57
- const scrollLeftRef = useRef<number>(null);
58
- const deckRef = useRef<HTMLDivElement>(null);
59
-
60
- // Ensure the first plank is attended when the deck is first rendered.
61
- useEffect(() => {
62
- // NOTE: Not `useAttended` so that the layout component is not re-rendered when the attended list changes.
63
- const attended = untracked(() => {
64
- const attention = pluginManager.context.getCapability(AttentionCapabilities.Attention);
65
- return attention.current;
66
- });
67
- const firstId = solo ?? active[0];
68
- if (attended.length === 0 && firstId) {
69
- // TODO(wittjosiah): Focusing the type button is a workaround.
70
- // If the plank is directly focused on first load the focus ring appears.
71
- document.querySelector<HTMLElement>(`article[data-attendable-id="${firstId}"] button`)?.focus();
72
- }
73
- }, []);
74
-
75
- // Not using `breakpoint` to avoid firing when breakpoint changes between tablet and desktop.
76
- // `ssr: false` to avoid using fallback values and flashing into solo mode on startup.
77
- const [isNotMobile] = useMediaQuery('md');
78
- const shouldRevert = useRef(false);
79
- useEffect(() => {
80
- if (!isNotMobile && getMode(deck) === 'deck') {
81
- // NOTE: Not `useAttended` so that the layout component is not re-rendered when the attended list changes.
82
- const attended = untracked(() => {
83
- const attention = pluginManager.context.getCapability(AttentionCapabilities.Attention);
84
- return attention.current;
85
- });
86
-
87
- shouldRevert.current = true;
88
- void dispatch(
89
- createIntent(LayoutAction.SetLayoutMode, { part: 'mode', subject: attended[0], options: { mode: 'solo' } }),
90
- );
91
- } else if (isNotMobile && getMode(deck) === 'solo' && shouldRevert.current) {
92
- void dispatch(createIntent(LayoutAction.SetLayoutMode, { part: 'mode', options: { revert: true } }));
93
- }
94
- }, [isNotMobile, deck, dispatch]);
95
-
96
- // When deck is disabled in settings, set to solo mode if the current layout mode is deck.
97
- // TODO(thure): Applying this as an effect should be avoided over emitting the intent only when the setting changes.
98
- useEffect(() => {
99
- if (!settings.enableDeck && layoutMode === 'deck') {
100
- void dispatch(
101
- createIntent(LayoutAction.SetLayoutMode, { part: 'mode', subject: active[0], options: { mode: 'solo' } }),
102
- );
103
- }
104
- }, [settings.enableDeck, dispatch, active, layoutMode]);
105
-
106
- /**
107
- * Clear scroll restoration state if the window is resized
108
- */
109
- const handleResize = useCallback(() => {
110
- scrollLeftRef.current = null;
111
- }, []);
112
-
113
- useEffect(() => {
114
- window.addEventListener('resize', handleResize);
115
- return () => window.removeEventListener('resize', handleResize);
116
- }, [handleResize]);
117
-
118
- const restoreScroll = useCallback(() => {
119
- if (deckRef.current && scrollLeftRef.current != null) {
120
- deckRef.current.scrollLeft = scrollLeftRef.current;
121
- }
122
- }, []);
123
- useOnTransition(layoutMode, (mode) => mode !== 'deck', 'deck', restoreScroll);
124
-
125
- /**
126
- * Save scroll position as the user scrolls
127
- */
128
- const handleScroll = useCallback(
129
- (event: UIEvent) => {
130
- if (!solo && event.currentTarget === event.target) {
131
- scrollLeftRef.current = (event.target as HTMLDivElement).scrollLeft;
132
- }
133
- },
134
- [solo],
135
- );
136
-
137
- const isEmpty = !solo && active.length === 0;
138
-
139
- const padding = useMemo(() => {
140
- if (!solo && settings.overscroll === 'centering') {
141
- return calculateOverscroll(active.length);
142
- }
143
- return {};
144
- }, [solo, settings.overscroll, deck]);
145
-
146
- const mainPosition = useMemo(
147
- () => [
148
- 'grid !block-start-[env(safe-area-inset-top)]',
149
- topbar && '!block-start-[calc(env(safe-area-inset-top)+var(--rail-size))]',
150
- hoistStatusbar && 'lg:block-end-[--statusbar-size]',
151
- ],
152
- [topbar, hoistStatusbar],
153
- );
154
-
155
- const { order, itemsCount }: { order: Record<string, number>; itemsCount: number } = useMemo(() => {
156
- return active.reduce(
157
- (acc: { order: Record<string, number>; itemsCount: number }, entryId) => {
158
- acc.order[entryId] = acc.itemsCount + 1;
159
- acc.itemsCount += activeCompanions?.[entryId] ? 3 : 2;
160
- return acc;
161
- },
162
- { order: {}, itemsCount: 0 },
163
- );
164
- }, [active, activeCompanions]);
21
+ const { toasts } = context;
165
22
 
166
23
  return (
167
24
  <PopoverRoot>
168
25
  <ActiveNode />
169
-
170
- <Main.Root
171
- navigationSidebarState={fullscreen ? 'closed' : context.sidebarState}
172
- onNavigationSidebarStateChange={(next) => (context.sidebarState = next)}
173
- complementarySidebarState={fullscreen ? 'closed' : context.complementarySidebarState}
174
- onComplementarySidebarStateChange={(next) => (context.complementarySidebarState = next)}
175
- >
176
- {/* Left sidebar. */}
177
- <Sidebar />
178
-
179
- {/* Right sidebar. */}
180
- <ComplementarySidebar current={complementarySidebarPanel} />
181
-
182
- {/* Dialog overlay to dismiss dialogs. */}
183
- <Main.Overlay />
184
-
185
- {/* No content. */}
186
- {isEmpty && (
187
- <Main.Content bounce handlesFocus classNames={mainPosition}>
188
- <ContentEmpty />
189
- </Main.Content>
190
- )}
191
-
192
- {/* Solo/deck mode. */}
193
- {!isEmpty && (
194
- <Main.Content
195
- bounce
196
- handlesFocus
197
- classNames={mainPosition}
198
- style={
199
- {
200
- '--dx-main-sidebarWidth':
201
- sidebarState === 'expanded'
202
- ? 'var(--nav-sidebar-size)'
203
- : sidebarState === 'collapsed'
204
- ? 'var(--l0-size)'
205
- : '0',
206
- '--dx-main-complementaryWidth':
207
- complementarySidebarState === 'expanded'
208
- ? 'var(--complementary-sidebar-size)'
209
- : complementarySidebarState === 'collapsed'
210
- ? 'var(--rail-size)'
211
- : '0',
212
- '--dx-main-contentFirstWidth': `${plankSizing[active[0] ?? 'never'] ?? DEFAULT_HORIZONTAL_SIZE}rem`,
213
- '--dx-main-contentLastWidth': `${plankSizing[active[(active.length ?? 1) - 1] ?? 'never'] ?? DEFAULT_HORIZONTAL_SIZE}rem`,
214
- } as MainProps['style']
215
- }
216
- >
217
- <div
218
- role='none'
219
- className={!solo ? 'relative bg-deckSurface overflow-hidden' : 'sr-only'}
220
- {...(solo && { inert: true })}
221
- >
222
- {!topbar && !fullscreen && <ToggleSidebarButton classNames={fixedSidebarToggleStyles} />}
223
- {!topbar && !fullscreen && (
224
- <ToggleComplementarySidebarButton classNames={fixedComplementarySidebarToggleStyles} />
225
- )}
226
- <Stack
227
- ref={deckRef}
228
- orientation='horizontal'
229
- size='contain'
230
- classNames={['absolute inset-block-0 -inset-inline-px', mainPaddingTransitions]}
231
- itemsCount={itemsCount - 1}
232
- style={padding}
233
- onScroll={handleScroll}
234
- >
235
- {active.map((entryId) => (
236
- <Fragment key={entryId}>
237
- <PlankSeparator order={order[entryId] - 1} />
238
- <Plank
239
- id={entryId}
240
- companionId={activeCompanions?.[entryId]}
241
- part='deck'
242
- order={order[entryId]}
243
- active={active}
244
- layoutMode={layoutMode}
245
- settings={settings}
246
- />
247
- </Fragment>
248
- ))}
249
- </Stack>
250
- </div>
251
- <div
252
- role='none'
253
- className={solo ? 'relative bg-deckSurface overflow-hidden' : 'sr-only'}
254
- {...(!solo && { inert: true })}
255
- >
256
- {!topbar && !fullscreen && <ToggleSidebarButton classNames={fixedSidebarToggleStyles} />}
257
- {!topbar && !fullscreen && (
258
- <ToggleComplementarySidebarButton classNames={fixedComplementarySidebarToggleStyles} />
259
- )}
260
- <StackContext.Provider value={{ size: 'contain', orientation: 'horizontal', rail: true }}>
261
- <Plank
262
- id={solo}
263
- companionId={solo ? activeCompanions?.[solo] : undefined}
264
- part='solo'
265
- layoutMode={layoutMode}
266
- settings={settings}
267
- />
268
- </StackContext.Provider>
269
- </div>
270
- </Main.Content>
271
- )}
272
-
273
- {/* Topbar. */}
274
- {topbar && <Topbar />}
275
-
276
- {/* Status bar. */}
277
- {hoistStatusbar && <StatusBar showHints={settings.showHints} />}
278
- </Main.Root>
279
-
280
- {/* Global popovers. */}
26
+ <DeckMain />
281
27
  <PopoverContent />
282
-
283
- {/* Global dialog. */}
284
28
  <Dialog />
285
-
286
- {/* Global toasts. */}
287
- {toasts?.map((toast) => (
288
- <Toast
289
- {...toast}
290
- key={toast.id}
291
- onOpenChange={(open) => {
292
- if (!open) {
293
- onDismissToast(toast.id);
294
- }
295
-
296
- return open;
297
- }}
298
- />
299
- ))}
29
+ <Toaster toasts={toasts} onDismissToast={onDismissToast} />
300
30
  </PopoverRoot>
301
31
  );
302
32
  };
@@ -0,0 +1,281 @@
1
+ //
2
+ // Copyright 2023 DXOS.org
3
+ //
4
+
5
+ import { untracked } from '@preact/signals-core';
6
+ import React, { Fragment, type UIEvent, useCallback, useEffect, useMemo, useRef } from 'react';
7
+
8
+ import { Capabilities, LayoutAction, createIntent } from '@dxos/app-framework';
9
+ import { useCapability, useIntentDispatcher, usePluginManager } from '@dxos/app-framework/react';
10
+ import { AttentionCapabilities } from '@dxos/plugin-attention';
11
+ import { Main, type MainProps, useMediaQuery, useOnTransition } from '@dxos/react-ui';
12
+ import { DEFAULT_HORIZONTAL_SIZE, Stack, StackContext } from '@dxos/react-ui-stack';
13
+ import { mainPaddingTransitions, mx } from '@dxos/react-ui-theme';
14
+
15
+ import { DeckCapabilities } from '../../capabilities';
16
+ import { useBreakpoints, useHoistStatusbar } from '../../hooks';
17
+ import { meta } from '../../meta';
18
+ import { type DeckSettingsProps, getMode } from '../../types';
19
+ import { calculateOverscroll, layoutAppliesTopbar } from '../../util';
20
+ import { fixedComplementarySidebarToggleStyles, fixedSidebarToggleStyles } from '../fragments';
21
+ import { Plank } from '../Plank';
22
+ import { ComplementarySidebar, Sidebar, ToggleComplementarySidebarButton, ToggleSidebarButton } from '../Sidebar';
23
+
24
+ import { ContentEmpty } from './ContentEmpty';
25
+ import { StatusBar } from './StatusBar';
26
+ import { Topbar } from './Topbar';
27
+
28
+ export const DeckMain = () => {
29
+ const { dispatchPromise: dispatch } = useIntentDispatcher();
30
+ const settings = useCapability(Capabilities.SettingsStore).getStore<DeckSettingsProps>(meta.id)?.value;
31
+ const context = useCapability(DeckCapabilities.MutableDeckState);
32
+ const { sidebarState, complementarySidebarState, complementarySidebarPanel, deck } = context;
33
+ const { active, activeCompanions, fullscreen, solo, plankSizing } = deck;
34
+ const layoutMode = getMode(deck);
35
+ const breakpoint = useBreakpoints();
36
+ const topbar = layoutAppliesTopbar(breakpoint, layoutMode);
37
+ const hoistStatusbar = useHoistStatusbar(breakpoint, layoutMode);
38
+ const pluginManager = usePluginManager();
39
+
40
+ const scrollLeftRef = useRef<number>(null);
41
+ const deckRef = useRef<HTMLDivElement>(null);
42
+
43
+ // Ensure the first plank is attended when the deck is first rendered.
44
+ useEffect(() => {
45
+ // NOTE: Not `useAttended` so that the layout component is not re-rendered when the attended list changes.
46
+ const attended = untracked(() => {
47
+ const attention = pluginManager.context.getCapability(AttentionCapabilities.Attention);
48
+ return attention.current;
49
+ });
50
+ const firstId = solo ?? active[0];
51
+ if (attended.length === 0 && firstId) {
52
+ // TODO(wittjosiah): Focusing the type button is a workaround.
53
+ // If the plank is directly focused on first load the focus ring appears.
54
+ document.querySelector<HTMLElement>(`article[data-attendable-id="${firstId}"] button`)?.focus();
55
+ }
56
+ }, []);
57
+
58
+ // Not using `breakpoint` to avoid firing when breakpoint changes between tablet and desktop.
59
+ // `ssr: false` to avoid using fallback values and flashing into solo mode on startup.
60
+ const [isNotMobile] = useMediaQuery('md');
61
+ const shouldRevert = useRef(false);
62
+ useEffect(() => {
63
+ if (!isNotMobile && getMode(deck) === 'deck') {
64
+ // NOTE: Not `useAttended` so that the layout component is not re-rendered when the attended list changes.
65
+ const attended = untracked(() => {
66
+ const attention = pluginManager.context.getCapability(AttentionCapabilities.Attention);
67
+ return attention.current;
68
+ });
69
+
70
+ shouldRevert.current = true;
71
+ void dispatch(
72
+ createIntent(LayoutAction.SetLayoutMode, { part: 'mode', subject: attended[0], options: { mode: 'solo' } }),
73
+ );
74
+ } else if (isNotMobile && getMode(deck) === 'solo' && shouldRevert.current) {
75
+ void dispatch(createIntent(LayoutAction.SetLayoutMode, { part: 'mode', options: { revert: true } }));
76
+ }
77
+ }, [isNotMobile, deck, dispatch]);
78
+
79
+ // When deck is disabled in settings, set to solo mode if the current layout mode is deck.
80
+ // TODO(thure): Applying this as an effect should be avoided over emitting the intent only when the setting changes.
81
+ useEffect(() => {
82
+ if (!settings?.enableDeck && layoutMode === 'deck') {
83
+ void dispatch(
84
+ createIntent(LayoutAction.SetLayoutMode, { part: 'mode', subject: active[0], options: { mode: 'solo' } }),
85
+ );
86
+ }
87
+ }, [settings?.enableDeck, dispatch, active, layoutMode]);
88
+
89
+ /**
90
+ * Clear scroll restoration state if the window is resized.
91
+ */
92
+ const handleResize = useCallback(() => {
93
+ scrollLeftRef.current = null;
94
+ }, []);
95
+
96
+ useEffect(() => {
97
+ window.addEventListener('resize', handleResize);
98
+ return () => window.removeEventListener('resize', handleResize);
99
+ }, [handleResize]);
100
+
101
+ const restoreScroll = useCallback(() => {
102
+ if (deckRef.current && scrollLeftRef.current != null) {
103
+ deckRef.current.scrollLeft = scrollLeftRef.current;
104
+ }
105
+ }, []);
106
+ useOnTransition(layoutMode, (mode) => mode !== 'deck', 'deck', restoreScroll);
107
+
108
+ /**
109
+ * Save scroll position as the user scrolls.
110
+ */
111
+ const handleScroll = useCallback(
112
+ (event: UIEvent) => {
113
+ if (!solo && event.currentTarget === event.target) {
114
+ scrollLeftRef.current = (event.target as HTMLDivElement).scrollLeft;
115
+ }
116
+ },
117
+ [solo],
118
+ );
119
+
120
+ const isEmpty = !solo && active.length === 0;
121
+
122
+ const padding = useMemo(() => {
123
+ if (!solo && settings?.overscroll === 'centering') {
124
+ return calculateOverscroll(active.length);
125
+ }
126
+ return {};
127
+ }, [solo, settings?.overscroll, deck]);
128
+
129
+ const mainPosition = useMemo(
130
+ () => [
131
+ 'grid !block-start-[env(safe-area-inset-top)]',
132
+ topbar && '!block-start-[calc(env(safe-area-inset-top)+var(--rail-size))]',
133
+ hoistStatusbar && 'lg:block-end-[--statusbar-size]',
134
+ ],
135
+ [topbar, hoistStatusbar],
136
+ );
137
+
138
+ const { order, itemsCount }: { order: Record<string, number>; itemsCount: number } = useMemo(() => {
139
+ return active.reduce(
140
+ (acc: { order: Record<string, number>; itemsCount: number }, entryId) => {
141
+ acc.order[entryId] = acc.itemsCount + 1;
142
+ acc.itemsCount += activeCompanions?.[entryId] ? 3 : 2;
143
+ return acc;
144
+ },
145
+ { order: {}, itemsCount: 0 },
146
+ );
147
+ }, [active, activeCompanions]);
148
+
149
+ return (
150
+ <Main.Root
151
+ navigationSidebarState={fullscreen ? 'closed' : context.sidebarState}
152
+ complementarySidebarState={fullscreen ? 'closed' : context.complementarySidebarState}
153
+ onNavigationSidebarStateChange={(next) => (context.sidebarState = next)}
154
+ onComplementarySidebarStateChange={(next) => (context.complementarySidebarState = next)}
155
+ >
156
+ {/* Left sidebar. */}
157
+ <Sidebar />
158
+
159
+ {/* Right sidebar. */}
160
+ <ComplementarySidebar current={complementarySidebarPanel} />
161
+
162
+ {/* Dialog overlay to dismiss dialogs. */}
163
+ <Main.Overlay />
164
+
165
+ {/* No content. */}
166
+ {isEmpty && (
167
+ <Main.Content bounce handlesFocus classNames={mainPosition}>
168
+ <ContentEmpty />
169
+ </Main.Content>
170
+ )}
171
+
172
+ {/* Solo/deck mode. */}
173
+ {!isEmpty && (
174
+ <Main.Content
175
+ bounce
176
+ handlesFocus
177
+ classNames={mainPosition}
178
+ style={
179
+ {
180
+ '--main-spacing': settings?.encapsulatedPlanks ? '0.75rem' : '0',
181
+ '--dx-main-sidebarWidth':
182
+ sidebarState === 'expanded'
183
+ ? 'var(--nav-sidebar-size)'
184
+ : sidebarState === 'collapsed'
185
+ ? 'var(--l0-size)'
186
+ : '0',
187
+ '--dx-main-complementaryWidth':
188
+ complementarySidebarState === 'expanded'
189
+ ? 'var(--complementary-sidebar-size)'
190
+ : complementarySidebarState === 'collapsed'
191
+ ? 'var(--rail-size)'
192
+ : '0',
193
+ '--dx-main-contentFirstWidth': `${plankSizing[active[0] ?? 'never'] ?? DEFAULT_HORIZONTAL_SIZE}rem`,
194
+ '--dx-main-contentLastWidth': `${plankSizing[active[(active.length ?? 1) - 1] ?? 'never'] ?? DEFAULT_HORIZONTAL_SIZE}rem`,
195
+ } as MainProps['style']
196
+ }
197
+ >
198
+ {/* Deck mode. */}
199
+ <div
200
+ role='none'
201
+ className={!solo ? 'relative bg-deckSurface overflow-hidden' : 'sr-only'}
202
+ {...(solo && { inert: true })}
203
+ >
204
+ {!topbar && !fullscreen && <ToggleSidebarButton classNames={fixedSidebarToggleStyles} />}
205
+ {!topbar && !fullscreen && (
206
+ <ToggleComplementarySidebarButton classNames={fixedComplementarySidebarToggleStyles} />
207
+ )}
208
+ <Stack
209
+ ref={deckRef}
210
+ orientation='horizontal'
211
+ size='contain'
212
+ itemsCount={itemsCount - 1}
213
+ classNames={[
214
+ 'absolute inset-block-[--main-spacing] -inset-inline-px bs-[calc(100%-2*var(--main-spacing))]',
215
+ mainPaddingTransitions,
216
+ ]}
217
+ style={padding}
218
+ onScroll={handleScroll}
219
+ >
220
+ {active.map((entryId) => (
221
+ <Fragment key={entryId}>
222
+ <PlankSeparator order={order[entryId] - 1} encapsulate={!!settings?.enableDeck} />
223
+ <Plank
224
+ id={entryId}
225
+ companionId={activeCompanions?.[entryId]}
226
+ part='deck'
227
+ order={order[entryId]}
228
+ active={active}
229
+ layoutMode={layoutMode}
230
+ settings={settings}
231
+ />
232
+ </Fragment>
233
+ ))}
234
+ </Stack>
235
+ </div>
236
+ {/* Solo mode. */}
237
+ <div
238
+ role='none'
239
+ className={solo ? 'relative overflow-hidden bg-deckSurface' : 'sr-only'}
240
+ {...(!solo && { inert: true })}
241
+ >
242
+ {!topbar && !fullscreen && <ToggleSidebarButton classNames={fixedSidebarToggleStyles} />}
243
+ {!topbar && !fullscreen && (
244
+ <ToggleComplementarySidebarButton classNames={fixedComplementarySidebarToggleStyles} />
245
+ )}
246
+ <StackContext.Provider
247
+ value={{
248
+ orientation: 'horizontal',
249
+ size: 'contain',
250
+ rail: true,
251
+ }}
252
+ >
253
+ <Plank
254
+ id={solo}
255
+ companionId={solo ? activeCompanions?.[solo] : undefined}
256
+ part='solo'
257
+ layoutMode={layoutMode}
258
+ settings={settings}
259
+ />
260
+ </StackContext.Provider>
261
+ </div>
262
+ </Main.Content>
263
+ )}
264
+
265
+ {/* Topbar. */}
266
+ {topbar && <Topbar />}
267
+
268
+ {/* Status bar. */}
269
+ {hoistStatusbar && <StatusBar showHints={settings?.showHints} />}
270
+ </Main.Root>
271
+ );
272
+ };
273
+
274
+ const PlankSeparator = ({ order, encapsulate }: { order: number; encapsulate?: boolean }) =>
275
+ order > 0 ? (
276
+ <span
277
+ role='separator'
278
+ className={mx('row-span-2 bg-deckSurface', encapsulate ? 'is-0' : 'is-4')}
279
+ style={{ gridColumn: order }}
280
+ />
281
+ ) : null;
@@ -4,7 +4,7 @@
4
4
 
5
5
  import React from 'react';
6
6
 
7
- import { Surface, useCapability } from '@dxos/app-framework';
7
+ import { Surface, useCapability } from '@dxos/app-framework/react';
8
8
  import { AlertDialog, Dialog as NaturalDialog } from '@dxos/react-ui';
9
9
 
10
10
  import { DeckCapabilities } from '../../capabilities';
@@ -18,7 +18,7 @@ export const Fallback = () => {
18
18
  role='alert'
19
19
  className={mx(
20
20
  errorText,
21
- 'border border-error-400/50 rounded-md flex items-center justify-center p-8 font-normal text-lg',
21
+ 'border border-roseFill rounded-md flex items-center justify-center p-8 font-normal text-lg',
22
22
  )}
23
23
  >
24
24
  {t('plugin error message')}
@@ -3,9 +3,9 @@
3
3
  //
4
4
 
5
5
  import { createContext } from '@radix-ui/react-context';
6
- import React, { type PropsWithChildren, useCallback, useEffect, useMemo, useRef, useState } from 'react';
6
+ import React, { type PropsWithChildren, useCallback, useEffect, useRef, useState } from 'react';
7
7
 
8
- import { Surface, useCapability } from '@dxos/app-framework';
8
+ import { Surface, useCapability } from '@dxos/app-framework/react';
9
9
  import { Popover, type PopoverContentInteractOutsideEvent } from '@dxos/react-ui';
10
10
 
11
11
  import { DeckCapabilities } from '../../capabilities';
@@ -76,23 +76,14 @@ export const PopoverContent = () => {
76
76
  [setOpen],
77
77
  );
78
78
 
79
- const collisionBoundaries: HTMLElement[] = useMemo(() => {
80
- const closest = layout.popoverAnchor?.closest('[data-popover-collision-boundary]') as
81
- | HTMLElement
82
- | null
83
- | undefined;
84
- return closest ? [closest] : [];
85
- }, [layout.popoverAnchor]);
86
-
87
79
  return (
88
80
  <Popover.Portal>
89
81
  <Popover.Content
90
82
  side={layout.popoverSide}
91
- onInteractOutside={handleClose}
92
- onEscapeKeyDown={handleClose}
93
- collisionBoundary={collisionBoundaries}
94
83
  sticky='always'
95
84
  hideWhenDetached
85
+ onInteractOutside={handleClose}
86
+ onEscapeKeyDown={handleClose}
96
87
  >
97
88
  <Popover.Viewport>
98
89
  <Surface role='card--popover' data={layout.popoverContent} limit={1} />
@@ -4,7 +4,7 @@
4
4
 
5
5
  import React from 'react';
6
6
 
7
- import { Surface } from '@dxos/app-framework';
7
+ import { Surface } from '@dxos/app-framework/react';
8
8
  import { useLandmarkMover } from '@dxos/react-ui';
9
9
 
10
10
  export const StatusBar = ({ showHints }: { showHints?: boolean }) => {