@salesforce/ui-bundle-template-feature-angular-search 0.0.0-stage → 12.14.0

package/dist/force-app/main/default/uiBundles/feature-angular-search/src/app/components/ui/popover/popover.ts

@@ -0,0 +1,37 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { ChangeDetectionStrategy, Component, input, model } from '@angular/core';
+import { HlmPopoverImports } from '@spartan-ng/styles/popover';
+
+@Component({
+	selector: 'app-popover',
+	changeDetection: ChangeDetectionStrategy.OnPush,
+	imports: [HlmPopoverImports],
+	templateUrl: './popover.html',
+})
+export class PopoverComponent {
+	readonly open = model<boolean>(false);
+	readonly align = input<'start' | 'center' | 'end'>('start');
+	readonly sideOffset = input<number>(4);
+	// The wrapper owns the single real trigger `<button>` (so callers project
+	// plain content, never a nested button); these style/label it.
+	readonly triggerClass = input<string>('');
+	readonly ariaLabel = input<string | null>(null, { alias: 'aria-label' });
+
+	toggle(): void {
+		this.open.set(!this.open());
+	}
+
+	close(): void {
+		this.open.set(false);
+	}
+
+	protected onStateChanged(state: 'open' | 'closed'): void {
+		this.open.set(state === 'open');
+	}
+}
+
+export const PopoverImports = [PopoverComponent] as const;

package/dist/force-app/main/default/uiBundles/feature-angular-search/src/app/components/ui/select/select.html

@@ -0,0 +1,36 @@
+@if (label()) {
+	<label hlmLabel [for]="labelId" class="mb-1.5 block">{{ label() }}</label>
+}
+@if (!multiple()) {
+	<hlm-select
+		[value]="value()"
+		(valueChange)="onSingleChange($event)"
+		[disabled]="disabled()"
+		[itemToString]="itemToString"
+	>
+		<hlm-select-trigger [buttonId]="labelId" [size]="size()" [class]="triggerClasses()">
+			<hlm-select-value [placeholder]="placeholder()" />
+		</hlm-select-trigger>
+		<hlm-select-content *hlmSelectPortal>
+			@for (option of options(); track option.value) {
+				<hlm-select-item [value]="option.value">{{ option.label }}</hlm-select-item>
+			}
+		</hlm-select-content>
+	</hlm-select>
+} @else {
+	<hlm-select-multiple
+		[value]="$any(values())"
+		(valueChange)="onMultiChange($event)"
+		[disabled]="disabled()"
+		[itemToString]="itemToString"
+	>
+		<hlm-select-trigger [buttonId]="labelId" [size]="size()" [class]="triggerClasses()">
+			<hlm-select-value [placeholder]="placeholder()" />
+		</hlm-select-trigger>
+		<hlm-select-content *hlmSelectPortal>
+			@for (option of options(); track option.value) {
+				<hlm-select-item [value]="option.value">{{ option.label }}</hlm-select-item>
+			}
+		</hlm-select-content>
+	</hlm-select-multiple>
+}

package/dist/force-app/main/default/uiBundles/feature-angular-search/src/app/components/ui/select/select.ts

@@ -0,0 +1,63 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import {
+	ChangeDetectionStrategy,
+	Component,
+	booleanAttribute,
+	computed,
+	input,
+	model,
+} from '@angular/core';
+import { HlmSelectImports } from '@spartan-ng/styles/select';
+import { HlmLabelImports } from '@spartan-ng/styles/label';
+import type { AppFieldSize } from '../field-size';
+import type { AppFieldAppearance } from '../field-appearance';
+
+export interface AppSelectOption {
+	value: string;
+	label: string;
+}
+
+@Component({
+	selector: 'app-select',
+	changeDetection: ChangeDetectionStrategy.OnPush,
+	imports: [HlmSelectImports, HlmLabelImports],
+	host: { class: 'block min-w-0' },
+	templateUrl: './select.html',
+})
+export class SelectComponent {
+	readonly value = model<string>('');
+	readonly values = model<readonly string[]>([]);
+	readonly multiple = input(false, { transform: booleanAttribute });
+	readonly options = input<readonly AppSelectOption[]>([]);
+	readonly placeholder = input<string>('');
+	readonly label = input<string>('');
+	readonly disabled = input(false, { transform: booleanAttribute });
+	readonly appearance = input<AppFieldAppearance>('outline');
+	readonly size = input<AppFieldSize>('default');
+
+	private static _uid = 0;
+	protected readonly labelId = `app-select-${SelectComponent._uid++}`;
+
+	protected readonly itemToString = (value: string): string => {
+		return this.options().find((o) => o.value === value)?.label ?? value;
+	};
+
+	protected readonly triggerClasses = computed(() => {
+		if (this.appearance() === 'fill') return 'border-transparent bg-muted';
+		return '';
+	});
+
+	protected onSingleChange(event: string | null | undefined): void {
+		this.value.set(event ?? '');
+	}
+
+	protected onMultiChange(event: string[] | readonly string[] | null | undefined): void {
+		this.values.set(event ?? []);
+	}
+}
+
+export const SelectImports = [SelectComponent] as const;

package/dist/force-app/main/default/uiBundles/feature-angular-search/src/app/components/ui/separator/separator.ts

@@ -0,0 +1,31 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { booleanAttribute, ChangeDetectionStrategy, Component, input } from '@angular/core';
+import { BrnSeparator } from '@spartan-ng/brain/separator';
+import { hlmSeparatorClass } from '@spartan-ng/styles/separator';
+import { classes } from '@spartan-ng/styles/utils';
+
+export type AppSeparatorOrientation = 'horizontal' | 'vertical';
+
+@Component({
+	selector: 'app-separator',
+	changeDetection: ChangeDetectionStrategy.OnPush,
+	hostDirectives: [{ directive: BrnSeparator, inputs: ['orientation', 'decorative'] }],
+	host: {
+		'data-slot': 'separator',
+	},
+	template: '',
+})
+export class SeparatorComponent {
+	readonly orientation = input<AppSeparatorOrientation>('horizontal');
+	readonly decorative = input(true, { transform: booleanAttribute });
+
+	constructor() {
+		classes(() => hlmSeparatorClass);
+	}
+}
+
+export const SeparatorImports = [SeparatorComponent] as const;

package/dist/force-app/main/default/uiBundles/feature-angular-search/src/app/components/ui/skeleton/skeleton.ts

@@ -0,0 +1,20 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { ChangeDetectionStrategy, Component } from '@angular/core';
+import { HlmSkeleton } from '@spartan-ng/styles/skeleton';
+
+@Component({
+	selector: 'app-skeleton',
+	changeDetection: ChangeDetectionStrategy.OnPush,
+	hostDirectives: [HlmSkeleton],
+	host: {
+		'aria-hidden': 'true',
+	},
+	template: '<ng-content />',
+})
+export class SkeletonComponent {}
+
+export const SkeletonImports = [SkeletonComponent] as const;

package/dist/force-app/main/default/uiBundles/feature-angular-search/src/app/components/ui/spinner/spinner.ts

@@ -0,0 +1,28 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { ChangeDetectionStrategy, Component, input } from '@angular/core';
+import { HlmSpinnerImports } from '@spartan-ng/styles/spinner';
+import { classes } from '@spartan-ng/styles/utils';
+
+@Component({
+	selector: 'app-spinner',
+	imports: [HlmSpinnerImports],
+	changeDetection: ChangeDetectionStrategy.OnPush,
+	host: {
+		role: 'status',
+		'[attr.aria-label]': 'ariaLabel()',
+	},
+	template: `<hlm-spinner />`,
+})
+export class SpinnerComponent {
+	public readonly ariaLabel = input<string>('Loading', { alias: 'aria-label' });
+
+	constructor() {
+		classes(() => 'text-[length:--spacing(4)]');
+	}
+}
+
+export const SpinnerImports = [SpinnerComponent] as const;

package/dist/force-app/main/default/uiBundles/feature-angular-search/src/app/features/search/adapters/registry.ts

@@ -0,0 +1,28 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+/**
+ * Adapter registry, mapping a source `kind` to its runtime adapter. A new
+ * backend is added by extending the `SourceConfig` union and registering its
+ * adapter here.
+ */
+import type { SourceConfig } from "../types/search-config.types";
+import type { SourceAdapter } from "./types";
+import { sObjectAdapter } from "./sobject";
+
+const REGISTRY: { [K in SourceConfig["kind"]]: SourceAdapter<Extract<SourceConfig, { kind: K }>> } =
+	{
+		sobject: sObjectAdapter,
+	};
+
+/** Returns the adapter registered for `kind`; throws on an unknown kind. */
+export function getAdapter(kind: SourceConfig["kind"]): SourceAdapter {
+	const adapter = REGISTRY[kind];
+	if (!adapter) {
+		throw new Error(`No search adapter registered for source kind "${kind}".`);
+	}
+	return adapter as SourceAdapter;
+}

package/dist/force-app/main/default/uiBundles/feature-angular-search/src/app/features/search/adapters/sobject/index.ts

@@ -0,0 +1,19 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+import type { SObjectSourceConfig } from "../../types/search-config.types";
+import type { SourceAdapter } from "../types";
+import { assertValidSObjectSource, buildSObjectFragment } from "./query-fragment";
+import { parseSObjectResponse } from "./parse-response";
+
+export const sObjectAdapter: SourceAdapter<SObjectSourceConfig> = {
+	kind: "sobject",
+	buildRequest: buildSObjectFragment,
+	parseResponse: parseSObjectResponse,
+	// SObject aliases live under uiapi.query.<key>
+	validateSource: assertValidSObjectSource,
+	errorPath: (request) => ["uiapi", "query", request.source.key],
+};

package/dist/force-app/main/default/uiBundles/feature-angular-search/src/app/features/search/adapters/sobject/parse-response.ts

@@ -0,0 +1,57 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+/**
+ * SObject response parser. Reads its subtree from `root.uiapi.query[source.key]`
+ * and returns `null` when the alias is absent (partial-failure leniency).
+ */
+
+import type { SObjectSourceConfig } from "../../types/search-config.types";
+import type { SourceRequest, SourceResult } from "../../types/search-result.types";
+
+interface RawSourceResult {
+	edges?: Array<{ node?: unknown }> | null;
+	pageInfo?: {
+		hasNextPage?: boolean | null;
+		hasPreviousPage?: boolean | null;
+		startCursor?: string | null;
+		endCursor?: string | null;
+	} | null;
+	totalCount?: number | null;
+}
+
+/**
+ * Maps `root.uiapi.query[source.key]` (an `edges`/`pageInfo`/`totalCount`
+ * subtree) to a {@link SourceResult}. Returns `null` when the alias is missing
+ * from the response (e.g. a partial GraphQL error blanked this source only).
+ */
+export function parseSObjectResponse(
+	root: Record<string, unknown>,
+	request: SourceRequest<SObjectSourceConfig>,
+): SourceResult | null {
+	const queryRoot = (root?.["uiapi"] as Record<string, unknown> | undefined)?.["query"] as
+		Record<string, RawSourceResult | null | undefined> | undefined;
+
+	const raw = queryRoot?.[request.source.key];
+	if (raw == null) return null;
+
+	const nodes = (raw.edges ?? [])
+		.map((edge) => edge?.node)
+		.filter((node): node is unknown => node != null);
+
+	return {
+		nodes,
+		pageInfo: raw.pageInfo
+			? {
+					hasNextPage: raw.pageInfo.hasNextPage ?? false,
+					hasPreviousPage: raw.pageInfo.hasPreviousPage ?? false,
+					startCursor: raw.pageInfo.startCursor ?? null,
+					endCursor: raw.pageInfo.endCursor ?? null,
+				}
+			: null,
+		totalCount: raw.totalCount ?? null,
+	};
+}

package/dist/force-app/main/default/uiBundles/feature-angular-search/src/app/features/search/adapters/sobject/query-fragment.ts

@@ -0,0 +1,169 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+/**
+ * SObject fragment builder. Emits one `QueryFragmentContribution` with
+ * `placement: "uiapi.query"`: the `${key}: ${objectName}(...) { ... }` selection,
+ * its 4 per-source variable declarations, and their 4 values.
+ *
+ * Selection sets are generated from `displayFields`:
+ *   - string `"Name"` → `Name @optional { value displayValue }`
+ *   - `{ name, raw: true }` → `Name`
+ *   - `{ name, subfields }` → nested `Name @optional { ... }`
+ *
+ * The `idField` (default "Id") is always emitted; it is **not** wrapped
+ * because uiapi's Id is a scalar.
+ */
+
+import { buildFilter, buildGlobalQueryClause } from "../../utils/filter-utils";
+import { assertValidIdentifier } from "../../utils/identifier";
+import { buildOrderBy } from "../../utils/sort-utils";
+import type { ActiveFilterValue } from "../../types/filter.types";
+import type { DisplayField, SObjectSourceConfig } from "../../types/search-config.types";
+import type { SourceRequest } from "../../types/search-result.types";
+import type { QueryFragmentContribution } from "../types";
+
+const KEY_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+
+function assertValidKey(key: string): void {
+	if (key.startsWith("__")) {
+		throw new Error(
+			`Invalid source key "${key}". Keys must not start with "__" (reserved by GraphQL).`,
+		);
+	}
+	if (!KEY_PATTERN.test(key)) {
+		throw new Error(
+			`Invalid source key "${key}". Must match /^[A-Za-z_][A-Za-z0-9_]*$/ to be a valid GraphQL alias and variable prefix.`,
+		);
+	}
+}
+
+/**
+ * Combines a per-source structured-filter clause with the global-q `or` clause.
+ * Returns `undefined` when neither side has any constraints.
+ */
+function assertValidDisplayField(field: DisplayField): void {
+	if (typeof field === "string") {
+		assertValidIdentifier(field, "display field");
+		return;
+	}
+	assertValidIdentifier(field.name, "display field");
+	if ("subfields" in field) field.subfields.forEach(assertValidDisplayField);
+}
+
+/**
+ * Validates every config value that is interpolated into the query document
+ * (alias, object, field and type names). Throws on the first invalid one.
+ */
+export function assertValidSObjectSource(source: SObjectSourceConfig): void {
+	assertValidKey(source.key);
+	assertValidIdentifier(source.objectName, "objectName");
+	if (source.idField !== undefined) assertValidIdentifier(source.idField, "idField");
+	if (source.whereTypeName !== undefined) {
+		assertValidIdentifier(source.whereTypeName, "whereTypeName");
+	}
+	if (source.orderByTypeName !== undefined) {
+		assertValidIdentifier(source.orderByTypeName, "orderByTypeName");
+	}
+	source.displayFields.forEach(assertValidDisplayField);
+}
+
+function buildSourceWhere(
+	source: SObjectSourceConfig,
+	q: string,
+	filters: ActiveFilterValue[],
+): unknown {
+	const clauses: unknown[] = [];
+	const globalClause = buildGlobalQueryClause(q, source.searchableFields);
+	if (globalClause) clauses.push(globalClause);
+	const structured = buildFilter(filters, source.filterBy ?? []);
+	if (structured) clauses.push(structured);
+	if (clauses.length === 0) return undefined;
+	if (clauses.length === 1) return clauses[0];
+	return { and: clauses };
+}
+
+function buildSelectionBody(source: SObjectSourceConfig): string {
+	const idField = source.idField ?? "Id";
+	const fieldLines = [`    ${idField}`];
+	for (const field of source.displayFields) {
+		fieldLines.push(...renderField(field, "    "));
+	}
+	return [
+		`  edges { node {`,
+		...fieldLines,
+		`  } }`,
+		`  pageInfo { hasNextPage hasPreviousPage startCursor endCursor }`,
+		`  totalCount`,
+	].join("\n");
+}
+
+function renderField(field: DisplayField, indentStr: string): string[] {
+	if (typeof field === "string") {
+		return [`${indentStr}${field} @optional { value displayValue }`];
+	}
+	if ("raw" in field) {
+		return [`${indentStr}${field.name}`];
+	}
+	const lines = [`${indentStr}${field.name} @optional {`];
+	for (const sub of field.subfields) {
+		lines.push(...renderField(sub, indentStr + "  "));
+	}
+	lines.push(`${indentStr}}`);
+	return lines;
+}
+
+/**
+ * Builds one SObject source's `QueryFragmentContribution`.
+ *
+ * The fragment is the `${key}: ${objectName}(...) { … }` selection that lives
+ * inside `uiapi.query`; the 4 declarations/values are the per-source
+ * `first / after / where / orderBy` variables.
+ */
+export function buildSObjectFragment(
+	request: SourceRequest<SObjectSourceConfig>,
+): QueryFragmentContribution {
+	const { source } = request;
+	assertValidSObjectSource(source);
+
+	const firstVar = `${source.key}_first`;
+	const afterVar = `${source.key}_after`;
+	const whereVar = `${source.key}_where`;
+	const orderByVar = `${source.key}_orderBy`;
+	const whereType = source.whereTypeName ?? `${source.objectName}_Filter`;
+	const orderByType = source.orderByTypeName ?? `${source.objectName}_OrderBy`;
+
+	const variableDeclarations = [
+		`$${firstVar}: Int`,
+		`$${afterVar}: String`,
+		`$${whereVar}: ${whereType}`,
+		`$${orderByVar}: ${orderByType}`,
+	];
+
+	const fragment =
+		`${source.key}: ${source.objectName}(` +
+		`first: $${firstVar}, ` +
+		`after: $${afterVar}, ` +
+		`where: $${whereVar}, ` +
+		`orderBy: $${orderByVar}` +
+		`) {\n` +
+		buildSelectionBody(source) +
+		`\n}`;
+
+	const variables: Record<string, unknown> = {
+		[firstVar]: request.pageSize,
+		[afterVar]: request.afterCursor ?? null,
+		[whereVar]: buildSourceWhere(source, request.q, request.filters) ?? null,
+		[orderByVar]: buildOrderBy(request.sort) ?? null,
+	};
+
+	return {
+		variableDeclarations,
+		variables,
+		placement: "uiapi.query",
+		fragment,
+	};
+}

package/dist/force-app/main/default/uiBundles/feature-angular-search/src/app/features/search/adapters/types.ts

@@ -0,0 +1,44 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+/**
+ * Kind-agnostic adapter contracts for multi-source search. Every searchable
+ * backend is fronted by a {@link SourceAdapter}; the query builder and response
+ * parser dispatch to the adapter registered for a source's `kind`.
+ */
+import type { SourceConfig } from "../types/search-config.types";
+import type { SourceRequest, SourceResult } from "../types/search-result.types";
+
+/** One source's contribution to the combined GraphQL document. */
+export interface QueryFragmentContribution {
+	/** GraphQL variable declarations, e.g. `"$accounts_first: Int"`. */
+	variableDeclarations: string[];
+	/** Values for the declared variables, keyed by (unprefixed) variable name. */
+	variables: Record<string, unknown>;
+	/**
+	 * Where the fragment is spliced into the combined document: inside the shared
+	 * `uiapi { query { ... } }` block, or as a sibling of `uiapi` at the root.
+	 */
+	placement: "uiapi.query" | "root";
+	/** The GraphQL selection fragment (unindented; the builder indents it). */
+	fragment: string;
+}
+
+export interface SourceAdapter<T extends SourceConfig = SourceConfig> {
+	readonly kind: T["kind"];
+	/** Build this source's fragment/variables contribution for the combined doc. */
+	buildRequest(request: SourceRequest<T>): QueryFragmentContribution;
+	/**
+	 * Extract this source's result from the response `data` root. Returns `null`
+	 * when the source's own subtree is absent or errored; never throws for a
+	 * partial failure.
+	 */
+	parseResponse(root: Record<string, unknown>, request: SourceRequest<T>): SourceResult | null;
+	/** Throws if the source config holds anything unsafe to put in a query document. */
+	validateSource(source: T): void;
+	/** The GraphQL error `path` prefix that locates this source in the response. */
+	errorPath(request: SourceRequest<T>): Array<string | number>;
+}

package/dist/force-app/main/default/uiBundles/feature-angular-search/src/app/features/search/api/search-response.spec.ts

@@ -0,0 +1,114 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+import { describe, it, expect } from "vitest";
+import { parseSearchResponse } from "./search-response";
+import type { SObjectSourceConfig } from "../types/search-config.types";
+import type { SourceRequest } from "../types/search-result.types";
+
+const source = (key: string): SObjectSourceConfig => ({
+	kind: "sobject",
+	key,
+	label: key,
+	objectName: "Account",
+	displayFields: ["Name"],
+	searchableFields: ["Name"],
+});
+
+const request = (key: string): SourceRequest => ({
+	source: source(key),
+	q: "acme",
+	filters: [],
+	sort: null,
+	pageSize: 10,
+	afterCursor: undefined,
+});
+
+const connection = (nodes: unknown[], totalCount = nodes.length) => ({
+	edges: nodes.map((node) => ({ node })),
+	pageInfo: { hasNextPage: false, hasPreviousPage: false, startCursor: null, endCursor: "c1" },
+	totalCount,
+});
+
+describe("parseSearchResponse", () => {
+	it("returns a result per source when every subtree is present", () => {
+		const outcome = parseSearchResponse(
+			[request("accounts"), request("contacts")],
+			{ uiapi: { query: { accounts: connection([{ Id: "1" }]), contacts: connection([]) } } },
+			[],
+		);
+
+		expect(outcome.results["accounts"].nodes).toEqual([{ Id: "1" }]);
+		expect(outcome.results["accounts"].totalCount).toBe(1);
+		expect(outcome.results["accounts"].pageInfo?.endCursor).toBe("c1");
+		expect(outcome.results["contacts"].nodes).toEqual([]);
+		expect(outcome.errors).toEqual({});
+	});
+
+	it("drops null edge nodes", () => {
+		const outcome = parseSearchResponse(
+			[request("accounts")],
+			{ uiapi: { query: { accounts: { edges: [{ node: null }, { node: { Id: "1" } }] } } } },
+			[],
+		);
+
+		expect(outcome.results["accounts"].nodes).toEqual([{ Id: "1" }]);
+		expect(outcome.results["accounts"].pageInfo).toBeNull();
+	});
+
+	it("partial failure: attributes the error to the failed source only", () => {
+		const outcome = parseSearchResponse(
+			[request("accounts"), request("contacts")],
+			{ uiapi: { query: { accounts: connection([{ Id: "1" }]), contacts: null } } },
+			[{ message: "Contact error", path: ["uiapi", "query", "contacts"] }],
+		);
+
+		expect(outcome.results).toHaveProperty("accounts");
+		expect(outcome.errors["contacts"]).toContain("Contact error");
+		expect(outcome.errors).not.toHaveProperty("accounts");
+	});
+
+	it("attributes errors by path across multiple failed sources", () => {
+		const outcome = parseSearchResponse(
+			[request("accounts"), request("contacts")],
+			{ uiapi: { query: { accounts: null, contacts: null } } },
+			[
+				{ message: "Account error", path: ["uiapi", "query", "accounts"] },
+				{ message: "Contact error", path: ["uiapi", "query", "contacts"] },
+			],
+		);
+
+		expect(outcome.errors["accounts"]).toContain("Account error");
+		expect(outcome.errors["contacts"]).toContain("Contact error");
+		expect(outcome.results).toEqual({});
+	});
+
+	it("does not cross-attribute: an unmatched source gets the generic message", () => {
+		const outcome = parseSearchResponse(
+			[request("accounts"), request("contacts")],
+			{ uiapi: { query: { accounts: null, contacts: null } } },
+			[{ message: "Account error", path: ["uiapi", "query", "accounts"] }],
+		);
+
+		expect(outcome.errors["accounts"]).toContain("Account error");
+		expect(outcome.errors["contacts"]).toBe("Search failed for this source.");
+	});
+
+	it("falls back to the generic message when error paths are empty", () => {
+		const outcome = parseSearchResponse([request("accounts")], {}, [
+			{ message: "Validation error", path: [] },
+		]);
+
+		expect(outcome.results).toEqual({});
+		expect(outcome.errors["accounts"]).toBe("Search failed for this source.");
+	});
+
+	it("leaves a missing subtree out of both maps when there are no errors", () => {
+		const outcome = parseSearchResponse([request("accounts")], {}, []);
+
+		expect(outcome).toEqual({ results: {}, errors: {} });
+	});
+});