@olenbetong/synergi-react 2.5.7 → 2.7.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 (68) hide show
  1. package/es/components/AppMenu/AppMenu.css +455 -92
  2. package/es/components/AppMenu/AppMenu.d.ts +47 -0
  3. package/es/components/AppMenu/AppMenu.js +223 -0
  4. package/es/components/AppMenu/AppMenuToggle.d.ts +15 -0
  5. package/es/components/AppMenu/AppMenuToggle.js +14 -0
  6. package/es/components/AppMenu/AppMenuUserMenu.d.ts +32 -0
  7. package/es/components/AppMenu/AppMenuUserMenu.js +110 -0
  8. package/es/components/AppMenu/developerCategories.d.ts +24 -0
  9. package/es/components/AppMenu/developerCategories.js +116 -0
  10. package/es/components/AppMenu/index.d.ts +6 -12
  11. package/es/components/AppMenu/index.js +5 -85
  12. package/es/components/AppMenu/types.d.ts +33 -0
  13. package/es/components/AppMenu/types.js +1 -0
  14. package/es/components/AppMenu/useRovingTabIndex.d.ts +24 -0
  15. package/es/components/AppMenu/useRovingTabIndex.js +103 -0
  16. package/es/components/AppMenu/useServiceWorkerUpdate.d.ts +16 -0
  17. package/es/components/AppMenu/useServiceWorkerUpdate.js +62 -0
  18. package/es/components/AppShell/index.js +107 -13
  19. package/es/components/ImageEditor/ImageEditor.css +22 -11
  20. package/es/components/ImageEditor/ImageEditor.js +12 -12
  21. package/es/components/ImageEditor/ResponsiveButton.d.ts +1 -1
  22. package/es/components/ImageEditor/ResponsiveButton.js +5 -5
  23. package/es/components/ImageEditor/plugins/cropPlugin/CropOverlay.js +2 -2
  24. package/es/components/ImageEditor/plugins/cropPlugin/CropToolbar.js +3 -4
  25. package/es/components/ImageEditor/plugins/cropPlugin/index.js +2 -2
  26. package/es/components/ImageEditor/plugins/redactPlugin/RedactToolbar.js +3 -5
  27. package/es/components/ImageEditor/plugins/redactPlugin/index.js +2 -2
  28. package/es/components/ImageEditor/plugins/rotatePlugin.js +1 -2
  29. package/es/components/ImageEditor/plugins/zoomPlugin/ZoomControls.js +2 -4
  30. package/es/components/ImageEditor/useIsSmall.d.ts +5 -0
  31. package/es/components/ImageEditor/useIsSmall.js +21 -0
  32. package/es/index.d.ts +1 -1
  33. package/es/index.js +1 -1
  34. package/package.json +5 -1
  35. package/src/colorScheme.ts +81 -0
  36. package/src/components/AppMenu/AppMenu.css +648 -158
  37. package/src/components/AppMenu/AppMenu.tsx +285 -0
  38. package/src/components/AppMenu/AppMenuColorScheme.tsx +41 -0
  39. package/src/components/AppMenu/AppMenuFavoriteButton.tsx +47 -0
  40. package/src/components/AppMenu/AppMenuHeader.tsx +79 -0
  41. package/src/components/AppMenu/AppMenuList.tsx +89 -0
  42. package/src/components/AppMenu/AppMenuRail.tsx +117 -0
  43. package/src/components/AppMenu/AppMenuToggle.tsx +51 -0
  44. package/src/components/AppMenu/AppMenuUserMenu.tsx +190 -0
  45. package/src/components/AppMenu/developerCategories.ts +142 -0
  46. package/src/components/AppMenu/icons.tsx +76 -0
  47. package/src/components/AppMenu/index.ts +17 -0
  48. package/src/components/AppMenu/menuEntries.ts +128 -0
  49. package/src/components/AppMenu/types.ts +45 -0
  50. package/src/components/AppMenu/useFavorites.ts +40 -0
  51. package/src/components/AppMenu/useRovingTabIndex.ts +130 -0
  52. package/src/components/AppMenu/useServiceWorkerUpdate.ts +68 -0
  53. package/src/components/AppShell/index.tsx +287 -133
  54. package/src/components/ImageEditor/ImageEditor.css +22 -11
  55. package/src/components/ImageEditor/ImageEditor.tsx +38 -40
  56. package/src/components/ImageEditor/ResponsiveButton.tsx +8 -10
  57. package/src/components/ImageEditor/plugins/cropPlugin/CropOverlay.tsx +6 -6
  58. package/src/components/ImageEditor/plugins/cropPlugin/CropToolbar.tsx +6 -10
  59. package/src/components/ImageEditor/plugins/cropPlugin/index.ts +2 -2
  60. package/src/components/ImageEditor/plugins/redactPlugin/RedactToolbar.tsx +8 -17
  61. package/src/components/ImageEditor/plugins/redactPlugin/index.ts +2 -2
  62. package/src/components/ImageEditor/plugins/rotatePlugin.ts +1 -2
  63. package/src/components/ImageEditor/plugins/zoomPlugin/ZoomControls.tsx +4 -6
  64. package/src/components/ImageEditor/useIsSmall.ts +27 -0
  65. package/src/components/LinkedCardList/index.scss +93 -93
  66. package/src/components/ProgressBar/index.scss +94 -94
  67. package/src/index.ts +61 -37
  68. package/src/components/AppMenu/index.tsx +0 -179
@@ -0,0 +1,285 @@
1
+ import "./AppMenu.css";
2
+
3
+ import { getLocalizedString } from "@olenbetong/appframe-core";
4
+ import type { DataObject } from "@olenbetong/appframe-data";
5
+ import { useData, useLoading } from "@olenbetong/appframe-react";
6
+ import clsx from "clsx";
7
+ import { useEffect, useMemo, useRef, useState } from "react";
8
+
9
+ import { AppMenuHeader } from "./AppMenuHeader.js";
10
+ import { AppMenuList } from "./AppMenuList.js";
11
+ import { AppMenuRail } from "./AppMenuRail.js";
12
+ import type { AppMenuUser } from "./AppMenuUserMenu.js";
13
+ import {
14
+ type AppMenuArticle,
15
+ countItems,
16
+ FAVORITES,
17
+ filterCategory,
18
+ groupEntries,
19
+ groupLabel,
20
+ type Selection,
21
+ toAppEntries,
22
+ } from "./menuEntries.js";
23
+ import type { AppMenuCategory, AppMenuLink, AppMenuLinkGroup } from "./types.js";
24
+ import { useFavorites } from "./useFavorites.js";
25
+
26
+ export type { AppMenuArticle } from "./menuEntries.js";
27
+
28
+ export type AppMenuProps = {
29
+ /** Data object returning the articles to list. See `AppMenuArticle` for the required fields. */
30
+ dataObject: DataObject<AppMenuArticle>;
31
+ /** Whether the menu is open. The menu is a controlled component. */
32
+ open: boolean;
33
+ /** Called when the menu requests to be closed (backdrop click, Escape, app selected). */
34
+ onClose: () => void;
35
+ /**
36
+ * Extra categories listed below the app categories in the rail, showing a
37
+ * fixed set of links instead of apps. See `createDeveloperCategories`.
38
+ */
39
+ categories?: AppMenuCategory[];
40
+ /** Data object over `aviw_General_SidebarUserInfo`. Enables the user menu in the header. */
41
+ userDataObject?: DataObject<AppMenuUser>;
42
+ /** Overrides the default user menu entries. */
43
+ userMenuItems?: AppMenuLink[];
44
+ /**
45
+ * Called when the favorite toggle next to an app is activated. Without this
46
+ * handler no favorite toggles are rendered.
47
+ *
48
+ * `id` is the version-less ArticleId. The menu updates its own state
49
+ * optimistically and rolls back if the promise rejects.
50
+ */
51
+ onToggleFavorite?: (id: string, favorite: boolean) => void | Promise<unknown>;
52
+ /**
53
+ * Link shown at the start of the content header, e.g. the portal/front page,
54
+ * which isn't part of the app list. Omit it when already on that page.
55
+ */
56
+ homeLink?: AppMenuLink;
57
+ /** Shown below the user's name. Defaults to `af.userSession.domain`. */
58
+ userSubtitle?: string;
59
+ /**
60
+ * Shows a highlighted "install update" button in the menu header. Pair with
61
+ * `useServiceWorkerUpdate()`.
62
+ */
63
+ hasUpdate?: boolean;
64
+ /** Called when the install update button is pressed. */
65
+ onInstallUpdate?: () => void;
66
+ id?: string;
67
+ className?: string;
68
+ };
69
+
70
+ /**
71
+ * Two pane application menu. The left rail holds a local search field and the
72
+ * list of app categories (`MenuGroup`); the right pane lists the apps in the
73
+ * selected category, or every app when no category is selected.
74
+ *
75
+ * On narrow viewports only one pane is visible at a time, defaulting to the app
76
+ * list, with a button to switch to the category list.
77
+ */
78
+ export function AppMenu({
79
+ dataObject,
80
+ open,
81
+ onClose,
82
+ categories = [],
83
+ userDataObject,
84
+ userMenuItems,
85
+ userSubtitle,
86
+ onToggleFavorite,
87
+ homeLink,
88
+ hasUpdate = false,
89
+ onInstallUpdate,
90
+ id,
91
+ className,
92
+ }: AppMenuProps) {
93
+ let dialogRef = useRef<HTMLDialogElement>(null);
94
+ let searchRef = useRef<HTMLInputElement>(null);
95
+ let [search, setSearch] = useState("");
96
+ let [selection, setSelection] = useState<Selection>(null);
97
+ let [mobilePane, setMobilePane] = useState<"apps" | "groups">("apps");
98
+ let [hasLoaded, setHasLoaded] = useState(false);
99
+ /*
100
+ * True once the initial category has been decided, either by the menu picking
101
+ * the favorites when the apps arrive, or by the user picking one themselves.
102
+ * Without it the menu would jump to the favorites group the moment the first
103
+ * favorite is added.
104
+ */
105
+ let [hasResolvedSelection, setHasResolvedSelection] = useState(false);
106
+
107
+ let isLoading = useLoading(dataObject);
108
+ let articles = useData<AppMenuArticle>(dataObject);
109
+ let { applyOverrides, toggleFavorite } = useFavorites(onToggleFavorite);
110
+
111
+ // Sync the native dialog with the `open` prop. Using showModal() puts the
112
+ // dialog in the top layer so it renders above the toolbar and page content.
113
+ useEffect(() => {
114
+ let dialog = dialogRef.current;
115
+ if (!dialog) return;
116
+
117
+ if (open && !dialog.open) {
118
+ dialog.showModal();
119
+ requestAnimationFrame(() => searchRef.current?.focus());
120
+ } else if (!open && dialog.open) {
121
+ dialog.close();
122
+ }
123
+ }, [open]);
124
+
125
+ // Reset transient state whenever the menu is closed.
126
+ useEffect(() => {
127
+ if (!open) {
128
+ setSearch("");
129
+ setSelection(null);
130
+ setMobilePane("apps");
131
+ setHasResolvedSelection(false);
132
+ }
133
+ }, [open]);
134
+
135
+ // Load the app list the first time the menu is opened.
136
+ useEffect(() => {
137
+ if (open && !hasLoaded) {
138
+ setHasLoaded(true);
139
+ dataObject.refreshDataSource();
140
+ userDataObject?.refreshDataSource();
141
+ }
142
+ }, [open, hasLoaded, dataObject, userDataObject]);
143
+
144
+ let entries = useMemo(() => applyOverrides(toAppEntries(articles)), [articles, applyOverrides]);
145
+ let term = search.trim().toLowerCase();
146
+
147
+ let searchMatches = useMemo(() => {
148
+ if (!term) return entries;
149
+ return entries.filter((entry) => entry.title.toLowerCase().includes(term) || entry.id.toLowerCase().includes(term));
150
+ }, [entries, term]);
151
+
152
+ let groups = useMemo(() => groupEntries(searchMatches), [searchMatches]);
153
+ let visibleCategories = useMemo(
154
+ () => categories.map((category) => filterCategory(category, term)).filter((category) => countItems(category) > 0),
155
+ [categories, term],
156
+ );
157
+
158
+ let hasFavorites = groups.length > 0 && groups[0][0] === FAVORITES;
159
+
160
+ /*
161
+ * The favorites are the most likely target, so select them by default. The
162
+ * article list loads asynchronously, so this can't be done when opening the
163
+ * menu — it has to wait until the apps have arrived. It only ever runs once
164
+ * per open, so favoriting an app doesn't move the user to another group.
165
+ */
166
+ useEffect(() => {
167
+ if (!open || hasResolvedSelection || entries.length === 0) return;
168
+
169
+ setHasResolvedSelection(true);
170
+ if (hasFavorites) setSelection({ type: "group", key: FAVORITES });
171
+ }, [open, hasResolvedSelection, entries.length, hasFavorites]);
172
+
173
+ // A selection that no longer has matches falls back to "all apps" so the pane
174
+ // never ends up empty while results exist elsewhere.
175
+ let activeSelection: Selection = null;
176
+ if (selection?.type === "group" && groups.some(([group]) => group === selection.key)) activeSelection = selection;
177
+ else if (selection?.type === "category" && visibleCategories.some((category) => category.id === selection.id)) {
178
+ activeSelection = selection;
179
+ }
180
+
181
+ let activeCategoryId = activeSelection?.type === "category" ? activeSelection.id : null;
182
+ let activeCategory = visibleCategories.find((category) => category.id === activeCategoryId);
183
+ let activeGroupKey = activeSelection?.type === "group" ? activeSelection.key : null;
184
+
185
+ // Everything the right hand pane renders, normalized to titled link groups.
186
+ // The favorites are left out of the "all apps" pane, since those apps are
187
+ // already listed in their own group.
188
+ let paneGroups: AppMenuLinkGroup[] = useMemo(() => {
189
+ if (activeCategory) return activeCategory.groups;
190
+
191
+ return groups
192
+ .filter(([group]) => (activeGroupKey === null ? group !== FAVORITES : group === activeGroupKey))
193
+ .map(([group, items]) => ({
194
+ title: groupLabel(group),
195
+ items: items.map((entry) => ({
196
+ id: entry.id,
197
+ label: entry.title,
198
+ href: entry.href,
199
+ isFavorite: entry.isFavorite,
200
+ })),
201
+ }));
202
+ }, [activeCategory, activeGroupKey, groups]);
203
+
204
+ let paneItemCount = paneGroups.reduce((total, group) => total + group.items.length, 0);
205
+ let hasApps = searchMatches.length > 0;
206
+ let railGroups = groups.map(([key, items]) => ({ key, count: items.length }));
207
+
208
+ function select(next: Selection) {
209
+ setSelection(next);
210
+ setHasResolvedSelection(true);
211
+ setMobilePane("apps");
212
+ }
213
+
214
+ return (
215
+ <dialog
216
+ ref={dialogRef}
217
+ id={id}
218
+ className={clsx("ob-app-menu", className)}
219
+ aria-label={getLocalizedString("Applications")}
220
+ data-pane={mobilePane}
221
+ onCancel={(event) => {
222
+ // Let React own the open state instead of the browser's default close.
223
+ event.preventDefault();
224
+ onClose();
225
+ }}
226
+ onKeyDown={(event) => {
227
+ // A `type="search"` input consumes Escape to clear itself, so the
228
+ // dialog's own cancel event never fires when the search has focus.
229
+ if (event.key === "Escape") {
230
+ event.preventDefault();
231
+ onClose();
232
+ }
233
+ }}
234
+ onClick={(event) => {
235
+ // Clicks on the dialog element itself are backdrop clicks; anything
236
+ // inside the menu is caught by the inner wrapper below.
237
+ if (event.target === dialogRef.current) onClose();
238
+ }}
239
+ >
240
+ <div className="ob-app-menu__panel">
241
+ <AppMenuRail
242
+ searchRef={searchRef}
243
+ search={search}
244
+ onSearchChange={setSearch}
245
+ groups={railGroups}
246
+ appCount={searchMatches.length}
247
+ categories={visibleCategories}
248
+ selection={activeSelection}
249
+ onSelect={select}
250
+ />
251
+
252
+ <div className="ob-app-menu__content">
253
+ {isLoading && !hasApps && !activeCategory && (
254
+ <p className="ob-app-menu__message">{getLocalizedString("Loading...")}</p>
255
+ )}
256
+
257
+ {!isLoading && paneItemCount === 0 && (
258
+ <p className="ob-app-menu__message">{getLocalizedString("No applications found")}</p>
259
+ )}
260
+
261
+ {paneItemCount > 0 && (
262
+ <AppMenuList
263
+ groups={paneGroups}
264
+ itemCount={paneItemCount}
265
+ onClose={onClose}
266
+ onToggleFavorite={toggleFavorite}
267
+ />
268
+ )}
269
+
270
+ <AppMenuHeader
271
+ homeLink={homeLink}
272
+ mobilePane={mobilePane}
273
+ onToggleMobilePane={() => setMobilePane(mobilePane === "apps" ? "groups" : "apps")}
274
+ hasUpdate={hasUpdate}
275
+ onInstallUpdate={onInstallUpdate}
276
+ userDataObject={userDataObject}
277
+ userMenuItems={userMenuItems}
278
+ userSubtitle={userSubtitle}
279
+ onClose={onClose}
280
+ />
281
+ </div>
282
+ </div>
283
+ </dialog>
284
+ );
285
+ }
@@ -0,0 +1,41 @@
1
+ import { ToggleGroup, Tooltip } from "@digdir/designsystemet-react";
2
+ import { MonitorIcon, MoonIcon, SunIcon } from "@navikt/aksel-icons";
3
+ import { getLocalizedString } from "@olenbetong/appframe-core";
4
+
5
+ import { type ColorSchemePreference, useColorSchemePreference } from "../../colorScheme.js";
6
+
7
+ const OPTIONS: Array<{ value: ColorSchemePreference; label: string; Icon: typeof MonitorIcon }> = [
8
+ { value: "auto", label: "Follow system setting", Icon: MonitorIcon },
9
+ { value: "light", label: "Light mode", Icon: SunIcon },
10
+ { value: "dark", label: "Dark mode", Icon: MoonIcon },
11
+ ];
12
+
13
+ /** Icon-only color scheme toggle, shown at the bottom of the app menu rail. */
14
+ export function AppMenuColorScheme() {
15
+ let [preference, setPreference] = useColorSchemePreference();
16
+
17
+ return (
18
+ <div className="ob-app-menu__color-scheme">
19
+ <ToggleGroup
20
+ data-size="sm"
21
+ aria-label={getLocalizedString("Theme")}
22
+ value={preference}
23
+ onChange={(value) => setPreference(value as ColorSchemePreference)}
24
+ >
25
+ {OPTIONS.map(({ value, label, Icon }) => {
26
+ let localizedLabel = getLocalizedString(label);
27
+
28
+ return (
29
+ <Tooltip key={value} content={localizedLabel}>
30
+ <ToggleGroup.Item value={value}>
31
+ <Icon aria-hidden fontSize="1.25rem" />
32
+ {/* The radio takes its accessible name from the label's text content. */}
33
+ <span className="ob-app-menu__color-scheme-label">{localizedLabel}</span>
34
+ </ToggleGroup.Item>
35
+ </Tooltip>
36
+ );
37
+ })}
38
+ </ToggleGroup>
39
+ </div>
40
+ );
41
+ }
@@ -0,0 +1,47 @@
1
+ import { getLocalizedString } from "@olenbetong/appframe-core";
2
+
3
+ import { StarIcon } from "./icons.js";
4
+
5
+ export type AppMenuFavoriteButtonProps = {
6
+ /** Label of the app the toggle belongs to, used for the accessible name. */
7
+ appLabel: string;
8
+ isFavorite: boolean;
9
+ onToggle: () => void;
10
+ /**
11
+ * Shares the tab stop of the app link it belongs to, so Tab reaches it
12
+ * without adding a stop per app to the arrow key navigation. See
13
+ * `useRovingTabIndex().getSecondaryProps`.
14
+ */
15
+ tabIndex: number;
16
+ onFocus: () => void;
17
+ };
18
+
19
+ /**
20
+ * Star toggle rendered next to an app link. It is only visible while the entry
21
+ * is hovered or focused, unless the app already is a favorite.
22
+ */
23
+ export function AppMenuFavoriteButton({
24
+ appLabel,
25
+ isFavorite,
26
+ onToggle,
27
+ tabIndex,
28
+ onFocus,
29
+ }: AppMenuFavoriteButtonProps) {
30
+ let label = isFavorite ? getLocalizedString("Remove from favorites") : getLocalizedString("Add to favorites");
31
+
32
+ return (
33
+ <button
34
+ type="button"
35
+ className="ob-app-menu__favorite"
36
+ aria-pressed={isFavorite}
37
+ aria-label={`${label}: ${appLabel}`}
38
+ title={label}
39
+ data-favorite={isFavorite ? "true" : undefined}
40
+ tabIndex={tabIndex}
41
+ onFocus={onFocus}
42
+ onClick={onToggle}
43
+ >
44
+ <StarIcon filled={isFavorite} />
45
+ </button>
46
+ );
47
+ }
@@ -0,0 +1,79 @@
1
+ import { getLocalizedString } from "@olenbetong/appframe-core";
2
+ import type { DataObject } from "@olenbetong/appframe-data";
3
+
4
+ import { AppMenuUserMenu, type AppMenuUser } from "./AppMenuUserMenu.js";
5
+ import { CloseIcon, HomeIcon, ReloadIcon } from "./icons.js";
6
+ import type { AppMenuLink } from "./types.js";
7
+
8
+ export type AppMenuHeaderProps = {
9
+ /** Link shown at the start of the header, e.g. the portal/front page. */
10
+ homeLink?: AppMenuLink;
11
+ /** Which pane is shown on narrow viewports. */
12
+ mobilePane: "apps" | "groups";
13
+ onToggleMobilePane: () => void;
14
+ hasUpdate: boolean;
15
+ onInstallUpdate?: () => void;
16
+ userDataObject?: DataObject<AppMenuUser>;
17
+ userMenuItems?: AppMenuLink[];
18
+ userSubtitle?: string;
19
+ onClose: () => void;
20
+ };
21
+
22
+ /**
23
+ * Header of the app menu's content pane, holding the navigation shortcuts on
24
+ * the start side and the user/update/close controls on the end side.
25
+ *
26
+ * It is rendered after the app list so it comes last in the tab order, and is
27
+ * moved back to the top visually with `order: -1`.
28
+ */
29
+ export function AppMenuHeader({
30
+ homeLink,
31
+ mobilePane,
32
+ onToggleMobilePane,
33
+ hasUpdate,
34
+ onInstallUpdate,
35
+ userDataObject,
36
+ userMenuItems,
37
+ userSubtitle,
38
+ onClose,
39
+ }: AppMenuHeaderProps) {
40
+ return (
41
+ <div className="ob-app-menu__content-header">
42
+ <div className="ob-app-menu__header-start">
43
+ {homeLink && (
44
+ <a
45
+ className="ob-app-menu__home"
46
+ href={homeLink.href}
47
+ target={homeLink.target}
48
+ rel={homeLink.rel}
49
+ onClick={() => {
50
+ homeLink.onClick?.();
51
+ if (!homeLink.keepOpen) onClose();
52
+ }}
53
+ >
54
+ <HomeIcon />
55
+ <span className="ob-app-menu__home-label">{homeLink.label}</span>
56
+ </a>
57
+ )}
58
+ <button type="button" className="ob-app-menu__pane-toggle" onClick={onToggleMobilePane}>
59
+ {mobilePane === "apps" ? getLocalizedString("Categories") : getLocalizedString("Applications")}
60
+ </button>
61
+ </div>
62
+ {hasUpdate && (
63
+ <button
64
+ type="button"
65
+ className="ob-app-menu__update"
66
+ aria-label={getLocalizedString("Install update and reload")}
67
+ onClick={onInstallUpdate}
68
+ >
69
+ <ReloadIcon />
70
+ <span className="ob-app-menu__update-label">{getLocalizedString("Install update and reload")}</span>
71
+ </button>
72
+ )}
73
+ {userDataObject && <AppMenuUserMenu dataObject={userDataObject} items={userMenuItems} subtitle={userSubtitle} />}
74
+ <button type="button" className="ob-app-menu__close" aria-label={getLocalizedString("Close")} onClick={onClose}>
75
+ <CloseIcon />
76
+ </button>
77
+ </div>
78
+ );
79
+ }
@@ -0,0 +1,89 @@
1
+ import { AppMenuFavoriteButton } from "./AppMenuFavoriteButton.js";
2
+ import type { AppMenuLink, AppMenuLinkGroup } from "./types.js";
3
+ import { useRovingTabIndex } from "./useRovingTabIndex.js";
4
+
5
+ export type AppMenuListProps = {
6
+ groups: AppMenuLinkGroup[];
7
+ /** Total number of links across all groups; the roving tab index size. */
8
+ itemCount: number;
9
+ /** Called when an entry that doesn't opt out with `keepOpen` is activated. */
10
+ onClose: () => void;
11
+ /** Without a handler no favorite toggles are rendered. */
12
+ onToggleFavorite?: (id: string, favorite: boolean) => void;
13
+ };
14
+
15
+ /**
16
+ * The app menu's right hand pane: the selected category's links, laid out as
17
+ * titled groups of wrapping columns.
18
+ *
19
+ * The whole list is a single tab stop; the arrow keys move focus between the
20
+ * links, following the visual grid.
21
+ */
22
+ export function AppMenuList({ groups, itemCount, onClose, onToggleFavorite }: AppMenuListProps) {
23
+ let roving = useRovingTabIndex(itemCount, { columns: true });
24
+
25
+ // Links are numbered across all groups, since they share one roving index.
26
+ let itemIndex = -1;
27
+
28
+ function renderItem(item: AppMenuLink, index: number) {
29
+ let props = {
30
+ className: "ob-app-menu__link",
31
+ ...item.attributes,
32
+ ...roving.getItemProps(index),
33
+ };
34
+
35
+ function activate() {
36
+ item.onClick?.();
37
+ if (!item.keepOpen) onClose();
38
+ }
39
+
40
+ let link = item.href ? (
41
+ <a {...props} href={item.href} target={item.target} rel={item.rel} onClick={activate}>
42
+ {item.label}
43
+ </a>
44
+ ) : (
45
+ <button {...props} type="button" onClick={activate}>
46
+ {item.label}
47
+ </button>
48
+ );
49
+
50
+ // Only app entries carry an id and a favorite state; the fixed category
51
+ // links (e.g. the developer tools) can't be favorited.
52
+ if (!onToggleFavorite || item.id === undefined || typeof item.isFavorite !== "boolean") return link;
53
+
54
+ let id = item.id;
55
+ let isFavorite = item.isFavorite;
56
+
57
+ return (
58
+ <>
59
+ {link}
60
+ <AppMenuFavoriteButton
61
+ appLabel={item.label}
62
+ isFavorite={isFavorite}
63
+ onToggle={() => onToggleFavorite(id, !isFavorite)}
64
+ {...roving.getSecondaryProps(index)}
65
+ />
66
+ </>
67
+ );
68
+ }
69
+
70
+ return (
71
+ <div className="ob-app-menu__columns" onKeyDown={roving.onKeyDown}>
72
+ {groups.map((group, groupIdx) => (
73
+ <section key={group.title ?? groupIdx} className="ob-app-menu__group">
74
+ {group.title && <h2 className="ob-app-menu__group-title">{group.title}</h2>}
75
+ <ul className="ob-app-menu__list">
76
+ {group.items.map((item) => {
77
+ itemIndex += 1;
78
+ return (
79
+ <li key={item.href ?? item.label} className="ob-app-menu__item">
80
+ {renderItem(item, itemIndex)}
81
+ </li>
82
+ );
83
+ })}
84
+ </ul>
85
+ </section>
86
+ ))}
87
+ </div>
88
+ );
89
+ }
@@ -0,0 +1,117 @@
1
+ import { getLocalizedString } from "@olenbetong/appframe-core";
2
+ import { Fragment, type RefObject } from "react";
3
+
4
+ import { AppMenuColorScheme } from "./AppMenuColorScheme.js";
5
+ import { countItems, groupLabel, type Selection, toRailSections } from "./menuEntries.js";
6
+ import type { AppMenuCategory } from "./types.js";
7
+ import { useRovingTabIndex } from "./useRovingTabIndex.js";
8
+
9
+ export type AppMenuRailProps = {
10
+ searchRef: RefObject<HTMLInputElement | null>;
11
+ search: string;
12
+ onSearchChange: (value: string) => void;
13
+ /** App groups, in the order they are listed. */
14
+ groups: { key: string; count: number }[];
15
+ /** Number of apps matching the search, shown next to "All applications". */
16
+ appCount: number;
17
+ /** Extra link categories, listed after the app groups. */
18
+ categories: AppMenuCategory[];
19
+ selection: Selection;
20
+ onSelect: (selection: Selection) => void;
21
+ };
22
+
23
+ /**
24
+ * The app menu's left rail: the local search field, the app groups and any
25
+ * extra link categories.
26
+ *
27
+ * The rail is a single tab stop; the arrow keys move focus between the buttons.
28
+ */
29
+ export function AppMenuRail({
30
+ searchRef,
31
+ search,
32
+ onSearchChange,
33
+ groups,
34
+ appCount,
35
+ categories,
36
+ selection,
37
+ onSelect,
38
+ }: AppMenuRailProps) {
39
+ // "All applications", then the app groups, then the categories.
40
+ let roving = useRovingTabIndex(groups.length + 1 + categories.length);
41
+ let railSections = toRailSections(categories);
42
+ let categoryIndex = groups.length;
43
+
44
+ function isSelected(next: NonNullable<Selection>) {
45
+ if (selection === null) return false;
46
+ if (next.type === "group") return selection.type === "group" && selection.key === next.key;
47
+ return selection.type === "category" && selection.id === next.id;
48
+ }
49
+
50
+ return (
51
+ <div className="ob-app-menu__rail">
52
+ <div className="ds-search ob-app-menu__search" data-size="sm">
53
+ <input
54
+ ref={searchRef}
55
+ className="ds-input"
56
+ type="search"
57
+ value={search}
58
+ onChange={(event) => onSearchChange(event.target.value)}
59
+ placeholder={getLocalizedString("Search applications")}
60
+ aria-label={getLocalizedString("Search applications")}
61
+ autoComplete="off"
62
+ />
63
+ </div>
64
+
65
+ <nav className="ob-app-menu__groups" aria-label={getLocalizedString("Categories")} onKeyDown={roving.onKeyDown}>
66
+ <button
67
+ type="button"
68
+ className="ob-app-menu__group-button"
69
+ aria-current={selection === null ? "true" : undefined}
70
+ onClick={() => onSelect(null)}
71
+ {...roving.getItemProps(0)}
72
+ >
73
+ <span>{getLocalizedString("All applications")}</span>
74
+ <span className="ob-app-menu__count">{appCount}</span>
75
+ </button>
76
+ {groups.map(({ key, count }, index) => (
77
+ <button
78
+ key={key}
79
+ type="button"
80
+ className="ob-app-menu__group-button"
81
+ aria-current={isSelected({ type: "group", key }) ? "true" : undefined}
82
+ onClick={() => onSelect({ type: "group", key })}
83
+ {...roving.getItemProps(index + 1)}
84
+ >
85
+ <span>{groupLabel(key)}</span>
86
+ <span className="ob-app-menu__count">{count}</span>
87
+ </button>
88
+ ))}
89
+
90
+ {railSections.map(([section, sectionCategories]) => (
91
+ <Fragment key={section || "\u0000default"}>
92
+ {section && <h2 className="ob-app-menu__rail-heading">{section}</h2>}
93
+ {sectionCategories.map((category) => {
94
+ categoryIndex += 1;
95
+ let railIndex = categoryIndex;
96
+ return (
97
+ <button
98
+ key={category.id}
99
+ type="button"
100
+ className="ob-app-menu__group-button"
101
+ aria-current={isSelected({ type: "category", id: category.id }) ? "true" : undefined}
102
+ onClick={() => onSelect({ type: "category", id: category.id })}
103
+ {...roving.getItemProps(railIndex)}
104
+ >
105
+ <span>{category.label}</span>
106
+ <span className="ob-app-menu__count">{countItems(category)}</span>
107
+ </button>
108
+ );
109
+ })}
110
+ </Fragment>
111
+ ))}
112
+ </nav>
113
+
114
+ <AppMenuColorScheme />
115
+ </div>
116
+ );
117
+ }