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

package/dist/esm/components/resources-fields/resource-reference/resource-reference.shared.utils.js

@@ -1,6 +1,31 @@
-import { CoreResourceOperation, ResourceOperationRiskLevel } from '@wildo-ai/saas-models';
+import { CoreResourceOperation, ResourceOperationRiskLevel, Resources_SharedUtils } from '@wildo-ai/saas-models';
 import { frontendResourceUtils, FrontendResourceUtils } from '../../../core/resources/frontend-resource.utils.js';
 import { isFrontendOperationAddressableForCurrentContext, pickPreferredOperationForCoreSemanticAddressability } from '../../../core/resources/resource-addressability.frontend.utils.js';
+/**
+ * The ONE scope a reference to `resourceType` must be searched within, when that target is a peer of a
+ * scope present in the context through a junction — e.g. users ↔ organizations via
+ * organizationMembers, with the viewer's `organizationId` in context. Returns the single contextual
+ * parameter that selects the scope-anchored route (`/organizations/{org}/users/search`), whose rows
+ * are confined to that scope's members; `undefined` when no such junction applies.
+ *
+ * Restricting to that ONE parameter is deliberate: an unrelated context parameter (the viewer's own
+ * `userId`, say) would otherwise hijack route selection and collapse the result to a single record.
+ * Shared by the picker (`useResourceSearch`) and the label probe below, so the two can never disagree
+ * about which door a reference is reached through.
+ */
+export function resolveScopeRequiredReferenceParameters(params) {
+    // Guard for partial (test) registries with no map.
+    if (!params.registry.manyToManyScopeJunctions)
+        return undefined;
+    const scopeJunction = Resources_SharedUtils.findScopeJunctionForTargetInContext(params.registry.manyToManyScopeJunctions, params.resourceType, new Set(Object.keys(params.contextualParameters)));
+    if (!scopeJunction)
+        return undefined;
+    const scopeValue = params.contextualParameters[scopeJunction.scopeFkField];
+    if ((typeof scopeValue !== 'string' && typeof scopeValue !== 'number') || String(scopeValue).trim() === '') {
+        return undefined;
+    }
+    return { [scopeJunction.scopeFkField]: scopeValue };
+}
 export function normalizeResourceReferenceSelectionValue(value) {
     if (value === undefined || value === null || value === '') {
         return [];
@@ -25,6 +50,8 @@ export function mapResourceReferenceOptions(params) {
             registry: params.registry,
             currentObject: item,
             t: params.t,
+            formatDate: params.formatDate,
+            formatDateTime: params.formatDateTime,
         }) ?? id;
         // Carry the full summary record so the picker can optionally render each option
         // as a summary card (ForeignKeyDisplayMode.SUMMARY) instead of just `label`. The
@@ -33,6 +60,45 @@ export function mapResourceReferenceOptions(params) {
     });
 }
 export async function fetchResourceReferenceRecordAndLabel(params) {
+    /*
+     * A reference REACHED THROUGH A SCOPE JUNCTION is labelled through that same confined door, not the
+     * target's READ (#1661). The users READ lets a user read only themselves, so an assignee or owner
+     * who is someone else could never be labelled — it rendered as a raw id. The org-scoped people
+     * search already returns that organization's members to its members, so filtering it to this one
+     * id narrows what the picker shows and exposes nothing new.
+     *
+     * The match is by id on the CLIENT too: a target whose search does not offer an `_id` filter
+     * would return its first page unfiltered, and taking row 0 would put the wrong name on the
+     * reference. Not found is the dangling case, reported like a failed READ.
+     */
+    const scopedParameters = resolveScopeRequiredReferenceParameters({
+        resourceType: params.resourceType,
+        registry: params.registry,
+        contextualParameters: params.contextualParameters ?? {},
+    });
+    if (scopedParameters) {
+        const result = await params.doOperation(FrontendResourceUtils.buildForeignKeySearchOperationPath(params.resourceType, params.registry), { contextualParameters: scopedParameters, queryParameters: { _id: params.id, limit: 1 } }, { silent: true, riskLevel: ResourceOperationRiskLevel.LOW });
+        const items = Array.isArray(result)
+            ? result
+            : (result?.data
+                ?? result?.items
+                ?? []);
+        const record = items.find((item) => item._id === params.id);
+        if (!record) {
+            throw new Error(`Reference ${params.resourceType}:${params.id} is not reachable within its scope.`);
+        }
+        return {
+            record,
+            label: FrontendResourceUtils.computeFrontendResourceLabel({
+                resourceType: params.resourceType,
+                registry: params.registry,
+                currentObject: record,
+                t: params.t,
+                formatDate: params.formatDate,
+                formatDateTime: params.formatDateTime,
+            }) ?? params.id,
+        };
+    }
     const fkFetchParams = FrontendResourceUtils.buildForeignKeyFetchParams(params.resourceType, params.id, params.registry);
     const resourceConfig = params.registry.resourceConfigurations[params.resourceType];
     const contextResourceIdentifiers = {
@@ -87,6 +153,8 @@ export async function fetchResourceReferenceRecordAndLabel(params) {
             registry: params.registry,
             currentObject: record,
             t: params.t,
+            formatDate: params.formatDate,
+            formatDateTime: params.formatDateTime,
         }) ?? params.id,
     };
 }

package/dist/esm/components/resources-fields/resource-reference/resource-reference.shared.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource-reference.shared.utils.js","sourceRoot":"","sources":["../../../../../../src/components/resources-fields/resource-reference/resource-reference.shared.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { CoreResourceOperation, ResourceOperationRiskLevel, type ResourceType } from '@wildo-ai/saas-models';\nimport type { FieldOption } from '~wildo-frontend-lib/components/form/form-field-types';\nimport type { ResourceRegistryContextType } from '~wildo-frontend-lib/core/resources/ResourceRegistryContext';\nimport { frontendResourceUtils, FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { isFrontendOperationAddressableForCurrentContext, pickPreferredOperationForCoreSemanticAddressability } from '~wildo-frontend-lib/core/resources/resource-addressability.frontend.utils';\nimport type {\n  FrontendResourceConfiguration_Operation,\n  FrontendResourcesRegistry,\n} from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\n\ntype ResourceReferenceTranslator = (\n  toTranslate: string,\n  translateParams?: { [key: string]: any },\n) => string;\n\nexport function normalizeResourceReferenceSelectionValue(\n  value: string | string[] | null | undefined,\n): string[] {\n  if (value === undefined || value === null || value === '') {\n    return [];\n  }\n\n  return Array.isArray(value)\n    ? value.filter((entry): entry is string => typeof entry === 'string' && entry !== '')\n    : [value];\n}\n\nexport function mapResourceReferenceOptions(params: {\n  items: Record<string, unknown>[];\n  resourceType: ResourceType;\n  registry: FrontendResourcesRegistry;\n  t?: ResourceReferenceTranslator;\n}): FieldOption<string>[] {\n  const fieldIdentifier = FrontendResourceUtils.getResourceFieldIdentifierForType(\n    params.resourceType,\n    params.registry,\n  );\n\n  return params.items.flatMap((item) => {\n    // The picker searches the FK target directly, so each record's own id (`_id`)\n    // IS the FK value. Resolve it via `getResourceObjectId` (NOT the cross-resource\n    // field-identifier name, which is absent from a plain record — without that\n    // every reference option was silently dropped).\n    const id = FrontendResourceUtils.getResourceObjectId(item as Record<string, unknown>, fieldIdentifier);\n    if (!id) {\n      return [];\n    }\n\n    const label = FrontendResourceUtils.computeFrontendResourceLabel({\n      resourceType: params.resourceType,\n      registry: params.registry,\n      currentObject: item,\n      t: params.t,\n    }) ?? id;\n\n    // Carry the full summary record so the picker can optionally render each option\n    // as a summary card (ForeignKeyDisplayMode.SUMMARY) instead of just `label`. The\n    // search already returns summary-mode DTOs, so this needs no extra fetch.\n    return [{ value: id, label, data: item }];\n  });\n}\n\nexport async function fetchResourceReferenceRecordAndLabel(params: {\n  resourceType: ResourceType;\n  id: string;\n  registry: FrontendResourcesRegistry;\n  doOperation: ResourceRegistryContextType['doOperation'];\n  contextualParameters?: Record<string, string | number>;\n  readOperation?: FrontendResourceConfiguration_Operation | null;\n  t?: ResourceReferenceTranslator;\n}): Promise<{\n  record: Record<string, unknown>;\n  label: string;\n}> {\n  const fkFetchParams = FrontendResourceUtils.buildForeignKeyFetchParams(\n    params.resourceType,\n    params.id,\n    params.registry,\n  );\n  const resourceConfig = params.registry.resourceConfigurations[params.resourceType];\n  const contextResourceIdentifiers = {\n    [params.resourceType]: params.id,\n  };\n  const contextualParameters = {\n    ...(params.contextualParameters ?? {}),\n    ...(fkFetchParams.contextualParameters || {}),\n  };\n  const runtimeAddressableReadOperation = resourceConfig\n    ? (\n        params.readOperation\n        && isFrontendOperationAddressableForCurrentContext({\n          resourceConfig,\n          operation: params.readOperation,\n          registry: params.registry,\n          hasResourceId: frontendResourceUtils.getResourceId(contextResourceIdentifiers[params.resourceType]).length > 0,\n          contextResourceIdentifiers,\n          contextualParameters,\n        })\n          ? params.readOperation\n          : pickPreferredOperationForCoreSemanticAddressability({\n            resourceConfig,\n            operations: resourceConfig.operations ?? [],\n            coreOperation: CoreResourceOperation.READ,\n            registry: params.registry,\n            hasResourceId: true,\n            contextResourceIdentifiers,\n            contextualParameters,\n          })\n      )\n    : params.readOperation;\n  const operationPath = FrontendResourceUtils.buildForeignKeyReadOperationPath(\n    params.resourceType,\n    params.registry,\n    runtimeAddressableReadOperation,\n  );\n  /*\n   * A LABEL PROBE, declared as one. It is a background read whose only purpose is a display string,\n   * and its one expected failure is a DANGLING reference — an OPTIONAL edge whose target has gone\n   * (a build-plan task a probe dispatch named that the accepted plan does not carry). The caller\n   * renders the raw id with the reason as a tooltip, which is the whole user-facing answer; so the\n   * request is `silent` (the caller owns the UX) and LOW risk (the 404 row of the behaviour matrix\n   * drops the notification at LOW). Without both, every render of a list carrying one such\n   * reference produced a global error notification and a console error for a field that was\n   * already rendering correctly.\n   */\n  const record = await params.doOperation<Record<string, unknown>>(operationPath, {\n    contextualParameters,\n  }, {\n    silent: true,\n    riskLevel: ResourceOperationRiskLevel.LOW,\n  });\n\n  return {\n    record,\n    label: FrontendResourceUtils.computeFrontendResourceLabel({\n      resourceType: params.resourceType,\n      registry: params.registry,\n      currentObject: record,\n      t: params.t,\n    }) ?? params.id,\n  };\n}\n"]}
+{"version":3,"file":"resource-reference.shared.utils.js","sourceRoot":"","sources":["../../../../../src/components/resources-fields/resource-reference/resource-reference.shared.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { CoreResourceOperation, ResourceOperationRiskLevel, Resources_SharedUtils, type ResourceType } from '@wildo-ai/saas-models';\nimport type { FieldOption } from '~wildo-frontend-lib/components/form/form-field-types';\nimport type { ResourceRegistryContextType } from '~wildo-frontend-lib/core/resources/ResourceRegistryContext';\nimport { frontendResourceUtils, FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { isFrontendOperationAddressableForCurrentContext, pickPreferredOperationForCoreSemanticAddressability } from '~wildo-frontend-lib/core/resources/resource-addressability.frontend.utils';\nimport type {\n  FrontendResourceConfiguration_Operation,\n  FrontendResourcesRegistry,\n} from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\n\ntype ResourceReferenceDateFormatter = (value: Date | string | number) => string;\n\ntype ResourceReferenceTranslator = (\n  toTranslate: string,\n  translateParams?: { [key: string]: any },\n) => string;\n\n/**\n * The ONE scope a reference to `resourceType` must be searched within, when that target is a peer of a\n * scope present in the context through a junction — e.g. users ↔ organizations via\n * organizationMembers, with the viewer's `organizationId` in context. Returns the single contextual\n * parameter that selects the scope-anchored route (`/organizations/{org}/users/search`), whose rows\n * are confined to that scope's members; `undefined` when no such junction applies.\n *\n * Restricting to that ONE parameter is deliberate: an unrelated context parameter (the viewer's own\n * `userId`, say) would otherwise hijack route selection and collapse the result to a single record.\n * Shared by the picker (`useResourceSearch`) and the label probe below, so the two can never disagree\n * about which door a reference is reached through.\n */\nexport function resolveScopeRequiredReferenceParameters(params: {\n  resourceType: ResourceType;\n  registry: FrontendResourcesRegistry;\n  contextualParameters: Record<string, string | number>;\n}): Record<string, string | number> | undefined {\n  // Guard for partial (test) registries with no map.\n  if (!params.registry.manyToManyScopeJunctions) return undefined;\n  const scopeJunction = Resources_SharedUtils.findScopeJunctionForTargetInContext(\n    params.registry.manyToManyScopeJunctions,\n    params.resourceType,\n    new Set(Object.keys(params.contextualParameters)),\n  );\n  if (!scopeJunction) return undefined;\n  const scopeValue = params.contextualParameters[scopeJunction.scopeFkField];\n  if ((typeof scopeValue !== 'string' && typeof scopeValue !== 'number') || String(scopeValue).trim() === '') {\n    return undefined;\n  }\n  return { [scopeJunction.scopeFkField]: scopeValue };\n}\n\nexport function normalizeResourceReferenceSelectionValue(\n  value: string | string[] | null | undefined,\n): string[] {\n  if (value === undefined || value === null || value === '') {\n    return [];\n  }\n\n  return Array.isArray(value)\n    ? value.filter((entry): entry is string => typeof entry === 'string' && entry !== '')\n    : [value];\n}\n\nexport function mapResourceReferenceOptions(params: {\n  items: Record<string, unknown>[];\n  resourceType: ResourceType;\n  registry: FrontendResourcesRegistry;\n  /* Required, as on `computeFrontendResourceLabel`, which it is forwarded to (#1454 review). */\n  t: ResourceReferenceTranslator;\n  /* Required beside `t`: forwarded to `computeFrontendResourceLabel` for a label callback that formats a date. */\n  formatDate: ResourceReferenceDateFormatter;\n  /* Required beside `formatDate`, for a label callback whose name is an instant. */\n  formatDateTime: ResourceReferenceDateFormatter;\n}): FieldOption<string>[] {\n  const fieldIdentifier = FrontendResourceUtils.getResourceFieldIdentifierForType(\n    params.resourceType,\n    params.registry,\n  );\n\n  return params.items.flatMap((item) => {\n    // The picker searches the FK target directly, so each record's own id (`_id`)\n    // IS the FK value. Resolve it via `getResourceObjectId` (NOT the cross-resource\n    // field-identifier name, which is absent from a plain record — without that\n    // every reference option was silently dropped).\n    const id = FrontendResourceUtils.getResourceObjectId(item as Record<string, unknown>, fieldIdentifier);\n    if (!id) {\n      return [];\n    }\n\n    const label = FrontendResourceUtils.computeFrontendResourceLabel({\n      resourceType: params.resourceType,\n      registry: params.registry,\n      currentObject: item,\n      t: params.t,\n      formatDate: params.formatDate,\n      formatDateTime: params.formatDateTime,\n    }) ?? id;\n\n    // Carry the full summary record so the picker can optionally render each option\n    // as a summary card (ForeignKeyDisplayMode.SUMMARY) instead of just `label`. The\n    // search already returns summary-mode DTOs, so this needs no extra fetch.\n    return [{ value: id, label, data: item }];\n  });\n}\n\nexport async function fetchResourceReferenceRecordAndLabel(params: {\n  resourceType: ResourceType;\n  id: string;\n  registry: FrontendResourcesRegistry;\n  doOperation: ResourceRegistryContextType['doOperation'];\n  contextualParameters?: Record<string, string | number>;\n  readOperation?: FrontendResourceConfiguration_Operation | null;\n  /* Required, as on `computeFrontendResourceLabel`, which it is forwarded to (#1454 review). */\n  t: ResourceReferenceTranslator;\n  /* Required beside `t`: forwarded to `computeFrontendResourceLabel` for a label callback that formats a date. */\n  formatDate: ResourceReferenceDateFormatter;\n  /* Required beside `formatDate`, for a label callback whose name is an instant. */\n  formatDateTime: ResourceReferenceDateFormatter;\n}): Promise<{\n  record: Record<string, unknown>;\n  label: string;\n}> {\n  /*\n   * A reference REACHED THROUGH A SCOPE JUNCTION is labelled through that same confined door, not the\n   * target's READ (#1661). The users READ lets a user read only themselves, so an assignee or owner\n   * who is someone else could never be labelled — it rendered as a raw id. The org-scoped people\n   * search already returns that organization's members to its members, so filtering it to this one\n   * id narrows what the picker shows and exposes nothing new.\n   *\n   * The match is by id on the CLIENT too: a target whose search does not offer an `_id` filter\n   * would return its first page unfiltered, and taking row 0 would put the wrong name on the\n   * reference. Not found is the dangling case, reported like a failed READ.\n   */\n  const scopedParameters = resolveScopeRequiredReferenceParameters({\n    resourceType: params.resourceType,\n    registry: params.registry,\n    contextualParameters: params.contextualParameters ?? {},\n  });\n  if (scopedParameters) {\n    const result = await params.doOperation<unknown>(\n      FrontendResourceUtils.buildForeignKeySearchOperationPath(params.resourceType, params.registry),\n      { contextualParameters: scopedParameters, queryParameters: { _id: params.id, limit: 1 } },\n      { silent: true, riskLevel: ResourceOperationRiskLevel.LOW },\n    );\n    const items: Record<string, unknown>[] = Array.isArray(result)\n      ? result as Record<string, unknown>[]\n      : ((result as { data?: Record<string, unknown>[]; items?: Record<string, unknown>[] } | null)?.data\n        ?? (result as { items?: Record<string, unknown>[] } | null)?.items\n        ?? []);\n    const record = items.find((item) => item._id === params.id);\n    if (!record) {\n      throw new Error(`Reference ${params.resourceType}:${params.id} is not reachable within its scope.`);\n    }\n    return {\n      record,\n      label: FrontendResourceUtils.computeFrontendResourceLabel({\n        resourceType: params.resourceType,\n        registry: params.registry,\n        currentObject: record,\n        t: params.t,\n      formatDate: params.formatDate,\n      formatDateTime: params.formatDateTime,\n      }) ?? params.id,\n    };\n  }\n\n  const fkFetchParams = FrontendResourceUtils.buildForeignKeyFetchParams(\n    params.resourceType,\n    params.id,\n    params.registry,\n  );\n  const resourceConfig = params.registry.resourceConfigurations[params.resourceType];\n  const contextResourceIdentifiers = {\n    [params.resourceType]: params.id,\n  };\n  const contextualParameters = {\n    ...(params.contextualParameters ?? {}),\n    ...(fkFetchParams.contextualParameters || {}),\n  };\n  const runtimeAddressableReadOperation = resourceConfig\n    ? (\n        params.readOperation\n        && isFrontendOperationAddressableForCurrentContext({\n          resourceConfig,\n          operation: params.readOperation,\n          registry: params.registry,\n          hasResourceId: frontendResourceUtils.getResourceId(contextResourceIdentifiers[params.resourceType]).length > 0,\n          contextResourceIdentifiers,\n          contextualParameters,\n        })\n          ? params.readOperation\n          : pickPreferredOperationForCoreSemanticAddressability({\n            resourceConfig,\n            operations: resourceConfig.operations ?? [],\n            coreOperation: CoreResourceOperation.READ,\n            registry: params.registry,\n            hasResourceId: true,\n            contextResourceIdentifiers,\n            contextualParameters,\n          })\n      )\n    : params.readOperation;\n  const operationPath = FrontendResourceUtils.buildForeignKeyReadOperationPath(\n    params.resourceType,\n    params.registry,\n    runtimeAddressableReadOperation,\n  );\n  /*\n   * A LABEL PROBE, declared as one. It is a background read whose only purpose is a display string,\n   * and its one expected failure is a DANGLING reference — an OPTIONAL edge whose target has gone\n   * (a build-plan task a probe dispatch named that the accepted plan does not carry). The caller\n   * renders the raw id with the reason as a tooltip, which is the whole user-facing answer; so the\n   * request is `silent` (the caller owns the UX) and LOW risk (the 404 row of the behaviour matrix\n   * drops the notification at LOW). Without both, every render of a list carrying one such\n   * reference produced a global error notification and a console error for a field that was\n   * already rendering correctly.\n   */\n  const record = await params.doOperation<Record<string, unknown>>(operationPath, {\n    contextualParameters,\n  }, {\n    silent: true,\n    riskLevel: ResourceOperationRiskLevel.LOW,\n  });\n\n  return {\n    record,\n    label: FrontendResourceUtils.computeFrontendResourceLabel({\n      resourceType: params.resourceType,\n      registry: params.registry,\n      currentObject: record,\n      t: params.t,\n      formatDate: params.formatDate,\n      formatDateTime: params.formatDateTime,\n    }) ?? params.id,\n  };\n}\n"]}

package/dist/esm/components/resources-fields/resource-reference/useResourceSearch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useResourceSearch.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources-fields/resource-reference/useResourceSearch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sDAAsD,CAAC;AAMxF,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,yDAAyD,CAAC;AAgBlH,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;IACrC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACrC;AAMD,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,IAAI,EACJ,KAAK,EACL,kBAAkB,GACnB,EAAE,wBAAwB,GAAG,uBAAuB,CAqUpD"}
+{"version":3,"file":"useResourceSearch.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources-fields/resource-reference/useResourceSearch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sDAAsD,CAAC;AAOxF,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,yDAAyD,CAAC;AAgBlH,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;IACrC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACrC;AAMD,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,IAAI,EACJ,KAAK,EACL,kBAAkB,GACnB,EAAE,wBAAwB,GAAG,uBAAuB,CA+TpD"}

package/dist/esm/components/resources-fields/resource-reference/useResourceSearch.js

@@ -17,8 +17,8 @@ import { useOptionalFormSchemaContext } from '../../../components/form/useFormSc
 import { resolveComponentLabel } from '../../../core/i18n/component-label-resolution.utils.js';
 import { useOptionalResourceOperationViewContext } from '../../../core/resources/ResourceOperationViewContext.js';
 import { FrontendComponentType } from '@wildo-ai/presets-components-models';
-import { CoreResourceOperation, Resources_SharedUtils } from '@wildo-ai/saas-models';
-import { fetchResourceReferenceRecordAndLabel, mapResourceReferenceOptions, normalizeResourceReferenceSelectionValue, } from './resource-reference.shared.utils.js';
+import { CoreResourceOperation } from '@wildo-ai/saas-models';
+import { fetchResourceReferenceRecordAndLabel, mapResourceReferenceOptions, normalizeResourceReferenceSelectionValue, resolveScopeRequiredReferenceParameters, } from './resource-reference.shared.utils.js';
 import { extractErrorInfo } from '../../../core/errors/errors.frontend.schemas.js';
 import { useUserFacingErrorMessage } from '../../../core/errors/useUserFacingErrorMessage.js';
 import { LoggerFrontendService } from '../../../core/monitoring/logger.frontend.service.js';
@@ -33,7 +33,7 @@ const MIN_SEARCH_CHARS = 2;
 // =============================================================================
 export function useResourceSearch({ schema, name, value, targetResourceType, }) {
     const { registry, doOperation } = useResourceRegistry();
-    const { t, tComponent, tResourceFieldEdit } = useI18n({ component: FrontendComponentType.RESOURCES_FIELDS_RESOURCE_REFERENCE });
+    const { t, formatDate, formatDateTime, tComponent, tResourceFieldEdit } = useI18n({ component: FrontendComponentType.RESOURCES_FIELDS_RESOURCE_REFERENCE });
     const toUserFacingErrorMessage = useUserFacingErrorMessage();
     const formSchemaContext = useOptionalFormSchemaContext();
     // Filter pickers render OUTSIDE a form (no FormSchemaContext) but INSIDE the
@@ -110,21 +110,16 @@ export function useResourceSearch({ schema, name, value, targetResourceType, })
         try {
             const operationPath = FrontendResourceUtils.buildForeignKeySearchOperationPath(resourceType, registry);
             const searchParams = FrontendResourceUtils.buildForeignKeySearchParams(query, INITIAL_LOAD_LIMIT);
-            // Infer the scope junction (if any) for this FK target from the registry
-            // map, using the scope params present in the LIVE context. When found,
-            // restrict the search to that ONE scope param so the backend's
-            // scope-anchored route is selected (members of the caller's org) and no
-            // unrelated context param (e.g. the caller's own userId) hijacks route
-            // selection. Otherwise pass the host context unchanged for a plain target
-            // search. Guard for partial (test) registries with no map.
+            // Infer the scope junction (if any) for this FK target from the LIVE context, and restrict the
+            // search to that ONE scope param so the scope-anchored route is selected (members of the
+            // caller's org). Otherwise pass the host context unchanged for a plain target search. One
+            // definition, shared with the label probe — see `resolveScopeRequiredReferenceParameters`.
             const hostContextualParameters = contextualParametersRef.current;
-            const scopeJunction = registry.manyToManyScopeJunctions
-                ? Resources_SharedUtils.findScopeJunctionForTargetInContext(registry.manyToManyScopeJunctions, resourceType, new Set(Object.keys(hostContextualParameters)))
-                : undefined;
-            const scopeValue = scopeJunction ? hostContextualParameters[scopeJunction.scopeFkField] : undefined;
-            const effectiveContextualParameters = scopeJunction && (typeof scopeValue === 'string' || typeof scopeValue === 'number') && String(scopeValue).trim() !== ''
-                ? { [scopeJunction.scopeFkField]: scopeValue }
-                : hostContextualParameters;
+            const effectiveContextualParameters = resolveScopeRequiredReferenceParameters({
+                resourceType,
+                registry,
+                contextualParameters: hostContextualParameters,
+            }) ?? hostContextualParameters;
             const result = await doOperationRef.current(operationPath, {
                 contextualParameters: effectiveContextualParameters,
                 queryParameters: searchParams.queryParameters,
@@ -145,6 +140,8 @@ export function useResourceSearch({ schema, name, value, targetResourceType, })
                 resourceType,
                 registry,
                 t,
+                formatDate,
+                formatDateTime,
             }));
         }
         catch (err) {
@@ -158,7 +155,7 @@ export function useResourceSearch({ schema, name, value, targetResourceType, })
         finally {
             setIsLoading(false);
         }
-    }, [resourceType, registry, t]);
+    }, [resourceType, registry, t, formatDate, formatDateTime]);
     // =========================================================================
     // RESOLVE CURRENT VALUE LABELS
     // =========================================================================
@@ -182,6 +179,8 @@ export function useResourceSearch({ schema, name, value, targetResourceType, })
                     contextualParameters: contextualParametersRef.current,
                     readOperation,
                     t,
+                    formatDate,
+                    formatDateTime,
                 });
                 newLabels.set(id, label);
             }
@@ -191,7 +190,7 @@ export function useResourceSearch({ schema, name, value, targetResourceType, })
         }
         setCurrentValueLabels(newLabels);
         setIsLoadingCurrentValue(false);
-    }, [resourceType, normalizedValue, registry, readOperation, t]);
+    }, [resourceType, normalizedValue, registry, readOperation, t, formatDate, formatDateTime]);
     // =========================================================================
     // EFFECTS
     // =========================================================================

package/dist/esm/components/resources-fields/resource-reference/useResourceSearch.js.map

@@ -1 +1 @@
-{"version":3,"file":"useResourceSearch.js","sourceRoot":"","sources":["../../../../../../src/components/resources-fields/resource-reference/useResourceSearch.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * useResourceSearch\n *\n * Reusable hook for async resource-reference search:\n * - Fetches initial options when the dropdown opens\n * - Debounces search queries and fetches filtered results\n * - Resolves display labels for currently selected values\n * - Returns data shaped for Combobox/ComboboxMultiple consumption\n */\n\nimport { useState, useEffect, useCallback, useMemo, useRef } from 'react';\nimport { z } from 'zod';\nimport { getArrayItemSchema, getSchemaType, FieldSchemaType } from '@wildo-ai/zod-decorators';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { pickPreferredOperationForCoreSemantic } from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport { useOptionalFormSchemaContext } from '~wildo-frontend-lib/components/form/useFormSchemaContext';\nimport { resolveComponentLabel } from '~wildo-frontend-lib/core/i18n/component-label-resolution.utils';\nimport { useOptionalResourceOperationViewContext } from '~wildo-frontend-lib/core/resources/ResourceOperationViewContext';\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { CoreResourceOperation, Resources_SharedUtils } from '@wildo-ai/saas-models';\nimport type { FieldOption } from '~wildo-frontend-lib/components/form/form-field-types';\nimport {\n  fetchResourceReferenceRecordAndLabel,\n  mapResourceReferenceOptions,\n  normalizeResourceReferenceSelectionValue,\n} from './resource-reference.shared.utils';\nimport { extractErrorInfo, type DisplayableError } from '~wildo-frontend-lib/core/errors/errors.frontend.schemas';\nimport { useUserFacingErrorMessage } from '~wildo-frontend-lib/core/errors/useUserFacingErrorMessage';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\n// =============================================================================\n// CONSTANTS\n// =============================================================================\n\nconst INITIAL_LOAD_LIMIT = 10;\nconst SEARCH_DEBOUNCE_MS = 300;\nconst MIN_SEARCH_CHARS = 2;\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\nexport interface UseResourceSearchOptions {\n  schema: z.ZodTypeAny;\n  name: string;\n  value: string | string[] | undefined;\n  targetResourceType?: string;\n}\n\nexport interface UseResourceSearchResult {\n  options: FieldOption<string>[];\n  isLoading: boolean;\n  isLoadingCurrentValue: boolean;\n  isOpen: boolean;\n  setIsOpen: (open: boolean) => void;\n  handleSearchChange: (search: string) => void;\n  getDisplayLabel: (id: string) => string;\n  resourceType: string | undefined;\n  isMultiple: boolean;\n  normalizedValue: string[];\n  emptyMessage: string;\n  defaultPlaceholder: string;\n  /**\n   * E-4: surfaced error for the most-recent options fetch.\n   * Consumers (Combobox/ComboboxMultiple presets) can render this as an inline\n   * footer/notice in the dropdown so users know why the list is empty.\n   * `null` when there is no error to display. Its `message` is already localized text (#1160).\n   */\n  fetchError: DisplayableError | null;\n}\n\n// =============================================================================\n// HOOK\n// =============================================================================\n\nexport function useResourceSearch({\n  schema,\n  name,\n  value,\n  targetResourceType,\n}: UseResourceSearchOptions): UseResourceSearchResult {\n  const { registry, doOperation } = useResourceRegistry();\n  const { t, tComponent, tResourceFieldEdit } = useI18n({ component: FrontendComponentType.RESOURCES_FIELDS_RESOURCE_REFERENCE });\n  const toUserFacingErrorMessage = useUserFacingErrorMessage();\n\n  const formSchemaContext = useOptionalFormSchemaContext();\n  // Filter pickers render OUTSIDE a form (no FormSchemaContext) but INSIDE the\n  // list's `ResourceOperationViewProvider`, which carries the rendered\n  // operation's scope (e.g. the current `organizationId`). Without this\n  // fallback, an org-scoped search SURFACE (e.g. `organizationMembers` for an\n  // assignee picker) is requested with no org id and the backend correctly\n  // 403s (\"Organization ID is required for organization-scoped collection\n  // operations\"). Form pickers keep using their own (more specific) form\n  // context unchanged — the operation-view scope is consulted ONLY when there\n  // is no form context, so the form path is byte-for-byte preserved.\n  const operationViewContext = useOptionalResourceOperationViewContext();\n\n  const contextualParameters = useMemo(() => {\n    if (formSchemaContext?.contextResourceIdentifiers) {\n      return FrontendResourceUtils.buildContextualParameters(\n        formSchemaContext.contextResourceIdentifiers,\n        registry\n      );\n    }\n    return operationViewContext?.contextualParameters ?? {};\n  }, [formSchemaContext?.contextResourceIdentifiers, operationViewContext?.contextualParameters, registry]);\n\n  const searchTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const doOperationRef = useRef(doOperation);\n  doOperationRef.current = doOperation;\n  const contextualParametersRef = useRef(contextualParameters);\n  contextualParametersRef.current = contextualParameters;\n\n  const schemaType = getSchemaType(schema);\n  const isMultiple = schemaType === FieldSchemaType.ARRAY;\n  const fkSchema = isMultiple ? (getArrayItemSchema(schema) || schema) : schema;\n\n  const resourceType = useMemo(() => {\n    if (targetResourceType) {\n      return targetResourceType;\n    }\n\n    try {\n      return FrontendResourceUtils.resolveResourceTypeForForeignKey(name, fkSchema, registry);\n    } catch {\n      return undefined;\n    }\n  }, [fkSchema, name, registry, targetResourceType]);\n\n  // Scope-required reference search (registry inference): the picker SEARCHES the\n  // FK target (`resourceType`) directly and labels results with the TARGET's own\n  // display config — never a separate \"surface\" resource. When the target has an\n  // M:N junction to a scope present in the current context (e.g.\n  // users ↔ organizations via organizationMembers, with the caller's\n  // `organizationId` injected by the app scope), the search is restricted to that\n  // single scope param so the backend's scope-anchored route\n  // (`/organizations/{org}/users/search`) is selected and results are scoped\n  // through the junction (members of the caller's org), authorized by membership.\n  // Inferred per-fetch from `registry.manyToManyScopeJunctions` (Phase 1) — no\n  // per-field declaration. The scope restriction also prevents an unrelated\n  // context param (e.g. the caller's own `userId`) from hijacking route selection\n  // and collapsing the result set to a single record.\n\n  const [isOpen, setIsOpen] = useState(false);\n  const [options, setOptions] = useState<FieldOption<string>[]>([]);\n  const [isLoading, setIsLoading] = useState(false);\n  const [isLoadingCurrentValue, setIsLoadingCurrentValue] = useState(false);\n  const [searchQuery, setSearchQuery] = useState('');\n  const [currentValueLabels, setCurrentValueLabels] = useState<Map<string, string>>(new Map());\n  // E-4: track the most recent fetch error so the consumer can surface it\n  const [fetchError, setFetchError] = useState<DisplayableError | null>(null);\n\n  const normalizedValue = useMemo(\n    () => normalizeResourceReferenceSelectionValue(value),\n    [value],\n  );\n\n  const readOperation = useMemo(() => {\n    if (!resourceType) {\n      return null;\n    }\n\n    return pickPreferredOperationForCoreSemantic(\n      registry.resourceConfigurations?.[resourceType]?.operations ?? [],\n      CoreResourceOperation.READ,\n    ) ?? null;\n  }, [registry, resourceType]);\n\n  // =========================================================================\n  // FETCH OPTIONS\n  // =========================================================================\n\n  const fetchOptions = useCallback(async (query?: string) => {\n    if (!resourceType) return;\n    setIsLoading(true);\n    setFetchError(null);\n\n    try {\n      const operationPath = FrontendResourceUtils.buildForeignKeySearchOperationPath(resourceType, registry);\n      const searchParams = FrontendResourceUtils.buildForeignKeySearchParams(query, INITIAL_LOAD_LIMIT);\n\n      // Infer the scope junction (if any) for this FK target from the registry\n      // map, using the scope params present in the LIVE context. When found,\n      // restrict the search to that ONE scope param so the backend's\n      // scope-anchored route is selected (members of the caller's org) and no\n      // unrelated context param (e.g. the caller's own userId) hijacks route\n      // selection. Otherwise pass the host context unchanged for a plain target\n      // search. Guard for partial (test) registries with no map.\n      const hostContextualParameters = contextualParametersRef.current;\n      const scopeJunction = registry.manyToManyScopeJunctions\n        ? Resources_SharedUtils.findScopeJunctionForTargetInContext(\n            registry.manyToManyScopeJunctions,\n            resourceType,\n            new Set(Object.keys(hostContextualParameters)),\n          )\n        : undefined;\n      const scopeValue = scopeJunction ? hostContextualParameters[scopeJunction.scopeFkField] : undefined;\n      const effectiveContextualParameters =\n        scopeJunction && (typeof scopeValue === 'string' || typeof scopeValue === 'number') && String(scopeValue).trim() !== ''\n          ? { [scopeJunction.scopeFkField]: scopeValue }\n          : hostContextualParameters;\n\n      const result = await doOperationRef.current(operationPath, {\n        contextualParameters: effectiveContextualParameters,\n        queryParameters: searchParams.queryParameters,\n      });\n\n      let items: Record<string, unknown>[] = [];\n      if (Array.isArray(result)) {\n        items = result as Record<string, unknown>[];\n      } else if (result && typeof result === 'object') {\n        const resultObj = result as { data?: Record<string, unknown>[]; items?: Record<string, unknown>[] };\n        items = resultObj.data || resultObj.items || [];\n      }\n\n      // Label results with the FK TARGET's own display config (e.g. users.email),\n      // symmetric with the current-value + chip label paths. The stored option\n      // value is the target record's own id — no projection.\n      setOptions(mapResourceReferenceOptions({\n        items,\n        resourceType,\n        registry,\n        t,\n      }));\n    } catch (err) {\n      const errorInfo = extractErrorInfo(err);\n      LoggerFrontendService.getLogger().error(\n        '[useResourceSearch] Failed to fetch options:',\n        { resourceType, query, ...errorInfo, error: err },\n      );\n      // Shown in the picker's empty state: localized text, never the reference (#1160). The resolver has a\n      // stable identity, so this callback's dependencies are unchanged.\n      setFetchError({ ...errorInfo, message: toUserFacingErrorMessage(err) });\n      setOptions([]);\n    } finally {\n      setIsLoading(false);\n    }\n  }, [resourceType, registry, t]);\n\n  // =========================================================================\n  // RESOLVE CURRENT VALUE LABELS\n  // =========================================================================\n\n  const currentValueLabelsRef = useRef(currentValueLabels);\n  currentValueLabelsRef.current = currentValueLabels;\n\n  const resolveCurrentValueLabels = useCallback(async () => {\n    if (!resourceType || normalizedValue.length === 0) return;\n\n    const unresolvedIds = normalizedValue.filter(id => !currentValueLabelsRef.current.has(id));\n    if (unresolvedIds.length === 0) return;\n\n    setIsLoadingCurrentValue(true);\n\n    const newLabels = new Map(currentValueLabelsRef.current);\n\n    for (const id of unresolvedIds) {\n      try {\n        const { label } = await fetchResourceReferenceRecordAndLabel({\n          resourceType,\n          id,\n          registry,\n          doOperation: doOperationRef.current,\n          contextualParameters: contextualParametersRef.current,\n          readOperation,\n          t,\n        });\n        newLabels.set(id, label);\n      } catch {\n        newLabels.set(id, id);\n      }\n    }\n\n    setCurrentValueLabels(newLabels);\n    setIsLoadingCurrentValue(false);\n  }, [resourceType, normalizedValue, registry, readOperation, t]);\n\n  // =========================================================================\n  // EFFECTS\n  // =========================================================================\n\n  useEffect(() => {\n    resolveCurrentValueLabels();\n  }, [resolveCurrentValueLabels]);\n\n  // SINGLE fetch driver. Every options request is caused by a user gesture\n  // observable in (isOpen, searchQuery): opening the dropdown fetches the\n  // unfiltered head (query === ''), typing fetches the debounced filtered\n  // set, clearing the query re-fetches the unfiltered head, and reopening\n  // after a failure retries exactly once (handleOpenChange clears the error).\n  //\n  // Do NOT add a data-shape condition (e.g. `options.length === 0`) as a\n  // fetch trigger here or in a sibling effect. Zero options is a RESOLVED\n  // state, not a not-yet-loaded state: a successful fetch over an empty\n  // collection settles on zero options just as legitimately as a failed one,\n  // and a shape-driven trigger turns both into an unbounded refetch loop\n  // (each completed request flips `isLoading`, re-runs the effect, and\n  // re-satisfies the \"still empty\" condition — one request per round-trip,\n  // forever). Empty is rendered by the consumer via `emptyMessage` /\n  // `fetchError`; it is only ever retried through a new gesture.\n  useEffect(() => {\n    if (!isOpen) return;\n\n    if (searchTimeoutRef.current) {\n      clearTimeout(searchTimeoutRef.current);\n    }\n\n    if (searchQuery.length >= MIN_SEARCH_CHARS) {\n      searchTimeoutRef.current = setTimeout(() => {\n        fetchOptions(searchQuery);\n      }, SEARCH_DEBOUNCE_MS);\n    } else if (searchQuery.length === 0) {\n      fetchOptions();\n    }\n\n    return () => {\n      if (searchTimeoutRef.current) {\n        clearTimeout(searchTimeoutRef.current);\n      }\n    };\n  }, [searchQuery, isOpen, fetchOptions]);\n\n  // =========================================================================\n  // SEARCH HANDLER\n  // =========================================================================\n\n  const handleSearchChange = useCallback((search: string) => {\n    setSearchQuery(search);\n  }, []);\n\n  const handleOpenChange = useCallback((open: boolean) => {\n    setIsOpen(open);\n    if (!open) {\n      setSearchQuery('');\n    } else {\n      // Reopening is the user's natural retry gesture after a failed fetch —\n      // the open transition itself triggers one new attempt via the fetch\n      // driver effect. Clearing the error here just prevents the stale error\n      // notice from flashing while that attempt is in flight.\n      setFetchError(null);\n    }\n  }, []);\n\n  // =========================================================================\n  // DISPLAY HELPERS\n  // =========================================================================\n\n  const getDisplayLabel = useCallback((id: string): string => {\n    return currentValueLabels.get(id) || id;\n  }, [currentValueLabels]);\n\n  const emptyMessage = useMemo(() => {\n    if (searchQuery.length > 0 && searchQuery.length < MIN_SEARCH_CHARS) {\n      return tComponent(FrontendComponentType.RESOURCES_FIELDS_RESOURCE_REFERENCE, 'minSearchChars', { count: String(MIN_SEARCH_CHARS) });\n    }\n    return tComponent(FrontendComponentType.RESOURCES_FIELDS_RESOURCE_REFERENCE, 'noResults');\n  }, [searchQuery, tComponent]);\n\n  // Audit D2: prefer a TARGET-NAMED placeholder (\"Select a Todo list…\") over the\n  // generic \"Select an item\". The `{target}` interpolation value is the FIELD's\n  // resolved edit label — the same string shown as the field label above the\n  // control, so placeholder and label can never disagree, and a label-tier fix\n  // (e.g. singularizing a generated plural) automatically heals the placeholder.\n  //\n  // `selectReferencePlaceholder` is a framework-declared label. An application\n  // whose generated bundle does not carry it yet shows the KEY (#1414) — it used\n  // to fall back silently to the generic placeholder, so nothing ever said label\n  // generation was owed. The generic `selectPlaceholder` is for the cases below\n  // where the parameterized wording does not apply, not for a missing label.\n  //\n  // Single-selection only: the host resource type comes from the FORM context\n  // (filter pickers outside a form keep the generic placeholder), and multi\n  // pickers keep the generic wording — their trigger shows a selection count,\n  // not an article-phrased prompt.\n  const hostResourceTypeForLabels = formSchemaContext?.resourceType;\n  const defaultPlaceholder = useMemo(() => {\n    if (!isMultiple && hostResourceTypeForLabels) {\n      const targetLabel = tResourceFieldEdit(hostResourceTypeForLabels, name, 'label');\n      if (targetLabel) {\n        return resolveComponentLabel({\n          tComponent,\n          componentType: FrontendComponentType.RESOURCES_FIELDS_RESOURCE_REFERENCE,\n          key: 'selectReferencePlaceholder',\n          params: { target: targetLabel },\n        });\n      }\n    }\n    return tComponent(FrontendComponentType.RESOURCES_FIELDS_RESOURCE_REFERENCE, 'selectPlaceholder');\n  }, [hostResourceTypeForLabels, isMultiple, name, tComponent, tResourceFieldEdit]);\n\n  return {\n    options,\n    isLoading,\n    isLoadingCurrentValue,\n    isOpen,\n    setIsOpen: handleOpenChange,\n    handleSearchChange,\n    getDisplayLabel,\n    resourceType,\n    isMultiple,\n    normalizedValue,\n    emptyMessage,\n    defaultPlaceholder,\n    fetchError,\n  };\n}\n"]}
+{"version":3,"file":"useResourceSearch.js","sourceRoot":"","sources":["../../../../../src/components/resources-fields/resource-reference/useResourceSearch.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * useResourceSearch\n *\n * Reusable hook for async resource-reference search:\n * - Fetches initial options when the dropdown opens\n * - Debounces search queries and fetches filtered results\n * - Resolves display labels for currently selected values\n * - Returns data shaped for Combobox/ComboboxMultiple consumption\n */\n\nimport { useState, useEffect, useCallback, useMemo, useRef } from 'react';\nimport { z } from 'zod';\nimport { getArrayItemSchema, getSchemaType, FieldSchemaType } from '@wildo-ai/zod-decorators';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { pickPreferredOperationForCoreSemantic } from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport { useOptionalFormSchemaContext } from '~wildo-frontend-lib/components/form/useFormSchemaContext';\nimport { resolveComponentLabel } from '~wildo-frontend-lib/core/i18n/component-label-resolution.utils';\nimport { useOptionalResourceOperationViewContext } from '~wildo-frontend-lib/core/resources/ResourceOperationViewContext';\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { CoreResourceOperation } from '@wildo-ai/saas-models';\nimport type { FieldOption } from '~wildo-frontend-lib/components/form/form-field-types';\nimport {\n  fetchResourceReferenceRecordAndLabel,\n  mapResourceReferenceOptions,\n  normalizeResourceReferenceSelectionValue,\n  resolveScopeRequiredReferenceParameters,\n} from './resource-reference.shared.utils';\nimport { extractErrorInfo, type DisplayableError } from '~wildo-frontend-lib/core/errors/errors.frontend.schemas';\nimport { useUserFacingErrorMessage } from '~wildo-frontend-lib/core/errors/useUserFacingErrorMessage';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\n// =============================================================================\n// CONSTANTS\n// =============================================================================\n\nconst INITIAL_LOAD_LIMIT = 10;\nconst SEARCH_DEBOUNCE_MS = 300;\nconst MIN_SEARCH_CHARS = 2;\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\nexport interface UseResourceSearchOptions {\n  schema: z.ZodTypeAny;\n  name: string;\n  value: string | string[] | undefined;\n  targetResourceType?: string;\n}\n\nexport interface UseResourceSearchResult {\n  options: FieldOption<string>[];\n  isLoading: boolean;\n  isLoadingCurrentValue: boolean;\n  isOpen: boolean;\n  setIsOpen: (open: boolean) => void;\n  handleSearchChange: (search: string) => void;\n  getDisplayLabel: (id: string) => string;\n  resourceType: string | undefined;\n  isMultiple: boolean;\n  normalizedValue: string[];\n  emptyMessage: string;\n  defaultPlaceholder: string;\n  /**\n   * E-4: surfaced error for the most-recent options fetch.\n   * Consumers (Combobox/ComboboxMultiple presets) can render this as an inline\n   * footer/notice in the dropdown so users know why the list is empty.\n   * `null` when there is no error to display. Its `message` is already localized text (#1160).\n   */\n  fetchError: DisplayableError | null;\n}\n\n// =============================================================================\n// HOOK\n// =============================================================================\n\nexport function useResourceSearch({\n  schema,\n  name,\n  value,\n  targetResourceType,\n}: UseResourceSearchOptions): UseResourceSearchResult {\n  const { registry, doOperation } = useResourceRegistry();\n  const { t, formatDate, formatDateTime, tComponent, tResourceFieldEdit } = useI18n({ component: FrontendComponentType.RESOURCES_FIELDS_RESOURCE_REFERENCE });\n  const toUserFacingErrorMessage = useUserFacingErrorMessage();\n\n  const formSchemaContext = useOptionalFormSchemaContext();\n  // Filter pickers render OUTSIDE a form (no FormSchemaContext) but INSIDE the\n  // list's `ResourceOperationViewProvider`, which carries the rendered\n  // operation's scope (e.g. the current `organizationId`). Without this\n  // fallback, an org-scoped search SURFACE (e.g. `organizationMembers` for an\n  // assignee picker) is requested with no org id and the backend correctly\n  // 403s (\"Organization ID is required for organization-scoped collection\n  // operations\"). Form pickers keep using their own (more specific) form\n  // context unchanged — the operation-view scope is consulted ONLY when there\n  // is no form context, so the form path is byte-for-byte preserved.\n  const operationViewContext = useOptionalResourceOperationViewContext();\n\n  const contextualParameters = useMemo(() => {\n    if (formSchemaContext?.contextResourceIdentifiers) {\n      return FrontendResourceUtils.buildContextualParameters(\n        formSchemaContext.contextResourceIdentifiers,\n        registry\n      );\n    }\n    return operationViewContext?.contextualParameters ?? {};\n  }, [formSchemaContext?.contextResourceIdentifiers, operationViewContext?.contextualParameters, registry]);\n\n  const searchTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const doOperationRef = useRef(doOperation);\n  doOperationRef.current = doOperation;\n  const contextualParametersRef = useRef(contextualParameters);\n  contextualParametersRef.current = contextualParameters;\n\n  const schemaType = getSchemaType(schema);\n  const isMultiple = schemaType === FieldSchemaType.ARRAY;\n  const fkSchema = isMultiple ? (getArrayItemSchema(schema) || schema) : schema;\n\n  const resourceType = useMemo(() => {\n    if (targetResourceType) {\n      return targetResourceType;\n    }\n\n    try {\n      return FrontendResourceUtils.resolveResourceTypeForForeignKey(name, fkSchema, registry);\n    } catch {\n      return undefined;\n    }\n  }, [fkSchema, name, registry, targetResourceType]);\n\n  // Scope-required reference search (registry inference): the picker SEARCHES the\n  // FK target (`resourceType`) directly and labels results with the TARGET's own\n  // display config — never a separate \"surface\" resource. When the target has an\n  // M:N junction to a scope present in the current context (e.g.\n  // users ↔ organizations via organizationMembers, with the caller's\n  // `organizationId` injected by the app scope), the search is restricted to that\n  // single scope param so the backend's scope-anchored route\n  // (`/organizations/{org}/users/search`) is selected and results are scoped\n  // through the junction (members of the caller's org), authorized by membership.\n  // Inferred per-fetch from `registry.manyToManyScopeJunctions` (Phase 1) — no\n  // per-field declaration. The scope restriction also prevents an unrelated\n  // context param (e.g. the caller's own `userId`) from hijacking route selection\n  // and collapsing the result set to a single record.\n\n  const [isOpen, setIsOpen] = useState(false);\n  const [options, setOptions] = useState<FieldOption<string>[]>([]);\n  const [isLoading, setIsLoading] = useState(false);\n  const [isLoadingCurrentValue, setIsLoadingCurrentValue] = useState(false);\n  const [searchQuery, setSearchQuery] = useState('');\n  const [currentValueLabels, setCurrentValueLabels] = useState<Map<string, string>>(new Map());\n  // E-4: track the most recent fetch error so the consumer can surface it\n  const [fetchError, setFetchError] = useState<DisplayableError | null>(null);\n\n  const normalizedValue = useMemo(\n    () => normalizeResourceReferenceSelectionValue(value),\n    [value],\n  );\n\n  const readOperation = useMemo(() => {\n    if (!resourceType) {\n      return null;\n    }\n\n    return pickPreferredOperationForCoreSemantic(\n      registry.resourceConfigurations?.[resourceType]?.operations ?? [],\n      CoreResourceOperation.READ,\n    ) ?? null;\n  }, [registry, resourceType]);\n\n  // =========================================================================\n  // FETCH OPTIONS\n  // =========================================================================\n\n  const fetchOptions = useCallback(async (query?: string) => {\n    if (!resourceType) return;\n    setIsLoading(true);\n    setFetchError(null);\n\n    try {\n      const operationPath = FrontendResourceUtils.buildForeignKeySearchOperationPath(resourceType, registry);\n      const searchParams = FrontendResourceUtils.buildForeignKeySearchParams(query, INITIAL_LOAD_LIMIT);\n\n      // Infer the scope junction (if any) for this FK target from the LIVE context, and restrict the\n      // search to that ONE scope param so the scope-anchored route is selected (members of the\n      // caller's org). Otherwise pass the host context unchanged for a plain target search. One\n      // definition, shared with the label probe — see `resolveScopeRequiredReferenceParameters`.\n      const hostContextualParameters = contextualParametersRef.current;\n      const effectiveContextualParameters = resolveScopeRequiredReferenceParameters({\n        resourceType,\n        registry,\n        contextualParameters: hostContextualParameters,\n      }) ?? hostContextualParameters;\n\n      const result = await doOperationRef.current(operationPath, {\n        contextualParameters: effectiveContextualParameters,\n        queryParameters: searchParams.queryParameters,\n      });\n\n      let items: Record<string, unknown>[] = [];\n      if (Array.isArray(result)) {\n        items = result as Record<string, unknown>[];\n      } else if (result && typeof result === 'object') {\n        const resultObj = result as { data?: Record<string, unknown>[]; items?: Record<string, unknown>[] };\n        items = resultObj.data || resultObj.items || [];\n      }\n\n      // Label results with the FK TARGET's own display config (e.g. users.email),\n      // symmetric with the current-value + chip label paths. The stored option\n      // value is the target record's own id — no projection.\n      setOptions(mapResourceReferenceOptions({\n        items,\n        resourceType,\n        registry,\n        t,\n        formatDate,\n        formatDateTime,\n      }));\n    } catch (err) {\n      const errorInfo = extractErrorInfo(err);\n      LoggerFrontendService.getLogger().error(\n        '[useResourceSearch] Failed to fetch options:',\n        { resourceType, query, ...errorInfo, error: err },\n      );\n      // Shown in the picker's empty state: localized text, never the reference (#1160). The resolver has a\n      // stable identity, so this callback's dependencies are unchanged.\n      setFetchError({ ...errorInfo, message: toUserFacingErrorMessage(err) });\n      setOptions([]);\n    } finally {\n      setIsLoading(false);\n    }\n  }, [resourceType, registry, t, formatDate, formatDateTime]);\n\n  // =========================================================================\n  // RESOLVE CURRENT VALUE LABELS\n  // =========================================================================\n\n  const currentValueLabelsRef = useRef(currentValueLabels);\n  currentValueLabelsRef.current = currentValueLabels;\n\n  const resolveCurrentValueLabels = useCallback(async () => {\n    if (!resourceType || normalizedValue.length === 0) return;\n\n    const unresolvedIds = normalizedValue.filter(id => !currentValueLabelsRef.current.has(id));\n    if (unresolvedIds.length === 0) return;\n\n    setIsLoadingCurrentValue(true);\n\n    const newLabels = new Map(currentValueLabelsRef.current);\n\n    for (const id of unresolvedIds) {\n      try {\n        const { label } = await fetchResourceReferenceRecordAndLabel({\n          resourceType,\n          id,\n          registry,\n          doOperation: doOperationRef.current,\n          contextualParameters: contextualParametersRef.current,\n          readOperation,\n          t,\n          formatDate,\n          formatDateTime,\n        });\n        newLabels.set(id, label);\n      } catch {\n        newLabels.set(id, id);\n      }\n    }\n\n    setCurrentValueLabels(newLabels);\n    setIsLoadingCurrentValue(false);\n  }, [resourceType, normalizedValue, registry, readOperation, t, formatDate, formatDateTime]);\n\n  // =========================================================================\n  // EFFECTS\n  // =========================================================================\n\n  useEffect(() => {\n    resolveCurrentValueLabels();\n  }, [resolveCurrentValueLabels]);\n\n  // SINGLE fetch driver. Every options request is caused by a user gesture\n  // observable in (isOpen, searchQuery): opening the dropdown fetches the\n  // unfiltered head (query === ''), typing fetches the debounced filtered\n  // set, clearing the query re-fetches the unfiltered head, and reopening\n  // after a failure retries exactly once (handleOpenChange clears the error).\n  //\n  // Do NOT add a data-shape condition (e.g. `options.length === 0`) as a\n  // fetch trigger here or in a sibling effect. Zero options is a RESOLVED\n  // state, not a not-yet-loaded state: a successful fetch over an empty\n  // collection settles on zero options just as legitimately as a failed one,\n  // and a shape-driven trigger turns both into an unbounded refetch loop\n  // (each completed request flips `isLoading`, re-runs the effect, and\n  // re-satisfies the \"still empty\" condition — one request per round-trip,\n  // forever). Empty is rendered by the consumer via `emptyMessage` /\n  // `fetchError`; it is only ever retried through a new gesture.\n  useEffect(() => {\n    if (!isOpen) return;\n\n    if (searchTimeoutRef.current) {\n      clearTimeout(searchTimeoutRef.current);\n    }\n\n    if (searchQuery.length >= MIN_SEARCH_CHARS) {\n      searchTimeoutRef.current = setTimeout(() => {\n        fetchOptions(searchQuery);\n      }, SEARCH_DEBOUNCE_MS);\n    } else if (searchQuery.length === 0) {\n      fetchOptions();\n    }\n\n    return () => {\n      if (searchTimeoutRef.current) {\n        clearTimeout(searchTimeoutRef.current);\n      }\n    };\n  }, [searchQuery, isOpen, fetchOptions]);\n\n  // =========================================================================\n  // SEARCH HANDLER\n  // =========================================================================\n\n  const handleSearchChange = useCallback((search: string) => {\n    setSearchQuery(search);\n  }, []);\n\n  const handleOpenChange = useCallback((open: boolean) => {\n    setIsOpen(open);\n    if (!open) {\n      setSearchQuery('');\n    } else {\n      // Reopening is the user's natural retry gesture after a failed fetch —\n      // the open transition itself triggers one new attempt via the fetch\n      // driver effect. Clearing the error here just prevents the stale error\n      // notice from flashing while that attempt is in flight.\n      setFetchError(null);\n    }\n  }, []);\n\n  // =========================================================================\n  // DISPLAY HELPERS\n  // =========================================================================\n\n  const getDisplayLabel = useCallback((id: string): string => {\n    return currentValueLabels.get(id) || id;\n  }, [currentValueLabels]);\n\n  const emptyMessage = useMemo(() => {\n    if (searchQuery.length > 0 && searchQuery.length < MIN_SEARCH_CHARS) {\n      return tComponent(FrontendComponentType.RESOURCES_FIELDS_RESOURCE_REFERENCE, 'minSearchChars', { count: String(MIN_SEARCH_CHARS) });\n    }\n    return tComponent(FrontendComponentType.RESOURCES_FIELDS_RESOURCE_REFERENCE, 'noResults');\n  }, [searchQuery, tComponent]);\n\n  // Audit D2: prefer a TARGET-NAMED placeholder (\"Select a Todo list…\") over the\n  // generic \"Select an item\". The `{target}` interpolation value is the FIELD's\n  // resolved edit label — the same string shown as the field label above the\n  // control, so placeholder and label can never disagree, and a label-tier fix\n  // (e.g. singularizing a generated plural) automatically heals the placeholder.\n  //\n  // `selectReferencePlaceholder` is a framework-declared label. An application\n  // whose generated bundle does not carry it yet shows the KEY (#1414) — it used\n  // to fall back silently to the generic placeholder, so nothing ever said label\n  // generation was owed. The generic `selectPlaceholder` is for the cases below\n  // where the parameterized wording does not apply, not for a missing label.\n  //\n  // Single-selection only: the host resource type comes from the FORM context\n  // (filter pickers outside a form keep the generic placeholder), and multi\n  // pickers keep the generic wording — their trigger shows a selection count,\n  // not an article-phrased prompt.\n  const hostResourceTypeForLabels = formSchemaContext?.resourceType;\n  const defaultPlaceholder = useMemo(() => {\n    if (!isMultiple && hostResourceTypeForLabels) {\n      const targetLabel = tResourceFieldEdit(hostResourceTypeForLabels, name, 'label');\n      if (targetLabel) {\n        return resolveComponentLabel({\n          tComponent,\n          componentType: FrontendComponentType.RESOURCES_FIELDS_RESOURCE_REFERENCE,\n          key: 'selectReferencePlaceholder',\n          params: { target: targetLabel },\n        });\n      }\n    }\n    return tComponent(FrontendComponentType.RESOURCES_FIELDS_RESOURCE_REFERENCE, 'selectPlaceholder');\n  }, [hostResourceTypeForLabels, isMultiple, name, tComponent, tResourceFieldEdit]);\n\n  return {\n    options,\n    isLoading,\n    isLoadingCurrentValue,\n    isOpen,\n    setIsOpen: handleOpenChange,\n    handleSearchChange,\n    getDisplayLabel,\n    resourceType,\n    isMultiple,\n    normalizedValue,\n    emptyMessage,\n    defaultPlaceholder,\n    fetchError,\n  };\n}\n"]}

package/dist/esm/components/sections/ContentSectionContainer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContentSectionContainer.d.ts","sourceRoot":"","sources":["../../../../../src/components/sections/ContentSectionContainer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAA+C,MAAM,OAAO,CAAC;AAEpE,OAAO,KAAK,EAEV,aAAa,EAed,MAAM,qCAAqC,CAAC;AAI7C,OAAO,EAAoG,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAkBzK,MAAM,WAAW,wBAAwB;IACvC,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,2BAA2B;IAC3B,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,wBAAwB;IACxB,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,oBAAoB;IACpB,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,2FAA2F;IAC3F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,4BAA4B;IAC3C,kCAAkC;IAClC,QAAQ,EAAE,wBAAwB,EAAE,CAAC;IACrC,qEAAqE;IACrE,MAAM,EAAE,aAAa,CAAC;IACtB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,IAAI,CAAC;CAC1D;AAqKD,eAAO,MAAM,uBAAuB,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,CA8D1E,CAAC;AA8uBF,eAAe,uBAAuB,CAAC"}
+{"version":3,"file":"ContentSectionContainer.d.ts","sourceRoot":"","sources":["../../../../src/components/sections/ContentSectionContainer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAA+C,MAAM,OAAO,CAAC;AAEpE,OAAO,KAAK,EAEV,aAAa,EAed,MAAM,qCAAqC,CAAC;AAI7C,OAAO,EAAoG,gBAAgB,EAAqB,MAAM,qCAAqC,CAAC;AAkB5L,MAAM,WAAW,wBAAwB;IACvC,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,2BAA2B;IAC3B,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,wBAAwB;IACxB,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,oBAAoB;IACpB,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,2FAA2F;IAC3F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,4BAA4B;IAC3C,kCAAkC;IAClC,QAAQ,EAAE,wBAAwB,EAAE,CAAC;IACrC,qEAAqE;IACrE,MAAM,EAAE,aAAa,CAAC;IACtB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,IAAI,CAAC;CAC1D;AAsKD,eAAO,MAAM,uBAAuB,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,CA8D1E,CAAC;AA8uBF,eAAe,uBAAuB,CAAC"}

package/dist/esm/components/sections/ContentSectionContainer.js

@@ -21,7 +21,7 @@ import { SectionMode, DisplayDirection } from '@wildo-ai/zod-decorators';
 import { cn } from '../../core/ui/cn.js';
 import { useUI } from '../../core/ui/useUI.js';
 import { useSurfacePolicy } from '../../core/ui/SurfacePolicyContext.js';
-import { ButtonSize, FrontendComponentType, LabellingTypes, UIBehavior, SelectableVariant, SurfaceVariant } from '@wildo-ai/presets-components-models';
+import { ButtonSize, FrontendComponentType, LabellingTypes, UIBehavior, SelectableVariant, SurfaceVariant, TypographyVariant } from '@wildo-ai/presets-components-models';
 import { useI18n } from '../../core/i18n/useI18n.js';
 import { Tabs, TabsList, TabsTrigger, TabsContent } from '../../components/sections/tabs.js';
 import { Timeline, TimelineBody, TimelineEntry } from '../../components/data-display/timeline.js';
@@ -82,8 +82,8 @@ function wrapModeToAppearance(wrapMode) {
  * GROUPED wrap-mode chrome (T3) — the modern default for stacked forms/settings.
  *
  * Renders ALL sections inside ONE `SurfaceVariant.CARD`, each as a flat group
- * introduced by an **eyebrow** label (`text-xs font-semibold uppercase tracking-wide
- * text-muted-foreground`) and separated by `divide-y` — instead of a bordered card
+ * introduced by an **eyebrow** label (the theme's `TypographyVariant.EYEBROW` recipe, the same voice
+ * a TITLE-styled field label takes) and separated by `divide-y` — instead of a bordered card
  * per section with a floating `<legend>`. Each group's body is a flat
  * `ContentSection` (`SectionMode.DEFAULT`) so the native `<fieldset disabled>`
  * cascade + inter-field spacing are preserved; the section title is promoted to
@@ -95,8 +95,9 @@ function wrapModeToAppearance(wrapMode) {
 const GroupedSectionsCard = ({ sections, className }) => {
     const { getRecipe } = useUI();
     const cardRecipe = getRecipe(UIBehavior.SURFACE, SurfaceVariant.CARD);
+    const eyebrowRecipe = getRecipe(UIBehavior.TYPOGRAPHY, TypographyVariant.EYEBROW);
     const getLabel = useContentSectionContainerLabel();
-    return (_jsx(Surface, { asChild: true, emitPolicyVars: false, variant: SurfaceVariant.CARD, policyOverride: { nesting: { framingMode: 'always' } }, children: _jsx("div", { role: "region", "aria-label": getLabel('contentSectionsRegion'), className: cn(cardRecipe.base, 'divide-y divide-border', className), children: sections.map((section) => (_jsxs("section", { "data-slot": "content-group", className: "space-y-field p-card", children: [(section.title != null || section.icon != null) && (_jsxs("div", { className: "flex items-center gap-element-xs text-xs font-semibold uppercase tracking-wide text-muted-foreground", children: [section.icon != null && _jsx("span", { className: "inline-flex items-center", children: section.icon }), section.title] })), section.description != null && (_jsx("p", { className: "text-sm text-muted-foreground", children: section.description })), _jsx(ContentSection, { appearance: SectionMode.DEFAULT, disabled: section.disabled, children: section.content })] }, section.id))) }) }));
+    return (_jsx(Surface, { asChild: true, emitPolicyVars: false, variant: SurfaceVariant.CARD, policyOverride: { nesting: { framingMode: 'always' } }, children: _jsx("div", { role: "region", "aria-label": getLabel('contentSectionsRegion'), className: cn(cardRecipe.base, 'divide-y divide-border', className), children: sections.map((section) => (_jsxs("section", { "data-slot": "content-group", className: "space-y-field p-card", children: [(section.title != null || section.icon != null) && (_jsxs("div", { className: cn('flex items-center gap-element-xs', eyebrowRecipe.base), children: [section.icon != null && _jsx("span", { className: "inline-flex items-center", children: section.icon }), section.title] })), section.description != null && (_jsx("p", { className: "text-sm text-muted-foreground", children: section.description })), _jsx(ContentSection, { appearance: SectionMode.DEFAULT, disabled: section.disabled, children: section.content })] }, section.id))) }) }));
 };
 /**
  * Renders a section panel WITH its heading through `ContentSection` in PANEL mode: