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

package/dist/esm/components/resources-fields/_presets/resource-reference/ResourceFieldEditPreset_ResourceReference_Default.labels.js.map

@@ -1 +1 @@
-{"version":3,"file":"ResourceFieldEditPreset_ResourceReference_Default.labels.js","sourceRoot":"","sources":["../../../../../../src/components/resources-fields/_presets/resource-reference/ResourceFieldEditPreset_ResourceReference_Default.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAA4B,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAE1I,2EAA2E;AAC3E,6EAA6E;AAC7E,+EAA+E;AAE/E,MAAM,CAAC,MAAM,sCAAsC,GAA0B;IAC3E;QACE,GAAG,EAAE,WAAW;QAChB,IAAI,EAAE,SAAS,CAAC,WAAW;QAC3B,OAAO,EAAE,wEAAwE;KAClF;IACD;QACE,GAAG,EAAE,gBAAgB;QACrB,IAAI,EAAE,SAAS,CAAC,OAAO;QACvB,OAAO,EAAE,2EAA2E;QACpF,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,6DAA6D,EAAE,CAAC;KACnG;IACD;QACE,GAAG,EAAE,mBAAmB;QACxB,IAAI,EAAE,SAAS,CAAC,WAAW;QAC3B,OAAO,EAAE,yJAAyJ;KACnK;IACD;QACE,GAAG,EAAE,4BAA4B;QACjC,IAAI,EAAE,SAAS,CAAC,WAAW;QAC3B,OAAO,EACL,2OAA2O;QAC7O,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,6FAA6F,EAAE,CAAC;KACpI;IACD;QACE,GAAG,EAAE,wBAAwB;QAC7B,IAAI,EAAE,SAAS,CAAC,OAAO;QACvB,OAAO,EAAE,+FAA+F;QACxG,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,oDAAoD,EAAE,CAAC;KAC5F;CACF,CAAC;AACF,uBAAuB,CAAC,qBAAqB,CAAC,mCAAmC,EAAE,sCAAsC,CAAC,CAAC","sourcesContent":["import { FrontendComponentType, LabelKind, type LabellingUnitaryDef, registerComponentLabels } from '@wildo-ai/presets-components-models';\n\n// Companion-only label metadata for this component: keys + params + (where\n// authored) per-key purpose / kind / variable meaning. Statically scanned by\n// the dev companion; NOT imported at runtime, so it never ships in the bundle.\n\nexport const ResourcesFieldsResourceReferenceLabels: LabellingUnitaryDef[] = [\n  {\n    ref: 'noResults',\n    kind: LabelKind.EMPTY_STATE,\n    purpose: 'Shown when the resource-reference search returns no selectable options',\n  },\n  {\n    ref: 'minSearchChars',\n    kind: LabelKind.MESSAGE,\n    purpose: 'Prompts the user to type more characters before the reference search runs',\n    params: [{ key: 'count', meaning: 'minimum number of characters required to trigger the search' }],\n  },\n  {\n    ref: 'selectPlaceholder',\n    kind: LabelKind.PLACEHOLDER,\n    purpose: 'Generic placeholder for the resource-reference picker before a related record is chosen (fallback when the target-named placeholder key is unavailable)',\n  },\n  {\n    ref: 'selectReferencePlaceholder',\n    kind: LabelKind.PLACEHOLDER,\n    purpose:\n      'Target-named placeholder for a SINGLE-selection resource-reference picker (e.g. \"Select a Todo list…\"). Preferred over the generic selectPlaceholder; the runtime falls back to the generic key when this one is missing from the bundle.',\n    params: [{ key: 'target', meaning: \"the referenced field's resolved edit label (singular record-type wording, e.g. 'Todo list')\" }],\n  },\n  {\n    ref: 'fetchErrorEmptyMessage',\n    kind: LabelKind.MESSAGE,\n    purpose: 'Shown in place of options when fetching the reference candidates fails (network/server error)',\n    params: [{ key: 'message', meaning: 'human-readable error message from the failed fetch' }],\n  },\n];\nregisterComponentLabels(FrontendComponentType.RESOURCES_FIELDS_RESOURCE_REFERENCE, ResourcesFieldsResourceReferenceLabels);\n"]}
+{"version":3,"file":"ResourceFieldEditPreset_ResourceReference_Default.labels.js","sourceRoot":"","sources":["../../../../../../../src/components/resources-fields/_presets/resource-reference/ResourceFieldEditPreset_ResourceReference_Default.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAA4B,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAE1I,2EAA2E;AAC3E,6EAA6E;AAC7E,+EAA+E;AAE/E,MAAM,CAAC,MAAM,sCAAsC,GAA0B;IAC3E;QACE,GAAG,EAAE,WAAW;QAChB,IAAI,EAAE,SAAS,CAAC,WAAW;QAC3B,OAAO,EAAE,wEAAwE;KAClF;IACD;QACE,GAAG,EAAE,gBAAgB;QACrB,IAAI,EAAE,SAAS,CAAC,OAAO;QACvB,OAAO,EAAE,2EAA2E;QACpF,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,6DAA6D,EAAE,CAAC;KACnG;IACD;QACE,GAAG,EAAE,mBAAmB;QACxB,IAAI,EAAE,SAAS,CAAC,WAAW;QAC3B,OAAO,EAAE,yJAAyJ;KACnK;IACD;QACE,GAAG,EAAE,4BAA4B;QACjC,IAAI,EAAE,SAAS,CAAC,WAAW;QAC3B,OAAO,EACL,2OAA2O;QAC7O,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,6FAA6F,EAAE,CAAC;KACpI;IACD;QACE,GAAG,EAAE,wBAAwB;QAC7B,IAAI,EAAE,SAAS,CAAC,OAAO;QACvB,OAAO,EAAE,+FAA+F;QACxG,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,oDAAoD,EAAE,CAAC;KAC5F;CACF,CAAC;AACF,uBAAuB,CAAC,qBAAqB,CAAC,mCAAmC,EAAE,sCAAsC,CAAC,CAAC","sourcesContent":["import { FrontendComponentType, LabelKind, type LabellingUnitaryDef, registerComponentLabels } from '@wildo-ai/presets-components-models';\n\n// Companion-only label metadata for this component: keys + params + (where\n// authored) per-key purpose / kind / variable meaning. Statically scanned by\n// the dev companion; NOT imported at runtime, so it never ships in the bundle.\n\nexport const ResourcesFieldsResourceReferenceLabels: LabellingUnitaryDef[] = [\n  {\n    ref: 'noResults',\n    kind: LabelKind.EMPTY_STATE,\n    purpose: 'Shown when the resource-reference search returns no selectable options',\n  },\n  {\n    ref: 'minSearchChars',\n    kind: LabelKind.MESSAGE,\n    purpose: 'Prompts the user to type more characters before the reference search runs',\n    params: [{ key: 'count', meaning: 'minimum number of characters required to trigger the search' }],\n  },\n  {\n    ref: 'selectPlaceholder',\n    kind: LabelKind.PLACEHOLDER,\n    purpose: 'Generic placeholder for the resource-reference picker before a related record is chosen (fallback when the target-named placeholder key is unavailable)',\n  },\n  {\n    ref: 'selectReferencePlaceholder',\n    kind: LabelKind.PLACEHOLDER,\n    purpose:\n      'Target-named placeholder for a SINGLE-selection resource-reference picker (e.g. \"Select a Todo list…\"). Preferred over the generic selectPlaceholder; the runtime falls back to the generic key when this one is missing from the bundle.',\n    params: [{ key: 'target', meaning: \"the referenced field's resolved edit label (singular record-type wording, e.g. 'Todo list')\" }],\n  },\n  {\n    ref: 'fetchErrorEmptyMessage',\n    kind: LabelKind.MESSAGE,\n    purpose: 'Shown in place of options when fetching the reference candidates fails (network/server error)',\n    params: [{ key: 'message', meaning: 'human-readable error message from the failed fetch' }],\n  },\n];\nregisterComponentLabels(FrontendComponentType.RESOURCES_FIELDS_RESOURCE_REFERENCE, ResourcesFieldsResourceReferenceLabels);\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"ResourceFieldEditPreset_ResourceReference_Search.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources-fields/_presets/resource-reference/ResourceFieldEditPreset_ResourceReference_Search.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iDAAiD,EAAE,MAAM,qDAAqD,CAAC;AAOxH,eAAO,MAAM,gDAAgD,EAAE,OAAO,iDAAqG,CAAC"}
+{"version":3,"file":"ResourceFieldEditPreset_ResourceReference_Search.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/resources-fields/_presets/resource-reference/ResourceFieldEditPreset_ResourceReference_Search.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iDAAiD,EAAE,MAAM,qDAAqD,CAAC;AAOxH,eAAO,MAAM,gDAAgD,EAAE,OAAO,iDAAqG,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"ResourceFieldEditPreset_ResourceReference_Search.js","sourceRoot":"","sources":["../../../../../../src/components/resources-fields/_presets/resource-reference/ResourceFieldEditPreset_ResourceReference_Search.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iDAAiD,EAAE,MAAM,qDAAqD,CAAC;AAGxH,uDAAuD;AACvD,4DAA4D;AAC5D,yCAAyC;AACzC,2EAA2E;AAC3E,MAAM,CAAC,MAAM,gDAAgD,GAA6D,iDAAiD,CAAC","sourcesContent":["/**\n * ResourceFieldEditPreset_ResourceReference_Search\n *\n * Search-enabled variant of the FK edit field.\n * Currently shares implementation with Default preset which already\n * includes search functionality.\n *\n * Future enhancement: Could open a full modal for advanced search\n * with filters, pagination, etc.\n */\n\nimport { ResourceFieldEditPreset_ResourceReference_Default } from './ResourceFieldEditPreset_ResourceReference_Default';\n\n\n// The SEARCH preset uses the same component as DEFAULT\n// Both support search functionality - the Default component\n// already has debounced search built in.\n// This separation allows future differentiation (e.g., modal-based search)\nexport const ResourceFieldEditPreset_ResourceReference_Search: typeof ResourceFieldEditPreset_ResourceReference_Default = ResourceFieldEditPreset_ResourceReference_Default;\n"]}
+{"version":3,"file":"ResourceFieldEditPreset_ResourceReference_Search.js","sourceRoot":"","sources":["../../../../../../../src/components/resources-fields/_presets/resource-reference/ResourceFieldEditPreset_ResourceReference_Search.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iDAAiD,EAAE,MAAM,qDAAqD,CAAC;AAGxH,uDAAuD;AACvD,4DAA4D;AAC5D,yCAAyC;AACzC,2EAA2E;AAC3E,MAAM,CAAC,MAAM,gDAAgD,GAA6D,iDAAiD,CAAC","sourcesContent":["/**\n * ResourceFieldEditPreset_ResourceReference_Search\n *\n * Search-enabled variant of the FK edit field.\n * Currently shares implementation with Default preset which already\n * includes search functionality.\n *\n * Future enhancement: Could open a full modal for advanced search\n * with filters, pagination, etc.\n */\n\nimport { ResourceFieldEditPreset_ResourceReference_Default } from './ResourceFieldEditPreset_ResourceReference_Default';\n\n\n// The SEARCH preset uses the same component as DEFAULT\n// Both support search functionality - the Default component\n// already has debounced search built in.\n// This separation allows future differentiation (e.g., modal-based search)\nexport const ResourceFieldEditPreset_ResourceReference_Search: typeof ResourceFieldEditPreset_ResourceReference_Default = ResourceFieldEditPreset_ResourceReference_Default;\n"]}

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

@@ -7,6 +7,13 @@ export interface ResourceFieldDisplayPreset_ResourceReference_DefaultProps {
     value: string | string[] | null | undefined;
     resourceType?: string;
     data?: Record<string, unknown>;
+    /**
+     * A readable stand-in supplied by the HOLDING record, used when the reference cannot be resolved
+     * — instead of printing the raw foreign key. Resolved by the dispatcher from
+     * `foreignKeyUI.display.labelFallbackField`; absent for a field that declares none, which keeps
+     * the previous fall-through to the id.
+     */
+    labelFallback?: string;
     displayParams?: ForeignKeyUIDisplayParams;
     schema?: z.ZodTypeAny;
     className?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"ResourceFieldDisplay_ResourceReference.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources-fields/resource-reference/ResourceFieldDisplay_ResourceReference.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AAGvH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAA;AAGzE,MAAM,WAAW,yDAAyD;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,aAAa,CAAC,EAAE,yBAAyB,CAAC;IAC1C,MAAM,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,sCAAsC,CAAC,EAAC,MAAgC,EAAE,GAAG,KAAK,EAAC,EAAE,yDAAyD,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAGxM"}
+{"version":3,"file":"ResourceFieldDisplay_ResourceReference.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources-fields/resource-reference/ResourceFieldDisplay_ResourceReference.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AAGvH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAA;AAGzE,MAAM,WAAW,yDAAyD;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,yBAAyB,CAAC;IAC1C,MAAM,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,sCAAsC,CAAC,EAAC,MAAgC,EAAE,GAAG,KAAK,EAAC,EAAE,yDAAyD,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAGxM"}

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

@@ -1 +1 @@
-{"version":3,"file":"ResourceFieldDisplay_ResourceReference.js","sourceRoot":"","sources":["../../../../../src/components/resources-fields/resource-reference/ResourceFieldDisplay_ResourceReference.tsx"],"names":[],"mappings":";AAGA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iFAAiF,CAAA;AACzH,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,sCAAsC,EAAE,MAAM,qCAAqC,CAAA;AAcpI,MAAM,UAAU,sCAAsC,CAAC,EAAC,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAmF;IACnL,MAAM,SAAS,GAAG,uBAAuB,CAA4D,qBAAqB,CAAC,mCAAmC,EAAE,wCAAwC,EAAE,sCAAsC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;IAClQ,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAC;AAClC,CAAC","sourcesContent":["import React from 'react';\nimport { z } from 'zod';\nimport { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas'\nimport { createComponentResolver } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper'\nimport { FrontendComponentType, CorePresetNames, FrontEndComponentResourceFieldCategory } from '@wildo-ai/presets-components-models'\nimport type { ForeignKeyUIDisplayParams } from '@wildo-ai/zod-decorators'\n\n// --- Contract ---\nexport interface ResourceFieldDisplayPreset_ResourceReference_DefaultProps {\n  fieldName: string;\n  value: string | string[] | null | undefined;\n  resourceType?: string;\n  data?: Record<string, unknown>;\n  displayParams?: ForeignKeyUIDisplayParams;\n  schema?: z.ZodTypeAny;\n  className?: string;\n}\n\nexport function ResourceFieldDisplay_ResourceReference({preset = CorePresetNames.DEFAULT, ...props}: ResourceFieldDisplayPreset_ResourceReference_DefaultProps & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<ResourceFieldDisplayPreset_ResourceReference_DefaultProps>(FrontendComponentType.RESOURCES_FIELDS_RESOURCE_REFERENCE, 'ResourceFieldDisplay_ResourceReference', FrontEndComponentResourceFieldCategory.DISPLAY)(preset);\n  return <Component {...props} />;\n}\n"]}
+{"version":3,"file":"ResourceFieldDisplay_ResourceReference.js","sourceRoot":"","sources":["../../../../../../src/components/resources-fields/resource-reference/ResourceFieldDisplay_ResourceReference.tsx"],"names":[],"mappings":";AAGA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iFAAiF,CAAA;AACzH,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,sCAAsC,EAAE,MAAM,qCAAqC,CAAA;AAqBpI,MAAM,UAAU,sCAAsC,CAAC,EAAC,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAmF;IACnL,MAAM,SAAS,GAAG,uBAAuB,CAA4D,qBAAqB,CAAC,mCAAmC,EAAE,wCAAwC,EAAE,sCAAsC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;IAClQ,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAC;AAClC,CAAC","sourcesContent":["import React from 'react';\nimport { z } from 'zod';\nimport { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas'\nimport { createComponentResolver } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper'\nimport { FrontendComponentType, CorePresetNames, FrontEndComponentResourceFieldCategory } from '@wildo-ai/presets-components-models'\nimport type { ForeignKeyUIDisplayParams } from '@wildo-ai/zod-decorators'\n\n// --- Contract ---\nexport interface ResourceFieldDisplayPreset_ResourceReference_DefaultProps {\n  fieldName: string;\n  value: string | string[] | null | undefined;\n  resourceType?: string;\n  data?: Record<string, unknown>;\n  /**\n   * A readable stand-in supplied by the HOLDING record, used when the reference cannot be resolved\n   * — instead of printing the raw foreign key. Resolved by the dispatcher from\n   * `foreignKeyUI.display.labelFallbackField`; absent for a field that declares none, which keeps\n   * the previous fall-through to the id.\n   */\n  labelFallback?: string;\n  displayParams?: ForeignKeyUIDisplayParams;\n  schema?: z.ZodTypeAny;\n  className?: string;\n}\n\nexport function ResourceFieldDisplay_ResourceReference({preset = CorePresetNames.DEFAULT, ...props}: ResourceFieldDisplayPreset_ResourceReference_DefaultProps & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<ResourceFieldDisplayPreset_ResourceReference_DefaultProps>(FrontendComponentType.RESOURCES_FIELDS_RESOURCE_REFERENCE, 'ResourceFieldDisplay_ResourceReference', FrontEndComponentResourceFieldCategory.DISPLAY)(preset);\n  return <Component {...props} />;\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"ResourceFieldEdit_ResourceReference.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources-fields/resource-reference/ResourceFieldEdit_ResourceReference.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AAGvH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sDAAsD,CAAA;AAC5F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAA;AAGrE,MAAM,WAAW,sDACf,SAAQ,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,UAAU,GAAG,cAAc,CAAC;IACrE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;IACrC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,KAAK,IAAI,CAAC;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;;;;OASG;IACH,iBAAiB,CAAC,EAAE,qBAAqB,CAAC;IAC1C;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACnC;;;;;;OAMG;IACH,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpE;AAED,MAAM,MAAM,sCAAsC,GAAG,gBAAgB,GAAG,iBAAiB,CAAA;AAEzF,eAAO,MAAM,mCAAmC,8KAS/C,CAAA"}
+{"version":3,"file":"ResourceFieldEdit_ResourceReference.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources-fields/resource-reference/ResourceFieldEdit_ResourceReference.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AAGvH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sDAAsD,CAAA;AAC5F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAA;AAGrE,MAAM,WAAW,sDACf,SAAQ,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,UAAU,GAAG,cAAc,CAAC;IACrE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;IACrC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,KAAK,IAAI,CAAC;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;;;;OASG;IACH,iBAAiB,CAAC,EAAE,qBAAqB,CAAC;IAC1C;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACnC;;;;;;OAMG;IACH,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpE;AAED,MAAM,MAAM,sCAAsC,GAAG,gBAAgB,GAAG,iBAAiB,CAAA;AAEzF,eAAO,MAAM,mCAAmC,8KAS/C,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"ResourceFieldEdit_ResourceReference.js","sourceRoot":"","sources":["../../../../../src/components/resources-fields/resource-reference/ResourceFieldEdit_ResourceReference.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,EAAE,8BAA8B,EAAE,MAAM,iFAAiF,CAAA;AAChI,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,sCAAsC,EAAE,MAAM,qCAAqC,CAAA;AAsDpI,MAAM,CAAC,MAAM,mCAAmC,GAAG,UAAU,CAC3D,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE;IACxD,MAAM,SAAS,GAAG,8BAA8B,CAC9C,qBAAqB,CAAC,mCAAmC,EACzD,qCAAqC,EACrC,sCAAsC,CAAC,IAAI,CAC5C,CAAC,MAAM,CAAC,CAAC;IACV,OAAO,KAAC,SAAS,OAAK,KAAK,EAAE,GAAG,EAAE,GAAG,GAAI,CAAC;AAC5C,CAAC,CACA,CAAA;AACD,mCAAmC,CAAC,WAAW,GAAG,qCAAqC,CAAA","sourcesContent":["import React, { forwardRef } from 'react';\nimport { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas'\nimport { createComponentResolverWithRef } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper'\nimport { FrontendComponentType, CorePresetNames, FrontEndComponentResourceFieldCategory } from '@wildo-ai/presets-components-models'\nimport type { ControlBaseProps } from '~wildo-frontend-lib/components/form/form-field-types'\nimport type { ForeignKeyDisplayMode } from '@wildo-ai/zod-decorators'\n\n// --- Contract ---\nexport interface ResourceFieldEditPreset_ResourceReference_DefaultProps\n  extends Omit<ControlBaseProps, 'value' | 'onChange' | 'defaultValue'> {\n  value: string | string[] | undefined;\n  onChange: (value: string | string[] | undefined) => void;\n  placeholder?: string;\n  targetResourceType?: string;\n  /**\n   * Explicit option-rendering mode, overriding the FK schema's\n   * `.foreignKeyUI({ edit: { optionDisplayMode } })`.\n   *\n   * For callers whose control is NOT backed by a decorated schema field — the\n   * app-scope quick switcher picks an instance of a resource through a\n   * primary-key-fallback schema that carries no FK metadata — so the mode is\n   * declared where that control is declared instead. Omitted means \"read the\n   * schema\", which is every ordinary form field.\n   */\n  optionDisplayMode?: ForeignKeyDisplayMode;\n  /**\n   * Makes the picker CLEARABLE — the clear affordance renders inside the\n   * control (see `ComboboxProps.onClear`). Supplied by hosts whose empty state\n   * is a real, user-selectable state, such as the app-scope quick switcher\n   * (\"no scope selected\").\n   */\n  onClear?: () => void;\n  /**\n   * Leading content inside the control (see `ComboboxProps.leadingAdornment`).\n   * Supplied by hosts that give the picker its own visual identity, such as the\n   * app-scope quick switcher's ICON_LED presentation.\n   */\n  leadingAdornment?: React.ReactNode;\n  /**\n   * Relationship-aware field name used to resolve quick-create semantics.\n   *\n   * Defaults to `name`. Generated relationship object controls pass their owning\n   * object-slot name here so the quick-create policy is resolved from the\n   * relationship field, not from a synthetic selector control name.\n   */\n  quickCreateSourceFieldName?: string;\n  /**\n   * Optional callback invoked when quick create completes successfully.\n   *\n   * When omitted, the reference control applies the new id to its own selection\n   * (`replace` for single, `append` for multi).\n   */\n  onQuickCreateCreated?: (createdId: string) => void | Promise<void>;\n}\n\nexport type ResourceFieldEdit_ResourceReferenceRef = HTMLInputElement | HTMLButtonElement\n\nexport const ResourceFieldEdit_ResourceReference = forwardRef<ResourceFieldEdit_ResourceReferenceRef, ResourceFieldEditPreset_ResourceReference_DefaultProps & ComponentPresetProps>(\n  ({ preset = CorePresetNames.DEFAULT, ...props }, ref) => {\n  const Component = createComponentResolverWithRef<ResourceFieldEditPreset_ResourceReference_DefaultProps, ResourceFieldEdit_ResourceReferenceRef>(\n    FrontendComponentType.RESOURCES_FIELDS_RESOURCE_REFERENCE,\n    'ResourceFieldEdit_ResourceReference',\n    FrontEndComponentResourceFieldCategory.EDIT,\n  )(preset);\n  return <Component {...props} ref={ref} />;\n}\n)\nResourceFieldEdit_ResourceReference.displayName = 'ResourceFieldEdit_ResourceReference'\n"]}
+{"version":3,"file":"ResourceFieldEdit_ResourceReference.js","sourceRoot":"","sources":["../../../../../../src/components/resources-fields/resource-reference/ResourceFieldEdit_ResourceReference.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,EAAE,8BAA8B,EAAE,MAAM,iFAAiF,CAAA;AAChI,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,sCAAsC,EAAE,MAAM,qCAAqC,CAAA;AAsDpI,MAAM,CAAC,MAAM,mCAAmC,GAAG,UAAU,CAC3D,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE;IACxD,MAAM,SAAS,GAAG,8BAA8B,CAC9C,qBAAqB,CAAC,mCAAmC,EACzD,qCAAqC,EACrC,sCAAsC,CAAC,IAAI,CAC5C,CAAC,MAAM,CAAC,CAAC;IACV,OAAO,KAAC,SAAS,OAAK,KAAK,EAAE,GAAG,EAAE,GAAG,GAAI,CAAC;AAC5C,CAAC,CACA,CAAA;AACD,mCAAmC,CAAC,WAAW,GAAG,qCAAqC,CAAA","sourcesContent":["import React, { forwardRef } from 'react';\nimport { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas'\nimport { createComponentResolverWithRef } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper'\nimport { FrontendComponentType, CorePresetNames, FrontEndComponentResourceFieldCategory } from '@wildo-ai/presets-components-models'\nimport type { ControlBaseProps } from '~wildo-frontend-lib/components/form/form-field-types'\nimport type { ForeignKeyDisplayMode } from '@wildo-ai/zod-decorators'\n\n// --- Contract ---\nexport interface ResourceFieldEditPreset_ResourceReference_DefaultProps\n  extends Omit<ControlBaseProps, 'value' | 'onChange' | 'defaultValue'> {\n  value: string | string[] | undefined;\n  onChange: (value: string | string[] | undefined) => void;\n  placeholder?: string;\n  targetResourceType?: string;\n  /**\n   * Explicit option-rendering mode, overriding the FK schema's\n   * `.foreignKeyUI({ edit: { optionDisplayMode } })`.\n   *\n   * For callers whose control is NOT backed by a decorated schema field — the\n   * app-scope quick switcher picks an instance of a resource through a\n   * primary-key-fallback schema that carries no FK metadata — so the mode is\n   * declared where that control is declared instead. Omitted means \"read the\n   * schema\", which is every ordinary form field.\n   */\n  optionDisplayMode?: ForeignKeyDisplayMode;\n  /**\n   * Makes the picker CLEARABLE — the clear affordance renders inside the\n   * control (see `ComboboxProps.onClear`). Supplied by hosts whose empty state\n   * is a real, user-selectable state, such as the app-scope quick switcher\n   * (\"no scope selected\").\n   */\n  onClear?: () => void;\n  /**\n   * Leading content inside the control (see `ComboboxProps.leadingAdornment`).\n   * Supplied by hosts that give the picker its own visual identity, such as the\n   * app-scope quick switcher's ICON_LED presentation.\n   */\n  leadingAdornment?: React.ReactNode;\n  /**\n   * Relationship-aware field name used to resolve quick-create semantics.\n   *\n   * Defaults to `name`. Generated relationship object controls pass their owning\n   * object-slot name here so the quick-create policy is resolved from the\n   * relationship field, not from a synthetic selector control name.\n   */\n  quickCreateSourceFieldName?: string;\n  /**\n   * Optional callback invoked when quick create completes successfully.\n   *\n   * When omitted, the reference control applies the new id to its own selection\n   * (`replace` for single, `append` for multi).\n   */\n  onQuickCreateCreated?: (createdId: string) => void | Promise<void>;\n}\n\nexport type ResourceFieldEdit_ResourceReferenceRef = HTMLInputElement | HTMLButtonElement\n\nexport const ResourceFieldEdit_ResourceReference = forwardRef<ResourceFieldEdit_ResourceReferenceRef, ResourceFieldEditPreset_ResourceReference_DefaultProps & ComponentPresetProps>(\n  ({ preset = CorePresetNames.DEFAULT, ...props }, ref) => {\n  const Component = createComponentResolverWithRef<ResourceFieldEditPreset_ResourceReference_DefaultProps, ResourceFieldEdit_ResourceReferenceRef>(\n    FrontendComponentType.RESOURCES_FIELDS_RESOURCE_REFERENCE,\n    'ResourceFieldEdit_ResourceReference',\n    FrontEndComponentResourceFieldCategory.EDIT,\n  )(preset);\n  return <Component {...props} ref={ref} />;\n}\n)\nResourceFieldEdit_ResourceReference.displayName = 'ResourceFieldEdit_ResourceReference'\n"]}

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

@@ -2,15 +2,35 @@ import { type ResourceType } from '@wildo-ai/saas-models';
 import type { FieldOption } from '../../../components/form/form-field-types';
 import type { ResourceRegistryContextType } from '../../../core/resources/ResourceRegistryContext';
 import type { FrontendResourceConfiguration_Operation, FrontendResourcesRegistry } from '../../../core/resources/resources.frontend.schemas';
+type ResourceReferenceDateFormatter = (value: Date | string | number) => string;
 type ResourceReferenceTranslator = (toTranslate: string, translateParams?: {
     [key: string]: any;
 }) => string;
+/**
+ * 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 declare function resolveScopeRequiredReferenceParameters(params: {
+    resourceType: ResourceType;
+    registry: FrontendResourcesRegistry;
+    contextualParameters: Record<string, string | number>;
+}): Record<string, string | number> | undefined;
 export declare function normalizeResourceReferenceSelectionValue(value: string | string[] | null | undefined): string[];
 export declare function mapResourceReferenceOptions(params: {
     items: Record<string, unknown>[];
     resourceType: ResourceType;
     registry: FrontendResourcesRegistry;
-    t?: ResourceReferenceTranslator;
+    t: ResourceReferenceTranslator;
+    formatDate: ResourceReferenceDateFormatter;
+    formatDateTime: ResourceReferenceDateFormatter;
 }): FieldOption<string>[];
 export declare function fetchResourceReferenceRecordAndLabel(params: {
     resourceType: ResourceType;
@@ -19,7 +39,9 @@ export declare function fetchResourceReferenceRecordAndLabel(params: {
     doOperation: ResourceRegistryContextType['doOperation'];
     contextualParameters?: Record<string, string | number>;
     readOperation?: FrontendResourceConfiguration_Operation | null;
-    t?: ResourceReferenceTranslator;
+    t: ResourceReferenceTranslator;
+    formatDate: ResourceReferenceDateFormatter;
+    formatDateTime: ResourceReferenceDateFormatter;
 }): Promise<{
     record: Record<string, unknown>;
     label: string;

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

@@ -1 +1 @@
-{"version":3,"file":"resource-reference.shared.utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/resources-fields/resource-reference/resource-reference.shared.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqD,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC7G,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sDAAsD,CAAC;AACxF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,4DAA4D,CAAC;AAG9G,OAAO,KAAK,EACV,uCAAuC,EACvC,yBAAyB,EAC1B,MAAM,+DAA+D,CAAC;AAEvE,KAAK,2BAA2B,GAAG,CACjC,WAAW,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,KACrC,MAAM,CAAC;AAEZ,wBAAgB,wCAAwC,CACtD,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,GAC1C,MAAM,EAAE,CAQV;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACjC,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,EAAE,yBAAyB,CAAC;IACpC,CAAC,CAAC,EAAE,2BAA2B,CAAC;CACjC,GAAG,WAAW,CAAC,MAAM,CAAC,EAAE,CA4BxB;AAED,wBAAsB,oCAAoC,CAAC,MAAM,EAAE;IACjE,YAAY,EAAE,YAAY,CAAC;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,yBAAyB,CAAC;IACpC,WAAW,EAAE,2BAA2B,CAAC,aAAa,CAAC,CAAC;IACxD,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACvD,aAAa,CAAC,EAAE,uCAAuC,GAAG,IAAI,CAAC;IAC/D,CAAC,CAAC,EAAE,2BAA2B,CAAC;CACjC,GAAG,OAAO,CAAC;IACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAoED"}
+{"version":3,"file":"resource-reference.shared.utils.d.ts","sourceRoot":"","sources":["../../../../../../src/components/resources-fields/resource-reference/resource-reference.shared.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4E,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACpI,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sDAAsD,CAAC;AACxF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,4DAA4D,CAAC;AAG9G,OAAO,KAAK,EACV,uCAAuC,EACvC,yBAAyB,EAC1B,MAAM,+DAA+D,CAAC;AAEvE,KAAK,8BAA8B,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,KAAK,MAAM,CAAC;AAEhF,KAAK,2BAA2B,GAAG,CACjC,WAAW,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,KACrC,MAAM,CAAC;AAEZ;;;;;;;;;;;GAWG;AACH,wBAAgB,uCAAuC,CAAC,MAAM,EAAE;IAC9D,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,EAAE,yBAAyB,CAAC;IACpC,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CACvD,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,SAAS,CAc9C;AAED,wBAAgB,wCAAwC,CACtD,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,GAC1C,MAAM,EAAE,CAQV;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACjC,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,EAAE,yBAAyB,CAAC;IAEpC,CAAC,EAAE,2BAA2B,CAAC;IAE/B,UAAU,EAAE,8BAA8B,CAAC;IAE3C,cAAc,EAAE,8BAA8B,CAAC;CAChD,GAAG,WAAW,CAAC,MAAM,CAAC,EAAE,CA8BxB;AAED,wBAAsB,oCAAoC,CAAC,MAAM,EAAE;IACjE,YAAY,EAAE,YAAY,CAAC;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,yBAAyB,CAAC;IACpC,WAAW,EAAE,2BAA2B,CAAC,aAAa,CAAC,CAAC;IACxD,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACvD,aAAa,CAAC,EAAE,uCAAuC,GAAG,IAAI,CAAC;IAE/D,CAAC,EAAE,2BAA2B,CAAC;IAE/B,UAAU,EAAE,8BAA8B,CAAC;IAE3C,cAAc,EAAE,8BAA8B,CAAC;CAChD,GAAG,OAAO,CAAC;IACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAkHD"}

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":"AAAA,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,qBAAqB,EAAqB,MAAM,uBAAuB,CAAC;AAGpI,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,4DAA4D,CAAC;AAC1H,OAAO,EAAE,+CAA+C,EAAE,mDAAmD,EAAE,MAAM,2EAA2E,CAAC;AAajM;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,uCAAuC,CAAC,MAIvD;IACC,mDAAmD;IACnD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB;QAAE,OAAO,SAAS,CAAC;IAChE,MAAM,aAAa,GAAG,qBAAqB,CAAC,mCAAmC,CAC7E,MAAM,CAAC,QAAQ,CAAC,wBAAwB,EACxC,MAAM,CAAC,YAAY,EACnB,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,CAClD,CAAC;IACF,IAAI,CAAC,aAAa;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,UAAU,GAAG,MAAM,CAAC,oBAAoB,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;IAC3E,IAAI,CAAC,OAAO,UAAU,KAAK,QAAQ,IAAI,OAAO,UAAU,KAAK,QAAQ,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3G,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,EAAE,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,wCAAwC,CACtD,KAA2C;IAE3C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QAC1D,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzB,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE,CAAC;QACrF,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,MAU3C;IACC,MAAM,eAAe,GAAG,qBAAqB,CAAC,iCAAiC,CAC7E,MAAM,CAAC,YAAY,EACnB,MAAM,CAAC,QAAQ,CAChB,CAAC;IAEF,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QACnC,8EAA8E;QAC9E,gFAAgF;QAChF,4EAA4E;QAC5E,gDAAgD;QAChD,MAAM,EAAE,GAAG,qBAAqB,CAAC,mBAAmB,CAAC,IAA+B,EAAE,eAAe,CAAC,CAAC;QACvG,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,KAAK,GAAG,qBAAqB,CAAC,4BAA4B,CAAC;YAC/D,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,aAAa,EAAE,IAAI;YACnB,CAAC,EAAE,MAAM,CAAC,CAAC;YACX,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,cAAc,EAAE,MAAM,CAAC,cAAc;SACtC,CAAC,IAAI,EAAE,CAAC;QAET,gFAAgF;QAChF,iFAAiF;QACjF,0EAA0E;QAC1E,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oCAAoC,CAAC,MAa1D;IAIC;;;;;;;;;;OAUG;IACH,MAAM,gBAAgB,GAAG,uCAAuC,CAAC;QAC/D,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,oBAAoB,EAAE,MAAM,CAAC,oBAAoB,IAAI,EAAE;KACxD,CAAC,CAAC;IACH,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CACrC,qBAAqB,CAAC,kCAAkC,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,EAC9F,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,eAAe,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EACzF,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,0BAA0B,CAAC,GAAG,EAAE,CAC5D,CAAC;QACF,MAAM,KAAK,GAA8B,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAC5D,CAAC,CAAC,MAAmC;YACrC,CAAC,CAAC,CAAE,MAAyF,EAAE,IAAI;mBAC7F,MAAuD,EAAE,KAAK;mBAC/D,EAAE,CAAC,CAAC;QACX,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,aAAa,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,EAAE,qCAAqC,CAAC,CAAC;QACtG,CAAC;QACD,OAAO;YACL,MAAM;YACN,KAAK,EAAE,qBAAqB,CAAC,4BAA4B,CAAC;gBACxD,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,aAAa,EAAE,MAAM;gBACrB,CAAC,EAAE,MAAM,CAAC,CAAC;gBACb,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,cAAc,EAAE,MAAM,CAAC,cAAc;aACpC,CAAC,IAAI,MAAM,CAAC,EAAE;SAChB,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,qBAAqB,CAAC,0BAA0B,CACpE,MAAM,CAAC,YAAY,EACnB,MAAM,CAAC,EAAE,EACT,MAAM,CAAC,QAAQ,CAChB,CAAC;IACF,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACnF,MAAM,0BAA0B,GAAG;QACjC,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,EAAE;KACjC,CAAC;IACF,MAAM,oBAAoB,GAAG;QAC3B,GAAG,CAAC,MAAM,CAAC,oBAAoB,IAAI,EAAE,CAAC;QACtC,GAAG,CAAC,aAAa,CAAC,oBAAoB,IAAI,EAAE,CAAC;KAC9C,CAAC;IACF,MAAM,+BAA+B,GAAG,cAAc;QACpD,CAAC,CAAC,CACE,MAAM,CAAC,aAAa;eACjB,+CAA+C,CAAC;gBACjD,cAAc;gBACd,SAAS,EAAE,MAAM,CAAC,aAAa;gBAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,aAAa,EAAE,qBAAqB,CAAC,aAAa,CAAC,0BAA0B,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC;gBAC9G,0BAA0B;gBAC1B,oBAAoB;aACrB,CAAC;YACA,CAAC,CAAC,MAAM,CAAC,aAAa;YACtB,CAAC,CAAC,mDAAmD,CAAC;gBACpD,cAAc;gBACd,UAAU,EAAE,cAAc,CAAC,UAAU,IAAI,EAAE;gBAC3C,aAAa,EAAE,qBAAqB,CAAC,IAAI;gBACzC,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,aAAa,EAAE,IAAI;gBACnB,0BAA0B;gBAC1B,oBAAoB;aACrB,CAAC,CACL;QACH,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;IACzB,MAAM,aAAa,GAAG,qBAAqB,CAAC,gCAAgC,CAC1E,MAAM,CAAC,YAAY,EACnB,MAAM,CAAC,QAAQ,EACf,+BAA+B,CAChC,CAAC;IACF;;;;;;;;;OASG;IACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAA0B,aAAa,EAAE;QAC9E,oBAAoB;KACrB,EAAE;QACD,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,0BAA0B,CAAC,GAAG;KAC1C,CAAC,CAAC;IAEH,OAAO;QACL,MAAM;QACN,KAAK,EAAE,qBAAqB,CAAC,4BAA4B,CAAC;YACxD,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,aAAa,EAAE,MAAM;YACrB,CAAC,EAAE,MAAM,CAAC,CAAC;YACX,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,cAAc,EAAE,MAAM,CAAC,cAAc;SACtC,CAAC,IAAI,MAAM,CAAC,EAAE;KAChB,CAAC;AACJ,CAAC","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

@@ -9,7 +9,7 @@
  */
 import { z } from 'zod';
 import type { FieldOption } from '../../../components/form/form-field-types';
-import { type EnhancedError } from '../../../core/errors/errors.frontend.schemas';
+import { type DisplayableError } from '../../../core/errors/errors.frontend.schemas';
 export interface UseResourceSearchOptions {
     schema: z.ZodTypeAny;
     name: string;
@@ -33,9 +33,9 @@ export interface UseResourceSearchResult {
      * E-4: surfaced error for the most-recent options fetch.
      * Consumers (Combobox/ComboboxMultiple presets) can render this as an inline
      * footer/notice in the dropdown so users know why the list is empty.
-     * `null` when there is no error to display.
+     * `null` when there is no error to display. Its `message` is already localized text (#1160).
      */
-    fetchError: EnhancedError | null;
+    fetchError: DisplayableError | null;
 }
 export declare function useResourceSearch({ schema, name, value, targetResourceType, }: UseResourceSearchOptions): UseResourceSearchResult;
 //# sourceMappingURL=useResourceSearch.d.ts.map

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,aAAa,EAAE,MAAM,yDAAyD,CAAC;AAe/G,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,aAAa,GAAG,IAAI,CAAC;CAClC;AAMD,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,IAAI,EACJ,KAAK,EACL,kBAAkB,GACnB,EAAE,wBAAwB,GAAG,uBAAuB,CAuUpD"}
+{"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,9 +17,10 @@ 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';
 // =============================================================================
 // CONSTANTS
@@ -32,7 +33,8 @@ 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
     // list's `ResourceOperationViewProvider`, which carries the rendered
@@ -108,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,
@@ -143,18 +140,22 @@ export function useResourceSearch({ schema, name, value, targetResourceType, })
                 resourceType,
                 registry,
                 t,
+                formatDate,
+                formatDateTime,
             }));
         }
         catch (err) {
             const errorInfo = extractErrorInfo(err);
-            LoggerFrontendService.getLogger().error('[useResourceSearch] Failed to fetch options:', { resourceType, query, error: errorInfo });
-            setFetchError(errorInfo);
+            LoggerFrontendService.getLogger().error('[useResourceSearch] Failed to fetch options:', { resourceType, query, ...errorInfo, error: err });
+            // Shown in the picker's empty state: localized text, never the reference (#1160). The resolver has a
+            // stable identity, so this callback's dependencies are unchanged.
+            setFetchError({ ...errorInfo, message: toUserFacingErrorMessage(err) });
             setOptions([]);
         }
         finally {
             setIsLoading(false);
         }
-    }, [resourceType, registry, t]);
+    }, [resourceType, registry, t, formatDate, formatDateTime]);
     // =========================================================================
     // RESOLVE CURRENT VALUE LABELS
     // =========================================================================
@@ -178,6 +179,8 @@ export function useResourceSearch({ schema, name, value, targetResourceType, })
                     contextualParameters: contextualParametersRef.current,
                     readOperation,
                     t,
+                    formatDate,
+                    formatDateTime,
                 });
                 newLabels.set(id, label);
             }
@@ -187,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
     // =========================================================================
@@ -266,13 +269,11 @@ export function useResourceSearch({ schema, name, value, targetResourceType, })
     // control, so placeholder and label can never disagree, and a label-tier fix
     // (e.g. singularizing a generated plural) automatically heals the placeholder.
     //
-    // Fallback chain (each step degrades gracefully):
-    // 1. `selectReferencePlaceholder` with `{target}` — requires the app's
-    //    generated component bundle to carry the key. `resolveComponentLabel`
-    //    detects a bundle miss (tComponent returns the key path verbatim) and
-    //    yields '' instead of leaking the raw key, so apps that have not rerun
-    //    label generation keep the current generic placeholder unchanged.
-    // 2. The generic `selectPlaceholder` (pre-existing behavior).
+    // `selectReferencePlaceholder` is a framework-declared label. An application
+    // whose generated bundle does not carry it yet shows the KEY (#1414) — it used
+    // to fall back silently to the generic placeholder, so nothing ever said label
+    // generation was owed. The generic `selectPlaceholder` is for the cases below
+    // where the parameterized wording does not apply, not for a missing label.
     //
     // Single-selection only: the host resource type comes from the FORM context
     // (filter pickers outside a form keep the generic placeholder), and multi
@@ -283,15 +284,12 @@ export function useResourceSearch({ schema, name, value, targetResourceType, })
         if (!isMultiple && hostResourceTypeForLabels) {
             const targetLabel = tResourceFieldEdit(hostResourceTypeForLabels, name, 'label');
             if (targetLabel) {
-                const parameterized = resolveComponentLabel({
+                return resolveComponentLabel({
                     tComponent,
                     componentType: FrontendComponentType.RESOURCES_FIELDS_RESOURCE_REFERENCE,
                     key: 'selectReferencePlaceholder',
                     params: { target: targetLabel },
                 });
-                if (parameterized !== '') {
-                    return parameterized;
-                }
             }
         }
         return tComponent(FrontendComponentType.RESOURCES_FIELDS_RESOURCE_REFERENCE, 'selectPlaceholder');