@marinoscar/platform-web 0.0.0-stage → 0.1.0-next.4

package/dist/onboarding/index.d.ts

@@ -0,0 +1,3 @@
+export { FeatureUnavailableNotice } from './ui/FeatureUnavailableNotice.js';
+export type { FeatureUnavailableNoticeProps } from './ui/FeatureUnavailableNotice.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/onboarding/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/onboarding/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,YAAY,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/onboarding/index.js

@@ -0,0 +1,8 @@
+// The onboarding slice's entry point for SIBLING SLICES of this package (issue
+// #892): the boundary lint lets one slice import another only through the
+// other's `index.ts`, and only when packages/platform-slices.json lists the
+// dependency (settings -> onboarding). Not a package subpath: apps import
+// `@marinoscar/platform-web/onboarding/headless` and `/onboarding/ui`.
+// Narrow on purpose: only what a sibling uses.
+export { FeatureUnavailableNotice } from './ui/FeatureUnavailableNotice.js';
+//# sourceMappingURL=index.js.map

package/dist/onboarding/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/onboarding/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,0EAA0E;AAC1E,4EAA4E;AAC5E,0EAA0E;AAC1E,uEAAuE;AACvE,+CAA+C;AAE/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/onboarding/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/onboarding/internal/use-is-mounted.d.ts.map

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

package/dist/onboarding/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/onboarding/internal/use-is-mounted.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-is-mounted.js","sourceRoot":"","sources":["../../../src/onboarding/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/onboarding/ui/ActivationMetrics.d.ts

@@ -0,0 +1,40 @@
+import type { ReactElement } from 'react';
+/**
+ * The windows the section offers, in days.
+ *
+ * @stability experimental
+ */
+export declare const ACTIVATION_WINDOWS: readonly [7, 30, 90];
+/**
+ * `0.25` as `25%`; `null` as `null`.
+ *
+ * @param rate - the ratio.
+ * @returns the percentage text.
+ *
+ * @stability experimental
+ */
+export declare function formatRate(rate: number | null): string | null;
+/**
+ * Hours as words: under 48 in hours, otherwise in days.
+ *
+ * @param hours - the hours.
+ * @returns the text.
+ *
+ * @stability experimental
+ */
+export declare function formatHours(hours: number): string;
+/**
+ * The Activation section: new users, milestone activation and the funnel.
+ *
+ * @returns the section.
+ *
+ * @example
+ * ```tsx
+ * <ActivationMetrics />
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export declare function ActivationMetrics(): ReactElement;
+//# sourceMappingURL=ActivationMetrics.d.ts.map

package/dist/onboarding/ui/ActivationMetrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivationMetrics.d.ts","sourceRoot":"","sources":["../../../src/onboarding/ui/ActivationMetrics.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAK1C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,sBAAuB,CAAC;AAEvD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAE7D;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjD;AAoBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,IAAI,YAAY,CAiEhD"}

package/dist/onboarding/ui/ActivationMetrics.js

@@ -0,0 +1,73 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+// =============================================================================
+// ActivationMetrics (issue #745): the Activation section of the Setup guide
+// =============================================================================
+//
+// A SECTION of `/admin/settings/setup`, not a card or a tab (Settings UI
+// Pattern). For the users who signed up in the chosen window (7, 30 or 90
+// days): new users, per registered milestone the activation rate and the
+// median time to it, and the step funnel. Every number is also text ("1 of 4,
+// 25%"); bars only repeat it. Aggregates only: nothing per user is fetched.
+// =============================================================================
+import { Alert, Box, LinearProgress, Paper, Skeleton, Stack, ToggleButton, ToggleButtonGroup, Typography } from '@mui/material';
+import { useId, useState } from 'react';
+import { useOnboardingMetrics } from '../headless/use-onboarding-metrics.js';
+import { ACTIVATION_HEADING, EMPTY_COHORT_TEXT } from './copy.js';
+/**
+ * The windows the section offers, in days.
+ *
+ * @stability experimental
+ */
+export const ACTIVATION_WINDOWS = [7, 30, 90];
+/**
+ * `0.25` as `25%`; `null` as `null`.
+ *
+ * @param rate - the ratio.
+ * @returns the percentage text.
+ *
+ * @stability experimental
+ */
+export function formatRate(rate) {
+    return rate === null || !Number.isFinite(rate) ? null : `${Math.round(rate * 100)}%`;
+}
+/**
+ * Hours as words: under 48 in hours, otherwise in days.
+ *
+ * @param hours - the hours.
+ * @returns the text.
+ *
+ * @stability experimental
+ */
+export function formatHours(hours) {
+    if (hours < 48)
+        return `${Math.round(hours * 10) / 10} h`;
+    return `${Math.round((hours / 24) * 10) / 10} days`;
+}
+function Tile({ label, value, sub }) {
+    return (_jsxs(Paper, { variant: "outlined", sx: { p: 2, flex: 1, minWidth: 0 }, children: [_jsx(Typography, { variant: "body2", color: "text.secondary", children: label }), _jsx(Typography, { variant: "h5", component: "p", children: value }), sub ? (_jsx(Typography, { variant: "body2", color: "text.secondary", children: sub })) : null] }));
+}
+/**
+ * The Activation section: new users, milestone activation and the funnel.
+ *
+ * @returns the section.
+ *
+ * @example
+ * ```tsx
+ * <ActivationMetrics />
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export function ActivationMetrics() {
+    const [days, setDays] = useState(30);
+    const { metrics, isLoading, error } = useOnboardingMetrics(days);
+    const headingId = useId();
+    return (_jsxs(Box, { component: "section", "aria-labelledby": headingId, sx: { mt: 4 }, children: [_jsxs(Stack, { direction: { xs: 'column', sm: 'row' }, spacing: 1, sx: { mb: 2, alignItems: { sm: 'center' }, justifyContent: 'space-between' }, children: [_jsx(Typography, { id: headingId, variant: "h5", component: "h2", children: ACTIVATION_HEADING }), _jsx(ToggleButtonGroup, { exclusive: true, size: "small", value: days, onChange: (_e, value) => value && setDays(value), "aria-label": "Window", children: ACTIVATION_WINDOWS.map((window) => (_jsx(ToggleButton, { value: window, sx: { minHeight: 36, px: 2 }, children: `${window} days` }, window))) })] }), error ? _jsx(Alert, { severity: "error", children: error }) : null, isLoading && !metrics ? _jsx(Skeleton, { variant: "rounded", height: 96, "data-testid": "activation-loading" }) : null, metrics && metrics.cohortSize === 0 ? _jsx(Typography, { color: "text.secondary", children: EMPTY_COHORT_TEXT }) : null, metrics && metrics.cohortSize > 0 ? (_jsxs(_Fragment, { children: [_jsxs(Stack, { direction: { xs: 'column', sm: 'row' }, spacing: 2, sx: { mb: 2 }, children: [_jsx(Tile, { label: "New users", value: String(metrics.cohortSize), sub: `in the last ${metrics.windowDays} days` }), metrics.milestones.map((m) => (_jsx(Tile, { label: `${m.label} within ${m.windowDays} days`, value: formatRate(m.activationRate) ?? 'Not yet', sub: `${m.activated} of ${m.eligible} eligible` +
+                                    (m.medianHours === null ? '' : ` · median ${formatHours(m.medianHours)}`) }, m.id)))] }), metrics.steps.length > 0 ? (_jsx(Box, { component: "ul", "aria-label": "Step funnel", sx: { listStyle: 'none', p: 0, m: 0 }, children: metrics.steps.map((step) => {
+                            const rate = formatRate(step.rate);
+                            const text = `${step.completed} of ${metrics.cohortSize}${rate ? `, ${rate}` : ''}`;
+                            return (_jsxs(Box, { component: "li", sx: { mb: 1.5 }, children: [_jsxs(Typography, { variant: "body2", children: [step.title, ": ", text] }), _jsx(LinearProgress, { variant: "determinate", value: Math.round((step.rate ?? 0) * 100), "aria-label": step.title, "aria-valuetext": text, sx: { height: 6, borderRadius: 3 } })] }, step.id));
+                        }) })) : null] })) : null] }));
+}
+//# sourceMappingURL=ActivationMetrics.js.map

package/dist/onboarding/ui/ActivationMetrics.js.map

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

package/dist/onboarding/ui/FeatureUnavailableNotice.d.ts

@@ -0,0 +1,30 @@
+import type { ReactElement } from 'react';
+/**
+ * What {@link FeatureUnavailableNotice} takes.
+ *
+ * @stability experimental
+ */
+export interface FeatureUnavailableNoticeProps {
+    /** The feature (`ai`, `storage`, `push`, or one registered with `registerFeatureNotice`). */
+    feature: string;
+    /** An extra sentence, such as what still works. */
+    detail?: string;
+}
+/**
+ * "<Feature> isn't enabled yet", with "Set it up" for the feature's
+ * administrators.
+ *
+ * @param props - see {@link FeatureUnavailableNoticeProps}.
+ * @returns the notice.
+ * @throws Error when no notice is registered for `feature`.
+ *
+ * @example
+ * ```tsx
+ * {aiEnabled ? <AskButton /> : <FeatureUnavailableNotice feature="ai" />}
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export declare function FeatureUnavailableNotice({ feature, detail }: FeatureUnavailableNoticeProps): ReactElement;
+//# sourceMappingURL=FeatureUnavailableNotice.d.ts.map

package/dist/onboarding/ui/FeatureUnavailableNotice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeatureUnavailableNotice.d.ts","sourceRoot":"","sources":["../../../src/onboarding/ui/FeatureUnavailableNotice.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAO1C;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC5C,6FAA6F;IAC7F,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,6BAA6B,GAAG,YAAY,CAwBzG"}

package/dist/onboarding/ui/FeatureUnavailableNotice.js

@@ -0,0 +1,43 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// =============================================================================
+// FeatureUnavailableNotice (issue #745): "{Feature} isn't enabled yet"
+// =============================================================================
+//
+// Shown in place of a control that cannot work because the feature behind it
+// is not set up (AI, object storage, Web Push, an app's own), so it neither
+// vanishes silently nor fails on use. A viewer holding the feature's admin
+// permission sees "Set it up", a link to the admin page; everyone else reads
+// that their administrator has not set it up. The permission only picks the
+// words: the admin route and the API enforce their own gates.
+// =============================================================================
+import { Alert, AlertTitle, Button } from '@mui/material';
+import { Link as RouterLink } from 'react-router-dom';
+import { usePlatformViewer } from '../../core/index.js';
+import { featureNoticeFor } from '../headless/feature-notices.js';
+import { FEATURE_SET_UP_LABEL, FEATURE_UNAVAILABLE_BODY } from './copy.js';
+/**
+ * "<Feature> isn't enabled yet", with "Set it up" for the feature's
+ * administrators.
+ *
+ * @param props - see {@link FeatureUnavailableNoticeProps}.
+ * @returns the notice.
+ * @throws Error when no notice is registered for `feature`.
+ *
+ * @example
+ * ```tsx
+ * {aiEnabled ? <AskButton /> : <FeatureUnavailableNotice feature="ai" />}
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export function FeatureUnavailableNotice({ feature, detail }) {
+    const viewer = usePlatformViewer();
+    const notice = featureNoticeFor(feature);
+    if (!notice)
+        throw new Error(`FeatureUnavailableNotice: no notice is registered for "${feature}" (registerFeatureNotice).`);
+    const canSetUp = viewer.hasPermission(notice.adminPermission);
+    const text = [canSetUp ? null : FEATURE_UNAVAILABLE_BODY, detail ?? null].filter(Boolean).join(' ');
+    return (_jsxs(Alert, { severity: "info", "data-testid": `feature-unavailable-${feature}`, action: canSetUp ? (_jsx(Button, { component: RouterLink, to: notice.setupHref, variant: "outlined", size: "small", sx: { minHeight: 36 }, children: FEATURE_SET_UP_LABEL })) : null, sx: { '& .MuiAlert-action': { alignItems: 'center', pt: 0 } }, children: [_jsx(AlertTitle, { sx: { mb: text ? 0.5 : 0 }, children: `${notice.label} isn't enabled yet` }), text || null] }));
+}
+//# sourceMappingURL=FeatureUnavailableNotice.js.map

package/dist/onboarding/ui/FeatureUnavailableNotice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeatureUnavailableNotice.js","sourceRoot":"","sources":["../../../src/onboarding/ui/FeatureUnavailableNotice.tsx"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,uEAAuE;AACvE,gFAAgF;AAChF,EAAE;AACF,6EAA6E;AAC7E,4EAA4E;AAC5E,2EAA2E;AAC3E,6EAA6E;AAC7E,4EAA4E;AAC5E,8DAA8D;AAC9D,gFAAgF;AAEhF,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE1D,OAAO,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAc3E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,wBAAwB,CAAC,EAAE,OAAO,EAAE,MAAM,EAAiC;IACzF,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,OAAO,4BAA4B,CAAC,CAAC;IAC5H,MAAM,QAAQ,GAAG,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,wBAAwB,EAAE,MAAM,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEpG,OAAO,CACL,MAAC,KAAK,IACJ,QAAQ,EAAC,MAAM,iBACF,uBAAuB,OAAO,EAAE,EAC7C,MAAM,EACJ,QAAQ,CAAC,CAAC,CAAC,CACT,KAAC,MAAM,IAAC,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,EAAC,UAAU,EAAC,IAAI,EAAC,OAAO,EAAC,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,YACvG,oBAAoB,GACd,CACV,CAAC,CAAC,CAAC,IAAI,EAEV,EAAE,EAAE,EAAE,oBAAoB,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,aAE7D,KAAC,UAAU,IAAC,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,YAAG,GAAG,MAAM,CAAC,KAAK,oBAAoB,GAAc,EACzF,IAAI,IAAI,IAAI,IACP,CACT,CAAC;AACJ,CAAC"}

package/dist/onboarding/ui/GettingStartedMenuItem.d.ts

@@ -0,0 +1,28 @@
+import type { ReactElement } from 'react';
+/**
+ * What {@link GettingStartedMenuItem} takes.
+ *
+ * @stability experimental
+ */
+export interface GettingStartedMenuItemProps {
+    /** Called after the action ran (to close the menu, navigate). */
+    onDone?: () => void;
+}
+/**
+ * The "Getting started" item for the app's user menu: clears the stored
+ * welcome and dismissals so the dialog and the checklists return. Renders
+ * nothing without an onboarding provider or before its state loaded.
+ *
+ * @param props - see {@link GettingStartedMenuItemProps}.
+ * @returns the menu item, or `null`.
+ *
+ * @example
+ * ```tsx
+ * <Menu ...><GettingStartedMenuItem onDone={handleClose} /></Menu>
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export declare function GettingStartedMenuItem({ onDone }: GettingStartedMenuItemProps): ReactElement | null;
+//# sourceMappingURL=GettingStartedMenuItem.d.ts.map

package/dist/onboarding/ui/GettingStartedMenuItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GettingStartedMenuItem.d.ts","sourceRoot":"","sources":["../../../src/onboarding/ui/GettingStartedMenuItem.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAI1C;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,MAAM,EAAE,EAAE,2BAA2B,GAAG,YAAY,GAAG,IAAI,CAgBnG"}

package/dist/onboarding/ui/GettingStartedMenuItem.js

@@ -0,0 +1,30 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import RocketLaunchOutlinedIcon from '@mui/icons-material/RocketLaunchOutlined';
+import { ListItemIcon, ListItemText, MenuItem } from '@mui/material';
+import { useGettingStartedAction } from '../headless/getting-started.js';
+/**
+ * The "Getting started" item for the app's user menu: clears the stored
+ * welcome and dismissals so the dialog and the checklists return. Renders
+ * nothing without an onboarding provider or before its state loaded.
+ *
+ * @param props - see {@link GettingStartedMenuItemProps}.
+ * @returns the menu item, or `null`.
+ *
+ * @example
+ * ```tsx
+ * <Menu ...><GettingStartedMenuItem onDone={handleClose} /></Menu>
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export function GettingStartedMenuItem({ onDone }) {
+    const action = useGettingStartedAction();
+    if (!action.visible)
+        return null;
+    return (_jsxs(MenuItem, { onClick: () => {
+            void action.run();
+            onDone?.();
+        }, children: [_jsx(ListItemIcon, { children: _jsx(RocketLaunchOutlinedIcon, { fontSize: "small" }) }), _jsx(ListItemText, { children: action.label })] }));
+}
+//# sourceMappingURL=GettingStartedMenuItem.js.map

package/dist/onboarding/ui/GettingStartedMenuItem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GettingStartedMenuItem.js","sourceRoot":"","sources":["../../../src/onboarding/ui/GettingStartedMenuItem.tsx"],"names":[],"mappings":";AAAA,OAAO,wBAAwB,MAAM,0CAA0C,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAYzE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,sBAAsB,CAAC,EAAE,MAAM,EAA+B;IAC5E,MAAM,MAAM,GAAG,uBAAuB,EAAE,CAAC;IACzC,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IACjC,OAAO,CACL,MAAC,QAAQ,IACP,OAAO,EAAE,GAAG,EAAE;YACZ,KAAK,MAAM,CAAC,GAAG,EAAE,CAAC;YAClB,MAAM,EAAE,EAAE,CAAC;QACb,CAAC,aAED,KAAC,YAAY,cACX,KAAC,wBAAwB,IAAC,QAAQ,EAAC,OAAO,GAAG,GAChC,EACf,KAAC,YAAY,cAAE,MAAM,CAAC,KAAK,GAAgB,IAClC,CACZ,CAAC;AACJ,CAAC"}

package/dist/onboarding/ui/GettingStartedPage.d.ts

@@ -0,0 +1,42 @@
+import type { ReactElement } from 'react';
+import type { PageSlotsBase } from '../../core/index.js';
+/**
+ * The slots of {@link GettingStartedPage}: the page-slot contract. `Sections`
+ * is drawn at both ends of the body (return `null` for the position you do not
+ * want), so an app adds its own notes or steps above or below the checklist;
+ * the platform's steps themselves come from the step registry on the API.
+ *
+ * @example
+ * ```tsx
+ * <GettingStartedPage slots={{ Sections: ({ position }) => (position === 'bottom' ? <TeamIntro /> : null) }} />
+ * ```
+ *
+ * @extensionPoint slot
+ * @stability experimental
+ */
+export type GettingStartedPageSlots = PageSlotsBase;
+/**
+ * What {@link GettingStartedPage} takes.
+ *
+ * @stability experimental
+ */
+export interface GettingStartedPageProps {
+    /** Optional extension slots; omitted, the page renders exactly as it always did. */
+    slots?: GettingStartedPageSlots;
+}
+/**
+ * The Getting started page.
+ *
+ * @param props - see {@link GettingStartedPageProps}.
+ * @returns the page.
+ *
+ * @example
+ * ```tsx
+ * <Route path="/settings/getting-started" element={<GettingStartedPage />} />
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export declare function GettingStartedPage(props?: GettingStartedPageProps): ReactElement;
+//# sourceMappingURL=GettingStartedPage.d.ts.map

package/dist/onboarding/ui/GettingStartedPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GettingStartedPage.d.ts","sourceRoot":"","sources":["../../../src/onboarding/ui/GettingStartedPage.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKzD;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,uBAAuB,GAAG,aAAa,CAAC;AAEpD;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,oFAAoF;IACpF,KAAK,CAAC,EAAE,uBAAuB,CAAC;CACjC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,GAAE,uBAA4B,GAAG,YAAY,CAqDpF"}

package/dist/onboarding/ui/GettingStartedPage.js

@@ -0,0 +1,34 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+// =============================================================================
+// GettingStartedPage (issue #745): `/settings/getting-started`
+// =============================================================================
+//
+// The caller's own checklist, with Skip on the skippable steps, and a way to
+// see the welcome again. A user settings card with no permission: every role
+// holds `user_settings:read`.
+// =============================================================================
+import { Alert, Box, Button, Card, CardContent, Container, Skeleton, Stack, Typography } from '@mui/material';
+import { PageSlotsFrame } from '../../core/index.js';
+import { useOnboarding } from '../headless/provider.js';
+import { GETTING_STARTED_DESCRIPTION, GETTING_STARTED_TITLE } from './copy.js';
+import { OnboardingChecklist } from './OnboardingChecklist.js';
+/**
+ * The Getting started page.
+ *
+ * @param props - see {@link GettingStartedPageProps}.
+ * @returns the page.
+ *
+ * @example
+ * ```tsx
+ * <Route path="/settings/getting-started" element={<GettingStartedPage />} />
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export function GettingStartedPage(props = {}) {
+    const { state, isLoading, error, setSkipped, reopen } = useOnboarding();
+    const user = state?.user ?? null;
+    return (_jsx(Container, { maxWidth: "md", children: _jsx(Box, { sx: { py: { xs: 2, sm: 4 } }, children: _jsxs(PageSlotsFrame, { slots: props.slots, headerProps: { title: GETTING_STARTED_TITLE, description: GETTING_STARTED_DESCRIPTION, actions: null }, header: _jsxs(_Fragment, { children: [_jsx(Typography, { variant: "h4", component: "h1", gutterBottom: true, children: GETTING_STARTED_TITLE }), _jsx(Typography, { color: "text.secondary", sx: { mb: 3 }, children: GETTING_STARTED_DESCRIPTION })] }), children: [error ? (_jsx(Alert, { severity: "error", sx: { mb: 2 }, children: error })) : null, _jsx(Card, { variant: "outlined", "aria-busy": isLoading, children: _jsx(CardContent, { children: isLoading ? (_jsx(Stack, { spacing: 1, "aria-label": "Loading your steps", children: [0, 1, 2].map((index) => (_jsx(Skeleton, { variant: "rounded", height: 48 }, index))) })) : user && user.total > 0 ? (_jsx(OnboardingChecklist, { steps: user.steps, completed: user.completed, total: user.total, onSkip: (id, skipped) => void setSkipped(id, skipped) })) : error ? null : (_jsx(Typography, { color: "text.secondary", children: "Nothing to set up right now." })) }) }), _jsx(Button, { onClick: () => void reopen(), sx: { mt: 2, minHeight: 44 }, children: "Show the welcome again" })] }) }) }));
+}
+//# sourceMappingURL=GettingStartedPage.js.map

package/dist/onboarding/ui/GettingStartedPage.js.map

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

package/dist/onboarding/ui/OnboardingChecklist.d.ts

@@ -0,0 +1,55 @@
+import type { OnboardingStep, OnboardingTier } from '@marinoscar/platform-contract/onboarding';
+import type { ReactElement } from 'react';
+/**
+ * The heading of each tier's group.
+ *
+ * @stability experimental
+ */
+export declare const ONBOARDING_TIER_LABELS: Readonly<Record<OnboardingTier, string>>;
+/**
+ * A step's status in words.
+ *
+ * @param step - the step.
+ * @returns "Done", "To do", "Blocked" or "Skipped".
+ *
+ * @stability experimental
+ */
+export declare function onboardingStatusWord(step: OnboardingStep): string;
+/**
+ * What {@link OnboardingChecklist} takes.
+ *
+ * @stability experimental
+ */
+export interface OnboardingChecklistProps {
+    /** The steps, in order. */
+    steps: readonly OnboardingStep[];
+    /** How many are done. */
+    completed: number;
+    /** How many there are. */
+    total: number;
+    /** Accessible name of the list and the progress bar. Default "Getting started". */
+    label?: string;
+    /** Group the steps under their tier's heading. */
+    grouped?: boolean;
+    /** Called when a step's link is followed (to close a surrounding dialog). */
+    onNavigate?: () => void;
+    /** Offers Skip / Undo on skippable steps that are not done. */
+    onSkip?: (stepId: string, skipped: boolean) => void;
+}
+/**
+ * One audience's checklist: a list of links with each status in words and
+ * an icon, and a "3 of 5 done" progress line.
+ *
+ * @param props - see {@link OnboardingChecklistProps}.
+ * @returns the checklist.
+ *
+ * @example
+ * ```tsx
+ * <OnboardingChecklist steps={user.steps} completed={user.completed} total={user.total} onSkip={setSkipped} />
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export declare function OnboardingChecklist(props: OnboardingChecklistProps): ReactElement;
+//# sourceMappingURL=OnboardingChecklist.d.ts.map

package/dist/onboarding/ui/OnboardingChecklist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OnboardingChecklist.d.ts","sourceRoot":"","sources":["../../../src/onboarding/ui/OnboardingChecklist.tsx"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAmB/F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAI1E,CAAC;AAEH;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAIjE;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,2BAA2B;IAC3B,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IACjC,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACrD;AAoDD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,GAAG,YAAY,CA8CjF"}

package/dist/onboarding/ui/OnboardingChecklist.js

@@ -0,0 +1,91 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+// =============================================================================
+// OnboardingChecklist (issue #745): one audience's derived steps, as a list
+// =============================================================================
+//
+// Presentation only: every status comes from `GET /api/onboarding`; nothing
+// here can tick a step. Accessibility:
+//   - a real list per group (`required`, `recommended`, `optional` when
+//     `grouped`), each labelled by its subheader;
+//   - each step's status is a WORD ("Done", "To do", "Blocked", "Skipped")
+//     beside an icon, never colour alone;
+//   - progress is visible text ("3 of 5 done") and a determinate bar with
+//     `aria-valuetext`;
+//   - a step to do is a link to the page where it is done.
+// =============================================================================
+import { ONBOARDING_TIERS } from '@marinoscar/platform-contract/onboarding';
+import BlockIcon from '@mui/icons-material/Block';
+import CheckCircleIcon from '@mui/icons-material/CheckCircle';
+import ChevronRightIcon from '@mui/icons-material/ChevronRight';
+import RadioButtonUncheckedIcon from '@mui/icons-material/RadioButtonUnchecked';
+import RemoveCircleOutlineIcon from '@mui/icons-material/RemoveCircleOutlineOutlined';
+import { Box, Button, LinearProgress, List, ListItem, ListItemButton, ListItemIcon, ListItemText, ListSubheader, Typography, } from '@mui/material';
+import { useId } from 'react';
+import { Link as RouterLink } from 'react-router-dom';
+/**
+ * The heading of each tier's group.
+ *
+ * @stability experimental
+ */
+export const ONBOARDING_TIER_LABELS = Object.freeze({
+    required: 'Required',
+    recommended: 'Recommended',
+    optional: 'Optional',
+});
+/**
+ * A step's status in words.
+ *
+ * @param step - the step.
+ * @returns "Done", "To do", "Blocked" or "Skipped".
+ *
+ * @stability experimental
+ */
+export function onboardingStatusWord(step) {
+    if (step.status === 'done')
+        return 'Done';
+    if (step.skipped)
+        return 'Skipped';
+    return step.status === 'blocked' ? 'Blocked' : 'To do';
+}
+function StepRow({ step, onNavigate, onSkip }) {
+    const done = step.status === 'done';
+    const word = onboardingStatusWord(step);
+    const hint = done ? null : step.status === 'blocked' ? step.blockedReason : step.detail;
+    const Icon = done ? CheckCircleIcon : step.skipped ? RemoveCircleOutlineIcon : step.status === 'blocked' ? BlockIcon : RadioButtonUncheckedIcon;
+    const icon = (_jsx(ListItemIcon, { sx: { minWidth: 40 }, children: _jsx(Icon, { color: done ? 'success' : 'action', "aria-hidden": true }) }));
+    const text = (_jsx(ListItemText, { primary: step.title, secondary: _jsxs(_Fragment, { children: [_jsx(Box, { component: "span", sx: { fontWeight: 500, color: done ? 'success.main' : 'text.secondary' }, children: word }), hint ? _jsx(Box, { component: "span", children: ` · ${hint}` }) : null] }) }));
+    const skip = onSkip && step.skippable && !done ? (_jsx(Button, { size: "small", onClick: () => onSkip(step.id, !step.skipped), sx: { minHeight: 36, flexShrink: 0 }, children: step.skipped ? 'Undo skip' : 'Skip' })) : null;
+    if (done || step.status === 'blocked') {
+        return (_jsxs(ListItem, { "data-testid": `onboarding-step-${step.id}`, "data-status": step.status, secondaryAction: skip, children: [icon, text] }));
+    }
+    return (_jsx(ListItem, { disablePadding: true, "data-testid": `onboarding-step-${step.id}`, "data-status": step.status, secondaryAction: skip, children: _jsxs(ListItemButton, { component: RouterLink, to: step.href, onClick: onNavigate, sx: { minHeight: 48, pr: skip ? 12 : undefined }, children: [icon, text, _jsx(ChevronRightIcon, { color: "action", "aria-hidden": true })] }) }));
+}
+/**
+ * One audience's checklist: a list of links with each status in words and
+ * an icon, and a "3 of 5 done" progress line.
+ *
+ * @param props - see {@link OnboardingChecklistProps}.
+ * @returns the checklist.
+ *
+ * @example
+ * ```tsx
+ * <OnboardingChecklist steps={user.steps} completed={user.completed} total={user.total} onSkip={setSkipped} />
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export function OnboardingChecklist(props) {
+    const { steps, completed, total, label = 'Getting started', grouped = false, onNavigate, onSkip } = props;
+    const baseId = useId();
+    const progressText = `${completed} of ${total} done`;
+    const percent = total > 0 ? Math.round((completed / total) * 100) : 0;
+    const groups = grouped
+        ? ONBOARDING_TIERS.map((tier) => ({ key: tier, label: ONBOARDING_TIER_LABELS[tier], steps: steps.filter((s) => s.tier === tier) })).filter((group) => group.steps.length > 0)
+        : [{ key: 'all', label: null, steps }];
+    return (_jsxs(Box, { children: [_jsx(Typography, { variant: "body2", color: "text.secondary", sx: { mb: 0.5 }, "data-testid": "onboarding-progress-text", children: progressText }), _jsx(LinearProgress, { variant: "determinate", value: percent, "aria-label": `${label} progress`, "aria-valuetext": progressText, sx: { mb: 1, height: 6, borderRadius: 3 } }), groups.map((group) => {
+                const headerId = `${baseId}-${group.key}`;
+                return (_jsx(List, { "aria-labelledby": group.label ? headerId : undefined, "aria-label": group.label ? undefined : label, subheader: group.label ? (_jsx(ListSubheader, { id: headerId, component: "div", disableSticky: true, sx: { px: 0, bgcolor: 'transparent' }, children: group.label })) : undefined, children: group.steps.map((step) => (_jsx(StepRow, { step: step, onNavigate: onNavigate, onSkip: onSkip }, step.id))) }, group.key));
+            })] }));
+}
+//# sourceMappingURL=OnboardingChecklist.js.map

package/dist/onboarding/ui/OnboardingChecklist.js.map

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