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

package/dist/esm/components/data-display/DisplayField.js

@@ -13,18 +13,77 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
  */
 import React from 'react';
 import { useOptionalDisplayTemplateContext } from './DisplayTemplateContext.js';
+import { DisplayContextKind, useDisplayContextKind } from './DisplayContextKindContext.js';
 import { useFieldScope } from '../../components/resources/skeleton/FieldScopeContext.js';
 import { useDisplayChromeContext } from './chromes/DisplayChromeContext.js';
 import { DisplayFieldChrome } from './chromes/DisplayFieldChrome.js';
 import { Skeleton } from '../../components/feedback/skeleton.js';
+import { useSurfacePolicy } from '../../core/ui/SurfacePolicyContext.js';
 import { getFieldSchema, getNestedValue, getParentData, resolveResponsiveValue } from './display-field-resolution.utils.js';
-import { getSchemaType, getFieldUIDisplayConfig, getShowWhenParams, hasInlineEditableDecorator, } from '@wildo-ai/zod-decorators';
+import { DisplayChromeMode, getSchemaType, getFieldUIDisplayConfig, getFieldUISummaryDisplayConfig, getShowWhenParams, hasInlineEditableDecorator, isHiddenForDisplay, FieldSchemaType, } from '@wildo-ai/zod-decorators';
 import { useResourceDisplayContext } from './automatic-displayer.utils.js';
 import { AutomatedLayoutFrontendUtils } from '../../core/automated-layout/automated-layout.frontend.utils.js';
 import { LoggerFrontendService } from '../../core/monitoring/logger.frontend.service.js';
 import { DisplayFieldReadOnly } from './DisplayFieldReadOnly.js';
+import { DisplayFieldReadOnlyArraySection } from './DisplayFieldReadOnlyArraySection.js';
 import { DisplayFieldEditable } from './DisplayFieldEditable.js';
+import { DisplayFieldEditableArray } from './DisplayFieldEditableArray.js';
 const logger = LoggerFrontendService.getLogger();
+function resolveSurfaceDisplayChromeMode(value) {
+    switch (value) {
+        case 'stacked':
+            return DisplayChromeMode.STACKED;
+        case 'inline':
+            return DisplayChromeMode.INLINE;
+        case 'compact':
+            return DisplayChromeMode.COMPACT;
+        default:
+            return undefined;
+    }
+}
+function resolveSurfaceAutoEmptyValue(value) {
+    switch (value) {
+        case 'em-dash':
+        case 'placeholder':
+        case 'hidden':
+        case 'skeleton':
+            return value;
+        default:
+            return undefined;
+    }
+}
+function resolveSurfaceAutoLabelPlacement(value) {
+    switch (value) {
+        case 'top':
+        case 'start':
+        case 'inline':
+        case 'hidden':
+            return value;
+        default:
+            return undefined;
+    }
+}
+/**
+ * Emptiness test for the field-level `display.hideWhenEmpty` mechanism.
+ *
+ * A value counts as empty when it is null / undefined, an empty (or
+ * whitespace-only) string, or an empty array. Object/scalar values with any
+ * content are considered present. This mirrors what every display formatter
+ * treats as the "—" em-dash case, centralized here so a `hideWhenEmpty` field
+ * drops out of the read surface entirely instead of rendering the placeholder.
+ */
+function isEmptyDisplayValue(value) {
+    if (value === null || value === undefined) {
+        return true;
+    }
+    if (typeof value === 'string') {
+        return value.trim() === '';
+    }
+    if (Array.isArray(value)) {
+        return value.length === 0;
+    }
+    return false;
+}
 function fieldMatchesDisplayShapingRule(fieldName, rules) {
     if (!fieldName || !rules || rules.length === 0) {
         return false;
@@ -40,6 +99,8 @@ function DisplayFieldComponent(props) {
     // ── Context resolution ──
     const ctx = useOptionalDisplayTemplateContext();
     const { pathPrefix } = useFieldScope();
+    const surfacePolicy = useSurfacePolicy();
+    const displayContextKind = useDisplayContextKind();
     const effectiveName = props.name;
     const resolvedName = effectiveName
         ? (pathPrefix ? `${pathPrefix}.${effectiveName}` : effectiveName)
@@ -51,7 +112,13 @@ function DisplayFieldComponent(props) {
     const description = props.description ?? (resolvedName ? ctx?.fieldDescriptions?.[resolvedName] : undefined);
     const tooltipProp = props.tooltip ?? (resolvedName ? ctx?.fieldTooltips?.[resolvedName] : undefined);
     const enumLabels = props.enumLabels ?? (resolvedName ? ctx?.enumLabels?.[resolvedName] : undefined);
-    const displayConfig = schema ? getFieldUIDisplayConfig(schema) : undefined;
+    // SUMMARY surfaces resolve base display params with `summaryOverride` merged
+    // over `display` (the {primitive}UI decorator contract for cards/FK previews).
+    const displayConfig = schema
+        ? (displayContextKind === DisplayContextKind.SUMMARY
+            ? getFieldUISummaryDisplayConfig(schema)
+            : getFieldUIDisplayConfig(schema))
+        : undefined;
     const displayComponent = props.displayComponent ?? displayConfig?.component;
     const parentData = props.parentData ?? getParentData(ctx?.data, pathPrefix || undefined);
     const disableInlineEdit = props.disableInlineEdit ?? false;
@@ -61,7 +128,11 @@ function DisplayFieldComponent(props) {
     const isInlineEditDisabledByDisplayShaping = fieldMatchesDisplayShapingRule(resolvedName, ctx?.inlineEditDisabledFieldNames);
     // ── Chrome mode resolution ──
     const { displayChromeMode, sectionChromeMode } = useDisplayChromeContext();
-    const resolvedChromeMode = displayConfig?.chromeMode ?? sectionChromeMode ?? displayChromeMode;
+    const surfaceChromeMode = resolveSurfaceDisplayChromeMode(surfacePolicy.autoRender?.autoFieldChrome);
+    const explicitChromeMode = displayConfig?.chromeMode ?? sectionChromeMode ?? displayChromeMode;
+    const resolvedChromeMode = explicitChromeMode ?? surfaceChromeMode;
+    const resolvedLabelPlacement = props.labelPlacement ?? resolveSurfaceAutoLabelPlacement(surfacePolicy.autoRender?.autoLabelPlacement);
+    const resolvedEmptyValue = resolveSurfaceAutoEmptyValue(surfacePolicy.autoRender?.autoEmptyValue);
     // forceHide → hideLabel/hideDescription (resolves responsive breakpoint-aware values)
     const breakpoint = ctx?.breakpoint;
     const resolvedForceHide = breakpoint
@@ -83,10 +154,20 @@ function DisplayFieldComponent(props) {
     if (isHiddenByDisplayShaping) {
         return _jsx(_Fragment, {});
     }
+    // Decorator-level hidden — a field marked `.isHidden()` (display variant) must
+    // never render in ANY display surface. This covers both the explicit-layout path
+    // (a `<DisplayField name="x" />` whose schema is `.isHidden()`) and the recursive
+    // object-render path (DisplayValueDispatcher renders each nested field through this
+    // gate), so hidden audit/internal sub-fields stay out of whole-object renders too.
+    // (`isHiddenByDisplayShaping` above handles runtime/relationship shaping via the
+    // `hiddenFieldNames` context; this handles the static schema decorator.)
+    if (schema && isHiddenForDisplay(schema)) {
+        return _jsx(_Fragment, {});
+    }
     // DD-9: Template-as-skeleton — render Skeleton when loading
     const isLoading = ctx?.isLoading ?? false;
     if (isLoading) {
-        return (_jsx(DisplayFieldChrome, { mode: resolvedChromeMode, label: label, name: resolvedName, hideLabel: hideLabel, hideDescription: true, tooltip: tooltipProp, children: _jsx(Skeleton, { className: "h-5 w-full" }) }));
+        return (_jsx(DisplayFieldChrome, { mode: resolvedChromeMode, label: label, name: resolvedName, labelPlacement: resolvedLabelPlacement, hideLabel: hideLabel, hideDescription: true, tooltip: tooltipProp, children: _jsx(Skeleton, { className: "h-5 w-full" }) }));
     }
     // DD-10: Per-field showWhen — hidden by condition.
     // When inside an ObjectScope (pathPrefix set), evaluate showWhen against the scoped
@@ -98,6 +179,13 @@ function DisplayFieldComponent(props) {
     if (showWhenParams && showWhenData && !AutomatedLayoutFrontendUtils.evaluateShowWhen(showWhenParams, showWhenData)) {
         return _jsx(_Fragment, {});
     }
+    // Field-level hide-when-empty — a field decorated with
+    // `{primitive}UI({ display: { hideWhenEmpty: true } })` is omitted from the
+    // DISPLAY surface entirely when its value is empty (no label, no em-dash).
+    // Display-only: the edit form still renders the field so it can be filled.
+    if (displayConfig?.hideWhenEmpty && isEmptyDisplayValue(value)) {
+        return _jsx(_Fragment, {});
+    }
     // No schema — cannot render
     if (!schema || !schemaType) {
         logger.error('[DisplayField] Cannot resolve schema for field', { name: resolvedName });
@@ -120,9 +208,22 @@ function DisplayFieldComponent(props) {
         hideLabel,
         hideDescription,
         resolvedChromeMode,
+        resolvedLabelPlacement,
+        resolvedEmptyValue,
         fileUploadContext,
     };
-    return (_jsx(DisplayFieldErrorBoundary, { name: resolvedName, children: isInlineEditable ? (_jsx(DisplayFieldEditable, { ...resolvedProps, doInlineUpdate: doInlineUpdate, rmm: rmm })) : (_jsx(DisplayFieldReadOnly, { ...resolvedProps })) }));
+    return (_jsx(DisplayFieldErrorBoundary, { name: resolvedName, children: isInlineEditable && schemaType === FieldSchemaType.ARRAY ? (
+        // Inline-editable ARRAY → a PERSISTENT inline editor (add / edit / remove /
+        // reorder, whole-array autosave) instead of the scalar click-to-edit overlay.
+        // `isInlineEditable` already guarantees `resolvedName` is a non-empty string.
+        _jsx(DisplayFieldEditableArray, { name: resolvedName, schema: schema, value: value, label: label, description: description, doInlineUpdate: doInlineUpdate, renderField: props.renderField, sectionAppearance: props.sectionAppearance, objectItemLayout: props.objectItemLayout })) : isInlineEditable ? (_jsx(DisplayFieldEditable, { ...resolvedProps, doInlineUpdate: doInlineUpdate, rmm: rmm })) : schemaType === FieldSchemaType.ARRAY && props.sectionAppearance ? (
+        // Read-only ARRAY authored via DisplayFieldArray (which sets
+        // `sectionAppearance`, GHOST by default) → render it in a controllable
+        // SECTION container (legend + appearance), matching the editable path,
+        // instead of the default chrome + bare list. Only wrapper-authored
+        // arrays pass `sectionAppearance`, so direct DisplayField usages are
+        // untouched.
+        _jsx(DisplayFieldReadOnlyArraySection, { ...resolvedProps, sectionAppearance: props.sectionAppearance })) : (_jsx(DisplayFieldReadOnly, { ...resolvedProps })) }));
 }
 DisplayFieldComponent.displayName = 'DisplayField';
 export const DisplayField = DisplayFieldComponent;
@@ -155,4 +256,4 @@ export class DisplayFieldErrorBoundary extends React.Component {
         return this.props.children;
     }
 }
-//# sourceMappingURL=DisplayField.js.map
+//# sourceMappingURL=DisplayField.js.map

package/dist/esm/components/data-display/DisplayField.js.map

@@ -1 +1 @@
-{"version":3,"file":"DisplayField.js","sourceRoot":"","sources":["../../../../src/components/data-display/DisplayField.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"DisplayField.js","sourceRoot":"","sources":["../../../../../src/components/data-display/DisplayField.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * DisplayField — thin gate component for display fields.\n *\n * Resolves field props from DisplayTemplateContext, evaluates early-return\n * conditions (skeleton, showWhen, missing schema), then routes to:\n *   - DisplayFieldEditable  (inline editing available)\n *   - DisplayFieldReadOnly  (pure display)\n *\n * Wraps the routed component in DisplayFieldErrorBoundary for crash isolation.\n *\n * Pattern: Gate → Resolution → Early Returns → Route → ErrorBoundary → Child\n */\n\nimport React from 'react';\nimport { z } from 'zod';\n\nimport { useOptionalDisplayTemplateContext } from './DisplayTemplateContext';\nimport { DisplayContextKind, useDisplayContextKind } from './DisplayContextKindContext';\nimport { useFieldScope } from '~wildo-frontend-lib/components/resources/skeleton/FieldScopeContext';\nimport { useDisplayChromeContext } from './chromes/DisplayChromeContext';\nimport { DisplayFieldChrome } from './chromes/DisplayFieldChrome';\nimport { Skeleton } from '~wildo-frontend-lib/components/feedback/skeleton';\nimport { useSurfacePolicy } from '~wildo-frontend-lib/core/ui/SurfacePolicyContext';\nimport { getFieldSchema, getNestedValue, getParentData, resolveResponsiveValue } from './display-field-resolution.utils';\nimport {\n  DisplayChromeMode,\n  getSchemaType,\n  getFieldUIDisplayConfig,\n  getFieldUISummaryDisplayConfig,\n  getShowWhenParams,\n  hasInlineEditableDecorator,\n  isHiddenForDisplay,\n  type DisplayFieldComponent as DisplayFieldComponentEnum,\n  FieldSchemaType,\n  type ForceHideDisplayConfig,\n  ArrayObjectItemLayout,\n  type SoloSectionMode,\n} from '@wildo-ai/zod-decorators';\nimport type { AutoEmptyValue, AutoLabelPlacement } from '@wildo-ai/presets-components-models';\n\nimport { useResourceDisplayContext } from './automatic-displayer.utils';\nimport { AutomatedLayoutFrontendUtils } from '~wildo-frontend-lib/core/automated-layout/automated-layout.frontend.utils';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\nimport { DisplayFieldReadOnly } from './DisplayFieldReadOnly';\nimport { DisplayFieldReadOnlyArraySection } from './DisplayFieldReadOnlyArraySection';\nimport { DisplayFieldEditable } from './DisplayFieldEditable';\nimport { DisplayFieldEditableArray } from './DisplayFieldEditableArray';\n\nconst logger = LoggerFrontendService.getLogger();\n\nfunction resolveSurfaceDisplayChromeMode(value: string | undefined): DisplayChromeMode | undefined {\n  switch (value) {\n    case 'stacked':\n      return DisplayChromeMode.STACKED;\n    case 'inline':\n      return DisplayChromeMode.INLINE;\n    case 'compact':\n      return DisplayChromeMode.COMPACT;\n    default:\n      return undefined;\n  }\n}\n\nfunction resolveSurfaceAutoEmptyValue(value: string | undefined): AutoEmptyValue | undefined {\n  switch (value) {\n    case 'em-dash':\n    case 'placeholder':\n    case 'hidden':\n    case 'skeleton':\n      return value;\n    default:\n      return undefined;\n  }\n}\n\nfunction resolveSurfaceAutoLabelPlacement(value: string | undefined): AutoLabelPlacement | undefined {\n  switch (value) {\n    case 'top':\n    case 'start':\n    case 'inline':\n    case 'hidden':\n      return value;\n    default:\n      return undefined;\n  }\n}\n\n/**\n * Emptiness test for the field-level `display.hideWhenEmpty` mechanism.\n *\n * A value counts as empty when it is null / undefined, an empty (or\n * whitespace-only) string, or an empty array. Object/scalar values with any\n * content are considered present. This mirrors what every display formatter\n * treats as the \"—\" em-dash case, centralized here so a `hideWhenEmpty` field\n * drops out of the read surface entirely instead of rendering the placeholder.\n */\nfunction isEmptyDisplayValue(value: unknown): boolean {\n  if (value === null || value === undefined) {\n    return true;\n  }\n  if (typeof value === 'string') {\n    return value.trim() === '';\n  }\n  if (Array.isArray(value)) {\n    return value.length === 0;\n  }\n  return false;\n}\n\nfunction fieldMatchesDisplayShapingRule(fieldName: string | undefined, rules?: string[]): boolean {\n  if (!fieldName || !rules || rules.length === 0) {\n    return false;\n  }\n\n  return rules.some((rule) => (\n    fieldName === rule ||\n    fieldName.startsWith(`${rule}.`) ||\n    fieldName.startsWith(`${rule}[`)\n  ));\n}\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\nexport interface DisplayFieldProps {\n  /**\n   * Field name — the primary identifier. All other props are resolved from\n   * DisplayTemplateContext when absent.\n   */\n  name?: string;\n\n  /** Field schema — resolved from context via `getFieldSchema(ctx.schema, resolvedName)` when absent. */\n  schema?: z.ZodTypeAny;\n  /** Field schema type — resolved via `getSchemaType(resolvedSchema)` when absent. */\n  schemaType?: FieldSchemaType;\n  /** Display component override — when set, overrides the schemaType-based component dispatch. */\n  displayComponent?: DisplayFieldComponentEnum;\n  /** Field value — resolved from context via `getNestedValue(ctx.data, resolvedName)` when absent. */\n  value?: unknown;\n  /** Enum labels — resolved from context via `ctx.enumLabels[resolvedName]` when absent. */\n  enumLabels?: Record<string, string>;\n  /** Field label — resolved from context via `ctx.fieldLabels[resolvedName]` when absent. */\n  label?: string;\n  /** Field description — resolved from context via `ctx.fieldDescriptions[resolvedName]` when absent. */\n  description?: string;\n  /**\n   * Tooltip text to display next to the field label.\n   * Resolved from i18n via `ctx.fieldTooltips[resolvedName]` when absent.\n   */\n  tooltip?: string;\n  /** When true, label is hidden regardless of chrome mode. */\n  hideLabel?: boolean;\n  /** When true, description is hidden regardless of chrome mode. */\n  hideDescription?: boolean;\n  /** Explicit label placement; falls back to surface policy when absent. */\n  labelPlacement?: AutoLabelPlacement;\n  className?: string;\n\n  /** Force disable inline editing for this specific field. */\n  disableInlineEdit?: boolean;\n\n  /**\n   * Current recursion depth for nested objects/arrays (ROBUST-02).\n   * @default 0\n   */\n  depth?: number;\n\n  /**\n   * The parent data object containing this field (REL-02).\n   * Resolved from context via `getParentData(ctx.data, pathPrefix)` when absent.\n   */\n  parentData?: Record<string, unknown>;\n\n  /**\n   * @internal Array plumbing — set via `DisplayFieldArray`, not directly.\n   * Per-array-item TEMPLATE, forwarded to `AutomatedArrayField.renderField`\n   * for INLINE-EDITABLE arrays. Receives `(itemPath, itemSchema)` scoped to the\n   * array's local edit form (e.g. `checklist.0`).\n   */\n  renderField?: (name: string, schema: z.ZodTypeAny) => React.ReactNode;\n  /** @internal Array plumbing — set via `DisplayFieldArray`. Array section-frame appearance. */\n  sectionAppearance?: SoloSectionMode;\n  /** @internal Array plumbing — set via `DisplayFieldArray`. Per-placement item-layout override. */\n  objectItemLayout?: ArrayObjectItemLayout;\n}\n\n// =============================================================================\n// GATE COMPONENT\n// =============================================================================\n\nfunction DisplayFieldComponent(props: DisplayFieldProps): React.JSX.Element {\n  // ── Context resolution ──\n  const ctx = useOptionalDisplayTemplateContext();\n  const { pathPrefix } = useFieldScope();\n  const surfacePolicy = useSurfacePolicy();\n  const displayContextKind = useDisplayContextKind();\n\n  const effectiveName = props.name;\n  const resolvedName = effectiveName\n    ? (pathPrefix ? `${pathPrefix}.${effectiveName}` : effectiveName)\n    : undefined;\n\n  const schema = props.schema ?? (resolvedName ? getFieldSchema(ctx?.schema, resolvedName) : undefined);\n  const schemaType = props.schemaType ?? (schema ? getSchemaType(schema) : undefined);\n  const value = props.value ?? (resolvedName ? getNestedValue(ctx?.data, resolvedName) : undefined);\n  const label = props.label ?? (resolvedName ? ctx?.fieldLabels?.[resolvedName] : undefined);\n  const description = props.description ?? (resolvedName ? ctx?.fieldDescriptions?.[resolvedName] : undefined);\n  const tooltipProp = props.tooltip ?? (resolvedName ? ctx?.fieldTooltips?.[resolvedName] : undefined);\n  const enumLabels = props.enumLabels ?? (resolvedName ? ctx?.enumLabels?.[resolvedName] : undefined);\n  // SUMMARY surfaces resolve base display params with `summaryOverride` merged\n  // over `display` (the {primitive}UI decorator contract for cards/FK previews).\n  const displayConfig = schema\n    ? (displayContextKind === DisplayContextKind.SUMMARY\n      ? getFieldUISummaryDisplayConfig(schema)\n      : getFieldUIDisplayConfig(schema))\n    : undefined;\n  const displayComponent = props.displayComponent ?? displayConfig?.component;\n  const parentData = props.parentData ?? getParentData(ctx?.data, pathPrefix || undefined);\n  const disableInlineEdit = props.disableInlineEdit ?? false;\n  const depth = props.depth ?? 0;\n  const className = props.className;\n  const isHiddenByDisplayShaping = fieldMatchesDisplayShapingRule(resolvedName, ctx?.hiddenFieldNames);\n  const isInlineEditDisabledByDisplayShaping = fieldMatchesDisplayShapingRule(\n    resolvedName,\n    ctx?.inlineEditDisabledFieldNames,\n  );\n\n  // ── Chrome mode resolution ──\n  const { displayChromeMode, sectionChromeMode } = useDisplayChromeContext();\n  const surfaceChromeMode = resolveSurfaceDisplayChromeMode(surfacePolicy.autoRender?.autoFieldChrome);\n  const explicitChromeMode = displayConfig?.chromeMode ?? sectionChromeMode ?? displayChromeMode;\n  const resolvedChromeMode = explicitChromeMode ?? surfaceChromeMode;\n  const resolvedLabelPlacement = props.labelPlacement ?? resolveSurfaceAutoLabelPlacement(surfacePolicy.autoRender?.autoLabelPlacement);\n  const resolvedEmptyValue = resolveSurfaceAutoEmptyValue(surfacePolicy.autoRender?.autoEmptyValue);\n\n  // forceHide → hideLabel/hideDescription (resolves responsive breakpoint-aware values)\n  const breakpoint = ctx?.breakpoint;\n  const resolvedForceHide = breakpoint\n    ? resolveResponsiveValue<ForceHideDisplayConfig>(displayConfig?.forceHide, breakpoint)\n    : (displayConfig?.forceHide as ForceHideDisplayConfig | undefined);\n  const forceHideLabel = resolvedForceHide?.label === true;\n  const forceHideDescription = resolvedForceHide?.description === true;\n\n  const hideLabel = (props.hideLabel === true) || forceHideLabel;\n  const hideDescription = (props.hideDescription === true) || forceHideDescription;\n\n  // ── Resource display context (lightweight read for routing + fileUploadContext) ──\n  const {\n    canInlineEdit: contextCanInlineEdit,\n    doInlineUpdate,\n    fileUploadContext,\n    rmm,\n  } = useResourceDisplayContext();\n\n  // ── Inline edit gate ──\n  const hasDecorator = resolvedName && schema && hasInlineEditableDecorator(schema);\n  const isInlineEditable = (\n    !disableInlineEdit &&\n    !isInlineEditDisabledByDisplayShaping &&\n    contextCanInlineEdit &&\n    !!hasDecorator\n  );\n\n  // ── Early returns (after all hooks) ──\n\n  if (isHiddenByDisplayShaping) {\n    return <></>;\n  }\n\n  // Decorator-level hidden — a field marked `.isHidden()` (display variant) must\n  // never render in ANY display surface. This covers both the explicit-layout path\n  // (a `<DisplayField name=\"x\" />` whose schema is `.isHidden()`) and the recursive\n  // object-render path (DisplayValueDispatcher renders each nested field through this\n  // gate), so hidden audit/internal sub-fields stay out of whole-object renders too.\n  // (`isHiddenByDisplayShaping` above handles runtime/relationship shaping via the\n  // `hiddenFieldNames` context; this handles the static schema decorator.)\n  if (schema && isHiddenForDisplay(schema)) {\n    return <></>;\n  }\n\n  // DD-9: Template-as-skeleton — render Skeleton when loading\n  const isLoading = ctx?.isLoading ?? false;\n  if (isLoading) {\n    return (\n      <DisplayFieldChrome\n        mode={resolvedChromeMode}\n        label={label}\n        name={resolvedName}\n        labelPlacement={resolvedLabelPlacement}\n        hideLabel={hideLabel}\n        hideDescription={true}\n        tooltip={tooltipProp}\n      >\n        <Skeleton className=\"h-5 w-full\" />\n      </DisplayFieldChrome>\n    );\n  }\n\n  // DD-10: Per-field showWhen — hidden by condition.\n  // When inside an ObjectScope (pathPrefix set), evaluate showWhen against the scoped\n  // parent data so sibling references resolve correctly (e.g., showWhen({ field: 'country' })\n  // on address.city checks address.country, not root.country).\n  // Falls back to root data when no pathPrefix or parent data is unavailable.\n  const showWhenParams = schema ? getShowWhenParams(schema) : undefined;\n  const showWhenData = (pathPrefix && parentData) ? parentData : ctx?.data;\n  if (showWhenParams && showWhenData && !AutomatedLayoutFrontendUtils.evaluateShowWhen(showWhenParams, showWhenData)) {\n    return <></>;\n  }\n\n  // Field-level hide-when-empty — a field decorated with\n  // `{primitive}UI({ display: { hideWhenEmpty: true } })` is omitted from the\n  // DISPLAY surface entirely when its value is empty (no label, no em-dash).\n  // Display-only: the edit form still renders the field so it can be filled.\n  if (displayConfig?.hideWhenEmpty && isEmptyDisplayValue(value)) {\n    return <></>;\n  }\n\n  // No schema — cannot render\n  if (!schema || !schemaType) {\n    logger.error('[DisplayField] Cannot resolve schema for field', { name: resolvedName });\n    return <></>;\n  }\n\n  // ── Resolved props for child components ──\n  const resolvedProps = {\n    schema,\n    schemaType,\n    value,\n    fieldName: resolvedName,\n    label,\n    description,\n    tooltip: tooltipProp,\n    enumLabels,\n    displayComponent,\n    parentData,\n    depth,\n    className,\n    hideLabel,\n    hideDescription,\n    resolvedChromeMode,\n    resolvedLabelPlacement,\n    resolvedEmptyValue,\n    fileUploadContext,\n  };\n\n  return (\n    <DisplayFieldErrorBoundary name={resolvedName}>\n      {isInlineEditable && schemaType === FieldSchemaType.ARRAY ? (\n        // Inline-editable ARRAY → a PERSISTENT inline editor (add / edit / remove /\n        // reorder, whole-array autosave) instead of the scalar click-to-edit overlay.\n        // `isInlineEditable` already guarantees `resolvedName` is a non-empty string.\n        <DisplayFieldEditableArray\n          name={resolvedName as string}\n          schema={schema}\n          value={value}\n          label={label}\n          description={description}\n          doInlineUpdate={doInlineUpdate}\n          renderField={props.renderField}\n          sectionAppearance={props.sectionAppearance}\n          objectItemLayout={props.objectItemLayout}\n        />\n      ) : isInlineEditable ? (\n        <DisplayFieldEditable\n          {...resolvedProps}\n          doInlineUpdate={doInlineUpdate}\n          rmm={rmm}\n        />\n      ) : schemaType === FieldSchemaType.ARRAY && props.sectionAppearance ? (\n        // Read-only ARRAY authored via DisplayFieldArray (which sets\n        // `sectionAppearance`, GHOST by default) → render it in a controllable\n        // SECTION container (legend + appearance), matching the editable path,\n        // instead of the default chrome + bare list. Only wrapper-authored\n        // arrays pass `sectionAppearance`, so direct DisplayField usages are\n        // untouched.\n        <DisplayFieldReadOnlyArraySection {...resolvedProps} sectionAppearance={props.sectionAppearance} />\n      ) : (\n        <DisplayFieldReadOnly {...resolvedProps} />\n      )}\n    </DisplayFieldErrorBoundary>\n  );\n}\n\nDisplayFieldComponent.displayName = 'DisplayField';\n\nexport const DisplayField: typeof DisplayFieldComponent & { displayName: string } = DisplayFieldComponent;\n\n// =============================================================================\n// ERROR BOUNDARY (ROBUST-01)\n// =============================================================================\n\ninterface DisplayFieldErrorBoundaryProps {\n  name?: string;\n  children: React.ReactNode;\n}\n\ninterface DisplayFieldErrorBoundaryState {\n  hasError: boolean;\n}\n\n/**\n * Lightweight error boundary wrapping individual DisplayField instances.\n * Prevents a single malformed field value from crashing the entire page.\n *\n * Uses hardcoded English for the fallback message because class components\n * cannot call hooks (useI18n). Error boundaries are a last resort — the\n * message is developer-facing, not user-facing in normal operation.\n */\nexport class DisplayFieldErrorBoundary extends React.Component<\n  DisplayFieldErrorBoundaryProps,\n  DisplayFieldErrorBoundaryState\n> {\n  state: DisplayFieldErrorBoundaryState = { hasError: false };\n\n  static getDerivedStateFromError(): DisplayFieldErrorBoundaryState {\n    return { hasError: true };\n  }\n\n  componentDidCatch(error: Error, errorInfo: React.ErrorInfo): void {\n    const fieldId = this.props.name;\n    logger.error('[DisplayField] Error boundary caught error', {\n      name: fieldId,\n      error: error.message,\n      componentStack: errorInfo.componentStack,\n    });\n  }\n\n  render(): React.ReactNode {\n    const fieldId = this.props.name;\n    if (this.state.hasError) {\n      return (\n        <div className=\"flex items-center gap-element px-card-sm py-item-xs rounded-md bg-destructive/10 border border-destructive/20\">\n          <span className=\"text-destructive text-sm\">Error rendering field</span>\n          {fieldId && (\n            <code className=\"text-xs text-destructive/70 px-item-xs rounded bg-destructive/5\">{fieldId}</code>\n          )}\n        </div>\n      );\n    }\n    return this.props.children;\n  }\n}\n"]}

package/dist/esm/components/data-display/DisplayFieldArray.d.ts

@@ -0,0 +1,45 @@
+import * as React from 'react';
+import type { z } from 'zod';
+import { type ArrayObjectItemLayout, type SoloSectionMode } from '@wildo-ai/zod-decorators';
+/**
+ * DisplayFieldArray — the template-facing component for authoring an ARRAY field
+ * on a display / read surface.
+ *
+ * Array-specific concerns live HERE — the per-item template (`renderItem`), the
+ * array's section-frame appearance (`sectionAppearance`), and a per-placement
+ * item-layout override (`objectItemLayout`) — instead of leaking onto the
+ * generic `DisplayField` (where they mean nothing for a scalar field). It
+ * delegates to `DisplayField` for schema resolution + the inline-editable / read
+ * dispatch, so there's no duplicated resolution logic.
+ *
+ * Semantic TRUTHS about the field (is it inline-editable? sortable? the default
+ * item layout?) stay on the `arrayUI` schema decorator; these props are
+ * PRESENTATION for this placement and win over the decorator default.
+ */
+export interface DisplayFieldArrayProps {
+    /** The array field name (dot path), resolved against the display template context. */
+    name: string;
+    /**
+     * Per-item TEMPLATE. Receives `(itemPath, itemSchema)` — `itemPath` is scoped
+     * to the array's local edit form (e.g. `checklist.0`). Bind item sub-fields
+     * with `useArrayItemAutosaveField`.
+     */
+    renderItem?: (itemPath: string, itemSchema: z.ZodTypeAny) => React.ReactNode;
+    /**
+     * Appearance of the array's own section frame (legend + item list). Defaults
+     * to `SectionMode.GHOST` — a quiet, frameless section (legend + list, no card
+     * border). Opt into `CARD` to containerize it in a framed card, `COLLAPSIBLE`
+     * for a toggle.
+     */
+    sectionAppearance?: SoloSectionMode;
+    /** Per-placement item framing override (`CARD` framed cards vs compact `ROW`). */
+    objectItemLayout?: ArrayObjectItemLayout;
+    className?: string;
+    hideLabel?: boolean;
+    hideDescription?: boolean;
+}
+export declare function DisplayFieldArray({ name, renderItem, sectionAppearance, objectItemLayout, className, hideLabel, hideDescription, }: DisplayFieldArrayProps): React.JSX.Element;
+export declare namespace DisplayFieldArray {
+    var displayName: string;
+}
+//# sourceMappingURL=DisplayFieldArray.d.ts.map

package/dist/esm/components/data-display/DisplayFieldArray.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DisplayFieldArray.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DisplayFieldArray.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAe,KAAK,qBAAqB,EAAE,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAIzG;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,sBAAsB;IACrC,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,KAAK,KAAK,CAAC,SAAS,CAAC;IAC7E;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,eAAe,CAAC;IACpC,kFAAkF;IAClF,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,iBAAiB,CAAC,EAChC,IAAI,EACJ,UAAU,EACV,iBAAqC,EACrC,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,eAAe,GAChB,EAAE,sBAAsB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAY5C;yBApBe,iBAAiB"}

package/dist/esm/components/data-display/DisplayFieldArray.js

@@ -0,0 +1,8 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { SectionMode } from '@wildo-ai/zod-decorators';
+import { DisplayField } from './DisplayField.js';
+export function DisplayFieldArray({ name, renderItem, sectionAppearance = SectionMode.GHOST, objectItemLayout, className, hideLabel, hideDescription, }) {
+    return (_jsx(DisplayField, { name: name, renderField: renderItem, sectionAppearance: sectionAppearance, objectItemLayout: objectItemLayout, className: className, hideLabel: hideLabel, hideDescription: hideDescription }));
+}
+DisplayFieldArray.displayName = 'DisplayFieldArray';
+//# sourceMappingURL=DisplayFieldArray.js.map

package/dist/esm/components/data-display/DisplayFieldArray.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DisplayFieldArray.js","sourceRoot":"","sources":["../../../../../src/components/data-display/DisplayFieldArray.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,WAAW,EAAoD,MAAM,0BAA0B,CAAC;AAEzG,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAwC9C,MAAM,UAAU,iBAAiB,CAAC,EAChC,IAAI,EACJ,UAAU,EACV,iBAAiB,GAAG,WAAW,CAAC,KAAK,EACrC,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,eAAe,GACQ;IACvB,OAAO,CACL,KAAC,YAAY,IACX,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,UAAU,EACvB,iBAAiB,EAAE,iBAAiB,EACpC,gBAAgB,EAAE,gBAAgB,EAClC,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,eAAe,GAChC,CACH,CAAC;AACJ,CAAC;AAED,iBAAiB,CAAC,WAAW,GAAG,mBAAmB,CAAC","sourcesContent":["import * as React from 'react';\nimport type { z } from 'zod';\nimport { SectionMode, type ArrayObjectItemLayout, type SoloSectionMode } from '@wildo-ai/zod-decorators';\n\nimport { DisplayField } from './DisplayField';\n\n/**\n * DisplayFieldArray — the template-facing component for authoring an ARRAY field\n * on a display / read surface.\n *\n * Array-specific concerns live HERE — the per-item template (`renderItem`), the\n * array's section-frame appearance (`sectionAppearance`), and a per-placement\n * item-layout override (`objectItemLayout`) — instead of leaking onto the\n * generic `DisplayField` (where they mean nothing for a scalar field). It\n * delegates to `DisplayField` for schema resolution + the inline-editable / read\n * dispatch, so there's no duplicated resolution logic.\n *\n * Semantic TRUTHS about the field (is it inline-editable? sortable? the default\n * item layout?) stay on the `arrayUI` schema decorator; these props are\n * PRESENTATION for this placement and win over the decorator default.\n */\nexport interface DisplayFieldArrayProps {\n  /** The array field name (dot path), resolved against the display template context. */\n  name: string;\n  /**\n   * Per-item TEMPLATE. Receives `(itemPath, itemSchema)` — `itemPath` is scoped\n   * to the array's local edit form (e.g. `checklist.0`). Bind item sub-fields\n   * with `useArrayItemAutosaveField`.\n   */\n  renderItem?: (itemPath: string, itemSchema: z.ZodTypeAny) => React.ReactNode;\n  /**\n   * Appearance of the array's own section frame (legend + item list). Defaults\n   * to `SectionMode.GHOST` — a quiet, frameless section (legend + list, no card\n   * border). Opt into `CARD` to containerize it in a framed card, `COLLAPSIBLE`\n   * for a toggle.\n   */\n  sectionAppearance?: SoloSectionMode;\n  /** Per-placement item framing override (`CARD` framed cards vs compact `ROW`). */\n  objectItemLayout?: ArrayObjectItemLayout;\n  className?: string;\n  hideLabel?: boolean;\n  hideDescription?: boolean;\n}\n\nexport function DisplayFieldArray({\n  name,\n  renderItem,\n  sectionAppearance = SectionMode.GHOST,\n  objectItemLayout,\n  className,\n  hideLabel,\n  hideDescription,\n}: DisplayFieldArrayProps): React.JSX.Element {\n  return (\n    <DisplayField\n      name={name}\n      renderField={renderItem}\n      sectionAppearance={sectionAppearance}\n      objectItemLayout={objectItemLayout}\n      className={className}\n      hideLabel={hideLabel}\n      hideDescription={hideDescription}\n    />\n  );\n}\n\nDisplayFieldArray.displayName = 'DisplayFieldArray';\n"]}

package/dist/esm/components/data-display/DisplayFieldEditable.d.ts

@@ -9,15 +9,15 @@
  * Edit mode:   DisplayFieldChrome → FormField with embedded FormFieldChrome
  */
 import React from 'react';
-import type { ResourceMutationManager } from '../../core/resources/rmm/ResourceMutationManager.js';
-import type { DisplayFieldResolvedProps } from './display-field-resolved-props.js';
+import type { ResourceMutationManager } from '../../core/resources/rmm/ResourceMutationManager';
+import type { DisplayFieldResolvedProps } from './display-field-resolved-props';
 export interface DisplayFieldEditableProps extends DisplayFieldResolvedProps {
     /** Callback to save an inline edit. From ResourceDisplayContext. */
     doInlineUpdate: (fieldName: string, value: unknown) => Promise<void>;
     /** RMM instance for reacting to external mutations. */
     rmm?: ResourceMutationManager | null;
 }
-export declare function DisplayFieldEditable(props: DisplayFieldEditableProps): React.JSX.Element;
+export declare function DisplayFieldEditable(props: DisplayFieldEditableProps): React.JSX.Element | null;
 export declare namespace DisplayFieldEditable {
     var displayName: string;
 }

package/dist/esm/components/data-display/DisplayFieldEditable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DisplayFieldEditable.d.ts","sourceRoot":"","sources":["../../../../src/components/data-display/DisplayFieldEditable.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAkF,MAAM,OAAO,CAAC;AAyBvG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gEAAgE,CAAC;AAO9G,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AA0ChF,MAAM,WAAW,yBAA0B,SAAQ,yBAAyB;IAC1E,oEAAoE;IACpE,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,uDAAuD;IACvD,GAAG,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;CACtC;AAMD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAocxF;yBApce,oBAAoB"}
+{"version":3,"file":"DisplayFieldEditable.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DisplayFieldEditable.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAkF,MAAM,OAAO,CAAC;AA0BvG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gEAAgE,CAAC;AAS9G,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AA0ChF,MAAM,WAAW,yBAA0B,SAAQ,yBAAyB;IAC1E,oEAAoE;IACpE,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,uDAAuD;IACvD,GAAG,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;CACtC;AAMD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAghB/F;yBAhhBe,oBAAoB"}

package/dist/esm/components/data-display/DisplayFieldEditable.js

@@ -24,12 +24,14 @@ import { Alert, AlertDescription } from '../../components/overlays/containers/al
 import { FrontendComponentType, UIBehavior, IndicatorVariant } from '@wildo-ai/presets-components-models';
 import { cn } from '../../core/ui/cn.js';
 import { CoreResourceOperation } from '@wildo-ai/saas-models';
-import { FieldSchemaType, getInlineEditableParams, isFormTextarea, } from '@wildo-ai/zod-decorators';
+import { FieldSchemaType, getInlineEditableParams, isFormTextarea, isTemplatableFileField, } from '@wildo-ai/zod-decorators';
 import { rmmFieldPathIsDescendant, rmmReadPathValue } from '../../core/resources/rmm/field-path.utils.js';
 import { NOOP_GET_SNAPSHOT, NOOP_SUBSCRIBE } from '../../core/resources/rmm/rmm-noop-snapshot.js';
 import { RMMEventType, MutationErrorType, MutationSourceType } from '../../core/resources/rmm/types.js';
 import { FormSchemaProvider } from '../../components/form/form-context.js';
+import { FormSchemaKind } from '../../components/form/form-field-types.js';
 import { FormField } from '../../components/form/automated/FormField.js';
+import { SwitchRoot } from '../../components/form/controls/boolean/switch.js';
 import { DEFAULT_VALIDATION_MODE, InlineEditState } from '../../core/automated-layout/automated-layout.frontend.schemas.js';
 import { AutomatedLayoutFrontendUtils } from '../../core/automated-layout/automated-layout.frontend.utils.js';
 import { LoggerFrontendService } from '../../core/monitoring/logger.frontend.service.js';
@@ -64,8 +66,8 @@ const DEFAULT_INLINE_EDIT_PARAMS = {
 // COMPONENT
 // =============================================================================
 export function DisplayFieldEditable(props) {
-    const { schema, schemaType, value, fieldName, label, description, tooltip, enumLabels, displayComponent, parentData, depth, className, hideLabel, hideDescription, resolvedChromeMode, fileUploadContext, doInlineUpdate, rmm, } = props;
-    const { tComponent } = useI18n({
+    const { schema, schemaType, value, fieldName, label, description, tooltip, enumLabels, displayComponent, parentData, depth, className, hideLabel, hideDescription, resolvedChromeMode, resolvedLabelPlacement, resolvedEmptyValue, fileUploadContext, doInlineUpdate, rmm, } = props;
+    const { tComponent, isReady } = useI18n({
         component: [FrontendComponentType.LOW_LEVEL_FORM_FIELD, FrontendComponentType.LOW_LEVEL_BUTTON],
     });
     const { getRecipe } = useUI();
@@ -80,6 +82,12 @@ export function DisplayFieldEditable(props) {
     const retryButtonRef = useRef(null);
     const savedTimeoutRef = useRef(null);
     const lastProcessedEventIdRef = useRef(null);
+    // ── Boolean toggle-in-place state (T4b) ──
+    // An inline-editable boolean renders a LIVE Switch that persists immediately on
+    // toggle (no click-to-edit overlay). `optimisticBool` gives instant feedback and
+    // is cleared when the authoritative `value` arrives (or on error → revert).
+    const [booleanSaving, setBooleanSaving] = useState(false);
+    const [optimisticBool, setOptimisticBool] = useState(null);
     // Truncation state for arrays/objects (ROBUST-03)
     const [showAllArrayItems, setShowAllArrayItems] = useState(false);
     const [showAllObjectFields, setShowAllObjectFields] = useState(false);
@@ -88,6 +96,8 @@ export function DisplayFieldEditable(props) {
         if (prevValueRef.current !== value) {
             setShowAllArrayItems(false);
             setShowAllObjectFields(false);
+            // Authoritative value arrived (RMM update / conflict reset) → drop optimism.
+            setOptimisticBool(null);
             prevValueRef.current = value;
         }
     }, [value]);
@@ -116,7 +126,8 @@ export function DisplayFieldEditable(props) {
         }
         return fileUploadContext?.[AutomatedLayoutFrontendUtils.normalizeSchemaFieldPath(fieldName)];
     }, [fieldName, fileUploadContext]);
-    const supportsInlineFileEditing = schemaType !== FieldSchemaType.FILE || hasActionableFileEndpoints(inlineFileEndpoints);
+    const supportsInlineFileEditing = schemaType !== FieldSchemaType.FILE
+        || (!isTemplatableFileField(schema) && hasActionableFileEndpoints(inlineFileEndpoints));
     // ── Isolated form for inline editing ──
     // PERF: useForm() is unconditionally instantiated due to Rules of Hooks.
     // In a future refactor, extract the edit form into a child component
@@ -204,6 +215,31 @@ export function DisplayFieldEditable(props) {
         setSaveErrorMessage(null);
         setEditState(InlineEditState.DISPLAY);
     }, [form, fieldKey, value, fieldName]);
+    // ── Boolean toggle-in-place handler (T4b) ──
+    // Persists immediately via the same RMM `doInlineUpdate` path used by the
+    // click-to-edit flow. Optimistic flip for responsiveness; reverts on error
+    // (a CONFLICT is authoritative — RMM re-syncs `value`, so leave the revert to
+    // the value-change effect and surface no error message).
+    const handleBooleanToggle = useCallback(async (next) => {
+        if (!fieldName)
+            return;
+        setOptimisticBool(next);
+        setSaveErrorMessage(null);
+        setBooleanSaving(true);
+        try {
+            await doInlineUpdate(fieldName, next);
+            logDebug('inline boolean toggle', { fieldName, value: next });
+        }
+        catch (err) {
+            setOptimisticBool(null);
+            if (!(err instanceof InlineEditMutationError && err.mutationError?.type === MutationErrorType.CONFLICT)) {
+                setSaveErrorMessage(tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'save_failed'));
+            }
+        }
+        finally {
+            setBooleanSaving(false);
+        }
+    }, [fieldName, doInlineUpdate, tComponent]);
     // ── RMM event handler ──
     // Cancel inline edit when an external mutation changes this field.
     // Tracks last-processed event ID to prevent re-processing the same event
@@ -284,7 +320,16 @@ export function DisplayFieldEditable(props) {
     }, [handleSave, handleCancel, isMultilineField]);
     // ── Content rendering ──
     function renderDisplayValue() {
-        return (_jsx(DisplayValueDispatcher, { schema: schema, schemaType: schemaType, value: value, fieldName: fieldName, label: label, className: className, enumLabels: enumLabels, displayComponent: displayComponent, parentData: parentData, depth: depth, fileUploadContext: fileUploadContext, showAllArrayItems: showAllArrayItems, onExpandArrayItems: () => setShowAllArrayItems(true), showAllObjectFields: showAllObjectFields, onExpandObjectFields: () => setShowAllObjectFields(true) }));
+        return (_jsx(DisplayValueDispatcher, { schema: schema, schemaType: schemaType, value: value, fieldName: fieldName, label: label, className: className, enumLabels: enumLabels, displayComponent: displayComponent, parentData: parentData, depth: depth, emptyValue: resolvedEmptyValue, fileUploadContext: fileUploadContext, showAllArrayItems: showAllArrayItems, onExpandArrayItems: () => setShowAllArrayItems(true), showAllObjectFields: showAllObjectFields, onExpandObjectFields: () => setShowAllObjectFields(true) }));
+    }
+    // Boolean toggle-in-place (T4b): a live Switch, right-pinned in the settings row,
+    // that writes immediately on toggle. No click-to-edit overlay, no ✓/✕ glyph.
+    function renderBooleanToggle() {
+        const checked = optimisticBool ?? !!value;
+        return (_jsxs("div", { className: "inline-flex items-center gap-element", children: [booleanSaving && (_jsx("span", { className: "text-muted-foreground", "aria-hidden": "true", children: renderIcon(StandardIconReference.LOADER_2, {
+                        size: IconSize.SM,
+                        className: 'animate-spin motion-reduce:animate-none',
+                    }) })), saveErrorMessage && !booleanSaving && (_jsx("span", { className: "text-destructive text-xs", role: "alert", children: saveErrorMessage })), _jsx(SwitchRoot, { checked: checked, onCheckedChange: handleBooleanToggle, disabled: booleanSaving, "aria-label": label || fieldName || undefined })] }));
     }
     function renderInlineEditTrigger() {
         return (_jsxs(Button, { type: "button", variant: ButtonVariants_Variant.GHOST, className: cn("group relative inline-flex items-center gap-element h-auto px-card-sm py-item-xs"), onClick: () => {
@@ -297,7 +342,13 @@ export function DisplayFieldEditable(props) {
     function renderInlineEditForm() {
         const errorAlertId = fieldName ? `inline-edit-error-${fieldName.replace(/\./g, '-')}` : undefined;
         const hasError = editState === InlineEditState.ERROR && !!saveErrorMessage;
-        return (_jsx(FormSchemaProvider, { schema: formSchema, form: form, resourceType: resourceDisplayContext.resourceType, resourceId: resourceDisplayContext.resourceId, operationType: CoreResourceOperation.UPDATE, contextResourceIdentifiers: resourceDisplayContext.contextResourceIdentifiers, navigationZone: resourceDisplayContext.navigationZone, children: _jsxs("div", { ref: containerRef, className: "inline-flex flex-col gap-item-xs min-w-[200px]", onBlur: handleContainerBlur, onKeyDown: handleKeyDown, "aria-describedby": hasError ? errorAlertId : undefined, children: [_jsxs("div", { className: "flex items-start gap-element", children: [_jsx("div", { className: "flex-1", children: _jsx(FormField, { name: fieldKey, quickCreateSourceFieldName: relationshipInlineEditSurface?.sourceFieldName, schema: schema, label: "", description: "", disabled: isSaving, placeholder: label, enumLabels: enumLabels, fileUploadContext: inlineFileEndpoints
+        return (_jsx(FormSchemaProvider, { schema: formSchema, 
+            // This surface wraps a single field from the resource's MAIN schema, not an operation
+            // request DTO. Declaring it is what lets `FormField` ask the right clearability question:
+            // on a main schema an ordinary `.optional()` field does not accept `null`, so the
+            // request-DTO question would report every clearable field un-clearable — which left
+            // refined optional fields (colour, email, url) impossible to empty inline.
+            schemaKind: FormSchemaKind.MAIN_SCHEMA, form: form, resourceType: resourceDisplayContext.resourceType, resourceId: resourceDisplayContext.resourceId, operationType: CoreResourceOperation.UPDATE, contextResourceIdentifiers: resourceDisplayContext.contextResourceIdentifiers, navigationZone: resourceDisplayContext.navigationZone, children: _jsxs("div", { ref: containerRef, className: "inline-flex flex-col gap-item-xs min-w-[200px]", onBlur: handleContainerBlur, onKeyDown: handleKeyDown, "aria-describedby": hasError ? errorAlertId : undefined, children: [_jsxs("div", { className: "flex items-start gap-element", children: [_jsx("div", { className: "flex-1", children: _jsx(FormField, { name: fieldKey, quickCreateSourceFieldName: relationshipInlineEditSurface?.sourceFieldName, schema: schema, label: "", description: "", disabled: isSaving, placeholder: label, enumLabels: enumLabels, respectSurfaceErrorPlacement: false, fileUploadContext: inlineFileEndpoints
                                         ? { [fieldKey]: inlineFileEndpoints }
                                         : undefined, className: "inline-edit-field" }) }), _jsxs("div", { className: "flex items-center gap-item-xs shrink-0 pt-item-xs", children: [editState === InlineEditState.SAVED && (_jsx("div", { className: successIndicatorRecipe.base, "aria-hidden": "true", children: renderIcon(StandardIconReference.CHECK, { size: IconSize.SM }) })), params.showSaveButton && editState !== InlineEditState.SAVED && (_jsx(Button, { type: "button", size: ButtonSize.SM, variant: ButtonVariants_Variant.DEFAULT, onClick: handleSave, disabled: isSaving, "aria-label": tComponent(FrontendComponentType.LOW_LEVEL_BUTTON, 'save'), children: editState === InlineEditState.SAVING
                                             ? renderIcon(StandardIconReference.LOADER_2, {
@@ -312,9 +363,15 @@ export function DisplayFieldEditable(props) {
                                 return (_jsx(Button, { ref: retryButtonRef, type: "button", size: ButtonSize.SM, variant: ButtonVariants_Variant.GHOST, onClick: handleSave, disabled: isSaving, "aria-label": retryLabel, title: retryLabel, children: renderIcon(StandardIconReference.TRY_AGAIN, { size: IconSize.SM }) }));
                             })()] }))] }) }));
     }
+    if (!isReady)
+        return null;
     // ── Determine content based on edit state ──
     let content;
-    if (isInEditMode && fieldName && supportsInlineFileEditing) {
+    if (schemaType === FieldSchemaType.BOOLEAN && fieldName) {
+        // Inline-editable boolean → live toggle-in-place Switch (T4b), no overlay.
+        content = renderBooleanToggle();
+    }
+    else if (isInEditMode && fieldName && supportsInlineFileEditing) {
         content = renderInlineEditForm();
     }
     else if (!supportsInlineFileEditing) {
@@ -323,7 +380,7 @@ export function DisplayFieldEditable(props) {
     else {
         content = renderInlineEditTrigger();
     }
-    return (_jsx(DisplayFieldChrome, { mode: resolvedChromeMode, label: label, description: description, tooltip: tooltip, name: fieldName, hideLabel: hideLabel, hideDescription: hideDescription, className: className, children: content }));
+    return (_jsx(DisplayFieldChrome, { mode: resolvedChromeMode, label: label, description: description, tooltip: tooltip, name: fieldName, labelPlacement: resolvedLabelPlacement, hideLabel: hideLabel, hideDescription: hideDescription, className: className, children: content }));
 }
 DisplayFieldEditable.displayName = 'DisplayFieldEditable';
-//# sourceMappingURL=DisplayFieldEditable.js.map
+//# sourceMappingURL=DisplayFieldEditable.js.map