@wildo-ai/saas-frontend-lib 1.0.1

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

@@ -0,0 +1,329 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * DisplayFieldEditable — inline-editable display field.
+ *
+ * Renders as a clickable trigger in display mode, switches to an inline
+ * form when activated. Manages all editing state: useForm, RMM subscription,
+ * focus management, save/cancel callbacks.
+ *
+ * Display mode: DisplayFieldChrome → inline edit trigger (wrapping DisplayValueDispatcher)
+ * Edit mode:   DisplayFieldChrome → FormField with embedded FormFieldChrome
+ */
+import { useState, useCallback, useMemo, useRef, useEffect, useSyncExternalStore } from 'react';
+import { z } from 'zod';
+import { useForm } from 'react-hook-form';
+import { standardSchemaResolver } from '@hookform/resolvers/standard-schema';
+import { useI18n } from '../../core/i18n/useI18n.js';
+import { useUI } from '../../core/ui/useUI.js';
+import { useIconRegistry } from '../../core/icons/useIconRegistry.js';
+import { IconSize, StandardIconReference } from '../../core/icons/icon-registry.frontend.schemas.js';
+import { Text } from '../../components/typography/text.js';
+import { Button, ButtonVariants_Variant } from '../../components/actions/button.js';
+import { ButtonSize } from '@wildo-ai/presets-components-models';
+import { Alert, AlertDescription } from '../../components/overlays/containers/alert.js';
+import { FrontendComponentType, UIBehavior, IndicatorVariant } from '@wildo-ai/presets-components-models';
+import { cn } from '../../core/ui/cn.js';
+import { CoreResourceOperation } from '@wildo-ai/saas-models';
+import { FieldSchemaType, getInlineEditableParams, isFormTextarea, } from '@wildo-ai/zod-decorators';
+import { rmmFieldPathIsDescendant, rmmReadPathValue } from '../../core/resources/rmm/field-path.utils.js';
+import { NOOP_GET_SNAPSHOT, NOOP_SUBSCRIBE } from '../../core/resources/rmm/rmm-noop-snapshot.js';
+import { RMMEventType, MutationErrorType, MutationSourceType } from '../../core/resources/rmm/types.js';
+import { FormSchemaProvider } from '../../components/form/form-context.js';
+import { FormField } from '../../components/form/automated/FormField.js';
+import { DEFAULT_VALIDATION_MODE, InlineEditState } from '../../core/automated-layout/automated-layout.frontend.schemas.js';
+import { AutomatedLayoutFrontendUtils } from '../../core/automated-layout/automated-layout.frontend.utils.js';
+import { LoggerFrontendService } from '../../core/monitoring/logger.frontend.service.js';
+import { DisplayFieldChrome } from './chromes/DisplayFieldChrome.js';
+import { DisplayValueDispatcher } from './DisplayValueDispatcher.js';
+import { InlineEditMutationError, useResourceDisplayContext } from './automatic-displayer.utils.js';
+import { useResourceRegistry } from '../../core/resources/useResourceRegistry.js';
+import { resolveRelationshipInlineEditSurface } from '../../core/resources/relationship-surface-runtime.frontend.utils.js';
+const logger = LoggerFrontendService.getLogger();
+const logDebug = logger.debugByType('DisplayFieldEditable');
+logger.setDebugTypeLogging('DisplayFieldEditable', false);
+// =============================================================================
+// HELPERS
+// =============================================================================
+/**
+ * Check if a field name matches any entry in changedFields/savedFields.
+ * Handles nested dot-paths: a change to `address` matches `address.city`.
+ */
+function fieldMatchesEvent(fieldName, eventFields) {
+    return eventFields.some((f) => fieldName === f || fieldName.startsWith(f + '[') || rmmFieldPathIsDescendant(f, fieldName));
+}
+function hasActionableFileEndpoints(endpoints) {
+    return !!(endpoints?.upload || endpoints?.override);
+}
+const DEFAULT_INLINE_EDIT_PARAMS = {
+    mode: 'direct',
+    saveOn: 'blur',
+    showSaveButton: false,
+    showCancelButton: true,
+};
+// =============================================================================
+// COMPONENT
+// =============================================================================
+export function DisplayFieldEditable(props) {
+    const { schema, schemaType, value, fieldName, label, description, tooltip, enumLabels, displayComponent, parentData, depth, className, hideLabel, hideDescription, resolvedChromeMode, fileUploadContext, doInlineUpdate, rmm, } = props;
+    const { tComponent } = useI18n({
+        component: [FrontendComponentType.LOW_LEVEL_FORM_FIELD, FrontendComponentType.LOW_LEVEL_BUTTON],
+    });
+    const { getRecipe } = useUI();
+    const { renderIcon } = useIconRegistry();
+    const resourceDisplayContext = useResourceDisplayContext();
+    const { registry } = useResourceRegistry();
+    const successIndicatorRecipe = getRecipe(UIBehavior.INDICATOR, IndicatorVariant.SUCCESS);
+    // ── Inline editing state ──
+    const [editState, setEditState] = useState(InlineEditState.DISPLAY);
+    const [saveErrorMessage, setSaveErrorMessage] = useState(null);
+    const containerRef = useRef(null);
+    const retryButtonRef = useRef(null);
+    const savedTimeoutRef = useRef(null);
+    const lastProcessedEventIdRef = useRef(null);
+    // Truncation state for arrays/objects (ROBUST-03)
+    const [showAllArrayItems, setShowAllArrayItems] = useState(false);
+    const [showAllObjectFields, setShowAllObjectFields] = useState(false);
+    const prevValueRef = useRef(value);
+    useEffect(() => {
+        if (prevValueRef.current !== value) {
+            setShowAllArrayItems(false);
+            setShowAllObjectFields(false);
+            prevValueRef.current = value;
+        }
+    }, [value]);
+    const isInEditMode = editState !== InlineEditState.DISPLAY;
+    const isSaving = editState === InlineEditState.SAVING;
+    // ── RMM subscription ──
+    const rmmForField = rmm ?? null;
+    const rmmSnapshot = useSyncExternalStore(rmmForField?.subscribe ?? NOOP_SUBSCRIBE, rmmForField?.getSnapshot ?? NOOP_GET_SNAPSHOT);
+    // ── Inline edit params from decorator ──
+    const inlineEditParams = getInlineEditableParams(schema);
+    const params = inlineEditParams ?? DEFAULT_INLINE_EDIT_PARAMS;
+    const relationshipInlineEditSurface = useMemo(() => {
+        if (!fieldName || !resourceDisplayContext.resourceType) {
+            return undefined;
+        }
+        return resolveRelationshipInlineEditSurface({
+            resourceType: resourceDisplayContext.resourceType,
+            fieldName,
+            operationType: CoreResourceOperation.UPDATE,
+            registry,
+        });
+    }, [fieldName, registry, resourceDisplayContext.resourceType]);
+    const inlineFileEndpoints = useMemo(() => {
+        if (!fieldName) {
+            return undefined;
+        }
+        return fileUploadContext?.[AutomatedLayoutFrontendUtils.normalizeSchemaFieldPath(fieldName)];
+    }, [fieldName, fileUploadContext]);
+    const supportsInlineFileEditing = schemaType !== FieldSchemaType.FILE || hasActionableFileEndpoints(inlineFileEndpoints);
+    // ── Isolated form for inline editing ──
+    // PERF: useForm() is unconditionally instantiated due to Rules of Hooks.
+    // In a future refactor, extract the edit form into a child component
+    // (DisplayFieldInlineEditForm) that mounts only when editing, so useForm()
+    // is lazy. The cost is ~1 useForm per editable field even in display mode.
+    const fieldKey = useMemo(() => {
+        return fieldName?.includes('.') ? fieldName.split('.').pop() : (fieldName ?? 'value');
+    }, [fieldName]);
+    const formSchema = useMemo(() => {
+        return z.object({ [fieldKey]: schema });
+    }, [fieldKey, schema]);
+    const form = useForm({
+        resolver: standardSchemaResolver(formSchema),
+        defaultValues: { [fieldKey]: value },
+        mode: DEFAULT_VALIDATION_MODE,
+    });
+    // Reset form when value or schema changes externally (schema may change
+    // for discriminated unions; resetting ensures the resolver stays in sync)
+    useEffect(() => {
+        if (editState === InlineEditState.DISPLAY) {
+            form.reset({ [fieldKey]: value });
+            setSaveErrorMessage(null);
+        }
+    }, [value, editState, form, fieldKey, schema]);
+    // Auto-focus when entering edit mode
+    useEffect(() => {
+        if (isInEditMode && containerRef.current) {
+            const timer = setTimeout(() => {
+                const firstInput = containerRef.current?.querySelector('input, textarea, select, [tabindex]:not([tabindex="-1"])');
+                if (firstInput) {
+                    firstInput.focus();
+                }
+            }, 0);
+            return () => clearTimeout(timer);
+        }
+    }, [isInEditMode]);
+    // Auto-focus retry button on error
+    useEffect(() => {
+        if (editState === InlineEditState.ERROR) {
+            retryButtonRef.current?.focus();
+        }
+    }, [editState]);
+    // Cleanup SAVED→DISPLAY timeout on unmount to prevent state updates on unmounted component
+    useEffect(() => {
+        return () => {
+            if (savedTimeoutRef.current != null) {
+                clearTimeout(savedTimeoutRef.current);
+            }
+        };
+    }, []);
+    // ── Callbacks ──
+    const handleSave = useCallback(async () => {
+        if (!fieldName)
+            return;
+        const isValid = await form.trigger(fieldKey);
+        if (!isValid) {
+            setEditState(InlineEditState.EDITING);
+            return;
+        }
+        setSaveErrorMessage(null);
+        setEditState(InlineEditState.SAVING);
+        try {
+            const formValue = form.getValues(fieldKey);
+            await doInlineUpdate(fieldName, formValue);
+            logDebug('inline edit save', { fieldName, value: formValue });
+            setEditState(InlineEditState.SAVED);
+            savedTimeoutRef.current = setTimeout(() => {
+                setEditState(InlineEditState.DISPLAY);
+                savedTimeoutRef.current = null;
+            }, 500);
+        }
+        catch (err) {
+            if (err instanceof InlineEditMutationError && err.mutationError?.type === MutationErrorType.CONFLICT) {
+                return;
+            }
+            setSaveErrorMessage(tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'save_failed'));
+            setEditState(InlineEditState.ERROR);
+        }
+    }, [form, fieldKey, fieldName, doInlineUpdate, tComponent]);
+    const handleCancel = useCallback(() => {
+        if (fieldName) {
+            logDebug('inline edit cancel', { fieldName });
+        }
+        form.reset({ [fieldKey]: value });
+        setSaveErrorMessage(null);
+        setEditState(InlineEditState.DISPLAY);
+    }, [form, fieldKey, value, fieldName]);
+    // ── RMM event handler ──
+    // Cancel inline edit when an external mutation changes this field.
+    // Tracks last-processed event ID to prevent re-processing the same event
+    // when other deps change (e.g., editState transitions from DISPLAY→EDITING).
+    useEffect(() => {
+        if (!rmmForField || !rmmSnapshot?.lastEvent || !fieldName)
+            return;
+        const event = rmmSnapshot.lastEvent;
+        if (event.id === lastProcessedEventIdRef.current)
+            return;
+        lastProcessedEventIdRef.current = event.id;
+        switch (event.type) {
+            case RMMEventType.REMOTE_UPDATE: {
+                if (fieldMatchesEvent(fieldName, event.changedFields) && editState === InlineEditState.EDITING) {
+                    logDebug('RMM event cancelling inline edit', { fieldName, eventType: event.type });
+                    handleCancel();
+                }
+                break;
+            }
+            case RMMEventType.CONFLICT_RESET: {
+                const authoritativeValue = rmmReadPathValue(event.currentData, fieldName);
+                form.reset({ [fieldKey]: authoritativeValue });
+                if (editState !== InlineEditState.DISPLAY) {
+                    logDebug('RMM event resetting inline edit after conflict', { fieldName, eventType: event.type });
+                    setSaveErrorMessage('This field was reset to the latest saved value after a version conflict.');
+                    setEditState(InlineEditState.ERROR);
+                }
+                break;
+            }
+            case RMMEventType.MUTATION_RESULT: {
+                if (event.result.success &&
+                    event.source.type !== MutationSourceType.DISPLAY &&
+                    event.result.savedFields &&
+                    fieldMatchesEvent(fieldName, event.result.savedFields) &&
+                    editState === InlineEditState.EDITING) {
+                    logDebug('RMM event cancelling inline edit', { fieldName, eventType: event.type });
+                    handleCancel();
+                }
+                break;
+            }
+            case RMMEventType.RESOURCE_DELETED: {
+                if (editState === InlineEditState.EDITING) {
+                    logDebug('RMM event cancelling inline edit', { fieldName, eventType: event.type });
+                    handleCancel();
+                }
+                break;
+            }
+        }
+    }, [rmmSnapshot?.lastEvent?.id, rmmForField, fieldName, editState, fieldKey, form, handleCancel]);
+    // ── Blur & keyboard handlers ──
+    const handleContainerBlur = useCallback((e) => {
+        if (params.saveOn === 'blur' && containerRef.current) {
+            const relatedTarget = e.relatedTarget;
+            if (!containerRef.current.contains(relatedTarget)) {
+                handleSave();
+            }
+        }
+    }, [params.saveOn, handleSave]);
+    const isMultilineField = schemaType === FieldSchemaType.CODE || isFormTextarea(schema);
+    const handleKeyDown = useCallback((e) => {
+        if (e.key === 'Escape') {
+            e.preventDefault();
+            handleCancel();
+            return;
+        }
+        if (e.key === 'Enter') {
+            if (isMultilineField) {
+                if (e.ctrlKey || e.metaKey) {
+                    e.preventDefault();
+                    handleSave();
+                }
+            }
+            else if (!e.shiftKey) {
+                e.preventDefault();
+                handleSave();
+            }
+        }
+    }, [handleSave, handleCancel, isMultilineField]);
+    // ── Content rendering ──
+    function renderDisplayValue() {
+        return (_jsx(DisplayValueDispatcher, { schema: schema, schemaType: schemaType, value: value, fieldName: fieldName, label: label, className: className, enumLabels: enumLabels, displayComponent: displayComponent, parentData: parentData, depth: depth, fileUploadContext: fileUploadContext, showAllArrayItems: showAllArrayItems, onExpandArrayItems: () => setShowAllArrayItems(true), showAllObjectFields: showAllObjectFields, onExpandObjectFields: () => setShowAllObjectFields(true) }));
+    }
+    function renderInlineEditTrigger() {
+        return (_jsxs(Button, { type: "button", variant: ButtonVariants_Variant.GHOST, className: cn("group relative inline-flex items-center gap-element h-auto px-card-sm py-item-xs"), onClick: () => {
+                if (fieldName) {
+                    logDebug('inline edit start', { fieldName });
+                }
+                setEditState(InlineEditState.EDITING);
+            }, "aria-label": tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'editField', { label: label || fieldName || '' }), children: [_jsx("span", { className: "flex-1", children: renderDisplayValue() }), _jsx("span", { className: "text-muted-foreground opacity-0 group-hover:opacity-100 motion-safe:transition-opacity", children: renderIcon(StandardIconReference.EDIT, { size: IconSize.SM }) })] }));
+    }
+    function renderInlineEditForm() {
+        const errorAlertId = fieldName ? `inline-edit-error-${fieldName.replace(/\./g, '-')}` : undefined;
+        const hasError = editState === InlineEditState.ERROR && !!saveErrorMessage;
+        return (_jsx(FormSchemaProvider, { schema: formSchema, form: form, resourceType: resourceDisplayContext.resourceType, resourceId: resourceDisplayContext.resourceId, operationType: CoreResourceOperation.UPDATE, contextResourceIdentifiers: resourceDisplayContext.contextResourceIdentifiers, navigationZone: resourceDisplayContext.navigationZone, children: _jsxs("div", { ref: containerRef, className: "inline-flex flex-col gap-item-xs min-w-[200px]", onBlur: handleContainerBlur, onKeyDown: handleKeyDown, "aria-describedby": hasError ? errorAlertId : undefined, children: [_jsxs("div", { className: "flex items-start gap-element", children: [_jsx("div", { className: "flex-1", children: _jsx(FormField, { name: fieldKey, quickCreateSourceFieldName: relationshipInlineEditSurface?.sourceFieldName, schema: schema, label: "", description: "", disabled: isSaving, placeholder: label, enumLabels: enumLabels, fileUploadContext: inlineFileEndpoints
+                                        ? { [fieldKey]: inlineFileEndpoints }
+                                        : undefined, className: "inline-edit-field" }) }), _jsxs("div", { className: "flex items-center gap-item-xs shrink-0 pt-item-xs", children: [editState === InlineEditState.SAVED && (_jsx("div", { className: successIndicatorRecipe.base, "aria-hidden": "true", children: renderIcon(StandardIconReference.CHECK, { size: IconSize.SM }) })), params.showSaveButton && editState !== InlineEditState.SAVED && (_jsx(Button, { type: "button", size: ButtonSize.SM, variant: ButtonVariants_Variant.DEFAULT, onClick: handleSave, disabled: isSaving, "aria-label": tComponent(FrontendComponentType.LOW_LEVEL_BUTTON, 'save'), children: editState === InlineEditState.SAVING
+                                            ? renderIcon(StandardIconReference.LOADER_2, {
+                                                size: IconSize.SM,
+                                                className: 'animate-spin motion-reduce:animate-none'
+                                            })
+                                            : renderIcon(StandardIconReference.CHECK, { size: IconSize.SM }) })), params.showCancelButton && (_jsx(Button, { type: "button", size: ButtonSize.SM, variant: ButtonVariants_Variant.GHOST, onClick: handleCancel, disabled: isSaving, "aria-label": tComponent(FrontendComponentType.LOW_LEVEL_BUTTON, 'cancel'), children: renderIcon(StandardIconReference.CLOSE, { size: IconSize.SM }) }))] })] }), hasError && (_jsxs(Alert, { id: errorAlertId, variant: "destructive", role: "alert", className: "flex items-center gap-element py-card-sm", children: [renderIcon(StandardIconReference.ERROR, {
+                                size: IconSize.SM,
+                                className: 'shrink-0'
+                            }), _jsx(AlertDescription, { className: "flex-1 m-0", children: _jsx(Text, { children: saveErrorMessage }) }), (() => {
+                                const retryLabel = tComponent(FrontendComponentType.LOW_LEVEL_BUTTON, 'retry');
+                                return (_jsx(Button, { ref: retryButtonRef, type: "button", size: ButtonSize.SM, variant: ButtonVariants_Variant.GHOST, onClick: handleSave, disabled: isSaving, "aria-label": retryLabel, title: retryLabel, children: renderIcon(StandardIconReference.TRY_AGAIN, { size: IconSize.SM }) }));
+                            })()] }))] }) }));
+    }
+    // ── Determine content based on edit state ──
+    let content;
+    if (isInEditMode && fieldName && supportsInlineFileEditing) {
+        content = renderInlineEditForm();
+    }
+    else if (!supportsInlineFileEditing) {
+        content = renderDisplayValue();
+    }
+    else {
+        content = renderInlineEditTrigger();
+    }
+    return (_jsx(DisplayFieldChrome, { mode: resolvedChromeMode, label: label, description: description, tooltip: tooltip, name: fieldName, hideLabel: hideLabel, hideDescription: hideDescription, className: className, children: content }));
+}
+DisplayFieldEditable.displayName = 'DisplayFieldEditable';
+//# sourceMappingURL=DisplayFieldEditable.js.map

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * DisplayFieldReadOnly — read-only display field with chrome wrapping.
+ *
+ * Owns truncation state (array/object "show more") and delegates value
+ * rendering to DisplayValueDispatcher. No inline editing hooks — all
+ * editing concerns live in DisplayFieldEditable.
+ */
+import React from 'react';
+import type { DisplayFieldResolvedProps } from './display-field-resolved-props.js';
+export declare function DisplayFieldReadOnly(props: DisplayFieldResolvedProps): React.JSX.Element;
+export declare namespace DisplayFieldReadOnly {
+    var displayName: string;
+}
+//# sourceMappingURL=DisplayFieldReadOnly.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DisplayFieldReadOnly.d.ts","sourceRoot":"","sources":["../../../../src/components/data-display/DisplayFieldReadOnly.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAsC,MAAM,OAAO,CAAC;AAE3D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAQhF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA8DxF;yBA9De,oBAAoB"}

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

@@ -0,0 +1,31 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * DisplayFieldReadOnly — read-only display field with chrome wrapping.
+ *
+ * Owns truncation state (array/object "show more") and delegates value
+ * rendering to DisplayValueDispatcher. No inline editing hooks — all
+ * editing concerns live in DisplayFieldEditable.
+ */
+import { useState, useRef, useEffect } from 'react';
+import { DisplayFieldChrome } from './chromes/DisplayFieldChrome.js';
+import { DisplayValueDispatcher } from './DisplayValueDispatcher.js';
+// =============================================================================
+// COMPONENT
+// =============================================================================
+export function DisplayFieldReadOnly(props) {
+    const { schema, schemaType, value, fieldName, label, description, tooltip, enumLabels, displayComponent, parentData, depth, className, hideLabel, hideDescription, resolvedChromeMode, fileUploadContext, } = props;
+    // Truncation state for arrays/objects (ROBUST-03)
+    const [showAllArrayItems, setShowAllArrayItems] = useState(false);
+    const [showAllObjectFields, setShowAllObjectFields] = useState(false);
+    const prevValueRef = useRef(value);
+    useEffect(() => {
+        if (prevValueRef.current !== value) {
+            setShowAllArrayItems(false);
+            setShowAllObjectFields(false);
+            prevValueRef.current = value;
+        }
+    }, [value]);
+    return (_jsx(DisplayFieldChrome, { mode: resolvedChromeMode, label: label, description: description, tooltip: tooltip, name: fieldName, hideLabel: hideLabel, hideDescription: hideDescription, className: className, children: _jsx(DisplayValueDispatcher, { schema: schema, schemaType: schemaType, value: value, fieldName: fieldName, label: label, className: className, enumLabels: enumLabels, displayComponent: displayComponent, parentData: parentData, depth: depth, fileUploadContext: fileUploadContext, showAllArrayItems: showAllArrayItems, onExpandArrayItems: () => setShowAllArrayItems(true), showAllObjectFields: showAllObjectFields, onExpandObjectFields: () => setShowAllObjectFields(true) }) }));
+}
+DisplayFieldReadOnly.displayName = 'DisplayFieldReadOnly';
+//# sourceMappingURL=DisplayFieldReadOnly.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DisplayFieldReadOnly.js","sourceRoot":"","sources":["../../../../src/components/data-display/DisplayFieldReadOnly.tsx"],"names":[],"mappings":";AAAA;;;;;;GAMG;AAEH,OAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAG3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,MAAM,UAAU,oBAAoB,CAAC,KAAgC;IACnE,MAAM,EACJ,MAAM,EACN,UAAU,EACV,KAAK,EACL,SAAS,EACT,KAAK,EACL,WAAW,EACX,OAAO,EACP,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,KAAK,EACL,SAAS,EACT,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,iBAAiB,GAClB,GAAG,KAAK,CAAC;IAEV,kDAAkD;IAClD,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClE,MAAM,CAAC,mBAAmB,EAAE,sBAAsB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACtE,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACnC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,YAAY,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YACnC,oBAAoB,CAAC,KAAK,CAAC,CAAC;YAC5B,sBAAsB,CAAC,KAAK,CAAC,CAAC;YAC9B,YAAY,CAAC,OAAO,GAAG,KAAK,CAAC;QAC/B,CAAC;IACH,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,OAAO,CACL,KAAC,kBAAkB,IACjB,IAAI,EAAE,kBAAkB,EACxB,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,SAAS,EACf,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,eAAe,EAChC,SAAS,EAAE,SAAS,YAEpB,KAAC,sBAAsB,IACrB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,UAAU,EACtB,gBAAgB,EAAE,gBAAgB,EAClC,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,KAAK,EACZ,iBAAiB,EAAE,iBAAiB,EACpC,iBAAiB,EAAE,iBAAiB,EACpC,kBAAkB,EAAE,GAAG,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,EACpD,mBAAmB,EAAE,mBAAmB,EACxC,oBAAoB,EAAE,GAAG,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,GACxD,GACiB,CACtB,CAAC;AACJ,CAAC;AAED,oBAAoB,CAAC,WAAW,GAAG,sBAAsB,CAAC"}

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

@@ -0,0 +1,110 @@
+/**
+ * DisplayTemplateContext — carries resolved display-level values so template components
+ * (DisplayField in name-only mode, Section, Group) can resolve from context.
+ *
+ * AutomaticDisplayer / ResourceAutomaticDisplayer provide this context inside the
+ * display render tree. Skeleton components and developer-authored templates both
+ * read from it via `useDisplayTemplateContext()` or `useOptionalDisplayTemplateContext()`.
+ *
+ * **What this context carries (and where each value comes from):**
+ *
+ * | Value                | Source                                | Template consumer |
+ * |----------------------|---------------------------------------|-------------------|
+ * | schema               | Resource schema                       | DisplayField (resolves field schemas by path) |
+ * | data                 | Fetched resource data (undefined when loading) | DisplayField (resolves field values by path) |
+ * | isLoading            | `!effectiveData`                      | DisplayField (renders Skeleton when true — DD-9) |
+ * | fieldLabels          | `useResourceLabels()` hook            | DisplayField `label` |
+ * | fieldDescriptions    | `useResourceLabels()` hook            | DisplayField `description` |
+ * | fieldTooltips        | `useResourceLabels()` hook            | DisplayField `tooltip` |
+ * | enumLabels           | `useResourceLabels()` hook            | DisplayField `enumLabels` |
+ * | sectionLabels        | `useResourceLabels()` hook            | Section `legend` |
+ * | sectionDescriptions  | `useResourceLabels()` hook            | Section `description` |
+ * | groupLabels          | `useResourceLabels()` hook            | Group label |
+ * | breakpoint           | `useUI().currentBreakpoint`           | Responsive layout decisions |
+ * | hiddenFieldNames     | Resource-aware upstream display shaping | DisplayField hide gate for automatic templates |
+ * | inlineEditDisabledFieldNames | Resource-aware upstream display shaping | DisplayField inline-edit gate for automatic templates |
+ *
+ * **Relationship with ResourceDisplayContext:**
+ *
+ * ResourceDisplayContext carries inline editing capabilities (RMM, doInlineUpdate,
+ * canInlineEdit, fileUploadContext). DisplayTemplateContext carries data resolution
+ * and display-level metadata. They are separate concerns — a field needs both to
+ * render correctly in a resource context.
+ */
+import React from 'react';
+import type { z } from 'zod';
+import type { ViewportBreakpoint } from '@wildo-ai/zod-decorators';
+export interface DisplayTemplateContextValue {
+    /** Root display schema — enables field schema resolution by dot-path for name-only DisplayField usage. */
+    schema: z.ZodTypeAny;
+    /**
+     * Fetched resource data. `undefined` during initial loading.
+     * When `isLoading` is true, this is `undefined` — each DisplayField renders a `<Skeleton>` placeholder
+     * (template-as-skeleton pattern, DD-9). When loaded, contains the full resource data object.
+     */
+    data: Record<string, unknown> | undefined;
+    /**
+     * Whether resource data is still being fetched.
+     * When true, DisplayField renders `<Skeleton>` instead of the field value.
+     * Computed as `!effectiveData` in ResourceAutomaticDisplayer.
+     * This enables the template-as-skeleton pattern (DD-9): the template structure
+     * renders immediately from schema, individual fields show loading placeholders.
+     */
+    isLoading: boolean;
+    /** Resolved field labels (keyed by field name). Produced by useResourceLabels(). */
+    fieldLabels: Record<string, string>;
+    /** Resolved field descriptions (keyed by field name). Produced by useResourceLabels(). */
+    fieldDescriptions: Record<string, string>;
+    /** Resolved field tooltips (keyed by field name). Produced by useResourceLabels(). */
+    fieldTooltips: Record<string, string>;
+    /**
+     * Resolved enum labels per field (keyed by field name → enum value → label).
+     * Produced by useResourceLabels().
+     */
+    enumLabels: Record<string, Record<string, string>>;
+    /** Resolved section labels (keyed by section ref). Produced by useResourceLabels(). */
+    sectionLabels: Record<string, string>;
+    /** Resolved section descriptions (keyed by section ref). Produced by useResourceLabels(). */
+    sectionDescriptions: Record<string, string>;
+    /** Resolved group labels (keyed by group name). Produced by useResourceLabels(). */
+    groupLabels?: Record<string, string>;
+    /** Current viewport breakpoint for responsive display decisions. */
+    breakpoint: ViewportBreakpoint;
+    /**
+     * Resource-aware display shaping input for automatic READ templates.
+     * Like form `hiddenFieldNames`, this is consumed opaquely by generic display
+     * primitives. Explicit `layout.display` templates can simply omit it.
+     */
+    hiddenFieldNames?: string[];
+    /**
+     * Resource-aware inline-edit shaping input for automatic READ templates.
+     * This keeps the generic display field gate from treating relationship object
+     * slots as if they used the same write contract as primitive/FK fields.
+     */
+    inlineEditDisabledFieldNames?: string[];
+}
+export interface DisplayTemplateProviderProps {
+    value: DisplayTemplateContextValue;
+    children: React.ReactNode;
+}
+/**
+ * Provides display-level resolved values to the template tree.
+ * Placed by AutomaticDisplayer inside the display render tree so that
+ * skeleton components can resolve labels, schema, data, and loading state.
+ */
+export declare function DisplayTemplateProvider({ value, children }: DisplayTemplateProviderProps): React.JSX.Element;
+/**
+ * Read the display template context. Throws if not inside a DisplayTemplateProvider.
+ * Use in components that REQUIRE AutomaticDisplayer context.
+ */
+export declare function useDisplayTemplateContext(): DisplayTemplateContextValue;
+/**
+ * Read the display template context if available, or null when outside AutomaticDisplayer.
+ * Use in components that work both standalone and inside AutomaticDisplayer
+ * (e.g., DisplayField can receive explicit props OR resolve from context).
+ *
+ * When null is returned, DisplayField skips context resolution, skeleton rendering,
+ * and per-field showWhen — all values must be provided via explicit props.
+ */
+export declare function useOptionalDisplayTemplateContext(): DisplayTemplateContextValue | null;
+//# sourceMappingURL=DisplayTemplateContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DisplayTemplateContext.d.ts","sourceRoot":"","sources":["../../../../src/components/data-display/DisplayTemplateContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAoC,MAAM,OAAO,CAAC;AACzD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAMnE,MAAM,WAAW,2BAA2B;IAC1C,0GAA0G;IAC1G,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IAErB;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAE1C;;;;;;OAMG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB,oFAAoF;IACpF,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEpC,0FAA0F;IAC1F,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE1C,sFAAsF;IACtF,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtC;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAEnD,uFAAuF;IACvF,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtC,6FAA6F;IAC7F,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE5C,oFAAoF;IACpF,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErC,oEAAoE;IACpE,UAAU,EAAE,kBAAkB,CAAC;IAE/B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B;;;;OAIG;IACH,4BAA4B,CAAC,EAAE,MAAM,EAAE,CAAC;CACzC;AAYD,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,2BAA2B,CAAC;IACnC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,4BAA4B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAM5G;AAMD;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,2BAA2B,CASvE;AAED;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,IAAI,2BAA2B,GAAG,IAAI,CAEtF"}

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

@@ -0,0 +1,74 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * DisplayTemplateContext — carries resolved display-level values so template components
+ * (DisplayField in name-only mode, Section, Group) can resolve from context.
+ *
+ * AutomaticDisplayer / ResourceAutomaticDisplayer provide this context inside the
+ * display render tree. Skeleton components and developer-authored templates both
+ * read from it via `useDisplayTemplateContext()` or `useOptionalDisplayTemplateContext()`.
+ *
+ * **What this context carries (and where each value comes from):**
+ *
+ * | Value                | Source                                | Template consumer |
+ * |----------------------|---------------------------------------|-------------------|
+ * | schema               | Resource schema                       | DisplayField (resolves field schemas by path) |
+ * | data                 | Fetched resource data (undefined when loading) | DisplayField (resolves field values by path) |
+ * | isLoading            | `!effectiveData`                      | DisplayField (renders Skeleton when true — DD-9) |
+ * | fieldLabels          | `useResourceLabels()` hook            | DisplayField `label` |
+ * | fieldDescriptions    | `useResourceLabels()` hook            | DisplayField `description` |
+ * | fieldTooltips        | `useResourceLabels()` hook            | DisplayField `tooltip` |
+ * | enumLabels           | `useResourceLabels()` hook            | DisplayField `enumLabels` |
+ * | sectionLabels        | `useResourceLabels()` hook            | Section `legend` |
+ * | sectionDescriptions  | `useResourceLabels()` hook            | Section `description` |
+ * | groupLabels          | `useResourceLabels()` hook            | Group label |
+ * | breakpoint           | `useUI().currentBreakpoint`           | Responsive layout decisions |
+ * | hiddenFieldNames     | Resource-aware upstream display shaping | DisplayField hide gate for automatic templates |
+ * | inlineEditDisabledFieldNames | Resource-aware upstream display shaping | DisplayField inline-edit gate for automatic templates |
+ *
+ * **Relationship with ResourceDisplayContext:**
+ *
+ * ResourceDisplayContext carries inline editing capabilities (RMM, doInlineUpdate,
+ * canInlineEdit, fileUploadContext). DisplayTemplateContext carries data resolution
+ * and display-level metadata. They are separate concerns — a field needs both to
+ * render correctly in a resource context.
+ */
+import { createContext, useContext } from 'react';
+// =============================================================================
+// REACT CONTEXT
+// =============================================================================
+const DisplayTemplateContext = createContext(null);
+/**
+ * Provides display-level resolved values to the template tree.
+ * Placed by AutomaticDisplayer inside the display render tree so that
+ * skeleton components can resolve labels, schema, data, and loading state.
+ */
+export function DisplayTemplateProvider({ value, children }) {
+    return (_jsx(DisplayTemplateContext.Provider, { value: value, children: children }));
+}
+// =============================================================================
+// HOOKS
+// =============================================================================
+/**
+ * Read the display template context. Throws if not inside a DisplayTemplateProvider.
+ * Use in components that REQUIRE AutomaticDisplayer context.
+ */
+export function useDisplayTemplateContext() {
+    const ctx = useContext(DisplayTemplateContext);
+    if (!ctx) {
+        throw new Error('useDisplayTemplateContext() must be used within a <DisplayTemplateProvider>. ' +
+            'This is provided automatically by AutomaticDisplayer / ResourceAutomaticDisplayer.');
+    }
+    return ctx;
+}
+/**
+ * Read the display template context if available, or null when outside AutomaticDisplayer.
+ * Use in components that work both standalone and inside AutomaticDisplayer
+ * (e.g., DisplayField can receive explicit props OR resolve from context).
+ *
+ * When null is returned, DisplayField skips context resolution, skeleton rendering,
+ * and per-field showWhen — all values must be provided via explicit props.
+ */
+export function useOptionalDisplayTemplateContext() {
+    return useContext(DisplayTemplateContext);
+}
+//# sourceMappingURL=DisplayTemplateContext.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DisplayTemplateContext.js","sourceRoot":"","sources":["../../../../src/components/data-display/DisplayTemplateContext.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAsEzD,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF,MAAM,sBAAsB,GAAG,aAAa,CAAqC,IAAI,CAAC,CAAC;AAWvF;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAgC;IACvF,OAAO,CACL,KAAC,sBAAsB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAC1C,QAAQ,GACuB,CACnC,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,UAAU,yBAAyB;IACvC,MAAM,GAAG,GAAG,UAAU,CAAC,sBAAsB,CAAC,CAAC;IAC/C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,+EAA+E;YAC/E,oFAAoF,CACrF,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iCAAiC;IAC/C,OAAO,UAAU,CAAC,sBAAsB,CAAC,CAAC;AAC5C,CAAC"}