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

package/dist/settings/headless/features.js

@@ -0,0 +1,94 @@
+// =============================================================================
+// The deployment feature map the settings registries read (issue #733)
+// =============================================================================
+//
+// A settings card may carry `feature: 'ai'`: it exists only while that
+// deployment feature is on. The set of feature keys is OPEN (rung 2, module
+// augmentation): the platform declares `ai` and `telemetry`, an app adds its
+// own by augmenting `SettingsFeatureRegistry` and registering how to read it
+// (`registerSettingsFeature(key, useIsOn)`). `useSettingsFeatures()` asks every
+// registered resolver, in registration order, so every navigation surface
+// (the hubs, the rail, the AppBar title resolver) reads the SAME map.
+//
+// The resolvers are React hooks (they read the app's context), so the set is
+// FIXED once the first `useSettingsFeatures()` render ran: a later
+// registration would change the hook order mid-session. Register at module
+// scope, before the first render.
+// =============================================================================
+import { useMemo } from 'react';
+/**
+ * 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 function isFeatureEnabled(feature, features = {}) {
+    return feature === undefined || features[feature] === true;
+}
+const resolvers = new Map();
+let sealed = false;
+/**
+ * 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 function registerSettingsFeature(key, useIsOn) {
+    if (sealed && !resolvers.has(key)) {
+        throw new Error(`registerSettingsFeature("${key}"): the feature set is fixed once useSettingsFeatures() rendered; register at module scope.`);
+    }
+    resolvers.set(key, useIsOn);
+}
+/**
+ * The registered feature keys, in registration order.
+ *
+ * @returns the keys.
+ *
+ * @stability experimental
+ */
+export function registeredSettingsFeatures() {
+    return [...resolvers.keys()];
+}
+/**
+ * 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 function useSettingsFeatures() {
+    sealed = true;
+    const entries = [];
+    for (const [key, useIsOn] of resolvers)
+        entries.push([key, useIsOn()]);
+    const signature = entries.map(([key, on]) => `${key}:${on ? 1 : 0}`).join(',');
+    return useMemo(() => Object.fromEntries(entries), [signature]);
+}
+/**
+ * Clears the feature registry (tests only).
+ *
+ * @internal
+ */
+export function resetSettingsFeaturesForTests() {
+    resolvers.clear();
+    sealed = false;
+}
+//# sourceMappingURL=features.js.map

package/dist/settings/headless/features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.js","sourceRoot":"","sources":["../../../src/settings/headless/features.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,uEAAuE;AACvE,gFAAgF;AAChF,EAAE;AACF,uEAAuE;AACvE,4EAA4E;AAC5E,6EAA6E;AAC7E,6EAA6E;AAC7E,gFAAgF;AAChF,0EAA0E;AAC1E,sEAAsE;AACtE,EAAE;AACF,6EAA6E;AAC7E,mEAAmE;AACnE,2EAA2E;AAC3E,kCAAkC;AAClC,gFAAgF;AAEhF,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAoBhC;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAuC,EAAE,WAA6B,EAAE;IACvG,OAAO,OAAO,KAAK,SAAS,IAAI,QAAQ,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;AAC7D,CAAC;AASD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAmC,CAAC;AAC7D,IAAI,MAAM,GAAG,KAAK,CAAC;AAEnB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAuB,EAAE,OAAgC;IAC/F,IAAI,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACb,4BAA4B,GAAG,6FAA6F,CAC7H,CAAC;IACJ,CAAC;IACD,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B;IACxC,OAAO,CAAC,GAAG,SAAS,CAAC,IAAI,EAAE,CAAyB,CAAC;AACvD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,GAAG,IAAI,CAAC;IACd,MAAM,OAAO,GAA6B,EAAE,CAAC;IAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/E,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAqB,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;AACrF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,6BAA6B;IAC3C,SAAS,CAAC,KAAK,EAAE,CAAC;IAClB,MAAM,GAAG,KAAK,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,39 @@
+export { isFeatureEnabled, registerSettingsFeature, registeredSettingsFeatures, useSettingsFeatures, } from './features.js';
+export type { SettingsFeatureKey, SettingsFeatureResolver, SettingsFeatures } from './features.js';
+export { useSystemSettings } from './use-system-settings.js';
+export type { SettingsHookOptions, UseSystemSettingsResult, VersionedSettingsDocument } from './use-system-settings.js';
+export { useUserSettings } from './use-user-settings.js';
+export type { UseUserSettingsOptions, UseUserSettingsResult, UserSettingsDocument, UserSettingsUpdateBase, } from './use-user-settings.js';
+export { createProfileImageClient, useProfileImageClient } from './profile-image.js';
+export type { ProfileImageClient, ProfileImageMutationResponse } from './profile-image.js';
+export { useStorageStatus } from './use-storage-status.js';
+export type { UseStorageStatusResult } from './use-storage-status.js';
+export { usePluggableConfigForm } from './use-pluggable-config-form.js';
+export type { PluggableConfigPayload, PluggableSettingsValue, UsePluggableConfigFormResult, } from './use-pluggable-config-form.js';
+export { useOrgSettings } from './use-org-settings.js';
+export { orgSettingsFieldRenderer, registerOrgSettingsFieldRenderer } from './org-field-renderers.js';
+export type { OrgSettingsFieldRendererProps } from './org-field-renderers.js';
+export { themePreferenceOptions, useThemePreferenceOptions } from './theme-options.js';
+export type { UseOrgSettingsResult } from './use-org-settings.js';
+/**
+ * The known deployment feature keys, as an augmentation target. The platform
+ * declares `ai` and `telemetry`; an app adds a key with module augmentation
+ * and registers its resolver with {@link registerSettingsFeature}.
+ *
+ * @example
+ * ```ts
+ * declare module '@marinoscar/platform-web/settings/headless' {
+ *   interface SettingsFeatureRegistry { orgs: true }
+ * }
+ * registerSettingsFeature('orgs', useOrgsFeature);
+ * ```
+ *
+ * @stability experimental
+ */
+export interface SettingsFeatureRegistry {
+    /** AI is switched on for this deployment. */
+    ai: true;
+    /** A telemetry store is deployed and collection is on. */
+    telemetry: true;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/settings/headless/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACnG,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,YAAY,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACxH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACrF,YAAY,EAAE,kBAAkB,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,YAAY,EACV,sBAAsB,EACtB,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,gCAAgC,EAAE,MAAM,0BAA0B,CAAC;AACtG,YAAY,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AACvF,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAIlE;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,uBAAuB;IACtC,6CAA6C;IAC7C,EAAE,EAAE,IAAI,CAAC;IACT,0DAA0D;IAC1D,SAAS,EAAE,IAAI,CAAC;CACjB"}

package/dist/settings/headless/index.js

@@ -0,0 +1,12 @@
+// `@marinoscar/platform-web/settings/headless`: the settings slice's hooks and
+// its open feature registry (issue #733, PP-8.1). Documented in ../README.md.
+export { isFeatureEnabled, registerSettingsFeature, registeredSettingsFeatures, useSettingsFeatures, } from './features.js';
+export { useSystemSettings } from './use-system-settings.js';
+export { useUserSettings } from './use-user-settings.js';
+export { createProfileImageClient, useProfileImageClient } from './profile-image.js';
+export { useStorageStatus } from './use-storage-status.js';
+export { usePluggableConfigForm } from './use-pluggable-config-form.js';
+export { useOrgSettings } from './use-org-settings.js';
+export { orgSettingsFieldRenderer, registerOrgSettingsFieldRenderer } from './org-field-renderers.js';
+export { themePreferenceOptions, useThemePreferenceOptions } from './theme-options.js';
+//# sourceMappingURL=index.js.map

package/dist/settings/headless/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/settings/headless/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,8EAA8E;AAE9E,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAOzD,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAErF,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAMxE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,gCAAgC,EAAE,MAAM,0BAA0B,CAAC;AAEtG,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/settings/headless/org-field-renderers.d.ts

@@ -0,0 +1,57 @@
+import type { OrgSettingsField } from '@marinoscar/platform-contract/settings';
+import type { ComponentType } from 'react';
+/**
+ * What a registered org field renderer receives.
+ *
+ * @stability experimental
+ */
+export interface OrgSettingsFieldRendererProps {
+    /** The namespace key (`telemetry`). */
+    namespace: string;
+    /** The field's descriptor from `GET /api/org-settings` (its `name`, `kind: 'other'`). */
+    field: OrgSettingsField;
+    /**
+     * The organization's value: the draft being edited, else the stored one,
+     * else `undefined` (the organization inherits the deployment's).
+     */
+    value: unknown;
+    /** The effective value: what applies when the organization stores none. */
+    inherited: unknown;
+    /** Whether the control must be read-only (no write permission, or a read-only namespace, or a save in flight). */
+    disabled: boolean;
+    /** Reports a new value for the field; `null` removes the override (the deployment's value applies again). */
+    onChange: (next: unknown) => void;
+}
+/**
+ * Registers how the organization settings page draws one `other` field of one
+ * namespace. Call at module scope, before the page renders. Registering the
+ * same field again replaces its renderer in place (a hot module reload re-runs
+ * the registering module).
+ *
+ * @param namespace - the namespace key the API describes.
+ * @param field - the field name inside it (for a nested org field, the path root: `query`).
+ * @param Component - the control; see {@link OrgSettingsFieldRendererProps}.
+ * @returns a function that removes the registration (for a test).
+ *
+ * @example
+ * ```ts
+ * registerOrgSettingsFieldRenderer('telemetry', 'query', ({ value, onChange, disabled }) => (
+ *   <SlowQueryField value={value} onChange={onChange} disabled={disabled} />
+ * ));
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare function registerOrgSettingsFieldRenderer(namespace: string, field: string, Component: ComponentType<OrgSettingsFieldRendererProps>): () => void;
+/**
+ * The renderer registered for a field, if any.
+ *
+ * @param namespace - the namespace key.
+ * @param field - the field name.
+ * @returns the component, or `undefined` (the page shows its note).
+ *
+ * @stability experimental
+ */
+export declare function orgSettingsFieldRenderer(namespace: string, field: string): ComponentType<OrgSettingsFieldRendererProps> | undefined;
+//# sourceMappingURL=org-field-renderers.d.ts.map

package/dist/settings/headless/org-field-renderers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"org-field-renderers.d.ts","sourceRoot":"","sources":["../../../src/settings/headless/org-field-renderers.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC5C,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,KAAK,EAAE,gBAAgB,CAAC;IACxB;;;OAGG;IACH,KAAK,EAAE,OAAO,CAAC;IACf,2EAA2E;IAC3E,SAAS,EAAE,OAAO,CAAC;IACnB,kHAAkH;IAClH,QAAQ,EAAE,OAAO,CAAC;IAClB,6GAA6G;IAC7G,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACnC;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gCAAgC,CAC9C,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,aAAa,CAAC,6BAA6B,CAAC,GACtD,MAAM,IAAI,CAMZ;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,aAAa,CAAC,6BAA6B,CAAC,GAAG,SAAS,CAE1D"}

package/dist/settings/headless/org-field-renderers.js

@@ -0,0 +1,59 @@
+// =============================================================================
+// Org settings field renderers: the `other` kind, drawn by the app (PP-14.21)
+// =============================================================================
+//
+// `GET /api/org-settings` describes each field of an org-overridable namespace
+// as a boolean, enum, number or string (the page draws a control) or `other`
+// (an object, a record: the page cannot edit it generically and says it is
+// managed elsewhere). An app that adds such a field to an org layer, with an
+// extension at a nested path for example, draws it itself:
+//
+//   registerOrgSettingsFieldRenderer('telemetry', 'query', SlowQueryControl);
+//
+// The renderer replaces the page's note for that one field; every other field
+// keeps the generated control. With none registered the page is unchanged.
+// =============================================================================
+const renderers = new Map();
+const keyOf = (namespace, field) => `${namespace}\u0000${field}`;
+/**
+ * Registers how the organization settings page draws one `other` field of one
+ * namespace. Call at module scope, before the page renders. Registering the
+ * same field again replaces its renderer in place (a hot module reload re-runs
+ * the registering module).
+ *
+ * @param namespace - the namespace key the API describes.
+ * @param field - the field name inside it (for a nested org field, the path root: `query`).
+ * @param Component - the control; see {@link OrgSettingsFieldRendererProps}.
+ * @returns a function that removes the registration (for a test).
+ *
+ * @example
+ * ```ts
+ * registerOrgSettingsFieldRenderer('telemetry', 'query', ({ value, onChange, disabled }) => (
+ *   <SlowQueryField value={value} onChange={onChange} disabled={disabled} />
+ * ));
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export function registerOrgSettingsFieldRenderer(namespace, field, Component) {
+    const key = keyOf(namespace, field);
+    renderers.set(key, Component);
+    return () => {
+        if (renderers.get(key) === Component)
+            renderers.delete(key);
+    };
+}
+/**
+ * The renderer registered for a field, if any.
+ *
+ * @param namespace - the namespace key.
+ * @param field - the field name.
+ * @returns the component, or `undefined` (the page shows its note).
+ *
+ * @stability experimental
+ */
+export function orgSettingsFieldRenderer(namespace, field) {
+    return renderers.get(keyOf(namespace, field));
+}
+//# sourceMappingURL=org-field-renderers.js.map

package/dist/settings/headless/org-field-renderers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"org-field-renderers.js","sourceRoot":"","sources":["../../../src/settings/headless/org-field-renderers.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,8EAA8E;AAC9E,gFAAgF;AAChF,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAC7E,2EAA2E;AAC3E,6EAA6E;AAC7E,2DAA2D;AAC3D,EAAE;AACF,8EAA8E;AAC9E,EAAE;AACF,8EAA8E;AAC9E,2EAA2E;AAC3E,gFAAgF;AA4BhF,MAAM,SAAS,GAAG,IAAI,GAAG,EAAwD,CAAC;AAElF,MAAM,KAAK,GAAG,CAAC,SAAiB,EAAE,KAAa,EAAU,EAAE,CAAC,GAAG,SAAS,SAAS,KAAK,EAAE,CAAC;AAEzF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,gCAAgC,CAC9C,SAAiB,EACjB,KAAa,EACb,SAAuD;IAEvD,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACpC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC9B,OAAO,GAAG,EAAE;QACV,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9D,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CACtC,SAAiB,EACjB,KAAa;IAEb,OAAO,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;AAChD,CAAC"}

package/dist/settings/headless/profile-image.d.ts

@@ -0,0 +1,62 @@
+import type { UserSettingsResponseBase } from '@marinoscar/platform-contract/settings';
+import type { PlatformApiClient } from '../../core/index.js';
+/**
+ * What the upload and delete endpoints answer: the new settings document and
+ * the resolved picture. The caller MUST adopt `settings` (its `version` moved)
+ * or its next `If-Match` PATCH answers 409.
+ *
+ * @typeParam T - the app's user settings document type.
+ *
+ * @stability experimental
+ */
+export interface ProfileImageMutationResponse<T = UserSettingsResponseBase> {
+    /** The settings document after the change. */
+    settings: T;
+    /** The resolved picture (same meaning as the user's `profileImageUrl`). */
+    profileImageUrl: string | null;
+}
+/**
+ * The profile picture calls.
+ *
+ * @stability experimental
+ */
+export interface ProfileImageClient {
+    /**
+     * `POST /user-settings/profile-image`: one multipart `file` part. The server
+     * switches `profile.imageSource` to `upload` and deletes any previous upload.
+     * Rejects when the transport has no `postFormData`.
+     */
+    upload(file: File): Promise<ProfileImageMutationResponse>;
+    /** `DELETE /user-settings/profile-image`: an `upload` source falls back to `provider` server-side. */
+    remove(): Promise<ProfileImageMutationResponse>;
+    /**
+     * `GET /user-settings/profile-image`: the stored picture, whatever
+     * `profile.imageSource` selects (authenticated on purpose: the public avatar
+     * route serves only the selected source). Rejects with a 404 when none
+     * exists, or when the transport has no `getBlob`.
+     */
+    preview(): Promise<Blob>;
+}
+/**
+ * Builds the profile picture client over a transport.
+ *
+ * @param api - the app's transport (the host's `api`).
+ * @returns the client.
+ *
+ * @example
+ * ```ts
+ * const { settings } = await createProfileImageClient(api).upload(file);
+ * ```
+ *
+ * @stability experimental
+ */
+export declare function createProfileImageClient(api: PlatformApiClient): ProfileImageClient;
+/**
+ * {@link createProfileImageClient} over the platform host's transport.
+ *
+ * @returns a client whose identity is stable while the host's `api` is.
+ *
+ * @stability experimental
+ */
+export declare function useProfileImageClient(): ProfileImageClient;
+//# sourceMappingURL=profile-image.d.ts.map

package/dist/settings/headless/profile-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-image.d.ts","sourceRoot":"","sources":["../../../src/settings/headless/profile-image.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAIvF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;;;;;;GAQG;AACH,MAAM,WAAW,4BAA4B,CAAC,CAAC,GAAG,wBAAwB;IACxE,8CAA8C;IAC9C,QAAQ,EAAE,CAAC,CAAC;IACZ,2EAA2E;IAC3E,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAC1D,sGAAsG;IACtG,MAAM,IAAI,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAChD;;;;;OAKG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,iBAAiB,GAAG,kBAAkB,CAkBnF;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,IAAI,kBAAkB,CAG1D"}

package/dist/settings/headless/profile-image.js

@@ -0,0 +1,51 @@
+// The caller's own profile picture (`/user-settings/profile-image`, issue
+// #367), over the platform host's transport. Moved from the reference app's
+// `services/api.ts` (#892), behaviour unchanged: the server validates the
+// bytes (JPEG, PNG, GIF, WebP, 5 MB) and answers 400 or 413 with a message.
+import { useMemo } from 'react';
+import { usePlatformApi } from '../../core/index.js';
+const PROFILE_IMAGE = '/user-settings/profile-image';
+/**
+ * Builds the profile picture client over a transport.
+ *
+ * @param api - the app's transport (the host's `api`).
+ * @returns the client.
+ *
+ * @example
+ * ```ts
+ * const { settings } = await createProfileImageClient(api).upload(file);
+ * ```
+ *
+ * @stability experimental
+ */
+export function createProfileImageClient(api) {
+    return {
+        upload: async (file) => {
+            if (typeof api.postFormData !== 'function') {
+                throw new Error('This transport cannot send multipart/form-data: pass a client with postFormData.');
+            }
+            const formData = new FormData();
+            formData.append('file', file);
+            return api.postFormData(PROFILE_IMAGE, formData);
+        },
+        remove: () => api.delete(PROFILE_IMAGE),
+        preview: async () => {
+            if (typeof api.getBlob !== 'function') {
+                throw new Error('This transport cannot download files: pass a client with getBlob.');
+            }
+            return (await api.getBlob(PROFILE_IMAGE)).blob;
+        },
+    };
+}
+/**
+ * {@link createProfileImageClient} over the platform host's transport.
+ *
+ * @returns a client whose identity is stable while the host's `api` is.
+ *
+ * @stability experimental
+ */
+export function useProfileImageClient() {
+    const api = usePlatformApi();
+    return useMemo(() => createProfileImageClient(api), [api]);
+}
+//# sourceMappingURL=profile-image.js.map

package/dist/settings/headless/profile-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-image.js","sourceRoot":"","sources":["../../../src/settings/headless/profile-image.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,4EAA4E;AAC5E,0EAA0E;AAC1E,4EAA4E;AAG5E,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AA0CrD,MAAM,aAAa,GAAG,8BAA8B,CAAC;AAErD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAsB;IAC7D,OAAO;QACL,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACrB,IAAI,OAAO,GAAG,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;gBAC3C,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAC;YACtG,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;YAChC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC9B,OAAO,GAAG,CAAC,YAAY,CAA+B,aAAa,EAAE,QAAQ,CAAC,CAAC;QACjF,CAAC;QACD,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAA+B,aAAa,CAAC;QACrE,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;gBACtC,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;YACvF,CAAC;YACD,OAAO,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC;QACjD,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,GAAG,GAAG,cAAc,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,wBAAwB,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7D,CAAC"}

package/dist/settings/headless/theme-options.d.ts

@@ -0,0 +1,33 @@
+import type { ThemeOption } from '@marinoscar/platform-contract/settings';
+/**
+ * The extra themes a user settings document lists.
+ *
+ * @param settings - the document, or `null` while it loads.
+ * @returns the registered themes, in registration order; the same empty array when there are none.
+ *
+ * @stability experimental
+ */
+export declare function themePreferenceOptions(settings: {
+    themeOptions?: readonly ThemeOption[];
+} | null | undefined): readonly ThemeOption[];
+/**
+ * {@link themePreferenceOptions} as a hook, for a component that holds the
+ * document in state. (A render-prop callback such as `UserSettingsSection`'s
+ * `children` is not a place to call a hook: use the function.)
+ *
+ * @param settings - the document, or `null` while it loads.
+ * @returns the registered themes.
+ *
+ * @example
+ * ```tsx
+ * const { settings } = useUserSettings();
+ * <ThemeSettings currentTheme={settings.theme} onThemeChange={save} extraOptions={useThemePreferenceOptions(settings)} />
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export declare function useThemePreferenceOptions(settings: {
+    themeOptions?: readonly ThemeOption[];
+} | null | undefined): readonly ThemeOption[];
+//# sourceMappingURL=theme-options.d.ts.map

package/dist/settings/headless/theme-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-options.d.ts","sourceRoot":"","sources":["../../../src/settings/headless/theme-options.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAK1E;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE;IAAE,YAAY,CAAC,EAAE,SAAS,WAAW,EAAE,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,WAAW,EAAE,CAGrI;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE;IAAE,YAAY,CAAC,EAAE,SAAS,WAAW,EAAE,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,WAAW,EAAE,CAGxI"}

package/dist/settings/headless/theme-options.js

@@ -0,0 +1,47 @@
+// =============================================================================
+// The themes an app registered, as the settings document lists them (PP-14.21)
+// =============================================================================
+//
+// `registerThemePreference` of `@marinoscar/platform-api/settings` adds a theme
+// id the API accepts, and `GET /api/user-settings` lists the registered ones in
+// `themeOptions` (absent when there are none). The theme control offers them
+// after light, dark and system. How a registered theme LOOKS, and how the app
+// applies the stored id, is the app's theme registry; this is only the list of
+// choices.
+// =============================================================================
+import { useMemo } from 'react';
+const NONE = Object.freeze([]);
+/**
+ * The extra themes a user settings document lists.
+ *
+ * @param settings - the document, or `null` while it loads.
+ * @returns the registered themes, in registration order; the same empty array when there are none.
+ *
+ * @stability experimental
+ */
+export function themePreferenceOptions(settings) {
+    const options = settings?.themeOptions;
+    return options && options.length > 0 ? options : NONE;
+}
+/**
+ * {@link themePreferenceOptions} as a hook, for a component that holds the
+ * document in state. (A render-prop callback such as `UserSettingsSection`'s
+ * `children` is not a place to call a hook: use the function.)
+ *
+ * @param settings - the document, or `null` while it loads.
+ * @returns the registered themes.
+ *
+ * @example
+ * ```tsx
+ * const { settings } = useUserSettings();
+ * <ThemeSettings currentTheme={settings.theme} onThemeChange={save} extraOptions={useThemePreferenceOptions(settings)} />
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export function useThemePreferenceOptions(settings) {
+    const options = settings?.themeOptions;
+    return useMemo(() => themePreferenceOptions({ themeOptions: options }), [options]);
+}
+//# sourceMappingURL=theme-options.js.map

package/dist/settings/headless/theme-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-options.js","sourceRoot":"","sources":["../../../src/settings/headless/theme-options.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,+EAA+E;AAC/E,gFAAgF;AAChF,EAAE;AACF,gFAAgF;AAChF,gFAAgF;AAChF,6EAA6E;AAC7E,8EAA8E;AAC9E,+EAA+E;AAC/E,WAAW;AACX,gFAAgF;AAGhF,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,MAAM,IAAI,GAA2B,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEvD;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAsE;IAC3G,MAAM,OAAO,GAAG,QAAQ,EAAE,YAAY,CAAC;IACvC,OAAO,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AACxD,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAsE;IAC9G,MAAM,OAAO,GAAG,QAAQ,EAAE,YAAY,CAAC;IACvC,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,sBAAsB,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;AACrF,CAAC"}

package/dist/settings/headless/use-org-settings.d.ts

@@ -0,0 +1,41 @@
+import type { OrgSettingsResponse, PatchOrgSettingsBody } from '@marinoscar/platform-contract/settings';
+import { type SettingsHookOptions } from './use-system-settings.js';
+/**
+ * What {@link useOrgSettings} returns.
+ *
+ * @stability experimental
+ */
+export interface UseOrgSettingsResult {
+    /** The payload, or `null` until loaded. */
+    settings: OrgSettingsResponse | null;
+    /** Whether a load is in flight. */
+    isLoading: boolean;
+    /** The last error's message, or `null`. */
+    error: string | null;
+    /** Whether a save is in flight. */
+    isSaving: boolean;
+    /**
+     * `PATCH` with the loaded version as `If-Match`. `null` clears a namespace
+     * (or, inside one, a field). A 409 refetches and throws.
+     */
+    patch: (body: PatchOrgSettingsBody) => Promise<void>;
+    /** Reloads the payload. */
+    refresh: () => Promise<void>;
+}
+/**
+ * The active organization's settings overrides.
+ *
+ * @param options - see {@link SettingsHookOptions}.
+ * @returns the payload and its actions.
+ *
+ * @example
+ * ```ts
+ * const { settings, patch } = useOrgSettings();
+ * await patch({ exportPolicy: { enabled: false } });
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export declare function useOrgSettings(options?: SettingsHookOptions): UseOrgSettingsResult;
+//# sourceMappingURL=use-org-settings.d.ts.map

package/dist/settings/headless/use-org-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-org-settings.d.ts","sourceRoot":"","sources":["../../../src/settings/headless/use-org-settings.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAKxG,OAAO,EAAkB,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpF;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,2CAA2C;IAC3C,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACrC,mCAAmC;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,mCAAmC;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,KAAK,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,2BAA2B;IAC3B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,oBAAoB,CAsDlF"}

package/dist/settings/headless/use-org-settings.js

@@ -0,0 +1,84 @@
+// `GET` / `PATCH /org-settings` (issue #733): the active organization's
+// settings overrides, the effective value of each org-overridable namespace,
+// and the namespace descriptors a generated form renders. Same contract as
+// the other settings hooks; `org_settings:read` to load, `org_settings:write`
+// (and the namespace's own write permission) to save.
+import { useCallback, useEffect, useState } from 'react';
+import { isPlatformApiError } from '../../core/index.js';
+import { useIsMounted } from '../internal/use-is-mounted.js';
+import { useSettingsApi } from './use-system-settings.js';
+/**
+ * The active organization's settings overrides.
+ *
+ * @param options - see {@link SettingsHookOptions}.
+ * @returns the payload and its actions.
+ *
+ * @example
+ * ```ts
+ * const { settings, patch } = useOrgSettings();
+ * await patch({ exportPolicy: { enabled: false } });
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export function useOrgSettings(options) {
+    const api = useSettingsApi(options);
+    const [settings, setSettings] = useState(null);
+    const [isLoading, setIsLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const [isSaving, setIsSaving] = useState(false);
+    const isMounted = useIsMounted();
+    const fetchSettings = useCallback(async () => {
+        try {
+            setIsLoading(true);
+            setError(null);
+            const data = await api.get('/org-settings');
+            if (isMounted())
+                setSettings(data);
+        }
+        catch (err) {
+            if (isMounted()) {
+                if (isPlatformApiError(err) && err.status === 403) {
+                    setError('You do not have permission to view the organization settings');
+                }
+                else {
+                    setError(isPlatformApiError(err) ? err.message : 'Failed to load the organization settings');
+                }
+            }
+        }
+        finally {
+            if (isMounted())
+                setIsLoading(false);
+        }
+    }, [api, isMounted]);
+    useEffect(() => {
+        void fetchSettings();
+    }, [fetchSettings]);
+    const patch = useCallback(async (body) => {
+        if (!settings)
+            return;
+        try {
+            setIsSaving(true);
+            setError(null);
+            const data = await api.patch('/org-settings', body, { ifMatch: settings.version.toString() });
+            if (isMounted())
+                setSettings(data);
+        }
+        catch (err) {
+            if (isPlatformApiError(err) && err.status === 409) {
+                await fetchSettings();
+                throw new Error('The organization settings were updated elsewhere. Please review and try again.');
+            }
+            if (isMounted())
+                setError(isPlatformApiError(err) ? err.message : 'Failed to save the organization settings');
+            throw err;
+        }
+        finally {
+            if (isMounted())
+                setIsSaving(false);
+        }
+    }, [api, settings, fetchSettings, isMounted]);
+    return { settings, isLoading, error, isSaving, patch, refresh: fetchSettings };
+}
+//# sourceMappingURL=use-org-settings.js.map

package/dist/settings/headless/use-org-settings.js.map

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