@wildo-ai/saas-frontend-lib 1.0.1

package/dist/esm/components/flows-actors/task-detail.js

@@ -0,0 +1,83 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "../../components/sections/card.js";
+import { Badge } from "../../components/data-display/badge.js";
+import { ScrollArea } from "../../components/layout/scroll-area.js";
+import { Collapsible, CollapsibleContent, CollapsibleTrigger } from "../../components/sections/collapsible.js";
+import { Button, ButtonVariants_Variant } from "../../components/actions/button.js";
+import { ButtonSize } from "@wildo-ai/presets-components-models";
+import { useI18n } from "@wildo-ai/saas-frontend-lib";
+import { cn } from "../../core/ui/cn.js";
+import { FrontendComponentType } from "@wildo-ai/presets-components-models";
+import { AI_FlowNodeStatusBadge } from "./flow-node.js";
+import { FlowsActorsUIUtils } from "./flows-actors-ui.utils.js";
+//===============================================================
+//  Helpers
+//===============================================================
+const CT = FrontendComponentType.LOW_LEVEL_AI_TASK_DETAIL;
+function formatRelationship(rel) {
+    const parts = [rel.relation, rel.kind];
+    if (rel.kind === "actor.task")
+        parts.push(rel.taskId);
+    else if (rel.kind === "actor.plan.step")
+        parts.push(rel.planStepId);
+    else if (rel.kind === "actor")
+        parts.push(rel.actorId);
+    else if (rel.kind === "flow")
+        parts.push(rel.flowId);
+    else if (rel.kind === "flow.step")
+        parts.push(rel.stepId);
+    return parts.join(" → ");
+}
+export const AI_TaskDetail = ({ task, className, ...props }) => {
+    const { tComponent, isReady } = useI18n({ component: CT });
+    const hasContext = Object.keys(task.context).length > 0;
+    const hasRelationships = task.relationships.length > 0;
+    const hasArtifacts = task.artifacts && task.artifacts.length > 0;
+    return (_jsxs(Card, { className: cn("flex flex-col", className), ...props, children: [_jsxs(CardHeader, { children: [_jsxs("div", { className: "flex flex-wrap items-center gap-element", children: [_jsx(Badge, { variant: "outline", className: "text-2xs", children: task.topic }), _jsx(AI_FlowNodeStatusBadge, { status: task.status }), _jsxs("span", { className: "text-2xs text-muted-foreground", children: [tComponent(CT, "actor"), ": ", task.actors.actorRef] })] }), _jsx(CardTitle, { className: "text-sm", children: task.title }), _jsx(CardDescription, { className: "text-xs", children: task.description })] }), _jsxs(CardContent, { className: "flex flex-col gap-card-sm", children: [task.input !== undefined && (_jsx(CollapsibleSection, { label: tComponent(CT, "input"), children: _jsx("pre", { className: "max-h-32 overflow-auto rounded-md bg-muted p-2 text-2xs", children: typeof task.input === "string" ? task.input : JSON.stringify(task.input, null, 2) }) })), task.output !== undefined && (_jsx(CollapsibleSection, { label: tComponent(CT, "output"), children: _jsx("pre", { className: "max-h-32 overflow-auto rounded-md bg-muted p-2 text-2xs", children: typeof task.output === "string" ? task.output : JSON.stringify(task.output, null, 2) }) })), _jsx(CollapsibleSection, { label: tComponent(CT, "context"), children: hasContext ? (_jsx("pre", { className: "max-h-24 overflow-auto rounded-md bg-muted p-2 text-2xs", children: JSON.stringify(task.context, null, 2) })) : (_jsx("span", { className: "text-2xs text-muted-foreground italic", children: tComponent(CT, "contextEmpty") })) }), hasRelationships && (_jsx(CollapsibleSection, { label: tComponent(CT, "relationships"), children: _jsx("div", { className: "flex flex-col gap-0.5", children: task.relationships.map((rel, i) => (_jsxs("div", { className: "flex items-center gap-element text-2xs", children: [_jsx(Badge, { variant: "outline", className: "text-2xs shrink-0", children: rel.relation }), _jsx(Badge, { variant: "secondary", className: "text-2xs shrink-0", children: rel.kind }), _jsx("span", { className: "text-muted-foreground truncate", children: formatRelationship(rel) })] }, i))) }) })), hasArtifacts && (_jsx(CollapsibleSection, { label: tComponent(CT, "artifacts"), children: _jsx("div", { className: "flex flex-col gap-0.5", children: task.artifacts.map((artifact, i) => (_jsxs("div", { className: "flex items-center gap-element text-2xs", children: [_jsx(Badge, { variant: "outline", className: "text-2xs", children: artifact.type }), _jsx("span", { className: "text-muted-foreground", children: artifact.name })] }, i))) }) })), task.actorStates.length > 0 && (_jsx(AI_TaskTimeline, { events: task.actorStates.flatMap((as) => as.statusChanges.map((sc) => ({
+                            status: sc.status,
+                            timestamp: sc.timestamp,
+                            actorRef: as.actorRef,
+                        }))) })), (task.startedAt || task.completedAt) && (_jsxs("div", { className: "flex gap-card text-2xs text-muted-foreground", children: [task.startedAt && (_jsxs("span", { children: [tComponent(CT, "started"), ": ", FlowsActorsUIUtils.formatTimestampFull(task.startedAt)] })), task.completedAt && (_jsxs("span", { children: [tComponent(CT, "completed"), ": ", FlowsActorsUIUtils.formatTimestampFull(task.completedAt)] })), task.startedAt && (_jsxs("span", { className: "font-mono", children: ["(", FlowsActorsUIUtils.formatDuration(task.startedAt, task.completedAt), ")"] }))] }))] })] }));
+};
+//===============================================================
+//  CollapsibleSection (internal helper)
+//===============================================================
+function CollapsibleSection({ label, children, defaultOpen = false, }) {
+    return (_jsxs(Collapsible, { defaultOpen: defaultOpen, children: [_jsx(CollapsibleTrigger, { asChild: true, children: _jsx(Button, { type: "button", variant: ButtonVariants_Variant.GHOST, size: ButtonSize.SM, className: "h-auto justify-start p-0 text-xs font-medium", children: label }) }), _jsx(CollapsibleContent, { className: "mt-1", children: children })] }));
+}
+export const AI_TaskList = ({ tasks, className, ...props }) => {
+    const { tComponent, isReady } = useI18n({ component: CT });
+    const [statusFilter, setStatusFilter] = React.useState(null);
+    const [topicFilter, setTopicFilter] = React.useState(null);
+    const [sortField, setSortField] = React.useState("createdAt");
+    const uniqueStatuses = React.useMemo(() => [...new Set(tasks.map((t) => t.status))], [tasks]);
+    const uniqueTopics = React.useMemo(() => [...new Set(tasks.map((t) => t.topic))], [tasks]);
+    const filtered = React.useMemo(() => {
+        let result = tasks;
+        if (statusFilter)
+            result = result.filter((t) => t.status === statusFilter);
+        if (topicFilter)
+            result = result.filter((t) => t.topic === topicFilter);
+        return [...result].sort((a, b) => {
+            if (sortField === "createdAt") {
+                return new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime();
+            }
+            return a.status.localeCompare(b.status);
+        });
+    }, [tasks, statusFilter, topicFilter, sortField]);
+    return (_jsxs("div", { className: cn("flex flex-col gap-card", className), ...props, children: [_jsxs("div", { className: "flex flex-wrap items-center gap-element", children: [_jsxs("div", { className: "flex items-center gap-1", children: [_jsxs("span", { className: "text-2xs text-muted-foreground", children: [tComponent(CT, "filterByStatus"), ":"] }), _jsx(Button, { type: "button", variant: statusFilter === null ? ButtonVariants_Variant.SECONDARY : ButtonVariants_Variant.GHOST, size: ButtonSize.SM, className: "h-6 text-2xs", onClick: () => setStatusFilter(null), children: tComponent(CT, "filterAll") }), uniqueStatuses.map((s) => (_jsx(Button, { type: "button", variant: statusFilter === s ? ButtonVariants_Variant.SECONDARY : ButtonVariants_Variant.GHOST, size: ButtonSize.SM, className: "h-6 text-2xs", onClick: () => setStatusFilter(s === statusFilter ? null : s), children: s }, s)))] }), _jsxs("div", { className: "flex items-center gap-1", children: [_jsxs("span", { className: "text-2xs text-muted-foreground", children: [tComponent(CT, "filterByTopic"), ":"] }), _jsx(Button, { type: "button", variant: topicFilter === null ? ButtonVariants_Variant.SECONDARY : ButtonVariants_Variant.GHOST, size: ButtonSize.SM, className: "h-6 text-2xs", onClick: () => setTopicFilter(null), children: tComponent(CT, "filterAll") }), uniqueTopics.map((t) => (_jsx(Button, { type: "button", variant: topicFilter === t ? ButtonVariants_Variant.SECONDARY : ButtonVariants_Variant.GHOST, size: ButtonSize.SM, className: "h-6 text-2xs", onClick: () => setTopicFilter(t === topicFilter ? null : t), children: t }, t)))] }), _jsxs("div", { className: "flex items-center gap-1", children: [_jsxs("span", { className: "text-2xs text-muted-foreground", children: [tComponent(CT, "sortBy"), ":"] }), _jsx(Button, { type: "button", variant: sortField === "createdAt" ? ButtonVariants_Variant.SECONDARY : ButtonVariants_Variant.GHOST, size: ButtonSize.SM, className: "h-6 text-2xs", onClick: () => setSortField("createdAt"), children: tComponent(CT, "sortDate") }), _jsx(Button, { type: "button", variant: sortField === "status" ? ButtonVariants_Variant.SECONDARY : ButtonVariants_Variant.GHOST, size: ButtonSize.SM, className: "h-6 text-2xs", onClick: () => setSortField("status"), children: tComponent(CT, "sortStatus") })] })] }), _jsx(ScrollArea, { className: "max-h-[32rem]", children: _jsxs("div", { className: "flex flex-col gap-card", children: [filtered.length === 0 && (_jsx("p", { className: "text-sm text-muted-foreground italic", children: tComponent(CT, "noTasks") })), filtered.map((task) => (_jsx(AI_TaskDetail, { task: task }, task._id)))] }) })] }));
+};
+export const AI_TaskTimeline = ({ events, className, ...props }) => {
+    const { tComponent, isReady } = useI18n({ component: CT });
+    const sorted = React.useMemo(() => [...events].sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime()), [events]);
+    return (_jsxs("div", { className: cn("flex flex-col gap-1", className), ...props, children: [_jsx("span", { className: "text-xs font-medium", children: tComponent(CT, "timeline") }), _jsx(ScrollArea, { className: "max-h-40", children: _jsx("ol", { className: "relative border-s border-border ms-3 space-y-1.5", children: sorted.map((event, i) => {
+                        const color = FlowsActorsUIUtils.STATUS_COLOR[event.status] ?? "bg-muted-foreground";
+                        const delta = i > 0
+                            ? FlowsActorsUIUtils.formatDuration(sorted[i - 1].timestamp, event.timestamp)
+                            : undefined;
+                        return (_jsxs("li", { className: "ms-4", children: [_jsx("div", { className: cn("absolute -start-1.5 mt-1.5 size-3 rounded-full", color) }), _jsxs("div", { className: "flex items-center gap-element", children: [_jsx(AI_FlowNodeStatusBadge, { status: event.status }), event.actorRef && (_jsx("span", { className: "text-2xs text-muted-foreground", children: event.actorRef })), delta && (_jsxs("span", { className: "text-2xs text-muted-foreground", children: ["+", delta] }))] }), _jsx("time", { className: "text-2xs text-muted-foreground", children: new Date(event.timestamp).toLocaleTimeString() })] }, `${event.status}-${event.timestamp}-${i}`));
+                    }) }) })] }));
+};
+//# sourceMappingURL=task-detail.js.map

package/dist/esm/components/flows-actors/task-detail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-detail.js","sourceRoot":"","sources":["../../../../src/components/flows-actors/task-detail.tsx"],"names":[],"mappings":"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"}

package/dist/esm/components/flows-actors/task-memory.d.ts

@@ -0,0 +1,20 @@
+import * as React from "react";
+import { Collapsible } from "../../components/sections/collapsible.js";
+import type { ComponentProps } from "react";
+import type { Actors_Memory_Context, Actors_Memory_Store, Actors_Memory_Entry } from "@wildo-ai/saas-models";
+export type AI_TaskMemoryProps = ComponentProps<"div"> & {
+    memory: Actors_Memory_Context;
+};
+export declare const AI_TaskMemory: ({ memory, className, ...props }: AI_TaskMemoryProps) => React.JSX.Element;
+export type AI_TaskMemoryScopeProps = ComponentProps<typeof Collapsible> & {
+    scope: string;
+    label: string;
+    store: Actors_Memory_Store;
+    defaultOpen?: boolean;
+};
+export declare const AI_TaskMemoryScope: ({ scope, label, store, defaultOpen, className, ...props }: AI_TaskMemoryScopeProps) => React.JSX.Element;
+export type AI_TaskMemoryEntryItemProps = ComponentProps<"div"> & {
+    entry: Actors_Memory_Entry;
+};
+export declare const AI_TaskMemoryEntryItem: ({ entry, className, ...props }: AI_TaskMemoryEntryItemProps) => React.JSX.Element;
+//# sourceMappingURL=task-memory.d.ts.map

package/dist/esm/components/flows-actors/task-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-memory.d.ts","sourceRoot":"","sources":["../../../../src/components/flows-actors/task-memory.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAAE,WAAW,EAA0C,MAAM,qDAAqD,CAAC;AAK1H,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAkB/B,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG;IACvD,MAAM,EAAE,qBAAqB,CAAC;CAC/B,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,iCAI3B,kBAAkB,KAAG,KAAK,CAAC,GAAG,CAAC,OAkCjC,CAAC;AAMF,MAAM,MAAM,uBAAuB,GAAG,cAAc,CAAC,OAAO,WAAW,CAAC,GAAG;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,mBAAmB,CAAC;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,2DAOhC,uBAAuB,KAAG,KAAK,CAAC,GAAG,CAAC,OAoCtC,CAAC;AAMF,MAAM,MAAM,2BAA2B,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG;IAChE,KAAK,EAAE,mBAAmB,CAAC;CAC5B,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,gCAIpC,2BAA2B,KAAG,KAAK,CAAC,GAAG,CAAC,OA8C1C,CAAC"}

package/dist/esm/components/flows-actors/task-memory.js

@@ -0,0 +1,36 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Badge } from "../../components/data-display/badge.js";
+import { ScrollArea } from "../../components/layout/scroll-area.js";
+import { Collapsible, CollapsibleContent, CollapsibleTrigger } from "../../components/sections/collapsible.js";
+import { Button, ButtonVariants_Variant } from "../../components/actions/button.js";
+import { useI18n } from "@wildo-ai/saas-frontend-lib";
+import { cn } from "../../core/ui/cn.js";
+import { FrontendComponentType } from "@wildo-ai/presets-components-models";
+//===============================================================
+//  Constants
+//===============================================================
+const CT = FrontendComponentType.LOW_LEVEL_AI_TASK_MEMORY;
+const SCOPE_ICONS = {
+    short_term: "⚡",
+    long_term: "📦",
+    working: "🔧",
+};
+export const AI_TaskMemory = ({ memory, className, ...props }) => {
+    const { tComponent, isReady } = useI18n({ component: CT });
+    const totalEntries = memory.shortTerm.entries.length +
+        memory.longTerm.entries.length +
+        memory.working.entries.length;
+    return (_jsxs("div", { className: cn("flex flex-col gap-card", className), ...props, children: [_jsxs("div", { className: "flex items-center gap-element", children: [_jsx("h4", { className: "text-sm font-semibold", children: tComponent(CT, "title") }), _jsx(Badge, { variant: "secondary", className: "text-2xs", children: totalEntries })] }), _jsx(AI_TaskMemoryScope, { scope: "short_term", label: tComponent(CT, "shortTerm"), store: memory.shortTerm, defaultOpen: true }), _jsx(AI_TaskMemoryScope, { scope: "long_term", label: tComponent(CT, "longTerm"), store: memory.longTerm }), _jsx(AI_TaskMemoryScope, { scope: "working", label: tComponent(CT, "working"), store: memory.working })] }));
+};
+export const AI_TaskMemoryScope = ({ scope, label, store, defaultOpen = false, className, ...props }) => {
+    const { tComponent, isReady } = useI18n({ component: CT });
+    const icon = SCOPE_ICONS[scope] ?? "📋";
+    return (_jsxs(Collapsible, { defaultOpen: defaultOpen, className: cn("rounded-md border", className), ...props, children: [_jsx(CollapsibleTrigger, { asChild: true, children: _jsxs(Button, { type: "button", variant: ButtonVariants_Variant.GHOST, className: "w-full justify-between p-card-sm", children: [_jsxs("span", { className: "flex items-center gap-element text-xs font-medium", children: [_jsx("span", { children: icon }), label, store.maxSize != null && (_jsxs("span", { className: "text-2xs text-muted-foreground", children: ["(", store.entries.length, "/", store.maxSize, ")"] }))] }), _jsx(Badge, { variant: "secondary", className: "text-2xs", children: store.entries.length })] }) }), _jsx(CollapsibleContent, { children: _jsx(ScrollArea, { className: "max-h-48", children: _jsxs("div", { className: "flex flex-col gap-1 p-card-sm pt-0", children: [store.entries.map((entry) => (_jsx(AI_TaskMemoryEntryItem, { entry: entry }, entry.key))), store.entries.length === 0 && (_jsx("span", { className: "text-2xs text-muted-foreground italic", children: tComponent(CT, "scopeEmpty") }))] }) }) })] }));
+};
+export const AI_TaskMemoryEntryItem = ({ entry, className, ...props }) => {
+    const { tComponent, isReady } = useI18n({ component: CT });
+    const isExpired = entry.expiresAt ? new Date(entry.expiresAt).getTime() < Date.now() : false;
+    return (_jsxs("div", { className: cn("flex flex-col gap-0.5 rounded-sm bg-muted p-1.5", isExpired && "opacity-[var(--opacity-muted)]", className), ...props, children: [_jsxs("div", { className: "flex items-center gap-element", children: [_jsx("span", { className: "text-2xs font-medium", children: entry.key }), _jsx(Badge, { variant: "outline", className: "text-2xs", children: entry.type }), isExpired && (_jsx(Badge, { variant: "destructive", className: "text-2xs", children: tComponent(CT, "expired") })), entry.expiresAt && !isExpired && (_jsxs("span", { className: "text-2xs text-muted-foreground", children: [tComponent(CT, "expires"), ": ", new Date(entry.expiresAt).toLocaleTimeString()] }))] }), _jsx("pre", { className: "max-h-16 overflow-auto text-2xs text-muted-foreground", children: typeof entry.value === "string" ? entry.value : JSON.stringify(entry.value, null, 2) }), entry.metadata && Object.keys(entry.metadata).length > 0 && (_jsxs("div", { className: "mt-0.5 flex flex-wrap gap-1", children: [_jsxs("span", { className: "text-2xs text-muted-foreground/70", children: [tComponent(CT, "metadata"), ":"] }), Object.entries(entry.metadata).map(([k, v]) => (_jsxs(Badge, { variant: "outline", className: "text-2xs", children: [k, ": ", String(v)] }, k)))] })), _jsx("time", { className: "text-2xs text-muted-foreground/60", children: new Date(entry.timestamp).toLocaleTimeString() })] }));
+};
+//# sourceMappingURL=task-memory.js.map

package/dist/esm/components/flows-actors/task-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-memory.js","sourceRoot":"","sources":["../../../../src/components/flows-actors/task-memory.tsx"],"names":[],"mappings":"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"}

package/dist/esm/components/form/Form.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Form Component
+ *
+ * Schema-driven form wrapper that uses react-hook-form with standardSchemaResolver.
+ * Provides FormProvider context for child fields.
+ *
+ * Note: Uses standardSchemaResolver (not zodResolver) for Zod 4 compatibility.
+ * Zod 4 implements the Standard Schema interface which is supported by this resolver.
+ * Requires @hookform/resolvers >= 5.0.0
+ */
+import React from 'react';
+import { z } from 'zod';
+import { FieldErrors, UseFormReturn, DefaultValues } from 'react-hook-form';
+import { type ValidationMode } from './form-field-types.js';
+import type { NavigationZone } from '../../core/navigation/navigation.schemas.js';
+/**
+ * Form methods interface for external access.
+ * Curated subset of RHF's UseFormReturn — exposes what callers actually need
+ * without leaking the full RHF API.
+ */
+export interface FormMethods {
+    /** Set an error on a specific field */
+    setError: (name: string, error: {
+        type: string;
+        message: string;
+    }) => void;
+    /** Clear error on a specific field or all errors */
+    clearErrors: (name?: string | string[]) => void;
+    /** Watch form values for changes */
+    watch: UseFormReturn<any>['watch'];
+    /** Reset form to default values or provided values */
+    reset: UseFormReturn<any>['reset'];
+    /** Get current form values (all fields or a specific field) */
+    getValues: UseFormReturn<any>['getValues'];
+    /** Set a specific field value programmatically */
+    setValue: UseFormReturn<any>['setValue'];
+    /** Trigger validation for specific fields or the entire form */
+    trigger: UseFormReturn<any>['trigger'];
+    /** Submit the form programmatically (e.g., from an external button) */
+    handleSubmit: UseFormReturn<any>['handleSubmit'];
+    /** Reactive form state (isDirty, isSubmitting, isValid, errors, etc.) */
+    formState: UseFormReturn<any>['formState'];
+    /** Get field state (isDirty, isTouched, invalid, error) for a specific field */
+    getFieldState: UseFormReturn<any>['getFieldState'];
+}
+export interface FormProps<TSchema extends z.ZodTypeAny> {
+    /** The main schema (used for context and type inference) */
+    schema: TSchema;
+    /**
+     * Optional prepared schema for validation.
+     * When provided, this schema is used for RHF validation instead of the main schema.
+     * Use prepareFormSchema() to create this from the main schema.
+     */
+    validationSchema?: z.ZodTypeAny;
+    defaultValues?: DefaultValues<z.infer<TSchema>>;
+    onSubmit: (data: z.infer<TSchema>) => void | Promise<void>;
+    onError?: (errors: FieldErrors<z.infer<TSchema>>) => void;
+    validationMode?: ValidationMode;
+    children: React.ReactNode;
+    className?: string;
+    disabled?: boolean;
+    id?: string;
+    /** Resource type for i18n field label lookup (used by FormErrorSummary) */
+    resourceType?: string;
+    /**
+     * Callback invoked with form methods when the form is ready.
+     * Use this to get access to setError/clearErrors for setting server-side validation errors.
+     */
+    onFormReady?: (formMethods: FormMethods) => void;
+    /**
+     * When true, shows a browser confirmation dialog when the user tries to leave
+     * the page (tab close, refresh) while the form has unsaved changes (isDirty).
+     * @default false
+     */
+    warnOnUnsavedChanges?: boolean;
+    /** Base URL for validate-field endpoint (enables uniqueness pre-validation on blur) */
+    validateFieldUrl?: string;
+    /** Resource ID for UPDATE operations (used as excludeId in uniqueness checks) */
+    resourceId?: string;
+    /** Current operation type for operation-aware decorators (e.g., isNotEditable) */
+    operationType?: string;
+    /** Resource context identifiers for FK context propagation to nested field components */
+    contextResourceIdentifiers?: Record<string, string | {
+        fieldIdentifier: string;
+        resourceId: string;
+    }>;
+    /** Current navigation zone for quick-create-aware field controls */
+    navigationZone?: NavigationZone;
+}
+declare function FormComponent<TSchema extends z.ZodTypeAny>({ schema, validationSchema, defaultValues, onSubmit, onError, validationMode, children, className, disabled, id, resourceType, onFormReady, warnOnUnsavedChanges, validateFieldUrl, resourceId, operationType, contextResourceIdentifiers, navigationZone, }: FormProps<TSchema>): React.JSX.Element;
+declare namespace FormComponent {
+    var displayName: string;
+}
+export declare const Form: typeof FormComponent & {
+    displayName: string;
+};
+export {};
+//# sourceMappingURL=Form.d.ts.map

package/dist/esm/components/form/Form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Form.d.ts","sourceRoot":"","sources":["../../../../src/components/form/Form.tsx"],"names":[],"mappings":"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"}

package/dist/esm/components/form/Form.js

@@ -0,0 +1,72 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Form Component
+ *
+ * Schema-driven form wrapper that uses react-hook-form with standardSchemaResolver.
+ * Provides FormProvider context for child fields.
+ *
+ * Note: Uses standardSchemaResolver (not zodResolver) for Zod 4 compatibility.
+ * Zod 4 implements the Standard Schema interface which is supported by this resolver.
+ * Requires @hookform/resolvers >= 5.0.0
+ */
+import { useEffect } from 'react';
+import { useForm } from 'react-hook-form';
+import { standardSchemaResolver } from '@hookform/resolvers/standard-schema';
+import { cn } from '../../core/ui/cn.js';
+import { FormSchemaProvider } from './form-context.js';
+import { FieldSet } from './chromes/field.js';
+import { DEFAULT_VALIDATION_MODE } from '../../core/automated-layout/automated-layout.frontend.schemas.js';
+function FormComponent({ schema, validationSchema, defaultValues, onSubmit, onError, validationMode, children, className, disabled, id, resourceType, onFormReady, warnOnUnsavedChanges = false, validateFieldUrl, resourceId, operationType, contextResourceIdentifiers, navigationZone, }) {
+    // Use centralized DEFAULT_VALIDATION_MODE constant
+    const rhfMode = validationMode ?? DEFAULT_VALIDATION_MODE;
+    // Use prepared validation schema if provided, otherwise use main schema
+    const schemaForValidation = validationSchema ?? schema;
+    const form = useForm({
+        // Cast required for Zod 4 + TypeScript compatibility with Standard Schema interface
+        resolver: standardSchemaResolver(schemaForValidation),
+        defaultValues: defaultValues,
+        mode: rhfMode,
+        disabled,
+    });
+    // Dirty guard: warn user before leaving page with unsaved changes
+    useEffect(() => {
+        if (!warnOnUnsavedChanges)
+            return;
+        const handleBeforeUnload = (e) => {
+            if (form.formState.isDirty) {
+                e.preventDefault();
+            }
+        };
+        window.addEventListener('beforeunload', handleBeforeUnload);
+        return () => window.removeEventListener('beforeunload', handleBeforeUnload);
+    }, [warnOnUnsavedChanges, form.formState.isDirty]);
+    // Notify parent when form is ready with form methods.
+    // `form` is a stable reference (useForm returns the same object across renders),
+    // so this effect only meaningfully re-runs when `onFormReady` changes.
+    useEffect(() => {
+        if (onFormReady) {
+            onFormReady({
+                setError: (name, error) => form.setError(name, error),
+                clearErrors: (name) => form.clearErrors(name),
+                watch: form.watch,
+                reset: form.reset,
+                getValues: form.getValues,
+                setValue: form.setValue,
+                trigger: form.trigger,
+                handleSubmit: form.handleSubmit,
+                formState: form.formState,
+                getFieldState: form.getFieldState,
+            });
+        }
+    }, [onFormReady, form]);
+    const handleSubmit = form.handleSubmit(async (data) => {
+        await onSubmit(data);
+    }, (errors) => {
+        onError?.(errors);
+    });
+    return (_jsx(FormSchemaProvider, { schema: schema, form: form, resourceType: resourceType, validationMode: validationMode, validateFieldUrl: validateFieldUrl, resourceId: resourceId, operationType: operationType, contextResourceIdentifiers: contextResourceIdentifiers, navigationZone: navigationZone, children: _jsx("form", { id: id, onSubmit: handleSubmit, className: cn('space-y-field', className), noValidate // Let react-hook-form handle validation
+            : true, "data-testid": "form", children: _jsx(FieldSet, { disabled: disabled, className: "contents", children: children }) }) }));
+}
+FormComponent.displayName = 'Form';
+export const Form = FormComponent;
+//# sourceMappingURL=Form.js.map

package/dist/esm/components/form/Form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Form.js","sourceRoot":"","sources":["../../../../src/components/form/Form.tsx"],"names":[],"mappings":"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"}

package/dist/esm/components/form/automated/AutomatedForm.d.ts

@@ -0,0 +1,144 @@
+/**
+ * AutomatedForm Component
+ *
+ * Schema-driven form that renders a mandatory layout template inside infrastructure
+ * wrappers (RHF FormProvider, FormTemplateContext, FormChromeProvider).
+ *
+ * The template controls field order, section structure, wizard steps, and grid layout.
+ * All infrastructure (validation, submission, unsaved-changes guard) stays outside.
+ *
+ * `layoutTemplate` is required — callers must either provide an explicit template
+ * or use `generateDefaultFormTemplate()` to produce one from the schema and config.
+ */
+import React from 'react';
+import { z } from 'zod';
+import type { FieldErrors, DefaultValues } from 'react-hook-form';
+import { type AutomatedFormLabels, type ResponsiveChromeMode } from '@wildo-ai/presets-components-models';
+import { type FormMethods } from '../../../components/form/Form.js';
+import type { ValidationMode } from '../form-field-types.js';
+import type { FileFieldEndpoints } from '@wildo-ai/zod-decorators';
+import type { FormOperationType, InheritanceSchemaDefinition } from '../../../core/automated-layout/automated-layout.frontend.schemas.js';
+import type { LayoutRefManifest } from '../../../core/resources/resources.frontend.schemas.js';
+import type { NavigationZone } from '../../../core/navigation/navigation.schemas.js';
+export interface AutomatedFormProps<TSchema extends z.ZodTypeAny> {
+    schema: TSchema;
+    defaultValues?: DefaultValues<z.infer<TSchema>>;
+    onSubmit: (data: z.infer<TSchema>) => void | Promise<void>;
+    onError?: (errors: FieldErrors<z.infer<TSchema>>) => void;
+    validationMode?: ValidationMode;
+    className?: string;
+    disabled?: boolean;
+    /**
+     * Makes all form fields read-only (values are submitted but not editable).
+     * Individual fields can also be made read-only via the isNotEditable() schema decorator.
+     * Unlike disabled, read-only field values are included in submission.
+     */
+    readOnly?: boolean;
+    id?: string;
+    /**
+     * When true, shows a browser confirmation dialog when the user tries to leave
+     * the page (tab close, refresh, back button) while the form has unsaved changes.
+     * Uses the browser's native `beforeunload` event.
+     * @default false
+     */
+    warnOnUnsavedChanges?: boolean;
+    /**
+     * Unified labels interface for all form text.
+     * Supports explicit overrides and i18n resolution via resourceContext.
+     */
+    labels?: AutomatedFormLabels;
+    /**
+     * Specific operation identifier for operation-level field visibility rules.
+     * Used with isHidden({ operations: ['ARCHIVE'] }) decorator to control
+     * which fields appear for specific operations (beyond just create/update type).
+     */
+    operationRef?: string;
+    /**
+     * Operation type for decorator-based field filtering.
+     * Controls excludeFromCreate, excludeFromUpdate, and isHidden(operations) behavior.
+     */
+    operationType?: FormOperationType;
+    /**
+     * Operation-like type for custom operations that behave like core operations.
+     * When specified, takes precedence over operationType for excludeFromCreate/excludeFromUpdate checks.
+     */
+    operationLike?: FormOperationType;
+    /**
+     * Structural ref manifest from `layout.refs`. Provides the list of
+     * section, wizard step, and group names for i18n label resolution.
+     */
+    layoutRefs?: LayoutRefManifest;
+    /** File upload context for resource-integrated file fields */
+    fileUploadContext?: Record<string, FileFieldEndpoints>;
+    /**
+     * Context-provided field values that should be hidden from the form but auto-populated on submit.
+     * Key: field name, Value: value to inject on submit.
+     * These fields are automatically excluded from rendering and merged into form data on submission.
+     */
+    contextFieldValues?: Record<string, unknown>;
+    /**
+     * Additional field names hidden by an upstream preparation layer before the
+     * generated form tree reaches `FormField`.
+     *
+     * `AutomatedForm` treats this as an opaque infrastructure input and only
+     * applies generic submit/draft pruning. Resource-aware derivation (for
+     * example relationship-backed DTO slots) belongs in `ResourceAutomatedForm`
+     * or another wrapper that understands the caller's domain semantics.
+     */
+    hiddenFieldNames?: string[];
+    /**
+     * Generated-form replacements keyed by top-level field name.
+     *
+     * Like `hiddenFieldNames`, this is an upstream resolved input. The generic
+     * form infrastructure mounts the overrides but does not decide when a
+     * resource-specific replacement should exist.
+     */
+    generatedFieldOverrides?: Record<string, React.ReactNode>;
+    inheritanceConfig?: InheritanceSchemaDefinition;
+    /**
+     * Default chrome mode for all fields in the form (lowest priority in cascade).
+     * Overridden by section-level chromeMode and field-level decorator chromeMode.
+     * Supports responsive per-breakpoint mapping.
+     */
+    chromeMode?: ResponsiveChromeMode;
+    /**
+     * Callback for saving individual sections (partial updates).
+     * Called when a saveable section's save button is clicked and validation passes.
+     */
+    onSectionSave?: (sectionRef: string, fieldNames: string[], data: Record<string, unknown>) => void | Promise<void>;
+    /**
+     * Callback invoked with form methods when the form is ready.
+     * Use this to get access to setError/clearErrors for setting server-side validation errors.
+     */
+    onFormReady?: (formMethods: FormMethods) => void;
+    /** Base URL for validate-field endpoint (enables uniqueness pre-validation on blur) */
+    validateFieldUrl?: string;
+    /** Resource ID for UPDATE operations (used as excludeId in uniqueness checks) */
+    resourceId?: string;
+    /** Resource context identifiers for FK context propagation to nested field components */
+    contextResourceIdentifiers?: Record<string, string | {
+        fieldIdentifier: string;
+        resourceId: string;
+    }>;
+    /** Current navigation zone for quick-create-aware field controls */
+    navigationZone?: NavigationZone;
+    /**
+     * Layout template component rendered inside the form infrastructure wrappers.
+     * The template is a `React.ComponentType` with access to `useFormTemplateContext()`
+     * for resolved labels, schema, and operation context.
+     *
+     * All skeleton components (`<FormLayout>`, `<Section>`, `<FormField>`, `<WizardLayout>`,
+     * `<WizardStep>`, `<DiscriminatorSwitch>`, etc.) are available inside the template.
+     *
+     * When not provided by callers, `ResourceAutomatedForm` generates one via
+     * `generateDefaultFormTemplate()` based on the schema and config.
+     */
+    layoutTemplate: React.ComponentType;
+}
+declare function AutomatedFormComponent<TSchema extends z.ZodTypeAny>({ schema, defaultValues, onSubmit, onError, validationMode, className, disabled, readOnly, id, warnOnUnsavedChanges, labels, operationRef, operationType, operationLike, layoutRefs, fileUploadContext, contextFieldValues, hiddenFieldNames, generatedFieldOverrides, inheritanceConfig, chromeMode, onSectionSave, onFormReady, validateFieldUrl, resourceId, contextResourceIdentifiers, navigationZone, layoutTemplate: LayoutTemplate, }: AutomatedFormProps<TSchema>): React.JSX.Element;
+declare namespace AutomatedFormComponent {
+    var displayName: string;
+}
+export declare const AutomatedForm: typeof AutomatedFormComponent;
+export {};
+//# sourceMappingURL=AutomatedForm.d.ts.map

package/dist/esm/components/form/automated/AutomatedForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutomatedForm.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/automated/AutomatedForm.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAkB,MAAM,OAAO,CAAC;AACvC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAElE,OAAO,EACL,KAAK,mBAAmB,EAExB,KAAK,oBAAoB,EAE1B,MAAM,qCAAqC,CAAC;AAK7C,OAAO,EAAQ,KAAK,WAAW,EAAE,MAAM,0CAA0C,CAAC;AAElF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAGnE,OAAO,KAAK,EACV,iBAAiB,EACjB,2BAA2B,EAC5B,MAAM,6EAA6E,CAAC;AACrF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+DAA+D,CAAC;AAEvG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wDAAwD,CAAC;AAM7F,MAAM,WAAW,kBAAkB,CAAC,OAAO,SAAS,CAAC,CAAC,UAAU;IAC9D,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAChD,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC;IAC1D,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;;OAGG;IACH,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAE7B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAElC;;;OAGG;IACH,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAIlC;;;OAGG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAE/B,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAEvD;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE7C;;;;;;;;OAQG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAC1D,iBAAiB,CAAC,EAAE,2BAA2B,CAAC;IAEhD;;;;OAIG;IACH,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAElC;;;OAGG;IACH,aAAa,CAAC,EAAE,CACd,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAAE,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,CAAC;IAEjD,uFAAuF;IACvF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yFAAyF;IACzF,0BAA0B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtG,oEAAoE;IACpE,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;;;;;;;;OAUG;IACH,cAAc,EAAE,KAAK,CAAC,aAAa,CAAC;CACrC;AAMD,iBAAS,sBAAsB,CAAC,OAAO,SAAS,CAAC,CAAC,UAAU,EAAE,EAC5D,MAAM,EACN,aAAa,EACb,QAAQ,EACR,OAAO,EACP,cAAc,EACd,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,EAAE,EACF,oBAA4B,EAC5B,MAAM,EACN,YAAY,EACZ,aAAa,EACb,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,0BAA0B,EAC1B,cAAc,EACd,cAAc,EAAE,cAAc,GAC/B,EAAE,kBAAkB,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA6LjD;kBA1NQ,sBAAsB;;;AA8N/B,eAAO,MAAM,aAAa,+BAAyB,CAAC"}