@wildo-ai/presets-components 1.0.1 → 1.1.1

package/dist/esm/components/data-display/formatters/display-field-datetime.d.ts

@@ -8,6 +8,6 @@
  */
 import * as React from "react";
 import type { DisplayFieldDateTimeProps } from '@wildo-ai/saas-frontend-lib';
-declare function DisplayFieldDateTime({ value, className, }: DisplayFieldDateTimeProps): React.JSX.Element;
+declare function DisplayFieldDateTime({ value, className, }: DisplayFieldDateTimeProps): React.JSX.Element | null;
 export { DisplayFieldDateTime };
 //# sourceMappingURL=display-field-datetime.d.ts.map

package/dist/esm/components/data-display/formatters/display-field-datetime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"display-field-datetime.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/formatters/display-field-datetime.tsx"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AAI5E,iBAAS,oBAAoB,CAAC,EAC5B,KAAK,EACL,SAAS,GACV,EAAE,yBAAyB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAQ/C;AAID,OAAO,EAAE,oBAAoB,EAAE,CAAA"}
+{"version":3,"file":"display-field-datetime.d.ts","sourceRoot":"","sources":["../../../../../../src/components/data-display/formatters/display-field-datetime.tsx"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AAI5E,iBAAS,oBAAoB,CAAC,EAC5B,KAAK,EACL,SAAS,GACV,EAAE,yBAAyB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAUtD;AAID,OAAO,EAAE,oBAAoB,EAAE,CAAA"}

package/dist/esm/components/data-display/formatters/display-field-datetime.js

@@ -5,6 +5,8 @@ import { useI18n } from "@wildo-ai/saas-frontend-lib";
 import { FrontendComponentType } from "@wildo-ai/presets-components-models";
 function DisplayFieldDateTime({ value, className, }) {
     const { formatDateTime, tComponent, isReady } = useI18n({ component: FrontendComponentType.LOW_LEVEL_FORM_FIELD });
+    if (!isReady)
+        return null;
     if (value === null || value === undefined) {
         return _jsxs(_Fragment, { children: [_jsx(Text, { className: "text-muted-foreground italic", "aria-hidden": "true", children: "\u2014" }), _jsx("span", { className: "sr-only", children: tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'noValue') })] });
     }
@@ -13,4 +15,4 @@ function DisplayFieldDateTime({ value, className, }) {
 ;
 DisplayFieldDateTime.displayName = "DisplayFieldDateTime";
 export { DisplayFieldDateTime };
-//# sourceMappingURL=display-field-datetime.js.map
+//# sourceMappingURL=display-field-datetime.js.map

package/dist/esm/components/data-display/formatters/display-field-datetime.js.map

@@ -1 +1 @@
-{"version":3,"file":"display-field-datetime.js","sourceRoot":"","sources":["../../../../../src/components/data-display/formatters/display-field-datetime.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAaZ,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAA;AAElD,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAA;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAA;AAE3E,SAAS,oBAAoB,CAAC,EAC5B,KAAK,EACL,SAAS,GACiB;IAC1B,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,EAAE,SAAS,EAAE,qBAAqB,CAAC,oBAAoB,EAAE,CAAC,CAAA;IAElH,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,8BAAE,KAAC,IAAI,IAAC,SAAS,EAAC,8BAA8B,iBAAa,MAAM,uBAAS,EAAA,eAAM,SAAS,EAAC,SAAS,YAAE,UAAU,CAAC,qBAAqB,CAAC,oBAAoB,EAAE,SAAS,CAAC,GAAQ,IAAG,CAAA;IAC5L,CAAC;IAED,OAAO,KAAC,IAAI,IAAC,SAAS,EAAE,SAAS,YAAG,cAAc,CAAC,KAAK,CAAC,GAAQ,CAAA;AACnE,CAAC;AAED,CAAC;AAAC,oBAA8E,CAAC,WAAW,GAAG,sBAAsB,CAAA;AAErH,OAAO,EAAE,oBAAoB,EAAE,CAAA"}
+{"version":3,"file":"display-field-datetime.js","sourceRoot":"","sources":["../../../../../../src/components/data-display/formatters/display-field-datetime.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAaZ,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAA;AAElD,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAA;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAA;AAE3E,SAAS,oBAAoB,CAAC,EAC5B,KAAK,EACL,SAAS,GACiB;IAC1B,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,EAAE,SAAS,EAAE,qBAAqB,CAAC,oBAAoB,EAAE,CAAC,CAAA;IAElH,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAA;IAEzB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,8BAAE,KAAC,IAAI,IAAC,SAAS,EAAC,8BAA8B,iBAAa,MAAM,uBAAS,EAAA,eAAM,SAAS,EAAC,SAAS,YAAE,UAAU,CAAC,qBAAqB,CAAC,oBAAoB,EAAE,SAAS,CAAC,GAAQ,IAAG,CAAA;IAC5L,CAAC;IAED,OAAO,KAAC,IAAI,IAAC,SAAS,EAAE,SAAS,YAAG,cAAc,CAAC,KAAK,CAAC,GAAQ,CAAA;AACnE,CAAC;AAED,CAAC;AAAC,oBAA8E,CAAC,WAAW,GAAG,sBAAsB,CAAA;AAErH,OAAO,EAAE,oBAAoB,EAAE,CAAA","sourcesContent":["\"use client\"\n\n/**\n * DisplayFieldDateTime Component\n *\n * Displays a datetime value formatted according to regional preferences.\n * Uses the centralized formatting from ComponentsLabellingContext.\n *\n * Label/description rendering is handled by the parent DisplayField (FIELD-01).\n */\n\nimport * as React from \"react\"\n\nimport { Text } from \"@wildo-ai/saas-frontend-lib\"\nimport type { DisplayFieldDateTimeProps } from '@wildo-ai/saas-frontend-lib'\nimport { useI18n } from \"@wildo-ai/saas-frontend-lib\"\nimport { FrontendComponentType } from \"@wildo-ai/presets-components-models\"\n\nfunction DisplayFieldDateTime({\n  value,\n  className,\n}: DisplayFieldDateTimeProps): React.JSX.Element | null {\n  const { formatDateTime, tComponent, isReady } = useI18n({ component: FrontendComponentType.LOW_LEVEL_FORM_FIELD })\n\n  if (!isReady) return null\n\n  if (value === null || value === undefined) {\n    return <><Text className=\"text-muted-foreground italic\" aria-hidden=\"true\">—</Text><span className=\"sr-only\">{tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'noValue')}</span></>\n  }\n\n  return <Text className={className}>{formatDateTime(value)}</Text>\n}\n\n;(DisplayFieldDateTime as typeof DisplayFieldDateTime & { displayName: string }).displayName = \"DisplayFieldDateTime\"\n\nexport { DisplayFieldDateTime }\n"]}

package/dist/esm/components/data-display/formatters/display-field-datetime.labels.d.ts

@@ -0,0 +1,3 @@
+import { type LabellingUnitaryDef } from '@wildo-ai/presets-components-models';
+export declare const LowLevelDisplayFieldDatetimeLabels: LabellingUnitaryDef[];
+//# sourceMappingURL=display-field-datetime.labels.d.ts.map

package/dist/esm/components/data-display/formatters/display-field-datetime.labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-field-datetime.labels.d.ts","sourceRoot":"","sources":["../../../../../../src/components/data-display/formatters/display-field-datetime.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,mBAAmB,EAA2B,MAAM,qCAAqC,CAAC;AAM/H,eAAO,MAAM,kCAAkC,EAAE,mBAAmB,EAAO,CAAC"}

package/dist/esm/components/data-display/formatters/display-field-datetime.labels.js

@@ -0,0 +1,7 @@
+import { FrontendComponentType, registerComponentLabels } from '@wildo-ai/presets-components-models';
+// Companion-only label metadata for this component: keys + params + (where
+// authored) per-key purpose / kind / variable meaning. Statically scanned by
+// the dev companion; NOT imported at runtime, so it never ships in the bundle.
+export const LowLevelDisplayFieldDatetimeLabels = [];
+registerComponentLabels(FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_DATETIME, LowLevelDisplayFieldDatetimeLabels);
+//# sourceMappingURL=display-field-datetime.labels.js.map

package/dist/esm/components/data-display/formatters/display-field-datetime.labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-field-datetime.labels.js","sourceRoot":"","sources":["../../../../../../src/components/data-display/formatters/display-field-datetime.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAA4B,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAE/H,2EAA2E;AAC3E,6EAA6E;AAC7E,+EAA+E;AAE/E,MAAM,CAAC,MAAM,kCAAkC,GAA0B,EAAE,CAAC;AAC5E,uBAAuB,CAAC,qBAAqB,CAAC,gCAAgC,EAAE,kCAAkC,CAAC,CAAC","sourcesContent":["import { FrontendComponentType, type LabellingUnitaryDef, registerComponentLabels } from '@wildo-ai/presets-components-models';\n\n// Companion-only label metadata for this component: keys + params + (where\n// authored) per-key purpose / kind / variable meaning. Statically scanned by\n// the dev companion; NOT imported at runtime, so it never ships in the bundle.\n\nexport const LowLevelDisplayFieldDatetimeLabels: LabellingUnitaryDef[] = [];\nregisterComponentLabels(FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_DATETIME, LowLevelDisplayFieldDatetimeLabels);\n"]}

package/dist/esm/components/data-display/formatters/display-field-duration.d.ts

@@ -11,6 +11,6 @@ import type { DisplayFieldDurationProps } from '@wildo-ai/saas-frontend-lib';
  *
  * Renders a duration value with i18n-aware unit labels (e.g., "5 Minutes", "1 Hour").
  */
-declare function DisplayFieldDuration({ schema, value, className, }: DisplayFieldDurationProps): React.JSX.Element;
+declare function DisplayFieldDuration({ schema, value, className, }: DisplayFieldDurationProps): React.JSX.Element | null;
 export { DisplayFieldDuration };
 //# sourceMappingURL=display-field-duration.d.ts.map

package/dist/esm/components/data-display/formatters/display-field-duration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"display-field-duration.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/formatters/display-field-duration.tsx"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAE7E;;;;GAIG;AACH,iBAAS,oBAAoB,CAAC,EAC5B,MAAM,EACN,KAAK,EACL,SAAS,GACV,EAAE,yBAAyB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAoC/C;AAKD,OAAO,EAAE,oBAAoB,EAAE,CAAC"}
+{"version":3,"file":"display-field-duration.d.ts","sourceRoot":"","sources":["../../../../../../src/components/data-display/formatters/display-field-duration.tsx"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAE7E;;;;GAIG;AACH,iBAAS,oBAAoB,CAAC,EAC5B,MAAM,EACN,KAAK,EACL,SAAS,GACV,EAAE,yBAAyB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CA8CtD;AAKD,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/esm/components/data-display/formatters/display-field-duration.js

@@ -1,8 +1,16 @@
 'use client';
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * DisplayFieldDuration Component
+ *
+ * Displays a duration value with locale-aware formatting.
+ * Uses tSystemEnum for i18n-aware unit labels.
+ */
+import * as React from 'react';
 import { useI18n } from '@wildo-ai/saas-frontend-lib';
 import { Text } from '@wildo-ai/saas-frontend-lib';
 import { FrontendComponentType, SystemEnumName } from '@wildo-ai/presets-components-models';
+import { resolveInvalidLabel } from './display-field-i18n.utils.js';
 /**
  * DisplayFieldDuration component
  *
@@ -10,9 +18,15 @@ import { FrontendComponentType, SystemEnumName } from '@wildo-ai/presets-compone
  */
 function DisplayFieldDuration({ schema, value, className, }) {
     const { tComponent, tSystemEnum, isReady } = useI18n({
-        component: FrontendComponentType.LOW_LEVEL_FORM_FIELD,
+        component: [FrontendComponentType.LOW_LEVEL_FORM_FIELD, FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_DURATION],
         keys: ['system_enums'],
     });
+    // Hooks must run unconditionally — placed above the `!isReady` gate so the
+    // first ready render doesn't add a hook (Rules-of-Hooks crash into the
+    // DisplayField error boundary; same defect family as DisplayFieldPhone).
+    const invalidLabel = React.useMemo(() => resolveInvalidLabel(tComponent, FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_DURATION), [tComponent]);
+    if (!isReady)
+        return null;
     const renderValue = () => {
         if (value === null || value === undefined) {
             return (_jsxs(_Fragment, { children: [_jsx(Text, { className: "text-muted-foreground italic", "aria-hidden": "true", children: "\u2014" }), _jsx("span", { className: "sr-only", children: tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'noValue') })] }));
@@ -22,7 +36,7 @@ function DisplayFieldDuration({ schema, value, className, }) {
             !('unit' in value) ||
             typeof value.value !== 'number' ||
             typeof value.unit !== 'string') {
-            return _jsx(Text, { className: "text-muted-foreground italic", children: "Invalid" });
+            return _jsx(Text, { className: "text-muted-foreground italic", children: invalidLabel });
         }
         const unitLabel = tSystemEnum(SystemEnumName.DURATION_UNIT, value.unit);
         const displayText = `${value.value} ${unitLabel}`;
@@ -33,4 +47,4 @@ function DisplayFieldDuration({ schema, value, className, }) {
 DisplayFieldDuration.displayName =
     'DisplayFieldDuration';
 export { DisplayFieldDuration };
-//# sourceMappingURL=display-field-duration.js.map
+//# sourceMappingURL=display-field-duration.js.map

package/dist/esm/components/data-display/formatters/display-field-duration.js.map

@@ -1 +1 @@
-{"version":3,"file":"display-field-duration.js","sourceRoot":"","sources":["../../../../../src/components/data-display/formatters/display-field-duration.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAWb,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAG5F;;;;GAIG;AACH,SAAS,oBAAoB,CAAC,EAC5B,MAAM,EACN,KAAK,EACL,SAAS,GACiB;IAC1B,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QACnD,SAAS,EAAE,qBAAqB,CAAC,oBAAoB;QACrD,IAAI,EAAE,CAAC,cAAc,CAAC;KACvB,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,GAAG,EAAE;QACvB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC1C,OAAO,CACL,8BACE,KAAC,IAAI,IAAC,SAAS,EAAC,8BAA8B,iBAAa,MAAM,uBAE1D,EACP,eAAM,SAAS,EAAC,SAAS,YACtB,UAAU,CAAC,qBAAqB,CAAC,oBAAoB,EAAE,SAAS,CAAC,GAC7D,IACN,CACJ,CAAC;QACJ,CAAC;QAED,IACE,OAAO,KAAK,KAAK,QAAQ;YACzB,CAAC,CAAC,OAAO,IAAI,KAAK,CAAC;YACnB,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC;YAClB,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;YAC/B,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAC9B,CAAC;YACD,OAAO,KAAC,IAAI,IAAC,SAAS,EAAC,8BAA8B,wBAAe,CAAC;QACvE,CAAC;QAED,MAAM,SAAS,GAAG,WAAW,CAAC,cAAc,CAAC,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACxE,MAAM,WAAW,GAAG,GAAG,KAAK,CAAC,KAAK,IAAI,SAAS,EAAE,CAAC;QAClD,OAAO,KAAC,IAAI,IAAC,SAAS,EAAC,cAAc,YAAE,WAAW,GAAQ,CAAC;IAC7D,CAAC,CAAC;IAEF,OAAO,cAAK,SAAS,EAAE,SAAS,YAAG,WAAW,EAAE,GAAO,CAAC;AAC1D,CAAC;AAEA,oBAA8E,CAAC,WAAW;IACzF,sBAAsB,CAAC;AAEzB,OAAO,EAAE,oBAAoB,EAAE,CAAC"}
+{"version":3,"file":"display-field-duration.js","sourceRoot":"","sources":["../../../../../../src/components/data-display/formatters/display-field-duration.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb;;;;;GAKG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAC5F,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGjE;;;;GAIG;AACH,SAAS,oBAAoB,CAAC,EAC5B,MAAM,EACN,KAAK,EACL,SAAS,GACiB;IAC1B,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QACnD,SAAS,EAAE,CAAC,qBAAqB,CAAC,oBAAoB,EAAE,qBAAqB,CAAC,gCAAgC,CAAC;QAC/G,IAAI,EAAE,CAAC,cAAc,CAAC;KACvB,CAAC,CAAC;IAEH,2EAA2E;IAC3E,uEAAuE;IACvE,yEAAyE;IACzE,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAChC,GAAG,EAAE,CAAC,mBAAmB,CAAC,UAAU,EAAE,qBAAqB,CAAC,gCAAgC,CAAC,EAC7F,CAAC,UAAU,CAAC,CACb,CAAC;IAEF,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,MAAM,WAAW,GAAG,GAAG,EAAE;QACvB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC1C,OAAO,CACL,8BACE,KAAC,IAAI,IAAC,SAAS,EAAC,8BAA8B,iBAAa,MAAM,uBAE1D,EACP,eAAM,SAAS,EAAC,SAAS,YACtB,UAAU,CAAC,qBAAqB,CAAC,oBAAoB,EAAE,SAAS,CAAC,GAC7D,IACN,CACJ,CAAC;QACJ,CAAC;QAED,IACE,OAAO,KAAK,KAAK,QAAQ;YACzB,CAAC,CAAC,OAAO,IAAI,KAAK,CAAC;YACnB,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC;YAClB,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;YAC/B,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAC9B,CAAC;YACD,OAAO,KAAC,IAAI,IAAC,SAAS,EAAC,8BAA8B,YAAE,YAAY,GAAQ,CAAC;QAC9E,CAAC;QAED,MAAM,SAAS,GAAG,WAAW,CAAC,cAAc,CAAC,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACxE,MAAM,WAAW,GAAG,GAAG,KAAK,CAAC,KAAK,IAAI,SAAS,EAAE,CAAC;QAClD,OAAO,KAAC,IAAI,IAAC,SAAS,EAAC,cAAc,YAAE,WAAW,GAAQ,CAAC;IAC7D,CAAC,CAAC;IAEF,OAAO,cAAK,SAAS,EAAE,SAAS,YAAG,WAAW,EAAE,GAAO,CAAC;AAC1D,CAAC;AAEA,oBAA8E,CAAC,WAAW;IACzF,sBAAsB,CAAC;AAEzB,OAAO,EAAE,oBAAoB,EAAE,CAAC","sourcesContent":["'use client';\n\n/**\n * DisplayFieldDuration Component\n *\n * Displays a duration value with locale-aware formatting.\n * Uses tSystemEnum for i18n-aware unit labels.\n */\n\nimport * as React from 'react';\n\nimport { useI18n } from '@wildo-ai/saas-frontend-lib';\nimport { Text } from '@wildo-ai/saas-frontend-lib';\nimport { FrontendComponentType, SystemEnumName } from '@wildo-ai/presets-components-models';\nimport { resolveInvalidLabel } from './display-field-i18n.utils';\nimport type { DisplayFieldDurationProps } from '@wildo-ai/saas-frontend-lib';\n\n/**\n * DisplayFieldDuration component\n *\n * Renders a duration value with i18n-aware unit labels (e.g., \"5 Minutes\", \"1 Hour\").\n */\nfunction DisplayFieldDuration({\n  schema,\n  value,\n  className,\n}: DisplayFieldDurationProps): React.JSX.Element | null {\n  const { tComponent, tSystemEnum, isReady } = useI18n({\n    component: [FrontendComponentType.LOW_LEVEL_FORM_FIELD, FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_DURATION],\n    keys: ['system_enums'],\n  });\n\n  // Hooks must run unconditionally — placed above the `!isReady` gate so the\n  // first ready render doesn't add a hook (Rules-of-Hooks crash into the\n  // DisplayField error boundary; same defect family as DisplayFieldPhone).\n  const invalidLabel = React.useMemo(\n    () => resolveInvalidLabel(tComponent, FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_DURATION),\n    [tComponent]\n  );\n\n  if (!isReady) return null;\n\n  const renderValue = () => {\n    if (value === null || value === undefined) {\n      return (\n        <>\n          <Text className=\"text-muted-foreground italic\" aria-hidden=\"true\">\n            —\n          </Text>\n          <span className=\"sr-only\">\n            {tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'noValue')}\n          </span>\n        </>\n      );\n    }\n\n    if (\n      typeof value !== 'object' ||\n      !('value' in value) ||\n      !('unit' in value) ||\n      typeof value.value !== 'number' ||\n      typeof value.unit !== 'string'\n    ) {\n      return <Text className=\"text-muted-foreground italic\">{invalidLabel}</Text>;\n    }\n\n    const unitLabel = tSystemEnum(SystemEnumName.DURATION_UNIT, value.unit);\n    const displayText = `${value.value} ${unitLabel}`;\n    return <Text className=\"tabular-nums\">{displayText}</Text>;\n  };\n\n  return <div className={className}>{renderValue()}</div>;\n}\n\n(DisplayFieldDuration as typeof DisplayFieldDuration & { displayName: string }).displayName =\n  'DisplayFieldDuration';\n\nexport { DisplayFieldDuration };\n"]}

package/dist/esm/components/data-display/formatters/display-field-duration.labels.d.ts

@@ -0,0 +1,3 @@
+import { type LabellingUnitaryDef } from '@wildo-ai/presets-components-models';
+export declare const LowLevelDisplayFieldDurationLabels: LabellingUnitaryDef[];
+//# sourceMappingURL=display-field-duration.labels.d.ts.map

package/dist/esm/components/data-display/formatters/display-field-duration.labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-field-duration.labels.d.ts","sourceRoot":"","sources":["../../../../../../src/components/data-display/formatters/display-field-duration.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,mBAAmB,EAA2B,MAAM,qCAAqC,CAAC;AAM1I,eAAO,MAAM,kCAAkC,EAAE,mBAAmB,EAMnE,CAAC"}

package/dist/esm/components/data-display/formatters/display-field-duration.labels.js

@@ -0,0 +1,13 @@
+import { FrontendComponentType, LabelKind, registerComponentLabels } from '@wildo-ai/presets-components-models';
+// Companion-only label metadata for this component: keys + params + (where
+// authored) per-key purpose / kind / variable meaning. Statically scanned by
+// the dev companion; NOT imported at runtime, so it never ships in the bundle.
+export const LowLevelDisplayFieldDurationLabels = [
+    {
+        ref: 'invalid',
+        kind: LabelKind.MESSAGE,
+        purpose: 'Fallback shown in place of a duration value that cannot be parsed into a time span',
+    },
+];
+registerComponentLabels(FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_DURATION, LowLevelDisplayFieldDurationLabels);
+//# sourceMappingURL=display-field-duration.labels.js.map

package/dist/esm/components/data-display/formatters/display-field-duration.labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-field-duration.labels.js","sourceRoot":"","sources":["../../../../../../src/components/data-display/formatters/display-field-duration.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAA4B,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAE1I,2EAA2E;AAC3E,6EAA6E;AAC7E,+EAA+E;AAE/E,MAAM,CAAC,MAAM,kCAAkC,GAA0B;IACvE;QACE,GAAG,EAAE,SAAS;QACd,IAAI,EAAE,SAAS,CAAC,OAAO;QACvB,OAAO,EAAE,oFAAoF;KAC9F;CACF,CAAC;AACF,uBAAuB,CAAC,qBAAqB,CAAC,gCAAgC,EAAE,kCAAkC,CAAC,CAAC","sourcesContent":["import { FrontendComponentType, LabelKind, type LabellingUnitaryDef, registerComponentLabels } from '@wildo-ai/presets-components-models';\n\n// Companion-only label metadata for this component: keys + params + (where\n// authored) per-key purpose / kind / variable meaning. Statically scanned by\n// the dev companion; NOT imported at runtime, so it never ships in the bundle.\n\nexport const LowLevelDisplayFieldDurationLabels: LabellingUnitaryDef[] = [\n  {\n    ref: 'invalid',\n    kind: LabelKind.MESSAGE,\n    purpose: 'Fallback shown in place of a duration value that cannot be parsed into a time span',\n  },\n];\nregisterComponentLabels(FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_DURATION, LowLevelDisplayFieldDurationLabels);\n"]}

package/dist/esm/components/data-display/formatters/display-field-enum.d.ts

@@ -11,6 +11,6 @@ import type { DisplayFieldEnumProps } from '@wildo-ai/saas-frontend-lib';
  *
  * Renders an enum value according to the display policy
  */
-declare function DisplayFieldEnum({ schema, value, className, labels, }: DisplayFieldEnumProps): React.JSX.Element;
+declare function DisplayFieldEnum({ schema, value, className, labels, }: DisplayFieldEnumProps): React.JSX.Element | null;
 export { DisplayFieldEnum };
 //# sourceMappingURL=display-field-enum.d.ts.map

package/dist/esm/components/data-display/formatters/display-field-enum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"display-field-enum.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/formatters/display-field-enum.tsx"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAM9B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAA;AAGxE;;;;GAIG;AACH,iBAAS,gBAAgB,CAAC,EACxB,MAAM,EACN,KAAK,EACL,SAAS,EACT,MAAM,GACP,EAAE,qBAAqB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA+F3C;AAID,OAAO,EAAE,gBAAgB,EAAE,CAAA"}
+{"version":3,"file":"display-field-enum.d.ts","sourceRoot":"","sources":["../../../../../../src/components/data-display/formatters/display-field-enum.tsx"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAM9B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAA;AAGxE;;;;GAIG;AACH,iBAAS,gBAAgB,CAAC,EACxB,MAAM,EACN,KAAK,EACL,SAAS,EACT,MAAM,GACP,EAAE,qBAAqB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAkHlD;AAID,OAAO,EAAE,gBAAgB,EAAE,CAAA"}

package/dist/esm/components/data-display/formatters/display-field-enum.js

@@ -7,7 +7,7 @@ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-run
  * Supports different display modes: text, badge, icon, card
  */
 import * as React from "react";
-import { cn, useI18n, useIconRegistry, IconSize, ICON_SIZE_MAP, Text, Badge, Card } from "@wildo-ai/saas-frontend-lib";
+import { cn, useI18n, useIconRegistry, IconSize, ICON_SIZE_MAP, Text, Badge, Card, DisplayContextKind, useDisplayContextKind } from "@wildo-ai/saas-frontend-lib";
 import { FrontendComponentType } from "@wildo-ai/presets-components-models";
 import { EnumDisplayMode, getEnumUI } from "@wildo-ai/zod-decorators";
 /**
@@ -18,8 +18,16 @@ import { EnumDisplayMode, getEnumUI } from "@wildo-ai/zod-decorators";
 function DisplayFieldEnum({ schema, value, className, labels, }) {
     const { tComponent, isReady } = useI18n({ component: FrontendComponentType.LOW_LEVEL_FORM_FIELD });
     const { renderIcon } = useIconRegistry();
+    const displayContextKind = useDisplayContextKind();
     const enumUI = getEnumUI(schema);
-    const displayMode = enumUI?.display?.displayMode ?? EnumDisplayMode.TEXT;
+    // SUMMARY surfaces (cards, FK previews) merge `summaryOverride` over
+    // `display` — the {primitive}UI decorator contract. E.g. a priority enum can
+    // render `BADGE` on the detail page but `summaryOverride: { displayMode: ICON }`
+    // (icon-only) on list cards.
+    const displayParams = displayContextKind === DisplayContextKind.SUMMARY
+        ? { ...enumUI?.display, ...enumUI?.summaryOverride }
+        : enumUI?.display;
+    const displayMode = displayParams?.displayMode ?? EnumDisplayMode.TEXT;
     const resolveColor = (enumValue, fallback) => {
         return (enumUI?.values?.[enumValue]?.color
             ?? enumUI?.defaultColor
@@ -57,13 +65,19 @@ function DisplayFieldEnum({ schema, value, className, labels, }) {
                 const icon = resolveIcon(value);
                 return (_jsxs(Badge, { variant: variant, className: cn(icon && 'inline-flex items-center gap-item-xs'), children: [icon ? renderIconLike(icon, IconSize.SM) : null, displayLabel] }));
             }
+            // ICON — the COMPACT, icon-only representation: a colored badge carrying
+            // just the value's icon; the label goes to assistive tech (sr-only) and
+            // to sighted users on hover (native `title`). This is what summary
+            // surfaces use via `summaryOverride: { displayMode: ICON }`. It is NOT a
+            // "badge with icon" — that's BADGE with a per-value `icon` configured.
             case EnumDisplayMode.ICON: {
                 const iconVariant = resolveColor(value, 'outline');
                 const icon = resolveIcon(value);
                 if (icon) {
-                    return (_jsxs(Badge, { variant: iconVariant, className: "gap-item-xs", children: [renderIconLike(icon, IconSize.SM), displayLabel] }));
+                    return (_jsxs(Badge, { variant: iconVariant, className: "px-1.5", title: displayLabel, children: [renderIconLike(icon, IconSize.SM), _jsx("span", { className: "sr-only", children: displayLabel })] }));
                 }
-                return (_jsxs("span", { className: "inline-flex items-center gap-item-xs", children: [_jsx(Badge, { variant: iconVariant, className: "h-2.5 w-2.5 rounded-full p-0", "aria-hidden": "true" }), _jsx(Text, { children: displayLabel })] }));
+                // No icon configured for this value — the color dot IS the icon.
+                return (_jsx(Badge, { variant: iconVariant, className: "h-2.5 w-2.5 rounded-full p-0", title: displayLabel, children: _jsx("span", { className: "sr-only", children: displayLabel }) }));
             }
             case EnumDisplayMode.CARD:
                 return (_jsx(Card, { className: "inline-flex px-card-sm py-1.5", children: _jsx(Text, { className: "text-sm font-medium", children: displayLabel }) }));
@@ -71,10 +85,12 @@ function DisplayFieldEnum({ schema, value, className, labels, }) {
                 return _jsx(Text, { children: displayLabel });
         }
     };
+    if (!isReady)
+        return null;
     // Label/description rendering is handled by the parent DisplayField (FIELD-01)
     return _jsx("div", { className: className, children: renderValue() });
 }
 ;
 DisplayFieldEnum.displayName = "DisplayFieldEnum";
 export { DisplayFieldEnum };
-//# sourceMappingURL=display-field-enum.js.map
+//# sourceMappingURL=display-field-enum.js.map

package/dist/esm/components/data-display/formatters/display-field-enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"display-field-enum.js","sourceRoot":"","sources":["../../../../../src/components/data-display/formatters/display-field-enum.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"display-field-enum.js","sourceRoot":"","sources":["../../../../../../src/components/data-display/formatters/display-field-enum.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\"\n\n/**\n * DisplayFieldEnum Component\n *\n * Displays an enum value based on the enum UI decorator.\n * Supports different display modes: text, badge, icon, card\n */\n\nimport * as React from \"react\"\n\nimport { cn, useI18n, useIconRegistry, IconSize, ICON_SIZE_MAP, Text, Badge, Card, DisplayContextKind, useDisplayContextKind } from \"@wildo-ai/saas-frontend-lib\"\nimport { FrontendComponentType } from \"@wildo-ai/presets-components-models\"\nimport { EnumDisplayMode, getEnumUI } from \"@wildo-ai/zod-decorators\"\nimport type { IconLike } from \"@wildo-ai/zod-decorators\"\nimport type { DisplayFieldEnumProps } from '@wildo-ai/saas-frontend-lib'\nimport type { BadgeVariants_Variant } from '@wildo-ai/saas-frontend-lib'\n\n/**\n * DisplayFieldEnum component\n *\n * Renders an enum value according to the display policy\n */\nfunction DisplayFieldEnum({\n  schema,\n  value,\n  className,\n  labels,\n}: DisplayFieldEnumProps): React.JSX.Element | null {\n  const { tComponent, isReady } = useI18n({ component: FrontendComponentType.LOW_LEVEL_FORM_FIELD })\n  const { renderIcon } = useIconRegistry()\n  const displayContextKind = useDisplayContextKind()\n\n  const enumUI = getEnumUI(schema)\n  // SUMMARY surfaces (cards, FK previews) merge `summaryOverride` over\n  // `display` — the {primitive}UI decorator contract. E.g. a priority enum can\n  // render `BADGE` on the detail page but `summaryOverride: { displayMode: ICON }`\n  // (icon-only) on list cards.\n  const displayParams = displayContextKind === DisplayContextKind.SUMMARY\n    ? { ...enumUI?.display, ...enumUI?.summaryOverride }\n    : enumUI?.display\n  const displayMode = displayParams?.displayMode ?? EnumDisplayMode.TEXT\n\n  const resolveColor = (enumValue: string, fallback: BadgeVariants_Variant): BadgeVariants_Variant => {\n    return (\n      enumUI?.values?.[enumValue]?.color\n      ?? enumUI?.defaultColor\n      ?? fallback\n    ) as BadgeVariants_Variant\n  }\n\n  const resolveIcon = (enumValue: string): IconLike | undefined => {\n    return (\n      enumUI?.values?.[enumValue]?.icon\n      ?? enumUI?.defaultIcon\n    )\n  }\n\n  // Get display label for the value\n  const displayLabel = value ? (labels?.[value] ?? value) : null\n\n  /**\n   * Render an `IconLike` — dispatches between string refs (via icon registry)\n   * and direct React component refs (via createElement).\n   */\n  const renderIconLike = (icon: IconLike, size: IconSize, className?: string): React.ReactNode => {\n    if (typeof icon === 'string') {\n      return renderIcon(icon, { size, className })\n    }\n    const sizeInPixels = ICON_SIZE_MAP[size]\n    return React.createElement(icon, { size: sizeInPixels, className })\n  }\n\n  // Render the value content\n  const renderValue = () => {\n    // Handle null/undefined\n    if (value === null || value === undefined || value === '' || displayLabel === null) {\n      return <><Text className=\"text-muted-foreground italic\" aria-hidden=\"true\">—</Text><span className=\"sr-only\">{tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'noValue')}</span></>\n    }\n\n    // Render based on display mode\n    switch (displayMode) {\n      case EnumDisplayMode.TEXT:\n        return <Text>{displayLabel}</Text>\n\n      case EnumDisplayMode.BADGE: {\n        const variant = resolveColor(value, 'secondary')\n        const icon = resolveIcon(value)\n        return (\n          <Badge variant={variant} className={cn(icon && 'inline-flex items-center gap-item-xs')}>\n            {icon ? renderIconLike(icon, IconSize.SM) : null}\n            {displayLabel}\n          </Badge>\n        )\n      }\n\n      // ICON — the COMPACT, icon-only representation: a colored badge carrying\n      // just the value's icon; the label goes to assistive tech (sr-only) and\n      // to sighted users on hover (native `title`). This is what summary\n      // surfaces use via `summaryOverride: { displayMode: ICON }`. It is NOT a\n      // \"badge with icon\" — that's BADGE with a per-value `icon` configured.\n      case EnumDisplayMode.ICON: {\n        const iconVariant = resolveColor(value, 'outline')\n        const icon = resolveIcon(value)\n\n        if (icon) {\n          return (\n            <Badge variant={iconVariant} className=\"px-1.5\" title={displayLabel}>\n              {renderIconLike(icon, IconSize.SM)}\n              <span className=\"sr-only\">{displayLabel}</span>\n            </Badge>\n          )\n        }\n\n        // No icon configured for this value — the color dot IS the icon.\n        return (\n          <Badge\n            variant={iconVariant}\n            className=\"h-2.5 w-2.5 rounded-full p-0\"\n            title={displayLabel}\n          >\n            <span className=\"sr-only\">{displayLabel}</span>\n          </Badge>\n        )\n      }\n\n      case EnumDisplayMode.CARD:\n        return (\n          <Card className=\"inline-flex px-card-sm py-1.5\">\n            <Text className=\"text-sm font-medium\">{displayLabel}</Text>\n          </Card>\n        )\n\n      default:\n        return <Text>{displayLabel}</Text>\n    }\n  }\n\n  if (!isReady) return null\n\n  // Label/description rendering is handled by the parent DisplayField (FIELD-01)\n  return <div className={className}>{renderValue()}</div>\n}\n\n;(DisplayFieldEnum as typeof DisplayFieldEnum & { displayName: string }).displayName = \"DisplayFieldEnum\"\n\nexport { DisplayFieldEnum }\n"]}

package/dist/esm/components/data-display/formatters/display-field-enum.labels.d.ts

@@ -0,0 +1,3 @@
+import { type LabellingUnitaryDef } from '@wildo-ai/presets-components-models';
+export declare const LowLevelDisplayFieldEnumLabels: LabellingUnitaryDef[];
+//# sourceMappingURL=display-field-enum.labels.d.ts.map

package/dist/esm/components/data-display/formatters/display-field-enum.labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-field-enum.labels.d.ts","sourceRoot":"","sources":["../../../../../../src/components/data-display/formatters/display-field-enum.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,mBAAmB,EAA2B,MAAM,qCAAqC,CAAC;AAM/H,eAAO,MAAM,8BAA8B,EAAE,mBAAmB,EAAO,CAAC"}

package/dist/esm/components/data-display/formatters/display-field-enum.labels.js

@@ -0,0 +1,7 @@
+import { FrontendComponentType, registerComponentLabels } from '@wildo-ai/presets-components-models';
+// Companion-only label metadata for this component: keys + params + (where
+// authored) per-key purpose / kind / variable meaning. Statically scanned by
+// the dev companion; NOT imported at runtime, so it never ships in the bundle.
+export const LowLevelDisplayFieldEnumLabels = [];
+registerComponentLabels(FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_ENUM, LowLevelDisplayFieldEnumLabels);
+//# sourceMappingURL=display-field-enum.labels.js.map

package/dist/esm/components/data-display/formatters/display-field-enum.labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-field-enum.labels.js","sourceRoot":"","sources":["../../../../../../src/components/data-display/formatters/display-field-enum.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAA4B,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAE/H,2EAA2E;AAC3E,6EAA6E;AAC7E,+EAA+E;AAE/E,MAAM,CAAC,MAAM,8BAA8B,GAA0B,EAAE,CAAC;AACxE,uBAAuB,CAAC,qBAAqB,CAAC,4BAA4B,EAAE,8BAA8B,CAAC,CAAC","sourcesContent":["import { FrontendComponentType, type LabellingUnitaryDef, registerComponentLabels } from '@wildo-ai/presets-components-models';\n\n// Companion-only label metadata for this component: keys + params + (where\n// authored) per-key purpose / kind / variable meaning. Statically scanned by\n// the dev companion; NOT imported at runtime, so it never ships in the bundle.\n\nexport const LowLevelDisplayFieldEnumLabels: LabellingUnitaryDef[] = [];\nregisterComponentLabels(FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_ENUM, LowLevelDisplayFieldEnumLabels);\n"]}

package/dist/esm/components/data-display/formatters/display-field-file-audio.d.ts

@@ -8,7 +8,7 @@
  * Resolved via the component registry (LOW_LEVEL_DISPLAY_FIELD_FILE_AUDIO).
  */
 import * as React from "react";
-import type { DisplayFieldFileAudioProps } from '@wildo-ai/saas-frontend-lib';
-declare function DisplayFieldFileAudio({ metadata, fileId, className, showDownload, showSize, }: DisplayFieldFileAudioProps): React.JSX.Element;
+import { DisplayFieldFileAudioProps } from '@wildo-ai/saas-frontend-lib';
+declare function DisplayFieldFileAudio({ metadata, fileId, className, showDownload, showSize, }: DisplayFieldFileAudioProps): React.JSX.Element | null;
 export { DisplayFieldFileAudio };
 //# sourceMappingURL=display-field-file-audio.d.ts.map

package/dist/esm/components/data-display/formatters/display-field-file-audio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"display-field-file-audio.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/formatters/display-field-file-audio.tsx"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAK9B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAA;AAM7E,iBAAS,qBAAqB,CAAC,EAC7B,QAAQ,EACR,MAAM,EACN,SAAS,EACT,YAAmB,EACnB,QAAe,GAChB,EAAE,0BAA0B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAmEhD;AAID,OAAO,EAAE,qBAAqB,EAAE,CAAA"}
+{"version":3,"file":"display-field-file-audio.d.ts","sourceRoot":"","sources":["../../../../../../src/components/data-display/formatters/display-field-file-audio.tsx"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAQL,0BAA0B,EAC3B,MAAM,6BAA6B,CAAC;AASrC,iBAAS,qBAAqB,CAAC,EAC7B,QAAQ,EACR,MAAM,EACN,SAAS,EACT,YAAmB,EACnB,QAAe,GAChB,EAAE,0BAA0B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAyEvD;AAID,OAAO,EAAE,qBAAqB,EAAE,CAAA"}

package/dist/esm/components/data-display/formatters/display-field-file-audio.js

@@ -10,8 +10,8 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * Resolved via the component registry (LOW_LEVEL_DISPLAY_FIELD_FILE_AUDIO).
  */
 import * as React from "react";
-import { Text, useIconRegistry, StandardIconReference, IconSize, useI18n } from "@wildo-ai/saas-frontend-lib";
-import { FrontendComponentType } from "@wildo-ai/presets-components-models";
+import { Text, useIconRegistry, StandardIconReference, IconSize, useI18n, cn, Surface, } from '@wildo-ai/saas-frontend-lib';
+import { FrontendComponentType, SurfaceVariant } from "@wildo-ai/presets-components-models";
 import { formatFileSize } from "@wildo-ai/zod-decorators";
 // =============================================================================
 // COMPONENT
@@ -20,14 +20,16 @@ function DisplayFieldFileAudio({ metadata, fileId, className, showDownload = tru
     const { renderIcon } = useIconRegistry();
     const { tComponent, isReady } = useI18n({ component: [FrontendComponentType.LOW_LEVEL_FORM_FIELD, FrontendComponentType.LOW_LEVEL_FORM_FIELD_FILE] });
     const [audioError, setAudioError] = React.useState(false);
+    if (!isReady)
+        return null;
     const audioUrl = metadata.url;
     // No URL or audio failed — fallback to download card
     if (audioError || !audioUrl) {
-        return (_jsxs("div", { className: `flex items-center gap-group p-card-sm rounded-md border bg-muted/30 ${className ?? ''}`, children: [_jsx("span", { "aria-hidden": "true", children: renderIcon(StandardIconReference.FILE_AUDIO, { size: IconSize.LG, className: "text-muted-foreground" }) }), _jsxs("div", { className: "flex-1 min-w-0", children: [_jsx(Text, { className: "font-medium truncate", children: metadata.filename }), _jsxs("div", { className: "flex items-center gap-group text-xs text-muted-foreground mt-0.5", children: [showSize && _jsx("span", { children: formatFileSize(metadata.size) }), metadata.extension && _jsx("span", { className: "uppercase", children: metadata.extension }), audioError && _jsx("span", { className: "text-destructive", children: tComponent(FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_FILE_AUDIO, 'audio_load_error') })] })] }), showDownload && audioUrl && (_jsx("a", { href: audioUrl, download: metadata.filename, className: "text-primary hover:underline text-sm shrink-0", children: tComponent(FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_FILE_AUDIO, 'download') }))] }));
+        return (_jsx(Surface, { asChild: true, emitPolicyVars: false, variant: SurfaceVariant.BASE, children: _jsxs("div", { className: cn('flex items-center gap-group p-card-sm rounded-md border bg-muted/30', className), children: [_jsx("span", { "aria-hidden": "true", children: renderIcon(StandardIconReference.FILE_AUDIO, { size: IconSize.LG, className: "text-muted-foreground" }) }), _jsxs("div", { className: "flex-1 min-w-0", children: [_jsx(Text, { className: "font-medium truncate", children: metadata.filename }), _jsxs("div", { className: "flex items-center gap-group text-xs text-muted-foreground mt-0.5", children: [showSize && _jsx("span", { children: formatFileSize(metadata.size) }), metadata.extension && _jsx("span", { className: "uppercase", children: metadata.extension }), audioError && _jsx("span", { className: "text-destructive", children: tComponent(FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_FILE_AUDIO, 'audio_load_error') })] })] }), showDownload && audioUrl && (_jsx("a", { href: audioUrl, download: metadata.filename, className: "text-primary hover:underline text-sm shrink-0", children: tComponent(FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_FILE_AUDIO, 'download') }))] }) }));
     }
-    return (_jsxs("div", { className: `flex items-center gap-group p-card-sm rounded-md border bg-muted/30 ${className ?? ''}`, children: [_jsx("span", { "aria-hidden": "true", children: renderIcon(StandardIconReference.FILE_AUDIO, { size: IconSize.LG, className: "text-muted-foreground" }) }), _jsxs("div", { className: "flex-1 min-w-0 space-y-item", children: [_jsxs("div", { className: "flex items-center gap-group", children: [_jsx(Text, { className: "font-medium truncate max-w-48", children: metadata.filename }), showSize && _jsx("span", { className: "text-xs text-muted-foreground", children: formatFileSize(metadata.size) }), metadata.extension && _jsx("span", { className: "text-xs text-muted-foreground uppercase", children: metadata.extension })] }), _jsxs("audio", { controls: true, preload: "metadata", className: "w-full h-8", onError: () => setAudioError(true), children: [_jsx("source", { src: audioUrl, type: metadata.mimeType }), tComponent(FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_FILE_AUDIO, 'unsupported_format')] })] }), showDownload && (_jsx("a", { href: audioUrl, download: metadata.filename, className: "text-primary hover:underline text-sm shrink-0", children: tComponent(FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_FILE_AUDIO, 'download') }))] }));
+    return (_jsx(Surface, { asChild: true, emitPolicyVars: false, variant: SurfaceVariant.BASE, children: _jsxs("div", { className: cn('flex items-center gap-group p-card-sm rounded-md border bg-muted/30', className), children: [_jsx("span", { "aria-hidden": "true", children: renderIcon(StandardIconReference.FILE_AUDIO, { size: IconSize.LG, className: "text-muted-foreground" }) }), _jsxs("div", { className: "flex-1 min-w-0 space-y-item", children: [_jsxs("div", { className: "flex items-center gap-group", children: [_jsx(Text, { className: "font-medium truncate max-w-48", children: metadata.filename }), showSize && _jsx("span", { className: "text-xs text-muted-foreground", children: formatFileSize(metadata.size) }), metadata.extension && _jsx("span", { className: "text-xs text-muted-foreground uppercase", children: metadata.extension })] }), _jsxs("audio", { controls: true, preload: "metadata", className: "w-full h-8", onError: () => setAudioError(true), children: [_jsx("source", { src: audioUrl, type: metadata.mimeType }), tComponent(FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_FILE_AUDIO, 'unsupported_format')] })] }), showDownload && (_jsx("a", { href: audioUrl, download: metadata.filename, className: "text-primary hover:underline text-sm shrink-0", children: tComponent(FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_FILE_AUDIO, 'download') }))] }) }));
 }
 ;
 DisplayFieldFileAudio.displayName = "DisplayFieldFileAudio";
 export { DisplayFieldFileAudio };
-//# sourceMappingURL=display-field-file-audio.js.map
+//# sourceMappingURL=display-field-file-audio.js.map

package/dist/esm/components/data-display/formatters/display-field-file-audio.js.map

@@ -1 +1 @@
-{"version":3,"file":"display-field-file-audio.js","sourceRoot":"","sources":["../../../../../src/components/data-display/formatters/display-field-file-audio.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"display-field-file-audio.js","sourceRoot":"","sources":["../../../../../../src/components/data-display/formatters/display-field-file-audio.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\"\n\n/**\n * DisplayFieldFileAudio Component\n *\n * Nature-specific display for audio files.\n * Renders a compact HTML5 audio player with native controls\n * and file metadata.\n *\n * Resolved via the component registry (LOW_LEVEL_DISPLAY_FIELD_FILE_AUDIO).\n */\n\nimport * as React from \"react\"\n\nimport {\n  Text,\n  useIconRegistry,\n  StandardIconReference,\n  IconSize,\n  useI18n,\n  cn,\n  Surface,\n  DisplayFieldFileAudioProps,\n} from '@wildo-ai/saas-frontend-lib';\n\nimport { FrontendComponentType, SurfaceVariant } from \"@wildo-ai/presets-components-models\"\nimport { type FileMetadata, formatFileSize } from \"@wildo-ai/zod-decorators\"\n\n// =============================================================================\n// COMPONENT\n// =============================================================================\n\nfunction DisplayFieldFileAudio({\n  metadata,\n  fileId,\n  className,\n  showDownload = true,\n  showSize = true,\n}: DisplayFieldFileAudioProps): React.JSX.Element | null {\n  const { renderIcon } = useIconRegistry()\n  const { tComponent, isReady } = useI18n({ component: [FrontendComponentType.LOW_LEVEL_FORM_FIELD, FrontendComponentType.LOW_LEVEL_FORM_FIELD_FILE] })\n\n  const [audioError, setAudioError] = React.useState(false)\n\n  if (!isReady) return null\n\n  const audioUrl = metadata.url\n\n  // No URL or audio failed — fallback to download card\n  if (audioError || !audioUrl) {\n    return (\n      <Surface asChild emitPolicyVars={false} variant={SurfaceVariant.BASE}>\n        <div className={cn('flex items-center gap-group p-card-sm rounded-md border bg-muted/30', className)}>\n          <span aria-hidden=\"true\">\n            {renderIcon(StandardIconReference.FILE_AUDIO, { size: IconSize.LG, className: \"text-muted-foreground\" })}\n          </span>\n          <div className=\"flex-1 min-w-0\">\n            <Text className=\"font-medium truncate\">{metadata.filename}</Text>\n            <div className=\"flex items-center gap-group text-xs text-muted-foreground mt-0.5\">\n              {showSize && <span>{formatFileSize(metadata.size)}</span>}\n              {metadata.extension && <span className=\"uppercase\">{metadata.extension}</span>}\n              {audioError && <span className=\"text-destructive\">{tComponent(FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_FILE_AUDIO, 'audio_load_error')}</span>}\n            </div>\n          </div>\n          {showDownload && audioUrl && (\n            <a href={audioUrl} download={metadata.filename} className=\"text-primary hover:underline text-sm shrink-0\">\n              {tComponent(FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_FILE_AUDIO, 'download')}\n            </a>\n          )}\n        </div>\n      </Surface>\n    )\n  }\n\n  return (\n    <Surface asChild emitPolicyVars={false} variant={SurfaceVariant.BASE}>\n      <div className={cn('flex items-center gap-group p-card-sm rounded-md border bg-muted/30', className)}>\n        {/* Audio icon */}\n        <span aria-hidden=\"true\">\n          {renderIcon(StandardIconReference.FILE_AUDIO, { size: IconSize.LG, className: \"text-muted-foreground\" })}\n        </span>\n\n        {/* File info + player */}\n        <div className=\"flex-1 min-w-0 space-y-item\">\n          <div className=\"flex items-center gap-group\">\n            <Text className=\"font-medium truncate max-w-48\">{metadata.filename}</Text>\n            {showSize && <span className=\"text-xs text-muted-foreground\">{formatFileSize(metadata.size)}</span>}\n            {metadata.extension && <span className=\"text-xs text-muted-foreground uppercase\">{metadata.extension}</span>}\n          </div>\n\n          {/* Compact audio player — full width within the card */}\n          <audio\n            controls\n            preload=\"metadata\"\n            className=\"w-full h-8\"\n            onError={() => setAudioError(true)}\n          >\n            <source src={audioUrl} type={metadata.mimeType} />\n            {tComponent(FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_FILE_AUDIO, 'unsupported_format')}\n          </audio>\n        </div>\n\n        {/* Download link */}\n        {showDownload && (\n          <a href={audioUrl} download={metadata.filename} className=\"text-primary hover:underline text-sm shrink-0\">\n            {tComponent(FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_FILE_AUDIO, 'download')}\n          </a>\n        )}\n      </div>\n    </Surface>\n  )\n}\n\n;(DisplayFieldFileAudio as typeof DisplayFieldFileAudio & { displayName: string }).displayName = \"DisplayFieldFileAudio\"\n\nexport { DisplayFieldFileAudio }\n"]}

package/dist/esm/components/data-display/formatters/display-field-file-audio.labels.d.ts

@@ -0,0 +1,3 @@
+import { type LabellingUnitaryDef } from '@wildo-ai/presets-components-models';
+export declare const DisplayFieldFileAudio_Labels: LabellingUnitaryDef[];
+//# sourceMappingURL=display-field-file-audio.labels.d.ts.map

package/dist/esm/components/data-display/formatters/display-field-file-audio.labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-field-file-audio.labels.d.ts","sourceRoot":"","sources":["../../../../../../src/components/data-display/formatters/display-field-file-audio.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,mBAAmB,EAA2B,MAAM,qCAAqC,CAAC;AAM1I,eAAO,MAAM,4BAA4B,EAAE,mBAAmB,EAI7D,CAAC"}

package/dist/esm/components/data-display/formatters/display-field-file-audio.labels.js

@@ -0,0 +1,11 @@
+import { FrontendComponentType, LabelKind, registerComponentLabels } from '@wildo-ai/presets-components-models';
+// Companion-only label metadata for this component: keys + params + (where
+// authored) per-key purpose / kind / variable meaning. Statically scanned by
+// the dev companion; NOT imported at runtime, so it never ships in the bundle.
+export const DisplayFieldFileAudio_Labels = [
+    { ref: 'audio_load_error', kind: LabelKind.MESSAGE, purpose: 'Error shown when the audio file fails to load in the player' },
+    { ref: 'unsupported_format', kind: LabelKind.MESSAGE, purpose: 'Notice shown when the browser cannot play this audio format' },
+    { ref: 'download', kind: LabelKind.BUTTON, purpose: 'Download link offered as a fallback when the audio cannot be played inline' },
+];
+registerComponentLabels(FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_FILE_AUDIO, DisplayFieldFileAudio_Labels);
+//# sourceMappingURL=display-field-file-audio.labels.js.map

package/dist/esm/components/data-display/formatters/display-field-file-audio.labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-field-file-audio.labels.js","sourceRoot":"","sources":["../../../../../../src/components/data-display/formatters/display-field-file-audio.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAA4B,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAE1I,2EAA2E;AAC3E,6EAA6E;AAC7E,+EAA+E;AAE/E,MAAM,CAAC,MAAM,4BAA4B,GAA0B;IACjE,EAAE,GAAG,EAAE,kBAAkB,EAAE,IAAI,EAAE,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,6DAA6D,EAAE;IAC5H,EAAE,GAAG,EAAE,oBAAoB,EAAE,IAAI,EAAE,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,6DAA6D,EAAE;IAC9H,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,4EAA4E,EAAE;CACnI,CAAC;AACF,uBAAuB,CAAC,qBAAqB,CAAC,kCAAkC,EAAE,4BAA4B,CAAC,CAAC","sourcesContent":["import { FrontendComponentType, LabelKind, type LabellingUnitaryDef, registerComponentLabels } from '@wildo-ai/presets-components-models';\n\n// Companion-only label metadata for this component: keys + params + (where\n// authored) per-key purpose / kind / variable meaning. Statically scanned by\n// the dev companion; NOT imported at runtime, so it never ships in the bundle.\n\nexport const DisplayFieldFileAudio_Labels: LabellingUnitaryDef[] = [\n  { ref: 'audio_load_error', kind: LabelKind.MESSAGE, purpose: 'Error shown when the audio file fails to load in the player' },\n  { ref: 'unsupported_format', kind: LabelKind.MESSAGE, purpose: 'Notice shown when the browser cannot play this audio format' },\n  { ref: 'download', kind: LabelKind.BUTTON, purpose: 'Download link offered as a fallback when the audio cannot be played inline' },\n];\nregisterComponentLabels(FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_FILE_AUDIO, DisplayFieldFileAudio_Labels);\n"]}

package/dist/esm/components/data-display/formatters/display-field-file-document.d.ts

@@ -2,13 +2,17 @@
  * DisplayFieldFileDocument Component
  *
  * Nature-specific display for document files (PDF, Office).
- * - PDF: Embeds in an iframe using the browser's native PDF viewer.
- * - Office docs: Enhanced file card with type-specific icon + download button.
+ * - PDF: rendered by PDF.js behind the `PdfViewerLazy` boundary, so the pdf.js
+ *   payload is fetched only when a PDF is actually displayed. Replaces the previous
+ *   `<iframe>` on the browser's native viewer, which could not be styled to the
+ *   design system and dies under a strict `frame-src` CSP.
+ * - Office docs: file card with type-specific icon + download (no viewer exists, so
+ *   the display guard refuses THUMBNAIL/FULL for them upstream).
  *
  * Resolved via the component registry (LOW_LEVEL_DISPLAY_FIELD_FILE_DOCUMENT).
  */
 import * as React from "react";
-import type { DisplayFieldFileDocumentProps } from '@wildo-ai/saas-frontend-lib';
-declare function DisplayFieldFileDocument({ metadata, fileId, className, showDownload, showSize, }: DisplayFieldFileDocumentProps): React.JSX.Element;
+import { DisplayFieldFileDocumentProps } from '@wildo-ai/saas-frontend-lib';
+declare function DisplayFieldFileDocument({ metadata, fileId, refreshKey, className, showDownload, showSize, presentation, getBlob, serveUrl, }: DisplayFieldFileDocumentProps): React.JSX.Element | null;
 export { DisplayFieldFileDocument };
 //# sourceMappingURL=display-field-file-document.d.ts.map

package/dist/esm/components/data-display/formatters/display-field-file-document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"display-field-file-document.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/formatters/display-field-file-document.tsx"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAK9B,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAA;AAiChF,iBAAS,wBAAwB,CAAC,EAChC,QAAQ,EACR,MAAM,EACN,SAAS,EACT,YAAmB,EACnB,QAAe,GAChB,EAAE,6BAA6B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAkEnD;AAID,OAAO,EAAE,wBAAwB,EAAE,CAAA"}
+{"version":3,"file":"display-field-file-document.d.ts","sourceRoot":"","sources":["../../../../../../src/components/data-display/formatters/display-field-file-document.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EASL,6BAA6B,EAC9B,MAAM,6BAA6B,CAAC;AAgDrC,iBAAS,wBAAwB,CAAC,EAChC,QAAQ,EACR,MAAM,EACN,UAAU,EACV,SAAS,EACT,YAAmB,EACnB,QAAe,EACf,YAAY,EACZ,OAAO,EACP,QAAQ,GACT,EAAE,6BAA6B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CA2G1D;AAID,OAAO,EAAE,wBAAwB,EAAE,CAAA"}

package/dist/esm/components/data-display/formatters/display-field-file-document.js

@@ -1,8 +1,23 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Text, useIconRegistry, StandardIconReference, IconSize, useI18n } from "@wildo-ai/saas-frontend-lib";
-import { FrontendComponentType } from "@wildo-ai/presets-components-models";
-import { formatFileSize } from "@wildo-ai/zod-decorators";
+/**
+ * DisplayFieldFileDocument Component
+ *
+ * Nature-specific display for document files (PDF, Office).
+ * - PDF: rendered by PDF.js behind the `PdfViewerLazy` boundary, so the pdf.js
+ *   payload is fetched only when a PDF is actually displayed. Replaces the previous
+ *   `<iframe>` on the browser's native viewer, which could not be styled to the
+ *   design system and dies under a strict `frame-src` CSP.
+ * - Office docs: file card with type-specific icon + download (no viewer exists, so
+ *   the display guard refuses THUMBNAIL/FULL for them upstream).
+ *
+ * Resolved via the component registry (LOW_LEVEL_DISPLAY_FIELD_FILE_DOCUMENT).
+ */
+import * as React from "react";
+import { Text, useIconRegistry, StandardIconReference, IconSize, useI18n, cn, Surface, Skeleton, } from '@wildo-ai/saas-frontend-lib';
+import { FrontendComponentType, SurfaceVariant } from "@wildo-ai/presets-components-models";
+import { formatFileSize, FileDisplayPresentation } from "@wildo-ai/zod-decorators";
+import { PdfViewerLazy } from "../pdf-viewer/pdf-viewer.lazy.js";
 // =============================================================================
 // HELPERS
 // =============================================================================
@@ -34,24 +49,77 @@ function getDocumentTypeLabel(mimeType, extension) {
         return extension?.toUpperCase() || 'Document';
     return extension?.toUpperCase() || 'Document';
 }
+function buildFreshFileUrl(url, refreshKey) {
+    if (!refreshKey) {
+        return url;
+    }
+    const [withoutHash, hash] = url.split('#');
+    const separator = withoutHash.includes('?') ? '&' : '?';
+    const versionedUrl = `${withoutHash}${separator}wildoFileUpdatedAt=${encodeURIComponent(refreshKey)}`;
+    return hash ? `${versionedUrl}#${hash}` : versionedUrl;
+}
 // =============================================================================
 // COMPONENT
 // =============================================================================
-function DisplayFieldFileDocument({ metadata, fileId, className, showDownload = true, showSize = true, }) {
+function DisplayFieldFileDocument({ metadata, fileId, refreshKey, className, showDownload = true, showSize = true, presentation, getBlob, serveUrl, }) {
     const { renderIcon } = useIconRegistry();
     const { tComponent, isReady } = useI18n({ component: FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_FILE_DOCUMENT });
+    // PDF bytes for the viewer. Fetched over the AUTHENTICATED serve route (authz
+    // inherits the parent resource's READ) rather than handed to pdf.js as a URL, so a
+    // protected document renders without exposing an unauthenticated fetch path.
+    const [pdfData, setPdfData] = React.useState(null);
+    const [pdfFetchFailed, setPdfFetchFailed] = React.useState(false);
     const documentUrl = metadata.url;
+    const freshDocumentUrl = documentUrl ? buildFreshFileUrl(documentUrl, refreshKey) : undefined;
     const isPdfDocument = isPdf(metadata.mimeType);
     const docIcon = getDocumentIconRef(metadata.mimeType);
     const docTypeLabel = getDocumentTypeLabel(metadata.mimeType, metadata.extension);
-    // PDF with URL — render embedded viewer
-    if (isPdfDocument && documentUrl) {
-        return (_jsxs("div", { className: `space-y-item ${className ?? ''}`, children: [_jsx("div", { className: "w-full max-w-2xl rounded-md overflow-hidden border bg-muted/20", children: _jsx("iframe", { src: documentUrl, title: metadata.filename, className: "w-full h-96 border-0", loading: "lazy" }) }), _jsxs("div", { className: "flex items-center gap-group text-xs text-muted-foreground", children: [_jsx("span", { "aria-hidden": "true", children: renderIcon(docIcon, { size: IconSize.SM }) }), _jsx("span", { className: "font-medium text-foreground truncate max-w-48", children: metadata.filename }), _jsx("span", { className: "uppercase", children: docTypeLabel }), showSize && _jsx("span", { children: formatFileSize(metadata.size) }), showDownload && (_jsx("a", { href: documentUrl, download: metadata.filename, className: "text-primary hover:underline ms-auto shrink-0", children: tComponent(FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_FILE_DOCUMENT, 'download') }))] })] }));
+    // The host only mounts this component for THUMBNAIL / FULL; treat an absent value
+    // as FULL so a direct (non-host) consumer still gets the whole document.
+    const firstPageOnly = presentation === FileDisplayPresentation.THUMBNAIL;
+    /**
+     * The FRESH url, not the bare one — the same cache-buster the download links below already use.
+     *
+     * This carried `wildoFileUpdatedAt` for free while the PDF rendered in an `<iframe src=…>`. Moving
+     * to PDF.js turned the render into an authenticated GET through `getBlob`, and the busting was left
+     * behind on `freshDocumentUrl`, which kept only the `<a href>` honest. `refreshKey` stayed in the
+     * effect's dependency array, so a regenerated file DID re-run the fetch — at a byte-identical URL,
+     * which the HTTP cache may answer from its stored copy (`fetchFileBlob` is a plain `axios.get` with
+     * no cache directive). The viewer could therefore show the previous revision of a file whose
+     * download link served the new one.
+     *
+     * `serveUrl` is deliberately NOT busted: it takes precedence, and a pre-signed serve URL can carry a
+     * signature that appending a query parameter would invalidate.
+     */
+    const fetchUrl = serveUrl ?? freshDocumentUrl;
+    React.useEffect(() => {
+        if (!isPdfDocument || !getBlob || !fetchUrl)
+            return;
+        let cancelled = false;
+        const controller = new AbortController();
+        setPdfFetchFailed(false);
+        getBlob(fetchUrl, { signal: controller.signal })
+            .then(blob => blob.arrayBuffer())
+            .then(buffer => { if (!cancelled)
+            setPdfData(buffer); })
+            .catch(() => { if (!cancelled)
+            setPdfFetchFailed(true); });
+        return () => { cancelled = true; controller.abort(); };
+    }, [isPdfDocument, getBlob, fetchUrl, refreshKey]);
+    if (!isReady)
+        return null;
+    // PDF — render through PDF.js. Falls through to the file card when the bytes
+    // cannot be fetched (no authed client, or the fetch failed): a card that can still
+    // be downloaded beats an empty viewer frame.
+    if (isPdfDocument && (pdfData || (getBlob && fetchUrl && !pdfFetchFailed))) {
+        return (_jsxs("div", { className: cn('space-y-item', className), children: [_jsx(Surface, { asChild: true, emitPolicyVars: false, variant: SurfaceVariant.INSET, children: _jsx("div", { className: cn('w-full rounded-md overflow-hidden border bg-muted/20 p-card-sm', firstPageOnly && 'max-w-48'), children: pdfData
+                            ? _jsx(PdfViewerLazy, { data: pdfData, firstPageOnly: firstPageOnly, ariaLabel: metadata.filename })
+                            : _jsx(Skeleton, { className: firstPageOnly ? 'h-40 w-full' : 'h-64 w-full', "aria-hidden": "true" }) }) }), _jsxs("div", { className: "flex items-center gap-group text-xs text-muted-foreground", children: [_jsx("span", { "aria-hidden": "true", children: renderIcon(docIcon, { size: IconSize.SM }) }), _jsx("span", { className: "font-medium text-foreground truncate max-w-48", children: metadata.filename }), _jsx("span", { className: "uppercase", children: docTypeLabel }), showSize && _jsx("span", { children: formatFileSize(metadata.size) }), showDownload && (_jsx("a", { href: freshDocumentUrl, download: metadata.filename, className: "text-primary hover:underline ms-auto shrink-0", children: tComponent(FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_FILE_DOCUMENT, 'download') }))] })] }));
     }
     // Non-PDF or no URL — enhanced file card with type-specific icon
-    return (_jsxs("div", { className: `flex items-center gap-group p-card-sm rounded-md border bg-muted/30 ${className ?? ''}`, children: [_jsx("span", { "aria-hidden": "true", children: renderIcon(docIcon, { size: IconSize.LG, className: "text-muted-foreground" }) }), _jsxs("div", { className: "flex-1 min-w-0", children: [_jsx(Text, { className: "font-medium truncate", children: metadata.filename }), _jsxs("div", { className: "flex items-center gap-group text-xs text-muted-foreground mt-0.5", children: [_jsx("span", { className: "uppercase", children: docTypeLabel }), showSize && _jsx("span", { children: formatFileSize(metadata.size) })] })] }), showDownload && documentUrl && (_jsx("a", { href: documentUrl, target: "_blank", rel: "noopener noreferrer", className: "text-primary hover:underline text-sm shrink-0", children: tComponent(FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_FILE_DOCUMENT, 'open_document') }))] }));
+    return (_jsx(Surface, { asChild: true, emitPolicyVars: false, variant: SurfaceVariant.INSET, children: _jsxs("div", { className: cn('flex items-center gap-group p-card-sm rounded-md border bg-muted/30', className), children: [_jsx("span", { "aria-hidden": "true", children: renderIcon(docIcon, { size: IconSize.LG, className: "text-muted-foreground" }) }), _jsxs("div", { className: "flex-1 min-w-0", children: [_jsx(Text, { className: "font-medium truncate", children: metadata.filename }), _jsxs("div", { className: "flex items-center gap-group text-xs text-muted-foreground mt-0.5", children: [_jsx("span", { className: "uppercase", children: docTypeLabel }), showSize && _jsx("span", { children: formatFileSize(metadata.size) })] })] }), showDownload && freshDocumentUrl && (_jsx("a", { href: freshDocumentUrl, target: "_blank", rel: "noopener noreferrer", className: "text-primary hover:underline text-sm shrink-0", children: tComponent(FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_FILE_DOCUMENT, 'open_document') }))] }) }));
 }
 ;
 DisplayFieldFileDocument.displayName = "DisplayFieldFileDocument";
 export { DisplayFieldFileDocument };
-//# sourceMappingURL=display-field-file-document.js.map
+//# sourceMappingURL=display-field-file-document.js.map