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

package/dist/esm/components/data-display/display-field-resolution.utils.js

@@ -126,44 +126,25 @@ export function getParentData(data, pathPrefix) {
     return undefined;
 }
 /**
- * Build a nested object payload from a dot/bracket path.
+ * Build the UPDATE body for an inline edit of a possibly-NESTED field.
  *
- * Examples:
- * - `buildNestedObjectFromPath("address.city", "Paris")`
- *   → `{ address: { city: "Paris" } }`
- * - `buildNestedObjectFromPath("items[0].name", "A")`
- *   → `{ items: [{ name: "A" }] }`
+ * The body carries the WHOLE top-level field the path starts in, taken from the record being
+ * displayed, with the edited path written into it:
+ *
+ * - `buildInlineUpdateRequestData({ address: { city: 'A', zip: '1' } }, 'address.city', 'B')`
+ *   → `{ address: { city: 'B', zip: '1' } }`
+ * - a top-level field → `{ [field]: value }`, unchanged.
+ *
+ * The whole parent, not a nested fragment, because an UPDATE REPLACES a nested object (a `jsonb`
+ * column on PostgreSQL, a subdocument `$set` on MongoDB). This replaced `buildNestedObjectFromPath`,
+ * which sent `{ address: { city: 'B' } }` and so erased every sibling the caller never touched. The
+ * RMM lane shapes its body the same way, at its own chokepoint (`buildWireRequestData` in
+ * `ResourceMutationManager`) — this is the direct-operation fallback's copy of that rule (#1395).
  */
-export function buildNestedObjectFromPath(dotPath, value) {
-    const segments = dotPath.split('.').map(parseBracketSegment);
-    const result = {};
-    let current = result;
-    segments.forEach((segment, index) => {
-        const isLast = index === segments.length - 1;
-        const nextSegment = segments[index + 1];
-        if (segment.index != null) {
-            const arrayValue = Array.isArray(current[segment.key])
-                ? [...current[segment.key]]
-                : [];
-            current[segment.key] = arrayValue;
-            if (isLast) {
-                arrayValue[segment.index] = value;
-                return;
-            }
-            const childContainer = cloneOrCreatePathContainer(arrayValue[segment.index], nextSegment);
-            arrayValue[segment.index] = childContainer;
-            current = childContainer;
-            return;
-        }
-        if (isLast) {
-            current[segment.key] = value;
-            return;
-        }
-        const childContainer = cloneOrCreatePathContainer(current[segment.key], nextSegment);
-        current[segment.key] = childContainer;
-        current = childContainer;
-    });
-    return result;
+export function buildInlineUpdateRequestData(data, dotPath, value) {
+    const rootKey = parseBracketSegment(dotPath.split('.')[0]).key;
+    const merged = setNestedValueAtPath(data ?? {}, dotPath, value);
+    return { [rootKey]: merged[rootKey] };
 }
 /**
  * Return a shallow-cloned data object with a nested dot/bracket path updated.

package/dist/esm/components/data-display/display-field-resolution.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"display-field-resolution.utils.js","sourceRoot":"","sources":["../../../../src/components/data-display/display-field-resolution.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Display field resolution utilities for dot-path navigation.\n *\n * @internal These utilities are consumed only by `DisplayField` and are not\n * part of the public API. If future template authors need dot-path resolution,\n * re-export from the barrel at that point.\n *\n * Used by `useDisplayFieldResolution()` in DisplayField to resolve field-level\n * values (schema, data, labels) from the root-level DisplayTemplateContext\n * when DisplayField is used in name-only mode (`<DisplayField name=\"address.city\" />`).\n *\n * Building blocks:\n * - `getObjectLikeFieldShape()` — navigates Zod object schemas AND discriminated-union DTOs (polymorphic resources), handles unwrapping\n * - `unwrapSchema()` from zod-utils — strips optional/nullable wrappers at each level\n */\n\nimport type { z } from 'zod';\nimport { unwrapSchema } from '@wildo-ai/zod-decorators';\nimport { AutomatedLayoutFrontendUtils } from '~wildo-frontend-lib/core/automated-layout/automated-layout.frontend.utils';\nimport { ViewportBreakpoint } from '@wildo-ai/zod-decorators';\nimport type { ResponsiveAware } from '@wildo-ai/zod-decorators';\n\n/**\n * Parse a dot-path segment that may contain array bracket notation.\n * Returns the key and optional numeric index.\n *\n * Examples:\n *   \"items\"      → { key: \"items\" }\n *   \"items[0]\"   → { key: \"items\", index: 0 }\n *   \"items[12]\"  → { key: \"items\", index: 12 }\n */\nfunction parseBracketSegment(segment: string): { key: string; index?: number } {\n  const match = segment.match(/^(.+)\\[(\\d+)]$/);\n  if (match) {\n    return { key: match[1], index: parseInt(match[2], 10) };\n  }\n  return { key: segment };\n}\n\nfunction cloneOrCreatePathContainer(\n  currentValue: unknown,\n  nextSegment: { key: string; index?: number } | undefined,\n): Record<string, unknown> | unknown[] {\n  if (Array.isArray(currentValue)) {\n    return [...currentValue];\n  }\n\n  if (currentValue != null && typeof currentValue === 'object') {\n    return { ...(currentValue as Record<string, unknown>) };\n  }\n\n  return nextSegment?.index != null ? [] : {};\n}\n\n/**\n * Navigate a Zod root schema by dot-path to extract the nested field schema.\n *\n * Supports both dot notation and array bracket notation:\n *   - `getFieldSchema(Schema, \"address.city\")` → walks `.shape.address` → `.shape.city`\n *   - `getFieldSchema(Schema, \"items[0].name\")` → walks `.shape.items` → `.element` → `.shape.name`\n *\n * `getObjectLikeFieldShape()` internally handles unwrapping optional/nullable wrappers\n * before extracting the shape, so we don't need explicit `unwrapSchema()` calls\n * for object navigation. Array element access uses `unwrapSchema()` to strip\n * wrappers before accessing `.element`.\n *\n * @returns The field schema at the given path, or `undefined` if any segment doesn't exist\n */\nexport function getFieldSchema(rootSchema: z.ZodTypeAny | undefined, dotPath: string): z.ZodTypeAny | undefined {\n  if (!rootSchema) return undefined;\n\n  const segments = dotPath.split('.');\n  let current: z.ZodTypeAny = rootSchema;\n\n  for (const segment of segments) {\n    const { key, index } = parseBracketSegment(segment);\n\n    // Union-aware: the ROOT of a polymorphic resource is a discriminated union,\n    // for which the object-only `getObjectShape` returns null → NO field resolves\n    // (read views show raw/missing values). `getObjectLikeFieldShape` merges the\n    // union variants; for the plain nested objects walked on later segments it is\n    // identical to `getObjectShape` (it delegates to it internally).\n    const shape = AutomatedLayoutFrontendUtils.getObjectLikeFieldShape(current, { commonOnly: false }) ?? null;\n    if (!shape || !(key in shape)) return undefined;\n    current = shape[key];\n\n    if (index != null) {\n      const unwrapped = unwrapSchema(current);\n      const element = (unwrapped as z.ZodArray<z.ZodTypeAny>).element;\n      if (!element) return undefined;\n      current = element;\n    }\n  }\n\n  return current;\n}\n\n/**\n * Navigate a data object by dot-path to extract a nested value.\n *\n * Supports both dot notation and array bracket notation:\n *   - `getNestedValue(data, \"address.city\")` → `data.address.city`\n *   - `getNestedValue(data, \"items[0].name\")` → `data.items[0].name`\n *\n * @returns The value at the path, or `undefined` if any segment is missing\n */\nexport function getNestedValue(data: Record<string, unknown> | undefined, dotPath: string): unknown {\n  if (!data) return undefined;\n\n  const segments = dotPath.split('.');\n  let current: unknown = data;\n\n  for (const segment of segments) {\n    if (current == null || typeof current !== 'object') return undefined;\n\n    const { key, index } = parseBracketSegment(segment);\n    current = (current as Record<string, unknown>)[key];\n\n    if (index != null) {\n      if (!Array.isArray(current)) return undefined;\n      current = current[index];\n    }\n  }\n\n  return current;\n}\n\n/**\n * Extract the parent data object for a given path prefix.\n *\n * When `pathPrefix` is empty/falsy, returns the root data object.\n * Otherwise, navigates to the parent level using `getNestedValue`.\n *\n * Used by DisplayField to provide `parentData` to FK fields for sibling detection.\n */\nexport function getParentData(data: Record<string, unknown> | undefined, pathPrefix: string | undefined): Record<string, unknown> | undefined {\n  if (!pathPrefix || !data) return data;\n  const parentValue = getNestedValue(data, pathPrefix);\n  if (parentValue != null && typeof parentValue === 'object' && !Array.isArray(parentValue)) {\n    return parentValue as Record<string, unknown>;\n  }\n  return undefined;\n}\n\n/**\n * Build a nested object payload from a dot/bracket path.\n *\n * Examples:\n * - `buildNestedObjectFromPath(\"address.city\", \"Paris\")`\n *   → `{ address: { city: \"Paris\" } }`\n * - `buildNestedObjectFromPath(\"items[0].name\", \"A\")`\n *   → `{ items: [{ name: \"A\" }] }`\n */\nexport function buildNestedObjectFromPath(dotPath: string, value: unknown): Record<string, unknown> {\n  const segments = dotPath.split('.').map(parseBracketSegment);\n  const result: Record<string, unknown> = {};\n  let current: Record<string, unknown> | unknown[] = result;\n\n  segments.forEach((segment, index) => {\n    const isLast = index === segments.length - 1;\n    const nextSegment = segments[index + 1];\n\n    if (segment.index != null) {\n      const arrayValue = Array.isArray((current as Record<string, unknown>)[segment.key])\n        ? ([...((current as Record<string, unknown>)[segment.key] as unknown[])] as unknown[])\n        : [];\n      (current as Record<string, unknown>)[segment.key] = arrayValue;\n\n      if (isLast) {\n        arrayValue[segment.index] = value;\n        return;\n      }\n\n      const childContainer = cloneOrCreatePathContainer(arrayValue[segment.index], nextSegment);\n      arrayValue[segment.index] = childContainer;\n      current = childContainer;\n      return;\n    }\n\n    if (isLast) {\n      (current as Record<string, unknown>)[segment.key] = value;\n      return;\n    }\n\n    const childContainer = cloneOrCreatePathContainer(\n      (current as Record<string, unknown>)[segment.key],\n      nextSegment,\n    );\n    (current as Record<string, unknown>)[segment.key] = childContainer;\n    current = childContainer;\n  });\n\n  return result;\n}\n\n/**\n * Return a shallow-cloned data object with a nested dot/bracket path updated.\n *\n * This preserves sibling data while letting optimistic display state track the\n * same runtime field paths that inline-edit and file contexts use.\n */\nexport function setNestedValueAtPath(\n  data: Record<string, unknown>,\n  dotPath: string,\n  value: unknown,\n): Record<string, unknown> {\n  const segments = dotPath.split('.').map(parseBracketSegment);\n  const result = { ...data };\n  let current: Record<string, unknown> | unknown[] = result;\n\n  segments.forEach((segment, index) => {\n    const isLast = index === segments.length - 1;\n    const nextSegment = segments[index + 1];\n\n    if (segment.index != null) {\n      const existingArray = (current as Record<string, unknown>)[segment.key];\n      const arrayValue = Array.isArray(existingArray) ? [...existingArray] : [];\n      (current as Record<string, unknown>)[segment.key] = arrayValue;\n\n      if (isLast) {\n        arrayValue[segment.index] = value;\n        return;\n      }\n\n      const childContainer = cloneOrCreatePathContainer(arrayValue[segment.index], nextSegment);\n      arrayValue[segment.index] = childContainer;\n      current = childContainer;\n      return;\n    }\n\n    if (isLast) {\n      (current as Record<string, unknown>)[segment.key] = value;\n      return;\n    }\n\n    const childContainer = cloneOrCreatePathContainer(\n      (current as Record<string, unknown>)[segment.key],\n      nextSegment,\n    );\n    (current as Record<string, unknown>)[segment.key] = childContainer;\n    current = childContainer;\n  });\n\n  return result;\n}\n\n/**\n * Resolve a `ResponsiveAware<T>` value into a concrete `T` for the given viewport breakpoint.\n *\n * If the value is a plain `T` (not an object with breakpoint keys), returns it directly.\n * If it's a per-breakpoint map, returns the entry for `breakpoint`, falling back to\n * `DESKTOP` → `VERT_TABLET` → `MOBILE` → `undefined`.\n */\nexport function resolveResponsiveValue<T>(\n  value: ResponsiveAware<T> | undefined,\n  breakpoint: ViewportBreakpoint,\n): T | undefined {\n  if (value == null) return undefined;\n\n  if (typeof value !== 'object' || Array.isArray(value)) {\n    return value as T;\n  }\n\n  const isResponsiveMap = Object.keys(value).some(\n    k => k === ViewportBreakpoint.MOBILE || k === ViewportBreakpoint.VERT_TABLET || k === ViewportBreakpoint.DESKTOP,\n  );\n\n  if (!isResponsiveMap) {\n    return value as T;\n  }\n\n  const map = value as Partial<Record<ViewportBreakpoint, T>>;\n  return map[breakpoint] ?? map[ViewportBreakpoint.DESKTOP] ?? map[ViewportBreakpoint.VERT_TABLET] ?? map[ViewportBreakpoint.MOBILE];\n}\n"]}
+{"version":3,"file":"display-field-resolution.utils.js","sourceRoot":"","sources":["../../../../../src/components/data-display/display-field-resolution.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Display field resolution utilities for dot-path navigation.\n *\n * @internal These utilities are consumed only by `DisplayField` and are not\n * part of the public API. If future template authors need dot-path resolution,\n * re-export from the barrel at that point.\n *\n * Used by `useDisplayFieldResolution()` in DisplayField to resolve field-level\n * values (schema, data, labels) from the root-level DisplayTemplateContext\n * when DisplayField is used in name-only mode (`<DisplayField name=\"address.city\" />`).\n *\n * Building blocks:\n * - `getObjectLikeFieldShape()` — navigates Zod object schemas AND discriminated-union DTOs (polymorphic resources), handles unwrapping\n * - `unwrapSchema()` from zod-utils — strips optional/nullable wrappers at each level\n */\n\nimport type { z } from 'zod';\nimport { unwrapSchema } from '@wildo-ai/zod-decorators';\nimport { AutomatedLayoutFrontendUtils } from '~wildo-frontend-lib/core/automated-layout/automated-layout.frontend.utils';\nimport { ViewportBreakpoint } from '@wildo-ai/zod-decorators';\nimport type { ResponsiveAware } from '@wildo-ai/zod-decorators';\n\n/**\n * Parse a dot-path segment that may contain array bracket notation.\n * Returns the key and optional numeric index.\n *\n * Examples:\n *   \"items\"      → { key: \"items\" }\n *   \"items[0]\"   → { key: \"items\", index: 0 }\n *   \"items[12]\"  → { key: \"items\", index: 12 }\n */\nfunction parseBracketSegment(segment: string): { key: string; index?: number } {\n  const match = segment.match(/^(.+)\\[(\\d+)]$/);\n  if (match) {\n    return { key: match[1], index: parseInt(match[2], 10) };\n  }\n  return { key: segment };\n}\n\nfunction cloneOrCreatePathContainer(\n  currentValue: unknown,\n  nextSegment: { key: string; index?: number } | undefined,\n): Record<string, unknown> | unknown[] {\n  if (Array.isArray(currentValue)) {\n    return [...currentValue];\n  }\n\n  if (currentValue != null && typeof currentValue === 'object') {\n    return { ...(currentValue as Record<string, unknown>) };\n  }\n\n  return nextSegment?.index != null ? [] : {};\n}\n\n/**\n * Navigate a Zod root schema by dot-path to extract the nested field schema.\n *\n * Supports both dot notation and array bracket notation:\n *   - `getFieldSchema(Schema, \"address.city\")` → walks `.shape.address` → `.shape.city`\n *   - `getFieldSchema(Schema, \"items[0].name\")` → walks `.shape.items` → `.element` → `.shape.name`\n *\n * `getObjectLikeFieldShape()` internally handles unwrapping optional/nullable wrappers\n * before extracting the shape, so we don't need explicit `unwrapSchema()` calls\n * for object navigation. Array element access uses `unwrapSchema()` to strip\n * wrappers before accessing `.element`.\n *\n * @returns The field schema at the given path, or `undefined` if any segment doesn't exist\n */\nexport function getFieldSchema(rootSchema: z.ZodTypeAny | undefined, dotPath: string): z.ZodTypeAny | undefined {\n  if (!rootSchema) return undefined;\n\n  const segments = dotPath.split('.');\n  let current: z.ZodTypeAny = rootSchema;\n\n  for (const segment of segments) {\n    const { key, index } = parseBracketSegment(segment);\n\n    // Union-aware: the ROOT of a polymorphic resource is a discriminated union,\n    // for which the object-only `getObjectShape` returns null → NO field resolves\n    // (read views show raw/missing values). `getObjectLikeFieldShape` merges the\n    // union variants; for the plain nested objects walked on later segments it is\n    // identical to `getObjectShape` (it delegates to it internally).\n    const shape = AutomatedLayoutFrontendUtils.getObjectLikeFieldShape(current, { commonOnly: false }) ?? null;\n    if (!shape || !(key in shape)) return undefined;\n    current = shape[key];\n\n    if (index != null) {\n      const unwrapped = unwrapSchema(current);\n      const element = (unwrapped as z.ZodArray<z.ZodTypeAny>).element;\n      if (!element) return undefined;\n      current = element;\n    }\n  }\n\n  return current;\n}\n\n/**\n * Navigate a data object by dot-path to extract a nested value.\n *\n * Supports both dot notation and array bracket notation:\n *   - `getNestedValue(data, \"address.city\")` → `data.address.city`\n *   - `getNestedValue(data, \"items[0].name\")` → `data.items[0].name`\n *\n * @returns The value at the path, or `undefined` if any segment is missing\n */\nexport function getNestedValue(data: Record<string, unknown> | undefined, dotPath: string): unknown {\n  if (!data) return undefined;\n\n  const segments = dotPath.split('.');\n  let current: unknown = data;\n\n  for (const segment of segments) {\n    if (current == null || typeof current !== 'object') return undefined;\n\n    const { key, index } = parseBracketSegment(segment);\n    current = (current as Record<string, unknown>)[key];\n\n    if (index != null) {\n      if (!Array.isArray(current)) return undefined;\n      current = current[index];\n    }\n  }\n\n  return current;\n}\n\n/**\n * Extract the parent data object for a given path prefix.\n *\n * When `pathPrefix` is empty/falsy, returns the root data object.\n * Otherwise, navigates to the parent level using `getNestedValue`.\n *\n * Used by DisplayField to provide `parentData` to FK fields for sibling detection.\n */\nexport function getParentData(data: Record<string, unknown> | undefined, pathPrefix: string | undefined): Record<string, unknown> | undefined {\n  if (!pathPrefix || !data) return data;\n  const parentValue = getNestedValue(data, pathPrefix);\n  if (parentValue != null && typeof parentValue === 'object' && !Array.isArray(parentValue)) {\n    return parentValue as Record<string, unknown>;\n  }\n  return undefined;\n}\n\n/**\n * Build the UPDATE body for an inline edit of a possibly-NESTED field.\n *\n * The body carries the WHOLE top-level field the path starts in, taken from the record being\n * displayed, with the edited path written into it:\n *\n * - `buildInlineUpdateRequestData({ address: { city: 'A', zip: '1' } }, 'address.city', 'B')`\n *   → `{ address: { city: 'B', zip: '1' } }`\n * - a top-level field → `{ [field]: value }`, unchanged.\n *\n * The whole parent, not a nested fragment, because an UPDATE REPLACES a nested object (a `jsonb`\n * column on PostgreSQL, a subdocument `$set` on MongoDB). This replaced `buildNestedObjectFromPath`,\n * which sent `{ address: { city: 'B' } }` and so erased every sibling the caller never touched. The\n * RMM lane shapes its body the same way, at its own chokepoint (`buildWireRequestData` in\n * `ResourceMutationManager`) — this is the direct-operation fallback's copy of that rule (#1395).\n */\nexport function buildInlineUpdateRequestData(\n  data: Record<string, unknown> | null | undefined,\n  dotPath: string,\n  value: unknown,\n): Record<string, unknown> {\n  const rootKey = parseBracketSegment(dotPath.split('.')[0]).key;\n  const merged = setNestedValueAtPath(data ?? {}, dotPath, value);\n  return { [rootKey]: merged[rootKey] };\n}\n\n/**\n * Return a shallow-cloned data object with a nested dot/bracket path updated.\n *\n * This preserves sibling data while letting optimistic display state track the\n * same runtime field paths that inline-edit and file contexts use.\n */\nexport function setNestedValueAtPath(\n  data: Record<string, unknown>,\n  dotPath: string,\n  value: unknown,\n): Record<string, unknown> {\n  const segments = dotPath.split('.').map(parseBracketSegment);\n  const result = { ...data };\n  let current: Record<string, unknown> | unknown[] = result;\n\n  segments.forEach((segment, index) => {\n    const isLast = index === segments.length - 1;\n    const nextSegment = segments[index + 1];\n\n    if (segment.index != null) {\n      const existingArray = (current as Record<string, unknown>)[segment.key];\n      const arrayValue = Array.isArray(existingArray) ? [...existingArray] : [];\n      (current as Record<string, unknown>)[segment.key] = arrayValue;\n\n      if (isLast) {\n        arrayValue[segment.index] = value;\n        return;\n      }\n\n      const childContainer = cloneOrCreatePathContainer(arrayValue[segment.index], nextSegment);\n      arrayValue[segment.index] = childContainer;\n      current = childContainer;\n      return;\n    }\n\n    if (isLast) {\n      (current as Record<string, unknown>)[segment.key] = value;\n      return;\n    }\n\n    const childContainer = cloneOrCreatePathContainer(\n      (current as Record<string, unknown>)[segment.key],\n      nextSegment,\n    );\n    (current as Record<string, unknown>)[segment.key] = childContainer;\n    current = childContainer;\n  });\n\n  return result;\n}\n\n/**\n * Resolve a `ResponsiveAware<T>` value into a concrete `T` for the given viewport breakpoint.\n *\n * If the value is a plain `T` (not an object with breakpoint keys), returns it directly.\n * If it's a per-breakpoint map, returns the entry for `breakpoint`, falling back to\n * `DESKTOP` → `VERT_TABLET` → `MOBILE` → `undefined`.\n */\nexport function resolveResponsiveValue<T>(\n  value: ResponsiveAware<T> | undefined,\n  breakpoint: ViewportBreakpoint,\n): T | undefined {\n  if (value == null) return undefined;\n\n  if (typeof value !== 'object' || Array.isArray(value)) {\n    return value as T;\n  }\n\n  const isResponsiveMap = Object.keys(value).some(\n    k => k === ViewportBreakpoint.MOBILE || k === ViewportBreakpoint.VERT_TABLET || k === ViewportBreakpoint.DESKTOP,\n  );\n\n  if (!isResponsiveMap) {\n    return value as T;\n  }\n\n  const map = value as Partial<Record<ViewportBreakpoint, T>>;\n  return map[breakpoint] ?? map[ViewportBreakpoint.DESKTOP] ?? map[ViewportBreakpoint.VERT_TABLET] ?? map[ViewportBreakpoint.MOBILE];\n}\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/display-resource-link-trail.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"display-resource-link-trail.d.ts","sourceRoot":"","sources":["../../../../src/components/data-display/display-resource-link-trail.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACvC,iGAAiG;IACjG,YAAY,EAAE,YAAY,CAAC;IAC3B;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,sFAAsF;IACtF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,gCAAgC,CAC9C,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,KAAK,EAAE,wBAAwB,GAAG,SAAS,GAC1C,MAAM,GAAG,SAAS,CAQpB"}
+{"version":3,"file":"display-resource-link-trail.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/display-resource-link-trail.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACvC,iGAAiG;IACjG,YAAY,EAAE,YAAY,CAAC;IAC3B;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,sFAAsF;IACtF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,gCAAgC,CAC9C,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,KAAK,EAAE,wBAAwB,GAAG,SAAS,GAC1C,MAAM,GAAG,SAAS,CAQpB"}

package/dist/esm/components/data-display/display-resource-link-trail.js.map

@@ -1 +1 @@
-{"version":3,"file":"display-resource-link-trail.js","sourceRoot":"","sources":["../../../../src/components/data-display/display-resource-link-trail.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAwBH;;;;;;;GAOG;AACH,MAAM,UAAU,gCAAgC,CAC9C,SAA6B,EAC7B,KAA2C;IAE3C,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACjC,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC;QAAE,OAAO,SAAS,CAAC;IAE9D,mGAAmG;IACnG,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IACxF,OAAO,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;AAChD,CAAC","sourcesContent":["/**\n * The RESOURCE-LINK TRAIL — what the automatic display's depth guard actually counts.\n *\n * ## The correction this module exists for\n *\n * The display pipeline used to carry a bare `depth: number` that every nested object and every\n * array item incremented, capped at five, past which it printed \"Some details couldn't be\n * displayed.\" (ROBUST-02, authored 2026-04 against the reflex \"recursion must be bounded\" without\n * asking where the unboundedness comes from).\n *\n * **It counted the one thing that cannot run away, and never counted the one that can.**\n *\n * - A record's OWN structure is bounded by its schema. `icps[i].profile.firmographics.employeeRange.min`\n *   is five members deep and finite; there is no value shaped by that schema that nests forever.\n *   Counting it truncates real data — measured on wonder-crm 2026-09-02, where a live market\n *   document printed that sentence five times in a row where an employee range and five industries\n *   should have been.\n * - Following a RESOURCE LINK is what can run away. A COMPOSITION relationship object is expanded\n *   in place by `DisplayValueDispatcher` (only non-composition natures short-circuit to a reference\n *   chip), and relationships may be SELF-referencing — `selfRelationships` exists precisely so a\n *   resource can be its own parent, i.e. a tree. Task → subtasks → subtasks has no schema-imposed\n *   floor; only the data decides where it stops. Two resources composing each other is the same\n *   shape with one more hop.\n *\n * So the guard now counts CROSSINGS, and in-resource nesting is free.\n *\n * ## Why the resource type has to travel with the count\n *\n * Detecting a crossing means asking the registry \"is this field a relationship object of the\n * resource I am currently inside?\" — and *currently inside* changes the moment a crossing happens,\n * while `useResourceDisplayContext()` keeps reporting the resource at the display ROOT.\n *\n * Without carrying it, detection works exactly once. `subtasks` resolves against TASK and matches;\n * one level down the field name is `subtasks[0].subtasks`, whose root segment is `subtasks[0]`,\n * which matches no relationship at all — so the recursion the guard exists for would be the one it\n * stopped counting. The trail carries the resource reached and the path that reached it, so every\n * subsequent level asks the question against the right resource with a root-relative name.\n */\n\nimport type { ResourceType } from '@wildo-ai/saas-models';\n\n/**\n * Where the current display subtree sits relative to the display root, in RESOURCE terms.\n *\n * Absent at the root: the subtree belongs to the resource named by the display context (or to no\n * resource at all — a workbench artifact template renders a `_core` schema with no registry entry,\n * which is why every field of it must render, uncounted).\n */\nexport interface DisplayResourceLinkTrail {\n  /** The resource whose schema this subtree belongs to — the one a field name resolves against. */\n  resourceType: ResourceType;\n  /**\n   * The display-root-relative path that addressed this resource, WITHOUT the array index of the\n   * individual item (`subtasks`, never `subtasks[0]`): the trail describes the link that was\n   * followed, and every item of a to-many link followed the same link.\n   */\n  pathPrefix: string;\n  /** How many resource links were followed to get here. This is what the guard caps. */\n  linkDepth: number;\n}\n\n/**\n * The field name as the resource that owns it would spell it.\n *\n * `subtasks[0].title` under the trail `subtasks` is that resource's `title`. Returns `undefined`\n * when the name does not sit under the trail at all — a caller must then resolve nothing rather\n * than resolve against the wrong resource, which is how a nested plain field comes to be rendered\n * as somebody else's reference chip.\n */\nexport function resolveResourceRelativeFieldName(\n  fieldName: string | undefined,\n  trail: DisplayResourceLinkTrail | undefined,\n): string | undefined {\n  if (!fieldName) return undefined;\n  if (!trail) return fieldName;\n  if (!fieldName.startsWith(trail.pathPrefix)) return undefined;\n\n  // Strip the prefix, then the item indices and the separator that follow it: `[0].title` → `title`.\n  const relative = fieldName.slice(trail.pathPrefix.length).replace(/^(\\[\\d+\\])*\\.?/, '');\n  return relative === '' ? undefined : relative;\n}\n"]}
+{"version":3,"file":"display-resource-link-trail.js","sourceRoot":"","sources":["../../../../../src/components/data-display/display-resource-link-trail.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAwBH;;;;;;;GAOG;AACH,MAAM,UAAU,gCAAgC,CAC9C,SAA6B,EAC7B,KAA2C;IAE3C,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACjC,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC;QAAE,OAAO,SAAS,CAAC;IAE9D,mGAAmG;IACnG,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IACxF,OAAO,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;AAChD,CAAC","sourcesContent":["/**\n * The RESOURCE-LINK TRAIL — what the automatic display's depth guard actually counts.\n *\n * ## The correction this module exists for\n *\n * The display pipeline used to carry a bare `depth: number` that every nested object and every\n * array item incremented, capped at five, past which it printed \"Some details couldn't be\n * displayed.\" (ROBUST-02, authored 2026-04 against the reflex \"recursion must be bounded\" without\n * asking where the unboundedness comes from).\n *\n * **It counted the one thing that cannot run away, and never counted the one that can.**\n *\n * - A record's OWN structure is bounded by its schema. `icps[i].profile.firmographics.employeeRange.min`\n *   is five members deep and finite; there is no value shaped by that schema that nests forever.\n *   Counting it truncates real data — measured on wonder-crm 2026-09-02, where a live market\n *   document printed that sentence five times in a row where an employee range and five industries\n *   should have been.\n * - Following a RESOURCE LINK is what can run away. A COMPOSITION relationship object is expanded\n *   in place by `DisplayValueDispatcher` (only non-composition natures short-circuit to a reference\n *   chip), and relationships may be SELF-referencing — `selfRelationships` exists precisely so a\n *   resource can be its own parent, i.e. a tree. Task → subtasks → subtasks has no schema-imposed\n *   floor; only the data decides where it stops. Two resources composing each other is the same\n *   shape with one more hop.\n *\n * So the guard now counts CROSSINGS, and in-resource nesting is free.\n *\n * ## Why the resource type has to travel with the count\n *\n * Detecting a crossing means asking the registry \"is this field a relationship object of the\n * resource I am currently inside?\" — and *currently inside* changes the moment a crossing happens,\n * while `useResourceDisplayContext()` keeps reporting the resource at the display ROOT.\n *\n * Without carrying it, detection works exactly once. `subtasks` resolves against TASK and matches;\n * one level down the field name is `subtasks[0].subtasks`, whose root segment is `subtasks[0]`,\n * which matches no relationship at all — so the recursion the guard exists for would be the one it\n * stopped counting. The trail carries the resource reached and the path that reached it, so every\n * subsequent level asks the question against the right resource with a root-relative name.\n */\n\nimport type { ResourceType } from '@wildo-ai/saas-models';\n\n/**\n * Where the current display subtree sits relative to the display root, in RESOURCE terms.\n *\n * Absent at the root: the subtree belongs to the resource named by the display context (or to no\n * resource at all — a workbench artifact template renders a `_core` schema with no registry entry,\n * which is why every field of it must render, uncounted).\n */\nexport interface DisplayResourceLinkTrail {\n  /** The resource whose schema this subtree belongs to — the one a field name resolves against. */\n  resourceType: ResourceType;\n  /**\n   * The display-root-relative path that addressed this resource, WITHOUT the array index of the\n   * individual item (`subtasks`, never `subtasks[0]`): the trail describes the link that was\n   * followed, and every item of a to-many link followed the same link.\n   */\n  pathPrefix: string;\n  /** How many resource links were followed to get here. This is what the guard caps. */\n  linkDepth: number;\n}\n\n/**\n * The field name as the resource that owns it would spell it.\n *\n * `subtasks[0].title` under the trail `subtasks` is that resource's `title`. Returns `undefined`\n * when the name does not sit under the trail at all — a caller must then resolve nothing rather\n * than resolve against the wrong resource, which is how a nested plain field comes to be rendered\n * as somebody else's reference chip.\n */\nexport function resolveResourceRelativeFieldName(\n  fieldName: string | undefined,\n  trail: DisplayResourceLinkTrail | undefined,\n): string | undefined {\n  if (!fieldName) return undefined;\n  if (!trail) return fieldName;\n  if (!fieldName.startsWith(trail.pathPrefix)) return undefined;\n\n  // Strip the prefix, then the item indices and the separator that follow it: `[0].title` → `title`.\n  const relative = fieldName.slice(trail.pathPrefix.length).replace(/^(\\[\\d+\\])*\\.?/, '');\n  return relative === '' ? undefined : relative;\n}\n"]}

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

@@ -0,0 +1,46 @@
+import * as React from 'react';
+import { TextSize, TextVariant } from '@wildo-ai/presets-components-models';
+import type { ComponentPresetProps } from '../../core/components-registry/component-registry.frontend.schemas';
+/**
+ * Duration — how long something has been going, TICKING while it still is.
+ *
+ * ## The question it answers, which a timestamp cannot
+ *
+ * `Started at 2026-09-17T10:22:09Z` says WHEN. The question an operator watching a long-running
+ * process actually has is whether it is still moving, and a frozen number cannot answer it: a
+ * surface that polls every 5–60 seconds computes its duration at render, so a live run and a hung
+ * one look identical between polls. A clock that ticks beside an unsettled record is the surface
+ * saying "I am still watching this" — which a disabled button and a stale instant cannot say.
+ *
+ * So an UNSETTLED duration owns a one-second tick, and a SETTLED one does not: once `until` is known
+ * the number can never change again, and a timer behind it would be pure churn.
+ *
+ * ## Distinct from the duration FIELD, and the difference is the value
+ *
+ * `DisplayFieldDuration` renders a `{ value, unit }` a record CARRIES — a declared timeout, a
+ * billing period — with full unit words from the `DurationUnit` system enum. This renders a span
+ * BETWEEN TWO INSTANTS, compactly, beside the thing it is timing. Same subject, different value and
+ * different density; merging them would make one of the two read wrong.
+ *
+ * ## Unparseable in, nothing out
+ *
+ * A `since` or `until` that does not parse renders NOTHING rather than `NaN` or `0s`. Both of those
+ * are readable as a measurement, and a measurement is precisely what is not available when the
+ * server sent an instant the browser could not read.
+ */
+export interface DurationProps {
+    /** ISO instant the span starts at. */
+    since: string;
+    /** ISO instant it ended. ABSENT means still running — this is what turns the tick on. */
+    until?: string;
+    size?: TextSize;
+    variant?: TextVariant;
+    className?: string;
+}
+type DurationWrapperProps = DurationProps & ComponentPresetProps;
+export declare function Duration({ preset, ...props }: DurationWrapperProps): React.JSX.Element;
+export declare namespace Duration {
+    var displayName: string;
+}
+export {};
+//# sourceMappingURL=duration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/duration.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAA0C,QAAQ,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAA;AAEnH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AAG5H;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,yFAAyF;IACzF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAGD,KAAK,oBAAoB,GAAG,aAAa,GAAG,oBAAoB,CAAA;AAEhE,wBAAgB,QAAQ,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAGhH;yBAHe,QAAQ"}

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

@@ -0,0 +1,9 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { CorePresetNames, FrontendComponentType } from '@wildo-ai/presets-components-models';
+import { createComponentResolver } from '../../core/components-registry/component-resolver.frontend.helper.js';
+export function Duration({ preset = CorePresetNames.DEFAULT, ...props }) {
+    const Component = createComponentResolver(FrontendComponentType.LOW_LEVEL_DURATION, 'Duration')(preset);
+    return _jsx(Component, { ...props });
+}
+Duration.displayName = 'Duration';
+//# sourceMappingURL=duration.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duration.js","sourceRoot":"","sources":["../../../../../src/components/data-display/duration.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAyB,MAAM,qCAAqC,CAAA;AACnH,OAAO,EAAE,uBAAuB,EAAE,MAAM,iFAAiF,CAAA;AA4CzH,MAAM,UAAU,QAAQ,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAwB;IAC3F,MAAM,SAAS,GAAG,uBAAuB,CAAgB,qBAAqB,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC,MAAM,CAAC,CAAA;IACtH,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC;AAED,QAAQ,CAAC,WAAW,GAAG,UAAU,CAAA","sourcesContent":["import * as React from 'react'\nimport { CorePresetNames, FrontendComponentType, TextSize, TextVariant } from '@wildo-ai/presets-components-models'\nimport { createComponentResolver } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper'\nimport type { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas'\n\n// --- Contract ---\n/**\n * Duration — how long something has been going, TICKING while it still is.\n *\n * ## The question it answers, which a timestamp cannot\n *\n * `Started at 2026-09-17T10:22:09Z` says WHEN. The question an operator watching a long-running\n * process actually has is whether it is still moving, and a frozen number cannot answer it: a\n * surface that polls every 5–60 seconds computes its duration at render, so a live run and a hung\n * one look identical between polls. A clock that ticks beside an unsettled record is the surface\n * saying \"I am still watching this\" — which a disabled button and a stale instant cannot say.\n *\n * So an UNSETTLED duration owns a one-second tick, and a SETTLED one does not: once `until` is known\n * the number can never change again, and a timer behind it would be pure churn.\n *\n * ## Distinct from the duration FIELD, and the difference is the value\n *\n * `DisplayFieldDuration` renders a `{ value, unit }` a record CARRIES — a declared timeout, a\n * billing period — with full unit words from the `DurationUnit` system enum. This renders a span\n * BETWEEN TWO INSTANTS, compactly, beside the thing it is timing. Same subject, different value and\n * different density; merging them would make one of the two read wrong.\n *\n * ## Unparseable in, nothing out\n *\n * A `since` or `until` that does not parse renders NOTHING rather than `NaN` or `0s`. Both of those\n * are readable as a measurement, and a measurement is precisely what is not available when the\n * server sent an instant the browser could not read.\n */\nexport interface DurationProps {\n  /** ISO instant the span starts at. */\n  since: string\n  /** ISO instant it ended. ABSENT means still running — this is what turns the tick on. */\n  until?: string\n  size?: TextSize\n  variant?: TextVariant\n  className?: string\n}\n\n// --- Wrapper (resolve preset) ---\ntype DurationWrapperProps = DurationProps & ComponentPresetProps\n\nexport function Duration({ preset = CorePresetNames.DEFAULT, ...props }: DurationWrapperProps): React.JSX.Element {\n  const Component = createComponentResolver<DurationProps>(FrontendComponentType.LOW_LEVEL_DURATION, 'Duration')(preset)\n  return <Component {...props} />\n}\n\nDuration.displayName = 'Duration'\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":"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","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"}