@phis/ui 0.1.0 → 0.2.1

package/plugins/runtime-modules/dashboard/client-data-providers.js

@@ -0,0 +1,26 @@
+"use client";
+import { PHI_DASHBOARD_CARD_DATA_PROVIDER_KEY } from "./ids";
+import { PHI_DASHBOARD_RUNTIME_MODULE_ID } from "./ids";
+/**
+ * The fan-in provider, in both modes.
+ *
+ * Authoring loads the same client rather than a stand-in, because the alternative is a thrown error:
+ * a Dashboard opened in the Builder asks for a provider like any other page, and a definition with
+ * only a live loader makes that page unopenable.
+ *
+ * What it shows there is honest but thin. The provider sends the Area from its config and the path it
+ * actually stands on, and in the Builder that path is the Builder's own -- so the Site door resolves a
+ * different Area than the config names and answers with no cards. An author sees the Widget and its
+ * empty state, not the contributions. Teaching the door that it is being asked on behalf of another
+ * Area's page is its own piece of work and is not done.
+ */
+export const PHI_DASHBOARD_RUNTIME_DATA_PROVIDER_CLIENT_DEFINITIONS = [
+    {
+        key: PHI_DASHBOARD_CARD_DATA_PROVIDER_KEY,
+        ownerModuleId: PHI_DASHBOARD_RUNTIME_MODULE_ID,
+        loadLive: async () => (await import("../../../plugins/runtime-modules/dashboard/services/collection"))
+            .PhiDashboardCardCollectionProviderClient,
+        loadAuthoring: async () => (await import("../../../plugins/runtime-modules/dashboard/services/collection"))
+            .PhiDashboardCardCollectionProviderClient,
+    },
+];

package/plugins/runtime-modules/dashboard/clients/dashboard-card-view.d.ts

@@ -0,0 +1,9 @@
+import type { PhiCmsInstanceId } from "../../../../types/cms-instance-id";
+import type { PhiCollectionViewBindingModel } from "../../../../types/collection-provider";
+import type { PhiCmsCollectionViewWidgetConfig } from "../../../../types/collection-view-widget";
+export declare function PhiDashboardCardCollectionViewBinding({ config, binding, widgetId, }: {
+    config: PhiCmsCollectionViewWidgetConfig;
+    binding: PhiCollectionViewBindingModel;
+    labels?: unknown;
+    widgetId?: PhiCmsInstanceId | null;
+}): import("react").JSX.Element;

package/plugins/runtime-modules/dashboard/clients/dashboard-card-view.js

@@ -0,0 +1,128 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { usePathname } from "next/navigation";
+import { useEffect, useMemo, useState } from "react";
+import { PhiCardWidgetClient } from "../../../../components/widgets/shared/card-body-client";
+import { PhiCollectionViewControl } from "../../../../components/controls/phi-collection-view-control";
+import { PhiAlertControl } from "../../../../components/controls/phi-alert-control";
+import { PhiEmptyControl } from "../../../../components/controls/phi-empty-control";
+import { isPhiRecord } from "../../../../helpers/is-record";
+/**
+ * A Dashboard, drawn.
+ *
+ * The list arrives as ordinary Collection rows and each card then resolves its own payload, which is
+ * the one thing the shared card View could not do: it maps fields of a row onto a card and is finished.
+ * A Dashboard's rows come from N Modules that each do real work, so the cost profile is inverted and
+ * the View is too.
+ *
+ * What the split buys is visible here: twelve cards resolve in parallel, a payload that fails leaves an
+ * error in its own card, and a card that has not resolved reads as itself -- because its title, mark
+ * and target were in the descriptor and are already on screen.
+ */
+/** A card at the width a card is still a card at, matching the shared card View's floor. */
+const CARD_MIN_COLUMN_WIDTH = 260;
+/**
+ * A Module's form, and the Core body that draws it.
+ *
+ * Two vocabularies with one entry each today, and deliberately not one type. `form` is what a Module
+ * declares about its contribution; `body` is what Core draws. They agree now and are allowed to stop:
+ * a `series` form would reasonably draw in whatever body Core has for a graphic, under another name.
+ *
+ * A total map rather than a condition, so the day `list` joins the form vocabulary this file stops
+ * compiling instead of quietly falling back to a heading.
+ */
+const CARD_BODY_BY_FORM = {
+    stat: "stat",
+};
+function readRows(binding) {
+    return (binding.data?.items ?? [])
+        .filter(isPhiRecord)
+        .map((item) => item)
+        .filter((row) => typeof row.cardId === "string" && typeof row.title === "string");
+}
+/**
+ * One card, and its own request.
+ *
+ * No timer of its own, deliberately and checkably: a card fetches when it is asked and never on a
+ * schedule it keeps itself, because pausing, staggering and backing off can only be decided where all
+ * twelve are visible. Until the Controller is that clock, being asked means being mounted.
+ */
+function PhiDashboardCard({ row, area, pathname, }) {
+    /*
+     * One piece of state, carrying the request it answers.
+     *
+     * Clearing the payload when the request changes would be a second, synchronous write from inside the
+     * effect -- a cascading render for a value nothing has read yet. Keeping the key beside the answer
+     * says the same thing by comparison: an answer to a question no longer being asked is simply not this
+     * card's answer.
+     */
+    const requestKey = `${area}\u0000${pathname}\u0000${row.cardId}`;
+    const [resolved, setResolved] = useState(null);
+    useEffect(() => {
+        const controller = new AbortController();
+        const params = new URLSearchParams({ area, path: pathname, card: row.cardId });
+        fetch(`/api/site/dashboard-cards?${params.toString()}`, {
+            method: "GET",
+            headers: { Accept: "application/json" },
+            cache: "no-store",
+            credentials: "include",
+            signal: controller.signal,
+        })
+            .then(async (response) => {
+            if (!response.ok) {
+                throw new Error(`Card payload request failed (${response.status}).`);
+            }
+            return (await response.json());
+        })
+            .then((payload) => setResolved({ key: requestKey, payload, failure: null }))
+            .catch((error) => {
+            if (controller.signal.aborted) {
+                return;
+            }
+            setResolved({
+                key: requestKey,
+                payload: null,
+                failure: error instanceof Error ? error.message : "This card is unavailable.",
+            });
+        });
+        return () => controller.abort();
+    }, [area, pathname, requestKey, row.cardId]);
+    const current = resolved?.key === requestKey ? resolved : null;
+    const payload = current?.payload ?? null;
+    const error = current?.failure ?? payload?.error ?? null;
+    return (_jsx(PhiCardWidgetClient, { labels: {
+            ...(row.eyebrow ? { eyebrow: row.eyebrow } : {}),
+            /*
+             * The title stays the title.
+             *
+             * It used to be replaced by the figure once one arrived, which left the eyebrow as the only
+             * word saying what had been counted. The body draws the pair, so "Site users" and "42" are on
+             * screen together and the card reads the same before and after it resolves.
+             */
+            title: row.title,
+            ...(payload?.value ? { value: payload.value } : {}),
+            ...(payload?.description ?? row.description
+                ? { description: payload?.description ?? row.description }
+                : {}),
+            ...(payload?.meta ? { meta: payload.meta } : {}),
+        }, config: {
+            variant: "compact",
+            body: CARD_BODY_BY_FORM[row.form] ?? "text",
+            ...(row.href ? { href: row.href } : {}),
+            ...(row.mark ? { iconName: row.mark } : {}),
+        }, 
+        /*
+         * What the card is told about its own content, and the whole of it. The card decides none of
+         * this; that this file still does is what will move to a Controller when the Dashboard gets a
+         * clock (DASHBOARD.md section 4).
+         */
+        binding: { loading: current === null, error } }));
+}
+export function PhiDashboardCardCollectionViewBinding({ config, binding, widgetId, }) {
+    void widgetId;
+    const pathname = usePathname() ?? "/";
+    const { presentation } = config;
+    const rows = useMemo(() => readRows(binding), [binding]);
+    const area = typeof config.source?.params?.area === "string" ? config.source.params.area : "";
+    return (_jsx(PhiCollectionViewControl, { title: presentation.title, description: presentation.description, mode: presentation.mode, ...(presentation.gap ? { gap: presentation.gap } : {}), minColumnWidth: presentation.minColumnWidth ?? CARD_MIN_COLUMN_WIDTH, diagnostics: binding.error ? (_jsx(PhiAlertControl, { level: "error", title: binding.error })) : null, body: rows.length === 0 && !binding.loading ? (_jsx(PhiEmptyControl, { description: presentation.emptyDescription ?? "No Module offers a card here yet." })) : undefined, items: rows.map((row) => (_jsx(PhiDashboardCard, { row: row, area: area, pathname: pathname }, row.cardId))), pagination: null }));
+}

package/plugins/runtime-modules/dashboard/controller/address.d.ts

@@ -1,5 +1,3 @@
 export declare const PHI_DASHBOARD_CONTROLLER_PLUGIN_KEY = "@phis/ui/modules/dashboard/controller";
 export declare const PHI_DASHBOARD_CONTROLLER_KEY = "default";
 export declare const PHI_DASHBOARD_CONTROLLER_TYPE: "@phis/ui/modules/dashboard/controller/default";
-export declare const PHI_DASHBOARD_CONTROLLER_INSTANCE_KEY = "default";
-export declare function createPhiDashboardControllerAddress(): `controller:${string}/${string}:${string}`;

package/plugins/runtime-modules/dashboard/controller/address.js

@@ -1,8 +1,4 @@
-import { PHI_SHARED_PACKAGE_NAME, createPhiControllerSignalAddress } from "../../../../types/signals";
+import { PHI_SHARED_PACKAGE_NAME } from "../../../../types/signals";
 export const PHI_DASHBOARD_CONTROLLER_PLUGIN_KEY = `${PHI_SHARED_PACKAGE_NAME}/modules/dashboard/controller`;
 export const PHI_DASHBOARD_CONTROLLER_KEY = "default";
 export const PHI_DASHBOARD_CONTROLLER_TYPE = `${PHI_DASHBOARD_CONTROLLER_PLUGIN_KEY}/${PHI_DASHBOARD_CONTROLLER_KEY}`;
-export const PHI_DASHBOARD_CONTROLLER_INSTANCE_KEY = "default";
-export function createPhiDashboardControllerAddress() {
-    return createPhiControllerSignalAddress(PHI_DASHBOARD_CONTROLLER_PLUGIN_KEY, PHI_DASHBOARD_CONTROLLER_KEY, PHI_DASHBOARD_CONTROLLER_INSTANCE_KEY);
-}

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

@@ -0,0 +1,30 @@
+/**
+ * One provider, one resource, and the Collection Widget is unchanged.
+ *
+ * Making a Collection's `source` plural was the other way to fan N Modules in, and it would have forced
+ * ordering, pagination and totals to be answered across sources for every Collection in the house --
+ * including the ones that will never have more than one. So the fan-in is a provider like any other,
+ * and what it collects is the only thing about it that is unusual.
+ *
+ * It offers no search, no filters and no pagination: the rows are what the active Modules offered, and
+ * a Site with twelve of them has twelve cards. Searching a Dashboard is a question to ask once somebody
+ * has one worth searching.
+ */
+export declare const PHI_DASHBOARD_RUNTIME_DATA_PROVIDER_DESCRIPTORS: {
+    key: `${string}/${string}`;
+    ownerModuleId: "@phis/ui/modules/dashboard";
+    kind: "collection";
+    executionMode: "live";
+    authoringMode: "none";
+    title: string;
+    description: string;
+    resources: {
+        resourceKey: string;
+        title: string;
+        description: string;
+        itemIdentityPath: string;
+        itemRendererKey: `${string}/${string}`;
+        defaultForWidget: true;
+        query: {};
+    }[];
+}[];

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

@@ -0,0 +1,34 @@
+import { PHI_DASHBOARD_CARD_DATA_PROVIDER_KEY, PHI_DASHBOARD_CARD_ITEM_RENDERER_KEY, PHI_DASHBOARD_CARD_RESOURCE_KEY, } from "./ids";
+import { PHI_DASHBOARD_RUNTIME_MODULE_ID } from "./ids";
+/**
+ * One provider, one resource, and the Collection Widget is unchanged.
+ *
+ * Making a Collection's `source` plural was the other way to fan N Modules in, and it would have forced
+ * ordering, pagination and totals to be answered across sources for every Collection in the house --
+ * including the ones that will never have more than one. So the fan-in is a provider like any other,
+ * and what it collects is the only thing about it that is unusual.
+ *
+ * It offers no search, no filters and no pagination: the rows are what the active Modules offered, and
+ * a Site with twelve of them has twelve cards. Searching a Dashboard is a question to ask once somebody
+ * has one worth searching.
+ */
+export const PHI_DASHBOARD_RUNTIME_DATA_PROVIDER_DESCRIPTORS = [
+    {
+        key: PHI_DASHBOARD_CARD_DATA_PROVIDER_KEY,
+        ownerModuleId: PHI_DASHBOARD_RUNTIME_MODULE_ID,
+        kind: "collection",
+        executionMode: "live",
+        authoringMode: "none",
+        title: "Dashboard cards",
+        description: "The cards the Area's active Modules offer this Dashboard.",
+        resources: [{
+                resourceKey: PHI_DASHBOARD_CARD_RESOURCE_KEY,
+                title: "Cards",
+                description: "One row per card offered by an active Module.",
+                itemIdentityPath: "cardId",
+                itemRendererKey: PHI_DASHBOARD_CARD_ITEM_RENDERER_KEY,
+                defaultForWidget: true,
+                query: {},
+            }],
+    },
+];

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

@@ -10,4 +10,28 @@ export declare const PHI_DASHBOARD_RUNTIME_MODULE_DEFINITION: {
     category: "workspace";
     iconFamily: string;
     controllerMountPolicy: "area";
+    dataProviders: {
+        key: `${string}/${string}`;
+        ownerModuleId: "@phis/ui/modules/dashboard";
+        kind: "collection";
+        executionMode: "live";
+        authoringMode: "none";
+        title: string;
+        description: string;
+        resources: {
+            resourceKey: string;
+            title: string;
+            description: string;
+            itemIdentityPath: string;
+            itemRendererKey: `${string}/${string}`;
+            defaultForWidget: true;
+            query: {};
+        }[];
+    }[];
+    collectionItemRenderers: {
+        key: `${string}/${string}`;
+        rendersItemsOf: `${string}/${string}`;
+        title: string;
+        description: string;
+    }[];
 };

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

@@ -1,7 +1,8 @@
 import { PHI_DASHBOARD_RUNTIME_CONTROLLER_DEFINITION } from "../../../plugins/runtime-modules/dashboard/controller/definition";
 import { PHI_DASHBOARD_CONTROLLER_TYPE } from "../../../plugins/runtime-modules/dashboard/controller/address";
 import { buildPhiRuntimeModuleControllerDescriptor } from "../contracts";
-import { PHI_DASHBOARD_RUNTIME_MODULE_ID } from "./ids";
+import { PHI_DASHBOARD_CARD_ITEM_RENDERER_KEY, PHI_DASHBOARD_RUNTIME_MODULE_ID } from "./ids";
+import { PHI_DASHBOARD_RUNTIME_DATA_PROVIDER_DESCRIPTORS } from "./data-providers";
 import { PHI_CORE_SERVER_BINDING } from "../../../types/server-capabilities";
 export const PHI_DASHBOARD_RUNTIME_MODULE_DEFINITION = {
     moduleId: PHI_DASHBOARD_RUNTIME_MODULE_ID,
@@ -22,4 +23,13 @@ export const PHI_DASHBOARD_RUNTIME_MODULE_DEFINITION = {
     category: "workspace",
     iconFamily: "dashboard",
     controllerMountPolicy: "area",
+    dataProviders: PHI_DASHBOARD_RUNTIME_DATA_PROVIDER_DESCRIPTORS,
+    // The card it draws for its own rows, declared like anybody else's: a Site picks a renderer from one
+    // list, and a Module that wants to draw cards its own way registers another under its own key.
+    collectionItemRenderers: [{
+            key: PHI_DASHBOARD_CARD_ITEM_RENDERER_KEY,
+            rendersItemsOf: PHI_DASHBOARD_CARD_ITEM_RENDERER_KEY,
+            title: "Dashboard card",
+            description: "A contributed card: its name and target at once, its figure when it resolves.",
+        }],
 };

package/plugins/runtime-modules/dashboard/ids.d.ts

@@ -1 +1,7 @@
 export declare const PHI_DASHBOARD_RUNTIME_MODULE_ID: "@phis/ui/modules/dashboard";
+/**
+ * The Module's own view of the fan-in it answers. The names are a Foundation contract, so anything
+ * outside this Module cites those; these aliases exist because a Module should not have to spell its
+ * own namespace back to itself.
+ */
+export { PHI_DASHBOARD_CARD_DATA_PROVIDER_KEY, PHI_DASHBOARD_CARD_ITEM_RENDERER_KEY, PHI_DASHBOARD_CARD_RESOURCE_KEY, } from "../../../constants/dashboard-card-provider-keys";

package/plugins/runtime-modules/dashboard/ids.js

@@ -1,2 +1,8 @@
 import { PHI_SHARED_PACKAGE_NAME } from "../../../types/signals";
 export const PHI_DASHBOARD_RUNTIME_MODULE_ID = `${PHI_SHARED_PACKAGE_NAME}/modules/dashboard`;
+/**
+ * The Module's own view of the fan-in it answers. The names are a Foundation contract, so anything
+ * outside this Module cites those; these aliases exist because a Module should not have to spell its
+ * own namespace back to itself.
+ */
+export { PHI_DASHBOARD_CARD_DATA_PROVIDER_KEY, PHI_DASHBOARD_CARD_ITEM_RENDERER_KEY, PHI_DASHBOARD_CARD_RESOURCE_KEY, } from "../../../constants/dashboard-card-provider-keys";

package/plugins/runtime-modules/dashboard/module.d.ts

@@ -1,28 +1 @@
-export declare const PHI_DASHBOARD_RUNTIME_MODULE: {
-    controllerDefinition: {
-        kind: "controller";
-        pluginKey: string;
-        key: string;
-        title: string;
-        description: string;
-        iconFamily: string;
-        allowedMountScopes: "area"[];
-        runtimeSignals: {
-            emits: never[];
-            listens: never[];
-        };
-        defaultConfig: {};
-        parseConfig: () => import("../../../plugins/runtime-modules/dashboard/controller/definition").PhiDashboardControllerConfig;
-    };
-    moduleId: "@phis/ui/modules/dashboard";
-    kind: "module";
-    eligibleAreas: readonly ["app", "accounting", "admin", "builder", "editor"];
-    serverBinding: import("../../../types").PhiRuntimeModuleServerBinding;
-    controllerType: "@phis/ui/modules/dashboard/controller/default";
-    controller: import("../contracts").PhiRuntimeModuleControllerDescriptor;
-    title: string;
-    description: string;
-    category: "workspace";
-    iconFamily: string;
-    controllerMountPolicy: "area";
-};
+export declare const PHI_DASHBOARD_RUNTIME_MODULE: import("../contracts").PhiRuntimeModule;

package/plugins/runtime-modules/dashboard/module.js

@@ -1,6 +1,4 @@
 import { PHI_DASHBOARD_RUNTIME_CONTROLLER_DEFINITION } from "../../../plugins/runtime-modules/dashboard/controller/definition";
 import { PHI_DASHBOARD_RUNTIME_MODULE_DEFINITION } from "./definition";
-export const PHI_DASHBOARD_RUNTIME_MODULE = {
-    ...PHI_DASHBOARD_RUNTIME_MODULE_DEFINITION,
-    controllerDefinition: PHI_DASHBOARD_RUNTIME_CONTROLLER_DEFINITION,
-};
+import { createPhiAreaBaseRuntimeModule } from "../area-base-module";
+export const PHI_DASHBOARD_RUNTIME_MODULE = createPhiAreaBaseRuntimeModule(PHI_DASHBOARD_RUNTIME_MODULE_DEFINITION, PHI_DASHBOARD_RUNTIME_CONTROLLER_DEFINITION);

package/plugins/runtime-modules/dashboard/presets.js

@@ -1,77 +1,57 @@
 import { PHI_BASE_PAGE_LAYOUT_VERSION } from "../../../components/regions/presets/phi-base-page-layout";
+import { buildPhiSidebarRoutePresetDescriptor } from "../sidebar-route";
 import { PHI_DASHBOARD_RUNTIME_MODULE_ID } from "./ids";
-const GENERIC_DASHBOARDS = [
-    {
-        area: "app",
-        navKey: "app:sidebar",
-        eyebrow: "App",
-        description: "Everything this site makes available to you once you are signed in.",
-    },
-    {
-        area: "accounting",
-        navKey: "accounting:sidebar",
-        before: "@phis/ui/modules/accounting/nav/home",
-        eyebrow: "Accounting",
-        description: "Invoices and billing workflows for this site.",
-    },
-    {
-        area: "editor",
-        navKey: "editor:sidebar",
-        before: "@phis/ui/modules/editor/nav/translations",
-        eyebrow: "Editor",
-        description: "Content and translation work for this site.",
-    },
-];
-function buildDashboardRoute({ area, navKey, before, loadTree, }) {
-    const presetKey = `${area}-dashboard-page`;
-    return {
+/**
+ * One Dashboard per Area, at the same path in each, at the top of the Area's sidebar.
+ *
+ * `start` rather than wherever the Module happens to sort, because the Area root forwards to the first
+ * entry the viewer can see: where this item sits decides where the front door leads. What `start` is
+ * the Area says, so the Dashboard names no entry of any Area's.
+ *
+ * Every Dashboard is a base page layout, the Builder's included, so every one states that version
+ * rather than the one its Area's own pages are built on.
+ */
+function buildDashboardRoute({ area, loadTree, }) {
+    return buildPhiSidebarRoutePresetDescriptor({
+        area,
+        anchor: "start",
         ownerModuleId: PHI_DASHBOARD_RUNTIME_MODULE_ID,
-        presetKey,
+        presetKey: `${area}-dashboard-page`,
         presetVersion: 1 + PHI_BASE_PAGE_LAYOUT_VERSION,
-        area,
         title: "Dashboard",
         path: "/dashboard",
-        navigation: [{
-                navKey,
-                parentItemKey: null,
-                ...(before ? { before } : {}),
-                item: {
-                    itemKey: `@phis/ui/modules/dashboard/nav/${area}/dashboard`,
-                    label: { defaultMessage: "Dashboard" },
-                    icon: "antd:dashboard",
-                    routePresetKey: presetKey,
-                },
-            }],
+        itemKey: `@phis/ui/modules/dashboard/nav/${area}/dashboard`,
+        icon: "antd:dashboard",
         loadTree,
-    };
+    });
 }
+/*
+ * What each of these Dashboards says is no longer here.
+ *
+ * The eyebrow and the sentence travelled with the template while the page drew them on a card. The page
+ * places a Collection over the card contributions now, so the sentence is a page description and lives
+ * in the preset's label set with the rest of its words -- see `area-dashboard-label-set.ts`.
+ */
+const GENERIC_DASHBOARD_AREAS = ["app", "accounting", "editor"];
 export const PHI_DASHBOARD_RUNTIME_MODULE_ROUTES = [
     buildDashboardRoute({
         area: "admin",
-        navKey: "admin:sidebar",
-        before: "@phis/ui/modules/admin/nav/settings",
-        loadTree: ({ page, runtime }) => import("../../../components/regions/presets/phi-default-admin-dashboard-page-tree")
+        loadTree: ({ page, runtime }) => import("./trees/phi-default-admin-dashboard-page-tree")
             .then((module) => module.buildPhiDefaultAdminDashboardPageTree({ page, runtime })),
     }),
     buildDashboardRoute({
         area: "builder",
-        navKey: "builder:sidebar",
-        before: "@phis/ui/builder/nav/modules",
-        loadTree: ({ page, runtime }) => import("../../../components/regions/presets/phi-default-builder-dashboard-page-tree")
+        loadTree: ({ page, runtime }) => import("./trees/phi-default-builder-dashboard-page-tree")
             .then((module) => module.buildPhiDefaultBuilderDashboardPageTree({ page, runtime })),
     }),
-    ...GENERIC_DASHBOARDS.map((template) => buildDashboardRoute({
-        area: template.area,
-        navKey: template.navKey,
-        ...("before" in template ? { before: template.before } : {}),
-        loadTree: ({ page }) => import("../../../components/regions/presets/phi-default-area-dashboard-page-tree")
+    ...GENERIC_DASHBOARD_AREAS.map((area) => buildDashboardRoute({
+        area,
+        loadTree: ({ page, runtime }) => import("./trees/phi-default-area-dashboard-page-tree")
             .then((module) => module.buildPhiDefaultAreaDashboardPageTree({
             page,
-            area: template.area,
-            presetKey: `${template.area}-dashboard-page`,
-            title: "Dashboard",
-            eyebrow: template.eyebrow,
-            description: template.description,
+            runtime,
+            area,
+            presetKey: `${area}-dashboard-page`,
         })),
     })),
 ];

package/plugins/runtime-modules/dashboard/services/collection.d.ts

@@ -0,0 +1,4 @@
+import { type ReactNode } from "react";
+export declare function PhiDashboardCardCollectionProviderClient({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;

package/plugins/runtime-modules/dashboard/services/collection.js

@@ -0,0 +1,76 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { usePathname } from "next/navigation";
+import { useMemo } from "react";
+import { PHI_DASHBOARD_CARD_DATA_PROVIDER_KEY, PHI_DASHBOARD_CARD_ITEM_RENDERER_KEY, PHI_DASHBOARD_CARD_RESOURCE_KEY, } from "../../../../constants/dashboard-card-provider-keys";
+import { PhiCollectionProviderClient, } from "../../../../components/widgets/client/shared/phi-collection-provider";
+import { isPhiRecord } from "../../../../helpers/is-record";
+function readCardRows(payload) {
+    return Array.isArray(payload.cards)
+        ? payload.cards.filter(isPhiRecord).map((card) => ({ ...card }))
+        : [];
+}
+async function queryDashboardCards(request, pathname) {
+    if (request.resourceKey !== PHI_DASHBOARD_CARD_RESOURCE_KEY) {
+        throw new Error(`Unknown Dashboard collection "${request.resourceKey}".`);
+    }
+    const area = typeof request.params?.area === "string" ? request.params.area : "";
+    if (!area) {
+        return {
+            resourceKey: request.resourceKey,
+            items: [],
+            total: 0,
+            loading: false,
+            error: "The Dashboard Widget names no Area.",
+        };
+    }
+    const params = new URLSearchParams({ area, path: pathname });
+    try {
+        const response = await fetch(`/api/site/dashboard-cards?${params.toString()}`, {
+            method: "GET",
+            headers: { Accept: "application/json" },
+            cache: "no-store",
+            credentials: "include",
+            signal: request.signal,
+        });
+        if (!response.ok) {
+            throw new Error(`Dashboard cards request failed (${response.status}).`);
+        }
+        const rows = readCardRows((await response.json()));
+        return {
+            resourceKey: request.resourceKey,
+            items: rows,
+            total: rows.length,
+            loading: false,
+            error: null,
+        };
+    }
+    catch (error) {
+        if (request.signal.aborted) {
+            throw error;
+        }
+        return {
+            resourceKey: request.resourceKey,
+            items: [],
+            total: 0,
+            loading: false,
+            error: error instanceof Error ? error.message : "Dashboard cards are unavailable.",
+        };
+    }
+}
+export function PhiDashboardCardCollectionProviderClient({ children }) {
+    /*
+     * Where this Widget stands, live. A registration built once at module scope could not know it, and a
+     * Dashboard placed on a second page would ask about the first one's.
+     */
+    const pathname = usePathname() ?? "/";
+    const registration = useMemo(() => ({
+        key: PHI_DASHBOARD_CARD_DATA_PROVIDER_KEY,
+        query: (request) => queryDashboardCards(request, pathname),
+        resources: [{
+                resourceKey: PHI_DASHBOARD_CARD_RESOURCE_KEY,
+                itemRendererKey: PHI_DASHBOARD_CARD_ITEM_RENDERER_KEY,
+            }],
+    }), [pathname]);
+    return (_jsx(PhiCollectionProviderClient, { registration: registration, children: children }));
+}

package/plugins/runtime-modules/dashboard/trees/admin-dashboard-label-set.d.ts

@@ -0,0 +1,7 @@
+import "server-only";
+import { type PhiGlobalTranslatorOptions } from "../../../../gateway/tr";
+export declare function getPhiAdminDashboardPageLabels(options: PhiGlobalTranslatorOptions): Promise<{
+    pageTitle: string;
+    pageDescription: string;
+    emptyDescription: string;
+}>;

package/plugins/runtime-modules/dashboard/trees/admin-dashboard-label-set.js

@@ -0,0 +1,26 @@
+import "server-only";
+import { PHI_TR_CTX_WEB_UI_LABEL } from "../../../../gateway/tr";
+import { definePhiLabelSet, definePhiMessageLabel, getPhiLabelSet } from "../../../../gateway/label-set";
+/**
+ * What the page says, which is now all it says.
+ *
+ * The figures moved out with the cards: a card's own words belong to the Module that offers it, and a
+ * label set here would have been this page translating on three other Modules' behalf.
+ */
+const PHI_ADMIN_DASHBOARD_PAGE_LABEL_SET = definePhiLabelSet({
+    key: "preset:admin-dashboard-page",
+    ctx: PHI_TR_CTX_WEB_UI_LABEL,
+    labels: {
+        page_title: "Dashboard",
+        page_description: definePhiMessageLabel("Review the current site status and core runtime counters at a glance."),
+        empty_description: "No module offers a card here yet.",
+    },
+});
+export async function getPhiAdminDashboardPageLabels(options) {
+    const labels = await getPhiLabelSet(options, PHI_ADMIN_DASHBOARD_PAGE_LABEL_SET);
+    return {
+        pageTitle: labels.page_title,
+        pageDescription: labels.page_description,
+        emptyDescription: labels.empty_description,
+    };
+}

package/plugins/runtime-modules/dashboard/trees/area-dashboard-label-set.d.ts

@@ -0,0 +1,9 @@
+import "server-only";
+import { type PhiGlobalTranslatorOptions } from "../../../../gateway/tr";
+/** The Areas that take the generic Dashboard. Admin and Builder each have one written for them. */
+export type PhiAreaDashboardKey = "app" | "accounting" | "editor";
+export declare function getPhiAreaDashboardPageLabels(options: PhiGlobalTranslatorOptions, area: PhiAreaDashboardKey): Promise<{
+    pageTitle: string;
+    pageDescription: string;
+    emptyDescription: string;
+}>;

package/plugins/runtime-modules/dashboard/trees/area-dashboard-label-set.js

@@ -0,0 +1,38 @@
+import "server-only";
+import { PHI_TR_CTX_WEB_UI_LABEL } from "../../../../gateway/tr";
+import { definePhiLabelSet, definePhiMessageLabel, getPhiLabelSet } from "../../../../gateway/label-set";
+/**
+ * What the Dashboards that were not written for one Area say.
+ *
+ * The per-Area sentence used to travel as an English string in the route template and reach the page
+ * as a card's `description`, translated on the way out because the card translates its own text. The
+ * card is gone -- the page places a Collection over the contributions now, like Admin -- so the
+ * sentence moved here rather than becoming the one untranslated line on the page.
+ *
+ * One key per Area rather than a lookup by name, because a label set's keys are what a translator sees
+ * and a computed key is a message nobody can find.
+ */
+const PHI_AREA_DASHBOARD_PAGE_LABEL_SET = definePhiLabelSet({
+    key: "preset:area-dashboard-page",
+    ctx: PHI_TR_CTX_WEB_UI_LABEL,
+    labels: {
+        page_title: "Dashboard",
+        app_description: definePhiMessageLabel("Everything this site makes available to you once you are signed in."),
+        accounting_description: definePhiMessageLabel("Invoices and billing workflows for this site."),
+        editor_description: definePhiMessageLabel("Content and translation work for this site."),
+        empty_description: "No module offers a card here yet.",
+    },
+});
+export async function getPhiAreaDashboardPageLabels(options, area) {
+    const labels = await getPhiLabelSet(options, PHI_AREA_DASHBOARD_PAGE_LABEL_SET);
+    const descriptionByArea = {
+        app: labels.app_description,
+        accounting: labels.accounting_description,
+        editor: labels.editor_description,
+    };
+    return {
+        pageTitle: labels.page_title,
+        pageDescription: descriptionByArea[area],
+        emptyDescription: labels.empty_description,
+    };
+}