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

package/dist/settings/ui/PluggableConfigForm.js

@@ -0,0 +1,95 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// =============================================================================
+// PluggableConfigForm: the generated configuration form of one pluggable
+// implementation (PP-14.5, issue #923)
+// =============================================================================
+//
+// Renders a `PluggableDescriptor` (`@marinoscar/platform-contract/settings`)
+// the way `OrgSettingsPage` renders a namespace: a Switch for a boolean, a
+// select for an enum, a text or number input, and a note for a field the form
+// cannot edit generically (`other`). A `secret` field is a write-only
+// `SecretField`: the form is handed whether a value is stored, never the value,
+// and what the user types is a replacement.
+//
+// The form is CONTROLLED and presentational (the UI presents and collects, the
+// API decides): it has no save button and no fetch. The page owns those;
+// `usePluggableConfigForm` (settings/headless) holds the state.
+// =============================================================================
+import { Box, FormControl, FormControlLabel, FormHelperText, MenuItem, Stack, Switch, TextField, Typography } from '@mui/material';
+import { useId } from 'react';
+import { SecretField } from '../../credentials/index.js';
+/** "Signing key" reads as "a signing key" in the saved-secret sentence; "API key" stays. */
+function nounOf(label) {
+    return label.length > 1 && label[0] === label[0]?.toUpperCase() && label[1] === label[1]?.toLowerCase()
+        ? `${label[0]?.toLowerCase()}${label.slice(1)}`
+        : label;
+}
+/**
+ * The form of one pluggable implementation, generated from its descriptor.
+ *
+ * Controlled and presentational: it renders the fields, the page saves.
+ * Secrets are write-only: a stored one is shown as saved, never as a value,
+ * and an untouched secret is left out of the payload by
+ * `usePluggableConfigForm`.
+ *
+ * @param props - see {@link PluggableConfigFormProps}.
+ * @returns the form fields.
+ *
+ * @example
+ * ```tsx
+ * const form = usePluggableConfigForm(descriptor, stored);
+ * <PluggableConfigForm
+ *   descriptor={descriptor}
+ *   value={form.value}
+ *   onChange={form.setField}
+ *   secrets={form.secrets}
+ *   onSecretChange={form.setSecret}
+ *   disabled={!canWrite}
+ * />
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export function PluggableConfigForm(props) {
+    const { descriptor, value, onChange, secrets, onSecretChange, disabled = false, slots } = props;
+    const baseId = useId().replace(/[^A-Za-z0-9_-]/g, '');
+    return (_jsx(Stack, { role: "group", "aria-label": descriptor.label, spacing: 2, children: descriptor.fields.map((field) => {
+            const id = `pluggable-${baseId}-${field.name}`;
+            const typed = secrets[field.name] ?? '';
+            const control = defaultControl({ field, id, value: value[field.name], typed, disabled, slots, onChange, onSecretChange });
+            const custom = slots?.renderField?.({
+                field,
+                value: field.kind === 'secret' ? undefined : value[field.name],
+                secret: field.kind === 'secret' ? typed : '',
+                disabled,
+                onChange: (next) => onChange(field.name, next),
+                onSecretChange: (next) => onSecretChange(field.name, next),
+                defaultControl: control,
+            });
+            return _jsx(Box, { children: custom !== undefined ? custom : control }, field.name);
+        }) }));
+}
+function defaultControl({ field, id, value, typed, disabled, slots, onChange, onSecretChange }) {
+    const textProps = { size: 'small', id, disabled, helperText: field.help, ...slots?.textField };
+    switch (field.kind) {
+        case 'boolean':
+            return (_jsxs(FormControl, { disabled: disabled, children: [_jsx(FormControlLabel, { control: _jsx(Switch, { id: id, checked: value === true, disabled: disabled, onChange: (event) => onChange(field.name, event.target.checked), slotProps: field.help ? { input: { 'aria-describedby': `${id}-help` } } : undefined }), label: field.label }), field.help && _jsx(FormHelperText, { id: `${id}-help`, children: field.help })] }));
+        case 'enum':
+            return (_jsx(TextField, { ...textProps, select: true, label: field.label, value: typeof value === 'string' ? value : '', onChange: (event) => onChange(field.name, event.target.value), sx: { minWidth: 220, maxWidth: '100%' }, children: field.options.map((option) => (_jsx(MenuItem, { value: option, children: option }, option))) }));
+        case 'number':
+            return (_jsx(TextField, { ...textProps, type: "number", label: field.label, value: typeof value === 'number' ? value : '', slotProps: { htmlInput: { min: field.min, max: field.max, step: field.integer ? 1 : 'any' } }, onChange: (event) => onChange(field.name, event.target.value === '' ? undefined : Number(event.target.value)), sx: { minWidth: 220, maxWidth: '100%' } }));
+        case 'string':
+            return (_jsx(TextField, { ...textProps, label: field.label, value: typeof value === 'string' ? value : '', slotProps: { htmlInput: { maxLength: field.maxLength } }, onChange: (event) => onChange(field.name, event.target.value === '' ? undefined : event.target.value), sx: { minWidth: 280, maxWidth: '100%' } }));
+        case 'secret':
+            return (_jsx(SecretField, { id: id, name: field.name, label: field.label, value: typed, onChange: (next) => onSecretChange(field.name, next), 
+                // The descriptor carries presence only: no hint, no date. An empty hint reads as "is saved."
+                saved: field.hasValue ? { hint: '' } : null, noun: nounOf(field.label), emptyHelp: field.help ?? `No ${nounOf(field.label)} is saved yet.`, disabled: disabled, slots: {
+                    ...slots?.secretField,
+                    textField: { required: field.required && !field.hasValue, ...slots?.secretField?.textField },
+                } }));
+        default:
+            return (_jsx(Typography, { variant: "body2", color: "text.secondary", children: slots?.otherNote ? slots.otherNote(field) : `${field.label}: managed elsewhere.` }));
+    }
+}
+//# sourceMappingURL=PluggableConfigForm.js.map

package/dist/settings/ui/PluggableConfigForm.js.map

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

package/dist/settings/ui/ProfileSettings.d.ts

@@ -0,0 +1,75 @@
+import type { ComponentType } from 'react';
+import type { UserSettingsResponseBase } from '@marinoscar/platform-contract/settings';
+/**
+ * The profile fields a save may change. Beyond the core three, a field an
+ * app added with `extendUserProfile` (`timezone`): `null` deletes it.
+ *
+ * @stability experimental
+ */
+export type ProfilePatch = Partial<UserSettingsResponseBase['profile']> & Record<string, unknown>;
+/**
+ * What the `ExtraFields` slot of {@link ProfileSettings} receives: the app's
+ * own profile fields, drawn inside the card and saved with its button.
+ *
+ * @stability experimental
+ */
+export interface ProfileExtraFieldsProps {
+    /** The stored profile, the app's fields included. */
+    profile: UserSettingsResponseBase['profile'] & Record<string, unknown>;
+    /**
+     * The values to show: what is stored, with the edits not saved yet on top.
+     * Only the fields an app added (never `displayName` or the picture).
+     */
+    values: Readonly<Record<string, unknown>>;
+    /** Sets one field; `undefined`, `null` or `''` clears it (the save sends `null`). */
+    onChange: (name: string, value: unknown) => void;
+    /** Whether the card is disabled (a save or an upload is in flight). */
+    disabled: boolean;
+}
+/**
+ * The replaceable parts of {@link ProfileSettings}. With none, the card is
+ * exactly what it always was.
+ *
+ * @stability experimental
+ */
+export interface ProfileSettingsSlots {
+    /** Rendered under the display name (nothing by default): the fields an app added to the profile. */
+    ExtraFields?: ComponentType<ProfileExtraFieldsProps>;
+}
+/**
+ * Props of {@link ProfileSettings}.
+ *
+ * @extensionPoint slot
+ * @stability experimental
+ */
+export interface ProfileSettingsProps {
+    /** The stored profile preferences. */
+    profile: UserSettingsResponseBase['profile'] & Record<string, unknown>;
+    /** PATCH the changed profile fields (display name and/or picture source). */
+    onSave: (profile: ProfilePatch) => Promise<void>;
+    /**
+     * Adopt the settings document the upload/remove endpoints return, so the
+     * stored `version` stays current, and optionally announce success.
+     */
+    onSettingsReplaced?: (settings: UserSettingsResponseBase, successMessage?: string) => void;
+    /** Disables every control (a save is in flight). */
+    disabled?: boolean;
+    /** Part overrides. */
+    slots?: ProfileSettingsSlots;
+}
+/**
+ * The profile card: display name, picture source (none, provider, upload),
+ * preview, upload and remove.
+ *
+ * @param props - see {@link ProfileSettingsProps}.
+ * @returns the card.
+ *
+ * @example
+ * ```tsx
+ * <ProfileSettings profile={settings.profile} onSave={(profile) => save({ profile }, msgs)} />
+ * ```
+ *
+ * @stability experimental
+ */
+export declare function ProfileSettings({ profile, onSave, onSettingsReplaced, disabled, slots, }: ProfileSettingsProps): import("react").JSX.Element;
+//# sourceMappingURL=ProfileSettings.d.ts.map

package/dist/settings/ui/ProfileSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProfileSettings.d.ts","sourceRoot":"","sources":["../../../src/settings/ui/ProfileSettings.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAwB3C,OAAO,KAAK,EAAsB,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAU3G;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,wBAAwB,CAAC,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAKlG;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,qDAAqD;IACrD,OAAO,EAAE,wBAAwB,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvE;;;OAGG;IACH,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1C,qFAAqF;IACrF,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACjD,uEAAuE;IACvE,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,oGAAoG;IACpG,WAAW,CAAC,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAC;CACtD;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,sCAAsC;IACtC,OAAO,EAAE,wBAAwB,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvE,6EAA6E;IAC7E,MAAM,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD;;;OAGG;IACH,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EAAE,wBAAwB,EAAE,cAAc,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3F,oDAAoD;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sBAAsB;IACtB,KAAK,CAAC,EAAE,oBAAoB,CAAC;CAC9B;AAgCD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,EAC9B,OAAO,EACP,MAAM,EACN,kBAAkB,EAClB,QAAgB,EAChB,KAAK,GACN,EAAE,oBAAoB,+BA2atB"}

package/dist/settings/ui/ProfileSettings.js

@@ -0,0 +1,270 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useId, useMemo, useRef, useState } from 'react';
+import { Alert, Avatar, Box, Button, Card, CardContent, Dialog, DialogActions, DialogContent, DialogContentText, DialogTitle, FormControl, FormControlLabel, FormHelperText, FormLabel, Radio, RadioGroup, Stack, TextField, Typography, } from '@mui/material';
+import { DeleteOutlined as DeleteIcon } from '@mui/icons-material';
+import { isPlatformApiError } from '../../core/index.js';
+import { useAuth } from '../../identity/index.js';
+import { FeatureUnavailableNotice } from '../../onboarding/index.js';
+import { useProfileImageClient } from '../headless/profile-image.js';
+import { useStorageStatus } from '../headless/use-storage-status.js';
+import { ImageUpload } from './ImageUpload.js';
+/** The core profile fields; every other key of a stored profile belongs to an app's `extendUserProfile`. */
+const CORE_PROFILE_KEYS = ['displayName', 'imageSource', 'imageObjectId'];
+/** A cleared control: nothing to store. */
+function isCleared(value) {
+    return value === undefined || value === null || value === '';
+}
+/**
+ * The PATCH of the app's own fields: every touched field whose value differs
+ * from the stored one, `null` for a cleared one.
+ */
+function extraPatchOf(stored, draft) {
+    const patch = {};
+    for (const [name, value] of Object.entries(draft)) {
+        const before = stored[name];
+        if (isCleared(value)) {
+            if (!isCleared(before))
+                patch[name] = null;
+        }
+        else if (JSON.stringify(value) !== JSON.stringify(before)) {
+            patch[name] = value;
+        }
+    }
+    return patch;
+}
+/**
+ * The profile card: display name, picture source (none, provider, upload),
+ * preview, upload and remove.
+ *
+ * @param props - see {@link ProfileSettingsProps}.
+ * @returns the card.
+ *
+ * @example
+ * ```tsx
+ * <ProfileSettings profile={settings.profile} onSave={(profile) => save({ profile }, msgs)} />
+ * ```
+ *
+ * @stability experimental
+ */
+export function ProfileSettings({ profile, onSave, onSettingsReplaced, disabled = false, slots, }) {
+    const ExtraFields = slots?.ExtraFields;
+    const { user, refreshUser } = useAuth();
+    const baseId = useId();
+    const profileImage = useProfileImageClient();
+    // `?? 'provider'` only guards a settings document from an older API that
+    // predates `imageSource`; the current contract always sends it.
+    const savedSource = profile.imageSource ?? 'provider';
+    const hasUpload = Boolean(profile.imageObjectId);
+    const [displayName, setDisplayName] = useState(profile.displayName || '');
+    // The app's own profile fields (`ExtraFields`): the stored ones, and the
+    // edits not saved yet (only the fields the user touched).
+    const storedExtras = useMemo(() => Object.fromEntries(Object.entries(profile).filter(([key]) => !CORE_PROFILE_KEYS.includes(key))), [profile]);
+    const storedExtrasKey = JSON.stringify(storedExtras);
+    const [extraDraft, setExtraDraft] = useState({});
+    const [imageSource, setImageSource] = useState(savedSource);
+    const [isSaving, setIsSaving] = useState(false);
+    const [isUploading, setIsUploading] = useState(false);
+    const [isRemoving, setIsRemoving] = useState(false);
+    const [confirmRemoveOpen, setConfirmRemoveOpen] = useState(false);
+    const [imageError, setImageError] = useState(null);
+    // An uploaded picture is a storage object. When storage is known not to be
+    // configured, a notice replaces the upload control that would fail; an
+    // unknown answer changes nothing.
+    const storage = useStorageStatus();
+    // Object URL for the uploaded picture's preview. The public avatar route only
+    // serves a picture while it is the SELECTED source, so the preview is loaded
+    // through the authenticated `GET /user-settings/profile-image` instead and
+    // rendered from a blob. The ref tracks the live URL so it can be revoked.
+    const [uploadPreviewUrl, setUploadPreviewUrl] = useState(null);
+    const uploadPreviewUrlRef = useRef(null);
+    // Bumped after an upload or removal to force a re-fetch of the preview.
+    const [uploadPreviewNonce, setUploadPreviewNonce] = useState(0);
+    const replaceUploadPreview = useCallback((next) => {
+        const previous = uploadPreviewUrlRef.current;
+        uploadPreviewUrlRef.current = next;
+        if (previous && previous !== next) {
+            URL.revokeObjectURL(previous);
+        }
+        setUploadPreviewUrl(next);
+    }, []);
+    useEffect(() => () => {
+        if (uploadPreviewUrlRef.current) {
+            URL.revokeObjectURL(uploadPreviewUrlRef.current);
+            uploadPreviewUrlRef.current = null;
+        }
+    }, []);
+    const hasUploadedImage = Boolean(user?.hasUploadedProfileImage);
+    useEffect(() => {
+        if (!hasUploadedImage) {
+            replaceUploadPreview(null);
+            return;
+        }
+        let cancelled = false;
+        profileImage
+            .preview()
+            .then((blob) => {
+            if (!cancelled)
+                replaceUploadPreview(URL.createObjectURL(blob));
+        })
+            .catch(() => {
+            // No stored picture (404) or a network failure: the option simply
+            // shows initials. Not worth an error banner.
+            if (!cancelled)
+                replaceUploadPreview(null);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [hasUploadedImage, uploadPreviewNonce, replaceUploadPreview, profileImage]);
+    // Sync each field from the stored document only when THAT field changes, so
+    // an upload (which replaces the document) does not discard a display name
+    // the user has typed but not saved yet.
+    useEffect(() => {
+        setDisplayName(profile.displayName || '');
+    }, [profile.displayName]);
+    useEffect(() => {
+        setImageSource(savedSource);
+    }, [savedSource]);
+    // A saved (or replaced) document supersedes the edits.
+    useEffect(() => {
+        setExtraDraft({});
+    }, [storedExtrasKey]);
+    const providerUrl = user?.providerProfileImageUrl ?? null;
+    const uploadedUrl = hasUpload ? uploadPreviewUrl : null;
+    const urlFor = (source) => {
+        if (source === 'provider')
+            return providerUrl;
+        if (source === 'upload')
+            return uploadedUrl;
+        return null;
+    };
+    // Choosing "Upload" before any picture exists is a UI state, not a saveable
+    // one: the API rejects `imageSource: 'upload'` without an upload, and the
+    // upload endpoint sets the source itself once it succeeds.
+    const awaitingUpload = imageSource === 'upload' && !hasUpload;
+    const effectiveSource = awaitingUpload ? savedSource : imageSource;
+    const extraPatch = extraPatchOf(storedExtras, extraDraft);
+    const hasChanges = displayName !== (profile.displayName || '') ||
+        effectiveSource !== savedSource ||
+        Object.keys(extraPatch).length > 0;
+    const isBusy = isSaving || isUploading || isRemoving;
+    const controlsDisabled = disabled || isBusy;
+    const initials = user?.displayName
+        ?.split(' ')
+        .filter(Boolean)
+        .map((n) => n[0])
+        .join('')
+        .toUpperCase()
+        .slice(0, 2) ||
+        user?.email?.[0]?.toUpperCase() ||
+        '?';
+    const options = [
+        {
+            value: 'none',
+            title: 'No picture',
+            description: 'Show your initials instead',
+            imageUrl: null,
+            disabled: false,
+        },
+        {
+            value: 'provider',
+            title: 'Picture from your sign-in provider',
+            description: providerUrl
+                ? 'Use the picture from the account you signed in with'
+                : "Your sign-in provider didn't supply a picture",
+            imageUrl: providerUrl,
+            disabled: !providerUrl,
+        },
+        {
+            value: 'upload',
+            title: 'Upload a picture',
+            description: hasUpload
+                ? 'Use the picture you uploaded'
+                : 'Choose an image from your device',
+            imageUrl: uploadedUrl,
+            disabled: false,
+        },
+    ];
+    const handleSave = async () => {
+        setIsSaving(true);
+        try {
+            const patch = { displayName: displayName || undefined, ...extraPatch };
+            if (effectiveSource !== savedSource) {
+                patch.imageSource = effectiveSource;
+            }
+            await onSave(patch);
+            // Refresh user to get the newly resolved profile picture and name
+            await refreshUser();
+        }
+        finally {
+            setIsSaving(false);
+        }
+    };
+    const refreshUserQuietly = async () => {
+        try {
+            await refreshUser();
+        }
+        catch {
+            // The picture change itself succeeded; a failed refresh only leaves the
+            // avatar stale until the next load.
+        }
+    };
+    const handleUploaded = async (result, file) => {
+        setImageError(null);
+        setImageSource(result.settings.profile.imageSource);
+        // Adopt the new settings (and `version`) before anything cosmetic can fail.
+        onSettingsReplaced?.(result.settings, 'Profile picture updated');
+        // Show the picked file straight away; the re-fetch below replaces it with
+        // what the server actually stored.
+        try {
+            replaceUploadPreview(URL.createObjectURL(file));
+        }
+        catch {
+            // Preview only; the re-fetch still runs.
+        }
+        await refreshUserQuietly();
+        setUploadPreviewNonce((n) => n + 1);
+    };
+    const handleRemoveUpload = async () => {
+        setConfirmRemoveOpen(false);
+        setIsRemoving(true);
+        setImageError(null);
+        try {
+            const result = await profileImage.remove();
+            replaceUploadPreview(null);
+            setImageSource(result.settings.profile.imageSource);
+            onSettingsReplaced?.(result.settings, 'Uploaded picture removed');
+            await refreshUserQuietly();
+            setUploadPreviewNonce((n) => n + 1);
+        }
+        catch (err) {
+            setImageError(isPlatformApiError(err) && err.message !== 'Request failed'
+                ? err.message
+                : 'Failed to remove the uploaded picture. Please try again.');
+        }
+        finally {
+            setIsRemoving(false);
+        }
+    };
+    const previewCaption = awaitingUpload
+        ? 'Upload a picture to use it. Nothing changes until the upload finishes.'
+        : effectiveSource !== savedSource
+            ? 'Save changes to start using this picture.'
+            : 'This is how you appear across the app.';
+    const labelId = `${baseId}-source-label`;
+    const removeTitleId = `${baseId}-remove-title`;
+    const removeDescId = `${baseId}-remove-desc`;
+    return (_jsxs(Card, { children: [_jsxs(CardContent, { children: [_jsx(Typography, { variant: "h6", gutterBottom: true, children: "Profile" }), _jsx(Typography, { variant: "body2", color: "text.secondary", sx: { mb: 2 }, children: "Customize how you appear to others" }), _jsxs(Stack, { spacing: 3, children: [_jsxs(Stack, { direction: { xs: 'column', sm: 'row' }, spacing: 2, sx: { alignItems: { xs: 'flex-start', sm: 'center' } }, children: [_jsx(Avatar, { src: urlFor(imageSource) ?? undefined, alt: `Profile picture preview for ${user?.displayName || user?.email || 'you'}`, sx: { width: 80, height: 80, fontSize: '1.75rem' }, children: initials }), _jsxs(Box, { children: [_jsx(Typography, { variant: "subtitle2", children: "Preview" }), _jsx(Typography, { variant: "body2", color: "text.secondary", "aria-live": "polite", children: previewCaption })] })] }), _jsxs(FormControl, { component: "fieldset", disabled: controlsDisabled, children: [_jsx(FormLabel, { component: "legend", id: labelId, children: "Profile picture" }), _jsx(RadioGroup, { "aria-labelledby": labelId, name: "profile-image-source", value: imageSource, onChange: (e) => {
+                                            setImageError(null);
+                                            setImageSource(e.target.value);
+                                        }, children: options.map((option) => {
+                                            const descriptionId = `${baseId}-source-${option.value}-desc`;
+                                            return (_jsx(FormControlLabel, { value: option.value, 
+                                                // MUI's FormControlLabel prefers its own `disabled` over
+                                                // the fieldset's, so a literal `false` here would re-enable
+                                                // the option while the page is disabled or busy.
+                                                disabled: controlsDisabled || option.disabled, sx: { mr: 0, my: 0.5, alignItems: 'center' }, control: _jsx(Radio, { slotProps: { input: { 'aria-describedby': descriptionId } } }), label: _jsxs(Stack, { direction: "row", spacing: 1.5, sx: { alignItems: 'center' }, children: [_jsx(Avatar, { src: option.imageUrl ?? undefined, alt: "", "aria-hidden": true, sx: { width: 40, height: 40, fontSize: '1rem', flexShrink: 0 }, children: initials }), _jsxs(Box, { sx: { minWidth: 0 }, children: [_jsx(Typography, { variant: "body1", children: option.title }), _jsx(Typography, { id: descriptionId, variant: "body2", color: "text.secondary", children: option.description })] })] }) }, option.value));
+                                        }) }), awaitingUpload && (_jsx(FormHelperText, { children: "Your current picture stays in place until an upload succeeds." }))] }), (imageSource === 'upload' || hasUpload) && (_jsxs(Stack, { spacing: 1.5, sx: { pl: { xs: 0, sm: 5 } }, children: [imageSource === 'upload' && storage.configured === false && (_jsx(FeatureUnavailableNotice, { feature: "storage", detail: "You can still use the picture from your sign-in provider, or none." })), imageSource === 'upload' && storage.configured !== false && (_jsx(ImageUpload, { onUploaded: handleUploaded, onUploadingChange: setIsUploading, disabled: disabled || isSaving || isRemoving, label: hasUpload ? 'Replace picture' : 'Upload picture' })), hasUpload && (_jsx(Box, { children: _jsx(Button, { variant: "text", color: "error", size: "small", startIcon: _jsx(DeleteIcon, {}), onClick: () => setConfirmRemoveOpen(true), disabled: controlsDisabled, children: isRemoving ? 'Removing...' : 'Remove uploaded picture' }) }))] })), imageError && (_jsx(Alert, { severity: "error", onClose: () => setImageError(null), children: imageError })), _jsx(TextField, { label: "Display Name", value: displayName, onChange: (e) => setDisplayName(e.target.value), placeholder: user?.email?.split('@')[0], helperText: "Leave empty to use your Google name", disabled: disabled, fullWidth: true }), ExtraFields && (_jsx(ExtraFields, { profile: profile, values: { ...storedExtras, ...extraDraft }, onChange: (name, value) => setExtraDraft((draft) => ({ ...draft, [name]: value })), disabled: controlsDisabled })), _jsx(TextField, { label: "Email", value: user?.email || '', disabled: true, fullWidth: true, helperText: "Email cannot be changed" }), _jsx(Box, { sx: { display: 'flex', justifyContent: 'flex-end' }, children: _jsx(Button, { variant: "contained", onClick: handleSave, disabled: disabled || !hasChanges || isBusy, children: isSaving ? 'Saving...' : 'Save Changes' }) })] })] }), _jsxs(Dialog, { open: confirmRemoveOpen, onClose: () => setConfirmRemoveOpen(false), "aria-labelledby": removeTitleId, "aria-describedby": removeDescId, children: [_jsx(DialogTitle, { id: removeTitleId, children: "Remove uploaded picture?" }), _jsx(DialogContent, { children: _jsxs(DialogContentText, { id: removeDescId, children: ["The picture you uploaded will be deleted.", savedSource === 'upload' &&
+                                    " Your profile will switch to your sign-in provider's picture."] }) }), _jsxs(DialogActions, { children: [_jsx(Button, { onClick: () => setConfirmRemoveOpen(false), children: "Cancel" }), _jsx(Button, { color: "error", onClick: handleRemoveUpload, children: "Remove" })] })] })] }));
+}
+//# sourceMappingURL=ProfileSettings.js.map

package/dist/settings/ui/ProfileSettings.js.map

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

package/dist/settings/ui/SettingsHub.d.ts

@@ -0,0 +1,97 @@
+/**
+ * The settings hub — ONE component, every settings surface.
+ *
+ * Issue #93, epic #90; moved into `@marinoscar/platform-web/settings/ui` by
+ * #733 WITHOUT behavioural change. A searchable, grouped view of a settings
+ * registry that renders as a card grid from `sm` up and as an iOS-style
+ * drill-down list below it.
+ *
+ * WHY IT TAKES PROPS. The admin hub (`/admin/settings`) and the per-user hub
+ * (`/settings`) are the same page with a different array, and a second hub
+ * COPIED from the first is precisely the failure epic #90 was filed to
+ * remove. Everything surface-specific arrives through `SettingsHubProps`.
+ * Nothing in this file names "admin", and nothing in it may.
+ */
+import type { ReactElement } from 'react';
+import type { SettingsFeatures } from '../headless/features.js';
+import type { SettingsSectionDef } from './registry.js';
+/**
+ * The props of {@link SettingsHub}: the registry, the surface's key, title and
+ * subtitle, the feature map, and the two app seams (the permission check and
+ * the scroll restoration).
+ *
+ * @stability stable
+ */
+export interface SettingsHubProps {
+    /**
+     * The registry to draw — `ADMIN_SECTIONS` (#93) or `USER_SETTINGS_SECTIONS`
+     * (#96). Passed UNFILTERED: the permission and search gates both live in
+     * `visibleSettingsSections`, so a caller cannot accidentally apply its own.
+     */
+    sections: SettingsSectionDef[];
+    /**
+     * Stable scroll-restoration key for this surface, e.g.
+     * `'admin-settings-hub'`. Namespaced per surface so the admin hub and the
+     * user hub never restore each other's offset — they are different documents
+     * of different heights, and sharing a key would land the user in an
+     * arbitrary place on whichever one they opened second.
+     */
+    hubKey: string;
+    /**
+     * The `h4`. Comes from the registry's own hub constant (`ADMIN_HUB_TITLE` /
+     * `USER_HUB_TITLE`) rather than defaulting to `'Settings'` here: the AppBar's
+     * title resolver (#95) falls back to those same constants, and a default
+     * baked into this component would be a second place that decides what a hub
+     * is called — the exact duplication the registry removes.
+     */
+    title: string;
+    /** The `body1` secondary line under the title. Surface-specific prose. */
+    subtitle: string;
+    /**
+     * Which deployment features are on (#425) — checked against each card's
+     * `feature`. Optional and passed straight through to
+     * `visibleSettingsSections`; omitted, every feature-gated card stays hidden.
+     * The hub holds no opinion of its own about what is on: the page binding
+     * reads `useAiConfig` and hands the answer down.
+     */
+    features?: SettingsFeatures;
+    /**
+     * The viewer's permission check (the exact strings the API enforces).
+     * Default: the `PlatformHostProvider` viewer's; without a host, every
+     * permission-gated card is hidden (fail closed).
+     */
+    hasPermission?: (permission: string) => boolean;
+    /**
+     * A hook that saves and restores the hub's scroll offset under `hubKey`
+     * across a drill-down and back (the reference app passes its
+     * `useScrollRestoration`). Must be the same function on every render.
+     * Default: no restoration.
+     */
+    useScrollRestoration?: (key: string) => void;
+}
+/**
+ * The settings hub: ONE component, every settings surface (the admin Console
+ * at `/admin/settings`, the per-user hub at `/settings`). A searchable,
+ * grouped view of a section registry: a card grid from `sm` up, an iOS-style
+ * drill-down list below it. Nothing in it names a surface; each surface is a
+ * thin binding (`sections`, `hubKey`, `title`, `subtitle`, `features`).
+ *
+ * ⚠ BREAKPOINT GATE 4 OF FIVE: `isCompactWindow` is `down('sm')`, coupled
+ * with the app's `Layout` rail gate, its `BottomNav` self-gate, its `<main>`
+ * bottom padding and its AppBar's compact gate (docs/specs/settings-ui.md,
+ * "Breakpoint gates"). The five move together or not at all.
+ *
+ * @param props - see {@link SettingsHubProps}.
+ * @returns the hub.
+ *
+ * @example
+ * ```tsx
+ * <SettingsHub sections={ADMIN_SECTIONS} hubKey="admin-settings-hub" title="Settings"
+ *   subtitle="…" features={useSettingsFeatures()} useScrollRestoration={useScrollRestoration} />
+ * ```
+ *
+ * @extensionPoint component
+ * @stability stable
+ */
+export declare function SettingsHub({ sections, hubKey, title, subtitle, features, hasPermission: hasPermissionProp, useScrollRestoration, }: SettingsHubProps): ReactElement;
+//# sourceMappingURL=SettingsHub.d.ts.map

package/dist/settings/ui/SettingsHub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SettingsHub.d.ts","sourceRoot":"","sources":["../../../src/settings/ui/SettingsHub.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAyBH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAQxD;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;IAChD;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,WAAW,CAAC,EAC1B,QAAQ,EACR,MAAM,EACN,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,aAAa,EAAE,iBAAiB,EAChC,oBAA0C,GAC3C,EAAE,gBAAgB,GAAG,YAAY,CAoOjC"}