@phis/ui 0.2.1 → 0.3.0

package/plugins/runtime-modules/public/trees/phi-default-pub-welcome-page-tree.js

@@ -85,7 +85,6 @@ export async function buildPhiDefaultPubWelcomePageTree({ page, runtime, }) {
                 config: {
                     balancedSides: true,
                     contentAlign: "center",
-                    style: { height: "100%" },
                 },
             }),
             nodes.layout({

package/plugins/runtime-modules/resolver.d.ts

@@ -21,10 +21,6 @@ export declare function collectPhiRuntimeDataProviderKeys({ moduleSet, trees, }:
     moduleSet: PhiResolvedRuntimeModuleSet;
     trees: readonly PhiResolvedCmsRenderableTree[];
 }): Set<`${string}/${string}`>;
-export declare function collectPhiRuntimeFormOwnerModuleIds({ moduleSet, trees, }: {
-    moduleSet: PhiResolvedRuntimeModuleSet;
-    trees: readonly PhiResolvedCmsRenderableTree[];
-}): Set<`${string}/${string}`>;
 export declare function resolvePhiRuntimeRenderRegistry({ catalog, moduleSet, trees, serverCapabilities, }: {
     catalog: PhiRuntimeModuleCatalog;
     moduleSet: PhiResolvedRuntimeModuleSet;

package/plugins/runtime-modules/resolver.js

@@ -324,7 +324,13 @@ function collectDataProviderKeysFromValue(value, knownProviderKeys, collected) {
     }
 }
 export function collectPhiRuntimeDataProviderKeys({ moduleSet, trees, }) {
-    const knownProviderKeys = new Set(moduleSet.dataProviderDescriptorsByKey.keys());
+    /*
+     * What the browser mounts. A `record` Provider has no Client half -- it is asked on the server while the
+     * page is drawn (`server-helpers/record-source.ts`) -- so a binding to one is no reason to mount anything.
+     */
+    const knownProviderKeys = new Set([...moduleSet.dataProviderDescriptorsByKey.values()]
+        .filter((descriptor) => descriptor.kind !== "record")
+        .map((descriptor) => descriptor.key));
     const collected = new Set();
     for (const tree of trees) {
         for (const widget of tree.contentWidgets) {
@@ -375,7 +381,7 @@ export function collectPhiRuntimeDataProviderKeys({ moduleSet, trees, }) {
     }
     return collected;
 }
-export function collectPhiRuntimeFormOwnerModuleIds({ moduleSet, trees, }) {
+function collectPhiRuntimeFormOwnerModuleIds({ moduleSet, trees, }) {
     const collected = new Set();
     for (const tree of trees) {
         for (const widget of tree.contentWidgets) {
@@ -573,6 +579,10 @@ export async function resolvePhiRuntimeRenderRegistry({ catalog, moduleSet, tree
         renderIssuesByLayoutType,
         ownerModuleIdByWidgetType: new Map(widgetEntries.map(([type, entry]) => [type, entry.ownerModuleId])),
         widgetSlotSizePoliciesByType: new Map(widgetEntries.map(([type, entry]) => [type, entry.definition.slotSizePolicy])),
+        widgetSurfacePoliciesByType: new Map(widgetEntries.flatMap(([type, entry]) => {
+            const policy = entry.definition.surface;
+            return policy == null || policy === "none" ? [] : [[type, policy]];
+        })),
         /*
          * What a Widget states about its own block, for the nodes that state nothing.
          *
@@ -603,6 +613,11 @@ export async function resolvePhiRuntimeRenderRegistry({ catalog, moduleSet, tree
             const features = catalog.get(moduleId)?.features;
             return features ? [[features.namespace, features.load]] : [];
         })),
+        /*
+         * Every active Module's record Providers, for the reason the features are keyed off the active set: a
+         * binding names a Provider, not the Module whose Widget it sits in.
+         */
+        recordProviderLoadersByKey: new Map([...moduleSet.moduleDefinitionsById.keys()].flatMap((moduleId) => (catalog.get(moduleId)?.recordProviders ?? []).map((provider) => [provider.key, provider.load]))),
         dataProviderDescriptorsByKey,
         formDefinitionsById: moduleSet.formDefinitionsById,
     };

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

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

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

@@ -3,7 +3,7 @@ import WidgetModule from "./authoring-widgets";
 import { createPhiRuntimeModuleAuthoringClient } from "../client-authoring-module";
 import { definePhiRuntimeModuleAuthoringClientContribution } from "../authoring-contributions-client";
 import { PHI_REVISIONS_RUNTIME_MODULE_ID } from "./ids";
-export const PhiRevisionsRuntimeModuleAuthoringClient = createPhiRuntimeModuleAuthoringClient({
+const PhiRevisionsRuntimeModuleAuthoringClient = createPhiRuntimeModuleAuthoringClient({
     moduleId: PHI_REVISIONS_RUNTIME_MODULE_ID,
     WidgetModule,
 });

package/plugins/runtime-modules/revisions/controller/client.d.ts

@@ -1,8 +1,9 @@
 import type { PhiSignalAddress } from "../../../../types";
 import { type PhiRevisionsControllerConfig } from "../controller/definition";
 export declare const PHI_REVISIONS_RUNTIME_CONTROLLER_PLUGIN: {
-    renderController: ({ key, address }: import("../../../../types").PhiRuntimeControllerRenderArgs<PhiRevisionsControllerConfig, unknown>) => import("react").FunctionComponentElement<{
+    renderController: ({ key, address, config }: import("../../../../types").PhiRuntimeControllerRenderArgs<PhiRevisionsControllerConfig, unknown>) => import("react").FunctionComponentElement<{
         address: PhiSignalAddress;
+        config: PhiRevisionsControllerConfig;
     }>;
     kind: "controller";
     pluginKey: string;
@@ -12,12 +13,27 @@ export declare const PHI_REVISIONS_RUNTIME_CONTROLLER_PLUGIN: {
     iconFamily: string;
     allowedMountScopes: "area"[];
     runtimeSignals: {
-        emits: {
+        emits: ({
             id: string;
             action: "change";
             valueType: "json";
             valueSchema: `${string}/signals/${string}`;
-        }[];
+        } | {
+            id: string;
+            action: "change";
+            valueType: "string";
+            valueSchema?: undefined;
+        } | {
+            id: string;
+            action: "activate";
+            valueType: "none";
+            valueSchema?: undefined;
+        } | {
+            id: string;
+            action: "close";
+            valueType: "none";
+            valueSchema?: undefined;
+        })[];
         listens: ({
             id: string;
             channel: string;
@@ -38,7 +54,9 @@ export declare const PHI_REVISIONS_RUNTIME_CONTROLLER_PLUGIN: {
             valueSchema?: undefined;
         })[];
     };
-    defaultConfig: {};
-    parseConfig: () => PhiRevisionsControllerConfig;
+    defaultConfig: {
+        signalRoutes: null;
+    };
+    parseConfig: (raw: Record<string, unknown>) => PhiRevisionsControllerConfig;
 };
 export declare const PhiRevisionsRuntimeControllerClient: (props: import("../../contracts").PhiRuntimeModuleControllerClientProps) => import("react").JSX.Element;

package/plugins/runtime-modules/revisions/controller/client.js

@@ -1,11 +1,12 @@
 "use client";
-import { createElement, useCallback, useEffect } from "react";
-import { usePathname, useRouter } from "next/navigation";
-import { createPhiSignalAddress, PHI_SIGNAL_VALUE_SCHEMAS } from "../../../../types/signals";
+import { createElement, useCallback, useEffect, useMemo } from "react";
+import { useRouter } from "next/navigation";
+import { PHI_SIGNAL_VALUE_SCHEMAS } from "../../../../types/signals";
 import { readPhiTableBindingParamsSignalValue } from "../../../../types/table-signal-values";
 import { isPhiBuilderAreaKey } from "../../../../constants/cms-areas";
 import { createPhiRuntimeControllerClient } from "../../../../components/runtime/runtime-controller-client-factory";
 import { usePhiSignalDispatcher, usePhiSignalListener } from "../../../../components/runtime/runtime-signal-bus";
+import { dispatchPhiSignalCapability } from "../../../../components/runtime/runtime-signal-identity";
 import { usePhiApplicationFeedback } from "../../../../components/runtime/use-phi-application-feedback";
 import { getPhiWorkspaceCatalogSnapshot, usePhiWorkspaceCatalogValue, PHI_WORKSPACE_CATALOG_SCOPE, } from "../../../../components/workspace/catalog-store";
 import { PHI_BUILDER_NAVIGATION_KEY_SEARCH_PARAM, PHI_BUILDER_PAGE_SEARCH_PARAM, PHI_BUILDER_REVISIONS_KIND_SEARCH_PARAM, PHI_BUILDER_REVISIONS_SCOPE_SEARCH_PARAM, PHI_BUILDER_THEME_KEY_SEARCH_PARAM, normalizePhiBuilderAreaSearchParam, normalizePhiBuilderPageSearchParam, normalizePhiBuilderRevisionsKindSearchParam, } from "../../../../helpers/cms-scope-search-params";
@@ -14,13 +15,21 @@ import { resolvePhiBuilderActivePageCatalog, resolvePhiBuilderActivePageKey, res
 import { PHI_REVISIONS_RUNTIME_CONTROLLER_DEFINITION, } from "../controller/definition";
 import { resolvePhiBuilderRevisionNavScopeKey } from "../../../../helpers/cms-navigation-scope-key";
 import { deleteCmsDraft } from "../../../../helpers/cms-draft-delete";
-import { PHI_REVISIONS_DELETE_AREA_OVERLAY_IDS, PHI_REVISIONS_DELETE_AREA_WIDGET_IDS, PHI_REVISIONS_TABLE_WIDGET_ID, } from "../page-ids";
 import { isPhiRecord } from "../../../../helpers/is-record";
-const PHI_REVISIONS_TABLE_ADDRESS = createPhiSignalAddress("cms", PHI_REVISIONS_TABLE_WIDGET_ID);
-function PhiRevisionsControllerMount({ address }) {
+import { usePhiPathname } from "../../../../components/runtime/use-phi-pathname";
+function PhiRevisionsControllerMount({ address, config, }) {
     const dispatchSignal = usePhiSignalDispatcher();
+    /*
+     * One declared output, delivered through every route the Revisions Page wrote for it.
+     *
+     * The history Table and the delete-Area dialog were preset ids written into this file, and the Area
+     * runs this Controller on every Builder Page: away from Revisions it kept sending binding params to a
+     * Table that was not there, and the bus held each one for a listener that never came.
+     */
+    const emitRoutes = useMemo(() => config.signalRoutes?.emits ?? [], [config.signalRoutes?.emits]);
+    const emitCapability = useCallback((capabilityId, value, correlationId) => dispatchPhiSignalCapability(dispatchSignal, address, emitRoutes, capabilityId, value, correlationId), [address, dispatchSignal, emitRoutes]);
     const { showMessage } = usePhiApplicationFeedback();
-    const pathname = usePathname();
+    const pathname = usePhiPathname();
     const router = useRouter();
     const builderArea = usePhiWorkspaceCatalogValue(PHI_WORKSPACE_CATALOG_SCOPE, (state) => state.area);
     const builderPageKey = usePhiWorkspaceCatalogValue(PHI_WORKSPACE_CATALOG_SCOPE, (state) => state.pageKey);
@@ -47,23 +56,12 @@ function PhiRevisionsControllerMount({ address }) {
                 : kind === "theme"
                     ? requestedScope || search.get(PHI_BUILDER_THEME_KEY_SEARCH_PARAM) || "default"
                     : normalizePhiBuilderAreaSearchParam(requestedScope) ?? state.area;
-        dispatchSignal({
-            scope: "area",
-            channel: "bindingParams",
-            action: "change",
-            value: { params: { area: state.area, kind, scopeKey } },
-            valueType: "json",
-            valueSchema: PHI_SIGNAL_VALUE_SCHEMAS.tableBindingParams,
-            sender: address,
-            receiver: PHI_REVISIONS_TABLE_ADDRESS,
-            timestamp: Date.now(),
-        });
+        emitCapability("bindingParamsChange", { params: { area: state.area, kind, scopeKey } });
     }, [
-        address,
         builderArea,
         builderPageKey,
         customPages,
-        dispatchSignal,
+        emitCapability,
         modulePresetPagesByArea,
         persistedPageCatalogByArea,
     ]);
@@ -82,27 +80,18 @@ function PhiRevisionsControllerMount({ address }) {
                 ownerModuleId: source?.ownerModuleId,
                 presetKey: source?.presetKey,
             });
-            dispatchSignal({
-                scope: "area",
-                channel: "dialog",
-                action: "close",
-                value: null,
-                valueType: "none",
-                sender: address,
-                receiver: createPhiSignalAddress("cms", PHI_REVISIONS_DELETE_AREA_OVERLAY_IDS.overlayDeleteArea),
-                ...(correlationId ? { correlationId } : {}),
-                timestamp: Date.now(),
-            });
-            showMessage({ level: "success", content: `Deleted the ${area} shell.` });
+            emitCapability("deleteAreaClose", null, correlationId);
+            emitCapability("historyReload", null, correlationId);
+            showMessage({ level: "success", content: `Cleared ${area} back to its preset.` });
             router.refresh();
         }
         catch (error) {
             showMessage({
                 level: "error",
-                content: error instanceof Error ? error.message : "Deleting the shell failed.",
+                content: error instanceof Error ? error.message : "Clearing the Area failed.",
             });
         }
-    }, [address, dispatchSignal, router, showMessage]);
+    }, [emitCapability, router, showMessage]);
     usePhiSignalListener(useCallback((signal) => {
         if (signal.channel === "areaSelection" &&
             signal.action === "change" &&
@@ -111,18 +100,7 @@ function PhiRevisionsControllerMount({ address }) {
             const kind = normalizePhiBuilderRevisionsKindSearchParam(search.get(PHI_BUILDER_REVISIONS_KIND_SEARCH_PARAM)) ?? "area";
             if (kind !== "area")
                 return;
-            dispatchSignal({
-                scope: "area",
-                channel: "bindingParams",
-                action: "change",
-                value: { params: { kind: "area", scopeKey: signal.value } },
-                valueType: "json",
-                valueSchema: PHI_SIGNAL_VALUE_SCHEMAS.tableBindingParams,
-                sender: address,
-                receiver: PHI_REVISIONS_TABLE_ADDRESS,
-                correlationId: signal.correlationId,
-                timestamp: Date.now(),
-            });
+            emitCapability("bindingParamsChange", { params: { kind: "area", scopeKey: signal.value } }, signal.correlationId);
             return;
         }
         if (signal.receiver !== address)
@@ -137,28 +115,8 @@ function PhiRevisionsControllerMount({ address }) {
              * pointed at when it is pressed.
              */
             const area = getPhiWorkspaceCatalogSnapshot(PHI_WORKSPACE_CATALOG_SCOPE).area;
-            dispatchSignal({
-                scope: "area",
-                channel: "text",
-                action: "change",
-                value: `Everything this Site stored for ${area} is deleted, drafts and published alike. What is live changes at once, the Module preset takes the Area back, and no revision is left to restore it from. It cannot be undone.`,
-                valueType: "string",
-                sender: address,
-                receiver: createPhiSignalAddress("cms", PHI_REVISIONS_DELETE_AREA_WIDGET_IDS.deleteAreaWarning),
-                correlationId: signal.correlationId,
-                timestamp: Date.now(),
-            });
-            dispatchSignal({
-                scope: "area",
-                channel: "dialog",
-                action: "activate",
-                value: null,
-                valueType: "none",
-                sender: address,
-                receiver: createPhiSignalAddress("cms", PHI_REVISIONS_DELETE_AREA_OVERLAY_IDS.overlayDeleteArea),
-                correlationId: signal.correlationId,
-                timestamp: Date.now(),
-            });
+            emitCapability("deleteAreaWarning", `Everything this Site stored for ${area} is cleared -- its Shell and its Module selection, drafts and published alike. What is live changes at once, the Module preset takes the Area back, and no revision is left to restore it from. It cannot be undone.`, signal.correlationId);
+            emitCapability("deleteAreaOpen", null, signal.correlationId);
             return;
         }
         if (signal.channel === "formValues" && signal.action === "change") {
@@ -248,12 +206,17 @@ function PhiRevisionsControllerMount({ address }) {
                     timestamp: Date.now(),
                 });
             }
+            else if (key === "resetPage") {
+                showMessage({ level: "success", content: "The Page is back to its Module's preset." }, { correlationId: signal.correlationId });
+                // What stands now is the preset, which only the server knows how to build.
+                router.refresh();
+            }
             else if (key === "delete")
                 showMessage({ level: "success", content: `Deleted revision #${String(action?.revisionId ?? "")}.` }, { correlationId: signal.correlationId });
             else if (key === "deleteSelected")
                 showMessage({ level: "success", content: `Deleted ${String(action?.deletedCount ?? 0)} revisions.` }, { correlationId: signal.correlationId });
         }
-    }, [address, deleteAreaShell, dispatchSignal, pathname, router, showMessage]), {
+    }, [address, deleteAreaShell, dispatchSignal, emitCapability, pathname, router, showMessage]), {
         scopes: ["area", "page"],
         channels: ["areaSelection", "bindingParams", "command", "formValues", "mutation"],
     }, 
@@ -269,6 +232,6 @@ function PhiRevisionsControllerMount({ address }) {
 }
 export const PHI_REVISIONS_RUNTIME_CONTROLLER_PLUGIN = {
     ...PHI_REVISIONS_RUNTIME_CONTROLLER_DEFINITION,
-    renderController: ({ key, address }) => createElement(PhiRevisionsControllerMount, { key, address }),
+    renderController: ({ key, address, config }) => createElement(PhiRevisionsControllerMount, { key, address, config }),
 };
 export const PhiRevisionsRuntimeControllerClient = createPhiRuntimeControllerClient(PHI_REVISIONS_RUNTIME_CONTROLLER_PLUGIN);

package/plugins/runtime-modules/revisions/controller/definition.d.ts

@@ -1,4 +1,12 @@
-export type PhiRevisionsControllerConfig = Record<string, never>;
+import { type PhiSignalRouteSet } from "../../../../types/signals";
+/**
+ * Whom the Controller answers into: the history Table and the delete-Area dialog. The Revisions Page
+ * holds them and says so (`controllerSettings`); the Area runs this Controller on every Builder Page,
+ * and on one that names nothing it feeds nothing.
+ */
+export type PhiRevisionsControllerConfig = {
+    signalRoutes: PhiSignalRouteSet | null;
+};
 export declare const PHI_REVISIONS_RUNTIME_CONTROLLER_DEFINITION: {
     kind: "controller";
     pluginKey: string;
@@ -8,12 +16,27 @@ export declare const PHI_REVISIONS_RUNTIME_CONTROLLER_DEFINITION: {
     iconFamily: string;
     allowedMountScopes: "area"[];
     runtimeSignals: {
-        emits: {
+        emits: ({
             id: string;
             action: "change";
             valueType: "json";
             valueSchema: `${string}/signals/${string}`;
-        }[];
+        } | {
+            id: string;
+            action: "change";
+            valueType: "string";
+            valueSchema?: undefined;
+        } | {
+            id: string;
+            action: "activate";
+            valueType: "none";
+            valueSchema?: undefined;
+        } | {
+            id: string;
+            action: "close";
+            valueType: "none";
+            valueSchema?: undefined;
+        })[];
         listens: ({
             id: string;
             channel: string;
@@ -34,6 +57,8 @@ export declare const PHI_REVISIONS_RUNTIME_CONTROLLER_DEFINITION: {
             valueSchema?: undefined;
         })[];
     };
-    defaultConfig: {};
-    parseConfig: () => PhiRevisionsControllerConfig;
+    defaultConfig: {
+        signalRoutes: null;
+    };
+    parseConfig: (raw: Record<string, unknown>) => PhiRevisionsControllerConfig;
 };

package/plugins/runtime-modules/revisions/controller/definition.js

@@ -1,4 +1,4 @@
-import { PHI_SIGNAL_VALUE_SCHEMAS, } from "../../../../types/signals";
+import { PHI_SIGNAL_VALUE_SCHEMAS, readPhiSignalRouteSet, } from "../../../../types/signals";
 import { PHI_REVISIONS_CONTROLLER_KEY, PHI_REVISIONS_CONTROLLER_PLUGIN_KEY } from "../controller/address";
 export const PHI_REVISIONS_RUNTIME_CONTROLLER_DEFINITION = {
     kind: "controller",
@@ -22,6 +22,11 @@ export const PHI_REVISIONS_RUNTIME_CONTROLLER_DEFINITION = {
                 valueType: "json",
                 valueSchema: PHI_SIGNAL_VALUE_SCHEMAS.revisionsDraftStatus,
             },
+            { id: "deleteAreaWarning", action: "change", valueType: "string" },
+            { id: "deleteAreaOpen", action: "activate", valueType: "none" },
+            { id: "deleteAreaClose", action: "close", valueType: "none" },
+            /* The history is out of date once an Area is cleared: every revision it listed is gone. */
+            { id: "historyReload", action: "activate", valueType: "none" },
         ],
         listens: [{
                 id: "tableMutation",
@@ -59,6 +64,8 @@ export const PHI_REVISIONS_RUNTIME_CONTROLLER_DEFINITION = {
                 valueSchema: PHI_SIGNAL_VALUE_SCHEMAS.formValues,
             }],
     },
-    defaultConfig: {},
-    parseConfig: () => ({}),
+    defaultConfig: { signalRoutes: null },
+    parseConfig: (raw) => ({
+        signalRoutes: readPhiSignalRouteSet(raw.signalRoutes),
+    }),
 };

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

@@ -99,6 +99,13 @@ export declare const PHI_REVISIONS_RUNTIME_DATA_PROVIDER_DESCRIPTORS: ({
             intent: "destructive";
             confirmation: "required";
             disabledWhen?: undefined;
+        } | {
+            key: string;
+            title: string;
+            scope: "resource";
+            intent: "destructive";
+            confirmation: "required";
+            disabledWhen?: undefined;
         })[];
     }[];
 })[];

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

@@ -63,6 +63,8 @@ export const PHI_REVISIONS_RUNTIME_DATA_PROVIDER_DESCRIPTORS = [
                         confirmation: "required",
                     },
                     { key: "deleteSelected", title: "Delete selected", scope: "selection", intent: "destructive", confirmation: "required" },
+                    // A Module's Page back to its preset: the override goes, with every revision listed (CONTENT.md, Reset).
+                    { key: "resetPage", title: "Reset to preset", scope: "resource", intent: "destructive", confirmation: "required" },
                 ],
             }],
     },

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

@@ -111,6 +111,13 @@ export declare const PHI_REVISIONS_RUNTIME_MODULE_DEFINITION: {
                 intent: "destructive";
                 confirmation: "required";
                 disabledWhen?: undefined;
+            } | {
+                key: string;
+                title: string;
+                scope: "resource";
+                intent: "destructive";
+                confirmation: "required";
+                disabledWhen?: undefined;
             })[];
         }[];
     })[];

package/plugins/runtime-modules/revisions/forms.js

@@ -1,9 +1,8 @@
+import { createPhiFormLabelSetLoader } from "../../../components/forms/shared-form-loaders";
 import { createPhiFormId } from "../../../types/form-id";
 import { PHI_SHARED_PACKAGE_NAME } from "../../../types/signals";
-import { flattenPhiFormLabels } from "../../../components/forms/form-labels";
 import { PHI_FORM_FIELD_PROVIDER_KEYS, PHI_FORM_VALIDATION_PROVIDER_KEYS, } from "../../../components/forms/form-provider-contract";
 import { definePhiRuntimeModuleForm } from "../../../components/forms/form-registry";
-import { readPhiServerApiCredentials } from "../../../helpers/phis-server-credentials";
 import { PHI_REVISIONS_RUNTIME_MODULE_ID } from "./ids";
 export const PHI_REVISIONS_FORM_IDS = {
     deleteArea: createPhiFormId(PHI_SHARED_PACKAGE_NAME, "revisions/delete-area"),
@@ -40,18 +39,10 @@ const PHI_REVISIONS_DELETE_AREA_FORM_DESCRIPTOR = {
         },
     ],
 };
-async function loadLabels(context) {
-    const { getPhiBuilderRevisionsWidgetLabels } = await import("../../../components/widgets/label-sets/revisions");
-    const labels = await getPhiBuilderRevisionsWidgetLabels({
-        apiBaseUrl: readPhiServerApiCredentials().apiBaseUrl,
-        internalToken: readPhiServerApiCredentials().internalToken,
-        locale: context.runtime.locale.current,
-    });
-    return flattenPhiFormLabels({
-        areaKey: labels.deleteArea.field,
-        areaKeyRequired: labels.deleteArea.fieldRequired,
-    });
-}
+const loadLabels = createPhiFormLabelSetLoader(() => import("../../../components/widgets/label-sets/revisions").then((module) => module.getPhiBuilderRevisionsWidgetLabels), (labels) => ({
+    areaKey: labels.deleteArea.field,
+    areaKeyRequired: labels.deleteArea.fieldRequired,
+}));
 export const PHI_REVISIONS_RUNTIME_MODULE_FORMS = [
     definePhiRuntimeModuleForm({
         ownerModuleId: PHI_REVISIONS_RUNTIME_MODULE_ID,
@@ -59,8 +50,8 @@ export const PHI_REVISIONS_RUNTIME_MODULE_FORMS = [
         formId: PHI_REVISIONS_FORM_IDS.deleteArea,
         version: 1,
         flags: 0,
-        title: "Delete Area",
-        description: "Confirms deleting an Area's own shell by writing the Area key out.",
+        title: "Clear Area",
+        description: "Confirms clearing an Area back to its preset by writing the Area key out.",
         category: "forms",
         tags: ["revisions", "area"],
         descriptor: PHI_REVISIONS_DELETE_AREA_FORM_DESCRIPTOR,

package/plugins/runtime-modules/revisions/services/table.js

@@ -1,5 +1,7 @@
 "use client";
 import { PHI_REVISIONS_RUNTIME_DATA_PROVIDER_KEYS } from "../ids";
+import { deleteCmsDraft } from "../../../../helpers/cms-draft-delete";
+import { readNumber } from "../../../../components/widgets/config/parser-primitives";
 import { isPhiBuilderAreaKey, isPhiCmsAreaKey } from "../../../../constants/cms-areas";
 import { hasPhiCmsPresetUpdate } from "../../../../plugins/runtime-modules/preset-version";
 import { PhiTableProviderError, } from "../../../../types/table-widget";
@@ -11,6 +13,7 @@ import { PHI_BUILDER_NAVIGATION_KEY_SEARCH_PARAM, PHI_BUILDER_REVISIONS_SCOPE_SE
 import { resolvePhiBuilderRevisionPagePath, resolvePhiBuilderRevisionScope, } from "../types";
 import { resolvePhiBuilderRevisionNavScopeKey } from "../../../../helpers/cms-navigation-scope-key";
 import { isPhiRecord } from "../../../../helpers/is-record";
+import { formatPhiDateTime } from "../../../../helpers/format-date-time";
 function readPresetSource(value) {
     if (!isPhiRecord(value)) {
         return null;
@@ -38,9 +41,10 @@ function readRevisionScope(value) {
     };
 }
 function readParams(value) {
-    if (!isPhiRecord(value) || !isPhiRecord(value.labels)) {
+    if (!isPhiRecord(value) || !isPhiRecord(value.labels) || typeof value.locale !== "string") {
         throw new Error("Revisions table parameters are missing.");
     }
+    const locale = value.locale;
     if (!isPhiRecord(value.scope) && typeof window !== "undefined") {
         const state = getPhiWorkspaceCatalogSnapshot(PHI_WORKSPACE_CATALOG_SCOPE);
         const search = new URLSearchParams(window.location.search);
@@ -89,6 +93,7 @@ function readParams(value) {
                     : "",
             navScopeKey,
             labels: value.labels,
+            locale,
         };
     }
     const scope = readRevisionScope(value.scope);
@@ -105,6 +110,7 @@ function readParams(value) {
         reviewPagePath: value.reviewPagePath,
         navScopeKey: value.navScopeKey,
         labels: value.labels,
+        locale,
     };
 }
 async function readJson(response) {
@@ -205,12 +211,6 @@ async function deleteRevisions(scope, revisionIds, signal) {
     }
     return body;
 }
-function readNumber(value) {
-    return typeof value === "number" && Number.isFinite(value) ? value : null;
-}
-function readBoolean(value) {
-    return value === true;
-}
 function formatTemplate(template, ...values) {
     let result = template;
     values.forEach((value, index) => {
@@ -229,9 +229,9 @@ function readNodeChangeCount(nodes, keys) {
 }
 function formatPageMetaChangeLabel(labels, pageMeta) {
     const changed = [
-        readBoolean(pageMeta?.titleChanged) ? labels.messages.titleField : "",
-        readBoolean(pageMeta?.descriptionChanged) ? labels.messages.descriptionField : "",
-        readBoolean(pageMeta?.indexChanged) ? labels.messages.indexingField : "",
+        pageMeta?.titleChanged === true ? labels.messages.titleField : "",
+        pageMeta?.descriptionChanged === true ? labels.messages.descriptionField : "",
+        pageMeta?.indexChanged === true ? labels.messages.indexingField : "",
     ].filter(Boolean);
     /*
      * Composed rather than enumerated. Two fields were two named labels and one pair; a third turns that
@@ -243,6 +243,32 @@ function formatPageMetaChangeLabel(labels, pageMeta) {
         return labels.messages.titleAndDescriptionFields;
     return changed.join(labels.messages.fieldConjunction);
 }
+function readModuleIds(value) {
+    return Array.isArray(value) ? value.filter((entry) => typeof entry === "string") : [];
+}
+/**
+ * Names the Modules a Module save added and removed. A Module this build no longer installs has no
+ * title to show, so it is written by its id -- it is still what the revision changed.
+ */
+function formatModuleChangeList(labels, modules) {
+    const titles = new Map(getPhiWorkspaceCatalogSnapshot(PHI_WORKSPACE_CATALOG_SCOPE).runtimeModuleDefinitions
+        .map((definition) => [definition.moduleId, definition.title]));
+    const name = (moduleId) => titles.get(moduleId) ?? moduleId;
+    return [
+        ...readModuleIds(modules?.added).map((moduleId) => formatTemplate(labels.messages.moduleAdded, name(moduleId))),
+        ...readModuleIds(modules?.removed).map((moduleId) => formatTemplate(labels.messages.moduleRemoved, name(moduleId))),
+    ].join(", ");
+}
+/**
+ * A Working Draft is one row its saves rewrite, so the message says when and by whom it was saved
+ * last; the Created column keeps the first save.
+ */
+function formatRevisionMessageWithLastSave(params, row) {
+    const message = formatRevisionMessage(params.labels, row);
+    if (!row.savedAt)
+        return message;
+    return formatTemplate(params.labels.messages.lastSaved, message, formatPhiDateTime(row.savedAt, params.locale), row.savedByLabel ?? params.labels.systemLabel);
+}
 function formatRevisionMessage(labels, row) {
     const meta = isPhiRecord(row.meta) ? row.meta : null;
     const messageKey = typeof meta?.messageKey === "string" ? meta.messageKey : null;
@@ -266,6 +292,12 @@ function formatRevisionMessage(labels, row) {
     if (messageKey === "area_saved") {
         return formatTemplate(labels.messages.areaSaved, sourceRevisionId);
     }
+    if (messageKey === "area_modules_changed") {
+        return formatTemplate(labels.messages.areaModulesChanged, formatModuleChangeList(labels, isPhiRecord(meta?.modules) ? meta.modules : null), sourceRevisionId);
+    }
+    if (messageKey === "area_modules_saved") {
+        return formatTemplate(labels.messages.areaModulesSaved, sourceRevisionId);
+    }
     if (messageKey === "navigation_overlay_changed") {
         const navigationMeta = isPhiRecord(meta?.navigation) ? meta.navigation : null;
         return formatTemplate(labels.messages.navigationOverlayChanged, readNumber(navigationMeta?.overrideCount) ?? 0, readNumber(navigationMeta?.tombstoneCount) ?? 0, sourceRevisionId);
@@ -329,7 +361,7 @@ function buildTableData(params, result) {
             ...row,
             revisionTags,
             createdByDisplay: row.createdByLabel ?? params.labels.systemLabel,
-            formattedMessage: formatRevisionMessage(params.labels, row),
+            formattedMessage: formatRevisionMessageWithLastSave(params, row),
             reviewHref: buildRevisionReviewHref(params, row),
             isPublished,
             isWorkingDraft,
@@ -368,6 +400,26 @@ async function mutateRevision(request) {
         throw new PhiTableProviderError("resource-not-found", `Unknown Revisions resource "${request.resourceKey}".`);
     }
     const params = readParams(request.params);
+    if (request.actionKey === "resetPage") {
+        /*
+         * Not a revision act: the override these revisions belong to goes as a whole, and the Module's preset
+         * answers for the Page at once (phis-server CONTENT.md, Reset). Only a Module's Page has a preset.
+         */
+        const preset = params.scope.kind === "page" ? params.scope.sourcePreset ?? null : null;
+        if (!preset) {
+            throw new Error("Only a Module's Page can go back to its preset. Choose one under Page.");
+        }
+        await deleteCmsDraft("/api/site/cms/page/override", {
+            area: params.scope.area,
+            ownerModuleId: preset.ownerModuleId,
+            presetKey: preset.presetKey,
+        });
+        return {
+            status: "accepted",
+            invalidation: "view",
+            value: { key: request.actionKey },
+        };
+    }
     const current = await loadRevisionHistory(params.scope, request.signal);
     const protectedRevisionIds = new Set(buildTableData(params, current).rows
         .filter((row) => row.deleteDisabled === true)