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

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

@@ -12,7 +12,7 @@
  *   3. Foreign key (versioned FK, isForeignKey)
  *   4. Complex types (array, object)
  *   5. Primitive types (boolean, enum, string, number, ...)
- *   6. Specialized types (money, duration, phone, bigdecimal, code, file)
+ *   6. Specialized types (money, duration, phone, address, bigdecimal, code, file)
  *   7. Range types (range-number, range-date, ...)
  *   8. Fallback: unsupported type indicator
  */
@@ -45,7 +45,7 @@ export interface DisplayValueDispatcherProps {
     showAllObjectFields: boolean;
     onExpandObjectFields: () => void;
 }
-export declare function DisplayValueDispatcher({ schema, schemaType, value, fieldName, label, className, enumLabels, displayComponent, parentData, resourceLinkTrail, renderItem, emptyValue, fileUploadContext, showAllArrayItems, onExpandArrayItems, showAllObjectFields, onExpandObjectFields, }: DisplayValueDispatcherProps): React.JSX.Element | null;
+export declare function DisplayValueDispatcher({ schema, schemaType: declaredSchemaType, value, fieldName, label, className, enumLabels, displayComponent, parentData, resourceLinkTrail, renderItem, emptyValue, fileUploadContext, showAllArrayItems, onExpandArrayItems, showAllObjectFields, onExpandObjectFields, }: DisplayValueDispatcherProps): React.JSX.Element | null;
 export declare namespace DisplayValueDispatcher {
     var displayName: string;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"DisplayValueDispatcher.d.ts","sourceRoot":"","sources":["../../../../src/components/data-display/DisplayValueDispatcher.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAItF,OAAO,EAGL,eAAe,EAYf,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,IAAI,yBAAyB,EAGxD,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,+BAA+B,CAAC;AAsTvC,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IACrB,UAAU,EAAE,eAAe,CAAC;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAC7C,6FAA6F;IAC7F,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,KAAK,KAAK,CAAC,SAAS,CAAC;IAC7E,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAEvD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,oBAAoB,EAAE,MAAM,IAAI,CAAC;CAClC;AAMD,wBAAgB,sBAAsB,CAAC,EACrC,MAAM,EACN,UAAU,EACV,KAAK,EACL,SAAS,EACT,KAAK,EACL,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,GACrB,EAAE,2BAA2B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAirBxD;yBAnsBe,sBAAsB"}
+{"version":3,"file":"DisplayValueDispatcher.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DisplayValueDispatcher.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAKtF,OAAO,EAGL,eAAe,EAoBf,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,IAAI,yBAAyB,EAIxD,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,+BAA+B,CAAC;AAuTvC,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IACrB,UAAU,EAAE,eAAe,CAAC;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAC7C,6FAA6F;IAC7F,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,KAAK,KAAK,CAAC,SAAS,CAAC;IAC7E,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAEvD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,oBAAoB,EAAE,MAAM,IAAI,CAAC;CAClC;AAMD,wBAAgB,sBAAsB,CAAC,EACrC,MAAM,EACN,UAAU,EAAE,kBAAkB,EAC9B,KAAK,EACL,SAAS,EACT,KAAK,EACL,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,GACrB,EAAE,2BAA2B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAu6BxD;yBAz7Be,sBAAsB"}

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

@@ -13,7 +13,7 @@ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-run
  *   3. Foreign key (versioned FK, isForeignKey)
  *   4. Complex types (array, object)
  *   5. Primitive types (boolean, enum, string, number, ...)
- *   6. Specialized types (money, duration, phone, bigdecimal, code, file)
+ *   6. Specialized types (money, duration, phone, address, bigdecimal, code, file)
  *   7. Range types (range-number, range-date, ...)
  *   8. Fallback: unsupported type indicator
  */
@@ -28,7 +28,8 @@ import { ButtonSize } from '@wildo-ai/presets-components-models';
 import { FrontendComponentType, UIBehavior, IndicatorVariant, TypographyVariant } from '@wildo-ai/presets-components-models';
 import { cn } from '../../core/ui/cn.js';
 import { Skeleton } from '../../components/feedback/skeleton.js';
-import { ArrayListStyle, ArrayObjectItemLayout, DisplayChromeMode, FieldSchemaType, getFieldUIDisplayConfig, getObjectKeys, getObjectShape, resolveDiscriminatedUnionVariant, getSchemaType, getArrayUI, getObjectUI, isForeignKey, getForeignKeyUIDisplay, getDiscriminatedPolymorphicForeignKey, unwrapSchema, } from '@wildo-ai/zod-decorators';
+import { resolveContextualDisplayParams, useDisplayContextKind } from './DisplayContextKindContext.js';
+import { ArrayListStyle, ArrayObjectItemLayout, DisplayChromeMode, FieldSchemaType, getFieldUIDisplayConfig, getObjectKeys, getObjectShape, getRecordValueSchema, getSetValueSchema, getTupleItemSchemas, getMapSchemas, resolveDiscriminatedUnionVariant, getSchemaType, inferFieldSchemaTypeFromValue, getArrayUI, getObjectUI, isForeignKey, resolveDisplayEmptyReason, resolveForeignKeyLabelFallback, DISPLAY_EMPTY_REASON_LABEL_KEYS, getForeignKeyUIDisplay, getDiscriminatedPolymorphicForeignKey, unwrapSchema, } from '@wildo-ai/zod-decorators';
 import { ResourcesConfigNamingUtils } from '@wildo-ai/saas-models';
 import { resolveResourceRelativeFieldName, } from './display-resource-link-trail.js';
 import { AutomatedLayoutFrontendUtils } from '../../core/automated-layout/automated-layout.frontend.utils.js';
@@ -40,6 +41,7 @@ import { DisplayFieldEnum } from './formatters/display-field-enum.js';
 import { DisplayFieldMoney } from './formatters/display-field-money.js';
 import { DisplayFieldDuration } from './formatters/display-field-duration.js';
 import { DisplayFieldPhone } from './formatters/display-field-phone.js';
+import { DisplayFieldAddress } from './formatters/display-field-address.js';
 import { DisplayFieldBigDecimal } from './formatters/display-field-bigdecimal.js';
 import { DisplayFieldCode } from './formatters/display-field-code.js';
 import { DisplayFieldJson } from './formatters/display-field-json.js';
@@ -251,7 +253,7 @@ function renderEmptyDisplayValue(strategy, noValueLabel) {
 // =============================================================================
 // COMPONENT
 // =============================================================================
-export function DisplayValueDispatcher({ schema, schemaType, value, fieldName, label, className, enumLabels, displayComponent, parentData, resourceLinkTrail, renderItem, emptyValue, fileUploadContext, showAllArrayItems, onExpandArrayItems, showAllObjectFields, onExpandObjectFields, }) {
+export function DisplayValueDispatcher({ schema, schemaType: declaredSchemaType, value, fieldName, label, className, enumLabels, displayComponent, parentData, resourceLinkTrail, renderItem, emptyValue, fileUploadContext, showAllArrayItems, onExpandArrayItems, showAllObjectFields, onExpandObjectFields, }) {
     const { tComponent, isReady } = useI18n({
         component: [FrontendComponentType.LOW_LEVEL_FORM_FIELD, FrontendComponentType.LOW_LEVEL_BUTTON],
     });
@@ -282,6 +284,14 @@ export function DisplayValueDispatcher({ schema, schemaType, value, fieldName, l
      * `subtasks[0].subtasks` — root segment `subtasks[0]`, matching no relationship — and reported
      * "not a relationship" for the very recursion the depth guard exists to bound.
      */
+    /*
+     * Read ONCE here, with the component's other top-level hooks, and deliberately NOT beside the
+     * array branch that consumes it: this component has six early returns before that point, so a
+     * hook called down there runs on some renders and not others — React reports it as "a change in
+     * the order of Hooks", which is exactly what a first version of this change produced. The merge
+     * itself is the pure `resolveContextualDisplayParams`, so the branch needs no hook at all.
+     */
+    const displayContextKind = useDisplayContextKind();
     const owningResourceType = resourceLinkTrail?.resourceType ?? currentResourceType;
     const resourceRelativeFieldName = resolveResourceRelativeFieldName(fieldName, resourceLinkTrail);
     const relationshipObjectSemantics = React.useMemo(() => {
@@ -310,12 +320,43 @@ export function DisplayValueDispatcher({ schema, schemaType, value, fieldName, l
     if ((resourceLinkTrail?.linkDepth ?? 0) >= MAX_RESOURCE_LINK_DEPTH) {
         return _jsx(Text, { className: "text-muted-foreground italic text-sm", children: tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'resourceLinkLimitReached') });
     }
-    const noValueLabel = tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'noValue');
+    /**
+     * The words for an empty value, chosen by WHY it is empty — see `DisplayEmptyReason`.
+     *
+     * One em dash used to say four different things: a field awaiting the operator's input, a list
+     * with no members, and a computed value nothing has produced yet all rendered identically. On the
+     * `em-dash` strategy this changes only the screen-reader text (the dash is unchanged); on
+     * `placeholder` it is the visible word. Which of the two a surface uses stays `AutoEmptyValue`.
+     */
+    const emptyLabelFor = (isCollectionEmptiness) => tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, DISPLAY_EMPTY_REASON_LABEL_KEYS[resolveDisplayEmptyReason(schema, isCollectionEmptiness)]);
+    /**
+     * WHEN THE SCHEMA CANNOT SAY, ASK THE VALUE.
+     *
+     * `z.unknown()` is a deliberate posture — an outbound webhook's `payload`, a stored provider
+     * response, any passthrough blob the framework declines to impose structure on — and every one
+     * of those values used to render the same way: pretty-printed JSON in the code viewer. Faithful,
+     * and wrong for the common case, because most values inside such a payload are ordinary scalars.
+     * A name came out as `"Ada"` in a monospace block, a flag as `true`, a timestamp as a quoted ISO
+     * string; each is the value, and none of them is how that value reads anywhere else.
+     *
+     * So an UNKNOWN field adopts the type its VALUE reveals, and every branch below serves it
+     * unchanged. `inferFieldSchemaTypeFromValue` answers `undefined` for anything it cannot name —
+     * an object, an array, a function — and the JSON rendering keeps exactly the case it was built
+     * for. It is also conservative by design about what it WILL name: a number is never read as an
+     * epoch, and a numeric string is never read as a number. See its own docstring for why.
+     *
+     * Substituted here rather than at the UNKNOWN branch so the empty-value guard just below sees
+     * the same answer: an empty string in an opaque payload should read as empty, exactly as it
+     * would in a declared string field.
+     */
+    const schemaType = declaredSchemaType === FieldSchemaType.UNKNOWN
+        ? (inferFieldSchemaTypeFromValue(value) ?? FieldSchemaType.UNKNOWN)
+        : declaredSchemaType;
     // Null/undefined placeholder
     if (value === null ||
         value === undefined ||
         (schemaType === FieldSchemaType.STRING && value === '')) {
-        return renderEmptyDisplayValue(emptyValue, noValueLabel);
+        return renderEmptyDisplayValue(emptyValue, emptyLabelFor(false));
     }
     // ── DISPLAY COMPONENT OVERRIDE ──
     if (displayComponent) {
@@ -329,6 +370,7 @@ export function DisplayValueDispatcher({ schema, schemaType, value, fieldName, l
             case 'money': return _jsx(DisplayFieldMoney, { ...componentProps, value: value });
             case 'duration': return _jsx(DisplayFieldDuration, { ...componentProps, value: value });
             case 'phone': return _jsx(DisplayFieldPhone, { ...componentProps, value: value });
+            case 'address': return _jsx(DisplayFieldAddress, { ...componentProps, value: value });
             case 'bigdecimal': return _jsx(DisplayFieldBigDecimal, { ...componentProps, value: value });
             case 'file': {
                 const normalizedFieldName = fieldName
@@ -360,7 +402,10 @@ export function DisplayValueDispatcher({ schema, schemaType, value, fieldName, l
     // ── FOREIGN KEY TYPES ──
     if (schemaType === FieldSchemaType.VERSIONED_FOREIGN_KEY) {
         const fkPopulated = extractPopulatedSibling(fieldName, parentData, currentResourceType, registry);
-        return (_jsx(ResourceFieldDisplay_ResourceReference, { fieldName: fieldName || '', value: value, data: fkPopulated ?? undefined, displayParams: getForeignKeyUIDisplay(schema), schema: schema, className: className }));
+        return (_jsx(ResourceFieldDisplay_ResourceReference, { fieldName: fieldName || '', value: value, data: fkPopulated ?? undefined, 
+            // The readable copy this record carries, used INSTEAD of printing the raw id when the
+            // reference cannot be resolved. See `labelFallbackField`.
+            labelFallback: resolveForeignKeyLabelFallback(schema, parentData), displayParams: getForeignKeyUIDisplay(schema), schema: schema, className: className }));
     }
     if (isForeignKey(schema)) {
         const fkPopulated = extractPopulatedSibling(fieldName, parentData, currentResourceType, registry);
@@ -375,7 +420,7 @@ export function DisplayValueDispatcher({ schema, schemaType, value, fieldName, l
             currentResourceType: currentResourceType,
             registry,
         });
-        return (_jsx(ResourceFieldDisplay_ResourceReference, { fieldName: fieldName || '', value: value, data: fkPopulated ?? undefined, resourceType: polymorphicResourceType, displayParams: getForeignKeyUIDisplay(schema), schema: schema, className: className }));
+        return (_jsx(ResourceFieldDisplay_ResourceReference, { fieldName: fieldName || '', value: value, data: fkPopulated ?? undefined, labelFallback: resolveForeignKeyLabelFallback(schema, parentData), resourceType: polymorphicResourceType, displayParams: getForeignKeyUIDisplay(schema), schema: schema, className: className }));
     }
     if (relationshipObjectSemantics &&
         relationshipObjectSemantics.semantics.nature !== RelationshipNature.COMPOSITION &&
@@ -404,15 +449,16 @@ export function DisplayValueDispatcher({ schema, schemaType, value, fieldName, l
     // ── COMPLEX TYPES ──
     if (schemaType === FieldSchemaType.ARRAY && Array.isArray(value)) {
         if (value.length === 0) {
-            return renderEmptyDisplayValue(emptyValue, noValueLabel);
+            return renderEmptyDisplayValue(emptyValue, emptyLabelFor(true));
         }
         const unwrapped = unwrapSchema(schema);
         const elementType = unwrapped.element;
         const elementSchemaType = elementType ? getSchemaType(elementType) : FieldSchemaType.UNKNOWN;
         const arrayUI = getArrayUI(schema);
-        const displayMode = arrayUI?.display?.displayMode || 'vertical';
+        const arrayDisplayParams = resolveContextualDisplayParams(arrayUI, displayContextKind);
+        const displayMode = arrayDisplayParams?.displayMode || 'vertical';
         const items = value;
-        const maxItems = arrayUI?.display?.maxItems || undefined;
+        const maxItems = arrayDisplayParams?.maxItems || undefined;
         const visibleItems = maxItems && !showAllArrayItems ? items.slice(0, maxItems) : items;
         const hiddenCount = maxItems ? items.length - maxItems : 0;
         // ROW item layout (object arrays): render each item as a compact horizontal
@@ -438,7 +484,7 @@ export function DisplayValueDispatcher({ schema, schemaType, value, fieldName, l
                      * the rule is now what says where an entry ends and padding does the breathing (applied
                      * per item below). See `ArrayListStyle.SEPARATED`.
                      */
-                    : arrayUI?.display?.listStyle === ArrayListStyle.SEPARATED
+                    : arrayDisplayParams?.listStyle === ArrayListStyle.SEPARATED
                         /*
                          * `divide-border` — the border-COLOR utility the rules take, NOT the DIVIDER recipe.
                          * That recipe's base is `bg-border shrink-0`, because a divider is an ELEMENT painted
@@ -477,7 +523,7 @@ export function DisplayValueDispatcher({ schema, schemaType, value, fieldName, l
                     return (_jsx("div", { role: "listitem", className: cn(elementSchemaType === FieldSchemaType.OBJECT && 'py-item-xs', 
                         // Under SEPARATED the padding is what keeps entries off their own rule; `first:`/
                         // `last:` keep the run flush with the container it sits in.
-                        arrayUI?.display?.listStyle === ArrayListStyle.SEPARATED && 'py-card-sm first:pt-0 last:pb-0'), children: templated ?? (_jsx(DisplayField, { schema: elementType ?? schema, schemaType: elementSchemaType, value: item, enumLabels: enumLabels, name: fieldName ? `${fieldName}[${index}]` : undefined, resourceLinkTrail: childResourceLinkTrail })) }, index));
+                        arrayDisplayParams?.listStyle === ArrayListStyle.SEPARATED && 'py-card-sm first:pt-0 last:pb-0'), children: templated ?? (_jsx(DisplayField, { schema: elementType ?? schema, schemaType: elementSchemaType, value: item, enumLabels: enumLabels, name: fieldName ? `${fieldName}[${index}]` : undefined, resourceLinkTrail: childResourceLinkTrail })) }, index));
                 })) : isRowObjectArray && itemShape ? (visibleItems.map((item, index) => {
                     const itemRecord = (item && typeof item === 'object' ? item : {});
                     const itemKeys = getObjectKeys(elementType);
@@ -494,7 +540,7 @@ export function DisplayValueDispatcher({ schema, schemaType, value, fieldName, l
                  * consequences, principles — read as one run-on paragraph without markers. Object items
                  * keep the plain wrapper; they are cards, not list lines.
                  */
-                _jsx("div", { role: "listitem", className: cn(arrayUI?.display?.listStyle === ArrayListStyle.BULLETS
+                _jsx("div", { role: "listitem", className: cn(arrayDisplayParams?.listStyle === ArrayListStyle.BULLETS
                         && elementSchemaType !== FieldSchemaType.OBJECT
                         && displayMode !== 'horizontal'
                         && 'ms-4 list-item list-disc marker:text-muted-foreground/60', 
@@ -509,7 +555,15 @@ export function DisplayValueDispatcher({ schema, schemaType, value, fieldName, l
                         && displayMode !== 'horizontal'
                         && 'py-item-xs'), children: _jsx(DisplayField, { schema: elementType ?? schema, schemaType: elementSchemaType, value: item, enumLabels: enumLabels, name: fieldName ? `${fieldName}[${index}]` : undefined, resourceLinkTrail: childResourceLinkTrail }) }, index))), hiddenCount > 0 && !showAllArrayItems && (_jsx(Button, { type: "button", variant: ButtonVariants_Variant.GHOST, size: ButtonSize.SM, className: "self-start", "aria-label": tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'showMore', { count: hiddenCount }), onClick: onExpandArrayItems, children: tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'showMore', { count: hiddenCount }) }))] }));
     }
-    if (schemaType === FieldSchemaType.OBJECT && typeof value === 'object') {
+    /*
+     * VERSIONED_OBJECT joins OBJECT here rather than getting a branch of its own: `versioned()`
+     * returns a ZodObject with `currentVersion` and `versionHistory` added, both declared HIDDEN and
+     * NOT EDITABLE, so the object branch already renders exactly the visible fields and already
+     * omits the two bookkeeping ones. Giving it a separate branch would duplicate the object
+     * renderer to reach the same output — and leaving it out is why it rendered an "unsupported
+     * type" chip over a perfectly ordinary object.
+     */
+    if ((schemaType === FieldSchemaType.OBJECT || schemaType === FieldSchemaType.VERSIONED_OBJECT) && typeof value === 'object') {
         /*
          * A DISCRIMINATED UNION field resolves to its ONE matching variant before anything else.
          *
@@ -548,7 +602,7 @@ export function DisplayValueDispatcher({ schema, schemaType, value, fieldName, l
         const displayMode = objectUI?.display?.displayMode || 'vertical';
         const maxObjectItems = objectUI?.display?.maxItems || undefined;
         if (!shape || keys.length === 0) {
-            return renderEmptyDisplayValue(emptyValue, noValueLabel);
+            return renderEmptyDisplayValue(emptyValue, emptyLabelFor(true));
         }
         /*
          * `primaryField` promotion (see `ObjectUIDisplayParams.primaryField`): the declared headline
@@ -633,6 +687,9 @@ export function DisplayValueDispatcher({ schema, schemaType, value, fieldName, l
     if (schemaType === FieldSchemaType.PHONE) {
         return _jsx(DisplayFieldPhone, { ...commonProps, value: value });
     }
+    if (schemaType === FieldSchemaType.ADDRESS) {
+        return _jsx(DisplayFieldAddress, { ...commonProps, value: value });
+    }
     if (schemaType === FieldSchemaType.BIGDECIMAL) {
         return _jsx(DisplayFieldBigDecimal, { ...commonProps, value: value });
     }
@@ -677,6 +734,96 @@ export function DisplayValueDispatcher({ schema, schemaType, value, fieldName, l
     if (schemaType === FieldSchemaType.RANGE_TIME) {
         return _jsx(DisplayFieldRangeTime, { ...commonProps, value: value });
     }
+    // ── RECORD (z.record) ──
+    /*
+     * A record's KEYS ARE DATA, so it has no declared shape and the OBJECT branch above cannot
+     * serve it — `getObjectShape` answers `null` by design. Without a branch of its own it fell all
+     * the way through to the "unsupported type" chip below, which rendered an ERROR over a value
+     * that was fully present and fully readable.
+     *
+     * Measured 2026-09-18 across the settings hub: `organization-entitlements` showed it twice
+     * (`Limits`, `Limit overrides`) and the SSO policy once (`Domain verification status`), on both
+     * the organization and application surfaces — four panes reporting a defect that was only ever
+     * a missing branch.
+     *
+     * Each entry's KEY is rendered verbatim, never humanized. A record key is a value the operator
+     * authored or the system stored (`maxTodos`, a domain name), not an identifier awaiting a label,
+     * so inventing display text for it would state something the data does not say — see
+     * `.claude/rules/display-text-comes-from-i18n.md`. The VALUE goes back through the ordinary
+     * dispatch with the record's own value schema, so a record of money renders as money and a
+     * record of dates as dates, for free.
+     *
+     * When the value schema cannot be read, the value is still dispatched — with no schema, the
+     * child resolves what it can. That is strictly better than the error chip this replaces, and it
+     * is why this branch does not fail closed.
+     */
+    if (schemaType === FieldSchemaType.RECORD && typeof value === 'object' && value !== null) {
+        const recordEntries = Object.entries(value);
+        if (recordEntries.length === 0) {
+            return renderEmptyDisplayValue(emptyValue, emptyLabelFor(true));
+        }
+        const recordValueSchema = getRecordValueSchema(schema);
+        return (_jsxs("div", { className: cn('ps-card relative flex flex-col gap-element', className), children: [_jsx("div", { className: cn('absolute start-0 top-0 bottom-0 w-0.5', dividerRecipe.base), "aria-hidden": "true" }), recordEntries.map(([entryKey, entryValue]) => (_jsxs("div", { className: "flex flex-wrap items-baseline gap-x-item-sm gap-y-element-xs", children: [_jsx(Text, { className: cn(labelTypographyRecipe.base, 'shrink-0'), children: entryKey }), _jsx("div", { className: "min-w-0 flex-1", children: _jsx(DisplayField, { schema: recordValueSchema ?? undefined, schemaType: recordValueSchema ? getSchemaType(recordValueSchema) : undefined, value: entryValue, name: fieldName ? `${fieldName}.${entryKey}` : entryKey, hideLabel: true, parentData: value, resourceLinkTrail: childResourceLinkTrail }) })] }, entryKey)))] }));
+    }
+    /*
+     * ── SET ──
+     *
+     * A set is an ARRAY without order or duplicates, and that is the whole difference a DISPLAY has
+     * to care about: every item is the same type and there is no index worth showing. So it renders
+     * as the array branch's simple case rather than gaining a layout of its own.
+     *
+     * Added 2026-09-19. SET classified correctly and had no branch, so it fell through to the
+     * "unsupported type" chip and rendered an ERROR over data that was fully present — the same
+     * defect `getRecordValueSchema` records for RECORD, which had it until the day before.
+     */
+    if (schemaType === FieldSchemaType.SET && (value instanceof Set || Array.isArray(value))) {
+        const setItems = Array.from(value);
+        if (setItems.length === 0) {
+            return renderEmptyDisplayValue(emptyValue, emptyLabelFor(true));
+        }
+        const setValueSchema = getSetValueSchema(schema);
+        return (_jsx("div", { className: cn('flex flex-col gap-element-xs', className), children: setItems.map((item, index) => (_jsx(DisplayField, { schema: setValueSchema ?? undefined, schemaType: setValueSchema ? getSchemaType(setValueSchema) : undefined, value: item, name: fieldName ? `${fieldName}.${index}` : String(index), hideLabel: true, resourceLinkTrail: childResourceLinkTrail }, `${fieldName ?? 'set'}-${index}`))) }));
+    }
+    /*
+     * ── TUPLE ──
+     *
+     * Unlike an array, each POSITION has its own schema, so the items cannot share an element type
+     * and must be paired with `items[i]`. That pairing is the entire reason this is not the array
+     * branch: formatting a `[string, number]` through one element schema renders one of the two
+     * positions as the wrong type.
+     *
+     * A value longer than the declared items (a REST tuple) keeps rendering, with the surplus
+     * entries carrying no schema — better than dropping data the value genuinely holds.
+     */
+    if (schemaType === FieldSchemaType.TUPLE && Array.isArray(value)) {
+        if (value.length === 0) {
+            return renderEmptyDisplayValue(emptyValue, emptyLabelFor(true));
+        }
+        const tupleItemSchemas = getTupleItemSchemas(schema);
+        return (_jsx("div", { className: cn('flex flex-wrap items-baseline gap-x-item-sm gap-y-element-xs', className), children: value.map((item, index) => {
+                const itemSchema = tupleItemSchemas?.[index];
+                return (_jsx("div", { className: "min-w-0", children: _jsx(DisplayField, { schema: itemSchema ?? undefined, schemaType: itemSchema ? getSchemaType(itemSchema) : undefined, value: item, name: fieldName ? `${fieldName}.${index}` : String(index), hideLabel: true, resourceLinkTrail: childResourceLinkTrail }) }, `${fieldName ?? 'tuple'}-${index}`));
+            }) }));
+    }
+    /*
+     * ── MAP ──
+     *
+     * A map is a RECORD whose keys are not necessarily strings, so it renders with the record's
+     * key/value rhythm and differs in exactly two places: the entries come from `Map#entries()`
+     * rather than `Object.entries`, and the KEY is itself rendered through its own schema instead of
+     * being printed as text — a map keyed by a date or an enum would otherwise show a raw value
+     * where every other surface shows a formatted one.
+     */
+    if (schemaType === FieldSchemaType.MAP && (value instanceof Map || (typeof value === 'object' && value !== null))) {
+        const mapEntries = value instanceof Map
+            ? Array.from(value.entries())
+            : Object.entries(value);
+        if (mapEntries.length === 0) {
+            return renderEmptyDisplayValue(emptyValue, emptyLabelFor(true));
+        }
+        const mapSchemas = getMapSchemas(schema);
+        return (_jsxs("div", { className: cn('ps-card relative flex flex-col gap-element', className), children: [_jsx("div", { className: cn('absolute start-0 top-0 bottom-0 w-0.5', dividerRecipe.base), "aria-hidden": "true" }), mapEntries.map(([entryKey, entryValue], index) => (_jsxs("div", { className: "flex flex-wrap items-baseline gap-x-item-sm gap-y-element-xs", children: [_jsx("div", { className: cn(labelTypographyRecipe.base, 'shrink-0'), children: _jsx(DisplayField, { schema: mapSchemas?.keySchema ?? undefined, schemaType: mapSchemas?.keySchema ? getSchemaType(mapSchemas.keySchema) : undefined, value: entryKey, name: fieldName ? `${fieldName}.${index}.key` : `${index}.key`, hideLabel: true }) }), _jsx("div", { className: "min-w-0 flex-1", children: _jsx(DisplayField, { schema: mapSchemas?.valueSchema ?? undefined, schemaType: mapSchemas?.valueSchema ? getSchemaType(mapSchemas.valueSchema) : undefined, value: entryValue, name: fieldName ? `${fieldName}.${index}.value` : `${index}.value`, hideLabel: true, resourceLinkTrail: childResourceLinkTrail }) })] }, `${fieldName ?? 'map'}-${index}`)))] }));
+    }
     // ── OPAQUE VALUE (z.unknown() / unclassifiable) ──
     // UNKNOWN is a deliberate schema posture (e.g. webhook `payload: z.unknown()`
     // passthrough), not a misconfiguration — render the value faithfully as