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

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

@@ -142,6 +142,9 @@ export async function fetchResourceReferenceRecordAndLabel(params) {
      */
     const record = await params.doOperation(operationPath, {
         contextualParameters,
+        ...(params.parentResourcesRequirements && params.parentResourcesRequirements.length > 0
+            ? { parentResourcesRequirements: params.parentResourcesRequirements }
+            : {}),
     }, {
         silent: true,
         riskLevel: ResourceOperationRiskLevel.LOW,

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, 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"]}
+{"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 type { FrontendResource_ParentResourceRequirement } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\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  /**\n   * The parent chain the READ must be sent through, when the caller knows the record's own route — a reference drawn\n   * with no host record passes the chain of the route it links to. Without it the request takes the most specific\n   * route its parameters satisfy, and the scoped registry injects the viewer's whole working scope into every call (a\n   * selected list included), which can route the read under a parent the record does not belong to.\n   */\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\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    ...(params.parentResourcesRequirements && params.parentResourcesRequirements.length > 0\n      ? { parentResourcesRequirements: params.parentResourcesRequirements }\n      : {}),\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;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"}
+{"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;AAaxB,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,CAiWpD"}

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

@@ -8,10 +8,12 @@
  * - Returns data shaped for Combobox/ComboboxMultiple consumption
  */
 import { useState, useEffect, useCallback, useMemo, useRef } from 'react';
-import { getArrayItemSchema, getSchemaType, FieldSchemaType } from '@wildo-ai/zod-decorators';
+import { getArrayItemSchema, getForeignKeyParams, getSchemaType, FieldSchemaType } from '@wildo-ai/zod-decorators';
+import { resolveForeignKeyReferencedResourceType } from '../../../components/data-display/reference-display-target.js';
 import { useResourceRegistry } from '../../../core/resources/useResourceRegistry.js';
 import { useI18n } from '../../../core/i18n/useI18n.js';
-import { FrontendResourceUtils } from '../../../core/resources/frontend-resource.utils.js';
+import { FrontendResourceUtils, frontendResourceUtils } from '../../../core/resources/frontend-resource.utils.js';
+import { scopeReferencedRecord } from '../../../core/resources/referenced-record-scope.frontend.utils.js';
 import { pickPreferredOperationForCoreSemantic } from '../../../core/resources/operation-semantics.frontend.utils.js';
 import { useOptionalFormSchemaContext } from '../../../components/form/useFormSchemaContext.js';
 import { resolveComponentLabel } from '../../../core/i18n/component-label-resolution.utils.js';
@@ -57,20 +59,38 @@ export function useResourceSearch({ schema, name, value, targetResourceType, })
     doOperationRef.current = doOperation;
     const contextualParametersRef = useRef(contextualParameters);
     contextualParametersRef.current = contextualParameters;
+    // The record the host renders — the one case where the host's self-referencing parent slot describes a
+    // referenced record (#2144): the form's own record, or the operation view's addressed record (a filter
+    // picker), never an id read off the host's type slot, which on a list or a CREATE is ambient scope.
+    const hostRecord = formSchemaContext
+        ? { resourceType: formSchemaContext.resourceType, id: formSchemaContext.resourceId }
+        : operationViewContext?.resourceContext
+            ? {
+                resourceType: operationViewContext.resourceContext.resourceType,
+                id: frontendResourceUtils.getAddressedRecordId(operationViewContext.resourceContext),
+            }
+            : undefined;
+    const hostRecordRef = useRef(hostRecord);
+    hostRecordRef.current = hostRecord;
     const schemaType = getSchemaType(schema);
     const isMultiple = schemaType === FieldSchemaType.ARRAY;
     const fkSchema = isMultiple ? (getArrayItemSchema(schema) || schema) : schema;
-    const resourceType = useMemo(() => {
-        if (targetResourceType) {
-            return targetResourceType;
-        }
-        try {
-            return FrontendResourceUtils.resolveResourceTypeForForeignKey(name, fkSchema, registry);
-        }
-        catch {
-            return undefined;
-        }
-    }, [fkSchema, name, registry, targetResourceType]);
+    /*
+     * The type the field references, in the DISPLAY's order (`resolveForeignKeyReferencedResourceType`): an explicit type,
+     * then the decorator's declared `referencedResourceType`, then the registry's field-to-resource map by full name.
+     *
+     * The declared type is what makes a foreign key inside an ARRAY ENTRY pickable (#2328): its name here is the runtime
+     * path (`organizationUnitMapping.0.organizationUnitId`), which no relationship declares, so the registry lookup alone
+     * missed and the picker showed "unknown resource type" while the display of the same value resolved it. The leaf name
+     * is deliberately NOT tried: it would silently retarget any nested field that shares a name with a registered one.
+     * An array FK carries the marker on the array itself, so the declared type is read from whichever schema has it.
+     */
+    const resourceType = useMemo(() => resolveForeignKeyReferencedResourceType({
+        explicitResourceType: targetResourceType,
+        schema: getForeignKeyParams(schema) ? schema : fkSchema,
+        fieldName: name,
+        registry,
+    }), [fkSchema, name, registry, schema, targetResourceType]);
     // Scope-required reference search (registry inference): the picker SEARCHES the
     // FK target (`resourceType`) directly and labels results with the TARGET's own
     // display config — never a separate "surface" resource. When the target has an
@@ -112,9 +132,11 @@ export function useResourceSearch({ schema, name, value, targetResourceType, })
             const searchParams = FrontendResourceUtils.buildForeignKeySearchParams(query, INITIAL_LOAD_LIMIT);
             // 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;
+            // caller's org). Otherwise pass the host context for a plain target search — minus the target type's
+            // self-referencing parent slots, which describe the HOST: a unit form's parent picker would otherwise
+            // search the host's siblings instead of every unit (#2144). One definition, shared with the label
+            // probe — see `resolveScopeRequiredReferenceParameters`.
+            const hostContextualParameters = frontendResourceUtils.withoutSelfReferencingParents(contextualParametersRef.current, resourceType, registry);
             const effectiveContextualParameters = resolveScopeRequiredReferenceParameters({
                 resourceType,
                 registry,
@@ -176,7 +198,16 @@ export function useResourceSearch({ schema, name, value, targetResourceType, })
                     id,
                     registry,
                     doOperation: doOperationRef.current,
-                    contextualParameters: contextualParametersRef.current,
+                    // Scoped to this record: only the tenancy is known to be the target's, not the host's parents (#2144, #2741).
+                    contextualParameters: scopeReferencedRecord({
+                        // Only the PARAMETERS of the scoped context are used here, so no identifiers are handed in.
+                        hostIdentifiers: {},
+                        hostContextualParameters: contextualParametersRef.current,
+                        hostRecord: hostRecordRef.current,
+                        targetResourceType: resourceType,
+                        targetId: id,
+                        registry,
+                    }).contextualParameters,
                     readOperation,
                     t,
                     formatDate,

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 } 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"]}
+{"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, getForeignKeyParams, getSchemaType, FieldSchemaType } from '@wildo-ai/zod-decorators';\nimport { resolveForeignKeyReferencedResourceType } from '~wildo-frontend-lib/components/data-display/reference-display-target';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { FrontendResourceUtils, frontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { scopeReferencedRecord } from '~wildo-frontend-lib/core/resources/referenced-record-scope.frontend.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  // The record the host renders — the one case where the host's self-referencing parent slot describes a\n  // referenced record (#2144): the form's own record, or the operation view's addressed record (a filter\n  // picker), never an id read off the host's type slot, which on a list or a CREATE is ambient scope.\n  const hostRecord = formSchemaContext\n    ? { resourceType: formSchemaContext.resourceType, id: formSchemaContext.resourceId }\n    : operationViewContext?.resourceContext\n      ? {\n          resourceType: operationViewContext.resourceContext.resourceType,\n          id: frontendResourceUtils.getAddressedRecordId(operationViewContext.resourceContext),\n        }\n      : undefined;\n  const hostRecordRef = useRef(hostRecord);\n  hostRecordRef.current = hostRecord;\n\n  const schemaType = getSchemaType(schema);\n  const isMultiple = schemaType === FieldSchemaType.ARRAY;\n  const fkSchema = isMultiple ? (getArrayItemSchema(schema) || schema) : schema;\n\n  /*\n   * The type the field references, in the DISPLAY's order (`resolveForeignKeyReferencedResourceType`): an explicit type,\n   * then the decorator's declared `referencedResourceType`, then the registry's field-to-resource map by full name.\n   *\n   * The declared type is what makes a foreign key inside an ARRAY ENTRY pickable (#2328): its name here is the runtime\n   * path (`organizationUnitMapping.0.organizationUnitId`), which no relationship declares, so the registry lookup alone\n   * missed and the picker showed \"unknown resource type\" while the display of the same value resolved it. The leaf name\n   * is deliberately NOT tried: it would silently retarget any nested field that shares a name with a registered one.\n   * An array FK carries the marker on the array itself, so the declared type is read from whichever schema has it.\n   */\n  const resourceType = useMemo(() => resolveForeignKeyReferencedResourceType({\n    explicitResourceType: targetResourceType,\n    schema: getForeignKeyParams(schema) ? schema : fkSchema,\n    fieldName: name,\n    registry,\n  }), [fkSchema, name, registry, schema, 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 for a plain target search — minus the target type's\n      // self-referencing parent slots, which describe the HOST: a unit form's parent picker would otherwise\n      // search the host's siblings instead of every unit (#2144). One definition, shared with the label\n      // probe — see `resolveScopeRequiredReferenceParameters`.\n      const hostContextualParameters = frontendResourceUtils.withoutSelfReferencingParents(\n        contextualParametersRef.current,\n        resourceType,\n        registry,\n      );\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          // Scoped to this record: only the tenancy is known to be the target's, not the host's parents (#2144, #2741).\n          contextualParameters: scopeReferencedRecord({\n            // Only the PARAMETERS of the scoped context are used here, so no identifiers are handed in.\n            hostIdentifiers: {},\n            hostContextualParameters: contextualParametersRef.current,\n            hostRecord: hostRecordRef.current,\n            targetResourceType: resourceType,\n            targetId: id,\n            registry,\n          }).contextualParameters,\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,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"}
+{"version":3,"file":"ContentSectionContainer.d.ts","sourceRoot":"","sources":["../../../../../src/components/sections/ContentSectionContainer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAA0D,MAAM,OAAO,CAAC;AAE/E,OAAO,KAAK,EAEV,aAAa,EAed,MAAM,qCAAqC,CAAC;AAK7C,OAAO,EAAoG,gBAAgB,EAAqB,MAAM,qCAAqC,CAAC;AAwB5L,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;AAkLD,eAAO,MAAM,uBAAuB,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,CA8D1E,CAAC;AA23BF,eAAe,uBAAuB,CAAC"}