@wildo-ai/saas-frontend-lib 1.0.1

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

@@ -0,0 +1,24 @@
+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';
+export interface FormFieldRangeTimeProps extends Omit<ControlBaseProps, 'value' | 'onChange' | 'defaultValue'> {
+    value?: {
+        from?: string;
+        to?: string;
+    };
+    onChange?: (value: {
+        from?: string;
+        to?: string;
+    } | undefined) => void;
+    defaultValue?: {
+        from?: string;
+        to?: string;
+    };
+    placeholder?: string;
+    minuteStep?: number;
+    showSeconds?: boolean;
+}
+export type FormFieldRangeTimeRef = HTMLButtonElement;
+export declare const FormFieldRangeTime_Preset_Default: React.ForwardRefExoticComponent<FormFieldRangeTimeProps & React.RefAttributes<HTMLButtonElement>>;
+export declare const FormFieldRangeTime: React.ForwardRefExoticComponent<FormFieldRangeTimeProps & ComponentPresetProps & React.RefAttributes<HTMLButtonElement>>;
+//# sourceMappingURL=form-field-range-time.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"form-field-range-time.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/fields/form-field-range-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,uBAAwB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,UAAU,GAAG,cAAc,CAAC;IAC5G,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACtC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,KAAK,IAAI,CAAA;IACtE,YAAY,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,CAAA;AAGrD,eAAO,MAAM,iCAAiC,mGAa5C,CAAA;AAIF,eAAO,MAAM,kBAAkB,0HAQ9B,CAAA"}

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

@@ -0,0 +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 { createComponentResolverWithRef } from '../../../core/components-registry/component-resolver.frontend.helper.js';
+import { TimeRangePicker } from "../../../components/form/controls/date-time/time-range-picker.js";
+import { useI18n } from "@wildo-ai/saas-frontend-lib";
+export const FormFieldRangeTime_Preset_Default = React.forwardRef((props, ref) => {
+    const { regionalPreferences, isReady } = useI18n({ component: FrontendComponentType.LOW_LEVEL_FORM_FIELD_RANGE_TIME });
+    return (_jsx(TimeRangePicker, { ref: ref, schema: props.schema, name: props.name, ...props, timeFormat: regionalPreferences.timeFormat }));
+});
+// --- Wrapper ---
+export const FormFieldRangeTime = forwardRef(({ preset = CorePresetNames.DEFAULT, ...props }, ref) => {
+    const Component = createComponentResolverWithRef(FrontendComponentType.LOW_LEVEL_FORM_FIELD_RANGE_TIME, 'FormFieldRangeTime')(preset);
+    return _jsx(Component, { ...props, ref: ref });
+});
+FormFieldRangeTime.displayName = 'FormFieldRangeTime';
+//# sourceMappingURL=form-field-range-time.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"form-field-range-time.js","sourceRoot":"","sources":["../../../../../src/components/form/fields/form-field-range-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;AAIhI,OAAO,EAAE,eAAe,EAAE,MAAM,0EAA0E,CAAA;AAC1G,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAA;AAerD,MAAM,CAAC,MAAM,iCAAiC,GAAG,KAAK,CAAC,UAAU,CAC/D,CAAC,KAAK,EAAE,GAAG,EAAqB,EAAE;IAClC,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,EAAE,SAAS,EAAE,qBAAqB,CAAC,+BAA+B,EAAE,CAAC,CAAA;IAEtH,OAAO,CACL,KAAC,eAAe,IACd,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,KAAK,CAAC,MAAM,EACpB,IAAI,EAAE,KAAK,CAAC,IAAI,KACZ,KAAK,EACT,UAAU,EAAE,mBAAmB,CAAC,UAAU,GAC1C,CACH,CAAA;AACH,CAAC,CAAC,CAAA;AAGF,kBAAkB;AAClB,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAC1C,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE;IACtD,MAAM,SAAS,GAAG,8BAA8B,CAC9C,qBAAqB,CAAC,+BAA+B,EACrD,oBAAoB,CACrB,CAAC,MAAM,CAAC,CAAA;IACT,OAAO,KAAC,SAAS,OAAK,KAAK,EAAE,GAAG,EAAE,GAAG,GAAI,CAAA;AAC3C,CAAC,CACF,CAAA;AACD,kBAAkB,CAAC,WAAW,GAAG,oBAAoB,CAAA"}

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

@@ -0,0 +1,20 @@
+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';
+export interface FormFieldStringProps extends Omit<ControlBaseProps, 'value' | 'onChange' | 'defaultValue'> {
+    value?: string;
+    onChange?: (value: string) => void;
+    defaultValue?: string;
+    placeholder?: string;
+    autoComplete?: string;
+}
+export type FormFieldStringRef = HTMLInputElement | HTMLTextAreaElement | HTMLButtonElement | HTMLDivElement;
+/**
+ * FormFieldString component
+ *
+ * Renders a string field according to the edit policy.
+ * Forwards ref to the underlying input/textarea for RHF focus support.
+ */
+export declare const FormFieldString_Preset_Default: React.ForwardRefExoticComponent<FormFieldStringProps & React.RefAttributes<FormFieldStringRef>>;
+export declare const FormFieldString: React.ForwardRefExoticComponent<FormFieldStringProps & ComponentPresetProps & React.RefAttributes<FormFieldStringRef>>;
+//# sourceMappingURL=form-field-string.d.ts.map

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

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

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

@@ -0,0 +1,78 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React, { forwardRef } from 'react';
+import { FrontendComponentType, CorePresetNames } 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 { 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";
+import { getStringUI, getStringFormat, getOtpFieldParams, StringEditMode } from "@wildo-ai/zod-decorators";
+/**
+ * FormFieldString component
+ *
+ * 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) => {
+    const stringUI = getStringUI(schema);
+    const stringFormat = getStringFormat(schema);
+    let editMode = stringUI?.edit?.editMode ?? StringEditMode.INPUT;
+    if (!stringUI && stringFormat) {
+        // Default to input for most formats
+    }
+    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;
+    // Handle value change - validation is handled by parent FormField via RHF
+    const handleChange = React.useCallback((newValue) => {
+        if (isControlled) {
+            onChange?.(newValue);
+        }
+        else {
+            setInternalValue(newValue);
+        }
+    }, [isControlled, onChange]);
+    // Handle blur - validation is handled by parent FormField via RHF
+    const handleBlur = React.useCallback(() => {
+        onBlur?.();
+    }, [onBlur]);
+    // Common props for all edit modes
+    const commonProps = {
+        schema,
+        name,
+        disabled,
+        readOnly,
+        className,
+        validationMode: validationModeProp,
+        autoFocus,
+    };
+    // 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 }));
+        case StringEditMode.TEXTAREA:
+            return (_jsx(Textarea, { ref: ref, ...commonProps, value: currentValue, onChange: handleChange, onBlur: handleBlur, placeholder: placeholder, rows: textareaRows }));
+        case StringEditMode.COLOR:
+            return (_jsx(ColorInput, { ref: ref, ...commonProps, value: currentValue, onChange: handleChange, onBlur: handleBlur, placeholder: placeholder }));
+        case StringEditMode.PASSWORD:
+            return (_jsx(PasswordInput, { ref: ref, ...commonProps, value: currentValue, onChange: handleChange, onBlur: handleBlur, placeholder: placeholder, autoComplete: autoComplete }));
+        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))) }) }));
+        }
+        default:
+            return (_jsx(Input, { ref: ref, ...commonProps, value: currentValue, onChange: handleChange, onBlur: handleBlur, placeholder: placeholder, autoComplete: autoComplete }));
+    }
+});
+// --- Wrapper ---
+export const FormFieldString = forwardRef(({ preset = CorePresetNames.DEFAULT, ...props }, ref) => {
+    const Component = createComponentResolverWithRef(FrontendComponentType.LOW_LEVEL_FORM_FIELD_STRING, 'FormFieldString')(preset);
+    return _jsx(Component, { ...props, ref: ref });
+});
+FormFieldString.displayName = 'FormFieldString';
+//# sourceMappingURL=form-field-string.js.map

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

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

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

@@ -0,0 +1,15 @@
+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';
+export interface FormFieldTimeProps extends Omit<ControlBaseProps, 'value' | 'onChange' | 'defaultValue'> {
+    value?: string;
+    onChange?: (value: string | undefined) => void;
+    defaultValue?: string;
+    placeholder?: string;
+    minuteStep?: number;
+    showSeconds?: boolean;
+}
+export type FormFieldTimeRef = HTMLInputElement | HTMLButtonElement;
+export declare const FormFieldTime_Preset_Default: React.ForwardRefExoticComponent<FormFieldTimeProps & React.RefAttributes<FormFieldTimeRef>>;
+export declare const FormFieldTime: React.ForwardRefExoticComponent<FormFieldTimeProps & ComponentPresetProps & React.RefAttributes<FormFieldTimeRef>>;
+//# sourceMappingURL=form-field-time.d.ts.map

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

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

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

@@ -0,0 +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 { 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 }));
+});
+// --- Wrapper ---
+export const FormFieldTime = forwardRef(({ preset = CorePresetNames.DEFAULT, ...props }, ref) => {
+    const Component = createComponentResolverWithRef(FrontendComponentType.LOW_LEVEL_FORM_FIELD_TIME, 'FormFieldTime')(preset);
+    return _jsx(Component, { ...props, ref: ref });
+});
+FormFieldTime.displayName = 'FormFieldTime';
+//# sourceMappingURL=form-field-time.js.map

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

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

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

@@ -0,0 +1,34 @@
+/**
+ * useFormField Hook
+ *
+ * Reads from FormFieldContext and FormItemContext to provide form field
+ * state (error, dirty, touched, etc.) and deterministic IDs for aria attributes.
+ * Separated from form-primitives.tsx for React Fast Refresh compatibility.
+ */
+import * as React from 'react';
+import { type FieldValues, type FieldPath } from 'react-hook-form';
+type FormFieldContextValue<TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>> = {
+    name: TName;
+};
+export declare const FormFieldContext: React.Context<FormFieldContextValue<FieldValues, string>>;
+type FormItemContextValue = {
+    id: string;
+};
+export declare const FormItemContext: React.Context<FormItemContextValue>;
+type UseFormFieldReturn = {
+    id: string;
+    name: string;
+    formItemId: string;
+    formDescriptionId: string;
+    formMessageId: string;
+    invalid: boolean;
+    isDirty: boolean;
+    isTouched: boolean;
+    isValidating: boolean;
+    error?: {
+        message?: string;
+    };
+};
+export declare const useFormField: () => UseFormFieldReturn;
+export {};
+//# sourceMappingURL=useFormField.d.ts.map

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

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

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

@@ -0,0 +1,31 @@
+/**
+ * useFormField Hook
+ *
+ * Reads from FormFieldContext and FormItemContext to provide form field
+ * state (error, dirty, touched, etc.) and deterministic IDs for aria attributes.
+ * Separated from form-primitives.tsx for React Fast Refresh compatibility.
+ */
+import * as React from 'react';
+import { useFormContext, useFormState } from 'react-hook-form';
+export const FormFieldContext = React.createContext({});
+export const FormItemContext = React.createContext({});
+export const useFormField = () => {
+    const fieldContext = React.useContext(FormFieldContext);
+    const itemContext = React.useContext(FormItemContext);
+    const { getFieldState } = useFormContext();
+    const formState = useFormState({ name: fieldContext.name });
+    const fieldState = getFieldState(fieldContext.name, formState);
+    if (!fieldContext) {
+        throw new Error("useFormField should be used within <FormField>");
+    }
+    const { id } = itemContext;
+    return {
+        id,
+        name: fieldContext.name,
+        formItemId: `${id}-form-item`,
+        formDescriptionId: `${id}-form-item-description`,
+        formMessageId: `${id}-form-item-message`,
+        ...fieldState,
+    };
+};
+//# sourceMappingURL=useFormField.js.map

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

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

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

@@ -0,0 +1,116 @@
+/**
+ * Form Context
+ *
+ * Provides schema access to child form components.
+ */
+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';
+export interface FormSchemaContextType {
+    schema: z.ZodTypeAny;
+    form: UseFormReturn<any>;
+    /** Resource type for i18n field label lookup (optional) */
+    resourceType?: string;
+    /** Form-level validation mode - applies to all fields unless overridden */
+    validationMode?: ValidationMode;
+    /**
+     * Base URL for the validate-field endpoint (e.g., "/api/v1/todos/validate-field").
+     * When present, fields with isUnique() decorator will trigger server-side uniqueness checks on blur.
+     */
+    validateFieldUrl?: string;
+    /**
+     * Resource ID for UPDATE operations. Used as excludeId in uniqueness checks
+     * to avoid false conflicts with the resource's own current values.
+     */
+    resourceId?: string;
+    /**
+     * Current operation type (e.g., 'create', 'update', or custom operation names).
+     * Used by operation-aware decorators like isNotEditable({ operations: ['update'] })
+     * to determine field editability based on the current form operation.
+     */
+    operationType?: string;
+    /**
+     * Resource context identifiers map: ResourceType → resourceId | { fieldIdentifier, resourceId }.
+     * Propagated from FrontendResourceOperationContext so that nested field components
+     * (e.g., FK display/edit) can build correct scoped URLs and context-aware searches.
+     */
+    contextResourceIdentifiers?: Record<string, string | {
+        fieldIdentifier: string;
+        resourceId: string;
+    }>;
+    /**
+     * Current navigation zone hosting this form surface.
+     *
+     * Quick-create workflows need the source zone so they can open a temporary
+     * create surface without replacing the form currently being edited.
+     */
+    navigationZone?: NavigationZone;
+}
+/**
+ * Form Schema Context
+ * Exported for use in separate hook file (Fast Refresh compatibility)
+ * @internal - Use useFormSchemaContext() hook instead of accessing this directly
+ */
+export declare const FormSchemaContext: React.Context<FormSchemaContextType | null>;
+export interface FormSchemaProviderProps {
+    schema: z.ZodTypeAny;
+    form: UseFormReturn<any>;
+    /** Resource type for i18n field label lookup (optional) */
+    resourceType?: string;
+    /** Form-level validation mode - applies to all fields unless overridden by decorator or prop */
+    validationMode?: ValidationMode;
+    /** Base URL for validate-field endpoint (enables uniqueness pre-validation on blur) */
+    validateFieldUrl?: string;
+    /** Resource ID for UPDATE operations (used as excludeId in uniqueness checks) */
+    resourceId?: string;
+    /** Current operation type for operation-aware decorators (e.g., isNotEditable) */
+    operationType?: string;
+    /** Resource context identifiers for FK context propagation */
+    contextResourceIdentifiers?: Record<string, string | {
+        fieldIdentifier: string;
+        resourceId: string;
+    }>;
+    /** 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;
+/**
+ * Error type set by ResourceAutomatedForm when injecting server-side validation errors.
+ * Used to distinguish server errors from client-side Zod validation errors.
+ */
+export declare const SERVER_ERROR_TYPE: "server";
+/**
+ * Error type set by the uniqueness pre-validation hook when a field value
+ * conflicts with an existing resource. Distinguished from SERVER_ERROR_TYPE
+ * (which is set post-submission) to allow targeted UI treatment (e.g., checking spinner).
+ */
+export declare const UNIQUE_ERROR_TYPE: "server-unique";
+/**
+ * Error type set by FormFieldRecord when duplicate keys are detected in a record field.
+ * Uses a namespaced value to avoid collision with Zod's 'custom' issue code from .refine().
+ */
+export declare const DUPLICATE_KEY_ERROR_TYPE: "record-duplicate-key";
+/** Flattened error entry with optional type from RHF */
+export interface FlattenedError {
+    path: string;
+    message: string;
+    /** Error type (e.g., 'server' for server validation errors, 'required', 'pattern', etc.) */
+    type?: string;
+}
+/**
+ * Categorized errors result.
+ * Separates field-level errors from cross-field (schema-level) errors
+ * and server-side validation errors.
+ */
+export interface CategorizedErrors {
+    /** Client-side errors with a specific field path (display inline under fields) */
+    fieldErrors: Array<FlattenedError>;
+    /** Errors without a specific path or from schema-level refinements (display in summary) */
+    crossFieldErrors: Array<FlattenedError>;
+    /** Server-side validation errors (type: 'server') that should be shown in summary banner */
+    serverErrors: Array<FlattenedError>;
+}
+//# sourceMappingURL=form-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"form-context.d.ts","sourceRoot":"","sources":["../../../../src/components/form/form-context.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAiC,MAAM,OAAO,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAgB,MAAM,iBAAiB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wDAAwD,CAAC;AAE7F,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IACrB,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IACzB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,0BAA0B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtG;;;;;OAKG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAqD,CAAC;AAEhI,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IACrB,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IACzB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gGAAgG;IAChG,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,uFAAuF;IACvF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8DAA8D;IAC9D,0BAA0B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtG,oEAAoE;IACpE,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,wBAAgB,kBAAkB,CAAC,EACjC,MAAM,EACN,IAAI,EACJ,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,0BAA0B,EAC1B,cAAc,EACd,QAAQ,GACT,EAAE,uBAAuB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAqC7C;AAMD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAG,QAAiB,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAG,eAAwB,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAG,sBAA+B,CAAC;AAExE,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,4FAA4F;IAC5F,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,WAAW,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IACnC,2FAA2F;IAC3F,gBAAgB,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IACxC,4FAA4F;IAC5F,YAAY,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;CACrC"}

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

@@ -0,0 +1,59 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Form Context
+ *
+ * Provides schema access to child form components.
+ */
+import { createContext, useMemo } from 'react';
+import { FormProvider } from 'react-hook-form';
+/**
+ * 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, }) {
+    // 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.
+    // Stabilize contextResourceIdentifiers — object reference changes on every parent render
+    // but we only care about value changes. Use a sorted JSON key for dep comparison.
+    const contextResourceIdentifiersKey = contextResourceIdentifiers
+        ? JSON.stringify(Object.entries(contextResourceIdentifiers)
+            .sort(([a], [b]) => a.localeCompare(b)))
+        : undefined;
+    const contextValue = useMemo(() => ({
+        schema,
+        form,
+        resourceType,
+        validationMode,
+        validateFieldUrl,
+        resourceId,
+        operationType,
+        contextResourceIdentifiers,
+        navigationZone,
+    }), 
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- using stable key for contextResourceIdentifiers object
+    [schema, form, resourceType, validationMode, validateFieldUrl, resourceId, operationType, contextResourceIdentifiersKey, navigationZone]);
+    return (_jsx(FormSchemaContext.Provider, { value: contextValue, children: _jsx(FormProvider, { ...form, children: children }) }));
+}
+// =============================================================================
+// ERROR CATEGORIZATION CONSTANTS
+// =============================================================================
+/**
+ * Error type set by ResourceAutomatedForm when injecting server-side validation errors.
+ * Used to distinguish server errors from client-side Zod validation errors.
+ */
+export const SERVER_ERROR_TYPE = 'server';
+/**
+ * Error type set by the uniqueness pre-validation hook when a field value
+ * conflicts with an existing resource. Distinguished from SERVER_ERROR_TYPE
+ * (which is set post-submission) to allow targeted UI treatment (e.g., checking spinner).
+ */
+export const UNIQUE_ERROR_TYPE = 'server-unique';
+/**
+ * Error type set by FormFieldRecord when duplicate keys are detected in a record field.
+ * 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

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

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

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

@@ -0,0 +1,17 @@
+import type { FieldErrors } from 'react-hook-form';
+import { type CategorizedErrors } from './form-context.js';
+/**
+ * Static utility class for form error categorisation.
+ */
+export declare class FormContextUtils {
+    private constructor();
+    private static readonly ROOT_ERROR_PATHS;
+    private static readonly ROOT_ERROR_PREFIX;
+    private static isCrossFieldErrorPath;
+    private static flattenErrors;
+    /**
+     * Categorize form errors into field-level, cross-field, and server errors.
+     */
+    static categorizeErrors(errors: FieldErrors): CategorizedErrors;
+}
+//# sourceMappingURL=form-context.utils.d.ts.map

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

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

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

@@ -0,0 +1,67 @@
+import { LoggerFrontendService } from '../../core/monitoring/logger.frontend.service.js';
+import { SERVER_ERROR_TYPE, UNIQUE_ERROR_TYPE } from './form-context.js';
+const logger = LoggerFrontendService.getLogger();
+const logDebug = logger.debugByType('FormErrorCategorization');
+/**
+ * Static utility class for form error categorisation.
+ */
+export class FormContextUtils {
+    constructor() { }
+    static ROOT_ERROR_PATHS = new Set(['', 'root', '_']);
+    static ROOT_ERROR_PREFIX = '_root';
+    static isCrossFieldErrorPath(path) {
+        if (!path)
+            return true;
+        return FormContextUtils.ROOT_ERROR_PATHS.has(path) || path.startsWith(FormContextUtils.ROOT_ERROR_PREFIX);
+    }
+    static flattenErrors(errors, prefix = '') {
+        const result = [];
+        for (const [key, value] of Object.entries(errors)) {
+            const path = prefix ? `${prefix}.${key}` : key;
+            if (value?.message && typeof value.message === 'string') {
+                result.push({ path, message: value.message, type: value.type });
+            }
+            else if (typeof value === 'object' && value !== null) {
+                result.push(...FormContextUtils.flattenErrors(value, path));
+            }
+        }
+        return result;
+    }
+    /**
+     * Categorize form errors into field-level, cross-field, and server errors.
+     */
+    static categorizeErrors(errors) {
+        const allErrors = FormContextUtils.flattenErrors(errors);
+        const fieldErrors = [];
+        const crossFieldErrors = [];
+        const serverErrors = [];
+        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);
+                }
+                continue;
+            }
+            if (FormContextUtils.isCrossFieldErrorPath(error.path)) {
+                crossFieldErrors.push(error);
+            }
+            else {
+                fieldErrors.push(error);
+            }
+        }
+        logDebug('categorizeErrors', {
+            totalErrors: allErrors.length,
+            fieldErrors: fieldErrors.length,
+            crossFieldErrors: crossFieldErrors.length,
+            serverErrors: serverErrors.length,
+            serverFields: serverErrors.map(e => e.path),
+            crossFieldPaths: crossFieldErrors.map(e => e.path),
+        });
+        return { fieldErrors, crossFieldErrors, serverErrors };
+    }
+}
+//# sourceMappingURL=form-context.utils.js.map

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

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