@salesforce/ui-bundle-template-app-react-sample-b2e 11.55.1 → 11.56.0

package/dist/force-app/main/default/uiBundles/propertymanagementapp/src/features/search/components/results/__tests__/CmsResultRow.test.tsx

@@ -0,0 +1,139 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+import { describe, it, expect } from "vitest";
+import { render } from "@testing-library/react";
+import { MemoryRouter } from "react-router";
+import { CmsResultRow } from "../CmsResultRow";
+import type { CmsSearchItem, CmsSourceConfig } from "../../../adapters/cms/types";
+
+function renderWithRouter(
+	ui: React.ReactElement,
+	{ initialEntries = ["/"] }: { initialEntries?: string[] } = {},
+) {
+	const { container } = render(<MemoryRouter initialEntries={initialEntries}>{ui}</MemoryRouter>);
+	return container;
+}
+
+const source: CmsSourceConfig = {
+	kind: "cms",
+	key: "content",
+	label: "Content",
+	routePattern: "/content/:contentType/:id",
+};
+
+const baseItem: CmsSearchItem = {
+	managedContentId: "mc001",
+	managedContentKey: "article-key",
+	title: "Test Article",
+	contentType: "sfdc_cms__news",
+	language: "en_US",
+	managedContentChannelDeliveryDetails: [
+		{
+			contentUrl: "/content/test",
+			publishedDate: "2026-01-15T10:00:00Z",
+			managedContentChannelDetails: {
+				id: "ch001",
+				name: "Test Channel",
+				type: "public",
+			},
+		},
+	],
+};
+
+describe("CmsResultRow", () => {
+	describe("snippet rendering", () => {
+		it("renders the snippet text as plain muted text when highlightedSnippet present", () => {
+			const item: CmsSearchItem = {
+				...baseItem,
+				highlightedSnippet: "This article covers annual reports and financial data.",
+			};
+			const container = renderWithRouter(<CmsResultRow node={item} source={source} />);
+
+			expect(container.textContent).toContain(
+				"This article covers annual reports and financial data.",
+			);
+		});
+
+		it("renders the snippet with the same muted styling as the subtitle (no mark element)", () => {
+			const item: CmsSearchItem = {
+				...baseItem,
+				highlightedSnippet: "This article covers annual reports and financial data.",
+			};
+			const container = renderWithRouter(<CmsResultRow node={item} source={source} />);
+
+			expect(container.querySelector("mark")).toBeFalsy();
+			const snippet = Array.from(container.querySelectorAll("p")).find((p) =>
+				p.textContent?.includes("This article covers"),
+			);
+			expect(snippet).toBeTruthy();
+			expect(snippet?.className).toContain("text-muted-foreground");
+		});
+
+		it("renders the snippet regardless of any q param", () => {
+			const item: CmsSearchItem = {
+				...baseItem,
+				highlightedSnippet: "This article covers annual reports and financial data.",
+			};
+			const container = renderWithRouter(<CmsResultRow node={item} source={source} />, {
+				initialEntries: ["/"],
+			});
+
+			expect(container.textContent).toContain("This article covers");
+		});
+
+		it("does not render snippet element when highlightedSnippet is absent", () => {
+			const item: CmsSearchItem = {
+				...baseItem,
+			};
+			const container = renderWithRouter(<CmsResultRow node={item} source={source} />);
+
+			expect(container.textContent).toContain("Test Article");
+			expect(container.querySelector("mark")).toBeFalsy();
+		});
+
+		it("does not render snippet element when highlightedSnippet is empty string", () => {
+			const item: CmsSearchItem = {
+				...baseItem,
+				highlightedSnippet: "",
+			};
+			const container = renderWithRouter(<CmsResultRow node={item} source={source} />);
+
+			expect(container.textContent).toContain("Test Article");
+			expect(container.querySelector("mark")).toBeFalsy();
+		});
+	});
+
+	describe("link rendering", () => {
+		it("renders as a link when routePattern is configured", () => {
+			const container = renderWithRouter(<CmsResultRow node={baseItem} source={source} />, {
+				initialEntries: ["/"],
+			});
+
+			const link = container.querySelector("a");
+			expect(link).toBeTruthy();
+			expect(link?.getAttribute("href")).toBe("/content/sfdc_cms__news/mc001");
+			expect(link?.getAttribute("aria-label")).toBe("View content: Test Article");
+		});
+
+		it("renders as plain div when routePattern is not configured", () => {
+			const sourceWithoutRoute: CmsSourceConfig = {
+				kind: "cms",
+				key: "content",
+				label: "Content",
+			};
+			const container = renderWithRouter(
+				<CmsResultRow node={baseItem} source={sourceWithoutRoute} />,
+				{
+					initialEntries: ["/"],
+				},
+			);
+
+			expect(container.querySelector("a")).toBeFalsy();
+			expect(container.textContent).toContain("Test Article");
+		});
+	});
+});

package/dist/force-app/main/default/uiBundles/propertymanagementapp/src/features/search/components/results/__tests__/resolveResultRenderer.test.ts

@@ -0,0 +1,104 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+
+/**
+ * Tests for resolveResultRenderer precedence:
+ * 1. renderResult[key] override > 2. kind==="cms"→CmsResultRow > 3. DefaultResultRow
+ */
+import { describe, it, expect } from "vitest";
+import { resolveResultRenderer } from "../resolveResultRenderer";
+import type { SObjectSourceConfig, CmsSourceConfig } from "../../../types";
+
+const sobjectSource: SObjectSourceConfig = {
+	kind: "sobject",
+	key: "accounts",
+	label: "Accounts",
+	objectName: "Account",
+	displayFields: ["Name"],
+	searchableFields: ["Name"],
+};
+
+const cmsSource: CmsSourceConfig = {
+	kind: "cms",
+	key: "content",
+	label: "Content",
+};
+
+describe("resolveResultRenderer", () => {
+	it("SObject source with no override returns DefaultResultRow renderer", () => {
+		const renderer = resolveResultRenderer(sobjectSource);
+		expect(renderer).toBeTypeOf("function");
+		// Should render without throwing
+		const node = { Id: "001", Name: "Acme" };
+		const result = (renderer as (node: unknown) => unknown)(node);
+		expect(result).toBeTruthy();
+	});
+
+	it("CMS source with no override returns CmsResultRow renderer", () => {
+		const renderer = resolveResultRenderer(cmsSource);
+		expect(renderer).toBeTypeOf("function");
+		// Should render without throwing
+		const node = { managedContentId: "mc1", title: "Report" };
+		const result = (renderer as (node: unknown) => unknown)(node);
+		expect(result).toBeTruthy();
+	});
+
+	it("SObject renderer carries a DevTools displayName", () => {
+		const renderer = resolveResultRenderer(sobjectSource);
+		expect((renderer as { displayName?: string }).displayName).toBe("DefaultResultRowRenderer");
+	});
+
+	it("CMS renderer carries a DevTools displayName", () => {
+		const renderer = resolveResultRenderer(cmsSource);
+		expect((renderer as { displayName?: string }).displayName).toBe("CmsResultRowRenderer");
+	});
+
+	it("renderResult[key] override wins for SObject source (function override)", () => {
+		const customRenderer = (node: unknown) => `Custom: ${JSON.stringify(node)}`;
+		const overrides = { accounts: customRenderer };
+
+		const renderer = resolveResultRenderer(sobjectSource, overrides);
+		expect(renderer).toBe(customRenderer);
+	});
+
+	it("renderResult[key] override wins for CMS source (function override)", () => {
+		const customRenderer = (node: unknown) => `Custom CMS: ${JSON.stringify(node)}`;
+		const overrides = { content: customRenderer };
+
+		const renderer = resolveResultRenderer(cmsSource, overrides);
+		expect(renderer).toBe(customRenderer);
+	});
+
+	it("renderResult[key] = false hides the source (returns false)", () => {
+		const overrides = { accounts: false as const };
+		const renderer = resolveResultRenderer(sobjectSource, overrides);
+		expect(renderer).toBe(false);
+	});
+
+	it("renderResult[key] = false hides CMS source (returns false)", () => {
+		const overrides = { content: false as const };
+		const renderer = resolveResultRenderer(cmsSource, overrides);
+		expect(renderer).toBe(false);
+	});
+
+	it("other keys in renderResult do not affect the source without a matching key", () => {
+		const overrides = { someOtherKey: false as const };
+
+		const sobjectRenderer = resolveResultRenderer(sobjectSource, overrides);
+		expect(sobjectRenderer).toBeTypeOf("function");
+
+		const cmsRenderer = resolveResultRenderer(cmsSource, overrides);
+		expect(cmsRenderer).toBeTypeOf("function");
+	});
+
+	it("undefined renderResult is the same as no overrides", () => {
+		const renderer1 = resolveResultRenderer(sobjectSource, undefined);
+		const renderer2 = resolveResultRenderer(sobjectSource);
+		// Both should return functions (DefaultResultRow)
+		expect(renderer1).toBeTypeOf("function");
+		expect(renderer2).toBeTypeOf("function");
+	});
+});

package/dist/force-app/main/default/uiBundles/propertymanagementapp/src/features/search/components/results/resolveResultRenderer.ts

@@ -0,0 +1,49 @@
+/**
+ * Single source of truth for choosing how one source's result node is rendered.
+ *
+ * Every result layout (`SearchResults`, `MergedSearchResults`, and any future
+ * grid/list) MUST resolve its per-node renderer through this helper so the
+ * kind-aware default can never be missed in one mode. The rule, in order:
+ *
+ *   1. A `renderResult[source.key]` config override wins in EVERY mode —
+ *      including `false`, which hides the source entirely.
+ *   2. Otherwise `source.kind === "cms"` → {@link CmsResultRow}.
+ *   3. Otherwise (SObject) → {@link DefaultResultRow}.
+ *
+ * Returning the same union the callers already use (`renderer | false`) lets a
+ * component early-return `null` for a hidden source without special-casing.
+ */
+
+import { createElement, type ReactNode } from "react";
+import type { SourceConfig } from "../../types";
+import { DefaultResultRow } from "./DefaultResultRow";
+import { CmsResultRow } from "./CmsResultRow";
+
+/** A per-node renderer, or `false` to hide the source's results. */
+export type ResultRenderer = ((node: unknown) => ReactNode) | false;
+
+/**
+ * Resolves the renderer for one source. See the module doc for the precedence
+ * rules. `renderResult` is the optional per-source override map from `<Search>`.
+ */
+export function resolveResultRenderer(
+	source: SourceConfig,
+	renderResult?: Record<string, ResultRenderer>,
+): ResultRenderer {
+	const override = renderResult?.[source.key];
+	// A config override wins in every mode — including `false` (hide).
+	if (override !== undefined) return override;
+
+	// Assign a `displayName` so React DevTools shows a readable label for the
+	// per-node component factory and the `react/display-name` lint rule is
+	// satisfied. (This is a debug label only — it does not affect reference
+	// identity; a new function is still created on each call.)
+	if (source.kind === "cms") {
+		const renderCmsRow = (node: unknown) => createElement(CmsResultRow, { node, source });
+		renderCmsRow.displayName = "CmsResultRowRenderer";
+		return renderCmsRow;
+	}
+	const renderDefaultRow = (node: unknown) => createElement(DefaultResultRow, { node, source });
+	renderDefaultRow.displayName = "DefaultResultRowRenderer";
+	return renderDefaultRow;
+}

package/dist/force-app/main/default/uiBundles/propertymanagementapp/src/features/search/config.json

@@ -1,5 +1,6 @@
 {
   "pagination": {
+    "mode": "per-source",
     "pageSize": 10,
     "pageSizeOptions": [5, 10, 20]
   },
@@ -38,7 +39,6 @@
       "objectName": "Contact",
       "label": "Contacts",
       "labelSingular": "Contact",
-      "routePattern": "/contacts/:id",
       "searchableFields": ["Name", "Email", "Phone"],
       "displayFields": [
         "Name",
@@ -58,7 +58,6 @@
       "objectName": "Opportunity",
       "label": "Opportunities",
       "labelSingular": "Opportunity",
-      "routePattern": "/opportunities/:id",
       "searchableFields": ["Name"],
       "displayFields": [
         "Name",
@@ -78,6 +77,12 @@
         { "field": "Name", "label": "Name" }
       ],
       "defaultSort": { "field": "CloseDate", "direction": "DESC" }
+    },
+    {
+      "kind": "cms",
+      "key": "content",
+      "label": "Content",
+      "labelSingular": "Content"
     }
   ]
 }

package/dist/force-app/main/default/uiBundles/propertymanagementapp/src/features/search/constants.ts

@@ -0,0 +1,8 @@
+/**
+ * Minimum trimmed keyword length before a search fires. Both the SObject and
+ * CMS search backends reject terms shorter than this (returning errors that the
+ * UI would otherwise render as "Search failed for this source." on every
+ * source), so the query is gated client-side until the user types at least this
+ * many characters. Shared so every `<Search>` consumer inherits the same floor.
+ */
+export const MIN_QUERY_LENGTH = 3;