@wildo-ai/saas-frontend-lib 1.0.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"app-shell.utils.js","sourceRoot":"","sources":["../../../../src/core/app-shell/app-shell.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,uEAAuE,CAAC;AACtH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAE5E;;;;;;;GAOG;AACH,MAAM,UAAU,0CAA0C,CACxD,IAAmC;IAEnC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,6BAA6B,CAAC,YAAY;YAC7C,OAAO,qBAAqB,CAAC,8BAA8B,CAAC;QAC9D,KAAK,6BAA6B,CAAC,mBAAmB;YACpD,OAAO,qBAAqB,CAAC,qCAAqC,CAAC;QACrE,KAAK,6BAA6B,CAAC,mBAAmB;YACpD,OAAO,qBAAqB,CAAC,qCAAqC,CAAC;QACrE,KAAK,6BAA6B,CAAC,aAAa;YAC9C,OAAO,qBAAqB,CAAC,+BAA+B,CAAC;QAC/D,KAAK,6BAA6B,CAAC,aAAa;YAC9C,OAAO,qBAAqB,CAAC,+BAA+B,CAAC;QAC/D,KAAK,6BAA6B,CAAC,cAAc;YAC/C,OAAO,qBAAqB,CAAC,gCAAgC,CAAC;QAChE,KAAK,6BAA6B,CAAC,iBAAiB;YAClD;;;;;;eAMG;YACH,OAAO,qBAAqB,CAAC,+BAA+B,CAAC;QAC/D,KAAK,6BAA6B,CAAC,kBAAkB;YACnD,OAAO,qBAAqB,CAAC,iCAAiC,CAAC;QACjE,KAAK,6BAA6B,CAAC,aAAa;YAC9C,OAAO,qBAAqB,CAAC,+BAA+B,CAAC;QAC/D;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,11 @@
+import type { AppShellLayoutInfo } from './app-shell.schemas.js';
+/**
+ * Pure behavior hook for the app shell layout — computes which app-level
+ * components are present and their placement, and gates application
+ * initialization via `markComponentInitialized`.
+ *
+ * `has*` flags reflect *config presence*, not visibility (breakpoint-gated
+ * visibility is the preset's responsibility).
+ */
+export declare function useAppShellLayout(): AppShellLayoutInfo;
+//# sourceMappingURL=useAppShellLayout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAppShellLayout.d.ts","sourceRoot":"","sources":["../../../../src/core/app-shell/useAppShellLayout.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG9D;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI,kBAAkB,CAyDtD"}

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

@@ -0,0 +1,68 @@
+import { useEffect, useMemo } from 'react';
+import { HorizontalPlacement, VerticalPlacement } from '@wildo-ai/presets-components-models';
+import { ApplicationLevelComponentType } from '../../core/config/app-level-components.frontend.schemas.js';
+import { useUI } from '../../core/ui/useUI.js';
+import { useApplication } from '../../core/runtime/useApplication.js';
+import { MainContextInitComponents } from '../../core/runtime/runtime.frontend.schemas.js';
+import { isSidebarConfigObject, isStatusBarConfigObject, isUtilityPanelConfigObject } from './app-shell.schemas.js';
+/**
+ * Pure behavior hook for the app shell layout — computes which app-level
+ * components are present and their placement, and gates application
+ * initialization via `markComponentInitialized`.
+ *
+ * `has*` flags reflect *config presence*, not visibility (breakpoint-gated
+ * visibility is the preset's responsibility).
+ */
+export function useAppShellLayout() {
+    const { UIConfig, navigationLayout: resolvedNavigationLayout, appComponentsConfiguration } = useUI();
+    const { markComponentInitialized } = useApplication();
+    const isLayoutReady = Boolean(resolvedNavigationLayout && appComponentsConfiguration);
+    useEffect(() => {
+        if (isLayoutReady) {
+            markComponentInitialized(MainContextInitComponents.APP_MAIN_CONTAINER);
+        }
+    }, [isLayoutReady, markComponentInitialized]);
+    return useMemo(() => {
+        if (!isLayoutReady || !resolvedNavigationLayout || !appComponentsConfiguration) {
+            return {
+                hasMenubar: false,
+                hasSidebar: false,
+                hasStatusBar: false,
+                hasToolbar: false,
+                hasActivityBar: false,
+                hasQuickActionButton: false,
+                hasUtilityPanel: false,
+                sidebarPlacement: HorizontalPlacement.START,
+                statusBarPlacement: VerticalPlacement.BOTTOM,
+                utilityPanelPlacement: HorizontalPlacement.END,
+                isLayoutReady: false,
+            };
+        }
+        const sidebarConfig = appComponentsConfiguration[ApplicationLevelComponentType.SIDEBAR];
+        const statusBarConfig = appComponentsConfiguration[ApplicationLevelComponentType.STATUS_BAR];
+        const utilityPanelConfig = appComponentsConfiguration[ApplicationLevelComponentType.UTILITY_PANEL];
+        const sidebarPlacement = isSidebarConfigObject(sidebarConfig)
+            ? sidebarConfig.placement
+            : HorizontalPlacement.START;
+        return {
+            hasMenubar: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.MENUBAR]),
+            hasSidebar: Boolean(sidebarConfig),
+            hasStatusBar: Boolean(statusBarConfig),
+            hasToolbar: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.TOOLBAR]),
+            hasActivityBar: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.ACTIVITY_BAR]),
+            hasQuickActionButton: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.QUICK_ACTION_BUTTON]),
+            hasUtilityPanel: Boolean(utilityPanelConfig),
+            sidebarPlacement,
+            statusBarPlacement: typeof statusBarConfig === 'string'
+                ? statusBarConfig
+                : isStatusBarConfigObject(statusBarConfig)
+                    ? statusBarConfig.placement ?? VerticalPlacement.BOTTOM
+                    : VerticalPlacement.BOTTOM,
+            utilityPanelPlacement: isUtilityPanelConfigObject(utilityPanelConfig)
+                ? utilityPanelConfig.position ?? HorizontalPlacement.END
+                : HorizontalPlacement.END,
+            isLayoutReady: true,
+        };
+    }, [isLayoutReady, resolvedNavigationLayout, appComponentsConfiguration]);
+}
+//# sourceMappingURL=useAppShellLayout.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAppShellLayout.js","sourceRoot":"","sources":["../../../../src/core/app-shell/useAppShellLayout.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,9 @@
+import type { PublicShellLayoutInfo } from './app-shell.schemas.js';
+/**
+ * Pure behavior hook for the public shell layout.
+ *
+ * Gates application initialization via `markComponentInitialized` on mount
+ * and exposes layout mode (`useCardLayout`).
+ */
+export declare function usePublicShellLayout(useCardLayout?: boolean): PublicShellLayoutInfo;
+//# sourceMappingURL=usePublicShellLayout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usePublicShellLayout.d.ts","sourceRoot":"","sources":["../../../../src/core/app-shell/usePublicShellLayout.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,UAAQ,GAAG,qBAAqB,CAWjF"}

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

@@ -0,0 +1,20 @@
+import { useEffect } from 'react';
+import { useApplication } from '../../core/runtime/useApplication.js';
+import { MainContextInitComponents } from '../../core/runtime/runtime.frontend.schemas.js';
+/**
+ * Pure behavior hook for the public shell layout.
+ *
+ * Gates application initialization via `markComponentInitialized` on mount
+ * and exposes layout mode (`useCardLayout`).
+ */
+export function usePublicShellLayout(useCardLayout = false) {
+    const { markComponentInitialized } = useApplication();
+    useEffect(() => {
+        markComponentInitialized(MainContextInitComponents.PUBLIC_APP_CONTAINER);
+    }, [markComponentInitialized]);
+    return {
+        useCardLayout,
+        isReady: true,
+    };
+}
+//# sourceMappingURL=usePublicShellLayout.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usePublicShellLayout.js","sourceRoot":"","sources":["../../../../src/core/app-shell/usePublicShellLayout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2DAA2D,CAAC;AAItG;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,aAAa,GAAG,KAAK;IACxD,MAAM,EAAE,wBAAwB,EAAE,GAAG,cAAc,EAAE,CAAC;IAEtD,SAAS,CAAC,GAAG,EAAE;QACb,wBAAwB,CAAC,yBAAyB,CAAC,oBAAoB,CAAC,CAAC;IAC3E,CAAC,EAAE,CAAC,wBAAwB,CAAC,CAAC,CAAC;IAE/B,OAAO;QACL,aAAa;QACb,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,57 @@
+import { ValidationMode } from '@wildo-ai/zod-decorators';
+import { CoreResourceOperation } from '@wildo-ai/saas-models';
+import type { z } from 'zod';
+/**
+ * Default validation mode for all forms.
+ * Centralized constant for consistent default behavior.
+ */
+export declare const DEFAULT_VALIDATION_MODE = ValidationMode.ON_BLUR;
+/**
+ * State enum for inline field editing.
+ * Represents the different states a field can be in during inline editing.
+ */
+export declare enum InlineEditState {
+    /** Displaying value, not in edit mode */
+    DISPLAY = "display",
+    /** In edit mode, user is modifying the value */
+    EDITING = "editing",
+    /** Saving changes to the server */
+    SAVING = "saving",
+    /** Save completed successfully (brief feedback before returning to DISPLAY) */
+    SAVED = "saved",
+    /** Save failed, showing error */
+    ERROR = "error"
+}
+/**
+ * Operation type for controlling field visibility based on operation context.
+ * Uses CoreResourceOperation enum values for type safety.
+ * Used with excludeFromCreate, excludeFromUpdate, and isHidden(operations) decorators.
+ *
+ * Branded with `& {}` to allow custom string values through type assertion
+ * without collapsing the entire union to `string` (which kills autocomplete).
+ */
+export type FormOperationType = CoreResourceOperation.CREATE | CoreResourceOperation.UPDATE | CoreResourceOperation.READ | (string & {});
+/**
+ * Inheritance schema definition for discriminated unions.
+ * Used to track which fields belong to which variants for conditional visibility.
+ *
+ * This is a simplified, non-generic version of ResourceConfiguration_InheritanceSchemaDefinition
+ * from @wildo-ai/saas-models, optimized for frontend use. It is structurally compatible
+ * with the backend type but avoids complex generics that aren't needed for UI rendering.
+ */
+export interface InheritanceSchemaDefinition {
+    /** Field name used for discrimination (e.g., 'type', 'recurringType') */
+    discriminatorField: string;
+    /** Discriminator values that use base schema only (no variant extension) */
+    withoutInheritanceDiscriminatorFieldValues?: string[];
+    /** Variant schemas for each discriminator value */
+    inheritedSchemas?: Array<{
+        /** The discriminator value for this variant */
+        discriminatorFieldValue: string;
+        /** The extended schema for this variant */
+        schema: z.ZodTypeAny;
+        /** Nested inheritance for multi-level discriminated unions */
+        inheritenceSchemaDefinition?: InheritanceSchemaDefinition;
+    }>;
+}
+//# sourceMappingURL=automated-layout.frontend.schemas.d.ts.map

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

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

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

@@ -0,0 +1,30 @@
+import { ValidationMode, } from '@wildo-ai/zod-decorators';
+// =============================================================================
+// VALIDATION CONSTANTS
+// =============================================================================
+/**
+ * Default validation mode for all forms.
+ * Centralized constant for consistent default behavior.
+ */
+export const DEFAULT_VALIDATION_MODE = ValidationMode.ON_BLUR;
+// =============================================================================
+// INLINE EDIT STATE
+// =============================================================================
+/**
+ * State enum for inline field editing.
+ * Represents the different states a field can be in during inline editing.
+ */
+export var InlineEditState;
+(function (InlineEditState) {
+    /** Displaying value, not in edit mode */
+    InlineEditState["DISPLAY"] = "display";
+    /** In edit mode, user is modifying the value */
+    InlineEditState["EDITING"] = "editing";
+    /** Saving changes to the server */
+    InlineEditState["SAVING"] = "saving";
+    /** Save completed successfully (brief feedback before returning to DISPLAY) */
+    InlineEditState["SAVED"] = "saved";
+    /** Save failed, showing error */
+    InlineEditState["ERROR"] = "error";
+})(InlineEditState || (InlineEditState = {}));
+//# sourceMappingURL=automated-layout.frontend.schemas.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"automated-layout.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/automated-layout/automated-layout.frontend.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GACf,MAAM,0BAA0B,CAAC;AAOlC,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,cAAc,CAAC,OAAO,CAAC;AAE9D,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAN,IAAY,eAWX;AAXD,WAAY,eAAe;IACzB,yCAAyC;IACzC,sCAAmB,CAAA;IACnB,gDAAgD;IAChD,sCAAmB,CAAA;IACnB,mCAAmC;IACnC,oCAAiB,CAAA;IACjB,+EAA+E;IAC/E,kCAAe,CAAA;IACf,iCAAiC;IACjC,kCAAe,CAAA;AACjB,CAAC,EAXW,eAAe,KAAf,eAAe,QAW1B"}

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

@@ -0,0 +1,166 @@
+import { z } from 'zod';
+import type { InheritanceSchemaDefinition } from './automated-layout.frontend.schemas.js';
+import { FieldSchemaType, ValidationMode, type ShowWhenParams } from '@wildo-ai/zod-decorators';
+export declare class AutomatedLayoutFrontendUtils {
+    private static buildUnsupportedPlainUnionFileFieldMessage;
+    private static normalizeFileMetadataForComparison;
+    private static areFileMetadataCompatible;
+    private static collectFileFieldMetadata;
+    /**
+     * Fallback: convert a single field key segment from camelCase / snake_case / kebab-case
+     * into sentence case. Used when i18n label resolution is not available or returns no match.
+     *
+     * Handles acronym sequences correctly:
+     * - `HTMLContent` → `HTML Content`
+     * - `APIKey` → `API Key`
+     * - `userId` → `User ID`
+     * - `firstName` → `First Name`
+     * - `created_at` → `Created At`
+     * - `is-active` → `Is Active`
+     *
+     * @param key - A single field key segment (no dots)
+     */
+    static formatFieldLabelFallback(key: string): string;
+    /**
+     * Fallback: format a full dotted field path for display in error messages and breadcrumbs.
+     * Each segment is formatted individually and joined with ` › `.
+     * Array indices (pure numbers) are converted to 1-based display format.
+     * Used when i18n label resolution is not available.
+     *
+     * @example
+     * formatFieldPathFallback('address.streetName') → 'Address › Street Name'
+     * formatFieldPathFallback('items.0.name') → 'Items › [1] › Name'
+     */
+    static formatFieldPathFallback(path: string): string;
+    /**
+     * Normalize runtime field paths to the canonical schema-key form used by
+     * `fileUploadContext`.
+     *
+     * Runtime field scopes include array indices (`attachments[0].file`), but the
+     * schema-level upload contract is keyed by the structural path
+     * (`attachments.file`). Centralizing this normalization keeps nested display
+     * and form consumers aligned without inventing per-index endpoint entries.
+     */
+    static normalizeSchemaFieldPath(path: string): string;
+    /**
+     * Create a field label resolver that tries i18n first, falling back to camelCase conversion.
+     * Returns a function that resolves a dot-path to a human-readable label.
+     *
+     * When `resourceType` is provided, each path segment is resolved via `tResourceFieldEdit`.
+     * If the i18n lookup returns the raw key (not found), falls back to `formatFieldLabelFallback`.
+     * When `resourceType` is not provided, uses `formatFieldPathFallback` directly.
+     *
+     * @param resourceType - The resource type for i18n lookup
+     * @param tResourceFieldEdit - i18n function for field label resolution
+     * @returns A function that resolves a dot-path to a human-readable label
+     */
+    static createFieldLabelResolver(resourceType: string | undefined, tResourceFieldEdit: (resourceType: string, fieldPath: string, key: string) => string): (path: string) => string;
+    /**
+     * Return object variants when a schema is a discriminated union of objects.
+     * Returns an empty array for plain objects or non-object unions.
+     */
+    static getDiscriminatedUnionObjectOptions(schema: z.ZodTypeAny): z.ZodObject<any>[];
+    private static getPlainUnionObjectOptions;
+    /**
+     * Resolve a field-shape view for schemas that are either plain objects or
+     * discriminated unions of objects.
+     *
+     * - `commonOnly: true` keeps only keys present in every union variant. This is
+     *   the safe view for generated root layouts because variant-only fields must
+     *   stay under discriminator switching.
+     * - `commonOnly: false` unions keys across variants and picks the first
+     *   matching schema for each key. This is the permissive view for runtime
+     *   lookups such as wrapper shaping or field schema resolution.
+     */
+    static getObjectLikeFieldShape(schema: z.ZodTypeAny, options?: {
+        commonOnly?: boolean;
+    }): Record<string, z.ZodTypeAny> | undefined;
+    /**
+     * Collect canonical schema paths for every `z_file()` field reachable from the
+     * provided schema.
+     *
+     * The returned paths never include array indices. Array item scopes resolve
+     * those dynamically at render time and then normalize back through
+     * `normalizeSchemaFieldPath()`.
+     */
+    static collectFileFieldPaths(schema: z.ZodTypeAny | undefined, pathPrefix?: string): string[];
+    static resolveFieldSchemaPath(rootSchema: z.ZodTypeAny | undefined, path: string): z.ZodTypeAny | undefined;
+    /**
+     * Get default validation mode based on schema type.
+     *
+     * Different field types have different optimal validation timing:
+     * - Text fields (string, number): onBlur - avoids excessive validation during typing
+     * - Select/toggle fields (enum, boolean): onChange - immediate feedback for single-action inputs
+     * - Date/time fields: onChange - immediate feedback for picker selection
+     * - File fields: onChange - validate immediately after upload completes
+     *
+     * @param schemaType - The FieldSchemaType of the field
+     * @returns Default ValidationMode for this field type
+     */
+    static getDefaultValidationMode(schemaType: FieldSchemaType): ValidationMode;
+    /**
+     * Get a sensible default value for a given Zod schema type.
+     *
+     * Used by form components (FormFieldArray, FormFieldRecord, etc.) when creating
+     * new items/entries and a default value is needed.
+     *
+     * @param schema - The Zod schema to derive a default value from
+     * @returns A default value appropriate for the schema type
+     */
+    static getDefaultValueForSchema(schema: z.ZodTypeAny): unknown;
+    /**
+     * Compute field visibility based on discriminated union configuration.
+     *
+     * For schema families (discriminated unions), variant fields should only be
+     * visible when the discriminator value matches their variant.
+     */
+    static computeFieldVisibility(formSchema: z.ZodTypeAny, fieldName: string, formValues: Record<string, unknown>, inheritanceConfig?: InheritanceSchemaDefinition, options?: {
+        showAllWhenDiscriminatorUndefined?: boolean;
+    }): boolean;
+    private static evaluateShowWhenCondition;
+    /**
+     * Evaluate showWhen conditions for a field.
+     */
+    static evaluateShowWhen(showWhenParams: ShowWhenParams, formValues: Record<string, unknown>): boolean;
+    /**
+     * Get showWhen parameters from a field schema.
+     */
+    static getFieldShowWhenParams(fieldSchema: z.ZodTypeAny): ShowWhenParams | undefined;
+    /**
+     * Get the field names that a showWhen configuration depends on.
+     */
+    static getShowWhenWatchFields(showWhenParams: ShowWhenParams): string[];
+    /**
+     * Get fields that ONLY exist in variant schemas (not in base schema).
+     */
+    private static getVariantOnlyFields;
+    /**
+     * Detect if a schema has inheritance configuration by looking for discriminator fields.
+     */
+    static detectDiscriminatorConfig(formSchema: z.ZodTypeAny): {
+        discriminatorField: string;
+        baseValues: string[];
+    } | null;
+    /**
+     * Get list of visible field names based on current form values.
+     */
+    static getVisibleFieldNames(formSchema: z.ZodTypeAny, formValues: Record<string, unknown>, inheritanceConfig?: InheritanceSchemaDefinition): string[];
+    /**
+     * Filter form data to only include visible fields.
+     */
+    static filterVisibleFormData<T extends Record<string, unknown>>(formData: T, formSchema: z.ZodTypeAny, inheritanceConfig?: InheritanceSchemaDefinition): Partial<T>;
+    /**
+     * Get field names to exclude from validation.
+     */
+    static getHiddenFieldNames(formSchema: z.ZodTypeAny, formValues: Record<string, unknown>, inheritanceConfig?: InheritanceSchemaDefinition): string[];
+    /**
+     * Compute if a field should display the required indicator.
+     * A field shows as required when it is not optional in the schema AND currently visible.
+     */
+    static isFieldEffectivelyRequired(fieldSchema: z.ZodTypeAny, fieldName: string, formSchema: z.ZodTypeAny, formValues: Record<string, unknown>, inheritanceConfig?: InheritanceSchemaDefinition): boolean;
+    /**
+     * Get required state for all fields in a schema.
+     */
+    static computeAllRequiredStates(formSchema: z.ZodTypeAny, formValues: Record<string, unknown>, inheritanceConfig?: InheritanceSchemaDefinition): Record<string, boolean>;
+}
+//# sourceMappingURL=automated-layout.frontend.utils.d.ts.map

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

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