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

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

@@ -0,0 +1,46 @@
+import type { ReactElement, ReactNode } from 'react';
+import type { PageSlotsBase } from '../../core/index.js';
+/**
+ * The slots of {@link SetupGuidePage}: the page-slot contract. `Sections` is
+ * drawn at both ends of the body (return `null` for the position you do not
+ * want): `top` under the header, `bottom` after the checklist, the `footer` and
+ * the Activation section.
+ *
+ * @example
+ * ```tsx
+ * <SetupGuidePage slots={{ BeforeContent: () => <Alert severity="info">Ask the platform team before changing mail.</Alert> }} />
+ * ```
+ *
+ * @extensionPoint slot
+ * @stability experimental
+ */
+export type SetupGuidePageSlots = PageSlotsBase;
+/**
+ * What {@link SetupGuidePage} takes.
+ *
+ * @stability experimental
+ */
+export interface SetupGuidePageProps {
+    /** Show the Activation section. Default true. */
+    showActivation?: boolean;
+    /** Extra content below the checklist (an app's own section). */
+    footer?: ReactNode;
+    /** Optional extension slots; omitted, the page renders exactly as it always did. */
+    slots?: SetupGuidePageSlots;
+}
+/**
+ * The Setup guide.
+ *
+ * @param props - see {@link SetupGuidePageProps}.
+ * @returns the page.
+ *
+ * @example
+ * ```tsx
+ * <Route path="/admin/settings/setup" element={<RequirePermission permission="system_settings:read"><SetupGuidePage /></RequirePermission>} />
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export declare function SetupGuidePage(props?: SetupGuidePageProps): ReactElement;
+//# sourceMappingURL=SetupGuidePage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SetupGuidePage.d.ts","sourceRoot":"","sources":["../../../src/onboarding/ui/SetupGuidePage.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMzD;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAC;AAEhD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gEAAgE;IAChE,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,oFAAoF;IACpF,KAAK,CAAC,EAAE,mBAAmB,CAAC;CAC7B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,KAAK,GAAE,mBAAwB,GAAG,YAAY,CAqE5E"}

package/dist/onboarding/ui/SetupGuidePage.js

@@ -0,0 +1,40 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+// =============================================================================
+// SetupGuidePage (issue #745): `/admin/settings/setup`
+// =============================================================================
+//
+// The administrator's checklist in its tier groups, a Re-check button
+// (`refresh=true`, forwarded to the Doctor), a link to the Doctor for the
+// full picture, and the Activation section. A registry card gated on
+// `system_settings:read`, the permission under which `GET /api/onboarding`
+// returns its admin block; the app's route gate keeps everyone else out.
+// =============================================================================
+import HealthAndSafetyOutlinedIcon from '@mui/icons-material/HealthAndSafetyOutlined';
+import RefreshIcon from '@mui/icons-material/Refresh';
+import { Alert, Box, Button, Card, CardContent, CircularProgress, Container, Skeleton, Stack, Typography } from '@mui/material';
+import { Link as RouterLink } from 'react-router-dom';
+import { PageSlotsFrame } from '../../core/index.js';
+import { useOnboarding } from '../headless/provider.js';
+import { ActivationMetrics } from './ActivationMetrics.js';
+import { DOCTOR_PATH, SETUP_GUIDE_DESCRIPTION, SETUP_GUIDE_TITLE } from './copy.js';
+import { OnboardingChecklist } from './OnboardingChecklist.js';
+/**
+ * The Setup guide.
+ *
+ * @param props - see {@link SetupGuidePageProps}.
+ * @returns the page.
+ *
+ * @example
+ * ```tsx
+ * <Route path="/admin/settings/setup" element={<RequirePermission permission="system_settings:read"><SetupGuidePage /></RequirePermission>} />
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export function SetupGuidePage(props = {}) {
+    const { state, appName, isLoading, isRefreshing, error, refresh } = useOnboarding();
+    const admin = state?.admin ?? null;
+    return (_jsx(Container, { maxWidth: "md", children: _jsx(Box, { sx: { py: { xs: 2, sm: 4 } }, children: _jsxs(PageSlotsFrame, { slots: props.slots, headerProps: { title: SETUP_GUIDE_TITLE, description: SETUP_GUIDE_DESCRIPTION, actions: null }, header: _jsxs(_Fragment, { children: [_jsx(Typography, { variant: "h4", component: "h1", gutterBottom: true, children: SETUP_GUIDE_TITLE }), _jsx(Typography, { color: "text.secondary", sx: { mb: 3 }, children: SETUP_GUIDE_DESCRIPTION })] }), children: [_jsxs(Stack, { direction: { xs: 'column', sm: 'row' }, spacing: { xs: 1, sm: 2 }, sx: { mb: 3, alignItems: { xs: 'stretch', sm: 'center' } }, children: [_jsx(Button, { variant: "contained", onClick: () => void refresh({ refresh: true }), disabled: isLoading || isRefreshing, startIcon: isRefreshing ? _jsx(CircularProgress, { size: 16, color: "inherit" }) : _jsx(RefreshIcon, {}), sx: { minHeight: 44 }, children: isRefreshing ? 'Checking…' : 'Re-check' }), _jsx(Button, { component: RouterLink, to: DOCTOR_PATH, startIcon: _jsx(HealthAndSafetyOutlinedIcon, {}), sx: { minHeight: 44 }, children: "Open the Doctor" })] }), error ? (_jsx(Alert, { severity: "error", sx: { mb: 2 }, children: error })) : null, admin?.requiredDone ? (_jsx(Alert, { severity: "success", sx: { mb: 2 }, children: `Everything required is set up. People can start using ${appName}.` })) : null, _jsx(Card, { variant: "outlined", "aria-busy": isLoading || isRefreshing, children: _jsx(CardContent, { children: isLoading ? (_jsx(Stack, { spacing: 1, "data-testid": "setup-guide-loading", "aria-label": "Loading setup steps", children: [0, 1, 2, 3].map((index) => (_jsx(Skeleton, { variant: "rounded", height: 48 }, index))) })) : admin ? (_jsx(OnboardingChecklist, { steps: admin.steps, completed: admin.completed, total: admin.total, label: "Setup", grouped: true })) : error ? null : (_jsx(Typography, { color: "text.secondary", children: "The setup steps are not available right now." })) }) }), props.footer, props.showActivation === false ? null : _jsx(ActivationMetrics, {})] }) }) }));
+}
+//# sourceMappingURL=SetupGuidePage.js.map

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

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

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

@@ -0,0 +1,56 @@
+import type { ReactElement, ReactNode } from 'react';
+import type { OnboardingSettingsWrite } from '../headless/client.js';
+/**
+ * What a pane slot receives.
+ *
+ * @stability experimental
+ */
+export interface WelcomePaneProps {
+    /** The id the pane's describing paragraph must carry (`aria-describedby`). */
+    descriptionId: string;
+    /** The app's name. */
+    appName: string;
+    /** Records fields to store with the "seen" write when the primary action is taken (a goal). */
+    setExtra(extra: OnboardingSettingsWrite): void;
+}
+/**
+ * The parts an app may replace.
+ *
+ * @stability experimental
+ */
+export interface WelcomeDialogSlots {
+    /** The administrator's body. Default: "a few things must be configured first". */
+    adminPane?: (props: WelcomePaneProps) => ReactNode;
+    /** Everyone else's body. Default: a greeting pointing at the checklist. */
+    userPane?: (props: WelcomePaneProps) => ReactNode;
+}
+/**
+ * What {@link WelcomeDialog} takes.
+ *
+ * @stability experimental
+ */
+export interface WelcomeDialogProps {
+    /** Replaceable bodies. */
+    slots?: WelcomeDialogSlots;
+    /** Where "Start setup" goes. Default `/admin/settings/setup`. */
+    setupPath?: string;
+    /** Where "Get started" goes. Default `/settings/getting-started`. */
+    gettingStartedPath?: string;
+}
+/**
+ * The one-time welcome. Mount it once, inside the app's layout, under the
+ * `OnboardingProvider` (`/onboarding/headless`); it renders nothing until it should open.
+ *
+ * @param props - see {@link WelcomeDialogProps}.
+ * @returns the dialog, or `null`.
+ *
+ * @example
+ * ```tsx
+ * <WelcomeDialog slots={{ userPane: (pane) => <GoalQuestion {...pane} /> }} />
+ * ```
+ *
+ * @extensionPoint slot
+ * @stability experimental
+ */
+export declare function WelcomeDialog(props: WelcomeDialogProps): ReactElement | null;
+//# sourceMappingURL=WelcomeDialog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WelcomeDialog.d.ts","sourceRoot":"","sources":["../../../src/onboarding/ui/WelcomeDialog.tsx"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIrD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGrE;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,aAAa,EAAE,MAAM,CAAC;IACtB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,+FAA+F;IAC/F,QAAQ,CAAC,KAAK,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAChD;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,kFAAkF;IAClF,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,SAAS,CAAC;IACnD,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,SAAS,CAAC;CACnD;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAmBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,YAAY,GAAG,IAAI,CAqD5E"}

package/dist/onboarding/ui/WelcomeDialog.js

@@ -0,0 +1,66 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+// =============================================================================
+// WelcomeDialog (issue #745): the one-time welcome
+// =============================================================================
+//
+// Open while `settings.welcomeSeenAt` is null. Two variants, chosen by what
+// the API returned (never a role check in the browser): an administrator
+// (the response has an admin block) is pointed at the Setup guide; everyone
+// else at Get started. The app supplies each variant's body through `slots`
+// (EvoPath's goal question is a `userPane`), and may hand extra fields to
+// store with the "seen" write (`extra`).
+//
+// Every way out (the primary button, Later, Escape, the backdrop) marks the
+// welcome seen, so it never comes back on its own; "Getting started" in the
+// user menu brings it back. ARIA dialog pattern: `aria-labelledby` and
+// `aria-describedby`, focus moved in and returned (MUI), full screen below
+// `sm`, no transition under `prefers-reduced-motion`.
+// =============================================================================
+import { Button, Dialog, DialogActions, DialogContent, DialogTitle, Typography, useMediaQuery, useTheme } from '@mui/material';
+import { useId, useState } from 'react';
+import { useNavigate } from 'react-router-dom';
+import { useOnboarding } from '../headless/provider.js';
+import { GETTING_STARTED_PATH, SETUP_GUIDE_PATH } from './copy.js';
+function DefaultAdminPane({ descriptionId, appName }) {
+    return (_jsxs(Typography, { id: descriptionId, children: ["You are the administrator of ", appName, ". A few things must be configured before people can use it; the setup guide checks each one for you and links to where it is done."] }));
+}
+function DefaultUserPane({ descriptionId, appName }) {
+    return (_jsxs(Typography, { id: descriptionId, children: ["Welcome to ", appName, ". A short checklist walks you through your first steps; each one ticks itself when it is done."] }));
+}
+/**
+ * The one-time welcome. Mount it once, inside the app's layout, under the
+ * `OnboardingProvider` (`/onboarding/headless`); it renders nothing until it should open.
+ *
+ * @param props - see {@link WelcomeDialogProps}.
+ * @returns the dialog, or `null`.
+ *
+ * @example
+ * ```tsx
+ * <WelcomeDialog slots={{ userPane: (pane) => <GoalQuestion {...pane} /> }} />
+ * ```
+ *
+ * @extensionPoint slot
+ * @stability experimental
+ */
+export function WelcomeDialog(props) {
+    const theme = useTheme();
+    const fullScreen = useMediaQuery(theme.breakpoints.down('sm'));
+    const reduceMotion = useMediaQuery('(prefers-reduced-motion: reduce)');
+    const navigate = useNavigate();
+    const { state, appName, markWelcomeSeen } = useOnboarding();
+    const [extra, setExtra] = useState({});
+    const titleId = useId();
+    const descriptionId = useId();
+    if (state === null || state.settings.welcomeSeenAt !== null)
+        return null;
+    const isAdmin = state.admin !== null;
+    const pane = { descriptionId, appName, setExtra: (next) => setExtra((current) => ({ ...current, ...next })) };
+    const Pane = isAdmin ? (props.slots?.adminPane ?? DefaultAdminPane) : (props.slots?.userPane ?? DefaultUserPane);
+    const later = () => void markWelcomeSeen();
+    const primary = () => {
+        void markWelcomeSeen(extra);
+        navigate(isAdmin ? (props.setupPath ?? SETUP_GUIDE_PATH) : (props.gettingStartedPath ?? GETTING_STARTED_PATH));
+    };
+    return (_jsxs(Dialog, { open: true, onClose: later, fullScreen: fullScreen, maxWidth: "sm", fullWidth: true, "aria-labelledby": titleId, "aria-describedby": descriptionId, transitionDuration: reduceMotion ? 0 : undefined, "data-testid": "welcome-dialog", children: [_jsx(DialogTitle, { id: titleId, children: `Welcome to ${appName}` }), _jsxs(DialogContent, { children: [_jsx(Pane, { ...pane }), isAdmin && state.admin && state.admin.total > 0 ? (_jsx(Typography, { color: "text.secondary", sx: { mt: 2 }, children: `${state.admin.completed} of ${state.admin.total} done so far.` })) : null] }), _jsxs(DialogActions, { sx: { px: 3, pb: 2 }, children: [_jsx(Button, { onClick: later, sx: { minHeight: 44 }, children: "Later" }), _jsx(Button, { variant: "contained", onClick: primary, sx: { minHeight: 44 }, children: isAdmin ? 'Start setup' : 'Get started' })] })] }));
+}
+//# sourceMappingURL=WelcomeDialog.js.map

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

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

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

@@ -0,0 +1,67 @@
+/**
+ * The Setup guide's title.
+ *
+ * @stability experimental
+ */
+export declare const SETUP_GUIDE_TITLE = "Setup guide";
+/**
+ * The Setup guide's card text and subtitle.
+ *
+ * @stability experimental
+ */
+export declare const SETUP_GUIDE_DESCRIPTION = "What must be configured before people can use the app, and the features to turn on next.";
+/**
+ * The Setup guide's route.
+ *
+ * @stability experimental
+ */
+export declare const SETUP_GUIDE_PATH = "/admin/settings/setup";
+/**
+ * The Getting started page's title.
+ *
+ * @stability experimental
+ */
+export declare const GETTING_STARTED_TITLE = "Getting started";
+/**
+ * The Getting started page's card text and subtitle.
+ *
+ * @stability experimental
+ */
+export declare const GETTING_STARTED_DESCRIPTION = "Your first steps, checked against what you have already done.";
+/**
+ * The Getting started page's route.
+ *
+ * @stability experimental
+ */
+export declare const GETTING_STARTED_PATH = "/settings/getting-started";
+/**
+ * The Doctor's route (the Setup guide links to it).
+ *
+ * @stability experimental
+ */
+export declare const DOCTOR_PATH = "/admin/settings/doctor";
+/**
+ * The Activation section's heading.
+ *
+ * @stability experimental
+ */
+export declare const ACTIVATION_HEADING = "Activation";
+/**
+ * What the Activation section says for an empty cohort.
+ *
+ * @stability experimental
+ */
+export declare const EMPTY_COHORT_TEXT = "No new users in this window";
+/**
+ * The body of a feature notice for a viewer who cannot set it up.
+ *
+ * @stability experimental
+ */
+export declare const FEATURE_UNAVAILABLE_BODY = "Your administrator hasn't set this up yet.";
+/**
+ * The label of a feature notice's link to the admin page.
+ *
+ * @stability experimental
+ */
+export declare const FEATURE_SET_UP_LABEL = "Set it up";
+//# sourceMappingURL=copy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"copy.d.ts","sourceRoot":"","sources":["../../../src/onboarding/ui/copy.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAC/C;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,6FAA6F,CAAC;AAClI;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,0BAA0B,CAAC;AACxD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,oBAAoB,CAAC;AACvD;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,kEAAkE,CAAC;AAC3G;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,8BAA8B,CAAC;AAChE;;;;GAIG;AACH,eAAO,MAAM,WAAW,2BAA2B,CAAC;AACpD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,eAAe,CAAC;AAC/C;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,gCAAgC,CAAC;AAC/D;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,+CAA+C,CAAC;AACrF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,cAAc,CAAC"}

package/dist/onboarding/ui/copy.js

@@ -0,0 +1,69 @@
+// The onboarding pages' fixed copy, shared by each page and its settings-page
+// descriptor so the card and the page say the same thing.
+/**
+ * The Setup guide's title.
+ *
+ * @stability experimental
+ */
+export const SETUP_GUIDE_TITLE = 'Setup guide';
+/**
+ * The Setup guide's card text and subtitle.
+ *
+ * @stability experimental
+ */
+export const SETUP_GUIDE_DESCRIPTION = 'What must be configured before people can use the app, and the features to turn on next.';
+/**
+ * The Setup guide's route.
+ *
+ * @stability experimental
+ */
+export const SETUP_GUIDE_PATH = '/admin/settings/setup';
+/**
+ * The Getting started page's title.
+ *
+ * @stability experimental
+ */
+export const GETTING_STARTED_TITLE = 'Getting started';
+/**
+ * The Getting started page's card text and subtitle.
+ *
+ * @stability experimental
+ */
+export const GETTING_STARTED_DESCRIPTION = 'Your first steps, checked against what you have already done.';
+/**
+ * The Getting started page's route.
+ *
+ * @stability experimental
+ */
+export const GETTING_STARTED_PATH = '/settings/getting-started';
+/**
+ * The Doctor's route (the Setup guide links to it).
+ *
+ * @stability experimental
+ */
+export const DOCTOR_PATH = '/admin/settings/doctor';
+/**
+ * The Activation section's heading.
+ *
+ * @stability experimental
+ */
+export const ACTIVATION_HEADING = 'Activation';
+/**
+ * What the Activation section says for an empty cohort.
+ *
+ * @stability experimental
+ */
+export const EMPTY_COHORT_TEXT = 'No new users in this window';
+/**
+ * The body of a feature notice for a viewer who cannot set it up.
+ *
+ * @stability experimental
+ */
+export const FEATURE_UNAVAILABLE_BODY = "Your administrator hasn't set this up yet.";
+/**
+ * The label of a feature notice's link to the admin page.
+ *
+ * @stability experimental
+ */
+export const FEATURE_SET_UP_LABEL = 'Set it up';
+//# sourceMappingURL=copy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"copy.js","sourceRoot":"","sources":["../../../src/onboarding/ui/copy.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,0DAA0D;AAE1D;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC;AAC/C;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,0FAA0F,CAAC;AAClI;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AACxD;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,iBAAiB,CAAC;AACvD;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,+DAA+D,CAAC;AAC3G;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,2BAA2B,CAAC;AAChE;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,wBAAwB,CAAC;AACpD;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,YAAY,CAAC;AAC/C;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,6BAA6B,CAAC;AAC/D;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,4CAA4C,CAAC;AACrF;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,WAAW,CAAC"}

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

@@ -0,0 +1,16 @@
+export { ACTIVATION_WINDOWS, ActivationMetrics, formatHours, formatRate } from './ActivationMetrics.js';
+export { ACTIVATION_HEADING, DOCTOR_PATH, EMPTY_COHORT_TEXT, FEATURE_SET_UP_LABEL, FEATURE_UNAVAILABLE_BODY, GETTING_STARTED_DESCRIPTION, GETTING_STARTED_PATH, GETTING_STARTED_TITLE, SETUP_GUIDE_DESCRIPTION, SETUP_GUIDE_PATH, SETUP_GUIDE_TITLE, } from './copy.js';
+export { FeatureUnavailableNotice } from './FeatureUnavailableNotice.js';
+export type { FeatureUnavailableNoticeProps } from './FeatureUnavailableNotice.js';
+export { GettingStartedMenuItem } from './GettingStartedMenuItem.js';
+export type { GettingStartedMenuItemProps } from './GettingStartedMenuItem.js';
+export { GettingStartedPage } from './GettingStartedPage.js';
+export type { GettingStartedPageProps, GettingStartedPageSlots } from './GettingStartedPage.js';
+export { ONBOARDING_TIER_LABELS, OnboardingChecklist, onboardingStatusWord } from './OnboardingChecklist.js';
+export type { OnboardingChecklistProps } from './OnboardingChecklist.js';
+export { SetupGuidePage } from './SetupGuidePage.js';
+export type { SetupGuidePageProps, SetupGuidePageSlots } from './SetupGuidePage.js';
+export { gettingStartedSettingsPage, setupGuideSettingsPage } from './settings-pages.js';
+export { WelcomeDialog } from './WelcomeDialog.js';
+export type { WelcomeDialogProps, WelcomeDialogSlots, WelcomePaneProps } from './WelcomeDialog.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/onboarding/ui/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACxG,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACxB,2BAA2B,EAC3B,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,YAAY,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,YAAY,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAChG,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAC7G,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/onboarding/ui/index.js

@@ -0,0 +1,14 @@
+// `@marinoscar/platform-web/onboarding/ui`: the welcome dialog, the
+// checklist, the Setup guide and Getting started pages, the Activation
+// section, the feature notice and the "Getting started" menu item, built on
+// `/onboarding/headless` (issue #745). Documented in ../README.md.
+export { ACTIVATION_WINDOWS, ActivationMetrics, formatHours, formatRate } from './ActivationMetrics.js';
+export { ACTIVATION_HEADING, DOCTOR_PATH, EMPTY_COHORT_TEXT, FEATURE_SET_UP_LABEL, FEATURE_UNAVAILABLE_BODY, GETTING_STARTED_DESCRIPTION, GETTING_STARTED_PATH, GETTING_STARTED_TITLE, SETUP_GUIDE_DESCRIPTION, SETUP_GUIDE_PATH, SETUP_GUIDE_TITLE, } from './copy.js';
+export { FeatureUnavailableNotice } from './FeatureUnavailableNotice.js';
+export { GettingStartedMenuItem } from './GettingStartedMenuItem.js';
+export { GettingStartedPage } from './GettingStartedPage.js';
+export { ONBOARDING_TIER_LABELS, OnboardingChecklist, onboardingStatusWord } from './OnboardingChecklist.js';
+export { SetupGuidePage } from './SetupGuidePage.js';
+export { gettingStartedSettingsPage, setupGuideSettingsPage } from './settings-pages.js';
+export { WelcomeDialog } from './WelcomeDialog.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/onboarding/ui/index.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,uEAAuE;AACvE,4EAA4E;AAC5E,mEAAmE;AAEnE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACxG,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACxB,2BAA2B,EAC3B,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAE7G,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/onboarding/ui/settings-pages.d.ts

@@ -0,0 +1,33 @@
+import type { PlatformSettingsPage } from '../../core/index.js';
+/**
+ * The Setup guide as a packaged settings page: the app appends
+ * `{ ...setupGuideSettingsPage.card, Icon: setupGuideSettingsPage.Icon }` to
+ * its admin registry and routes `card.path` behind its permission gate for
+ * `card.permission` (`system_settings:read`, the exact string
+ * `@marinoscar/platform-api/onboarding` adds the admin block for by default).
+ *
+ * @example
+ * ```tsx
+ * // apps/web/src/config/adminSections.tsx (General, last card)
+ * { ...setupGuideSettingsPage.card, Icon: setupGuideSettingsPage.Icon },
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export declare const setupGuideSettingsPage: PlatformSettingsPage<never>;
+/**
+ * Getting started as a packaged user settings page: no permission (every
+ * role holds `user_settings:read`, which `GET /api/onboarding` requires).
+ *
+ * @example
+ * ```tsx
+ * // apps/web/src/config/userSettingsSections.tsx (Account, last card)
+ * { ...gettingStartedSettingsPage.card, Icon: gettingStartedSettingsPage.Icon },
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export declare const gettingStartedSettingsPage: PlatformSettingsPage<never>;
+//# sourceMappingURL=settings-pages.d.ts.map

package/dist/onboarding/ui/settings-pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-pages.d.ts","sourceRoot":"","sources":["../../../src/onboarding/ui/settings-pages.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAYhE;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,sBAAsB,EAAE,oBAAoB,CAAC,KAAK,CAU9D,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,0BAA0B,EAAE,oBAAoB,CAAC,KAAK,CASlE,CAAC"}

package/dist/onboarding/ui/settings-pages.js

@@ -0,0 +1,56 @@
+import RocketLaunchOutlinedIcon from '@mui/icons-material/RocketLaunchOutlined';
+import ChecklistOutlinedIcon from '@mui/icons-material/ChecklistOutlined';
+import { GettingStartedPage } from './GettingStartedPage.js';
+import { GETTING_STARTED_DESCRIPTION, GETTING_STARTED_PATH, GETTING_STARTED_TITLE, SETUP_GUIDE_DESCRIPTION, SETUP_GUIDE_PATH, SETUP_GUIDE_TITLE, } from './copy.js';
+import { SetupGuidePage } from './SetupGuidePage.js';
+/**
+ * The Setup guide as a packaged settings page: the app appends
+ * `{ ...setupGuideSettingsPage.card, Icon: setupGuideSettingsPage.Icon }` to
+ * its admin registry and routes `card.path` behind its permission gate for
+ * `card.permission` (`system_settings:read`, the exact string
+ * `@marinoscar/platform-api/onboarding` adds the admin block for by default).
+ *
+ * @example
+ * ```tsx
+ * // apps/web/src/config/adminSections.tsx (General, last card)
+ * { ...setupGuideSettingsPage.card, Icon: setupGuideSettingsPage.Icon },
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export const setupGuideSettingsPage = {
+    id: 'setup-guide',
+    card: {
+        title: SETUP_GUIDE_TITLE,
+        description: SETUP_GUIDE_DESCRIPTION,
+        path: SETUP_GUIDE_PATH,
+        permission: 'system_settings:read',
+    },
+    Icon: ChecklistOutlinedIcon,
+    Page: SetupGuidePage,
+};
+/**
+ * Getting started as a packaged user settings page: no permission (every
+ * role holds `user_settings:read`, which `GET /api/onboarding` requires).
+ *
+ * @example
+ * ```tsx
+ * // apps/web/src/config/userSettingsSections.tsx (Account, last card)
+ * { ...gettingStartedSettingsPage.card, Icon: gettingStartedSettingsPage.Icon },
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export const gettingStartedSettingsPage = {
+    id: 'getting-started',
+    card: {
+        title: GETTING_STARTED_TITLE,
+        description: GETTING_STARTED_DESCRIPTION,
+        path: GETTING_STARTED_PATH,
+    },
+    Icon: RocketLaunchOutlinedIcon,
+    Page: GettingStartedPage,
+};
+//# sourceMappingURL=settings-pages.js.map

package/dist/onboarding/ui/settings-pages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-pages.js","sourceRoot":"","sources":["../../../src/onboarding/ui/settings-pages.ts"],"names":[],"mappings":"AAAA,OAAO,wBAAwB,MAAM,0CAA0C,CAAC;AAChF,OAAO,qBAAqB,MAAM,uCAAuC,CAAC;AAG1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAgC;IACjE,EAAE,EAAE,aAAa;IACjB,IAAI,EAAE;QACJ,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,uBAAuB;QACpC,IAAI,EAAE,gBAAgB;QACtB,UAAU,EAAE,sBAAsB;KACnC;IACD,IAAI,EAAE,qBAAqB;IAC3B,IAAI,EAAE,cAAc;CACrB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAgC;IACrE,EAAE,EAAE,iBAAiB;IACrB,IAAI,EAAE;QACJ,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,2BAA2B;QACxC,IAAI,EAAE,oBAAoB;KAC3B;IACD,IAAI,EAAE,wBAAwB;IAC9B,IAAI,EAAE,kBAAkB;CACzB,CAAC"}

package/dist/settings/headless/features.d.ts

@@ -0,0 +1,74 @@
+import type { SettingsFeatureRegistry } from './index.js';
+/**
+ * One deployment feature key a settings card may be gated on.
+ *
+ * @stability experimental
+ */
+export type SettingsFeatureKey = keyof SettingsFeatureRegistry & string;
+/**
+ * Which features are on. Partial: a missing key is "off" (fail closed).
+ *
+ * @stability experimental
+ */
+export type SettingsFeatures = Partial<Record<SettingsFeatureKey, boolean>>;
+/**
+ * Whether a card's `feature` gate (if any) is open under `features`.
+ *
+ * @param feature - the card's feature, or `undefined` for an always-present card.
+ * @param features - the feature map; omitted, every gated card is closed.
+ * @returns `true` when the card exists in this deployment.
+ *
+ * @stability stable
+ */
+export declare function isFeatureEnabled(feature: SettingsFeatureKey | undefined, features?: SettingsFeatures): boolean;
+/**
+ * How one feature is read: a React hook returning whether it is on.
+ *
+ * @stability experimental
+ */
+export type SettingsFeatureResolver = () => boolean;
+/**
+ * Registers how one feature is read: a React hook returning whether it is on.
+ * Call at module scope, before the first render.
+ *
+ * Registering a key again replaces its resolver in place (a hot module
+ * reload re-runs the registering module); a NEW key after the first
+ * `useSettingsFeatures()` render would change the hook order and is refused.
+ *
+ * @param key - the feature key (augment {@link SettingsFeatureRegistry} for an app key).
+ * @param useIsOn - a hook reading the app's own context; it must never fetch.
+ * @throws Error for a new key once `useSettingsFeatures()` has rendered.
+ *
+ * @example
+ * ```ts
+ * registerSettingsFeature('ai', () => useAiFeatures().ai);
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare function registerSettingsFeature(key: SettingsFeatureKey, useIsOn: SettingsFeatureResolver): void;
+/**
+ * The registered feature keys, in registration order.
+ *
+ * @returns the keys.
+ *
+ * @stability experimental
+ */
+export declare function registeredSettingsFeatures(): SettingsFeatureKey[];
+/**
+ * The complete deployment feature map: every registered resolver, asked in
+ * registration order. Without a resolver a feature is off.
+ *
+ * @returns the feature map.
+ *
+ * @stability experimental
+ */
+export declare function useSettingsFeatures(): SettingsFeatures;
+/**
+ * Clears the feature registry (tests only).
+ *
+ * @internal
+ */
+export declare function resetSettingsFeaturesForTests(): void;
+//# sourceMappingURL=features.d.ts.map

package/dist/settings/headless/features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../../src/settings/headless/features.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAK1D;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAExE;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC,CAAC;AAE5E;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,SAAS,EAAE,QAAQ,GAAE,gBAAqB,GAAG,OAAO,CAElH;AAED;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,OAAO,CAAC;AAKpD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,kBAAkB,EAAE,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAOvG;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,IAAI,kBAAkB,EAAE,CAEjE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CAMtD;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,IAAI,IAAI,CAGpD"}