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

package/dist/esm/components/form/automated/form-field-autocomplete.frontend.utils.d.ts

@@ -0,0 +1,18 @@
+import type { AutocompleteFieldIdentifier, AutocompleteModifier } from '@wildo-ai/zod-decorators';
+type AutoCompleteIdentifierValue = AutocompleteFieldIdentifier | string;
+type AutoCompleteModifierValue = AutocompleteModifier | string;
+export interface BuildFormFieldAutoCompleteParams {
+    identifier?: AutoCompleteIdentifierValue;
+    modifier?: AutoCompleteModifierValue | AutoCompleteModifierValue[];
+}
+/**
+ * Materialize the final HTML autocomplete attribute value from typed decorator
+ * metadata. The runtime HTML attribute is always string-based, so this helper
+ * also accepts plain string tokens to stay compatible with downstream packages
+ * that may still be consuming older generated declaration files. Ordering
+ * follows the HTML token grammar:
+ * grouping -> recipient/contact -> identifier -> final token (`webauthn`).
+ */
+export declare function buildFormFieldAutoCompleteValue({ identifier, modifier, }: BuildFormFieldAutoCompleteParams): string | undefined;
+export {};
+//# sourceMappingURL=form-field-autocomplete.frontend.utils.d.ts.map

package/dist/esm/components/form/automated/form-field-autocomplete.frontend.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-field-autocomplete.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/automated/form-field-autocomplete.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAElC,KAAK,2BAA2B,GAAG,2BAA2B,GAAG,MAAM,CAAC;AACxE,KAAK,yBAAyB,GAAG,oBAAoB,GAAG,MAAM,CAAC;AAE/D,MAAM,WAAW,gCAAgC;IAC/C,UAAU,CAAC,EAAE,2BAA2B,CAAC;IACzC,QAAQ,CAAC,EAAE,yBAAyB,GAAG,yBAAyB,EAAE,CAAC;CACpE;AAoDD;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAAC,EAC9C,UAAU,EACV,QAAQ,GACT,EAAE,gCAAgC,GAAG,MAAM,GAAG,SAAS,CAOvD"}

package/dist/esm/components/form/automated/form-field-autocomplete.frontend.utils.js

@@ -0,0 +1,52 @@
+const GROUPING_MODIFIER_ORDER = [
+    'shipping',
+    'billing',
+];
+const RECIPIENT_MODIFIER_ORDER = [
+    'home',
+    'work',
+    'mobile',
+    'fax',
+    'pager',
+];
+const FINAL_MODIFIER_ORDER = [
+    'webauthn',
+];
+function normalizeAutoCompleteModifiers(modifier) {
+    if (!modifier) {
+        return {
+            leadingModifiers: [],
+            trailingModifiers: [],
+        };
+    }
+    const values = Array.isArray(modifier) ? modifier : [modifier];
+    const uniqueValues = Array.from(new Set(values));
+    const groupingModifier = uniqueValues.find((candidate) => GROUPING_MODIFIER_ORDER.includes(candidate));
+    const recipientModifier = uniqueValues.find((candidate) => RECIPIENT_MODIFIER_ORDER.includes(candidate));
+    const trailingModifier = uniqueValues.find((candidate) => FINAL_MODIFIER_ORDER.includes(candidate));
+    const leadingModifiers = [
+        ...(groupingModifier ? [groupingModifier] : []),
+        ...(recipientModifier ? [recipientModifier] : []),
+    ];
+    const trailingModifiers = trailingModifier ? [trailingModifier] : [];
+    return {
+        leadingModifiers,
+        trailingModifiers,
+    };
+}
+/**
+ * Materialize the final HTML autocomplete attribute value from typed decorator
+ * metadata. The runtime HTML attribute is always string-based, so this helper
+ * also accepts plain string tokens to stay compatible with downstream packages
+ * that may still be consuming older generated declaration files. Ordering
+ * follows the HTML token grammar:
+ * grouping -> recipient/contact -> identifier -> final token (`webauthn`).
+ */
+export function buildFormFieldAutoCompleteValue({ identifier, modifier, }) {
+    if (!identifier) {
+        return undefined;
+    }
+    const { leadingModifiers, trailingModifiers } = normalizeAutoCompleteModifiers(modifier);
+    return [...leadingModifiers, identifier, ...trailingModifiers].join(' ');
+}
+//# sourceMappingURL=form-field-autocomplete.frontend.utils.js.map

package/dist/esm/components/form/automated/form-field-autocomplete.frontend.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-field-autocomplete.frontend.utils.js","sourceRoot":"","sources":["../../../../../../src/components/form/automated/form-field-autocomplete.frontend.utils.ts"],"names":[],"mappings":"AAaA,MAAM,uBAAuB,GAAsB;IACjD,UAAU;IACV,SAAS;CACD,CAAC;AAEX,MAAM,wBAAwB,GAAsB;IAClD,MAAM;IACN,MAAM;IACN,QAAQ;IACR,KAAK;IACL,OAAO;CACC,CAAC;AAEX,MAAM,oBAAoB,GAAsB;IAC9C,UAAU;CACF,CAAC;AAEX,SAAS,8BAA8B,CACrC,QAAkE;IAKlE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,gBAAgB,EAAE,EAAE;YACpB,iBAAiB,EAAE,EAAE;SACtB,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC/D,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAEjD,MAAM,gBAAgB,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,uBAAuB,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IACvG,MAAM,iBAAiB,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,wBAAwB,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IACzG,MAAM,gBAAgB,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,oBAAoB,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IAEpG,MAAM,gBAAgB,GAAG;QACvB,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KAClD,CAAC;IAEF,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAErE,OAAO;QACL,gBAAgB;QAChB,iBAAiB;KAClB,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,+BAA+B,CAAC,EAC9C,UAAU,EACV,QAAQ,GACyB;IACjC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,GAAG,8BAA8B,CAAC,QAAQ,CAAC,CAAC;IACzF,OAAO,CAAC,GAAG,gBAAgB,EAAE,UAAU,EAAE,GAAG,iBAAiB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3E,CAAC","sourcesContent":["import type {\n  AutocompleteFieldIdentifier,\n  AutocompleteModifier,\n} from '@wildo-ai/zod-decorators';\n\ntype AutoCompleteIdentifierValue = AutocompleteFieldIdentifier | string;\ntype AutoCompleteModifierValue = AutocompleteModifier | string;\n\nexport interface BuildFormFieldAutoCompleteParams {\n  identifier?: AutoCompleteIdentifierValue;\n  modifier?: AutoCompleteModifierValue | AutoCompleteModifierValue[];\n}\n\nconst GROUPING_MODIFIER_ORDER: readonly string[] = [\n  'shipping',\n  'billing',\n] as const;\n\nconst RECIPIENT_MODIFIER_ORDER: readonly string[] = [\n  'home',\n  'work',\n  'mobile',\n  'fax',\n  'pager',\n] as const;\n\nconst FINAL_MODIFIER_ORDER: readonly string[] = [\n  'webauthn',\n] as const;\n\nfunction normalizeAutoCompleteModifiers(\n  modifier?: AutoCompleteModifierValue | AutoCompleteModifierValue[],\n): {\n  leadingModifiers: string[];\n  trailingModifiers: string[];\n} {\n  if (!modifier) {\n    return {\n      leadingModifiers: [],\n      trailingModifiers: [],\n    };\n  }\n\n  const values = Array.isArray(modifier) ? modifier : [modifier];\n  const uniqueValues = Array.from(new Set(values));\n\n  const groupingModifier = uniqueValues.find((candidate) => GROUPING_MODIFIER_ORDER.includes(candidate));\n  const recipientModifier = uniqueValues.find((candidate) => RECIPIENT_MODIFIER_ORDER.includes(candidate));\n  const trailingModifier = uniqueValues.find((candidate) => FINAL_MODIFIER_ORDER.includes(candidate));\n\n  const leadingModifiers = [\n    ...(groupingModifier ? [groupingModifier] : []),\n    ...(recipientModifier ? [recipientModifier] : []),\n  ];\n\n  const trailingModifiers = trailingModifier ? [trailingModifier] : [];\n\n  return {\n    leadingModifiers,\n    trailingModifiers,\n  };\n}\n\n/**\n * Materialize the final HTML autocomplete attribute value from typed decorator\n * metadata. The runtime HTML attribute is always string-based, so this helper\n * also accepts plain string tokens to stay compatible with downstream packages\n * that may still be consuming older generated declaration files. Ordering\n * follows the HTML token grammar:\n * grouping -> recipient/contact -> identifier -> final token (`webauthn`).\n */\nexport function buildFormFieldAutoCompleteValue({\n  identifier,\n  modifier,\n}: BuildFormFieldAutoCompleteParams): string | undefined {\n  if (!identifier) {\n    return undefined;\n  }\n\n  const { leadingModifiers, trailingModifiers } = normalizeAutoCompleteModifiers(modifier);\n  return [...leadingModifiers, identifier, ...trailingModifiers].join(' ');\n}\n"]}

package/dist/esm/components/form/automated/generated-relationship-field.helpers.d.ts

@@ -1,5 +1,5 @@
-import type { useFormSchemaContext } from '../../../components/form/useFormSchemaContext.js';
-import type { useResourceRegistry } from '../../../core/resources/useResourceRegistry.js';
+import type { useFormSchemaContext } from '../../../components/form/useFormSchemaContext';
+import type { useResourceRegistry } from '../../../core/resources/useResourceRegistry';
 export declare function warnGeneratedRelationshipActionFailure(params: {
     componentName: string;
     message: string;

package/dist/esm/components/form/automated/generated-relationship-field.helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generated-relationship-field.helpers.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/automated/generated-relationship-field.helpers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0DAA0D,CAAC;AACrG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAMlG,wBAAgB,sCAAsC,CAAC,MAAM,EAAE;IAC7D,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,GAAG,IAAI,CAIP;AAED,wBAAgB,yCAAyC,CAAC,MAAM,EAAE;IAChE,iBAAiB,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IAC3D,QAAQ,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,UAAU,CAAC,CAAC;CAC9D;;;;;;;;;;;;;;;EAkBA"}
+{"version":3,"file":"generated-relationship-field.helpers.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/automated/generated-relationship-field.helpers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0DAA0D,CAAC;AACrG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAMlG,wBAAgB,sCAAsC,CAAC,MAAM,EAAE;IAC7D,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,GAAG,IAAI,CAIP;AAED,wBAAgB,yCAAyC,CAAC,MAAM,EAAE;IAChE,iBAAiB,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IAC3D,QAAQ,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,UAAU,CAAC,CAAC;CAC9D;;;;;;;;;;;;;;;EAmBA"}

package/dist/esm/components/form/automated/generated-relationship-field.helpers.js

@@ -9,13 +9,14 @@ export function warnGeneratedRelationshipActionFailure(params) {
 }
 export function buildGeneratedRelationshipMutationContext(params) {
     const contextResourceIdentifiers = params.formSchemaContext.contextResourceIdentifiers ?? {};
-    const parentResourcesRequirements = Object.keys(contextResourceIdentifiers).length > 0
-        ? FrontendResourceUtils.getInstance().buildParentResourcesRequirements(params.formSchemaContext.resourceType, contextResourceIdentifiers, params.registry)
-        : [];
+    const parentResourcesRequirements = params.formSchemaContext.parentResourcesRequirements
+        ?? (Object.keys(contextResourceIdentifiers).length > 0
+            ? FrontendResourceUtils.getInstance().buildParentResourcesRequirements(params.formSchemaContext.resourceType, contextResourceIdentifiers, params.registry)
+            : []);
     return {
         contextResourceIdentifiers,
         parentResourcesRequirements,
         contextualParameters: FrontendResourceUtils.buildContextualParameters(contextResourceIdentifiers, params.registry),
     };
 }
-//# sourceMappingURL=generated-relationship-field.helpers.js.map
+//# sourceMappingURL=generated-relationship-field.helpers.js.map

package/dist/esm/components/form/automated/generated-relationship-field.helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"generated-relationship-field.helpers.js","sourceRoot":"","sources":["../../../../../src/components/form/automated/generated-relationship-field.helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4DAA4D,CAAC;AAGnG,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AACpG,OAAO,EAAE,SAAS,EAAE,MAAM,uEAAuE,CAAC;AAElG,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,EAAE,CAAC;AAEjD,MAAM,UAAU,sCAAsC,CAAC,MAItD;IACC,IAAI,SAAS,CAAC,aAAa,EAAE,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,aAAa,KAAK,MAAM,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yCAAyC,CAAC,MAGzD;IACC,MAAM,0BAA0B,GAAG,MAAM,CAAC,iBAAiB,CAAC,0BAA0B,IAAI,EAAE,CAAC;IAC7F,MAAM,2BAA2B,GAAG,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC,MAAM,GAAG,CAAC;QACpF,CAAC,CAAC,qBAAqB,CAAC,WAAW,EAAE,CAAC,gCAAgC,CACpE,MAAM,CAAC,iBAAiB,CAAC,YAA4B,EACrD,0BAA0B,EAC1B,MAAM,CAAC,QAAQ,CAChB;QACD,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;QACL,0BAA0B;QAC1B,2BAA2B;QAC3B,oBAAoB,EAAE,qBAAqB,CAAC,yBAAyB,CACnE,0BAA0B,EAC1B,MAAM,CAAC,QAAQ,CAChB;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"generated-relationship-field.helpers.js","sourceRoot":"","sources":["../../../../../../src/components/form/automated/generated-relationship-field.helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4DAA4D,CAAC;AAGnG,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AACpG,OAAO,EAAE,SAAS,EAAE,MAAM,uEAAuE,CAAC;AAElG,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,EAAE,CAAC;AAEjD,MAAM,UAAU,sCAAsC,CAAC,MAItD;IACC,IAAI,SAAS,CAAC,aAAa,EAAE,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,aAAa,KAAK,MAAM,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yCAAyC,CAAC,MAGzD;IACC,MAAM,0BAA0B,GAAG,MAAM,CAAC,iBAAiB,CAAC,0BAA0B,IAAI,EAAE,CAAC;IAC7F,MAAM,2BAA2B,GAAG,MAAM,CAAC,iBAAiB,CAAC,2BAA2B;WACnF,CAAC,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC,MAAM,GAAG,CAAC;YACtD,CAAC,CAAC,qBAAqB,CAAC,WAAW,EAAE,CAAC,gCAAgC,CACpE,MAAM,CAAC,iBAAiB,CAAC,YAA4B,EACrD,0BAA0B,EAC1B,MAAM,CAAC,QAAQ,CAChB;YACD,CAAC,CAAC,EAAE,CAAC,CAAC;IAER,OAAO;QACL,0BAA0B;QAC1B,2BAA2B;QAC3B,oBAAoB,EAAE,qBAAqB,CAAC,yBAAyB,CACnE,0BAA0B,EAC1B,MAAM,CAAC,QAAQ,CAChB;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { ResourceType } from '@wildo-ai/saas-models';\nimport { FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport type { useFormSchemaContext } from '~wildo-frontend-lib/components/form/useFormSchemaContext';\nimport type { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { envLoader } from '~wildo-frontend-lib/core/runtime/env-variable-loader.frontend.service';\n\nconst logger = LoggerFrontendService.getLogger();\n\nexport function warnGeneratedRelationshipActionFailure(params: {\n  componentName: string;\n  message: string;\n  context: Record<string, unknown>;\n}): void {\n  if (envLoader.isDevelopment()) {\n    logger.warn(`[${params.componentName}] ${params.message}`, params.context);\n  }\n}\n\nexport function buildGeneratedRelationshipMutationContext(params: {\n  formSchemaContext: ReturnType<typeof useFormSchemaContext>;\n  registry: ReturnType<typeof useResourceRegistry>['registry'];\n}) {\n  const contextResourceIdentifiers = params.formSchemaContext.contextResourceIdentifiers ?? {};\n  const parentResourcesRequirements = params.formSchemaContext.parentResourcesRequirements\n    ?? (Object.keys(contextResourceIdentifiers).length > 0\n    ? FrontendResourceUtils.getInstance().buildParentResourcesRequirements(\n      params.formSchemaContext.resourceType as ResourceType,\n      contextResourceIdentifiers,\n      params.registry,\n    )\n    : []);\n\n  return {\n    contextResourceIdentifiers,\n    parentResourcesRequirements,\n    contextualParameters: FrontendResourceUtils.buildContextualParameters(\n      contextResourceIdentifiers,\n      params.registry,\n    ),\n  };\n}\n"]}

package/dist/esm/components/form/automated/generated-relationship-field.hooks.d.ts

@@ -1,15 +1,18 @@
 import type { ResourceType } from '@wildo-ai/saas-models';
-import type { ResourceMutationManager } from '../../../core/resources/rmm/ResourceMutationManager.js';
+import type { ResourceMutationManager } from '../../../core/resources/rmm/ResourceMutationManager';
 export declare function useGeneratedRelationshipFieldCommon(params: {
     fieldName: string;
 }): {
     formContext: import("react-hook-form").UseFormReturn<import("react-hook-form").FieldValues, any, import("react-hook-form").FieldValues>;
-    formSchemaContext: import("../form-context.js").FormSchemaContextType;
-    templateContext: import("./FormTemplateContext.js").FormTemplateContextValue;
-    registry: import("../../../index.js").FrontendResourcesRegistry;
-    doOperation: <TResponse = any>(operationPath: import("../../../index.js").OperationPathIdentifier, parameters: import("../../../index.js").ResourceOperationCallParameters | import("../../../index.js").ResourceSearchCallParameters, options?: import("../../../index.js").RequestOptions) => Promise<TResponse>;
+    formSchemaContext: import("../form-context").FormSchemaContextType;
+    templateContext: import("./FormTemplateContext").FormTemplateContextValue;
+    registry: import("../../..").FrontendResourcesRegistry;
+    doOperation: <TResponse = any>(operationPath: import("../../..").OperationPathIdentifier, parameters: import("../../..").ResourceOperationCallParameters | import("../../..").ResourceSearchCallParameters, options?: import("../../..").RequestOptions) => Promise<TResponse>;
     fieldSchema: import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
-    resolvedChromeMode: import("@wildo-ai/zod-decorators").ResponsiveChromeMode;
+    resolvedChromeMode: "hidden" | "inline" | "stacked" | "settings_row" | "compact" | "relaxed" | Partial<Record<import("@wildo-ai/zod-decorators").ViewportBreakpoint, import("@wildo-ai/zod-decorators").EditChromeMode>>;
+    resolvedLabelPlacement: import("@wildo-ai/presets-components-models").AutoLabelPlacement;
+    resolvedControlSize: import("@wildo-ai/presets-components-models").ControlSize;
+    hideInlineErrorForPolicy: boolean;
     fieldLabel: string;
     fieldDescription: string;
     fieldTooltip: string;

package/dist/esm/components/form/automated/generated-relationship-field.hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generated-relationship-field.hooks.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/automated/generated-relationship-field.hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAQ1D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gEAAgE,CAAC;AAU9G,wBAAgB,mCAAmC,CAAC,MAAM,EAAE;IAC1D,SAAS,EAAE,MAAM,CAAC;CACnB;;;;;;;;;;;;;;;;;;;;;EAqCA;AAED,wBAAgB,8CAA8C,CAAC,MAAM,EAAE;IACrE,GAAG,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACrC,6BAA6B,CAAC,EAAE,OAAO,CAAC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,GAAG,IAAI,CAmBP;AAED,MAAM,MAAM,gCAAgC,GAAG,UAAU,CAAC,OAAO,mCAAmC,CAAC,CAAC;AACtG,MAAM,MAAM,iCAAiC,GAAG,YAAY,CAAC"}
+{"version":3,"file":"generated-relationship-field.hooks.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/automated/generated-relationship-field.hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAQ1D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gEAAgE,CAAC;AAY9G,wBAAgB,mCAAmC,CAAC,MAAM,EAAE;IAC1D,SAAS,EAAE,MAAM,CAAC;CACnB;;;;;;;;;;;;;;;;;;;;;;;;EA+CA;AAED,wBAAgB,8CAA8C,CAAC,MAAM,EAAE;IACrE,GAAG,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACrC,6BAA6B,CAAC,EAAE,OAAO,CAAC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,GAAG,IAAI,CAmBP;AAED,MAAM,MAAM,gCAAgC,GAAG,UAAU,CAAC,OAAO,mCAAmC,CAAC,CAAC;AACtG,MAAM,MAAM,iCAAiC,GAAG,YAAY,CAAC"}

package/dist/esm/components/form/automated/generated-relationship-field.hooks.js

@@ -12,6 +12,8 @@ import { useFormContext } from 'react-hook-form';
 import { useSectionFieldRegistration } from '../../resources/skeleton/SectionFieldsContext.js';
 import { useOptionalFormTemplateContext } from './FormTemplateContext.js';
 import { resolveGeneratedRelationshipFieldSchema } from './generated-relationship-field.utils.js';
+import { useSurfacePolicy } from '../../../core/ui/SurfacePolicyContext.js';
+import { resolveSurfaceAutoFieldDensity, resolveSurfaceAutoLabelPlacement, resolveSurfaceFormChromeMode } from './FormField.js';
 const logger = LoggerFrontendService.getLogger();
 export function useGeneratedRelationshipFieldCommon(params) {
     const formContext = useFormContext();
@@ -20,10 +22,17 @@ export function useGeneratedRelationshipFieldCommon(params) {
     const { registry, doOperation } = useResourceRegistry();
     useSectionFieldRegistration(params.fieldName);
     const { formChromeMode, sectionChromeMode } = useFormChromeContext();
+    const surfacePolicy = useSurfacePolicy();
     const { tComponent } = useI18n();
     const fieldSchema = resolveGeneratedRelationshipFieldSchema(templateContext?.schema, params.fieldName);
     const fieldEditConfig = fieldSchema ? getFieldUIEditConfig(fieldSchema) : undefined;
-    const resolvedChromeMode = fieldEditConfig?.chromeMode ?? sectionChromeMode ?? formChromeMode;
+    const resolvedChromeMode = fieldEditConfig?.chromeMode
+        ?? sectionChromeMode
+        ?? formChromeMode
+        ?? resolveSurfaceFormChromeMode(surfacePolicy.autoRender?.autoFieldChrome);
+    const resolvedLabelPlacement = resolveSurfaceAutoLabelPlacement(surfacePolicy.autoRender?.autoLabelPlacement);
+    const resolvedControlSize = resolveSurfaceAutoFieldDensity(surfacePolicy.autoRender?.autoFieldDensity);
+    const hideInlineErrorForPolicy = surfacePolicy.autoRender?.autoErrorPlacement === 'summary-at-surface-top';
     const fieldLabel = templateContext?.fieldLabels?.[params.fieldName] ??
         AutomatedLayoutFrontendUtils.formatFieldPathFallback(params.fieldName);
     return {
@@ -34,6 +43,9 @@ export function useGeneratedRelationshipFieldCommon(params) {
         doOperation,
         fieldSchema,
         resolvedChromeMode,
+        resolvedLabelPlacement,
+        resolvedControlSize,
+        hideInlineErrorForPolicy,
         fieldLabel,
         fieldDescription: templateContext?.fieldDescriptions?.[params.fieldName],
         fieldTooltip: templateContext?.fieldTooltips?.[params.fieldName],
@@ -61,4 +73,4 @@ export function useWarnWhenGeneratedRelationshipRmmUnavailable(params) {
         logger.warn(`[${params.componentName}] Resource mutation manager unavailable; relationship writes are disabled.`, params.context);
     }, [params.allowsDirectOperationFallback, params.componentName, params.context, params.rmm]);
 }
-//# sourceMappingURL=generated-relationship-field.hooks.js.map
+//# sourceMappingURL=generated-relationship-field.hooks.js.map

package/dist/esm/components/form/automated/generated-relationship-field.hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"generated-relationship-field.hooks.js","sourceRoot":"","sources":["../../../../../src/components/form/automated/generated-relationship-field.hooks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"generated-relationship-field.hooks.js","sourceRoot":"","sources":["../../../../../../src/components/form/automated/generated-relationship-field.hooks.ts"],"names":[],"mappings":"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","sourcesContent":["import { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport type { ResourceType } from '@wildo-ai/saas-models';\nimport { getFieldUIEditConfig } from '@wildo-ai/zod-decorators';\nimport { useEffect } from 'react';\nimport { useFormChromeContext } from '~wildo-frontend-lib/components/form/chromes/FormChromeContext';\nimport { useFormSchemaContext } from '~wildo-frontend-lib/components/form/useFormSchemaContext';\nimport { AutomatedLayoutFrontendUtils } from '~wildo-frontend-lib/core/automated-layout/automated-layout.frontend.utils';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport type { ResourceMutationManager } from '~wildo-frontend-lib/core/resources/rmm/ResourceMutationManager';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { envLoader } from '~wildo-frontend-lib/core/runtime/env-variable-loader.frontend.service';\nimport { useFormContext } from 'react-hook-form';\nimport { useSectionFieldRegistration } from '../../resources/skeleton/SectionFieldsContext';\nimport { useOptionalFormTemplateContext } from './FormTemplateContext';\nimport { resolveGeneratedRelationshipFieldSchema } from './generated-relationship-field.utils';\nimport { useSurfacePolicy } from '~wildo-frontend-lib/core/ui/SurfacePolicyContext';\nimport { resolveSurfaceAutoFieldDensity, resolveSurfaceAutoLabelPlacement, resolveSurfaceFormChromeMode } from './FormField';\n\nconst logger = LoggerFrontendService.getLogger();\n\nexport function useGeneratedRelationshipFieldCommon(params: {\n  fieldName: string;\n}) {\n  const formContext = useFormContext();\n  const formSchemaContext = useFormSchemaContext();\n  const templateContext = useOptionalFormTemplateContext();\n  const { registry, doOperation } = useResourceRegistry();\n  useSectionFieldRegistration(params.fieldName);\n  const { formChromeMode, sectionChromeMode } = useFormChromeContext();\n  const surfacePolicy = useSurfacePolicy();\n  const { tComponent } = useI18n();\n\n  const fieldSchema = resolveGeneratedRelationshipFieldSchema(templateContext?.schema, params.fieldName);\n  const fieldEditConfig = fieldSchema ? getFieldUIEditConfig(fieldSchema) : undefined;\n  const resolvedChromeMode = fieldEditConfig?.chromeMode\n    ?? sectionChromeMode\n    ?? formChromeMode\n    ?? resolveSurfaceFormChromeMode(surfacePolicy.autoRender?.autoFieldChrome);\n  const resolvedLabelPlacement = resolveSurfaceAutoLabelPlacement(surfacePolicy.autoRender?.autoLabelPlacement);\n  const resolvedControlSize = resolveSurfaceAutoFieldDensity(surfacePolicy.autoRender?.autoFieldDensity);\n  const hideInlineErrorForPolicy = surfacePolicy.autoRender?.autoErrorPlacement === 'summary-at-surface-top';\n  const fieldLabel = templateContext?.fieldLabels?.[params.fieldName] ??\n    AutomatedLayoutFrontendUtils.formatFieldPathFallback(params.fieldName);\n\n  return {\n    formContext,\n    formSchemaContext,\n    templateContext,\n    registry,\n    doOperation,\n    fieldSchema,\n    resolvedChromeMode,\n    resolvedLabelPlacement,\n    resolvedControlSize,\n    hideInlineErrorForPolicy,\n    fieldLabel,\n    fieldDescription: templateContext?.fieldDescriptions?.[params.fieldName],\n    fieldTooltip: templateContext?.fieldTooltips?.[params.fieldName],\n    disabled: templateContext?.disabled,\n    readOnly: templateContext?.readOnly,\n    labels: {\n      saveLabel: tComponent(FrontendComponentType.LOW_LEVEL_BUTTON, 'save'),\n      savingLabel: tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'saving'),\n      clearLabel: tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'clearSelection'),\n      saveFailedLabel: tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'save_failed'),\n      saveConflictLabel: tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'save_conflict'),\n      saveUnavailableLabel: tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'save_unavailable'),\n    },\n  };\n}\n\nexport function useWarnWhenGeneratedRelationshipRmmUnavailable(params: {\n  rmm?: ResourceMutationManager | null;\n  allowsDirectOperationFallback?: boolean;\n  componentName: string;\n  context: Record<string, unknown>;\n}): void {\n  useEffect(() => {\n    if (params.rmm || !envLoader.isDevelopment()) {\n      return;\n    }\n\n    if (params.allowsDirectOperationFallback) {\n      logger.warn(\n        `[${params.componentName}] Resource mutation manager unavailable; relationship writes are using weaker-guarantee direct-operation fallback.`,\n        params.context,\n      );\n      return;\n    }\n\n    logger.warn(\n      `[${params.componentName}] Resource mutation manager unavailable; relationship writes are disabled.`,\n      params.context,\n    );\n  }, [params.allowsDirectOperationFallback, params.componentName, params.context, params.rmm]);\n}\n\nexport type GeneratedRelationshipFieldCommon = ReturnType<typeof useGeneratedRelationshipFieldCommon>;\nexport type GeneratedRelationshipResourceType = ResourceType;\n"]}

package/dist/esm/components/form/automated/generated-relationship-field.shared.d.ts

@@ -1,7 +1,12 @@
 import React from 'react';
+import type { ResponsiveChromeMode } from '@wildo-ai/zod-decorators';
+import type { AutoLabelPlacement, ControlSize } from '@wildo-ai/presets-components-models';
 export declare function GeneratedRelationshipFieldFrame(props: {
     fieldName: string;
-    resolvedChromeMode: unknown;
+    resolvedChromeMode?: ResponsiveChromeMode;
+    resolvedLabelPlacement?: AutoLabelPlacement;
+    resolvedControlSize?: ControlSize;
+    hideInlineErrorForPolicy?: boolean;
     fieldLabel: string;
     fieldDescription?: string;
     fieldTooltip?: string;

package/dist/esm/components/form/automated/generated-relationship-field.shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generated-relationship-field.shared.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/automated/generated-relationship-field.shared.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,wBAAgB,+BAA+B,CAAC,KAAK,EAAE;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC;CAC1B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA0BpB"}
+{"version":3,"file":"generated-relationship-field.shared.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/automated/generated-relationship-field.shared.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAC3F,wBAAgB,+BAA+B,CAAC,KAAK,EAAE;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,oBAAoB,CAAC;IAC1C,sBAAsB,CAAC,EAAE,kBAAkB,CAAC;IAC5C,mBAAmB,CAAC,EAAE,WAAW,CAAC;IAClC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC;CAC1B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA4BpB"}

package/dist/esm/components/form/automated/generated-relationship-field.shared.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { FormFieldChrome } from '../../../components/form/chromes/FormFieldChrome.js';
 export function GeneratedRelationshipFieldFrame(props) {
-    return (_jsx(FormFieldChrome, { mode: props.resolvedChromeMode, label: props.fieldLabel, description: props.fieldDescription, tooltip: props.fieldTooltip, fieldName: props.fieldName, disabled: props.disabled, children: _jsxs("div", { className: "flex flex-col gap-item-sm", children: [_jsxs("div", { className: "flex flex-wrap items-center gap-item-sm", children: [_jsx("div", { className: "min-w-[16rem] flex-1", children: props.controls }), props.actions] }), (props.actionError || props.isUnavailable) && (_jsx("span", { className: props.actionError ? 'text-xs text-destructive' : 'text-xs text-muted-foreground', children: props.actionError ?? props.unavailableLabel }))] }) }));
+    return (_jsx(FormFieldChrome, { mode: props.resolvedChromeMode, labelPlacement: props.resolvedLabelPlacement, label: props.fieldLabel, description: props.fieldDescription, hideError: props.hideInlineErrorForPolicy, tooltip: props.fieldTooltip, fieldName: props.fieldName, disabled: props.disabled, children: _jsxs("div", { className: "flex flex-col gap-item-sm", children: [_jsxs("div", { className: "flex flex-wrap items-center gap-item-sm", children: [_jsx("div", { className: "min-w-[16rem] flex-1", children: props.controls }), props.actions] }), (props.actionError || props.isUnavailable) && (_jsx("span", { className: props.actionError ? 'text-xs text-destructive' : 'text-xs text-muted-foreground', children: props.actionError ?? props.unavailableLabel }))] }) }));
 }
-//# sourceMappingURL=generated-relationship-field.shared.js.map
+//# sourceMappingURL=generated-relationship-field.shared.js.map

package/dist/esm/components/form/automated/generated-relationship-field.shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"generated-relationship-field.shared.js","sourceRoot":"","sources":["../../../../../src/components/form/automated/generated-relationship-field.shared.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,eAAe,EAAE,MAAM,6DAA6D,CAAC;AAC9F,MAAM,UAAU,+BAA+B,CAAC,KAY/C;IACC,OAAO,CACL,KAAC,eAAe,IACd,IAAI,EAAE,KAAK,CAAC,kBAA2B,EACvC,KAAK,EAAE,KAAK,CAAC,UAAU,EACvB,WAAW,EAAE,KAAK,CAAC,gBAAgB,EACnC,OAAO,EAAE,KAAK,CAAC,YAAY,EAC3B,SAAS,EAAE,KAAK,CAAC,SAAS,EAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ,YAExB,eAAK,SAAS,EAAC,2BAA2B,aACxC,eAAK,SAAS,EAAC,yCAAyC,aACtD,cAAK,SAAS,EAAC,sBAAsB,YAClC,KAAK,CAAC,QAAQ,GACX,EACL,KAAK,CAAC,OAAO,IACV,EAEL,CAAC,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,aAAa,CAAC,IAAI,CAC7C,eAAM,SAAS,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,+BAA+B,YAC9F,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,gBAAgB,GACvC,CACR,IACG,GACU,CACnB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"generated-relationship-field.shared.js","sourceRoot":"","sources":["../../../../../../src/components/form/automated/generated-relationship-field.shared.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,eAAe,EAAE,MAAM,6DAA6D,CAAC;AAG9F,MAAM,UAAU,+BAA+B,CAAC,KAe/C;IACC,OAAO,CACL,KAAC,eAAe,IACd,IAAI,EAAE,KAAK,CAAC,kBAAkB,EAC9B,cAAc,EAAE,KAAK,CAAC,sBAAsB,EAC5C,KAAK,EAAE,KAAK,CAAC,UAAU,EACvB,WAAW,EAAE,KAAK,CAAC,gBAAgB,EACnC,SAAS,EAAE,KAAK,CAAC,wBAAwB,EACzC,OAAO,EAAE,KAAK,CAAC,YAAY,EAC3B,SAAS,EAAE,KAAK,CAAC,SAAS,EAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ,YAExB,eAAK,SAAS,EAAC,2BAA2B,aACxC,eAAK,SAAS,EAAC,yCAAyC,aACtD,cAAK,SAAS,EAAC,sBAAsB,YAClC,KAAK,CAAC,QAAQ,GACX,EACL,KAAK,CAAC,OAAO,IACV,EAEL,CAAC,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,aAAa,CAAC,IAAI,CAC7C,eAAM,SAAS,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,+BAA+B,YAC9F,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,gBAAgB,GACvC,CACR,IACG,GACU,CACnB,CAAC;AACJ,CAAC","sourcesContent":["import React from 'react';\nimport { FormFieldChrome } from '~wildo-frontend-lib/components/form/chromes/FormFieldChrome';\nimport type { ResponsiveChromeMode } from '@wildo-ai/zod-decorators';\nimport type { AutoLabelPlacement, ControlSize } from '@wildo-ai/presets-components-models';\nexport function GeneratedRelationshipFieldFrame(props: {\n  fieldName: string;\n  resolvedChromeMode?: ResponsiveChromeMode;\n  resolvedLabelPlacement?: AutoLabelPlacement;\n  resolvedControlSize?: ControlSize;\n  hideInlineErrorForPolicy?: boolean;\n  fieldLabel: string;\n  fieldDescription?: string;\n  fieldTooltip?: string;\n  disabled?: boolean;\n  actionError?: string;\n  unavailableLabel: string;\n  isUnavailable: boolean;\n  controls: React.ReactNode;\n  actions: React.ReactNode;\n}): React.JSX.Element {\n  return (\n    <FormFieldChrome\n      mode={props.resolvedChromeMode}\n      labelPlacement={props.resolvedLabelPlacement}\n      label={props.fieldLabel}\n      description={props.fieldDescription}\n      hideError={props.hideInlineErrorForPolicy}\n      tooltip={props.fieldTooltip}\n      fieldName={props.fieldName}\n      disabled={props.disabled}\n    >\n      <div className=\"flex flex-col gap-item-sm\">\n        <div className=\"flex flex-wrap items-center gap-item-sm\">\n          <div className=\"min-w-[16rem] flex-1\">\n            {props.controls}\n          </div>\n          {props.actions}\n        </div>\n\n        {(props.actionError || props.isUnavailable) && (\n          <span className={props.actionError ? 'text-xs text-destructive' : 'text-xs text-muted-foreground'}>\n            {props.actionError ?? props.unavailableLabel}\n          </span>\n        )}\n      </div>\n    </FormFieldChrome>\n  );\n}\n"]}

package/dist/esm/components/form/automated/generated-relationship-field.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generated-relationship-field.utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/automated/generated-relationship-field.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,wBAAgB,uCAAuC,CACrD,UAAU,EAAE,CAAC,CAAC,UAAU,GAAG,SAAS,EACpC,IAAI,EAAE,MAAM,GACX,CAAC,CAAC,UAAU,GAAG,SAAS,CAmB1B"}
+{"version":3,"file":"generated-relationship-field.utils.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/automated/generated-relationship-field.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,wBAAgB,uCAAuC,CACrD,UAAU,EAAE,CAAC,CAAC,UAAU,GAAG,SAAS,EACpC,IAAI,EAAE,MAAM,GACX,CAAC,CAAC,UAAU,GAAG,SAAS,CAmB1B"}

package/dist/esm/components/form/automated/generated-relationship-field.utils.js

@@ -16,4 +16,4 @@ export function resolveGeneratedRelationshipFieldSchema(rootSchema, path) {
     }
     return current;
 }
-//# sourceMappingURL=generated-relationship-field.utils.js.map
+//# sourceMappingURL=generated-relationship-field.utils.js.map

package/dist/esm/components/form/automated/generated-relationship-field.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"generated-relationship-field.utils.js","sourceRoot":"","sources":["../../../../../src/components/form/automated/generated-relationship-field.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExE,MAAM,UAAU,uCAAuC,CACrD,UAAoC,EACpC,IAAY;IAEZ,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAElC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,OAAO,GAAiB,UAAU,CAAC;IAEvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,cAAc,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"generated-relationship-field.utils.js","sourceRoot":"","sources":["../../../../../../src/components/form/automated/generated-relationship-field.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExE,MAAM,UAAU,uCAAuC,CACrD,UAAoC,EACpC,IAAY;IAEZ,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAElC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,OAAO,GAAiB,UAAU,CAAC;IAEvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,cAAc,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import type { z } from 'zod';\nimport { getObjectShape, unwrapSchema } from '@wildo-ai/zod-decorators';\n\nexport function resolveGeneratedRelationshipFieldSchema(\n  rootSchema: z.ZodTypeAny | undefined,\n  path: string,\n): z.ZodTypeAny | undefined {\n  if (!rootSchema) return undefined;\n\n  const parts = path.split('.');\n  let current: z.ZodTypeAny = rootSchema;\n\n  for (const part of parts) {\n    const shape = getObjectShape(unwrapSchema(current));\n    if (!shape) {\n      return undefined;\n    }\n\n    current = shape[part];\n    if (!current) {\n      return undefined;\n    }\n  }\n\n  return current;\n}\n"]}

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

@@ -0,0 +1,8 @@
+export interface ArrayItemAutosaveField<T> {
+    /** Live value of the bound field path (re-renders on change). */
+    value: T;
+    /** Write the field and, in an autosave context, trigger the whole-array save. */
+    setValue: (next: T) => void;
+}
+export declare function useArrayItemAutosaveField<T = unknown>(fieldPath: string): ArrayItemAutosaveField<T>;
+//# sourceMappingURL=useArrayItemAutosaveField.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useArrayItemAutosaveField.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/automated/useArrayItemAutosaveField.ts"],"names":[],"mappings":"AA4BA,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,iEAAiE;IACjE,KAAK,EAAE,CAAC,CAAC;IACT,iFAAiF;IACjF,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;CAC7B;AAED,wBAAgB,yBAAyB,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAiBnG"}

package/dist/esm/components/form/automated/useArrayItemAutosaveField.js

@@ -0,0 +1,38 @@
+"use client";
+/**
+ * useArrayItemAutosaveField — bind ONE sub-field of an array item inside a
+ * per-item TEMPLATE (the `renderItem`/`renderField` render-prop), correct in
+ * BOTH contexts the template can render in:
+ *
+ *  - **Inline-editable READ array** (`DisplayFieldEditableArray` → autosave):
+ *    each change must kick the whole-array debounced autosave. The array's
+ *    `handleSave` re-reads the WHOLE array from the form and PATCHes it, so the
+ *    value we pass to `triggerSave` is irrelevant — what matters is that a save
+ *    is triggered after the RHF field is updated.
+ *  - **Plain edit FORM** (`FormField name="checklist" renderField=…`, no
+ *    `AutosaveProvider`): `useOptionalAutosave()` is null, so we only update RHF
+ *    and the surrounding form's submit persists the change.
+ *
+ * Returns the live field `value` (via `useWatch`) and a `setValue` that writes
+ * the field and triggers autosave when present. Templates compose this with a
+ * plain control (`Checkbox`, `InlineEditText`, …) instead of a raw `Controller`,
+ * which would silently NOT persist in the autosave context.
+ */
+import { useCallback } from 'react';
+import { useFormContext, useWatch } from 'react-hook-form';
+import { AutosaveTrigger } from '@wildo-ai/zod-decorators';
+import { useOptionalAutosave } from './AutosaveContext.js';
+export function useArrayItemAutosaveField(fieldPath) {
+    const { setValue: rhfSetValue } = useFormContext();
+    const value = useWatch({ name: fieldPath });
+    const autosave = useOptionalAutosave();
+    const setValue = useCallback((next) => {
+        rhfSetValue(fieldPath, next, { shouldDirty: true, shouldTouch: true });
+        // The array's autosave bridge ignores this fieldName/value and re-reads the
+        // whole array — passing the field path keeps the autosave state keyed like a
+        // normal per-item FormField edit. DEBOUNCE matches text/edit cadence.
+        autosave?.triggerSave(fieldPath, next, AutosaveTrigger.DEBOUNCE);
+    }, [rhfSetValue, fieldPath, autosave]);
+    return { value, setValue };
+}
+//# sourceMappingURL=useArrayItemAutosaveField.js.map

package/dist/esm/components/form/automated/useArrayItemAutosaveField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useArrayItemAutosaveField.js","sourceRoot":"","sources":["../../../../../../src/components/form/automated/useArrayItemAutosaveField.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AASxD,MAAM,UAAU,yBAAyB,CAAc,SAAiB;IACtE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,cAAc,EAAE,CAAC;IACnD,MAAM,KAAK,GAAG,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAM,CAAC;IACjD,MAAM,QAAQ,GAAG,mBAAmB,EAAE,CAAC;IAEvC,MAAM,QAAQ,GAAG,WAAW,CAC1B,CAAC,IAAO,EAAQ,EAAE;QAChB,WAAW,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QACvE,4EAA4E;QAC5E,6EAA6E;QAC7E,sEAAsE;QACtE,QAAQ,EAAE,WAAW,CAAC,SAAS,EAAE,IAAI,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IACnE,CAAC,EACD,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,CACnC,CAAC;IAEF,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AAC7B,CAAC","sourcesContent":["\"use client\"\n\n/**\n * useArrayItemAutosaveField — bind ONE sub-field of an array item inside a\n * per-item TEMPLATE (the `renderItem`/`renderField` render-prop), correct in\n * BOTH contexts the template can render in:\n *\n *  - **Inline-editable READ array** (`DisplayFieldEditableArray` → autosave):\n *    each change must kick the whole-array debounced autosave. The array's\n *    `handleSave` re-reads the WHOLE array from the form and PATCHes it, so the\n *    value we pass to `triggerSave` is irrelevant — what matters is that a save\n *    is triggered after the RHF field is updated.\n *  - **Plain edit FORM** (`FormField name=\"checklist\" renderField=…`, no\n *    `AutosaveProvider`): `useOptionalAutosave()` is null, so we only update RHF\n *    and the surrounding form's submit persists the change.\n *\n * Returns the live field `value` (via `useWatch`) and a `setValue` that writes\n * the field and triggers autosave when present. Templates compose this with a\n * plain control (`Checkbox`, `InlineEditText`, …) instead of a raw `Controller`,\n * which would silently NOT persist in the autosave context.\n */\n\nimport { useCallback } from 'react';\nimport { useFormContext, useWatch } from 'react-hook-form';\nimport { AutosaveTrigger } from '@wildo-ai/zod-decorators';\n\nimport { useOptionalAutosave } from './AutosaveContext';\n\nexport interface ArrayItemAutosaveField<T> {\n  /** Live value of the bound field path (re-renders on change). */\n  value: T;\n  /** Write the field and, in an autosave context, trigger the whole-array save. */\n  setValue: (next: T) => void;\n}\n\nexport function useArrayItemAutosaveField<T = unknown>(fieldPath: string): ArrayItemAutosaveField<T> {\n  const { setValue: rhfSetValue } = useFormContext();\n  const value = useWatch({ name: fieldPath }) as T;\n  const autosave = useOptionalAutosave();\n\n  const setValue = useCallback(\n    (next: T): void => {\n      rhfSetValue(fieldPath, next, { shouldDirty: true, shouldTouch: true });\n      // The array's autosave bridge ignores this fieldName/value and re-reads the\n      // whole array — passing the field path keeps the autosave state keyed like a\n      // normal per-item FormField edit. DEBOUNCE matches text/edit cadence.\n      autosave?.triggerSave(fieldPath, next, AutosaveTrigger.DEBOUNCE);\n    },\n    [rhfSetValue, fieldPath, autosave],\n  );\n\n  return { value, setValue };\n}\n"]}

package/dist/esm/components/form/chromes/FormChromeContext.d.ts

@@ -3,7 +3,8 @@
  * down to FormField components.
  *
  * Resolution cascade:
- *   Field decorator chromeMode → FormChromeContext.sectionChromeMode → FormChromeContext.formChromeMode → STACKED
+ *   Field decorator chromeMode → FormChromeContext.sectionChromeMode
+ *   → FormChromeContext.formChromeMode → surface autoFieldChrome → STACKED
  *
  * FormField reads from this context and passes the resolved mode to FormFieldChrome.
  */

package/dist/esm/components/form/chromes/FormChromeContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormChromeContext.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/chromes/FormChromeContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAClF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAEpE,MAAM,WAAW,qBAAqB;IACpC,cAAc,CAAC,EAAE,oBAAoB,CAAA;IACrC,iBAAiB,CAAC,EAAE,oBAAoB,CAAA;CACzC;AAED,MAAM,WAAW,uBAAwB,SAAQ,qBAAqB;IACpE,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED,QAAA,MAAM,iBAAiB,sCAA8D,CAAC;AAEtF,iBAAS,kBAAkB,CAAC,EAC1B,cAAc,EACd,iBAAiB,EACjB,QAAQ,GACT,EAAE,uBAAuB,2CAWzB;AAMD;;;GAGG;AACH,iBAAS,oBAAoB,IAAI,qBAAqB,CAErD;AAED,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,CAAC"}
+{"version":3,"file":"FormChromeContext.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/chromes/FormChromeContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAClF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAEpE,MAAM,WAAW,qBAAqB;IACpC,cAAc,CAAC,EAAE,oBAAoB,CAAA;IACrC,iBAAiB,CAAC,EAAE,oBAAoB,CAAA;CACzC;AAED,MAAM,WAAW,uBAAwB,SAAQ,qBAAqB;IACpE,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED,QAAA,MAAM,iBAAiB,sCAA8D,CAAC;AAEtF,iBAAS,kBAAkB,CAAC,EAC1B,cAAc,EACd,iBAAiB,EACjB,QAAQ,GACT,EAAE,uBAAuB,2CAWzB;AAMD;;;GAGG;AACH,iBAAS,oBAAoB,IAAI,qBAAqB,CAErD;AAED,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/esm/components/form/chromes/FormChromeContext.js

@@ -4,7 +4,8 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * down to FormField components.
  *
  * Resolution cascade:
- *   Field decorator chromeMode → FormChromeContext.sectionChromeMode → FormChromeContext.formChromeMode → STACKED
+ *   Field decorator chromeMode → FormChromeContext.sectionChromeMode
+ *   → FormChromeContext.formChromeMode → surface autoFieldChrome → STACKED
  *
  * FormField reads from this context and passes the resolved mode to FormFieldChrome.
  */
@@ -25,4 +26,4 @@ function useFormChromeContext() {
     return useContext(FormChromeContext) ?? {};
 }
 export { FormChromeContext, FormChromeProvider, useFormChromeContext };
-//# sourceMappingURL=FormChromeContext.js.map
+//# sourceMappingURL=FormChromeContext.js.map

package/dist/esm/components/form/chromes/FormChromeContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"FormChromeContext.js","sourceRoot":"","sources":["../../../../../src/components/form/chromes/FormChromeContext.tsx"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;AAEH,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAkB,MAAM,OAAO,CAAC;AAYlF,MAAM,iBAAiB,GAAG,aAAa,CAAoC,SAAS,CAAC,CAAC;AAEtF,SAAS,kBAAkB,CAAC,EAC1B,cAAc,EACd,iBAAiB,EACjB,QAAQ,GACgB;IACxB,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC,EAAE,cAAc,EAAE,iBAAiB,EAAE,CAAC,EAC7C,CAAC,cAAc,EAAE,iBAAiB,CAAC,CACpC,CAAC;IAEF,OAAO,CACL,KAAC,iBAAiB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACrC,QAAQ,GACkB,CAC9B,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,OAAO;AACP,gFAAgF;AAEhF;;;GAGG;AACH,SAAS,oBAAoB;IAC3B,OAAO,UAAU,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;AAC7C,CAAC;AAED,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,CAAC"}
+{"version":3,"file":"FormChromeContext.js","sourceRoot":"","sources":["../../../../../../src/components/form/chromes/FormChromeContext.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;AAEH,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAkB,MAAM,OAAO,CAAC;AAYlF,MAAM,iBAAiB,GAAG,aAAa,CAAoC,SAAS,CAAC,CAAC;AAEtF,SAAS,kBAAkB,CAAC,EAC1B,cAAc,EACd,iBAAiB,EACjB,QAAQ,GACgB;IACxB,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC,EAAE,cAAc,EAAE,iBAAiB,EAAE,CAAC,EAC7C,CAAC,cAAc,EAAE,iBAAiB,CAAC,CACpC,CAAC;IAEF,OAAO,CACL,KAAC,iBAAiB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACrC,QAAQ,GACkB,CAC9B,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,OAAO;AACP,gFAAgF;AAEhF;;;GAGG;AACH,SAAS,oBAAoB;IAC3B,OAAO,UAAU,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;AAC7C,CAAC;AAED,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,CAAC","sourcesContent":["/**\n * FormChromeContext — propagates section-level and form-level chrome mode defaults\n * down to FormField components.\n *\n * Resolution cascade:\n *   Field decorator chromeMode → FormChromeContext.sectionChromeMode\n *   → FormChromeContext.formChromeMode → surface autoFieldChrome → STACKED\n *\n * FormField reads from this context and passes the resolved mode to FormFieldChrome.\n */\n\nimport React, { createContext, useContext, useMemo, type ReactNode } from \"react\";\nimport type { ResponsiveChromeMode } from '@wildo-ai/zod-decorators'\n\nexport interface FormChromeContextType {\n  formChromeMode?: ResponsiveChromeMode\n  sectionChromeMode?: ResponsiveChromeMode\n}\n\nexport interface FormChromeProviderProps extends FormChromeContextType {\n  children: ReactNode\n}\n\nconst FormChromeContext = createContext<FormChromeContextType | undefined>(undefined);\n\nfunction FormChromeProvider({\n  formChromeMode,\n  sectionChromeMode,\n  children,\n}: FormChromeProviderProps) {\n  const value = useMemo(\n    () => ({ formChromeMode, sectionChromeMode }),\n    [formChromeMode, sectionChromeMode],\n  );\n\n  return (\n    <FormChromeContext.Provider value={value}>\n      {children}\n    </FormChromeContext.Provider>\n  );\n}\n\n// =============================================================================\n// HOOK\n// =============================================================================\n\n/**\n * Read the chrome mode defaults from the nearest FormChromeProvider.\n * Returns undefined values when no provider is mounted (field-level decorator is sole source).\n */\nfunction useFormChromeContext(): FormChromeContextType {\n  return useContext(FormChromeContext) ?? {};\n}\n\nexport { FormChromeContext, FormChromeProvider, useFormChromeContext };\n"]}

package/dist/esm/components/form/chromes/FormFieldChrome.d.ts

@@ -7,7 +7,7 @@
  * with the appropriate chrome layout.
  *
  * Chrome mode is resolved via a two-phase cascade:
- *   Phase 1 (FormField): field decorator → section default → form default → STACKED
+ *   Phase 1 (FormField): field decorator → section default → form default → surface policy → STACKED
  *   Phase 2 (here): responsive viewport resolution via useUI()
  *
  * ## data-field safety net
@@ -20,8 +20,8 @@
  * fine; the chrome's attribute serves as an outer fallback.
  */
 import * as React from "react";
-import { AutosaveFieldState } from '../../../components/form/form-field-types.js';
-import { FormFieldChromeMode, type ResponsiveChromeMode, ViewportBreakpoint } from "@wildo-ai/zod-decorators";
+import { AutosaveFieldState } from '../../../components/form/form-field-types';
+import { EditChromeMode, type ResponsiveChromeMode, ViewportBreakpoint } from "@wildo-ai/zod-decorators";
 import type { ReactNode } from 'react';
 export interface FormFieldChromeProps {
     mode?: ResponsiveChromeMode;
@@ -29,6 +29,7 @@ export interface FormFieldChromeProps {
     description?: string;
     error?: string;
     required?: boolean;
+    labelPlacement?: AutoLabelPlacement;
     hideLabel?: boolean;
     hideDescription?: boolean;
     hideError?: boolean;
@@ -38,10 +39,24 @@ export interface FormFieldChromeProps {
     fieldName?: string;
     disabled?: boolean;
     tooltip?: string;
+    /**
+     * The control is intrinsically wide/tall (file drop zone, image preview, …)
+     * and cannot fit the SETTINGS_ROW fixed inline-end column (`w-72`). When the
+     * EFFECTIVE mode resolves to SETTINGS_ROW, the row keeps its settings-list
+     * shell (the `px-card` inset, `py-card-sm` rhythm, hairline divider, hover
+     * affordance and `data-chrome-mode="settings_row"` list identity) but stacks
+     * the control FULL-WIDTH beneath the label instead of pinning it inline-end —
+     * so the field stays a member of the flush, divided settings list rather than
+     * dropping out as a misaligned bare STACKED block (the old behavior, which
+     * lost the row inset and broke the list's flush stacking). Inert for every
+     * other mode (a STACKED/mobile-collapsed field is already full-width).
+     */
+    wideControl?: boolean;
     className?: string;
     children: ReactNode;
 }
-declare function resolveEffectiveChromeMode(chromeMode: ResponsiveChromeMode | undefined, currentBreakpoint: ViewportBreakpoint, isMobile: boolean): FormFieldChromeMode;
-declare function FormFieldChrome({ mode, label, description, error, required, hideLabel, hideDescription, hideError, saveState, saveErrorMessage, onRetrySave, fieldName, disabled, tooltip, className, children, }: FormFieldChromeProps): React.JSX.Element;
+import { type AutoLabelPlacement } from "@wildo-ai/presets-components-models";
+declare function resolveEffectiveChromeMode(chromeMode: ResponsiveChromeMode | undefined, currentBreakpoint: ViewportBreakpoint, isMobile: boolean): EditChromeMode;
+declare function FormFieldChrome({ mode, label, description, error, required, labelPlacement, hideLabel, hideDescription, hideError, saveState, saveErrorMessage, onRetrySave, fieldName, disabled, tooltip, wideControl, className, children, }: FormFieldChromeProps): React.JSX.Element;
 export { FormFieldChrome, resolveEffectiveChromeMode };
 //# sourceMappingURL=FormFieldChrome.d.ts.map

package/dist/esm/components/form/chromes/FormFieldChrome.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormFieldChrome.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/chromes/FormFieldChrome.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAgB9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sDAAsD,CAAA;AACzF,OAAO,EACL,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,kBAAkB,EACnB,MAAM,0BAA0B,CAAA;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,oBAAoB,CAAA;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,SAAS,CAAC,EAAE,kBAAkB,CAAA;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,SAAS,CAAA;CACpB;AAaD,iBAAS,0BAA0B,CACjC,UAAU,EAAE,oBAAoB,GAAG,SAAS,EAC5C,iBAAiB,EAAE,kBAAkB,EACrC,QAAQ,EAAE,OAAO,GAChB,mBAAmB,CAoBrB;AAkCD,iBAAS,eAAe,CAAC,EACvB,IAAI,EACJ,KAAK,EACL,WAAW,EACX,KAAK,EACL,QAAQ,EACR,SAAS,EACT,eAAe,EACf,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,QAAQ,EACR,OAAO,EACP,SAAS,EACT,QAAQ,GACT,EAAE,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAyL1C;AAID,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,CAAA"}
+{"version":3,"file":"FormFieldChrome.d.ts","sourceRoot":"","sources":["../../../../../../src/components/form/chromes/FormFieldChrome.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAgB9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sDAAsD,CAAA;AACzF,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,EACzB,kBAAkB,EACnB,MAAM,0BAA0B,CAAA;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,oBAAoB,CAAA;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,cAAc,CAAC,EAAE,kBAAkB,CAAA;IACnC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,SAAS,CAAC,EAAE,kBAAkB,CAAA;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,SAAS,CAAA;CACpB;AAID,OAAO,EAAqC,KAAK,kBAAkB,EAAE,MAAM,qCAAqC,CAAA;AAShH,iBAAS,0BAA0B,CACjC,UAAU,EAAE,oBAAoB,GAAG,SAAS,EAC5C,iBAAiB,EAAE,kBAAkB,EACrC,QAAQ,EAAE,OAAO,GAChB,cAAc,CAoBhB;AAmCD,iBAAS,eAAe,CAAC,EACvB,IAAI,EACJ,KAAK,EACL,WAAW,EACX,KAAK,EACL,QAAQ,EACR,cAAc,EACd,SAAS,EACT,eAAe,EACf,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,QAAQ,EACR,OAAO,EACP,WAAW,EACX,SAAS,EACT,QAAQ,GACT,EAAE,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAwS1C;AAID,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,CAAA"}