@phis/ui 0.2.0 → 0.3.0

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

@@ -1,8 +1,8 @@
 "use client";
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
-import { ReloadOutlined, UndoOutlined } from "@ant-design/icons";
+import { isPhiRecord } from "../../../../../helpers/is-record";
 import { useCallback, useEffect, useMemo, useState } from "react";
-import { validatePhiTreeWidgetBinding } from "../../../../../types/tree-widget";
+import { readPhiTreeProviderError, validatePhiTreeWidgetBinding } from "../../../../../types/tree-widget";
 import { usePhiTreeBinding } from "../../../../../components/trees/client/phi-tree-binding";
 import { PhiTreeActionButton, PhiTreeControl } from "../../../../../components/controls/phi-tree-control";
 import { PhiTextControl } from "../../../../../components/controls/phi-text-control";
@@ -15,9 +15,11 @@ import { usePhiControlOptionsProvider } from "../../../../../components/controls
 import { usePhiConfig } from "../../../../../components/root/phi-config-provider";
 import { clearPhiDataDragPayload, readPhiDataDragPayload, startPhiDataDragAutoScroll, writePhiDataDragPayload, } from "../../../../../components/runtime/client/phi-data-dnd";
 import { usePhiSignalListener } from "../../../../../components/runtime/runtime-signal-bus";
-import { usePhiSignalEmitter, usePhiSignalIdentity } from "../../../../../components/runtime/runtime-signal-identity";
-import { findPhiSignalRoutesByCapabilityId } from "../../../../../types/signals";
+import { findPhiSignalListenRoute, resolvePhiSignalListenFilter } from "../../../../../helpers/signal-listen-routes";
+import { emitPhiSignalCapability, usePhiSignalEmitter, usePhiSignalIdentity } from "../../../../../components/runtime/runtime-signal-identity";
+import {} from "../../../../../types/signals";
 import { PhiTypographyControl } from "../../../../../components/controls/phi-typography-control";
+import { PhiIcon } from "../../../../../components/shell/phi-icon";
 function readPath(value, path) {
     return path.split(".").reduce((current, key) => current && typeof current === "object" ? current[key] : undefined, value);
 }
@@ -31,7 +33,22 @@ function TreeBindingTool({ field, label, placeholder, presentation, width, sourc
 }
 export function PhiTreeWidgetClient({ config, labels }) {
     const { token } = usePhiConfig();
-    const [bindingParams, setBindingParams] = useState(() => ({ ...(config.source?.params ?? {}) }));
+    /*
+     * What the reader set, tagged with the configured params it was set against: a Builder edit of those
+     * is a new starting point, as in the Table.
+     */
+    const configuredBindingParams = useMemo(() => ({ ...(config.source?.params ?? {}) }), [config.source?.params]);
+    const bindingParamsSeed = JSON.stringify(configuredBindingParams);
+    const [chosenBindingParams, setChosenBindingParams] = useState(null);
+    const bindingParams = chosenBindingParams?.seed === bindingParamsSeed
+        ? chosenBindingParams.params
+        : configuredBindingParams;
+    const setBindingParams = useCallback((next) => {
+        setChosenBindingParams((current) => {
+            const base = current?.seed === bindingParamsSeed ? current.params : configuredBindingParams;
+            return { seed: bindingParamsSeed, params: typeof next === "function" ? next(base) : next };
+        });
+    }, [bindingParamsSeed, configuredBindingParams]);
     const [searchDraft, setSearchDraft] = useState(config.initialQuery?.search ?? "");
     const signalIdentity = usePhiSignalIdentity();
     const emitSignal = usePhiSignalEmitter(signalIdentity.sender);
@@ -41,22 +58,7 @@ export function PhiTreeWidgetClient({ config, labels }) {
      * `correlationId` is the exchange this output belongs to: present when the Tree is answering a
      * signal it received, absent when the operator drove it from the Tree itself, which begins one.
      */
-    const emitCapability = useCallback((capabilityId, value, correlationId) => {
-        for (const route of findPhiSignalRoutesByCapabilityId(emitRoutes, capabilityId)) {
-            if (route.receiver == null || route.valueType === "json" && !route.valueSchema)
-                continue;
-            emitSignal({
-                scope: route.scope,
-                channel: route.channel,
-                action: route.action,
-                value: route.valueType === "none" ? null : value,
-                valueType: route.valueType,
-                valueSchema: route.valueSchema ?? null,
-                receiver: route.receiver,
-                correlationId,
-            });
-        }
-    }, [emitRoutes, emitSignal]);
+    const emitCapability = useCallback((capabilityId, value, correlationId) => emitPhiSignalCapability(emitSignal, emitRoutes, capabilityId, value, correlationId), [emitRoutes, emitSignal]);
     const source = useMemo(() => config.source ? { ...config.source, params: bindingParams } : null, [bindingParams, config.source]);
     const binding = usePhiTreeBinding({
         source,
@@ -79,7 +81,7 @@ export function PhiTreeWidgetClient({ config, labels }) {
         setSearchDraft(config.initialQuery?.search ?? "");
         binding.setQuery({ ...(config.initialQuery ?? {}) });
         emitCapability("bindingParamsChange", { params: nextParams });
-    }, [binding, config.initialQuery, config.source?.params, emitCapability]);
+    }, [binding, config.initialQuery, config.source?.params, emitCapability, setBindingParams]);
     const contractError = binding.resource ? validatePhiTreeWidgetBinding(config, binding.resource)[0] ?? null : null;
     const treeQuery = binding.query;
     const setTreeQuery = binding.setQuery;
@@ -94,15 +96,21 @@ export function PhiTreeWidgetClient({ config, labels }) {
         else if (action.execution === "provider") {
             void binding.executeAction(action.key, identity).then((result) => {
                 emitCapability("mutationChange", result, correlationId);
-            }).catch(() => undefined);
+            }).catch((error) => {
+                // Whoever asked with a correlation id waits for an answer; a failure is one, in the result's shape.
+                const failure = readPhiTreeProviderError(error);
+                emitCapability("mutationChange", {
+                    status: "rejected",
+                    invalidation: "none",
+                    errorCode: failure.code,
+                    message: failure.message,
+                }, correlationId);
+            });
         }
     }, [binding, emitCapability]);
     usePhiSignalListener(useCallback((signal) => {
-        const route = listenRoutes.find((candidate) => candidate.receiver !== null &&
-            candidate.channel === signal.channel && candidate.action === signal.action &&
-            candidate.valueType === signal.valueType &&
-            (candidate.valueType !== "json" || candidate.valueSchema === signal.valueSchema));
-        if (!route || signal.receiver !== "broadcast" && signal.receiver !== signalIdentity.receiver)
+        const route = findPhiSignalListenRoute(listenRoutes, signal, signalIdentity.receiver);
+        if (!route)
             return;
         if (route.capabilityId === "searchChange" && typeof signal.value === "string") {
             setSearchDraft(signal.value);
@@ -115,9 +123,9 @@ export function PhiTreeWidgetClient({ config, labels }) {
         else if (route.capabilityId === "reload") {
             binding.reload();
         }
-        else if (route.capabilityId === "bindingParamsChange" && signal.value && typeof signal.value === "object" && !Array.isArray(signal.value)) {
+        else if (route.capabilityId === "bindingParamsChange" && isPhiRecord(signal.value)) {
             const params = signal.value.params;
-            if (params && typeof params === "object" && !Array.isArray(params)) {
+            if (isPhiRecord(params)) {
                 setBindingParams((current) => ({ ...current, ...params }));
             }
         }
@@ -130,7 +138,7 @@ export function PhiTreeWidgetClient({ config, labels }) {
         else if (route.capabilityId === "expansionChange" && Array.isArray(signal.value)) {
             binding.setExpandedNodeIdentities(signal.value.filter((value) => typeof value === "string"));
         }
-        else if (route.capabilityId === "actionActivate" && signal.value && typeof signal.value === "object" && !Array.isArray(signal.value)) {
+        else if (route.capabilityId === "actionActivate" && isPhiRecord(signal.value)) {
             const request = signal.value;
             const action = [...(config.features.actions?.toolbar ?? []), ...(config.features.actions?.node ?? []), ...(config.features.actions?.selection ?? [])]
                 .find((candidate) => candidate.key === request.actionKey);
@@ -140,19 +148,7 @@ export function PhiTreeWidgetClient({ config, labels }) {
                     : null, signal.correlationId);
             }
         }
-    }, [activate, binding, config.features.actions, listenRoutes, signalIdentity.receiver]), useMemo(() => {
-        if (!listenRoutes.length)
-            return null;
-        return {
-            scopes: Array.from(new Set(listenRoutes.map((route) => route.scope))),
-            channels: Array.from(new Set(listenRoutes.map((route) => route.channel))),
-            // Only a route set where every route names a schema can filter by schema: a route that names
-            // none accepts a signal that carries none, and listing the others would drop exactly those.
-            ...(listenRoutes.every((route) => route.valueSchema)
-                ? { valueSchemas: Array.from(new Set(listenRoutes.map((route) => route.valueSchema))) }
-                : {}),
-        };
-    }, [listenRoutes]), signalIdentity.receiver);
+    }, [activate, binding, config.features.actions, listenRoutes, setBindingParams, signalIdentity.receiver]), useMemo(() => resolvePhiSignalListenFilter(listenRoutes), [listenRoutes]), signalIdentity.receiver);
     useEffect(() => {
         emitCapability("stateChange", {
             loading: binding.loading,
@@ -186,7 +182,7 @@ export function PhiTreeWidgetClient({ config, labels }) {
     const toolbar = selfContained && ((config.features.actions?.selection?.length ?? 0) > 0 ||
         (config.features.actions?.toolbar?.length ?? 0) > 0 ||
         hasResettableQuery && tools?.reset !== false ||
-        tools?.reload === true) ? (_jsxs(PhiToolbarControl, { size: controlSize, compact: true, children: [(config.features.actions?.toolbar ?? []).map((action) => (_jsx(PhiTreeActionButton, { action: action, size: controlSize, onActivate: () => activate(action) }, action.key))), (config.features.actions?.selection ?? []).map((action) => (_jsx(PhiTreeActionButton, { action: action, size: controlSize, disabled: binding.selectedNodeIdentities.length === 0, onActivate: () => activate(action) }, action.key))), hasResettableQuery && tools?.reset !== false ? (_jsx(PhiButtonControl, { icon: _jsx(UndoOutlined, {}), ariaLabel: labels.reset, size: controlSize, onClick: resetTools })) : null, tools?.reload ? (_jsx(PhiButtonControl, { icon: _jsx(ReloadOutlined, {}), ariaLabel: labels.reload, tooltip: labels.reload, size: controlSize, onClick: binding.reload })) : null] })) : null;
+        tools?.reload === true) ? (_jsxs(PhiToolbarControl, { size: controlSize, compact: true, children: [(config.features.actions?.toolbar ?? []).map((action) => (_jsx(PhiTreeActionButton, { action: action, size: controlSize, onActivate: () => activate(action) }, action.key))), (config.features.actions?.selection ?? []).map((action) => (_jsx(PhiTreeActionButton, { action: action, size: controlSize, disabled: binding.selectedNodeIdentities.length === 0, onActivate: () => activate(action) }, action.key))), hasResettableQuery && tools?.reset !== false ? (_jsx(PhiButtonControl, { icon: _jsx(PhiIcon, { name: "undo", size: "inherit" }), ariaLabel: labels.reset, size: controlSize, onClick: resetTools })) : null, tools?.reload ? (_jsx(PhiButtonControl, { icon: _jsx(PhiIcon, { name: "reload", size: "inherit" }), ariaLabel: labels.reload, tooltip: labels.reload, size: controlSize, onClick: binding.reload })) : null] })) : null;
     return (_jsxs("div", { style: {
             display: "flex",
             flexDirection: "column",

package/plugins/runtime-modules/core/widgets/tree/config.js

@@ -82,7 +82,7 @@ export function parsePhiTreeWidgetConfig(raw) {
     const initialQuery = isPhiRecord(raw.initialQuery) ? raw.initialQuery : {};
     return {
         presentation: {
-            ...parsePhiControlPresentationConfig(presentation),
+            controlSize: parsePhiControlPresentationConfig(presentation).controlSize ?? "small",
             title: readString(presentation.title),
             description: readString(presentation.description),
             width: readPhiLengthValue(presentation.width) ?? undefined,

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

@@ -11,7 +11,7 @@ import { PHI_COMMAND_TOOLBAR_WIDGET_DEFINITION, } from "./widgets/command-toolba
 import { PHI_DESCRIPTION_WIDGET_DEFINITION, } from "./widgets/description/config";
 import { PHI_DRAFT_STATUS_WIDGET_DEFINITION, } from "./widgets/draft-status/config";
 import { PHI_DIMENSION_WIDGET_DEFINITION, } from "./widgets/dimension/config";
-import { PHI_DATE_PICKER_WIDGET_DEFINITION, } from "./widgets/date-picker/config";
+import { PHI_DATE_INPUT_WIDGET_DEFINITION, } from "./widgets/date-input/config";
 import { PHI_LENGTH_WIDGET_DEFINITION, } from "./widgets/length/config";
 import { PHI_FORM_WIDGET_DEFINITION, } from "./widgets/form/config";
 import { PHI_FORM_PREVIEW_WIDGET_DEFINITION } from "./widgets/form-preview/config";
@@ -42,9 +42,17 @@ import { PHI_SIDEBAR_NAVIGATION_WIDGET_DEFINITION, } from "./widgets/sidebar-nav
 import { PHI_SIMPLE_TEXT_WIDGET_DEFINITION, } from "./widgets/simple-text/config";
 import { PHI_SPACER_WIDGET_DEFINITION, } from "./widgets/spacer/config";
 import { PHI_GALLERY_WIDGET_DEFINITION } from "./widgets/gallery/config";
+import { PHI_STEPS_WIDGET_DEFINITION } from "./widgets/steps/config";
+import { PHI_TIMELINE_WIDGET_DEFINITION } from "./widgets/timeline/config";
+import { PHI_ENTRY_LIST_WIDGET_DEFINITION } from "./widgets/entry-list/config";
+import { PHI_ENTRY_DETAIL_WIDGET_DEFINITION } from "./widgets/entry-detail/config";
+import { PHI_ENTRY_HEADER_WIDGET_DEFINITION } from "./widgets/entry-header/config";
+import { PHI_THREAD_CONVERSATION_WIDGET_DEFINITION } from "./widgets/thread-conversation/config";
+import { PHI_FLOAT_BUTTON_WIDGET_DEFINITION } from "./widgets/float-button/config";
 import { PHI_TAB_BAR_WIDGET_DEFINITION, } from "../../../components/widgets/config/stack-tabs";
 import { PHI_SWITCH_WIDGET_DEFINITION, } from "./widgets/switch/config";
 import { PHI_THEME_MODE_SWITCH_WIDGET_DEFINITION, } from "./widgets/theme-mode-switch/config";
+import { PHI_TOUR_BUTTON_WIDGET_DEFINITION, } from "./widgets/tour-button/config";
 import { PHI_TABLE_WIDGET_DEFINITION, } from "./widgets/table/config";
 import { PHI_TREE_WIDGET_DEFINITION, } from "./widgets/tree/config";
 function defineFirstPartyWidget(options) {
@@ -52,13 +60,13 @@ function defineFirstPartyWidget(options) {
 }
 export const PHI_RUNTIME_MODULE_WIDGETS = [
     defineFirstPartyWidget({
-        definition: PHI_DATE_PICKER_WIDGET_DEFINITION,
+        definition: PHI_DATE_INPUT_WIDGET_DEFINITION,
         ownerModuleId: PHI_CORE_RUNTIME_MODULE_ID,
         renderPolicies: { "runtime": "custom", "preview": "custom", "authoring": "custom" },
-        loadRuntime: () => import("./widgets/date-picker/plugin")
-            .then((module) => module.PHI_DATE_PICKER_WIDGET_PLUGIN),
-        loadPreview: () => import("./widgets/date-picker/plugin")
-            .then((module) => module.PHI_DATE_PICKER_WIDGET_PLUGIN),
+        loadRuntime: () => import("./widgets/date-input/plugin")
+            .then((module) => module.PHI_DATE_INPUT_WIDGET_PLUGIN),
+        loadPreview: () => import("./widgets/date-input/plugin")
+            .then((module) => module.PHI_DATE_INPUT_WIDGET_PLUGIN),
     }),
     defineFirstPartyWidget({
         definition: PHI_ACCOUNT_WIDGET_DEFINITION,
@@ -349,6 +357,57 @@ export const PHI_RUNTIME_MODULE_WIDGETS = [
         loadRuntime: () => import("./widgets/gallery/plugin").then((module) => module.PHI_GALLERY_WIDGET_PLUGIN),
         loadPreview: () => import("./widgets/gallery/plugin").then((module) => module.PHI_GALLERY_WIDGET_PLUGIN),
     }),
+    defineFirstPartyWidget({
+        definition: PHI_STEPS_WIDGET_DEFINITION,
+        ownerModuleId: PHI_CORE_RUNTIME_MODULE_ID,
+        renderPolicies: { "runtime": "custom", "preview": "custom", "authoring": "custom" },
+        loadRuntime: () => import("./widgets/steps/plugin").then((module) => module.PHI_STEPS_WIDGET_PLUGIN),
+        loadPreview: () => import("./widgets/steps/plugin").then((module) => module.PHI_STEPS_WIDGET_PLUGIN),
+    }),
+    defineFirstPartyWidget({
+        definition: PHI_TIMELINE_WIDGET_DEFINITION,
+        ownerModuleId: PHI_CORE_RUNTIME_MODULE_ID,
+        renderPolicies: { "runtime": "custom", "preview": "custom", "authoring": "custom" },
+        loadRuntime: () => import("./widgets/timeline/plugin").then((module) => module.PHI_TIMELINE_WIDGET_PLUGIN),
+        loadPreview: () => import("./widgets/timeline/plugin").then((module) => module.PHI_TIMELINE_WIDGET_PLUGIN),
+    }),
+    // A content kind's entries and one entry of it, for every kind's Module (`CONTENT_ENTRIES.md`).
+    defineFirstPartyWidget({
+        definition: PHI_ENTRY_LIST_WIDGET_DEFINITION,
+        ownerModuleId: PHI_CORE_RUNTIME_MODULE_ID,
+        renderPolicies: { "runtime": "custom", "preview": "custom", "authoring": "custom" },
+        loadRuntime: () => import("./widgets/entry-list/plugin").then((module) => module.PHI_ENTRY_LIST_WIDGET_PLUGIN),
+        loadPreview: () => import("./widgets/entry-list/plugin").then((module) => module.PHI_ENTRY_LIST_WIDGET_PLUGIN),
+    }),
+    defineFirstPartyWidget({
+        definition: PHI_ENTRY_DETAIL_WIDGET_DEFINITION,
+        ownerModuleId: PHI_CORE_RUNTIME_MODULE_ID,
+        renderPolicies: { "runtime": "custom", "preview": "custom", "authoring": "custom" },
+        loadRuntime: () => import("./widgets/entry-detail/plugin").then((module) => module.PHI_ENTRY_DETAIL_WIDGET_PLUGIN),
+        loadPreview: () => import("./widgets/entry-detail/plugin").then((module) => module.PHI_ENTRY_DETAIL_WIDGET_PLUGIN),
+    }),
+    defineFirstPartyWidget({
+        definition: PHI_ENTRY_HEADER_WIDGET_DEFINITION,
+        ownerModuleId: PHI_CORE_RUNTIME_MODULE_ID,
+        renderPolicies: { "runtime": "custom", "preview": "custom", "authoring": "custom" },
+        loadRuntime: () => import("./widgets/entry-header/plugin").then((module) => module.PHI_ENTRY_HEADER_WIDGET_PLUGIN),
+        loadPreview: () => import("./widgets/entry-header/plugin").then((module) => module.PHI_ENTRY_HEADER_WIDGET_PLUGIN),
+    }),
+    // A conversation, for every Module that runs conversations of its own kind (`messaging/`).
+    defineFirstPartyWidget({
+        definition: PHI_THREAD_CONVERSATION_WIDGET_DEFINITION,
+        ownerModuleId: PHI_CORE_RUNTIME_MODULE_ID,
+        renderPolicies: { runtime: "custom", preview: "custom", authoring: "custom" },
+        loadRuntime: () => import("./widgets/thread-conversation/plugin").then((module) => module.PHI_THREAD_CONVERSATION_WIDGET_PLUGIN),
+        loadPreview: () => import("./widgets/thread-conversation/plugin").then((module) => module.PHI_THREAD_CONVERSATION_WIDGET_PLUGIN),
+    }),
+    defineFirstPartyWidget({
+        definition: PHI_FLOAT_BUTTON_WIDGET_DEFINITION,
+        ownerModuleId: PHI_CORE_RUNTIME_MODULE_ID,
+        renderPolicies: { "runtime": "custom", "preview": "custom", "authoring": "custom" },
+        loadRuntime: () => import("./widgets/float-button/plugin").then((module) => module.PHI_FLOAT_BUTTON_WIDGET_PLUGIN),
+        loadPreview: () => import("./widgets/float-button/plugin").then((module) => module.PHI_FLOAT_BUTTON_WIDGET_PLUGIN),
+    }),
     defineFirstPartyWidget({
         definition: PHI_SPACER_WIDGET_DEFINITION,
         ownerModuleId: PHI_CORE_RUNTIME_MODULE_ID,
@@ -370,6 +429,13 @@ export const PHI_RUNTIME_MODULE_WIDGETS = [
         loadRuntime: () => import("./widgets/theme-mode-switch/plugin").then((module) => module.PHI_THEME_MODE_SWITCH_WIDGET_PLUGIN),
         loadPreview: () => import("./widgets/theme-mode-switch/plugin").then((module) => module.PHI_THEME_MODE_SWITCH_WIDGET_PLUGIN),
     }),
+    defineFirstPartyWidget({
+        definition: PHI_TOUR_BUTTON_WIDGET_DEFINITION,
+        ownerModuleId: PHI_CORE_RUNTIME_MODULE_ID,
+        renderPolicies: { "runtime": "custom", "preview": "custom", "authoring": "custom" },
+        loadRuntime: () => import("./widgets/tour-button/plugin").then((module) => module.PHI_TOUR_BUTTON_WIDGET_PLUGIN),
+        loadPreview: () => import("./widgets/tour-button/plugin").then((module) => module.PHI_TOUR_BUTTON_WIDGET_PLUGIN),
+    }),
     defineFirstPartyWidget({
         definition: PHI_TAB_BAR_WIDGET_DEFINITION,
         ownerModuleId: PHI_CORE_RUNTIME_MODULE_ID,

package/plugins/runtime-modules/dashboard/authoring-client.d.ts

@@ -1,2 +1 @@
-export declare const PhiDashboardRuntimeModuleAuthoringClient: import("react").ComponentType<import("../contracts").PhiRuntimeModuleAuthoringClientProps>;
 export declare const PHI_DASHBOARD_RUNTIME_MODULE_AUTHORING_CLIENT_CONTRIBUTION: import("../authoring-contributions-client").PhiRuntimeModuleAuthoringClientContribution;

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

@@ -4,7 +4,7 @@ import { createPhiRuntimeModuleAuthoringClient } from "../client-authoring-modul
 import { definePhiRuntimeModuleAuthoringClientContribution } from "../authoring-contributions-client";
 import { PHI_DASHBOARD_RUNTIME_MODULE_ID } from "./ids";
 const DashboardWidgetModule = createPhiAuthoringWidgetModule([]);
-export const PhiDashboardRuntimeModuleAuthoringClient = createPhiRuntimeModuleAuthoringClient({
+const PhiDashboardRuntimeModuleAuthoringClient = createPhiRuntimeModuleAuthoringClient({
     moduleId: PHI_DASHBOARD_RUNTIME_MODULE_ID,
     WidgetModule: DashboardWidgetModule,
 });

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

@@ -1,39 +1,67 @@
 "use client";
 import { jsx as _jsx } from "react/jsx-runtime";
-import { usePathname } from "next/navigation";
 import { useEffect, useMemo, useState } from "react";
+import { readPhiTimelineEntries } from "@phis/contracts/timeline";
+import { PHI_DASHBOARD_CARD_LIST_LIMIT, } from "../../../../types/dashboard-cards";
 import { PhiCardWidgetClient } from "../../../../components/widgets/shared/card-body-client";
+import {} from "../../../../components/widgets/shared/card-vocabulary";
+import { PHI_SURFACE_CARD } from "../../../../helpers/surface-presets";
 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";
+import { usePhiPathname } from "../../../../components/runtime/use-phi-pathname";
+import { PhiTimelineControl } from "../../../../components/controls/phi-timeline-control";
+import { usePhiIntlLocale } from "../../../../components/root/phi-intl-locale";
+import { formatPhiRelativeTime } from "../../../../helpers/format-date-time";
 /**
  * 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.
+ * The list arrives as ordinary Collection rows, each carrying its first payload; a card resolves its own
+ * payload only where a row came without one -- the door a refresh will go through, one card at a time
+ * (DASHBOARD.md section 3). That 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.
+ * What the split buys is visible here: 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
+ * Two vocabularies that agree 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.
+ * A total map rather than a condition, so a form that joins the vocabulary stops this file compiling
+ * instead of quietly falling back to a heading.
  */
 const CARD_BODY_BY_FORM = {
     stat: "stat",
+    list: "list",
 };
+/**
+ * A `list` card's entries as the Timeline draws them: the first few, each time in the page's locale.
+ *
+ * Relative, because a Dashboard is read for what is recent -- "two hours ago" says that, a date makes
+ * the reader do the sum. An entry that states its time in words keeps the words. Drawn here and handed
+ * to the card, which does not import a list Control every page with a Card would load.
+ */
+function PhiDashboardCardList({ entries }) {
+    const locale = usePhiIntlLocale();
+    return (_jsx(PhiTimelineControl, { items: entries.slice(0, PHI_DASHBOARD_CARD_LIST_LIMIT).map((entry) => ({
+            key: entry.key,
+            ...(entry.title ? { title: entry.title } : {}),
+            content: entry.content,
+            ...(entry.time ?? entry.at ? { time: entry.time ?? formatPhiRelativeTime(entry.at, locale) } : {}),
+            ...(entry.icon ? { icon: entry.icon } : {}),
+            ...(entry.tone ? { tone: entry.tone } : {}),
+            ...(entry.pending ? { pending: true } : {}),
+        })) }));
+}
 function readRows(binding) {
     return (binding.data?.items ?? [])
         .filter(isPhiRecord)
@@ -41,11 +69,13 @@ function readRows(binding) {
         .filter((row) => typeof row.cardId === "string" && typeof row.title === "string");
 }
 /**
- * One card, and its own request.
+ * One card, and its own request where the list did not bring its payload.
  *
  * 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.
+ * twelve are visible. Until the Controller is that clock, being asked means being mounted without a
+ * payload -- which, with the list answering it, nothing on this page does today. The path stays so the
+ * clock has a door to knock on.
  */
 function PhiDashboardCard({ row, area, pathname, }) {
     /*
@@ -57,8 +87,12 @@ function PhiDashboardCard({ row, area, pathname, }) {
      * card's answer.
      */
     const requestKey = `${area}\u0000${pathname}\u0000${row.cardId}`;
+    const delivered = row.payload ?? null;
     const [resolved, setResolved] = useState(null);
     useEffect(() => {
+        if (delivered) {
+            return;
+        }
         const controller = new AbortController();
         const params = new URLSearchParams({ area, path: pathname, card: row.cardId });
         fetch(`/api/site/dashboard-cards?${params.toString()}`, {
@@ -86,10 +120,13 @@ function PhiDashboardCard({ row, area, pathname, }) {
             });
         });
         return () => controller.abort();
-    }, [area, pathname, requestKey, row.cardId]);
-    const current = resolved?.key === requestKey ? resolved : null;
+    }, [area, delivered, pathname, requestKey, row.cardId]);
+    const current = delivered
+        ? { key: requestKey, payload: delivered, failure: null }
+        : resolved?.key === requestKey ? resolved : null;
     const payload = current?.payload ?? null;
     const error = current?.failure ?? payload?.error ?? null;
+    const entries = row.form === "list" ? readPhiTimelineEntries(payload?.entries) : [];
     return (_jsx(PhiCardWidgetClient, { labels: {
             ...(row.eyebrow ? { eyebrow: row.eyebrow } : {}),
             /*
@@ -106,6 +143,7 @@ function PhiDashboardCard({ row, area, pathname, }) {
                 : {}),
             ...(payload?.meta ? { meta: payload.meta } : {}),
         }, config: {
+            surface: PHI_SURFACE_CARD,
             variant: "compact",
             body: CARD_BODY_BY_FORM[row.form] ?? "text",
             ...(row.href ? { href: row.href } : {}),
@@ -116,11 +154,11 @@ function PhiDashboardCard({ row, area, pathname, }) {
          * 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 } }));
+        binding: { loading: current === null, error }, listContent: entries.length > 0 ? _jsx(PhiDashboardCardList, { entries: entries }) : null }));
 }
 export function PhiDashboardCardCollectionViewBinding({ config, binding, widgetId, }) {
     void widgetId;
-    const pathname = usePathname() ?? "/";
+    const pathname = usePhiPathname();
     const { presentation } = config;
     const rows = useMemo(() => readRows(binding), [binding]);
     const area = typeof config.source?.params?.area === "string" ? config.source.params.area : "";

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

@@ -1,15 +1,11 @@
 export declare const PHI_DASHBOARD_RUNTIME_MODULE_DEFINITION: {
-    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";
     dataProviders: {
         key: `${string}/${string}`;
         ownerModuleId: "@phis/ui/modules/dashboard";
@@ -34,4 +30,5 @@ export declare const PHI_DASHBOARD_RUNTIME_MODULE_DEFINITION: {
         title: string;
         description: string;
     }[];
+    moduleId: "@phis/ui/modules/dashboard";
 };

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

@@ -1,11 +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_CARD_ITEM_RENDERER_KEY, PHI_DASHBOARD_RUNTIME_MODULE_ID } from "./ids";
+import { PHI_DASHBOARD_CARD_ITEM_RENDERER_KEY, PHI_DASHBOARD_RUNTIME_MODULE_IDENTITY } 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,
+    ...PHI_DASHBOARD_RUNTIME_MODULE_IDENTITY,
     kind: "module",
     /*
      * Every Area a person arrives in to work, which is every Area but Public.
@@ -16,13 +13,10 @@ export const PHI_DASHBOARD_RUNTIME_MODULE_DEFINITION = {
      */
     eligibleAreas: ["app", "accounting", "admin", "builder", "editor"],
     serverBinding: PHI_CORE_SERVER_BINDING,
-    controllerType: PHI_DASHBOARD_CONTROLLER_TYPE,
-    controller: buildPhiRuntimeModuleControllerDescriptor(PHI_DASHBOARD_RUNTIME_CONTROLLER_DEFINITION),
     title: "Dashboard",
     description: "Area-specific Dashboard routes and Dashboard projection orchestration.",
     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.

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

@@ -1,4 +1,13 @@
 export declare const PHI_DASHBOARD_RUNTIME_MODULE_ID: "@phis/ui/modules/dashboard";
+/**
+ * The Module's identity as its Label Sets inherit it (`definePhiRuntimeModuleLabelSet`): the id and,
+ * where a Module declares one, its source locale. Stated here beside the id and spread into the
+ * definition, so a Label Set a tree or a form reads does not import the definition that imports the
+ * tree -- and a Module that writes in another language says so once.
+ */
+export declare const PHI_DASHBOARD_RUNTIME_MODULE_IDENTITY: {
+    readonly moduleId: "@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

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

@@ -1,5 +1,14 @@
 import { PHI_SHARED_PACKAGE_NAME } from "../../../types/signals";
 export const PHI_DASHBOARD_RUNTIME_MODULE_ID = `${PHI_SHARED_PACKAGE_NAME}/modules/dashboard`;
+/**
+ * The Module's identity as its Label Sets inherit it (`definePhiRuntimeModuleLabelSet`): the id and,
+ * where a Module declares one, its source locale. Stated here beside the id and spread into the
+ * definition, so a Label Set a tree or a form reads does not import the definition that imports the
+ * tree -- and a Module that writes in another language says so once.
+ */
+export const PHI_DASHBOARD_RUNTIME_MODULE_IDENTITY = {
+    moduleId: PHI_DASHBOARD_RUNTIME_MODULE_ID,
+};
 /**
  * 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

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

@@ -1 +1,39 @@
-export declare const PHI_DASHBOARD_RUNTIME_MODULE: import("../contracts").PhiRuntimeModule;
+/**
+ * No Controller. The one this Module carried answered nothing and rendered nothing, and was mounted on
+ * every page of its Areas for it. Area-wide behaviour that belongs to no Module goes to the Core Runtime
+ * Controller; a Module's own goes into that Module's Controller, mounted on demand.
+ */
+export declare const PHI_DASHBOARD_RUNTIME_MODULE: {
+    kind: "module";
+    eligibleAreas: readonly ["app", "accounting", "admin", "builder", "editor"];
+    serverBinding: import("../../../types").PhiRuntimeModuleServerBinding;
+    title: string;
+    description: string;
+    category: "workspace";
+    iconFamily: string;
+    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;
+    }[];
+    moduleId: "@phis/ui/modules/dashboard";
+};

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

@@ -1,4 +1,9 @@
-import { PHI_DASHBOARD_RUNTIME_CONTROLLER_DEFINITION } from "../../../plugins/runtime-modules/dashboard/controller/definition";
 import { PHI_DASHBOARD_RUNTIME_MODULE_DEFINITION } from "./definition";
-import { createPhiAreaBaseRuntimeModule } from "../area-base-module";
-export const PHI_DASHBOARD_RUNTIME_MODULE = createPhiAreaBaseRuntimeModule(PHI_DASHBOARD_RUNTIME_MODULE_DEFINITION, PHI_DASHBOARD_RUNTIME_CONTROLLER_DEFINITION);
+/**
+ * No Controller. The one this Module carried answered nothing and rendered nothing, and was mounted on
+ * every page of its Areas for it. Area-wide behaviour that belongs to no Module goes to the Core Runtime
+ * Controller; a Module's own goes into that Module's Controller, mounted on demand.
+ */
+export const PHI_DASHBOARD_RUNTIME_MODULE = {
+    ...PHI_DASHBOARD_RUNTIME_MODULE_DEFINITION,
+};

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

@@ -1,10 +1,10 @@
 "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";
+import { usePhiPathname } from "../../../../components/runtime/use-phi-pathname";
 function readCardRows(payload) {
     return Array.isArray(payload.cards)
         ? payload.cards.filter(isPhiRecord).map((card) => ({ ...card }))
@@ -63,7 +63,7 @@ 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 pathname = usePhiPathname();
     const registration = useMemo(() => ({
         key: PHI_DASHBOARD_CARD_DATA_PROVIDER_KEY,
         query: (request) => queryDashboardCards(request, pathname),

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

@@ -1,13 +1,14 @@
 import "server-only";
 import { PHI_TR_CTX_WEB_UI_LABEL } from "../../../../gateway/tr";
-import { definePhiLabelSet, definePhiMessageLabel, getPhiLabelSet } from "../../../../gateway/label-set";
+import { definePhiRuntimeModuleLabelSet, definePhiMessageLabel, getPhiLabelSet } from "../../../../gateway/label-set";
+import { PHI_DASHBOARD_RUNTIME_MODULE_IDENTITY } from "../ids";
 /**
  * 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({
+const PHI_ADMIN_DASHBOARD_PAGE_LABEL_SET = definePhiRuntimeModuleLabelSet(PHI_DASHBOARD_RUNTIME_MODULE_IDENTITY, {
     key: "preset:admin-dashboard-page",
     ctx: PHI_TR_CTX_WEB_UI_LABEL,
     labels: {