@marinoscar/platform-web 0.1.0-next.3 → 0.1.0-next.5

package/dist/shell/headless/theme.js

@@ -0,0 +1,235 @@
+// =============================================================================
+// The shell's theme (issue #868; moved from the reference app's `theme/` and
+// `contexts/ThemeContext.tsx`)
+// =============================================================================
+//
+// Two MUI themes (light and dark) built from one base (Inter, 600-weight
+// headings, 8px radius, no-uppercase buttons, flat AppBar with a hairline),
+// plus the context the AppBar's toggle and the Appearance page read. The app
+// keeps its brand: `palette.primary.main` comes from its identity, and
+// `extend` lets it add token contracts (the telemetry slice's
+// `withTelemetryTokens`) without the shell depending on them.
+// =============================================================================
+import { THEME_PREFERENCE_ID_PATTERN } from '@marinoscar/platform-contract/settings';
+import { createContext, useContext } from 'react';
+import { createTheme } from '@mui/material/styles';
+/**
+ * The three modes the shell always has: `light`, `dark` and `system`. A theme
+ * registered under one of these ids is refused.
+ *
+ * @stability experimental
+ */
+export const BUILTIN_SHELL_THEME_MODES = ['light', 'dark', 'system'];
+/**
+ * Whether `mode` is one of {@link BUILTIN_SHELL_THEME_MODES}.
+ *
+ * @param mode - a mode id.
+ * @returns whether it is built in.
+ *
+ * @stability experimental
+ */
+export function isBuiltinThemeMode(mode) {
+    return BUILTIN_SHELL_THEME_MODES.includes(mode);
+}
+const themeModes = new Map();
+/**
+ * Add a theme mode to the shell: after this, `setMode(id)` of the theme context
+ * chooses it, the stored choice is restored on the next visit, and
+ * `ShellThemeProvider` resolves it to `theme`. Register at module scope, before
+ * the first render, next to the app's own themes.
+ *
+ * To let a user pick it on the Appearance page, register the same id on the API
+ * with `registerThemePreference` (`@marinoscar/platform-api/settings`): the
+ * settings document then lists it in `themeOptions`, and the packaged settings
+ * hook hands a stored value to the host's `applyTheme` (the app's `setMode`).
+ *
+ * @param definition - the id, label and theme.
+ * @throws Error when the id is malformed, built in or already registered, the label is empty or the theme is missing.
+ *
+ * @example
+ * ```ts
+ * registerThemeMode({ id: 'high-contrast', label: 'High contrast', theme: highContrastTheme });
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export function registerThemeMode(definition) {
+    const { id, label, theme } = definition;
+    if (typeof id !== 'string' || !THEME_PREFERENCE_ID_PATTERN.test(id)) {
+        throw new Error(`registerThemeMode: "${String(id)}" is not a valid theme id (lower-case, starts with a letter, 2 to 48 characters of a-z, 0-9 and -)`);
+    }
+    if (isBuiltinThemeMode(id))
+        throw new Error(`registerThemeMode: "${id}" is a built-in mode`);
+    if (themeModes.has(id))
+        throw new Error(`registerThemeMode: a theme mode "${id}" is already registered`);
+    if (typeof label !== 'string' || label.trim() === '')
+        throw new Error(`registerThemeMode: the theme mode "${id}" needs a label`);
+    if (!theme || typeof theme !== 'object' || !theme.palette)
+        throw new Error(`registerThemeMode: the theme mode "${id}" needs a MUI theme`);
+    themeModes.set(id, { id, label: label.trim(), theme });
+}
+/**
+ * The theme modes registered with {@link registerThemeMode}, in registration order.
+ *
+ * @returns a fresh array.
+ *
+ * @stability experimental
+ */
+export function listThemeModes() {
+    return [...themeModes.values()];
+}
+/**
+ * Forget every registered theme mode. For tests only.
+ *
+ * @internal
+ */
+export function resetThemeModesForTests() {
+    themeModes.clear();
+}
+const LIGHT_PALETTE = {
+    primary: { main: '#1976d2', light: '#42a5f5', dark: '#1565c0' },
+    secondary: { main: '#9c27b0', light: '#ba68c8', dark: '#7b1fa2' },
+    background: { default: '#f5f5f5', paper: '#ffffff' },
+    text: { primary: 'rgba(0, 0, 0, 0.87)', secondary: 'rgba(0, 0, 0, 0.6)' },
+};
+const DARK_PALETTE = {
+    primary: { main: '#90caf9', light: '#e3f2fd', dark: '#42a5f5' },
+    secondary: { main: '#ce93d8', light: '#f3e5f5', dark: '#ab47bc' },
+    background: { default: '#121212', paper: '#1e1e1e' },
+    text: { primary: '#ffffff', secondary: 'rgba(255, 255, 255, 0.7)' },
+};
+const BASE_THEME = {
+    typography: {
+        fontFamily: '"Inter", "Roboto", "Helvetica", "Arial", sans-serif',
+        h1: { fontWeight: 600 },
+        h2: { fontWeight: 600 },
+        h3: { fontWeight: 600 },
+        h4: { fontWeight: 600 },
+        h5: { fontWeight: 600 },
+        h6: { fontWeight: 600 },
+    },
+    shape: {
+        borderRadius: 8,
+    },
+};
+const MERGED_GROUPS = ['primary', 'secondary', 'background', 'text'];
+/**
+ * The shell's palette for `mode`, with `overrides` merged one level deep into
+ * `primary`, `secondary`, `background` and `text` (so `{ primary: { main } }`
+ * keeps the hand-picked `light` and `dark` tints) and shallowly elsewhere.
+ *
+ * @param mode - `light` or `dark`.
+ * @param overrides - the app's palette changes (its brand colour).
+ * @returns the palette options.
+ *
+ * @stability experimental
+ */
+export function shellPalette(mode, overrides = {}) {
+    const base = mode === 'light' ? LIGHT_PALETTE : DARK_PALETTE;
+    const merged = { ...base, ...overrides };
+    for (const group of MERGED_GROUPS) {
+        const override = overrides[group];
+        if (override !== undefined && typeof override === 'object') {
+            merged[group] = { ...base[group], ...override };
+        }
+    }
+    return merged;
+}
+/**
+ * The shell's component overrides for `mode`: no-uppercase 500-weight
+ * buttons, a soft card shadow, and a flat AppBar with a 1px bottom border.
+ *
+ * @param mode - `light` or `dark`.
+ * @returns the MUI component overrides.
+ *
+ * @stability experimental
+ */
+export function shellComponentOverrides(mode) {
+    return {
+        MuiButton: {
+            styleOverrides: {
+                root: {
+                    textTransform: 'none',
+                    fontWeight: 500,
+                },
+            },
+        },
+        MuiCard: {
+            styleOverrides: {
+                root: {
+                    boxShadow: mode === 'light' ? '0 2px 8px rgba(0, 0, 0, 0.1)' : '0 2px 8px rgba(0, 0, 0, 0.3)',
+                },
+            },
+        },
+        MuiAppBar: {
+            styleOverrides: {
+                root: {
+                    boxShadow: 'none',
+                    borderBottom: `1px solid ${mode === 'light' ? '#e0e0e0' : '#333333'}`,
+                },
+            },
+        },
+    };
+}
+/**
+ * Build the shell's MUI theme for `mode`.
+ *
+ * @param mode - `light` or `dark`.
+ * @param options - the app's palette changes and a final `extend` step.
+ * @returns the theme.
+ *
+ * @example
+ * ```ts
+ * export const lightTheme = createShellTheme('light', { palette: { primary: { main: THEME_COLOR } }, extend: withTelemetryTokens });
+ * export const darkTheme = createShellTheme('dark', { extend: withTelemetryTokens });
+ * ```
+ *
+ * @extensionPoint theme-token
+ * @stability experimental
+ */
+export function createShellTheme(mode, options = {}) {
+    const theme = createTheme({
+        ...BASE_THEME,
+        palette: {
+            mode,
+            ...shellPalette(mode, options.palette),
+        },
+        components: shellComponentOverrides(mode),
+    });
+    return options.extend ? options.extend(theme) : theme;
+}
+/**
+ * The context `ShellThemeProvider` (`@marinoscar/platform-web/shell/ui`) fills.
+ *
+ * @stability experimental
+ */
+export const ShellThemeContext = createContext(null);
+ShellThemeContext.displayName = 'ShellThemeContext';
+/**
+ * The shell's theme context, or `null` outside a `ShellThemeProvider` (the
+ * AppBar then draws no theme toggle).
+ *
+ * @returns the context value, or `null`.
+ *
+ * @stability experimental
+ */
+export function useOptionalShellTheme() {
+    return useContext(ShellThemeContext);
+}
+/**
+ * The shell's theme context: the mode, the resolved theme and the setters.
+ *
+ * @returns the context value.
+ * @throws Error outside a `ShellThemeProvider`.
+ *
+ * @stability experimental
+ */
+export function useShellTheme() {
+    const context = useContext(ShellThemeContext);
+    if (!context) {
+        throw new Error('useShellTheme must be used within a ShellThemeProvider (@marinoscar/platform-web/shell/ui).');
+    }
+    return context;
+}
+//# sourceMappingURL=theme.js.map

package/dist/shell/headless/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../../src/shell/headless/theme.ts"],"names":[],"mappings":"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"}

package/dist/shell/internal/use-is-mounted.d.ts

@@ -0,0 +1,3 @@
+/** `() => boolean`: whether the component is still mounted (guards setState after an await). */
+export declare function useIsMounted(): () => boolean;
+//# sourceMappingURL=use-is-mounted.d.ts.map

package/dist/shell/internal/use-is-mounted.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-is-mounted.d.ts","sourceRoot":"","sources":["../../../src/shell/internal/use-is-mounted.ts"],"names":[],"mappings":"AAEA,gGAAgG;AAChG,wBAAgB,YAAY,IAAI,MAAM,OAAO,CAS5C"}

package/dist/shell/internal/use-is-mounted.js

@@ -0,0 +1,13 @@
+import { useCallback, useEffect, useRef } from 'react';
+/** `() => boolean`: whether the component is still mounted (guards setState after an await). */
+export function useIsMounted() {
+    const mounted = useRef(false);
+    useEffect(() => {
+        mounted.current = true;
+        return () => {
+            mounted.current = false;
+        };
+    }, []);
+    return useCallback(() => mounted.current, []);
+}
+//# sourceMappingURL=use-is-mounted.js.map

package/dist/shell/internal/use-is-mounted.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-is-mounted.js","sourceRoot":"","sources":["../../../src/shell/internal/use-is-mounted.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEvD,gGAAgG;AAChG,MAAM,UAAU,YAAY;IAC1B,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;QACvB,OAAO,GAAG,EAAE;YACV,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC;QAC1B,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,OAAO,WAAW,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAChD,CAAC"}

package/dist/shell/ui/ShellAppBar.d.ts

@@ -0,0 +1,58 @@
+import type { ReactElement, ReactNode } from 'react';
+import type { SettingsFeatures } from '../../settings/index.js';
+import type { ShellNavigation, ShellSettingsSurface } from '../headless/navigation.js';
+interface DrillDown {
+    /** The resolved page title: a card's title, or the surface's hub title. */
+    title: string;
+    /** Where the back button goes. */
+    upPath: string;
+}
+/**
+ * Resolve a pathname to the compact bar's title and its UP destination, or
+ * `null` when the path is on no settings surface.
+ *
+ * UP ONE LEVEL, NEVER `navigate(-1)`: history-relative back diverges the
+ * moment the user arrived any other way (a deep link, a redirect, an OAuth
+ * callback), and then "back" silently means "leave the app". The hub's own
+ * parent is the home path.
+ *
+ * No permission gate (the route guard denies an unpermitted page; naming the
+ * page the user is looking at leaks nothing), but the FEATURE gate applies: a
+ * card whose feature is off does not exist in this deployment.
+ */
+export declare function resolveDrillDown(surfaces: readonly ShellSettingsSurface[], pathname: string, features: SettingsFeatures, homePath?: string): DrillDown | null;
+/**
+ * Props of {@link ShellAppBar}: the navigation and the slots.
+ *
+ * @stability experimental
+ */
+export interface ShellAppBarProps {
+    /** The app's navigation (its settings surfaces drive the drill-down; its destinations the default user menu). */
+    navigation: ShellNavigation;
+    /** The brand: the app's name or a logo. Clicking it goes home. */
+    brand: ReactNode;
+    /**
+     * Actions in BOTH treatments, before the theme toggle (the notification
+     * bell: on a settings screen it is still the only way into the centre).
+     */
+    actions?: ReactNode;
+    /**
+     * Actions outside the drill-down only, after the theme toggle (an
+     * organization switcher). The drill-down is sized for three icon buttons.
+     */
+    wideActions?: ReactNode;
+    /** The user menu. Default `<ShellUserMenu navigation={navigation} />`. */
+    userMenu?: ReactNode;
+}
+/**
+ * The top bar. Gate 5 of the five coupled breakpoint gates.
+ *
+ * @param props - see {@link ShellAppBarProps}.
+ * @returns the bar.
+ *
+ * @extensionPoint slot
+ * @stability experimental
+ */
+export declare function ShellAppBar({ navigation, brand, actions, wideActions, userMenu }: ShellAppBarProps): ReactElement;
+export {};
+//# sourceMappingURL=ShellAppBar.d.ts.map

package/dist/shell/ui/ShellAppBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellAppBar.d.ts","sourceRoot":"","sources":["../../../src/shell/ui/ShellAppBar.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAIvF,UAAU,SAAS;IACjB,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,SAAS,oBAAoB,EAAE,EACzC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,SAAM,GACb,SAAS,GAAG,IAAI,CAQlB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iHAAiH;IACjH,UAAU,EAAE,eAAe,CAAC;IAC5B,kEAAkE;IAClE,KAAK,EAAE,SAAS,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,gBAAgB,GAAG,YAAY,CA6FjH"}

package/dist/shell/ui/ShellAppBar.js

@@ -0,0 +1,81 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+// =============================================================================
+// The top bar (issue #868; moved from the reference app's
+// `components/navigation/AppBar.tsx`, issues #55, #95, #127, #425, #726)
+// =============================================================================
+//
+// Two treatments, chosen by window class AND route. Below `sm` on a settings
+// route the brand is replaced by a back arrow and the resolved page title (the
+// DRILL-DOWN); everywhere else the brand, the actions, the theme toggle and
+// the user menu. The app fills the slots: `brand`, `actions` (both
+// treatments: the notification bell), `wideActions` (dropped in the
+// drill-down: an organization switcher) and `userMenu`.
+// =============================================================================
+import { AppBar as MuiAppBar, Box, IconButton, Toolbar, Typography, useMediaQuery, useTheme } from '@mui/material';
+import { ArrowBack as ArrowBackIcon, Brightness4 as DarkModeIcon, Brightness7 as LightModeIcon } from '@mui/icons-material';
+import { useLocation, useNavigate } from 'react-router-dom';
+import { settingsPageTitle, useSettingsFeatures } from '../../settings/index.js';
+import { useOptionalShellTheme } from '../headless/theme.js';
+import { ShellUserMenu } from './ShellUserMenu.js';
+/**
+ * Resolve a pathname to the compact bar's title and its UP destination, or
+ * `null` when the path is on no settings surface.
+ *
+ * UP ONE LEVEL, NEVER `navigate(-1)`: history-relative back diverges the
+ * moment the user arrived any other way (a deep link, a redirect, an OAuth
+ * callback), and then "back" silently means "leave the app". The hub's own
+ * parent is the home path.
+ *
+ * No permission gate (the route guard denies an unpermitted page; naming the
+ * page the user is looking at leaks nothing), but the FEATURE gate applies: a
+ * card whose feature is off does not exist in this deployment.
+ */
+export function resolveDrillDown(surfaces, pathname, features, homePath = '/') {
+    for (const surface of surfaces) {
+        const title = settingsPageTitle(surface.sections, surface.hubPath, surface.hubTitle, pathname, features);
+        // `null` means "not this surface", a different answer from the hub's own title.
+        if (title === null)
+            continue;
+        return { title, upPath: pathname === surface.hubPath ? homePath : surface.hubPath };
+    }
+    return null;
+}
+/**
+ * The top bar. Gate 5 of the five coupled breakpoint gates.
+ *
+ * @param props - see {@link ShellAppBarProps}.
+ * @returns the bar.
+ *
+ * @extensionPoint slot
+ * @stability experimental
+ */
+export function ShellAppBar({ navigation, brand, actions, wideActions, userMenu }) {
+    const theme = useTheme();
+    const navigate = useNavigate();
+    const { pathname } = useLocation();
+    const shellTheme = useOptionalShellTheme();
+    const homePath = navigation.homePath ?? '/';
+    // 600px: `down('sm')`, byte-identical to `ShellBottomNav`'s and
+    // `SettingsHub`'s gates and the exact complement of `ShellLayout`'s
+    // `showRail` (`up('sm')`).
+    //
+    // ⚠️ FIVE COUPLED GATES: the list and the reasoning live in `ShellLayout`.
+    // This is member (5), bound most tightly to member (4), `SettingsHub`'s
+    // `isCompactWindow`: that hub is the page body directly under this header.
+    // If the two disagree the user gets a back-arrow header above a card grid,
+    // or a brand toolbar above a drill-down list with no way back up. Do not
+    // change this number alone.
+    const isCompactWindow = useMediaQuery(theme.breakpoints.down('sm'));
+    // Resolved at every width: a pure lookup, and hoisting it keeps the two
+    // treatments one render decision.
+    const features = useSettingsFeatures();
+    const drillDown = isCompactWindow ? resolveDrillDown(navigation.settingsSurfaces ?? [], pathname, features, homePath) : null;
+    return (_jsx(MuiAppBar, { position: "sticky", color: "default", elevation: 0, sx: {
+            backgroundColor: theme.palette.background.paper,
+        }, children: _jsxs(Toolbar, { children: [drillDown ? (_jsxs(_Fragment, { children: [_jsx(IconButton, { onClick: () => navigate(drillDown.upPath), color: "inherit", edge: "start", "aria-label": "Back", sx: { mr: 1, flexShrink: 0 }, children: _jsx(ArrowBackIcon, {}) }), _jsx(Typography, { variant: "h6", component: "div", noWrap: true, sx: { fontWeight: 600, minWidth: 0 }, children: drillDown.title })] })) : (_jsx(Typography, { variant: "h6", component: "div", sx: {
+                        cursor: 'pointer',
+                        fontWeight: 600,
+                        flexShrink: 0,
+                    }, onClick: () => navigate(homePath), children: brand })), _jsx(Box, { "aria-hidden": true, sx: { flexGrow: 1, minWidth: 0 } }), actions, !drillDown && shellTheme && (_jsx(IconButton, { onClick: shellTheme.toggleMode, color: "inherit", "aria-label": "toggle theme", sx: { mr: 1, flexShrink: 0 }, children: shellTheme.isDarkMode ? _jsx(LightModeIcon, {}) : _jsx(DarkModeIcon, {}) })), !drillDown && wideActions, _jsx(Box, { sx: { flexShrink: 0 }, children: userMenu ?? _jsx(ShellUserMenu, { navigation: navigation }) })] }) }));
+}
+//# sourceMappingURL=ShellAppBar.js.map

package/dist/shell/ui/ShellAppBar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellAppBar.js","sourceRoot":"","sources":["../../../src/shell/ui/ShellAppBar.tsx"],"names":[],"mappings":"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"}

package/dist/shell/ui/ShellBottomNav.d.ts

@@ -0,0 +1,31 @@
+import type { ReactElement } from 'react';
+import type { ShellNavigation } from '../headless/navigation.js';
+/**
+ * Props of {@link ShellBottomNav}.
+ *
+ * @stability experimental
+ */
+export interface ShellBottomNavProps {
+    /** The app's navigation. */
+    navigation: ShellNavigation;
+    /**
+     * The most actions the bar draws, the "More" action included. When more
+     * destinations are visible than this, the bar draws the first `maxItems - 1`
+     * and a "More" action that opens a sheet with the rest. At least 2.
+     *
+     * @defaultValue 4
+     */
+    maxItems?: number;
+}
+/**
+ * The bottom bar. Gate 2 of the five coupled breakpoint gates: it renders only
+ * below `sm`, even when mounted.
+ *
+ * @param props - see {@link ShellBottomNavProps}.
+ * @returns the bar, or `null` at `sm` and up.
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export declare function ShellBottomNav({ navigation, maxItems }: ShellBottomNavProps): ReactElement | null;
+//# sourceMappingURL=ShellBottomNav.d.ts.map

package/dist/shell/ui/ShellBottomNav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellBottomNav.d.ts","sourceRoot":"","sources":["../../../src/shell/ui/ShellBottomNav.tsx"],"names":[],"mappings":"AAuCA,OAAO,KAAK,EAAc,YAAY,EAAE,MAAM,OAAO,CAAC;AAWtD,OAAO,KAAK,EAAoB,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAenF;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,4BAA4B;IAC5B,UAAU,EAAE,eAAe,CAAC;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAiHD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,EAAE,UAAU,EAAE,QAA4B,EAAE,EAAE,mBAAmB,GAAG,YAAY,GAAG,IAAI,CAwHrH"}

package/dist/shell/ui/ShellBottomNav.js

@@ -0,0 +1,144 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// =============================================================================
+// The phone bottom bar (issue #868; moved from the reference app's
+// `components/navigation/BottomNav.tsx`, issue #55; PP-14.25 added `maxItems`)
+// =============================================================================
+//
+// The ONLY navigation chrome below `sm`: no drawer, no hamburger. FOUR
+// ACTIONS IS THE CEILING: five labelled tabs do not fit at 360px, so a fifth
+// destination forces a choice between labels and the tab. Active state comes
+// from the destination model, never a path prefix.
+//
+// PP-14.25: that ceiling is now the default of `maxItems` (4). With MORE
+// visible destinations than `maxItems`, the bar draws the first `maxItems - 1`
+// and a "More" action that opens a bottom sheet listing the rest, so a fifth
+// destination no longer squeezes the labels. With `maxItems` or fewer the bar
+// is exactly what it always was. The sheet lives inside this component, which
+// renders below `sm` only, so it adds no breakpoint gate.
+// =============================================================================
+import MoreHorizIcon from '@mui/icons-material/MoreHoriz';
+import OpenInNewIcon from '@mui/icons-material/OpenInNew';
+import { Badge, BottomNavigation, BottomNavigationAction, Box, Drawer, List, ListItem, ListItemButton, ListItemIcon, ListItemText, ListSubheader, Paper, Typography, useMediaQuery, useTheme, } from '@mui/material';
+import { Fragment, useCallback, useEffect, useState } from 'react';
+import { Link as RouterLink, useLocation, useNavigate } from 'react-router-dom';
+import { usePermissions } from '../../identity/index.js';
+import { useSettingsFeatures } from '../../settings/index.js';
+import { groupDestinationRuns, isDestinationVisible, resolveActiveDestination, shellDestinationRoutes, } from '../headless/navigation.js';
+import { DestinationIcon, EXTERNAL_LINK_PROPS, destinationAccessibleName, runDestinationClick, useDestinationBadge, } from './destination-parts.js';
+/** The value of the "More" action. Not a destination key (a key cannot contain a space). */
+const MORE_VALUE = 'more destinations';
+/** How many actions the bar draws by default, the "More" action included. */
+const DEFAULT_MAX_ITEMS = 4;
+/**
+ * One tab of the bar. `BottomNavigation` clones each child with `selected`,
+ * `showLabel`, `value` and `onChange`; this forwards what the action needs and
+ * handles the choice itself, so a destination's `onClick` can cancel the
+ * navigation (the action's own `onChange` fires before its `onClick`).
+ */
+function BottomNavItem({ destination, onNavigate, onChange, ...actionProps }) {
+    void onChange;
+    const badge = useDestinationBadge(destination);
+    const external = destination.external === true;
+    return (_jsx(BottomNavigationAction, { ...actionProps, ...(external ? { component: 'a', href: destination.path, ...EXTERNAL_LINK_PROPS } : {}), 
+        // The COMPACT label (a 4-up bar gives each tab ~90px); the full
+        // label is the accessible name.
+        label: destination.compactLabel, "aria-label": destinationAccessibleName(destination.label, badge, external), icon: _jsx(DestinationIcon, { Icon: destination.Icon, badge: badge }), onClick: (event) => {
+            if (runDestinationClick(destination, event))
+                return;
+            if (!external)
+                onNavigate(destination);
+        } }));
+}
+/** The "More" tab. Shows a dot when a destination in the sheet has a badge. */
+function MoreItem({ open, hasBadge, onOpen, onChange, ...actionProps }) {
+    void onChange;
+    return (_jsx(BottomNavigationAction, { ...actionProps, label: "More", "aria-label": hasBadge ? 'More destinations (new activity)' : 'More destinations', "aria-haspopup": "dialog", "aria-expanded": open, icon: hasBadge ? (_jsx(Badge, { variant: "dot", color: "error", "data-testid": "destination-badge", children: _jsx(MoreHorizIcon, {}) })) : (_jsx(MoreHorizIcon, {})), onClick: onOpen }));
+}
+/** Reports whether one overflow destination has a badge, so the "More" tab can show a dot. Renders nothing. */
+function OverflowBadgeProbe({ destination, report, }) {
+    const present = useDestinationBadge(destination) !== null;
+    useEffect(() => {
+        report(destination.key, present);
+        return () => report(destination.key, false);
+    }, [destination.key, present, report]);
+    return null;
+}
+/** One row of the sheet. A component of its own so the destination's `badge` has a stable hook order. */
+function SheetRow({ destination, active, onChoose, }) {
+    const badge = useDestinationBadge(destination);
+    const external = destination.external === true;
+    return (_jsx(ListItem, { disablePadding: true, children: _jsxs(ListItemButton, { ...(external
+                ? { component: 'a', href: destination.path, ...EXTERNAL_LINK_PROPS }
+                : { component: RouterLink, to: destination.path }), selected: active, "aria-current": active ? 'page' : undefined, "aria-label": destinationAccessibleName(destination.label, badge, external), onClick: (event) => onChoose(destination, event), children: [_jsx(ListItemIcon, { sx: { minWidth: 40 }, children: _jsx(DestinationIcon, { Icon: destination.Icon, badge: badge }) }), _jsx(ListItemText, { primary: destination.label }), external && _jsx(OpenInNewIcon, { "aria-hidden": true, fontSize: "small", sx: { color: 'text.secondary' } })] }) }));
+}
+/**
+ * The bottom bar. Gate 2 of the five coupled breakpoint gates: it renders only
+ * below `sm`, even when mounted.
+ *
+ * @param props - see {@link ShellBottomNavProps}.
+ * @returns the bar, or `null` at `sm` and up.
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export function ShellBottomNav({ navigation, maxItems = DEFAULT_MAX_ITEMS }) {
+    const theme = useTheme();
+    // The EXACT complement of `ShellLayout`'s `showRail` (`up('sm')`), and it
+    // must stay that way: any drift opens a band with two navigation surfaces or
+    // none. See the coupled-gate list in `ShellLayout`.
+    const isCompactWindow = useMediaQuery(theme.breakpoints.down('sm'));
+    const navigate = useNavigate();
+    const location = useLocation();
+    const { hasPermission } = usePermissions();
+    // Before the early return, per the rules of hooks.
+    const features = useSettingsFeatures();
+    const [sheetOpen, setSheetOpen] = useState(false);
+    const [badged, setBadged] = useState(new Set());
+    const reportBadge = useCallback((key, present) => {
+        setBadged((previous) => {
+            if (previous.has(key) === present)
+                return previous;
+            const next = new Set(previous);
+            if (present)
+                next.add(key);
+            else
+                next.delete(key);
+            return next;
+        });
+    }, []);
+    if (!isCompactWindow)
+        return null;
+    const visibleDestinations = navigation.destinations.filter((destination) => isDestinationVisible(destination, hasPermission, features));
+    const limit = Number.isFinite(maxItems) ? Math.max(2, Math.floor(maxItems)) : DEFAULT_MAX_ITEMS;
+    const overflows = visibleDestinations.length > limit;
+    const barDestinations = overflows ? visibleDestinations.slice(0, limit - 1) : visibleDestinations;
+    const sheetDestinations = overflows ? visibleDestinations.slice(limit - 1) : [];
+    const resolved = resolveActiveDestination(shellDestinationRoutes(navigation), location.pathname);
+    const activeInBar = resolved !== null && barDestinations.some((d) => d.key === resolved);
+    const activeInSheet = resolved !== null && sheetDestinations.some((d) => d.key === resolved);
+    // `false`, NOT `null`, is MUI's "nothing selected": the correct rendering on
+    // routes no destination owns, and for a destination the viewer cannot see.
+    const active = activeInBar && resolved !== null ? resolved : activeInSheet ? MORE_VALUE : false;
+    const choose = (destination, event) => {
+        setSheetOpen(false);
+        // A router link navigates on its own; the click handler's veto is all that needs care.
+        runDestinationClick(destination, event);
+    };
+    const sheetRuns = groupDestinationRuns(sheetDestinations);
+    const probes = sheetDestinations.filter((destination) => destination.badge);
+    return (_jsxs(Paper, { elevation: 3, sx: {
+            position: 'fixed',
+            bottom: 0,
+            left: 0,
+            right: 0,
+            zIndex: theme.zIndex.appBar,
+        }, children: [probes.map((destination) => (_jsx(OverflowBadgeProbe, { destination: destination, report: reportBadge }, destination.key))), _jsxs(BottomNavigation, { value: active, showLabels: true, children: [barDestinations.map((destination) => (_jsx(BottomNavItem, { value: destination.key, destination: destination, onNavigate: (next) => navigate(next.path) }, destination.key))), overflows && (_jsx(MoreItem, { value: MORE_VALUE, open: sheetOpen, hasBadge: sheetDestinations.some((destination) => badged.has(destination.key)), onOpen: () => setSheetOpen(true) }, MORE_VALUE))] }), overflows && (_jsx(Drawer, { anchor: "bottom", open: sheetOpen, onClose: () => setSheetOpen(false), slotProps: {
+                    paper: {
+                        'aria-label': 'More destinations',
+                        sx: { borderTopLeftRadius: 16, borderTopRightRadius: 16, maxHeight: '70vh', pb: 'env(safe-area-inset-bottom)' },
+                    },
+                }, children: _jsxs(Box, { component: "nav", "aria-label": "More destinations", sx: { py: 1 }, children: [_jsx(Typography, { variant: "subtitle2", component: "h2", sx: { px: 2, py: 1, color: 'text.secondary' }, children: "More" }), sheetRuns.map((run, index) => (_jsx(Fragment, { children: _jsx(List, { disablePadding: true, ...(run.group !== undefined
+                                    ? { subheader: _jsx(ListSubheader, { disableSticky: true, children: run.group }), 'aria-label': run.group }
+                                    : {}), children: run.destinations.map((destination) => (_jsx(SheetRow, { destination: destination, active: resolved === destination.key, onChoose: choose }, destination.key))) }) }, `${index}:${run.group ?? ''}`)))] }) }))] }));
+}
+//# sourceMappingURL=ShellBottomNav.js.map

package/dist/shell/ui/ShellBottomNav.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellBottomNav.js","sourceRoot":"","sources":["../../../src/shell/ui/ShellBottomNav.tsx"],"names":[],"mappings":"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"}