@wildo-ai/saas-frontend-lib 1.0.1 → 1.1.0

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

@@ -4,7 +4,7 @@ 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 { useI18n } from "../../core/i18n/useI18n.js";
 import { cn } from "../../core/ui/cn.js";
 import { FrontendComponentType } from "@wildo-ai/presets-components-models";
 //===============================================================
@@ -21,16 +21,22 @@ export const AI_TaskMemory = ({ memory, className, ...props }) => {
     const totalEntries = memory.shortTerm.entries.length +
         memory.longTerm.entries.length +
         memory.working.entries.length;
+    if (!isReady)
+        return null;
     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] ?? "📋";
+    if (!isReady)
+        return null;
     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;
+    if (!isReady)
+        return null;
     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
+//# sourceMappingURL=task-memory.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"task-memory.js","sourceRoot":"","sources":["../../../../src/components/flows-actors/task-memory.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"task-memory.js","sourceRoot":"","sources":["../../../../../src/components/flows-actors/task-memory.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\nimport * as React from \"react\";\nimport { Badge } from \"~wildo-frontend-lib/components/data-display/badge\";\nimport { ScrollArea } from \"~wildo-frontend-lib/components/layout/scroll-area\";\nimport { Collapsible, CollapsibleContent, CollapsibleTrigger } from \"~wildo-frontend-lib/components/sections/collapsible\";\nimport { Button, ButtonVariants_Variant } from \"~wildo-frontend-lib/components/actions/button\";\nimport { useI18n } from \"~wildo-frontend-lib/core/i18n/useI18n\";\nimport { cn } from \"~wildo-frontend-lib/core/ui/cn\";\nimport { FrontendComponentType } from \"@wildo-ai/presets-components-models\";\nimport type { ComponentProps } from \"react\";\nimport type {\n  Actors_Memory_Context,\n  Actors_Memory_Store,\n  Actors_Memory_Entry,\n} from \"@wildo-ai/saas-models\";\n\n//===============================================================\n//  Constants\n//===============================================================\n\nconst CT = FrontendComponentType.LOW_LEVEL_AI_TASK_MEMORY;\n\nconst SCOPE_ICONS: Record<string, string> = {\n  short_term: \"⚡\",\n  long_term: \"📦\",\n  working: \"🔧\",\n};\n\n//===============================================================\n//  AI_TaskMemory\n//===============================================================\n\nexport type AI_TaskMemoryProps = ComponentProps<\"div\"> & {\n  memory: Actors_Memory_Context;\n};\n\nexport const AI_TaskMemory = ({\n  memory,\n  className,\n  ...props\n}: AI_TaskMemoryProps): React.JSX.Element | null => {\n  const { tComponent, isReady } = useI18n({ component: CT });\n\n  const totalEntries =\n    memory.shortTerm.entries.length +\n    memory.longTerm.entries.length +\n    memory.working.entries.length;\n\n  if (!isReady) return null;\n\n  return (\n    <div className={cn(\"flex flex-col gap-card\", className)} {...props}>\n      <div className=\"flex items-center gap-element\">\n        <h4 className=\"text-sm font-semibold\">\n          {tComponent(CT, \"title\")}\n        </h4>\n        <Badge variant=\"secondary\" className=\"text-2xs\">{totalEntries}</Badge>\n      </div>\n      <AI_TaskMemoryScope\n        scope=\"short_term\"\n        label={tComponent(CT, \"shortTerm\")}\n        store={memory.shortTerm}\n        defaultOpen\n      />\n      <AI_TaskMemoryScope\n        scope=\"long_term\"\n        label={tComponent(CT, \"longTerm\")}\n        store={memory.longTerm}\n      />\n      <AI_TaskMemoryScope\n        scope=\"working\"\n        label={tComponent(CT, \"working\")}\n        store={memory.working}\n      />\n    </div>\n  );\n};\n\n//===============================================================\n//  AI_TaskMemoryScope\n//===============================================================\n\nexport type AI_TaskMemoryScopeProps = ComponentProps<typeof Collapsible> & {\n  scope: string;\n  label: string;\n  store: Actors_Memory_Store;\n  defaultOpen?: boolean;\n};\n\nexport const AI_TaskMemoryScope = ({\n  scope,\n  label,\n  store,\n  defaultOpen = false,\n  className,\n  ...props\n}: AI_TaskMemoryScopeProps): React.JSX.Element | null => {\n  const { tComponent, isReady } = useI18n({ component: CT });\n  const icon = SCOPE_ICONS[scope] ?? \"📋\";\n\n  if (!isReady) return null;\n\n  return (\n    <Collapsible defaultOpen={defaultOpen} className={cn(\"rounded-md border\", className)} {...props}>\n      <CollapsibleTrigger asChild>\n        <Button type=\"button\" variant={ButtonVariants_Variant.GHOST} className=\"w-full justify-between p-card-sm\">\n          <span className=\"flex items-center gap-element text-xs font-medium\">\n            <span>{icon}</span>\n            {label}\n            {store.maxSize != null && (\n              <span className=\"text-2xs text-muted-foreground\">\n                ({store.entries.length}/{store.maxSize})\n              </span>\n            )}\n          </span>\n          <Badge variant=\"secondary\" className=\"text-2xs\">{store.entries.length}</Badge>\n        </Button>\n      </CollapsibleTrigger>\n      <CollapsibleContent>\n        <ScrollArea className=\"max-h-48\">\n          <div className=\"flex flex-col gap-1 p-card-sm pt-0\">\n            {store.entries.map((entry) => (\n              <AI_TaskMemoryEntryItem key={entry.key} entry={entry} />\n            ))}\n            {store.entries.length === 0 && (\n              <span className=\"text-2xs text-muted-foreground italic\">\n                {tComponent(CT, \"scopeEmpty\" as any)}\n              </span>\n            )}\n          </div>\n        </ScrollArea>\n      </CollapsibleContent>\n    </Collapsible>\n  );\n};\n\n//===============================================================\n//  AI_TaskMemoryEntryItem\n//===============================================================\n\nexport type AI_TaskMemoryEntryItemProps = ComponentProps<\"div\"> & {\n  entry: Actors_Memory_Entry;\n};\n\nexport const AI_TaskMemoryEntryItem = ({\n  entry,\n  className,\n  ...props\n}: AI_TaskMemoryEntryItemProps): React.JSX.Element | null => {\n  const { tComponent, isReady } = useI18n({ component: CT });\n  const isExpired = entry.expiresAt ? new Date(entry.expiresAt).getTime() < Date.now() : false;\n\n  if (!isReady) return null;\n\n  return (\n    <div\n      className={cn(\n        \"flex flex-col gap-0.5 rounded-sm bg-muted p-1.5\",\n        isExpired && \"opacity-[var(--opacity-muted)]\",\n        className,\n      )}\n      {...props}\n    >\n      <div className=\"flex items-center gap-element\">\n        <span className=\"text-2xs font-medium\">{entry.key}</span>\n        <Badge variant=\"outline\" className=\"text-2xs\">{entry.type}</Badge>\n        {isExpired && (\n          <Badge variant=\"destructive\" className=\"text-2xs\">{tComponent(CT, \"expired\" as any)}</Badge>\n        )}\n        {entry.expiresAt && !isExpired && (\n          <span className=\"text-2xs text-muted-foreground\">\n            {tComponent(CT, \"expires\" as any)}: {new Date(entry.expiresAt).toLocaleTimeString()}\n          </span>\n        )}\n      </div>\n\n      <pre className=\"max-h-16 overflow-auto text-2xs text-muted-foreground\">\n        {typeof entry.value === \"string\" ? entry.value : JSON.stringify(entry.value, null, 2)}\n      </pre>\n\n      {entry.metadata && Object.keys(entry.metadata).length > 0 && (\n        <div className=\"mt-0.5 flex flex-wrap gap-1\">\n          <span className=\"text-2xs text-muted-foreground/70\">{tComponent(CT, \"metadata\" as any)}:</span>\n          {Object.entries(entry.metadata).map(([k, v]) => (\n            <Badge key={k} variant=\"outline\" className=\"text-2xs\">\n              {k}: {String(v)}\n            </Badge>\n          ))}\n        </div>\n      )}\n\n      <time className=\"text-2xs text-muted-foreground/60\">\n        {new Date(entry.timestamp).toLocaleTimeString()}\n      </time>\n    </div>\n  );\n};\n"]}

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

@@ -0,0 +1,3 @@
+import { type LabellingUnitaryDef } from '@wildo-ai/presets-components-models';
+export declare const LowLevelAiTaskMemoryLabels: LabellingUnitaryDef[];
+//# sourceMappingURL=task-memory.labels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task-memory.labels.d.ts","sourceRoot":"","sources":["../../../../../src/components/flows-actors/task-memory.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,mBAAmB,EAA2B,MAAM,qCAAqC,CAAC;AAM1I,eAAO,MAAM,0BAA0B,EAAE,mBAAmB,EAS3D,CAAC"}

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

@@ -0,0 +1,16 @@
+import { FrontendComponentType, LabelKind, registerComponentLabels } from '@wildo-ai/presets-components-models';
+// Companion-only label metadata for this component: keys + params + (where
+// authored) per-key purpose / kind / variable meaning. Statically scanned by
+// the dev companion; NOT imported at runtime, so it never ships in the bundle.
+export const LowLevelAiTaskMemoryLabels = [
+    { ref: 'title', kind: LabelKind.HEADING, purpose: 'Heading for the task memory panel' },
+    { ref: 'shortTerm', kind: LabelKind.LABEL, purpose: 'Label for the short-term (volatile) memory scope' },
+    { ref: 'longTerm', kind: LabelKind.LABEL, purpose: 'Label for the long-term (persisted) memory scope' },
+    { ref: 'working', kind: LabelKind.LABEL, purpose: 'Label for the working (active-task) memory scope' },
+    { ref: 'metadata', kind: LabelKind.LABEL, purpose: 'Label for the metadata attached to a memory entry' },
+    { ref: 'expires', kind: LabelKind.LABEL, purpose: 'Label for when a memory entry is set to expire' },
+    { ref: 'scopeEmpty', kind: LabelKind.EMPTY_STATE, purpose: 'Shown when a memory scope holds no entries' },
+    { ref: 'expired', kind: LabelKind.MESSAGE, purpose: 'Marker that a memory entry has passed its expiry time' },
+];
+registerComponentLabels(FrontendComponentType.LOW_LEVEL_AI_TASK_MEMORY, LowLevelAiTaskMemoryLabels);
+//# sourceMappingURL=task-memory.labels.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task-memory.labels.js","sourceRoot":"","sources":["../../../../../src/components/flows-actors/task-memory.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAA4B,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAE1I,2EAA2E;AAC3E,6EAA6E;AAC7E,+EAA+E;AAE/E,MAAM,CAAC,MAAM,0BAA0B,GAA0B;IAC/D,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,mCAAmC,EAAE;IACvF,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,kDAAkD,EAAE;IACxG,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,kDAAkD,EAAE;IACvG,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,kDAAkD,EAAE;IACtG,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,mDAAmD,EAAE;IACxG,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,gDAAgD,EAAE;IACpG,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,CAAC,WAAW,EAAE,OAAO,EAAE,4CAA4C,EAAE;IACzG,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,uDAAuD,EAAE;CAC9G,CAAC;AACF,uBAAuB,CAAC,qBAAqB,CAAC,wBAAwB,EAAE,0BAA0B,CAAC,CAAC","sourcesContent":["import { FrontendComponentType, LabelKind, type LabellingUnitaryDef, registerComponentLabels } from '@wildo-ai/presets-components-models';\n\n// Companion-only label metadata for this component: keys + params + (where\n// authored) per-key purpose / kind / variable meaning. Statically scanned by\n// the dev companion; NOT imported at runtime, so it never ships in the bundle.\n\nexport const LowLevelAiTaskMemoryLabels: LabellingUnitaryDef[] = [\n  { ref: 'title', kind: LabelKind.HEADING, purpose: 'Heading for the task memory panel' },\n  { ref: 'shortTerm', kind: LabelKind.LABEL, purpose: 'Label for the short-term (volatile) memory scope' },\n  { ref: 'longTerm', kind: LabelKind.LABEL, purpose: 'Label for the long-term (persisted) memory scope' },\n  { ref: 'working', kind: LabelKind.LABEL, purpose: 'Label for the working (active-task) memory scope' },\n  { ref: 'metadata', kind: LabelKind.LABEL, purpose: 'Label for the metadata attached to a memory entry' },\n  { ref: 'expires', kind: LabelKind.LABEL, purpose: 'Label for when a memory entry is set to expire' },\n  { ref: 'scopeEmpty', kind: LabelKind.EMPTY_STATE, purpose: 'Shown when a memory scope holds no entries' },\n  { ref: 'expired', kind: LabelKind.MESSAGE, purpose: 'Marker that a memory entry has passed its expiry time' },\n];\nregisterComponentLabels(FrontendComponentType.LOW_LEVEL_AI_TASK_MEMORY, LowLevelAiTaskMemoryLabels);\n"]}

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

@@ -11,8 +11,9 @@
 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';
+import { FormSchemaKind, type ValidationMode } from './form-field-types';
+import type { NavigationZone } from '../../core/navigation/navigation.schemas';
+import type { FrontendResource_ParentResourceRequirement } from '../../core/resources/resource-path.frontend.schemas';
 /**
  * Form methods interface for external access.
  * Curated subset of RHF's UseFormReturn — exposes what callers actually need
@@ -46,6 +47,13 @@ export interface FormMethods {
 export interface FormProps<TSchema extends z.ZodTypeAny> {
     /** The main schema (used for context and type inference) */
     schema: TSchema;
+    /**
+     * Which KIND of schema `schema` is. Decides how field clearability is answered — see
+     * {@link FormSchemaKind}. Resource forms validate a request DTO (the default); a surface that
+     * wraps a single MAIN-schema field must say so, or clearing silently stops working for refined
+     * optional fields on it.
+     */
+    schemaKind?: FormSchemaKind;
     /**
      * Optional prepared schema for validation.
      * When provided, this schema is used for RHF validation instead of the main schema.
@@ -57,6 +65,17 @@ export interface FormProps<TSchema extends z.ZodTypeAny> {
     onError?: (errors: FieldErrors<z.infer<TSchema>>) => void;
     validationMode?: ValidationMode;
     children: React.ReactNode;
+    /**
+     * Extra classes for the `<form>` element — BOX-level styling only (width
+     * constraints, grid placement). The form is NOT a spacing stack: all children
+     * render inside one `display: contents` fieldset (the disabled-cascade
+     * carrier), so the form has exactly one direct child and direct-children
+     * utilities (`space-y-*`, `space-x-*`, `divide-*`) are structurally inert
+     * here — Tailwind compiles them to `> * + *`, which never reaches
+     * grandchildren. Vertical rhythm between top-level form rows is owned by the
+     * layout template/containers (`FormLayout`, section containers, template
+     * divs). A dev-only warning fires when an inert utility is passed.
+     */
     className?: string;
     disabled?: boolean;
     id?: string;
@@ -84,10 +103,12 @@ export interface FormProps<TSchema extends z.ZodTypeAny> {
         fieldIdentifier: string;
         resourceId: string;
     }>;
+    /** Route parent evidence for generated relationship field mutations */
+    parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];
     /** 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 function FormComponent<TSchema extends z.ZodTypeAny>({ schema, schemaKind, validationSchema, defaultValues, onSubmit, onError, validationMode, children, className, disabled, id, resourceType, onFormReady, warnOnUnsavedChanges, validateFieldUrl, resourceId, operationType, contextResourceIdentifiers, parentResourcesRequirements, navigationZone, }: FormProps<TSchema>): React.JSX.Element;
 declare namespace FormComponent {
     var displayName: string;
 }

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

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

@@ -12,11 +12,32 @@ import { jsx as _jsx } from "react/jsx-runtime";
 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 { ContentSection } from '../../components/sections/content-section.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, }) {
+/**
+ * Direct-children-dependent utilities that can NEVER work on the `<form>`
+ * element: all children render inside one `display: contents` fieldset (the
+ * disabled-cascade carrier), so the form has exactly one direct child and
+ * Tailwind's `> * + *` selectors never reach the rows. A class name is a free
+ * string, so this trap cannot be made unbypassable — make it VISIBLE instead
+ * with a dev-only, deduped warning (invariant-call-site-enumeration: prefer
+ * unbypassable, else visible).
+ */
+const INERT_FORM_CLASS_PATTERN = /(?:^|\s)(?:[a-z-]+:)*(?:space-[xy]|divide-[xy])(?:-|\s|$)/;
+const warnedInertFormClassNames = new Set();
+function warnOnInertFormClassName(className) {
+    if (process.env.NODE_ENV === 'production' || !className)
+        return;
+    if (!INERT_FORM_CLASS_PATTERN.test(className))
+        return;
+    if (warnedInertFormClassNames.has(className))
+        return;
+    warnedInertFormClassNames.add(className);
+    // eslint-disable-next-line no-console -- dev-only authoring diagnostic
+    console.warn(`[Form] className "${className}" contains a direct-children utility (space-y-*/space-x-*/divide-*) that is structurally inert on the form element — all form children render inside one display:contents fieldset, so these selectors never apply. Own the spacing in the layout template/containers instead.`);
+}
+function FormComponent({ schema, schemaKind, validationSchema, defaultValues, onSubmit, onError, validationMode, children, className, disabled, id, resourceType, onFormReady, warnOnUnsavedChanges = false, validateFieldUrl, resourceId, operationType, contextResourceIdentifiers, parentResourcesRequirements, navigationZone, }) {
     // Use centralized DEFAULT_VALIDATION_MODE constant
     const rhfMode = validationMode ?? DEFAULT_VALIDATION_MODE;
     // Use prepared validation schema if provided, otherwise use main schema
@@ -64,9 +85,10 @@ function FormComponent({ schema, validationSchema, defaultValues, onSubmit, onEr
     }, (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 }) }) }));
+    warnOnInertFormClassName(className);
+    return (_jsx(FormSchemaProvider, { schema: schema, schemaKind: schemaKind, form: form, resourceType: resourceType, validationMode: validationMode, validateFieldUrl: validateFieldUrl, resourceId: resourceId, operationType: operationType, contextResourceIdentifiers: contextResourceIdentifiers, parentResourcesRequirements: parentResourcesRequirements, navigationZone: navigationZone, children: _jsx("form", { id: id, onSubmit: handleSubmit, className: className, noValidate // Let react-hook-form handle validation
+            : true, "data-testid": "form", children: _jsx(ContentSection, { disabled: disabled, className: "contents", children: children }) }) }));
 }
 FormComponent.displayName = 'Form';
 export const Form = FormComponent;
-//# sourceMappingURL=Form.js.map
+//# sourceMappingURL=Form.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"Form.js","sourceRoot":"","sources":["../../../../src/components/form/Form.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"Form.js","sourceRoot":"","sources":["../../../../../src/components/form/Form.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * Form Component\n * \n * Schema-driven form wrapper that uses react-hook-form with standardSchemaResolver.\n * Provides FormProvider context for child fields.\n * \n * Note: Uses standardSchemaResolver (not zodResolver) for Zod 4 compatibility.\n * Zod 4 implements the Standard Schema interface which is supported by this resolver.\n * Requires @hookform/resolvers >= 5.0.0\n */\n\nimport React, { useEffect } from 'react';\nimport { z } from 'zod';\nimport { useForm, FieldErrors, UseFormReturn, DefaultValues } from 'react-hook-form';\nimport { standardSchemaResolver } from '@hookform/resolvers/standard-schema';\n\nimport { FormSchemaKind, type ValidationMode } from './form-field-types';\n\nimport { FormSchemaProvider } from './form-context';\nimport { ContentSection } from '~wildo-frontend-lib/components/sections/content-section';\nimport { DEFAULT_VALIDATION_MODE } from '~wildo-frontend-lib/core/automated-layout/automated-layout.frontend.schemas';\nimport type { NavigationZone } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport type { FrontendResource_ParentResourceRequirement } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\n\n/**\n * Direct-children-dependent utilities that can NEVER work on the `<form>`\n * element: all children render inside one `display: contents` fieldset (the\n * disabled-cascade carrier), so the form has exactly one direct child and\n * Tailwind's `> * + *` selectors never reach the rows. A class name is a free\n * string, so this trap cannot be made unbypassable — make it VISIBLE instead\n * with a dev-only, deduped warning (invariant-call-site-enumeration: prefer\n * unbypassable, else visible).\n */\nconst INERT_FORM_CLASS_PATTERN = /(?:^|\\s)(?:[a-z-]+:)*(?:space-[xy]|divide-[xy])(?:-|\\s|$)/;\nconst warnedInertFormClassNames = new Set<string>();\nfunction warnOnInertFormClassName(className: string | undefined): void {\n  if (process.env.NODE_ENV === 'production' || !className) return;\n  if (!INERT_FORM_CLASS_PATTERN.test(className)) return;\n  if (warnedInertFormClassNames.has(className)) return;\n  warnedInertFormClassNames.add(className);\n  // eslint-disable-next-line no-console -- dev-only authoring diagnostic\n  console.warn(\n    `[Form] className \"${className}\" contains a direct-children utility (space-y-*/space-x-*/divide-*) that is structurally inert on the form element — all form children render inside one display:contents fieldset, so these selectors never apply. Own the spacing in the layout template/containers instead.`,\n  );\n}\n\n/**\n * Form methods interface for external access.\n * Curated subset of RHF's UseFormReturn — exposes what callers actually need\n * without leaking the full RHF API.\n */\nexport interface FormMethods {\n  /** Set an error on a specific field */\n  setError: (name: string, error: { type: string; message: string }) => void;\n  /** Clear error on a specific field or all errors */\n  clearErrors: (name?: string | string[]) => void;\n  /** Watch form values for changes */\n  watch: UseFormReturn<any>['watch'];\n  /** Reset form to default values or provided values */\n  reset: UseFormReturn<any>['reset'];\n  /** Get current form values (all fields or a specific field) */\n  getValues: UseFormReturn<any>['getValues'];\n  /** Set a specific field value programmatically */\n  setValue: UseFormReturn<any>['setValue'];\n  /** Trigger validation for specific fields or the entire form */\n  trigger: UseFormReturn<any>['trigger'];\n  /** Submit the form programmatically (e.g., from an external button) */\n  handleSubmit: UseFormReturn<any>['handleSubmit'];\n  /** Reactive form state (isDirty, isSubmitting, isValid, errors, etc.) */\n  formState: UseFormReturn<any>['formState'];\n  /** Get field state (isDirty, isTouched, invalid, error) for a specific field */\n  getFieldState: UseFormReturn<any>['getFieldState'];\n}\n\nexport interface FormProps<TSchema extends z.ZodTypeAny> {\n  /** The main schema (used for context and type inference) */\n  schema: TSchema;\n  /**\n   * Which KIND of schema `schema` is. Decides how field clearability is answered — see\n   * {@link FormSchemaKind}. Resource forms validate a request DTO (the default); a surface that\n   * wraps a single MAIN-schema field must say so, or clearing silently stops working for refined\n   * optional fields on it.\n   */\n  schemaKind?: FormSchemaKind;\n  /** \n   * Optional prepared schema for validation.\n   * When provided, this schema is used for RHF validation instead of the main schema.\n   * Use prepareFormSchema() to create this from the main schema.\n   */\n  validationSchema?: z.ZodTypeAny;\n  defaultValues?: DefaultValues<z.infer<TSchema>>;\n  onSubmit: (data: z.infer<TSchema>) => void | Promise<void>;\n  onError?: (errors: FieldErrors<z.infer<TSchema>>) => void;\n  validationMode?: ValidationMode;\n  children: React.ReactNode;\n  /**\n   * Extra classes for the `<form>` element — BOX-level styling only (width\n   * constraints, grid placement). The form is NOT a spacing stack: all children\n   * render inside one `display: contents` fieldset (the disabled-cascade\n   * carrier), so the form has exactly one direct child and direct-children\n   * utilities (`space-y-*`, `space-x-*`, `divide-*`) are structurally inert\n   * here — Tailwind compiles them to `> * + *`, which never reaches\n   * grandchildren. Vertical rhythm between top-level form rows is owned by the\n   * layout template/containers (`FormLayout`, section containers, template\n   * divs). A dev-only warning fires when an inert utility is passed.\n   */\n  className?: string;\n  disabled?: boolean;\n  id?: string;\n  /** Resource type for i18n field label lookup (used by FormErrorSummary) */\n  resourceType?: string;\n  /**\n   * Callback invoked with form methods when the form is ready.\n   * Use this to get access to setError/clearErrors for setting server-side validation errors.\n   */\n  onFormReady?: (formMethods: FormMethods) => void;\n  /**\n   * When true, shows a browser confirmation dialog when the user tries to leave\n   * the page (tab close, refresh) while the form has unsaved changes (isDirty).\n   * @default false\n   */\n  warnOnUnsavedChanges?: boolean;\n  /** Base URL for validate-field endpoint (enables uniqueness pre-validation on blur) */\n  validateFieldUrl?: string;\n  /** Resource ID for UPDATE operations (used as excludeId in uniqueness checks) */\n  resourceId?: string;\n  /** Current operation type for operation-aware decorators (e.g., isNotEditable) */\n  operationType?: string;\n  /** Resource context identifiers for FK context propagation to nested field components */\n  contextResourceIdentifiers?: Record<string, string | { fieldIdentifier: string; resourceId: string }>;\n  /** Route parent evidence for generated relationship field mutations */\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n  /** Current navigation zone for quick-create-aware field controls */\n  navigationZone?: NavigationZone;\n}\n\nfunction FormComponent<TSchema extends z.ZodTypeAny>({\n  schema,\n  schemaKind,\n  validationSchema,\n  defaultValues,\n  onSubmit,\n  onError,\n  validationMode,\n  children,\n  className,\n  disabled,\n  id,\n  resourceType,\n  onFormReady,\n  warnOnUnsavedChanges = false,\n  validateFieldUrl,\n  resourceId,\n  operationType,\n  contextResourceIdentifiers,\n  parentResourcesRequirements,\n  navigationZone,\n}: FormProps<TSchema>): React.JSX.Element {\n  // Use centralized DEFAULT_VALIDATION_MODE constant\n  const rhfMode = validationMode ?? DEFAULT_VALIDATION_MODE;\n  \n  // Use prepared validation schema if provided, otherwise use main schema\n  const schemaForValidation = validationSchema ?? schema;\n  \n  const form = useForm<z.infer<TSchema>>({\n    // Cast required for Zod 4 + TypeScript compatibility with Standard Schema interface\n    resolver: standardSchemaResolver(schemaForValidation) as any,\n    defaultValues: defaultValues as any,\n    mode: rhfMode,\n    disabled,\n  });\n  \n  // Dirty guard: warn user before leaving page with unsaved changes\n  useEffect(() => {\n    if (!warnOnUnsavedChanges) return;\n    \n    const handleBeforeUnload = (e: BeforeUnloadEvent) => {\n      if (form.formState.isDirty) {\n        e.preventDefault();\n      }\n    };\n    \n    window.addEventListener('beforeunload', handleBeforeUnload);\n    return () => window.removeEventListener('beforeunload', handleBeforeUnload);\n  }, [warnOnUnsavedChanges, form.formState.isDirty]);\n  \n  // Notify parent when form is ready with form methods.\n  // `form` is a stable reference (useForm returns the same object across renders),\n  // so this effect only meaningfully re-runs when `onFormReady` changes.\n  useEffect(() => {\n    if (onFormReady) {\n      onFormReady({\n        setError: (name, error) => form.setError(name as any, error),\n        clearErrors: (name) => form.clearErrors(name as any),\n        watch: form.watch,\n        reset: form.reset,\n        getValues: form.getValues,\n        setValue: form.setValue as FormMethods['setValue'],\n        trigger: form.trigger,\n        handleSubmit: form.handleSubmit,\n        formState: form.formState,\n        getFieldState: form.getFieldState,\n      });\n    }\n  }, [onFormReady, form]);\n  \n  const handleSubmit = form.handleSubmit(\n    async (data: z.infer<TSchema>) => {\n      await onSubmit(data);\n    },\n    (errors) => {\n      onError?.(errors);\n    }\n  );\n\n  warnOnInertFormClassName(className);\n\n  return (\n    <FormSchemaProvider\n      schema={schema}\n      schemaKind={schemaKind}\n      form={form}\n      resourceType={resourceType}\n      validationMode={validationMode}\n      validateFieldUrl={validateFieldUrl}\n      resourceId={resourceId}\n      operationType={operationType}\n      contextResourceIdentifiers={contextResourceIdentifiers}\n      parentResourcesRequirements={parentResourcesRequirements}\n      navigationZone={navigationZone}\n    >\n      {/* No spacing utilities here on purpose: the ContentSection below is\n          `display: contents`, so the form's only direct child is the fieldset\n          and `space-y-*` on the form can never apply (a hardcoded\n          `space-y-field` sat here dead until 2026-08-19). Spacing between\n          top-level rows is owned by the layout template/containers. */}\n      <form\n        id={id}\n        onSubmit={handleSubmit}\n        className={className}\n        noValidate // Let react-hook-form handle validation\n        data-testid=\"form\"\n      >\n        <ContentSection disabled={disabled} className=\"contents\">\n          {children}\n        </ContentSection>\n      </form>\n    </FormSchemaProvider>\n  );\n}\n\nFormComponent.displayName = 'Form';\n\nexport const Form: typeof FormComponent & { displayName: string } = FormComponent;"]}

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

@@ -0,0 +1,54 @@
+/**
+ * AutomatedArrayField Component
+ *
+ * Handles array schema types using react-hook-form's useFieldArray.
+ * Renders a list of items with add/remove controls and optional
+ * drag-and-drop reordering via @dnd-kit.
+ */
+import React from 'react';
+import { z } from 'zod';
+import { ArrayObjectItemLayout, type SoloSectionMode } from '@wildo-ai/zod-decorators';
+export interface AutomatedArrayFieldProps {
+    name: string;
+    schema: z.ZodTypeAny;
+    label: string;
+    description?: string;
+    disabled?: boolean;
+    className?: string;
+    renderField?: (name: string, schema: z.ZodTypeAny) => React.ReactNode;
+    addLabel?: string;
+    itemLabel?: string;
+    /** Enable drag-and-drop reordering. Defaults to true. */
+    reorderable?: boolean;
+    /**
+     * Appearance of the array's own section frame (the legend + item-list
+     * container). Threaded to the `ContentSection` the array renders. Defaults to
+     * `SectionMode.DEFAULT`. Set per-placement from `DisplayFieldArray` /
+     * `FormFieldArray`.
+     */
+    sectionAppearance?: SoloSectionMode;
+    /**
+     * Per-placement override of the item framing (`CARD` framed cards vs compact
+     * `ROW`). Wins over the schema's `arrayUI({ objectItemLayout })` default.
+     */
+    objectItemLayout?: ArrayObjectItemLayout;
+}
+/**
+ * Leading-gutter width for a ROW array that supplies a custom per-item TEMPLATE
+ * (`renderField`). Templates typically lead with a compact CHECKBOX rather than
+ * the wider default Switch, so the gutter is tighter. Exported so the app's item
+ * template can reserve the SAME leading cell for its control — keeping the
+ * template rows AND the framework "add item" quick-add input aligned to one
+ * column. Wrap the template's leading control in
+ * `<div className={ARRAY_ROW_TEMPLATE_GUTTER_CLASS + ' shrink-0 flex items-center'}>`.
+ */
+export declare const ARRAY_ROW_TEMPLATE_GUTTER_CLASS = "w-7";
+declare function AutomatedArrayFieldComponent({ name, schema, label, description, disabled, className, renderField, addLabel: addLabelProp, itemLabel: itemLabelProp, reorderable: reorderableProp, sectionAppearance, objectItemLayout: objectItemLayoutOverride, }: AutomatedArrayFieldProps): React.JSX.Element | null;
+declare namespace AutomatedArrayFieldComponent {
+    var displayName: string;
+}
+export declare const AutomatedArrayField: typeof AutomatedArrayFieldComponent & {
+    displayName: string;
+};
+export {};
+//# sourceMappingURL=AutomatedArrayField.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AutomatedArrayField.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/automated/AutomatedArrayField.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAA4D,MAAM,OAAO,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuCxB,OAAO,EAAmH,qBAAqB,EAAmJ,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AASzV,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,UAAU,KAAK,KAAK,CAAC,SAAS,CAAC;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,eAAe,CAAC;IACpC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;CAC1C;AAiMD;;;;;;;;GAQG;AACH,eAAO,MAAM,+BAA+B,QAAQ,CAAC;AAucrD,iBAAS,4BAA4B,CAAC,EACpC,IAAI,EACJ,MAAM,EACN,KAAK,EACL,WAAW,EACX,QAAQ,EACR,SAAS,EACT,WAAW,EACX,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,aAAa,EACxB,WAAW,EAAE,eAAsB,EACnC,iBAAiB,EACjB,gBAAgB,EAAE,wBAAwB,GAC3C,EAAE,wBAAwB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CA+frD;kBA5gBQ,4BAA4B;;;AAghBrC,eAAO,MAAM,mBAAmB,EAAE,OAAO,4BAA4B,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAiC,CAAC"}