@wildo-ai/saas-frontend-lib 1.1.9 → 1.1.11

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

@@ -6,9 +6,11 @@
  *
  * 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
+ * would have to sit in every application's tree for a read most of them never make. So the cache is keyed by the HTTP
+ * CLIENT and the RESOLVED URL (#2109). The URL already names the organization, so switching organizations reads a
+ * different entry and never shows another tenant's answer; the client names the BACKEND, because a path is relative to
+ * `/api/v1` and two applications rendered in one page (a workbench, a test harness) share paths but not backends. A path
+ * alone handed the second application the first one's answer. 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.
  *
@@ -64,9 +66,17 @@ export function buildExternalDataProvenancePath(params) {
         return undefined;
     return `${resolved}/${EXTERNAL_DATA_PROVENANCE_ROUTE_SEGMENT}`;
 }
-const cache = new Map();
-const inFlight = new Map();
+/** One store per client, so an answer read through one backend is never shown for another (#2109). */
+let stores = new WeakMap();
 const listeners = new Set();
+function storeOf(client) {
+    let store = stores.get(client);
+    if (!store) {
+        store = { cache: new Map(), inFlight: new Map() };
+        stores.set(client, store);
+    }
+    return store;
+}
 function notify() {
     for (const listener of listeners)
         listener();
@@ -80,21 +90,22 @@ export function subscribeExternalDataProvenance(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;
+export function msUntilExternalDataProvenanceExpires(path, client, now = Date.now()) {
+    const entry = path && client ? stores.get(client)?.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)
+export function peekExternalDataProvenance(path, client) {
+    if (!path || !client)
         return undefined;
-    return cache.get(path)?.value;
+    return stores.get(client)?.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 { cache, inFlight } = storeOf(httpClient);
     const entry = cache.get(path);
     if (entry && now - entry.fetchedAt < EXTERNAL_DATA_PROVENANCE_TTL_MS)
         return;
@@ -117,8 +128,7 @@ export function ensureExternalDataProvenance(path, httpClient, now = Date.now())
 }
 /** Test seam: forget every cached answer. */
 export function resetExternalDataProvenanceCache() {
-    cache.clear();
-    inFlight.clear();
+    stores = new WeakMap();
     notify();
 }
 //# sourceMappingURL=external-data-provenance.frontend.js.map

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

@@ -1 +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"]}
+{"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 HTTP\n * CLIENT and the RESOLVED URL (#2109). The URL already names the organization, so switching organizations reads a\n * different entry and never shows another tenant's answer; the client names the BACKEND, because a path is relative to\n * `/api/v1` and two applications rendered in one page (a workbench, a test harness) share paths but not backends. A path\n * alone handed the second application the first one's answer. 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\n/** The client a read goes through; only its identity and `get` are used. */\ntype ProvenanceClient = Pick<WildoBackendHttpClient, 'get'>;\n\ninterface ClientStore {\n  readonly cache: Map<string, CacheEntry>;\n  readonly inFlight: Map<string, Promise<void>>;\n}\n\n/** One store per client, so an answer read through one backend is never shown for another (#2109). */\nlet stores = new WeakMap<ProvenanceClient, ClientStore>();\nconst listeners = new Set<() => void>();\n\nfunction storeOf(client: ProvenanceClient): ClientStore {\n  let store = stores.get(client);\n  if (!store) {\n    store = { cache: new Map(), inFlight: new Map() };\n    stores.set(client, store);\n  }\n  return store;\n}\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(\n  path: string | undefined,\n  client: ProvenanceClient | undefined,\n  now: number = Date.now(),\n): number | undefined {\n  const entry = path && client ? stores.get(client)?.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, client: ProvenanceClient | undefined): ExternalDataProvenanceResponse | null | undefined {\n  if (!path || !client) return undefined;\n  return stores.get(client)?.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: ProvenanceClient, now: number = Date.now()): void {\n  const { cache, inFlight } = storeOf(httpClient);\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  stores = new WeakMap();\n  notify();\n}\n"]}

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

@@ -27,7 +27,7 @@ export function useExternalDataFieldProvenance(params) {
     const path = useMemo(() => (isSyncedField && resourceConfiguration
         ? buildExternalDataProvenancePath({ resourceConfiguration, contextualParameters: contextualParameters ?? {} })
         : undefined), [isSyncedField, resourceConfiguration, contextualParameters]);
-    const answer = useSyncExternalStore(subscribeExternalDataProvenance, () => peekExternalDataProvenance(path));
+    const answer = useSyncExternalStore(subscribeExternalDataProvenance, () => peekExternalDataProvenance(path, httpClient));
     // 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.
@@ -35,7 +35,7 @@ export function useExternalDataFieldProvenance(params) {
         if (!path || !httpClient)
             return undefined;
         ensureExternalDataProvenance(path, httpClient);
-        const expiresIn = msUntilExternalDataProvenanceExpires(path);
+        const expiresIn = msUntilExternalDataProvenanceExpires(path, httpClient);
         if (expiresIn === undefined)
             return undefined;
         const timer = setTimeout(() => ensureExternalDataProvenance(path, httpClient), expiresIn + 1);

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

@@ -1 +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"]}
+{"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,EAAE,UAAU,CAAC,CAAC,CAAC;IAEzH,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,EAAE,UAAU,CAAC,CAAC;QACzE,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, httpClient));\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, httpClient);\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/data-display/reference-display-target.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Which record a displayed REFERENCE points at — the referenced resource type and the referenced ids — resolved
+ * ONCE, for every reader that must agree on it.
+ *
+ * Two readers decide something about the same reference and used to resolve it separately:
+ *
+ * - `DisplayValueDispatcher` chooses the reference branch and hands the reference preset its target type;
+ * - `DisplayField` decides whether the whole field is a hidden parent reference (`ParentDisplay.NONE`) and must be
+ *   omitted, box and all (#2195).
+ *
+ * When `DisplayField` resolved the type its own way (declared type, else the field-name map keyed by the LAST path
+ * segment) while the preset resolved it the dispatcher's way (per-record polymorphic branch, declared type, then the
+ * map keyed by the FULL name), the two could disagree — on a nested path, a polymorphic FK, or a relationship object
+ * that is not an FK schema at all. The result was a field box with nothing in it. So both now read this module.
+ */
+import type { z } from 'zod';
+import { type ResourceType } from '@wildo-ai/saas-models';
+import type { FrontendResourcesRegistry } from '../../core/resources/resources.frontend.schemas';
+import { type DisplayResourceLinkTrail } from './display-resource-link-trail';
+export declare function getLeafFieldName(fieldName: string | undefined): string | undefined;
+/**
+ * Resolve the concrete branch a per-record DISCRIMINATED polymorphic FK points
+ * at (e.g. a referral's `referrerBillingAccountId` → `userBillingAccounts` vs
+ * `organizationBillingAccounts`, chosen by `referrerScopeType`).
+ *
+ * Returns `undefined` for plain / rename-only FKs (the reference component then
+ * falls back to the field-name → type map) and when the holder record or
+ * discriminator value is unavailable. When defined, the value is passed as the
+ * explicit `resourceType` so display label, link, and FK fetch all target the
+ * correct branch.
+ */
+export declare function resolveDiscriminatedPolymorphicFkResourceType(params: {
+    schema: z.ZodTypeAny;
+    fieldName: string | undefined;
+    parentData: Record<string, unknown> | undefined;
+    currentResourceType: ResourceType | undefined;
+    registry: FrontendResourcesRegistry | undefined;
+}): string | undefined;
+/**
+ * The type an FK field references, in the reference preset's order: an explicit type (the dispatcher's per-record
+ * polymorphic resolution), then the decorator's declared `referencedResourceType`, then the registry's
+ * field-to-resource map keyed by the field's FULL name. `undefined` when none answers — the preset turns that into
+ * its configuration error; a reader that only asks a question (is this hidden?) treats it as "not that reference".
+ */
+export declare function resolveForeignKeyReferencedResourceType(params: {
+    explicitResourceType: string | undefined;
+    schema: z.ZodTypeAny | undefined;
+    fieldName: string | undefined;
+    registry: FrontendResourcesRegistry | undefined;
+}): string | undefined;
+export declare function extractRelationshipDisplayValue(value: unknown, relationshipIdentifierField: string): string | string[] | undefined;
+/**
+ * The relationship read surface of a field that holds a RELATED RECORD (or records) rather than an FK id — the
+ * dispatcher's relationship-object branch. Resolved against the resource that owns the field, by the name that
+ * resource spells it.
+ *
+ * Both come from the TRAIL once a resource link has been followed, because `useResourceDisplayContext()` keeps
+ * reporting the resource at the display ROOT no matter how deep the recursion is. Resolving against the root with a
+ * nested name is why the registry saw `subtasks[0].subtasks` — root segment `subtasks[0]`, matching no relationship —
+ * and reported "not a relationship" for the very recursion the depth guard exists to bound.
+ *
+ * It asks the READ question only (`resolveRelationshipReadSurface`), never the whole relationship runtime. That runtime
+ * also resolves the write and inline-edit surfaces, whose quick-create resolution fails closed in development when a
+ * foreign key is reached by two relationships — a question that matters to a picker and not at all to a display. An
+ * organization membership's `userId` is exactly that case (`user_self → organizationMembers` and the users ↔
+ * organizations junction edge both resolve it), so once a table cell read in its row's resource type (#2347) every
+ * Members row rendered "Error rendering field userId" (#2427).
+ */
+export declare function resolveRelationshipObjectReadSurface(params: {
+    fieldName: string | undefined;
+    resourceLinkTrail: DisplayResourceLinkTrail | undefined;
+    currentResourceType: ResourceType | undefined;
+    registry: FrontendResourcesRegistry | undefined;
+}): import("../../core/resources/relationship-surface-runtime.frontend.utils").RelationshipReadSurfaceDescriptor;
+/** What a displayed reference points at: the referenced type (when resolvable) and the referenced ids. */
+export interface ReferenceDisplayTarget {
+    referencedResourceType: string | undefined;
+    referencedIds: string[];
+}
+/**
+ * The reference a display field renders, exactly as `DisplayValueDispatcher` routes it to the reference preset —
+ * `undefined` when the field is not a reference at all.
+ *
+ * - An FK schema → the FK branch: the polymorphic branch for this record, else the declared type, else the field
+ *   map; the ids are the value.
+ * - A non-composition relationship object with an object identity → the relationship branch: the related type; the
+ *   ids are read off the related record(s).
+ */
+export declare function resolveReferenceDisplayTarget(params: {
+    schema: z.ZodTypeAny | undefined;
+    value: unknown;
+    fieldName: string | undefined;
+    parentData: Record<string, unknown> | undefined;
+    resourceLinkTrail: DisplayResourceLinkTrail | undefined;
+    currentResourceType: ResourceType | undefined;
+    registry: FrontendResourcesRegistry | undefined;
+}): ReferenceDisplayTarget | undefined;
+//# sourceMappingURL=reference-display-target.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reference-display-target.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/reference-display-target.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,EAA6C,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+DAA+D,CAAC;AAE/G,OAAO,EAAoC,KAAK,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEhH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAMlF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,6CAA6C,CAAC,MAAM,EAAE;IACpE,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAChD,mBAAmB,EAAE,YAAY,GAAG,SAAS,CAAC;IAC9C,QAAQ,EAAE,yBAAyB,GAAG,SAAS,CAAC;CACjD,GAAG,MAAM,GAAG,SAAS,CAuBrB;AAED;;;;;GAKG;AACH,wBAAgB,uCAAuC,CAAC,MAAM,EAAE;IAC9D,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,SAAS,CAAC;IACjC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,QAAQ,EAAE,yBAAyB,GAAG,SAAS,CAAC;CACjD,GAAG,MAAM,GAAG,SAAS,CAKrB;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,OAAO,EACd,2BAA2B,EAAE,MAAM,GAClC,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAkC/B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oCAAoC,CAAC,MAAM,EAAE;IAC3D,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,iBAAiB,EAAE,wBAAwB,GAAG,SAAS,CAAC;IACxD,mBAAmB,EAAE,YAAY,GAAG,SAAS,CAAC;IAC9C,QAAQ,EAAE,yBAAyB,GAAG,SAAS,CAAC;CACjD,8HAYA;AAED,0GAA0G;AAC1G,MAAM,WAAW,sBAAsB;IACrC,sBAAsB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAWD;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IACpD,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,SAAS,CAAC;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAChD,iBAAiB,EAAE,wBAAwB,GAAG,SAAS,CAAC;IACxD,mBAAmB,EAAE,YAAY,GAAG,SAAS,CAAC;IAC9C,QAAQ,EAAE,yBAAyB,GAAG,SAAS,CAAC;CACjD,GAAG,sBAAsB,GAAG,SAAS,CA2BrC"}

package/dist/esm/components/data-display/reference-display-target.js

@@ -0,0 +1,154 @@
+import { getDiscriminatedPolymorphicForeignKey, getForeignKeyParams, isForeignKey } from '@wildo-ai/zod-decorators';
+import { RelationshipNature, Resources_SharedUtils } from '@wildo-ai/saas-models';
+import { resolveRelationshipReadSurface } from '../../core/resources/relationship-surface-runtime.frontend.utils.js';
+import { normalizeResourceReferenceSelectionValue } from '../../components/resources-fields/resource-reference/resource-reference.shared.utils.js';
+import { resolveResourceRelativeFieldName } from './display-resource-link-trail.js';
+export function getLeafFieldName(fieldName) {
+    if (!fieldName) {
+        return undefined;
+    }
+    return fieldName.includes('.') ? fieldName.split('.').pop() : fieldName;
+}
+/**
+ * Resolve the concrete branch a per-record DISCRIMINATED polymorphic FK points
+ * at (e.g. a referral's `referrerBillingAccountId` → `userBillingAccounts` vs
+ * `organizationBillingAccounts`, chosen by `referrerScopeType`).
+ *
+ * Returns `undefined` for plain / rename-only FKs (the reference component then
+ * falls back to the field-name → type map) and when the holder record or
+ * discriminator value is unavailable. When defined, the value is passed as the
+ * explicit `resourceType` so display label, link, and FK fetch all target the
+ * correct branch.
+ */
+export function resolveDiscriminatedPolymorphicFkResourceType(params) {
+    const discriminated = getDiscriminatedPolymorphicForeignKey(params.schema);
+    if (!discriminated || !params.parentData || !params.currentResourceType || !params.registry) {
+        return undefined;
+    }
+    const leafFieldName = getLeafFieldName(params.fieldName);
+    if (!leafFieldName)
+        return undefined;
+    const candidateReferencedTypes = Resources_SharedUtils.getForeignKeyCandidateReferencedTypes(leafFieldName, params.currentResourceType, params.registry.resourceRelationships);
+    if (candidateReferencedTypes.length === 0)
+        return undefined;
+    return Resources_SharedUtils.resolveDiscriminatedPolymorphicForeignKeyTarget({
+        record: params.parentData,
+        discriminatorField: discriminated.discriminatorField,
+        variants: discriminated.variants,
+        candidateReferencedTypes,
+        getResourcePrimaryScope: (resourceType) => params.registry?.resourceConfigurations[resourceType]?.resourcePrimaryScope,
+    });
+}
+/**
+ * The type an FK field references, in the reference preset's order: an explicit type (the dispatcher's per-record
+ * polymorphic resolution), then the decorator's declared `referencedResourceType`, then the registry's
+ * field-to-resource map keyed by the field's FULL name. `undefined` when none answers — the preset turns that into
+ * its configuration error; a reader that only asks a question (is this hidden?) treats it as "not that reference".
+ */
+export function resolveForeignKeyReferencedResourceType(params) {
+    return params.explicitResourceType
+        || (params.schema ? getForeignKeyParams(params.schema)?.referencedResourceType : undefined)
+        || (params.fieldName ? params.registry?.fieldIdentifierToResourceType?.[params.fieldName] : undefined)
+        || undefined;
+}
+export function extractRelationshipDisplayValue(value, relationshipIdentifierField) {
+    if (Array.isArray(value)) {
+        const ids = value.flatMap((entry) => {
+            if (typeof entry === 'string' && entry !== '') {
+                return [entry];
+            }
+            if (!entry || typeof entry !== 'object') {
+                return [];
+            }
+            const rawId = entry[relationshipIdentifierField]
+                ?? entry._id
+                ?? entry.id;
+            return typeof rawId === 'string' && rawId !== '' ? [rawId] : [];
+        });
+        return ids.length > 0 ? ids : undefined;
+    }
+    if (typeof value === 'string' && value !== '') {
+        return value;
+    }
+    if (!value || typeof value !== 'object') {
+        return undefined;
+    }
+    const rawId = value[relationshipIdentifierField]
+        ?? value._id
+        ?? value.id;
+    return typeof rawId === 'string' && rawId !== '' ? rawId : undefined;
+}
+/**
+ * The relationship read surface of a field that holds a RELATED RECORD (or records) rather than an FK id — the
+ * dispatcher's relationship-object branch. Resolved against the resource that owns the field, by the name that
+ * resource spells it.
+ *
+ * Both come from the TRAIL once a resource link has been followed, because `useResourceDisplayContext()` keeps
+ * reporting the resource at the display ROOT no matter how deep the recursion is. Resolving against the root with a
+ * nested name is why the registry saw `subtasks[0].subtasks` — root segment `subtasks[0]`, matching no relationship —
+ * and reported "not a relationship" for the very recursion the depth guard exists to bound.
+ *
+ * It asks the READ question only (`resolveRelationshipReadSurface`), never the whole relationship runtime. That runtime
+ * also resolves the write and inline-edit surfaces, whose quick-create resolution fails closed in development when a
+ * foreign key is reached by two relationships — a question that matters to a picker and not at all to a display. An
+ * organization membership's `userId` is exactly that case (`user_self → organizationMembers` and the users ↔
+ * organizations junction edge both resolve it), so once a table cell read in its row's resource type (#2347) every
+ * Members row rendered "Error rendering field userId" (#2427).
+ */
+export function resolveRelationshipObjectReadSurface(params) {
+    const owningResourceType = params.resourceLinkTrail?.resourceType ?? params.currentResourceType;
+    const resourceRelativeFieldName = resolveResourceRelativeFieldName(params.fieldName, params.resourceLinkTrail);
+    if (!owningResourceType || !resourceRelativeFieldName || !params.registry) {
+        return undefined;
+    }
+    return resolveRelationshipReadSurface({
+        resourceType: owningResourceType,
+        fieldName: resourceRelativeFieldName,
+        registry: params.registry,
+    });
+}
+/**
+ * The ids a reference value names — by the reference preset's own normalisation, so both readers hand
+ * `withoutHiddenParentReference` the SAME list. A second normaliser that kept what the preset drops (a number in an
+ * array) would let the field keep its box while the preset drew nothing.
+ */
+function toReferencedIds(value) {
+    return normalizeResourceReferenceSelectionValue(value);
+}
+/**
+ * The reference a display field renders, exactly as `DisplayValueDispatcher` routes it to the reference preset —
+ * `undefined` when the field is not a reference at all.
+ *
+ * - An FK schema → the FK branch: the polymorphic branch for this record, else the declared type, else the field
+ *   map; the ids are the value.
+ * - A non-composition relationship object with an object identity → the relationship branch: the related type; the
+ *   ids are read off the related record(s).
+ */
+export function resolveReferenceDisplayTarget(params) {
+    if (params.schema && isForeignKey(params.schema)) {
+        return {
+            referencedResourceType: resolveForeignKeyReferencedResourceType({
+                explicitResourceType: resolveDiscriminatedPolymorphicFkResourceType({
+                    schema: params.schema,
+                    fieldName: params.fieldName,
+                    parentData: params.parentData,
+                    currentResourceType: params.currentResourceType,
+                    registry: params.registry,
+                }),
+                schema: params.schema,
+                fieldName: params.fieldName,
+                registry: params.registry,
+            }),
+            referencedIds: toReferencedIds(params.value),
+        };
+    }
+    const readSurface = resolveRelationshipObjectReadSurface(params);
+    if (!readSurface || readSurface.semantics.nature === RelationshipNature.COMPOSITION || !readSurface.objectIdentity) {
+        return undefined;
+    }
+    return {
+        referencedResourceType: readSurface.relatedResourceType,
+        referencedIds: toReferencedIds(extractRelationshipDisplayValue(params.value, readSurface.objectIdentity.relationshipIdentifierField)),
+    };
+}
+//# sourceMappingURL=reference-display-target.js.map

package/dist/esm/components/data-display/reference-display-target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-display-target.js","sourceRoot":"","sources":["../../../../../src/components/data-display/reference-display-target.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Which record a displayed REFERENCE points at — the referenced resource type and the referenced ids — resolved\n * ONCE, for every reader that must agree on it.\n *\n * Two readers decide something about the same reference and used to resolve it separately:\n *\n * - `DisplayValueDispatcher` chooses the reference branch and hands the reference preset its target type;\n * - `DisplayField` decides whether the whole field is a hidden parent reference (`ParentDisplay.NONE`) and must be\n *   omitted, box and all (#2195).\n *\n * When `DisplayField` resolved the type its own way (declared type, else the field-name map keyed by the LAST path\n * segment) while the preset resolved it the dispatcher's way (per-record polymorphic branch, declared type, then the\n * map keyed by the FULL name), the two could disagree — on a nested path, a polymorphic FK, or a relationship object\n * that is not an FK schema at all. The result was a field box with nothing in it. So both now read this module.\n */\nimport type { z } from 'zod';\nimport { getDiscriminatedPolymorphicForeignKey, getForeignKeyParams, isForeignKey } from '@wildo-ai/zod-decorators';\nimport { RelationshipNature, Resources_SharedUtils, type ResourceType } from '@wildo-ai/saas-models';\nimport { resolveRelationshipReadSurface } from '~wildo-frontend-lib/core/resources/relationship-surface-runtime.frontend.utils';\nimport type { FrontendResourcesRegistry } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { normalizeResourceReferenceSelectionValue } from '~wildo-frontend-lib/components/resources-fields/resource-reference/resource-reference.shared.utils';\nimport { resolveResourceRelativeFieldName, type DisplayResourceLinkTrail } from './display-resource-link-trail';\n\nexport function getLeafFieldName(fieldName: string | undefined): string | undefined {\n  if (!fieldName) {\n    return undefined;\n  }\n\n  return fieldName.includes('.') ? fieldName.split('.').pop() : fieldName;\n}\n\n/**\n * Resolve the concrete branch a per-record DISCRIMINATED polymorphic FK points\n * at (e.g. a referral's `referrerBillingAccountId` → `userBillingAccounts` vs\n * `organizationBillingAccounts`, chosen by `referrerScopeType`).\n *\n * Returns `undefined` for plain / rename-only FKs (the reference component then\n * falls back to the field-name → type map) and when the holder record or\n * discriminator value is unavailable. When defined, the value is passed as the\n * explicit `resourceType` so display label, link, and FK fetch all target the\n * correct branch.\n */\nexport function resolveDiscriminatedPolymorphicFkResourceType(params: {\n  schema: z.ZodTypeAny;\n  fieldName: string | undefined;\n  parentData: Record<string, unknown> | undefined;\n  currentResourceType: ResourceType | undefined;\n  registry: FrontendResourcesRegistry | undefined;\n}): string | undefined {\n  const discriminated = getDiscriminatedPolymorphicForeignKey(params.schema);\n  if (!discriminated || !params.parentData || !params.currentResourceType || !params.registry) {\n    return undefined;\n  }\n  const leafFieldName = getLeafFieldName(params.fieldName);\n  if (!leafFieldName) return undefined;\n\n  const candidateReferencedTypes = Resources_SharedUtils.getForeignKeyCandidateReferencedTypes(\n    leafFieldName,\n    params.currentResourceType,\n    params.registry.resourceRelationships,\n  );\n  if (candidateReferencedTypes.length === 0) return undefined;\n\n  return Resources_SharedUtils.resolveDiscriminatedPolymorphicForeignKeyTarget({\n    record: params.parentData,\n    discriminatorField: discriminated.discriminatorField,\n    variants: discriminated.variants,\n    candidateReferencedTypes,\n    getResourcePrimaryScope: (resourceType) =>\n      params.registry?.resourceConfigurations[resourceType]?.resourcePrimaryScope,\n  });\n}\n\n/**\n * The type an FK field references, in the reference preset's order: an explicit type (the dispatcher's per-record\n * polymorphic resolution), then the decorator's declared `referencedResourceType`, then the registry's\n * field-to-resource map keyed by the field's FULL name. `undefined` when none answers — the preset turns that into\n * its configuration error; a reader that only asks a question (is this hidden?) treats it as \"not that reference\".\n */\nexport function resolveForeignKeyReferencedResourceType(params: {\n  explicitResourceType: string | undefined;\n  schema: z.ZodTypeAny | undefined;\n  fieldName: string | undefined;\n  registry: FrontendResourcesRegistry | undefined;\n}): string | undefined {\n  return params.explicitResourceType\n    || (params.schema ? getForeignKeyParams(params.schema)?.referencedResourceType : undefined)\n    || (params.fieldName ? params.registry?.fieldIdentifierToResourceType?.[params.fieldName] : undefined)\n    || undefined;\n}\n\nexport function extractRelationshipDisplayValue(\n  value: unknown,\n  relationshipIdentifierField: string,\n): string | string[] | undefined {\n  if (Array.isArray(value)) {\n    const ids = value.flatMap((entry) => {\n      if (typeof entry === 'string' && entry !== '') {\n        return [entry];\n      }\n\n      if (!entry || typeof entry !== 'object') {\n        return [];\n      }\n\n      const rawId = (entry as Record<string, unknown>)[relationshipIdentifierField]\n        ?? (entry as Record<string, unknown>)._id\n        ?? (entry as Record<string, unknown>).id;\n\n      return typeof rawId === 'string' && rawId !== '' ? [rawId] : [];\n    });\n\n    return ids.length > 0 ? ids : undefined;\n  }\n\n  if (typeof value === 'string' && value !== '') {\n    return value;\n  }\n\n  if (!value || typeof value !== 'object') {\n    return undefined;\n  }\n\n  const rawId = (value as Record<string, unknown>)[relationshipIdentifierField]\n    ?? (value as Record<string, unknown>)._id\n    ?? (value as Record<string, unknown>).id;\n\n  return typeof rawId === 'string' && rawId !== '' ? rawId : undefined;\n}\n\n/**\n * The relationship read surface of a field that holds a RELATED RECORD (or records) rather than an FK id — the\n * dispatcher's relationship-object branch. Resolved against the resource that owns the field, by the name that\n * resource spells it.\n *\n * Both come from the TRAIL once a resource link has been followed, because `useResourceDisplayContext()` keeps\n * reporting the resource at the display ROOT no matter how deep the recursion is. Resolving against the root with a\n * nested name is why the registry saw `subtasks[0].subtasks` — root segment `subtasks[0]`, matching no relationship —\n * and reported \"not a relationship\" for the very recursion the depth guard exists to bound.\n *\n * It asks the READ question only (`resolveRelationshipReadSurface`), never the whole relationship runtime. That runtime\n * also resolves the write and inline-edit surfaces, whose quick-create resolution fails closed in development when a\n * foreign key is reached by two relationships — a question that matters to a picker and not at all to a display. An\n * organization membership's `userId` is exactly that case (`user_self → organizationMembers` and the users ↔\n * organizations junction edge both resolve it), so once a table cell read in its row's resource type (#2347) every\n * Members row rendered \"Error rendering field userId\" (#2427).\n */\nexport function resolveRelationshipObjectReadSurface(params: {\n  fieldName: string | undefined;\n  resourceLinkTrail: DisplayResourceLinkTrail | undefined;\n  currentResourceType: ResourceType | undefined;\n  registry: FrontendResourcesRegistry | undefined;\n}) {\n  const owningResourceType = params.resourceLinkTrail?.resourceType ?? params.currentResourceType;\n  const resourceRelativeFieldName = resolveResourceRelativeFieldName(params.fieldName, params.resourceLinkTrail);\n  if (!owningResourceType || !resourceRelativeFieldName || !params.registry) {\n    return undefined;\n  }\n\n  return resolveRelationshipReadSurface({\n    resourceType: owningResourceType,\n    fieldName: resourceRelativeFieldName,\n    registry: params.registry,\n  });\n}\n\n/** What a displayed reference points at: the referenced type (when resolvable) and the referenced ids. */\nexport interface ReferenceDisplayTarget {\n  referencedResourceType: string | undefined;\n  referencedIds: string[];\n}\n\n/**\n * The ids a reference value names — by the reference preset's own normalisation, so both readers hand\n * `withoutHiddenParentReference` the SAME list. A second normaliser that kept what the preset drops (a number in an\n * array) would let the field keep its box while the preset drew nothing.\n */\nfunction toReferencedIds(value: unknown): string[] {\n  return normalizeResourceReferenceSelectionValue(value as string | string[] | null | undefined);\n}\n\n/**\n * The reference a display field renders, exactly as `DisplayValueDispatcher` routes it to the reference preset —\n * `undefined` when the field is not a reference at all.\n *\n * - An FK schema → the FK branch: the polymorphic branch for this record, else the declared type, else the field\n *   map; the ids are the value.\n * - A non-composition relationship object with an object identity → the relationship branch: the related type; the\n *   ids are read off the related record(s).\n */\nexport function resolveReferenceDisplayTarget(params: {\n  schema: z.ZodTypeAny | undefined;\n  value: unknown;\n  fieldName: string | undefined;\n  parentData: Record<string, unknown> | undefined;\n  resourceLinkTrail: DisplayResourceLinkTrail | undefined;\n  currentResourceType: ResourceType | undefined;\n  registry: FrontendResourcesRegistry | undefined;\n}): ReferenceDisplayTarget | undefined {\n  if (params.schema && isForeignKey(params.schema)) {\n    return {\n      referencedResourceType: resolveForeignKeyReferencedResourceType({\n        explicitResourceType: resolveDiscriminatedPolymorphicFkResourceType({\n          schema: params.schema,\n          fieldName: params.fieldName,\n          parentData: params.parentData,\n          currentResourceType: params.currentResourceType,\n          registry: params.registry,\n        }),\n        schema: params.schema,\n        fieldName: params.fieldName,\n        registry: params.registry,\n      }),\n      referencedIds: toReferencedIds(params.value),\n    };\n  }\n\n  const readSurface = resolveRelationshipObjectReadSurface(params);\n  if (!readSurface || readSurface.semantics.nature === RelationshipNature.COMPOSITION || !readSurface.objectIdentity) {\n    return undefined;\n  }\n  return {\n    referencedResourceType: readSurface.relatedResourceType,\n    referencedIds: toReferencedIds(extractRelationshipDisplayValue(params.value, readSurface.objectIdentity.relationshipIdentifierField)),\n  };\n}\n"]}

package/dist/esm/components/data-display/summary-value-naming.context.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Whether the summary being rendered applies the VALUE-NAMING RULE: a value that cannot speak for itself
+ * (`keepsItsNameAlone` — a boolean, a bare number) keeps a visible name. Provided by
+ * `ResourceSummaryDisplayer` when the resource's layout declares no summary chrome, and read by
+ * `DisplayField`, so the rule reaches EVERY summary of such a resource — the generated template and an
+ * authored one alike. It used to run only in the generated template and the no-template card, so an
+ * authored template that relied on the old INLINE default showed a lone ✓ (audit B-2: Wonder CRM's
+ * pipeline stage). A field's own summary chrome, or a section's, still outranks it.
+ *
+ * Internal to the display layer: an application declares a summary chrome or a field's
+ * `summaryOverride`; it never sets this.
+ */
+export declare const SummaryValueNamingContext: import("react").Context<boolean>;
+export declare function useSummaryValueNaming(): boolean;
+//# sourceMappingURL=summary-value-naming.context.d.ts.map

package/dist/esm/components/data-display/summary-value-naming.context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary-value-naming.context.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/summary-value-naming.context.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,yBAAyB,kCAAgC,CAAA;AAEtE,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C"}

package/dist/esm/components/data-display/summary-value-naming.context.js

@@ -0,0 +1,18 @@
+import { createContext, useContext } from 'react';
+/**
+ * Whether the summary being rendered applies the VALUE-NAMING RULE: a value that cannot speak for itself
+ * (`keepsItsNameAlone` — a boolean, a bare number) keeps a visible name. Provided by
+ * `ResourceSummaryDisplayer` when the resource's layout declares no summary chrome, and read by
+ * `DisplayField`, so the rule reaches EVERY summary of such a resource — the generated template and an
+ * authored one alike. It used to run only in the generated template and the no-template card, so an
+ * authored template that relied on the old INLINE default showed a lone ✓ (audit B-2: Wonder CRM's
+ * pipeline stage). A field's own summary chrome, or a section's, still outranks it.
+ *
+ * Internal to the display layer: an application declares a summary chrome or a field's
+ * `summaryOverride`; it never sets this.
+ */
+export const SummaryValueNamingContext = createContext(false);
+export function useSummaryValueNaming() {
+    return useContext(SummaryValueNamingContext);
+}
+//# sourceMappingURL=summary-value-naming.context.js.map

package/dist/esm/components/data-display/summary-value-naming.context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary-value-naming.context.js","sourceRoot":"","sources":["../../../../../src/components/data-display/summary-value-naming.context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAEjD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,aAAa,CAAU,KAAK,CAAC,CAAA;AAEtE,MAAM,UAAU,qBAAqB;IACnC,OAAO,UAAU,CAAC,yBAAyB,CAAC,CAAA;AAC9C,CAAC","sourcesContent":["import { createContext, useContext } from 'react'\n\n/**\n * Whether the summary being rendered applies the VALUE-NAMING RULE: a value that cannot speak for itself\n * (`keepsItsNameAlone` — a boolean, a bare number) keeps a visible name. Provided by\n * `ResourceSummaryDisplayer` when the resource's layout declares no summary chrome, and read by\n * `DisplayField`, so the rule reaches EVERY summary of such a resource — the generated template and an\n * authored one alike. It used to run only in the generated template and the no-template card, so an\n * authored template that relied on the old INLINE default showed a lone ✓ (audit B-2: Wonder CRM's\n * pipeline stage). A field's own summary chrome, or a section's, still outranks it.\n *\n * Internal to the display layer: an application declares a summary chrome or a field's\n * `summaryOverride`; it never sets this.\n */\nexport const SummaryValueNamingContext = createContext<boolean>(false)\n\nexport function useSummaryValueNaming(): boolean {\n  return useContext(SummaryValueNamingContext)\n}\n"]}

package/dist/esm/components/data-display/tone-marker.d.ts

@@ -0,0 +1,38 @@
+import { IndicatorVariant } from "@wildo-ai/presets-components-models";
+/**
+ * The STRONG fill of a tone's marker dot — the one place a "dot in this tone" is decided.
+ *
+ * The INDICATOR recipe tints a chip with the `*-subtle` tokens, which is right for a badge holding
+ * words and invisible on a 7–12px dot. A marker fills with the tone's own token instead: `success`,
+ * `warning`, `destructive`, `info`, and the muted foreground for NEUTRAL. The `text-*-foreground`
+ * half is for a marker that carries a glyph (a timeline entry's icon), so the glyph reads on its fill.
+ *
+ * Shared by the timeline marker, the enum `DOT` display mode and the enum edit controls' option marks,
+ * which were about to be three copies of one judgement (the shape `badge-tone.ts` documents for the chip). Total over `IndicatorVariant` by
+ * type: a sixth tone is a compile error here, not a grey dot somewhere downstream.
+ */
+export declare const TONE_MARKER_FILL: Record<IndicatorVariant, string>;
+/**
+ * The same strong fill as a CSS COLOUR, for a surface that takes a colour rather than a class: an SVG shape filled
+ * inline, such as a graph minimap's nodes, where a class would lose to the inline `fill` (#2529). The theme's own
+ * tokens, so it follows light and dark exactly as {@link TONE_MARKER_FILL} does. Total over `IndicatorVariant` by type.
+ */
+export declare const TONE_MARKER_COLOUR: Record<IndicatorVariant, string>;
+/**
+ * The INK of a word written in a tone without a chip around it — the label beside a `DOT` marker.
+ *
+ * The `*-subtle-foreground` tokens are the ones tuned to clear WCAG AA; they are tuned against the
+ * subtle tint, and they sit between the tone and the foreground, so on the page background they read
+ * as the tone without the saturation of the raw token. NEUTRAL takes the muted foreground: a neutral
+ * value is the quiet case, and it should not read like a coloured one.
+ */
+export declare const TONE_INK: Record<IndicatorVariant, string>;
+/**
+ * The GEOMETRY of a standalone tone dot — beside a word (`EnumDisplayMode.DOT`) or an option in an enum
+ * control. Framework vocabulary like an icon size, one constant so the two never drift apart; its COLOUR
+ * is the theme's ({@link TONE_MARKER_FILL} reads theme tokens). The word beside it is the value's own: on a
+ * read surface it speaks in the voice of the value around it, in the tone's ink; in the enum control it is
+ * the option's word. A badge's own leading dot is smaller and part of the badge preset.
+ */
+export declare const TONE_DOT_CLASS = "size-[0.4375rem] shrink-0 rounded-full";
+//# sourceMappingURL=tone-marker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tone-marker.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/tone-marker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAA;AAEtE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAM7D,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAM/D,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAMrD,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,2CAA2C,CAAA"}