@wildo-ai/saas-frontend-lib 1.1.5 → 1.1.7

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

@@ -4,6 +4,43 @@ 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.
  *
@@ -39,6 +76,7 @@ export function usePublicShellLayout(useCardLayout = false, organizationBranding
         logoComposition: undefined,
     } : brandIdentity;
     const brandHeader = frontendConfiguration.publicShellIdentityMode === PublicShellIdentityMode.BRAND_HEADER ? loginIdentity : undefined;
+    useTenantFavicon(tenant?.faviconUrl);
     return {
         useCardLayout,
         isReady: true,

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,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAE1D,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,CAClC,aAAa,GAAG,KAAK,EACrB,oBAAyE;IAEzE,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,EAAE,aAAa,EAAE,GAAG,KAAK,EAAE,CAAC;IAClC,8FAA8F;IAC9F,+FAA+F;IAC/F,MAAM,MAAM,GAAG,aAAa,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,SAAS,CAAC;IAClF,MAAM,aAAa,GAAG,MAAM,CAAC,CAAC,CAAC;QAC7B,IAAI,EAAE,MAAM,CAAC,gBAAgB,IAAI,aAAa,CAAC,IAAI;QACnD,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,aAAa,CAAC,OAAO;QAChD,4FAA4F;QAC5F,qFAAqF;QACrF,eAAe,EAAE,SAAS;KAC3B,CAAC,CAAC,CAAC,aAAa,CAAC;IAClB,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;QACX,gBAAgB,EAAE,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,SAAS;KACjE,CAAC;AACJ,CAAC","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 * 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  return {\n    useCardLayout,\n    isReady: true,\n    brandHeader,\n    brandAccentColor: brandHeader ? tenant?.primaryColor : undefined,\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

@@ -75,11 +75,25 @@ export declare class AutomatedLayoutFrontendUtils {
      * 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.

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":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AACvF,OAAO,EACL,eAAe,EASf,YAAY,EAUZ,cAAc,EAGd,KAAK,cAAc,EAMpB,MAAM,0BAA0B,CAAC;AA6BlC,qBAAa,4BAA4B;IACvC,OAAO,CAAC,MAAM,CAAC,0CAA0C;IAIzD,OAAO,CAAC,MAAM,CAAC,kCAAkC;IAmBjD,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAQxC,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAsEvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;WACW,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIvD;;;;;;;;;;;;OAYG;WACW,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAW3D;;;;;;;;OAQG;WACW,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI5D;;;;;;;;;;;;;OAaG;WACW,wBAAwB,CACpC,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,kBAAkB,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,GACnF,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM;IA4B3B;;;OAGG;WACW,kCAAkC,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE;IAc1F,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAczC;;;;;;;;;;OAUG;WACW,uBAAuB,CACnC,MAAM,EAAE,CAAC,CAAC,UAAU,EACpB,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAO,GACrC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,SAAS;IAmC3C;;;;;;;OAOG;WACW,qBAAqB,CACjC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,SAAS,EAChC,UAAU,GAAE,MAAW,GACtB,MAAM,EAAE;WAIG,+BAA+B,CAC3C,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,SAAS,EAChC,UAAU,GAAE,MAAW,GACtB,MAAM,EAAE;WAMG,sBAAsB,CAClC,UAAU,EAAE,CAAC,CAAC,UAAU,GAAG,SAAS,EACpC,IAAI,EAAE,MAAM,GACX,CAAC,CAAC,UAAU,GAAG,SAAS;IA4C3B;;;;;;;;;;;OAWG;WACW,wBAAwB,CAAC,UAAU,EAAE,eAAe,GAAG,cAAc;IA+CnF;;;;;;;;OAQG;WACW,wBAAwB,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,OAAO;IAkHrE;;;;;;;;;;;;;;;OAeG;WACW,wBAAwB,CAAC,UAAU,EAAE,CAAC,CAAC,UAAU,GAAG;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAA;KAAE;IAwB/G;;;;;;;;;;;;;;;;;;;OAmBG;WACW,mBAAmB,CAAC,WAAW,EAAE,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,GAAG,YAAY;IAiCpG;;;;;OAKG;WACW,sBAAsB,CAClC,UAAU,EAAE,CAAC,CAAC,UAAU,EACxB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,iBAAiB,CAAC,EAAE,2BAA2B,EAC/C,OAAO,GAAE;QAAE,iCAAiC,CAAC,EAAE,OAAO,CAAA;KAAO,GAC5D,OAAO;IA4CV,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAuCxC;;OAEG;WACW,gBAAgB,CAC5B,cAAc,EAAE,cAAc,EAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO;IAgBV;;OAEG;WACW,sBAAsB,CAAC,WAAW,EAAE,CAAC,CAAC,UAAU,GAAG,cAAc,GAAG,SAAS;IAI3F;;OAEG;WACW,sBAAsB,CAAC,cAAc,EAAE,cAAc,GAAG,MAAM,EAAE;IAO9E;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAsCnC;;OAEG;WACW,yBAAyB,CAAC,UAAU,EAAE,CAAC,CAAC,UAAU,GAAG;QACjE,kBAAkB,EAAE,MAAM,CAAC;QAC3B,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB,GAAG,IAAI;IAqBR;;OAEG;WACW,oBAAoB,CAChC,UAAU,EAAE,CAAC,CAAC,UAAU,EACxB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,iBAAiB,CAAC,EAAE,2BAA2B,GAC9C,MAAM,EAAE;IAiBX;;OAEG;WACW,qBAAqB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnE,QAAQ,EAAE,CAAC,EACX,UAAU,EAAE,CAAC,CAAC,UAAU,EACxB,iBAAiB,CAAC,EAAE,2BAA2B,GAC9C,OAAO,CAAC,CAAC,CAAC;IAoBb;;OAEG;WACW,mBAAmB,CAC/B,UAAU,EAAE,CAAC,CAAC,UAAU,EACxB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,iBAAiB,CAAC,EAAE,2BAA2B,GAC9C,MAAM,EAAE;IAqBX;;;OAGG;WACW,0BAA0B,CACtC,WAAW,EAAE,CAAC,CAAC,UAAU,EACzB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,CAAC,CAAC,UAAU,EACxB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,iBAAiB,CAAC,EAAE,2BAA2B,GAC9C,OAAO;IAqBV;;OAEG;WACW,wBAAwB,CACpC,UAAU,EAAE,CAAC,CAAC,UAAU,EACxB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,iBAAiB,CAAC,EAAE,2BAA2B,GAC9C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAqB3B"}
+{"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,4 @@
-import { FieldSchemaType, getFileMetadata, getAddressMetadata, getCodeMetadata, getCodeUI, 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`.
@@ -178,30 +178,64 @@ export class AutomatedLayoutFrontendUtils {
      * 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(' › ');
         };
     }
     // =============================================================================

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

@@ -1 +1 @@
-{"version":3,"file":"automated-layout.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/core/automated-layout/automated-layout.frontend.utils.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,SAAS,EACT,aAAa,EACb,aAAa,EACb,cAAc,EACd,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EACjB,uBAAuB,EACvB,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EAGjB,YAAY,EACZ,YAAY,EACZ,oBAAoB,GAErB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,+BAA+B,EAAE,4BAA4B,EAAE,MAAM,2CAA2C,CAAC;AAE1H;;;;;;;;;GASG;AACH,MAAM,2BAA2B,GAAiC,IAAI,GAAG,CAAC;IACxE,eAAe,CAAC,OAAO;IACvB,eAAe,CAAC,KAAK;IACrB,eAAe,CAAC,QAAQ;IACxB,oGAAoG;IACpG,oGAAoG;IACpG,eAAe,CAAC,IAAI;IACpB,eAAe,CAAC,YAAY;IAC5B,eAAe,CAAC,UAAU;IAC1B,eAAe,CAAC,cAAc;IAC9B,eAAe,CAAC,UAAU;IAC1B,eAAe,CAAC,gBAAgB;IAChC,eAAe,CAAC,WAAW;CAC5B,CAAC,CAAC;AAGH,MAAM,OAAO,4BAA4B;IAC/B,MAAM,CAAC,0CAA0C,CAAC,UAAkB;QAC1E,OAAO,wDAAwD,UAAU,IAAI,QAAQ,iFAAiF,CAAC;IACzK,CAAC;IAEO,MAAM,CAAC,kCAAkC,CAAC,KAAc;QAC9D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,4BAA4B,CAAC,kCAAkC,CAAC,IAAI,CAAC,CAAC,CAAC;QACpG,CAAC;QAED,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvC,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC;iBAC7C,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;iBACpD,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC;gBAC1B,GAAG;gBACH,4BAA4B,CAAC,kCAAkC,CAAC,UAAU,CAAC;aAC5E,CAAC,CACL,CAAC;QACJ,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,MAAM,CAAC,yBAAyB,CACtC,IAAwB,EACxB,KAAyB;QAEzB,OAAO,IAAI,CAAC,SAAS,CAAC,4BAA4B,CAAC,kCAAkC,CAAC,IAAI,CAAC,CAAC;gBACtF,IAAI,CAAC,SAAS,CAAC,4BAA4B,CAAC,kCAAkC,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/F,CAAC;IAEO,MAAM,CAAC,wBAAwB,CACrC,MAAgC,EAChC,aAAqB,EAAE;QAEvB,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,eAAe,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,YAAY,CAAC,eAAe,CAAC,EAAE,CAAC;YAClC,MAAM,YAAY,GAAG,eAAe,CAAC,eAAe,CAAC,CAAC;YACtD,OAAO,YAAY,EAAE,MAAM,IAAI,UAAU;gBACvC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC;gBAC3C,CAAC,CAAC,EAAE,CAAC;QACT,CAAC;QAED,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YAChC,MAAM,aAAa,GAAG,iBAAiB,CAAC,eAAe,EAAE,SAAS,CAA6B,CAAC;YAChG,OAAO,IAAI,CAAC,wBAAwB,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;QAClE,CAAC;QAED,IAAI,WAAW,CAAC,eAAe,CAAC,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,iBAAiB,CAAC,eAAe,CAAC,CAAC;YACjD,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,EAAE;gBAChE,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBACvE,OAAO,IAAI,CAAC,wBAAwB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YAC9D,CAAC,CAAC,CAAC;QACL,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,kCAAkC,CAAC,eAAe,CAAC,CAAC;QAC9E,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,iBAAiB,GAAG,IAAI,CAAC,0BAA0B,CAAC,eAAe,CAAC,CAAC;YAC3E,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACnC,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAC1D,IAAI,CAAC,wBAAwB,CAAC,MAAM,EAAE,UAAU,CAAC,CAClD,CAAC;YACF,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;gBAC7D,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,UAAU,CAAC,CAAC,CAAC;YAC/E,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAmE,CAAC;QAC1F,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;YAClC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,wBAAwB,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC;gBACtE,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBAC7C,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;oBACnC,SAAS;gBACX,CAAC;gBAED,IAAI,CAAC,IAAI,CAAC,yBAAyB,CAAC,QAAQ,CAAC,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;oBAC/E,MAAM,IAAI,KAAK,CACb,0EAA0E,KAAK,CAAC,SAAS,IAAI,CAC9F,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IAC1G,CAAC;IAGD,gFAAgF;IAChF,yBAAyB;IACzB,gFAAgF;IAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACI,MAAM,CAAC,oBAAoB,CAAC,GAAW;QAC5C,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;;;;;;;;OAYG;IACI,MAAM,CAAC,uBAAuB,CAAC,IAAY;QAChD,OAAO,IAAI;aACR,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACZ,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAChB,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG;YAC/B,CAAC,CAAC,4BAA4B,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAC5D;aACA,IAAI,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IAED;;;;;;;;OAQG;IACI,MAAM,CAAC,wBAAwB,CAAC,IAAY;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;;;;;;;;OAaG;IACI,MAAM,CAAC,wBAAwB,CACpC,YAAgC,EAChC,kBAAoF;QAEpF,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO,4BAA4B,CAAC,uBAAuB,CAAC;QAC9D,CAAC;QAED,OAAO,CAAC,IAAY,EAAU,EAAE;YAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACjC,OAAO,QAAQ;iBACZ,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;gBACtB,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC1B,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;gBAC1C,CAAC;gBACD,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACzD,MAAM,KAAK,GAAG,kBAAkB,CAAC,YAAY,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;gBACnE,MAAM,UAAU,GAAG,GAAG,YAAY,IAAI,SAAS,QAAQ,CAAC;gBACxD,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;oBACzB,OAAO,4BAA4B,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;gBACpE,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC,CAAC;iBACD,IAAI,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,CAAC;IACJ,CAAC;IAED,gFAAgF;IAChF,6BAA6B;IAC7B,gFAAgF;IAEhF;;;OAGG;IACI,MAAM,CAAC,kCAAkC,CAAC,MAAoB;QACnE,IAAI,UAAU,CAAC,MAAM,CAAC,KAAK,OAAO,EAAE,CAAC;YACnC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,aAAa,GAAG,uBAAuB,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;QACvE,MAAM,OAAO,GAAG,sBAAsB,CAAC,MAAM,EAAE,SAAS,CAA+B,CAAC;QACxF,IAAI,CAAC,aAAa,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;YACvC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAA8B,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IACrF,CAAC;IAEO,MAAM,CAAC,0BAA0B,CAAC,MAAoB;QAC5D,IAAI,UAAU,CAAC,MAAM,CAAC,KAAK,OAAO,EAAE,CAAC;YACnC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,aAAa,GAAG,uBAAuB,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;QACvE,MAAM,OAAO,GAAG,sBAAsB,CAAC,MAAM,EAAE,SAAS,CAA+B,CAAC;QACxF,IAAI,aAAa,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;YACtC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAA8B,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IACrF,CAAC;IAED;;;;;;;;;;OAUG;IACI,MAAM,CAAC,uBAAuB,CACnC,MAAoB,EACpB,UAAoC,EAAE;QAEtC,MAAM,eAAe,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,WAAW,CAAC,eAAe,CAAC,EAAE,CAAC;YACjC,OAAO,iBAAiB,CAAC,eAAe,CAAC,CAAC;QAC5C,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,kCAAkC,CAAC,eAAe,CAAC,CAAC;QAC9E,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,YAAY,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7E,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,CAAC,UAAU,EAAE,GAAG,UAAU,CAAC,GAAG,YAAY,CAAC;YACjD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CACxD,UAAU,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAC9E,CAAC;YAEF,OAAO,MAAM,CAAC,WAAW,CACvB,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,GAAG,CAAiB,CAAC,CAAC,CAChE,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAiC,EAAE,CAAC;QACrD,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;YACjC,KAAK,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,CAAC;oBAClE,WAAW,CAAC,SAAS,CAAC,GAAG,WAA2B,CAAC;gBACvD,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;;;;;;OAOG;IACI,MAAM,CAAC,qBAAqB,CACjC,MAAgC,EAChC,aAAqB,EAAE;QAEvB,OAAO,IAAI,CAAC,wBAAwB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC3F,CAAC;IAEM,MAAM,CAAC,+BAA+B,CAC3C,MAAgC,EAChC,aAAqB,EAAE;QAEvB,OAAO,IAAI,CAAC,wBAAwB,CAAC,MAAM,EAAE,UAAU,CAAC;aACrD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,KAAK,oBAAoB,CAAC,YAAY,CAAC;aAC9F,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IAEM,MAAM,CAAC,sBAAsB,CAClC,UAAoC,EACpC,IAAY;QAEZ,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,MAAM,GAAG,IAAI;aAChB,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC;aAC5B,KAAK,CAAC,GAAG,CAAC;aACV,MAAM,CAAC,OAAO,CAAC,CAAC;QAEnB,IAAI,OAAO,GAA6B,UAAU,CAAC;QACnD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxB,6FAA6F;gBAC7F,8FAA8F;gBAC9F,mDAAmD;gBACnD,MAAM,WAAW,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;gBAC1C,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;oBAC7B,OAAO,SAAS,CAAC;gBACnB,CAAC;gBACD,OAAO,GAAG,iBAAiB,CAAC,WAAW,EAAE,SAAS,CAA6B,CAAC;gBAChF,SAAS;YACX,CAAC;YAED,MAAM,KAAK,GAAG,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC;YACpD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAGD,gFAAgF;IAChF,0BAA0B;IAC1B,gFAAgF;IAEhF;;;;;;;;;;;OAWG;IACI,MAAM,CAAC,wBAAwB,CAAC,UAA2B;QAChE,QAAQ,UAAU,EAAE,CAAC;YACnB,KAAK,eAAe,CAAC,MAAM,CAAC;YAC5B,KAAK,eAAe,CAAC,MAAM,CAAC;YAC5B,KAAK,eAAe,CAAC,MAAM,CAAC;YAC5B,KAAK,eAAe,CAAC,KAAK,CAAC;YAC3B,KAAK,eAAe,CAAC,UAAU,CAAC;YAChC,KAAK,eAAe,CAAC,IAAI,CAAC;YAC1B,gGAAgG;YAChG,KAAK,eAAe,CAAC,OAAO;gBAC1B,OAAO,cAAc,CAAC,OAAO,CAAC;YAEhC,KAAK,eAAe,CAAC,IAAI,CAAC;YAC1B,KAAK,eAAe,CAAC,OAAO;gBAC1B,OAAO,cAAc,CAAC,SAAS,CAAC;YAElC,KAAK,eAAe,CAAC,IAAI,CAAC;YAC1B,KAAK,eAAe,CAAC,IAAI,CAAC;YAC1B,KAAK,eAAe,CAAC,QAAQ,CAAC;YAC9B,KAAK,eAAe,CAAC,UAAU,CAAC;YAChC,KAAK,eAAe,CAAC,UAAU,CAAC;YAChC,KAAK,eAAe,CAAC,cAAc;gBACjC,OAAO,cAAc,CAAC,SAAS,CAAC;YAElC,KAAK,eAAe,CAAC,IAAI;gBACvB,OAAO,cAAc,CAAC,SAAS,CAAC;YAElC,KAAK,eAAe,CAAC,YAAY,CAAC;YAClC,KAAK,eAAe,CAAC,gBAAgB,CAAC;YACtC,KAAK,eAAe,CAAC,WAAW;gBAC9B,OAAO,cAAc,CAAC,SAAS,CAAC;YAElC,KAAK,eAAe,CAAC,MAAM,CAAC;YAC5B,KAAK,eAAe,CAAC,KAAK,CAAC;YAC3B,KAAK,eAAe,CAAC,MAAM,CAAC;YAC5B,KAAK,eAAe,CAAC,GAAG;gBACtB,OAAO,cAAc,CAAC,SAAS,CAAC;YAElC;gBACE,OAAO,cAAc,CAAC,OAAO,CAAC;QAClC,CAAC;IACH,CAAC;IAED,gFAAgF;IAChF,2BAA2B;IAC3B,gFAAgF;IAEhF;;;;;;;;OAQG;IACI,MAAM,CAAC,wBAAwB,CAAC,MAAoB;QACzD,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QACnC,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,eAAe,CAAC,MAAM;gBACzB,OAAO,EAAE,CAAC;YACZ,KAAK,eAAe,CAAC,MAAM,CAAC;YAC5B,KAAK,eAAe,CAAC,MAAM,CAAC;YAC5B,KAAK,eAAe,CAAC,UAAU;gBAC7B,OAAO,CAAC,CAAC;YACX,KAAK,eAAe,CAAC,OAAO;gBAC1B,OAAO,KAAK,CAAC;YACf,KAAK,eAAe,CAAC,IAAI,CAAC;YAC1B,KAAK,eAAe,CAAC,QAAQ;gBAC3B,OAAO,IAAI,IAAI,EAAE,CAAC;YACpB,KAAK,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC1B,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;gBACrC,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5C,CAAC;YACD,KAAK,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC7B,6FAA6F;gBAC7F,8FAA8F;gBAC9F,qFAAqF;gBACrF,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;oBACvB,OAAO,SAAS,CAAC;gBACnB,CAAC;gBACD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAAE,cAAc,IAAI,EAAE,EAAE,CAAC;YAC5F,CAAC;YACD,KAAK,eAAe,CAAC,KAAK,CAAC;YAC3B,KAAK,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAC9B,6FAA6F;gBAC7F,6FAA6F;gBAC7F,yFAAyF;gBACzF,4DAA4D;gBAC5D,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;oBACvB,OAAO,SAAS,CAAC;gBACnB,CAAC;gBACD,OAAO,IAAI,KAAK,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,4BAA4B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,+BAA+B,CAAC,MAAM,CAAC,CAAC;YACzH,CAAC;YACD,KAAK,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC1B,6FAA6F;gBAC7F,4FAA4F;gBAC5F,0FAA0F;gBAC1F,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;oBACvB,OAAO,SAAS,CAAC;gBACnB,CAAC;gBACD,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,eAAe,IAAI,eAAe,CAAC,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YAC/H,CAAC;YACD,KAAK,eAAe,CAAC,YAAY,CAAC;YAClC,KAAK,eAAe,CAAC,UAAU,CAAC;YAChC,KAAK,eAAe,CAAC,cAAc,CAAC;YACpC,KAAK,eAAe,CAAC,UAAU,CAAC;YAChC,KAAK,eAAe,CAAC,gBAAgB,CAAC;YACtC,KAAK,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC;gBACjC,+FAA+F;gBAC/F,8FAA8F;gBAC9F,sEAAsE;gBACtE,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;oBACvB,OAAO,SAAS,CAAC;gBACnB,CAAC;gBACD,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC5C,MAAM,IAAI,GAA4B,EAAE,CAAC;gBACzC,KAAK,MAAM,KAAK,IAAI,CAAC,MAAM,EAAE,IAAI,CAAU,EAAE,CAAC;oBAC5C,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;oBAClC,IAAI,CAAC,WAAW,IAAI,UAAU,CAAC,WAAW,CAAC;wBAAE,SAAS;oBACtD,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,KAAK,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC,4BAA4B,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,WAAW,CAAC,CAAC;gBAC9I,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;YACD,KAAK,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;gBAC5B,0FAA0F;gBAC1F,qFAAqF;gBACrF,yFAAyF;gBACzF,qFAAqF;gBACrF,uFAAuF;gBACvF,yFAAyF;gBACzF,oFAAoF;gBACpF,wFAAwF;gBACxF,uDAAuD;gBACvD,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;oBACvB,OAAO,SAAS,CAAC;gBACnB,CAAC;gBACD,kFAAkF;gBAClF,wEAAwE;gBACxE,iFAAiF;gBACjF,oFAAoF;gBACpF,sFAAsF;gBACtF,0FAA0F;gBAC1F,IAAI,KAA+C,CAAC;gBACpD,IAAI,CAAC;oBACH,KAAK,GAAG,iBAAiB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAiC,CAAC;gBAClF,CAAC;gBAAC,MAAM,CAAC;oBACP,KAAK,GAAG,SAAS,CAAC;gBACpB,CAAC;gBACD,IAAI,CAAC,KAAK;oBAAE,OAAO,EAAE,CAAC;gBACtB,MAAM,MAAM,GAA4B,EAAE,CAAC;gBAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBACvD,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,wBAAwB,CAAC,WAAW,CAAC,CAAC;gBAC3D,CAAC;gBACD,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,KAAK,eAAe,CAAC,MAAM,CAAC;YAC5B,KAAK,eAAe,CAAC,GAAG;gBACtB,OAAO,EAAE,CAAC;YACZ,KAAK,eAAe,CAAC,KAAK;gBACxB,OAAO,EAAE,CAAC;YACZ;gBACE,OAAO,EAAE,CAAC;QACd,CAAC;IACH,CAAC;IAED,gFAAgF;IAChF,4EAA4E;IAC5E,gFAAgF;IAEhF;;;;;;;;;;;;;;;OAeG;IACI,MAAM,CAAC,wBAAwB,CAAC,UAAwB;QAC7D,MAAM,QAAQ,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;QAC3C,IAAI,QAAQ,KAAK,eAAe,CAAC,MAAM,EAAE,CAAC;YACxC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QAC5C,CAAC;QAED,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QAC5C,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,WAAW,CAAC,KAAK,eAAe,CAAC,MAAM,CAAC,CAAC;QAC7G,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,CAAC;QACD,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,WAAW,CAAC,KAAK,eAAe,CAAC,MAAM,CAAC,CAAC;QAC7G,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC3F,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACI,MAAM,CAAC,mBAAmB,CAAC,WAAyB,EAAE,UAAwB;QACnF,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC;QACxD,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,QAAQ,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;QAC3C,oGAAoG;QACpG,yFAAyF;QACzF,IAAI,2BAA2B,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9C,OAAO,YAAY,CAAC,aAAa,CAAC;QACpC,CAAC;QACD,IAAI,QAAQ,KAAK,eAAe,CAAC,MAAM,EAAE,CAAC;YACxC,OAAO,YAAY,CAAC,SAAS,CAAC;QAChC,CAAC;QAED,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,YAAY,CAAC,aAAa,CAAC;QACpC,CAAC;QAED,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE;YACtE,MAAM,SAAS,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;YAC7C,OAAO,SAAS,KAAK,eAAe,CAAC,MAAM,IAAI,SAAS,KAAK,eAAe,CAAC,MAAM,CAAC;QACtF,CAAC,CAAC,CAAC,MAAM,CAAC;QAEV,OAAO,mBAAmB,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,aAAa,CAAC;IACxF,CAAC;IAED,gFAAgF;IAChF,gDAAgD;IAChD,gFAAgF;IAEhF;;;;;OAKG;IACI,MAAM,CAAC,sBAAsB,CAClC,UAAwB,EACxB,SAAiB,EACjB,UAAmC,EACnC,iBAA+C,EAC/C,UAA2D,EAAE;QAE7D,MAAM,EAAE,iCAAiC,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;QAE7D,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,EAAE,kBAAkB,EAAE,0CAA0C,EAAE,gBAAgB,EAAE,GAAG,iBAAiB,CAAC;QAE/G,MAAM,yBAAyB,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;QACjE,IAAI,yBAAyB,KAAK,SAAS,EAAE,CAAC;YAC5C,OAAO,iCAAiC,CAAC;QAC3C,CAAC;QAED,MAAM,iBAAiB,GAAG,IAAI,CAAC,oBAAoB,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;QAEnF,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,0CAA0C,EAAE,QAAQ,CAAC,yBAAmC,CAAC,EAAE,CAAC;YAC9F,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,cAAc,GAAG,gBAAgB,EAAE,IAAI,CAC3C,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,uBAAuB,KAAK,yBAAyB,CAC7D,CAAC;QAEF,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,YAAY,GAAG,iBAAiB,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAC9D,IAAI,YAAY,IAAI,SAAS,IAAI,YAAY,EAAE,CAAC;YAC9C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,gFAAgF;IAChF,+CAA+C;IAC/C,gFAAgF;IAExE,MAAM,CAAC,yBAAyB,CACtC,SAA4B,EAC5B,UAAmC;QAEnC,MAAM,UAAU,GAAG,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,IAAI,gBAAgB,CAAC,MAAM,CAAC;QAE/D,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,gBAAgB,CAAC,MAAM;gBAC1B,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;oBACnC,OAAO,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;gBAC9C,CAAC;gBACD,OAAO,UAAU,KAAK,SAAS,CAAC,KAAK,CAAC;YAExC,KAAK,gBAAgB,CAAC,UAAU;gBAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;oBACnC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;gBAC/C,CAAC;gBACD,OAAO,UAAU,KAAK,SAAS,CAAC,KAAK,CAAC;YAExC,KAAK,gBAAgB,CAAC,EAAE;gBACtB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC;oBAAE,OAAO,KAAK,CAAC;gBAClD,OAAO,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YAE9C,KAAK,gBAAgB,CAAC,MAAM;gBAC1B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC;oBAAE,OAAO,IAAI,CAAC;gBACjD,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YAE/C,KAAK,gBAAgB,CAAC,MAAM;gBAC1B,OAAO,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI,CAAC;YAEzD,KAAK,gBAAgB,CAAC,UAAU;gBAC9B,OAAO,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI,CAAC;YAEzD;gBACE,OAAO,IAAI,CAAC;QAChB,CAAC;IACH,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,gBAAgB,CAC5B,cAA8B,EAC9B,UAAmC;QAEnC,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC;YACzD,CAAC,CAAC,cAAc,CAAC,UAAU;YAC3B,CAAC,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QAEhC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEzC,MAAM,WAAW,GAAG,cAAc,CAAC,WAAW,IAAI,KAAK,CAAC;QAExD,IAAI,WAAW,KAAK,KAAK,EAAE,CAAC;YAC1B,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;QAC9E,CAAC;aAAM,CAAC;YACN,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,sBAAsB,CAAC,WAAyB;QAC5D,OAAO,iBAAiB,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,sBAAsB,CAAC,cAA8B;QACjE,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC;YACzD,CAAC,CAAC,cAAc,CAAC,UAAU;YAC3B,CAAC,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QAChC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,oBAAoB,CACjC,UAAwB,EACxB,iBAA8C;QAE9C,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;QAE5C,IAAI,CAAC,iBAAiB,CAAC,gBAAgB,EAAE,CAAC;YACxC,OAAO,iBAAiB,CAAC;QAC3B,CAAC;QAED,oEAAoE;QACpE,yEAAyE;QACzE,yEAAyE;QACzE,4EAA4E;QAC5E,8EAA8E;QAC9E,0EAA0E;QAC1E,6EAA6E;QAC7E,0EAA0E;QAC1E,4EAA4E;QAC5E,oEAAoE;QACpE,MAAM,SAAS,GAAG,IAAI,CAAC,uBAAuB,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QACjF,MAAM,aAAa,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAU,CAAC;QAEtF,KAAK,MAAM,OAAO,IAAI,iBAAiB,CAAC,gBAAgB,EAAE,CAAC;YACzD,MAAM,YAAY,GAAG,iBAAiB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACvD,IAAI,CAAC,YAAY;gBAAE,SAAS;YAE5B,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;gBAClD,IAAI,SAAS,KAAK,iBAAiB,CAAC,kBAAkB;oBAAE,SAAS;gBACjE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;oBAClC,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,yBAAyB,CAAC,UAAwB;QAI9D,MAAM,KAAK,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAExB,KAAK,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7D,MAAM,mBAAmB,GAAG,sBAAsB,CAAC,WAA2B,CAAC,CAAC;YAChF,IAAI,mBAAmB,EAAE,CAAC;gBACxB,OAAO;oBACL,kBAAkB,EAAE,SAAS;oBAC7B,UAAU,EAAE,mBAAmB,CAAC,UAAU,IAAI,EAAE;iBACjD,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gFAAgF;IAChF,wCAAwC;IACxC,gFAAgF;IAEhF;;OAEG;IACI,MAAM,CAAC,oBAAoB,CAChC,UAAwB,EACxB,UAAmC,EACnC,iBAA+C;QAE/C,0EAA0E;QAC1E,+DAA+D;QAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC;QACvD,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,CAAC;QAEtB,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEzC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,OAAO,aAAa,CAAC;QACvB,CAAC;QAED,OAAO,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CACtC,IAAI,CAAC,sBAAsB,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAClF,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,qBAAqB,CACjC,QAAW,EACX,UAAwB,EACxB,iBAA+C;QAE/C,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,oBAAoB,CAAC,UAAU,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;QACzF,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;QAEhD,MAAM,MAAM,GAAe,EAAE,CAAC;QAE9B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpD,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACtC,IAAI,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClE,MAAkC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACnD,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,mBAAmB,CAC/B,UAAwB,EACxB,UAAmC,EACnC,iBAA+C;QAE/C,0EAA0E;QAC1E,+DAA+D;QAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC;QACvD,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,CAAC;QAEtB,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEzC,OAAO,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CACtC,CAAC,IAAI,CAAC,sBAAsB,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,iBAAiB,CAAC,CACnF,CAAC;IACJ,CAAC;IAED,gFAAgF;IAChF,6BAA6B;IAC7B,gFAAgF;IAEhF;;;OAGG;IACI,MAAM,CAAC,0BAA0B,CACtC,WAAyB,EACzB,SAAiB,EACjB,UAAwB,EACxB,UAAmC,EACnC,iBAA+C;QAE/C,MAAM,eAAe,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;QAEhD,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,cAAc,GAAG,IAAI,CAAC,sBAAsB,CAChD,UAAU,EACV,SAAS,EACT,UAAU,EACV,iBAAiB,CAClB,CAAC;QAEF,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,wBAAwB,CACpC,UAAwB,EACxB,UAAmC,EACnC,iBAA+C;QAE/C,0EAA0E;QAC1E,+DAA+D;QAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC;QACvD,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,CAAC;QAEtB,MAAM,MAAM,GAA4B,EAAE,CAAC;QAE3C,KAAK,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7D,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,0BAA0B,CACjD,WAA2B,EAC3B,SAAS,EACT,UAAU,EACV,UAAU,EACV,iBAAiB,CAClB,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CAEF","sourcesContent":["import { z } from 'zod';\n\nimport type { InheritanceSchemaDefinition } from './automated-layout.frontend.schemas';\nimport {\n  FieldSchemaType,\n  getFileMetadata,\n  getAddressMetadata,\n  getCodeMetadata,\n  getCodeUI,\n  getEnumValues,\n  getSchemaType,\n  getObjectShape,\n  getArrayUI,\n  ArrayAddMode,\n  getZodObjectShape,\n  getDiscriminatorParams,\n  getZodDefArrayProperty,\n  getZodDefProperty,\n  getZodDefStringProperty,\n  getZodType,\n  isOptional,\n  isZodArray,\n  isZodObject,\n  ValidationMode,\n  ShowWhenOperator,\n  getShowWhenParams,\n  type ShowWhenParams,\n  type ShowWhenCondition,\n  isFileSchema,\n  unwrapSchema,\n  FileGenerationSource,\n  type FileSchemaMetadata,\n} from '@wildo-ai/zod-decorators';\nimport { createDurationFieldDefaultValue, createMoneyFieldDefaultValue } from './composite-value-defaults.frontend.utils';\n\n/**\n * Field types whose value is ONE structured object although `getSchemaType` does not answer `OBJECT`.\n *\n * A list of them cannot use the quick-add box: the box stages the typed TEXT and commits only what the\n * item schema accepts, and no string is an address, an amount of money or a duration — so nothing could\n * ever be added (#561, #990). Their items append a draft from `getDefaultValueForSchema` instead.\n *\n * `CODE` and the `RANGE_*` types are structured values too and are not listed yet: a draft for them is\n * not built, and switching the add mode alone would append an item that can never become valid (#1073).\n */\nconst STRUCTURED_VALUE_ITEM_TYPES: ReadonlySet<FieldSchemaType> = new Set([\n  FieldSchemaType.ADDRESS,\n  FieldSchemaType.MONEY,\n  FieldSchemaType.DURATION,\n  // A code value is `{ content, language }` and a range is `{ from, to }` — objects to the schema and\n  // structured values to `getSchemaType`, so the same rule (#1073): append a draft, never a text box.\n  FieldSchemaType.CODE,\n  FieldSchemaType.RANGE_NUMBER,\n  FieldSchemaType.RANGE_DATE,\n  FieldSchemaType.RANGE_DATETIME,\n  FieldSchemaType.RANGE_TIME,\n  FieldSchemaType.RANGE_BIGDECIMAL,\n  FieldSchemaType.RANGE_MONEY,\n]);\n\n\nexport class AutomatedLayoutFrontendUtils {\n  private static buildUnsupportedPlainUnionFileFieldMessage(pathPrefix: string): string {\n    return `Unsupported z.union() file field schema detected at \"${pathPrefix || '<root>'}\". File fields inside non-discriminated unions must use z.discriminatedUnion().`;\n  }\n\n  private static normalizeFileMetadataForComparison(value: unknown): unknown {\n    if (Array.isArray(value)) {\n      return value.map((item) => AutomatedLayoutFrontendUtils.normalizeFileMetadataForComparison(item));\n    }\n\n    if (value && typeof value === 'object') {\n      return Object.fromEntries(\n        Object.entries(value as Record<string, unknown>)\n          .sort(([left], [right]) => left.localeCompare(right))\n          .map(([key, childValue]) => [\n            key,\n            AutomatedLayoutFrontendUtils.normalizeFileMetadataForComparison(childValue),\n          ]),\n      );\n    }\n\n    return value;\n  }\n\n  private static areFileMetadataCompatible(\n    left: FileSchemaMetadata,\n    right: FileSchemaMetadata,\n  ): boolean {\n    return JSON.stringify(AutomatedLayoutFrontendUtils.normalizeFileMetadataForComparison(left))\n      === JSON.stringify(AutomatedLayoutFrontendUtils.normalizeFileMetadataForComparison(right));\n  }\n\n  private static collectFileFieldMetadata(\n    schema: z.ZodTypeAny | undefined,\n    pathPrefix: string = '',\n  ): Array<{ fieldName: string; fileMetadata: FileSchemaMetadata }> {\n    if (!schema) {\n      return [];\n    }\n\n    const unwrappedSchema = unwrapSchema(schema);\n    if (isFileSchema(unwrappedSchema)) {\n      const fileMetadata = getFileMetadata(unwrappedSchema);\n      return fileMetadata?.isFile && pathPrefix\n        ? [{ fieldName: pathPrefix, fileMetadata }]\n        : [];\n    }\n\n    if (isZodArray(unwrappedSchema)) {\n      const elementSchema = getZodDefProperty(unwrappedSchema, 'element') as z.ZodTypeAny | undefined;\n      return this.collectFileFieldMetadata(elementSchema, pathPrefix);\n    }\n\n    if (isZodObject(unwrappedSchema)) {\n      const shape = getZodObjectShape(unwrappedSchema);\n      return Object.entries(shape).flatMap(([fieldName, fieldSchema]) => {\n        const nextPath = pathPrefix ? `${pathPrefix}.${fieldName}` : fieldName;\n        return this.collectFileFieldMetadata(fieldSchema, nextPath);\n      });\n    }\n\n    const unionOptions = this.getDiscriminatedUnionObjectOptions(unwrappedSchema);\n    if (unionOptions.length === 0) {\n      const plainUnionOptions = this.getPlainUnionObjectOptions(unwrappedSchema);\n      if (plainUnionOptions.length === 0) {\n        return [];\n      }\n\n      const plainUnionMetadata = plainUnionOptions.map((option) =>\n        this.collectFileFieldMetadata(option, pathPrefix),\n      );\n      if (plainUnionMetadata.some((entries) => entries.length > 0)) {\n        throw new Error(this.buildUnsupportedPlainUnionFileFieldMessage(pathPrefix));\n      }\n      return [];\n    }\n\n    const merged = new Map<string, { fieldName: string; fileMetadata: FileSchemaMetadata }>();\n    for (const option of unionOptions) {\n      for (const entry of this.collectFileFieldMetadata(option, pathPrefix)) {\n        const existing = merged.get(entry.fieldName);\n        if (!existing) {\n          merged.set(entry.fieldName, entry);\n          continue;\n        }\n\n        if (!this.areFileMetadataCompatible(existing.fileMetadata, entry.fileMetadata)) {\n          throw new Error(\n            `Incompatible z_file() metadata detected for canonical file field path \"${entry.fieldName}\".`,\n          );\n        }\n      }\n    }\n\n    return Array.from(merged.values()).sort((left, right) => left.fieldName.localeCompare(right.fieldName));\n  }\n\n\n  // =============================================================================\n  // FIELD LABEL FORMATTING\n  // =============================================================================\n\n  /**\n   * What a field renders as when no label resolved — the RAW KEY SEGMENT, unchanged.\n   *\n   * ## Why this returns the key rather than words\n   *\n   * Until 2026-09-08 this was `unresolvedFieldLabel`, and it produced sentence case from the\n   * identifier: `firstName` -> `First Name`, `created_at` -> `Created At`, with a special case\n   * turning `Id` into `ID`. It was convincing, which is exactly what made it a defect (#420):\n   *\n   * - **a missing label did not look missing**, so nobody ever authored one. The fallback ran only\n   *   where the label was absent — precisely the case somebody needed to notice;\n   * - **it was English in every locale**, because it was code producing words rather than a\n   *   translation, and no translator could find it — it was not in the label tree;\n   * - **it was silently wrong on anything it could not know**: `GDPR` -> `Gdpr`, `EUR` -> `Eur`.\n   *   Which all-caps token is an acronym is not derivable from the string, so the `Id` special case\n   *   was a guess that happened to be right once.\n   *\n   * The key itself is honest: visible, greppable, obviously not a label, identical in every locale.\n   * It is what `t()` already returns for an unresolved key.\n   *\n   * ## Why an identity function rather than nothing\n   *\n   * The call is kept, named and documented in one place so the surfaces that reach it share ONE\n   * decision rather than nine inlined ones — and so a future author who wants to \"improve the\n   * fallback\" finds this argument instead of an anonymous expression. See\n   * `.claude/rules/display-text-comes-from-i18n.md`.\n   *\n   * ## When it is reached\n   *\n   * Only AFTER label resolution has SETTLED. Surfaces gate on `useI18n().isReady`, which settles on\n   * a failed bundle as well as a loaded one, so a key is never flashed while labels are in flight.\n   *\n   * @param key - A single field key segment (no dots)\n   */\n  public static unresolvedFieldLabel(key: string): string {\n    return key;\n  }\n\n  /**\n   * Join a dotted field path for display in error messages and breadcrumbs, with array indices\n   * rendered 1-based.\n   *\n   * Each segment passes through {@link unresolvedFieldLabel}, which since 2026-09-08 (#420) is the\n   * IDENTITY function — so this reads as the raw path with separators, never as invented words. It\n   * is reached only when no i18n resolver is available, and a path that looks like a path is the\n   * honest rendering of that: see `.claude/rules/display-text-comes-from-i18n.md`.\n   *\n   * @example\n   * formatFieldPathFallback('address.streetName') → 'address › streetName'\n   * formatFieldPathFallback('items.0.name') → 'items › [1] › name'\n   */\n  public static formatFieldPathFallback(path: string): string {\n    return path\n      .split('.')\n      .map((part) =>\n        /^\\d+$/.test(part)\n          ? `[${parseInt(part, 10) + 1}]`\n          : AutomatedLayoutFrontendUtils.unresolvedFieldLabel(part)\n      )\n      .join(' › ');\n  }\n\n  /**\n   * Normalize runtime field paths to the canonical schema-key form used by\n   * `fileUploadContext`.\n   *\n   * Runtime field scopes include array indices (`attachments[0].file`), but the\n   * schema-level upload contract is keyed by the structural path\n   * (`attachments.file`). Centralizing this normalization keeps nested display\n   * and form consumers aligned without inventing per-index endpoint entries.\n   */\n  public static normalizeSchemaFieldPath(path: string): string {\n    return path.replace(/\\[\\d+\\]/g, '');\n  }\n\n  /**\n   * Create a field label resolver that resolves each path segment through i18n, and renders the raw\n   * segment when no label is authored.\n   *\n   * When `resourceType` is provided, each path segment is resolved via `tResourceFieldEdit`.\n   * If the i18n lookup returns the raw key (not found), the segment falls through\n   * {@link unresolvedFieldLabel} — the identity function, so a missing label READS as missing\n   * rather than as a plausible name.\n   * When `resourceType` is not provided, uses `formatFieldPathFallback` directly.\n   * \n   * @param resourceType - The resource type for i18n lookup\n   * @param tResourceFieldEdit - i18n function for field label resolution\n   * @returns A function that resolves a dot-path to a human-readable label\n   */\n  public static createFieldLabelResolver(\n    resourceType: string | undefined,\n    tResourceFieldEdit: (resourceType: string, fieldPath: string, key: string) => string,\n  ): (path: string) => string {\n    if (!resourceType) {\n      return AutomatedLayoutFrontendUtils.formatFieldPathFallback;\n    }\n\n    return (path: string): string => {\n      const segments = path.split('.');\n      return segments\n        .map((segment, index) => {\n          if (/^\\d+$/.test(segment)) {\n            return `[${parseInt(segment, 10) + 1}]`;\n          }\n          const fieldPath = segments.slice(0, index + 1).join('.');\n          const label = tResourceFieldEdit(resourceType, fieldPath, 'label');\n          const rawI18nKey = `${resourceType}.${fieldPath}.label`;\n          if (label === rawI18nKey) {\n            return AutomatedLayoutFrontendUtils.unresolvedFieldLabel(segment);\n          }\n          return label;\n        })\n        .join(' › ');\n    };\n  }\n\n  // =============================================================================\n  // OBJECT-LIKE SCHEMA HELPERS\n  // =============================================================================\n\n  /**\n   * Return object variants when a schema is a discriminated union of objects.\n   * Returns an empty array for plain objects or non-object unions.\n   */\n  public static getDiscriminatedUnionObjectOptions(schema: z.ZodTypeAny): z.ZodObject<any>[] {\n    if (getZodType(schema) !== 'union') {\n      return [];\n    }\n\n    const discriminator = getZodDefStringProperty(schema, 'discriminator');\n    const options = getZodDefArrayProperty(schema, 'options') as z.ZodTypeAny[] | undefined;\n    if (!discriminator || !options?.length) {\n      return [];\n    }\n\n    return options.filter((option): option is z.ZodObject<any> => isZodObject(option));\n  }\n\n  private static getPlainUnionObjectOptions(schema: z.ZodTypeAny): z.ZodObject<any>[] {\n    if (getZodType(schema) !== 'union') {\n      return [];\n    }\n\n    const discriminator = getZodDefStringProperty(schema, 'discriminator');\n    const options = getZodDefArrayProperty(schema, 'options') as z.ZodTypeAny[] | undefined;\n    if (discriminator || !options?.length) {\n      return [];\n    }\n\n    return options.filter((option): option is z.ZodObject<any> => isZodObject(option));\n  }\n\n  /**\n   * Resolve a field-shape view for schemas that are either plain objects or\n   * discriminated unions of objects.\n   *\n   * - `commonOnly: true` keeps only keys present in every union variant. This is\n   *   the safe view for generated root layouts because variant-only fields must\n   *   stay under discriminator switching.\n   * - `commonOnly: false` unions keys across variants and picks the first\n   *   matching schema for each key. This is the permissive view for runtime\n   *   lookups such as wrapper shaping or field schema resolution.\n   */\n  public static getObjectLikeFieldShape(\n    schema: z.ZodTypeAny,\n    options: { commonOnly?: boolean } = {},\n  ): Record<string, z.ZodTypeAny> | undefined {\n    const unwrappedSchema = unwrapSchema(schema);\n    if (isZodObject(unwrappedSchema)) {\n      return getZodObjectShape(unwrappedSchema);\n    }\n\n    const unionOptions = this.getDiscriminatedUnionObjectOptions(unwrappedSchema);\n    if (unionOptions.length === 0) {\n      return undefined;\n    }\n\n    const optionShapes = unionOptions.map((option) => getZodObjectShape(option));\n    if (options.commonOnly) {\n      const [firstShape, ...restShapes] = optionShapes;\n      const commonKeys = Object.keys(firstShape).filter((key) =>\n        restShapes.every((shape) => Object.prototype.hasOwnProperty.call(shape, key)),\n      );\n\n      return Object.fromEntries(\n        commonKeys.map((key) => [key, firstShape[key] as z.ZodTypeAny]),\n      );\n    }\n\n    const mergedShape: Record<string, z.ZodTypeAny> = {};\n    for (const shape of optionShapes) {\n      for (const [fieldName, fieldSchema] of Object.entries(shape)) {\n        if (!Object.prototype.hasOwnProperty.call(mergedShape, fieldName)) {\n          mergedShape[fieldName] = fieldSchema as z.ZodTypeAny;\n        }\n      }\n    }\n\n    return mergedShape;\n  }\n\n  /**\n   * Collect canonical schema paths for every `z_file()` field reachable from the\n   * provided schema.\n   *\n   * The returned paths never include array indices. Array item scopes resolve\n   * those dynamically at render time and then normalize back through\n   * `normalizeSchemaFieldPath()`.\n   */\n  public static collectFileFieldPaths(\n    schema: z.ZodTypeAny | undefined,\n    pathPrefix: string = '',\n  ): string[] {\n    return this.collectFileFieldMetadata(schema, pathPrefix).map((entry) => entry.fieldName);\n  }\n\n  public static collectUploadableFileFieldPaths(\n    schema: z.ZodTypeAny | undefined,\n    pathPrefix: string = '',\n  ): string[] {\n    return this.collectFileFieldMetadata(schema, pathPrefix)\n      .filter((entry) => entry.fileMetadata.generation?.source !== FileGenerationSource.PDF_TEMPLATE)\n      .map((entry) => entry.fieldName);\n  }\n\n  public static resolveFieldSchemaPath(\n    rootSchema: z.ZodTypeAny | undefined,\n    path: string,\n  ): z.ZodTypeAny | undefined {\n    if (!rootSchema) {\n      return undefined;\n    }\n\n    const tokens = path\n      .replace(/\\[(\\d+)\\]/g, '.$1')\n      .split('.')\n      .filter(Boolean);\n\n    let current: z.ZodTypeAny | undefined = rootSchema;\n    for (const token of tokens) {\n      if (!current) {\n        return undefined;\n      }\n\n      if (/^\\d+$/.test(token)) {\n        // An array field is usually `.optional()`: step through its wrappers to reach the array, the\n        // way `getObjectLikeFieldShape` does for an object — otherwise an item path under an optional\n        // array (`checklist.0.label`) resolves to nothing.\n        const arraySchema = unwrapSchema(current);\n        if (!isZodArray(arraySchema)) {\n          return undefined;\n        }\n        current = getZodDefProperty(arraySchema, 'element') as z.ZodTypeAny | undefined;\n        continue;\n      }\n\n      const shape = this.getObjectLikeFieldShape(current);\n      if (!shape) {\n        return undefined;\n      }\n\n      current = shape[token];\n    }\n\n    return current;\n  }\n\n\n  // =============================================================================\n  // DEFAULT VALIDATION MODE\n  // =============================================================================\n\n  /**\n   * Get default validation mode based on schema type.\n   * \n   * Different field types have different optimal validation timing:\n   * - Text fields (string, number): onBlur - avoids excessive validation during typing\n   * - Select/toggle fields (enum, boolean): onChange - immediate feedback for single-action inputs\n   * - Date/time fields: onChange - immediate feedback for picker selection\n   * - File fields: onChange - validate immediately after upload completes\n   * \n   * @param schemaType - The FieldSchemaType of the field\n   * @returns Default ValidationMode for this field type\n   */\n  public static getDefaultValidationMode(schemaType: FieldSchemaType): ValidationMode {\n    switch (schemaType) {\n      case FieldSchemaType.STRING:\n      case FieldSchemaType.NUMBER:\n      case FieldSchemaType.BIGINT:\n      case FieldSchemaType.MONEY:\n      case FieldSchemaType.BIGDECIMAL:\n      case FieldSchemaType.CODE:\n      // An address is typed part by part; its control reports blur when focus leaves the whole group.\n      case FieldSchemaType.ADDRESS:\n        return ValidationMode.ON_BLUR;\n      \n      case FieldSchemaType.ENUM:\n      case FieldSchemaType.BOOLEAN:\n        return ValidationMode.ON_CHANGE;\n      \n      case FieldSchemaType.DATE:\n      case FieldSchemaType.TIME:\n      case FieldSchemaType.DATETIME:\n      case FieldSchemaType.RANGE_DATE:\n      case FieldSchemaType.RANGE_TIME:\n      case FieldSchemaType.RANGE_DATETIME:\n        return ValidationMode.ON_CHANGE;\n      \n      case FieldSchemaType.FILE:\n        return ValidationMode.ON_CHANGE;\n      \n      case FieldSchemaType.RANGE_NUMBER:\n      case FieldSchemaType.RANGE_BIGDECIMAL:\n      case FieldSchemaType.RANGE_MONEY:\n        return ValidationMode.ON_CHANGE;\n      \n      case FieldSchemaType.OBJECT:\n      case FieldSchemaType.ARRAY:\n      case FieldSchemaType.RECORD:\n      case FieldSchemaType.MAP:\n        return ValidationMode.ON_SUBMIT;\n      \n      default:\n        return ValidationMode.ON_BLUR;\n    }\n  }\n\n  // =============================================================================\n  // DEFAULT VALUE FOR SCHEMA\n  // =============================================================================\n\n  /**\n   * Get a sensible default value for a given Zod schema type.\n   * \n   * Used by form components (AutomatedArrayField, FormFieldRecord, etc.) when creating\n   * new items/entries and a default value is needed.\n   * \n   * @param schema - The Zod schema to derive a default value from\n   * @returns A default value appropriate for the schema type\n   */\n  public static getDefaultValueForSchema(schema: z.ZodTypeAny): unknown {\n    const type = getSchemaType(schema);\n    switch (type) {\n      case FieldSchemaType.STRING:\n        return '';\n      case FieldSchemaType.NUMBER:\n      case FieldSchemaType.BIGINT:\n      case FieldSchemaType.BIGDECIMAL:\n        return 0;\n      case FieldSchemaType.BOOLEAN:\n        return false;\n      case FieldSchemaType.DATE:\n      case FieldSchemaType.DATETIME:\n        return new Date();\n      case FieldSchemaType.ENUM: {\n        const values = getEnumValues(schema);\n        return values.length > 0 ? values[0] : '';\n      }\n      case FieldSchemaType.ADDRESS: {\n        // An address is ONE value. An optional one stays `undefined` for the same reason an optional\n        // object does (below); a required one (an array item) starts as an empty draft in the field's\n        // default country, which the schema refuses until the user fills the required parts.\n        if (isOptional(schema)) {\n          return undefined;\n        }\n        return { line1: '', city: '', country: getAddressMetadata(schema)?.defaultCountry ?? '' };\n      }\n      case FieldSchemaType.MONEY:\n      case FieldSchemaType.DURATION: {\n        // Also ONE value each, so the address rule applies: an optional one stays `undefined`, and a\n        // required one (an array item) starts as the draft its own control starts from — a zero in a\n        // currency or unit the field allows (#990). The old `0` / `''` was not a MoneyValue or a\n        // DurationValue, so an added item could never become valid.\n        if (isOptional(schema)) {\n          return undefined;\n        }\n        return type === FieldSchemaType.MONEY ? createMoneyFieldDefaultValue(schema) : createDurationFieldDefaultValue(schema);\n      }\n      case FieldSchemaType.CODE: {\n        // ONE value: an empty snippet in the field's language — the authored default, else the first\n        // language the field allows, else none (a free-language field starts blank). Seeded as `''`\n        // before #1073, which is no code value at all, so an added item could never become valid.\n        if (isOptional(schema)) {\n          return undefined;\n        }\n        return { content: '', language: getCodeUI(schema)?.defaultLanguage ?? getCodeMetadata(schema)?.allowedLanguages?.[0] ?? '' };\n      }\n      case FieldSchemaType.RANGE_NUMBER:\n      case FieldSchemaType.RANGE_DATE:\n      case FieldSchemaType.RANGE_DATETIME:\n      case FieldSchemaType.RANGE_TIME:\n      case FieldSchemaType.RANGE_BIGDECIMAL:\n      case FieldSchemaType.RANGE_MONEY: {\n        // ONE value: `{ from, to }`, seeded with only the bounds the range REQUIRES (both are optional\n        // by default), each built from its own bound schema — a money range's bound through the money\n        // default, so it carries a currency the value schema accepts (#1073).\n        if (isOptional(schema)) {\n          return undefined;\n        }\n        const bounds = getObjectShape(schema) ?? {};\n        const seed: Record<string, unknown> = {};\n        for (const bound of ['from', 'to'] as const) {\n          const boundSchema = bounds[bound];\n          if (!boundSchema || isOptional(boundSchema)) continue;\n          seed[bound] = type === FieldSchemaType.RANGE_MONEY ? createMoneyFieldDefaultValue(boundSchema) : this.getDefaultValueForSchema(boundSchema);\n        }\n        return seed;\n      }\n      case FieldSchemaType.OBJECT: {\n        // An OPTIONAL object field must stay `undefined`, NOT a fabricated `{ nested defaults }`.\n        // `.optional()` means \"may be omitted\", and backend logic legitimately distinguishes\n        // `undefined` (not configured) from `{}`/`{ …defaults }` (explicitly configured). Only a\n        // REQUIRED object (e.g. an array's item TYPE, like the checklist item) recurses to a\n        // complete default below. A `.default(...)` object also returns `undefined` here — Zod\n        // re-applies its default at parse time, so the value is still correct on submit, without\n        // this helper pre-fabricating one. (`isOptional` is true for both `.optional()` and\n        // `.default()`; primitive fields like `done: z.boolean()` never reach this OBJECT case,\n        // so the array-item `done: false` seed is unaffected.)\n        if (isOptional(schema)) {\n          return undefined;\n        }\n        // Recurse into the object's fields so callers get a COMPLETE item default, not an\n        // empty `{}`. An empty object omits required-but-defaulted fields (e.g.\n        // `done: z.boolean().default(false)` on a checklist item), which makes a freshly\n        // added array item fail server validation on the whole-array autosave. Defaults are\n        // type-based (matching the primitives above). RECORD/MAP have no fixed shape, so they\n        // stay `{}`. (Surfaced by the read-inline array editor — array-element-authoring Step 4.)\n        let shape: Record<string, z.ZodTypeAny> | undefined;\n        try {\n          shape = getZodObjectShape(unwrapSchema(schema)) as Record<string, z.ZodTypeAny>;\n        } catch {\n          shape = undefined;\n        }\n        if (!shape) return {};\n        const result: Record<string, unknown> = {};\n        for (const [key, fieldSchema] of Object.entries(shape)) {\n          result[key] = this.getDefaultValueForSchema(fieldSchema);\n        }\n        return result;\n      }\n      case FieldSchemaType.RECORD:\n      case FieldSchemaType.MAP:\n        return {};\n      case FieldSchemaType.ARRAY:\n        return [];\n      default:\n        return '';\n    }\n  }\n\n  // =============================================================================\n  // ARRAY ADD-PATTERN RESOLUTION (quick-add primary field + add-mode default)\n  // =============================================================================\n\n  /**\n   * Resolve the PRIMARY field of an array item — the single value a user types to\n   * quick-add an entry (e.g. a checklist item's `label`).\n   *\n   * - **Primitive item** (`z.array(z.string())`, `z.array(z.number())`): the value\n   *   itself is the primary input, so `name` is `null` and `schema` is the item.\n   * - **Object item** (`z.array(z.object({ label, done }))`): the first STRING field\n   *   (label-like, the natural thing to type), else the first NUMBER field, else the\n   *   first field. Returned `name` is the object key; `schema` is that field's schema.\n   *\n   * Used by the quick-add row (form + read-inline) to render the staging input and\n   * to validate-before-add. Secondary fields (e.g. a `done` boolean) are seeded from\n   * {@link getDefaultValueForSchema} when the item is committed.\n   *\n   * @returns `{ name, schema }` — `name === null` means the item itself is the value.\n   */\n  public static getArrayItemPrimaryField(itemSchema: z.ZodTypeAny): { name: string | null; schema: z.ZodTypeAny } {\n    const itemType = getSchemaType(itemSchema);\n    if (itemType !== FieldSchemaType.OBJECT) {\n      return { name: null, schema: itemSchema };\n    }\n\n    const shape = getObjectShape(itemSchema);\n    if (!shape) {\n      return { name: null, schema: itemSchema };\n    }\n\n    const entries = Object.entries(shape);\n    const stringEntry = entries.find(([, fieldSchema]) => getSchemaType(fieldSchema) === FieldSchemaType.STRING);\n    if (stringEntry) {\n      return { name: stringEntry[0], schema: stringEntry[1] };\n    }\n    const numberEntry = entries.find(([, fieldSchema]) => getSchemaType(fieldSchema) === FieldSchemaType.NUMBER);\n    if (numberEntry) {\n      return { name: numberEntry[0], schema: numberEntry[1] };\n    }\n    const first = entries[0];\n    return first ? { name: first[0], schema: first[1] } : { name: null, schema: itemSchema };\n  }\n\n  /**\n   * Resolve the add-pattern ({@link ArrayAddMode}) for an array field.\n   *\n   * An explicit `arrayUI.edit.addMode` decorator wins. Otherwise the mode defaults\n   * **by item shape** — the framework's opinion about which add affordance fits:\n   *\n   * - **primitive** item → {@link ArrayAddMode.QUICK_ADD} (type-and-commit a value).\n   * - **address** item → {@link ArrayAddMode.APPEND_INLINE}: one structured value with no single\n   *   part that summarises it, so a typed quick-add string could never become an item.\n   * - **object with ≤ 1 prominent field** (string/number; e.g. checklist\n   *   `{ label, done }` — `label` is the only typed field) → `QUICK_ADD`. The single\n   *   typed field is staged in the add-row; the rest (booleans, enums) seed defaults.\n   * - **object with ≥ 2 prominent fields** → {@link ArrayAddMode.APPEND_INLINE}\n   *   (append a blank card and fill it in place — no single field summarises the item).\n   *\n   * {@link ArrayAddMode.DIALOG} is never auto-selected; it is opt-in for heavy items.\n   *\n   * @param arraySchema - the `z.array(...)` field schema (carries `arrayUI`).\n   * @param itemSchema - the array's item schema (drives the shape default).\n   */\n  public static resolveArrayAddMode(arraySchema: z.ZodTypeAny, itemSchema: z.ZodTypeAny): ArrayAddMode {\n    const explicit = getArrayUI(arraySchema)?.edit?.addMode;\n    if (explicit) {\n      return explicit;\n    }\n\n    const itemType = getSchemaType(itemSchema);\n    // A structured value is not OBJECT to `getSchemaType`, and falling to QUICK_ADD would render a text\n    // box whose string never parses as that value: nothing could ever be added (#561, #990).\n    if (STRUCTURED_VALUE_ITEM_TYPES.has(itemType)) {\n      return ArrayAddMode.APPEND_INLINE;\n    }\n    if (itemType !== FieldSchemaType.OBJECT) {\n      return ArrayAddMode.QUICK_ADD;\n    }\n\n    const shape = getObjectShape(itemSchema);\n    if (!shape) {\n      return ArrayAddMode.APPEND_INLINE;\n    }\n\n    const prominentFieldCount = Object.values(shape).filter((fieldSchema) => {\n      const fieldType = getSchemaType(fieldSchema);\n      return fieldType === FieldSchemaType.STRING || fieldType === FieldSchemaType.NUMBER;\n    }).length;\n\n    return prominentFieldCount <= 1 ? ArrayAddMode.QUICK_ADD : ArrayAddMode.APPEND_INLINE;\n  }\n\n  // =============================================================================\n  // CONDITIONAL VISIBILITY — DISCRIMINATED UNIONS\n  // =============================================================================\n\n  /**\n   * Compute field visibility based on discriminated union configuration.\n   * \n   * For schema families (discriminated unions), variant fields should only be\n   * visible when the discriminator value matches their variant.\n   */\n  public static computeFieldVisibility(\n    formSchema: z.ZodTypeAny,\n    fieldName: string,\n    formValues: Record<string, unknown>,\n    inheritanceConfig?: InheritanceSchemaDefinition,\n    options: { showAllWhenDiscriminatorUndefined?: boolean } = {}\n  ): boolean {\n    const { showAllWhenDiscriminatorUndefined = true } = options;\n    \n    if (!inheritanceConfig) {\n      return true;\n    }\n    \n    const { discriminatorField, withoutInheritanceDiscriminatorFieldValues, inheritedSchemas } = inheritanceConfig;\n    \n    const currentDiscriminatorValue = formValues[discriminatorField];\n    if (currentDiscriminatorValue === undefined) {\n      return showAllWhenDiscriminatorUndefined;\n    }\n    \n    const variantOnlyFields = this.getVariantOnlyFields(formSchema, inheritanceConfig);\n    \n    if (!variantOnlyFields.has(fieldName)) {\n      return true;\n    }\n    \n    if (withoutInheritanceDiscriminatorFieldValues?.includes(currentDiscriminatorValue as string)) {\n      return false;\n    }\n    \n    const currentVariant = inheritedSchemas?.find(\n      v => v.discriminatorFieldValue === currentDiscriminatorValue\n    );\n    \n    if (!currentVariant) {\n      return true;\n    }\n    \n    const variantShape = getZodObjectShape(currentVariant.schema);\n    if (variantShape && fieldName in variantShape) {\n      return true;\n    }\n    \n    return false;\n  }\n\n  // =============================================================================\n  // SHOW WHEN — CONDITION-BASED FIELD VISIBILITY\n  // =============================================================================\n\n  private static evaluateShowWhenCondition(\n    condition: ShowWhenCondition,\n    formValues: Record<string, unknown>\n  ): boolean {\n    const fieldValue = formValues[condition.field];\n    const operator = condition.operator ?? ShowWhenOperator.EQUALS;\n\n    switch (operator) {\n      case ShowWhenOperator.EQUALS:\n        if (Array.isArray(condition.value)) {\n          return condition.value.includes(fieldValue);\n        }\n        return fieldValue === condition.value;\n\n      case ShowWhenOperator.NOT_EQUALS:\n        if (Array.isArray(condition.value)) {\n          return !condition.value.includes(fieldValue);\n        }\n        return fieldValue !== condition.value;\n\n      case ShowWhenOperator.IN:\n        if (!Array.isArray(condition.value)) return false;\n        return condition.value.includes(fieldValue);\n\n      case ShowWhenOperator.NOT_IN:\n        if (!Array.isArray(condition.value)) return true;\n        return !condition.value.includes(fieldValue);\n\n      case ShowWhenOperator.EXISTS:\n        return fieldValue !== undefined && fieldValue !== null;\n\n      case ShowWhenOperator.NOT_EXISTS:\n        return fieldValue === undefined || fieldValue === null;\n\n      default:\n        return true;\n    }\n  }\n\n  /**\n   * Evaluate showWhen conditions for a field.\n   */\n  public static evaluateShowWhen(\n    showWhenParams: ShowWhenParams,\n    formValues: Record<string, unknown>\n  ): boolean {\n    const conditions = Array.isArray(showWhenParams.conditions)\n      ? showWhenParams.conditions\n      : [showWhenParams.conditions];\n\n    if (conditions.length === 0) return true;\n\n    const combineWith = showWhenParams.combineWith ?? 'and';\n\n    if (combineWith === 'and') {\n      return conditions.every(c => this.evaluateShowWhenCondition(c, formValues));\n    } else {\n      return conditions.some(c => this.evaluateShowWhenCondition(c, formValues));\n    }\n  }\n\n  /**\n   * Get showWhen parameters from a field schema.\n   */\n  public static getFieldShowWhenParams(fieldSchema: z.ZodTypeAny): ShowWhenParams | undefined {\n    return getShowWhenParams(fieldSchema);\n  }\n\n  /**\n   * Get the field names that a showWhen configuration depends on.\n   */\n  public static getShowWhenWatchFields(showWhenParams: ShowWhenParams): string[] {\n    const conditions = Array.isArray(showWhenParams.conditions)\n      ? showWhenParams.conditions\n      : [showWhenParams.conditions];\n    return [...new Set(conditions.map(c => c.field))];\n  }\n\n  /**\n   * Get fields that ONLY exist in variant schemas (not in base schema).\n   */\n  private static getVariantOnlyFields(\n    formSchema: z.ZodTypeAny,\n    inheritanceConfig: InheritanceSchemaDefinition\n  ): Set<string> {\n    const variantOnlyFields = new Set<string>();\n    \n    if (!inheritanceConfig.inheritedSchemas) {\n      return variantOnlyFields;\n    }\n    \n    // `formSchema` is the resource's ROOT form schema. For an inherited\n    // (discriminated-union) resource that root IS the union, and object-only\n    // `getZodObjectShape` returns `undefined` on a union — which would leave\n    // `baseFieldKeys` empty and (wrongly) classify EVERY field as variant-only.\n    // The fields then collapse: `computeFieldVisibility` hides any \"variant-only\"\n    // field whose discriminator is a base value (`withoutInheritance…`), so a\n    // freshly-seeded base variant (e.g. todos `recurringType: one_time`) renders\n    // ZERO fields. Use the union-aware common view (`commonOnly: true` = keys\n    // present in EVERY variant) so the true base fields are recognised and only\n    // genuinely variant-specific fields are gated by the discriminator.\n    const baseShape = this.getObjectLikeFieldShape(formSchema, { commonOnly: true });\n    const baseFieldKeys = baseShape ? new Set(Object.keys(baseShape)) : new Set<string>();\n\n    for (const variant of inheritanceConfig.inheritedSchemas) {\n      const variantShape = getZodObjectShape(variant.schema);\n      if (!variantShape) continue;\n      \n      for (const fieldName of Object.keys(variantShape)) {\n        if (fieldName === inheritanceConfig.discriminatorField) continue;\n        if (!baseFieldKeys.has(fieldName)) {\n          variantOnlyFields.add(fieldName);\n        }\n      }\n    }\n    \n    return variantOnlyFields;\n  }\n\n  /**\n   * Detect if a schema has inheritance configuration by looking for discriminator fields.\n   */\n  public static detectDiscriminatorConfig(formSchema: z.ZodTypeAny): {\n    discriminatorField: string;\n    baseValues: string[];\n  } | null {\n    const shape = getZodObjectShape(formSchema);\n    if (!shape) return null;\n    \n    for (const [fieldName, fieldSchema] of Object.entries(shape)) {\n      const discriminatorParams = getDiscriminatorParams(fieldSchema as z.ZodTypeAny);\n      if (discriminatorParams) {\n        return {\n          discriminatorField: fieldName,\n          baseValues: discriminatorParams.baseValues || [],\n        };\n      }\n    }\n    \n    return null;\n  }\n\n  // =============================================================================\n  // EXCLUDE HIDDEN FIELDS FROM VALIDATION\n  // =============================================================================\n\n  /**\n   * Get list of visible field names based on current form values.\n   */\n  public static getVisibleFieldNames(\n    formSchema: z.ZodTypeAny,\n    formValues: Record<string, unknown>,\n    inheritanceConfig?: InheritanceSchemaDefinition\n  ): string[] {\n    // Union-aware: a discriminated-union root has no object shape, so use the\n    // merged variant view (every candidate field across variants).\n    const shape = this.getObjectLikeFieldShape(formSchema);\n    if (!shape) return [];\n\n    const allFieldNames = Object.keys(shape);\n\n    if (!inheritanceConfig) {\n      return allFieldNames;\n    }\n    \n    return allFieldNames.filter(fieldName => \n      this.computeFieldVisibility(formSchema, fieldName, formValues, inheritanceConfig)\n    );\n  }\n\n  /**\n   * Filter form data to only include visible fields.\n   */\n  public static filterVisibleFormData<T extends Record<string, unknown>>(\n    formData: T,\n    formSchema: z.ZodTypeAny,\n    inheritanceConfig?: InheritanceSchemaDefinition\n  ): Partial<T> {\n    if (!inheritanceConfig) {\n      return formData;\n    }\n    \n    const visibleFields = this.getVisibleFieldNames(formSchema, formData, inheritanceConfig);\n    const visibleFieldsSet = new Set(visibleFields);\n    \n    const result: Partial<T> = {};\n    \n    for (const [key, value] of Object.entries(formData)) {\n      const topLevelKey = key.split('.')[0];\n      if (visibleFieldsSet.has(topLevelKey) || visibleFieldsSet.has(key)) {\n        (result as Record<string, unknown>)[key] = value;\n      }\n    }\n    \n    return result;\n  }\n\n  /**\n   * Get field names to exclude from validation.\n   */\n  public static getHiddenFieldNames(\n    formSchema: z.ZodTypeAny,\n    formValues: Record<string, unknown>,\n    inheritanceConfig?: InheritanceSchemaDefinition\n  ): string[] {\n    // Union-aware: a discriminated-union root has no object shape, so use the\n    // merged variant view (every candidate field across variants).\n    const shape = this.getObjectLikeFieldShape(formSchema);\n    if (!shape) return [];\n\n    if (!inheritanceConfig) {\n      return [];\n    }\n\n    const allFieldNames = Object.keys(shape);\n\n    return allFieldNames.filter(fieldName =>\n      !this.computeFieldVisibility(formSchema, fieldName, formValues, inheritanceConfig)\n    );\n  }\n\n  // =============================================================================\n  // DYNAMIC REQUIRED INDICATOR\n  // =============================================================================\n\n  /**\n   * Compute if a field should display the required indicator.\n   * A field shows as required when it is not optional in the schema AND currently visible.\n   */\n  public static isFieldEffectivelyRequired(\n    fieldSchema: z.ZodTypeAny,\n    fieldName: string,\n    formSchema: z.ZodTypeAny,\n    formValues: Record<string, unknown>,\n    inheritanceConfig?: InheritanceSchemaDefinition\n  ): boolean {\n    const fieldIsOptional = isOptional(fieldSchema);\n    \n    if (fieldIsOptional) {\n      return false;\n    }\n    \n    const fieldIsVisible = this.computeFieldVisibility(\n      formSchema,\n      fieldName,\n      formValues,\n      inheritanceConfig\n    );\n    \n    if (!fieldIsVisible) {\n      return false;\n    }\n    \n    return true;\n  }\n\n  /**\n   * Get required state for all fields in a schema.\n   */\n  public static computeAllRequiredStates(\n    formSchema: z.ZodTypeAny,\n    formValues: Record<string, unknown>,\n    inheritanceConfig?: InheritanceSchemaDefinition\n  ): Record<string, boolean> {\n    // Union-aware: a discriminated-union root has no object shape, so use the\n    // merged variant view (every candidate field across variants).\n    const shape = this.getObjectLikeFieldShape(formSchema);\n    if (!shape) return {};\n\n    const result: Record<string, boolean> = {};\n    \n    for (const [fieldName, fieldSchema] of Object.entries(shape)) {\n      result[fieldName] = this.isFieldEffectivelyRequired(\n        fieldSchema as z.ZodTypeAny,\n        fieldName,\n        formSchema,\n        formValues,\n        inheritanceConfig\n      );\n    }\n    \n    return result;\n  }\n  \n}\n"]}
+{"version":3,"file":"automated-layout.frontend.utils.js","sourceRoot":"","sources":["../../../../src/core/automated-layout/automated-layout.frontend.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\n\nimport type { InheritanceSchemaDefinition } from './automated-layout.frontend.schemas';\nimport {\n  FieldSchemaType,\n  getFileMetadata,\n  getAddressMetadata,\n  getCodeMetadata,\n  getCodeUI,\n  getEnumValues,\n  getSchemaType,\n  getObjectShape,\n  getArrayItemSchema,\n  getArrayUI,\n  ArrayAddMode,\n  getZodObjectShape,\n  getDiscriminatorParams,\n  getZodDefArrayProperty,\n  getZodDefProperty,\n  getZodDefStringProperty,\n  getZodType,\n  isOptional,\n  isZodArray,\n  isZodObject,\n  ValidationMode,\n  ShowWhenOperator,\n  getShowWhenParams,\n  type ShowWhenParams,\n  type ShowWhenCondition,\n  isFileSchema,\n  isFieldContainerSchema,\n  unwrapSchema,\n  FileGenerationSource,\n  type FileSchemaMetadata,\n} from '@wildo-ai/zod-decorators';\nimport { createDurationFieldDefaultValue, createMoneyFieldDefaultValue } from './composite-value-defaults.frontend.utils';\n\n/**\n * Field types whose value is ONE structured object although `getSchemaType` does not answer `OBJECT`.\n *\n * A list of them cannot use the quick-add box: the box stages the typed TEXT and commits only what the\n * item schema accepts, and no string is an address, an amount of money or a duration — so nothing could\n * ever be added (#561, #990). Their items append a draft from `getDefaultValueForSchema` instead.\n *\n * `CODE` and the `RANGE_*` types are structured values too and are not listed yet: a draft for them is\n * not built, and switching the add mode alone would append an item that can never become valid (#1073).\n */\nconst STRUCTURED_VALUE_ITEM_TYPES: ReadonlySet<FieldSchemaType> = new Set([\n  FieldSchemaType.ADDRESS,\n  FieldSchemaType.MONEY,\n  FieldSchemaType.DURATION,\n  // A code value is `{ content, language }` and a range is `{ from, to }` — objects to the schema and\n  // structured values to `getSchemaType`, so the same rule (#1073): append a draft, never a text box.\n  FieldSchemaType.CODE,\n  FieldSchemaType.RANGE_NUMBER,\n  FieldSchemaType.RANGE_DATE,\n  FieldSchemaType.RANGE_DATETIME,\n  FieldSchemaType.RANGE_TIME,\n  FieldSchemaType.RANGE_BIGDECIMAL,\n  FieldSchemaType.RANGE_MONEY,\n]);\n\n\nexport class AutomatedLayoutFrontendUtils {\n  private static buildUnsupportedPlainUnionFileFieldMessage(pathPrefix: string): string {\n    return `Unsupported z.union() file field schema detected at \"${pathPrefix || '<root>'}\". File fields inside non-discriminated unions must use z.discriminatedUnion().`;\n  }\n\n  private static normalizeFileMetadataForComparison(value: unknown): unknown {\n    if (Array.isArray(value)) {\n      return value.map((item) => AutomatedLayoutFrontendUtils.normalizeFileMetadataForComparison(item));\n    }\n\n    if (value && typeof value === 'object') {\n      return Object.fromEntries(\n        Object.entries(value as Record<string, unknown>)\n          .sort(([left], [right]) => left.localeCompare(right))\n          .map(([key, childValue]) => [\n            key,\n            AutomatedLayoutFrontendUtils.normalizeFileMetadataForComparison(childValue),\n          ]),\n      );\n    }\n\n    return value;\n  }\n\n  private static areFileMetadataCompatible(\n    left: FileSchemaMetadata,\n    right: FileSchemaMetadata,\n  ): boolean {\n    return JSON.stringify(AutomatedLayoutFrontendUtils.normalizeFileMetadataForComparison(left))\n      === JSON.stringify(AutomatedLayoutFrontendUtils.normalizeFileMetadataForComparison(right));\n  }\n\n  private static collectFileFieldMetadata(\n    schema: z.ZodTypeAny | undefined,\n    pathPrefix: string = '',\n  ): Array<{ fieldName: string; fileMetadata: FileSchemaMetadata }> {\n    if (!schema) {\n      return [];\n    }\n\n    const unwrappedSchema = unwrapSchema(schema);\n    if (isFileSchema(unwrappedSchema)) {\n      const fileMetadata = getFileMetadata(unwrappedSchema);\n      return fileMetadata?.isFile && pathPrefix\n        ? [{ fieldName: pathPrefix, fileMetadata }]\n        : [];\n    }\n\n    if (isZodArray(unwrappedSchema)) {\n      const elementSchema = getZodDefProperty(unwrappedSchema, 'element') as z.ZodTypeAny | undefined;\n      return this.collectFileFieldMetadata(elementSchema, pathPrefix);\n    }\n\n    if (isZodObject(unwrappedSchema)) {\n      const shape = getZodObjectShape(unwrappedSchema);\n      return Object.entries(shape).flatMap(([fieldName, fieldSchema]) => {\n        const nextPath = pathPrefix ? `${pathPrefix}.${fieldName}` : fieldName;\n        return this.collectFileFieldMetadata(fieldSchema, nextPath);\n      });\n    }\n\n    const unionOptions = this.getDiscriminatedUnionObjectOptions(unwrappedSchema);\n    if (unionOptions.length === 0) {\n      const plainUnionOptions = this.getPlainUnionObjectOptions(unwrappedSchema);\n      if (plainUnionOptions.length === 0) {\n        return [];\n      }\n\n      const plainUnionMetadata = plainUnionOptions.map((option) =>\n        this.collectFileFieldMetadata(option, pathPrefix),\n      );\n      if (plainUnionMetadata.some((entries) => entries.length > 0)) {\n        throw new Error(this.buildUnsupportedPlainUnionFileFieldMessage(pathPrefix));\n      }\n      return [];\n    }\n\n    const merged = new Map<string, { fieldName: string; fileMetadata: FileSchemaMetadata }>();\n    for (const option of unionOptions) {\n      for (const entry of this.collectFileFieldMetadata(option, pathPrefix)) {\n        const existing = merged.get(entry.fieldName);\n        if (!existing) {\n          merged.set(entry.fieldName, entry);\n          continue;\n        }\n\n        if (!this.areFileMetadataCompatible(existing.fileMetadata, entry.fileMetadata)) {\n          throw new Error(\n            `Incompatible z_file() metadata detected for canonical file field path \"${entry.fieldName}\".`,\n          );\n        }\n      }\n    }\n\n    return Array.from(merged.values()).sort((left, right) => left.fieldName.localeCompare(right.fieldName));\n  }\n\n\n  // =============================================================================\n  // FIELD LABEL FORMATTING\n  // =============================================================================\n\n  /**\n   * What a field renders as when no label resolved — the RAW KEY SEGMENT, unchanged.\n   *\n   * ## Why this returns the key rather than words\n   *\n   * Until 2026-09-08 this was `unresolvedFieldLabel`, and it produced sentence case from the\n   * identifier: `firstName` -> `First Name`, `created_at` -> `Created At`, with a special case\n   * turning `Id` into `ID`. It was convincing, which is exactly what made it a defect (#420):\n   *\n   * - **a missing label did not look missing**, so nobody ever authored one. The fallback ran only\n   *   where the label was absent — precisely the case somebody needed to notice;\n   * - **it was English in every locale**, because it was code producing words rather than a\n   *   translation, and no translator could find it — it was not in the label tree;\n   * - **it was silently wrong on anything it could not know**: `GDPR` -> `Gdpr`, `EUR` -> `Eur`.\n   *   Which all-caps token is an acronym is not derivable from the string, so the `Id` special case\n   *   was a guess that happened to be right once.\n   *\n   * The key itself is honest: visible, greppable, obviously not a label, identical in every locale.\n   * It is what `t()` already returns for an unresolved key.\n   *\n   * ## Why an identity function rather than nothing\n   *\n   * The call is kept, named and documented in one place so the surfaces that reach it share ONE\n   * decision rather than nine inlined ones — and so a future author who wants to \"improve the\n   * fallback\" finds this argument instead of an anonymous expression. See\n   * `.claude/rules/display-text-comes-from-i18n.md`.\n   *\n   * ## When it is reached\n   *\n   * Only AFTER label resolution has SETTLED. Surfaces gate on `useI18n().isReady`, which settles on\n   * a failed bundle as well as a loaded one, so a key is never flashed while labels are in flight.\n   *\n   * @param key - A single field key segment (no dots)\n   */\n  public static unresolvedFieldLabel(key: string): string {\n    return key;\n  }\n\n  /**\n   * Join a dotted field path for display in error messages and breadcrumbs, with array indices\n   * rendered 1-based.\n   *\n   * Each segment passes through {@link unresolvedFieldLabel}, which since 2026-09-08 (#420) is the\n   * IDENTITY function — so this reads as the raw path with separators, never as invented words. It\n   * is reached only when no i18n resolver is available, and a path that looks like a path is the\n   * honest rendering of that: see `.claude/rules/display-text-comes-from-i18n.md`.\n   *\n   * @example\n   * formatFieldPathFallback('address.streetName') → 'address › streetName'\n   * formatFieldPathFallback('items.0.name') → 'items › [1] › name'\n   */\n  public static formatFieldPathFallback(path: string): string {\n    return path\n      .split('.')\n      .map((part) =>\n        /^\\d+$/.test(part)\n          ? `[${parseInt(part, 10) + 1}]`\n          : AutomatedLayoutFrontendUtils.unresolvedFieldLabel(part)\n      )\n      .join(' › ');\n  }\n\n  /**\n   * Normalize runtime field paths to the canonical schema-key form used by\n   * `fileUploadContext`.\n   *\n   * Runtime field scopes include array indices (`attachments[0].file`), but the\n   * schema-level upload contract is keyed by the structural path\n   * (`attachments.file`). Centralizing this normalization keeps nested display\n   * and form consumers aligned without inventing per-index endpoint entries.\n   */\n  public static normalizeSchemaFieldPath(path: string): string {\n    return path.replace(/\\[\\d+\\]/g, '');\n  }\n\n  /**\n   * Create a field label resolver that resolves each path segment through i18n, and renders the raw\n   * segment when no label is authored.\n   *\n   * When `resourceType` is provided, each path segment is resolved via `tResourceFieldEdit`.\n   * If the i18n lookup returns the raw key (not found), the segment falls through\n   * {@link unresolvedFieldLabel} — the identity function, so a missing label READS as missing\n   * rather than as a plausible name.\n   * When `resourceType` is not provided, uses `formatFieldPathFallback` directly.\n   *\n   * ## A path that ends INSIDE a structured value names the value (#1959)\n   *\n   * A validation error on a money field's amount arrives at `amount.amount`, on an address's first\n   * line at `address.line1`. Those parts are not fields of the resource: the value's own component\n   * draws and names them, and the resource has one word for the whole value — so no label is planned\n   * for `amount.amount`, and asking for one would render the raw part name after the field's label.\n   * Given the form's `schema`, the resolver stops at the first segment whose schema does not hold\n   * fields (`isFieldContainerSchema`) and names that field alone. The inline error beside the part\n   * still says which part. Without a schema every segment is resolved as before.\n   *\n   * The same boundary ends a path into an ARRAY that continues with a name rather than an index —\n   * `tags.root`, where react-hook-form puts an error about the list itself — which names the list.\n   *\n   * @param resourceType - The resource type for i18n lookup\n   * @param tResourceFieldEdit - i18n function for field label resolution\n   * @param schema - The form's schema, when known: lets the resolver stop at a structured value\n   * @returns A function that resolves a dot-path to a human-readable label\n   */\n  public static createFieldLabelResolver(\n    resourceType: string | undefined,\n    tResourceFieldEdit: (resourceType: string, fieldPath: string, key: string) => string,\n    schema?: z.ZodTypeAny,\n  ): (path: string) => string {\n    if (!resourceType) {\n      return AutomatedLayoutFrontendUtils.formatFieldPathFallback;\n    }\n\n    return (path: string): string => {\n      const segments = path.split('.');\n      const rendered: string[] = [];\n      /*\n       * The schema of the value the NEXT segment addresses: the form's own schema at the root, then\n       * each field's, then an array's item after an index. `undefined` once the walk cannot follow the\n       * path, which leaves every remaining segment resolved as it always was.\n       */\n      let current: z.ZodTypeAny | undefined = schema;\n      for (const [index, segment] of segments.entries()) {\n        if (/^\\d+$/.test(segment)) {\n          rendered.push(`[${parseInt(segment, 10) + 1}]`);\n          current = current && getSchemaType(current) === FieldSchemaType.ARRAY ? (getArrayItemSchema(current) ?? undefined) : undefined;\n          continue;\n        }\n        // Everything below a value that holds no fields is that value's own part: the field is already named.\n        if (current && rendered.length > 0 && !isFieldContainerSchema(current)) break;\n        /*\n         * Labels are per FIELD, not per row: the key is index-free (`lines.label`, never `lines.2.label`), the\n         * same path the renderer's walk and the labelling planner use. Joining the raw segments asked for a key\n         * nothing plans, so an error inside any array item rendered its raw field name.\n         */\n        const fieldPath = segments.slice(0, index + 1).filter((part) => !/^\\d+$/.test(part)).join('.');\n        const label = tResourceFieldEdit(resourceType, fieldPath, 'label');\n        /*\n         * A miss answers the bare FIELD PATH (`tResourceFieldEdit` hands its key to `unresolvedFieldLabel`), so that\n         * is what a miss looks like here. This compared against `<resource>.<path>.label`, which no lookup ever\n         * returns, so a missing label for `profile.city` rendered `profile › profile.city` instead of the segment.\n         */\n        rendered.push(label === fieldPath ? AutomatedLayoutFrontendUtils.unresolvedFieldLabel(segment) : label);\n        current = current\n          ? AutomatedLayoutFrontendUtils.getObjectLikeFieldShape(current, { commonOnly: false })?.[segment]\n          : undefined;\n      }\n      return rendered.join(' › ');\n    };\n  }\n\n  // =============================================================================\n  // OBJECT-LIKE SCHEMA HELPERS\n  // =============================================================================\n\n  /**\n   * Return object variants when a schema is a discriminated union of objects.\n   * Returns an empty array for plain objects or non-object unions.\n   */\n  public static getDiscriminatedUnionObjectOptions(schema: z.ZodTypeAny): z.ZodObject<any>[] {\n    if (getZodType(schema) !== 'union') {\n      return [];\n    }\n\n    const discriminator = getZodDefStringProperty(schema, 'discriminator');\n    const options = getZodDefArrayProperty(schema, 'options') as z.ZodTypeAny[] | undefined;\n    if (!discriminator || !options?.length) {\n      return [];\n    }\n\n    return options.filter((option): option is z.ZodObject<any> => isZodObject(option));\n  }\n\n  private static getPlainUnionObjectOptions(schema: z.ZodTypeAny): z.ZodObject<any>[] {\n    if (getZodType(schema) !== 'union') {\n      return [];\n    }\n\n    const discriminator = getZodDefStringProperty(schema, 'discriminator');\n    const options = getZodDefArrayProperty(schema, 'options') as z.ZodTypeAny[] | undefined;\n    if (discriminator || !options?.length) {\n      return [];\n    }\n\n    return options.filter((option): option is z.ZodObject<any> => isZodObject(option));\n  }\n\n  /**\n   * Resolve a field-shape view for schemas that are either plain objects or\n   * discriminated unions of objects.\n   *\n   * - `commonOnly: true` keeps only keys present in every union variant. This is\n   *   the safe view for generated root layouts because variant-only fields must\n   *   stay under discriminator switching.\n   * - `commonOnly: false` unions keys across variants and picks the first\n   *   matching schema for each key. This is the permissive view for runtime\n   *   lookups such as wrapper shaping or field schema resolution.\n   */\n  public static getObjectLikeFieldShape(\n    schema: z.ZodTypeAny,\n    options: { commonOnly?: boolean } = {},\n  ): Record<string, z.ZodTypeAny> | undefined {\n    const unwrappedSchema = unwrapSchema(schema);\n    if (isZodObject(unwrappedSchema)) {\n      return getZodObjectShape(unwrappedSchema);\n    }\n\n    const unionOptions = this.getDiscriminatedUnionObjectOptions(unwrappedSchema);\n    if (unionOptions.length === 0) {\n      return undefined;\n    }\n\n    const optionShapes = unionOptions.map((option) => getZodObjectShape(option));\n    if (options.commonOnly) {\n      const [firstShape, ...restShapes] = optionShapes;\n      const commonKeys = Object.keys(firstShape).filter((key) =>\n        restShapes.every((shape) => Object.prototype.hasOwnProperty.call(shape, key)),\n      );\n\n      return Object.fromEntries(\n        commonKeys.map((key) => [key, firstShape[key] as z.ZodTypeAny]),\n      );\n    }\n\n    const mergedShape: Record<string, z.ZodTypeAny> = {};\n    for (const shape of optionShapes) {\n      for (const [fieldName, fieldSchema] of Object.entries(shape)) {\n        if (!Object.prototype.hasOwnProperty.call(mergedShape, fieldName)) {\n          mergedShape[fieldName] = fieldSchema as z.ZodTypeAny;\n        }\n      }\n    }\n\n    return mergedShape;\n  }\n\n  /**\n   * Collect canonical schema paths for every `z_file()` field reachable from the\n   * provided schema.\n   *\n   * The returned paths never include array indices. Array item scopes resolve\n   * those dynamically at render time and then normalize back through\n   * `normalizeSchemaFieldPath()`.\n   */\n  public static collectFileFieldPaths(\n    schema: z.ZodTypeAny | undefined,\n    pathPrefix: string = '',\n  ): string[] {\n    return this.collectFileFieldMetadata(schema, pathPrefix).map((entry) => entry.fieldName);\n  }\n\n  public static collectUploadableFileFieldPaths(\n    schema: z.ZodTypeAny | undefined,\n    pathPrefix: string = '',\n  ): string[] {\n    return this.collectFileFieldMetadata(schema, pathPrefix)\n      .filter((entry) => entry.fileMetadata.generation?.source !== FileGenerationSource.PDF_TEMPLATE)\n      .map((entry) => entry.fieldName);\n  }\n\n  public static resolveFieldSchemaPath(\n    rootSchema: z.ZodTypeAny | undefined,\n    path: string,\n  ): z.ZodTypeAny | undefined {\n    if (!rootSchema) {\n      return undefined;\n    }\n\n    const tokens = path\n      .replace(/\\[(\\d+)\\]/g, '.$1')\n      .split('.')\n      .filter(Boolean);\n\n    let current: z.ZodTypeAny | undefined = rootSchema;\n    for (const token of tokens) {\n      if (!current) {\n        return undefined;\n      }\n\n      if (/^\\d+$/.test(token)) {\n        // An array field is usually `.optional()`: step through its wrappers to reach the array, the\n        // way `getObjectLikeFieldShape` does for an object — otherwise an item path under an optional\n        // array (`checklist.0.label`) resolves to nothing.\n        const arraySchema = unwrapSchema(current);\n        if (!isZodArray(arraySchema)) {\n          return undefined;\n        }\n        current = getZodDefProperty(arraySchema, 'element') as z.ZodTypeAny | undefined;\n        continue;\n      }\n\n      const shape = this.getObjectLikeFieldShape(current);\n      if (!shape) {\n        return undefined;\n      }\n\n      current = shape[token];\n    }\n\n    return current;\n  }\n\n\n  // =============================================================================\n  // DEFAULT VALIDATION MODE\n  // =============================================================================\n\n  /**\n   * Get default validation mode based on schema type.\n   * \n   * Different field types have different optimal validation timing:\n   * - Text fields (string, number): onBlur - avoids excessive validation during typing\n   * - Select/toggle fields (enum, boolean): onChange - immediate feedback for single-action inputs\n   * - Date/time fields: onChange - immediate feedback for picker selection\n   * - File fields: onChange - validate immediately after upload completes\n   * \n   * @param schemaType - The FieldSchemaType of the field\n   * @returns Default ValidationMode for this field type\n   */\n  public static getDefaultValidationMode(schemaType: FieldSchemaType): ValidationMode {\n    switch (schemaType) {\n      case FieldSchemaType.STRING:\n      case FieldSchemaType.NUMBER:\n      case FieldSchemaType.BIGINT:\n      case FieldSchemaType.MONEY:\n      case FieldSchemaType.BIGDECIMAL:\n      case FieldSchemaType.CODE:\n      // An address is typed part by part; its control reports blur when focus leaves the whole group.\n      case FieldSchemaType.ADDRESS:\n        return ValidationMode.ON_BLUR;\n      \n      case FieldSchemaType.ENUM:\n      case FieldSchemaType.BOOLEAN:\n        return ValidationMode.ON_CHANGE;\n      \n      case FieldSchemaType.DATE:\n      case FieldSchemaType.TIME:\n      case FieldSchemaType.DATETIME:\n      case FieldSchemaType.RANGE_DATE:\n      case FieldSchemaType.RANGE_TIME:\n      case FieldSchemaType.RANGE_DATETIME:\n        return ValidationMode.ON_CHANGE;\n      \n      case FieldSchemaType.FILE:\n        return ValidationMode.ON_CHANGE;\n      \n      case FieldSchemaType.RANGE_NUMBER:\n      case FieldSchemaType.RANGE_BIGDECIMAL:\n      case FieldSchemaType.RANGE_MONEY:\n        return ValidationMode.ON_CHANGE;\n      \n      case FieldSchemaType.OBJECT:\n      case FieldSchemaType.ARRAY:\n      case FieldSchemaType.RECORD:\n      case FieldSchemaType.MAP:\n        return ValidationMode.ON_SUBMIT;\n      \n      default:\n        return ValidationMode.ON_BLUR;\n    }\n  }\n\n  // =============================================================================\n  // DEFAULT VALUE FOR SCHEMA\n  // =============================================================================\n\n  /**\n   * Get a sensible default value for a given Zod schema type.\n   * \n   * Used by form components (AutomatedArrayField, FormFieldRecord, etc.) when creating\n   * new items/entries and a default value is needed.\n   * \n   * @param schema - The Zod schema to derive a default value from\n   * @returns A default value appropriate for the schema type\n   */\n  public static getDefaultValueForSchema(schema: z.ZodTypeAny): unknown {\n    const type = getSchemaType(schema);\n    switch (type) {\n      case FieldSchemaType.STRING:\n        return '';\n      case FieldSchemaType.NUMBER:\n      case FieldSchemaType.BIGINT:\n      case FieldSchemaType.BIGDECIMAL:\n        return 0;\n      case FieldSchemaType.BOOLEAN:\n        return false;\n      case FieldSchemaType.DATE:\n      case FieldSchemaType.DATETIME:\n        return new Date();\n      case FieldSchemaType.ENUM: {\n        const values = getEnumValues(schema);\n        return values.length > 0 ? values[0] : '';\n      }\n      case FieldSchemaType.ADDRESS: {\n        // An address is ONE value. An optional one stays `undefined` for the same reason an optional\n        // object does (below); a required one (an array item) starts as an empty draft in the field's\n        // default country, which the schema refuses until the user fills the required parts.\n        if (isOptional(schema)) {\n          return undefined;\n        }\n        return { line1: '', city: '', country: getAddressMetadata(schema)?.defaultCountry ?? '' };\n      }\n      case FieldSchemaType.MONEY:\n      case FieldSchemaType.DURATION: {\n        // Also ONE value each, so the address rule applies: an optional one stays `undefined`, and a\n        // required one (an array item) starts as the draft its own control starts from — a zero in a\n        // currency or unit the field allows (#990). The old `0` / `''` was not a MoneyValue or a\n        // DurationValue, so an added item could never become valid.\n        if (isOptional(schema)) {\n          return undefined;\n        }\n        return type === FieldSchemaType.MONEY ? createMoneyFieldDefaultValue(schema) : createDurationFieldDefaultValue(schema);\n      }\n      case FieldSchemaType.CODE: {\n        // ONE value: an empty snippet in the field's language — the authored default, else the first\n        // language the field allows, else none (a free-language field starts blank). Seeded as `''`\n        // before #1073, which is no code value at all, so an added item could never become valid.\n        if (isOptional(schema)) {\n          return undefined;\n        }\n        return { content: '', language: getCodeUI(schema)?.defaultLanguage ?? getCodeMetadata(schema)?.allowedLanguages?.[0] ?? '' };\n      }\n      case FieldSchemaType.RANGE_NUMBER:\n      case FieldSchemaType.RANGE_DATE:\n      case FieldSchemaType.RANGE_DATETIME:\n      case FieldSchemaType.RANGE_TIME:\n      case FieldSchemaType.RANGE_BIGDECIMAL:\n      case FieldSchemaType.RANGE_MONEY: {\n        // ONE value: `{ from, to }`, seeded with only the bounds the range REQUIRES (both are optional\n        // by default), each built from its own bound schema — a money range's bound through the money\n        // default, so it carries a currency the value schema accepts (#1073).\n        if (isOptional(schema)) {\n          return undefined;\n        }\n        const bounds = getObjectShape(schema) ?? {};\n        const seed: Record<string, unknown> = {};\n        for (const bound of ['from', 'to'] as const) {\n          const boundSchema = bounds[bound];\n          if (!boundSchema || isOptional(boundSchema)) continue;\n          seed[bound] = type === FieldSchemaType.RANGE_MONEY ? createMoneyFieldDefaultValue(boundSchema) : this.getDefaultValueForSchema(boundSchema);\n        }\n        return seed;\n      }\n      case FieldSchemaType.OBJECT: {\n        // An OPTIONAL object field must stay `undefined`, NOT a fabricated `{ nested defaults }`.\n        // `.optional()` means \"may be omitted\", and backend logic legitimately distinguishes\n        // `undefined` (not configured) from `{}`/`{ …defaults }` (explicitly configured). Only a\n        // REQUIRED object (e.g. an array's item TYPE, like the checklist item) recurses to a\n        // complete default below. A `.default(...)` object also returns `undefined` here — Zod\n        // re-applies its default at parse time, so the value is still correct on submit, without\n        // this helper pre-fabricating one. (`isOptional` is true for both `.optional()` and\n        // `.default()`; primitive fields like `done: z.boolean()` never reach this OBJECT case,\n        // so the array-item `done: false` seed is unaffected.)\n        if (isOptional(schema)) {\n          return undefined;\n        }\n        // Recurse into the object's fields so callers get a COMPLETE item default, not an\n        // empty `{}`. An empty object omits required-but-defaulted fields (e.g.\n        // `done: z.boolean().default(false)` on a checklist item), which makes a freshly\n        // added array item fail server validation on the whole-array autosave. Defaults are\n        // type-based (matching the primitives above). RECORD/MAP have no fixed shape, so they\n        // stay `{}`. (Surfaced by the read-inline array editor — array-element-authoring Step 4.)\n        let shape: Record<string, z.ZodTypeAny> | undefined;\n        try {\n          shape = getZodObjectShape(unwrapSchema(schema)) as Record<string, z.ZodTypeAny>;\n        } catch {\n          shape = undefined;\n        }\n        if (!shape) return {};\n        const result: Record<string, unknown> = {};\n        for (const [key, fieldSchema] of Object.entries(shape)) {\n          result[key] = this.getDefaultValueForSchema(fieldSchema);\n        }\n        return result;\n      }\n      case FieldSchemaType.RECORD:\n      case FieldSchemaType.MAP:\n        return {};\n      case FieldSchemaType.ARRAY:\n        return [];\n      default:\n        return '';\n    }\n  }\n\n  // =============================================================================\n  // ARRAY ADD-PATTERN RESOLUTION (quick-add primary field + add-mode default)\n  // =============================================================================\n\n  /**\n   * Resolve the PRIMARY field of an array item — the single value a user types to\n   * quick-add an entry (e.g. a checklist item's `label`).\n   *\n   * - **Primitive item** (`z.array(z.string())`, `z.array(z.number())`): the value\n   *   itself is the primary input, so `name` is `null` and `schema` is the item.\n   * - **Object item** (`z.array(z.object({ label, done }))`): the first STRING field\n   *   (label-like, the natural thing to type), else the first NUMBER field, else the\n   *   first field. Returned `name` is the object key; `schema` is that field's schema.\n   *\n   * Used by the quick-add row (form + read-inline) to render the staging input and\n   * to validate-before-add. Secondary fields (e.g. a `done` boolean) are seeded from\n   * {@link getDefaultValueForSchema} when the item is committed.\n   *\n   * @returns `{ name, schema }` — `name === null` means the item itself is the value.\n   */\n  public static getArrayItemPrimaryField(itemSchema: z.ZodTypeAny): { name: string | null; schema: z.ZodTypeAny } {\n    const itemType = getSchemaType(itemSchema);\n    if (itemType !== FieldSchemaType.OBJECT) {\n      return { name: null, schema: itemSchema };\n    }\n\n    const shape = getObjectShape(itemSchema);\n    if (!shape) {\n      return { name: null, schema: itemSchema };\n    }\n\n    const entries = Object.entries(shape);\n    const stringEntry = entries.find(([, fieldSchema]) => getSchemaType(fieldSchema) === FieldSchemaType.STRING);\n    if (stringEntry) {\n      return { name: stringEntry[0], schema: stringEntry[1] };\n    }\n    const numberEntry = entries.find(([, fieldSchema]) => getSchemaType(fieldSchema) === FieldSchemaType.NUMBER);\n    if (numberEntry) {\n      return { name: numberEntry[0], schema: numberEntry[1] };\n    }\n    const first = entries[0];\n    return first ? { name: first[0], schema: first[1] } : { name: null, schema: itemSchema };\n  }\n\n  /**\n   * Resolve the add-pattern ({@link ArrayAddMode}) for an array field.\n   *\n   * An explicit `arrayUI.edit.addMode` decorator wins. Otherwise the mode defaults\n   * **by item shape** — the framework's opinion about which add affordance fits:\n   *\n   * - **primitive** item → {@link ArrayAddMode.QUICK_ADD} (type-and-commit a value).\n   * - **address** item → {@link ArrayAddMode.APPEND_INLINE}: one structured value with no single\n   *   part that summarises it, so a typed quick-add string could never become an item.\n   * - **object with ≤ 1 prominent field** (string/number; e.g. checklist\n   *   `{ label, done }` — `label` is the only typed field) → `QUICK_ADD`. The single\n   *   typed field is staged in the add-row; the rest (booleans, enums) seed defaults.\n   * - **object with ≥ 2 prominent fields** → {@link ArrayAddMode.APPEND_INLINE}\n   *   (append a blank card and fill it in place — no single field summarises the item).\n   *\n   * {@link ArrayAddMode.DIALOG} is never auto-selected; it is opt-in for heavy items.\n   *\n   * @param arraySchema - the `z.array(...)` field schema (carries `arrayUI`).\n   * @param itemSchema - the array's item schema (drives the shape default).\n   */\n  public static resolveArrayAddMode(arraySchema: z.ZodTypeAny, itemSchema: z.ZodTypeAny): ArrayAddMode {\n    const explicit = getArrayUI(arraySchema)?.edit?.addMode;\n    if (explicit) {\n      return explicit;\n    }\n\n    const itemType = getSchemaType(itemSchema);\n    // A structured value is not OBJECT to `getSchemaType`, and falling to QUICK_ADD would render a text\n    // box whose string never parses as that value: nothing could ever be added (#561, #990).\n    if (STRUCTURED_VALUE_ITEM_TYPES.has(itemType)) {\n      return ArrayAddMode.APPEND_INLINE;\n    }\n    if (itemType !== FieldSchemaType.OBJECT) {\n      return ArrayAddMode.QUICK_ADD;\n    }\n\n    const shape = getObjectShape(itemSchema);\n    if (!shape) {\n      return ArrayAddMode.APPEND_INLINE;\n    }\n\n    const prominentFieldCount = Object.values(shape).filter((fieldSchema) => {\n      const fieldType = getSchemaType(fieldSchema);\n      return fieldType === FieldSchemaType.STRING || fieldType === FieldSchemaType.NUMBER;\n    }).length;\n\n    return prominentFieldCount <= 1 ? ArrayAddMode.QUICK_ADD : ArrayAddMode.APPEND_INLINE;\n  }\n\n  // =============================================================================\n  // CONDITIONAL VISIBILITY — DISCRIMINATED UNIONS\n  // =============================================================================\n\n  /**\n   * Compute field visibility based on discriminated union configuration.\n   * \n   * For schema families (discriminated unions), variant fields should only be\n   * visible when the discriminator value matches their variant.\n   */\n  public static computeFieldVisibility(\n    formSchema: z.ZodTypeAny,\n    fieldName: string,\n    formValues: Record<string, unknown>,\n    inheritanceConfig?: InheritanceSchemaDefinition,\n    options: { showAllWhenDiscriminatorUndefined?: boolean } = {}\n  ): boolean {\n    const { showAllWhenDiscriminatorUndefined = true } = options;\n    \n    if (!inheritanceConfig) {\n      return true;\n    }\n    \n    const { discriminatorField, withoutInheritanceDiscriminatorFieldValues, inheritedSchemas } = inheritanceConfig;\n    \n    const currentDiscriminatorValue = formValues[discriminatorField];\n    if (currentDiscriminatorValue === undefined) {\n      return showAllWhenDiscriminatorUndefined;\n    }\n    \n    const variantOnlyFields = this.getVariantOnlyFields(formSchema, inheritanceConfig);\n    \n    if (!variantOnlyFields.has(fieldName)) {\n      return true;\n    }\n    \n    if (withoutInheritanceDiscriminatorFieldValues?.includes(currentDiscriminatorValue as string)) {\n      return false;\n    }\n    \n    const currentVariant = inheritedSchemas?.find(\n      v => v.discriminatorFieldValue === currentDiscriminatorValue\n    );\n    \n    if (!currentVariant) {\n      return true;\n    }\n    \n    const variantShape = getZodObjectShape(currentVariant.schema);\n    if (variantShape && fieldName in variantShape) {\n      return true;\n    }\n    \n    return false;\n  }\n\n  // =============================================================================\n  // SHOW WHEN — CONDITION-BASED FIELD VISIBILITY\n  // =============================================================================\n\n  private static evaluateShowWhenCondition(\n    condition: ShowWhenCondition,\n    formValues: Record<string, unknown>\n  ): boolean {\n    const fieldValue = formValues[condition.field];\n    const operator = condition.operator ?? ShowWhenOperator.EQUALS;\n\n    switch (operator) {\n      case ShowWhenOperator.EQUALS:\n        if (Array.isArray(condition.value)) {\n          return condition.value.includes(fieldValue);\n        }\n        return fieldValue === condition.value;\n\n      case ShowWhenOperator.NOT_EQUALS:\n        if (Array.isArray(condition.value)) {\n          return !condition.value.includes(fieldValue);\n        }\n        return fieldValue !== condition.value;\n\n      case ShowWhenOperator.IN:\n        if (!Array.isArray(condition.value)) return false;\n        return condition.value.includes(fieldValue);\n\n      case ShowWhenOperator.NOT_IN:\n        if (!Array.isArray(condition.value)) return true;\n        return !condition.value.includes(fieldValue);\n\n      case ShowWhenOperator.EXISTS:\n        return fieldValue !== undefined && fieldValue !== null;\n\n      case ShowWhenOperator.NOT_EXISTS:\n        return fieldValue === undefined || fieldValue === null;\n\n      default:\n        return true;\n    }\n  }\n\n  /**\n   * Evaluate showWhen conditions for a field.\n   */\n  public static evaluateShowWhen(\n    showWhenParams: ShowWhenParams,\n    formValues: Record<string, unknown>\n  ): boolean {\n    const conditions = Array.isArray(showWhenParams.conditions)\n      ? showWhenParams.conditions\n      : [showWhenParams.conditions];\n\n    if (conditions.length === 0) return true;\n\n    const combineWith = showWhenParams.combineWith ?? 'and';\n\n    if (combineWith === 'and') {\n      return conditions.every(c => this.evaluateShowWhenCondition(c, formValues));\n    } else {\n      return conditions.some(c => this.evaluateShowWhenCondition(c, formValues));\n    }\n  }\n\n  /**\n   * Get showWhen parameters from a field schema.\n   */\n  public static getFieldShowWhenParams(fieldSchema: z.ZodTypeAny): ShowWhenParams | undefined {\n    return getShowWhenParams(fieldSchema);\n  }\n\n  /**\n   * Get the field names that a showWhen configuration depends on.\n   */\n  public static getShowWhenWatchFields(showWhenParams: ShowWhenParams): string[] {\n    const conditions = Array.isArray(showWhenParams.conditions)\n      ? showWhenParams.conditions\n      : [showWhenParams.conditions];\n    return [...new Set(conditions.map(c => c.field))];\n  }\n\n  /**\n   * Get fields that ONLY exist in variant schemas (not in base schema).\n   */\n  private static getVariantOnlyFields(\n    formSchema: z.ZodTypeAny,\n    inheritanceConfig: InheritanceSchemaDefinition\n  ): Set<string> {\n    const variantOnlyFields = new Set<string>();\n    \n    if (!inheritanceConfig.inheritedSchemas) {\n      return variantOnlyFields;\n    }\n    \n    // `formSchema` is the resource's ROOT form schema. For an inherited\n    // (discriminated-union) resource that root IS the union, and object-only\n    // `getZodObjectShape` returns `undefined` on a union — which would leave\n    // `baseFieldKeys` empty and (wrongly) classify EVERY field as variant-only.\n    // The fields then collapse: `computeFieldVisibility` hides any \"variant-only\"\n    // field whose discriminator is a base value (`withoutInheritance…`), so a\n    // freshly-seeded base variant (e.g. todos `recurringType: one_time`) renders\n    // ZERO fields. Use the union-aware common view (`commonOnly: true` = keys\n    // present in EVERY variant) so the true base fields are recognised and only\n    // genuinely variant-specific fields are gated by the discriminator.\n    const baseShape = this.getObjectLikeFieldShape(formSchema, { commonOnly: true });\n    const baseFieldKeys = baseShape ? new Set(Object.keys(baseShape)) : new Set<string>();\n\n    for (const variant of inheritanceConfig.inheritedSchemas) {\n      const variantShape = getZodObjectShape(variant.schema);\n      if (!variantShape) continue;\n      \n      for (const fieldName of Object.keys(variantShape)) {\n        if (fieldName === inheritanceConfig.discriminatorField) continue;\n        if (!baseFieldKeys.has(fieldName)) {\n          variantOnlyFields.add(fieldName);\n        }\n      }\n    }\n    \n    return variantOnlyFields;\n  }\n\n  /**\n   * Detect if a schema has inheritance configuration by looking for discriminator fields.\n   */\n  public static detectDiscriminatorConfig(formSchema: z.ZodTypeAny): {\n    discriminatorField: string;\n    baseValues: string[];\n  } | null {\n    const shape = getZodObjectShape(formSchema);\n    if (!shape) return null;\n    \n    for (const [fieldName, fieldSchema] of Object.entries(shape)) {\n      const discriminatorParams = getDiscriminatorParams(fieldSchema as z.ZodTypeAny);\n      if (discriminatorParams) {\n        return {\n          discriminatorField: fieldName,\n          baseValues: discriminatorParams.baseValues || [],\n        };\n      }\n    }\n    \n    return null;\n  }\n\n  // =============================================================================\n  // EXCLUDE HIDDEN FIELDS FROM VALIDATION\n  // =============================================================================\n\n  /**\n   * Get list of visible field names based on current form values.\n   */\n  public static getVisibleFieldNames(\n    formSchema: z.ZodTypeAny,\n    formValues: Record<string, unknown>,\n    inheritanceConfig?: InheritanceSchemaDefinition\n  ): string[] {\n    // Union-aware: a discriminated-union root has no object shape, so use the\n    // merged variant view (every candidate field across variants).\n    const shape = this.getObjectLikeFieldShape(formSchema);\n    if (!shape) return [];\n\n    const allFieldNames = Object.keys(shape);\n\n    if (!inheritanceConfig) {\n      return allFieldNames;\n    }\n    \n    return allFieldNames.filter(fieldName => \n      this.computeFieldVisibility(formSchema, fieldName, formValues, inheritanceConfig)\n    );\n  }\n\n  /**\n   * Filter form data to only include visible fields.\n   */\n  public static filterVisibleFormData<T extends Record<string, unknown>>(\n    formData: T,\n    formSchema: z.ZodTypeAny,\n    inheritanceConfig?: InheritanceSchemaDefinition\n  ): Partial<T> {\n    if (!inheritanceConfig) {\n      return formData;\n    }\n    \n    const visibleFields = this.getVisibleFieldNames(formSchema, formData, inheritanceConfig);\n    const visibleFieldsSet = new Set(visibleFields);\n    \n    const result: Partial<T> = {};\n    \n    for (const [key, value] of Object.entries(formData)) {\n      const topLevelKey = key.split('.')[0];\n      if (visibleFieldsSet.has(topLevelKey) || visibleFieldsSet.has(key)) {\n        (result as Record<string, unknown>)[key] = value;\n      }\n    }\n    \n    return result;\n  }\n\n  /**\n   * Get field names to exclude from validation.\n   */\n  public static getHiddenFieldNames(\n    formSchema: z.ZodTypeAny,\n    formValues: Record<string, unknown>,\n    inheritanceConfig?: InheritanceSchemaDefinition\n  ): string[] {\n    // Union-aware: a discriminated-union root has no object shape, so use the\n    // merged variant view (every candidate field across variants).\n    const shape = this.getObjectLikeFieldShape(formSchema);\n    if (!shape) return [];\n\n    if (!inheritanceConfig) {\n      return [];\n    }\n\n    const allFieldNames = Object.keys(shape);\n\n    return allFieldNames.filter(fieldName =>\n      !this.computeFieldVisibility(formSchema, fieldName, formValues, inheritanceConfig)\n    );\n  }\n\n  // =============================================================================\n  // DYNAMIC REQUIRED INDICATOR\n  // =============================================================================\n\n  /**\n   * Compute if a field should display the required indicator.\n   * A field shows as required when it is not optional in the schema AND currently visible.\n   */\n  public static isFieldEffectivelyRequired(\n    fieldSchema: z.ZodTypeAny,\n    fieldName: string,\n    formSchema: z.ZodTypeAny,\n    formValues: Record<string, unknown>,\n    inheritanceConfig?: InheritanceSchemaDefinition\n  ): boolean {\n    const fieldIsOptional = isOptional(fieldSchema);\n    \n    if (fieldIsOptional) {\n      return false;\n    }\n    \n    const fieldIsVisible = this.computeFieldVisibility(\n      formSchema,\n      fieldName,\n      formValues,\n      inheritanceConfig\n    );\n    \n    if (!fieldIsVisible) {\n      return false;\n    }\n    \n    return true;\n  }\n\n  /**\n   * Get required state for all fields in a schema.\n   */\n  public static computeAllRequiredStates(\n    formSchema: z.ZodTypeAny,\n    formValues: Record<string, unknown>,\n    inheritanceConfig?: InheritanceSchemaDefinition\n  ): Record<string, boolean> {\n    // Union-aware: a discriminated-union root has no object shape, so use the\n    // merged variant view (every candidate field across variants).\n    const shape = this.getObjectLikeFieldShape(formSchema);\n    if (!shape) return {};\n\n    const result: Record<string, boolean> = {};\n    \n    for (const [fieldName, fieldSchema] of Object.entries(shape)) {\n      result[fieldName] = this.isFieldEffectivelyRequired(\n        fieldSchema as z.ZodTypeAny,\n        fieldName,\n        formSchema,\n        formValues,\n        inheritanceConfig\n      );\n    }\n    \n    return result;\n  }\n  \n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"composite-value-defaults.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/automated-layout/composite-value-defaults.frontend.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,YAAY,EAKZ,KAAK,aAAa,EAClB,KAAK,UAAU,EAChB,MAAM,0BAA0B,CAAC;AAYlC;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,iBAAiB,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,EACzD,cAAc,EAAE,OAAO,GACtB,iBAAiB,EAAE,CAyBrB;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,MAAM,CAY7E;AAED,oFAAoF;AACpF,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,UAAU,CAO7E;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,YAAY,CAalF;AAED,mDAAmD;AACnD,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,aAAa,CAEnF"}
+{"version":3,"file":"composite-value-defaults.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../src/core/automated-layout/composite-value-defaults.frontend.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,YAAY,EAKZ,KAAK,aAAa,EAClB,KAAK,UAAU,EAChB,MAAM,0BAA0B,CAAC;AAYlC;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,iBAAiB,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,EACzD,cAAc,EAAE,OAAO,GACtB,iBAAiB,EAAE,CAyBrB;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,MAAM,CAY7E;AAED,oFAAoF;AACpF,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,UAAU,CAO7E;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,YAAY,CAalF;AAED,mDAAmD;AACnD,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,aAAa,CAEnF"}