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

package/dist/esm/components/data-display/chromes/DisplayFieldChrome.js.map

@@ -1 +1 @@
-{"version":3,"file":"DisplayFieldChrome.js","sourceRoot":"","sources":["../../../../../../src/components/data-display/chromes/DisplayFieldChrome.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\"\n\n/**\n * DisplayFieldChrome — centralized chrome (label, description, tooltip) wrapper\n * for display fields.\n *\n * Parallel to FormFieldChrome but simplified for read-only display context:\n * - 5 modes: STACKED, INLINE, SETTINGS_ROW, COMPACT, HIDDEN (no RELAXED)\n * - No error, required, saveState, disabled, or autosave indicator props\n * - No FieldError rendering\n *\n * Chrome mode is resolved via a two-phase cascade:\n *   Phase 1 (DisplayField): field decorator → section default → display default → surface policy → STACKED\n *   Phase 2 (here): responsive viewport resolution via useUI()\n *\n * ## data-field safety net\n *\n * Every mode that renders a WRAPPER puts `data-field={name}` on it, so guidance\n * targeting and DOM queries can locate the field node regardless of what the\n * inner value component does with its own attributes.\n *\n * `HIDDEN` is the one exception, and it is not a gap: that mode's whole contract\n * is \"no chrome at all — bare value output\", so it returns `children` directly\n * with no element of its own to carry the attribute. A caller that needs the\n * field locatable in the DOM must therefore not use `HIDDEN`; `COMPACT` is the\n * mode that drops the label and KEEPS the wrapper. Measured 2026-09-18 in the\n * browser (Labs → Field Chrome Modes): COMPACT emits\n * `<div data-slot=\"field-chrome\" data-chrome-mode=\"compact\" data-field=…>` while\n * HIDDEN emits the bare value node. This paragraph previously said \"every\n * visible chrome mode … can ALWAYS locate\", which reads as a guarantee with no\n * exception and is the sentence a guidance author would rely on.\n */\n\nimport * as React from \"react\"\nimport { useMemo } from \"react\"\n\nimport { cn } from \"~wildo-frontend-lib/core/ui/cn\"\nimport {\n  Field,\n  FieldLabel,\n  FieldDescription,\n  FieldContent,\n  FieldTitle,\n  FieldVariants_Orientation,\n} from \"~wildo-frontend-lib/components/form/chromes/field\"\nimport { Tooltip, TooltipTrigger, TooltipContent } from \"~wildo-frontend-lib/components/overlays/floating/tooltip\"\nimport {\n  DisplayLabelStyle,\n  DisplayChromeMode,\n  ViewportBreakpoint,\n  type ResponsiveAware,\n} from \"@wildo-ai/zod-decorators\"\nimport type { ReactNode } from 'react'\nimport { useIconRegistry } from \"~wildo-frontend-lib/core/icons/useIconRegistry\"\nimport { StandardIconReference, IconSize } from \"~wildo-frontend-lib/core/icons/icon-registry.frontend.schemas\"\nimport { useI18n } from \"~wildo-frontend-lib/core/i18n/useI18n\"\nimport { FrontendComponentType, ButtonSize, type AutoLabelPlacement } from \"@wildo-ai/presets-components-models\"\nimport { useUI } from \"~wildo-frontend-lib/core/ui/useUI\"\nimport { Button, ButtonVariants_Variant } from \"~wildo-frontend-lib/components/actions/button\"\n\nexport interface DisplayFieldChromeProps {\n  mode?: ResponsiveAware<DisplayChromeMode>\n  label?: string\n  /** Label styling, orthogonal to the chrome mode's layout. See `DisplayLabelStyle`. */\n  labelStyle?: DisplayLabelStyle\n  description?: string\n  tooltip?: string\n  name?: string\n  labelPlacement?: AutoLabelPlacement\n  hideLabel?: boolean\n  hideDescription?: boolean\n  className?: string\n  children: ReactNode\n}\n\n\n// =============================================================================\n// VIEWPORT-AWARE MODE RESOLUTION\n// =============================================================================\n\n/**\n * Resolves a potentially responsive DisplayChromeMode to a single concrete mode\n * for the current viewport.\n *\n * Fallback chain: mode[currentBreakpoint] → mode[DESKTOP] → STACKED\n *\n * SETTINGS_ROW is not collapsed to STACKED on mobile: the row stacks its value\n * beneath the label itself (see the SETTINGS_ROW branch), mirroring\n * FormFieldChrome so a view→edit drill keeps the same geometry at every width.\n * The edit twin stopped collapsing because swapping the chrome's root element on a\n * breakpoint remounted the control (#1191); display follows so the two stay aligned.\n */\nfunction resolveEffectiveDisplayChromeMode(\n  chromeMode: ResponsiveAware<DisplayChromeMode> | undefined,\n  currentBreakpoint: ViewportBreakpoint,\n): DisplayChromeMode {\n  if (chromeMode === undefined || chromeMode === null) {\n    return DisplayChromeMode.STACKED;\n  }\n\n  return typeof chromeMode === \"string\"\n    ? chromeMode\n    : (chromeMode[currentBreakpoint] ?? chromeMode[ViewportBreakpoint.DESKTOP] ?? DisplayChromeMode.STACKED);\n}\n\n// =============================================================================\n// TOOLTIP ICON HELPER\n// =============================================================================\n\nfunction DisplayTooltipIcon({ text }: { text: string }): React.JSX.Element | null {\n  const { renderIcon } = useIconRegistry();\n  const { tComponent, isReady } = useI18n({\n    component: FrontendComponentType.LOW_LEVEL_FORM_FIELD,\n  });\n  if (!isReady) return null;\n  return (\n    <Tooltip>\n      <TooltipTrigger asChild>\n        <Button\n          type=\"button\"\n          variant={ButtonVariants_Variant.GHOST}\n          size={ButtonSize.ICON_SM}\n          className=\"ms-1 rounded-full\"\n          aria-label={tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'moreInformation')}\n          tabIndex={-1}\n        >\n          {renderIcon(StandardIconReference.INFO, { size: IconSize.XS })}\n        </Button>\n      </TooltipTrigger>\n      <TooltipContent>{text}</TooltipContent>\n    </Tooltip>\n  );\n}\n\n// =============================================================================\n// COMPONENT\n// =============================================================================\n\nfunction DisplayFieldChrome({\n  mode,\n  label,\n  labelStyle,\n  description,\n  tooltip,\n  name,\n  labelPlacement,\n  hideLabel,\n  hideDescription,\n  className,\n  children,\n}: DisplayFieldChromeProps): React.JSX.Element {\n  const { currentBreakpoint, isMobile } = useUI();\n\n  const effectiveMode = useMemo(\n    () => resolveEffectiveDisplayChromeMode(mode, currentBreakpoint),\n    [mode, currentBreakpoint],\n  );\n\n  /*\n   * INLINE mode defaults to label-FIRST ('start': \"Metric — value\"), not the suffix 'inline'\n   * placement — a labelled fact row reads label-first, and the suffix style stays reachable by\n   * passing `labelPlacement: 'inline'` explicitly. Safe to (re)decide 2026-08-31: until the\n   * surface-policy precedence fix landed the same day, INLINE mode was unreachable from\n   * decorators on any surface declaring an auto placement, so no consumer saw either default.\n   */\n  const effectiveLabelPlacement = labelPlacement ?? (effectiveMode === DisplayChromeMode.INLINE ? 'start' : 'top');\n  const showLabel = !hideLabel && !!label && effectiveLabelPlacement !== 'hidden' && effectiveMode !== DisplayChromeMode.COMPACT && effectiveMode !== DisplayChromeMode.HIDDEN;\n  const showDescription = !hideDescription && !!description && effectiveMode !== DisplayChromeMode.COMPACT && effectiveMode !== DisplayChromeMode.HIDDEN;\n  const hiddenLabel = !hideLabel && !!label && effectiveLabelPlacement === 'hidden'\n    ? <span className=\"sr-only\">{label}</span>\n    : null;\n\n  // ── HIDDEN mode: pass through ──\n  if (effectiveMode === DisplayChromeMode.HIDDEN) {\n    return <>{hiddenLabel}{children}</>;\n  }\n\n  // ── COMPACT mode: bare value, no chrome ──\n  if (effectiveMode === DisplayChromeMode.COMPACT) {\n    return (\n      <div\n        data-slot=\"field-chrome\"\n        data-chrome-mode=\"compact\"\n        data-label-placement={effectiveLabelPlacement}\n        data-field={name}\n        data-testid={name ? `field-${name}` : undefined}\n        data-guidance-field={name}\n        className={className}\n      >\n        {hiddenLabel}\n        {children}\n      </div>\n    );\n  }\n\n  // ── INLINE mode: a snug \"Label: value\" fact row ──\n  // The label reads as a small bold prefix with a colon, the value directly beside it — one\n  // labelled fact per line (\"Metric: within one day\"), wrapping when the value is long. This is\n  // deliberately NOT the horizontal Field layout (label left, value pinned to the inline-end\n  // edge): a fact row is read as one sentence, not scanned as a settings table.\n  if (effectiveMode === DisplayChromeMode.INLINE) {\n    return (\n      <div\n        data-slot=\"field-chrome\"\n        data-chrome-mode=\"inline\"\n        data-label-placement={effectiveLabelPlacement}\n        data-field={name}\n        data-testid={name ? `field-${name}` : undefined}\n        data-guidance-field={name}\n        className={cn(\"flex flex-wrap items-baseline gap-x-1.5 gap-y-element-xs\", className)}\n      >\n        {hiddenLabel}\n        {showLabel && (\n          <span className=\"shrink-0 text-xs font-semibold text-foreground\">\n            {label}:\n            {tooltip && <DisplayTooltipIcon text={tooltip} />}\n          </span>\n        )}\n        <div className=\"min-w-0\">{children}</div>\n        {showDescription && <FieldDescription className=\"w-full\">{description}</FieldDescription>}\n      </div>\n    );\n  }\n\n  // ── SETTINGS_ROW mode: a self-contained settings list-item (read mode) ──\n  // Read-mode counterpart of the form's SETTINGS_ROW (FormFieldChrome) — IDENTICAL\n  // row geometry (same `py-group` rhythm, same hairline `border-b … last:border-b-0`\n  // divider, same fixed-width inline-end column) so a view→edit drill keeps the\n  // value/control in the same place and a read-only settings list reads exactly\n  // like its editable twin. Values right-align to the row's inline-end edge\n  // (`items-end text-end`) so badges / ✓✗ booleans / text all share one edge\n  // instead of the previous ragged 200–320px box. See FormFieldChrome for the\n  // full rationale.\n  //\n  // On a MOBILE viewport the row keeps its shell and stacks the value beneath the\n  // label (the same element structure, only classes change), mirroring the edit twin.\n  if (effectiveMode === DisplayChromeMode.SETTINGS_ROW) {\n    return (\n      <div\n        data-slot=\"field-chrome\"\n        data-chrome-mode=\"settings_row\"\n        data-settings-row-layout={isMobile ? \"stacked\" : undefined}\n        data-label-placement={effectiveLabelPlacement}\n        data-field={name}\n        data-testid={name ? `field-${name}` : undefined}\n        data-guidance-field={name}\n        className={cn(\n          // Row rhythm (T4): a compact min-height + a subtle hover affordance so a\n          // settings list reads as scannable rows, not a flat stack. Vertical\n          // alignment is CONTENT-AWARE: a single-line row (no description) CENTERS\n          // its label + control in the min-height (`items-center`) so there is no\n          // dead space below the label — this is what made the rows read too tall;\n          // a row WITH a description top-aligns (`items-start`) so the control lines\n          // up with the label's first line and the description flows beneath.\n          // The row OWNS its inline padding (`px-card`): inside a CARD settings\n          // list the body is padding-less, so the row's `border-b` runs full-bleed\n          // to the card edge while `px-card` keeps the text inset; in a flat host\n          // the same `px-card` gives consistent inset. Block padding stays tight\n          // (`py-card-sm`) to keep rows compact.\n          \"flex min-h-10 px-card py-card-sm border-b border-border last:border-b-0 hover:bg-muted/50 transition-colors\",\n          isMobile\n            ? \"flex-col gap-element-xs\"\n            : cn(\"flex-row gap-section\", showDescription ? \"items-start\" : \"items-center\"),\n          className,\n        )}\n      >\n        {/* Inline-start: label + description */}\n        <div className={cn(\"flex min-w-0 flex-col gap-element-xs\", !isMobile && \"flex-1\")}>\n          {hiddenLabel}\n          {showLabel && (\n            <FieldLabel>\n              {label}\n              {tooltip && <DisplayTooltipIcon text={tooltip} />}\n            </FieldLabel>\n          )}\n          {showDescription && <FieldDescription>{description}</FieldDescription>}\n        </div>\n        {/* Inline-end: value, right-pinned to the row's inline-end edge. `w-72` is\n            the shared target width; `shrink` + `min-w-0` (NOT `shrink-0`) keeps the\n            column compressible so the row can never outgrow a padded CARD fieldset\n            and clip against its border — mirrors the edit-mode FormFieldChrome twin. */}\n        <div\n          className={cn(\n            \"flex min-w-0 flex-col gap-element-xs\",\n            isMobile ? \"w-full items-start text-start\" : \"w-72 max-w-[55%] shrink items-end text-end\",\n          )}\n        >\n          {children}\n        </div>\n      </div>\n    );\n  }\n\n  // ── Horizontal label modes ──\n  if (effectiveLabelPlacement === 'start' || effectiveLabelPlacement === 'inline') {\n    const isInlinePlacement = effectiveLabelPlacement === 'inline';\n    return (\n      <Field\n        orientation={FieldVariants_Orientation.HORIZONTAL}\n        data-slot=\"field-chrome\"\n        data-chrome-mode=\"inline\"\n        data-label-placement={effectiveLabelPlacement}\n        data-field={name}\n        data-testid={name ? `field-${name}` : undefined}\n        data-guidance-field={name}\n        className={cn(isInlinePlacement && \"flex-row-reverse\", className)}\n      >\n        {hiddenLabel}\n        <FieldContent>\n          {showLabel && (\n            <FieldTitle>\n              <FieldLabel>\n                {label}\n                {tooltip && <DisplayTooltipIcon text={tooltip} />}\n              </FieldLabel>\n            </FieldTitle>\n          )}\n          {showDescription && <FieldDescription>{description}</FieldDescription>}\n        </FieldContent>\n        {children}\n      </Field>\n    );\n  }\n\n  // ── STACKED mode (default): label above, value, description below ──\n  return (\n    <Field\n      orientation={FieldVariants_Orientation.VERTICAL}\n      data-slot=\"field-chrome\"\n      data-chrome-mode=\"stacked\"\n      data-label-placement={effectiveLabelPlacement}\n      data-field={name}\n      data-testid={name ? `field-${name}` : undefined}\n      data-guidance-field={name}\n      className={className}\n    >\n      {hiddenLabel}\n      {showLabel && (\n        labelStyle === DisplayLabelStyle.TITLE ? (\n          /*\n           * TITLE label style: the label reads as a SMALL TITLE above its content — for a field\n           * acting as a mini-section inside a prose flow (\"Who suffers it\" above its answer),\n           * where the ordinary muted label would not carry the structure.\n           */\n          <div className=\"pt-item-xs text-xs font-semibold uppercase tracking-wide text-muted-foreground\">\n            {label}\n            {tooltip && <DisplayTooltipIcon text={tooltip} />}\n          </div>\n        ) : (\n          <FieldLabel>\n            {label}\n            {tooltip && <DisplayTooltipIcon text={tooltip} />}\n          </FieldLabel>\n        )\n      )}\n      {children}\n      {showDescription && <FieldDescription>{description}</FieldDescription>}\n    </Field>\n  );\n}\n\n;(DisplayFieldChrome as typeof DisplayFieldChrome & { displayName: string }).displayName = \"DisplayFieldChrome\"\n\nexport { DisplayFieldChrome, resolveEffectiveDisplayChromeMode }\n"]}
+{"version":3,"file":"DisplayFieldChrome.js","sourceRoot":"","sources":["../../../../../../src/components/data-display/chromes/DisplayFieldChrome.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\"\n\n/**\n * DisplayFieldChrome — centralized chrome (label, description, tooltip) wrapper\n * for display fields.\n *\n * Parallel to FormFieldChrome but simplified for read-only display context:\n * - 5 modes: STACKED, INLINE, SETTINGS_ROW, COMPACT, HIDDEN (no RELAXED)\n * - No error, required, saveState, disabled, or autosave indicator props\n * - No FieldError rendering\n *\n * Chrome mode is resolved via a two-phase cascade:\n *   Phase 1 (DisplayField): field decorator → section default → display default → surface policy → STACKED\n *   Phase 2 (here): responsive viewport resolution via useUI()\n *\n * ## data-field safety net\n *\n * Every mode that renders a WRAPPER puts `data-field={name}` on it, so guidance\n * targeting and DOM queries can locate the field node regardless of what the\n * inner value component does with its own attributes.\n *\n * `HIDDEN` is the one exception, and it is not a gap: that mode's whole contract\n * is \"no chrome at all — bare value output\", so it returns `children` directly\n * with no element of its own to carry the attribute. A caller that needs the\n * field locatable in the DOM must therefore not use `HIDDEN`; `COMPACT` is the\n * mode that drops the label and KEEPS the wrapper. Measured 2026-09-18 in the\n * browser (Labs → Field Chrome Modes): COMPACT emits\n * `<div data-slot=\"field-chrome\" data-chrome-mode=\"compact\" data-field=…>` while\n * HIDDEN emits the bare value node. This paragraph previously said \"every\n * visible chrome mode … can ALWAYS locate\", which reads as a guarantee with no\n * exception and is the sentence a guidance author would rely on.\n */\n\nimport * as React from \"react\"\nimport { useMemo } from \"react\"\n\nimport { cn } from \"~wildo-frontend-lib/core/ui/cn\"\nimport {\n  Field,\n  FieldLabel,\n  FieldDescription,\n  FieldContent,\n  FieldTitle,\n  FieldVariants_Orientation,\n} from \"~wildo-frontend-lib/components/form/chromes/field\"\nimport { Tooltip, TooltipTrigger, TooltipContent } from \"~wildo-frontend-lib/components/overlays/floating/tooltip\"\nimport {\n  DisplayLabelStyle,\n  DisplayChromeMode,\n  ViewportBreakpoint,\n  type ResponsiveAware,\n} from \"@wildo-ai/zod-decorators\"\nimport type { ReactNode } from 'react'\nimport { useIconRegistry } from \"~wildo-frontend-lib/core/icons/useIconRegistry\"\nimport { StandardIconReference, IconSize } from \"~wildo-frontend-lib/core/icons/icon-registry.frontend.schemas\"\nimport { useI18n } from \"~wildo-frontend-lib/core/i18n/useI18n\"\nimport { FrontendComponentType, ButtonSize, TypographyVariant, UIBehavior, type AutoLabelPlacement } from \"@wildo-ai/presets-components-models\"\nimport { useUI } from \"~wildo-frontend-lib/core/ui/useUI\"\nimport { Button, ButtonVariants_Variant } from \"~wildo-frontend-lib/components/actions/button\"\nimport { DisplayFieldProvenanceNote } from \"~wildo-frontend-lib/components/data-display/external-data-provenance/DisplayFieldProvenanceNote\"\nimport type { DisplayFieldProvenance } from \"~wildo-frontend-lib/components/data-display/external-data-provenance/external-data-provenance.frontend\"\n\nexport interface DisplayFieldChromeProps {\n  mode?: ResponsiveAware<DisplayChromeMode>\n  label?: string\n  /** Label styling, orthogonal to the chrome mode's layout. See `DisplayLabelStyle`. */\n  labelStyle?: DisplayLabelStyle\n  description?: string\n  tooltip?: string\n  name?: string\n  labelPlacement?: AutoLabelPlacement\n  hideLabel?: boolean\n  hideDescription?: boolean\n  /**\n   * Where the value came from, for a field an external-data pipeline writes (#1997): \"Synced from Odoo · as of\n   * 12 minutes ago\". The chrome places it beneath the value in the description voice, so it reads as a note about the\n   * value rather than as a second label; `DisplayFieldProvenanceNote` composes the words from the i18n tree.\n   *\n   * Shown in every mode that renders chrome and suppressed in COMPACT and HIDDEN, which are the bare-value modes: a\n   * table cell or a card has no room for a provenance note, and the cue belongs where one record is read.\n   */\n  provenance?: DisplayFieldProvenance\n  className?: string\n  children: ReactNode\n}\n\n\n// =============================================================================\n// VIEWPORT-AWARE MODE RESOLUTION\n// =============================================================================\n\n/**\n * Resolves a potentially responsive DisplayChromeMode to a single concrete mode\n * for the current viewport.\n *\n * Fallback chain: mode[currentBreakpoint] → mode[DESKTOP] → STACKED\n *\n * SETTINGS_ROW is not collapsed to STACKED on mobile: the row stacks its value\n * beneath the label itself (see the SETTINGS_ROW branch), mirroring\n * FormFieldChrome so a view→edit drill keeps the same geometry at every width.\n * The edit twin stopped collapsing because swapping the chrome's root element on a\n * breakpoint remounted the control (#1191); display follows so the two stay aligned.\n */\nfunction resolveEffectiveDisplayChromeMode(\n  chromeMode: ResponsiveAware<DisplayChromeMode> | undefined,\n  currentBreakpoint: ViewportBreakpoint,\n): DisplayChromeMode {\n  if (chromeMode === undefined || chromeMode === null) {\n    return DisplayChromeMode.STACKED;\n  }\n\n  return typeof chromeMode === \"string\"\n    ? chromeMode\n    : (chromeMode[currentBreakpoint] ?? chromeMode[ViewportBreakpoint.DESKTOP] ?? DisplayChromeMode.STACKED);\n}\n\n// =============================================================================\n// TOOLTIP ICON HELPER\n// =============================================================================\n\nfunction DisplayTooltipIcon({ text }: { text: string }): React.JSX.Element | null {\n  const { renderIcon } = useIconRegistry();\n  const { tComponent, isReady } = useI18n({\n    component: FrontendComponentType.LOW_LEVEL_FORM_FIELD,\n  });\n  if (!isReady) return null;\n  return (\n    <Tooltip>\n      <TooltipTrigger asChild>\n        <Button\n          type=\"button\"\n          variant={ButtonVariants_Variant.GHOST}\n          size={ButtonSize.ICON_SM}\n          className=\"ms-1 rounded-full\"\n          aria-label={tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'moreInformation')}\n          tabIndex={-1}\n        >\n          {renderIcon(StandardIconReference.INFO, { size: IconSize.XS })}\n        </Button>\n      </TooltipTrigger>\n      <TooltipContent>{text}</TooltipContent>\n    </Tooltip>\n  );\n}\n\n// =============================================================================\n// COMPONENT\n// =============================================================================\n\nfunction DisplayFieldChrome({\n  mode,\n  label,\n  labelStyle,\n  description,\n  tooltip,\n  name,\n  labelPlacement,\n  hideLabel,\n  hideDescription,\n  provenance,\n  className,\n  children,\n}: DisplayFieldChromeProps): React.JSX.Element {\n  const { currentBreakpoint, isMobile, getRecipe } = useUI();\n  /*\n   * A READ label is a TERM: it names the value beneath it and must not compete with it. The form's\n   * `FieldLabel` is set in the foreground at the value's own size and weight, which is right above an\n   * input (the label is what you read first) and wrong above a value, where it made every stacked\n   * read-only field one undifferentiated run of text — measured on the workbench's Roadmap and Build\n   * plan pages, where \"Sequence\", \"Theme\" and \"Objective\" could not be told from their answers.\n   *\n   * The DESCRIPTION recipe is the one the description list's `DescriptionTerm` already uses for the\n   * same job, so a stacked field and a description-list row name their values in one voice.\n   */\n  const termRecipe = getRecipe(UIBehavior.TYPOGRAPHY, TypographyVariant.DESCRIPTION);\n  /* The TITLE label style's voice: the theme's small label above a section, not a class list of its own. */\n  const eyebrowRecipe = getRecipe(UIBehavior.TYPOGRAPHY, TypographyVariant.EYEBROW);\n\n  const effectiveMode = useMemo(\n    () => resolveEffectiveDisplayChromeMode(mode, currentBreakpoint),\n    [mode, currentBreakpoint],\n  );\n\n  /*\n   * INLINE mode defaults to label-FIRST ('start': \"Metric — value\"), not the suffix 'inline'\n   * placement — a labelled fact row reads label-first, and the suffix style stays reachable by\n   * passing `labelPlacement: 'inline'` explicitly. Safe to (re)decide 2026-08-31: until the\n   * surface-policy precedence fix landed the same day, INLINE mode was unreachable from\n   * decorators on any surface declaring an auto placement, so no consumer saw either default.\n   */\n  const effectiveLabelPlacement = labelPlacement ?? (effectiveMode === DisplayChromeMode.INLINE ? 'start' : 'top');\n  const showLabel = !hideLabel && !!label && effectiveLabelPlacement !== 'hidden' && effectiveMode !== DisplayChromeMode.COMPACT && effectiveMode !== DisplayChromeMode.HIDDEN;\n  const showDescription = !hideDescription && !!description && effectiveMode !== DisplayChromeMode.COMPACT && effectiveMode !== DisplayChromeMode.HIDDEN;\n  // No mode test here on purpose: the COMPACT and HIDDEN branches below return before any note is placed, so the\n  // bare-value modes carry none by construction (pinned in display-field-provenance-chrome.test.tsx).\n  const showProvenance = !!provenance;\n  const provenanceNote = showProvenance\n    ? <DisplayFieldProvenanceNote provenance={provenance} />\n    : null;\n  const hiddenLabel = !hideLabel && !!label && effectiveLabelPlacement === 'hidden'\n    ? <span className=\"sr-only\">{label}</span>\n    : null;\n\n  // ── HIDDEN mode: pass through ──\n  if (effectiveMode === DisplayChromeMode.HIDDEN) {\n    return <>{hiddenLabel}{children}</>;\n  }\n\n  // ── COMPACT mode: bare value, no chrome ──\n  if (effectiveMode === DisplayChromeMode.COMPACT) {\n    return (\n      <div\n        data-slot=\"field-chrome\"\n        data-chrome-mode=\"compact\"\n        data-label-placement={effectiveLabelPlacement}\n        data-field={name}\n        data-testid={name ? `field-${name}` : undefined}\n        data-guidance-field={name}\n        className={className}\n      >\n        {hiddenLabel}\n        {children}\n      </div>\n    );\n  }\n\n  // ── INLINE mode: a snug \"Label: value\" fact row ──\n  // The label reads as a prefix with a colon, the value directly beside it — one labelled fact per\n  // line (\"Metric: within one day\"), wrapping when the value is long. This is deliberately NOT the\n  // horizontal Field layout (label left, value pinned to the inline-end edge): a fact row is read as\n  // one sentence, not scanned as a settings table.\n  //\n  // The prefix is the same muted TERM as a stacked label (since 2026-09-25). It was a small bold\n  // foreground prefix, chosen while stacked labels were foreground too; once those became terms, an\n  // entry mixing the two modes named its facts in two voices — \"Target window:\" dark and bold\n  // beneath a muted \"Objective\" — which is the inconsistency a reader sees before reading anything.\n  if (effectiveMode === DisplayChromeMode.INLINE) {\n    return (\n      <div\n        data-slot=\"field-chrome\"\n        data-chrome-mode=\"inline\"\n        data-label-placement={effectiveLabelPlacement}\n        data-field={name}\n        data-testid={name ? `field-${name}` : undefined}\n        data-guidance-field={name}\n        className={cn(\"flex flex-wrap items-baseline gap-x-1.5 gap-y-element-xs\", className)}\n      >\n        {hiddenLabel}\n        {showLabel && (\n          <span className={cn(\"shrink-0\", termRecipe.base)}>\n            {label}:\n            {tooltip && <DisplayTooltipIcon text={tooltip} />}\n          </span>\n        )}\n        <div className=\"min-w-0\">{children}</div>\n        {showDescription && <FieldDescription className=\"w-full\">{description}</FieldDescription>}\n        {showProvenance && <DisplayFieldProvenanceNote provenance={provenance} className=\"w-full\" />}\n      </div>\n    );\n  }\n\n  // ── SETTINGS_ROW mode: a self-contained settings list-item (read mode) ──\n  // Read-mode counterpart of the form's SETTINGS_ROW (FormFieldChrome) — IDENTICAL\n  // row geometry (same `py-group` rhythm, same hairline `border-b … last:border-b-0`\n  // divider, same fixed-width inline-end column) so a view→edit drill keeps the\n  // value/control in the same place and a read-only settings list reads exactly\n  // like its editable twin. Values right-align to the row's inline-end edge\n  // (`items-end text-end`) so badges / ✓✗ booleans / text all share one edge\n  // instead of the previous ragged 200–320px box. See FormFieldChrome for the\n  // full rationale.\n  //\n  // On a MOBILE viewport the row keeps its shell and stacks the value beneath the\n  // label (the same element structure, only classes change), mirroring the edit twin.\n  if (effectiveMode === DisplayChromeMode.SETTINGS_ROW) {\n    return (\n      <div\n        data-slot=\"field-chrome\"\n        data-chrome-mode=\"settings_row\"\n        data-settings-row-layout={isMobile ? \"stacked\" : undefined}\n        data-label-placement={effectiveLabelPlacement}\n        data-field={name}\n        data-testid={name ? `field-${name}` : undefined}\n        data-guidance-field={name}\n        className={cn(\n          // Row rhythm (T4): a compact min-height + a subtle hover affordance so a\n          // settings list reads as scannable rows, not a flat stack. Vertical\n          // alignment is CONTENT-AWARE: a single-line row (no description) CENTERS\n          // its label + control in the min-height (`items-center`) so there is no\n          // dead space below the label — this is what made the rows read too tall;\n          // a row WITH a description top-aligns (`items-start`) so the control lines\n          // up with the label's first line and the description flows beneath.\n          // The row OWNS its inline padding (`px-card`): inside a CARD settings\n          // list the body is padding-less, so the row's `border-b` runs full-bleed\n          // to the card edge while `px-card` keeps the text inset; in a flat host\n          // the same `px-card` gives consistent inset. Block padding stays tight\n          // (`py-card-sm`) to keep rows compact.\n          \"flex min-h-10 px-card py-card-sm border-b border-border last:border-b-0 hover:bg-muted/50 transition-colors\",\n          isMobile\n            ? \"flex-col gap-element-xs\"\n            : cn(\"flex-row gap-section\", showDescription ? \"items-start\" : \"items-center\"),\n          className,\n        )}\n      >\n        {/* Inline-start: label + description. The label stays the FORM label here, deliberately not\n            the muted term the other read modes use: a settings row mirrors its editable twin, where\n            the label is the setting's name and reads first, so a view→edit drill keeps its voice. */}\n        <div className={cn(\"flex min-w-0 flex-col gap-element-xs\", !isMobile && \"flex-1\")}>\n          {hiddenLabel}\n          {showLabel && (\n            <FieldLabel>\n              {label}\n              {tooltip && <DisplayTooltipIcon text={tooltip} />}\n            </FieldLabel>\n          )}\n          {showDescription && <FieldDescription>{description}</FieldDescription>}\n        </div>\n        {/* Inline-end: value, right-pinned to the row's inline-end edge. `w-72` is\n            the shared target width; `shrink` + `min-w-0` (NOT `shrink-0`) keeps the\n            column compressible so the row can never outgrow a padded CARD fieldset\n            and clip against its border — mirrors the edit-mode FormFieldChrome twin. */}\n        <div\n          className={cn(\n            \"flex min-w-0 flex-col gap-element-xs\",\n            isMobile ? \"w-full items-start text-start\" : \"w-72 max-w-[55%] shrink items-end text-end\",\n          )}\n        >\n          {children}\n          {provenanceNote}\n        </div>\n      </div>\n    );\n  }\n\n  // ── Horizontal label modes ──\n  if (effectiveLabelPlacement === 'start' || effectiveLabelPlacement === 'inline') {\n    const isInlinePlacement = effectiveLabelPlacement === 'inline';\n    return (\n      <Field\n        orientation={FieldVariants_Orientation.HORIZONTAL}\n        data-slot=\"field-chrome\"\n        data-chrome-mode=\"inline\"\n        data-label-placement={effectiveLabelPlacement}\n        data-field={name}\n        data-testid={name ? `field-${name}` : undefined}\n        data-guidance-field={name}\n        className={cn(isInlinePlacement && \"flex-row-reverse\", className)}\n      >\n        {hiddenLabel}\n        <FieldContent>\n          {showLabel && (\n            <FieldTitle>\n              {/* The same muted TERM as the stacked and inline labels — one voice for naming a value. */}\n              <FieldLabel className={termRecipe.base}>\n                {label}\n                {tooltip && <DisplayTooltipIcon text={tooltip} />}\n              </FieldLabel>\n            </FieldTitle>\n          )}\n          {showDescription && <FieldDescription>{description}</FieldDescription>}\n          {provenanceNote}\n        </FieldContent>\n        {children}\n      </Field>\n    );\n  }\n\n  // ── STACKED mode (default): label above, value, description below ──\n  return (\n    <Field\n      orientation={FieldVariants_Orientation.VERTICAL}\n      data-slot=\"field-chrome\"\n      data-chrome-mode=\"stacked\"\n      data-label-placement={effectiveLabelPlacement}\n      data-field={name}\n      data-testid={name ? `field-${name}` : undefined}\n      data-guidance-field={name}\n      className={className}\n    >\n      {hiddenLabel}\n      {showLabel && (\n        labelStyle === DisplayLabelStyle.TITLE ? (\n          /*\n           * TITLE label style: the label reads as a SMALL TITLE above its content — for a field\n           * acting as a mini-section inside a prose flow (\"Who suffers it\" above its answer),\n           * where the ordinary muted label would not carry the structure.\n           */\n          <div className={cn(\"pt-item-xs\", eyebrowRecipe.base)}>\n            {label}\n            {tooltip && <DisplayTooltipIcon text={tooltip} />}\n          </div>\n        ) : (\n          <FieldLabel className={termRecipe.base}>\n            {label}\n            {tooltip && <DisplayTooltipIcon text={tooltip} />}\n          </FieldLabel>\n        )\n      )}\n      {children}\n      {showDescription && <FieldDescription>{description}</FieldDescription>}\n      {provenanceNote}\n    </Field>\n  );\n}\n\n;(DisplayFieldChrome as typeof DisplayFieldChrome & { displayName: string }).displayName = \"DisplayFieldChrome\"\n\nexport { DisplayFieldChrome, resolveEffectiveDisplayChromeMode }\n"]}

package/dist/esm/components/data-display/display-field-resolved-props.d.ts

@@ -11,6 +11,7 @@ import type { FieldSchemaType, FileFieldEndpoints, DisplayFieldComponent as Disp
 import type { DisplayChromeMode, DisplayLabelStyle, ResponsiveAware } from '@wildo-ai/zod-decorators';
 import type { AutoEmptyValue, AutoLabelPlacement } from '@wildo-ai/presets-components-models';
 import type { DisplayResourceLinkTrail } from './display-resource-link-trail';
+import type { DisplayFieldProvenance } from './external-data-provenance/external-data-provenance.frontend';
 export interface DisplayFieldResolvedProps {
     /** Resolved Zod schema — gate guarantees this is defined. */
     schema: z.ZodTypeAny;
@@ -26,6 +27,11 @@ export interface DisplayFieldResolvedProps {
     description?: string;
     /** Resolved tooltip from props or context. */
     tooltip?: string;
+    /**
+     * The provenance of a field an external-data pipeline writes (#1997) — the instance and the last completed pass,
+     * resolved by the gate; absent for every other field. The chrome places it and suppresses it in its bare-value modes.
+     */
+    provenance?: DisplayFieldProvenance;
     /** Resolved enum labels from props or context. */
     enumLabels?: Record<string, string>;
     /** Display component override from decorator. */

package/dist/esm/components/data-display/display-field-resolved-props.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"display-field-resolved-props.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/display-field-resolved-props.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,qBAAqB,IAAI,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACxI,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACtG,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAE9E,MAAM,WAAW,yBAAyB;IACxC,6DAA6D;IAC7D,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IACrB,8DAA8D;IAC9D,UAAU,EAAE,eAAe,CAAC;IAC5B,8DAA8D;IAC9D,KAAK,EAAE,OAAO,CAAC;IACf,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;IAC7C,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC;6GACyG;IACzG,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAC7C;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,KAAK,KAAK,CAAC,SAAS,CAAC;IAC7E,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,qCAAqC;IACrC,eAAe,EAAE,OAAO,CAAC;IACzB,mGAAmG;IACnG,kBAAkB,CAAC,EAAE,eAAe,CAAC,iBAAiB,CAAC,CAAC;IACxD,qEAAqE;IACrE,sBAAsB,CAAC,EAAE,kBAAkB,CAAC;IAC5C,8FAA8F;IAC9F,kBAAkB,CAAC,EAAE,iBAAiB,CAAC;IACvC,yDAAyD;IACzD,kBAAkB,CAAC,EAAE,cAAc,CAAC;IACpC,yDAAyD;IACzD,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CACxD"}
+{"version":3,"file":"display-field-resolved-props.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/display-field-resolved-props.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,qBAAqB,IAAI,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACxI,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACtG,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8DAA8D,CAAC;AAE3G,MAAM,WAAW,yBAAyB;IACxC,6DAA6D;IAC7D,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IACrB,8DAA8D;IAC9D,UAAU,EAAE,eAAe,CAAC;IAC5B,8DAA8D;IAC9D,KAAK,EAAE,OAAO,CAAC;IACf,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,UAAU,CAAC,EAAE,sBAAsB,CAAC;IACpC,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;IAC7C,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC;6GACyG;IACzG,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAC7C;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,KAAK,KAAK,CAAC,SAAS,CAAC;IAC7E,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,qCAAqC;IACrC,eAAe,EAAE,OAAO,CAAC;IACzB,mGAAmG;IACnG,kBAAkB,CAAC,EAAE,eAAe,CAAC,iBAAiB,CAAC,CAAC;IACxD,qEAAqE;IACrE,sBAAsB,CAAC,EAAE,kBAAkB,CAAC;IAC5C,8FAA8F;IAC9F,kBAAkB,CAAC,EAAE,iBAAiB,CAAC;IACvC,yDAAyD;IACzD,kBAAkB,CAAC,EAAE,cAAc,CAAC;IACpC,yDAAyD;IACzD,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CACxD"}

package/dist/esm/components/data-display/display-field-resolved-props.js.map

@@ -1 +1 @@
-{"version":3,"file":"display-field-resolved-props.js","sourceRoot":"","sources":["../../../../../src/components/data-display/display-field-resolved-props.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG","sourcesContent":["/**\n * Shared resolved props interface for DisplayFieldReadOnly and DisplayFieldEditable.\n *\n * These props are resolved by the DisplayField gate component from explicit props\n * and DisplayTemplateContext, then passed to the appropriate child component.\n * All context resolution happens in the gate — children receive concrete values.\n */\n\nimport type React from 'react';\nimport type { z } from 'zod';\nimport type { FieldSchemaType, FileFieldEndpoints, DisplayFieldComponent as DisplayFieldComponentEnum } from '@wildo-ai/zod-decorators';\nimport type { DisplayChromeMode, DisplayLabelStyle, ResponsiveAware } from '@wildo-ai/zod-decorators';\nimport type { AutoEmptyValue, AutoLabelPlacement } from '@wildo-ai/presets-components-models';\nimport type { DisplayResourceLinkTrail } from './display-resource-link-trail';\n\nexport interface DisplayFieldResolvedProps {\n  /** Resolved Zod schema — gate guarantees this is defined. */\n  schema: z.ZodTypeAny;\n  /** Resolved schema type — gate guarantees this is defined. */\n  schemaType: FieldSchemaType;\n  /** Field value — may be undefined for null/missing fields. */\n  value: unknown;\n  /** Fully-qualified field name (with pathPrefix applied). */\n  fieldName?: string;\n  /** Resolved label from props or context. */\n  label?: string;\n  /** Resolved description from props or context. */\n  description?: string;\n  /** Resolved tooltip from props or context. */\n  tooltip?: string;\n  /** Resolved enum labels from props or context. */\n  enumLabels?: Record<string, string>;\n  /** Display component override from decorator. */\n  displayComponent?: DisplayFieldComponentEnum;\n  /** Parent data object for FK sibling extraction (REL-02). */\n  parentData?: Record<string, unknown>;\n  /** Resource-link trail — how many relationship objects were expanded to reach this subtree, and\n   * which resource it now belongs to. Absent at the display root. See `display-resource-link-trail.ts`. */\n  resourceLinkTrail?: DisplayResourceLinkTrail;\n  /**\n   * Per-item TEMPLATE for an ARRAY field, authored through `DisplayFieldArray.renderItem`.\n   *\n   * Receives the item's path AS THIS SURFACE ADDRESSES IT — on a read surface that is the display\n   * path (`icps[0]`), which is what a nested `<DisplayField name=…>` resolves against. The\n   * inline-editable path passes the array's LOCAL FORM path instead (`checklist.0`), because that\n   * is what its autosave bindings resolve against. Same prop, two path shapes, because the two\n   * surfaces genuinely address differently — see `DisplayFieldArray`.\n   */\n  renderItem?: (itemPath: string, itemSchema: z.ZodTypeAny) => React.ReactNode;\n  /** CSS class name. */\n  className?: string;\n  /** Whether label is hidden. */\n  hideLabel: boolean;\n  /** Whether description is hidden. */\n  hideDescription: boolean;\n  /** Resolved chrome mode (field decorator → section default → display default → surface policy). */\n  resolvedChromeMode?: ResponsiveAware<DisplayChromeMode>;\n  /** Resolved label placement from explicit prop or surface policy. */\n  resolvedLabelPlacement?: AutoLabelPlacement;\n  /** Resolved label style (decorator `display.labelStyle` or an explicit template override). */\n  resolvedLabelStyle?: DisplayLabelStyle;\n  /** Resolved empty-value strategy from surface policy. */\n  resolvedEmptyValue?: AutoEmptyValue;\n  /** File upload endpoints from ResourceDisplayContext. */\n  fileUploadContext?: Record<string, FileFieldEndpoints>;\n}\n"]}
+{"version":3,"file":"display-field-resolved-props.js","sourceRoot":"","sources":["../../../../../src/components/data-display/display-field-resolved-props.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG","sourcesContent":["/**\n * Shared resolved props interface for DisplayFieldReadOnly and DisplayFieldEditable.\n *\n * These props are resolved by the DisplayField gate component from explicit props\n * and DisplayTemplateContext, then passed to the appropriate child component.\n * All context resolution happens in the gate — children receive concrete values.\n */\n\nimport type React from 'react';\nimport type { z } from 'zod';\nimport type { FieldSchemaType, FileFieldEndpoints, DisplayFieldComponent as DisplayFieldComponentEnum } from '@wildo-ai/zod-decorators';\nimport type { DisplayChromeMode, DisplayLabelStyle, ResponsiveAware } from '@wildo-ai/zod-decorators';\nimport type { AutoEmptyValue, AutoLabelPlacement } from '@wildo-ai/presets-components-models';\nimport type { DisplayResourceLinkTrail } from './display-resource-link-trail';\nimport type { DisplayFieldProvenance } from './external-data-provenance/external-data-provenance.frontend';\n\nexport interface DisplayFieldResolvedProps {\n  /** Resolved Zod schema — gate guarantees this is defined. */\n  schema: z.ZodTypeAny;\n  /** Resolved schema type — gate guarantees this is defined. */\n  schemaType: FieldSchemaType;\n  /** Field value — may be undefined for null/missing fields. */\n  value: unknown;\n  /** Fully-qualified field name (with pathPrefix applied). */\n  fieldName?: string;\n  /** Resolved label from props or context. */\n  label?: string;\n  /** Resolved description from props or context. */\n  description?: string;\n  /** Resolved tooltip from props or context. */\n  tooltip?: string;\n  /**\n   * The provenance of a field an external-data pipeline writes (#1997) — the instance and the last completed pass,\n   * resolved by the gate; absent for every other field. The chrome places it and suppresses it in its bare-value modes.\n   */\n  provenance?: DisplayFieldProvenance;\n  /** Resolved enum labels from props or context. */\n  enumLabels?: Record<string, string>;\n  /** Display component override from decorator. */\n  displayComponent?: DisplayFieldComponentEnum;\n  /** Parent data object for FK sibling extraction (REL-02). */\n  parentData?: Record<string, unknown>;\n  /** Resource-link trail — how many relationship objects were expanded to reach this subtree, and\n   * which resource it now belongs to. Absent at the display root. See `display-resource-link-trail.ts`. */\n  resourceLinkTrail?: DisplayResourceLinkTrail;\n  /**\n   * Per-item TEMPLATE for an ARRAY field, authored through `DisplayFieldArray.renderItem`.\n   *\n   * Receives the item's path AS THIS SURFACE ADDRESSES IT — on a read surface that is the display\n   * path (`icps[0]`), which is what a nested `<DisplayField name=…>` resolves against. The\n   * inline-editable path passes the array's LOCAL FORM path instead (`checklist.0`), because that\n   * is what its autosave bindings resolve against. Same prop, two path shapes, because the two\n   * surfaces genuinely address differently — see `DisplayFieldArray`.\n   */\n  renderItem?: (itemPath: string, itemSchema: z.ZodTypeAny) => React.ReactNode;\n  /** CSS class name. */\n  className?: string;\n  /** Whether label is hidden. */\n  hideLabel: boolean;\n  /** Whether description is hidden. */\n  hideDescription: boolean;\n  /** Resolved chrome mode (field decorator → section default → display default → surface policy). */\n  resolvedChromeMode?: ResponsiveAware<DisplayChromeMode>;\n  /** Resolved label placement from explicit prop or surface policy. */\n  resolvedLabelPlacement?: AutoLabelPlacement;\n  /** Resolved label style (decorator `display.labelStyle` or an explicit template override). */\n  resolvedLabelStyle?: DisplayLabelStyle;\n  /** Resolved empty-value strategy from surface policy. */\n  resolvedEmptyValue?: AutoEmptyValue;\n  /** File upload endpoints from ResourceDisplayContext. */\n  fileUploadContext?: Record<string, FileFieldEndpoints>;\n}\n"]}

package/dist/esm/components/data-display/external-data-provenance/DisplayFieldProvenanceNote.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The provenance note beneath a pipeline-written value (#1997): "Synced from Odoo · as of 12 minutes ago".
+ *
+ * Every word comes from the i18n tree (`display-text-comes-from-i18n.md`):
+ * - the sentence is `components.LOW_LEVEL_FORM_FIELD.syncedFromAsOf`, with `system` and `asOf` params;
+ * - the instance is `systems_of_record.<name>.displayName`, planned by the labelling pipeline for every declared
+ *   instance. A name nobody generated words for renders RAW (`odoo`) — the missing label looking missing, never a
+ *   word derived from the identifier;
+ * - the instant is the viewer's regional formatting, relative when near ("12 minutes ago") and a date when far.
+ *
+ * Rendered with the `FieldDescription` recipe so it reads in the description voice, as a note about the value.
+ */
+import React from 'react';
+import type { DisplayFieldProvenance } from './external-data-provenance.frontend';
+export interface DisplayFieldProvenanceNoteProps {
+    provenance: DisplayFieldProvenance;
+    className?: string;
+}
+export declare function DisplayFieldProvenanceNote({ provenance, className }: DisplayFieldProvenanceNoteProps): React.JSX.Element | null;
+export declare namespace DisplayFieldProvenanceNote {
+    var displayName: string;
+}
+//# sourceMappingURL=DisplayFieldProvenanceNote.d.ts.map

package/dist/esm/components/data-display/external-data-provenance/DisplayFieldProvenanceNote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DisplayFieldProvenanceNote.d.ts","sourceRoot":"","sources":["../../../../../../src/components/data-display/external-data-provenance/DisplayFieldProvenanceNote.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAkB,MAAM,OAAO,CAAC;AAOvC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAElF,MAAM,WAAW,+BAA+B;IAC9C,UAAU,EAAE,sBAAsB,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,0BAA0B,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,+BAA+B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAkB/H;yBAlBe,0BAA0B"}

package/dist/esm/components/data-display/external-data-provenance/DisplayFieldProvenanceNote.js

@@ -0,0 +1,35 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * The provenance note beneath a pipeline-written value (#1997): "Synced from Odoo · as of 12 minutes ago".
+ *
+ * Every word comes from the i18n tree (`display-text-comes-from-i18n.md`):
+ * - the sentence is `components.LOW_LEVEL_FORM_FIELD.syncedFromAsOf`, with `system` and `asOf` params;
+ * - the instance is `systems_of_record.<name>.displayName`, planned by the labelling pipeline for every declared
+ *   instance. A name nobody generated words for renders RAW (`odoo`) — the missing label looking missing, never a
+ *   word derived from the identifier;
+ * - the instant is the viewer's regional formatting, relative when near ("12 minutes ago") and a date when far.
+ *
+ * Rendered with the `FieldDescription` recipe so it reads in the description voice, as a note about the value.
+ */
+import { useMemo } from 'react';
+import { DateDisplayMode } from '@wildo-ai/zod-decorators';
+import { FrontendComponentType } from '@wildo-ai/presets-components-models';
+import { buildSystemOfRecordDisplayNameLabelKey } from '@wildo-ai/saas-models';
+import { FieldDescription } from '../../../components/form/chromes/field.js';
+import { useI18n } from '../../../core/i18n/useI18n.js';
+export function DisplayFieldProvenanceNote({ provenance, className }) {
+    const systemKey = buildSystemOfRecordDisplayNameLabelKey(provenance.system);
+    const keys = useMemo(() => [systemKey], [systemKey]);
+    const { tComponent, t, formatDateTimeForDisplayMode, isReady } = useI18n({
+        component: FrontendComponentType.LOW_LEVEL_FORM_FIELD,
+        keys,
+    });
+    if (!isReady)
+        return null;
+    const translatedSystem = t(systemKey);
+    const system = translatedSystem && translatedSystem !== systemKey ? translatedSystem : provenance.system;
+    const asOf = formatDateTimeForDisplayMode(provenance.currentAsOf, DateDisplayMode.AUTO);
+    return (_jsx(FieldDescription, { className: className, "data-field-provenance": "", children: tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'syncedFromAsOf', { system, asOf }) }));
+}
+DisplayFieldProvenanceNote.displayName = 'DisplayFieldProvenanceNote';
+//# sourceMappingURL=DisplayFieldProvenanceNote.js.map

package/dist/esm/components/data-display/external-data-provenance/DisplayFieldProvenanceNote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DisplayFieldProvenanceNote.js","sourceRoot":"","sources":["../../../../../../src/components/data-display/external-data-provenance/DisplayFieldProvenanceNote.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;AACH,OAAc,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,sCAAsC,EAAE,MAAM,uBAAuB,CAAC;AAE/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,uCAAuC,CAAC;AAQhE,MAAM,UAAU,0BAA0B,CAAC,EAAE,UAAU,EAAE,SAAS,EAAmC;IACnG,MAAM,SAAS,GAAG,sCAAsC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC5E,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IACrD,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,4BAA4B,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QACvE,SAAS,EAAE,qBAAqB,CAAC,oBAAoB;QACrD,IAAI;KACL,CAAC,CAAC;IACH,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,MAAM,gBAAgB,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,gBAAgB,IAAI,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC;IACzG,MAAM,IAAI,GAAG,4BAA4B,CAAC,UAAU,CAAC,WAAW,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC;IAExF,OAAO,CACL,KAAC,gBAAgB,IAAC,SAAS,EAAE,SAAS,2BAAwB,EAAE,YAC7D,UAAU,CAAC,qBAAqB,CAAC,oBAAoB,EAAE,gBAAgB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAC1E,CACpB,CAAC;AACJ,CAAC;AAED,0BAA0B,CAAC,WAAW,GAAG,4BAA4B,CAAC","sourcesContent":["/**\n * The provenance note beneath a pipeline-written value (#1997): \"Synced from Odoo · as of 12 minutes ago\".\n *\n * Every word comes from the i18n tree (`display-text-comes-from-i18n.md`):\n * - the sentence is `components.LOW_LEVEL_FORM_FIELD.syncedFromAsOf`, with `system` and `asOf` params;\n * - the instance is `systems_of_record.<name>.displayName`, planned by the labelling pipeline for every declared\n *   instance. A name nobody generated words for renders RAW (`odoo`) — the missing label looking missing, never a\n *   word derived from the identifier;\n * - the instant is the viewer's regional formatting, relative when near (\"12 minutes ago\") and a date when far.\n *\n * Rendered with the `FieldDescription` recipe so it reads in the description voice, as a note about the value.\n */\nimport React, { useMemo } from 'react';\nimport { DateDisplayMode } from '@wildo-ai/zod-decorators';\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { buildSystemOfRecordDisplayNameLabelKey } from '@wildo-ai/saas-models';\n\nimport { FieldDescription } from '~wildo-frontend-lib/components/form/chromes/field';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport type { DisplayFieldProvenance } from './external-data-provenance.frontend';\n\nexport interface DisplayFieldProvenanceNoteProps {\n  provenance: DisplayFieldProvenance;\n  className?: string;\n}\n\nexport function DisplayFieldProvenanceNote({ provenance, className }: DisplayFieldProvenanceNoteProps): React.JSX.Element | null {\n  const systemKey = buildSystemOfRecordDisplayNameLabelKey(provenance.system);\n  const keys = useMemo(() => [systemKey], [systemKey]);\n  const { tComponent, t, formatDateTimeForDisplayMode, isReady } = useI18n({\n    component: FrontendComponentType.LOW_LEVEL_FORM_FIELD,\n    keys,\n  });\n  if (!isReady) return null;\n\n  const translatedSystem = t(systemKey);\n  const system = translatedSystem && translatedSystem !== systemKey ? translatedSystem : provenance.system;\n  const asOf = formatDateTimeForDisplayMode(provenance.currentAsOf, DateDisplayMode.AUTO);\n\n  return (\n    <FieldDescription className={className} data-field-provenance=\"\">\n      {tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD, 'syncedFromAsOf', { system, asOf })}\n    </FieldDescription>\n  );\n}\n\nDisplayFieldProvenanceNote.displayName = 'DisplayFieldProvenanceNote';\n"]}

package/dist/esm/components/data-display/external-data-provenance/external-data-provenance.frontend.d.ts

@@ -0,0 +1,47 @@
+import { type ExternalDataPipelineDeclaration, type ExternalDataProvenanceResponse } from '@wildo-ai/saas-models/external-data';
+import type { AnyFrontendResourceConfiguration } from '../../../core/resources/resources.frontend.schemas';
+import type { WildoBackendHttpClient } from '../../../core/requests/wildo-http-client.frontend.service';
+/** How long one answer is trusted: well under a pipeline's shortest sensible interval, well over one page's life. */
+export declare const EXTERNAL_DATA_PROVENANCE_TTL_MS: number;
+/**
+ * What the display chrome is handed for a synced field — the provenance answer once a pass has COMPLETED. A pipeline
+ * that never completed one produces no cue at all rather than an "as of" nobody can state.
+ */
+export interface DisplayFieldProvenance {
+    /** The declared system-of-record instance NAME; its words come from `systems_of_record.<name>.displayName`. */
+    readonly system: string;
+    /** When the most recent completed pass BEGAN reading (ISO 8601) — the instant its rows are current as of. */
+    readonly currentAsOf: string;
+}
+/** The pipeline-written local fields of a destination, derived once per declaration object. */
+export declare function externalDataSyncedFieldSet(declaration: ExternalDataPipelineDeclaration): ReadonlySet<string>;
+/**
+ * The provenance route of a destination, composed from its default LIST operation's initiator URL. The LIST operation is
+ * selected with `isDefaultUrlBearingOperation`, the same predicate the backend mounts the route with
+ * (`external-data-provenance-route.backend.ts`), and exactly one must match there too — so the two sides select one
+ * operation and describe one path, rather than two selections that happen to agree.
+ *
+ * @returns a path under `/api/v1` for the HTTP client, or `undefined` when the destination has no LIST initiator whose
+ *          parameters the current context can fill — in which case no request is made and no cue is shown.
+ */
+export declare function buildExternalDataProvenancePath(params: {
+    resourceConfiguration: AnyFrontendResourceConfiguration;
+    contextualParameters: Record<string, string | number>;
+}): string | undefined;
+/** `useSyncExternalStore` subscription. */
+export declare function subscribeExternalDataProvenance(listener: () => void): () => void;
+/**
+ * How long until the cached answer for a path expires (ms, never negative), or `undefined` when nothing is cached — the
+ * hook's cue to schedule its re-read.
+ */
+export declare function msUntilExternalDataProvenanceExpires(path: string | undefined, now?: number): number | undefined;
+/** The cached answer for a path: the response, `null` for a refused/failed read, `undefined` while unknown. */
+export declare function peekExternalDataProvenance(path: string | undefined): ExternalDataProvenanceResponse | null | undefined;
+/**
+ * Read the path unless a fresh answer is cached or a read is already on its way. Every synced field of a record calls
+ * this; exactly one request leaves.
+ */
+export declare function ensureExternalDataProvenance(path: string, httpClient: Pick<WildoBackendHttpClient, 'get'>, now?: number): void;
+/** Test seam: forget every cached answer. */
+export declare function resetExternalDataProvenanceCache(): void;
+//# sourceMappingURL=external-data-provenance.frontend.d.ts.map

package/dist/esm/components/data-display/external-data-provenance/external-data-provenance.frontend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-data-provenance.frontend.d.ts","sourceRoot":"","sources":["../../../../../../src/components/data-display/external-data-provenance/external-data-provenance.frontend.ts"],"names":[],"mappings":"AA0BA,OAAO,EAIL,KAAK,+BAA+B,EACpC,KAAK,8BAA8B,EACpC,MAAM,qCAAqC,CAAC;AAI7C,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,+DAA+D,CAAC;AACtH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sEAAsE,CAAC;AAEnH,qHAAqH;AACrH,eAAO,MAAM,+BAA+B,QAAgB,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,+GAA+G;IAC/G,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6GAA6G;IAC7G,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAID,+FAA+F;AAC/F,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,+BAA+B,GAAG,WAAW,CAAC,MAAM,CAAC,CAO5G;AAED;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE;IACtD,qBAAqB,EAAE,gCAAgC,CAAC;IACxD,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CACvD,GAAG,MAAM,GAAG,SAAS,CAiBrB;AAeD,2CAA2C;AAC3C,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAGhF;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,GAAG,SAAS,CAG3H;AAED,+GAA+G;AAC/G,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,8BAA8B,GAAG,IAAI,GAAG,SAAS,CAGtH;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,sBAAsB,EAAE,KAAK,CAAC,EAAE,GAAG,GAAE,MAAmB,GAAG,IAAI,CAiB1I;AAED,6CAA6C;AAC7C,wBAAgB,gCAAgC,IAAI,IAAI,CAIvD"}

package/dist/esm/components/data-display/external-data-provenance/external-data-provenance.frontend.js

@@ -0,0 +1,124 @@
+/**
+ * Reading a pipeline destination's provenance for the display chrome (#1997) — which fields a pipeline writes, the URL
+ * of the destination's provenance route, and a small cache so a record with six synced fields asks once.
+ *
+ * ## Why a module cache and not a provider in the context tree
+ *
+ * The answer is per DESTINATION and per ORGANIZATION (the route is scoped by the destination's LIST URL, which carries
+ * the organization), it changes at most once per pipeline pass, and only a handful of surfaces ever need it. A provider
+ * would have to sit in every application's tree for a read most of them never make. So the cache is keyed by the
+ * RESOLVED URL — which already names the organization, so switching organizations reads a different entry and never
+ * shows another tenant's answer — and entries expire after {@link EXTERNAL_DATA_PROVENANCE_TTL_MS}: the hook schedules
+ * a re-read at the expiry of the answer it shows, so a page left open across a pipeline pass does not keep saying
+ * "as of" an instant the copy has since moved past.
+ *
+ * ## Failure reads as silence
+ *
+ * A refused or failed read caches `null` for the same period, and the cue then renders nothing. The cue is a courtesy
+ * about a value that renders correctly without it; a failed read must not become an error on the field, and must not be
+ * retried on every render of every synced field.
+ */
+import { MAIN_API_BASE_PATH, CoreResourceOperation, isDefaultUrlBearingOperation, } from '@wildo-ai/saas-models';
+import { EXTERNAL_DATA_PROVENANCE_ROUTE_SEGMENT, ExternalDataProvenanceResponseSchema, listExternalDataPipelineSyncedLocalFields, } from '@wildo-ai/saas-models/external-data';
+import { NavigationUtils } from '../../../core/navigation/navigation.utils.js';
+import { FrontendResourceUtils } from '../../../core/resources/frontend-resource.utils.js';
+/** How long one answer is trusted: well under a pipeline's shortest sensible interval, well over one page's life. */
+export const EXTERNAL_DATA_PROVENANCE_TTL_MS = 5 * 60 * 1000;
+const syncedFieldsByDeclaration = new WeakMap();
+/** The pipeline-written local fields of a destination, derived once per declaration object. */
+export function externalDataSyncedFieldSet(declaration) {
+    let fields = syncedFieldsByDeclaration.get(declaration);
+    if (!fields) {
+        fields = new Set(listExternalDataPipelineSyncedLocalFields(declaration));
+        syncedFieldsByDeclaration.set(declaration, fields);
+    }
+    return fields;
+}
+/**
+ * The provenance route of a destination, composed from its default LIST operation's initiator URL. The LIST operation is
+ * selected with `isDefaultUrlBearingOperation`, the same predicate the backend mounts the route with
+ * (`external-data-provenance-route.backend.ts`), and exactly one must match there too — so the two sides select one
+ * operation and describe one path, rather than two selections that happen to agree.
+ *
+ * @returns a path under `/api/v1` for the HTTP client, or `undefined` when the destination has no LIST initiator whose
+ *          parameters the current context can fill — in which case no request is made and no cue is shown.
+ */
+export function buildExternalDataProvenancePath(params) {
+    const { resourceConfiguration, contextualParameters } = params;
+    const listOperations = (resourceConfiguration.operations ?? []).filter((operation) => isDefaultUrlBearingOperation(operation, CoreResourceOperation.LIST));
+    if (listOperations.length !== 1)
+        return undefined;
+    const initiatorInfos = (listOperations[0].initiatorInfos ?? []);
+    if (initiatorInfos.length === 0)
+        return undefined;
+    const initiatorInfo = FrontendResourceUtils.selectOperationUrlInitiatorInfo({
+        initiatorInfos,
+        contextualParameters,
+        targetResourceType: resourceConfiguration.resourceIdentifier,
+        targetDefaultFieldIdentifier: resourceConfiguration.resourceFieldIdentifier,
+    });
+    if (!initiatorInfo)
+        return undefined;
+    const resolved = NavigationUtils.resolveUrlPath(`${MAIN_API_BASE_PATH}${initiatorInfo.url}`, contextualParameters);
+    if (!resolved || NavigationUtils.hasUnresolvedPlaceholders(resolved))
+        return undefined;
+    return `${resolved}/${EXTERNAL_DATA_PROVENANCE_ROUTE_SEGMENT}`;
+}
+const cache = new Map();
+const inFlight = new Map();
+const listeners = new Set();
+function notify() {
+    for (const listener of listeners)
+        listener();
+}
+/** `useSyncExternalStore` subscription. */
+export function subscribeExternalDataProvenance(listener) {
+    listeners.add(listener);
+    return () => { listeners.delete(listener); };
+}
+/**
+ * How long until the cached answer for a path expires (ms, never negative), or `undefined` when nothing is cached — the
+ * hook's cue to schedule its re-read.
+ */
+export function msUntilExternalDataProvenanceExpires(path, now = Date.now()) {
+    const entry = path ? cache.get(path) : undefined;
+    return entry ? Math.max(0, entry.fetchedAt + EXTERNAL_DATA_PROVENANCE_TTL_MS - now) : undefined;
+}
+/** The cached answer for a path: the response, `null` for a refused/failed read, `undefined` while unknown. */
+export function peekExternalDataProvenance(path) {
+    if (!path)
+        return undefined;
+    return cache.get(path)?.value;
+}
+/**
+ * Read the path unless a fresh answer is cached or a read is already on its way. Every synced field of a record calls
+ * this; exactly one request leaves.
+ */
+export function ensureExternalDataProvenance(path, httpClient, now = Date.now()) {
+    const entry = cache.get(path);
+    if (entry && now - entry.fetchedAt < EXTERNAL_DATA_PROVENANCE_TTL_MS)
+        return;
+    if (inFlight.has(path))
+        return;
+    const read = (async () => {
+        let value;
+        try {
+            const parsed = ExternalDataProvenanceResponseSchema.safeParse(await httpClient.get(path, { silent: true }));
+            value = parsed.success ? parsed.data : null;
+        }
+        catch {
+            value = null;
+        }
+        cache.set(path, { value, fetchedAt: Date.now() });
+        inFlight.delete(path);
+        notify();
+    })();
+    inFlight.set(path, read);
+}
+/** Test seam: forget every cached answer. */
+export function resetExternalDataProvenanceCache() {
+    cache.clear();
+    inFlight.clear();
+    notify();
+}
+//# sourceMappingURL=external-data-provenance.frontend.js.map

package/dist/esm/components/data-display/external-data-provenance/external-data-provenance.frontend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-data-provenance.frontend.js","sourceRoot":"","sources":["../../../../../../src/components/data-display/external-data-provenance/external-data-provenance.frontend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EACL,kBAAkB,EAElB,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,sCAAsC,EACtC,oCAAoC,EACpC,yCAAyC,GAG1C,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EAAE,eAAe,EAAE,MAAM,sDAAsD,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,4DAA4D,CAAC;AAInG,qHAAqH;AACrH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAa7D,MAAM,yBAAyB,GAAG,IAAI,OAAO,EAAwD,CAAC;AAEtG,+FAA+F;AAC/F,MAAM,UAAU,0BAA0B,CAAC,WAA4C;IACrF,IAAI,MAAM,GAAG,yBAAyB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,IAAI,GAAG,CAAC,yCAAyC,CAAC,WAAW,CAAC,CAAC,CAAC;QACzE,yBAAyB,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,+BAA+B,CAAC,MAG/C;IACC,MAAM,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,GAAG,MAAM,CAAC;IAC/D,MAAM,cAAc,GAAG,CAAC,qBAAqB,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CACnF,4BAA4B,CAAC,SAAS,EAAE,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;IACvE,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAClD,MAAM,cAAc,GAAG,CAAC,cAAc,CAAC,CAAC,CAAE,CAAC,cAAc,IAAI,EAAE,CAAuD,CAAC;IACvH,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAClD,MAAM,aAAa,GAAG,qBAAqB,CAAC,+BAA+B,CAAC;QAC1E,cAAc;QACd,oBAAoB;QACpB,kBAAkB,EAAE,qBAAqB,CAAC,kBAAkB;QAC5D,4BAA4B,EAAE,qBAAqB,CAAC,uBAAuB;KAC5E,CAAC,CAAC;IACH,IAAI,CAAC,aAAa;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,QAAQ,GAAG,eAAe,CAAC,cAAc,CAAC,GAAG,kBAAkB,GAAG,aAAa,CAAC,GAAG,EAAE,EAAE,oBAAoB,CAAC,CAAC;IACnH,IAAI,CAAC,QAAQ,IAAI,eAAe,CAAC,yBAAyB,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IACvF,OAAO,GAAG,QAAQ,IAAI,sCAAsC,EAAE,CAAC;AACjE,CAAC;AAOD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;AAC5C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;AAExC,SAAS,MAAM;IACb,KAAK,MAAM,QAAQ,IAAI,SAAS;QAAE,QAAQ,EAAE,CAAC;AAC/C,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,+BAA+B,CAAC,QAAoB;IAClE,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxB,OAAO,GAAG,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oCAAoC,CAAC,IAAwB,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;IACrG,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjD,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,+BAA+B,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAClG,CAAC;AAED,+GAA+G;AAC/G,MAAM,UAAU,0BAA0B,CAAC,IAAwB;IACjE,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,IAAY,EAAE,UAA+C,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;IAClI,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,KAAK,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,GAAG,+BAA+B;QAAE,OAAO;IAC7E,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO;IAC/B,MAAM,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE;QACvB,IAAI,KAA4C,CAAC;QACjD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,oCAAoC,CAAC,SAAS,CAAC,MAAM,UAAU,CAAC,GAAG,CAAU,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACrH,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAClD,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACtB,MAAM,EAAE,CAAC;IACX,CAAC,CAAC,EAAE,CAAC;IACL,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,gCAAgC;IAC9C,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,QAAQ,CAAC,KAAK,EAAE,CAAC;IACjB,MAAM,EAAE,CAAC;AACX,CAAC","sourcesContent":["/**\n * Reading a pipeline destination's provenance for the display chrome (#1997) — which fields a pipeline writes, the URL\n * of the destination's provenance route, and a small cache so a record with six synced fields asks once.\n *\n * ## Why a module cache and not a provider in the context tree\n *\n * The answer is per DESTINATION and per ORGANIZATION (the route is scoped by the destination's LIST URL, which carries\n * the organization), it changes at most once per pipeline pass, and only a handful of surfaces ever need it. A provider\n * would have to sit in every application's tree for a read most of them never make. So the cache is keyed by the\n * RESOLVED URL — which already names the organization, so switching organizations reads a different entry and never\n * shows another tenant's answer — and entries expire after {@link EXTERNAL_DATA_PROVENANCE_TTL_MS}: the hook schedules\n * a re-read at the expiry of the answer it shows, so a page left open across a pipeline pass does not keep saying\n * \"as of\" an instant the copy has since moved past.\n *\n * ## Failure reads as silence\n *\n * A refused or failed read caches `null` for the same period, and the cue then renders nothing. The cue is a courtesy\n * about a value that renders correctly without it; a failed read must not become an error on the field, and must not be\n * retried on every render of every synced field.\n */\nimport {\n  MAIN_API_BASE_PATH,\n  type ResourceConfiguration_Operation_UrlInitiatorInfo,\n  CoreResourceOperation,\n  isDefaultUrlBearingOperation,\n} from '@wildo-ai/saas-models';\nimport {\n  EXTERNAL_DATA_PROVENANCE_ROUTE_SEGMENT,\n  ExternalDataProvenanceResponseSchema,\n  listExternalDataPipelineSyncedLocalFields,\n  type ExternalDataPipelineDeclaration,\n  type ExternalDataProvenanceResponse,\n} from '@wildo-ai/saas-models/external-data';\n\nimport { NavigationUtils } from '~wildo-frontend-lib/core/navigation/navigation.utils';\nimport { FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport type { AnyFrontendResourceConfiguration } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport type { WildoBackendHttpClient } from '~wildo-frontend-lib/core/requests/wildo-http-client.frontend.service';\n\n/** How long one answer is trusted: well under a pipeline's shortest sensible interval, well over one page's life. */\nexport const EXTERNAL_DATA_PROVENANCE_TTL_MS = 5 * 60 * 1000;\n\n/**\n * What the display chrome is handed for a synced field — the provenance answer once a pass has COMPLETED. A pipeline\n * that never completed one produces no cue at all rather than an \"as of\" nobody can state.\n */\nexport interface DisplayFieldProvenance {\n  /** The declared system-of-record instance NAME; its words come from `systems_of_record.<name>.displayName`. */\n  readonly system: string;\n  /** When the most recent completed pass BEGAN reading (ISO 8601) — the instant its rows are current as of. */\n  readonly currentAsOf: string;\n}\n\nconst syncedFieldsByDeclaration = new WeakMap<ExternalDataPipelineDeclaration, ReadonlySet<string>>();\n\n/** The pipeline-written local fields of a destination, derived once per declaration object. */\nexport function externalDataSyncedFieldSet(declaration: ExternalDataPipelineDeclaration): ReadonlySet<string> {\n  let fields = syncedFieldsByDeclaration.get(declaration);\n  if (!fields) {\n    fields = new Set(listExternalDataPipelineSyncedLocalFields(declaration));\n    syncedFieldsByDeclaration.set(declaration, fields);\n  }\n  return fields;\n}\n\n/**\n * The provenance route of a destination, composed from its default LIST operation's initiator URL. The LIST operation is\n * selected with `isDefaultUrlBearingOperation`, the same predicate the backend mounts the route with\n * (`external-data-provenance-route.backend.ts`), and exactly one must match there too — so the two sides select one\n * operation and describe one path, rather than two selections that happen to agree.\n *\n * @returns a path under `/api/v1` for the HTTP client, or `undefined` when the destination has no LIST initiator whose\n *          parameters the current context can fill — in which case no request is made and no cue is shown.\n */\nexport function buildExternalDataProvenancePath(params: {\n  resourceConfiguration: AnyFrontendResourceConfiguration;\n  contextualParameters: Record<string, string | number>;\n}): string | undefined {\n  const { resourceConfiguration, contextualParameters } = params;\n  const listOperations = (resourceConfiguration.operations ?? []).filter((operation) =>\n    isDefaultUrlBearingOperation(operation, CoreResourceOperation.LIST));\n  if (listOperations.length !== 1) return undefined;\n  const initiatorInfos = (listOperations[0]!.initiatorInfos ?? []) as ResourceConfiguration_Operation_UrlInitiatorInfo[];\n  if (initiatorInfos.length === 0) return undefined;\n  const initiatorInfo = FrontendResourceUtils.selectOperationUrlInitiatorInfo({\n    initiatorInfos,\n    contextualParameters,\n    targetResourceType: resourceConfiguration.resourceIdentifier,\n    targetDefaultFieldIdentifier: resourceConfiguration.resourceFieldIdentifier,\n  });\n  if (!initiatorInfo) return undefined;\n  const resolved = NavigationUtils.resolveUrlPath(`${MAIN_API_BASE_PATH}${initiatorInfo.url}`, contextualParameters);\n  if (!resolved || NavigationUtils.hasUnresolvedPlaceholders(resolved)) return undefined;\n  return `${resolved}/${EXTERNAL_DATA_PROVENANCE_ROUTE_SEGMENT}`;\n}\n\ninterface CacheEntry {\n  readonly value: ExternalDataProvenanceResponse | null;\n  readonly fetchedAt: number;\n}\n\nconst cache = new Map<string, CacheEntry>();\nconst inFlight = new Map<string, Promise<void>>();\nconst listeners = new Set<() => void>();\n\nfunction notify(): void {\n  for (const listener of listeners) listener();\n}\n\n/** `useSyncExternalStore` subscription. */\nexport function subscribeExternalDataProvenance(listener: () => void): () => void {\n  listeners.add(listener);\n  return () => { listeners.delete(listener); };\n}\n\n/**\n * How long until the cached answer for a path expires (ms, never negative), or `undefined` when nothing is cached — the\n * hook's cue to schedule its re-read.\n */\nexport function msUntilExternalDataProvenanceExpires(path: string | undefined, now: number = Date.now()): number | undefined {\n  const entry = path ? cache.get(path) : undefined;\n  return entry ? Math.max(0, entry.fetchedAt + EXTERNAL_DATA_PROVENANCE_TTL_MS - now) : undefined;\n}\n\n/** The cached answer for a path: the response, `null` for a refused/failed read, `undefined` while unknown. */\nexport function peekExternalDataProvenance(path: string | undefined): ExternalDataProvenanceResponse | null | undefined {\n  if (!path) return undefined;\n  return cache.get(path)?.value;\n}\n\n/**\n * Read the path unless a fresh answer is cached or a read is already on its way. Every synced field of a record calls\n * this; exactly one request leaves.\n */\nexport function ensureExternalDataProvenance(path: string, httpClient: Pick<WildoBackendHttpClient, 'get'>, now: number = Date.now()): void {\n  const entry = cache.get(path);\n  if (entry && now - entry.fetchedAt < EXTERNAL_DATA_PROVENANCE_TTL_MS) return;\n  if (inFlight.has(path)) return;\n  const read = (async () => {\n    let value: ExternalDataProvenanceResponse | null;\n    try {\n      const parsed = ExternalDataProvenanceResponseSchema.safeParse(await httpClient.get<unknown>(path, { silent: true }));\n      value = parsed.success ? parsed.data : null;\n    } catch {\n      value = null;\n    }\n    cache.set(path, { value, fetchedAt: Date.now() });\n    inFlight.delete(path);\n    notify();\n  })();\n  inFlight.set(path, read);\n}\n\n/** Test seam: forget every cached answer. */\nexport function resetExternalDataProvenanceCache(): void {\n  cache.clear();\n  inFlight.clear();\n  notify();\n}\n"]}

package/dist/esm/components/data-display/external-data-provenance/useExternalDataFieldProvenance.d.ts

@@ -0,0 +1,8 @@
+import { type DisplayFieldProvenance } from './external-data-provenance.frontend';
+export declare function useExternalDataFieldProvenance(params: {
+    /** The field's full path as the gate resolved it. Only a TOP-LEVEL name can be pipeline-written. */
+    fieldName: string | undefined;
+    /** False on surfaces that never show the cue (SUMMARY: cards and FK previews), so they never cause a read. */
+    enabled: boolean;
+}): DisplayFieldProvenance | undefined;
+//# sourceMappingURL=useExternalDataFieldProvenance.d.ts.map

package/dist/esm/components/data-display/external-data-provenance/useExternalDataFieldProvenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useExternalDataFieldProvenance.d.ts","sourceRoot":"","sources":["../../../../../../src/components/data-display/external-data-provenance/useExternalDataFieldProvenance.ts"],"names":[],"mappings":"AAcA,OAAO,EAOL,KAAK,sBAAsB,EAC5B,MAAM,qCAAqC,CAAC;AAE7C,wBAAgB,8BAA8B,CAAC,MAAM,EAAE;IACrD,oGAAoG;IACpG,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,8GAA8G;IAC9G,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG,sBAAsB,GAAG,SAAS,CAuCrC"}

package/dist/esm/components/data-display/external-data-provenance/useExternalDataFieldProvenance.js

@@ -0,0 +1,46 @@
+/**
+ * The provenance of ONE displayed field (#1997): the answer the chrome shows beneath a value an external-data pipeline
+ * wrote, or `undefined` for every other field.
+ *
+ * Cheap for the overwhelming majority of fields, which is what lets the display gate call it for every field it
+ * renders: a resource that declares no pipeline, a nested path, an array item, or a field no mapping writes all return
+ * before any request exists. Words are NOT composed here — the note component does that, and only when it renders — so
+ * the gate takes on no i18n dependency for a field that never shows a cue.
+ */
+import { useContext, useEffect, useMemo, useSyncExternalStore } from 'react';
+import { useResourceDisplayContext } from '../automatic-displayer.utils.js';
+import { ApplicationContext } from '../../../core/runtime/ApplicationContext.shared.js';
+import { useResourceRegistrySafe } from '../../../core/resources/useResourceRegistry.js';
+import { buildExternalDataProvenancePath, ensureExternalDataProvenance, externalDataSyncedFieldSet, msUntilExternalDataProvenanceExpires, peekExternalDataProvenance, subscribeExternalDataProvenance, } from './external-data-provenance.frontend.js';
+export function useExternalDataFieldProvenance(params) {
+    const { resourceType, contextualParameters } = useResourceDisplayContext();
+    const registryContext = useResourceRegistrySafe();
+    // Read optionally: a display surface rendered outside an application (a test harness, a docs preview) has no client
+    // and simply shows no cue — the throwing `useApplication` would take every such surface down.
+    const httpClient = useContext(ApplicationContext)?.httpClient;
+    const resourceConfiguration = resourceType ? registryContext?.registry.resourceConfigurations[resourceType] : undefined;
+    const declaration = resourceConfiguration?.externalDataPipeline;
+    const isSyncedField = params.enabled
+        && !!declaration
+        && !!params.fieldName
+        && externalDataSyncedFieldSet(declaration).has(params.fieldName);
+    const path = useMemo(() => (isSyncedField && resourceConfiguration
+        ? buildExternalDataProvenancePath({ resourceConfiguration, contextualParameters: contextualParameters ?? {} })
+        : undefined), [isSyncedField, resourceConfiguration, contextualParameters]);
+    const answer = useSyncExternalStore(subscribeExternalDataProvenance, () => peekExternalDataProvenance(path));
+    // Read now if nothing fresh is cached, and again when the answer shown expires — a page left open across a pipeline
+    // pass must not keep its first "as of". The store dedupes, so every synced field of a record scheduling the same
+    // re-read still sends one request. `answer` is a dependency so the timer is re-armed each time a new answer lands.
+    useEffect(() => {
+        if (!path || !httpClient)
+            return undefined;
+        ensureExternalDataProvenance(path, httpClient);
+        const expiresIn = msUntilExternalDataProvenanceExpires(path);
+        if (expiresIn === undefined)
+            return undefined;
+        const timer = setTimeout(() => ensureExternalDataProvenance(path, httpClient), expiresIn + 1);
+        return () => clearTimeout(timer);
+    }, [path, httpClient, answer]);
+    return useMemo(() => (answer?.currentAsOf ? { system: answer.system, currentAsOf: answer.currentAsOf } : undefined), [answer]);
+}
+//# sourceMappingURL=useExternalDataFieldProvenance.js.map

package/dist/esm/components/data-display/external-data-provenance/useExternalDataFieldProvenance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useExternalDataFieldProvenance.js","sourceRoot":"","sources":["../../../../../../src/components/data-display/external-data-provenance/useExternalDataFieldProvenance.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAE7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4DAA4D,CAAC;AAChG,OAAO,EAAE,uBAAuB,EAAE,MAAM,wDAAwD,CAAC;AACjG,OAAO,EACL,+BAA+B,EAC/B,4BAA4B,EAC5B,0BAA0B,EAC1B,oCAAoC,EACpC,0BAA0B,EAC1B,+BAA+B,GAEhC,MAAM,qCAAqC,CAAC;AAE7C,MAAM,UAAU,8BAA8B,CAAC,MAK9C;IACC,MAAM,EAAE,YAAY,EAAE,oBAAoB,EAAE,GAAG,yBAAyB,EAAE,CAAC;IAC3E,MAAM,eAAe,GAAG,uBAAuB,EAAE,CAAC;IAClD,oHAAoH;IACpH,8FAA8F;IAC9F,MAAM,UAAU,GAAG,UAAU,CAAC,kBAAkB,CAAC,EAAE,UAAU,CAAC;IAE9D,MAAM,qBAAqB,GAAG,YAAY,CAAC,CAAC,CAAC,eAAe,EAAE,QAAQ,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxH,MAAM,WAAW,GAAG,qBAAqB,EAAE,oBAAoB,CAAC;IAChE,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO;WAC/B,CAAC,CAAC,WAAW;WACb,CAAC,CAAC,MAAM,CAAC,SAAS;WAClB,0BAA0B,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAEnE,MAAM,IAAI,GAAG,OAAO,CAClB,GAAG,EAAE,CAAC,CAAC,aAAa,IAAI,qBAAqB;QAC3C,CAAC,CAAC,+BAA+B,CAAC,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,oBAAoB,IAAI,EAAE,EAAE,CAAC;QAC9G,CAAC,CAAC,SAAS,CAAC,EACd,CAAC,aAAa,EAAE,qBAAqB,EAAE,oBAAoB,CAAC,CAC7D,CAAC;IAEF,MAAM,MAAM,GAAG,oBAAoB,CAAC,+BAA+B,EAAE,GAAG,EAAE,CAAC,0BAA0B,CAAC,IAAI,CAAC,CAAC,CAAC;IAE7G,oHAAoH;IACpH,iHAAiH;IACjH,mHAAmH;IACnH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU;YAAE,OAAO,SAAS,CAAC;QAC3C,4BAA4B,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,oCAAoC,CAAC,IAAI,CAAC,CAAC;QAC7D,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC9C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,4BAA4B,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC;QAC9F,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IAE/B,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EACpG,CAAC,MAAM,CAAC,CACT,CAAC;AACJ,CAAC","sourcesContent":["/**\n * The provenance of ONE displayed field (#1997): the answer the chrome shows beneath a value an external-data pipeline\n * wrote, or `undefined` for every other field.\n *\n * Cheap for the overwhelming majority of fields, which is what lets the display gate call it for every field it\n * renders: a resource that declares no pipeline, a nested path, an array item, or a field no mapping writes all return\n * before any request exists. Words are NOT composed here — the note component does that, and only when it renders — so\n * the gate takes on no i18n dependency for a field that never shows a cue.\n */\nimport { useContext, useEffect, useMemo, useSyncExternalStore } from 'react';\n\nimport { useResourceDisplayContext } from '../automatic-displayer.utils';\nimport { ApplicationContext } from '~wildo-frontend-lib/core/runtime/ApplicationContext.shared';\nimport { useResourceRegistrySafe } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport {\n  buildExternalDataProvenancePath,\n  ensureExternalDataProvenance,\n  externalDataSyncedFieldSet,\n  msUntilExternalDataProvenanceExpires,\n  peekExternalDataProvenance,\n  subscribeExternalDataProvenance,\n  type DisplayFieldProvenance,\n} from './external-data-provenance.frontend';\n\nexport function useExternalDataFieldProvenance(params: {\n  /** The field's full path as the gate resolved it. Only a TOP-LEVEL name can be pipeline-written. */\n  fieldName: string | undefined;\n  /** False on surfaces that never show the cue (SUMMARY: cards and FK previews), so they never cause a read. */\n  enabled: boolean;\n}): DisplayFieldProvenance | undefined {\n  const { resourceType, contextualParameters } = useResourceDisplayContext();\n  const registryContext = useResourceRegistrySafe();\n  // Read optionally: a display surface rendered outside an application (a test harness, a docs preview) has no client\n  // and simply shows no cue — the throwing `useApplication` would take every such surface down.\n  const httpClient = useContext(ApplicationContext)?.httpClient;\n\n  const resourceConfiguration = resourceType ? registryContext?.registry.resourceConfigurations[resourceType] : undefined;\n  const declaration = resourceConfiguration?.externalDataPipeline;\n  const isSyncedField = params.enabled\n    && !!declaration\n    && !!params.fieldName\n    && externalDataSyncedFieldSet(declaration).has(params.fieldName);\n\n  const path = useMemo(\n    () => (isSyncedField && resourceConfiguration\n      ? buildExternalDataProvenancePath({ resourceConfiguration, contextualParameters: contextualParameters ?? {} })\n      : undefined),\n    [isSyncedField, resourceConfiguration, contextualParameters],\n  );\n\n  const answer = useSyncExternalStore(subscribeExternalDataProvenance, () => peekExternalDataProvenance(path));\n\n  // Read now if nothing fresh is cached, and again when the answer shown expires — a page left open across a pipeline\n  // pass must not keep its first \"as of\". The store dedupes, so every synced field of a record scheduling the same\n  // re-read still sends one request. `answer` is a dependency so the timer is re-armed each time a new answer lands.\n  useEffect(() => {\n    if (!path || !httpClient) return undefined;\n    ensureExternalDataProvenance(path, httpClient);\n    const expiresIn = msUntilExternalDataProvenanceExpires(path);\n    if (expiresIn === undefined) return undefined;\n    const timer = setTimeout(() => ensureExternalDataProvenance(path, httpClient), expiresIn + 1);\n    return () => clearTimeout(timer);\n  }, [path, httpClient, answer]);\n\n  return useMemo(\n    () => (answer?.currentAsOf ? { system: answer.system, currentAsOf: answer.currentAsOf } : undefined),\n    [answer],\n  );\n}\n"]}

package/dist/esm/components/feedback/resource-empty-state.d.ts

@@ -13,18 +13,31 @@ export interface ResourceEmptyStateWrapperProps extends ComponentPresetProps {
     /** Variant: 'default' for list/table, 'compact' for inline contexts */
     variant?: 'default' | 'compact';
 }
+/**
+ * Whether the empty state will VISIBLY offer its primary action — the one decision a collection host needs
+ * to avoid offering the same action twice.
+ *
+ * An empty collection used to show two create buttons at once: the toolbar's trailing "Add task" and the
+ * empty state's own call to action, often under a DIFFERENT label ("Add draft" above, "Add note" below —
+ * measured on Wonder Todos' drafts). One action, one place. The empty state keeps it — the moment a collection
+ * is empty is the moment the first item is created, and a resource opts out with `emptyState.primaryAction:
+ * false` — so the host drops its copy.
+ *
+ * The answer is "no" whenever the surface policy hides or collapses the empty state, so a host that asks
+ * this never removes its own button in favour of one nobody can see. Exported beside the component, and
+ * read by the component itself, so the two can never disagree about which of them renders the action.
+ */
+export declare function useResourceEmptyStateOffersPrimaryAction(config: ResourceUIBehavior_EmptyState | undefined, hasCreateOperation: boolean): boolean;
 /**
  * ResourceEmptyState — bridges resource config + i18n to the generic EmptyState preset.
  *
- * Resolves labels from i18n with the following priority:
- * 1. Resource-specific: `resources.{resourceType}.emptyState.title`
- * 2. Generic fallback: `tComponent(RESOURCES_LAYOUTS_LIST, 'noItems')`
- * 3. Hardcoded fallback: "No items found"
+ * Title: `resources.{resourceType}.emptyState.title`, else the generic `RESOURCES_LAYOUTS_LIST.noItems`.
+ * Description: `resources.{resourceType}.emptyState.description`, rendered only when it exists — it is planned
+ * only for a resource whose specification authors `frontend.emptyState.purpose`.
  *
- * Primary action:
- * - If config.primaryAction === false → no button
- * - If config.primaryAction is a string → use that operation ref (label from i18n)
- * - If config.primaryAction is undefined → auto-detect CREATE from hasCreateOperation
+ * Primary action (the collection's CREATE, named by that operation's title):
+ * - `config.primaryAction === false` → no button
+ * - otherwise → a button exactly when the caller can create (`hasCreateOperation`)
  */
 export declare function ResourceEmptyState({ resourceType, config, hasCreateOperation, onCreateAction, variant, preset, }: ResourceEmptyStateWrapperProps): React.JSX.Element | null;
 //# sourceMappingURL=resource-empty-state.d.ts.map

package/dist/esm/components/feedback/resource-empty-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-empty-state.d.ts","sourceRoot":"","sources":["../../../../../src/components/feedback/resource-empty-state.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAIvC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAC;AAG7H,OAAO,EACL,KAAK,6BAA6B,EAEnC,MAAM,+DAA+D,CAAC;AAcvE,MAAM,WAAW,8BAA+B,SAAQ,oBAAoB;IAC1E,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,6BAA6B,CAAC;IACvC,kEAAkE;IAClE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,uEAAuE;IACvE,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CACjC;AAWD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,YAAY,EACZ,MAAM,EACN,kBAA0B,EAC1B,cAAc,EACd,OAAmB,EACnB,MAAgC,GACjC,EAAE,8BAA8B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CA+F3D"}
+{"version":3,"file":"resource-empty-state.d.ts","sourceRoot":"","sources":["../../../../../src/components/feedback/resource-empty-state.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAKvC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAC;AAG7H,OAAO,EACL,KAAK,6BAA6B,EAEnC,MAAM,+DAA+D,CAAC;AAcvE,MAAM,WAAW,8BAA+B,SAAQ,oBAAoB;IAC1E,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,6BAA6B,CAAC;IACvC,kEAAkE;IAClE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,uEAAuE;IACvE,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CACjC;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wCAAwC,CACtD,MAAM,EAAE,6BAA6B,GAAG,SAAS,EACjD,kBAAkB,EAAE,OAAO,GAC1B,OAAO,CAIT;AAwBD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,YAAY,EACZ,MAAM,EACN,kBAA0B,EAC1B,cAAc,EACd,OAAmB,EACnB,MAAgC,GACjC,EAAE,8BAA8B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CA8F3D"}