@wildo-ai/saas-frontend-lib 1.1.4 → 1.1.6

package/dist/esm/core/app-shell/useAppShellLayout.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAppShellLayout.js","sourceRoot":"","sources":["../../../../src/core/app-shell/useAppShellLayout.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useMemo } from 'react';\n\nimport { HorizontalPlacement, VerticalPlacement } from '@wildo-ai/presets-components-models';\nimport { ApplicationLevelComponentType } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { MainContextInitComponents } from '~wildo-frontend-lib/core/runtime/runtime.frontend.schemas';\n\nimport type { AppShellLayoutInfo } from './app-shell.schemas';\nimport { isSidebarConfigObject, isStatusBarConfigObject, isUtilityPanelConfigObject } from './app-shell.schemas';\n\n/**\n * Pure behavior hook for the app shell layout — computes which app-level\n * components are present and their placement, and gates application\n * initialization via `markComponentInitialized`.\n *\n * `has*` flags reflect *config presence*, not visibility (breakpoint-gated\n * visibility is the preset's responsibility).\n */\nexport function useAppShellLayout(): AppShellLayoutInfo {\n  const { UIConfig, navigationLayout: resolvedNavigationLayout, appComponentsConfiguration } = useUI();\n  const { markComponentInitialized } = useApplication();\n\n  const isLayoutReady = Boolean(resolvedNavigationLayout && appComponentsConfiguration);\n\n  useEffect(() => {\n    if (isLayoutReady) {\n      markComponentInitialized(MainContextInitComponents.APP_MAIN_CONTAINER);\n    }\n  }, [isLayoutReady, markComponentInitialized]);\n\n  return useMemo((): AppShellLayoutInfo => {\n    if (!isLayoutReady || !resolvedNavigationLayout || !appComponentsConfiguration) {\n      return {\n        hasMenubar: false,\n        hasSidebar: false,\n        hasStatusBar: false,\n        hasToolbar: false,\n        hasActivityBar: false,\n        hasQuickActionButton: false,\n        hasUtilityPanel: false,\n        sidebarPlacement: HorizontalPlacement.START,\n        statusBarPlacement: VerticalPlacement.BOTTOM,\n        utilityPanelPlacement: HorizontalPlacement.END,\n        isLayoutReady: false,\n      };\n    }\n\n    const sidebarConfig = appComponentsConfiguration[ApplicationLevelComponentType.SIDEBAR] as unknown;\n    const statusBarConfig = appComponentsConfiguration[ApplicationLevelComponentType.STATUS_BAR];\n    const utilityPanelConfig = appComponentsConfiguration[ApplicationLevelComponentType.UTILITY_PANEL];\n\n    const sidebarPlacement = isSidebarConfigObject(sidebarConfig)\n      ? sidebarConfig.placement\n      : HorizontalPlacement.START;\n\n    return {\n      hasMenubar: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.MENUBAR]),\n      hasSidebar: Boolean(sidebarConfig),\n      hasStatusBar: Boolean(statusBarConfig),\n      hasToolbar: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.TOOLBAR]),\n      hasActivityBar: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.ACTIVITY_BAR]),\n      hasQuickActionButton: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.QUICK_ACTION_BUTTON]),\n      hasUtilityPanel: Boolean(utilityPanelConfig),\n      sidebarPlacement,\n      statusBarPlacement: typeof statusBarConfig === 'string'\n        ? statusBarConfig as VerticalPlacement\n        : isStatusBarConfigObject(statusBarConfig)\n          ? statusBarConfig.placement ?? VerticalPlacement.BOTTOM\n          : VerticalPlacement.BOTTOM,\n      utilityPanelPlacement: isUtilityPanelConfigObject(utilityPanelConfig)\n        ? utilityPanelConfig.position ?? HorizontalPlacement.END\n        : HorizontalPlacement.END,\n      isLayoutReady: true,\n    };\n  }, [isLayoutReady, resolvedNavigationLayout, appComponentsConfiguration]);\n}\n"]}
+{"version":3,"file":"useAppShellLayout.js","sourceRoot":"","sources":["../../../../../src/core/app-shell/useAppShellLayout.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useMemo } from 'react';\n\nimport { HorizontalPlacement, VerticalPlacement } from '@wildo-ai/presets-components-models';\nimport { ApplicationLevelComponentType } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { MainContextInitComponents } from '~wildo-frontend-lib/core/runtime/runtime.frontend.schemas';\n\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\nimport { isStatusBarPlacement, type StatusBarPlacement } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\n\nimport type { AppShellLayoutInfo } from './app-shell.schemas';\nimport { isSidebarConfigObject, isStatusBarConfigObject, isUtilityPanelConfigObject } from './app-shell.schemas';\n\n/** Values already reported, so a render loop reports each unplaceable value once. */\nconst reportedStatusBarPlacements = new Set<string>();\n\n/**\n * The status bar's placement from its configuration: the shorthand string, or the object form's `placement`.\n *\n * Unconfigured means the bottom edge. A configured value no layout can place — `MIDDLE`, or any other string —\n * used to be passed through and render the status bar NOWHERE (#2037); it is now reported, and the status bar is\n * shown at the bottom edge, where an unconfigured one goes. Reporting rather than refusing: the configuration is\n * the application's to correct, and a missing status bar is a worse outcome than one at its default edge.\n */\nexport function resolveStatusBarPlacement(statusBarConfig: unknown): StatusBarPlacement {\n  const configured = typeof statusBarConfig === 'string'\n    ? statusBarConfig\n    : isStatusBarConfigObject(statusBarConfig) ? statusBarConfig.placement : undefined;\n  if (configured === undefined) return VerticalPlacement.BOTTOM;\n  if (isStatusBarPlacement(configured)) return configured;\n  const value = String(configured);\n  if (!reportedStatusBarPlacements.has(value)) {\n    reportedStatusBarPlacements.add(value);\n    LoggerFrontendService.getLogger().warn(\n      `[app-shell] the status bar is configured at '${value}', which no shell layout places (only '${VerticalPlacement.TOP}' and '${VerticalPlacement.BOTTOM}'); it is shown at '${VerticalPlacement.BOTTOM}'.`,\n    );\n  }\n  return VerticalPlacement.BOTTOM;\n}\n\n/**\n * Pure behavior hook for the app shell layout — computes which app-level\n * components are present and their placement, and gates application\n * initialization via `markComponentInitialized`.\n *\n * `has*` flags reflect *config presence*, not visibility (breakpoint-gated\n * visibility is the preset's responsibility).\n */\nexport function useAppShellLayout(): AppShellLayoutInfo {\n  const { UIConfig, navigationLayout: resolvedNavigationLayout, appComponentsConfiguration } = useUI();\n  const { markComponentInitialized } = useApplication();\n\n  const isLayoutReady = Boolean(resolvedNavigationLayout && appComponentsConfiguration);\n\n  useEffect(() => {\n    if (isLayoutReady) {\n      markComponentInitialized(MainContextInitComponents.APP_MAIN_CONTAINER);\n    }\n  }, [isLayoutReady, markComponentInitialized]);\n\n  return useMemo((): AppShellLayoutInfo => {\n    if (!isLayoutReady || !resolvedNavigationLayout || !appComponentsConfiguration) {\n      return {\n        hasMenubar: false,\n        hasSidebar: false,\n        hasStatusBar: false,\n        hasToolbar: false,\n        hasActivityBar: false,\n        hasQuickActionButton: false,\n        hasUtilityPanel: false,\n        sidebarPlacement: HorizontalPlacement.START,\n        statusBarPlacement: VerticalPlacement.BOTTOM,\n        utilityPanelPlacement: HorizontalPlacement.END,\n        isLayoutReady: false,\n      };\n    }\n\n    const sidebarConfig = appComponentsConfiguration[ApplicationLevelComponentType.SIDEBAR] as unknown;\n    const statusBarConfig = appComponentsConfiguration[ApplicationLevelComponentType.STATUS_BAR];\n    const utilityPanelConfig = appComponentsConfiguration[ApplicationLevelComponentType.UTILITY_PANEL];\n\n    const sidebarPlacement = isSidebarConfigObject(sidebarConfig)\n      ? sidebarConfig.placement\n      : HorizontalPlacement.START;\n\n    return {\n      hasMenubar: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.MENUBAR]),\n      hasSidebar: Boolean(sidebarConfig),\n      hasStatusBar: Boolean(statusBarConfig),\n      hasToolbar: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.TOOLBAR]),\n      hasActivityBar: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.ACTIVITY_BAR]),\n      hasQuickActionButton: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.QUICK_ACTION_BUTTON]),\n      hasUtilityPanel: Boolean(utilityPanelConfig),\n      sidebarPlacement,\n      statusBarPlacement: resolveStatusBarPlacement(statusBarConfig),\n      utilityPanelPlacement: isUtilityPanelConfigObject(utilityPanelConfig)\n        ? utilityPanelConfig.position ?? HorizontalPlacement.END\n        : HorizontalPlacement.END,\n      isLayoutReady: true,\n    };\n  }, [isLayoutReady, resolvedNavigationLayout, appComponentsConfiguration]);\n}\n"]}

package/dist/esm/core/app-shell/usePublicShellLayout.d.ts

@@ -1,3 +1,4 @@
+import type { AuthIdentificationResponse } from '@wildo-ai/saas-models';
 import type { PublicShellLayoutInfo } from './app-shell.schemas';
 /**
  * Pure behavior hook for the public shell layout.
@@ -5,5 +6,5 @@ import type { PublicShellLayoutInfo } from './app-shell.schemas';
  * Gates application initialization via `markComponentInitialized` on mount, exposes layout mode
  * (`useCardLayout`), and resolves the identity the public pages may present.
  */
-export declare function usePublicShellLayout(useCardLayout?: boolean): PublicShellLayoutInfo;
+export declare function usePublicShellLayout(useCardLayout?: boolean, organizationBranding?: AuthIdentificationResponse['organizationBranding']): PublicShellLayoutInfo;
 //# sourceMappingURL=usePublicShellLayout.d.ts.map

package/dist/esm/core/app-shell/usePublicShellLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usePublicShellLayout.d.ts","sourceRoot":"","sources":["../../../../src/core/app-shell/usePublicShellLayout.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,UAAQ,GAAG,qBAAqB,CA2BjF"}
+{"version":3,"file":"usePublicShellLayout.d.ts","sourceRoot":"","sources":["../../../../../src/core/app-shell/usePublicShellLayout.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAQxE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAqCjE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,UAAQ,EACrB,oBAAoB,CAAC,EAAE,0BAA0B,CAAC,sBAAsB,CAAC,GACxE,qBAAqB,CAyCvB"}

package/dist/esm/core/app-shell/usePublicShellLayout.js

@@ -1,15 +1,53 @@
 import { useEffect } from 'react';
+import { useUI } from '../../core/ui/useUI.js';
 import { useApplication } from '../../core/runtime/useApplication.js';
 import { MainContextInitComponents } from '../../core/runtime/runtime.frontend.schemas.js';
 import { PublicShellIdentityMode } from '../../core/config/app-configuration-frontend.schemas.js';
 import { useBrandIdentity } from '../../core/branding/useBrandIdentity.js';
+/**
+ * Show the tenant's favicon in the browser tab while its sign-in card is on screen (#1799).
+ *
+ * The organization's `branding.favicon` was stored, edited and read by nothing. The sign-in card is the
+ * one place organization branding is applied — its logo and colour already replace the application's
+ * there — so that is where its tab icon is applied too. Every `rel="icon"` link is pointed at the
+ * tenant's icon, and restored to what it was when the card goes away or the tenant changes, so the
+ * application's own icon returns everywhere else.
+ */
+function useTenantFavicon(faviconUrl) {
+    useEffect(() => {
+        if (!faviconUrl)
+            return undefined;
+        const links = Array.from(document.querySelectorAll('link[rel~="icon"]'));
+        const created = links.length === 0 ? document.createElement('link') : undefined;
+        if (created) {
+            created.rel = 'icon';
+            document.head.appendChild(created);
+        }
+        const targets = created ? [created] : links;
+        const previous = targets.map((link) => link.getAttribute('href'));
+        targets.forEach((link) => { link.href = faviconUrl; });
+        return () => {
+            if (created) {
+                created.remove();
+                return;
+            }
+            targets.forEach((link, index) => {
+                const href = previous[index];
+                if (href === null || href === undefined)
+                    link.removeAttribute('href');
+                else
+                    link.setAttribute('href', href);
+            });
+        };
+    }, [faviconUrl]);
+}
 /**
  * Pure behavior hook for the public shell layout.
  *
  * Gates application initialization via `markComponentInitialized` on mount, exposes layout mode
  * (`useCardLayout`), and resolves the identity the public pages may present.
  */
-export function usePublicShellLayout(useCardLayout = false) {
+export function usePublicShellLayout(useCardLayout = false, organizationBranding) {
     const { markComponentInitialized, frontendConfiguration } = useApplication();
     useEffect(() => {
         markComponentInitialized(MainContextInitComponents.PUBLIC_APP_CONTAINER);
@@ -26,11 +64,24 @@ export function usePublicShellLayout(useCardLayout = false) {
      * presentation layer branches on the composition it ACTUALLY got.
      */
     const brandIdentity = useBrandIdentity();
-    const brandHeader = frontendConfiguration.publicShellIdentityMode === PublicShellIdentityMode.BRAND_HEADER ? brandIdentity : undefined;
+    const { shellIdentity } = useUI();
+    // A tool shell represents itself, not the tenant in the application it observes. The explicit
+    // page input also prevents a previous login attempt from branding registration or legal pages.
+    const tenant = useCardLayout && !shellIdentity ? organizationBranding : undefined;
+    const loginIdentity = tenant ? {
+        name: tenant.organizationName || brandIdentity.name,
+        logoUrl: tenant.logoUrl || brandIdentity.logoUrl,
+        // Neither a tenant URL nor an application fallback proves that the mark contains the tenant
+        // name. Keep that name visible instead of applying application-wordmark suppression.
+        logoComposition: undefined,
+    } : brandIdentity;
+    const brandHeader = frontendConfiguration.publicShellIdentityMode === PublicShellIdentityMode.BRAND_HEADER ? loginIdentity : undefined;
+    useTenantFavicon(tenant?.faviconUrl);
     return {
         useCardLayout,
         isReady: true,
         brandHeader,
+        brandAccentColor: brandHeader ? tenant?.primaryColor : undefined,
     };
 }
 //# sourceMappingURL=usePublicShellLayout.js.map

package/dist/esm/core/app-shell/usePublicShellLayout.js.map

@@ -1 +1 @@
-{"version":3,"file":"usePublicShellLayout.js","sourceRoot":"","sources":["../../../../src/core/app-shell/usePublicShellLayout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2DAA2D,CAAC;AACtG,OAAO,EAAE,uBAAuB,EAAE,MAAM,oEAAoE,CAAC;AAC7G,OAAO,EAAE,gBAAgB,EAAE,MAAM,oDAAoD,CAAC;AAItF;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,aAAa,GAAG,KAAK;IACxD,MAAM,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,GAAG,cAAc,EAAE,CAAC;IAE7E,SAAS,CAAC,GAAG,EAAE;QACb,wBAAwB,CAAC,yBAAyB,CAAC,oBAAoB,CAAC,CAAC;IAC3E,CAAC,EAAE,CAAC,wBAAwB,CAAC,CAAC,CAAC;IAE/B;;;;;;;;;;OAUG;IACH,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;IACzC,MAAM,WAAW,GACf,qBAAqB,CAAC,uBAAuB,KAAK,uBAAuB,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;IAErH,OAAO;QACL,aAAa;QACb,OAAO,EAAE,IAAI;QACb,WAAW;KACZ,CAAC;AACJ,CAAC","sourcesContent":["import { useEffect } from 'react';\n\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { MainContextInitComponents } from '~wildo-frontend-lib/core/runtime/runtime.frontend.schemas';\nimport { PublicShellIdentityMode } from '~wildo-frontend-lib/core/config/app-configuration-frontend.schemas';\nimport { useBrandIdentity } from '~wildo-frontend-lib/core/branding/useBrandIdentity';\n\nimport type { PublicShellLayoutInfo } from './app-shell.schemas';\n\n/**\n * Pure behavior hook for the public shell layout.\n *\n * Gates application initialization via `markComponentInitialized` on mount, exposes layout mode\n * (`useCardLayout`), and resolves the identity the public pages may present.\n */\nexport function usePublicShellLayout(useCardLayout = false): PublicShellLayoutInfo {\n  const { markComponentInitialized, frontendConfiguration } = useApplication();\n\n  useEffect(() => {\n    markComponentInitialized(MainContextInitComponents.PUBLIC_APP_CONTAINER);\n  }, [markComponentInitialized]);\n\n  /*\n   * Read UNCONDITIONALLY (rules of hooks) but EXPOSED only in the opted-in mode, which is exactly\n   * how `useSidebarBehavior` gates its own brand header — so a preset cannot render an application's\n   * mark on a surface the application never opted into, and the gate lives in one place rather than\n   * in each preset that happens to remember it.\n   *\n   * `SYMBOL` is the requested composition (the default): the header renders the NAME as text beside\n   * the mark, and a lockup would print the name twice. `resolveBrandAsset`'s last fallback rung can\n   * still return a wordmark or lockup for a brand that generated no symbol, which is why the\n   * presentation layer branches on the composition it ACTUALLY got.\n   */\n  const brandIdentity = useBrandIdentity();\n  const brandHeader =\n    frontendConfiguration.publicShellIdentityMode === PublicShellIdentityMode.BRAND_HEADER ? brandIdentity : undefined;\n\n  return {\n    useCardLayout,\n    isReady: true,\n    brandHeader,\n  };\n}\n"]}
+{"version":3,"file":"usePublicShellLayout.js","sourceRoot":"","sources":["../../../../../src/core/app-shell/usePublicShellLayout.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect } from 'react';\nimport type { AuthIdentificationResponse } from '@wildo-ai/saas-models';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\n\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { MainContextInitComponents } from '~wildo-frontend-lib/core/runtime/runtime.frontend.schemas';\nimport { PublicShellIdentityMode } from '~wildo-frontend-lib/core/config/app-configuration-frontend.schemas';\nimport { useBrandIdentity } from '~wildo-frontend-lib/core/branding/useBrandIdentity';\n\nimport type { PublicShellLayoutInfo } from './app-shell.schemas';\n\n/**\n * Show the tenant's favicon in the browser tab while its sign-in card is on screen (#1799).\n *\n * The organization's `branding.favicon` was stored, edited and read by nothing. The sign-in card is the\n * one place organization branding is applied — its logo and colour already replace the application's\n * there — so that is where its tab icon is applied too. Every `rel=\"icon\"` link is pointed at the\n * tenant's icon, and restored to what it was when the card goes away or the tenant changes, so the\n * application's own icon returns everywhere else.\n */\nfunction useTenantFavicon(faviconUrl: string | undefined): void {\n  useEffect(() => {\n    if (!faviconUrl) return undefined;\n    const links = Array.from(document.querySelectorAll<HTMLLinkElement>('link[rel~=\"icon\"]'));\n    const created = links.length === 0 ? document.createElement('link') : undefined;\n    if (created) {\n      created.rel = 'icon';\n      document.head.appendChild(created);\n    }\n    const targets = created ? [created] : links;\n    const previous = targets.map((link) => link.getAttribute('href'));\n    targets.forEach((link) => { link.href = faviconUrl; });\n    return () => {\n      if (created) {\n        created.remove();\n        return;\n      }\n      targets.forEach((link, index) => {\n        const href = previous[index];\n        if (href === null || href === undefined) link.removeAttribute('href');\n        else link.setAttribute('href', href);\n      });\n    };\n  }, [faviconUrl]);\n}\n\n/**\n * Pure behavior hook for the public shell layout.\n *\n * Gates application initialization via `markComponentInitialized` on mount, exposes layout mode\n * (`useCardLayout`), and resolves the identity the public pages may present.\n */\nexport function usePublicShellLayout(\n  useCardLayout = false,\n  organizationBranding?: AuthIdentificationResponse['organizationBranding'],\n): PublicShellLayoutInfo {\n  const { markComponentInitialized, frontendConfiguration } = useApplication();\n\n  useEffect(() => {\n    markComponentInitialized(MainContextInitComponents.PUBLIC_APP_CONTAINER);\n  }, [markComponentInitialized]);\n\n  /*\n   * Read UNCONDITIONALLY (rules of hooks) but EXPOSED only in the opted-in mode, which is exactly\n   * how `useSidebarBehavior` gates its own brand header — so a preset cannot render an application's\n   * mark on a surface the application never opted into, and the gate lives in one place rather than\n   * in each preset that happens to remember it.\n   *\n   * `SYMBOL` is the requested composition (the default): the header renders the NAME as text beside\n   * the mark, and a lockup would print the name twice. `resolveBrandAsset`'s last fallback rung can\n   * still return a wordmark or lockup for a brand that generated no symbol, which is why the\n   * presentation layer branches on the composition it ACTUALLY got.\n   */\n  const brandIdentity = useBrandIdentity();\n  const { shellIdentity } = useUI();\n  // A tool shell represents itself, not the tenant in the application it observes. The explicit\n  // page input also prevents a previous login attempt from branding registration or legal pages.\n  const tenant = useCardLayout && !shellIdentity ? organizationBranding : undefined;\n  const loginIdentity = tenant ? {\n    name: tenant.organizationName || brandIdentity.name,\n    logoUrl: tenant.logoUrl || brandIdentity.logoUrl,\n    // Neither a tenant URL nor an application fallback proves that the mark contains the tenant\n    // name. Keep that name visible instead of applying application-wordmark suppression.\n    logoComposition: undefined,\n  } : brandIdentity;\n  const brandHeader =\n    frontendConfiguration.publicShellIdentityMode === PublicShellIdentityMode.BRAND_HEADER ? loginIdentity : undefined;\n\n  useTenantFavicon(tenant?.faviconUrl);\n\n  return {\n    useCardLayout,\n    isReady: true,\n    brandHeader,\n    brandAccentColor: brandHeader ? tenant?.primaryColor : undefined,\n  };\n}\n"]}

package/dist/esm/core/automated-layout/automated-layout.frontend.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"automated-layout.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../src/core/automated-layout/automated-layout.frontend.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACf,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAO7B;;;GAGG;AACH,eAAO,MAAM,uBAAuB,yBAAyB,CAAC;AAM9D;;;GAGG;AACH;;;;;;;;;GASG;AACH,oBAAY,2BAA2B;IACrC,2DAA2D;IAC3D,IAAI,SAAS;IACb,wDAAwD;IACxD,OAAO,YAAY;CACpB;AAED,oBAAY,eAAe;IACzB,yCAAyC;IACzC,OAAO,YAAY;IACnB,gDAAgD;IAChD,OAAO,YAAY;IACnB,mCAAmC;IACnC,MAAM,WAAW;IACjB,+EAA+E;IAC/E,KAAK,UAAU;IACf,iCAAiC;IACjC,KAAK,UAAU;CAChB;AAMD;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GACzB,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,IAAI,GAC1B,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAMlB;;;;;;;GAOG;AACH,MAAM,WAAW,2BAA2B;IAC1C,yEAAyE;IACzE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,4EAA4E;IAC5E,0CAA0C,CAAC,EAAE,MAAM,EAAE,CAAC;IACtD,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,KAAK,CAAC;QACvB,+CAA+C;QAC/C,uBAAuB,EAAE,MAAM,CAAC;QAChC,2CAA2C;QAC3C,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;QACrB,8DAA8D;QAC9D,2BAA2B,CAAC,EAAE,2BAA2B,CAAC;KAC3D,CAAC,CAAC;CACJ"}
+{"version":3,"file":"automated-layout.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/core/automated-layout/automated-layout.frontend.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACf,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAO7B;;;GAGG;AACH,eAAO,MAAM,uBAAuB,yBAAyB,CAAC;AAM9D;;;GAGG;AACH;;;;;;;;;GASG;AACH,oBAAY,2BAA2B;IACrC,2DAA2D;IAC3D,IAAI,SAAS;IACb,wDAAwD;IACxD,OAAO,YAAY;CACpB;AAED,oBAAY,eAAe;IACzB,yCAAyC;IACzC,OAAO,YAAY;IACnB,gDAAgD;IAChD,OAAO,YAAY;IACnB,mCAAmC;IACnC,MAAM,WAAW;IACjB,+EAA+E;IAC/E,KAAK,UAAU;IACf,iCAAiC;IACjC,KAAK,UAAU;CAChB;AAMD;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GACzB,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,IAAI,GAC1B,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAMlB;;;;;;;GAOG;AACH,MAAM,WAAW,2BAA2B;IAC1C,yEAAyE;IACzE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,4EAA4E;IAC5E,0CAA0C,CAAC,EAAE,MAAM,EAAE,CAAC;IACtD,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,KAAK,CAAC;QACvB,+CAA+C;QAC/C,uBAAuB,EAAE,MAAM,CAAC;QAChC,2CAA2C;QAC3C,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;QACrB,8DAA8D;QAC9D,2BAA2B,CAAC,EAAE,2BAA2B,CAAC;KAC3D,CAAC,CAAC;CACJ"}

package/dist/esm/core/automated-layout/automated-layout.frontend.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"automated-layout.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/automated-layout/automated-layout.frontend.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GACf,MAAM,0BAA0B,CAAC;AAOlC,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,cAAc,CAAC,OAAO,CAAC;AAE9D,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;;GAGG;AACH;;;;;;;;;GASG;AACH,MAAM,CAAN,IAAY,2BAKX;AALD,WAAY,2BAA2B;IACrC,2DAA2D;IAC3D,4CAAa,CAAA;IACb,wDAAwD;IACxD,kDAAmB,CAAA;AACrB,CAAC,EALW,2BAA2B,KAA3B,2BAA2B,QAKtC;AAED,MAAM,CAAN,IAAY,eAWX;AAXD,WAAY,eAAe;IACzB,yCAAyC;IACzC,sCAAmB,CAAA;IACnB,gDAAgD;IAChD,sCAAmB,CAAA;IACnB,mCAAmC;IACnC,oCAAiB,CAAA;IACjB,+EAA+E;IAC/E,kCAAe,CAAA;IACf,iCAAiC;IACjC,kCAAe,CAAA;AACjB,CAAC,EAXW,eAAe,KAAf,eAAe,QAW1B","sourcesContent":["import {\n  ValidationMode,\n} from '@wildo-ai/zod-decorators';\n\nimport { CoreResourceOperation } from '@wildo-ai/saas-models';\n\nimport type { z } from 'zod';\n\n\n// =============================================================================\n// VALIDATION CONSTANTS\n// =============================================================================\n\n/**\n * Default validation mode for all forms.\n * Centralized constant for consistent default behavior.\n */\nexport const DEFAULT_VALIDATION_MODE = ValidationMode.ON_BLUR;\n\n// =============================================================================\n// INLINE EDIT STATE\n// =============================================================================\n\n/**\n * State enum for inline field editing.\n * Represents the different states a field can be in during inline editing.\n */\n/**\n * Which of the two automated-layout generators a diagnostic is reporting for.\n *\n * A named source rather than a `'form' | 'display'` literal union, so the distinction has one\n * runtime home and each member can say what it means. Deliberately NOT reusing\n * `GroupedSectionHostKind` (which adds `COMPOSITE` and answers \"what hosts this section\") or\n * `MutationSourceType` (which answers \"what initiated this mutation\"): all three happen to spell\n * two members the same way, and merging vocabularies because their wire values overlap is what the\n * framework's own semantic rule forbids.\n */\nexport enum AutomatedLayoutTemplateKind {\n  /** The editable template — fields become form controls. */\n  FORM = 'form',\n  /** The read template — fields become display chrome. */\n  DISPLAY = 'display',\n}\n\nexport enum InlineEditState {\n  /** Displaying value, not in edit mode */\n  DISPLAY = 'display',\n  /** In edit mode, user is modifying the value */\n  EDITING = 'editing',\n  /** Saving changes to the server */\n  SAVING = 'saving',\n  /** Save completed successfully (brief feedback before returning to DISPLAY) */\n  SAVED = 'saved',\n  /** Save failed, showing error */\n  ERROR = 'error',\n}\n\n// =============================================================================\n// FORM OPERATION TYPE\n// =============================================================================\n\n/**\n * Operation type for controlling field visibility based on operation context.\n * Uses CoreResourceOperation enum values for type safety.\n * Used with excludeFromCreate, excludeFromUpdate, and isHidden(operations) decorators.\n * \n * Branded with `& {}` to allow custom string values through type assertion\n * without collapsing the entire union to `string` (which kills autocomplete).\n */\nexport type FormOperationType = \n  | CoreResourceOperation.CREATE \n  | CoreResourceOperation.UPDATE \n  | CoreResourceOperation.READ\n  | (string & {});\n\n// =============================================================================\n// INHERITANCE SCHEMA DEFINITION\n// =============================================================================\n\n/**\n * Inheritance schema definition for discriminated unions.\n * Used to track which fields belong to which variants for conditional visibility.\n * \n * This is a simplified, non-generic version of ResourceConfiguration_InheritanceSchemaDefinition\n * from @wildo-ai/saas-models, optimized for frontend use. It is structurally compatible\n * with the backend type but avoids complex generics that aren't needed for UI rendering.\n */\nexport interface InheritanceSchemaDefinition {\n  /** Field name used for discrimination (e.g., 'type', 'recurringType') */\n  discriminatorField: string;\n  /** Discriminator values that use base schema only (no variant extension) */\n  withoutInheritanceDiscriminatorFieldValues?: string[];\n  /** Variant schemas for each discriminator value */\n  inheritedSchemas?: Array<{\n    /** The discriminator value for this variant */\n    discriminatorFieldValue: string;\n    /** The extended schema for this variant */\n    schema: z.ZodTypeAny;\n    /** Nested inheritance for multi-level discriminated unions */\n    inheritenceSchemaDefinition?: InheritanceSchemaDefinition;\n  }>;\n}\n"]}
+{"version":3,"file":"automated-layout.frontend.schemas.js","sourceRoot":"","sources":["../../../../../src/core/automated-layout/automated-layout.frontend.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GACf,MAAM,0BAA0B,CAAC;AAOlC,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,cAAc,CAAC,OAAO,CAAC;AAE9D,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;;GAGG;AACH;;;;;;;;;GASG;AACH,MAAM,CAAN,IAAY,2BAKX;AALD,WAAY,2BAA2B;IACrC,2DAA2D;IAC3D,4CAAa,CAAA;IACb,wDAAwD;IACxD,kDAAmB,CAAA;AACrB,CAAC,EALW,2BAA2B,KAA3B,2BAA2B,QAKtC;AAED,MAAM,CAAN,IAAY,eAWX;AAXD,WAAY,eAAe;IACzB,yCAAyC;IACzC,sCAAmB,CAAA;IACnB,gDAAgD;IAChD,sCAAmB,CAAA;IACnB,mCAAmC;IACnC,oCAAiB,CAAA;IACjB,+EAA+E;IAC/E,kCAAe,CAAA;IACf,iCAAiC;IACjC,kCAAe,CAAA;AACjB,CAAC,EAXW,eAAe,KAAf,eAAe,QAW1B","sourcesContent":["import {\n  ValidationMode,\n} from '@wildo-ai/zod-decorators';\n\nimport { CoreResourceOperation } from '@wildo-ai/saas-models';\n\nimport type { z } from 'zod';\n\n\n// =============================================================================\n// VALIDATION CONSTANTS\n// =============================================================================\n\n/**\n * Default validation mode for all forms.\n * Centralized constant for consistent default behavior.\n */\nexport const DEFAULT_VALIDATION_MODE = ValidationMode.ON_BLUR;\n\n// =============================================================================\n// INLINE EDIT STATE\n// =============================================================================\n\n/**\n * State enum for inline field editing.\n * Represents the different states a field can be in during inline editing.\n */\n/**\n * Which of the two automated-layout generators a diagnostic is reporting for.\n *\n * A named source rather than a `'form' | 'display'` literal union, so the distinction has one\n * runtime home and each member can say what it means. Deliberately NOT reusing\n * `GroupedSectionHostKind` (which adds `COMPOSITE` and answers \"what hosts this section\") or\n * `MutationSourceType` (which answers \"what initiated this mutation\"): all three happen to spell\n * two members the same way, and merging vocabularies because their wire values overlap is what the\n * framework's own semantic rule forbids.\n */\nexport enum AutomatedLayoutTemplateKind {\n  /** The editable template — fields become form controls. */\n  FORM = 'form',\n  /** The read template — fields become display chrome. */\n  DISPLAY = 'display',\n}\n\nexport enum InlineEditState {\n  /** Displaying value, not in edit mode */\n  DISPLAY = 'display',\n  /** In edit mode, user is modifying the value */\n  EDITING = 'editing',\n  /** Saving changes to the server */\n  SAVING = 'saving',\n  /** Save completed successfully (brief feedback before returning to DISPLAY) */\n  SAVED = 'saved',\n  /** Save failed, showing error */\n  ERROR = 'error',\n}\n\n// =============================================================================\n// FORM OPERATION TYPE\n// =============================================================================\n\n/**\n * Operation type for controlling field visibility based on operation context.\n * Uses CoreResourceOperation enum values for type safety.\n * Used with excludeFromCreate, excludeFromUpdate, and isHidden(operations) decorators.\n * \n * Branded with `& {}` to allow custom string values through type assertion\n * without collapsing the entire union to `string` (which kills autocomplete).\n */\nexport type FormOperationType = \n  | CoreResourceOperation.CREATE \n  | CoreResourceOperation.UPDATE \n  | CoreResourceOperation.READ\n  | (string & {});\n\n// =============================================================================\n// INHERITANCE SCHEMA DEFINITION\n// =============================================================================\n\n/**\n * Inheritance schema definition for discriminated unions.\n * Used to track which fields belong to which variants for conditional visibility.\n * \n * This is a simplified, non-generic version of ResourceConfiguration_InheritanceSchemaDefinition\n * from @wildo-ai/saas-models, optimized for frontend use. It is structurally compatible\n * with the backend type but avoids complex generics that aren't needed for UI rendering.\n */\nexport interface InheritanceSchemaDefinition {\n  /** Field name used for discrimination (e.g., 'type', 'recurringType') */\n  discriminatorField: string;\n  /** Discriminator values that use base schema only (no variant extension) */\n  withoutInheritanceDiscriminatorFieldValues?: string[];\n  /** Variant schemas for each discriminator value */\n  inheritedSchemas?: Array<{\n    /** The discriminator value for this variant */\n    discriminatorFieldValue: string;\n    /** The extended schema for this variant */\n    schema: z.ZodTypeAny;\n    /** Nested inheritance for multi-level discriminated unions */\n    inheritenceSchemaDefinition?: InheritanceSchemaDefinition;\n  }>;\n}\n"]}

package/dist/esm/core/automated-layout/automated-layout.frontend.utils.d.ts

@@ -42,14 +42,17 @@ export declare class AutomatedLayoutFrontendUtils {
      */
     static unresolvedFieldLabel(key: string): string;
     /**
-     * Fallback: format a full dotted field path for display in error messages and breadcrumbs.
-     * Each segment is formatted individually and joined with ` › `.
-     * Array indices (pure numbers) are converted to 1-based display format.
-     * Used when i18n label resolution is not available.
+     * Join a dotted field path for display in error messages and breadcrumbs, with array indices
+     * rendered 1-based.
+     *
+     * Each segment passes through {@link unresolvedFieldLabel}, which since 2026-09-08 (#420) is the
+     * IDENTITY function — so this reads as the raw path with separators, never as invented words. It
+     * is reached only when no i18n resolver is available, and a path that looks like a path is the
+     * honest rendering of that: see `.claude/rules/display-text-comes-from-i18n.md`.
      *
      * @example
-     * formatFieldPathFallback('address.streetName') → 'Address › Street Name'
-     * formatFieldPathFallback('items.0.name') → 'Items › [1] › Name'
+     * formatFieldPathFallback('address.streetName') → 'address › streetName'
+     * formatFieldPathFallback('items.0.name') → 'items › [1] › name'
      */
     static formatFieldPathFallback(path: string): string;
     /**
@@ -63,18 +66,34 @@ export declare class AutomatedLayoutFrontendUtils {
      */
     static normalizeSchemaFieldPath(path: string): string;
     /**
-     * Create a field label resolver that tries i18n first, falling back to camelCase conversion.
-     * Returns a function that resolves a dot-path to a human-readable label.
+     * Create a field label resolver that resolves each path segment through i18n, and renders the raw
+     * segment when no label is authored.
      *
      * When `resourceType` is provided, each path segment is resolved via `tResourceFieldEdit`.
-     * If the i18n lookup returns the raw key (not found), falls back to `unresolvedFieldLabel`.
+     * If the i18n lookup returns the raw key (not found), the segment falls through
+     * {@link unresolvedFieldLabel} — the identity function, so a missing label READS as missing
+     * rather than as a plausible name.
      * When `resourceType` is not provided, uses `formatFieldPathFallback` directly.
      *
+     * ## A path that ends INSIDE a structured value names the value (#1959)
+     *
+     * A validation error on a money field's amount arrives at `amount.amount`, on an address's first
+     * line at `address.line1`. Those parts are not fields of the resource: the value's own component
+     * draws and names them, and the resource has one word for the whole value — so no label is planned
+     * for `amount.amount`, and asking for one would render the raw part name after the field's label.
+     * Given the form's `schema`, the resolver stops at the first segment whose schema does not hold
+     * fields (`isFieldContainerSchema`) and names that field alone. The inline error beside the part
+     * still says which part. Without a schema every segment is resolved as before.
+     *
+     * The same boundary ends a path into an ARRAY that continues with a name rather than an index —
+     * `tags.root`, where react-hook-form puts an error about the list itself — which names the list.
+     *
      * @param resourceType - The resource type for i18n lookup
      * @param tResourceFieldEdit - i18n function for field label resolution
+     * @param schema - The form's schema, when known: lets the resolver stop at a structured value
      * @returns A function that resolves a dot-path to a human-readable label
      */
-    static createFieldLabelResolver(resourceType: string | undefined, tResourceFieldEdit: (resourceType: string, fieldPath: string, key: string) => string): (path: string) => string;
+    static createFieldLabelResolver(resourceType: string | undefined, tResourceFieldEdit: (resourceType: string, fieldPath: string, key: string) => string, schema?: z.ZodTypeAny): (path: string) => string;
     /**
      * Return object variants when a schema is a discriminated union of objects.
      * Returns an empty array for plain objects or non-object unions.
@@ -156,6 +175,8 @@ export declare class AutomatedLayoutFrontendUtils {
      * **by item shape** — the framework's opinion about which add affordance fits:
      *
      * - **primitive** item → {@link ArrayAddMode.QUICK_ADD} (type-and-commit a value).
+     * - **address** item → {@link ArrayAddMode.APPEND_INLINE}: one structured value with no single
+     *   part that summarises it, so a typed quick-add string could never become an item.
      * - **object with ≤ 1 prominent field** (string/number; e.g. checklist
      *   `{ label, done }` — `label` is the only typed field) → `QUICK_ADD`. The single
      *   typed field is staged in the add-row; the rest (booleans, enums) seed defaults.

package/dist/esm/core/automated-layout/automated-layout.frontend.utils.d.ts.map

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

package/dist/esm/core/automated-layout/automated-layout.frontend.utils.js

@@ -1,4 +1,29 @@
-import { FieldSchemaType, getFileMetadata, getEnumValues, getSchemaType, getObjectShape, getArrayUI, ArrayAddMode, getZodObjectShape, getDiscriminatorParams, getZodDefArrayProperty, getZodDefProperty, getZodDefStringProperty, getZodType, isOptional, isZodArray, isZodObject, ValidationMode, ShowWhenOperator, getShowWhenParams, isFileSchema, unwrapSchema, FileGenerationSource, } from '@wildo-ai/zod-decorators';
+import { FieldSchemaType, getFileMetadata, getAddressMetadata, getCodeMetadata, getCodeUI, getEnumValues, getSchemaType, getObjectShape, getArrayItemSchema, getArrayUI, ArrayAddMode, getZodObjectShape, getDiscriminatorParams, getZodDefArrayProperty, getZodDefProperty, getZodDefStringProperty, getZodType, isOptional, isZodArray, isZodObject, ValidationMode, ShowWhenOperator, getShowWhenParams, isFileSchema, isFieldContainerSchema, unwrapSchema, FileGenerationSource, } from '@wildo-ai/zod-decorators';
+import { createDurationFieldDefaultValue, createMoneyFieldDefaultValue } from './composite-value-defaults.frontend.utils.js';
+/**
+ * Field types whose value is ONE structured object although `getSchemaType` does not answer `OBJECT`.
+ *
+ * A list of them cannot use the quick-add box: the box stages the typed TEXT and commits only what the
+ * item schema accepts, and no string is an address, an amount of money or a duration — so nothing could
+ * ever be added (#561, #990). Their items append a draft from `getDefaultValueForSchema` instead.
+ *
+ * `CODE` and the `RANGE_*` types are structured values too and are not listed yet: a draft for them is
+ * not built, and switching the add mode alone would append an item that can never become valid (#1073).
+ */
+const STRUCTURED_VALUE_ITEM_TYPES = new Set([
+    FieldSchemaType.ADDRESS,
+    FieldSchemaType.MONEY,
+    FieldSchemaType.DURATION,
+    // A code value is `{ content, language }` and a range is `{ from, to }` — objects to the schema and
+    // structured values to `getSchemaType`, so the same rule (#1073): append a draft, never a text box.
+    FieldSchemaType.CODE,
+    FieldSchemaType.RANGE_NUMBER,
+    FieldSchemaType.RANGE_DATE,
+    FieldSchemaType.RANGE_DATETIME,
+    FieldSchemaType.RANGE_TIME,
+    FieldSchemaType.RANGE_BIGDECIMAL,
+    FieldSchemaType.RANGE_MONEY,
+]);
 export class AutomatedLayoutFrontendUtils {
     static buildUnsupportedPlainUnionFileFieldMessage(pathPrefix) {
         return `Unsupported z.union() file field schema detected at "${pathPrefix || '<root>'}". File fields inside non-discriminated unions must use z.discriminatedUnion().`;
@@ -111,14 +136,17 @@ export class AutomatedLayoutFrontendUtils {
         return key;
     }
     /**
-     * Fallback: format a full dotted field path for display in error messages and breadcrumbs.
-     * Each segment is formatted individually and joined with ` › `.
-     * Array indices (pure numbers) are converted to 1-based display format.
-     * Used when i18n label resolution is not available.
+     * Join a dotted field path for display in error messages and breadcrumbs, with array indices
+     * rendered 1-based.
+     *
+     * Each segment passes through {@link unresolvedFieldLabel}, which since 2026-09-08 (#420) is the
+     * IDENTITY function — so this reads as the raw path with separators, never as invented words. It
+     * is reached only when no i18n resolver is available, and a path that looks like a path is the
+     * honest rendering of that: see `.claude/rules/display-text-comes-from-i18n.md`.
      *
      * @example
-     * formatFieldPathFallback('address.streetName') → 'Address › Street Name'
-     * formatFieldPathFallback('items.0.name') → 'Items › [1] › Name'
+     * formatFieldPathFallback('address.streetName') → 'address › streetName'
+     * formatFieldPathFallback('items.0.name') → 'items › [1] › name'
      */
     static formatFieldPathFallback(path) {
         return path
@@ -141,37 +169,73 @@ export class AutomatedLayoutFrontendUtils {
         return path.replace(/\[\d+\]/g, '');
     }
     /**
-     * Create a field label resolver that tries i18n first, falling back to camelCase conversion.
-     * Returns a function that resolves a dot-path to a human-readable label.
+     * Create a field label resolver that resolves each path segment through i18n, and renders the raw
+     * segment when no label is authored.
      *
      * When `resourceType` is provided, each path segment is resolved via `tResourceFieldEdit`.
-     * If the i18n lookup returns the raw key (not found), falls back to `unresolvedFieldLabel`.
+     * If the i18n lookup returns the raw key (not found), the segment falls through
+     * {@link unresolvedFieldLabel} — the identity function, so a missing label READS as missing
+     * rather than as a plausible name.
      * When `resourceType` is not provided, uses `formatFieldPathFallback` directly.
      *
+     * ## A path that ends INSIDE a structured value names the value (#1959)
+     *
+     * A validation error on a money field's amount arrives at `amount.amount`, on an address's first
+     * line at `address.line1`. Those parts are not fields of the resource: the value's own component
+     * draws and names them, and the resource has one word for the whole value — so no label is planned
+     * for `amount.amount`, and asking for one would render the raw part name after the field's label.
+     * Given the form's `schema`, the resolver stops at the first segment whose schema does not hold
+     * fields (`isFieldContainerSchema`) and names that field alone. The inline error beside the part
+     * still says which part. Without a schema every segment is resolved as before.
+     *
+     * The same boundary ends a path into an ARRAY that continues with a name rather than an index —
+     * `tags.root`, where react-hook-form puts an error about the list itself — which names the list.
+     *
      * @param resourceType - The resource type for i18n lookup
      * @param tResourceFieldEdit - i18n function for field label resolution
+     * @param schema - The form's schema, when known: lets the resolver stop at a structured value
      * @returns A function that resolves a dot-path to a human-readable label
      */
-    static createFieldLabelResolver(resourceType, tResourceFieldEdit) {
+    static createFieldLabelResolver(resourceType, tResourceFieldEdit, schema) {
         if (!resourceType) {
             return AutomatedLayoutFrontendUtils.formatFieldPathFallback;
         }
         return (path) => {
             const segments = path.split('.');
-            return segments
-                .map((segment, index) => {
+            const rendered = [];
+            /*
+             * The schema of the value the NEXT segment addresses: the form's own schema at the root, then
+             * each field's, then an array's item after an index. `undefined` once the walk cannot follow the
+             * path, which leaves every remaining segment resolved as it always was.
+             */
+            let current = schema;
+            for (const [index, segment] of segments.entries()) {
                 if (/^\d+$/.test(segment)) {
-                    return `[${parseInt(segment, 10) + 1}]`;
+                    rendered.push(`[${parseInt(segment, 10) + 1}]`);
+                    current = current && getSchemaType(current) === FieldSchemaType.ARRAY ? (getArrayItemSchema(current) ?? undefined) : undefined;
+                    continue;
                 }
-                const fieldPath = segments.slice(0, index + 1).join('.');
+                // Everything below a value that holds no fields is that value's own part: the field is already named.
+                if (current && rendered.length > 0 && !isFieldContainerSchema(current))
+                    break;
+                /*
+                 * Labels are per FIELD, not per row: the key is index-free (`lines.label`, never `lines.2.label`), the
+                 * same path the renderer's walk and the labelling planner use. Joining the raw segments asked for a key
+                 * nothing plans, so an error inside any array item rendered its raw field name.
+                 */
+                const fieldPath = segments.slice(0, index + 1).filter((part) => !/^\d+$/.test(part)).join('.');
                 const label = tResourceFieldEdit(resourceType, fieldPath, 'label');
-                const rawI18nKey = `${resourceType}.${fieldPath}.label`;
-                if (label === rawI18nKey) {
-                    return AutomatedLayoutFrontendUtils.unresolvedFieldLabel(segment);
-                }
-                return label;
-            })
-                .join(' › ');
+                /*
+                 * A miss answers the bare FIELD PATH (`tResourceFieldEdit` hands its key to `unresolvedFieldLabel`), so that
+                 * is what a miss looks like here. This compared against `<resource>.<path>.label`, which no lookup ever
+                 * returns, so a missing label for `profile.city` rendered `profile › profile.city` instead of the segment.
+                 */
+                rendered.push(label === fieldPath ? AutomatedLayoutFrontendUtils.unresolvedFieldLabel(segment) : label);
+                current = current
+                    ? AutomatedLayoutFrontendUtils.getObjectLikeFieldShape(current, { commonOnly: false })?.[segment]
+                    : undefined;
+            }
+            return rendered.join(' › ');
         };
     }
     // =============================================================================
@@ -269,10 +333,14 @@ export class AutomatedLayoutFrontendUtils {
                 return undefined;
             }
             if (/^\d+$/.test(token)) {
-                if (!isZodArray(current)) {
+                // An array field is usually `.optional()`: step through its wrappers to reach the array, the
+                // way `getObjectLikeFieldShape` does for an object — otherwise an item path under an optional
+                // array (`checklist.0.label`) resolves to nothing.
+                const arraySchema = unwrapSchema(current);
+                if (!isZodArray(arraySchema)) {
                     return undefined;
                 }
-                current = getZodDefProperty(current, 'element');
+                current = getZodDefProperty(arraySchema, 'element');
                 continue;
             }
             const shape = this.getObjectLikeFieldShape(current);
@@ -306,6 +374,8 @@ export class AutomatedLayoutFrontendUtils {
             case FieldSchemaType.MONEY:
             case FieldSchemaType.BIGDECIMAL:
             case FieldSchemaType.CODE:
+            // An address is typed part by part; its control reports blur when focus leaves the whole group.
+            case FieldSchemaType.ADDRESS:
                 return ValidationMode.ON_BLUR;
             case FieldSchemaType.ENUM:
             case FieldSchemaType.BOOLEAN:
@@ -352,7 +422,6 @@ export class AutomatedLayoutFrontendUtils {
             case FieldSchemaType.NUMBER:
             case FieldSchemaType.BIGINT:
             case FieldSchemaType.BIGDECIMAL:
-            case FieldSchemaType.MONEY:
                 return 0;
             case FieldSchemaType.BOOLEAN:
                 return false;
@@ -363,6 +432,57 @@ export class AutomatedLayoutFrontendUtils {
                 const values = getEnumValues(schema);
                 return values.length > 0 ? values[0] : '';
             }
+            case FieldSchemaType.ADDRESS: {
+                // An address is ONE value. An optional one stays `undefined` for the same reason an optional
+                // object does (below); a required one (an array item) starts as an empty draft in the field's
+                // default country, which the schema refuses until the user fills the required parts.
+                if (isOptional(schema)) {
+                    return undefined;
+                }
+                return { line1: '', city: '', country: getAddressMetadata(schema)?.defaultCountry ?? '' };
+            }
+            case FieldSchemaType.MONEY:
+            case FieldSchemaType.DURATION: {
+                // Also ONE value each, so the address rule applies: an optional one stays `undefined`, and a
+                // required one (an array item) starts as the draft its own control starts from — a zero in a
+                // currency or unit the field allows (#990). The old `0` / `''` was not a MoneyValue or a
+                // DurationValue, so an added item could never become valid.
+                if (isOptional(schema)) {
+                    return undefined;
+                }
+                return type === FieldSchemaType.MONEY ? createMoneyFieldDefaultValue(schema) : createDurationFieldDefaultValue(schema);
+            }
+            case FieldSchemaType.CODE: {
+                // ONE value: an empty snippet in the field's language — the authored default, else the first
+                // language the field allows, else none (a free-language field starts blank). Seeded as `''`
+                // before #1073, which is no code value at all, so an added item could never become valid.
+                if (isOptional(schema)) {
+                    return undefined;
+                }
+                return { content: '', language: getCodeUI(schema)?.defaultLanguage ?? getCodeMetadata(schema)?.allowedLanguages?.[0] ?? '' };
+            }
+            case FieldSchemaType.RANGE_NUMBER:
+            case FieldSchemaType.RANGE_DATE:
+            case FieldSchemaType.RANGE_DATETIME:
+            case FieldSchemaType.RANGE_TIME:
+            case FieldSchemaType.RANGE_BIGDECIMAL:
+            case FieldSchemaType.RANGE_MONEY: {
+                // ONE value: `{ from, to }`, seeded with only the bounds the range REQUIRES (both are optional
+                // by default), each built from its own bound schema — a money range's bound through the money
+                // default, so it carries a currency the value schema accepts (#1073).
+                if (isOptional(schema)) {
+                    return undefined;
+                }
+                const bounds = getObjectShape(schema) ?? {};
+                const seed = {};
+                for (const bound of ['from', 'to']) {
+                    const boundSchema = bounds[bound];
+                    if (!boundSchema || isOptional(boundSchema))
+                        continue;
+                    seed[bound] = type === FieldSchemaType.RANGE_MONEY ? createMoneyFieldDefaultValue(boundSchema) : this.getDefaultValueForSchema(boundSchema);
+                }
+                return seed;
+            }
             case FieldSchemaType.OBJECT: {
                 // An OPTIONAL object field must stay `undefined`, NOT a fabricated `{ nested defaults }`.
                 // `.optional()` means "may be omitted", and backend logic legitimately distinguishes
@@ -453,6 +573,8 @@ export class AutomatedLayoutFrontendUtils {
      * **by item shape** — the framework's opinion about which add affordance fits:
      *
      * - **primitive** item → {@link ArrayAddMode.QUICK_ADD} (type-and-commit a value).
+     * - **address** item → {@link ArrayAddMode.APPEND_INLINE}: one structured value with no single
+     *   part that summarises it, so a typed quick-add string could never become an item.
      * - **object with ≤ 1 prominent field** (string/number; e.g. checklist
      *   `{ label, done }` — `label` is the only typed field) → `QUICK_ADD`. The single
      *   typed field is staged in the add-row; the rest (booleans, enums) seed defaults.
@@ -470,6 +592,11 @@ export class AutomatedLayoutFrontendUtils {
             return explicit;
         }
         const itemType = getSchemaType(itemSchema);
+        // A structured value is not OBJECT to `getSchemaType`, and falling to QUICK_ADD would render a text
+        // box whose string never parses as that value: nothing could ever be added (#561, #990).
+        if (STRUCTURED_VALUE_ITEM_TYPES.has(itemType)) {
+            return ArrayAddMode.APPEND_INLINE;
+        }
         if (itemType !== FieldSchemaType.OBJECT) {
             return ArrayAddMode.QUICK_ADD;
         }