@wildo-ai/saas-frontend-lib 1.1.1 → 1.1.3

package/dist/esm/core/components-registry/useProviderComponent.frontend.hooks.js

@@ -0,0 +1,98 @@
+/**
+ * Reading provider-contributed components from a React surface.
+ *
+ * Two hooks, split along the one line that matters: WHICH providers can fill a
+ * capability is known synchronously and their component is not.
+ *
+ *   - `useProviderComponentChoices` — the live providers offering a component
+ *     for a capability, in a stable order, with the label KEY each renders
+ *     under. Synchronous, so a surface can draw its chooser on the first frame
+ *     instead of flashing an empty one.
+ *   - `useProviderComponent` — the chosen provider's component, loaded on
+ *     demand, with an explicit status so a surface renders a pending state
+ *     rather than nothing.
+ *
+ * Neither hook picks a provider. That is the defect being fixed: resolution was
+ * first-match, so two pickers could not coexist and the winner depended on map
+ * order. When there are several, choosing is the surface's job — and a user's.
+ *
+ * Labels are KEYS, never text. A provider's display name is resolved through
+ * the app i18n service at render time by whatever surface shows it; returning a
+ * string here would freeze locale-bound copy into a hook and make a missing
+ * translation invisible.
+ */
+import { useEffect, useState } from 'react';
+import { buildProviderDisplayNameLabelKey } from '@wildo-ai/saas-models/public-runtime';
+import { useApplication } from '../../core/runtime/useApplication.js';
+/**
+ * The providers that are BOTH live for this service and carry a component for
+ * this capability.
+ *
+ * Both halves are required and they come from different channels: a provider
+ * can be live with no code (an older bundle) or have code and not be live (an
+ * environment that left it off). A surface must offer only what can actually
+ * render.
+ */
+export function useProviderComponentChoices(capability) {
+    const { frontendProviderRegistry, providerComponentRegistry } = useApplication();
+    if (providerComponentRegistry === undefined)
+        return [];
+    return providerComponentRegistry.listProviders(capability).map((providerRef) => {
+        const provider = frontendProviderRegistry?.getProviderByRef(providerRef);
+        return {
+            providerRef,
+            displayNameLabelKey: provider?.metadata.displayNameLabelKey ?? buildProviderDisplayNameLabelKey(providerRef),
+            displayName: provider?.metadata.displayName,
+        };
+    });
+}
+/** Why a provider component is not on screen yet. */
+export var ProviderComponentStatus;
+(function (ProviderComponentStatus) {
+    /** No provider was chosen, or none offers a component for this capability. */
+    ProviderComponentStatus["NONE"] = "NONE";
+    ProviderComponentStatus["LOADING"] = "LOADING";
+    ProviderComponentStatus["READY"] = "READY";
+    /**
+     * The loader failed or returned something unrenderable. The registry has
+     * already reported why; a surface should fall back rather than retry, because
+     * the registry will not run a failed loader again.
+     */
+    ProviderComponentStatus["UNAVAILABLE"] = "UNAVAILABLE";
+})(ProviderComponentStatus || (ProviderComponentStatus = {}));
+/**
+ * Loads one provider's component for a capability.
+ *
+ * Pass `undefined` for the ref while nothing is chosen — the hook does not
+ * choose, and a surface with several providers must not load all of them
+ * speculatively.
+ */
+export function useProviderComponent(capability, providerRef) {
+    const { providerComponentRegistry } = useApplication();
+    const [state, setState] = useState({
+        status: ProviderComponentStatus.NONE,
+        Component: null,
+    });
+    useEffect(() => {
+        if (providerComponentRegistry === undefined || providerRef === undefined) {
+            setState({ status: ProviderComponentStatus.NONE, Component: null });
+            return;
+        }
+        let current = true;
+        setState({ status: ProviderComponentStatus.LOADING, Component: null });
+        void providerComponentRegistry.resolve(capability, providerRef).then((Component) => {
+            // A user can switch provider while one is still downloading. Without this
+            // the slower answer would arrive last and replace the one they chose.
+            if (!current)
+                return;
+            setState(Component === null
+                ? { status: ProviderComponentStatus.UNAVAILABLE, Component: null }
+                : { status: ProviderComponentStatus.READY, Component });
+        });
+        return () => {
+            current = false;
+        };
+    }, [capability, providerRef, providerComponentRegistry]);
+    return state;
+}
+//# sourceMappingURL=useProviderComponent.frontend.hooks.js.map

package/dist/esm/core/components-registry/useProviderComponent.frontend.hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useProviderComponent.frontend.hooks.js","sourceRoot":"","sources":["../../../../src/core/components-registry/useProviderComponent.frontend.hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAE,gCAAgC,EAAE,MAAM,sCAAsC,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AAWjF;;;;;;;;GAQG;AACH,MAAM,UAAU,2BAA2B,CACzC,UAA8B;IAE9B,MAAM,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,GAAG,cAAc,EAAE,CAAC;IAEjF,IAAI,yBAAyB,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAEvD,OAAO,yBAAyB,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE;QAC7E,MAAM,QAAQ,GAAG,wBAAwB,EAAE,gBAAgB,CAAC,WAAoB,CAAC,CAAC;QAClF,OAAO;YACL,WAAW;YACX,mBAAmB,EACjB,QAAQ,EAAE,QAAQ,CAAC,mBAAmB,IAAI,gCAAgC,CAAC,WAAW,CAAC;YACzF,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,WAAW;SAC5C,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,qDAAqD;AACrD,MAAM,CAAN,IAAY,uBAWX;AAXD,WAAY,uBAAuB;IACjC,8EAA8E;IAC9E,wCAAa,CAAA;IACb,8CAAmB,CAAA;IACnB,0CAAe,CAAA;IACf;;;;OAIG;IACH,sDAA2B,CAAA;AAC7B,CAAC,EAXW,uBAAuB,KAAvB,uBAAuB,QAWlC;AAOD;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAA8B,EAC9B,WAA+B;IAE/B,MAAM,EAAE,yBAAyB,EAAE,GAAG,cAAc,EAAE,CAAC;IACvD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAyB;QACzD,MAAM,EAAE,uBAAuB,CAAC,IAAI;QACpC,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,yBAAyB,KAAK,SAAS,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YACzE,QAAQ,CAAC,EAAE,MAAM,EAAE,uBAAuB,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QAED,IAAI,OAAO,GAAG,IAAI,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,uBAAuB,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEvE,KAAK,yBAAyB,CAAC,OAAO,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE;YACjF,0EAA0E;YAC1E,sEAAsE;YACtE,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,QAAQ,CACN,SAAS,KAAK,IAAI;gBAChB,CAAC,CAAC,EAAE,MAAM,EAAE,uBAAuB,CAAC,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE;gBAClE,CAAC,CAAC,EAAE,MAAM,EAAE,uBAAuB,CAAC,KAAK,EAAE,SAAS,EAAE,CACzD,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO,GAAG,EAAE;YACV,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,yBAAyB,CAAC,CAAC,CAAC;IAEzD,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["/**\n * Reading provider-contributed components from a React surface.\n *\n * Two hooks, split along the one line that matters: WHICH providers can fill a\n * capability is known synchronously and their component is not.\n *\n *   - `useProviderComponentChoices` — the live providers offering a component\n *     for a capability, in a stable order, with the label KEY each renders\n *     under. Synchronous, so a surface can draw its chooser on the first frame\n *     instead of flashing an empty one.\n *   - `useProviderComponent` — the chosen provider's component, loaded on\n *     demand, with an explicit status so a surface renders a pending state\n *     rather than nothing.\n *\n * Neither hook picks a provider. That is the defect being fixed: resolution was\n * first-match, so two pickers could not coexist and the winner depended on map\n * order. When there are several, choosing is the surface's job — and a user's.\n *\n * Labels are KEYS, never text. A provider's display name is resolved through\n * the app i18n service at render time by whatever surface shows it; returning a\n * string here would freeze locale-bound copy into a hook and make a missing\n * translation invisible.\n */\n\nimport { useEffect, useState } from 'react';\nimport type { ProviderCapability } from '@wildo-ai/saas-models';\nimport { buildProviderDisplayNameLabelKey } from '@wildo-ai/saas-models/public-runtime';\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport type { ProviderComponent } from './provider-component-registry.frontend.service';\n\nexport interface ProviderComponentChoice {\n  readonly providerRef: string;\n  /** Resolve through the app i18n service; never render this key. */\n  readonly displayNameLabelKey: string;\n  /** The provider's authored fallback, when it has one. Still not a translation. */\n  readonly displayName?: string;\n}\n\n/**\n * The providers that are BOTH live for this service and carry a component for\n * this capability.\n *\n * Both halves are required and they come from different channels: a provider\n * can be live with no code (an older bundle) or have code and not be live (an\n * environment that left it off). A surface must offer only what can actually\n * render.\n */\nexport function useProviderComponentChoices(\n  capability: ProviderCapability,\n): ReadonlyArray<ProviderComponentChoice> {\n  const { frontendProviderRegistry, providerComponentRegistry } = useApplication();\n\n  if (providerComponentRegistry === undefined) return [];\n\n  return providerComponentRegistry.listProviders(capability).map((providerRef) => {\n    const provider = frontendProviderRegistry?.getProviderByRef(providerRef as never);\n    return {\n      providerRef,\n      displayNameLabelKey:\n        provider?.metadata.displayNameLabelKey ?? buildProviderDisplayNameLabelKey(providerRef),\n      displayName: provider?.metadata.displayName,\n    };\n  });\n}\n\n/** Why a provider component is not on screen yet. */\nexport enum ProviderComponentStatus {\n  /** No provider was chosen, or none offers a component for this capability. */\n  NONE = 'NONE',\n  LOADING = 'LOADING',\n  READY = 'READY',\n  /**\n   * The loader failed or returned something unrenderable. The registry has\n   * already reported why; a surface should fall back rather than retry, because\n   * the registry will not run a failed loader again.\n   */\n  UNAVAILABLE = 'UNAVAILABLE',\n}\n\nexport interface ProviderComponentState {\n  readonly status: ProviderComponentStatus;\n  readonly Component: ProviderComponent | null;\n}\n\n/**\n * Loads one provider's component for a capability.\n *\n * Pass `undefined` for the ref while nothing is chosen — the hook does not\n * choose, and a surface with several providers must not load all of them\n * speculatively.\n */\nexport function useProviderComponent(\n  capability: ProviderCapability,\n  providerRef: string | undefined,\n): ProviderComponentState {\n  const { providerComponentRegistry } = useApplication();\n  const [state, setState] = useState<ProviderComponentState>({\n    status: ProviderComponentStatus.NONE,\n    Component: null,\n  });\n\n  useEffect(() => {\n    if (providerComponentRegistry === undefined || providerRef === undefined) {\n      setState({ status: ProviderComponentStatus.NONE, Component: null });\n      return;\n    }\n\n    let current = true;\n    setState({ status: ProviderComponentStatus.LOADING, Component: null });\n\n    void providerComponentRegistry.resolve(capability, providerRef).then((Component) => {\n      // A user can switch provider while one is still downloading. Without this\n      // the slower answer would arrive last and replace the one they chose.\n      if (!current) return;\n      setState(\n        Component === null\n          ? { status: ProviderComponentStatus.UNAVAILABLE, Component: null }\n          : { status: ProviderComponentStatus.READY, Component },\n      );\n    });\n\n    return () => {\n      current = false;\n    };\n  }, [capability, providerRef, providerComponentRegistry]);\n\n  return state;\n}\n"]}

package/dist/esm/core/config/app-configuration-frontend.schemas.d.ts

@@ -256,10 +256,10 @@ export declare const AppLevelComponentConfigurationSchema: z.ZodObject<{
     sidebar: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
         placement: z.ZodUnion<readonly [z.ZodLiteral<HorizontalPlacement.START>, z.ZodLiteral<HorizontalPlacement.END>]>;
         collapsible: z.ZodDefault<z.ZodBoolean>;
+        defaultCollapsed: z.ZodOptional<z.ZodBoolean>;
         responsiveBreakpoint: z.ZodDefault<z.ZodEnum<typeof ViewportBreakpoint>>;
         responsivePolicy: z.ZodDefault<z.ZodEnum<typeof SidebarResponsivePolicy>>;
         defaultSection: z.ZodDefault<z.ZodString>;
-        showUncategorized: z.ZodDefault<z.ZodBoolean>;
         homeDisplayMode: z.ZodOptional<z.ZodEnum<typeof SidebarHomeDisplayMode>>;
         brandMarkTheme: z.ZodOptional<z.ZodEnum<typeof BrandAssetTheme>>;
         contentSections: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -485,12 +485,17 @@ export declare const AppLevelComponentConfigurationSchema: z.ZodObject<{
         mobileRendering: z.ZodDefault<z.ZodEnum<typeof ActivityBarRendering>>;
     }, z.core.$strip>]>>;
     utility_panel: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
-        items: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        items: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<import("./launcher-items.frontend.schemas").LauncherItemTargetKind.CUSTOM_COMPONENT>;
             componentRef: z.ZodString;
             icon: z.ZodString;
             label: z.ZodString;
-        }, z.core.$strip>>>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<import("./launcher-items.frontend.schemas").LauncherItemTargetKind.VIEW>;
+            viewRef: z.ZodString;
+            icon: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>], "kind">>>;
         position: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<HorizontalPlacement.START>, z.ZodLiteral<HorizontalPlacement.END>]>>;
     }, z.core.$strip>]>>;
 }, z.core.$strip>;
@@ -1093,6 +1098,89 @@ export declare const ErrorPageConfigSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ErrorPageConfig = z.infer<typeof ErrorPageConfigSchema>;
+/**
+ * The identity a FRONTEND SURFACE presents, when that surface is not the
+ * application whose backend it talks to.
+ *
+ * Mirrors the two things `useBrandIdentity` returns — a display name and a set
+ * of brand assets — because those are exactly the inputs a shell needs to
+ * present an identity, and reusing `RuntimeBrandAsset` keeps ONE asset
+ * vocabulary: the same compositions, themes, purposes and the same
+ * `resolveBrandAsset` fallback ladder apply whether the assets came from the
+ * application's generated brand or from a tool declaring its own.
+ *
+ * See the `shellIdentity` field on `AppConfiguration_Frontend_Schema` for why
+ * this exists and when to declare it.
+ */
+export declare const ShellIdentitySchema: z.ZodObject<{
+    name: z.ZodString;
+    brandAssets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        composition: z.ZodEnum<typeof import("@wildo-ai/saas-models").BrandAssetComposition>;
+        theme: z.ZodEnum<typeof BrandAssetTheme>;
+        purpose: z.ZodEnum<typeof import("@wildo-ai/saas-models").BrandAssetPurpose>;
+        url: z.ZodString;
+        format: z.ZodEnum<typeof import("@wildo-ai/saas-models").BrandAssetFormat>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type ShellIdentity = z.infer<typeof ShellIdentitySchema>;
+/**
+ * @wildo_source:part:start saas.frontend.public-shell.identity-mode facet:layer:frontend facet:family:config facet:audience:app-developer
+ *
+ * Whether the PUBLIC (unauthenticated) pages present the application's identity.
+ *
+ * Declare it beside your other frontend configuration and pass it to
+ * `buildFrontendModuleConfigOverrides` in `frontend/src/modules-registry.frontend.ts`, alongside
+ * `navigationLayout`, `homeDefinition` and `errorPageConfig`:
+ *
+ * ```ts
+ * import { PublicShellIdentityMode } from '@wildo-ai/saas-frontend-lib';
+ *
+ * frontendConfigOverrides: buildFrontendModuleConfigOverrides({
+ *   // …navigationLayout, designSystemConfiguration, homeDefinition, errorPageConfig
+ *   publicShellIdentityMode: PublicShellIdentityMode.BRAND_HEADER,
+ * }),
+ * ```
+ *
+ * It is NOT an `ApplicationLevelComponentType` key: it does not belong in
+ * `frontend/src/config/app-shell.config.ts`, and putting it there configures nothing at all. Those
+ * keys describe the AUTHENTICATED shell (menubar, sidebar, status bar); the pages this governs
+ * render before any of that exists.
+ *
+ * Login, registration, invitation acceptance, e-mail confirmation, password reset, the MFA
+ * challenge and the OAuth consent screens are the first thing a person ever sees of an application,
+ * and they are also the pages most likely to be reached from a link — an e-mail, a chat message, a
+ * bookmark — with no surrounding context saying what they belong to. Naming the surface there is
+ * conventional (Stripe, Linear, GitHub, Slack all do it) and it is the difference between "sign in"
+ * and "sign in to WHAT".
+ *
+ * OPT-IN, and {@link HIDDEN} is the framework default, for the same reason the sidebar's home mode
+ * defaults to a navigation row rather than a brand header: showing an identity assumes the surface
+ * HAS one worth showing, and an application that has generated no brand yet would get its technical
+ * `appName` printed over its login form. An application says when it is ready.
+ *
+ * Mirrors {@link SidebarHomeDisplayMode} deliberately — same question ("how is this product's
+ * identity surfaced here"), same answer shape, so an author who has met one already knows this one.
+ */
+export declare enum PublicShellIdentityMode {
+    /**
+     * Public pages carry no identity. The framework default, and the behavior of every application
+     * that does not mention this field.
+     */
+    HIDDEN = "hidden",
+    /**
+     * The identity at the top of the public card, above the form's own heading: the mark when one
+     * resolves, and the name.
+     *
+     * What actually renders is decided from the DATA, not from this mode — an application with no
+     * generated brand shows its name alone, and a brand whose mark is a wordmark or lockup shows the
+     * mark alone, because such a mark already contains the name. So this mode is a permission, never
+     * a promise that a logo exists.
+     */
+    BRAND_HEADER = "brand_header"
+}
+/** @wildo_source:part:end saas.frontend.public-shell.identity-mode */
 /**
  * Frontend configuration schema — the single source of truth for all frontend
  * configuration. Provided entirely by the app at runtime via presets + overrides.
@@ -1340,10 +1428,10 @@ export declare const AppConfiguration_Frontend_Schema: z.ZodObject<{
         sidebar: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
             placement: z.ZodUnion<readonly [z.ZodLiteral<HorizontalPlacement.START>, z.ZodLiteral<HorizontalPlacement.END>]>;
             collapsible: z.ZodDefault<z.ZodBoolean>;
+            defaultCollapsed: z.ZodOptional<z.ZodBoolean>;
             responsiveBreakpoint: z.ZodDefault<z.ZodEnum<typeof ViewportBreakpoint>>;
             responsivePolicy: z.ZodDefault<z.ZodEnum<typeof SidebarResponsivePolicy>>;
             defaultSection: z.ZodDefault<z.ZodString>;
-            showUncategorized: z.ZodDefault<z.ZodBoolean>;
             homeDisplayMode: z.ZodOptional<z.ZodEnum<typeof SidebarHomeDisplayMode>>;
             brandMarkTheme: z.ZodOptional<z.ZodEnum<typeof BrandAssetTheme>>;
             contentSections: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -1569,12 +1657,17 @@ export declare const AppConfiguration_Frontend_Schema: z.ZodObject<{
             mobileRendering: z.ZodDefault<z.ZodEnum<typeof ActivityBarRendering>>;
         }, z.core.$strip>]>>;
         utility_panel: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
-            items: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            items: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<import("./launcher-items.frontend.schemas").LauncherItemTargetKind.CUSTOM_COMPONENT>;
                 componentRef: z.ZodString;
                 icon: z.ZodString;
                 label: z.ZodString;
-            }, z.core.$strip>>>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<import("./launcher-items.frontend.schemas").LauncherItemTargetKind.VIEW>;
+                viewRef: z.ZodString;
+                icon: z.ZodString;
+                label: z.ZodString;
+            }, z.core.$strip>], "kind">>>;
             position: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<HorizontalPlacement.START>, z.ZodLiteral<HorizontalPlacement.END>]>>;
         }, z.core.$strip>]>>;
     }, z.core.$strip>;
@@ -1997,7 +2090,7 @@ export declare const AppConfiguration_Frontend_Schema: z.ZodObject<{
         isAddressable: z.ZodDefault<z.ZodBoolean>;
         operationLike: z.ZodDefault<z.ZodEnum<typeof import("@wildo-ai/saas-models").CoreResourceOperation>>;
         primaryScope: z.ZodDefault<z.ZodEnum<typeof import("@wildo-ai/saas-models").ResourcePrimaryScope>>;
-        systemRefs: z.ZodArray<z.ZodString>;
+        systemRef: z.ZodString;
         layoutPreset: z.ZodDefault<z.ZodString>;
         requiredFeatures: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodObject<{
             features: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -2628,6 +2721,19 @@ export declare const AppConfiguration_Frontend_Schema: z.ZodObject<{
         }, z.core.$strip>>>;
     }, z.core.$strip>>;
     settingsHub: z.ZodOptional<z.ZodCustom<SettingsHubConfig, SettingsHubConfig>>;
+    shellIdentity: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        brandAssets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            composition: z.ZodEnum<typeof import("@wildo-ai/saas-models").BrandAssetComposition>;
+            theme: z.ZodEnum<typeof BrandAssetTheme>;
+            purpose: z.ZodEnum<typeof import("@wildo-ai/saas-models").BrandAssetPurpose>;
+            url: z.ZodString;
+            format: z.ZodEnum<typeof import("@wildo-ai/saas-models").BrandAssetFormat>;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    publicShellIdentityMode: z.ZodOptional<z.ZodEnum<typeof PublicShellIdentityMode>>;
 }, z.core.$strip>;
 export type HomeDefinition = z.infer<typeof HomeDefinitionSchema>;
 export type AppConfiguration_Frontend = z.infer<typeof AppConfiguration_Frontend_Schema>;

package/dist/esm/core/config/app-configuration-frontend.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-configuration-frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/core/config/app-configuration-frontend.schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"app-configuration-frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../src/core/config/app-configuration-frontend.schemas.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/config/app-configuration-frontend.schemas.js

@@ -1,5 +1,5 @@
 import { DesignSystemConfigurationSchema, HorizontalPlacement, VerticalPlacement } from '@wildo-ai/presets-components-models';
-import { BrandAssetTheme, GuidanceFlowDefinitionSchema, NavigationLayoutSchema, } from '@wildo-ai/saas-models';
+import { BrandAssetTheme, GuidanceFlowDefinitionSchema, NavigationLayoutSchema, RuntimeBrandAssetSchema, } from '@wildo-ai/saas-models';
 import { CompositeViewDefinitionSchema } from './composite-view.schemas.js';
 import { OnboardingViewDefinitionSchema } from './onboarding-view.frontend.schemas.js';
 import { FrontendResourceOperationPathSchema } from '../../core/resources/resource-path.frontend.schemas.js';
@@ -262,10 +262,34 @@ export const AppLevelComponentConfigurationSchema = z.object({
         z.object({
             placement: z.union([z.literal(HorizontalPlacement.START), z.literal(HorizontalPlacement.END)]),
             collapsible: z.boolean().default(true),
+            /**
+             * Does the sidebar start COLLAPSED (the icon rail) rather than expanded?
+             *
+             * This is the application's STARTING POSITION, not a lock: the rail
+             * collapse is a per-machine user preference persisted under
+             * `LOCAL_STORAGE_KEYS.SIDEBAR_COLLAPSED`, and a stored preference always
+             * wins. So this answers "what does a visitor with no preference yet
+             * see", which nothing could express before — the hydration fell back to
+             * `false`, making EXPANDED the only reachable default for every
+             * application.
+             *
+             * Pairs with the theme's `SidebarCompactLabelMode`: `ICON_AND_LABEL`
+             * renders a wrapping label under each icon in the collapsed rail, so a
+             * rail-first shell stays readable rather than becoming a column of
+             * unlabelled glyphs.
+             *
+             * OPTIONAL rather than `.default(false)` for the reason `homeDisplayMode`
+             * gives one line below: a Zod default makes the key REQUIRED in the
+             * inferred authoring type, forcing every preset and application config to
+             * restate an opinion it does not have. The framework default (expanded —
+             * the behavior every app had before this axis existed) is applied in
+             * `useSidebarBehavior`, which must resolve it there regardless because a
+             * sidebar authored as plain `true` never reaches this object branch.
+             */
+            defaultCollapsed: z.boolean().optional(),
             responsiveBreakpoint: z.enum(ViewportBreakpoint).default(ViewportBreakpoint.MOBILE),
             responsivePolicy: z.enum(SidebarResponsivePolicy).default(SidebarResponsivePolicy.BURGER),
             defaultSection: z.string().default("main"),
-            showUncategorized: z.boolean().default(true),
             /**
              * How the sidebar surfaces HOME — hidden, the pinned brand header
              * (app symbol + name above the search trigger), or a "Home" navigation
@@ -595,6 +619,97 @@ export const ErrorPageConfigSchema = z.object({
     maintenance: ErrorPageConfigDefinitionSchema.optional(),
 });
 // ================================
+// Shell Identity
+// ================================
+/**
+ * The identity a FRONTEND SURFACE presents, when that surface is not the
+ * application whose backend it talks to.
+ *
+ * Mirrors the two things `useBrandIdentity` returns — a display name and a set
+ * of brand assets — because those are exactly the inputs a shell needs to
+ * present an identity, and reusing `RuntimeBrandAsset` keeps ONE asset
+ * vocabulary: the same compositions, themes, purposes and the same
+ * `resolveBrandAsset` fallback ladder apply whether the assets came from the
+ * application's generated brand or from a tool declaring its own.
+ *
+ * See the `shellIdentity` field on `AppConfiguration_Frontend_Schema` for why
+ * this exists and when to declare it.
+ */
+export const ShellIdentitySchema = z.object({
+    /**
+     * Human-readable surface name — rendered wherever the application's
+     * `appIdentity.displayName` would otherwise appear. Required: an identity
+     * with no name is not an identity, and the name alone is a complete answer
+     * (a surface may legitimately have no mark yet).
+     */
+    name: z.string().min(1),
+    /**
+     * This surface's OWN brand assets, resolved by the same `resolveBrandAsset`
+     * ladder as the application's. Omitted means "named, unmarked" — the shell
+     * renders the name and degrades to the framework glyph rather than showing
+     * the application's mark beside a different name, which is the specific
+     * mismatch this whole field exists to prevent.
+     */
+    brandAssets: RuntimeBrandAssetSchema.array().optional(),
+});
+/**
+ * @wildo_source:part:start saas.frontend.public-shell.identity-mode facet:layer:frontend facet:family:config facet:audience:app-developer
+ *
+ * Whether the PUBLIC (unauthenticated) pages present the application's identity.
+ *
+ * Declare it beside your other frontend configuration and pass it to
+ * `buildFrontendModuleConfigOverrides` in `frontend/src/modules-registry.frontend.ts`, alongside
+ * `navigationLayout`, `homeDefinition` and `errorPageConfig`:
+ *
+ * ```ts
+ * import { PublicShellIdentityMode } from '@wildo-ai/saas-frontend-lib';
+ *
+ * frontendConfigOverrides: buildFrontendModuleConfigOverrides({
+ *   // …navigationLayout, designSystemConfiguration, homeDefinition, errorPageConfig
+ *   publicShellIdentityMode: PublicShellIdentityMode.BRAND_HEADER,
+ * }),
+ * ```
+ *
+ * It is NOT an `ApplicationLevelComponentType` key: it does not belong in
+ * `frontend/src/config/app-shell.config.ts`, and putting it there configures nothing at all. Those
+ * keys describe the AUTHENTICATED shell (menubar, sidebar, status bar); the pages this governs
+ * render before any of that exists.
+ *
+ * Login, registration, invitation acceptance, e-mail confirmation, password reset, the MFA
+ * challenge and the OAuth consent screens are the first thing a person ever sees of an application,
+ * and they are also the pages most likely to be reached from a link — an e-mail, a chat message, a
+ * bookmark — with no surrounding context saying what they belong to. Naming the surface there is
+ * conventional (Stripe, Linear, GitHub, Slack all do it) and it is the difference between "sign in"
+ * and "sign in to WHAT".
+ *
+ * OPT-IN, and {@link HIDDEN} is the framework default, for the same reason the sidebar's home mode
+ * defaults to a navigation row rather than a brand header: showing an identity assumes the surface
+ * HAS one worth showing, and an application that has generated no brand yet would get its technical
+ * `appName` printed over its login form. An application says when it is ready.
+ *
+ * Mirrors {@link SidebarHomeDisplayMode} deliberately — same question ("how is this product's
+ * identity surfaced here"), same answer shape, so an author who has met one already knows this one.
+ */
+export var PublicShellIdentityMode;
+(function (PublicShellIdentityMode) {
+    /**
+     * Public pages carry no identity. The framework default, and the behavior of every application
+     * that does not mention this field.
+     */
+    PublicShellIdentityMode["HIDDEN"] = "hidden";
+    /**
+     * The identity at the top of the public card, above the form's own heading: the mark when one
+     * resolves, and the name.
+     *
+     * What actually renders is decided from the DATA, not from this mode — an application with no
+     * generated brand shows its name alone, and a brand whose mark is a wordmark or lockup shows the
+     * mark alone, because such a mark already contains the name. So this mode is a permission, never
+     * a promise that a logo exists.
+     */
+    PublicShellIdentityMode["BRAND_HEADER"] = "brand_header";
+})(PublicShellIdentityMode || (PublicShellIdentityMode = {}));
+/** @wildo_source:part:end saas.frontend.public-shell.identity-mode */
+// ================================
 // Per-App Frontend Configuration Schema
 // ================================
 /**
@@ -648,6 +763,52 @@ export const AppConfiguration_Frontend_Schema = z.object({
      * RESOLVED config and refuses a placement naming an unknown destination.
      */
     settingsHub: z.custom().optional(),
+    /**
+     * The identity THIS FRONTEND presents — for a surface that is not the
+     * application it talks to.
+     *
+     * Every brand-rendering surface (`useBrandIdentity`, and through it the
+     * sidebar's `BRAND_HEADER` home mode) otherwise reads the APPLICATION's
+     * identity from `appConfig.appIdentity` + `appConfig.brandAssets`. That is
+     * correct for an application's own frontend and WRONG for a tool that
+     * observes an application: one backend serves one application config to
+     * every frontend registered against it, so a tool frontend inherits the
+     * customer's name and mark.
+     *
+     * Measured, not assumed (2026-08-31): the dev companion answers
+     * `GET /api/v1/application-config?frontendServiceName=application-creation-workbench`
+     * with `appIdentity.displayName: "Wonder CRM"`, so the application-creation
+     * workbench's brand header would have carried the managed application's
+     * identity. There is exactly one config endpoint and it is the application's.
+     *
+     * Declared HERE — on the FRONTEND configuration — rather than on the sidebar,
+     * because it is a property of the surface, not of one of its components: the
+     * document title, a menubar brand and any future shell affordance ask the
+     * same question and must get the same answer. `useBrandIdentity` reads this
+     * with precedence over the application config and falls back to it, so an
+     * ordinary application frontend that declares nothing is unaffected.
+     *
+     * OPTIONAL, and absence means "I am the application's own frontend". Do not
+     * give it a default: a default identity would be a second, silent answer to
+     * "whose product is this", which is the question this field exists to make
+     * explicit.
+     */
+    shellIdentity: ShellIdentitySchema.optional(),
+    /**
+     * Whether the public (unauthenticated) pages present this surface's identity — see
+     * {@link PublicShellIdentityMode}.
+     *
+     * Reads the SAME identity as every other brand surface, through `useBrandIdentity`: a frontend
+     * that declares {@link AppConfiguration_Frontend.shellIdentity} presents its own name and mark,
+     * and one that does not presents the application's. So a tool observing an application cannot end
+     * up inviting people to sign in to the customer's brand.
+     *
+     * Optional rather than defaulted, and absent is read as {@link PublicShellIdentityMode.HIDDEN}.
+     * A Zod default would work here, but it would put the framework's answer into every merged config
+     * object, making "this application chose not to show identity" and "this application never
+     * considered it" indistinguishable at the point a reader looks.
+     */
+    publicShellIdentityMode: z.enum(PublicShellIdentityMode).optional(),
 }).superRefine((config, ctx) => {
     const appScopeFields = config.appScope?.fields ?? [];
     const duplicates = findDuplicateAppScopeResourceTypes(appScopeFields);