@phis/ui 0.2.1 → 0.4.0

package/plugins/runtime-modules/builder/clients/widget-inspector.js

@@ -1,28 +1,27 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect } from "react";
 import { PhiGeometryControl } from "../../../../components/controls/phi-geometry-control";
+import { PhiSurfaceControl } from "../../../../components/controls/phi-surface-control";
+import { usePhiBaseLayoutOwnSlotController } from "../../../../components/layouts/phi-layout-slot-state";
 import { PhiViewportVisibilityControl } from "../../../../components/controls/phi-viewport-visibility-control";
 import { mergeRenderableBlockDefaults } from "../../../../helpers/renderable-block-serialization";
-import { resolvePhiBuilderPluginDefaultConfig, resolvePhiBuilderWidgetDraftConfig, } from "../plugin-metas";
+import { mergePhiBuilderConfigDefaults, resolvePhiBuilderPluginDefaultConfig, resolvePhiBuilderWidgetDraftConfig, } from "../plugin-metas";
 import { resolvePhiSignalEndpointCapabilities, resolvePhiWidgetSignalEndpoints, } from "../../../../components/widgets/signals/signal-endpoints";
 import { PhiInspectorSectionContent } from "./inspector-section-content";
 import { PhiInspectorSignalSection, } from "./inspector-signal-section";
-import { buildPhiInspectorConfigPathPatch, isPhiInspectorConfigFieldVisible, readPhiInspectorConfigPathValue, renderPhiInspectorConfigField, resolvePhiInspectorDimensionValue, } from "./inspector-config-field";
+import { buildPhiInspectorConfigPathPatch, isPhiInspectorConfigFieldVisible, readPhiInspectorConfigPathValue, renderPhiInspectorConfigField, renderPhiInspectorSwitchRow, resolvePhiInspectorDimensionValue, resolvePhiInspectorFieldLock, } from "./inspector-config-field";
 import { PhiTypographyControl } from "../../../../components/controls/phi-typography-control";
-import { PhiSwitchControl } from "../../../../components/controls/phi-switch-control";
 import { PhiCmsFlags } from "../../../../constants/phi-cms";
 import { hasPhiFlag } from "../../../../helpers/flags";
 const PHI_GAP_SM = "var(--ant-padding-sm)";
-export function PhiDeveloperBuilderWidgetInspectorWidgetClient({ section, builderMode = "editor", selectedStructureNodeKey = null, selectedStructureNodeKind = null, selectedStructureNodeTitle = null, selectedStructureWidgetMeta = null, currentDraft = null, widgetReferenceOptions = [], signalRouteScope = "widget", onConfigChange, onGeometryChange, onTranslateChange, geometryLabels, signalsLabels, colorPickerLabels, iconPickerLabels, dataProviderDescriptors = [], calendarAdapterDescriptors = [], videoProviderDescriptors = [], }) {
+export function PhiDeveloperBuilderWidgetInspectorWidgetClient({ section, builderMode = "editor", selectedStructureNodeKey = null, selectedStructureNodeKind = null, selectedStructureNodeTitle = null, selectedStructureWidgetMeta = null, currentDraft = null, widgetReferenceOptions = [], signalRouteScope = "widget", onConfigChange, onGeometryChange, onSurfaceChange, onTranslateChange, geometryLabels, surfaceLabels, backgroundLabels, borderLabels, renderMediaPicker, signalsLabels, colorPickerLabels, iconPickerLabels, fieldLabels, dataProviderDescriptors = [], calendarAdapterDescriptors = [], videoProviderDescriptors = [], }) {
     const isPreviewMode = builderMode === "preview";
     const isTargetKind = selectedStructureNodeKind === "widget";
     const currentWidgetConfig = resolvePhiBuilderWidgetDraftConfig(selectedStructureWidgetMeta, currentDraft?.config);
     const currentBlockConfig = mergeRenderableBlockDefaults(currentWidgetConfig);
     const widgetDefaultConfigRecord = resolvePhiBuilderPluginDefaultConfig(selectedStructureWidgetMeta);
-    const currentWidgetSettingsConfigRecord = {
-        ...(widgetDefaultConfigRecord ?? {}),
-        ...(currentDraft?.config ?? {}),
-    };
+    const currentWidgetSettingsConfigRecord = mergePhiBuilderConfigDefaults(widgetDefaultConfigRecord, currentDraft?.config);
     const runtimeSignals = selectedStructureWidgetMeta?.runtimeSignals ?? null;
     const currentWidgetConfigRecord = currentWidgetConfig;
     const signalEndpoints = currentDraft
@@ -33,11 +32,59 @@ export function PhiDeveloperBuilderWidgetInspectorWidgetClient({ section, builde
             config: currentWidgetConfigRecord,
             runtimeSignals,
             signalSubcontrols: selectedStructureWidgetMeta?.signalSubcontrols,
+            surfacePolicy: selectedStructureWidgetMeta?.surface,
             routeScope: signalRouteScope,
         })
         : [];
     const signalCapabilities = resolvePhiSignalEndpointCapabilities(signalEndpoints);
     const settingsFields = (selectedStructureWidgetMeta?.fields ?? []).filter((field) => isPhiInspectorConfigFieldVisible(field, currentWidgetSettingsConfigRecord));
+    /*
+     * Only a Widget that asks for a Surface (`surface: "frame"` or `"own"`) gets the Surface section; for
+     * the rest the panel hides itself, the way the Layout Settings panel does when there is nothing to set.
+     * Nothing is decided before the Widget's metadata has arrived -- not known is not "none".
+     */
+    const surfaceSectionHidden = section === "surface" && isTargetKind
+        && selectedStructureWidgetMeta != null && (selectedStructureWidgetMeta.surface ?? "none") === "none";
+    const ownSlot = usePhiBaseLayoutOwnSlotController();
+    useEffect(() => {
+        if (!ownSlot || section !== "surface")
+            return;
+        if (surfaceSectionHidden) {
+            if (ownSlot.state !== "hidden")
+                ownSlot.hide();
+            return;
+        }
+        if (ownSlot.state === "hidden")
+            ownSlot.show();
+    }, [ownSlot, section, surfaceSectionHidden]);
+    /* A heading over the very first field names the Widget's own group rather than starting another. */
+    const headedFieldIndex = settingsFields.findIndex((field, index) => index > 0 && field.heading != null);
+    const firstHeadedFieldIndex = headedFieldIndex === -1 ? settingsFields.length : headedFieldIndex;
+    const renderSettingsField = (field) => {
+        const lock = resolvePhiInspectorFieldLock(field, selectedStructureWidgetMeta?.fields ?? [], currentWidgetSettingsConfigRecord);
+        return renderPhiInspectorConfigField({
+            field,
+            blockId: currentDraft?.id ?? null,
+            value: lock ? lock.value : readPhiInspectorConfigPathValue(currentWidgetSettingsConfigRecord, field.key),
+            defaultValue: readPhiInspectorConfigPathValue(widgetDefaultConfigRecord, field.key),
+            config: currentWidgetSettingsConfigRecord,
+            defaultConfig: widgetDefaultConfigRecord,
+            disabled: isPreviewMode || lock != null,
+            widgetReferenceOptions,
+            backgroundLabels,
+            borderLabels,
+            colorPickerLabels,
+            iconPickerLabels,
+            fieldLabels,
+            dataProviderDescriptors,
+            calendarAdapterDescriptors,
+            videoProviderDescriptors,
+            onChange: (next) => {
+                const patch = buildPhiInspectorConfigPathPatch(currentWidgetSettingsConfigRecord, next);
+                onConfigChange?.(patch);
+            },
+        });
+    };
     const geometryValue = {
         sticky: false,
         offsetTop: 0,
@@ -51,24 +98,15 @@ export function PhiDeveloperBuilderWidgetInspectorWidgetClient({ section, builde
                     {
                         key: "settings",
                         title: "Settings",
-                        children: selectedStructureWidgetMeta == null ? (_jsxs(PhiTypographyControl, { type: "danger", children: ["Widget metadata for ", selectedStructureNodeKey ?? selectedStructureNodeTitle ?? "this widget", " is not available from the active Canvas modules."] })) : settingsFields.length === 0 ? (_jsx(PhiTypographyControl, { type: "secondary", children: "This widget does not declare configurable settings." })) : (_jsxs("div", { style: { display: "grid", gap: PHI_GAP_SM, width: "100%" }, children: [settingsFields.map((field) => renderPhiInspectorConfigField({
-                                    field,
-                                    value: readPhiInspectorConfigPathValue(currentWidgetSettingsConfigRecord, field.key),
-                                    defaultValue: readPhiInspectorConfigPathValue(widgetDefaultConfigRecord, field.key),
-                                    config: currentWidgetSettingsConfigRecord,
-                                    defaultConfig: widgetDefaultConfigRecord,
-                                    disabled: isPreviewMode,
-                                    widgetReferenceOptions,
-                                    colorPickerLabels,
-                                    iconPickerLabels,
-                                    dataProviderDescriptors,
-                                    calendarAdapterDescriptors,
-                                    videoProviderDescriptors,
-                                    onChange: (next) => {
-                                        const patch = buildPhiInspectorConfigPathPatch(currentWidgetSettingsConfigRecord, next);
-                                        onConfigChange?.(patch);
-                                    },
-                                })), selectedStructureWidgetMeta.translatesOwnText ? (_jsx(PhiSwitchControl, { label: "Translate text", checked: !hasPhiFlag(currentDraft?.flags ?? 0, PhiCmsFlags.NoTranslate), disabled: isPreviewMode, onChange: onTranslateChange })) : null] })),
+                        children: selectedStructureWidgetMeta == null ? (_jsxs(PhiTypographyControl, { type: "danger", children: ["Widget metadata for ", selectedStructureNodeKey ?? selectedStructureNodeTitle ?? "this widget", " is not available from the active Canvas modules."] })) : settingsFields.length === 0 ? (_jsx(PhiTypographyControl, { type: "secondary", children: "This widget does not declare configurable settings." })) : (_jsxs("div", { style: { display: "grid", gap: PHI_GAP_SM, width: "100%" }, children: [settingsFields.slice(0, firstHeadedFieldIndex).map(renderSettingsField), selectedStructureWidgetMeta.translatesOwnText
+                                    ? renderPhiInspectorSwitchRow({
+                                        key: "translate-text",
+                                        label: "Translate text",
+                                        checked: !hasPhiFlag(currentDraft?.flags ?? 0, PhiCmsFlags.NoTranslate),
+                                        disabled: isPreviewMode,
+                                        ...(onTranslateChange ? { onChange: onTranslateChange } : {}),
+                                    })
+                                    : null, settingsFields.slice(firstHeadedFieldIndex).map(renderSettingsField)] })),
                     },
                     {
                         key: "geometry",
@@ -83,6 +121,11 @@ export function PhiDeveloperBuilderWidgetInspectorWidgetClient({ section, builde
                                 viewportFlags,
                             }) })),
                     },
+                    {
+                        key: "surface",
+                        title: surfaceLabels?.section ?? "Surface",
+                        children: (_jsx(PhiSurfaceControl, { disabled: isPreviewMode, value: currentBlockConfig.surface ?? null, onChange: (surface) => onSurfaceChange?.(surface), labels: surfaceLabels?.parts, backgroundLabels: backgroundLabels, borderLabels: borderLabels, colorPickerLabels: colorPickerLabels, renderMediaPicker: renderMediaPicker })),
+                    },
                     {
                         key: "signals",
                         title: signalsLabels?.title ?? "Signals",

package/plugins/runtime-modules/builder/clients/workspace-scope-boundary.js

@@ -4,10 +4,20 @@ import { PhiBuilderWorkspacePreviewSkeleton } from "../../../../components/widge
 import { usePhiDeveloperBuilderStateValue, } from "../developer-workspace-store";
 import { PhiSignalRuntimePartitionProvider } from "../../../../components/runtime/runtime-signal-partition";
 import { PhiBuilderCanvasRegionOverrides } from "./builder-region-overrides";
+import { usePhiSignalIdentity } from "../../../../components/runtime/runtime-signal-identity";
+import { usePhiVisualAnchorParts } from "../../../../components/runtime/runtime-visual-anchors";
+import { PHI_BUILDER_PAGE_REGION_KEYS, PHI_BUILDER_SHELL_REGION_KEYS } from "../region-keys";
 export function PhiBuilderWorkspaceScopeBoundary({ kind, targetArea, targetPageKey, children, }) {
     const activeArea = usePhiDeveloperBuilderStateValue("public", (state) => state.area);
     const activePageKey = usePhiDeveloperBuilderStateValue("public", (state) => state.pageKey);
     const scopeMatches = activeArea === targetArea &&
         (targetPageKey == null || activePageKey === targetPageKey);
+    /*
+     * Each Region on the canvas, offered to a Tour as `cms:<workspace>:<regionKey>`. Registered here, on
+     * this side of the canvas partition: the Tour looks in the Page's partition, and the canvas below runs
+     * in an isolated one of its own.
+     */
+    const signalIdentity = usePhiSignalIdentity();
+    usePhiVisualAnchorParts(signalIdentity.receiver?.startsWith("cms:") ? signalIdentity.receiver : null, kind === "shells" ? PHI_BUILDER_SHELL_REGION_KEYS : PHI_BUILDER_PAGE_REGION_KEYS);
     return scopeMatches ? (_jsx(PhiSignalRuntimePartitionProvider, { id: `canvas:${kind}:${targetArea}:${targetPageKey ?? "area"}`, kind: "canvas", context: { area: targetArea, pageKey: targetPageKey ?? null }, isolated: true, children: _jsx(PhiBuilderCanvasRegionOverrides, { children: children }) })) : _jsx(PhiBuilderWorkspacePreviewSkeleton, { kind: kind });
 }

package/plugins/runtime-modules/builder/cms-instance-allocator.d.ts

@@ -1,7 +1,6 @@
 import { type PhiCmsInstanceId } from "../../../types/cms-instance-id";
 import type { PhiDeveloperBuilderArea } from "./developer-workspace-types";
 import type { PhiBuilderPluginMeta } from "../../../types/builder";
-export declare function getPhiBuilderDraftAllocationKey(area: PhiDeveloperBuilderArea, pageKey: string, regionKey: string): string;
 export declare function allocatePhiBuilderCmsInstanceId(input: {
     area: PhiDeveloperBuilderArea;
     pageKey: string;

package/plugins/runtime-modules/builder/cms-instance-allocator.js

@@ -6,7 +6,7 @@ import { builderWorkspaceStore, getPhiDeveloperBuilderStateSnapshot, getPhiDevel
 import { createPhiBuilderDraftAllocationKey } from "./draft-allocation-key";
 import { resolvePhiBuilderActivePageCatalog } from "../../../helpers/cms-page-catalog";
 const pendingDraftCreations = new Map();
-export function getPhiBuilderDraftAllocationKey(area, pageKey, regionKey) {
+function getPhiBuilderDraftAllocationKey(area, pageKey, regionKey) {
     return createPhiBuilderDraftAllocationKey(area, pageKey, isPhiBuilderPageScopedRegion(regionKey) ? "page" : "area");
 }
 async function ensurePhiBuilderDraftAllocation(input) {

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

@@ -1,6 +1,6 @@
 import { type PhiBuilderRuntimeControllerConfig, type PhiBuilderRuntimeControllerPreload } from "./definition";
 export declare const PHI_BUILDER_RUNTIME_CONTROLLER_PLUGIN: {
-    renderController: ({ preloadData }: import("../../../../types").PhiRuntimeControllerRenderArgs<PhiBuilderRuntimeControllerConfig, PhiBuilderRuntimeControllerPreload>) => import("react").FunctionComponentElement<import("../workspace-controller").PhiDeveloperBuilderWorkspaceControllerProps>;
+    renderController: ({ preloadData, config }: import("../../../../types").PhiRuntimeControllerRenderArgs<PhiBuilderRuntimeControllerConfig, PhiBuilderRuntimeControllerPreload>) => import("react").FunctionComponentElement<import("./workspace-controller").PhiDeveloperBuilderWorkspaceControllerProps>;
     kind: "controller";
     pluginKey: string;
     key: string;
@@ -25,6 +25,14 @@ export declare const PHI_BUILDER_RUNTIME_CONTROLLER_PLUGIN: {
             action: "stop";
             valueType: "json";
             valueSchema: `${string}/signals/${string}`;
+        } | {
+            id: string;
+            action: "activate";
+            valueType: "none";
+        } | {
+            id: string;
+            action: "close";
+            valueType: "none";
         } | {
             id: string;
             action: "change";
@@ -40,11 +48,6 @@ export declare const PHI_BUILDER_RUNTIME_CONTROLLER_PLUGIN: {
             action: "change";
             valueType: "boolean";
             valueSchema?: undefined;
-        } | {
-            id: string;
-            action: "close";
-            valueType: "none";
-            valueSchema?: undefined;
         } | {
             id: string;
             action: "drop";
@@ -52,12 +55,6 @@ export declare const PHI_BUILDER_RUNTIME_CONTROLLER_PLUGIN: {
             valueSchema: `${string}/signals/${string}`;
         })[];
         listens: ({
-            id: string;
-            channel: string;
-            action: "change";
-            valueType: "json";
-            valueSchema: `${string}/signals/${string}`;
-        } | {
             id: string;
             channel: string;
             action: "activate";
@@ -75,6 +72,12 @@ export declare const PHI_BUILDER_RUNTIME_CONTROLLER_PLUGIN: {
             action: "change";
             valueType: "string";
             valueSchema?: undefined;
+        } | {
+            id: string;
+            channel: string;
+            action: "change";
+            valueType: "json";
+            valueSchema: `${string}/signals/${string}`;
         } | {
             id: string;
             channel: string;
@@ -105,9 +108,23 @@ export declare const PHI_BUILDER_RUNTIME_CONTROLLER_PLUGIN: {
             action: "close";
             valueType: "none";
             valueSchema?: undefined;
+        } | {
+            id: string;
+            channel: string;
+            action: "close";
+            valueType: "json";
+            valueSchema: `${string}/signals/${string}`;
+        } | {
+            id: string;
+            channel: string;
+            action: "activate";
+            valueType: "json";
+            valueSchema: `${string}/signals/${string}`;
         })[];
     };
-    defaultConfig: {};
-    parseConfig: typeof import("./definition").parsePhiBuilderRuntimeControllerConfig;
+    defaultConfig: {
+        signalRoutes: null;
+    };
+    parseConfig: (raw: Record<string, unknown>) => PhiBuilderRuntimeControllerConfig;
 };
 export declare const PhiBuilderRuntimeControllerClient: (props: import("../../contracts").PhiRuntimeModuleControllerClientProps) => import("react").JSX.Element;

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

@@ -5,7 +5,7 @@ import { PhiDeveloperBuilderWorkspaceControllerMount } from "./mount";
 import { PHI_BUILDER_RUNTIME_CONTROLLER_DEFINITION, } from "./definition";
 export const PHI_BUILDER_RUNTIME_CONTROLLER_PLUGIN = {
     ...PHI_BUILDER_RUNTIME_CONTROLLER_DEFINITION,
-    renderController: ({ preloadData }) => {
+    renderController: ({ preloadData, config }) => {
         if (!preloadData?.shellPresetDraftsByArea ||
             !preloadData.runtimeModuleDefinitions ||
             !preloadData.runtimeModuleIdsByArea ||
@@ -13,14 +13,18 @@ export const PHI_BUILDER_RUNTIME_CONTROLLER_PLUGIN = {
             !preloadData.areaPresetSourcesByArea ||
             !preloadData.navigationSurfacesByArea ||
             !preloadData.unresolvedModuleIdsByArea ||
+            !preloadData.serverUnavailableModules ||
             !preloadData.publicRouteClaims ||
             !preloadData.publicRoutePaths ||
             !preloadData.areaRootRoutesByArea ||
             !preloadData.areaMetaByArea ||
-            !preloadData.pageMetaLabels) {
+            !preloadData.areaControllerSettingsByArea ||
+            !preloadData.pageMetaLabels ||
+            !preloadData.historyLabels) {
             throw new Error("Builder runtime controller requires server preload data.");
         }
         return createElement(PhiDeveloperBuilderWorkspaceControllerMount, {
+            signalRoutes: config.signalRoutes,
             shellPresetDraftsByArea: preloadData.shellPresetDraftsByArea,
             runtimeModuleDefinitions: preloadData.runtimeModuleDefinitions,
             runtimeModuleIdsByArea: preloadData.runtimeModuleIdsByArea,
@@ -28,11 +32,14 @@ export const PHI_BUILDER_RUNTIME_CONTROLLER_PLUGIN = {
             areaPresetSourcesByArea: preloadData.areaPresetSourcesByArea,
             navigationSurfacesByArea: preloadData.navigationSurfacesByArea,
             unresolvedModuleIdsByArea: preloadData.unresolvedModuleIdsByArea,
+            serverUnavailableModules: preloadData.serverUnavailableModules,
             publicRouteClaims: preloadData.publicRouteClaims,
             publicRoutePaths: preloadData.publicRoutePaths,
             areaRootRoutesByArea: preloadData.areaRootRoutesByArea,
             areaMetaByArea: preloadData.areaMetaByArea,
+            areaControllerSettingsByArea: preloadData.areaControllerSettingsByArea,
             pageMetaLabels: preloadData.pageMetaLabels,
+            historyLabels: preloadData.historyLabels,
         });
     },
 };

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

@@ -1,3 +1,4 @@
+import { type PhiSignalRouteSet } from "../../../../types/signals";
 import type { PhiRuntimeModuleDefinition, PhiRuntimeModuleId } from "../../../../types/cms-plugins";
 import type { PhiDeveloperBuilderRegionDraft } from "../developer-workspace-types";
 import type { PhiBuilderModulePresetPagesByArea } from "../../../../helpers/cms-page-catalog";
@@ -5,7 +6,24 @@ import type { PhiAreaRootRoute, PhiAreaMeta, PhiPublicRoutePathAssignment } from
 import type { PhiPublicRouteClaim } from "../../../../helpers/public-route-claims";
 import type { PhiBuilderAreaKey } from "../../../../constants/cms-areas";
 import type { PhiCmsPresetSource, PhiCmsResolvedNavigationSurface } from "../../../../types/cms-module-descriptors";
-export type PhiBuilderRuntimeControllerConfig = Record<string, never>;
+import type { PhiCmsTreeControllerSettings } from "../../../../types/cms";
+import type { PhiWorkspaceCatalogState } from "../../../../components/workspace/catalog-state";
+import type { PhiHistoryLabels } from "../../../../components/widgets/label-types/history";
+/**
+ * Whom the Builder Controller answers into, from the trees that hold the receivers.
+ *
+ * The Inspector Overlay contribution routes its drawers, the Effects editor and the wiring dialog; the
+ * Builder Shell its Area selector and debug switch; each Builder Page the dialogs it carries -- Area
+ * settings, Page metadata, the Modules page's three. The composed Area tree joins the first two, and
+ * the shown Page's routes join them while it is shown (`mergePhiRuntimeControllerConfigOverlay`).
+ */
+export type PhiBuilderRuntimeControllerConfig = {
+    signalRoutes: PhiSignalRouteSet | null;
+};
+/** The three Effects Forms, each with its own values, submit and reset. */
+export declare const PHI_BUILDER_EFFECTS_CAPABILITY_SECTIONS: readonly ["appearance", "transitions", "viewport"];
+export type PhiBuilderEffectsCapabilitySection = (typeof PHI_BUILDER_EFFECTS_CAPABILITY_SECTIONS)[number];
+export declare function resolvePhiBuilderEffectsCapabilityId(section: PhiBuilderEffectsCapabilitySection, kind: "Values" | "Submit" | "Reset"): string;
 export type PhiBuilderPageMetaPresentationLabels = {
     createTitle: string;
     updateTitle: string;
@@ -18,16 +36,19 @@ export type PhiBuilderRuntimeControllerPreload = {
     runtimeModuleDefinitions: PhiRuntimeModuleDefinition[];
     runtimeModuleIdsByArea: Record<string, PhiRuntimeModuleId[]>;
     unresolvedModuleIdsByArea: Record<string, PhiRuntimeModuleId[]>;
+    serverUnavailableModules: PhiWorkspaceCatalogState["serverUnavailableModules"];
     publicRouteClaims: readonly PhiPublicRouteClaim[];
     publicRoutePaths: readonly PhiPublicRoutePathAssignment[];
     areaRootRoutesByArea: Record<string, PhiAreaRootRoute | null>;
     areaMetaByArea: Record<string, PhiAreaMeta | null>;
+    areaControllerSettingsByArea: Record<string, PhiCmsTreeControllerSettings>;
     modulePresetPagesByArea: PhiBuilderModulePresetPagesByArea;
     areaPresetSourcesByArea: Partial<Record<PhiBuilderAreaKey, PhiCmsPresetSource>>;
     navigationSurfacesByArea: Partial<Record<PhiBuilderAreaKey, readonly PhiCmsResolvedNavigationSurface[]>>;
     pageMetaLabels: PhiBuilderPageMetaPresentationLabels;
+    historyLabels: PhiHistoryLabels;
 };
-export declare function parsePhiBuilderRuntimeControllerConfig(): PhiBuilderRuntimeControllerConfig;
+declare function parsePhiBuilderRuntimeControllerConfig(raw: Record<string, unknown>): PhiBuilderRuntimeControllerConfig;
 export declare const PHI_BUILDER_RUNTIME_CONTROLLER_DEFINITION: {
     kind: "controller";
     pluginKey: string;
@@ -53,6 +74,14 @@ export declare const PHI_BUILDER_RUNTIME_CONTROLLER_DEFINITION: {
             action: "stop";
             valueType: "json";
             valueSchema: `${string}/signals/${string}`;
+        } | {
+            id: string;
+            action: "activate";
+            valueType: "none";
+        } | {
+            id: string;
+            action: "close";
+            valueType: "none";
         } | {
             id: string;
             action: "change";
@@ -68,11 +97,6 @@ export declare const PHI_BUILDER_RUNTIME_CONTROLLER_DEFINITION: {
             action: "change";
             valueType: "boolean";
             valueSchema?: undefined;
-        } | {
-            id: string;
-            action: "close";
-            valueType: "none";
-            valueSchema?: undefined;
         } | {
             id: string;
             action: "drop";
@@ -80,12 +104,6 @@ export declare const PHI_BUILDER_RUNTIME_CONTROLLER_DEFINITION: {
             valueSchema: `${string}/signals/${string}`;
         })[];
         listens: ({
-            id: string;
-            channel: string;
-            action: "change";
-            valueType: "json";
-            valueSchema: `${string}/signals/${string}`;
-        } | {
             id: string;
             channel: string;
             action: "activate";
@@ -103,6 +121,12 @@ export declare const PHI_BUILDER_RUNTIME_CONTROLLER_DEFINITION: {
             action: "change";
             valueType: "string";
             valueSchema?: undefined;
+        } | {
+            id: string;
+            channel: string;
+            action: "change";
+            valueType: "json";
+            valueSchema: `${string}/signals/${string}`;
         } | {
             id: string;
             channel: string;
@@ -133,8 +157,23 @@ export declare const PHI_BUILDER_RUNTIME_CONTROLLER_DEFINITION: {
             action: "close";
             valueType: "none";
             valueSchema?: undefined;
+        } | {
+            id: string;
+            channel: string;
+            action: "close";
+            valueType: "json";
+            valueSchema: `${string}/signals/${string}`;
+        } | {
+            id: string;
+            channel: string;
+            action: "activate";
+            valueType: "json";
+            valueSchema: `${string}/signals/${string}`;
         })[];
     };
-    defaultConfig: {};
+    defaultConfig: {
+        signalRoutes: null;
+    };
     parseConfig: typeof parsePhiBuilderRuntimeControllerConfig;
 };
+export {};