@phis/ui 0.4.2 → 0.4.4

package/plugins/runtime-modules/client-authoring-module.js

@@ -1,6 +1,6 @@
 "use client";
 import { jsx as _jsx } from "react/jsx-runtime";
-import { createContext, lazy, useContext, useMemo, } from "react";
+import { createContext, lazy, useCallback, useContext, useMemo, } from "react";
 const PhiRuntimeModuleAuthoringContext = createContext(new Map());
 function createPhiLazyAuthoringLayout(load) {
     return lazy(async () => {
@@ -54,8 +54,7 @@ export function usePhiRuntimeModuleAuthoringRegistration(moduleId) {
     const modules = useContext(PhiRuntimeModuleAuthoringContext);
     return moduleId ? modules.get(moduleId) ?? null : null;
 }
-export function usePhiAuthoringLayoutDefinition(type) {
-    const modules = useContext(PhiRuntimeModuleAuthoringContext);
+function findPhiAuthoringLayoutDefinition(modules, type) {
     for (const registration of modules.values()) {
         const definition = registration.layoutsByType.get(type);
         if (definition) {
@@ -64,3 +63,14 @@ export function usePhiAuthoringLayoutDefinition(type) {
     }
     return null;
 }
+/**
+ * The authoring Layout definitions, as a lookup by type rather than one type's answer.
+ *
+ * A Layout names its nested Layouts only while it renders its children, and a parent Layout sizes each
+ * slot by the props of the element standing in it, before that element renders: a nested Layout's
+ * element has to carry its policy already, and a hook inside it would be too late.
+ */
+export function usePhiAuthoringLayoutDefinitionResolver() {
+    const modules = useContext(PhiRuntimeModuleAuthoringContext);
+    return useCallback((type) => findPhiAuthoringLayoutDefinition(modules, type), [modules]);
+}

package/plugins/runtime-modules/client-manifests/common.js

@@ -11,7 +11,7 @@ import { PHI_ASSET_RUNTIME_MODULE_ID } from "../asset/ids";
 import { PHI_MEDIA_LIBRARY_ITEM_RENDERER_KEY } from "../../../constants/media-library-provider-keys";
 import { PHI_DASHBOARD_CARD_ITEM_RENDERER_KEY } from "../../../constants/dashboard-card-provider-keys";
 import { createPhiRuntimeModuleCalendarAdapterClientManifest } from "../../../components/runtime/runtime-module-calendar-adapter-client-manifest";
-import { PHI_CORE_CALENDAR_ADAPTER_CLIENT_DEFINITIONS } from "../client-calendar-adapters/core";
+import { PHI_CORE_CALENDAR_ADAPTER_CLIENT_DEFINITIONS } from "../core/client-calendar-adapters";
 import { PhiLazyAssetRuntimeControllerClient } from "../asset/client";
 import { createPhiRuntimeModuleUiProviderClientManifest, } from "../../../components/runtime/runtime-module-ui-provider-client-manifest";
 import { PHI_AUTH_RUNTIME_MODULE_ID } from "../auth/ids";

package/plugins/runtime-modules/{runtime-calendar-adapters.js → core/calendar-adapters.js}

@@ -1,5 +1,5 @@
-import { PHI_GREGORY_CALENDAR_ADAPTER_KEY } from "../../types/calendar-keys";
-import { PHI_CORE_RUNTIME_MODULE_ID } from "./core/ids";
+import { PHI_GREGORY_CALENDAR_ADAPTER_KEY } from "../../../types/calendar-keys";
+import { PHI_CORE_RUNTIME_MODULE_ID } from "./ids";
 export const PHI_CORE_CALENDAR_ADAPTER_DESCRIPTORS = [{
         key: PHI_GREGORY_CALENDAR_ADAPTER_KEY,
         ownerModuleId: PHI_CORE_RUNTIME_MODULE_ID,

package/plugins/runtime-modules/{client-calendar-adapters/core.js → core/client-calendar-adapters.js}

@@ -1,6 +1,6 @@
 "use client";
 import { PHI_GREGORY_CALENDAR_ADAPTER_KEY } from "../../../types/calendar-keys";
-import { PHI_CORE_RUNTIME_MODULE_ID } from "../core/ids";
+import { PHI_CORE_RUNTIME_MODULE_ID } from "./ids";
 export const PHI_CORE_CALENDAR_ADAPTER_CLIENT_DEFINITIONS = [{
         key: PHI_GREGORY_CALENDAR_ADAPTER_KEY,
         ownerModuleId: PHI_CORE_RUNTIME_MODULE_ID,

package/plugins/runtime-modules/core/content-entries/table.js

@@ -53,7 +53,7 @@ async function loadEntries(kind, { query, signal }) {
     }));
     return {
         rows,
-        total: readNumber(result?.total) ?? rows.length,
+        total: readNumber(result?.total),
         page: readNumber(result?.page) ?? 1,
         pageSize: readNumber(result?.pageSize) ?? (rows.length || 25),
         /*

package/plugins/runtime-modules/core/data-providers.d.ts

@@ -56,6 +56,7 @@ export declare const PHI_CORE_RUNTIME_DATA_PROVIDER_DESCRIPTORS: ({
             search: false;
             sorting: "none";
             pagination: "offset";
+            total: true;
             filterFields: string[];
         };
         actions: ({
@@ -115,6 +116,7 @@ export declare const PHI_CORE_RUNTIME_DATA_PROVIDER_DESCRIPTORS: ({
             search: true;
             sorting: "multiple";
             pagination: "offset";
+            total: true;
         };
     }[];
     settingsFields?: undefined;
@@ -205,6 +207,7 @@ export declare const PHI_CORE_RUNTIME_DATA_PROVIDER_DESCRIPTORS: ({
             filterFields: string[];
             sorting: "none";
             pagination: "offset";
+            total: true;
             facets: string[];
         };
         recordRead: true;

package/plugins/runtime-modules/core/data-providers.js

@@ -35,7 +35,7 @@ export const PHI_CORE_RUNTIME_DATA_PROVIDER_DESCRIPTORS = [
                 description: "Neutral package-owned baseline for a provider-bound table.",
                 rowIdentityPath: "id",
                 fields: [{ key: "id", title: "ID", type: "string", required: true }],
-                query: { search: true, sorting: "multiple", pagination: "offset" },
+                query: { search: true, sorting: "multiple", pagination: "offset", total: true },
             }],
     },
     ...PHI_CORE_MESSAGING_DATA_PROVIDER_DESCRIPTORS,
@@ -121,6 +121,7 @@ export const PHI_CORE_RUNTIME_DATA_PROVIDER_DESCRIPTORS = [
                 filterFields: ["status"],
                 sorting: "none",
                 pagination: "offset",
+                total: true,
                 facets: ["tags"],
             },
             recordRead: true,

package/plugins/runtime-modules/core/definition.d.ts

@@ -67,6 +67,7 @@ export declare const PHI_CORE_RUNTIME_MODULE_DEFINITION: {
                 search: false;
                 sorting: "none";
                 pagination: "offset";
+                total: true;
                 filterFields: string[];
             };
             actions: ({
@@ -126,6 +127,7 @@ export declare const PHI_CORE_RUNTIME_MODULE_DEFINITION: {
                 search: true;
                 sorting: "multiple";
                 pagination: "offset";
+                total: true;
             };
         }[];
         settingsFields?: undefined;
@@ -216,6 +218,7 @@ export declare const PHI_CORE_RUNTIME_MODULE_DEFINITION: {
                 filterFields: string[];
                 sorting: "none";
                 pagination: "offset";
+                total: true;
                 facets: string[];
             };
             recordRead: true;

package/plugins/runtime-modules/core/definition.js

@@ -6,7 +6,7 @@ import { PHI_CORE_RUNTIME_DATA_PROVIDER_DESCRIPTORS } from "./data-providers";
 import { PHI_CMS_AREA_KEYS } from "../../../constants/cms-areas";
 import { PHI_CORE_FORM_PROVIDER_DESCRIPTORS } from "./form-providers";
 import { PHI_CORE_SERVER_BINDING } from "../../../types/server-capabilities";
-import { PHI_CORE_CALENDAR_ADAPTER_DESCRIPTORS } from "../runtime-calendar-adapters";
+import { PHI_CORE_CALENDAR_ADAPTER_DESCRIPTORS } from "./calendar-adapters";
 export const PHI_CORE_RUNTIME_MODULE_DEFINITION = {
     ...PHI_CORE_RUNTIME_MODULE_IDENTITY,
     kind: "platform",

package/plugins/runtime-modules/core/messaging/data-providers.d.ts

@@ -77,6 +77,7 @@ export declare const PHI_CORE_MESSAGING_DATA_PROVIDER_DESCRIPTORS: {
             search: false;
             sorting: "none";
             pagination: "offset";
+            total: true;
             filterFields: string[];
         };
         actions: ({

package/plugins/runtime-modules/core/messaging/data-providers.js

@@ -81,6 +81,7 @@ export const PHI_CORE_MESSAGING_DATA_PROVIDER_DESCRIPTORS = [
                     search: false,
                     sorting: "none",
                     pagination: "offset",
+                    total: true,
                     /*
                      * The three the Core route takes, and no fourth.
                      *

package/plugins/runtime-modules/core/messaging/thread-inbox-table.js

@@ -61,7 +61,7 @@ async function queryThreadTable({ resourceKey, query, signal, }) {
     const rows = readPhiTableRows(payload?.rows).map(readThreadRow);
     return {
         rows,
-        total: typeof payload?.total === "number" ? payload.total : rows.length,
+        total: typeof payload?.total === "number" ? payload.total : undefined,
         page: typeof payload?.page === "number" ? payload.page : undefined,
         pageSize: typeof payload?.pageSize === "number" ? payload.pageSize : undefined,
         // Unread among everything the listing matches, for a footer beside the total.

package/plugins/runtime-modules/core/server.js

@@ -1,5 +1,5 @@
 import { PHI_CORE_RUNTIME_DATA_PROVIDER_KEYS } from "../../../constants/core-data-provider-keys";
-import { PHI_CORE_RUNTIME_MODULE_THEMES } from "../area-base-presets";
+import { PHI_CORE_RUNTIME_MODULE_THEMES } from "./themes";
 import { definePhiRuntimeModuleServerAreaContribution } from "../area-contributions";
 import { PHI_CORE_RUNTIME_MODULE_DEFINITION } from "./definition";
 import { PHI_RUNTIME_MODULE_LAYOUTS as PHI_CORE_LAYOUTS } from "./layouts";

package/plugins/runtime-modules/core/themes.d.ts

@@ -0,0 +1,44 @@
+export declare const PHI_CORE_RUNTIME_MODULE_THEMES: {
+    loadPreset: () => {
+        readonly key: "phis";
+        readonly version: 1;
+        readonly title: "Phis";
+        readonly description: "Warm orange brand color with a deep blue text base.";
+        readonly palette: {
+            readonly seed: {
+                readonly colorPrimary: "#E05A2A";
+                readonly colorInfo: "#7088BA";
+                readonly colorSuccess: "#4D8F6B";
+                readonly colorWarning: "#D99A2B";
+                readonly colorError: "#C94A3A";
+                readonly colorLink: "#7088BA";
+            };
+            readonly modes: {
+                readonly light: {
+                    readonly seed: {
+                        readonly colorTextBase: "#223A61";
+                        readonly colorBgBase: "#ffffff";
+                    };
+                    readonly overrides: {
+                        readonly colorFillQuaternary: "rgba(34, 58, 97, 0.03)";
+                    };
+                };
+                readonly dark: {
+                    readonly seed: {
+                        readonly colorTextBase: "#DCE7F8";
+                        readonly colorBgBase: "#050914";
+                    };
+                    readonly overrides: {
+                        readonly colorFillQuaternary: "rgba(220, 231, 248, 0.06)";
+                    };
+                };
+            };
+        };
+    };
+    description?: "Warm orange brand color with a deep blue text base." | undefined;
+    ownerModuleId: "@phis/ui/modules/core";
+    presetKey: string;
+    presetVersion: number;
+    themeKey: "phis";
+    title: "Phis";
+}[];

package/plugins/runtime-modules/core/themes.js

@@ -0,0 +1,12 @@
+import { PHI_CORE_THEME_PRESET_PLUGINS } from "../../../theme/phi-theme-presets";
+import { PHI_CORE_RUNTIME_MODULE_ID } from "./ids";
+/* The Theme presets Core ships, one descriptor each. */
+export const PHI_CORE_RUNTIME_MODULE_THEMES = PHI_CORE_THEME_PRESET_PLUGINS.map((preset) => ({
+    ownerModuleId: PHI_CORE_RUNTIME_MODULE_ID,
+    presetKey: `${preset.key}-theme-preset`,
+    presetVersion: 1,
+    themeKey: preset.key,
+    title: preset.title,
+    ...(preset.description ? { description: preset.description } : {}),
+    loadPreset: () => preset,
+}));

package/plugins/runtime-modules/core/widgets/brand/client.d.ts

@@ -11,10 +11,19 @@ export type PhiBrandWidgetConfig = {
 export declare const PHI_BRAND_LINE_FALLBACK_ICONS: Record<PhiBrandWidgetLineMode, string>;
 export type PhiBrandWidgetClientProps = PhiClientBlockBaseProps<PhiNoLabels, PhiBrandWidgetConfig> & {
     fallbackTitle?: ReactNode;
-    /** The language being read, which the way home keeps. */
-    locale?: string;
+    /**
+     * Where the Brand leads, resolved on the Server: the Theme's `homeLinkTarget`, or the Site root in the
+     * language being read. A Page reference means nothing in a browser, so the address travels instead.
+     */
+    home?: PhiBrandWidgetHome;
     interactive?: boolean;
 };
+/** A ready address, and whether it leaves the Site -- the shape `resolvePhiLinkHref` answers. */
+export type PhiBrandWidgetHome = {
+    href: string;
+    newTab: boolean;
+    external: boolean;
+};
 /**
  * The Brand in the Site frame: what `PhiBrandControl` shows, and where clicking it leads.
  *
@@ -22,4 +31,4 @@ export type PhiBrandWidgetClientProps = PhiClientBlockBaseProps<PhiNoLabels, Phi
  * because the Theme workspace preview shows the same Brand without being in a frame and without
  * leading anywhere.
  */
-export declare function PhiBrandWidgetClient({ config, locale, fallbackTitle, interactive, }: PhiBrandWidgetClientProps): import("react").JSX.Element | null;
+export declare function PhiBrandWidgetClient({ config, home, fallbackTitle, interactive, }: PhiBrandWidgetClientProps): import("react").JSX.Element | null;

package/plugins/runtime-modules/core/widgets/brand/client.js

@@ -1,13 +1,12 @@
 "use client";
 import { jsx as _jsx } from "react/jsx-runtime";
-import Link from "next/link";
 import { PhiBrandControl, PhiBrandLineControl, phiBrandControlIsEmpty, } from "../../../../../components/controls/phi-brand-control";
 import { isPhiBrandWidgetLineMode, } from "./mode";
 import { usePhiConfig } from "../../../../../components/root/phi-config-provider";
 import { usePhiSiteBrand } from "../../../../../components/root/phi-root-live-theme-provider";
 import { resolvePhiWidgetFontFamily } from "../../../../../components/widgets/helpers/font-family";
 import { resolvePhiWidgetFontSize } from "../../../../../components/widgets/helpers/font-size";
-import { localizePath } from "../../../../../helpers/locale";
+import { PhiLink } from "../../../../../components/navigation/phi-link";
 /** What a line shows in front of itself where the Brand names no icon for it. */
 export const PHI_BRAND_LINE_FALLBACK_ICONS = {
     slogan: "antd:star",
@@ -20,7 +19,7 @@ export const PHI_BRAND_LINE_FALLBACK_ICONS = {
  * because the Theme workspace preview shows the same Brand without being in a frame and without
  * leading anywhere.
  */
-export function PhiBrandWidgetClient({ config, locale, fallbackTitle, interactive = true, }) {
+export function PhiBrandWidgetClient({ config, home, fallbackTitle, interactive = true, }) {
     const brand = usePhiSiteBrand();
     // The Theme's mode, not the Widget's: one picks the Logo's picture, the other what is drawn at all.
     const { fonts, token, mode: themeMode } = usePhiConfig();
@@ -54,13 +53,6 @@ export function PhiBrandWidgetClient({ config, locale, fallbackTitle, interactiv
     if (phiBrandControlIsEmpty(presentation)) {
         return null;
     }
-    /*
-     * The front page in the language being read. `/` alone is answered with a redirect to the visitor's
-     * preferred language, so a reader of `/de` could be led to `/en`; and Next's prefetch of it, which loses
-     * its `_rsc` on that redirect, came back with the static tree's own address and a 404
-     * (AUDIT-2026-10-13, PM15).
-     */
-    const homeHref = brand?.homeHref?.trim() || (locale ? localizePath(locale, "/") : "/");
     const linkStyle = {
         color: "inherit",
         textDecoration: "none",
@@ -73,5 +65,5 @@ export function PhiBrandWidgetClient({ config, locale, fallbackTitle, interactiv
     if (!interactive) {
         return (_jsx("span", { "aria-disabled": "true", style: linkStyle, children: _jsx(PhiBrandControl, { ...presentation }) }));
     }
-    return (_jsx(Link, { href: homeHref, style: linkStyle, children: _jsx(PhiBrandControl, { ...presentation }) }));
+    return (_jsx(PhiLink, { href: home?.href ?? "/", external: home?.external, newTab: home?.newTab, style: linkStyle, children: _jsx(PhiBrandControl, { ...presentation }) }));
 }

package/plugins/runtime-modules/core/widgets/brand/home.d.ts

@@ -0,0 +1,15 @@
+import type { PhiBlockRuntime } from "../../../../../types";
+import { type PhiResolvedLinkTargets } from "../../../../../types/references";
+import type { PhiBrandWidgetHome } from "./client";
+/**
+ * Where the Brand leads, as an address: the Theme's target, resolved in this render's batch of link
+ * targets (`resolvePhiCmsTreeLinkTargets` collects the Brand's beside the tree's), or the Site root.
+ *
+ * The root is the root in the language being read. `/` alone is answered with a redirect to the
+ * visitor's preferred language, so a reader of `/de` could be led to `/en`; and Next's prefetch of it,
+ * which loses its `_rsc` on that redirect, came back with the static tree's own address and a 404
+ * (AUDIT-2026-10-13, PM15). A target that does not resolve -- a Page deleted, unpublished, or brought by
+ * a Module that is switched off -- leads there too: the Brand is the way home and always leads somewhere.
+ * A resolved Page path is already locale- and Area-correct (`REFERENCES.md`).
+ */
+export declare function resolvePhiBrandWidgetHome(runtime: Pick<PhiBlockRuntime, "site" | "locale">, links: PhiResolvedLinkTargets | null | undefined): PhiBrandWidgetHome;

package/plugins/runtime-modules/core/widgets/brand/home.js

@@ -0,0 +1,18 @@
+import { resolvePhiLinkHref } from "../../../../../helpers/link-target";
+import { localizePath } from "../../../../../helpers/locale";
+import { readPhiLinkTarget } from "../../../../../types/references";
+/**
+ * Where the Brand leads, as an address: the Theme's target, resolved in this render's batch of link
+ * targets (`resolvePhiCmsTreeLinkTargets` collects the Brand's beside the tree's), or the Site root.
+ *
+ * The root is the root in the language being read. `/` alone is answered with a redirect to the
+ * visitor's preferred language, so a reader of `/de` could be led to `/en`; and Next's prefetch of it,
+ * which loses its `_rsc` on that redirect, came back with the static tree's own address and a 404
+ * (AUDIT-2026-10-13, PM15). A target that does not resolve -- a Page deleted, unpublished, or brought by
+ * a Module that is switched off -- leads there too: the Brand is the way home and always leads somewhere.
+ * A resolved Page path is already locale- and Area-correct (`REFERENCES.md`).
+ */
+export function resolvePhiBrandWidgetHome(runtime, links) {
+    return resolvePhiLinkHref(readPhiLinkTarget(runtime.site.theme?.brand?.homeLinkTarget), links)
+        ?? { href: localizePath(runtime.locale.current, "/"), newTab: false, external: false };
+}

package/plugins/runtime-modules/core/widgets/brand/plugin.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { resolvePhiBrandWordmarkText } from "../../../../../helpers/brand-wordmark";
+import { resolvePhiBrandWidgetHome } from "./home";
 import { PhiBrandWidget } from "./server";
 import { PHI_BRAND_WIDGET_DEFINITION, PHI_BRAND_WIDGET_PLUGIN_TYPE, } from "./config";
 /*
@@ -13,7 +14,7 @@ import { PHI_BRAND_WIDGET_DEFINITION, PHI_BRAND_WIDGET_PLUGIN_TYPE, } from "./co
  */
 export const PHI_BRAND_WIDGET_PLUGIN = {
     ...PHI_BRAND_WIDGET_DEFINITION,
-    render: ({ widget, config, runtime }) => (_jsx(PhiBrandWidget, { fallbackTitle: resolvePhiBrandWordmarkText(runtime), locale: runtime.locale.current, mode: config.mode, fontFamily: config.fontFamily, fontSize: config.fontSize }, `widget-${widget.id}`)),
-    renderPreview: ({ widget, config, runtime }) => (_jsx(PhiBrandWidget, { fallbackTitle: resolvePhiBrandWordmarkText(runtime), locale: runtime.locale.current, mode: config.mode, fontFamily: config.fontFamily, fontSize: config.fontSize, interactive: false }, `widget-${widget.id}`)),
+    render: ({ widget, config, runtime, links }) => (_jsx(PhiBrandWidget, { fallbackTitle: resolvePhiBrandWordmarkText(runtime), home: resolvePhiBrandWidgetHome(runtime, links), mode: config.mode, fontFamily: config.fontFamily, fontSize: config.fontSize }, `widget-${widget.id}`)),
+    renderPreview: ({ widget, config, runtime, links }) => (_jsx(PhiBrandWidget, { fallbackTitle: resolvePhiBrandWordmarkText(runtime), home: resolvePhiBrandWidgetHome(runtime, links), mode: config.mode, fontFamily: config.fontFamily, fontSize: config.fontSize, interactive: false }, `widget-${widget.id}`)),
 };
 export { PHI_BRAND_WIDGET_PLUGIN_TYPE };

package/plugins/runtime-modules/core/widgets/brand/server.d.ts

@@ -1,3 +1,3 @@
 import type { PhiBrandWidgetClientProps, PhiBrandWidgetConfig } from "./client";
-export type PhiBrandWidgetProps = Pick<PhiBrandWidgetClientProps, "fallbackTitle" | "interactive" | "locale"> & PhiBrandWidgetConfig;
-export declare function PhiBrandWidget({ fallbackTitle, interactive, locale, mode, fontFamily, fontSize, }: PhiBrandWidgetProps): import("react").JSX.Element;
+export type PhiBrandWidgetProps = Pick<PhiBrandWidgetClientProps, "fallbackTitle" | "interactive" | "home"> & PhiBrandWidgetConfig;
+export declare function PhiBrandWidget({ fallbackTitle, interactive, home, mode, fontFamily, fontSize, }: PhiBrandWidgetProps): import("react").JSX.Element;

package/plugins/runtime-modules/core/widgets/brand/server.js

@@ -5,12 +5,12 @@ import { PhiRuntimeModuleRenderClientHost } from "../../../../../components/runt
  * The Brand itself is not read here. It comes from the root on the Client (`usePhiSiteBrand`), which
  * holds it with the Theme Set's Logo folded in and follows a live Theme draft.
  */
-export function PhiBrandWidget({ fallbackTitle, interactive, locale, mode, fontFamily, fontSize, }) {
+export function PhiBrandWidget({ fallbackTitle, interactive, home, mode, fontFamily, fontSize, }) {
     const config = { mode, fontFamily, fontSize };
     return (_jsx(PhiRuntimeModuleRenderClientHost, { type: PhiCmsWidgetType.Brand, componentProps: {
             config,
             fallbackTitle,
-            locale,
+            home,
             interactive,
         } }));
 }

package/plugins/runtime-modules/core/widgets/card/collection-view-binding.js

@@ -10,6 +10,8 @@ import { PHI_SURFACE_CARD } from "../../../../../helpers/surface-presets";
 import { resolvePhiImagePresentation } from "../../../../../components/media/image-presentation";
 import { normalizePhiCssSize } from "../../../../../components/layouts/phi-layout-contract";
 import { usePhiSearchDraft } from "../../../../../components/widgets/client/shared/phi-search-draft";
+import { PhiBulletListControl } from "../../../../../components/controls/phi-bullet-list-control";
+import { buildPhiBulletListTree, readPhiBulletListEntries, } from "../../../../../components/widgets/shared/bullet-list-vocabulary";
 /**
  * A Collection drawn as Cards.
  *
@@ -34,15 +36,18 @@ import { usePhiSearchDraft } from "../../../../../components/widgets/client/shar
  * squeezed pair.
  */
 const CARD_MIN_COLUMN_WIDTH = 260;
+/* A dot path, because a provider's rows are documents and the interesting field is often one level in. */
+function readValue(item, path) {
+    return path.split(".").reduce((current, key) => (current && typeof current === "object"
+        ? current[key]
+        : undefined), item);
+}
 function readPath(item, path) {
     if (!path) {
         return undefined;
     }
-    // A dot path, because a provider's rows are documents and the interesting field is often one level
-    // in. Anything that is not a string or a number is not a label and is left alone.
-    const value = path.split(".").reduce((current, key) => (current && typeof current === "object"
-        ? current[key]
-        : undefined), item);
+    // Anything that is not a string or a number is not a label and is left alone.
+    const value = readValue(item, path);
     return typeof value === "string" || typeof value === "number" ? String(value) : undefined;
 }
 /**
@@ -59,7 +64,7 @@ function readIconName(value) {
 function readTruth(item, path) {
     if (!path)
         return false;
-    const value = path.split(".").reduce((current, key) => (current && typeof current === "object" ? current[key] : undefined), item);
+    const value = readValue(item, path);
     return value === true || value === "true" || value === 1;
 }
 /*
@@ -85,6 +90,11 @@ function buildCard(item, card) {
         meta: readPath(item, card?.meta),
         actionLabel: readPath(item, card?.actionLabel),
         value: readPath(item, card?.value),
+        badge: readPath(item, card?.badge),
+        price: readPath(item, card?.price),
+        pricePeriod: readPath(item, card?.pricePeriod),
+        priceYearly: readPath(item, card?.priceYearly),
+        pricePeriodYearly: readPath(item, card?.pricePeriodYearly),
     };
     /*
      * Two pictures with two jobs, and the fallbacks say which is which. A cover opens the card and takes
@@ -110,8 +120,14 @@ function buildCard(item, card) {
         ...(card?.variant ? { variant: card.variant } : {}),
         ...(card?.body ? { body: card.body } : {}),
         highlight: readTruth(item, card?.highlight),
+        ...(card?.billingPeriod ? { billingPeriod: card.billingPeriod } : {}),
     };
-    return { labels, config };
+    /* A plan's features are a list in the row, drawn as a plan card's list is drawn on a page. */
+    const features = card?.body === "plan" && card.features
+        ? readPhiBulletListEntries(readValue(item, card.features)).filter((entry) => Boolean(entry.text))
+        : [];
+    const listContent = features.length > 0 ? (_jsx(PhiBulletListControl, { items: buildPhiBulletListTree(features, (entry) => entry.text) })) : null;
+    return { labels, config, listContent };
 }
 export function PhiCardCollectionViewBinding({ config, binding, widgetId, }) {
     void widgetId;
@@ -126,7 +142,7 @@ export function PhiCardCollectionViewBinding({ config, binding, widgetId, }) {
     });
     const cards = items.map((item, index) => {
         const card = buildCard(item, presentation.card);
-        return (_jsx(PhiCardWidgetClient, { labels: card.labels, config: card.config }, readPath(item, "id") ?? readPath(item, "slug") ?? String(index)));
+        return (_jsx(PhiCardWidgetClient, { labels: card.labels, config: card.config, listContent: card.listContent }, readPath(item, "id") ?? readPath(item, "slug") ?? String(index)));
     });
     return (_jsx(PhiCollectionViewControl, { title: presentation.title, description: presentation.description, mode: presentation.mode, ...(presentation.gap ? { gap: presentation.gap } : {}), minColumnWidth: presentation.minColumnWidth ?? CARD_MIN_COLUMN_WIDTH, filters: features.search?.enabled ? (_jsx(PhiTextControl, { inputType: "search", value: searchDraft, placeholder: features.search.placeholder, ariaLabel: features.search.placeholder ?? "Search", onChange: (value) => setSearchDraft(value ?? ""), style: {
                 flex: "1 1 12rem",
@@ -134,7 +150,7 @@ export function PhiCardCollectionViewBinding({ config, binding, widgetId, }) {
             }, size: presentation.controlSize })) : null, diagnostics: binding.error ? (_jsx(PhiAlertControl, { level: "error", title: binding.error })) : null, body: items.length === 0 && !binding.loading ? (_jsx(PhiEmptyControl, { description: presentation.emptyDescription ?? "Nothing here yet." })) : undefined, items: cards, pagination: features.pagination?.enabled === false ? null : {
             page: binding.query.page ?? 1,
             pageSize: binding.query.pageSize ?? features.pagination?.pageSize ?? 20,
-            total: binding.data?.total ?? items.length,
+            total: binding.data?.total ?? 0,
             ...(features.pagination?.compact === undefined
                 ? {}
                 : { simple: features.pagination.compact }),