@marinoscar/platform-web 0.1.0-next.6 → 0.1.0-next.8

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

@@ -1,4 +1,6 @@
 export { AuthContext, AuthProvider, useAuth, useOptionalAuth } from './auth-context.js';
+export { LocalIdentityProvider, createLocalAuthContextValue } from './local-identity.js';
+export type { LocalIdentityInput, LocalIdentityProviderProps } from './local-identity.js';
 export { useCurrentUserExtension, userExtension } from './user-extensions.js';
 export type { AuthProviderProps } from './auth-context.js';
 export type { AuthContextValue, AuthProviderInfo, AuthRole, AuthSessionClient, AuthUser, LoginOptions, OrgMembershipSummary, OrgSummary, } from './types.js';

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

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

package/dist/identity/headless/index.js

@@ -4,6 +4,7 @@
 // registry and the device-activation credential logic. Documented in
 // ../README.md. Explicit named exports only.
 export { AuthContext, AuthProvider, useAuth, useOptionalAuth } from './auth-context.js';
+export { LocalIdentityProvider, createLocalAuthContextValue } from './local-identity.js';
 export { useCurrentUserExtension, userExtension } from './user-extensions.js';
 export { usePermissions } from './use-permissions.js';
 export { RequireAuth, RequireMultiOrg, RequirePermission, useOrgsFeature } from './guards.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/identity/headless/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,2EAA2E;AAC3E,6EAA6E;AAC7E,qEAAqE;AACrE,6CAA6C;AAE7C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAY9E,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE9F,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACjG,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AA+BxD,OAAO,EAAE,2BAA2B,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAcpG,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAEhF,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAE9F,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/identity/headless/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,2EAA2E;AAC3E,6EAA6E;AAC7E,qEAAqE;AACrE,6CAA6C;AAE7C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAEzF,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAY9E,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE9F,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACjG,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AA+BxD,OAAO,EAAE,2BAA2B,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAcpG,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAEhF,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAE9F,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC"}

package/dist/identity/headless/local-identity.d.ts

@@ -0,0 +1,63 @@
+import type { ReactElement, ReactNode } from 'react';
+import type { AuthContextValue } from './types.js';
+/**
+ * The one local user a {@link LocalIdentityProvider} presents.
+ *
+ * @stability experimental
+ */
+export interface LocalIdentityInput {
+    /** The local user's id. */
+    userId: string;
+    /**
+     * The name the user menu shows.
+     *
+     * @defaultValue `'You'`
+     */
+    displayName?: string;
+    /** The email, or `null`/absent for none (shown as an empty string). */
+    email?: string | null;
+    /** The permissions the local user holds (the exact strings a destination or card names). */
+    permissions: readonly string[];
+    /** The role names the local user holds. */
+    roles?: readonly string[];
+}
+/**
+ * Builds the {@link AuthContextValue} of a local, always-signed-in user:
+ * `isAuthenticated` is `true`, there are no sign-in providers, `mode` is
+ * `'local'`, and `login`, `logout`, `refreshUser`, `switchOrg` and
+ * `setAccessToken` do nothing.
+ *
+ * @param input - see {@link LocalIdentityInput}.
+ * @returns the context value; give it a stable identity (memoize) when passing it to `AuthContext.Provider`.
+ *
+ * @stability experimental
+ */
+export declare function createLocalAuthContextValue(input: LocalIdentityInput): AuthContextValue;
+/**
+ * Props of {@link LocalIdentityProvider}: a {@link LocalIdentityInput} and the tree.
+ *
+ * @stability experimental
+ */
+export type LocalIdentityProviderProps = LocalIdentityInput & {
+    /** The tree. */
+    children: ReactNode;
+};
+/**
+ * Provides a local, always-signed-in user as the auth context. For a host with
+ * no API session; mount it where an `AuthProvider` would go.
+ *
+ * @param props - see {@link LocalIdentityProviderProps}.
+ * @returns the provider element.
+ *
+ * @example
+ * ```tsx
+ * <LocalIdentityProvider userId="local" permissions={['notes:read', 'notes:write']}>
+ *   <ShellLayout navigation={navigation} />
+ * </LocalIdentityProvider>
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export declare function LocalIdentityProvider({ children, userId, displayName, email, permissions, roles, }: LocalIdentityProviderProps): ReactElement;
+//# sourceMappingURL=local-identity.d.ts.map

package/dist/identity/headless/local-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-identity.d.ts","sourceRoot":"","sources":["../../../src/identity/headless/local-identity.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGrD,OAAO,KAAK,EAAE,gBAAgB,EAAY,MAAM,YAAY,CAAC;AAE7D;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,4FAA4F;IAC5F,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,2CAA2C;IAC3C,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAKD;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,kBAAkB,GAAG,gBAAgB,CA0BvF;AAED;;;;GAIG;AACH,MAAM,MAAM,0BAA0B,GAAG,kBAAkB,GAAG;IAC5D,gBAAgB;IAChB,QAAQ,EAAE,SAAS,CAAC;CACrB,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,QAAQ,EACR,MAAM,EACN,WAAW,EACX,KAAK,EACL,WAAW,EACX,KAAK,GACN,EAAE,0BAA0B,GAAG,YAAY,CAgB3C"}

package/dist/identity/headless/local-identity.js

@@ -0,0 +1,84 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// =============================================================================
+// Local identity (a host with no API session, e.g. a desktop shell)
+// =============================================================================
+//
+// A local host has one user, known at start-up, with a fixed permission set.
+// `LocalIdentityProvider` provides an `AuthContext` value for it
+// (`mode: 'local'`) so the shell's chrome (`usePermissions`, the user menu) works
+// unchanged. Nothing here calls the network; every session verb is a no-op.
+// =============================================================================
+import { useMemo } from 'react';
+import { AuthContext } from './auth-context.js';
+const noop = () => undefined;
+const resolved = () => Promise.resolve();
+/**
+ * Builds the {@link AuthContextValue} of a local, always-signed-in user:
+ * `isAuthenticated` is `true`, there are no sign-in providers, `mode` is
+ * `'local'`, and `login`, `logout`, `refreshUser`, `switchOrg` and
+ * `setAccessToken` do nothing.
+ *
+ * @param input - see {@link LocalIdentityInput}.
+ * @returns the context value; give it a stable identity (memoize) when passing it to `AuthContext.Provider`.
+ *
+ * @stability experimental
+ */
+export function createLocalAuthContextValue(input) {
+    const user = {
+        id: input.userId,
+        email: input.email ?? '',
+        displayName: input.displayName ?? 'You',
+        profileImageUrl: null,
+        roles: (input.roles ?? []).map((name) => ({ name })),
+        permissions: [...input.permissions],
+        isActive: true,
+        createdAt: new Date(0).toISOString(),
+    };
+    return {
+        user,
+        isLoading: false,
+        isAuthenticated: true,
+        providers: [],
+        sessionExpired: false,
+        login: noop,
+        logout: resolved,
+        refreshUser: resolved,
+        setAccessToken: noop,
+        activeOrg: null,
+        memberships: [],
+        switchOrg: resolved,
+        mode: 'local',
+    };
+}
+/**
+ * Provides a local, always-signed-in user as the auth context. For a host with
+ * no API session; mount it where an `AuthProvider` would go.
+ *
+ * @param props - see {@link LocalIdentityProviderProps}.
+ * @returns the provider element.
+ *
+ * @example
+ * ```tsx
+ * <LocalIdentityProvider userId="local" permissions={['notes:read', 'notes:write']}>
+ *   <ShellLayout navigation={navigation} />
+ * </LocalIdentityProvider>
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export function LocalIdentityProvider({ children, userId, displayName, email, permissions, roles, }) {
+    const permissionKey = permissions.join('\u0000');
+    const roleKey = (roles ?? []).join('\u0000');
+    const value = useMemo(() => createLocalAuthContextValue({
+        userId,
+        ...(displayName === undefined ? {} : { displayName }),
+        ...(email === undefined ? {} : { email }),
+        permissions,
+        ...(roles === undefined ? {} : { roles }),
+    }), 
+    // The arrays are compared by content so an inline literal does not rebuild the value every render.
+    [userId, displayName, email, permissionKey, roleKey]);
+    return _jsx(AuthContext.Provider, { value: value, children: children });
+}
+//# sourceMappingURL=local-identity.js.map

package/dist/identity/headless/local-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-identity.js","sourceRoot":"","sources":["../../../src/identity/headless/local-identity.tsx"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,oEAAoE;AACpE,gFAAgF;AAChF,EAAE;AACF,6EAA6E;AAC7E,iEAAiE;AACjE,kFAAkF;AAClF,4EAA4E;AAC5E,gFAAgF;AAEhF,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAGhC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAyBhD,MAAM,IAAI,GAAG,GAAS,EAAE,CAAC,SAAS,CAAC;AACnC,MAAM,QAAQ,GAAG,GAAkB,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;AAExD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,2BAA2B,CAAC,KAAyB;IACnE,MAAM,IAAI,GAAa;QACrB,EAAE,EAAE,KAAK,CAAC,MAAM;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE;QACxB,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,KAAK;QACvC,eAAe,EAAE,IAAI;QACrB,KAAK,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC;QACnC,QAAQ,EAAE,IAAI;QACd,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;KACrC,CAAC;IACF,OAAO;QACL,IAAI;QACJ,SAAS,EAAE,KAAK;QAChB,eAAe,EAAE,IAAI;QACrB,SAAS,EAAE,EAAE;QACb,cAAc,EAAE,KAAK;QACrB,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,QAAQ;QAChB,WAAW,EAAE,QAAQ;QACrB,cAAc,EAAE,IAAI;QACpB,SAAS,EAAE,IAAI;QACf,WAAW,EAAE,EAAE;QACf,SAAS,EAAE,QAAQ;QACnB,IAAI,EAAE,OAAO;KACd,CAAC;AACJ,CAAC;AAYD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,qBAAqB,CAAC,EACpC,QAAQ,EACR,MAAM,EACN,WAAW,EACX,KAAK,EACL,WAAW,EACX,KAAK,GACsB;IAC3B,MAAM,aAAa,GAAG,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CACH,2BAA2B,CAAC;QAC1B,MAAM;QACN,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;QACrD,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;QACzC,WAAW;QACX,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;KAC1C,CAAC;IACJ,mGAAmG;IACnG,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,CAAC,CACrD,CAAC;IACF,OAAO,KAAC,WAAW,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAwB,CAAC;AAC/E,CAAC"}

package/dist/identity/headless/types.d.ts

@@ -161,6 +161,13 @@ export interface AuthContextValue {
      * Rejects when the API refuses; the current session is then unchanged.
      */
     switchOrg: (orgId: string) => Promise<void>;
+    /**
+     * Where the identity comes from. Absent or `'server'`: an {@link AuthProvider}
+     * session against the API. `'local'`: a {@link LocalIdentityProvider}, a
+     * single local user with no API (a desktop host); the shell hides sign-out and
+     * the organization switcher by default and nothing here reaches the network.
+     */
+    mode?: 'server' | 'local';
 }
 /**
  * What {@link AuthProvider} drives sessions through: the access-token holder

package/dist/identity/headless/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/identity/headless/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/identity/headless/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAE/F;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,QAAQ;IACvB,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;;;OAIG;IACH,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,6EAA6E;IAC7E,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,yEAAyE;IACzE,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,4EAA4E;IAC5E,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,qCAAqC;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,8FAA8F;IAC9F,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,wDAAwD;IACxD,SAAS,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,8EAA8E;IAC9E,WAAW,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACrC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oFAAoF;IACpF,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IACtB,sDAAsD;IACtD,SAAS,EAAE,OAAO,CAAC;IACnB,4BAA4B;IAC5B,eAAe,EAAE,OAAO,CAAC;IACzB,4CAA4C;IAC5C,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B;;;;OAIG;IACH,cAAc,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;IAC1D,sFAAsF;IACtF,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,4DAA4D;IAC5D,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC;;;OAGG;IACH,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC/C,kEAAkE;IAClE,SAAS,EAAE,UAAU,GAAG,IAAI,CAAC;IAC7B,0FAA0F;IAC1F,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC;;;;;OAKG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C;;;;;OAKG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,4EAA4E;IAC5E,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACnE,8CAA8C;IAC9C,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAClD,qCAAqC;IACrC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC3C,iFAAiF;IACjF,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC,iFAAiF;IACjF,gBAAgB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CACpD"}

package/dist/identity/headless/use-permissions.d.ts

@@ -26,8 +26,13 @@ export interface UsePermissionsReturn {
 /**
  * The signed-in user's permissions and roles, as predicates.
  *
+ * The source, in order: the {@link AuthContext} (an `AuthProvider`, or the
+ * `LocalIdentityProvider` of a local host); else the `PlatformHostProvider`'s
+ * viewer (`hasPermission` only: the viewer port cannot list permissions or
+ * roles, so `permissions` and `roles` are empty and `isAdmin` is `false`).
+ *
  * @returns see {@link UsePermissionsReturn}.
- * @throws Error outside an `AuthProvider`.
+ * @throws Error when neither an `AuthProvider`/`LocalIdentityProvider` nor a `PlatformHostProvider` is mounted.
  *
  * @example
  * ```tsx

package/dist/identity/headless/use-permissions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-permissions.d.ts","sourceRoot":"","sources":["../../../src/identity/headless/use-permissions.ts"],"names":[],"mappings":"AAQA;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,+CAA+C;IAC/C,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnB,+EAA+E;IAC/E,aAAa,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;IAC/C,sDAAsD;IACtD,gBAAgB,EAAE,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;IAClD,mDAAmD;IACnD,iBAAiB,EAAE,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;IACnD,4CAA4C;IAC5C,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,uDAAuD;IACvD,UAAU,EAAE,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;IAC/C,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,IAAI,oBAAoB,CA4DrD"}
+{"version":3,"file":"use-permissions.d.ts","sourceRoot":"","sources":["../../../src/identity/headless/use-permissions.ts"],"names":[],"mappings":"AASA;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,+CAA+C;IAC/C,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnB,+EAA+E;IAC/E,aAAa,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;IAC/C,sDAAsD;IACtD,gBAAgB,EAAE,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;IAClD,mDAAmD;IACnD,iBAAiB,EAAE,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;IACnD,4CAA4C;IAC5C,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,uDAAuD;IACvD,UAAU,EAAE,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;IAC/C,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,IAAI,oBAAoB,CAyErD"}

package/dist/identity/headless/use-permissions.js

@@ -2,12 +2,18 @@
 // reference app's `hooks/usePermissions.ts`. These only decide what the UI
 // shows; the API enforces every permission.
 import { useCallback, useMemo } from 'react';
-import { useAuth } from './auth-context.js';
+import { useOptionalPlatformHost } from '../../core/index.js';
+import { useOptionalAuth } from './auth-context.js';
 /**
  * The signed-in user's permissions and roles, as predicates.
  *
+ * The source, in order: the {@link AuthContext} (an `AuthProvider`, or the
+ * `LocalIdentityProvider` of a local host); else the `PlatformHostProvider`'s
+ * viewer (`hasPermission` only: the viewer port cannot list permissions or
+ * roles, so `permissions` and `roles` are empty and `isAdmin` is `false`).
+ *
  * @returns see {@link UsePermissionsReturn}.
- * @throws Error outside an `AuthProvider`.
+ * @throws Error when neither an `AuthProvider`/`LocalIdentityProvider` nor a `PlatformHostProvider` is mounted.
  *
  * @example
  * ```tsx
@@ -19,22 +25,26 @@ import { useAuth } from './auth-context.js';
  * @stability stable
  */
 export function usePermissions() {
-    const { user } = useAuth();
+    const auth = useOptionalAuth();
+    const viewer = useOptionalPlatformHost()?.viewer ?? null;
+    const user = auth?.user;
     const permissions = useMemo(() => {
         return new Set(user?.permissions || []);
     }, [user?.permissions]);
     const roles = useMemo(() => {
         return new Set(user?.roles?.map((r) => r.name) || []);
     }, [user?.roles]);
+    // The viewer port answers one permission at a time; used only without an AuthContext.
+    const viewerCheck = auth === null ? viewer : null;
     const hasPermission = useCallback((permission) => {
-        return permissions.has(permission);
-    }, [permissions]);
+        return viewerCheck ? viewerCheck.hasPermission(permission) : permissions.has(permission);
+    }, [permissions, viewerCheck]);
     const hasAnyPermission = useCallback((...perms) => {
-        return perms.some((p) => permissions.has(p));
-    }, [permissions]);
+        return perms.some((p) => hasPermission(p));
+    }, [hasPermission]);
     const hasAllPermissions = useCallback((...perms) => {
-        return perms.every((p) => permissions.has(p));
-    }, [permissions]);
+        return perms.every((p) => hasPermission(p));
+    }, [hasPermission]);
     const hasRole = useCallback((role) => {
         return roles.has(role);
     }, [roles]);
@@ -44,6 +54,11 @@ export function usePermissions() {
     const isAdmin = useMemo(() => {
         return roles.has('admin');
     }, [roles]);
+    if (auth === null && viewer === null) {
+        throw new Error('usePermissions: no permission source. Mount an AuthProvider (or a LocalIdentityProvider for a local host) ' +
+            "from '@marinoscar/platform-web/identity/headless', or a PlatformHostProvider from '@marinoscar/platform-web/core' " +
+            '(its viewer answers hasPermission).');
+    }
     return {
         permissions,
         roles,

package/dist/identity/headless/use-permissions.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-permissions.js","sourceRoot":"","sources":["../../../src/identity/headless/use-permissions.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,2EAA2E;AAC3E,4CAA4C;AAE5C,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAE7C,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AA4B5C;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC;IAE3B,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE;QAC/B,OAAO,IAAI,GAAG,CAAC,IAAI,EAAE,WAAW,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;IAExB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE;QACzB,OAAO,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAElB,MAAM,aAAa,GAAG,WAAW,CAC/B,CAAC,UAAkB,EAAW,EAAE;QAC9B,OAAO,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC,EACD,CAAC,WAAW,CAAC,CACd,CAAC;IAEF,MAAM,gBAAgB,GAAG,WAAW,CAClC,CAAC,GAAG,KAAe,EAAW,EAAE;QAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC,EACD,CAAC,WAAW,CAAC,CACd,CAAC;IAEF,MAAM,iBAAiB,GAAG,WAAW,CACnC,CAAC,GAAG,KAAe,EAAW,EAAE;QAC9B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC,EACD,CAAC,WAAW,CAAC,CACd,CAAC;IAEF,MAAM,OAAO,GAAG,WAAW,CACzB,CAAC,IAAY,EAAW,EAAE;QACxB,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC,EACD,CAAC,KAAK,CAAC,CACR,CAAC;IAEF,MAAM,UAAU,GAAG,WAAW,CAC5B,CAAC,GAAG,QAAkB,EAAW,EAAE;QACjC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC,EACD,CAAC,KAAK,CAAC,CACR,CAAC;IAEF,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE;QAC3B,OAAO,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,OAAO;QACL,WAAW;QACX,KAAK;QACL,aAAa;QACb,gBAAgB;QAChB,iBAAiB;QACjB,OAAO;QACP,UAAU;QACV,OAAO;KACR,CAAC;AACJ,CAAC"}
+{"version":3,"file":"use-permissions.js","sourceRoot":"","sources":["../../../src/identity/headless/use-permissions.ts"],"names":[],"mappings":"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"}

package/dist/identity/index.d.ts

@@ -1,4 +1,4 @@
-export { useAuth, usePermissions } from './headless/index.js';
+export { useAuth, usePermissions, LocalIdentityProvider } from './headless/index.js';
 export type { IdentityDataTableProps, IdentityTableColumn, IdentityTableFilter, IdentityTableRowAction, } from './headless/index.js';
 export { IdentityTable } from './ui/table.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/identity/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC9D,YAAY,EACV,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/identity/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACrF,YAAY,EACV,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/identity/index.js

@@ -4,7 +4,7 @@
 // dependency (notifications -> identity). Not a package subpath: apps import
 // `@marinoscar/platform-web/identity/headless` and `/identity/ui`. Narrow on
 // purpose: only what a sibling uses.
-export { useAuth, usePermissions } from './headless/index.js';
+export { useAuth, usePermissions, LocalIdentityProvider } from './headless/index.js';
 // The table seam: the app's DataTable from the identity adapters, else the
 // plain MUI fallback.
 export { IdentityTable } from './ui/table.js';

package/dist/identity/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/identity/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,0EAA0E;AAC1E,4EAA4E;AAC5E,6EAA6E;AAC7E,6EAA6E;AAC7E,qCAAqC;AAErC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAO9D,2EAA2E;AAC3E,sBAAsB;AACtB,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/identity/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,0EAA0E;AAC1E,4EAA4E;AAC5E,6EAA6E;AAC7E,6EAA6E;AAC7E,qCAAqC;AAErC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAOrF,2EAA2E;AAC3E,sBAAsB;AACtB,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

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

@@ -1,5 +1,7 @@
 export { groupDestinationRuns, isDestinationVisible, isExternalUrl, owns, resolveActiveDestination, shellDestinationRoutes, } from './navigation.js';
 export type { ShellConsole, ShellConsoleBack, ShellDestination, ShellDestinationRun, ShellIcon, ShellIconProps, ShellNavigation, ShellRailPreference, ShellSettingsSurface, } from './navigation.js';
+export { ShellPreferencesProvider, createLocalStorageShellPreferencesPort, useOptionalShellPreferencesPort, } from './preferences.js';
+export type { ShellPreferences, ShellPreferencesPort, ShellPreferencesProviderProps } from './preferences.js';
 export { useShellRailPreference } from './rail-preference.js';
 export type { ShellRailPreferenceOptions, UseShellRailPreferenceResult } from './rail-preference.js';
 export { BUILTIN_SHELL_THEME_MODES, createShellTheme, isBuiltinThemeMode, listThemeModes, registerThemeMode, shellComponentOverrides, shellPalette, useOptionalShellTheme, useShellTheme, } from './theme.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shell/headless/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,IAAI,EACJ,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,SAAS,EACT,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,YAAY,EAAE,0BAA0B,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AACrG,OAAO,EACL,yBAAyB,EACzB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,uBAAuB,EACvB,YAAY,EACZ,qBAAqB,EACrB,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,sBAAsB,EACtB,cAAc,EACd,wBAAwB,EACxB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shell/headless/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,IAAI,EACJ,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,SAAS,EACT,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,wBAAwB,EACxB,sCAAsC,EACtC,+BAA+B,GAChC,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC;AAC9G,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,YAAY,EAAE,0BAA0B,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AACrG,OAAO,EACL,yBAAyB,EACzB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,uBAAuB,EACvB,YAAY,EACZ,qBAAqB,EACrB,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,sBAAsB,EACtB,cAAc,EACd,wBAAwB,EACxB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/shell/headless/index.js

@@ -2,6 +2,7 @@
 // theme and providers composition, with no component (issue #868). Documented
 // in ../README.md.
 export { groupDestinationRuns, isDestinationVisible, isExternalUrl, owns, resolveActiveDestination, shellDestinationRoutes, } from './navigation.js';
+export { ShellPreferencesProvider, createLocalStorageShellPreferencesPort, useOptionalShellPreferencesPort, } from './preferences.js';
 export { useShellRailPreference } from './rail-preference.js';
 export { BUILTIN_SHELL_THEME_MODES, createShellTheme, isBuiltinThemeMode, listThemeModes, registerThemeMode, shellComponentOverrides, shellPalette, useOptionalShellTheme, useShellTheme, } from './theme.js';
 export { ShellProviders } from './providers.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shell/headless/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,8EAA8E;AAC9E,mBAAmB;AAEnB,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,IAAI,EACJ,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAYzB,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,EACL,yBAAyB,EACzB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,uBAAuB,EACvB,YAAY,EACZ,qBAAqB,EACrB,aAAa,GACd,MAAM,YAAY,CAAC;AAQpB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shell/headless/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,8EAA8E;AAC9E,mBAAmB;AAEnB,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,IAAI,EACJ,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAYzB,OAAO,EACL,wBAAwB,EACxB,sCAAsC,EACtC,+BAA+B,GAChC,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,EACL,yBAAyB,EACzB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,uBAAuB,EACvB,YAAY,EACZ,qBAAqB,EACrB,aAAa,GACd,MAAM,YAAY,CAAC;AAQpB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/shell/headless/preferences.d.ts

@@ -0,0 +1,72 @@
+import type { ReactElement, ReactNode } from 'react';
+/**
+ * The preferences the shell stores per viewer. Absent means the default.
+ *
+ * @stability experimental
+ */
+export interface ShellPreferences {
+    /** The desktop rail is collapsed. Absent: expanded. */
+    railCollapsed?: boolean;
+}
+/**
+ * Where a host keeps {@link ShellPreferences}.
+ *
+ * @extensionPoint option
+ * @stability experimental
+ */
+export interface ShellPreferencesPort {
+    /** Reads the stored preferences (an empty object when none). */
+    read(): ShellPreferences | Promise<ShellPreferences>;
+    /** Stores the fields of `patch`; fields it omits are left as they are. */
+    write(patch: Partial<ShellPreferences>): void | Promise<void>;
+}
+/**
+ * Props of {@link ShellPreferencesProvider}.
+ *
+ * @stability experimental
+ */
+export interface ShellPreferencesProviderProps {
+    /** The port; keep its identity stable. */
+    port: ShellPreferencesPort;
+    /** The tree. */
+    children: ReactNode;
+}
+/**
+ * Stores the shell's preferences through `port` instead of `/user-settings`.
+ * Mount it for the whole life of the shell: `useShellRailPreference` picks its
+ * source from whether a provider is mounted.
+ *
+ * @param props - see {@link ShellPreferencesProviderProps}.
+ * @returns the provider element.
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export declare function ShellPreferencesProvider({ port, children }: ShellPreferencesProviderProps): ReactElement;
+/**
+ * The preferences port in context, or `null` when no
+ * {@link ShellPreferencesProvider} is mounted.
+ *
+ * @returns the port, or `null`.
+ *
+ * @stability experimental
+ */
+export declare function useOptionalShellPreferencesPort(): ShellPreferencesPort | null;
+/**
+ * A port over `window.localStorage`: one JSON object under `key`. Every storage
+ * access is guarded, so a blocked or full store reads as "no preferences" and
+ * a failed write is dropped; the shell then keeps the choice for the session.
+ *
+ * @param key - the storage key. Default `'shell-preferences'`.
+ * @returns the port.
+ *
+ * @example
+ * ```tsx
+ * const port = createLocalStorageShellPreferencesPort('myapp.shell');
+ * <ShellPreferencesProvider port={port}>...</ShellPreferencesProvider>
+ * ```
+ *
+ * @stability experimental
+ */
+export declare function createLocalStorageShellPreferencesPort(key?: string): ShellPreferencesPort;
+//# sourceMappingURL=preferences.d.ts.map

package/dist/shell/headless/preferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../../../src/shell/headless/preferences.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,gEAAgE;IAChE,IAAI,IAAI,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACrD,0EAA0E;IAC1E,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D;AAKD;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC5C,0CAA0C;IAC1C,IAAI,EAAE,oBAAoB,CAAC;IAC3B,gBAAgB;IAChB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,6BAA6B,GAAG,YAAY,CAExG;AAED;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,IAAI,oBAAoB,GAAG,IAAI,CAE7E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sCAAsC,CAAC,GAAG,SAAsB,GAAG,oBAAoB,CAuBtG"}

package/dist/shell/headless/preferences.js

@@ -0,0 +1,83 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// =============================================================================
+// The shell preferences port (a host with no `/user-settings`)
+// =============================================================================
+//
+// The rail's collapse preference lives in the viewer's `navigation`
+// user-settings namespace by default (`useShellRailPreference`). A host with no
+// API (a desktop shell) mounts `ShellPreferencesProvider` with a port that reads
+// and writes the same values locally, and the rail then never touches the API.
+// =============================================================================
+import { createContext, useContext } from 'react';
+const ShellPreferencesContext = createContext(null);
+ShellPreferencesContext.displayName = 'ShellPreferencesContext';
+/**
+ * Stores the shell's preferences through `port` instead of `/user-settings`.
+ * Mount it for the whole life of the shell: `useShellRailPreference` picks its
+ * source from whether a provider is mounted.
+ *
+ * @param props - see {@link ShellPreferencesProviderProps}.
+ * @returns the provider element.
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export function ShellPreferencesProvider({ port, children }) {
+    return _jsx(ShellPreferencesContext.Provider, { value: port, children: children });
+}
+/**
+ * The preferences port in context, or `null` when no
+ * {@link ShellPreferencesProvider} is mounted.
+ *
+ * @returns the port, or `null`.
+ *
+ * @stability experimental
+ */
+export function useOptionalShellPreferencesPort() {
+    return useContext(ShellPreferencesContext);
+}
+/**
+ * A port over `window.localStorage`: one JSON object under `key`. Every storage
+ * access is guarded, so a blocked or full store reads as "no preferences" and
+ * a failed write is dropped; the shell then keeps the choice for the session.
+ *
+ * @param key - the storage key. Default `'shell-preferences'`.
+ * @returns the port.
+ *
+ * @example
+ * ```tsx
+ * const port = createLocalStorageShellPreferencesPort('myapp.shell');
+ * <ShellPreferencesProvider port={port}>...</ShellPreferencesProvider>
+ * ```
+ *
+ * @stability experimental
+ */
+export function createLocalStorageShellPreferencesPort(key = 'shell-preferences') {
+    const readAll = () => {
+        try {
+            const raw = window.localStorage.getItem(key);
+            if (raw === null)
+                return {};
+            const parsed = JSON.parse(raw);
+            if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+                return {};
+            const railCollapsed = parsed.railCollapsed;
+            return typeof railCollapsed === 'boolean' ? { railCollapsed } : {};
+        }
+        catch {
+            return {};
+        }
+    };
+    return {
+        read: readAll,
+        write(patch) {
+            try {
+                window.localStorage.setItem(key, JSON.stringify({ ...readAll(), ...patch }));
+            }
+            catch {
+                // Storage unavailable: the preference lasts for the session only.
+            }
+        },
+    };
+}
+//# sourceMappingURL=preferences.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.js","sourceRoot":"","sources":["../../../src/shell/headless/preferences.tsx"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,+DAA+D;AAC/D,gFAAgF;AAChF,EAAE;AACF,oEAAoE;AACpE,gFAAgF;AAChF,iFAAiF;AACjF,+EAA+E;AAC/E,gFAAgF;AAEhF,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AA0BlD,MAAM,uBAAuB,GAAG,aAAa,CAA8B,IAAI,CAAC,CAAC;AACjF,uBAAuB,CAAC,WAAW,GAAG,yBAAyB,CAAC;AAchE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,wBAAwB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAiC;IACxF,OAAO,KAAC,uBAAuB,CAAC,QAAQ,IAAC,KAAK,EAAE,IAAI,YAAG,QAAQ,GAAoC,CAAC;AACtG,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,+BAA+B;IAC7C,OAAO,UAAU,CAAC,uBAAuB,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,sCAAsC,CAAC,GAAG,GAAG,mBAAmB;IAC9E,MAAM,OAAO,GAAG,GAAqB,EAAE;QACrC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC7C,IAAI,GAAG,KAAK,IAAI;gBAAE,OAAO,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACxC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;gBAAE,OAAO,EAAE,CAAC;YACtF,MAAM,aAAa,GAAI,MAAsC,CAAC,aAAa,CAAC;YAC5E,OAAO,OAAO,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC,CAAC;IACF,OAAO;QACL,IAAI,EAAE,OAAO;QACb,KAAK,CAAC,KAAK;YACT,IAAI,CAAC;gBACH,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,OAAO,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;YAC/E,CAAC;YAAC,MAAM,CAAC;gBACP,kEAAkE;YACpE,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/shell/headless/rail-preference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rail-preference.d.ts","sourceRoot":"","sources":["../../../src/shell/headless/rail-preference.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAI7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAU3D;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,4EAA4E;IAC5E,GAAG,CAAC,EAAE,iBAAiB,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,4BAA6B,SAAQ,mBAAmB;IACvE,2FAA2F;IAC3F,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,0BAA+B,GAAG,4BAA4B,CAmC7G"}
+{"version":3,"file":"rail-preference.d.ts","sourceRoot":"","sources":["../../../src/shell/headless/rail-preference.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAI7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAY3D;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,4EAA4E;IAC5E,GAAG,CAAC,EAAE,iBAAiB,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,4BAA6B,SAAQ,mBAAmB;IACvE,2FAA2F;IAC3F,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,0BAA+B,GAAG,4BAA4B,CAK7G"}

package/dist/shell/headless/rail-preference.js

@@ -17,9 +17,10 @@
 //    at which point the stored value either carries the new value (success) or
 //    the old one (failure): the revert is the same path as the commit.
 // =============================================================================
-import { useCallback, useMemo, useRef, useState } from 'react';
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { useUserSettings } from '../../settings/index.js';
 import { useIsMounted } from '../internal/use-is-mounted.js';
+import { useOptionalShellPreferencesPort } from './preferences.js';
 /**
  * The desktop rail's collapse preference, stored in the viewer's `navigation`
  * user-settings namespace (`railCollapsed`). Optimistic toggle; a default is
@@ -33,6 +34,48 @@ import { useIsMounted } from '../internal/use-is-mounted.js';
  * @stability experimental
  */
 export function useShellRailPreference(options = {}) {
+    // The source is fixed for the life of the shell (a provider is mounted or it
+    // is not), so choosing between the two hooks here keeps the hook order stable.
+    const port = useOptionalShellPreferencesPort();
+    return port ? usePortRailPreference(port) : useServerRailPreference(options);
+}
+/** The preference over a host's {@link ShellPreferencesPort}; never touches the API. */
+function usePortRailPreference(port) {
+    const [railCollapsed, setRailCollapsed] = useState(false);
+    const [isLoading, setIsLoading] = useState(true);
+    // A write made before the first read resolves wins over the stale read.
+    const touched = useRef(false);
+    useEffect(() => {
+        let cancelled = false;
+        void Promise.resolve()
+            .then(() => port.read())
+            .then((stored) => {
+            if (cancelled || touched.current)
+                return;
+            setRailCollapsed(stored.railCollapsed === true);
+        })
+            .catch(() => undefined)
+            .finally(() => {
+            if (!cancelled)
+                setIsLoading(false);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [port]);
+    const toggleRailCollapsed = useCallback(() => {
+        touched.current = true;
+        const next = !railCollapsed;
+        setRailCollapsed(next);
+        void Promise.resolve()
+            .then(() => port.write({ railCollapsed: next }))
+            // The choice stays for this session when the port cannot keep it.
+            .catch(() => undefined);
+    }, [port, railCollapsed]);
+    return { railCollapsed, toggleRailCollapsed, isLoading };
+}
+/** The preference over `/user-settings` (the default). */
+function useServerRailPreference(options) {
     const { settings, isLoading, updateSettings } = useUserSettings({
         syncTheme: false,
         ...(options.api === undefined ? {} : { api: options.api }),