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

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

@@ -1,7 +1,7 @@
 'use client';
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import React from 'react';
-import { FieldSchemaType, getSchemaType, getObjectShape, getObjectKeys, getZodObjectShape, isVirtualField, isBackendOnlyField, isSummaryField, getShowWhenParams, } from '@wildo-ai/zod-decorators';
+import { FieldSchemaType, getSchemaType, getObjectShape, getObjectKeys, getZodObjectShape, getZodDefArrayProperty, getZodDefStringProperty, isDiscriminatedUnion, unwrapSchema, isVirtualField, isBackendOnlyField, isSummaryField, getShowWhenParams, } from '@wildo-ai/zod-decorators';
 import { AutomatedLayoutFrontendUtils } from './automated-layout.frontend.utils.js';
 import { FormLayout } from '../../components/resources/skeleton/FormLayout.js';
 import { DisplayLayout } from '../../components/resources/skeleton/DisplayLayout.js';
@@ -51,12 +51,193 @@ export function extractSchemaFieldList(schema, discriminatorField) {
     }
     return fields;
 }
+/**
+ * The ONE reader every nested traversal in this file goes through, and the place
+ * the surprising part of `getZodObjectShape` is written down once instead of
+ * being rediscovered at three call sites.
+ *
+ * `getZodObjectShape()` returns `{}` — an EMPTY OBJECT, not `null` — for anything
+ * that is not a BARE `ZodObject`, and that includes every ordinary authoring
+ * wrapper. Measured 2026-09-08 against zod 4.3.6:
+ *
+ * | authored field                      | `getZodObjectShape` | `getObjectShape` |
+ * |-------------------------------------|---------------------|------------------|
+ * | `z.object({ a, b })`                | `['a','b']`         | `['a','b']`      |
+ * | `z.object({ a, b }).optional()`     | **`[]`**            | `['a','b']`      |
+ * | `z.object({ a, b }).nullable()`     | **`[]`**            | `['a','b']`      |
+ * | `z.object({ a, b }).default({...})` | **`[]`**            | `['a','b']`      |
+ * | `z.discriminatedUnion('t', [...])`  | **`[]`**            | `null`           |
+ *
+ * Because `{}` is TRUTHY, an `if (!shape)` guard never fires; the traversal falls
+ * out through its "no renderable keys" branch instead and emits ONE
+ * `<FormField name={objectField} />` for the whole subtree.
+ *
+ * **That fallthrough is deliberate for the wrapper rows, and this comment exists
+ * so it is not "fixed" a second time.** Swapping in `getObjectShape` here makes
+ * the generator descend into a `.optional()` nested object and emit its declared
+ * `<ObjectScope>` + per-child `<FormField>` structure — which was tried, measured,
+ * and reverted, because it is a CHANGE with no defect behind it:
+ *
+ *   - the single `<FormField>` is not a dead end. Its OBJECT branch mounts
+ *     `FormFieldComposite`, which reads the shape with `getObjectShape` (it
+ *     unwraps), renders every child as a real `FormField` under an absolute
+ *     dotted name, and gives the object a titled `ContentSection`. Measured with
+ *     that section available: an `.optional()` nested object rendered BOTH
+ *     children, and a `showWhen` on a child hid initially and appeared live on
+ *     the sibling toggle — i.e. nothing is dropped;
+ *   - descending would therefore only trade a titled section for a flat scope, on
+ *     every generated screen of every application whose schema has a wrapped
+ *     nested object. Wonder Todos' `todos.reminder` (`z.object({...}).optional()`)
+ *     deliberately renders through the composite in its authored layout, which is
+ *     what that trade would silently undo elsewhere.
+ *
+ * The union row is a different story and is NOT compensated — `getObjectShape`
+ * returns `null` there too, so the composite renders nothing at all. That case is
+ * handled before this reader is ever reached (see `renderObjectScope`).
+ */
+function readNestedObjectShape(schema) {
+    return getZodObjectShape(schema);
+}
+/**
+ * Builds the nested equivalent of the ROOT discriminated-union layout: a scope for
+ * the union field, its discriminator, and a `<DiscriminatorSwitch>` carrying each
+ * variant's own fields.
+ *
+ * This is the case the generator used to drop in silence. A field declared
+ * `payload: z.discriminatedUnion('t', [...])` is `FieldSchemaType.OBJECT`, so it
+ * took the object path, produced no readable shape, fell back to a single
+ * `<FormField>` — and `FormFieldComposite` gets `null` from `getObjectShape` for a
+ * union, so the authored field rendered NOTHING. Measured 2026-09-08: a two-variant
+ * nested union contributed not one element to the generated form.
+ *
+ * Nothing new is invented here. `<DiscriminatorSwitch>` already resolves its
+ * `field` through `useResolvedFieldName`, so placed inside `<ObjectScope name="payload">`
+ * it watches `payload.t` and its children resolve to `payload.xv` / `payload.yv`.
+ * The root union path (`renderDiscriminatorAndVariants`) composes the same two
+ * primitives; the only reason it could not serve here is that it is driven by the
+ * caller-supplied `inheritanceConfig`, which describes the ROOT resource schema and
+ * says nothing about an arbitrary nested field. The discriminator and the variant
+ * literals are read from the schema instead, which is where they already are.
+ *
+ * Variant fields are filtered to those a variant OWNS: the fields shared by every
+ * variant are rendered once, outside the switch, so switching the discriminator
+ * does not remount them (and does not, via `shouldUnregister`, drop their values).
+ *
+ * Returns `null` when the schema is not a usable discriminated union, so callers
+ * fall through to their existing behaviour rather than rendering half a union.
+ */
+function renderNestedDiscriminatedUnion(field) {
+    const unwrapped = unwrapSchema(field.schema);
+    if (!isDiscriminatedUnion(unwrapped))
+        return null;
+    const discriminator = getZodDefStringProperty(unwrapped, 'discriminator');
+    const options = (getZodDefArrayProperty(unwrapped, 'options') ?? []);
+    if (!discriminator || options.length === 0)
+        return null;
+    // Fields every variant declares (the union's common base). Rendered once,
+    // outside the switch — see the JSDoc above for why that matters beyond tidiness.
+    const perVariantKeys = options.map(option => new Set(getObjectKeys(option)));
+    const commonKeys = [...(perVariantKeys[0] ?? new Set())]
+        .filter(key => key !== discriminator && perVariantKeys.every(keys => keys.has(key)));
+    const variants = {};
+    for (const option of options) {
+        const optionShape = getObjectShape(option);
+        if (!optionShape)
+            continue;
+        /*
+         * A variant's discriminator is a LITERAL (`z.literal('x')`), and Zod 4 stores a
+         * literal's value in an ARRAY under `values` — the same shape
+         * `resolveDiscriminatedUnionVariant` reads to match a variant to a value. Reading
+         * it here is what keys the switch on the exact authored value rather than on the
+         * variant's position in the options array.
+         */
+        const literalValues = getZodDefArrayProperty(optionShape[discriminator], 'values') ?? [];
+        const variantValue = literalValues[0];
+        if (variantValue === undefined || variantValue === null)
+            continue;
+        const variantOnlyKeys = Object.keys(optionShape).filter(key => key !== discriminator
+            && !commonKeys.includes(key)
+            && !isVirtualField(optionShape[key])
+            && !isBackendOnlyField(optionShape[key]));
+        if (variantOnlyKeys.length === 0)
+            continue;
+        variants[String(variantValue)] = (_jsx(_Fragment, { children: variantOnlyKeys.map(key => _jsx(FormField, { name: key }, key)) }));
+    }
+    const commonShape = getObjectShape(options[0]);
+    const renderableCommonKeys = commonShape
+        ? commonKeys.filter(key => !isVirtualField(commonShape[key]) && !isBackendOnlyField(commonShape[key]))
+        : [];
+    return (_jsxs(ObjectScope, { name: field.name, children: [_jsx(FormField, { name: discriminator }), renderableCommonKeys.map(key => _jsx(FormField, { name: key }, key)), Object.keys(variants).length > 0 && (_jsx(DiscriminatorSwitch, { field: discriminator, variants: variants }))] }, field.name));
+}
 function dedupeShowWhenWatchFields(params) {
     const conditions = Array.isArray(params.conditions)
         ? params.conditions
         : [params.conditions];
     return [...new Set(conditions.map(c => c.field))];
 }
+/**
+ * Reports a nested discriminated-union field that will render NOTHING, walking the
+ * whole nested tree rather than only its top level.
+ *
+ * This is the residue of the drop `renderNestedDiscriminatedUnion` fixes. The FORM
+ * generator now lays a nested union out, so it reports only a union it could not
+ * build (no discriminator, or no options). The DISPLAY generator has no equivalent
+ * branch, and the reason is structural rather than unfinished work:
+ * `<DiscriminatorSwitch>` picks the live variant with `useWatch`, and a display
+ * surface has no form to watch. Picking one there means reading the VALUE — which
+ * `resolveDiscriminatedUnionVariant` will do, but the display generator is
+ * schema-only at generation time and holds no value. Until that path exists the
+ * field renders nothing, and an authored field that renders nothing must say so.
+ *
+ * Deliberately a development-only `console.warn` rather than a throw:
+ *
+ * - Throwing would turn a layout limitation into a broken screen, on the render
+ *   path of every resource that has no authored template.
+ * - It fires at GENERATION time (once per `generateDefault*Template()` call, which
+ *   callers memoize per schema), not per render, so it cannot repeat on keystrokes.
+ * - Measured 2026-09-08: neither dogfood application authors a nested
+ *   discriminated-union field anywhere, so this is silent on the installed base. It
+ *   reaches only the author who would otherwise be looking at a blank space
+ *   wondering which layer ate their field, and it names the remedy that works.
+ */
+function reportUnrenderableNestedObjectFields(fields, templateKind, parentPathPrefix = '') {
+    if (process.env.NODE_ENV === 'production')
+        return;
+    for (const field of fields) {
+        if (field.schemaType !== FieldSchemaType.OBJECT)
+            continue;
+        const fieldPath = parentPathPrefix ? `${parentPathPrefix}.${field.name}` : field.name;
+        if (isDiscriminatedUnion(unwrapSchema(field.schema))) {
+            // The FORM generator now lays a nested union out (`renderNestedDiscriminatedUnion`),
+            // so it only reports one it could not build — a union with no discriminator or
+            // no options. The DISPLAY generator has no equivalent, and the reason is not
+            // laziness: `<DiscriminatorSwitch>` decides the live variant with `useWatch`,
+            // and a display surface has no form to watch. Choosing the variant there means
+            // reading the VALUE (`resolveDiscriminatedUnionVariant` takes one), which the
+            // schema-only display generator does not have at generation time. Until that
+            // path exists, the field renders nothing and must at least say so.
+            if (templateKind === 'form' && renderNestedDiscriminatedUnion(field) !== null)
+                continue;
+            // eslint-disable-next-line no-console -- authoring-time diagnostic; see the JSDoc above for why this is a warn and not a throw
+            console.warn(`[DefaultLayoutGenerator] Field "${fieldPath}" is a nested discriminated union, and the generated `
+                + `default ${templateKind} template cannot lay it out, so "${fieldPath}" will render nothing. `
+                + `Provide an explicit layout.${templateKind === 'form' ? 'edit' : 'display'} template for this resource.`);
+            continue;
+        }
+        // Descend, because the render walk descends: an unrenderable union sitting
+        // three objects down is exactly as invisible as one at the root, and a reporter
+        // that only looked at the top level would be the "invariant applied at one of
+        // its N sites" defect this repository keeps paying for. `getObjectShape` is the
+        // right reader HERE (unlike in the render path) precisely because this walk
+        // renders nothing — it only needs to see every authored child.
+        const innerShape = getObjectShape(field.schema);
+        if (!innerShape)
+            continue;
+        reportUnrenderableNestedObjectFields(Object.entries(innerShape)
+            .filter(([, childSchema]) => !isVirtualField(childSchema) && !isBackendOnlyField(childSchema))
+            .map(([childName, childSchema]) => createSchemaFieldInfo(childName, childSchema)), templateKind, fieldPath);
+    }
+}
 // =============================================================================
 // FORM TEMPLATE GENERATION — MAIN
 // =============================================================================
@@ -77,10 +258,36 @@ function dedupeShowWhenWatchFields(params) {
  * For resources that need sections, wizard steps, or custom layouts, provide an
  * explicit `layout.edit` template in the resource config.
  *
- * Limitations:
- * - **Array-of-objects fields** fall through to `<FormField>` (no `<ArrayField>` generation).
- *   For resources with complex array fields, provide an explicit layout template.
- * - **showWhen on nested fields** (inside OBJECT schemas) is not captured by the generator.
+ * Limitation — ONE, and it is the only authored shape that renders nothing:
+ * - **A nested field whose schema is a discriminated union** cannot be laid out.
+ *   The generator has no discriminator to switch on below the root, so the field
+ *   falls back to a single `<FormField>` and renders nothing. It is reported at
+ *   generation time in development (see {@link reportUnrenderableNestedObjectFields});
+ *   the remedy is an explicit `layout.edit` template.
+ *
+ * TWO LIMITATIONS PREVIOUSLY DOCUMENTED HERE WERE FALSE, and the correction is kept
+ * because the stale text did measurable damage — it was read as a specification and
+ * became a filed defect against behaviour that works (`generated-screens#8`).
+ * Measured 2026-09-08 by rendering the generated template against the REAL
+ * `FormField` (the pre-existing generator test mocks `FormField`, which is exactly
+ * why neither claim was falsifiable there — see the pins in
+ * `__tests__/default-layout-generator.frontend.utils.test.tsx`):
+ *
+ * - *"Array-of-objects fields fall through to `<FormField>` (no `<ArrayField>`
+ *   generation)"* — literally true and materially misleading. `<FormField>` is not
+ *   a fallback here, it is the DISPATCHER: its ARRAY branch mounts
+ *   `AutomatedArrayField`, a full array editor (add / remove / drag-reorder, CARD
+ *   or ROW per-item layouts, per-item sub-fields). The skeleton `<ArrayField>` +
+ *   `<ArrayItemTemplate>` pair is the HAND-AUTHORING shape for an explicit
+ *   template; not emitting it costs an authored field nothing.
+ * - *"showWhen on nested fields (inside OBJECT schemas) is not captured"* — false.
+ *   `FormField` evaluates `showWhen` itself, deriving the sibling scope from its
+ *   RESOLVED name, so a condition on a field nested in an object resolves against
+ *   that object and reacts live. The generator's own watch collector descends too.
+ *   The two evaluations agree because both scope conditions to the parent path.
+ *
+ * The lesson, since prose in this file ships as the authoring contract: a claim
+ * about behaviour that no test can falsify will be believed. Both of these were.
  *
  * @param schema - Root object-like schema for the resource. Plain object roots and
  *   discriminated-union roots are both supported.
@@ -90,6 +297,7 @@ function dedupeShowWhenWatchFields(params) {
 export function generateDefaultFormTemplate(schema, options) {
     const inheritanceConfig = options?.inheritanceConfig;
     const fields = extractSchemaFieldList(schema, inheritanceConfig?.discriminatorField);
+    reportUnrenderableNestedObjectFields(fields, 'form');
     const showSubmit = options?.includeSubmitButton !== false;
     const showErrorSummary = options?.includeErrorSummary !== false;
     if (fields.length === 0) {
@@ -186,15 +394,24 @@ function renderObjectScope(field, watchValues, allShowWhenWatchFields, parentPat
             return null;
         }
     }
-    const innerShape = getZodObjectShape(field.schema);
-    if (!innerShape) {
-        return _jsx(FormField, { name: field.name }, field.name);
+    // BEFORE the shape read, because a discriminated union answers that read with an
+    // empty shape and would otherwise fall through to a `<FormField>` that renders
+    // nothing at all. This is the generator's one genuine silent drop; see
+    // `renderNestedDiscriminatedUnion`.
+    const unionScope = renderNestedDiscriminatedUnion(field);
+    if (unionScope) {
+        return unionScope;
     }
+    const innerShape = readNestedObjectShape(field.schema);
     const innerKeys = Object.keys(innerShape);
     const renderableKeys = innerKeys.filter(k => {
         const s = innerShape[k];
         return !isVirtualField(s) && !isBackendOnlyField(s);
     });
+    // Empty for a WRAPPED object (`.optional()` / `.nullable()` / `.default()`) as
+    // well as for a genuinely field-less one — `readNestedObjectShape` documents why
+    // that conflation is left in place, and why the single `<FormField>` below is a
+    // working renderer for it rather than a dead end.
     if (renderableKeys.length === 0) {
         return _jsx(FormField, { name: field.name }, field.name);
     }
@@ -229,10 +446,7 @@ function collectShowWhenWatchFieldsForField(field, collector, parentPathPrefix =
     if (field.schemaType !== FieldSchemaType.OBJECT) {
         return;
     }
-    const innerShape = getZodObjectShape(field.schema);
-    if (!innerShape) {
-        return;
-    }
+    const innerShape = readNestedObjectShape(field.schema);
     const currentFieldPath = parentPathPrefix ? `${parentPathPrefix}.${field.name}` : field.name;
     for (const [childName, childSchema] of Object.entries(innerShape)) {
         if (isVirtualField(childSchema) || isBackendOnlyField(childSchema)) {
@@ -289,6 +503,10 @@ function evaluateShowWhenFromWatch(params, watchValues, allWatchFields) {
  */
 export function generateDefaultDisplayTemplate(schema) {
     const fields = extractSchemaFieldList(schema);
+    // Same nested-union limitation as the form generator, reported at the same
+    // moment — the display side falls back to a `<DisplayField>` that resolves no
+    // child shape and renders nothing, so the silence is identical.
+    reportUnrenderableNestedObjectFields(fields, 'display');
     if (fields.length === 0) {
         const EmptyDisplayTemplate = () => _jsx(DisplayLayout, {});
         return EmptyDisplayTemplate;
@@ -306,10 +524,7 @@ export function generateDefaultDisplayTemplate(schema) {
  * Renders a nested OBJECT field for display using ObjectScope + recursive DisplayField.
  */
 function renderDisplayObjectScope(field) {
-    const innerShape = getZodObjectShape(field.schema);
-    if (!innerShape) {
-        return _jsx(DisplayField, { name: field.name }, field.name);
-    }
+    const innerShape = readNestedObjectShape(field.schema);
     const innerKeys = Object.keys(innerShape);
     const renderableKeys = innerKeys.filter(k => {
         const s = innerShape[k];

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

@@ -1 +1 @@
-{"version":3,"file":"default-layout-generator.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/core/automated-layout/default-layout-generator.frontend.utils.tsx"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport React from 'react';\nimport type { ReactNode } from 'react';\nimport { z } from 'zod';\nimport type { ShowWhenParams, ShowWhenCondition } from '@wildo-ai/zod-decorators';\nimport {\n  FieldSchemaType,\n  getSchemaType,\n  getObjectShape,\n  getObjectKeys,\n  getZodObjectShape,\n  isVirtualField,\n  isBackendOnlyField,\n  isSummaryField,\n  getShowWhenParams,\n} from '@wildo-ai/zod-decorators';\nimport { AutomatedLayoutFrontendUtils } from './automated-layout.frontend.utils';\nimport type { InheritanceSchemaDefinition } from './automated-layout.frontend.schemas';\nimport { FormLayout } from '~wildo-frontend-lib/components/resources/skeleton/FormLayout';\nimport { DisplayLayout } from '~wildo-frontend-lib/components/resources/skeleton/DisplayLayout';\nimport { SummaryLayout, SummaryTitlePlacement } from '~wildo-frontend-lib/components/resources/skeleton/SummaryLayout';\nimport { FormErrorSummarySlot } from '~wildo-frontend-lib/components/resources/skeleton/FormErrorSummarySlot';\nimport { SubmitButton } from '~wildo-frontend-lib/components/resources/skeleton/SubmitButton';\nimport { ObjectScope } from '~wildo-frontend-lib/components/resources/skeleton/ObjectScope';\nimport { DiscriminatorSwitch } from '~wildo-frontend-lib/components/resources/skeleton/DiscriminatorSwitch';\nimport { FormField } from '~wildo-frontend-lib/components/form/automated/FormField';\nimport { useOptionalFormTemplateContext } from '~wildo-frontend-lib/components/form/automated/FormTemplateContext';\nimport { DisplayField } from '~wildo-frontend-lib/components/data-display/DisplayField';\nimport { useWatch } from 'react-hook-form';\n\n/**\n * Label resolver function signature for layout template generators.\n * Receives a field name (potentially dotted path) and returns a human-readable label.\n * Consumers (AutomatedForm, AutomaticDisplayer) pass their i18n-aware resolver here.\n */\nexport type LayoutLabelResolver = (fieldName: string) => string;\n\n// =============================================================================\n// SCHEMA FIELD LIST — THIN EXTRACTION UTILITY\n// =============================================================================\n\n/**\n * Lightweight field descriptor produced by `extractSchemaFieldList()`.\n * Contains only what the template generator needs — no grid/row/layout calculations.\n */\nexport interface SchemaFieldInfo {\n  /** Field key (top-level name, not dotted path) */\n  name: string;\n  /** The Zod schema for this field */\n  schema: z.ZodTypeAny;\n  /** Resolved schema type (STRING, NUMBER, OBJECT, ARRAY, etc.) */\n  schemaType: FieldSchemaType;\n  /** showWhen conditional visibility params (from `.showWhen()` decorator) */\n  showWhenParams?: ShowWhenParams;\n  /** Fields that showWhen depends on (deduped) */\n  showWhenWatchFields?: string[];\n  /** Whether this field is a discriminator for a discriminated union */\n  isDiscriminator?: boolean;\n}\n\nfunction createSchemaFieldInfo(\n  name: string,\n  schema: z.ZodTypeAny,\n  discriminatorField?: string,\n): SchemaFieldInfo {\n  const schemaType = getSchemaType(schema);\n  const showWhenParams = getShowWhenParams(schema);\n\n  return {\n    name,\n    schema,\n    schemaType,\n    showWhenParams,\n    showWhenWatchFields: showWhenParams\n      ? dedupeShowWhenWatchFields(showWhenParams)\n      : undefined,\n    isDiscriminator: discriminatorField === name,\n  };\n}\n\n/**\n * Extracts a flat list of renderable root fields from an object-like schema.\n *\n * Produces the field metadata the template generator needs.\n * No grid math, no row calculations, no section/wizard grouping.\n *\n * Excludes: virtual fields, backend-only fields.\n * Does NOT exclude operation-specific fields — those are handled at render time.\n */\nexport function extractSchemaFieldList(\n  schema: z.ZodTypeAny,\n  discriminatorField?: string,\n): SchemaFieldInfo[] {\n  const shape = AutomatedLayoutFrontendUtils.getObjectLikeFieldShape(schema, { commonOnly: true });\n  const keys = shape ? Object.keys(shape) : [];\n\n  if (!shape || keys.length === 0) return [];\n\n  const fields: SchemaFieldInfo[] = [];\n\n  for (const key of keys) {\n    const fieldSchema = shape[key];\n    if (isVirtualField(fieldSchema) || isBackendOnlyField(fieldSchema)) continue;\n\n    fields.push(createSchemaFieldInfo(key, fieldSchema, discriminatorField));\n  }\n\n  return fields;\n}\n\nfunction dedupeShowWhenWatchFields(params: ShowWhenParams): string[] {\n  const conditions: ShowWhenCondition[] = Array.isArray(params.conditions)\n    ? params.conditions\n    : [params.conditions];\n  return [...new Set(conditions.map(c => c.field))];\n}\n\n\n// =============================================================================\n// FORM TEMPLATE GENERATION — OPTIONS\n// =============================================================================\n\n/**\n * Options for `generateDefaultFormTemplate()`.\n * All options are optional — omitting everything produces a flat field list.\n *\n * For resources that need sections, wizard steps, or custom layout,\n * provide an explicit `layout.edit` template in the resource config\n * instead of using the auto-generator.\n */\nexport interface FormTemplateGeneratorOptions {\n  /** Inheritance config for discriminated unions. Produces `<DiscriminatorSwitch>`. */\n  inheritanceConfig?: InheritanceSchemaDefinition;\n  /** Label resolver (i18n-aware). Defaults to camelCase fallback formatting. */\n  resolveLabel?: LayoutLabelResolver;\n  /**\n   * Whether to include `<SubmitButton />` in the generated template.\n   * Set to `false` when the caller provides its own submit button externally\n   * (e.g., ResourceAutomatedForm for operation-specific labels, draft mode).\n   * @default true\n   */\n  includeSubmitButton?: boolean;\n  /**\n   * Whether to include `<FormErrorSummarySlot />` in the generated template.\n   * Set to `false` when the caller handles error summary externally.\n   * @default true\n   */\n  includeErrorSummary?: boolean;\n}\n\n\n// =============================================================================\n// FORM TEMPLATE GENERATION — MAIN\n// =============================================================================\n\n/**\n * Generates a flat default form layout template component from a Zod object schema.\n *\n * Returns a `React.FC` (not ReactNode) so that forms with `.showWhen()` decorators\n * can use `useWatch()` hooks for conditional rendering. The returned component is\n * stable across renders when memoized by the caller.\n *\n * Capabilities:\n * - **Flat list**: one `<FormField>` per key, wrapped in `<FormLayout>`\n * - **showWhen**: produces `useWatch()` + conditional rendering for fields with `.showWhen()` decorators,\n *   including nested OBJECT scopes.\n * - **Discriminated unions**: produces `<DiscriminatorSwitch>` with variant field grouping\n * - **Nested objects**: produces `<ObjectScope>` + recursive `<FormField>` for OBJECT fields\n *\n * For resources that need sections, wizard steps, or custom layouts, provide an\n * explicit `layout.edit` template in the resource config.\n *\n * Limitations:\n * - **Array-of-objects fields** fall through to `<FormField>` (no `<ArrayField>` generation).\n *   For resources with complex array fields, provide an explicit layout template.\n * - **showWhen on nested fields** (inside OBJECT schemas) is not captured by the generator.\n *\n * @param schema - Root object-like schema for the resource. Plain object roots and\n *   discriminated-union roots are both supported.\n * @param options - Generator options (inheritance, labels, submit/error controls)\n * @returns React.FC — a component function (memoize with useMemo/useRef for stable identity)\n */\nexport function generateDefaultFormTemplate(\n  schema: z.ZodTypeAny,\n  options?: FormTemplateGeneratorOptions,\n): React.FC {\n  const inheritanceConfig = options?.inheritanceConfig;\n\n  const fields = extractSchemaFieldList(schema, inheritanceConfig?.discriminatorField);\n  const showSubmit = options?.includeSubmitButton !== false;\n  const showErrorSummary = options?.includeErrorSummary !== false;\n\n  if (fields.length === 0) {\n    const EmptyTemplate: React.FC = () => <FormLayout autoInjectSubmitButton={showSubmit} />;\n    EmptyTemplate.displayName = 'GeneratedFormTemplate(empty)';\n    return EmptyTemplate;\n  }\n\n  const allShowWhenWatchFields = collectAllShowWhenWatchFields(fields);\n  const hasShowWhen = allShowWhenWatchFields.length > 0;\n\n  const baseFieldNames = new Set(fields.map(f => f.name));\n\n  const GeneratedTemplate: React.FC = () => {\n    const watchValues = useConditionalWatch(hasShowWhen, allShowWhenWatchFields);\n    const formTemplateContext = useOptionalFormTemplateContext();\n    const hiddenGeneratedFields = new Set(\n      Object.keys(formTemplateContext?.contextFieldValues ?? {})\n    );\n    for (const hiddenFieldName of formTemplateContext?.hiddenFieldNames ?? []) {\n      hiddenGeneratedFields.add(hiddenFieldName);\n    }\n\n    const renderField = (field: SchemaFieldInfo): ReactNode => {\n      const hasGeneratedOverride = Boolean(formTemplateContext?.generatedFieldOverrides?.[field.name]);\n      const element = hiddenGeneratedFields.has(field.name) && !hasGeneratedOverride\n        ? null\n        : renderFieldElement(\n            field,\n            inheritanceConfig,\n            baseFieldNames,\n            hiddenGeneratedFields,\n            formTemplateContext?.generatedFieldOverrides,\n            watchValues,\n            allShowWhenWatchFields,\n          );\n\n      if (!field.showWhenParams || !watchValues) return element;\n\n      const isVisible = evaluateShowWhenFromWatch(field.showWhenParams, watchValues, allShowWhenWatchFields);\n      return isVisible ? element : null;\n    };\n\n    return (\n      <FormLayout autoInjectSubmitButton={showSubmit}>\n        {showErrorSummary && <FormErrorSummarySlot />}\n        {fields.map(renderField)}\n        {showSubmit && <SubmitButton />}\n      </FormLayout>\n    );\n  };\n\n  GeneratedTemplate.displayName = 'GeneratedFormTemplate';\n  return GeneratedTemplate;\n}\n\n\n// =============================================================================\n// INTERNAL — CONDITIONAL WATCH HOOK\n// =============================================================================\n\n/**\n * Conditionally calls `useWatch` — only when there are showWhen fields to track.\n * React hooks must be called unconditionally, so we always call useWatch but with\n * an empty array when not needed (no-op).\n */\nfunction useConditionalWatch(hasShowWhen: boolean, watchFields: string[]): unknown[] | undefined {\n  const values = useWatch({ name: hasShowWhen ? watchFields : [] });\n  return hasShowWhen ? (Array.isArray(values) ? values : [values]) : undefined;\n}\n\n\n// =============================================================================\n// INTERNAL — FIELD RENDERING\n// =============================================================================\n\n/**\n * Renders a single field element, handling OBJECT nesting and discriminated unions.\n */\nfunction renderFieldElement(\n  field: SchemaFieldInfo,\n  inheritanceConfig: InheritanceSchemaDefinition | undefined,\n  baseFieldNames?: Set<string>,\n  hiddenContextFields?: Set<string>,\n  generatedFieldOverrides?: Record<string, ReactNode>,\n  watchValues?: unknown[],\n  allShowWhenWatchFields?: string[],\n): ReactNode {\n  if (generatedFieldOverrides?.[field.name]) {\n    return <FormField key={field.name} name={field.name} />;\n  }\n\n  if (field.isDiscriminator && inheritanceConfig && baseFieldNames && hiddenContextFields) {\n    return renderDiscriminatorAndVariants(\n      field,\n      inheritanceConfig,\n      baseFieldNames,\n      hiddenContextFields,\n      generatedFieldOverrides,\n    );\n  }\n\n  if (field.schemaType === FieldSchemaType.OBJECT) {\n    return renderObjectScope(field, watchValues, allShowWhenWatchFields);\n  }\n\n  return (\n    <FormField key={field.name} name={field.name} />\n  );\n}\n\n/**\n * Renders a discriminator field + DiscriminatorSwitch for variant-specific fields.\n */\nfunction renderDiscriminatorAndVariants(\n  discriminatorField: SchemaFieldInfo,\n  config: InheritanceSchemaDefinition,\n  baseFieldNames: Set<string>,\n  hiddenContextFields: Set<string>,\n  generatedFieldOverrides?: Record<string, ReactNode>,\n): ReactNode {\n  const variants: Record<string, ReactNode> = {};\n\n  if (config.inheritedSchemas) {\n    for (const variant of config.inheritedSchemas) {\n      const variantShape = getObjectShape(variant.schema);\n      const variantKeys = getObjectKeys(variant.schema);\n\n      if (variantShape && variantKeys.length > 0) {\n        const variantOnlyKeys = variantKeys.filter(k =>\n          !isVirtualField(variantShape[k]) &&\n          !isBackendOnlyField(variantShape[k]) &&\n          !baseFieldNames.has(k) &&\n          (!hiddenContextFields.has(k) || Boolean(generatedFieldOverrides?.[k])),\n        );\n\n        if (variantOnlyKeys.length > 0) {\n          variants[variant.discriminatorFieldValue] = (\n            <>\n              {variantOnlyKeys.map((key) => (\n                <FormField key={key} name={key} />\n              ))}\n            </>\n          );\n        }\n      }\n    }\n  }\n\n  const hasVariants = Object.keys(variants).length > 0;\n\n  return (\n    <React.Fragment key={discriminatorField.name}>\n      <FormField name={discriminatorField.name} />\n      {hasVariants && (\n        <DiscriminatorSwitch\n          field={config.discriminatorField}\n          variants={variants}\n        />\n      )}\n    </React.Fragment>\n  );\n}\n\n/**\n * Renders a nested OBJECT field using ObjectScope + recursive FormField elements.\n */\nfunction renderObjectScope(\n  field: SchemaFieldInfo,\n  watchValues?: unknown[],\n  allShowWhenWatchFields?: string[],\n  parentPathPrefix: string = '',\n): ReactNode {\n  if (field.showWhenParams && watchValues && allShowWhenWatchFields) {\n    const scopedShowWhenParams = scopeShowWhenParams(field.showWhenParams, parentPathPrefix);\n    const isVisible = evaluateShowWhenFromWatch(scopedShowWhenParams, watchValues, allShowWhenWatchFields);\n    if (!isVisible) {\n      return null;\n    }\n  }\n\n  const innerShape = getZodObjectShape(field.schema);\n  if (!innerShape) {\n    return <FormField key={field.name} name={field.name} />;\n  }\n\n  const innerKeys = Object.keys(innerShape);\n  const renderableKeys = innerKeys.filter(k => {\n    const s = innerShape[k];\n    return !isVirtualField(s) && !isBackendOnlyField(s);\n  });\n\n  if (renderableKeys.length === 0) {\n    return <FormField key={field.name} name={field.name} />;\n  }\n\n  const currentFieldPath = parentPathPrefix ? `${parentPathPrefix}.${field.name}` : field.name;\n\n  return (\n    <ObjectScope key={field.name} name={field.name}>\n      {renderableKeys.map(key => {\n        const childSchema = innerShape[key];\n        const childType = getSchemaType(childSchema);\n\n        if (childType === FieldSchemaType.OBJECT) {\n          const nestedField = createSchemaFieldInfo(key, childSchema);\n          return renderObjectScope(\n            nestedField,\n            watchValues,\n            allShowWhenWatchFields,\n            currentFieldPath,\n          );\n        }\n\n        return <FormField key={key} name={key} />;\n      })}\n    </ObjectScope>\n  );\n}\n\n\n// =============================================================================\n// INTERNAL — SHOW WHEN EVALUATION\n// =============================================================================\n\nfunction collectAllShowWhenWatchFields(fields: SchemaFieldInfo[]): string[] {\n  const allFields = new Set<string>();\n  for (const field of fields) {\n    collectShowWhenWatchFieldsForField(field, allFields);\n  }\n  return [...allFields];\n}\n\nfunction collectShowWhenWatchFieldsForField(\n  field: SchemaFieldInfo,\n  collector: Set<string>,\n  parentPathPrefix: string = '',\n): void {\n  if (field.showWhenParams) {\n    const scopedShowWhenParams = scopeShowWhenParams(field.showWhenParams, parentPathPrefix);\n    for (const fieldName of dedupeShowWhenWatchFields(scopedShowWhenParams)) {\n      collector.add(fieldName);\n    }\n  }\n\n  if (field.schemaType !== FieldSchemaType.OBJECT) {\n    return;\n  }\n\n  const innerShape = getZodObjectShape(field.schema);\n  if (!innerShape) {\n    return;\n  }\n\n  const currentFieldPath = parentPathPrefix ? `${parentPathPrefix}.${field.name}` : field.name;\n  for (const [childName, childSchema] of Object.entries(innerShape)) {\n    if (isVirtualField(childSchema) || isBackendOnlyField(childSchema)) {\n      continue;\n    }\n\n    collectShowWhenWatchFieldsForField(\n      createSchemaFieldInfo(childName, childSchema as z.ZodTypeAny),\n      collector,\n      currentFieldPath,\n    );\n  }\n}\n\nfunction scopeShowWhenParams(\n  params: ShowWhenParams,\n  parentPathPrefix: string,\n): ShowWhenParams {\n  if (!parentPathPrefix) {\n    return params;\n  }\n\n  const conditions = Array.isArray(params.conditions)\n    ? params.conditions\n    : [params.conditions];\n\n  return {\n    ...params,\n    conditions: conditions.map((condition) => ({\n      ...condition,\n      field: condition.field.includes('.') || condition.field.includes('[')\n        ? condition.field\n        : `${parentPathPrefix}.${condition.field}`,\n    })),\n  };\n}\n\n/**\n * Evaluates showWhen conditions using values from the useWatch array.\n * Maps field names to their positions in the watched fields array.\n */\nfunction evaluateShowWhenFromWatch(\n  params: ShowWhenParams,\n  watchValues: unknown[],\n  allWatchFields: string[],\n): boolean {\n  const formValues: Record<string, unknown> = {};\n  for (let i = 0; i < allWatchFields.length; i++) {\n    formValues[allWatchFields[i]] = watchValues[i];\n  }\n  return AutomatedLayoutFrontendUtils.evaluateShowWhen(params, formValues);\n}\n\n\n// =============================================================================\n// DISPLAY TEMPLATE GENERATION\n// =============================================================================\n\n/**\n * Generates a flat default display layout template (React.FC) from a Zod object schema.\n *\n * Schema-only: field values, labels, and descriptions are resolved from\n * DisplayTemplateContext at render time via name-only `<DisplayField name=\"x\" />`.\n *\n * Supports nested objects (`<ObjectScope>`) and per-field showWhen\n * (DD-10 — not evaluated at generator time).\n *\n * For resources that need sections or custom display layouts, provide an\n * explicit `layout.display` template in the resource config.\n *\n * @param schema - The root Zod object schema for the resource\n * @returns React.FC component using DisplayLayout + name-only DisplayField components\n */\nexport function generateDefaultDisplayTemplate(\n  schema: z.ZodTypeAny,\n): React.FC {\n  const fields = extractSchemaFieldList(schema);\n\n  if (fields.length === 0) {\n    const EmptyDisplayTemplate: React.FC = () => <DisplayLayout />;\n    return EmptyDisplayTemplate;\n  }\n\n  const renderDisplayField = (field: SchemaFieldInfo): ReactNode => {\n    if (field.schemaType === FieldSchemaType.OBJECT) {\n      return renderDisplayObjectScope(field);\n    }\n    return <DisplayField key={field.name} name={field.name} />;\n  };\n\n  const DefaultDisplayTemplate: React.FC = () => (\n    <DisplayLayout>\n      {fields.map(renderDisplayField)}\n    </DisplayLayout>\n  );\n  return DefaultDisplayTemplate;\n}\n\n/**\n * Renders a nested OBJECT field for display using ObjectScope + recursive DisplayField.\n */\nfunction renderDisplayObjectScope(field: SchemaFieldInfo): ReactNode {\n  const innerShape = getZodObjectShape(field.schema);\n  if (!innerShape) {\n    return <DisplayField key={field.name} name={field.name} />;\n  }\n\n  const innerKeys = Object.keys(innerShape);\n  const renderableKeys = innerKeys.filter(k => {\n    const s = innerShape[k];\n    return !isVirtualField(s) && !isBackendOnlyField(s);\n  });\n\n  if (renderableKeys.length === 0) {\n    return <DisplayField key={field.name} name={field.name} />;\n  }\n\n  return (\n    <ObjectScope key={field.name} name={field.name}>\n      {renderableKeys.map(key => {\n        const childSchema = innerShape[key];\n        const childType = getSchemaType(childSchema);\n\n        if (childType === FieldSchemaType.OBJECT) {\n          const nestedField: SchemaFieldInfo = {\n            name: key,\n            schema: childSchema,\n            schemaType: childType,\n          };\n          return renderDisplayObjectScope(nestedField);\n        }\n\n        return <DisplayField key={key} name={key} />;\n      })}\n    </ObjectScope>\n  );\n}\n\n// =============================================================================\n// SUMMARY TEMPLATE GENERATION\n// =============================================================================\n\n/**\n * Generates a default summary layout template (React.FC) from a Zod object schema.\n *\n * Schema-only: values are resolved from DisplayTemplateContext at render time.\n * Each field uses `<DisplayField name=\"x\" />` — rendered with compact chrome\n * from the `defaultChromeMode.summary` set on the enclosing `ResourceSummaryDisplayer`.\n *\n * Includes only fields decorated with `isSummaryField()`. If no summary fields\n * are defined, renders all non-backend-only fields with summary variant.\n *\n * @param schema - The root Zod object schema for the resource\n * @returns React.FC component using SummaryLayout + name-only DisplayField components\n */\nexport function generateDefaultSummaryTemplate(\n  schema: z.ZodTypeAny,\n): React.FC {\n  // Union-aware shape (matches the display/form generators): `getObjectShape`\n  // returns null for a discriminated union, so a polymorphic resource with no\n  // authored `layout.summary` would otherwise fall into the empty branch and\n  // render a blank FK preview / ReadSummary body. `commonOnly: true` yields the\n  // fields shared across variants.\n  const shape = AutomatedLayoutFrontendUtils.getObjectLikeFieldShape(schema, { commonOnly: true });\n  const keys = shape ? Object.keys(shape) : [];\n\n  // The generated default is BODY-ONLY: `titlePlacement={TEMPLATE_OWNED}` so\n  // `SummaryLayout` renders no auto title. Resources WITHOUT an authored\n  // `layout.summary` keep their title host-owned (list card / FK popover render\n  // the primary label themselves) — routing the default through an AUTO title\n  // would restyle every no-template list in every app. Only AUTHORED templates\n  // opt the title into the flow.\n  if (!shape || keys.length === 0) {\n    const EmptySummaryTemplate: React.FC = () => (\n      <SummaryLayout titlePlacement={SummaryTitlePlacement.TEMPLATE_OWNED} />\n    );\n    return EmptySummaryTemplate;\n  }\n\n  // Summaries are `isSummaryField`-scoped (a DIFFERENT axis from the display\n  // view's all-non-hidden selection), so — unlike the display generator — we do\n  // NOT exclude virtual fields: a virtual field can legitimately be an authored\n  // summary field, and `ResourceLayoutUtils.detectSummaryFields` (the sibling\n  // path feeding table columns + card bodies) includes them too. We keep them in\n  // sync; only backend-only fields (no client value) are dropped.\n  const summaryKeys = keys.filter(key => {\n    const fieldSchema = shape[key];\n    return !isBackendOnlyField(fieldSchema) && isSummaryField(fieldSchema);\n  });\n\n  const targetKeys = summaryKeys.length > 0\n    ? summaryKeys\n    : keys.filter(key => !isBackendOnlyField(shape[key]));\n\n  const DefaultSummaryTemplate: React.FC = () => (\n    <SummaryLayout titlePlacement={SummaryTitlePlacement.TEMPLATE_OWNED}>\n      {targetKeys.map(key => (\n        <DisplayField key={key} name={key} />\n      ))}\n    </SummaryLayout>\n  );\n  return DefaultSummaryTemplate;\n}\n"]}
+{"version":3,"file":"default-layout-generator.frontend.utils.js","sourceRoot":"","sources":["../../../../src/core/automated-layout/default-layout-generator.frontend.utils.tsx"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport React from 'react';\nimport type { ReactNode } from 'react';\nimport { z } from 'zod';\nimport type { ShowWhenParams, ShowWhenCondition } from '@wildo-ai/zod-decorators';\nimport {\n  FieldSchemaType,\n  getSchemaType,\n  getObjectShape,\n  getObjectKeys,\n  getZodObjectShape,\n  getZodDefArrayProperty,\n  getZodDefStringProperty,\n  isDiscriminatedUnion,\n  unwrapSchema,\n  isVirtualField,\n  isBackendOnlyField,\n  isSummaryField,\n  getShowWhenParams,\n} from '@wildo-ai/zod-decorators';\nimport { AutomatedLayoutFrontendUtils } from './automated-layout.frontend.utils';\nimport type { InheritanceSchemaDefinition } from './automated-layout.frontend.schemas';\nimport { FormLayout } from '~wildo-frontend-lib/components/resources/skeleton/FormLayout';\nimport { DisplayLayout } from '~wildo-frontend-lib/components/resources/skeleton/DisplayLayout';\nimport { SummaryLayout, SummaryTitlePlacement } from '~wildo-frontend-lib/components/resources/skeleton/SummaryLayout';\nimport { FormErrorSummarySlot } from '~wildo-frontend-lib/components/resources/skeleton/FormErrorSummarySlot';\nimport { SubmitButton } from '~wildo-frontend-lib/components/resources/skeleton/SubmitButton';\nimport { ObjectScope } from '~wildo-frontend-lib/components/resources/skeleton/ObjectScope';\nimport { DiscriminatorSwitch } from '~wildo-frontend-lib/components/resources/skeleton/DiscriminatorSwitch';\nimport { FormField } from '~wildo-frontend-lib/components/form/automated/FormField';\nimport { useOptionalFormTemplateContext } from '~wildo-frontend-lib/components/form/automated/FormTemplateContext';\nimport { DisplayField } from '~wildo-frontend-lib/components/data-display/DisplayField';\nimport { useWatch } from 'react-hook-form';\n\n/**\n * Label resolver function signature for layout template generators.\n * Receives a field name (potentially dotted path) and returns a human-readable label.\n * Consumers (AutomatedForm, AutomaticDisplayer) pass their i18n-aware resolver here.\n */\nexport type LayoutLabelResolver = (fieldName: string) => string;\n\n// =============================================================================\n// SCHEMA FIELD LIST — THIN EXTRACTION UTILITY\n// =============================================================================\n\n/**\n * Lightweight field descriptor produced by `extractSchemaFieldList()`.\n * Contains only what the template generator needs — no grid/row/layout calculations.\n */\nexport interface SchemaFieldInfo {\n  /** Field key (top-level name, not dotted path) */\n  name: string;\n  /** The Zod schema for this field */\n  schema: z.ZodTypeAny;\n  /** Resolved schema type (STRING, NUMBER, OBJECT, ARRAY, etc.) */\n  schemaType: FieldSchemaType;\n  /** showWhen conditional visibility params (from `.showWhen()` decorator) */\n  showWhenParams?: ShowWhenParams;\n  /** Fields that showWhen depends on (deduped) */\n  showWhenWatchFields?: string[];\n  /** Whether this field is a discriminator for a discriminated union */\n  isDiscriminator?: boolean;\n}\n\nfunction createSchemaFieldInfo(\n  name: string,\n  schema: z.ZodTypeAny,\n  discriminatorField?: string,\n): SchemaFieldInfo {\n  const schemaType = getSchemaType(schema);\n  const showWhenParams = getShowWhenParams(schema);\n\n  return {\n    name,\n    schema,\n    schemaType,\n    showWhenParams,\n    showWhenWatchFields: showWhenParams\n      ? dedupeShowWhenWatchFields(showWhenParams)\n      : undefined,\n    isDiscriminator: discriminatorField === name,\n  };\n}\n\n/**\n * Extracts a flat list of renderable root fields from an object-like schema.\n *\n * Produces the field metadata the template generator needs.\n * No grid math, no row calculations, no section/wizard grouping.\n *\n * Excludes: virtual fields, backend-only fields.\n * Does NOT exclude operation-specific fields — those are handled at render time.\n */\nexport function extractSchemaFieldList(\n  schema: z.ZodTypeAny,\n  discriminatorField?: string,\n): SchemaFieldInfo[] {\n  const shape = AutomatedLayoutFrontendUtils.getObjectLikeFieldShape(schema, { commonOnly: true });\n  const keys = shape ? Object.keys(shape) : [];\n\n  if (!shape || keys.length === 0) return [];\n\n  const fields: SchemaFieldInfo[] = [];\n\n  for (const key of keys) {\n    const fieldSchema = shape[key];\n    if (isVirtualField(fieldSchema) || isBackendOnlyField(fieldSchema)) continue;\n\n    fields.push(createSchemaFieldInfo(key, fieldSchema, discriminatorField));\n  }\n\n  return fields;\n}\n\n/**\n * The ONE reader every nested traversal in this file goes through, and the place\n * the surprising part of `getZodObjectShape` is written down once instead of\n * being rediscovered at three call sites.\n *\n * `getZodObjectShape()` returns `{}` — an EMPTY OBJECT, not `null` — for anything\n * that is not a BARE `ZodObject`, and that includes every ordinary authoring\n * wrapper. Measured 2026-09-08 against zod 4.3.6:\n *\n * | authored field                      | `getZodObjectShape` | `getObjectShape` |\n * |-------------------------------------|---------------------|------------------|\n * | `z.object({ a, b })`                | `['a','b']`         | `['a','b']`      |\n * | `z.object({ a, b }).optional()`     | **`[]`**            | `['a','b']`      |\n * | `z.object({ a, b }).nullable()`     | **`[]`**            | `['a','b']`      |\n * | `z.object({ a, b }).default({...})` | **`[]`**            | `['a','b']`      |\n * | `z.discriminatedUnion('t', [...])`  | **`[]`**            | `null`           |\n *\n * Because `{}` is TRUTHY, an `if (!shape)` guard never fires; the traversal falls\n * out through its \"no renderable keys\" branch instead and emits ONE\n * `<FormField name={objectField} />` for the whole subtree.\n *\n * **That fallthrough is deliberate for the wrapper rows, and this comment exists\n * so it is not \"fixed\" a second time.** Swapping in `getObjectShape` here makes\n * the generator descend into a `.optional()` nested object and emit its declared\n * `<ObjectScope>` + per-child `<FormField>` structure — which was tried, measured,\n * and reverted, because it is a CHANGE with no defect behind it:\n *\n *   - the single `<FormField>` is not a dead end. Its OBJECT branch mounts\n *     `FormFieldComposite`, which reads the shape with `getObjectShape` (it\n *     unwraps), renders every child as a real `FormField` under an absolute\n *     dotted name, and gives the object a titled `ContentSection`. Measured with\n *     that section available: an `.optional()` nested object rendered BOTH\n *     children, and a `showWhen` on a child hid initially and appeared live on\n *     the sibling toggle — i.e. nothing is dropped;\n *   - descending would therefore only trade a titled section for a flat scope, on\n *     every generated screen of every application whose schema has a wrapped\n *     nested object. Wonder Todos' `todos.reminder` (`z.object({...}).optional()`)\n *     deliberately renders through the composite in its authored layout, which is\n *     what that trade would silently undo elsewhere.\n *\n * The union row is a different story and is NOT compensated — `getObjectShape`\n * returns `null` there too, so the composite renders nothing at all. That case is\n * handled before this reader is ever reached (see `renderObjectScope`).\n */\nfunction readNestedObjectShape(schema: z.ZodTypeAny): Record<string, z.ZodTypeAny> {\n  return getZodObjectShape(schema);\n}\n\n/**\n * Builds the nested equivalent of the ROOT discriminated-union layout: a scope for\n * the union field, its discriminator, and a `<DiscriminatorSwitch>` carrying each\n * variant's own fields.\n *\n * This is the case the generator used to drop in silence. A field declared\n * `payload: z.discriminatedUnion('t', [...])` is `FieldSchemaType.OBJECT`, so it\n * took the object path, produced no readable shape, fell back to a single\n * `<FormField>` — and `FormFieldComposite` gets `null` from `getObjectShape` for a\n * union, so the authored field rendered NOTHING. Measured 2026-09-08: a two-variant\n * nested union contributed not one element to the generated form.\n *\n * Nothing new is invented here. `<DiscriminatorSwitch>` already resolves its\n * `field` through `useResolvedFieldName`, so placed inside `<ObjectScope name=\"payload\">`\n * it watches `payload.t` and its children resolve to `payload.xv` / `payload.yv`.\n * The root union path (`renderDiscriminatorAndVariants`) composes the same two\n * primitives; the only reason it could not serve here is that it is driven by the\n * caller-supplied `inheritanceConfig`, which describes the ROOT resource schema and\n * says nothing about an arbitrary nested field. The discriminator and the variant\n * literals are read from the schema instead, which is where they already are.\n *\n * Variant fields are filtered to those a variant OWNS: the fields shared by every\n * variant are rendered once, outside the switch, so switching the discriminator\n * does not remount them (and does not, via `shouldUnregister`, drop their values).\n *\n * Returns `null` when the schema is not a usable discriminated union, so callers\n * fall through to their existing behaviour rather than rendering half a union.\n */\nfunction renderNestedDiscriminatedUnion(field: SchemaFieldInfo): ReactNode | null {\n  const unwrapped = unwrapSchema(field.schema);\n  if (!isDiscriminatedUnion(unwrapped)) return null;\n\n  const discriminator = getZodDefStringProperty(unwrapped, 'discriminator');\n  const options = (getZodDefArrayProperty(unwrapped, 'options') ?? []) as z.ZodTypeAny[];\n  if (!discriminator || options.length === 0) return null;\n\n  // Fields every variant declares (the union's common base). Rendered once,\n  // outside the switch — see the JSDoc above for why that matters beyond tidiness.\n  const perVariantKeys = options.map(option => new Set(getObjectKeys(option)));\n  const commonKeys = [...(perVariantKeys[0] ?? new Set<string>())]\n    .filter(key => key !== discriminator && perVariantKeys.every(keys => keys.has(key)));\n\n  const variants: Record<string, ReactNode> = {};\n\n  for (const option of options) {\n    const optionShape = getObjectShape(option);\n    if (!optionShape) continue;\n\n    /*\n     * A variant's discriminator is a LITERAL (`z.literal('x')`), and Zod 4 stores a\n     * literal's value in an ARRAY under `values` — the same shape\n     * `resolveDiscriminatedUnionVariant` reads to match a variant to a value. Reading\n     * it here is what keys the switch on the exact authored value rather than on the\n     * variant's position in the options array.\n     */\n    const literalValues = getZodDefArrayProperty(optionShape[discriminator], 'values') ?? [];\n    const variantValue = literalValues[0];\n    if (variantValue === undefined || variantValue === null) continue;\n\n    const variantOnlyKeys = Object.keys(optionShape).filter(key =>\n      key !== discriminator\n      && !commonKeys.includes(key)\n      && !isVirtualField(optionShape[key])\n      && !isBackendOnlyField(optionShape[key]),\n    );\n    if (variantOnlyKeys.length === 0) continue;\n\n    variants[String(variantValue)] = (\n      <>\n        {variantOnlyKeys.map(key => <FormField key={key} name={key} />)}\n      </>\n    );\n  }\n\n  const commonShape = getObjectShape(options[0]);\n  const renderableCommonKeys = commonShape\n    ? commonKeys.filter(key => !isVirtualField(commonShape[key]) && !isBackendOnlyField(commonShape[key]))\n    : [];\n\n  return (\n    <ObjectScope key={field.name} name={field.name}>\n      <FormField name={discriminator} />\n      {renderableCommonKeys.map(key => <FormField key={key} name={key} />)}\n      {Object.keys(variants).length > 0 && (\n        <DiscriminatorSwitch field={discriminator} variants={variants} />\n      )}\n    </ObjectScope>\n  );\n}\n\nfunction dedupeShowWhenWatchFields(params: ShowWhenParams): string[] {\n  const conditions: ShowWhenCondition[] = Array.isArray(params.conditions)\n    ? params.conditions\n    : [params.conditions];\n  return [...new Set(conditions.map(c => c.field))];\n}\n\n/**\n * Reports a nested discriminated-union field that will render NOTHING, walking the\n * whole nested tree rather than only its top level.\n *\n * This is the residue of the drop `renderNestedDiscriminatedUnion` fixes. The FORM\n * generator now lays a nested union out, so it reports only a union it could not\n * build (no discriminator, or no options). The DISPLAY generator has no equivalent\n * branch, and the reason is structural rather than unfinished work:\n * `<DiscriminatorSwitch>` picks the live variant with `useWatch`, and a display\n * surface has no form to watch. Picking one there means reading the VALUE — which\n * `resolveDiscriminatedUnionVariant` will do, but the display generator is\n * schema-only at generation time and holds no value. Until that path exists the\n * field renders nothing, and an authored field that renders nothing must say so.\n *\n * Deliberately a development-only `console.warn` rather than a throw:\n *\n * - Throwing would turn a layout limitation into a broken screen, on the render\n *   path of every resource that has no authored template.\n * - It fires at GENERATION time (once per `generateDefault*Template()` call, which\n *   callers memoize per schema), not per render, so it cannot repeat on keystrokes.\n * - Measured 2026-09-08: neither dogfood application authors a nested\n *   discriminated-union field anywhere, so this is silent on the installed base. It\n *   reaches only the author who would otherwise be looking at a blank space\n *   wondering which layer ate their field, and it names the remedy that works.\n */\nfunction reportUnrenderableNestedObjectFields(\n  fields: SchemaFieldInfo[],\n  templateKind: 'form' | 'display',\n  parentPathPrefix: string = '',\n): void {\n  if (process.env.NODE_ENV === 'production') return;\n\n  for (const field of fields) {\n    if (field.schemaType !== FieldSchemaType.OBJECT) continue;\n\n    const fieldPath = parentPathPrefix ? `${parentPathPrefix}.${field.name}` : field.name;\n\n    if (isDiscriminatedUnion(unwrapSchema(field.schema))) {\n      // The FORM generator now lays a nested union out (`renderNestedDiscriminatedUnion`),\n      // so it only reports one it could not build — a union with no discriminator or\n      // no options. The DISPLAY generator has no equivalent, and the reason is not\n      // laziness: `<DiscriminatorSwitch>` decides the live variant with `useWatch`,\n      // and a display surface has no form to watch. Choosing the variant there means\n      // reading the VALUE (`resolveDiscriminatedUnionVariant` takes one), which the\n      // schema-only display generator does not have at generation time. Until that\n      // path exists, the field renders nothing and must at least say so.\n      if (templateKind === 'form' && renderNestedDiscriminatedUnion(field) !== null) continue;\n\n      // eslint-disable-next-line no-console -- authoring-time diagnostic; see the JSDoc above for why this is a warn and not a throw\n      console.warn(\n        `[DefaultLayoutGenerator] Field \"${fieldPath}\" is a nested discriminated union, and the generated `\n        + `default ${templateKind} template cannot lay it out, so \"${fieldPath}\" will render nothing. `\n        + `Provide an explicit layout.${templateKind === 'form' ? 'edit' : 'display'} template for this resource.`,\n      );\n      continue;\n    }\n\n    // Descend, because the render walk descends: an unrenderable union sitting\n    // three objects down is exactly as invisible as one at the root, and a reporter\n    // that only looked at the top level would be the \"invariant applied at one of\n    // its N sites\" defect this repository keeps paying for. `getObjectShape` is the\n    // right reader HERE (unlike in the render path) precisely because this walk\n    // renders nothing — it only needs to see every authored child.\n    const innerShape = getObjectShape(field.schema);\n    if (!innerShape) continue;\n\n    reportUnrenderableNestedObjectFields(\n      Object.entries(innerShape)\n        .filter(([, childSchema]) => !isVirtualField(childSchema) && !isBackendOnlyField(childSchema))\n        .map(([childName, childSchema]) => createSchemaFieldInfo(childName, childSchema)),\n      templateKind,\n      fieldPath,\n    );\n  }\n}\n\n\n// =============================================================================\n// FORM TEMPLATE GENERATION — OPTIONS\n// =============================================================================\n\n/**\n * Options for `generateDefaultFormTemplate()`.\n * All options are optional — omitting everything produces a flat field list.\n *\n * For resources that need sections, wizard steps, or custom layout,\n * provide an explicit `layout.edit` template in the resource config\n * instead of using the auto-generator.\n */\nexport interface FormTemplateGeneratorOptions {\n  /** Inheritance config for discriminated unions. Produces `<DiscriminatorSwitch>`. */\n  inheritanceConfig?: InheritanceSchemaDefinition;\n  /** Label resolver (i18n-aware). Defaults to camelCase fallback formatting. */\n  resolveLabel?: LayoutLabelResolver;\n  /**\n   * Whether to include `<SubmitButton />` in the generated template.\n   * Set to `false` when the caller provides its own submit button externally\n   * (e.g., ResourceAutomatedForm for operation-specific labels, draft mode).\n   * @default true\n   */\n  includeSubmitButton?: boolean;\n  /**\n   * Whether to include `<FormErrorSummarySlot />` in the generated template.\n   * Set to `false` when the caller handles error summary externally.\n   * @default true\n   */\n  includeErrorSummary?: boolean;\n}\n\n\n// =============================================================================\n// FORM TEMPLATE GENERATION — MAIN\n// =============================================================================\n\n/**\n * Generates a flat default form layout template component from a Zod object schema.\n *\n * Returns a `React.FC` (not ReactNode) so that forms with `.showWhen()` decorators\n * can use `useWatch()` hooks for conditional rendering. The returned component is\n * stable across renders when memoized by the caller.\n *\n * Capabilities:\n * - **Flat list**: one `<FormField>` per key, wrapped in `<FormLayout>`\n * - **showWhen**: produces `useWatch()` + conditional rendering for fields with `.showWhen()` decorators,\n *   including nested OBJECT scopes.\n * - **Discriminated unions**: produces `<DiscriminatorSwitch>` with variant field grouping\n * - **Nested objects**: produces `<ObjectScope>` + recursive `<FormField>` for OBJECT fields\n *\n * For resources that need sections, wizard steps, or custom layouts, provide an\n * explicit `layout.edit` template in the resource config.\n *\n * Limitation — ONE, and it is the only authored shape that renders nothing:\n * - **A nested field whose schema is a discriminated union** cannot be laid out.\n *   The generator has no discriminator to switch on below the root, so the field\n *   falls back to a single `<FormField>` and renders nothing. It is reported at\n *   generation time in development (see {@link reportUnrenderableNestedObjectFields});\n *   the remedy is an explicit `layout.edit` template.\n *\n * TWO LIMITATIONS PREVIOUSLY DOCUMENTED HERE WERE FALSE, and the correction is kept\n * because the stale text did measurable damage — it was read as a specification and\n * became a filed defect against behaviour that works (`generated-screens#8`).\n * Measured 2026-09-08 by rendering the generated template against the REAL\n * `FormField` (the pre-existing generator test mocks `FormField`, which is exactly\n * why neither claim was falsifiable there — see the pins in\n * `__tests__/default-layout-generator.frontend.utils.test.tsx`):\n *\n * - *\"Array-of-objects fields fall through to `<FormField>` (no `<ArrayField>`\n *   generation)\"* — literally true and materially misleading. `<FormField>` is not\n *   a fallback here, it is the DISPATCHER: its ARRAY branch mounts\n *   `AutomatedArrayField`, a full array editor (add / remove / drag-reorder, CARD\n *   or ROW per-item layouts, per-item sub-fields). The skeleton `<ArrayField>` +\n *   `<ArrayItemTemplate>` pair is the HAND-AUTHORING shape for an explicit\n *   template; not emitting it costs an authored field nothing.\n * - *\"showWhen on nested fields (inside OBJECT schemas) is not captured\"* — false.\n *   `FormField` evaluates `showWhen` itself, deriving the sibling scope from its\n *   RESOLVED name, so a condition on a field nested in an object resolves against\n *   that object and reacts live. The generator's own watch collector descends too.\n *   The two evaluations agree because both scope conditions to the parent path.\n *\n * The lesson, since prose in this file ships as the authoring contract: a claim\n * about behaviour that no test can falsify will be believed. Both of these were.\n *\n * @param schema - Root object-like schema for the resource. Plain object roots and\n *   discriminated-union roots are both supported.\n * @param options - Generator options (inheritance, labels, submit/error controls)\n * @returns React.FC — a component function (memoize with useMemo/useRef for stable identity)\n */\nexport function generateDefaultFormTemplate(\n  schema: z.ZodTypeAny,\n  options?: FormTemplateGeneratorOptions,\n): React.FC {\n  const inheritanceConfig = options?.inheritanceConfig;\n\n  const fields = extractSchemaFieldList(schema, inheritanceConfig?.discriminatorField);\n  reportUnrenderableNestedObjectFields(fields, 'form');\n  const showSubmit = options?.includeSubmitButton !== false;\n  const showErrorSummary = options?.includeErrorSummary !== false;\n\n  if (fields.length === 0) {\n    const EmptyTemplate: React.FC = () => <FormLayout autoInjectSubmitButton={showSubmit} />;\n    EmptyTemplate.displayName = 'GeneratedFormTemplate(empty)';\n    return EmptyTemplate;\n  }\n\n  const allShowWhenWatchFields = collectAllShowWhenWatchFields(fields);\n  const hasShowWhen = allShowWhenWatchFields.length > 0;\n\n  const baseFieldNames = new Set(fields.map(f => f.name));\n\n  const GeneratedTemplate: React.FC = () => {\n    const watchValues = useConditionalWatch(hasShowWhen, allShowWhenWatchFields);\n    const formTemplateContext = useOptionalFormTemplateContext();\n    const hiddenGeneratedFields = new Set(\n      Object.keys(formTemplateContext?.contextFieldValues ?? {})\n    );\n    for (const hiddenFieldName of formTemplateContext?.hiddenFieldNames ?? []) {\n      hiddenGeneratedFields.add(hiddenFieldName);\n    }\n\n    const renderField = (field: SchemaFieldInfo): ReactNode => {\n      const hasGeneratedOverride = Boolean(formTemplateContext?.generatedFieldOverrides?.[field.name]);\n      const element = hiddenGeneratedFields.has(field.name) && !hasGeneratedOverride\n        ? null\n        : renderFieldElement(\n            field,\n            inheritanceConfig,\n            baseFieldNames,\n            hiddenGeneratedFields,\n            formTemplateContext?.generatedFieldOverrides,\n            watchValues,\n            allShowWhenWatchFields,\n          );\n\n      if (!field.showWhenParams || !watchValues) return element;\n\n      const isVisible = evaluateShowWhenFromWatch(field.showWhenParams, watchValues, allShowWhenWatchFields);\n      return isVisible ? element : null;\n    };\n\n    return (\n      <FormLayout autoInjectSubmitButton={showSubmit}>\n        {showErrorSummary && <FormErrorSummarySlot />}\n        {fields.map(renderField)}\n        {showSubmit && <SubmitButton />}\n      </FormLayout>\n    );\n  };\n\n  GeneratedTemplate.displayName = 'GeneratedFormTemplate';\n  return GeneratedTemplate;\n}\n\n\n// =============================================================================\n// INTERNAL — CONDITIONAL WATCH HOOK\n// =============================================================================\n\n/**\n * Conditionally calls `useWatch` — only when there are showWhen fields to track.\n * React hooks must be called unconditionally, so we always call useWatch but with\n * an empty array when not needed (no-op).\n */\nfunction useConditionalWatch(hasShowWhen: boolean, watchFields: string[]): unknown[] | undefined {\n  const values = useWatch({ name: hasShowWhen ? watchFields : [] });\n  return hasShowWhen ? (Array.isArray(values) ? values : [values]) : undefined;\n}\n\n\n// =============================================================================\n// INTERNAL — FIELD RENDERING\n// =============================================================================\n\n/**\n * Renders a single field element, handling OBJECT nesting and discriminated unions.\n */\nfunction renderFieldElement(\n  field: SchemaFieldInfo,\n  inheritanceConfig: InheritanceSchemaDefinition | undefined,\n  baseFieldNames?: Set<string>,\n  hiddenContextFields?: Set<string>,\n  generatedFieldOverrides?: Record<string, ReactNode>,\n  watchValues?: unknown[],\n  allShowWhenWatchFields?: string[],\n): ReactNode {\n  if (generatedFieldOverrides?.[field.name]) {\n    return <FormField key={field.name} name={field.name} />;\n  }\n\n  if (field.isDiscriminator && inheritanceConfig && baseFieldNames && hiddenContextFields) {\n    return renderDiscriminatorAndVariants(\n      field,\n      inheritanceConfig,\n      baseFieldNames,\n      hiddenContextFields,\n      generatedFieldOverrides,\n    );\n  }\n\n  if (field.schemaType === FieldSchemaType.OBJECT) {\n    return renderObjectScope(field, watchValues, allShowWhenWatchFields);\n  }\n\n  return (\n    <FormField key={field.name} name={field.name} />\n  );\n}\n\n/**\n * Renders a discriminator field + DiscriminatorSwitch for variant-specific fields.\n */\nfunction renderDiscriminatorAndVariants(\n  discriminatorField: SchemaFieldInfo,\n  config: InheritanceSchemaDefinition,\n  baseFieldNames: Set<string>,\n  hiddenContextFields: Set<string>,\n  generatedFieldOverrides?: Record<string, ReactNode>,\n): ReactNode {\n  const variants: Record<string, ReactNode> = {};\n\n  if (config.inheritedSchemas) {\n    for (const variant of config.inheritedSchemas) {\n      const variantShape = getObjectShape(variant.schema);\n      const variantKeys = getObjectKeys(variant.schema);\n\n      if (variantShape && variantKeys.length > 0) {\n        const variantOnlyKeys = variantKeys.filter(k =>\n          !isVirtualField(variantShape[k]) &&\n          !isBackendOnlyField(variantShape[k]) &&\n          !baseFieldNames.has(k) &&\n          (!hiddenContextFields.has(k) || Boolean(generatedFieldOverrides?.[k])),\n        );\n\n        if (variantOnlyKeys.length > 0) {\n          variants[variant.discriminatorFieldValue] = (\n            <>\n              {variantOnlyKeys.map((key) => (\n                <FormField key={key} name={key} />\n              ))}\n            </>\n          );\n        }\n      }\n    }\n  }\n\n  const hasVariants = Object.keys(variants).length > 0;\n\n  return (\n    <React.Fragment key={discriminatorField.name}>\n      <FormField name={discriminatorField.name} />\n      {hasVariants && (\n        <DiscriminatorSwitch\n          field={config.discriminatorField}\n          variants={variants}\n        />\n      )}\n    </React.Fragment>\n  );\n}\n\n/**\n * Renders a nested OBJECT field using ObjectScope + recursive FormField elements.\n */\nfunction renderObjectScope(\n  field: SchemaFieldInfo,\n  watchValues?: unknown[],\n  allShowWhenWatchFields?: string[],\n  parentPathPrefix: string = '',\n): ReactNode {\n  if (field.showWhenParams && watchValues && allShowWhenWatchFields) {\n    const scopedShowWhenParams = scopeShowWhenParams(field.showWhenParams, parentPathPrefix);\n    const isVisible = evaluateShowWhenFromWatch(scopedShowWhenParams, watchValues, allShowWhenWatchFields);\n    if (!isVisible) {\n      return null;\n    }\n  }\n\n  // BEFORE the shape read, because a discriminated union answers that read with an\n  // empty shape and would otherwise fall through to a `<FormField>` that renders\n  // nothing at all. This is the generator's one genuine silent drop; see\n  // `renderNestedDiscriminatedUnion`.\n  const unionScope = renderNestedDiscriminatedUnion(field);\n  if (unionScope) {\n    return unionScope;\n  }\n\n  const innerShape = readNestedObjectShape(field.schema);\n\n  const innerKeys = Object.keys(innerShape);\n  const renderableKeys = innerKeys.filter(k => {\n    const s = innerShape[k];\n    return !isVirtualField(s) && !isBackendOnlyField(s);\n  });\n\n  // Empty for a WRAPPED object (`.optional()` / `.nullable()` / `.default()`) as\n  // well as for a genuinely field-less one — `readNestedObjectShape` documents why\n  // that conflation is left in place, and why the single `<FormField>` below is a\n  // working renderer for it rather than a dead end.\n  if (renderableKeys.length === 0) {\n    return <FormField key={field.name} name={field.name} />;\n  }\n\n  const currentFieldPath = parentPathPrefix ? `${parentPathPrefix}.${field.name}` : field.name;\n\n  return (\n    <ObjectScope key={field.name} name={field.name}>\n      {renderableKeys.map(key => {\n        const childSchema = innerShape[key];\n        const childType = getSchemaType(childSchema);\n\n        if (childType === FieldSchemaType.OBJECT) {\n          const nestedField = createSchemaFieldInfo(key, childSchema);\n          return renderObjectScope(\n            nestedField,\n            watchValues,\n            allShowWhenWatchFields,\n            currentFieldPath,\n          );\n        }\n\n        return <FormField key={key} name={key} />;\n      })}\n    </ObjectScope>\n  );\n}\n\n\n// =============================================================================\n// INTERNAL — SHOW WHEN EVALUATION\n// =============================================================================\n\nfunction collectAllShowWhenWatchFields(fields: SchemaFieldInfo[]): string[] {\n  const allFields = new Set<string>();\n  for (const field of fields) {\n    collectShowWhenWatchFieldsForField(field, allFields);\n  }\n  return [...allFields];\n}\n\nfunction collectShowWhenWatchFieldsForField(\n  field: SchemaFieldInfo,\n  collector: Set<string>,\n  parentPathPrefix: string = '',\n): void {\n  if (field.showWhenParams) {\n    const scopedShowWhenParams = scopeShowWhenParams(field.showWhenParams, parentPathPrefix);\n    for (const fieldName of dedupeShowWhenWatchFields(scopedShowWhenParams)) {\n      collector.add(fieldName);\n    }\n  }\n\n  if (field.schemaType !== FieldSchemaType.OBJECT) {\n    return;\n  }\n\n  const innerShape = readNestedObjectShape(field.schema);\n\n  const currentFieldPath = parentPathPrefix ? `${parentPathPrefix}.${field.name}` : field.name;\n  for (const [childName, childSchema] of Object.entries(innerShape)) {\n    if (isVirtualField(childSchema) || isBackendOnlyField(childSchema)) {\n      continue;\n    }\n\n    collectShowWhenWatchFieldsForField(\n      createSchemaFieldInfo(childName, childSchema as z.ZodTypeAny),\n      collector,\n      currentFieldPath,\n    );\n  }\n}\n\nfunction scopeShowWhenParams(\n  params: ShowWhenParams,\n  parentPathPrefix: string,\n): ShowWhenParams {\n  if (!parentPathPrefix) {\n    return params;\n  }\n\n  const conditions = Array.isArray(params.conditions)\n    ? params.conditions\n    : [params.conditions];\n\n  return {\n    ...params,\n    conditions: conditions.map((condition) => ({\n      ...condition,\n      field: condition.field.includes('.') || condition.field.includes('[')\n        ? condition.field\n        : `${parentPathPrefix}.${condition.field}`,\n    })),\n  };\n}\n\n/**\n * Evaluates showWhen conditions using values from the useWatch array.\n * Maps field names to their positions in the watched fields array.\n */\nfunction evaluateShowWhenFromWatch(\n  params: ShowWhenParams,\n  watchValues: unknown[],\n  allWatchFields: string[],\n): boolean {\n  const formValues: Record<string, unknown> = {};\n  for (let i = 0; i < allWatchFields.length; i++) {\n    formValues[allWatchFields[i]] = watchValues[i];\n  }\n  return AutomatedLayoutFrontendUtils.evaluateShowWhen(params, formValues);\n}\n\n\n// =============================================================================\n// DISPLAY TEMPLATE GENERATION\n// =============================================================================\n\n/**\n * Generates a flat default display layout template (React.FC) from a Zod object schema.\n *\n * Schema-only: field values, labels, and descriptions are resolved from\n * DisplayTemplateContext at render time via name-only `<DisplayField name=\"x\" />`.\n *\n * Supports nested objects (`<ObjectScope>`) and per-field showWhen\n * (DD-10 — not evaluated at generator time).\n *\n * For resources that need sections or custom display layouts, provide an\n * explicit `layout.display` template in the resource config.\n *\n * @param schema - The root Zod object schema for the resource\n * @returns React.FC component using DisplayLayout + name-only DisplayField components\n */\nexport function generateDefaultDisplayTemplate(\n  schema: z.ZodTypeAny,\n): React.FC {\n  const fields = extractSchemaFieldList(schema);\n  // Same nested-union limitation as the form generator, reported at the same\n  // moment — the display side falls back to a `<DisplayField>` that resolves no\n  // child shape and renders nothing, so the silence is identical.\n  reportUnrenderableNestedObjectFields(fields, 'display');\n\n  if (fields.length === 0) {\n    const EmptyDisplayTemplate: React.FC = () => <DisplayLayout />;\n    return EmptyDisplayTemplate;\n  }\n\n  const renderDisplayField = (field: SchemaFieldInfo): ReactNode => {\n    if (field.schemaType === FieldSchemaType.OBJECT) {\n      return renderDisplayObjectScope(field);\n    }\n    return <DisplayField key={field.name} name={field.name} />;\n  };\n\n  const DefaultDisplayTemplate: React.FC = () => (\n    <DisplayLayout>\n      {fields.map(renderDisplayField)}\n    </DisplayLayout>\n  );\n  return DefaultDisplayTemplate;\n}\n\n/**\n * Renders a nested OBJECT field for display using ObjectScope + recursive DisplayField.\n */\nfunction renderDisplayObjectScope(field: SchemaFieldInfo): ReactNode {\n  const innerShape = readNestedObjectShape(field.schema);\n\n  const innerKeys = Object.keys(innerShape);\n  const renderableKeys = innerKeys.filter(k => {\n    const s = innerShape[k];\n    return !isVirtualField(s) && !isBackendOnlyField(s);\n  });\n\n  if (renderableKeys.length === 0) {\n    return <DisplayField key={field.name} name={field.name} />;\n  }\n\n  return (\n    <ObjectScope key={field.name} name={field.name}>\n      {renderableKeys.map(key => {\n        const childSchema = innerShape[key];\n        const childType = getSchemaType(childSchema);\n\n        if (childType === FieldSchemaType.OBJECT) {\n          const nestedField: SchemaFieldInfo = {\n            name: key,\n            schema: childSchema,\n            schemaType: childType,\n          };\n          return renderDisplayObjectScope(nestedField);\n        }\n\n        return <DisplayField key={key} name={key} />;\n      })}\n    </ObjectScope>\n  );\n}\n\n// =============================================================================\n// SUMMARY TEMPLATE GENERATION\n// =============================================================================\n\n/**\n * Generates a default summary layout template (React.FC) from a Zod object schema.\n *\n * Schema-only: values are resolved from DisplayTemplateContext at render time.\n * Each field uses `<DisplayField name=\"x\" />` — rendered with compact chrome\n * from the `defaultChromeMode.summary` set on the enclosing `ResourceSummaryDisplayer`.\n *\n * Includes only fields decorated with `isSummaryField()`. If no summary fields\n * are defined, renders all non-backend-only fields with summary variant.\n *\n * @param schema - The root Zod object schema for the resource\n * @returns React.FC component using SummaryLayout + name-only DisplayField components\n */\nexport function generateDefaultSummaryTemplate(\n  schema: z.ZodTypeAny,\n): React.FC {\n  // Union-aware shape (matches the display/form generators): `getObjectShape`\n  // returns null for a discriminated union, so a polymorphic resource with no\n  // authored `layout.summary` would otherwise fall into the empty branch and\n  // render a blank FK preview / ReadSummary body. `commonOnly: true` yields the\n  // fields shared across variants.\n  const shape = AutomatedLayoutFrontendUtils.getObjectLikeFieldShape(schema, { commonOnly: true });\n  const keys = shape ? Object.keys(shape) : [];\n\n  // The generated default is BODY-ONLY: `titlePlacement={TEMPLATE_OWNED}` so\n  // `SummaryLayout` renders no auto title. Resources WITHOUT an authored\n  // `layout.summary` keep their title host-owned (list card / FK popover render\n  // the primary label themselves) — routing the default through an AUTO title\n  // would restyle every no-template list in every app. Only AUTHORED templates\n  // opt the title into the flow.\n  if (!shape || keys.length === 0) {\n    const EmptySummaryTemplate: React.FC = () => (\n      <SummaryLayout titlePlacement={SummaryTitlePlacement.TEMPLATE_OWNED} />\n    );\n    return EmptySummaryTemplate;\n  }\n\n  // Summaries are `isSummaryField`-scoped (a DIFFERENT axis from the display\n  // view's all-non-hidden selection), so — unlike the display generator — we do\n  // NOT exclude virtual fields: a virtual field can legitimately be an authored\n  // summary field, and `ResourceLayoutUtils.detectSummaryFields` (the sibling\n  // path feeding table columns + card bodies) includes them too. We keep them in\n  // sync; only backend-only fields (no client value) are dropped.\n  const summaryKeys = keys.filter(key => {\n    const fieldSchema = shape[key];\n    return !isBackendOnlyField(fieldSchema) && isSummaryField(fieldSchema);\n  });\n\n  const targetKeys = summaryKeys.length > 0\n    ? summaryKeys\n    : keys.filter(key => !isBackendOnlyField(shape[key]));\n\n  const DefaultSummaryTemplate: React.FC = () => (\n    <SummaryLayout titlePlacement={SummaryTitlePlacement.TEMPLATE_OWNED}>\n      {targetKeys.map(key => (\n        <DisplayField key={key} name={key} />\n      ))}\n    </SummaryLayout>\n  );\n  return DefaultSummaryTemplate;\n}\n"]}

package/dist/esm/core/billing/BillingContext.d.ts

@@ -19,6 +19,41 @@ import React from 'react';
 import type { BillingAccount, BillingSubscriptionBase, Product, Price, Promotion, InvoiceRef, UsageSummary, BillingConfiguration, ProductDefinition } from '@wildo-ai/saas-models';
 import { ResourcePrimaryScope } from '@wildo-ai/saas-models';
 import type { FrontendAppProviderModule } from '@wildo-ai/external-connectors-public/app';
+/**
+ * @wildo_source:part:start saas.frontend.billing-context facet:layer:frontend facet:audience:app-developer
+ *
+ * Everything an application's own frontend reads or does about billing. Reached with `useBilling()`,
+ * which throws outside a `BillingProvider`; `useBillingSafe()` returns `undefined` instead, for a
+ * component that may render before the provider mounts or in an application where billing is off.
+ *
+ * The shipped billing components and the feature-gating hooks read this same context, so an
+ * application composing its own purchase flow works from exactly what they do — no application code
+ * builds the request.
+ *
+ * ## Starting a purchase
+ *
+ * `openCheckout(productKey, priceId, options)` posts to the scoped billing-account route and follows
+ * the returned URL; success and cancel destinations come from the application's own redirect base. A
+ * SECOND call while one is in flight is IGNORED, so a double-click cannot open two sessions — do not
+ * add your own guard expecting otherwise, and do not read the silence as a failure.
+ *
+ * The `priceId` must belong to the product named by `productKey`; the checkout operation refuses a
+ * mismatched pair. Resolve it through `getPricesForProduct` rather than assuming an ordering.
+ *
+ * `openCustomerPortal()` opens the provider's own portal — which is where payment methods, card
+ * updates and receipt downloads live. Those are deliberately NOT rendered by the framework, so an
+ * application that needs them links the portal rather than building them.
+ *
+ * ## What `usage` contains
+ *
+ * Metered consumption appears here only if the application RECORDS it. Nothing is automatic: a
+ * metered product with no recorded usage shows an empty dashboard rather than an error.
+ *
+ * ## Invoices are capped
+ *
+ * `invoices` carries the fifty most recent, which is what the shipped history component renders. An
+ * application needing more reads the invoices resource directly.
+ */
 export interface BillingContextType {
     isEnabled: boolean;
     billingConfiguration: BillingConfiguration | undefined;
@@ -51,6 +86,7 @@ export interface BillingContextType {
     error: Error | null;
     refetch: () => void;
 }
+/** @wildo_source:part:end saas.frontend.billing-context */
 export declare const BillingContext: React.Context<BillingContextType | undefined>;
 export interface BillingProviderProps {
     children: React.ReactNode;

package/dist/esm/core/billing/BillingContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BillingContext.d.ts","sourceRoot":"","sources":["../../../../../src/core/billing/BillingContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAA2E,MAAM,OAAO,CAAC;AAChG,OAAO,KAAK,EACV,cAAc,EACd,uBAAuB,EACvB,OAAO,EACP,KAAK,EACL,SAAS,EACT,UAAU,EACV,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EAGlB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAKL,oBAAoB,EAErB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,yBAAyB,EAA0B,MAAM,0CAA0C,CAAC;AAwFlH,MAAM,WAAW,kBAAkB;IAEjC,SAAS,EAAE,OAAO,CAAC;IACnB,oBAAoB,EAAE,oBAAoB,GAAG,SAAS,CAAC;IACvD,eAAe,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAGlD,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,YAAY,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC7C,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,kBAAkB,EAAE,OAAO,GAAG,IAAI,CAAC;IAGnC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;IACxC,mBAAmB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,KAAK,EAAE,CAAC;IACpD,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,CAAC;IAGtD,YAAY,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAG1C,QAAQ,EAAE,UAAU,EAAE,CAAC;IAGvB,gBAAgB,EAAE,SAAS,EAAE,CAAC;IAG9B,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAGlG,YAAY,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpB,kBAAkB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAGxC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAGpB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAOD,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAA4D,CAAC;AAMtI,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC1C;AAED,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,EAAE,oBAAoB,GAAG,KAAK,CAAC,YAAY,CA2atI"}
+{"version":3,"file":"BillingContext.d.ts","sourceRoot":"","sources":["../../../../src/core/billing/BillingContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAA2E,MAAM,OAAO,CAAC;AAChG,OAAO,KAAK,EACV,cAAc,EACd,uBAAuB,EACvB,OAAO,EACP,KAAK,EACL,SAAS,EACT,UAAU,EACV,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EAGlB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAKL,oBAAoB,EAErB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,yBAAyB,EAA0B,MAAM,0CAA0C,CAAC;AAwFlH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,WAAW,kBAAkB;IAEjC,SAAS,EAAE,OAAO,CAAC;IACnB,oBAAoB,EAAE,oBAAoB,GAAG,SAAS,CAAC;IACvD,eAAe,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAGlD,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,YAAY,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC7C,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,kBAAkB,EAAE,OAAO,GAAG,IAAI,CAAC;IAGnC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;IACxC,mBAAmB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,KAAK,EAAE,CAAC;IACpD,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,CAAC;IAGtD,YAAY,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAG1C,QAAQ,EAAE,UAAU,EAAE,CAAC;IAGvB,gBAAgB,EAAE,SAAS,EAAE,CAAC;IAG9B,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAGlG,YAAY,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpB,kBAAkB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAGxC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAGpB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAOD,2DAA2D;AAE3D,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAA4D,CAAC;AAMtI,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC1C;AAED,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,EAAE,oBAAoB,GAAG,KAAK,CAAC,YAAY,CA2atI"}

package/dist/esm/core/billing/BillingContext.js

@@ -79,6 +79,7 @@ const SCOPE_TO_OPEN_PORTAL_URL = {
 const EMPTY_USAGE = {
     byProduct: {},
 };
+/** @wildo_source:part:end saas.frontend.billing-context */
 export const BillingContext = createContext(undefined);
 export function BillingProvider({ children, productDefinitions: injectedProductDefinitions }) {
     // ── Self-resolve configuration from hooks ──