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

package/dist/esm/components/form/fields/form-field-range-time.labels.js

@@ -0,0 +1,7 @@
+import { FrontendComponentType, 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 LowLevelFormFieldRangeTimeLabels = [];
+registerComponentLabels(FrontendComponentType.LOW_LEVEL_FORM_FIELD_RANGE_TIME, LowLevelFormFieldRangeTimeLabels);
+//# sourceMappingURL=form-field-range-time.labels.js.map

package/dist/esm/components/form/fields/form-field-range-time.labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-field-range-time.labels.js","sourceRoot":"","sources":["../../../../../../src/components/form/fields/form-field-range-time.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAA4B,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAE/H,2EAA2E;AAC3E,6EAA6E;AAC7E,+EAA+E;AAE/E,MAAM,CAAC,MAAM,gCAAgC,GAA0B,EAAE,CAAC;AAC1E,uBAAuB,CAAC,qBAAqB,CAAC,+BAA+B,EAAE,gCAAgC,CAAC,CAAC","sourcesContent":["import { FrontendComponentType, 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 LowLevelFormFieldRangeTimeLabels: LabellingUnitaryDef[] = [];\nregisterComponentLabels(FrontendComponentType.LOW_LEVEL_FORM_FIELD_RANGE_TIME, LowLevelFormFieldRangeTimeLabels);\n"]}

package/dist/esm/components/form/fields/form-field-string.d.ts

@@ -1,12 +1,13 @@
 import React from 'react';
-import { ComponentPresetProps } from '../../../core/components-registry/component-registry.frontend.schemas.js';
-import type { ControlBaseProps } from '../../../components/form/form-field-types.js';
+import { ComponentPresetProps } from '../../../core/components-registry/component-registry.frontend.schemas';
+import type { ControlBaseProps } from '../../../components/form/form-field-types';
 export interface FormFieldStringProps extends Omit<ControlBaseProps, 'value' | 'onChange' | 'defaultValue'> {
     value?: string;
     onChange?: (value: string) => void;
     defaultValue?: string;
     placeholder?: string;
     autoComplete?: string;
+    type?: 'text' | 'email' | 'url' | 'password' | 'tel' | 'number';
 }
 export type FormFieldStringRef = HTMLInputElement | HTMLTextAreaElement | HTMLButtonElement | HTMLDivElement;
 /**

package/dist/esm/components/form/fields/form-field-string.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-field-string.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/fields/form-field-string.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqB,MAAM,OAAO,CAAA;AAMzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AACvH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sDAAsD,CAAA;AAU5F,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,UAAU,GAAG,cAAc,CAAC;IACzG,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,MAAM,kBAAkB,GAAG,gBAAgB,GAAG,mBAAmB,GAAG,iBAAiB,GAAG,cAAc,CAAA;AAE5G;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,iGAgJzC,CAAA;AAIF,eAAO,MAAM,eAAe,wHAQ3B,CAAA"}
+{"version":3,"file":"form-field-string.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/fields/form-field-string.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqB,MAAM,OAAO,CAAA;AAKzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AACvH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sDAAsD,CAAA;AAW5F,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,UAAU,GAAG,cAAc,CAAC;IACzG,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,UAAU,GAAG,KAAK,GAAG,QAAQ,CAAA;CAChE;AAED,MAAM,MAAM,kBAAkB,GAAG,gBAAgB,GAAG,mBAAmB,GAAG,iBAAiB,GAAG,cAAc,CAAA;AAE5G;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,iGAmMzC,CAAA;AAGF,eAAO,MAAM,eAAe,wHAQ3B,CAAA"}

package/dist/esm/components/form/fields/form-field-string.js

@@ -1,9 +1,10 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import React, { forwardRef } from 'react';
-import { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models';
+import { ControlSize, CorePresetNames, FrontendComponentType } from '@wildo-ai/presets-components-models';
 import { createComponentResolverWithRef } from '../../../core/components-registry/component-resolver.frontend.helper.js';
 import { Input } from "../../../components/form/controls/input.js";
 import { Textarea } from "../../../components/form/controls/string/textarea.js";
+import { MarkdownEditor } from "../../../components/form/controls/string/markdown-editor.js";
 import { ColorInput } from "../../../components/form/controls/string/color-input.js";
 import { PasswordInput } from "../../../components/form/controls/string/password-input.js";
 import { InputOTP, InputOTPGroup, InputOTPSlot } from "../../../components/form/controls/string/input-otp.js";
@@ -14,7 +15,15 @@ import { getStringUI, getStringFormat, getOtpFieldParams, StringEditMode } from
  * Renders a string field according to the edit policy.
  * Forwards ref to the underlying input/textarea for RHF focus support.
  */
-export const FormFieldString_Preset_Default = React.forwardRef(({ schema, name, disabled, readOnly, className, value: controlledValue, onChange, onBlur, defaultValue, validationMode: validationModeProp, placeholder, autoComplete, autoFocus, }, ref) => {
+export const FormFieldString_Preset_Default = React.forwardRef(({ schema, name, disabled, readOnly, className, value: controlledValue, onChange, onBlur, defaultValue, validationMode: validationModeProp, placeholder, autoComplete, autoFocus, controlSize = ControlSize.MD, type, }, ref) => {
+    // The HTML default for `<input>` is text-like behavior, but React only
+    // renders a `type` attribute when the prop is defined — `<input
+    // type={undefined} />` produces an element whose `getAttribute('type')`
+    // returns `null`. That's a footgun for downstream tooling (DOM queries,
+    // a11y heuristics, autofill detection) that branches on the explicit
+    // attribute value. Pin the implicit default so callers omitting `type`
+    // still see a stable `text` attribute on the rendered element.
+    const resolvedInputType = type ?? 'text';
     const stringUI = getStringUI(schema);
     const stringFormat = getStringFormat(schema);
     let editMode = stringUI?.edit?.editMode ?? StringEditMode.INPUT;
@@ -24,9 +33,13 @@ export const FormFieldString_Preset_Default = React.forwardRef(({ schema, name,
     const textareaRows = stringUI?.edit?.textareaRows ?? 4;
     // Internal state for uncontrolled mode
     const [internalValue, setInternalValue] = React.useState(defaultValue ?? '');
-    // Determine if controlled
-    const isControlled = controlledValue !== undefined;
-    const currentValue = isControlled ? controlledValue : internalValue;
+    // Controlled ⇔ the caller supplied a change handler (or a defined value).
+    // An RHF-controlled value is legitimately `undefined` on CREATE surfaces;
+    // deciding by value alone routed user input into internal state and never
+    // called `onChange`, so form state silently stayed empty (`internalValue`
+    // doubles as the stable empty-display fallback while controlled-empty).
+    const isControlled = onChange !== undefined || controlledValue !== undefined;
+    const currentValue = controlledValue ?? internalValue;
     // Handle value change - validation is handled by parent FormField via RHF
     const handleChange = React.useCallback((newValue) => {
         if (isControlled) {
@@ -49,13 +62,19 @@ export const FormFieldString_Preset_Default = React.forwardRef(({ schema, name,
         className,
         validationMode: validationModeProp,
         autoFocus,
+        controlSize,
     };
     // Render based on edit mode
     switch (editMode) {
         case StringEditMode.INPUT:
-            return (_jsx(Input, { ref: ref, ...commonProps, value: currentValue, onChange: handleChange, onBlur: handleBlur, placeholder: placeholder, autoComplete: autoComplete }));
+            return (_jsx(Input, { ref: ref, ...commonProps, value: currentValue, onChange: handleChange, onBlur: handleBlur, placeholder: placeholder, autoComplete: autoComplete, type: resolvedInputType }));
         case StringEditMode.TEXTAREA:
-            return (_jsx(Textarea, { ref: ref, ...commonProps, value: currentValue, onChange: handleChange, onBlur: handleBlur, placeholder: placeholder, rows: textareaRows }));
+            return (_jsx(Textarea, { ref: ref, ...commonProps, value: currentValue, onChange: handleChange, onBlur: handleBlur, placeholder: placeholder, rows: textareaRows, autoComplete: autoComplete }));
+        case StringEditMode.MARKDOWN:
+            // Markdown SOURCE editor (registry-resolved; default preset is a
+            // lazy-loaded CodeMirror core). Value stays plain markdown source —
+            // display rendering remains on the MARKDOWN display pipeline.
+            return (_jsx(MarkdownEditor, { value: currentValue, onChange: handleChange, onBlur: handleBlur, placeholder: placeholder, disabled: disabled, readOnly: readOnly, autoFocus: autoFocus, minRows: textareaRows, ariaLabel: name, className: className }));
         case StringEditMode.COLOR:
             return (_jsx(ColorInput, { ref: ref, ...commonProps, value: currentValue, onChange: handleChange, onBlur: handleBlur, placeholder: placeholder }));
         case StringEditMode.PASSWORD:
@@ -63,10 +82,18 @@ export const FormFieldString_Preset_Default = React.forwardRef(({ schema, name,
         case StringEditMode.OTP: {
             const otpParams = getOtpFieldParams(schema);
             const otpMaxLength = otpParams?.maxLength ?? 6;
-            return (_jsx(InputOTP, { ref: ref, maxLength: otpMaxLength, value: currentValue, onChange: handleChange, disabled: disabled, children: _jsx(InputOTPGroup, { children: Array.from({ length: otpMaxLength }, (_, i) => (_jsx(InputOTPSlot, { index: i }, i))) }) }));
+            // NB: this is the one branch that cannot spread `commonProps` wholesale — `InputOTP` is a narrow
+            // control contract (`InputOTPProps`) and does not declare the schema-aware members the text controls
+            // accept (`schema`, `readOnly`, `validationMode`). Every member it DOES declare must still be
+            // forwarded explicitly, or this branch silently drops props every sibling branch honours. That is
+            // exactly what happened to `name` and `className` before: the field rendered `name=""`, so the input
+            // was unaddressable by name (breaking form-name selectors and weakening password-manager heuristics)
+            // and authored classes were ignored. Add the forward here whenever `commonProps` grows a member
+            // `InputOTPProps` declares.
+            return (_jsx(InputOTP, { ref: ref, name: name, className: className, maxLength: otpMaxLength, value: currentValue, onChange: handleChange, onBlur: handleBlur, disabled: disabled, autoComplete: autoComplete, autoFocus: autoFocus, controlSize: controlSize, children: _jsx(InputOTPGroup, { children: Array.from({ length: otpMaxLength }, (_, i) => (_jsx(InputOTPSlot, { index: i }, i))) }) }));
         }
         default:
-            return (_jsx(Input, { ref: ref, ...commonProps, value: currentValue, onChange: handleChange, onBlur: handleBlur, placeholder: placeholder, autoComplete: autoComplete }));
+            return (_jsx(Input, { ref: ref, ...commonProps, value: currentValue, onChange: handleChange, onBlur: handleBlur, placeholder: placeholder, autoComplete: autoComplete, type: resolvedInputType }));
     }
 });
 // --- Wrapper ---
@@ -75,4 +102,4 @@ export const FormFieldString = forwardRef(({ preset = CorePresetNames.DEFAULT, .
     return _jsx(Component, { ...props, ref: ref });
 });
 FormFieldString.displayName = 'FormFieldString';
-//# sourceMappingURL=form-field-string.js.map
+//# sourceMappingURL=form-field-string.js.map

package/dist/esm/components/form/fields/form-field-string.js.map

@@ -1 +1 @@
-{"version":3,"file":"form-field-string.js","sourceRoot":"","sources":["../../../../../src/components/form/fields/form-field-string.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAEzC,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AAC5F,OAAO,EAAE,8BAA8B,EAAE,MAAM,iFAAiF,CAAA;AAKhI,OAAO,EAAE,KAAK,EAAE,MAAM,oDAAoD,CAAA;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,8DAA8D,CAAA;AACvF,OAAO,EAAE,UAAU,EAAE,MAAM,iEAAiE,CAAA;AAC5F,OAAO,EAAE,aAAa,EAAE,MAAM,oEAAoE,CAAA;AAClG,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,+DAA+D,CAAA;AACrH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAc1G;;;;;GAKG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,KAAK,CAAC,UAAU,CAC5D,CAAC,EACD,MAAM,EACN,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,KAAK,EAAE,eAAe,EACtB,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,cAAc,EAAE,kBAAkB,EAClC,WAAW,EACX,YAAY,EACZ,SAAS,GACV,EAAE,GAAG,EAAqB,EAAE;IAC3B,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;IACpC,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;IAE5C,IAAI,QAAQ,GAAG,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,cAAc,CAAC,KAAK,CAAA;IAC/D,IAAI,CAAC,QAAQ,IAAI,YAAY,EAAE,CAAC;QAC9B,oCAAoC;IACtC,CAAC;IAED,MAAM,YAAY,GAAG,QAAQ,EAAE,IAAI,EAAE,YAAY,IAAI,CAAC,CAAA;IAEtD,uCAAuC;IACvC,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAS,YAAY,IAAI,EAAE,CAAC,CAAA;IAEpF,0BAA0B;IAC1B,MAAM,YAAY,GAAG,eAAe,KAAK,SAAS,CAAA;IAClD,MAAM,YAAY,GAAG,YAAY,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,aAAa,CAAA;IAEnE,0EAA0E;IAC1E,MAAM,YAAY,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,QAAgB,EAAE,EAAE;QAC1D,IAAI,YAAY,EAAE,CAAC;YACjB,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAA;QACtB,CAAC;aAAM,CAAC;YACN,gBAAgB,CAAC,QAAQ,CAAC,CAAA;QAC5B,CAAC;IACH,CAAC,EAAE,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAA;IAE5B,kEAAkE;IAClE,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE;QACxC,MAAM,EAAE,EAAE,CAAA;IACZ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAEZ,kCAAkC;IAClC,MAAM,WAAW,GAAG;QAClB,MAAM;QACN,IAAI;QACJ,QAAQ;QACR,QAAQ;QACR,SAAS;QACT,cAAc,EAAE,kBAAkB;QAClC,SAAS;KACV,CAAA;IAED,4BAA4B;IAC5B,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,cAAc,CAAC,KAAK;YACvB,OAAO,CACL,KAAC,KAAK,IACJ,GAAG,EAAE,GAAkC,KACnC,WAAW,EACf,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,WAAW,EACxB,YAAY,EAAE,YAAY,GAC1B,CACH,CAAA;QAEH,KAAK,cAAc,CAAC,QAAQ;YAC1B,OAAO,CACL,KAAC,QAAQ,IACP,GAAG,EAAE,GAAqC,KACtC,WAAW,EACf,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,YAAY,GAClB,CACH,CAAA;QAEH,KAAK,cAAc,CAAC,KAAK;YACvB,OAAO,CACL,KAAC,UAAU,IACT,GAAG,EAAE,GAAkC,KACnC,WAAW,EACf,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,WAAW,GACxB,CACH,CAAA;QAEH,KAAK,cAAc,CAAC,QAAQ;YAC1B,OAAO,CACL,KAAC,aAAa,IACZ,GAAG,EAAE,GAAkC,KACnC,WAAW,EACf,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,WAAW,EACxB,YAAY,EAAE,YAAY,GAC1B,CACH,CAAA;QAEH,KAAK,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;YACxB,MAAM,SAAS,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAA;YAC3C,MAAM,YAAY,GAAG,SAAS,EAAE,SAAS,IAAI,CAAC,CAAA;YAC9C,OAAO,CACL,KAAC,QAAQ,IACP,GAAG,EAAE,GAAkC,EACvC,SAAS,EAAE,YAAY,EACvB,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,QAAQ,YAElB,KAAC,aAAa,cACX,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAC9C,KAAC,YAAY,IAAS,KAAK,EAAE,CAAC,IAAX,CAAC,CAAc,CACnC,CAAC,GACY,GACP,CACZ,CAAA;QACH,CAAC;QAED;YACE,OAAO,CACL,KAAC,KAAK,IACJ,GAAG,EAAE,GAAkC,KACnC,WAAW,EACf,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,WAAW,EACxB,YAAY,EAAE,YAAY,GAC1B,CACH,CAAA;IACL,CAAC;AACH,CAAC,CAAC,CAAA;AAGF,kBAAkB;AAClB,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CACvC,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE;IACtD,MAAM,SAAS,GAAG,8BAA8B,CAC9C,qBAAqB,CAAC,2BAA2B,EACjD,iBAAiB,CAClB,CAAC,MAAM,CAAC,CAAA;IACT,OAAO,KAAC,SAAS,OAAK,KAAK,EAAE,GAAG,EAAE,GAAG,GAAI,CAAA;AAC3C,CAAC,CACF,CAAA;AACD,eAAe,CAAC,WAAW,GAAG,iBAAiB,CAAA"}
+{"version":3,"file":"form-field-string.js","sourceRoot":"","sources":["../../../../../../src/components/form/fields/form-field-string.tsx"],"names":[],"mappings":"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","sourcesContent":["import React, { forwardRef } from 'react'\n\nimport { ControlSize, CorePresetNames, FrontendComponentType } from '@wildo-ai/presets-components-models'\nimport { createComponentResolverWithRef } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper'\n\nimport { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas'\nimport type { ControlBaseProps } from '~wildo-frontend-lib/components/form/form-field-types'\nimport { Input } from \"~wildo-frontend-lib/components/form/controls/input\"\nimport { Textarea } from \"~wildo-frontend-lib/components/form/controls/string/textarea\"\nimport { MarkdownEditor } from \"~wildo-frontend-lib/components/form/controls/string/markdown-editor\"\nimport { ColorInput } from \"~wildo-frontend-lib/components/form/controls/string/color-input\"\nimport { PasswordInput } from \"~wildo-frontend-lib/components/form/controls/string/password-input\"\nimport { InputOTP, InputOTPGroup, InputOTPSlot } from \"~wildo-frontend-lib/components/form/controls/string/input-otp\"\nimport { getStringUI, getStringFormat, getOtpFieldParams, StringEditMode } from \"@wildo-ai/zod-decorators\"\nimport { cn } from '~wildo-frontend-lib/core/ui/cn'\n\n// --- Contract ---\nexport interface FormFieldStringProps extends Omit<ControlBaseProps, 'value' | 'onChange' | 'defaultValue'> {\n  value?: string\n  onChange?: (value: string) => void\n  defaultValue?: string\n  placeholder?: string\n  autoComplete?: string\n  type?: 'text' | 'email' | 'url' | 'password' | 'tel' | 'number'\n}\n\nexport type FormFieldStringRef = HTMLInputElement | HTMLTextAreaElement | HTMLButtonElement | HTMLDivElement\n\n/**\n * FormFieldString component\n *\n * Renders a string field according to the edit policy.\n * Forwards ref to the underlying input/textarea for RHF focus support.\n */\nexport const FormFieldString_Preset_Default = React.forwardRef<FormFieldStringRef, FormFieldStringProps>(\n  ({\n  schema,\n  name,\n  disabled,\n  readOnly,\n  className,\n  value: controlledValue,\n  onChange,\n  onBlur,\n  defaultValue,\n  validationMode: validationModeProp,\n  placeholder,\n  autoComplete,\n  autoFocus,\n  controlSize = ControlSize.MD,\n  type,\n}, ref): React.JSX.Element => {\n  // The HTML default for `<input>` is text-like behavior, but React only\n  // renders a `type` attribute when the prop is defined — `<input\n  // type={undefined} />` produces an element whose `getAttribute('type')`\n  // returns `null`. That's a footgun for downstream tooling (DOM queries,\n  // a11y heuristics, autofill detection) that branches on the explicit\n  // attribute value. Pin the implicit default so callers omitting `type`\n  // still see a stable `text` attribute on the rendered element.\n  const resolvedInputType = type ?? 'text'\n  const stringUI = getStringUI(schema)\n  const stringFormat = getStringFormat(schema)\n\n  let editMode = stringUI?.edit?.editMode ?? StringEditMode.INPUT\n  if (!stringUI && stringFormat) {\n    // Default to input for most formats\n  }\n\n  const textareaRows = stringUI?.edit?.textareaRows ?? 4\n\n  // Internal state for uncontrolled mode\n  const [internalValue, setInternalValue] = React.useState<string>(defaultValue ?? '')\n\n  // Controlled ⇔ the caller supplied a change handler (or a defined value).\n  // An RHF-controlled value is legitimately `undefined` on CREATE surfaces;\n  // deciding by value alone routed user input into internal state and never\n  // called `onChange`, so form state silently stayed empty (`internalValue`\n  // doubles as the stable empty-display fallback while controlled-empty).\n  const isControlled = onChange !== undefined || controlledValue !== undefined\n  const currentValue = controlledValue ?? internalValue\n\n  // Handle value change - validation is handled by parent FormField via RHF\n  const handleChange = React.useCallback((newValue: string) => {\n    if (isControlled) {\n      onChange?.(newValue)\n    } else {\n      setInternalValue(newValue)\n    }\n  }, [isControlled, onChange])\n\n  // Handle blur - validation is handled by parent FormField via RHF\n  const handleBlur = React.useCallback(() => {\n    onBlur?.()\n  }, [onBlur])\n\n  // Common props for all edit modes\n  const commonProps = {\n    schema,\n    name,\n    disabled,\n    readOnly,\n    className,\n    validationMode: validationModeProp,\n    autoFocus,\n    controlSize,\n  }\n\n  // Render based on edit mode\n  switch (editMode) {\n    case StringEditMode.INPUT:\n      return (\n        <Input\n          ref={ref as React.Ref<HTMLInputElement>}\n          {...commonProps}\n          value={currentValue}\n          onChange={handleChange}\n          onBlur={handleBlur}\n          placeholder={placeholder}\n          autoComplete={autoComplete}\n          type={resolvedInputType}\n        />\n      )\n\n    case StringEditMode.TEXTAREA:\n      return (\n        <Textarea\n          ref={ref as React.Ref<HTMLTextAreaElement>}\n          {...commonProps}\n          value={currentValue}\n          onChange={handleChange}\n          onBlur={handleBlur}\n          placeholder={placeholder}\n          rows={textareaRows}\n          autoComplete={autoComplete}\n        />\n      )\n\n    case StringEditMode.MARKDOWN:\n      // Markdown SOURCE editor (registry-resolved; default preset is a\n      // lazy-loaded CodeMirror core). Value stays plain markdown source —\n      // display rendering remains on the MARKDOWN display pipeline.\n      return (\n        <MarkdownEditor\n          value={currentValue}\n          onChange={handleChange}\n          onBlur={handleBlur}\n          placeholder={placeholder}\n          disabled={disabled}\n          readOnly={readOnly}\n          autoFocus={autoFocus}\n          minRows={textareaRows}\n          ariaLabel={name}\n          className={className}\n        />\n      )\n\n    case StringEditMode.COLOR:\n      return (\n        <ColorInput\n          ref={ref as React.Ref<HTMLInputElement>}\n          {...commonProps}\n          value={currentValue}\n          onChange={handleChange}\n          onBlur={handleBlur}\n          placeholder={placeholder}\n        />\n      )\n\n    case StringEditMode.PASSWORD:\n      return (\n        <PasswordInput\n          ref={ref as React.Ref<HTMLInputElement>}\n          {...commonProps}\n          value={currentValue}\n          onChange={handleChange}\n          onBlur={handleBlur}\n          placeholder={placeholder}\n          autoComplete={autoComplete}\n        />\n      )\n\n    case StringEditMode.OTP: {\n      const otpParams = getOtpFieldParams(schema)\n      const otpMaxLength = otpParams?.maxLength ?? 6\n      // NB: this is the one branch that cannot spread `commonProps` wholesale — `InputOTP` is a narrow\n      // control contract (`InputOTPProps`) and does not declare the schema-aware members the text controls\n      // accept (`schema`, `readOnly`, `validationMode`). Every member it DOES declare must still be\n      // forwarded explicitly, or this branch silently drops props every sibling branch honours. That is\n      // exactly what happened to `name` and `className` before: the field rendered `name=\"\"`, so the input\n      // was unaddressable by name (breaking form-name selectors and weakening password-manager heuristics)\n      // and authored classes were ignored. Add the forward here whenever `commonProps` grows a member\n      // `InputOTPProps` declares.\n      return (\n        <InputOTP\n          ref={ref as React.Ref<HTMLInputElement>}\n          name={name}\n          className={className}\n          maxLength={otpMaxLength}\n          value={currentValue}\n          onChange={handleChange}\n          onBlur={handleBlur}\n          disabled={disabled}\n          autoComplete={autoComplete}\n          autoFocus={autoFocus}\n          controlSize={controlSize}\n        >\n          <InputOTPGroup>\n            {Array.from({ length: otpMaxLength }, (_, i) => (\n              <InputOTPSlot key={i} index={i} />\n            ))}\n          </InputOTPGroup>\n        </InputOTP>\n      )\n    }\n\n    default:\n      return (\n        <Input\n          ref={ref as React.Ref<HTMLInputElement>}\n          {...commonProps}\n          value={currentValue}\n          onChange={handleChange}\n          onBlur={handleBlur}\n          placeholder={placeholder}\n          autoComplete={autoComplete}\n          type={resolvedInputType}\n        />\n      )\n  }\n})\n\n// --- Wrapper ---\nexport const FormFieldString = forwardRef<FormFieldStringRef, FormFieldStringProps & ComponentPresetProps>(\n  ({ preset = CorePresetNames.DEFAULT, ...props }, ref) => {\n    const Component = createComponentResolverWithRef<FormFieldStringProps, FormFieldStringRef>(\n      FrontendComponentType.LOW_LEVEL_FORM_FIELD_STRING,\n      'FormFieldString'\n    )(preset)\n    return <Component {...props} ref={ref} />\n  }\n)\nFormFieldString.displayName = 'FormFieldString'\n"]}

package/dist/esm/components/form/fields/form-field-string.labels.d.ts

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

package/dist/esm/components/form/fields/form-field-string.labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-field-string.labels.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/fields/form-field-string.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,mBAAmB,EAEzB,MAAM,qCAAqC,CAAC;AAM7C,eAAO,MAAM,6BAA6B,EAAE,mBAAmB,EAK9D,CAAC"}

package/dist/esm/components/form/fields/form-field-string.labels.js

@@ -0,0 +1,12 @@
+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 LowLevelFormFieldStringLabels = [
+    { ref: 'copied', kind: LabelKind.MESSAGE, purpose: 'Confirmation shown after the string value is copied to the clipboard' },
+    { ref: 'copyToClipboard', kind: LabelKind.ARIA, purpose: 'Accessible label/tooltip for the button that copies the string value' },
+    { ref: 'revealValue', kind: LabelKind.ARIA, purpose: 'Accessible label/tooltip for the control that unmasks a hidden (password) string value' },
+    { ref: 'hideValue', kind: LabelKind.ARIA, purpose: 'Accessible label/tooltip for the control that re-masks a revealed string value' },
+];
+registerComponentLabels(FrontendComponentType.LOW_LEVEL_FORM_FIELD_STRING, LowLevelFormFieldStringLabels);
+//# sourceMappingURL=form-field-string.labels.js.map

package/dist/esm/components/form/fields/form-field-string.labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-field-string.labels.js","sourceRoot":"","sources":["../../../../../../src/components/form/fields/form-field-string.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,SAAS,EAET,uBAAuB,GACxB,MAAM,qCAAqC,CAAC;AAE7C,2EAA2E;AAC3E,6EAA6E;AAC7E,+EAA+E;AAE/E,MAAM,CAAC,MAAM,6BAA6B,GAA0B;IAClE,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,sEAAsE,EAAE;IAC3H,EAAE,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,sEAAsE,EAAE;IACjI,EAAE,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,wFAAwF,EAAE;IAC/I,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,gFAAgF,EAAE;CACtI,CAAC;AACF,uBAAuB,CAAC,qBAAqB,CAAC,2BAA2B,EAAE,6BAA6B,CAAC,CAAC","sourcesContent":["import {\n  FrontendComponentType,\n  LabelKind,\n  type LabellingUnitaryDef,\n  registerComponentLabels,\n} 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 LowLevelFormFieldStringLabels: LabellingUnitaryDef[] = [\n  { ref: 'copied', kind: LabelKind.MESSAGE, purpose: 'Confirmation shown after the string value is copied to the clipboard' },\n  { ref: 'copyToClipboard', kind: LabelKind.ARIA, purpose: 'Accessible label/tooltip for the button that copies the string value' },\n  { ref: 'revealValue', kind: LabelKind.ARIA, purpose: 'Accessible label/tooltip for the control that unmasks a hidden (password) string value' },\n  { ref: 'hideValue', kind: LabelKind.ARIA, purpose: 'Accessible label/tooltip for the control that re-masks a revealed string value' },\n];\nregisterComponentLabels(FrontendComponentType.LOW_LEVEL_FORM_FIELD_STRING, LowLevelFormFieldStringLabels);\n"]}

package/dist/esm/components/form/fields/form-field-time.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
-import { ComponentPresetProps } from '../../../core/components-registry/component-registry.frontend.schemas.js';
-import type { ControlBaseProps } from '../../../components/form/form-field-types.js';
+import { ComponentPresetProps } from '../../../core/components-registry/component-registry.frontend.schemas';
+import type { ControlBaseProps } from '../../../components/form/form-field-types';
 export interface FormFieldTimeProps extends Omit<ControlBaseProps, 'value' | 'onChange' | 'defaultValue'> {
     value?: string;
     onChange?: (value: string | undefined) => void;

package/dist/esm/components/form/fields/form-field-time.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-field-time.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/fields/form-field-time.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqB,MAAM,OAAO,CAAA;AAGzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AACvH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sDAAsD,CAAA;AAQ5F,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,UAAU,GAAG,cAAc,CAAC;IACvG,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAA;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,GAAG,iBAAiB,CAAA;AAGnE,eAAO,MAAM,4BAA4B,6FAWvC,CAAA;AAIF,eAAO,MAAM,aAAa,oHAQzB,CAAA"}
+{"version":3,"file":"form-field-time.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/fields/form-field-time.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqB,MAAM,OAAO,CAAA;AAGzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AACvH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sDAAsD,CAAA;AAM5F,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,UAAU,GAAG,cAAc,CAAC;IACvG,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAA;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,GAAG,iBAAiB,CAAA;AAEnE,eAAO,MAAM,4BAA4B,6FAgBvC,CAAA;AAGF,eAAO,MAAM,aAAa,oHAQzB,CAAA"}

package/dist/esm/components/form/fields/form-field-time.js

@@ -1,12 +1,17 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import React, { forwardRef } from 'react';
-import { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models';
+import { CorePresetNames, FrontendComponentType } from '@wildo-ai/presets-components-models';
 import { createComponentResolverWithRef } from '../../../core/components-registry/component-resolver.frontend.helper.js';
 import { TimePicker } from "../../../components/form/controls/date-time/time-picker.js";
 import { useI18n } from '../../../core/i18n/useI18n.js';
 export const FormFieldTime_Preset_Default = React.forwardRef((props, ref) => {
     const { regionalPreferences, isReady } = useI18n({ component: FrontendComponentType.LOW_LEVEL_FORM_FIELD_TIME });
-    return (_jsx(TimePicker, { ref: ref, ...props, timeFormat: regionalPreferences.timeFormat }));
+    // `regionalPreferences` is null until the i18n bundle resolves (`isReady`), so
+    // optional-chain this read — see form-field-date for the full rationale. Without the
+    // `?.`, a time field rendered on the first pass throws `Cannot read properties of
+    // null` and crashes the form; `undefined` lets the picker fall back to its default
+    // format for that beat and the real preference applies next render.
+    return (_jsx(TimePicker, { ref: ref, ...props, timeFormat: regionalPreferences?.timeFormat }));
 });
 // --- Wrapper ---
 export const FormFieldTime = forwardRef(({ preset = CorePresetNames.DEFAULT, ...props }, ref) => {
@@ -14,4 +19,4 @@ export const FormFieldTime = forwardRef(({ preset = CorePresetNames.DEFAULT, ...
     return _jsx(Component, { ...props, ref: ref });
 });
 FormFieldTime.displayName = 'FormFieldTime';
-//# sourceMappingURL=form-field-time.js.map
+//# sourceMappingURL=form-field-time.js.map

package/dist/esm/components/form/fields/form-field-time.js.map

@@ -1 +1 @@
-{"version":3,"file":"form-field-time.js","sourceRoot":"","sources":["../../../../../src/components/form/fields/form-field-time.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AACzC,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AAC5F,OAAO,EAAE,8BAA8B,EAAE,MAAM,iFAAiF,CAAA;AAKhI,OAAO,EAAE,UAAU,EAAE,MAAM,oEAAoE,CAAA;AAC/F,OAAO,EAAE,OAAO,EAAE,MAAM,uCAAuC,CAAA;AAgB/D,MAAM,CAAC,MAAM,4BAA4B,GAAG,KAAK,CAAC,UAAU,CAC1D,CAAC,KAAK,EAAE,GAAG,EAAqB,EAAE;IAClC,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,EAAE,SAAS,EAAE,qBAAqB,CAAC,yBAAyB,EAAE,CAAC,CAAA;IAEhH,OAAO,CACL,KAAC,UAAU,IACT,GAAG,EAAE,GAAmC,KACnC,KAAyB,EAC9B,UAAU,EAAE,mBAAmB,CAAC,UAAU,GAC1C,CACH,CAAA;AACH,CAAC,CAAC,CAAA;AAGF,kBAAkB;AAClB,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CACrC,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE;IACtD,MAAM,SAAS,GAAG,8BAA8B,CAC9C,qBAAqB,CAAC,yBAAyB,EAC/C,eAAe,CAChB,CAAC,MAAM,CAAC,CAAA;IACT,OAAO,KAAC,SAAS,OAAK,KAAK,EAAE,GAAG,EAAE,GAAG,GAAI,CAAA;AAC3C,CAAC,CACF,CAAA;AACD,aAAa,CAAC,WAAW,GAAG,eAAe,CAAA"}
+{"version":3,"file":"form-field-time.js","sourceRoot":"","sources":["../../../../../../src/components/form/fields/form-field-time.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AACzC,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAA;AAC5F,OAAO,EAAE,8BAA8B,EAAE,MAAM,iFAAiF,CAAA;AAIhI,OAAO,EAAE,UAAU,EAAwB,MAAM,oEAAoE,CAAA;AACrH,OAAO,EAAE,OAAO,EAAE,MAAM,uCAAuC,CAAA;AAc/D,MAAM,CAAC,MAAM,4BAA4B,GAAG,KAAK,CAAC,UAAU,CAC1D,CAAC,KAAK,EAAE,GAAG,EAAqB,EAAE;IAClC,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,EAAE,SAAS,EAAE,qBAAqB,CAAC,yBAAyB,EAAE,CAAC,CAAA;IAEhH,+EAA+E;IAC/E,qFAAqF;IACrF,kFAAkF;IAClF,mFAAmF;IACnF,oEAAoE;IACpE,OAAO,CACL,KAAC,UAAU,IACT,GAAG,EAAE,GAAmC,KACnC,KAAyB,EAC9B,UAAU,EAAE,mBAAmB,EAAE,UAAU,GAC3C,CACH,CAAA;AACH,CAAC,CAAC,CAAA;AAEF,kBAAkB;AAClB,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CACrC,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE;IACtD,MAAM,SAAS,GAAG,8BAA8B,CAC9C,qBAAqB,CAAC,yBAAyB,EAC/C,eAAe,CAChB,CAAC,MAAM,CAAC,CAAA;IACT,OAAO,KAAC,SAAS,OAAK,KAAK,EAAE,GAAG,EAAE,GAAG,GAAI,CAAA;AAC3C,CAAC,CACF,CAAA;AACD,aAAa,CAAC,WAAW,GAAG,eAAe,CAAA","sourcesContent":["import React, { forwardRef } from 'react'\nimport { CorePresetNames, FrontendComponentType } from '@wildo-ai/presets-components-models'\nimport { createComponentResolverWithRef } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper'\nimport { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas'\nimport type { ControlBaseProps } from '~wildo-frontend-lib/components/form/form-field-types'\n\nimport { TimePicker, type TimePickerProps } from \"~wildo-frontend-lib/components/form/controls/date-time/time-picker\"\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n'\n\n// --- Contract ---\nexport interface FormFieldTimeProps extends Omit<ControlBaseProps, 'value' | 'onChange' | 'defaultValue'> {\n  value?: string\n  onChange?: (value: string | undefined) => void\n  defaultValue?: string\n  placeholder?: string\n  minuteStep?: number\n  showSeconds?: boolean\n}\n\nexport type FormFieldTimeRef = HTMLInputElement | HTMLButtonElement\n\nexport const FormFieldTime_Preset_Default = React.forwardRef<FormFieldTimeRef, FormFieldTimeProps>(\n  (props, ref): React.JSX.Element => {\n  const { regionalPreferences, isReady } = useI18n({ component: FrontendComponentType.LOW_LEVEL_FORM_FIELD_TIME })\n\n  // `regionalPreferences` is null until the i18n bundle resolves (`isReady`), so\n  // optional-chain this read — see form-field-date for the full rationale. Without the\n  // `?.`, a time field rendered on the first pass throws `Cannot read properties of\n  // null` and crashes the form; `undefined` lets the picker fall back to its default\n  // format for that beat and the real preference applies next render.\n  return (\n    <TimePicker\n      ref={ref as React.Ref<HTMLButtonElement>}\n      {...(props as TimePickerProps)}\n      timeFormat={regionalPreferences?.timeFormat}\n    />\n  )\n})\n\n// --- Wrapper ---\nexport const FormFieldTime = forwardRef<FormFieldTimeRef, FormFieldTimeProps & ComponentPresetProps>(\n  ({ preset = CorePresetNames.DEFAULT, ...props }, ref) => {\n    const Component = createComponentResolverWithRef<FormFieldTimeProps, FormFieldTimeRef>(\n      FrontendComponentType.LOW_LEVEL_FORM_FIELD_TIME,\n      'FormFieldTime'\n    )(preset)\n    return <Component {...props} ref={ref} />\n  }\n)\nFormFieldTime.displayName = 'FormFieldTime'\n"]}

package/dist/esm/components/form/fields/form-field-time.labels.d.ts

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

package/dist/esm/components/form/fields/form-field-time.labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-field-time.labels.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/fields/form-field-time.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,mBAAmB,EAA2B,MAAM,qCAAqC,CAAC;AAM/H,eAAO,MAAM,2BAA2B,EAAE,mBAAmB,EAAO,CAAC"}

package/dist/esm/components/form/fields/form-field-time.labels.js

@@ -0,0 +1,7 @@
+import { FrontendComponentType, 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 LowLevelFormFieldTimeLabels = [];
+registerComponentLabels(FrontendComponentType.LOW_LEVEL_FORM_FIELD_TIME, LowLevelFormFieldTimeLabels);
+//# sourceMappingURL=form-field-time.labels.js.map

package/dist/esm/components/form/fields/form-field-time.labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-field-time.labels.js","sourceRoot":"","sources":["../../../../../../src/components/form/fields/form-field-time.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAA4B,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAE/H,2EAA2E;AAC3E,6EAA6E;AAC7E,+EAA+E;AAE/E,MAAM,CAAC,MAAM,2BAA2B,GAA0B,EAAE,CAAC;AACrE,uBAAuB,CAAC,qBAAqB,CAAC,yBAAyB,EAAE,2BAA2B,CAAC,CAAC","sourcesContent":["import { FrontendComponentType, 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 LowLevelFormFieldTimeLabels: LabellingUnitaryDef[] = [];\nregisterComponentLabels(FrontendComponentType.LOW_LEVEL_FORM_FIELD_TIME, LowLevelFormFieldTimeLabels);\n"]}

package/dist/esm/components/form/fields/useFormField.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFormField.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/fields/useFormField.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAgC,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAIhG,KAAK,qBAAqB,CACxB,YAAY,SAAS,WAAW,GAAG,WAAW,EAC9C,KAAK,SAAS,SAAS,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC,YAAY,CAAC,IAC7D;IACF,IAAI,EAAE,KAAK,CAAA;CACZ,CAAA;AAED,eAAO,MAAM,gBAAgB,2DAE5B,CAAA;AAED,KAAK,oBAAoB,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAA;CACX,CAAA;AAED,eAAO,MAAM,eAAe,qCAE3B,CAAA;AAID,KAAK,kBAAkB,GAAG;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,iBAAiB,EAAE,MAAM,CAAA;IACzB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,OAAO,CAAA;IAClB,YAAY,EAAE,OAAO,CAAA;IACrB,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC7B,CAAA;AAED,eAAO,MAAM,YAAY,QAAO,kBAqB/B,CAAA"}
+{"version":3,"file":"useFormField.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/fields/useFormField.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAgC,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAIhG,KAAK,qBAAqB,CACxB,YAAY,SAAS,WAAW,GAAG,WAAW,EAC9C,KAAK,SAAS,SAAS,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC,YAAY,CAAC,IAC7D;IACF,IAAI,EAAE,KAAK,CAAA;CACZ,CAAA;AAED,eAAO,MAAM,gBAAgB,2DAE5B,CAAA;AAED,KAAK,oBAAoB,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAA;CACX,CAAA;AAED,eAAO,MAAM,eAAe,qCAE3B,CAAA;AAID,KAAK,kBAAkB,GAAG;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,iBAAiB,EAAE,MAAM,CAAA;IACzB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,OAAO,CAAA;IAClB,YAAY,EAAE,OAAO,CAAA;IACrB,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC7B,CAAA;AAED,eAAO,MAAM,YAAY,QAAO,kBAqB/B,CAAA"}

package/dist/esm/components/form/fields/useFormField.js

@@ -28,4 +28,4 @@ export const useFormField = () => {
         ...fieldState,
     };
 };
-//# sourceMappingURL=useFormField.js.map
+//# sourceMappingURL=useFormField.js.map

package/dist/esm/components/form/fields/useFormField.js.map

@@ -1 +1 @@
-{"version":3,"file":"useFormField.js","sourceRoot":"","sources":["../../../../../src/components/form/fields/useFormField.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAoC,MAAM,iBAAiB,CAAA;AAWhG,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC,aAAa,CACjD,EAA2B,CAC5B,CAAA;AAMD,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC,aAAa,CAChD,EAA0B,CAC3B,CAAA;AAiBD,MAAM,CAAC,MAAM,YAAY,GAAG,GAAuB,EAAE;IACnD,MAAM,YAAY,GAAG,KAAK,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAA;IACvD,MAAM,WAAW,GAAG,KAAK,CAAC,UAAU,CAAC,eAAe,CAAC,CAAA;IACrD,MAAM,EAAE,aAAa,EAAE,GAAG,cAAc,EAAE,CAAA;IAC1C,MAAM,SAAS,GAAG,YAAY,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,CAAC,CAAA;IAC3D,MAAM,UAAU,GAAG,aAAa,CAAC,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;IAE9D,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAA;IACnE,CAAC;IAED,MAAM,EAAE,EAAE,EAAE,GAAG,WAAW,CAAA;IAE1B,OAAO;QACL,EAAE;QACF,IAAI,EAAE,YAAY,CAAC,IAAI;QACvB,UAAU,EAAE,GAAG,EAAE,YAAY;QAC7B,iBAAiB,EAAE,GAAG,EAAE,wBAAwB;QAChD,aAAa,EAAE,GAAG,EAAE,oBAAoB;QACxC,GAAG,UAAU;KACd,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"useFormField.js","sourceRoot":"","sources":["../../../../../../src/components/form/fields/useFormField.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAoC,MAAM,iBAAiB,CAAA;AAWhG,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC,aAAa,CACjD,EAA2B,CAC5B,CAAA;AAMD,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC,aAAa,CAChD,EAA0B,CAC3B,CAAA;AAiBD,MAAM,CAAC,MAAM,YAAY,GAAG,GAAuB,EAAE;IACnD,MAAM,YAAY,GAAG,KAAK,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAA;IACvD,MAAM,WAAW,GAAG,KAAK,CAAC,UAAU,CAAC,eAAe,CAAC,CAAA;IACrD,MAAM,EAAE,aAAa,EAAE,GAAG,cAAc,EAAE,CAAA;IAC1C,MAAM,SAAS,GAAG,YAAY,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,CAAC,CAAA;IAC3D,MAAM,UAAU,GAAG,aAAa,CAAC,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;IAE9D,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAA;IACnE,CAAC;IAED,MAAM,EAAE,EAAE,EAAE,GAAG,WAAW,CAAA;IAE1B,OAAO;QACL,EAAE;QACF,IAAI,EAAE,YAAY,CAAC,IAAI;QACvB,UAAU,EAAE,GAAG,EAAE,YAAY;QAC7B,iBAAiB,EAAE,GAAG,EAAE,wBAAwB;QAChD,aAAa,EAAE,GAAG,EAAE,oBAAoB;QACxC,GAAG,UAAU;KACd,CAAA;AACH,CAAC,CAAA","sourcesContent":["/**\n * useFormField Hook\n *\n * Reads from FormFieldContext and FormItemContext to provide form field\n * state (error, dirty, touched, etc.) and deterministic IDs for aria attributes.\n * Separated from form-primitives.tsx for React Fast Refresh compatibility.\n */\n\nimport * as React from 'react'\nimport { useFormContext, useFormState, type FieldValues, type FieldPath } from 'react-hook-form'\n\n// ── Contexts (shared with form-primitive preset implementations) ──\n\ntype FormFieldContextValue<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n> = {\n  name: TName\n}\n\nexport const FormFieldContext = React.createContext<FormFieldContextValue>(\n  {} as FormFieldContextValue\n)\n\ntype FormItemContextValue = {\n  id: string\n}\n\nexport const FormItemContext = React.createContext<FormItemContextValue>(\n  {} as FormItemContextValue\n)\n\n// ── Hook ──\n\ntype UseFormFieldReturn = {\n  id: string\n  name: string\n  formItemId: string\n  formDescriptionId: string\n  formMessageId: string\n  invalid: boolean\n  isDirty: boolean\n  isTouched: boolean\n  isValidating: boolean\n  error?: { message?: string }\n}\n\nexport const useFormField = (): UseFormFieldReturn => {\n  const fieldContext = React.useContext(FormFieldContext)\n  const itemContext = React.useContext(FormItemContext)\n  const { getFieldState } = useFormContext()\n  const formState = useFormState({ name: fieldContext.name })\n  const fieldState = getFieldState(fieldContext.name, formState)\n\n  if (!fieldContext) {\n    throw new Error(\"useFormField should be used within <FormField>\")\n  }\n\n  const { id } = itemContext\n\n  return {\n    id,\n    name: fieldContext.name,\n    formItemId: `${id}-form-item`,\n    formDescriptionId: `${id}-form-item-description`,\n    formMessageId: `${id}-form-item-message`,\n    ...fieldState,\n  }\n}\n"]}

package/dist/esm/components/form/form-context.d.ts

@@ -6,10 +6,16 @@
 import React from 'react';
 import { z } from 'zod';
 import { UseFormReturn } from 'react-hook-form';
-import type { NavigationZone } from '../../core/navigation/navigation.schemas.js';
-import { type ValidationMode } from './form-field-types.js';
+import type { NavigationZone } from '../../core/navigation/navigation.schemas';
+import type { FrontendResource_ParentResourceRequirement } from '../../core/resources/resource-path.frontend.schemas';
+import { FormSchemaKind, type ValidationMode } from './form-field-types';
 export interface FormSchemaContextType {
     schema: z.ZodTypeAny;
+    /**
+     * Which KIND of schema `schema` is. Decides how field clearability is answered — see
+     * {@link FormSchemaKind}. Defaults to REQUEST_DTO, which is what every resource form supplies.
+     */
+    schemaKind: FormSchemaKind;
     form: UseFormReturn<any>;
     /** Resource type for i18n field label lookup (optional) */
     resourceType?: string;
@@ -40,6 +46,11 @@ export interface FormSchemaContextType {
         fieldIdentifier: string;
         resourceId: string;
     }>;
+    /**
+     * Route parent evidence supplied by the resource surface. Generated relationship
+     * fields use it when the current context has no serializable identifiers yet.
+     */
+    parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];
     /**
      * Current navigation zone hosting this form surface.
      *
@@ -56,6 +67,8 @@ export interface FormSchemaContextType {
 export declare const FormSchemaContext: React.Context<FormSchemaContextType | null>;
 export interface FormSchemaProviderProps {
     schema: z.ZodTypeAny;
+    /** Which kind of schema is being validated — see {@link FormSchemaKind}. @default REQUEST_DTO */
+    schemaKind?: FormSchemaKind;
     form: UseFormReturn<any>;
     /** Resource type for i18n field label lookup (optional) */
     resourceType?: string;
@@ -72,11 +85,13 @@ export interface FormSchemaProviderProps {
         fieldIdentifier: string;
         resourceId: string;
     }>;
+    /** Route parent evidence for generated relationship mutation surfaces */
+    parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];
     /** Current navigation zone for quick-create-aware field controls */
     navigationZone?: NavigationZone;
     children: React.ReactNode;
 }
-export declare function FormSchemaProvider({ schema, form, resourceType, validationMode, validateFieldUrl, resourceId, operationType, contextResourceIdentifiers, navigationZone, children, }: FormSchemaProviderProps): React.JSX.Element;
+export declare function FormSchemaProvider({ schema, schemaKind, form, resourceType, validationMode, validateFieldUrl, resourceId, operationType, contextResourceIdentifiers, parentResourcesRequirements, navigationZone, children, }: FormSchemaProviderProps): React.JSX.Element;
 /**
  * Error type set by ResourceAutomatedForm when injecting server-side validation errors.
  * Used to distinguish server errors from client-side Zod validation errors.

package/dist/esm/components/form/form-context.d.ts.map

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

package/dist/esm/components/form/form-context.js

@@ -6,13 +6,14 @@ import { jsx as _jsx } from "react/jsx-runtime";
  */
 import { createContext, useMemo } from 'react';
 import { FormProvider } from 'react-hook-form';
+import { FormSchemaKind } from './form-field-types.js';
 /**
  * Form Schema Context
  * Exported for use in separate hook file (Fast Refresh compatibility)
  * @internal - Use useFormSchemaContext() hook instead of accessing this directly
  */
 export const FormSchemaContext = createContext(null);
-export function FormSchemaProvider({ schema, form, resourceType, validationMode, validateFieldUrl, resourceId, operationType, contextResourceIdentifiers, navigationZone, children, }) {
+export function FormSchemaProvider({ schema, schemaKind = FormSchemaKind.REQUEST_DTO, form, resourceType, validationMode, validateFieldUrl, resourceId, operationType, contextResourceIdentifiers, parentResourcesRequirements, navigationZone, children, }) {
     // Memoize the context value to prevent cascading re-renders.
     // Without this, every render of the provider creates a new object reference,
     // forcing every useFormSchemaContext() consumer to re-render.
@@ -22,8 +23,12 @@ export function FormSchemaProvider({ schema, form, resourceType, validationMode,
         ? JSON.stringify(Object.entries(contextResourceIdentifiers)
             .sort(([a], [b]) => a.localeCompare(b)))
         : undefined;
+    const parentResourcesRequirementsKey = parentResourcesRequirements
+        ? JSON.stringify(parentResourcesRequirements)
+        : undefined;
     const contextValue = useMemo(() => ({
         schema,
+        schemaKind,
         form,
         resourceType,
         validationMode,
@@ -31,10 +36,11 @@ export function FormSchemaProvider({ schema, form, resourceType, validationMode,
         resourceId,
         operationType,
         contextResourceIdentifiers,
+        parentResourcesRequirements,
         navigationZone,
     }), 
-    // eslint-disable-next-line react-hooks/exhaustive-deps -- using stable key for contextResourceIdentifiers object
-    [schema, form, resourceType, validationMode, validateFieldUrl, resourceId, operationType, contextResourceIdentifiersKey, navigationZone]);
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- using stable keys for context objects
+    [schema, schemaKind, form, resourceType, validationMode, validateFieldUrl, resourceId, operationType, contextResourceIdentifiersKey, parentResourcesRequirementsKey, navigationZone]);
     return (_jsx(FormSchemaContext.Provider, { value: contextValue, children: _jsx(FormProvider, { ...form, children: children }) }));
 }
 // =============================================================================
@@ -56,4 +62,4 @@ export const UNIQUE_ERROR_TYPE = 'server-unique';
  * Uses a namespaced value to avoid collision with Zod's 'custom' issue code from .refine().
  */
 export const DUPLICATE_KEY_ERROR_TYPE = 'record-duplicate-key';
-//# sourceMappingURL=form-context.js.map
+//# sourceMappingURL=form-context.js.map

package/dist/esm/components/form/form-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"form-context.js","sourceRoot":"","sources":["../../../../src/components/form/form-context.tsx"],"names":[],"mappings":";AAAA;;;;GAIG;AAEH,OAAc,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEtD,OAAO,EAAiB,YAAY,EAAE,MAAM,iBAAiB,CAAC;AA2C9D;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAgD,aAAa,CAA+B,IAAI,CAAC,CAAC;AAsBhI,MAAM,UAAU,kBAAkB,CAAC,EACjC,MAAM,EACN,IAAI,EACJ,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,0BAA0B,EAC1B,cAAc,EACd,QAAQ,GACgB;IACxB,6DAA6D;IAC7D,6EAA6E;IAC7E,8DAA8D;IAE9D,yFAAyF;IACzF,kFAAkF;IAClF,MAAM,6BAA6B,GAAG,0BAA0B;QAC9D,CAAC,CAAC,IAAI,CAAC,SAAS,CACZ,MAAM,CAAC,OAAO,CAAC,0BAA0B,CAAC;aACvC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAC1C;QACH,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,YAAY,GAAG,OAAO,CAC1B,GAAG,EAAE,CAAC,CAAC;QACL,MAAM;QACN,IAAI;QACJ,YAAY;QACZ,cAAc;QACd,gBAAgB;QAChB,UAAU;QACV,aAAa;QACb,0BAA0B;QAC1B,cAAc;KACf,CAAC;IACF,iHAAiH;IACjH,CAAC,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAE,aAAa,EAAE,6BAA6B,EAAE,cAAc,CAAC,CACzI,CAAC;IAEF,OAAO,CACL,KAAC,iBAAiB,CAAC,QAAQ,IAAC,KAAK,EAAE,YAAY,YAC7C,KAAC,YAAY,OAAK,IAAI,YACnB,QAAQ,GACI,GACY,CAC9B,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,iCAAiC;AACjC,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAiB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAwB,CAAC;AAE1D;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,sBAA+B,CAAC"}
+{"version":3,"file":"form-context.js","sourceRoot":"","sources":["../../../../../src/components/form/form-context.tsx"],"names":[],"mappings":";AAAA;;;;GAIG;AAEH,OAAc,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEtD,OAAO,EAAiB,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAI9D,OAAO,EAAE,cAAc,EAAuB,MAAM,oBAAoB,CAAC;AAkDzE;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAgD,aAAa,CAA+B,IAAI,CAAC,CAAC;AA0BhI,MAAM,UAAU,kBAAkB,CAAC,EACjC,MAAM,EACN,UAAU,GAAG,cAAc,CAAC,WAAW,EACvC,IAAI,EACJ,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,0BAA0B,EAC1B,2BAA2B,EAC3B,cAAc,EACd,QAAQ,GACgB;IACxB,6DAA6D;IAC7D,6EAA6E;IAC7E,8DAA8D;IAE9D,yFAAyF;IACzF,kFAAkF;IAClF,MAAM,6BAA6B,GAAG,0BAA0B;QAC9D,CAAC,CAAC,IAAI,CAAC,SAAS,CACZ,MAAM,CAAC,OAAO,CAAC,0BAA0B,CAAC;aACvC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAC1C;QACH,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,8BAA8B,GAAG,2BAA2B;QAChE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,2BAA2B,CAAC;QAC7C,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,YAAY,GAAG,OAAO,CAC1B,GAAG,EAAE,CAAC,CAAC;QACL,MAAM;QACN,UAAU;QACV,IAAI;QACJ,YAAY;QACZ,cAAc;QACd,gBAAgB;QAChB,UAAU;QACV,aAAa;QACb,0BAA0B;QAC1B,2BAA2B;QAC3B,cAAc;KACf,CAAC;IACF,gGAAgG;IAChG,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAE,aAAa,EAAE,6BAA6B,EAAE,8BAA8B,EAAE,cAAc,CAAC,CACrL,CAAC;IAEF,OAAO,CACL,KAAC,iBAAiB,CAAC,QAAQ,IAAC,KAAK,EAAE,YAAY,YAC7C,KAAC,YAAY,OAAK,IAAI,YACnB,QAAQ,GACI,GACY,CAC9B,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,iCAAiC;AACjC,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAiB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAwB,CAAC;AAE1D;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,sBAA+B,CAAC","sourcesContent":["/**\n * Form Context\n * \n * Provides schema access to child form components.\n */\n\nimport React, { createContext, useMemo } from 'react';\nimport { z } from 'zod';\nimport { UseFormReturn, FormProvider } from 'react-hook-form';\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\nimport { FormSchemaKind, type ValidationMode } from './form-field-types';\n\nexport interface FormSchemaContextType {\n  schema: z.ZodTypeAny;\n  /**\n   * Which KIND of schema `schema` is. Decides how field clearability is answered — see\n   * {@link FormSchemaKind}. Defaults to REQUEST_DTO, which is what every resource form supplies.\n   */\n  schemaKind: FormSchemaKind;\n  form: UseFormReturn<any>;\n  /** Resource type for i18n field label lookup (optional) */\n  resourceType?: string;\n  /** Form-level validation mode - applies to all fields unless overridden */\n  validationMode?: ValidationMode;\n  /** \n   * Base URL for the validate-field endpoint (e.g., \"/api/v1/todos/validate-field\").\n   * When present, fields with isUnique() decorator will trigger server-side uniqueness checks on blur.\n   */\n  validateFieldUrl?: string;\n  /**\n   * Resource ID for UPDATE operations. Used as excludeId in uniqueness checks\n   * to avoid false conflicts with the resource's own current values.\n   */\n  resourceId?: string;\n  /**\n   * Current operation type (e.g., 'create', 'update', or custom operation names).\n   * Used by operation-aware decorators like isNotEditable({ operations: ['update'] })\n   * to determine field editability based on the current form operation.\n   */\n  operationType?: string;\n  /**\n   * Resource context identifiers map: ResourceType → resourceId | { fieldIdentifier, resourceId }.\n   * Propagated from FrontendResourceOperationContext so that nested field components\n   * (e.g., FK display/edit) can build correct scoped URLs and context-aware searches.\n   */\n  contextResourceIdentifiers?: Record<string, string | { fieldIdentifier: string; resourceId: string }>;\n  /**\n   * Route parent evidence supplied by the resource surface. Generated relationship\n   * fields use it when the current context has no serializable identifiers yet.\n   */\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n  /**\n   * Current navigation zone hosting this form surface.\n   *\n   * Quick-create workflows need the source zone so they can open a temporary\n   * create surface without replacing the form currently being edited.\n   */\n  navigationZone?: NavigationZone;\n}\n\n/**\n * Form Schema Context\n * Exported for use in separate hook file (Fast Refresh compatibility)\n * @internal - Use useFormSchemaContext() hook instead of accessing this directly\n */\nexport const FormSchemaContext: React.Context<FormSchemaContextType | null> = createContext<FormSchemaContextType | null>(null);\n\nexport interface FormSchemaProviderProps {\n  schema: z.ZodTypeAny;\n  /** Which kind of schema is being validated — see {@link FormSchemaKind}. @default REQUEST_DTO */\n  schemaKind?: FormSchemaKind;\n  form: UseFormReturn<any>;\n  /** Resource type for i18n field label lookup (optional) */\n  resourceType?: string;\n  /** Form-level validation mode - applies to all fields unless overridden by decorator or prop */\n  validationMode?: ValidationMode;\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 */\n  contextResourceIdentifiers?: Record<string, string | { fieldIdentifier: string; resourceId: string }>;\n  /** Route parent evidence for generated relationship mutation surfaces */\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n  /** Current navigation zone for quick-create-aware field controls */\n  navigationZone?: NavigationZone;\n  children: React.ReactNode;\n}\n\nexport function FormSchemaProvider({\n  schema,\n  schemaKind = FormSchemaKind.REQUEST_DTO,\n  form,\n  resourceType,\n  validationMode,\n  validateFieldUrl,\n  resourceId,\n  operationType,\n  contextResourceIdentifiers,\n  parentResourcesRequirements,\n  navigationZone,\n  children,\n}: FormSchemaProviderProps): React.JSX.Element {\n  // Memoize the context value to prevent cascading re-renders.\n  // Without this, every render of the provider creates a new object reference,\n  // forcing every useFormSchemaContext() consumer to re-render.\n  \n  // Stabilize contextResourceIdentifiers — object reference changes on every parent render\n  // but we only care about value changes. Use a sorted JSON key for dep comparison.\n  const contextResourceIdentifiersKey = contextResourceIdentifiers\n    ? JSON.stringify(\n        Object.entries(contextResourceIdentifiers)\n          .sort(([a], [b]) => a.localeCompare(b))\n      )\n    : undefined;\n  const parentResourcesRequirementsKey = parentResourcesRequirements\n    ? JSON.stringify(parentResourcesRequirements)\n    : undefined;\n  \n  const contextValue = useMemo(\n    () => ({\n      schema,\n      schemaKind,\n      form,\n      resourceType,\n      validationMode,\n      validateFieldUrl,\n      resourceId,\n      operationType,\n      contextResourceIdentifiers,\n      parentResourcesRequirements,\n      navigationZone,\n    }),\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- using stable keys for context objects\n    [schema, schemaKind, form, resourceType, validationMode, validateFieldUrl, resourceId, operationType, contextResourceIdentifiersKey, parentResourcesRequirementsKey, navigationZone]\n  );\n  \n  return (\n    <FormSchemaContext.Provider value={contextValue}>\n      <FormProvider {...form}>\n        {children}\n      </FormProvider>\n    </FormSchemaContext.Provider>\n  );\n}\n\n// =============================================================================\n// ERROR CATEGORIZATION CONSTANTS\n// =============================================================================\n\n/**\n * Error type set by ResourceAutomatedForm when injecting server-side validation errors.\n * Used to distinguish server errors from client-side Zod validation errors.\n */\nexport const SERVER_ERROR_TYPE = 'server' as const;\n\n/**\n * Error type set by the uniqueness pre-validation hook when a field value\n * conflicts with an existing resource. Distinguished from SERVER_ERROR_TYPE\n * (which is set post-submission) to allow targeted UI treatment (e.g., checking spinner).\n */\nexport const UNIQUE_ERROR_TYPE = 'server-unique' as const;\n\n/**\n * Error type set by FormFieldRecord when duplicate keys are detected in a record field.\n * Uses a namespaced value to avoid collision with Zod's 'custom' issue code from .refine().\n */\nexport const DUPLICATE_KEY_ERROR_TYPE = 'record-duplicate-key' as const;\n\n/** Flattened error entry with optional type from RHF */\nexport interface FlattenedError {\n  path: string;\n  message: string;\n  /** Error type (e.g., 'server' for server validation errors, 'required', 'pattern', etc.) */\n  type?: string;\n}\n\n/**\n * Categorized errors result.\n * Separates field-level errors from cross-field (schema-level) errors\n * and server-side validation errors.\n */\nexport interface CategorizedErrors {\n  /** Client-side errors with a specific field path (display inline under fields) */\n  fieldErrors: Array<FlattenedError>;\n  /** Errors without a specific path or from schema-level refinements (display in summary) */\n  crossFieldErrors: Array<FlattenedError>;\n  /** Server-side validation errors (type: 'server') that should be shown in summary banner */\n  serverErrors: Array<FlattenedError>;\n}"]}

package/dist/esm/components/form/form-context.utils.d.ts

@@ -1,5 +1,5 @@
 import type { FieldErrors } from 'react-hook-form';
-import { type CategorizedErrors } from './form-context.js';
+import { type CategorizedErrors } from './form-context';
 /**
  * Static utility class for form error categorisation.
  */

package/dist/esm/components/form/form-context.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-context.utils.d.ts","sourceRoot":"","sources":["../../../../src/components/form/form-context.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAA6D,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAKnH;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO;IAEP,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAA8B;IACtE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAW;IAEpD,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAKpC,OAAO,CAAC,MAAM,CAAC,aAAa;IAmB5B;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB;CAoChE"}
+{"version":3,"file":"form-context.utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/form-context.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAA6D,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAKnH;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO;IAEP,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAA8B;IACtE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAW;IAEpD,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAKpC,OAAO,CAAC,MAAM,CAAC,aAAa;IAmB5B;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB;CAgChE"}

package/dist/esm/components/form/form-context.utils.js

@@ -38,12 +38,7 @@ export class FormContextUtils {
         for (const error of allErrors) {
             const isServerError = error.type === SERVER_ERROR_TYPE || error.type === UNIQUE_ERROR_TYPE;
             if (isServerError) {
-                if (FormContextUtils.isCrossFieldErrorPath(error.path)) {
-                    serverErrors.push(error);
-                }
-                else {
-                    fieldErrors.push(error);
-                }
+                serverErrors.push(error);
                 continue;
             }
             if (FormContextUtils.isCrossFieldErrorPath(error.path)) {
@@ -64,4 +59,4 @@ export class FormContextUtils {
         return { fieldErrors, crossFieldErrors, serverErrors };
     }
 }
-//# sourceMappingURL=form-context.utils.js.map
+//# sourceMappingURL=form-context.utils.js.map

package/dist/esm/components/form/form-context.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"form-context.utils.js","sourceRoot":"","sources":["../../../../src/components/form/form-context.utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"form-context.utils.js","sourceRoot":"","sources":["../../../../../src/components/form/form-context.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import type { FieldErrors } from 'react-hook-form';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { SERVER_ERROR_TYPE, UNIQUE_ERROR_TYPE, type FlattenedError, type CategorizedErrors } from './form-context';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('FormErrorCategorization');\n\n/**\n * Static utility class for form error categorisation.\n */\nexport class FormContextUtils {\n  private constructor() {}\n\n  private static readonly ROOT_ERROR_PATHS = new Set(['', 'root', '_']);\n  private static readonly ROOT_ERROR_PREFIX = '_root';\n\n  private static isCrossFieldErrorPath(path: string | undefined): boolean {\n    if (!path) return true;\n    return FormContextUtils.ROOT_ERROR_PATHS.has(path) || path.startsWith(FormContextUtils.ROOT_ERROR_PREFIX);\n  }\n\n  private static flattenErrors(\n    errors: FieldErrors,\n    prefix: string = ''\n  ): Array<FlattenedError> {\n    const result: Array<FlattenedError> = [];\n\n    for (const [key, value] of Object.entries(errors)) {\n      const path = prefix ? `${prefix}.${key}` : key;\n\n      if (value?.message && typeof value.message === 'string') {\n        result.push({ path, message: value.message, type: value.type as string | undefined });\n      } else if (typeof value === 'object' && value !== null) {\n        result.push(...FormContextUtils.flattenErrors(value as FieldErrors, path));\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Categorize form errors into field-level, cross-field, and server errors.\n   */\n  static categorizeErrors(errors: FieldErrors): CategorizedErrors {\n    const allErrors = FormContextUtils.flattenErrors(errors);\n\n    const fieldErrors: Array<FlattenedError> = [];\n    const crossFieldErrors: Array<FlattenedError> = [];\n    const serverErrors: Array<FlattenedError> = [];\n\n    for (const error of allErrors) {\n      const isServerError = error.type === SERVER_ERROR_TYPE || error.type === UNIQUE_ERROR_TYPE;\n      if (isServerError) {\n        serverErrors.push(error);\n        continue;\n      }\n\n      if (FormContextUtils.isCrossFieldErrorPath(error.path)) {\n        crossFieldErrors.push(error);\n      } else {\n        fieldErrors.push(error);\n      }\n    }\n\n    logDebug('categorizeErrors', {\n      totalErrors: allErrors.length,\n      fieldErrors: fieldErrors.length,\n      crossFieldErrors: crossFieldErrors.length,\n      serverErrors: serverErrors.length,\n      serverFields: serverErrors.map(e => e.path),\n      crossFieldPaths: crossFieldErrors.map(e => e.path),\n    });\n\n    return { fieldErrors, crossFieldErrors, serverErrors };\n  }\n}\n"]}