@wildo-ai/saas-frontend-lib 1.0.1

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

@@ -0,0 +1,125 @@
+import React from 'react';
+import { z } from 'zod';
+import type { ShowWhenParams } from '@wildo-ai/zod-decorators';
+import { FieldSchemaType } from '@wildo-ai/zod-decorators';
+import type { InheritanceSchemaDefinition } from './automated-layout.frontend.schemas.js';
+/**
+ * Label resolver function signature for layout template generators.
+ * Receives a field name (potentially dotted path) and returns a human-readable label.
+ * Consumers (AutomatedForm, AutomaticDisplayer) pass their i18n-aware resolver here.
+ */
+export type LayoutLabelResolver = (fieldName: string) => string;
+/**
+ * Lightweight field descriptor produced by `extractSchemaFieldList()`.
+ * Contains only what the template generator needs — no grid/row/layout calculations.
+ */
+export interface SchemaFieldInfo {
+    /** Field key (top-level name, not dotted path) */
+    name: string;
+    /** The Zod schema for this field */
+    schema: z.ZodTypeAny;
+    /** Resolved schema type (STRING, NUMBER, OBJECT, ARRAY, etc.) */
+    schemaType: FieldSchemaType;
+    /** showWhen conditional visibility params (from `.showWhen()` decorator) */
+    showWhenParams?: ShowWhenParams;
+    /** Fields that showWhen depends on (deduped) */
+    showWhenWatchFields?: string[];
+    /** Whether this field is a discriminator for a discriminated union */
+    isDiscriminator?: boolean;
+}
+/**
+ * Extracts a flat list of renderable root fields from an object-like schema.
+ *
+ * Produces the field metadata the template generator needs.
+ * No grid math, no row calculations, no section/wizard grouping.
+ *
+ * Excludes: virtual fields, backend-only fields.
+ * Does NOT exclude operation-specific fields — those are handled at render time.
+ */
+export declare function extractSchemaFieldList(schema: z.ZodTypeAny, discriminatorField?: string): SchemaFieldInfo[];
+/**
+ * Options for `generateDefaultFormTemplate()`.
+ * All options are optional — omitting everything produces a flat field list.
+ *
+ * For resources that need sections, wizard steps, or custom layout,
+ * provide an explicit `layout.edit` template in the resource config
+ * instead of using the auto-generator.
+ */
+export interface FormTemplateGeneratorOptions {
+    /** Inheritance config for discriminated unions. Produces `<DiscriminatorSwitch>`. */
+    inheritanceConfig?: InheritanceSchemaDefinition;
+    /** Label resolver (i18n-aware). Defaults to camelCase fallback formatting. */
+    resolveLabel?: LayoutLabelResolver;
+    /**
+     * Whether to include `<SubmitButton />` in the generated template.
+     * Set to `false` when the caller provides its own submit button externally
+     * (e.g., ResourceAutomatedForm for operation-specific labels, draft mode).
+     * @default true
+     */
+    includeSubmitButton?: boolean;
+    /**
+     * Whether to include `<FormErrorSummarySlot />` in the generated template.
+     * Set to `false` when the caller handles error summary externally.
+     * @default true
+     */
+    includeErrorSummary?: boolean;
+}
+/**
+ * Generates a flat default form layout template component from a Zod object schema.
+ *
+ * Returns a `React.FC` (not ReactNode) so that forms with `.showWhen()` decorators
+ * can use `useWatch()` hooks for conditional rendering. The returned component is
+ * stable across renders when memoized by the caller.
+ *
+ * Capabilities:
+ * - **Flat list**: one `<FormField>` per key, wrapped in `<FormLayout>`
+ * - **showWhen**: produces `useWatch()` + conditional rendering for fields with `.showWhen()` decorators,
+ *   including nested OBJECT scopes.
+ * - **Discriminated unions**: produces `<DiscriminatorSwitch>` with variant field grouping
+ * - **Nested objects**: produces `<ObjectScope>` + recursive `<FormField>` for OBJECT fields
+ *
+ * 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.
+ *
+ * @param schema - Root object-like schema for the resource. Plain object roots and
+ *   discriminated-union roots are both supported.
+ * @param options - Generator options (inheritance, labels, submit/error controls)
+ * @returns React.FC — a component function (memoize with useMemo/useRef for stable identity)
+ */
+export declare function generateDefaultFormTemplate(schema: z.ZodTypeAny, options?: FormTemplateGeneratorOptions): React.FC;
+/**
+ * Generates a flat default display layout template (React.FC) from a Zod object schema.
+ *
+ * Schema-only: field values, labels, and descriptions are resolved from
+ * DisplayTemplateContext at render time via name-only `<DisplayField name="x" />`.
+ *
+ * Supports nested objects (`<ObjectScope>`) and per-field showWhen
+ * (DD-10 — not evaluated at generator time).
+ *
+ * For resources that need sections or custom display layouts, provide an
+ * explicit `layout.display` template in the resource config.
+ *
+ * @param schema - The root Zod object schema for the resource
+ * @returns React.FC component using DisplayLayout + name-only DisplayField components
+ */
+export declare function generateDefaultDisplayTemplate(schema: z.ZodTypeAny): React.FC;
+/**
+ * Generates a default summary layout template (React.FC) from a Zod object schema.
+ *
+ * Schema-only: values are resolved from DisplayTemplateContext at render time.
+ * Each field uses `<DisplayField name="x" />` — rendered with compact chrome
+ * from the `defaultChromeMode.summary` set on the enclosing `ResourceSummaryDisplayer`.
+ *
+ * Includes only fields decorated with `isSummaryField()`. If no summary fields
+ * are defined, renders all non-backend-only fields with summary variant.
+ *
+ * @param schema - The root Zod object schema for the resource
+ * @returns React.FC component using SummaryLayout + name-only DisplayField components
+ */
+export declare function generateDefaultSummaryTemplate(schema: z.ZodTypeAny): React.FC;
+//# sourceMappingURL=default-layout-generator.frontend.utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"default-layout-generator.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../src/core/automated-layout/default-layout-generator.frontend.utils.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAqB,MAAM,0BAA0B,CAAC;AAClF,OAAO,EACL,eAAe,EAShB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAavF;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;AAMhE;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IACrB,iEAAiE;IACjE,UAAU,EAAE,eAAe,CAAC;IAC5B,4EAA4E;IAC5E,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,gDAAgD;IAChD,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,sEAAsE;IACtE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAsBD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,CAAC,CAAC,UAAU,EACpB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,eAAe,EAAE,CAgBnB;AAcD;;;;;;;GAOG;AACH,MAAM,WAAW,4BAA4B;IAC3C,qFAAqF;IACrF,iBAAiB,CAAC,EAAE,2BAA2B,CAAC;IAChD,8EAA8E;IAC9E,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAOD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,CAAC,CAAC,UAAU,EACpB,OAAO,CAAC,EAAE,4BAA4B,GACrC,KAAK,CAAC,EAAE,CA2DV;AAkQD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,CAAC,CAAC,UAAU,GACnB,KAAK,CAAC,EAAE,CAqBV;AA8CD;;;;;;;;;;;;GAYG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,CAAC,CAAC,UAAU,GACnB,KAAK,CAAC,EAAE,CA0BV"}

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

@@ -0,0 +1,368 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import React from 'react';
+import { FieldSchemaType, getSchemaType, getObjectShape, getObjectKeys, getZodObjectShape, 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';
+import { SummaryLayout } from '../../components/resources/skeleton/SummaryLayout.js';
+import { FormErrorSummarySlot } from '../../components/resources/skeleton/FormErrorSummarySlot.js';
+import { SubmitButton } from '../../components/resources/skeleton/SubmitButton.js';
+import { ObjectScope } from '../../components/resources/skeleton/ObjectScope.js';
+import { DiscriminatorSwitch } from '../../components/resources/skeleton/DiscriminatorSwitch.js';
+import { FormField } from '../../components/form/automated/FormField.js';
+import { useOptionalFormTemplateContext } from '../../components/form/automated/FormTemplateContext.js';
+import { DisplayField } from '../../components/data-display/DisplayField.js';
+import { useWatch } from 'react-hook-form';
+function createSchemaFieldInfo(name, schema, discriminatorField) {
+    const schemaType = getSchemaType(schema);
+    const showWhenParams = getShowWhenParams(schema);
+    return {
+        name,
+        schema,
+        schemaType,
+        showWhenParams,
+        showWhenWatchFields: showWhenParams
+            ? dedupeShowWhenWatchFields(showWhenParams)
+            : undefined,
+        isDiscriminator: discriminatorField === name,
+    };
+}
+/**
+ * Extracts a flat list of renderable root fields from an object-like schema.
+ *
+ * Produces the field metadata the template generator needs.
+ * No grid math, no row calculations, no section/wizard grouping.
+ *
+ * Excludes: virtual fields, backend-only fields.
+ * Does NOT exclude operation-specific fields — those are handled at render time.
+ */
+export function extractSchemaFieldList(schema, discriminatorField) {
+    const shape = AutomatedLayoutFrontendUtils.getObjectLikeFieldShape(schema, { commonOnly: true });
+    const keys = shape ? Object.keys(shape) : [];
+    if (!shape || keys.length === 0)
+        return [];
+    const fields = [];
+    for (const key of keys) {
+        const fieldSchema = shape[key];
+        if (isVirtualField(fieldSchema) || isBackendOnlyField(fieldSchema))
+            continue;
+        fields.push(createSchemaFieldInfo(key, fieldSchema, discriminatorField));
+    }
+    return fields;
+}
+function dedupeShowWhenWatchFields(params) {
+    const conditions = Array.isArray(params.conditions)
+        ? params.conditions
+        : [params.conditions];
+    return [...new Set(conditions.map(c => c.field))];
+}
+// =============================================================================
+// FORM TEMPLATE GENERATION — MAIN
+// =============================================================================
+/**
+ * Generates a flat default form layout template component from a Zod object schema.
+ *
+ * Returns a `React.FC` (not ReactNode) so that forms with `.showWhen()` decorators
+ * can use `useWatch()` hooks for conditional rendering. The returned component is
+ * stable across renders when memoized by the caller.
+ *
+ * Capabilities:
+ * - **Flat list**: one `<FormField>` per key, wrapped in `<FormLayout>`
+ * - **showWhen**: produces `useWatch()` + conditional rendering for fields with `.showWhen()` decorators,
+ *   including nested OBJECT scopes.
+ * - **Discriminated unions**: produces `<DiscriminatorSwitch>` with variant field grouping
+ * - **Nested objects**: produces `<ObjectScope>` + recursive `<FormField>` for OBJECT fields
+ *
+ * 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.
+ *
+ * @param schema - Root object-like schema for the resource. Plain object roots and
+ *   discriminated-union roots are both supported.
+ * @param options - Generator options (inheritance, labels, submit/error controls)
+ * @returns React.FC — a component function (memoize with useMemo/useRef for stable identity)
+ */
+export function generateDefaultFormTemplate(schema, options) {
+    const inheritanceConfig = options?.inheritanceConfig;
+    const fields = extractSchemaFieldList(schema, inheritanceConfig?.discriminatorField);
+    const showSubmit = options?.includeSubmitButton !== false;
+    const showErrorSummary = options?.includeErrorSummary !== false;
+    if (fields.length === 0) {
+        const EmptyTemplate = () => _jsx(FormLayout, { autoInjectSubmitButton: showSubmit });
+        EmptyTemplate.displayName = 'GeneratedFormTemplate(empty)';
+        return EmptyTemplate;
+    }
+    const allShowWhenWatchFields = collectAllShowWhenWatchFields(fields);
+    const hasShowWhen = allShowWhenWatchFields.length > 0;
+    const baseFieldNames = new Set(fields.map(f => f.name));
+    const GeneratedTemplate = () => {
+        const watchValues = useConditionalWatch(hasShowWhen, allShowWhenWatchFields);
+        const formTemplateContext = useOptionalFormTemplateContext();
+        const hiddenGeneratedFields = new Set(Object.keys(formTemplateContext?.contextFieldValues ?? {}));
+        for (const hiddenFieldName of formTemplateContext?.hiddenFieldNames ?? []) {
+            hiddenGeneratedFields.add(hiddenFieldName);
+        }
+        const renderField = (field) => {
+            const hasGeneratedOverride = Boolean(formTemplateContext?.generatedFieldOverrides?.[field.name]);
+            const element = hiddenGeneratedFields.has(field.name) && !hasGeneratedOverride
+                ? null
+                : renderFieldElement(field, inheritanceConfig, baseFieldNames, hiddenGeneratedFields, formTemplateContext?.generatedFieldOverrides, watchValues, allShowWhenWatchFields);
+            if (!field.showWhenParams || !watchValues)
+                return element;
+            const isVisible = evaluateShowWhenFromWatch(field.showWhenParams, watchValues, allShowWhenWatchFields);
+            return isVisible ? element : null;
+        };
+        return (_jsxs(FormLayout, { autoInjectSubmitButton: showSubmit, children: [showErrorSummary && _jsx(FormErrorSummarySlot, {}), fields.map(renderField), showSubmit && _jsx(SubmitButton, {})] }));
+    };
+    GeneratedTemplate.displayName = 'GeneratedFormTemplate';
+    return GeneratedTemplate;
+}
+// =============================================================================
+// INTERNAL — CONDITIONAL WATCH HOOK
+// =============================================================================
+/**
+ * Conditionally calls `useWatch` — only when there are showWhen fields to track.
+ * React hooks must be called unconditionally, so we always call useWatch but with
+ * an empty array when not needed (no-op).
+ */
+function useConditionalWatch(hasShowWhen, watchFields) {
+    const values = useWatch({ name: hasShowWhen ? watchFields : [] });
+    return hasShowWhen ? (Array.isArray(values) ? values : [values]) : undefined;
+}
+// =============================================================================
+// INTERNAL — FIELD RENDERING
+// =============================================================================
+/**
+ * Renders a single field element, handling OBJECT nesting and discriminated unions.
+ */
+function renderFieldElement(field, inheritanceConfig, baseFieldNames, hiddenContextFields, generatedFieldOverrides, watchValues, allShowWhenWatchFields) {
+    if (generatedFieldOverrides?.[field.name]) {
+        return _jsx(FormField, { name: field.name }, field.name);
+    }
+    if (field.isDiscriminator && inheritanceConfig && baseFieldNames && hiddenContextFields) {
+        return renderDiscriminatorAndVariants(field, inheritanceConfig, baseFieldNames, hiddenContextFields, generatedFieldOverrides);
+    }
+    if (field.schemaType === FieldSchemaType.OBJECT) {
+        return renderObjectScope(field, watchValues, allShowWhenWatchFields);
+    }
+    return (_jsx(FormField, { name: field.name }, field.name));
+}
+/**
+ * Renders a discriminator field + DiscriminatorSwitch for variant-specific fields.
+ */
+function renderDiscriminatorAndVariants(discriminatorField, config, baseFieldNames, hiddenContextFields, generatedFieldOverrides) {
+    const variants = {};
+    if (config.inheritedSchemas) {
+        for (const variant of config.inheritedSchemas) {
+            const variantShape = getObjectShape(variant.schema);
+            const variantKeys = getObjectKeys(variant.schema);
+            if (variantShape && variantKeys.length > 0) {
+                const variantOnlyKeys = variantKeys.filter(k => !isVirtualField(variantShape[k]) &&
+                    !isBackendOnlyField(variantShape[k]) &&
+                    !baseFieldNames.has(k) &&
+                    (!hiddenContextFields.has(k) || Boolean(generatedFieldOverrides?.[k])));
+                if (variantOnlyKeys.length > 0) {
+                    variants[variant.discriminatorFieldValue] = (_jsx(_Fragment, { children: variantOnlyKeys.map((key) => (_jsx(FormField, { name: key }, key))) }));
+                }
+            }
+        }
+    }
+    const hasVariants = Object.keys(variants).length > 0;
+    return (_jsxs(React.Fragment, { children: [_jsx(FormField, { name: discriminatorField.name }), hasVariants && (_jsx(DiscriminatorSwitch, { field: config.discriminatorField, variants: variants }))] }, discriminatorField.name));
+}
+/**
+ * Renders a nested OBJECT field using ObjectScope + recursive FormField elements.
+ */
+function renderObjectScope(field, watchValues, allShowWhenWatchFields, parentPathPrefix = '') {
+    if (field.showWhenParams && watchValues && allShowWhenWatchFields) {
+        const scopedShowWhenParams = scopeShowWhenParams(field.showWhenParams, parentPathPrefix);
+        const isVisible = evaluateShowWhenFromWatch(scopedShowWhenParams, watchValues, allShowWhenWatchFields);
+        if (!isVisible) {
+            return null;
+        }
+    }
+    const innerShape = getZodObjectShape(field.schema);
+    if (!innerShape) {
+        return _jsx(FormField, { name: field.name }, field.name);
+    }
+    const innerKeys = Object.keys(innerShape);
+    const renderableKeys = innerKeys.filter(k => {
+        const s = innerShape[k];
+        return !isVirtualField(s) && !isBackendOnlyField(s);
+    });
+    if (renderableKeys.length === 0) {
+        return _jsx(FormField, { name: field.name }, field.name);
+    }
+    const currentFieldPath = parentPathPrefix ? `${parentPathPrefix}.${field.name}` : field.name;
+    return (_jsx(ObjectScope, { name: field.name, children: renderableKeys.map(key => {
+            const childSchema = innerShape[key];
+            const childType = getSchemaType(childSchema);
+            if (childType === FieldSchemaType.OBJECT) {
+                const nestedField = createSchemaFieldInfo(key, childSchema);
+                return renderObjectScope(nestedField, watchValues, allShowWhenWatchFields, currentFieldPath);
+            }
+            return _jsx(FormField, { name: key }, key);
+        }) }, field.name));
+}
+// =============================================================================
+// INTERNAL — SHOW WHEN EVALUATION
+// =============================================================================
+function collectAllShowWhenWatchFields(fields) {
+    const allFields = new Set();
+    for (const field of fields) {
+        collectShowWhenWatchFieldsForField(field, allFields);
+    }
+    return [...allFields];
+}
+function collectShowWhenWatchFieldsForField(field, collector, parentPathPrefix = '') {
+    if (field.showWhenParams) {
+        const scopedShowWhenParams = scopeShowWhenParams(field.showWhenParams, parentPathPrefix);
+        for (const fieldName of dedupeShowWhenWatchFields(scopedShowWhenParams)) {
+            collector.add(fieldName);
+        }
+    }
+    if (field.schemaType !== FieldSchemaType.OBJECT) {
+        return;
+    }
+    const innerShape = getZodObjectShape(field.schema);
+    if (!innerShape) {
+        return;
+    }
+    const currentFieldPath = parentPathPrefix ? `${parentPathPrefix}.${field.name}` : field.name;
+    for (const [childName, childSchema] of Object.entries(innerShape)) {
+        if (isVirtualField(childSchema) || isBackendOnlyField(childSchema)) {
+            continue;
+        }
+        collectShowWhenWatchFieldsForField(createSchemaFieldInfo(childName, childSchema), collector, currentFieldPath);
+    }
+}
+function scopeShowWhenParams(params, parentPathPrefix) {
+    if (!parentPathPrefix) {
+        return params;
+    }
+    const conditions = Array.isArray(params.conditions)
+        ? params.conditions
+        : [params.conditions];
+    return {
+        ...params,
+        conditions: conditions.map((condition) => ({
+            ...condition,
+            field: condition.field.includes('.') || condition.field.includes('[')
+                ? condition.field
+                : `${parentPathPrefix}.${condition.field}`,
+        })),
+    };
+}
+/**
+ * Evaluates showWhen conditions using values from the useWatch array.
+ * Maps field names to their positions in the watched fields array.
+ */
+function evaluateShowWhenFromWatch(params, watchValues, allWatchFields) {
+    const formValues = {};
+    for (let i = 0; i < allWatchFields.length; i++) {
+        formValues[allWatchFields[i]] = watchValues[i];
+    }
+    return AutomatedLayoutFrontendUtils.evaluateShowWhen(params, formValues);
+}
+// =============================================================================
+// DISPLAY TEMPLATE GENERATION
+// =============================================================================
+/**
+ * Generates a flat default display layout template (React.FC) from a Zod object schema.
+ *
+ * Schema-only: field values, labels, and descriptions are resolved from
+ * DisplayTemplateContext at render time via name-only `<DisplayField name="x" />`.
+ *
+ * Supports nested objects (`<ObjectScope>`) and per-field showWhen
+ * (DD-10 — not evaluated at generator time).
+ *
+ * For resources that need sections or custom display layouts, provide an
+ * explicit `layout.display` template in the resource config.
+ *
+ * @param schema - The root Zod object schema for the resource
+ * @returns React.FC component using DisplayLayout + name-only DisplayField components
+ */
+export function generateDefaultDisplayTemplate(schema) {
+    const fields = extractSchemaFieldList(schema);
+    if (fields.length === 0) {
+        const EmptyDisplayTemplate = () => _jsx(DisplayLayout, {});
+        return EmptyDisplayTemplate;
+    }
+    const renderDisplayField = (field) => {
+        if (field.schemaType === FieldSchemaType.OBJECT) {
+            return renderDisplayObjectScope(field);
+        }
+        return _jsx(DisplayField, { name: field.name }, field.name);
+    };
+    const DefaultDisplayTemplate = () => (_jsx(DisplayLayout, { children: fields.map(renderDisplayField) }));
+    return DefaultDisplayTemplate;
+}
+/**
+ * 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 innerKeys = Object.keys(innerShape);
+    const renderableKeys = innerKeys.filter(k => {
+        const s = innerShape[k];
+        return !isVirtualField(s) && !isBackendOnlyField(s);
+    });
+    if (renderableKeys.length === 0) {
+        return _jsx(DisplayField, { name: field.name }, field.name);
+    }
+    return (_jsx(ObjectScope, { name: field.name, children: renderableKeys.map(key => {
+            const childSchema = innerShape[key];
+            const childType = getSchemaType(childSchema);
+            if (childType === FieldSchemaType.OBJECT) {
+                const nestedField = {
+                    name: key,
+                    schema: childSchema,
+                    schemaType: childType,
+                };
+                return renderDisplayObjectScope(nestedField);
+            }
+            return _jsx(DisplayField, { name: key }, key);
+        }) }, field.name));
+}
+// =============================================================================
+// SUMMARY TEMPLATE GENERATION
+// =============================================================================
+/**
+ * Generates a default summary layout template (React.FC) from a Zod object schema.
+ *
+ * Schema-only: values are resolved from DisplayTemplateContext at render time.
+ * Each field uses `<DisplayField name="x" />` — rendered with compact chrome
+ * from the `defaultChromeMode.summary` set on the enclosing `ResourceSummaryDisplayer`.
+ *
+ * Includes only fields decorated with `isSummaryField()`. If no summary fields
+ * are defined, renders all non-backend-only fields with summary variant.
+ *
+ * @param schema - The root Zod object schema for the resource
+ * @returns React.FC component using SummaryLayout + name-only DisplayField components
+ */
+export function generateDefaultSummaryTemplate(schema) {
+    const shape = getObjectShape(schema);
+    const keys = getObjectKeys(schema);
+    if (!shape || keys.length === 0) {
+        const EmptySummaryTemplate = () => _jsx(SummaryLayout, {});
+        return EmptySummaryTemplate;
+    }
+    const summaryKeys = keys.filter(key => {
+        const fieldSchema = shape[key];
+        return !isBackendOnlyField(fieldSchema) && isSummaryField(fieldSchema);
+    });
+    const targetKeys = summaryKeys.length > 0
+        ? summaryKeys
+        : keys.filter(key => !isBackendOnlyField(shape[key]));
+    const DefaultSummaryTemplate = () => (_jsx(SummaryLayout, { children: targetKeys.map(key => (_jsx(DisplayField, { name: key }, key))) }));
+    return DefaultSummaryTemplate;
+}
+//# sourceMappingURL=default-layout-generator.frontend.utils.js.map

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

@@ -0,0 +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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"}

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

@@ -0,0 +1,58 @@
+/**
+ * BillingContext
+ *
+ * Central context for billing operations on the frontend.
+ *
+ * Responsibilities:
+ * - Self-resolves scope (org/user) from AppScope + user context — no external props needed
+ * - Fetches billing state via the GET_STATE resource operation on the billing account
+ * - The backend auto-creates the billing account if one doesn't exist
+ * - Provides actions: openCheckout, openCustomerPortal (via resource operations)
+ * - Caches billing state and invalidates on WebSocket events
+ * - Exposes convenience accessors for current plan, subscription status, etc.
+ *
+ * DELEGATION PRINCIPLE: The frontend does NOT build payment UI.
+ * - Stripe Checkout (hosted page): for new subscriptions and upgrades
+ * - Stripe Customer Portal (hosted page): for invoices, payment methods, cancellation
+ */
+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';
+export interface BillingContextType {
+    isEnabled: boolean;
+    billingConfiguration: BillingConfiguration | undefined;
+    billingAccount: BillingAccount | null;
+    subscription: BillingSubscriptionBase | null;
+    currentPlanKey: string | null;
+    currentPlanProduct: Product | null;
+    products: Product[];
+    prices: Price[];
+    productDefinitions: ProductDefinition[];
+    getPricesForProduct: (productId: string) => Price[];
+    getProductByKey: (key: string) => Product | undefined;
+    currentScope: ResourcePrimaryScope | null;
+    invoices: InvoiceRef[];
+    activePromotions: Promotion[];
+    usage: UsageSummary;
+    creditPools: Record<string, {
+        available: number;
+        totalPurchased: number;
+        totalConsumed: number;
+    }>;
+    openCheckout: (productKey: string, priceId: string, options?: {
+        quantity?: number;
+        promotionCode?: string;
+        trialDays?: number;
+    }) => Promise<void>;
+    openCustomerPortal: () => Promise<void>;
+    isLoading: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+export declare const BillingContext: React.Context<BillingContextType | undefined>;
+export interface BillingProviderProps {
+    children: React.ReactNode;
+    productDefinitions?: ProductDefinition[];
+}
+export declare function BillingProvider({ children, productDefinitions: injectedProductDefinitions }: BillingProviderProps): React.ReactElement;
+//# sourceMappingURL=BillingContext.d.ts.map

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

@@ -0,0 +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,EAGL,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;AA+D/B,MAAM,WAAW,kBAAkB;IAEjC,SAAS,EAAE,OAAO,CAAC;IACnB,oBAAoB,EAAE,oBAAoB,GAAG,SAAS,CAAC;IAGvD,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,CA+VtI"}