@phis/ui 0.2.1 → 0.4.0

package/plugins/runtime-modules/editor/trees/editor-releases-label-set.js

@@ -0,0 +1,54 @@
+import "server-only";
+import { PHI_TR_CTX_WEB_UI_LABEL } from "../../../../gateway/tr";
+import { definePhiRuntimeModuleLabelSet, definePhiMessageLabel, getPhiLabelSet } from "../../../../gateway/label-set";
+import { PHI_EDITOR_RUNTIME_MODULE_IDENTITY } from "../ids";
+/** What the Releases page in the Editor says: its frame, the Table's columns and footer, and its two acts. */
+const PHI_EDITOR_RELEASES_PAGE_LABEL_SET = definePhiRuntimeModuleLabelSet(PHI_EDITOR_RUNTIME_MODULE_IDENTITY, {
+    key: "preset:editor-releases-page",
+    ctx: PHI_TR_CTX_WEB_UI_LABEL,
+    labels: {
+        widget_label: "releases",
+        column_kind: "Kind",
+        column_what: "What",
+        column_where: "Where",
+        column_by: "By",
+        column_at: "When",
+        footer: "%1 waiting for publication",
+        kind_content: "Content",
+        kind_entry: "Entry",
+        kind_page: "Page",
+        kind_area: "Area",
+        action_publish: "Publish",
+        action_reject: "Send back",
+        publish_title: "Publish this",
+        publish_description: definePhiMessageLabel("What was submitted goes live now. Content is published apart from the Page that shows it."),
+        reject_title: "Send this back",
+        reject_description: definePhiMessageLabel("The submission is withdrawn and nothing is published. The words stay as they were written."),
+        empty_title: definePhiMessageLabel("Nothing waits for publication."),
+        empty_text: definePhiMessageLabel("Submitted content and Page drafts appear here."),
+    },
+});
+export async function getPhiEditorReleasesPageLabels(options) {
+    const labels = await getPhiLabelSet(options, PHI_EDITOR_RELEASES_PAGE_LABEL_SET);
+    return {
+        widgetLabel: labels.widget_label,
+        columns: {
+            kind: labels.column_kind,
+            what: labels.column_what,
+            where: labels.column_where,
+            by: labels.column_by,
+            at: labels.column_at,
+        },
+        footer: labels.footer,
+        kinds: {
+            content: labels.kind_content,
+            entry: labels.kind_entry,
+            page: labels.kind_page,
+            area: labels.kind_area,
+        },
+        actions: { publish: labels.action_publish, reject: labels.action_reject },
+        publish: { title: labels.publish_title, description: labels.publish_description },
+        reject: { title: labels.reject_title, description: labels.reject_description },
+        empty: { title: labels.empty_title, text: labels.empty_text },
+    };
+}

package/plugins/runtime-modules/editor/trees/phi-default-editor-area-preset-tree.js

@@ -1,18 +1,10 @@
 import { createPhiPresetCmsInstanceIdMap } from "../../../../types/cms-instance-id";
 import { PHI_EDITOR_RUNTIME_MODULE_ID } from "../ids";
-import { PHI_CMS_DEFAULT_SLOT_INDEX, PHI_CMS_SEQUENTIAL_LAYOUT_SLOTS, PHI_CMS_THREE_COLUMN_LAYOUT_SLOT_INDEX, } from "../../../../constants/cms-layout-types";
-import { PhiCmsRegionType } from "../../../../constants/phi-cms";
 import { createPhiCmsPresetNodes } from "../../../../helpers/cms-preset-nodes";
-import { buildPhiHeaderTopActionsLayoutNode } from "../../../../components/regions/presets/phi-header-top-actions-layout";
-import { resolvePhiShellHeaderHeight, resolvePhiShellMetric } from "../../../../helpers/shell-region-style";
-import { PHI_LAYOUT } from "../../../../theme/phi-tokens";
-import { PHI_SPACE } from "../../../../theme/antd-css-var-contract";
-import { getPhiEditorAreaLabels } from "./editor-label-set";
+import { buildPhiAreaShellHeaderNodes, buildPhiAreaShellSiderLeftNodes, concatPhiAreaShellPresetNodes, } from "../../../../components/regions/presets/phi-area-shell-preset-nodes";
 import { createPhiDefaultAreaRuntimeModuleIds } from "../../area-module-defaults";
-import { readPhiServerApiCredentials } from "../../../../helpers/phis-server-credentials";
 const SYNTHETIC_EDITOR_REGION_IDS = {
     regionHeaderTop: -140,
-    regionHeaderMain: -141,
     regionSiderLeft: -150,
 };
 const SYNTHETIC_EDITOR_LAYOUT_IDS = createPhiPresetCmsInstanceIdMap({
@@ -22,7 +14,6 @@ const SYNTHETIC_EDITOR_LAYOUT_IDS = createPhiPresetCmsInstanceIdMap({
 }, [
     "layoutHeaderTop",
     "layoutHeaderTopActions",
-    "layoutHeaderMain",
     "layoutSiderLeft",
 ]);
 const SYNTHETIC_EDITOR_WIDGET_IDS = createPhiPresetCmsInstanceIdMap({
@@ -30,184 +21,25 @@ const SYNTHETIC_EDITOR_WIDGET_IDS = createPhiPresetCmsInstanceIdMap({
     ownerModuleId: PHI_EDITOR_RUNTIME_MODULE_ID,
     presetKey: "editor-area-preset",
 }, [
-    "widgetHeaderMainPageTitle",
+    "widgetHeaderTopPageTitle",
+    "widgetHeaderTopTourButton",
     "widgetHeaderTopAccount",
     "widgetSiderLeftNav",
 ]);
 export async function buildPhiDefaultEditorAreaPresetTree({ page, runtime, }) {
-    const labels = await getPhiEditorAreaLabels({
-        apiBaseUrl: readPhiServerApiCredentials().apiBaseUrl,
-        internalToken: readPhiServerApiCredentials().internalToken,
-        locale: runtime.locale.current,
-    });
-    const shellSiderLeftOffsetTop = resolvePhiShellMetric(runtime.site.theme?.shell, "offsetTop", {
-        family: "sider",
-        region: "left",
-    });
-    const shellHeaderMainOffsetTop = resolvePhiShellMetric(runtime.site.theme?.shell, "offsetTop", {
-        family: "header",
-        region: "main",
-    });
-    const shellSiderLeftWidth = resolvePhiShellMetric(runtime.site.theme?.shell, "width", {
-        family: "sider",
-        region: "left",
-    });
-    const resolvedShellLeftWidth = shellSiderLeftWidth ?? PHI_LAYOUT.sidebarWidth;
     const nodes = createPhiCmsPresetNodes(page);
+    const ids = { ...SYNTHETIC_EDITOR_REGION_IDS, ...SYNTHETIC_EDITOR_LAYOUT_IDS, ...SYNTHETIC_EDITOR_WIDGET_IDS };
     return {
         page,
         runtimeModuleIds: createPhiDefaultAreaRuntimeModuleIds("editor"),
         overlays: [],
-        regions: [
-            nodes.region({
-                id: SYNTHETIC_EDITOR_REGION_IDS.regionHeaderTop,
-                regionType: PhiCmsRegionType.HeaderTop,
-                rootLayoutNodeId: SYNTHETIC_EDITOR_LAYOUT_IDS.layoutHeaderTop,
-                sortOrder: 10,
-                // Structure only: the frame's look is the Theme's (SHELL.md, Shell Chrome Overlay).
-                config: {
-                    sticky: false,
-                    size: { height: `${resolvePhiShellHeaderHeight(runtime.site.theme?.shell, "top")}px` },
-                },
-            }),
-            nodes.region({
-                id: SYNTHETIC_EDITOR_REGION_IDS.regionHeaderMain,
-                regionType: PhiCmsRegionType.HeaderMain,
-                rootLayoutNodeId: SYNTHETIC_EDITOR_LAYOUT_IDS.layoutHeaderMain,
-                sortOrder: 20,
-                config: {
-                    sticky: true,
-                    size: { height: `${resolvePhiShellHeaderHeight(runtime.site.theme?.shell, "main")}px` },
-                    offsetTop: typeof shellHeaderMainOffsetTop === "number" ? shellHeaderMainOffsetTop : 0,
-                },
-            }),
-            nodes.region({
-                id: SYNTHETIC_EDITOR_REGION_IDS.regionSiderLeft,
-                regionType: PhiCmsRegionType.SiderLeft,
-                rootLayoutNodeId: SYNTHETIC_EDITOR_LAYOUT_IDS.layoutSiderLeft,
-                sortOrder: 25,
-                config: {
-                    sticky: true,
-                    fullHeight: true,
-                    size: { width: `${resolvedShellLeftWidth}px` },
-                    ...(typeof shellSiderLeftOffsetTop === "number" ? { offsetTop: shellSiderLeftOffsetTop } : { offsetTop: 0 }),
-                    collapsible: true,
-                },
-            }),
-        ],
-        layoutNodes: [
-            nodes.layout({
-                creationPreset: { layoutKind: "threecol", preset: "panel" },
-                typeKey: "three-column",
-                id: SYNTHETIC_EDITOR_LAYOUT_IDS.layoutHeaderMain,
-                parentLayoutNodeId: null,
-                slotIndex: PHI_CMS_DEFAULT_SLOT_INDEX,
-                sortOrder: 0,
-                label: "editor header main three column",
-                config: {
-                    balancedSides: true,
-                    contentAlign: "center",
-                    style: { height: "100%" },
-                },
-            }),
-            nodes.layout({
-                creationPreset: { layoutKind: "threecol", preset: "panel" },
-                typeKey: "three-column",
-                id: SYNTHETIC_EDITOR_LAYOUT_IDS.layoutHeaderTop,
-                parentLayoutNodeId: null,
-                slotIndex: PHI_CMS_DEFAULT_SLOT_INDEX,
-                sortOrder: 0,
-                label: "editor header top three column",
-                config: {
-                    balancedSides: true,
-                    contentAlign: "center",
-                    paddingLeft: PHI_SPACE.base,
-                    paddingRight: PHI_SPACE.base,
-                    style: { height: "100%" },
-                },
-            }),
-            buildPhiHeaderTopActionsLayoutNode(nodes, {
-                id: SYNTHETIC_EDITOR_LAYOUT_IDS.layoutHeaderTopActions,
-                parentLayoutNodeId: SYNTHETIC_EDITOR_LAYOUT_IDS.layoutHeaderTop,
-                label: "editor header top actions",
-            }),
-            nodes.layout({
-                creationPreset: { layoutKind: "verticalflex", preset: "panel" },
-                typeKey: "flex-vertical",
-                id: SYNTHETIC_EDITOR_LAYOUT_IDS.layoutSiderLeft,
-                parentLayoutNodeId: null,
-                slotIndex: PHI_CMS_DEFAULT_SLOT_INDEX,
-                sortOrder: 0,
-                label: "editor sider left stack",
-                config: {
-                    anchor: {
-                        horizontal: "center",
-                        vertical: "top",
-                    },
-                    gap: 0,
-                    padding: PHI_SPACE.xs,
-                    paddingTop: 0,
-                },
-            }),
-        ],
-        contentWidgets: [
-            nodes.widget({
-                typeKey: "page-title",
-                id: SYNTHETIC_EDITOR_WIDGET_IDS.widgetHeaderMainPageTitle,
-                parentLayoutNodeId: SYNTHETIC_EDITOR_LAYOUT_IDS.layoutHeaderMain,
-                slotIndex: PHI_CMS_THREE_COLUMN_LAYOUT_SLOT_INDEX.Middle,
-                sortOrder: 0,
-                label: "Page title",
-                config: {},
-            }),
-            nodes.widget({
-                typeKey: "account",
-                id: SYNTHETIC_EDITOR_WIDGET_IDS.widgetHeaderTopAccount,
-                parentLayoutNodeId: SYNTHETIC_EDITOR_LAYOUT_IDS.layoutHeaderTopActions,
-                slotIndex: PHI_CMS_SEQUENTIAL_LAYOUT_SLOTS[2].slotIndex,
-                sortOrder: 20,
-                label: "editor account",
-                config: {},
-            }),
-            nodes.widget({
-                typeKey: "sidebar-navigation",
-                id: SYNTHETIC_EDITOR_WIDGET_IDS.widgetSiderLeftNav,
-                parentLayoutNodeId: SYNTHETIC_EDITOR_LAYOUT_IDS.layoutSiderLeft,
-                slotIndex: PHI_CMS_DEFAULT_SLOT_INDEX,
-                sortOrder: 0,
-                label: "editor sider left navigation",
-                config: {
-                    side: "left",
-                    width: resolvedShellLeftWidth,
-                    navKey: "editor:sidebar",
-                    items: [
-                        {
-                            key: "editor-dashboard",
-                            label: labels.dashboard,
-                            href: "/",
-                            icon: "antd:dashboard",
-                        },
-                        {
-                            key: "editor-text",
-                            label: labels.text,
-                            href: "/text",
-                            icon: "antd:file-text",
-                        },
-                        {
-                            key: "editor-translations",
-                            label: labels.translations,
-                            href: "/translations",
-                            icon: "antd:translation",
-                        },
-                        {
-                            key: "editor-profile",
-                            label: labels.profile,
-                            href: "/profile",
-                            icon: "antd:user",
-                        },
-                    ],
-                },
-            }),
-        ],
+        ...concatPhiAreaShellPresetNodes(buildPhiAreaShellHeaderNodes({ nodes, runtime, labelPrefix: "editor", ids }), buildPhiAreaShellSiderLeftNodes({
+            nodes,
+            runtime,
+            labelPrefix: "editor",
+            // The entries come from the navigation behind `navKey`, as in every other Area.
+            navKey: "editor:sidebar",
+            ids,
+        })),
     };
 }

package/plugins/runtime-modules/editor/trees/phi-default-editor-releases-page-tree.d.ts

@@ -0,0 +1,13 @@
+import type { PhiCmsPageNode, PhiResolvedCmsPageTree } from "../../../../types/cms";
+import type { PhiBlockRuntime } from "../../../../types";
+/**
+ * The Publisher's queue (phis-server CONTENT.md, Submission).
+ *
+ * Everybody who edits sees it -- an Author sees what they submitted waiting -- and only a Publisher is
+ * offered the two acts: the page offers each viewer what is theirs rather than buttons that answer 403,
+ * and Core refuses the acts to anybody else regardless.
+ */
+export declare function buildPhiDefaultEditorReleasesPageTree({ page, runtime, }: {
+    page: PhiCmsPageNode;
+    runtime: PhiBlockRuntime;
+}): Promise<PhiResolvedCmsPageTree>;

package/plugins/runtime-modules/editor/trees/phi-default-editor-releases-page-tree.js

@@ -0,0 +1,134 @@
+import { PHI_CMS_SEQUENTIAL_LAYOUT_SLOTS } from "../../../../constants/cms-layout-types";
+import { PhiCmsPageType } from "../../../../constants/phi-cms";
+import { createPhiCmsPresetNodes } from "../../../../helpers/cms-preset-nodes";
+import { readPhiServerApiCredentials } from "../../../../helpers/phis-server-credentials";
+import { canPhiViewerAccess, PHI_VIEWER_ACCESS_PUBLISHING } from "../../../../types/access";
+import { buildPhiBasePageContentScaffold, PHI_BASE_PAGE_LAYOUT_NODE_ID, } from "../../../../components/regions/presets/phi-base-page-layout";
+import { PHI_EDITOR_RELEASES_DATA_PROVIDER_KEY, PHI_EDITOR_RELEASES_RESOURCE_KEY, PHI_EDITOR_RELEASES_WIDGET_ID, } from "../ids";
+import { getPhiEditorReleasesPageLabels } from "./editor-releases-label-set";
+const SYNTHETIC_EDITOR_RELEASES_REGION_IDS = { regionContent: -563 };
+/**
+ * The Publisher's queue (phis-server CONTENT.md, Submission).
+ *
+ * Everybody who edits sees it -- an Author sees what they submitted waiting -- and only a Publisher is
+ * offered the two acts: the page offers each viewer what is theirs rather than buttons that answer 403,
+ * and Core refuses the acts to anybody else regardless.
+ */
+export async function buildPhiDefaultEditorReleasesPageTree({ page, runtime, }) {
+    const credentials = readPhiServerApiCredentials();
+    const labels = await getPhiEditorReleasesPageLabels({
+        apiBaseUrl: credentials.apiBaseUrl,
+        internalToken: credentials.internalToken,
+        locale: runtime.locale.current,
+    });
+    const rowActions = canPhiViewerAccess(runtime.viewer, PHI_VIEWER_ACCESS_PUBLISHING)
+        ? [
+            {
+                key: "publish",
+                label: labels.actions.publish,
+                icon: "antd:cloud-upload",
+                display: "icon",
+                execution: "provider",
+                // An Area's draft names a Shell preset the queue does not carry; the Builder publishes it.
+                disabledWhen: { source: "row", valuePath: "publishable", operator: "falsy" },
+                confirm: {
+                    title: labels.publish.title,
+                    description: labels.publish.description,
+                    okText: labels.actions.publish,
+                },
+            },
+            {
+                key: "reject",
+                label: labels.actions.reject,
+                icon: "antd:undo",
+                display: "icon",
+                execution: "provider",
+                // A Page draft has no submission to send back: the Builder's draft is the request.
+                disabledWhen: { source: "row", valuePath: "rejectable", operator: "falsy" },
+                confirm: {
+                    title: labels.reject.title,
+                    description: labels.reject.description,
+                    okText: labels.actions.reject,
+                },
+            },
+        ]
+        : [];
+    const scaffold = buildPhiBasePageContentScaffold({
+        page,
+        regionId: SYNTHETIC_EDITOR_RELEASES_REGION_IDS.regionContent,
+    });
+    const nodes = createPhiCmsPresetNodes(page);
+    return {
+        page: nodes.page({ pageType: PhiCmsPageType.Standard }),
+        overlays: [],
+        regions: [scaffold.region],
+        layoutNodes: [scaffold.layoutNode],
+        contentWidgets: [
+            nodes.widget({
+                id: PHI_EDITOR_RELEASES_WIDGET_ID,
+                parentLayoutNodeId: PHI_BASE_PAGE_LAYOUT_NODE_ID,
+                typeKey: "table",
+                slotIndex: PHI_CMS_SEQUENTIAL_LAYOUT_SLOTS[1].slotIndex,
+                sortOrder: 10,
+                label: labels.widgetLabel,
+                config: {
+                    source: {
+                        providerKey: PHI_EDITOR_RELEASES_DATA_PROVIDER_KEY,
+                        resourceKey: PHI_EDITOR_RELEASES_RESOURCE_KEY,
+                    },
+                    presentation: {
+                        layout: { mode: "auto", overflowX: "auto" },
+                        columns: [
+                            {
+                                key: "kind",
+                                fieldKey: "kind",
+                                title: labels.columns.kind,
+                                renderer: "badge",
+                                valueMap: labels.kinds,
+                                sizing: { mode: "content", minWidth: 104 },
+                            },
+                            {
+                                key: "what",
+                                fieldKey: "what",
+                                title: labels.columns.what,
+                                sizing: { mode: "fill", minWidth: 280 },
+                            },
+                            {
+                                key: "where",
+                                fieldKey: "where",
+                                title: labels.columns.where,
+                                sizing: { mode: "content", minWidth: 160 },
+                            },
+                            {
+                                key: "by",
+                                fieldKey: "by",
+                                title: labels.columns.by,
+                                sizing: { mode: "content", minWidth: 140 },
+                            },
+                            {
+                                key: "at",
+                                fieldKey: "at",
+                                title: labels.columns.at,
+                                renderer: "datetime",
+                                sizing: { mode: "content", minWidth: 168 },
+                            },
+                        ],
+                        footer: {
+                            template: labels.footer,
+                            values: [{ key: "releases", value: { source: "core", fieldKey: "totalRows" } }],
+                            align: "start",
+                        },
+                        emptyState: { title: labels.empty.title, description: labels.empty.text },
+                        controlSize: "small",
+                    },
+                    features: {
+                        pagination: { enabled: false },
+                        sorting: { mode: "none" },
+                        tools: { mode: "self-contained", reset: false, reload: true },
+                        actions: { toolbar: [], row: rowActions },
+                    },
+                },
+            }),
+        ],
+    };
+}

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

@@ -4,4 +4,4 @@ import dynamic from "next/dynamic";
  * next/dynamic rather than a loader: rendered during the server render, it names its chunks in the
  * route's loadable manifest, and the HTML asks for them before hydration instead of after it.
  */
-export const PhiLazyFormBuilderRuntimeControllerClient = dynamic(() => import("../../../components/forms/form-builder-controller-plugin").then((module) => module.PhiFormBuilderControllerClient));
+export const PhiLazyFormBuilderRuntimeControllerClient = dynamic(() => import("./controller/client").then((module) => module.PhiFormBuilderControllerClient));

package/{components/forms/form-builder-controller-plugin.d.ts → plugins/runtime-modules/form-builder/controller/client.d.ts}

@@ -12,6 +12,6 @@ export declare const PHI_FORM_BUILDER_CONTROLLER_PLUGIN: {
         listens: never[];
     };
     defaultConfig: {};
-    parseConfig: typeof import("./form-builder-controller-definition").parsePhiFormBuilderControllerConfig;
+    parseConfig: typeof import("../../../../forms").parsePhiFormBuilderControllerConfig;
 };
-export declare const PhiFormBuilderControllerClient: (props: import("../../types").PhiRuntimeModuleControllerClientProps) => import("react").JSX.Element;
+export declare const PhiFormBuilderControllerClient: (props: import("../../contracts").PhiRuntimeModuleControllerClientProps) => import("react").JSX.Element;

package/{components/forms/form-builder-controller-plugin.js → plugins/runtime-modules/form-builder/controller/client.js}

@@ -1,6 +1,6 @@
 "use client";
-import { createPhiRuntimeControllerClient } from "../runtime/runtime-controller-client-factory";
-import { PHI_FORM_BUILDER_CONTROLLER_DEFINITION, } from "./form-builder-controller-definition";
+import { createPhiRuntimeControllerClient } from "../../../../components/runtime/runtime-controller-client-factory";
+import { PHI_FORM_BUILDER_CONTROLLER_DEFINITION, } from "../../../../components/forms/form-builder-controller-definition";
 export const PHI_FORM_BUILDER_CONTROLLER_PLUGIN = {
     ...PHI_FORM_BUILDER_CONTROLLER_DEFINITION,
     renderController: () => null,

package/plugins/runtime-modules/groups/addresses.d.ts

@@ -1,4 +1,7 @@
 export declare const PHI_APP_GROUPS_PAGE_WIDGET_IDS: Readonly<Record<"widgetMyGroupsTable" | "widgetMembersTable" | "widgetMembershipForm" | "widgetMembershipCommands", import("@phis/contracts/cms").PhiCmsInstanceId>>;
+/** The two dialogs of the Groups administration Page: creating a group, adding a member. */
+export declare const PHI_GROUPS_PAGE_OVERLAY_IDS: Readonly<Record<"overlayCreate" | "overlayMembership", import("@phis/contracts/cms").PhiCmsInstanceId>>;
+export declare const PHI_GROUPS_PAGE_LAYOUT_IDS: Readonly<Record<"layoutCreate" | "layoutCreateFooter" | "layoutMembership" | "layoutMembershipFooter", import("@phis/contracts/cms").PhiCmsInstanceId>>;
 /**
  * Stable Widget ids for the Groups administration Page.
  *

package/plugins/runtime-modules/groups/addresses.js

@@ -16,6 +16,17 @@ export const PHI_APP_GROUPS_PAGE_WIDGET_IDS = createPhiPresetCmsInstanceIdMap(ap
     "widgetMembershipForm",
     "widgetMembershipCommands",
 ]);
+/** The two dialogs of the Groups administration Page: creating a group, adding a member. */
+export const PHI_GROUPS_PAGE_OVERLAY_IDS = createPhiPresetCmsInstanceIdMap(identity, [
+    "overlayCreate",
+    "overlayMembership",
+]);
+export const PHI_GROUPS_PAGE_LAYOUT_IDS = createPhiPresetCmsInstanceIdMap(identity, [
+    "layoutCreate",
+    "layoutCreateFooter",
+    "layoutMembership",
+    "layoutMembershipFooter",
+]);
 /**
  * Stable Widget ids for the Groups administration Page.
  *

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

@@ -19,6 +19,11 @@ export declare const PHI_GROUPS_RUNTIME_CONTROLLER_PLUGIN: {
             action: "activate";
             valueType: "none";
             valueSchema?: undefined;
+        } | {
+            id: string;
+            action: "close";
+            valueType: "none";
+            valueSchema?: undefined;
         })[];
         listens: ({
             id: string;

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

@@ -1,51 +1,40 @@
 "use client";
 import { jsx as _jsx } from "react/jsx-runtime";
-import { useCallback, useMemo } from "react";
-import { findPhiSignalRoutesByCapabilityId, } from "../../../../types/signals";
+import { useCallback, useMemo, useRef } from "react";
+import {} from "../../../../types/signals";
 import { readPhiTableSelectionSignalValue } from "../../../../types/table-signal-values";
 import { createPhiRuntimeControllerClient } from "../../../../components/runtime/runtime-controller-client-factory";
 import { PHI_GROUPS_OPTIONS_REVISION } from "../services/options-revision";
 import { usePhiSignalDispatcher, usePhiSignalListener } from "../../../../components/runtime/runtime-signal-bus";
+import { dispatchPhiSignalCapability } from "../../../../components/runtime/runtime-signal-identity";
 import { usePhiRuntimeConditionStateResponder } from "../../../../components/runtime/runtime-condition-state-responder";
 import { PHI_GROUPS_RUNTIME_CONTROLLER_DEFINITION, } from "../controller/definition";
-/* This Controller gates nothing, so the answer never varies -- but a Widget still has to hear it. */
-const GROUPS_CONDITION_STATE = { ready: true };
-function readSelectedGroupId(value) {
+function readSelectedGroup(value) {
     const selection = readPhiTableSelectionSignalValue(value);
     const identity = selection?.selectedRowIdentities?.[0];
     if (identity == null)
-        return null;
+        return { groupId: null, retired: false };
     const groupId = Number.parseInt(String(identity), 10);
-    return Number.isSafeInteger(groupId) && groupId > 0 ? groupId : null;
+    if (!Number.isSafeInteger(groupId) || groupId <= 0)
+        return { groupId: null, retired: false };
+    // The group table names `retired` in its `emitFields`; a row it has not loaded says nothing.
+    const row = selection?.selectedRows?.find((candidate) => String(candidate.rowIdentity) === String(identity));
+    return { groupId, retired: row?.values.retired === true };
 }
 function PhiGroupsControllerView({ address, config, }) {
     const dispatchSignal = usePhiSignalDispatcher();
     const emitRoutes = useMemo(() => config.signalRoutes?.emits ?? [], [config.signalRoutes?.emits]);
     /* One declared output, delivered through every route the Page wrote for it. */
-    const emitCapability = useCallback((capabilityId, value, correlationId) => {
-        for (const route of findPhiSignalRoutesByCapabilityId(emitRoutes, capabilityId)) {
-            if (route.receiver == null || (route.valueType === "json" && !route.valueSchema)) {
-                continue;
-            }
-            dispatchSignal({
-                scope: route.scope,
-                sender: address,
-                receiver: route.receiver,
-                channel: route.channel,
-                action: route.action,
-                value: route.valueType === "none" ? null : value,
-                valueType: route.valueType,
-                valueSchema: route.valueSchema ?? null,
-                correlationId,
-                timestamp: Date.now(),
-            });
-        }
-    }, [address, dispatchSignal, emitRoutes]);
+    const emitCapability = useCallback((capabilityId, value, correlationId) => dispatchPhiSignalCapability(dispatchSignal, address, emitRoutes, capabilityId, value, correlationId), [address, dispatchSignal, emitRoutes]);
     // No selection means no group, and the membership table answers that with an empty list rather than
     // with every membership on the Site.
     const sendGroupFilter = useCallback((groupId, correlationId) => emitCapability("filtersChange", { groupId }, correlationId), [emitCapability]);
-    // Nothing about this Controller gates a Widget; answering keeps the asking Widget from waiting.
-    usePhiRuntimeConditionStateResponder({ address, scope: "page", state: GROUPS_CONDITION_STATE });
+    // Kept for the membership Form, which mounts only when its dialog opens and then asks for it.
+    const selectedGroupIdRef = useRef(null);
+    // A retired group takes no new members, so the membership table's `+` is off while one is selected.
+    const selectedGroupRetiredRef = useRef(false);
+    const conditionState = useCallback(() => ({ ready: true, selectedGroupRetired: selectedGroupRetiredRef.current }), []);
+    usePhiRuntimeConditionStateResponder({ address, scope: "page", state: conditionState });
     usePhiSignalListener((signal) => {
         if (signal.channel === "command") {
             // The Forms are submitted from outside, so a toolbar asks and this carries it to the right one.
@@ -66,12 +55,36 @@ function PhiGroupsControllerView({ address, config, }) {
             PHI_GROUPS_OPTIONS_REVISION.bump();
             // Something was written: every list this Page named is stale, and none knows which it was.
             emitCapability("reload", null, signal.correlationId);
+            // And the dialog it was written in is done. Closing one that is not open does nothing.
+            emitCapability("dialogClose", null, signal.correlationId);
             return;
         }
-        sendGroupFilter(readSelectedGroupId(signal.value), signal.correlationId);
+        // Only a selection chooses the group. A condition question or reload reaching this listener fell
+        // through to here and sent `{ groupId: null }`, which emptied the membership table under a choice.
+        if (signal.channel === "selection") {
+            const { groupId, retired } = readSelectedGroup(signal.value);
+            /*
+             * The table says the same selection again when a row's fields change. Only a different group is a
+             * new filter: sending it again would put the membership table back on its first page.
+             */
+            if (groupId !== selectedGroupIdRef.current) {
+                selectedGroupIdRef.current = groupId;
+                sendGroupFilter(groupId, signal.correlationId);
+            }
+            if (retired !== selectedGroupRetiredRef.current) {
+                selectedGroupRetiredRef.current = retired;
+                emitCapability("conditionStateChange", { state: conditionState() }, signal.correlationId);
+            }
+            return;
+        }
+        // No group selected, nothing to say: the Form starts empty, as it would without asking.
+        if (signal.channel === "values" && selectedGroupIdRef.current != null) {
+            // The group field's options carry their ids as strings.
+            emitCapability("membershipValues", { values: { groupId: String(selectedGroupIdRef.current) } }, signal.correlationId);
+        }
     }, {
         scopes: ["page"],
-        channels: ["selection", "condition", "submit", "command"],
+        channels: ["selection", "condition", "submit", "command", "values"],
         actions: ["change", "reload", "activate"],
         receiver: address,
     });

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

@@ -36,6 +36,11 @@ export declare const PHI_GROUPS_RUNTIME_CONTROLLER_DEFINITION: {
             action: "activate";
             valueType: "none";
             valueSchema?: undefined;
+        } | {
+            id: string;
+            action: "close";
+            valueType: "none";
+            valueSchema?: undefined;
         })[];
         listens: ({
             id: string;

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

@@ -37,6 +37,15 @@ export const PHI_GROUPS_RUNTIME_CONTROLLER_DEFINITION = {
              */
             { id: "createSubmit", action: "activate", valueType: "none" },
             { id: "membershipSubmit", action: "activate", valueType: "none" },
+            // A dialog a Form was written from closes once the write took; the Page names which dialogs.
+            { id: "dialogClose", action: "close", valueType: "none" },
+            // What the membership Form starts with when it asks: the group selected in the table, if any.
+            {
+                id: "membershipValues",
+                action: "change",
+                valueType: "json",
+                valueSchema: PHI_SIGNAL_VALUE_SCHEMAS.formValues,
+            },
         ],
         listens: [
             {
@@ -57,6 +66,7 @@ export const PHI_GROUPS_RUNTIME_CONTROLLER_DEFINITION = {
                 valueSchema: PHI_SIGNAL_VALUE_SCHEMAS.formResult,
             },
             { id: "formCommand", channel: "command", action: "activate", valueType: "string" },
+            { id: "membershipValuesRequest", channel: "values", action: "reload", valueType: "none" },
         ],
     },
     defaultConfig: {},