npm - @wildo-ai/saas-frontend-lib - Versions diffs - 1.1.4 → 1.1.5 - Mend

@wildo-ai/saas-frontend-lib 1.1.4 → 1.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2512) hide show

package/dist/esm/components/data-display/AutomaticDisplayer.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"AutomaticDisplayer.js","sourceRoot":"","sources":["../../../../src/components/data-display/AutomaticDisplayer.tsx"],"names":[],"mappings":"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","sourcesContent":["/*\n AutomaticDisplayer Component\n \n Renders a display template inside a provider stack:\n * ResourceDisplayContext → DisplayChromeContext → DisplayTemplateContext → template\n \n The template is a `React.ComponentType` instantiated inside `<DisplayTemplateProvider>`,\n * so it can call `useDisplayTemplateContext()` for `data`, `isLoading`, labels, etc.\n * The template is structurally stable (created from schema) and data-reactive\n * (context data changes trigger re-renders).\n \n Inline editing is wired through ResourceDisplayContext.\n /\n\nimport React, { useMemo, useCallback, useContext } from 'react';\nimport { z } from 'zod';\n\nimport type { FileActivationOperationDispatcher } from '~wildo-frontend-lib/components/data-display/useFileActivation';\nimport type { LayoutRefManifest } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport type { FrontendResource_ParentResourceRequirement } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\nimport { CoreResourceOperation, ResourceOperationVariantType } from '@wildo-ai/saas-models';\nimport { ViewportBreakpoint, isDiscriminatorField, getObjectLikeFieldSchema, normalizeClearedMainSchemaValue } from '@wildo-ai/zod-decorators';\nimport type { DisplayChromeMode, ResponsiveAware, FileFieldEndpoints } from '@wildo-ai/zod-decorators';\nimport { AutomatedLayoutFrontendUtils } from '~wildo-frontend-lib/core/automated-layout/automated-layout.frontend.utils';\n\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { frontendResourceUtils, FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { ResourcesConfig_OperationPathUtils } from '@wildo-ai/saas-models';\nimport type { ResourceMutationManager } from '~wildo-frontend-lib/core/resources/rmm/ResourceMutationManager';\nimport { MutationType, MutationPriority, MutationSourceType } from '~wildo-frontend-lib/core/resources/rmm/types';\nimport {\n allowsDirectOperationFallback,\n MissingRMMRuntimeError,\n UpdateLikeMutationFallbackMode,\n} from '~wildo-frontend-lib/core/resources/rmm/update-like-mutation-fallback.frontend';\nimport { UIContext } from '~wildo-frontend-lib/core/ui/UIContext';\nimport { useResourceLabels } from '~wildo-frontend-lib/core/resources/useResourceLabels';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport type { NavigationZone } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport type { FrontendResourceConfiguration_Operation } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { pickPreferredOperationForCoreSemanticAddressability } from '~wildo-frontend-lib/core/resources/resource-addressability.frontend.utils';\n\nimport {\n ResourceDisplayContext,\n InlineEditMutationError,\n type ResourceDisplayContextValue,\n type ParentReferenceConfig,\n} from './automatic-displayer.utils';\nimport { buildNestedObjectFromPath } from './display-field-resolution.utils';\n\nimport { DisplayChromeProvider } from './chromes/DisplayChromeContext';\nimport { DisplayTemplateProvider, type DisplayTemplateContextValue } from './DisplayTemplateContext';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('AutomaticDisplayer');\nlogger.setDebugTypeLogging('AutomaticDisplayer', false);\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\nexport interface AutomaticDisplayerLabels {\n resourceContext?: { resourceType: string; operationId: string };\n fields?: Record<string, string>;\n enums?: Record<string, Record<string, string>>;\n sections?: Record<string, { titleKey?: string; descriptionKey?: string }>;\n}\n\nexport interface AutomaticDisplayerProps<TSchema extends z.ZodTypeAny> {\n schema: TSchema;\n data: z.infer<TSchema>;\n className?: string;\n labels?: AutomaticDisplayerLabels;\n\n /* Layout ref manifest for i18n label resolution of sections/groups. /\n layoutRefs?: LayoutRefManifest;\n\n resourceType?: string;\n resourceId?: string;\n contextualParameters?: Record<string, string \| number>;\n contextResourceIdentifiers?: Record<string, string \| { fieldIdentifier: string; resourceId: string }>;\n parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n navigationZone?: NavigationZone;\n inlineEditOperation?: FrontendResourceConfiguration_Operation \| null;\n parentReferenceConfig?: ParentReferenceConfig;\n /\n Caller-owned weaker-guarantee override for inline edit.\n \n Providing this hook bypasses the default RMM-backed engine path. The caller\n * becomes responsible for any queueing, conflict handling, canonical read-back,\n * and broader coherence guarantees they still want to preserve.\n /\n onInlineEdit?: (fieldName: string, value: unknown) => Promise<void>;\n disableInlineEdit?: boolean;\n fileUploadContext?: Record<string, FileFieldEndpoints>;\n onInlineEditSuccess?: (fieldName: string, value: unknown) => void;\n rmm?: ResourceMutationManager \| null;\n /\n Controls whether inline edit may downgrade to a direct UPDATE operation when\n * RMM is unavailable. Defaults to `RMM_REQUIRED` so generic engine inline edit\n * does not silently pretend to be RMM-backed.\n \n The richer conflict-reset UX is only guaranteed on the single-resource\n * RMM-backed lane where the backend supplies authoritative nested\n * `versionConflict` details. Explicit direct fallback remains a weaker-\n * guarantee path.\n /\n updateLikeMutationFallbackMode?: UpdateLikeMutationFallbackMode;\n\n /\n The display template to render — a `React.ComponentType` instantiated inside\n * `<DisplayTemplateProvider>`. The component can call `useDisplayTemplateContext()`\n * to access `data`, `isLoading`, labels, and breakpoint.\n /\n layoutTemplate: React.ComponentType \| null;\n\n /\n Whether data is still loading. When true, DisplayField renders skeletons (DD-9).\n * @default false\n /\n isLoading?: boolean;\n\n /\n Default chrome mode for display fields from `ResourceLayoutConfig.defaultChromeMode.display`.\n * Propagated to `DisplayChromeProvider.displayChromeMode`.\n /\n defaultDisplayChromeMode?: ResponsiveAware<DisplayChromeMode>;\n\n /\n Opaque upstream shaping input for automatic READ templates.\n * Resource-aware wrappers can hide duplicate relationship-backed fields\n * without teaching generic display components relationship semantics.\n /\n hiddenFieldNames?: string[];\n\n /\n Opaque upstream shaping input for automatic READ templates.\n * Keeps generic inline edit fail-closed for relationship object/array slots.\n /\n inlineEditDisabledFieldNames?: string[];\n /\n Dispatcher for `FileActivationPolicy.CUSTOM` file activations — supplied by the\n * resource-aware host, forwarded opaquely into `DisplayTemplateContext` for the\n * generic file displayer. Absent under a non-resource host.\n */\n onFileActivationOperation?: FileActivationOperationDispatcher;\n\n}\n\n// =============================================================================\n// COMPONENT\n// =============================================================================\n\nfunction AutomaticDisplayerComponent<TSchema extends z.ZodTypeAny>({\n schema,\n data,\n className,\n labels,\n layoutRefs,\n resourceType,\n resourceId,\n contextualParameters,\n contextResourceIdentifiers,\n parentResourcesRequirements,\n navigationZone,\n inlineEditOperation,\n parentReferenceConfig,\n onInlineEdit,\n disableInlineEdit = false,\n fileUploadContext,\n onInlineEditSuccess,\n rmm,\n updateLikeMutationFallbackMode = UpdateLikeMutationFallbackMode.RMM_REQUIRED,\n layoutTemplate,\n isLoading = false,\n defaultDisplayChromeMode,\n hiddenFieldNames,\n inlineEditDisabledFieldNames,\n onFileActivationOperation,\n}: AutomaticDisplayerProps<TSchema>): React.JSX.Element {\n const { doOperation, registry } = useResourceRegistry();\n\n // ── Breakpoint resolution ──\n const uiContext = useContext(UIContext);\n const viewportBreakpoint: ViewportBreakpoint = uiContext?.UIConfig?.currentBreakpoint ?? ViewportBreakpoint.DESKTOP;\n\n // ── Labels from i18n ──\n const {\n fieldLabels,\n fieldDescriptions,\n fieldTooltips,\n enumLabels,\n sectionLabels,\n sectionDescriptions,\n groupLabels,\n } = useResourceLabels(\n schema,\n labels?.resourceContext,\n data as Record<string, unknown>,\n 'display',\n {\n layoutRefs,\n overrides: {\n fields: labels?.fields,\n enums: labels?.enums,\n sections: labels?.sections,\n },\n },\n );\n\n // ── Inline editing ──\n\n const resolveInlineUpdateOperation = useCallback((): FrontendResourceConfiguration_Operation \| null => {\n if (inlineEditOperation === null) {\n return null;\n }\n if (inlineEditOperation !== undefined) {\n const isUrlBearingOperation = inlineEditOperation.variantType === ResourceOperationVariantType.API_CALL\n \|\| inlineEditOperation.variantType === ResourceOperationVariantType.API_CALL_WITH_CALLBACK;\n const effectiveOperation = inlineEditOperation.resourceOperationLike ?? inlineEditOperation.operationIdentifier;\n if (!isUrlBearingOperation \|\| inlineEditOperation.isBulkOperation === true \|\| effectiveOperation !== CoreResourceOperation.UPDATE) {\n logDebug('Rejected invalid inlineEditOperation', {\n operationIdentifier: String(inlineEditOperation.operationIdentifier),\n variantType: inlineEditOperation.variantType,\n variantKey: inlineEditOperation.variantKey,\n isBulkOperation: inlineEditOperation.isBulkOperation,\n effectiveOperation: String(effectiveOperation),\n });\n throw new InlineEditMutationError(\n 'inlineEditOperation must be a non-bulk URL-bearing UPDATE operation',\n );\n }\n return inlineEditOperation;\n }\n if (!resourceType \|\| !resourceId) {\n return null;\n }\n\n const resourceConfig = registry.resourceConfigurations[resourceType];\n if (!resourceConfig) {\n return null;\n }\n\n const fieldIdentifier = FrontendResourceUtils.getResourceFieldIdentifierForType(resourceType, registry);\n const updateContextResourceIdentifiers = {\n ...(contextResourceIdentifiers ?? {}),\n [resourceType]: resourceId,\n };\n const updateContextualParameters = {\n ...(contextualParameters ?? {}),\n [fieldIdentifier]: resourceId,\n };\n\n return pickPreferredOperationForCoreSemanticAddressability({\n resourceConfig,\n operations: resourceConfig.operations ?? [],\n coreOperation: CoreResourceOperation.UPDATE,\n registry,\n hasResourceId: frontendResourceUtils.getResourceId(updateContextResourceIdentifiers[resourceType]).length > 0,\n requireFrontendAddressable: true,\n contextResourceIdentifiers: updateContextResourceIdentifiers,\n contextualParameters: updateContextualParameters,\n }) ?? null;\n }, [contextResourceIdentifiers, contextualParameters, inlineEditOperation, registry, resourceId, resourceType]);\n\n const hasUpdateOperation = useMemo(() => {\n return resolveInlineUpdateOperation() !== null;\n }, [resolveInlineUpdateOperation]);\n\n // Discriminator field name(s) for this resource. A discriminated-union (polymorphic)\n // resource keeps its discriminator REQUIRED on the UPDATE requestDto (it selects the\n // variant the body is validated against), so every PARTIAL inline update must carry it —\n // otherwise the backend rejects the update with `<discriminator>: Invalid input`. Resolved\n // from the display schema's COMMON shape (the discriminator is shared across all variants).\n const discriminatorFieldNames = useMemo<string[]>(() => {\n try {\n const commonShape = AutomatedLayoutFrontendUtils.getObjectLikeFieldShape(schema, { commonOnly: true }) ?? {};\n return Object.entries(commonShape)\n .filter(([, fieldSchema]) => isDiscriminatorField(fieldSchema as z.ZodTypeAny))\n .map(([discriminatorField]) => discriminatorField);\n } catch {\n return [];\n }\n }, [schema]);\n\n const doInlineUpdate = useCallback(async (fieldName: string, rawValue: unknown): Promise<void> => {\n // FIELD-CLEARING CONTRACT — inline edit builds its payload outside the form entirely, so it\n // does not pass through `FormField`'s change handler and has to apply the same normalisation\n // itself. Without it, emptying a field inline sends `''` (persisting an empty string, or\n // failing validation on a refined field) instead of the clear the user asked for.\n // This surface holds the resource's MAIN schema, so it uses the main-schema entry point: on a\n // main schema an `.optional()` field does not accept null, and asking the request-DTO question\n // here would report every ordinary optional field un-clearable.\n const fieldSchema = schema ? getObjectLikeFieldSchema(schema, fieldName) : undefined;\n const value = fieldSchema ? normalizeClearedMainSchemaValue(fieldSchema, rawValue) : rawValue;\n\n logDebug('doInlineUpdate', {\n fieldName,\n path: onInlineEdit ? 'custom' : rmm ? 'rmm' : 'fallback',\n });\n\n if (onInlineEdit) {\n await onInlineEdit(fieldName, value);\n onInlineEditSuccess?.(fieldName, value);\n return;\n }\n\n if (rmm) {\n const transportOverride = inlineEditOperation\n ? {\n operationPathKey: ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(inlineEditOperation),\n }\n : undefined;\n // Carry the current discriminator value(s) from `data` alongside the edited field so a\n // discriminated-union resource's partial UPDATE selects the right variant (see\n // `discriminatorFieldNames`). No-op for non-polymorphic resources.\n const inlineRequest: Record<string, unknown> = { [fieldName]: value };\n for (const discriminatorField of discriminatorFieldNames) {\n if (\n discriminatorField !== fieldName\n && data != null\n && (data as Record<string, unknown>)[discriminatorField] !== undefined\n ) {\n inlineRequest[discriminatorField] = (data as Record<string, unknown>)[discriminatorField];\n }\n }\n const result = await rmm.queueMutation(\n inlineRequest,\n {\n type: MutationType.INLINE,\n priority: MutationPriority.LOW,\n source: { type: MutationSourceType.DISPLAY, subscriberId: 'display-inline' },\n transportOverride,\n },\n );\n if (!result.success) {\n throw new InlineEditMutationError(\n result.error?.message ?? 'Inline edit failed',\n result.error,\n );\n }\n onInlineEditSuccess?.(fieldName, value);\n return;\n }\n\n if (\n allowsDirectOperationFallback(updateLikeMutationFallbackMode)\n && resourceType\n && resourceId\n ) {\n const updateOperation = resolveInlineUpdateOperation();\n if (!updateOperation) {\n throw new Error(\n `No UPDATE operation configured for resource \"${resourceType}\". ` +\n `Inline editing requires an UPDATE.default operation.`\n );\n }\n const operationPathKey = ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(updateOperation);\n const fieldIdentifier = FrontendResourceUtils.getResourceFieldIdentifierForType(resourceType, registry);\n const mergedContextualParameters: Record<string, string \| number> = {\n ...contextualParameters,\n [fieldIdentifier]: resourceId,\n };\n await doOperation(operationPathKey, {\n contextualParameters: mergedContextualParameters,\n parentResourcesRequirements,\n requestData: buildNestedObjectFromPath(fieldName, value),\n });\n onInlineEditSuccess?.(fieldName, value);\n return;\n }\n\n throw new MissingRMMRuntimeError({\n surfaceName: 'AutomaticDisplayer inline edit',\n resourceType: resourceType ?? 'unknown',\n operationIdentifier: inlineEditOperation?.operationIdentifier ?? CoreResourceOperation.UPDATE,\n });\n }, [\n onInlineEdit,\n rmm,\n resourceType,\n resourceId,\n contextualParameters,\n parentResourcesRequirements,\n doOperation,\n registry,\n onInlineEditSuccess,\n resolveInlineUpdateOperation,\n updateLikeMutationFallbackMode,\n inlineEditOperation,\n discriminatorFieldNames,\n data,\n schema,\n ]);\n\n const canInlineEdit = !disableInlineEdit && (\n !!onInlineEdit\n \|\| !!rmm\n \|\| (\n allowsDirectOperationFallback(updateLikeMutationFallbackMode)\n && !!resourceType\n && !!resourceId\n && hasUpdateOperation\n )\n );\n\n // ── Context values ──\n\n const resourceDisplayContextValue = useMemo<ResourceDisplayContextValue>(() => ({\n resourceType,\n resourceId,\n doInlineUpdate,\n canInlineEdit,\n fileUploadContext,\n contextualParameters,\n contextResourceIdentifiers,\n navigationZone,\n parentReferenceConfig,\n rmm,\n }), [resourceType, resourceId, doInlineUpdate, canInlineEdit, fileUploadContext, contextualParameters, contextResourceIdentifiers, navigationZone, parentReferenceConfig, rmm]);\n\n const displayTemplateContextValue = useMemo<DisplayTemplateContextValue>(() => ({\n schema,\n data: isLoading ? undefined : (data as Record<string, unknown>),\n isLoading,\n fieldLabels,\n fieldDescriptions,\n fieldTooltips,\n enumLabels,\n sectionLabels,\n sectionDescriptions,\n groupLabels,\n breakpoint: viewportBreakpoint,\n hiddenFieldNames,\n inlineEditDisabledFieldNames,\n onFileActivationOperation,\n }), [\n schema,\n data,\n isLoading,\n fieldLabels,\n fieldDescriptions,\n fieldTooltips,\n enumLabels,\n sectionLabels,\n sectionDescriptions,\n groupLabels,\n viewportBreakpoint,\n hiddenFieldNames,\n inlineEditDisabledFieldNames,\n onFileActivationOperation,\n ]);\n\n // ── Provider stack → template ──\n\n return (\n <ResourceDisplayContext.Provider value={resourceDisplayContextValue}>\n <DisplayChromeProvider displayChromeMode={defaultDisplayChromeMode}>\n <DisplayTemplateProvider value={displayTemplateContextValue}>\n <div className={cn('space-y-section', className)}>\n {layoutTemplate ? React.createElement(layoutTemplate) : null}\n </div>\n </DisplayTemplateProvider>\n </DisplayChromeProvider>\n </ResourceDisplayContext.Provider>\n );\n}\n\nAutomaticDisplayerComponent.displayName = 'AutomaticDisplayer';\n\nexport const AutomaticDisplayer: typeof AutomaticDisplayerComponent & { displayName: string } = AutomaticDisplayerComponent;\n"]}
1	+ {"version":3,"file":"AutomaticDisplayer.js","sourceRoot":"","sources":["../../../../../src/components/data-display/AutomaticDisplayer.tsx"],"names":[],"mappings":"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","sourcesContent":["/*\n AutomaticDisplayer Component\n \n Renders a display template inside a provider stack:\n * ResourceDisplayContext → DisplayChromeContext → DisplayTemplateContext → template\n \n The template is a `React.ComponentType` instantiated inside `<DisplayTemplateProvider>`,\n * so it can call `useDisplayTemplateContext()` for `data`, `isLoading`, labels, etc.\n * The template is structurally stable (created from schema) and data-reactive\n * (context data changes trigger re-renders).\n \n Inline editing is wired through ResourceDisplayContext.\n /\n\nimport React, { useMemo, useCallback, useContext } from 'react';\nimport { z } from 'zod';\n\nimport type { FileActivationOperationDispatcher } from '~wildo-frontend-lib/components/data-display/useFileActivation';\nimport type { LayoutRefManifest, ResourceLayoutInlineEditDefault } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport type { FrontendResource_ParentResourceRequirement } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\nimport { CoreResourceOperation, ResourceOperationVariantType } from '@wildo-ai/saas-models';\nimport { ViewportBreakpoint, isDiscriminatorField, getObjectLikeFieldSchema, normalizeClearedMainSchemaValue } from '@wildo-ai/zod-decorators';\nimport type { DisplayChromeMode, ResponsiveAware, FileFieldEndpoints } from '@wildo-ai/zod-decorators';\nimport type { AutoEmptyValue } from '@wildo-ai/presets-components-models';\nimport { AutomatedLayoutFrontendUtils } from '~wildo-frontend-lib/core/automated-layout/automated-layout.frontend.utils';\n\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { frontendResourceUtils, FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { ResourcesConfig_OperationPathUtils } from '@wildo-ai/saas-models';\nimport type { ResourceMutationManager } from '~wildo-frontend-lib/core/resources/rmm/ResourceMutationManager';\nimport { MutationType, MutationPriority, MutationSourceType } from '~wildo-frontend-lib/core/resources/rmm/types';\nimport {\n allowsDirectOperationFallback,\n MissingRMMRuntimeError,\n UpdateLikeMutationFallbackMode,\n} from '~wildo-frontend-lib/core/resources/rmm/update-like-mutation-fallback.frontend';\nimport { UIContext } from '~wildo-frontend-lib/core/ui/UIContext';\nimport { useResourceLabels } from '~wildo-frontend-lib/core/resources/useResourceLabels';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport type { NavigationZone } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport type { FrontendResourceConfiguration_Operation } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { pickInlineFieldWriteOperation } from '~wildo-frontend-lib/core/resources/resource-addressability.frontend.utils';\n\nimport {\n ResourceDisplayContext,\n InlineEditMutationError,\n type ResourceDisplayContextValue,\n type ParentReferenceConfig,\n} from './automatic-displayer.utils';\nimport { buildInlineUpdateRequestData } from './display-field-resolution.utils';\n\nimport { DisplayChromeProvider } from './chromes/DisplayChromeContext';\nimport { DisplayTemplateProvider, type DisplayTemplateContextValue } from './DisplayTemplateContext';\nimport type { ContainerSectionMode } from '@wildo-ai/zod-decorators';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('AutomaticDisplayer');\nlogger.setDebugTypeLogging('AutomaticDisplayer', false);\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\nexport interface AutomaticDisplayerLabels {\n resourceContext?: { resourceType: string; operationId: string };\n /\n Resolve this schema's labels as if its fields sat at `<fieldPathPrefix>.<path>` in the resource.\n \n For a surface rendering the ITEM SHAPE of a collection that lives elsewhere in the owning\n * resource — see `UseResourceLabelsOptions.fieldPathPrefix` for the full reasoning (#638).\n /\n fieldPathPrefix?: string;\n fields?: Record<string, string>;\n enums?: Record<string, Record<string, string>>;\n sections?: Record<string, { titleKey?: string; descriptionKey?: string }>;\n}\n\nexport interface AutomaticDisplayerProps<TSchema extends z.ZodTypeAny> {\n schema: TSchema;\n data: z.infer<TSchema>;\n className?: string;\n labels?: AutomaticDisplayerLabels;\n\n /* Layout ref manifest for i18n label resolution of sections/groups. /\n layoutRefs?: LayoutRefManifest;\n\n resourceType?: string;\n resourceId?: string;\n contextualParameters?: Record<string, string \| number>;\n contextResourceIdentifiers?: Record<string, string \| { fieldIdentifier: string; resourceId: string }>;\n parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n navigationZone?: NavigationZone;\n inlineEditOperation?: FrontendResourceConfiguration_Operation \| null;\n parentReferenceConfig?: ParentReferenceConfig;\n /\n Caller-owned weaker-guarantee override for inline edit.\n \n Providing this hook bypasses the default RMM-backed engine path. The caller\n * becomes responsible for any queueing, conflict handling, canonical read-back,\n * and broader coherence guarantees they still want to preserve.\n /\n onInlineEdit?: (fieldName: string, value: unknown) => Promise<void>;\n disableInlineEdit?: boolean;\n fileUploadContext?: Record<string, FileFieldEndpoints>;\n onInlineEditSuccess?: (fieldName: string, value: unknown) => void;\n rmm?: ResourceMutationManager \| null;\n /\n Controls whether inline edit may downgrade to a direct UPDATE operation when\n * RMM is unavailable. Defaults to `RMM_REQUIRED` so generic engine inline edit\n * does not silently pretend to be RMM-backed.\n \n The richer conflict-reset UX is only guaranteed on the single-resource\n * RMM-backed lane where the backend supplies authoritative nested\n * `versionConflict` details. Explicit direct fallback remains a weaker-\n * guarantee path.\n /\n updateLikeMutationFallbackMode?: UpdateLikeMutationFallbackMode;\n\n /\n The display template to render — a `React.ComponentType` instantiated inside\n * `<DisplayTemplateProvider>`. The component can call `useDisplayTemplateContext()`\n * to access `data`, `isLoading`, labels, and breakpoint.\n /\n layoutTemplate: React.ComponentType \| null;\n\n /\n Whether data is still loading. When true, DisplayField renders skeletons (DD-9).\n * @default false\n /\n isLoading?: boolean;\n\n /\n Default chrome mode for display fields from `ResourceLayoutConfig.defaultChromeMode.display`.\n * Propagated to `DisplayChromeProvider.displayChromeMode`.\n /\n defaultDisplayChromeMode?: ResponsiveAware<DisplayChromeMode>;\n\n /\n The layout's inline-edit default, from `ResourceLayoutConfig.defaultInlineEdit`.\n * Forwarded opaquely into `ResourceDisplayContext` for `DisplayField` to consult — this component\n * is resource-unaware and never reads the resource config itself.\n /\n defaultInlineEdit?: ResourceLayoutInlineEditDefault;\n\n /\n The layout's empty-value strategy, from `ResourceLayoutConfig.defaultEmptyValue`.\n * Forwarded opaquely into `ResourceDisplayContext`; this component reads no resource config.\n /\n defaultEmptyValue?: AutoEmptyValue;\n /\n The layout's DISPLAY section container mode, from\n * `ResourceLayoutConfig.defaultDisplaySectionAppearance`. Adopted by a `<Section>` that declares\n * no `appearance` of its own; a section that declares one still wins.\n /\n defaultSectionAppearance?: ContainerSectionMode;\n\n /\n Opaque upstream shaping input for automatic READ templates.\n * Resource-aware wrappers can hide duplicate relationship-backed fields\n * without teaching generic display components relationship semantics.\n /\n hiddenFieldNames?: string[];\n\n /\n Opaque upstream shaping input for automatic READ templates.\n * Keeps generic inline edit fail-closed for relationship object/array slots.\n /\n inlineEditDisabledFieldNames?: string[];\n /\n Dispatcher for `FileActivationPolicy.CUSTOM` file activations — supplied by the\n * resource-aware host, forwarded opaquely into `DisplayTemplateContext` for the\n * generic file displayer. Absent under a non-resource host.\n */\n onFileActivationOperation?: FileActivationOperationDispatcher;\n\n}\n\n// =============================================================================\n// COMPONENT\n// =============================================================================\n\nfunction AutomaticDisplayerComponent<TSchema extends z.ZodTypeAny>({\n schema,\n data,\n className,\n labels,\n layoutRefs,\n resourceType,\n resourceId,\n contextualParameters,\n contextResourceIdentifiers,\n parentResourcesRequirements,\n navigationZone,\n inlineEditOperation,\n parentReferenceConfig,\n onInlineEdit,\n disableInlineEdit = false,\n fileUploadContext,\n onInlineEditSuccess,\n rmm,\n updateLikeMutationFallbackMode = UpdateLikeMutationFallbackMode.RMM_REQUIRED,\n layoutTemplate,\n isLoading = false,\n defaultDisplayChromeMode,\n defaultInlineEdit,\ndefaultEmptyValue,\n defaultSectionAppearance,\n hiddenFieldNames,\n inlineEditDisabledFieldNames,\n onFileActivationOperation,\n}: AutomaticDisplayerProps<TSchema>): React.JSX.Element {\n const { doOperation, registry } = useResourceRegistry();\n\n // ── Breakpoint resolution ──\n const uiContext = useContext(UIContext);\n const viewportBreakpoint: ViewportBreakpoint = uiContext?.UIConfig?.currentBreakpoint ?? ViewportBreakpoint.DESKTOP;\n\n // ── Labels from i18n ──\n const {\n fieldLabels,\n fieldDescriptions,\n fieldTooltips,\n enumLabels,\n sectionLabels,\n sectionDescriptions,\n groupLabels,\n } = useResourceLabels(\n schema,\n labels?.resourceContext,\n data as Record<string, unknown>,\n 'display',\n {\n layoutRefs,\n fieldPathPrefix: labels?.fieldPathPrefix,\n overrides: {\n fields: labels?.fields,\n enums: labels?.enums,\n sections: labels?.sections,\n },\n },\n );\n\n // ── Inline editing ──\n\n const resolveInlineUpdateOperation = useCallback((): FrontendResourceConfiguration_Operation \| null => {\n if (inlineEditOperation === null) {\n return null;\n }\n if (inlineEditOperation !== undefined) {\n const isUrlBearingOperation = inlineEditOperation.variantType === ResourceOperationVariantType.API_CALL\n \|\| inlineEditOperation.variantType === ResourceOperationVariantType.API_CALL_WITH_CALLBACK;\n const effectiveOperation = inlineEditOperation.resourceOperationLike ?? inlineEditOperation.operationIdentifier;\n // The LITERAL `update`, never a custom verb that borrows UPDATE semantics. `effectiveOperation`\n // alone admits `claimDomain`, `moveUnit`, `archive` — each a real, non-bulk, URL-bearing PUT that\n // satisfies every other clause here, and each with its OWN request contract. A field value sent\n // to one of them is a malformed call to a different action, not a partial update of the record.\n const isLiteralUpdateOperation = inlineEditOperation.operationIdentifier === CoreResourceOperation.UPDATE;\n if (!isUrlBearingOperation \|\| !isLiteralUpdateOperation \|\| inlineEditOperation.isBulkOperation === true \|\| effectiveOperation !== CoreResourceOperation.UPDATE) {\n logDebug('Rejected invalid inlineEditOperation', {\n operationIdentifier: String(inlineEditOperation.operationIdentifier),\n variantType: inlineEditOperation.variantType,\n variantKey: inlineEditOperation.variantKey,\n isBulkOperation: inlineEditOperation.isBulkOperation,\n effectiveOperation: String(effectiveOperation),\n });\n throw new InlineEditMutationError(\n 'inlineEditOperation must be the non-bulk URL-bearing literal UPDATE operation, not a custom verb borrowing UPDATE semantics',\n );\n }\n return inlineEditOperation;\n }\n if (!resourceType \|\| !resourceId) {\n return null;\n }\n\n const resourceConfig = registry.resourceConfigurations[resourceType];\n if (!resourceConfig) {\n return null;\n }\n\n const fieldIdentifier = FrontendResourceUtils.getResourceFieldIdentifierForType(resourceType, registry);\n const updateContextResourceIdentifiers = {\n ...(contextResourceIdentifiers ?? {}),\n [resourceType]: resourceId,\n };\n const updateContextualParameters = {\n ...(contextualParameters ?? {}),\n [fieldIdentifier]: resourceId,\n };\n\n return pickInlineFieldWriteOperation({\n resourceConfig,\n operations: resourceConfig.operations ?? [],\n registry,\n hasResourceId: frontendResourceUtils.getResourceId(updateContextResourceIdentifiers[resourceType]).length > 0,\n requireFrontendAddressable: true,\n contextResourceIdentifiers: updateContextResourceIdentifiers,\n contextualParameters: updateContextualParameters,\n }) ?? null;\n }, [contextResourceIdentifiers, contextualParameters, inlineEditOperation, registry, resourceId, resourceType]);\n\n const hasUpdateOperation = useMemo(() => {\n return resolveInlineUpdateOperation() !== null;\n }, [resolveInlineUpdateOperation]);\n\n // Discriminator field name(s) for this resource. A discriminated-union (polymorphic)\n // resource keeps its discriminator REQUIRED on the UPDATE requestDto (it selects the\n // variant the body is validated against), so every PARTIAL inline update must carry it —\n // otherwise the backend rejects the update with `<discriminator>: Invalid input`. Resolved\n // from the display schema's COMMON shape (the discriminator is shared across all variants).\n const discriminatorFieldNames = useMemo<string[]>(() => {\n try {\n const commonShape = AutomatedLayoutFrontendUtils.getObjectLikeFieldShape(schema, { commonOnly: true }) ?? {};\n return Object.entries(commonShape)\n .filter(([, fieldSchema]) => isDiscriminatorField(fieldSchema as z.ZodTypeAny))\n .map(([discriminatorField]) => discriminatorField);\n } catch {\n return [];\n }\n }, [schema]);\n\n const doInlineUpdate = useCallback(async (fieldName: string, rawValue: unknown): Promise<void> => {\n // FIELD-CLEARING CONTRACT — inline edit builds its payload outside the form entirely, so it\n // does not pass through `FormField`'s change handler and has to apply the same normalisation\n // itself. Without it, emptying a field inline sends `''` (persisting an empty string, or\n // failing validation on a refined field) instead of the clear the user asked for.\n // This surface holds the resource's MAIN schema, so it uses the main-schema entry point: on a\n // main schema an `.optional()` field does not accept null, and asking the request-DTO question\n // here would report every ordinary optional field un-clearable.\n const fieldSchema = schema ? getObjectLikeFieldSchema(schema, fieldName) : undefined;\n const value = fieldSchema ? normalizeClearedMainSchemaValue(fieldSchema, rawValue) : rawValue;\n\n logDebug('doInlineUpdate', {\n fieldName,\n path: onInlineEdit ? 'custom' : rmm ? 'rmm' : 'fallback',\n });\n\n if (onInlineEdit) {\n await onInlineEdit(fieldName, value);\n onInlineEditSuccess?.(fieldName, value);\n return;\n }\n\n if (rmm) {\n const transportOverride = inlineEditOperation\n ? {\n operationPathKey: ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(inlineEditOperation),\n }\n : undefined;\n // Carry the current discriminator value(s) from `data` alongside the edited field so a\n // discriminated-union resource's partial UPDATE selects the right variant (see\n // `discriminatorFieldNames`). No-op for non-polymorphic resources.\n const inlineRequest: Record<string, unknown> = { [fieldName]: value };\n for (const discriminatorField of discriminatorFieldNames) {\n if (\n discriminatorField !== fieldName\n && data != null\n && (data as Record<string, unknown>)[discriminatorField] !== undefined\n ) {\n inlineRequest[discriminatorField] = (data as Record<string, unknown>)[discriminatorField];\n }\n }\n const result = await rmm.queueMutation(\n inlineRequest,\n {\n type: MutationType.INLINE,\n priority: MutationPriority.LOW,\n source: { type: MutationSourceType.DISPLAY, subscriberId: 'display-inline' },\n transportOverride,\n },\n );\n if (!result.success) {\n throw new InlineEditMutationError(\n result.error?.message ?? 'Inline edit failed',\n result.error,\n );\n }\n onInlineEditSuccess?.(fieldName, value);\n return;\n }\n\n if (\n allowsDirectOperationFallback(updateLikeMutationFallbackMode)\n && resourceType\n && resourceId\n ) {\n const updateOperation = resolveInlineUpdateOperation();\n if (!updateOperation) {\n throw new Error(\n `No UPDATE operation configured for resource \"${resourceType}\". ` +\n `Inline editing requires an UPDATE.default operation.`\n );\n }\n const operationPathKey = ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(updateOperation);\n const fieldIdentifier = FrontendResourceUtils.getResourceFieldIdentifierForType(resourceType, registry);\n const mergedContextualParameters: Record<string, string \| number> = {\n ...contextualParameters,\n [fieldIdentifier]: resourceId,\n };\n await doOperation(operationPathKey, {\n contextualParameters: mergedContextualParameters,\n parentResourcesRequirements,\n requestData: buildInlineUpdateRequestData(data as Record<string, unknown> \| null \| undefined, fieldName, value),\n });\n onInlineEditSuccess?.(fieldName, value);\n return;\n }\n\n throw new MissingRMMRuntimeError({\n surfaceName: 'AutomaticDisplayer inline edit',\n resourceType: resourceType ?? 'unknown',\n operationIdentifier: inlineEditOperation?.operationIdentifier ?? CoreResourceOperation.UPDATE,\n });\n }, [\n onInlineEdit,\n rmm,\n resourceType,\n resourceId,\n contextualParameters,\n parentResourcesRequirements,\n doOperation,\n registry,\n onInlineEditSuccess,\n resolveInlineUpdateOperation,\n updateLikeMutationFallbackMode,\n inlineEditOperation,\n discriminatorFieldNames,\n data,\n schema,\n ]);\n\n const canInlineEdit = !disableInlineEdit && (\n !!onInlineEdit\n \|\| !!rmm\n \|\| (\n allowsDirectOperationFallback(updateLikeMutationFallbackMode)\n && !!resourceType\n && !!resourceId\n && hasUpdateOperation\n )\n );\n\n // ── Context values ──\n\n const resourceDisplayContextValue = useMemo<ResourceDisplayContextValue>(() => ({\n resourceType,\n resourceId,\n doInlineUpdate,\n canInlineEdit,\n defaultInlineEdit,\n defaultEmptyValue,\n fileUploadContext,\n contextualParameters,\n contextResourceIdentifiers,\n navigationZone,\n parentReferenceConfig,\n rmm,\n }), [resourceType, resourceId, doInlineUpdate, canInlineEdit, defaultInlineEdit, defaultEmptyValue, fileUploadContext, contextualParameters, contextResourceIdentifiers, navigationZone, parentReferenceConfig, rmm]);\n\n const displayTemplateContextValue = useMemo<DisplayTemplateContextValue>(() => ({\n schema,\n data: isLoading ? undefined : (data as Record<string, unknown>),\n isLoading,\n fieldLabels,\n fieldDescriptions,\n fieldTooltips,\n enumLabels,\n sectionLabels,\n sectionDescriptions,\n groupLabels,\n defaultSectionAppearance,\n breakpoint: viewportBreakpoint,\n hiddenFieldNames,\n inlineEditDisabledFieldNames,\n onFileActivationOperation,\n }), [\n schema,\n data,\n isLoading,\n fieldLabels,\n fieldDescriptions,\n fieldTooltips,\n enumLabels,\n sectionLabels,\n sectionDescriptions,\n groupLabels,\n defaultSectionAppearance,\n viewportBreakpoint,\n hiddenFieldNames,\n inlineEditDisabledFieldNames,\n onFileActivationOperation,\n ]);\n\n // ── Provider stack → template ──\n\n return (\n <ResourceDisplayContext.Provider value={resourceDisplayContextValue}>\n <DisplayChromeProvider displayChromeMode={defaultDisplayChromeMode}>\n <DisplayTemplateProvider value={displayTemplateContextValue}>\n <div className={cn('space-y-section', className)}>\n {layoutTemplate ? React.createElement(layoutTemplate) : null}\n </div>\n </DisplayTemplateProvider>\n </DisplayChromeProvider>\n </ResourceDisplayContext.Provider>\n );\n}\n\nAutomaticDisplayerComponent.displayName = 'AutomaticDisplayer';\n\nexport const AutomaticDisplayer: typeof AutomaticDisplayerComponent & { displayName: string } = AutomaticDisplayerComponent;\n"]}

package/dist/esm/components/data-display/DisplayContextKindContext.d.ts CHANGED Viewed

@@ -26,4 +26,47 @@ export interface DisplayContextKindProviderProps {
 export declare function DisplayContextKindProvider({ kind, children }: DisplayContextKindProviderProps): React.JSX.Element;
 /** The current read-only rendering context; defaults to `DISPLAY` with no provider. */
 export declare function useDisplayContextKind(): DisplayContextKind;
+/**
+ * The display params a formatter must actually render from, resolved for the CURRENT context.
+ *
+ * Every `{primitive}UI()` carries `{ display, summaryOverride, edit }`, and a summary surface
+ * resolves the read-only half as `{ ...display, ...summaryOverride }` — merged KEY BY KEY, so a
+ * field overriding one key keeps the rest of its display configuration.
+ *
+ * ## Why this exists rather than each formatter doing the merge
+ *
+ * It used to be hand-applied: three formatters (enum, date, datetime) carried an identical
+ * three-line copy of the ternary and the other twenty-two did not, so `summaryOverride` was a
+ * DECLARED authoring surface that silently did nothing for most of the vocabulary. An application
+ * could write `summaryOverride: { displayMode: TRUNCATE }` on a string field and get the detail
+ * rendering on every card, with no error and nothing to grep for.
+ *
+ * Measured 2026-09-19 in the browser (Labs → "Field summary context", which renders one schema in
+ * both contexts side by side): of eight families probed, only enum and date differed. Wonder CRM's
+ * authored `foreignKeyUI` summary override was inert for the same reason.
+ *
+ * That is the N-hand-applied-copies shape `.claude/rules/invariant-call-site-enumeration.md`
+ * exists to stop, so the merge lives HERE and a formatter reads its params through this hook
+ * instead of reaching for `.display` itself. A formatter that still writes `ui?.display` is opting
+ * out of the summary contract, which is now a visible thing to do rather than the default.
+ */
+export declare function useContextualDisplayParams<TParams>(ui: {
+    display?: TParams;
+    summaryOverride?: TParams;
+} | undefined): TParams | undefined;
+/**
+ * The same resolution as {@link useContextualDisplayParams}, as a PURE function taking the context
+ * kind explicitly.
+ *
+ * It exists for one shape: a renderer that resolves params inside a BRANCH. `DisplayValueDispatcher`
+ * picks its array/object/primitive path with `if (schemaType === …)`, so a hook called there would be
+ * a conditional hook call. Such a renderer reads the kind once at the top with
+ * `useDisplayContextKind()` and calls this in the branch — which keeps ONE implementation of the
+ * merge rather than growing a second copy for the branching case, and a second copy is exactly how
+ * the contract came to be honoured by three renderers out of twenty-five.
+ */
+export declare function resolveContextualDisplayParams<TParams>(ui: {
+    display?: TParams;
+    summaryOverride?: TParams;
+} | undefined, kind: DisplayContextKind): TParams | undefined;
 //# sourceMappingURL=DisplayContextKindContext.d.ts.map

package/dist/esm/components/data-display/DisplayContextKindContext.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"DisplayContextKindContext.d.ts","sourceRoot":"","sources":["~~../../../../~~src/components/data-display/DisplayContextKindContext.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEzE;;;;;;;;;;;;;;GAcG;AACH,oBAAY,kBAAkB;IAC5B,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AAID,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,qJAAqJ;AACrJ,wBAAgB,0BAA0B,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,+BAA+B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAEjH;AAED,uFAAuF;AACvF,wBAAgB,qBAAqB,IAAI,kBAAkB,CAE1D"}
1	+ {"version":3,"file":"DisplayContextKindContext.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DisplayContextKindContext.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEzE;;;;;;;;;;;;;;GAcG;AACH,oBAAY,kBAAkB;IAC5B,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AAID,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,qJAAqJ;AACrJ,wBAAgB,0BAA0B,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,+BAA+B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAEjH;AAED,uFAAuF;AACvF,wBAAgB,qBAAqB,IAAI,kBAAkB,CAE1D;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAChD,EAAE,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,GAC/D,OAAO,GAAG,SAAS,CAErB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EACpD,EAAE,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,EAChE,IAAI,EAAE,kBAAkB,GACvB,OAAO,GAAG,SAAS,CAIrB"}

package/dist/esm/components/data-display/DisplayContextKindContext.js CHANGED Viewed

@@ -30,4 +30,49 @@ export function DisplayContextKindProvider({ kind, children }) {
 export function useDisplayContextKind() {
     return useContext(DisplayContextKindContext);
 }
+/**
+ * The display params a formatter must actually render from, resolved for the CURRENT context.
+ *
+ * Every `{primitive}UI()` carries `{ display, summaryOverride, edit }`, and a summary surface
+ * resolves the read-only half as `{ ...display, ...summaryOverride }` — merged KEY BY KEY, so a
+ * field overriding one key keeps the rest of its display configuration.
+ *
+ * ## Why this exists rather than each formatter doing the merge
+ *
+ * It used to be hand-applied: three formatters (enum, date, datetime) carried an identical
+ * three-line copy of the ternary and the other twenty-two did not, so `summaryOverride` was a
+ * DECLARED authoring surface that silently did nothing for most of the vocabulary. An application
+ * could write `summaryOverride: { displayMode: TRUNCATE }` on a string field and get the detail
+ * rendering on every card, with no error and nothing to grep for.
+ *
+ * Measured 2026-09-19 in the browser (Labs → "Field summary context", which renders one schema in
+ * both contexts side by side): of eight families probed, only enum and date differed. Wonder CRM's
+ * authored `foreignKeyUI` summary override was inert for the same reason.
+ *
+ * That is the N-hand-applied-copies shape `.claude/rules/invariant-call-site-enumeration.md`
+ * exists to stop, so the merge lives HERE and a formatter reads its params through this hook
+ * instead of reaching for `.display` itself. A formatter that still writes `ui?.display` is opting
+ * out of the summary contract, which is now a visible thing to do rather than the default.
+ */
+export function useContextualDisplayParams(ui) {
+    return resolveContextualDisplayParams(ui, useContext(DisplayContextKindContext));
+}
+/**
+ * The same resolution as {@link useContextualDisplayParams}, as a PURE function taking the context
+ * kind explicitly.
+ *
+ * It exists for one shape: a renderer that resolves params inside a BRANCH. `DisplayValueDispatcher`
+ * picks its array/object/primitive path with `if (schemaType === …)`, so a hook called there would be
+ * a conditional hook call. Such a renderer reads the kind once at the top with
+ * `useDisplayContextKind()` and calls this in the branch — which keeps ONE implementation of the
+ * merge rather than growing a second copy for the branching case, and a second copy is exactly how
+ * the contract came to be honoured by three renderers out of twenty-five.
+ */
+export function resolveContextualDisplayParams(ui, kind) {
+    if (kind !== DisplayContextKind.SUMMARY)
+        return ui?.display;
+    if (!ui?.display && !ui?.summaryOverride)
+        return undefined;
+    return { ...ui?.display, ...ui?.summaryOverride };
+}
 //# sourceMappingURL=DisplayContextKindContext.js.map

package/dist/esm/components/data-display/DisplayContextKindContext.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"DisplayContextKindContext.js","sourceRoot":"","sources":["~~../../../../~~src/components/data-display/DisplayContextKindContext.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAc,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAC;AAEzE;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAN,IAAY,kBAGX;AAHD,WAAY,kBAAkB;IAC5B,yCAAmB,CAAA;IACnB,yCAAmB,CAAA;AACrB,CAAC,EAHW,kBAAkB,KAAlB,kBAAkB,QAG7B;AAED,MAAM,yBAAyB,GAAG,aAAa,CAAqB,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAOhG,qJAAqJ;AACrJ,MAAM,UAAU,0BAA0B,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAmC;IAC5F,OAAO,KAAC,yBAAyB,CAAC,QAAQ,IAAC,KAAK,EAAE,IAAI,YAAG,QAAQ,GAAsC,CAAC;AAC1G,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,qBAAqB;IACnC,OAAO,UAAU,CAAC,yBAAyB,CAAC,CAAC;AAC/C,CAAC","sourcesContent":["'use client';\n\nimport React, { createContext, useContext, type ReactNode } from 'react';\n\n/*\n Which READ-ONLY rendering context a display subtree belongs to.\n \n - `DISPLAY` — the full detail surface (READ page, display templates).\n * - `SUMMARY` — compact representations: list/search cards, FK reference\n * previews/popovers, anywhere `ResourceSummaryDisplayer` renders.\n \n This is the runtime half of the `summaryOverride` decorator contract: every\n * `{primitive}UI()` accepts `{ display, summaryOverride, edit }`, and summary\n * surfaces resolve their effective display params as\n * `{ ...display, ...summaryOverride }` (see `getFieldUISummaryDisplayConfig`).\n * Field formatters read this context to decide which side of that contract\n * applies — chrome modes are NOT a substitute (a summary defaulting to INLINE\n * chrome says nothing about per-primitive display params).\n /\nexport enum DisplayContextKind {\n DISPLAY = 'display',\n SUMMARY = 'summary',\n}\n\nconst DisplayContextKindContext = createContext<DisplayContextKind>(DisplayContextKind.DISPLAY);\n\nexport interface DisplayContextKindProviderProps {\n kind: DisplayContextKind;\n children: ReactNode;\n}\n\n/* Marks a display subtree as belonging to `kind`. Mounted by `ResourceSummaryDisplayer` (SUMMARY); everything else inherits the DISPLAY default. /\nexport function DisplayContextKindProvider({ kind, children }: DisplayContextKindProviderProps): React.JSX.Element {\n return <DisplayContextKindContext.Provider value={kind}>{children}</DisplayContextKindContext.Provider>;\n}\n\n/* The current read-only rendering context; defaults to `DISPLAY` with no provider. */\nexport function useDisplayContextKind(): DisplayContextKind {\n return useContext(DisplayContextKindContext);\n}\n"]}
1	+ {"version":3,"file":"DisplayContextKindContext.js","sourceRoot":"","sources":["../../../../../src/components/data-display/DisplayContextKindContext.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAc,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAC;AAEzE;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAN,IAAY,kBAGX;AAHD,WAAY,kBAAkB;IAC5B,yCAAmB,CAAA;IACnB,yCAAmB,CAAA;AACrB,CAAC,EAHW,kBAAkB,KAAlB,kBAAkB,QAG7B;AAED,MAAM,yBAAyB,GAAG,aAAa,CAAqB,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAOhG,qJAAqJ;AACrJ,MAAM,UAAU,0BAA0B,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAmC;IAC5F,OAAO,KAAC,yBAAyB,CAAC,QAAQ,IAAC,KAAK,EAAE,IAAI,YAAG,QAAQ,GAAsC,CAAC;AAC1G,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,qBAAqB;IACnC,OAAO,UAAU,CAAC,yBAAyB,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,0BAA0B,CACxC,EAAgE;IAEhE,OAAO,8BAA8B,CAAC,EAAE,EAAE,UAAU,CAAC,yBAAyB,CAAC,CAAC,CAAC;AACnF,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,8BAA8B,CAC5C,EAAgE,EAChE,IAAwB;IAExB,IAAI,IAAI,KAAK,kBAAkB,CAAC,OAAO;QAAE,OAAO,EAAE,EAAE,OAAO,CAAC;IAC5D,IAAI,CAAC,EAAE,EAAE,OAAO,IAAI,CAAC,EAAE,EAAE,eAAe;QAAE,OAAO,SAAS,CAAC;IAC3D,OAAO,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,eAAe,EAAa,CAAC;AAC/D,CAAC","sourcesContent":["'use client';\n\nimport React, { createContext, useContext, type ReactNode } from 'react';\n\n/*\n Which READ-ONLY rendering context a display subtree belongs to.\n \n - `DISPLAY` — the full detail surface (READ page, display templates).\n * - `SUMMARY` — compact representations: list/search cards, FK reference\n * previews/popovers, anywhere `ResourceSummaryDisplayer` renders.\n \n This is the runtime half of the `summaryOverride` decorator contract: every\n * `{primitive}UI()` accepts `{ display, summaryOverride, edit }`, and summary\n * surfaces resolve their effective display params as\n * `{ ...display, ...summaryOverride }` (see `getFieldUISummaryDisplayConfig`).\n * Field formatters read this context to decide which side of that contract\n * applies — chrome modes are NOT a substitute (a summary defaulting to INLINE\n * chrome says nothing about per-primitive display params).\n /\nexport enum DisplayContextKind {\n DISPLAY = 'display',\n SUMMARY = 'summary',\n}\n\nconst DisplayContextKindContext = createContext<DisplayContextKind>(DisplayContextKind.DISPLAY);\n\nexport interface DisplayContextKindProviderProps {\n kind: DisplayContextKind;\n children: ReactNode;\n}\n\n/* Marks a display subtree as belonging to `kind`. Mounted by `ResourceSummaryDisplayer` (SUMMARY); everything else inherits the DISPLAY default. /\nexport function DisplayContextKindProvider({ kind, children }: DisplayContextKindProviderProps): React.JSX.Element {\n return <DisplayContextKindContext.Provider value={kind}>{children}</DisplayContextKindContext.Provider>;\n}\n\n/* The current read-only rendering context; defaults to `DISPLAY` with no provider. /\nexport function useDisplayContextKind(): DisplayContextKind {\n return useContext(DisplayContextKindContext);\n}\n\n/\n The display params a formatter must actually render from, resolved for the CURRENT context.\n \n Every `{primitive}UI()` carries `{ display, summaryOverride, edit }`, and a summary surface\n * resolves the read-only half as `{ ...display, ...summaryOverride }` — merged KEY BY KEY, so a\n * field overriding one key keeps the rest of its display configuration.\n \n ## Why this exists rather than each formatter doing the merge\n \n It used to be hand-applied: three formatters (enum, date, datetime) carried an identical\n * three-line copy of the ternary and the other twenty-two did not, so `summaryOverride` was a\n * DECLARED authoring surface that silently did nothing for most of the vocabulary. An application\n * could write `summaryOverride: { displayMode: TRUNCATE }` on a string field and get the detail\n * rendering on every card, with no error and nothing to grep for.\n \n Measured 2026-09-19 in the browser (Labs → \"Field summary context\", which renders one schema in\n * both contexts side by side): of eight families probed, only enum and date differed. Wonder CRM's\n * authored `foreignKeyUI` summary override was inert for the same reason.\n \n That is the N-hand-applied-copies shape `.claude/rules/invariant-call-site-enumeration.md`\n * exists to stop, so the merge lives HERE and a formatter reads its params through this hook\n * instead of reaching for `.display` itself. A formatter that still writes `ui?.display` is opting\n * out of the summary contract, which is now a visible thing to do rather than the default.\n /\nexport function useContextualDisplayParams<TParams>(\n ui: { display?: TParams; summaryOverride?: TParams } \| undefined,\n): TParams \| undefined {\n return resolveContextualDisplayParams(ui, useContext(DisplayContextKindContext));\n}\n\n/\n The same resolution as {@link useContextualDisplayParams}, as a PURE function taking the context\n * kind explicitly.\n \n It exists for one shape: a renderer that resolves params inside a BRANCH. `DisplayValueDispatcher`\n * picks its array/object/primitive path with `if (schemaType === …)`, so a hook called there would be\n * a conditional hook call. Such a renderer reads the kind once at the top with\n * `useDisplayContextKind()` and calls this in the branch — which keeps ONE implementation of the\n * merge rather than growing a second copy for the branching case, and a second copy is exactly how\n * the contract came to be honoured by three renderers out of twenty-five.\n */\nexport function resolveContextualDisplayParams<TParams>(\n ui: { display?: TParams; summaryOverride?: TParams } \| undefined,\n kind: DisplayContextKind,\n): TParams \| undefined {\n if (kind !== DisplayContextKind.SUMMARY) return ui?.display;\n if (!ui?.display && !ui?.summaryOverride) return undefined;\n return { ...ui?.display, ...ui?.summaryOverride } as TParams;\n}\n"]}

package/dist/esm/components/data-display/DisplayField.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"DisplayField.d.ts","sourceRoot":"","sources":["~~../../../../~~src/components/data-display/DisplayField.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,OAAO,EACL,KAAK,iBAAiB,~~EAQtB~~,KAAK,qBAAqB,IAAI,yBAAyB,EACvD,eAAe,EAEf,qBAAqB,EACrB,KAAK,eAAe,EACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAkB,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;~~AAU9F~~,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;~~AA+E9E~~,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,uGAAuG;IACvG,MAAM,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC;IACtB,oFAAoF;IACpF,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,gGAAgG;IAChG,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;IAC7C,oGAAoG;IACpG,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0FAA0F;IAC1F,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,2FAA2F;IAC3F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uGAAuG;IACvG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kEAAkE;IAClE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,0EAA0E;IAC1E,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC,kHAAkH;IAClH,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;;;;;;;;OAUG;IACH,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAE7C;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAErC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,UAAU,KAAK,KAAK,CAAC,SAAS,CAAC;IACtE,8FAA8F;IAC9F,iBAAiB,CAAC,EAAE,eAAe,CAAC;IACpC,kGAAkG;IAClG,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;CAC1C;AAMD,iBAAS,qBAAqB,CAAC,KAAK,EAAE,iBAAiB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,~~CAiP1E~~;~~kBAjPQ~~,qBAAqB;;;~~AAqP9B~~,eAAO,MAAM,YAAY,EAAE,OAAO,qBAAqB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAA0B,CAAC;AAM1G,UAAU,8BAA8B;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,UAAU,8BAA8B;IACtC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,qBAAa,yBAA0B,SAAQ,KAAK,CAAC,SAAS,CAC5D,8BAA8B,EAC9B,8BAA8B,CAC/B;IACC,KAAK,EAAE,8BAA8B,CAAuB;IAE5D,MAAM,CAAC,wBAAwB,IAAI,8BAA8B;IAIjE,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI;IASjE,MAAM,IAAI,KAAK,CAAC,SAAS;CAc1B"}
1	+ {"version":3,"file":"DisplayField.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DisplayField.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,OAAO,EACL,KAAK,iBAAiB,EAUtB,KAAK,qBAAqB,IAAI,yBAAyB,EACvD,eAAe,EAEf,qBAAqB,EACrB,KAAK,eAAe,EACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAkB,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAW9F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAgH9E,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,uGAAuG;IACvG,MAAM,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC;IACtB,oFAAoF;IACpF,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,gGAAgG;IAChG,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;IAC7C,oGAAoG;IACpG,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0FAA0F;IAC1F,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,2FAA2F;IAC3F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uGAAuG;IACvG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kEAAkE;IAClE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,0EAA0E;IAC1E,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC,kHAAkH;IAClH,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;;;;;;;;OAUG;IACH,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAE7C;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAErC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,UAAU,KAAK,KAAK,CAAC,SAAS,CAAC;IACtE,8FAA8F;IAC9F,iBAAiB,CAAC,EAAE,eAAe,CAAC;IACpC,kGAAkG;IAClG,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;CAC1C;AAMD,iBAAS,qBAAqB,CAAC,KAAK,EAAE,iBAAiB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAuS1E;kBAvSQ,qBAAqB;;;AA2S9B,eAAO,MAAM,YAAY,EAAE,OAAO,qBAAqB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAA0B,CAAC;AAM1G,UAAU,8BAA8B;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,UAAU,8BAA8B;IACtC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,qBAAa,yBAA0B,SAAQ,KAAK,CAAC,SAAS,CAC5D,8BAA8B,EAC9B,8BAA8B,CAC/B;IACC,KAAK,EAAE,8BAA8B,CAAuB;IAE5D,MAAM,CAAC,wBAAwB,IAAI,8BAA8B;IAIjE,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI;IASjE,MAAM,IAAI,KAAK,CAAC,SAAS;CAc1B"}

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

@@ -20,8 +20,9 @@ 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 { DisplayChromeMode, getSchemaType, getFieldUIDisplayConfig, getFieldUISummaryDisplayConfig, getShowWhenParams, hasInlineEditableDecorator, isHiddenForDisplay, FieldSchemaType, } from '@wildo-ai/zod-decorators';
+import { DisplayChromeMode, getSchemaType, getFieldUIDisplayConfig, getFieldUISummaryDisplayConfig, getShowWhenParams, hasDescriptionForDisplay, hasInlineEditableDecorator, isEligibleForLayoutDefaultInlineEdit, isHiddenForDisplay, FieldSchemaType, } from '@wildo-ai/zod-decorators';
 import { useResourceDisplayContext } from './automatic-displayer.utils.js';
+import { ResourceLayoutInlineEditDefault } from '../../core/resources/resources.frontend.schemas.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';
@@ -67,10 +68,37 @@ function resolveSurfaceAutoLabelPlacement(value) {
  * 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.
+ * whitespace-only) string, an empty array, or a PLAIN OBJECT with no own
+ * enumerable keys. Every other value — including `false` and `0`, which are
+ * answers rather than absences — is 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.
+ *
+ * ## Why `{}` counts, added 2026-09-18
+ *
+ * It did not until this change, and the omission made `hideWhenEmpty`
+ * unable to express the one thing an object field needs it for. An object
+ * whose members are all optional — a context bag, a set of locators — is
+ * `{}` whenever none of them applies, and the row then rendered a label
+ * with a void under it. There was no other mechanism: `showWhen` compares a
+ * value, and `{}` satisfies `EXISTS`.
+ *
+ * It is consistent rather than special: an empty array was already empty,
+ * and an empty object is the same absence in the other container. And the
+ * decoration is OPT-IN, so a field reaching this line has already asked to
+ * disappear rather than render the placeholder — there is no field for which
+ * showing an empty labelled block is the better answer.
+ *
+ * ## The guard is the whole of the risk
+ *
+ * `Object.keys()` is empty for far more than a plain object: a `Date`, a
+ * `Map`, a `Set`, a `File`, and every class instance whose state lives on its
+ * prototype or in private fields. Counting keys without checking the
+ * prototype would make every date field on every read surface vanish. So the
+ * test is PROTOTYPE-first — `Object.prototype` or a null prototype, nothing
+ * else — and `display-field-empty-value.test.tsx` pins each of those shapes
+ * as present.
  */
 function isEmptyDisplayValue(value) {
     if (value === null || value === undefined) {
@@ -82,6 +110,12 @@ function isEmptyDisplayValue(value) {
     if (Array.isArray(value)) {
         return value.length === 0;
     }
+    if (typeof value === 'object') {
+        const prototype = Object.getPrototypeOf(value);
+        if (prototype === Object.prototype || prototype === null) {
+            return Object.keys(value).length === 0;
+        }
+    }
     return false;
 }
 function fieldMatchesDisplayShapingRule(fieldName, rules) {
@@ -138,7 +172,23 @@ function DisplayFieldComponent(props) {
         ? AutomatedLayoutFrontendUtils.unresolvedFieldLabel(fieldMetaKey.split('.').pop() ?? fieldMetaKey)
         : undefined;
     const label = props.label ?? (fieldMetaKey ? ctx?.fieldLabels?.[fieldMetaKey] : undefined) ?? leafFallbackLabel;
-    const description = props.description ?? (fieldMetaKey ? ctx?.fieldDescriptions?.[fieldMetaKey] : undefined);
+    /*
+     * The DECLARATION decides whether a description renders, not the presence of a resolved string.
+     *
+     * `{primitive}UI.display.showDescription` is documented as an "opt-in for description text below
+     * the field value" — and it was only ever an i18n GENERATION flag: it tells the companion to
+     * produce the key, and nothing read it at render time. So a field resolved whatever description
+     * its label bundle happened to contain, and turning the flag OFF changed nothing until somebody
+     * regenerated labels — which needs a running companion, and until then the surface keeps showing
+     * a sentence its schema no longer asks for. That is a generated artifact outranking the source
+     * it was generated from.
+     *
+     * An explicitly passed `description` prop still wins: a template author writing one is making the
+     * declaration at the call site.
+     */
+    const declaresDisplayDescription = schema ? hasDescriptionForDisplay(schema) : false;
+    const description = props.description
+        ?? (fieldMetaKey && declaresDisplayDescription ? ctx?.fieldDescriptions?.[fieldMetaKey] : undefined);
     const tooltipProp = props.tooltip ?? (fieldMetaKey ? ctx?.fieldTooltips?.[fieldMetaKey] : undefined);
     const enumLabels = props.enumLabels
         ?? (indexFreeName ? ctx?.enumLabels?.[indexFreeName] : undefined);
@@ -173,7 +223,6 @@ function DisplayFieldComponent(props) {
             ? undefined
             : resolveSurfaceAutoLabelPlacement(surfacePolicy.autoRender?.autoLabelPlacement));
     const resolvedLabelStyle = props.labelStyle ?? displayConfig?.labelStyle;
-    const resolvedEmptyValue = resolveSurfaceAutoEmptyValue(surfacePolicy.autoRender?.autoEmptyValue);
     // forceHide → hideLabel/hideDescription (resolves responsive breakpoint-aware values)
     const breakpoint = ctx?.breakpoint;
     const resolvedForceHide = breakpoint
@@ -184,13 +233,47 @@ function DisplayFieldComponent(props) {
     const hideLabel = (props.hideLabel === true) || forceHideLabel;
     const hideDescription = (props.hideDescription === true) || forceHideDescription;
     // ── Resource display context (lightweight read for routing + fileUploadContext) ──
-    const { canInlineEdit: contextCanInlineEdit, doInlineUpdate, fileUploadContext, rmm, } = useResourceDisplayContext();
+    const { canInlineEdit: contextCanInlineEdit, doInlineUpdate, fileUploadContext, rmm, defaultInlineEdit, defaultEmptyValue, } = useResourceDisplayContext();
+    /*
+     * The LAYOUT outranks the surface policy here, and only here.
+     *
+     * `AutoEmptyValue` is declared per surface variant — BASE, RAISED, OVERLAY and INSET all say
+     * `em-dash` — which is right for a surface, because a surface knows nothing about the fields it
+     * happens to hold. In a dense table or a summary card a dash IS correct: the reader is scanning
+     * and meaning comes from the neighbours.
+     *
+     * A settings layout knows something the surface cannot: its rows are the content, read one at a
+     * time to decide something, and there an em dash refuses to say which of four things it means.
+     * That layout says so once (`defaultEmptyValue`) rather than every field saying it.
+     *
+     * A layout with no opinion omits it and the surface policy decides exactly as before — which is
+     * every layout in the product except the settings ones that opt in.
+     */
+    const resolvedEmptyValue = defaultEmptyValue
+        ?? resolveSurfaceAutoEmptyValue(surfacePolicy.autoRender?.autoEmptyValue);
     // ── Inline edit gate ──
+    //
+    // A field is offered in place when it ASKS (the decorator) or when its LAYOUT offers its writable
+    // fields and this field qualifies. The two are ORed on purpose and the precedence is deliberate:
+    // the decorator decides HOW (mode, saveOn, which buttons), the layout default decides only
+    // WHETHER — so a field carrying params keeps them under a layout that turns the default on, and a
+    // field carrying `inlineEditable: false` is refused by BOTH (`hasInlineEditableDecorator` is false
+    // for it, and `isEligibleForLayoutDefaultInlineEdit` declines it explicitly).
+    //
+    // Everything else in this conjunction still holds, and that is what keeps the default safe: a
+    // layout cannot manufacture a write path. `contextCanInlineEdit` requires an RMM, an
+    // `onInlineEdit`, or a real UPDATE operation; `isInlineEditDisabledByDisplayShaping` keeps
+    // relationship object/array slots fail-closed. See `ResourceLayoutInlineEditDefault` for why a
+    // settings layout needs the default at all.
     const hasDecorator = resolvedName && schema && hasInlineEditableDecorator(schema);
+    const isOfferedByLayoutDefault = (!!resolvedName
+        && !!schema
+        && defaultInlineEdit === ResourceLayoutInlineEditDefault.WRITABLE_FIELDS
+        && isEligibleForLayoutDefaultInlineEdit(schema));
     const isInlineEditable = (!disableInlineEdit &&
         !isInlineEditDisabledByDisplayShaping &&
         contextCanInlineEdit &&
-        !!hasDecorator);
+        (!!hasDecorator || isOfferedByLayoutDefault));
     // ── Early returns (after all hooks) ──
     if (isHiddenByDisplayShaping) {
         return _jsx(_Fragment, {});

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

	@@ -1 +1 @@
1	- {"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 type DisplayLabelStyle,\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';\nimport type { DisplayResourceLinkTrail } from './display-resource-link-trail';\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 /* Label styling override (small-title labels etc.); falls back to the field's decorator `display.labelStyle`. /\n labelStyle?: DisplayLabelStyle;\n className?: string;\n\n /* Force disable inline editing for this specific field. /\n disableInlineEdit?: boolean;\n\n /\n @internal Recursion plumbing — set by the display pipeline, not by a caller.\n \n Where this subtree sits in RESOURCE terms: which resource its fields belong to, and how many\n * relationship objects were expanded in place to reach it. Absent at the display root.\n \n This replaced a bare `depth: number` that every nested object and array item incremented. That\n * number counted a record's own structure — which is finite by construction — and never counted\n * the traversal that can actually run away, so it truncated real data while guarding nothing.\n * See `display-resource-link-trail.ts`.\n /\n resourceLinkTrail?: DisplayResourceLinkTrail;\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 /\n * Context lookups are INDEX-FREE: an array item's field resolves as `constraints[0].kind`, but\n * the label maps are keyed by the schema path (`constraints.kind`) — one label set per FIELD,\n * not per row. Stripping the indices is what lets an authored label or enum label inside an\n * entry collection resolve at all; before this each silently fell back (the enum to its raw\n * wire value, the label to the formatted field name — the second was invisible wherever the\n * fallback happened to read well, which is how it outlived the enum fix).\n \n With one carve-out: a path ENDING in an index is an array ITEM, not a field. An item must\n * never inherit its array's label/description — stripping there put the array's label on every\n * row (\"Accepted when · Accepted when · Accepted when\"). Enum labels are the exception in the\n * other direction: they map VALUES, and an enum-array's items are exactly the values the map\n * exists for.\n /\n const indexFreeName = resolvedName?.replace(/\\[\\d+\\]/g, '');\n const isArrayItemPath = resolvedName ? /\\[\\d+\\]$/.test(resolvedName) : false;\n const fieldMetaKey = isArrayItemPath ? undefined : indexFreeName;\n /\n * Final fallback: the LEAF key, unchanged. The context map already answers for every path it\n * registered, so this only fires for paths the label walk cannot reach (union-variant members,\n * depths past the walk) — where the object dispatcher used to force-feed the same leaf as an\n * explicit prop, winning over authored labels.\n \n It is a KEY, not words derived from one (#420): a leaf that shows up as `streetName` is\n * visibly unlabelled and gets authored, where \"Street Name\" reads as finished and never does.\n /\n const leafFallbackLabel = fieldMetaKey\n ? AutomatedLayoutFrontendUtils.unresolvedFieldLabel(fieldMetaKey.split('.').pop() ?? fieldMetaKey)\n : undefined;\n const label = props.label ?? (fieldMetaKey ? ctx?.fieldLabels?.[fieldMetaKey] : undefined) ?? leafFallbackLabel;\n const description = props.description ?? (fieldMetaKey ? ctx?.fieldDescriptions?.[fieldMetaKey] : undefined);\n const tooltipProp = props.tooltip ?? (fieldMetaKey ? ctx?.fieldTooltips?.[fieldMetaKey] : undefined);\n const enumLabels = props.enumLabels\n ?? (indexFreeName ? ctx?.enumLabels?.[indexFreeName] : 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 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 /\n * The surface's auto label placement is a DEFAULT for undecorated fields — a field whose\n * decorator declares its own chromeMode has chosen its presentation, and the chrome derives\n * placement from that mode. Before this guard, a surface-level `autoLabelPlacement: 'top'`\n * silently outranked every `chromeMode: INLINE` decoration: the chrome received mode INLINE\n * plus placement 'top' and rendered the STACKED branch, so INLINE was unreachable on any\n * surface that states a default — which is every resource READ page.\n /\n const resolvedLabelPlacement = props.labelPlacement\n ?? (displayConfig?.chromeMode !== undefined\n ? undefined\n : resolveSurfaceAutoLabelPlacement(surfacePolicy.autoRender?.autoLabelPlacement));\n const resolvedLabelStyle = props.labelStyle ?? displayConfig?.labelStyle;\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 labelStyle={resolvedLabelStyle}\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 resourceLinkTrail: props.resourceLinkTrail,\n /\n * The per-item template now reaches the READ path too. It used to be forwarded only on the\n * inline-editable ARRAY branch below, so `DisplayFieldArray.renderItem` was accepted and\n * silently ignored on every display template — measured: the rendered page was byte-identical\n * with and without it.\n /\n renderItem: props.renderField,\n className,\n hideLabel,\n hideDescription,\n resolvedChromeMode,\n resolvedLabelPlacement,\n resolvedLabelStyle,\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"]}
1	+ {"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 type DisplayLabelStyle,\n DisplayChromeMode,\n getSchemaType,\n getFieldUIDisplayConfig,\n getFieldUISummaryDisplayConfig,\n getShowWhenParams,\n hasDescriptionForDisplay,\n hasInlineEditableDecorator,\n isEligibleForLayoutDefaultInlineEdit,\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 { ResourceLayoutInlineEditDefault } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\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';\nimport type { DisplayResourceLinkTrail } from './display-resource-link-trail';\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, an empty array, or a PLAIN OBJECT with no own\n * enumerable keys. Every other value — including `false` and `0`, which are\n * answers rather than absences — is present. This mirrors what every display\n * formatter treats as the \"—\" em-dash case, centralized here so a\n * `hideWhenEmpty` field drops out of the read surface entirely instead of\n * rendering the placeholder.\n \n ## Why `{}` counts, added 2026-09-18\n \n It did not until this change, and the omission made `hideWhenEmpty`\n * unable to express the one thing an object field needs it for. An object\n * whose members are all optional — a context bag, a set of locators — is\n * `{}` whenever none of them applies, and the row then rendered a label\n * with a void under it. There was no other mechanism: `showWhen` compares a\n * value, and `{}` satisfies `EXISTS`.\n \n It is consistent rather than special: an empty array was already empty,\n * and an empty object is the same absence in the other container. And the\n * decoration is OPT-IN, so a field reaching this line has already asked to\n * disappear rather than render the placeholder — there is no field for which\n * showing an empty labelled block is the better answer.\n \n ## The guard is the whole of the risk\n \n `Object.keys()` is empty for far more than a plain object: a `Date`, a\n * `Map`, a `Set`, a `File`, and every class instance whose state lives on its\n * prototype or in private fields. Counting keys without checking the\n * prototype would make every date field on every read surface vanish. So the\n * test is PROTOTYPE-first — `Object.prototype` or a null prototype, nothing\n * else — and `display-field-empty-value.test.tsx` pins each of those shapes\n * as present.\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 if (typeof value === 'object') {\n const prototype = Object.getPrototypeOf(value);\n if (prototype === Object.prototype \|\| prototype === null) {\n return Object.keys(value).length === 0;\n }\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 /* Label styling override (small-title labels etc.); falls back to the field's decorator `display.labelStyle`. /\n labelStyle?: DisplayLabelStyle;\n className?: string;\n\n /* Force disable inline editing for this specific field. /\n disableInlineEdit?: boolean;\n\n /\n @internal Recursion plumbing — set by the display pipeline, not by a caller.\n \n Where this subtree sits in RESOURCE terms: which resource its fields belong to, and how many\n * relationship objects were expanded in place to reach it. Absent at the display root.\n \n This replaced a bare `depth: number` that every nested object and array item incremented. That\n * number counted a record's own structure — which is finite by construction — and never counted\n * the traversal that can actually run away, so it truncated real data while guarding nothing.\n * See `display-resource-link-trail.ts`.\n /\n resourceLinkTrail?: DisplayResourceLinkTrail;\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 /\n * Context lookups are INDEX-FREE: an array item's field resolves as `constraints[0].kind`, but\n * the label maps are keyed by the schema path (`constraints.kind`) — one label set per FIELD,\n * not per row. Stripping the indices is what lets an authored label or enum label inside an\n * entry collection resolve at all; before this each silently fell back (the enum to its raw\n * wire value, the label to the formatted field name — the second was invisible wherever the\n * fallback happened to read well, which is how it outlived the enum fix).\n \n With one carve-out: a path ENDING in an index is an array ITEM, not a field. An item must\n * never inherit its array's label/description — stripping there put the array's label on every\n * row (\"Accepted when · Accepted when · Accepted when\"). Enum labels are the exception in the\n * other direction: they map VALUES, and an enum-array's items are exactly the values the map\n * exists for.\n /\n const indexFreeName = resolvedName?.replace(/\\[\\d+\\]/g, '');\n const isArrayItemPath = resolvedName ? /\\[\\d+\\]$/.test(resolvedName) : false;\n const fieldMetaKey = isArrayItemPath ? undefined : indexFreeName;\n /\n * Final fallback: the LEAF key, unchanged. The context map already answers for every path it\n * registered, so this only fires for paths the label walk cannot reach (union-variant members,\n * depths past the walk) — where the object dispatcher used to force-feed the same leaf as an\n * explicit prop, winning over authored labels.\n \n It is a KEY, not words derived from one (#420): a leaf that shows up as `streetName` is\n * visibly unlabelled and gets authored, where \"Street Name\" reads as finished and never does.\n /\n const leafFallbackLabel = fieldMetaKey\n ? AutomatedLayoutFrontendUtils.unresolvedFieldLabel(fieldMetaKey.split('.').pop() ?? fieldMetaKey)\n : undefined;\n const label = props.label ?? (fieldMetaKey ? ctx?.fieldLabels?.[fieldMetaKey] : undefined) ?? leafFallbackLabel;\n /\n * The DECLARATION decides whether a description renders, not the presence of a resolved string.\n \n `{primitive}UI.display.showDescription` is documented as an \"opt-in for description text below\n * the field value\" — and it was only ever an i18n GENERATION flag: it tells the companion to\n * produce the key, and nothing read it at render time. So a field resolved whatever description\n * its label bundle happened to contain, and turning the flag OFF changed nothing until somebody\n * regenerated labels — which needs a running companion, and until then the surface keeps showing\n * a sentence its schema no longer asks for. That is a generated artifact outranking the source\n * it was generated from.\n \n An explicitly passed `description` prop still wins: a template author writing one is making the\n * declaration at the call site.\n /\n const declaresDisplayDescription = schema ? hasDescriptionForDisplay(schema) : false;\n const description = props.description\n ?? (fieldMetaKey && declaresDisplayDescription ? ctx?.fieldDescriptions?.[fieldMetaKey] : undefined);\n const tooltipProp = props.tooltip ?? (fieldMetaKey ? ctx?.fieldTooltips?.[fieldMetaKey] : undefined);\n const enumLabels = props.enumLabels\n ?? (indexFreeName ? ctx?.enumLabels?.[indexFreeName] : 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 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 /\n * The surface's auto label placement is a DEFAULT for undecorated fields — a field whose\n * decorator declares its own chromeMode has chosen its presentation, and the chrome derives\n * placement from that mode. Before this guard, a surface-level `autoLabelPlacement: 'top'`\n * silently outranked every `chromeMode: INLINE` decoration: the chrome received mode INLINE\n * plus placement 'top' and rendered the STACKED branch, so INLINE was unreachable on any\n * surface that states a default — which is every resource READ page.\n /\n const resolvedLabelPlacement = props.labelPlacement\n ?? (displayConfig?.chromeMode !== undefined\n ? undefined\n : resolveSurfaceAutoLabelPlacement(surfacePolicy.autoRender?.autoLabelPlacement));\n const resolvedLabelStyle = props.labelStyle ?? displayConfig?.labelStyle;\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 defaultInlineEdit,\n defaultEmptyValue,\n } = useResourceDisplayContext();\n\n /\n * The LAYOUT outranks the surface policy here, and only here.\n \n `AutoEmptyValue` is declared per surface variant — BASE, RAISED, OVERLAY and INSET all say\n * `em-dash` — which is right for a surface, because a surface knows nothing about the fields it\n * happens to hold. In a dense table or a summary card a dash IS correct: the reader is scanning\n * and meaning comes from the neighbours.\n \n A settings layout knows something the surface cannot: its rows are the content, read one at a\n * time to decide something, and there an em dash refuses to say which of four things it means.\n * That layout says so once (`defaultEmptyValue`) rather than every field saying it.\n \n A layout with no opinion omits it and the surface policy decides exactly as before — which is\n * every layout in the product except the settings ones that opt in.\n /\n const resolvedEmptyValue = defaultEmptyValue\n ?? resolveSurfaceAutoEmptyValue(surfacePolicy.autoRender?.autoEmptyValue);\n\n // ── Inline edit gate ──\n //\n // A field is offered in place when it ASKS (the decorator) or when its LAYOUT offers its writable\n // fields and this field qualifies. The two are ORed on purpose and the precedence is deliberate:\n // the decorator decides HOW (mode, saveOn, which buttons), the layout default decides only\n // WHETHER — so a field carrying params keeps them under a layout that turns the default on, and a\n // field carrying `inlineEditable: false` is refused by BOTH (`hasInlineEditableDecorator` is false\n // for it, and `isEligibleForLayoutDefaultInlineEdit` declines it explicitly).\n //\n // Everything else in this conjunction still holds, and that is what keeps the default safe: a\n // layout cannot manufacture a write path. `contextCanInlineEdit` requires an RMM, an\n // `onInlineEdit`, or a real UPDATE operation; `isInlineEditDisabledByDisplayShaping` keeps\n // relationship object/array slots fail-closed. See `ResourceLayoutInlineEditDefault` for why a\n // settings layout needs the default at all.\n const hasDecorator = resolvedName && schema && hasInlineEditableDecorator(schema);\n const isOfferedByLayoutDefault = (\n !!resolvedName\n && !!schema\n && defaultInlineEdit === ResourceLayoutInlineEditDefault.WRITABLE_FIELDS\n && isEligibleForLayoutDefaultInlineEdit(schema)\n );\n const isInlineEditable = (\n !disableInlineEdit &&\n !isInlineEditDisabledByDisplayShaping &&\n contextCanInlineEdit &&\n (!!hasDecorator \|\| isOfferedByLayoutDefault)\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 labelStyle={resolvedLabelStyle}\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 resourceLinkTrail: props.resourceLinkTrail,\n /\n * The per-item template now reaches the READ path too. It used to be forwarded only on the\n * inline-editable ARRAY branch below, so `DisplayFieldArray.renderItem` was accepted and\n * silently ignored on every display template — measured: the rendered page was byte-identical\n * with and without it.\n /\n renderItem: props.renderField,\n className,\n hideLabel,\n hideDescription,\n resolvedChromeMode,\n resolvedLabelPlacement,\n resolvedLabelStyle,\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"]}