npm - @wildo-ai/saas-frontend-lib - Versions diffs - 1.1.4 → 1.1.5 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2512) hide show

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

	@@ -1 +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"]}
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"]}

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

@@ -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 CHANGED Viewed

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

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

@@ -20,6 +20,7 @@ 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 { 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
@@ -33,6 +34,7 @@ const MIN_SEARCH_CHARS = 2;
 export function useResourceSearch({ schema, name, value, targetResourceType, }) {
     const { registry, doOperation } = useResourceRegistry();
     const { t, tComponent, tResourceFieldEdit } = useI18n({ component: FrontendComponentType.RESOURCES_FIELDS_RESOURCE_REFERENCE });
+    const toUserFacingErrorMessage = useUserFacingErrorMessage();
     const formSchemaContext = useOptionalFormSchemaContext();
     // Filter pickers render OUTSIDE a form (no FormSchemaContext) but INSIDE the
     // list's `ResourceOperationViewProvider`, which carries the rendered
@@ -147,8 +149,10 @@ export function useResourceSearch({ schema, name, value, targetResourceType, })
         }
         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 {
@@ -266,13 +270,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 +285,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');

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

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

package/dist/esm/components/sections/ContentSectionContainer.d.ts CHANGED Viewed

@@ -17,6 +17,7 @@
  */
 import React from 'react';
 import type { SectionConfig } from '@wildo-ai/presets-components-models';
+import { IndicatorVariant } from '@wildo-ai/presets-components-models';
 export interface ContentSectionDescriptor {
     /** Unique identifier for the section */
     id: string;
@@ -28,6 +29,9 @@ export interface ContentSectionDescriptor {
     content: React.ReactNode;
     /** Optional icon */
     icon?: React.ReactNode;
+    /** A count the section's tab carries beside its title, in the tone it reads in (#1325). */
+    count?: number;
+    countTone?: IndicatorVariant;
     /** Whether section is disabled */
     disabled?: boolean;
 }

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

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

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

@@ -24,6 +24,7 @@ import { useSurfacePolicy } from '../../core/ui/SurfacePolicyContext.js';
 import { ButtonSize, FrontendComponentType, LabellingTypes, UIBehavior, SelectableVariant, SurfaceVariant } from '@wildo-ai/presets-components-models';
 import { useI18n } from '../../core/i18n/useI18n.js';
 import { Tabs, TabsList, TabsTrigger, TabsContent } from '../../components/sections/tabs.js';
+import { Timeline, TimelineBody, TimelineEntry } from '../../components/data-display/timeline.js';
 import { Accordion, AccordionItem, AccordionTrigger, AccordionContent } from '../../components/sections/accordion.js';
 import { ToggleGroupType } from '../../components/form/controls/enum/toggle-group.js';
 import { Collapsible, CollapsibleTrigger, CollapsibleContent } from '../../components/sections/collapsible.js';
@@ -233,7 +234,7 @@ const TabsMode = ({ sections, config, className, sectionWrapMode, onSectionChang
      * In the controlled shape every user click is only REPORTED through `onSectionChange`; an
      * owner that sets `activeSection` and ignores the callback has frozen its tabs.
      */
-    , { ...(config.activeSection !== undefined ? { value: config.activeSection } : { defaultValue }), className: className, onValueChange: (value) => onSectionChange?.(value), children: [_jsx(TabsList, { role: "tablist", "aria-label": config.ariaLabel ?? getLabel('sectionTabsNav'), children: sections.map((section) => (_jsxs(TabsTrigger, { value: section.id, disabled: section.disabled, role: "tab", "aria-controls": `panel-${section.id}`, children: [section.icon && _jsx("span", { className: "me-element", children: section.icon }), section.title] }, section.id))) }), sections.map((section) => (_jsx(TabsContent, { value: section.id, role: "tabpanel", id: `panel-${section.id}`, "aria-labelledby": section.id,
+    , { ...(config.activeSection !== undefined ? { value: config.activeSection } : { defaultValue }), className: className, onValueChange: (value) => onSectionChange?.(value), children: [_jsx(TabsList, { role: "tablist", "aria-label": config.ariaLabel ?? getLabel('sectionTabsNav'), children: sections.map((section) => (_jsxs(TabsTrigger, { value: section.id, disabled: section.disabled, role: "tab", "aria-controls": `panel-${section.id}`, ...(section.count !== undefined ? { count: section.count } : {}), ...(section.countTone !== undefined ? { countTone: section.countTone } : {}), children: [section.icon && _jsx("span", { className: "me-element", children: section.icon }), section.title] }, section.id))) }), sections.map((section) => (_jsx(TabsContent, { value: section.id, role: "tabpanel", id: `panel-${section.id}`, "aria-labelledby": section.id,
                 // Radix unmounts inactive panels, so the active one mounts fresh on each
                 // switch — `animate-in fade-in-0` runs once per activation (a subtle
                 // cross-fade instead of an instant pop).
@@ -266,7 +267,7 @@ const VerticalTabsMode = ({ sections, config, className, sectionWrapMode, onSect
          * different control. The horizontal set gets its separation for free from the strip's own
          * bottom rule; this one has no such edge, so the space has to be declared.
          */
-        className: cn('mt-field', className), onValueChange: (value) => onSectionChange?.(value), children: [_jsx(TabsList, { className: cn(navWidth, 'shrink-0 self-start border-e pe-card'), "aria-label": config.ariaLabel ?? getLabel('verticalTabsRegion'), children: sections.map((section) => (_jsxs(TabsTrigger, { value: section.id, disabled: section.disabled, children: [section.icon && _jsx("span", { className: "inline-flex items-center shrink-0", children: section.icon }), section.title] }, section.id))) }), sections.map((section) => (_jsx(TabsContent, { value: section.id, className: "min-w-0 flex-1 animate-in fade-in-0 duration-[var(--motion-duration-fast)]", children: renderSectionContentChrome(section, section.content, sectionWrapMode) }, section.id)))] }));
+        className: cn('mt-field', className), onValueChange: (value) => onSectionChange?.(value), children: [_jsx(TabsList, { className: cn(navWidth, 'shrink-0 self-start border-e pe-card'), "aria-label": config.ariaLabel ?? getLabel('verticalTabsRegion'), children: sections.map((section) => (_jsxs(TabsTrigger, { value: section.id, disabled: section.disabled, ...(section.count !== undefined ? { count: section.count } : {}), ...(section.countTone !== undefined ? { countTone: section.countTone } : {}), children: [section.icon && _jsx("span", { className: "inline-flex items-center shrink-0", children: section.icon }), section.title] }, section.id))) }), sections.map((section) => (_jsx(TabsContent, { value: section.id, className: "min-w-0 flex-1 animate-in fade-in-0 duration-[var(--motion-duration-fast)]", children: renderSectionContentChrome(section, section.content, sectionWrapMode) }, section.id)))] }));
 };
 /**
  * PILLS — a horizontal nav tablist over a single content pane.
@@ -379,6 +380,7 @@ const ExpandableMode = ({ sections, config, className, sectionWrapMode }) => {
 const StepperMode = ({ sections, config, className, sectionWrapMode, onSectionChange }) => {
     const [currentStep, setCurrentStep] = useState(0);
     const getLabel = useContentSectionContainerLabel();
+    const progressNavId = useId();
     const orientation = config.orientation ?? 'horizontal';
     // The numbered step indicators (filled circles + connectors) ALREADY communicate
     // progress, so the separate linear progress bar is redundant by default — a
@@ -405,16 +407,21 @@ const StepperMode = ({ sections, config, className, sectionWrapMode, onSectionCh
         onSectionChange?.(sections[index].id);
     };
     const currentSection = sections[currentStep];
-    return (_jsxs("div", { className: cn('space-y-section', className), children: [_jsx("nav", { className: cn('flex', orientation === 'horizontal' ? 'flex-row gap-field' : 'flex-col gap-element'), "aria-label": config.ariaLabel ?? getLabel('stepperProgressNav'), children: sections.map((section, index) => {
+    return (_jsxs("div", { className: cn('space-y-section', className), children: [_jsx("nav", { id: progressNavId, className: cn('flex', orientation === 'horizontal' ? 'flex-row gap-field' : 'flex-col gap-element'), "aria-label": config.ariaLabel ?? getLabel('stepperProgressNav'), children: sections.map((section, index) => {
                     const isCompleted = index < currentStep;
                     const isCurrent = index === currentStep;
                     const isClickable = canNavigate(index);
                     return (_jsxs("button", { type: "button", onClick: () => handleStepChange(index), disabled: !isClickable, className: cn('flex items-center gap-element', orientation === 'horizontal' ? 'flex-1' : '', !isClickable && 'cursor-not-allowed opacity-[var(--opacity-disabled)]'), "aria-current": isCurrent ? 'step' : undefined, children: [_jsx("div", { className: cn('w-8 h-8 rounded-full flex items-center justify-center text-sm font-medium border-2', isCompleted && 'bg-primary text-primary-foreground border-primary', isCurrent && 'border-primary text-primary', !isCompleted && !isCurrent && 'border-muted-foreground/30'), children: isCompleted ? completedIcon : index + 1 }), _jsx("span", { className: cn('text-sm', isCurrent && 'font-medium', !isCurrent && !isCompleted && 'text-muted-foreground'), children: section.title }), orientation === 'horizontal' && index < sections.length - 1 && (_jsx("div", { className: cn('flex-1 h-0.5', isCompleted ? 'bg-primary' : 'bg-muted-foreground/30') }))] }, section.id));
-                }) }), showProgress && (_jsx("div", { className: "w-full bg-muted rounded-full h-2", children: _jsx("div", { className: "bg-primary h-2 rounded-full transition-[width]", style: { width: `${((currentStep + 1) / sections.length) * 100}%` }, role: "progressbar", "aria-valuenow": currentStep + 1, "aria-valuemin": 1, "aria-valuemax": sections.length }) })), currentSection && (_jsx("div", { className: "animate-in fade-in-0 duration-[var(--motion-duration-fast)]", children: renderSectionContentChrome(currentSection, currentSection.content, sectionWrapMode) }, currentSection.id)), _jsxs("div", { className: "flex justify-between", children: [_jsx(Button, { variant: ButtonVariants_Variant.OUTLINE, onClick: () => handleStepChange(currentStep - 1), disabled: currentStep === 0, children: previousLabel }), _jsx(Button, { onClick: () => handleStepChange(currentStep + 1), disabled: currentStep === sections.length - 1, children: currentStep === sections.length - 1 ? completeLabel : nextLabel })] })] }));
+                }) }), showProgress && (_jsx("div", { className: "w-full bg-muted rounded-full h-2", children: _jsx("div", { className: "bg-primary h-2 rounded-full transition-[width]", style: { width: `${((currentStep + 1) / sections.length) * 100}%` }, role: "progressbar", "aria-labelledby": progressNavId, "aria-valuenow": currentStep + 1, "aria-valuemin": 1, "aria-valuemax": sections.length }) })), currentSection && (_jsx("div", { className: "animate-in fade-in-0 duration-[var(--motion-duration-fast)]", children: renderSectionContentChrome(currentSection, currentSection.content, sectionWrapMode) }, currentSection.id)), _jsxs("div", { className: "flex justify-between", children: [_jsx(Button, { variant: ButtonVariants_Variant.OUTLINE, onClick: () => handleStepChange(currentStep - 1), disabled: currentStep === 0, children: previousLabel }), _jsx(Button, { onClick: () => handleStepChange(currentStep + 1), disabled: currentStep === sections.length - 1, children: currentStep === sections.length - 1 ? completeLabel : nextLabel })] })] }));
 };
 const TimelineMode = ({ sections, config, className, sectionWrapMode }) => {
     const getLabel = useContentSectionContainerLabel();
-    return (_jsxs("div", { className: cn('relative', className), role: "region", "aria-label": config.ariaLabel ?? getLabel('timelineRegion'), children: [_jsx("div", { className: "absolute start-4 top-0 bottom-0 w-0.5 bg-border" }), _jsx("div", { className: "space-y-section", children: sections.map((section, index) => (_jsxs("div", { className: "relative ps-10", children: [_jsx("div", { className: "absolute left-2.5 w-3 h-3 rounded-full bg-primary border-2 border-background" }), renderSectionContentChrome(section, _jsxs(_Fragment, { children: [_jsxs("div", { className: "flex items-center gap-element mb-element", children: [section.icon, _jsx("h3", { className: "font-semibold", children: section.title }), _jsx(Badge, { variant: "outline", className: "ms-auto", children: getLabel('timelineStep', { step: index + 1 }) })] }), section.description && (_jsx("p", { className: "text-sm text-muted-foreground mb-element", children: section.description })), section.content] }), sectionWrapMode)] }, section.id))) })] }));
+    /*
+     * Drawn on the framework's own `Timeline` since #1317 — this mode used to draw a private rail and
+     * dot of its own, the first of three hand-drawn timelines the one component replaced. Each section
+     * is an entry; a section step has no status, so the marker is the NEUTRAL tone.
+     */
+    return (_jsx("div", { className: className, role: "region", "aria-label": config.ariaLabel ?? getLabel('timelineRegion'), children: _jsx(Timeline, { className: "gap-section", children: sections.map((section, index) => (_jsx(TimelineEntry, { children: _jsx(TimelineBody, { children: renderSectionContentChrome(section, _jsxs(_Fragment, { children: [_jsxs("div", { className: "flex items-center gap-element mb-element", children: [section.icon, _jsx("h3", { className: "font-semibold", children: section.title }), _jsx(Badge, { variant: "outline", className: "ms-auto", children: getLabel('timelineStep', { step: index + 1 }) })] }), section.description && (_jsx("p", { className: "text-sm text-muted-foreground mb-element", children: section.description })), section.content] }), sectionWrapMode) }) }, section.id))) }) }));
 };
 // =============================================================================
 // EXPORTS