@phis/ui 0.2.1 → 0.4.0

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

@@ -1,13 +1,84 @@
 export declare const PHI_EDITOR_RUNTIME_MODULE_DEFINITION: Omit<{
-    area: "editor";
-    moduleId: "@phis/ui/modules/editor";
     serverBinding: import("../../../types").PhiRuntimeModuleServerBinding;
-    controllerType: "@phis/ui/modules/editor/controller/default";
-    controller: import("../contracts").PhiRuntimeModuleControllerDescriptor;
     description: string;
     category: "foundation";
     iconFamily: string;
-    controllerMountPolicy: "area";
+    dataProviders: {
+        key: `${string}/${string}`;
+        ownerModuleId: "@phis/ui/modules/editor";
+        kind: "table";
+        executionMode: "live";
+        authoringMode: "none";
+        title: string;
+        description: string;
+        resources: {
+            resourceKey: string;
+            title: string;
+            rowIdentityPath: string;
+            fields: ({
+                key: string;
+                title: string;
+                type: "string";
+                required: true;
+                options?: undefined;
+            } | {
+                key: string;
+                title: string;
+                type: "enum";
+                options: {
+                    value: string;
+                    label: string;
+                }[];
+                required?: undefined;
+            } | {
+                key: string;
+                title: string;
+                type: "string";
+                required?: undefined;
+                options?: undefined;
+            } | {
+                key: string;
+                title: string;
+                type: "datetime";
+                required?: undefined;
+                options?: undefined;
+            } | {
+                key: string;
+                title: string;
+                type: "boolean";
+                required?: undefined;
+                options?: undefined;
+            })[];
+            query: {
+                search: false;
+                sorting: "none";
+                pagination: "none";
+            };
+            recordRead: false;
+            actions: ({
+                key: string;
+                title: string;
+                scope: "row";
+                confirmation: "required";
+                disabledWhen: {
+                    match: "any";
+                    conditions: {
+                        source: "row";
+                        valuePath: string;
+                        operator: "falsy";
+                    }[];
+                };
+            } | {
+                key: string;
+                title: string;
+                scope: "resource";
+                confirmation?: undefined;
+                disabledWhen?: undefined;
+            })[];
+        }[];
+    }[];
+    moduleId: "@phis/ui/modules/editor";
+    area: "editor";
 }, "area"> & {
     kind: "module";
     eligibleAreas: readonly ["public" | "app" | "admin" | "builder" | "editor" | "accounting"];

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

@@ -1,17 +1,13 @@
-import { PHI_EDITOR_RUNTIME_CONTROLLER_DEFINITION } from "../../../plugins/runtime-modules/editor/controller/definition";
-import { PHI_EDITOR_CONTROLLER_TYPE } from "../../../plugins/runtime-modules/editor/controller/address";
-import { buildPhiRuntimeModuleControllerDescriptor } from "../contracts";
 import { definePhiAreaBaseRuntimeModuleDefinition } from "../area-base-definition";
-import { PHI_EDITOR_RUNTIME_MODULE_ID } from "./ids";
+import { PHI_EDITOR_RUNTIME_MODULE_IDENTITY } from "./ids";
 import { PHI_CORE_SERVER_BINDING } from "../../../types/server-capabilities";
+import { PHI_EDITOR_RUNTIME_DATA_PROVIDER_DESCRIPTORS } from "./data-providers";
 export const PHI_EDITOR_RUNTIME_MODULE_DEFINITION = definePhiAreaBaseRuntimeModuleDefinition({
     area: "editor",
-    moduleId: PHI_EDITOR_RUNTIME_MODULE_ID,
+    ...PHI_EDITOR_RUNTIME_MODULE_IDENTITY,
     serverBinding: PHI_CORE_SERVER_BINDING,
-    controllerType: PHI_EDITOR_CONTROLLER_TYPE,
-    controller: buildPhiRuntimeModuleControllerDescriptor(PHI_EDITOR_RUNTIME_CONTROLLER_DEFINITION),
     description: "Locked Editor Area shell, content editor widgets, data, and workflows.",
     category: "foundation",
     iconFamily: "editor",
-    controllerMountPolicy: "area",
+    dataProviders: PHI_EDITOR_RUNTIME_DATA_PROVIDER_DESCRIPTORS,
 });

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

@@ -1 +1,20 @@
 export declare const PHI_EDITOR_RUNTIME_MODULE_ID: "@phis/ui/modules/editor";
+/**
+ * The Module's identity as its Label Sets inherit it (`definePhiRuntimeModuleLabelSet`): the id and,
+ * where a Module declares one, its source locale. Stated here beside the id and spread into the
+ * definition, so a Label Set a tree or a form reads does not import the definition that imports the
+ * tree -- and a Module that writes in another language says so once.
+ */
+export declare const PHI_EDITOR_RUNTIME_MODULE_IDENTITY: {
+    readonly moduleId: "@phis/ui/modules/editor";
+};
+/**
+ * The Publisher's queue (phis-server CONTENT.md, Submission): what waits for somebody to put it live. A
+ * Page of the Editor Area itself rather than of a Module, because every content Module's submissions land
+ * in it -- Widget content, News, and whatever content type comes next.
+ */
+export declare const PHI_EDITOR_RELEASES_DATA_PROVIDER_KEY: `${string}/${string}`;
+/** The one resource the queue's Provider answers. */
+export declare const PHI_EDITOR_RELEASES_RESOURCE_KEY = "items";
+export declare const PHI_EDITOR_RELEASES_PAGE_PRESET_KEY = "editor-releases-page";
+export declare const PHI_EDITOR_RELEASES_WIDGET_ID: import("@phis/contracts/cms").PhiCmsInstanceId;

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

@@ -1,2 +1,28 @@
 import { PHI_SHARED_PACKAGE_NAME } from "../../../types/signals";
+import { createPhiSharedRuntimeDataProviderKey } from "../../../constants/runtime-data-provider-key";
+import { createPhiPresetCmsInstanceId } from "../../../types/cms-instance-id";
 export const PHI_EDITOR_RUNTIME_MODULE_ID = `${PHI_SHARED_PACKAGE_NAME}/modules/editor`;
+/**
+ * The Module's identity as its Label Sets inherit it (`definePhiRuntimeModuleLabelSet`): the id and,
+ * where a Module declares one, its source locale. Stated here beside the id and spread into the
+ * definition, so a Label Set a tree or a form reads does not import the definition that imports the
+ * tree -- and a Module that writes in another language says so once.
+ */
+export const PHI_EDITOR_RUNTIME_MODULE_IDENTITY = {
+    moduleId: PHI_EDITOR_RUNTIME_MODULE_ID,
+};
+/**
+ * The Publisher's queue (phis-server CONTENT.md, Submission): what waits for somebody to put it live. A
+ * Page of the Editor Area itself rather than of a Module, because every content Module's submissions land
+ * in it -- Widget content, News, and whatever content type comes next.
+ */
+export const PHI_EDITOR_RELEASES_DATA_PROVIDER_KEY = createPhiSharedRuntimeDataProviderKey("tables", "editor-releases");
+/** The one resource the queue's Provider answers. */
+export const PHI_EDITOR_RELEASES_RESOURCE_KEY = "items";
+export const PHI_EDITOR_RELEASES_PAGE_PRESET_KEY = "editor-releases-page";
+export const PHI_EDITOR_RELEASES_WIDGET_ID = createPhiPresetCmsInstanceId({
+    domain: "page",
+    ownerModuleId: PHI_EDITOR_RUNTIME_MODULE_ID,
+    presetKey: PHI_EDITOR_RELEASES_PAGE_PRESET_KEY,
+    nodeKey: "widgetReleases",
+});

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

@@ -1 +1,89 @@
-export declare const PHI_EDITOR_RUNTIME_MODULE: import("../contracts").PhiRuntimeModule;
+/**
+ * No Controller. The one this Module carried answered nothing and rendered nothing, and was mounted on
+ * every page of its Areas for it. Area-wide behaviour that belongs to no Module goes to the Core Runtime
+ * Controller; a Module's own goes into that Module's Controller, mounted on demand.
+ */
+export declare const PHI_EDITOR_RUNTIME_MODULE: {
+    category: "foundation";
+    description: string;
+    moduleId: "@phis/ui/modules/editor";
+    serverBinding: import("../../../types").PhiRuntimeModuleServerBinding;
+    dataProviders: {
+        key: `${string}/${string}`;
+        ownerModuleId: "@phis/ui/modules/editor";
+        kind: "table";
+        executionMode: "live";
+        authoringMode: "none";
+        title: string;
+        description: string;
+        resources: {
+            resourceKey: string;
+            title: string;
+            rowIdentityPath: string;
+            fields: ({
+                key: string;
+                title: string;
+                type: "string";
+                required: true;
+                options?: undefined;
+            } | {
+                key: string;
+                title: string;
+                type: "enum";
+                options: {
+                    value: string;
+                    label: string;
+                }[];
+                required?: undefined;
+            } | {
+                key: string;
+                title: string;
+                type: "string";
+                required?: undefined;
+                options?: undefined;
+            } | {
+                key: string;
+                title: string;
+                type: "datetime";
+                required?: undefined;
+                options?: undefined;
+            } | {
+                key: string;
+                title: string;
+                type: "boolean";
+                required?: undefined;
+                options?: undefined;
+            })[];
+            query: {
+                search: false;
+                sorting: "none";
+                pagination: "none";
+            };
+            recordRead: false;
+            actions: ({
+                key: string;
+                title: string;
+                scope: "row";
+                confirmation: "required";
+                disabledWhen: {
+                    match: "any";
+                    conditions: {
+                        source: "row";
+                        valuePath: string;
+                        operator: "falsy";
+                    }[];
+                };
+            } | {
+                key: string;
+                title: string;
+                scope: "resource";
+                confirmation?: undefined;
+                disabledWhen?: undefined;
+            })[];
+        }[];
+    }[];
+    iconFamily: string;
+    kind: "module";
+    eligibleAreas: readonly ["public" | "app" | "admin" | "builder" | "editor" | "accounting"];
+    title: "Public Base" | "App Base" | "Accounting Base" | "Admin Base" | "Builder Base" | "Editor Base";
+};

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

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

package/plugins/runtime-modules/editor/presets.d.ts

@@ -6,4 +6,42 @@ export declare const PHI_EDITOR_RUNTIME_MODULE_AREA_SHELLS: {
     area: "editor";
     loadTree: ({ page, runtime }: import("../../../types").PhiCmsDescriptorBuildContext) => Promise<import("../../../types").PhiResolvedCmsPageTree>;
 }[];
-export declare const PHI_EDITOR_RUNTIME_MODULE_ROUTES: PhiCmsRoutePresetDescriptor[];
+export declare const PHI_EDITOR_RUNTIME_MODULE_ROUTES: (PhiCmsRoutePresetDescriptor | {
+    tour: {
+        readonly id: "@phis/ui/modules/editor/releases";
+        readonly version: 1;
+        readonly steps: readonly [{
+            readonly key: "queue";
+            readonly target: `cms:${import("@phis/contracts/cms").PhiCmsInstanceId}:header`;
+            readonly title: "Everything waiting for release";
+            readonly description: "What Authors submit anywhere in the Site lands here: texts on Pages, entries, Pages and Area changes. Kind says what it is, Where where it will appear, By who submitted it.";
+            readonly placement: "bottom";
+        }, {
+            readonly key: "answer";
+            readonly target: `cms:${import("@phis/contracts/cms").PhiCmsInstanceId}:row-actions`;
+            readonly title: "Publish or send back";
+            readonly description: "Publish puts the submitted version live. Send back withdraws the submission: nothing is published, and the words stay as they were written, so the Author can go on.";
+            readonly placement: "left";
+        }, {
+            readonly key: "count";
+            readonly target: `cms:${import("@phis/contracts/cms").PhiCmsInstanceId}:footer`;
+            readonly title: "How many wait";
+            readonly description: "The count of everything still waiting. The list is empty when everything submitted has an answer.";
+            readonly placement: "top";
+            readonly ifMissing: "skip";
+        }];
+    };
+    ownerModuleId: import("../contracts").PhiRuntimeModuleId;
+    presetKey: string;
+    presetVersion: number;
+    area: import("@phis/contracts/cms").PhiCmsAreaKey;
+    path: string;
+    landingPage?: true;
+    title: string;
+    defaultPageFlags?: number;
+    loadTree: (context: import("../../../types").PhiCmsDescriptorBuildContext & {
+        activeModuleIds: ReadonlySet<import("../contracts").PhiRuntimeModuleId>;
+        params: Readonly<Record<string, string>>;
+    }) => import("../../../types").PhiResolvedCmsPageTree | Promise<import("../../../types").PhiResolvedCmsPageTree>;
+    navigation?: readonly import("../../../types").PhiCmsNavigationInjectionDescriptor[];
+})[];

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

@@ -1,5 +1,7 @@
 import { buildPhiAreaRootRoutePresetDescriptor } from "../area-root-route";
-import { PHI_EDITOR_RUNTIME_MODULE_ID } from "./ids";
+import { buildPhiSidebarRoutePresetDescriptor } from "../sidebar-route";
+import { PHI_EDITOR_RELEASES_PAGE_PRESET_KEY, PHI_EDITOR_RUNTIME_MODULE_ID } from "./ids";
+import { PHI_EDITOR_RELEASES_TOUR } from "./tour";
 export const PHI_EDITOR_RUNTIME_MODULE_AREA_SHELLS = [{
         ownerModuleId: PHI_EDITOR_RUNTIME_MODULE_ID,
         presetKey: "editor-area-preset",
@@ -8,8 +10,29 @@ export const PHI_EDITOR_RUNTIME_MODULE_AREA_SHELLS = [{
         loadTree: ({ page, runtime }) => import("./trees/phi-default-editor-area-preset-tree")
             .then((module) => module.buildPhiDefaultEditorAreaPresetTree({ page, runtime })),
     }];
-export const PHI_EDITOR_RUNTIME_MODULE_ROUTES = [buildPhiAreaRootRoutePresetDescriptor({
+export const PHI_EDITOR_RUNTIME_MODULE_ROUTES = [
+    buildPhiAreaRootRoutePresetDescriptor({
         ownerModuleId: PHI_EDITOR_RUNTIME_MODULE_ID,
         area: "editor",
         title: "Editor",
-    })];
+    }),
+    /*
+     * The Publisher's queue, the Area's own Page: every content Module's submissions land in it, so it
+     * belongs to none of them (phis-server CONTENT.md, Submission).
+     */
+    {
+        ...buildPhiSidebarRoutePresetDescriptor({
+            area: "editor",
+            anchor: "main",
+            ownerModuleId: PHI_EDITOR_RUNTIME_MODULE_ID,
+            presetKey: PHI_EDITOR_RELEASES_PAGE_PRESET_KEY,
+            title: "Releases",
+            path: "/releases",
+            itemKey: "@phis/ui/modules/editor/nav/editor/releases",
+            icon: "antd:safety-certificate",
+            loadTree: ({ page, runtime }) => import("./trees/phi-default-editor-releases-page-tree")
+                .then((module) => module.buildPhiDefaultEditorReleasesPageTree({ page, runtime })),
+        }),
+        tour: PHI_EDITOR_RELEASES_TOUR,
+    },
+];

package/plugins/runtime-modules/editor/services/releases-table.d.ts

@@ -0,0 +1,10 @@
+import { type ReactNode } from "react";
+/**
+ * The Publisher's queue for a Table, and its two acts: publish what was submitted, or send it back.
+ *
+ * A refusal keeps its reason: Core answers `403` to anybody who may not publish and `409` to a version
+ * somebody wrote past, and that sentence is what the Table shows.
+ */
+export declare function PhiEditorReleasesTableProviderClient({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;

package/plugins/runtime-modules/editor/services/releases-table.js

@@ -0,0 +1,182 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useMemo, useRef } from "react";
+import { createPhiTableProviderRequestInit, readPhiTableRows, } from "../../../../components/widgets/client/shared/phi-table-provider-request";
+import { PhiTableProviderError, } from "../../../../types/table-widget";
+import { PhiTableProviderClient, } from "../../../../components/widgets/client/shared/phi-table-provider";
+import { readPhiTableProviderResponse, } from "../../../../components/widgets/client/shared/phi-table-provider-response";
+import { PHI_EDITOR_RUNTIME_DATA_PROVIDER_DESCRIPTORS } from "../data-providers";
+import { PHI_EDITOR_RELEASES_DATA_PROVIDER_KEY, PHI_EDITOR_RELEASES_RESOURCE_KEY } from "../ids";
+const RELEASES_API_PATH = "/api/site/editor/releases";
+const RESPONSE_OPTIONS = { subject: "Releases" };
+function readText(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+function readPerson(value) {
+    const person = (value ?? null);
+    return readText(person?.name) ?? readText(person?.email) ?? "";
+}
+function describePlace(item) {
+    const place = (item.place ?? item);
+    const area = readText(place.area) ?? "";
+    const address = readText(place.path) ?? readText(place.presetKey);
+    return address ? `${area} · ${address}` : area;
+}
+/**
+ * Core's queue as the Table speaks it: one row per waiting thing, the words a reader needs, and the request
+ * each of its two acts makes.
+ *
+ * An Area's draft is listed and not published from here: publishing an Area names the Shell preset it
+ * stands on, which the queue does not carry. The Builder publishes it.
+ */
+function toReleaseRow(item) {
+    switch (item.kind) {
+        case "content": {
+            const contentId = item.contentId;
+            return {
+                id: `content:${String(contentId)}`,
+                kind: "content",
+                what: readText(item.preview) ?? readText(item.storage) ?? "",
+                where: describePlace(item),
+                by: readPerson(item.writtenBy),
+                at: item.writtenAt,
+                publishable: true,
+                rejectable: true,
+                publish: {
+                    path: "/api/site/editor/content/publish",
+                    method: "POST",
+                    body: { contentId, versionId: item.submittedVersionId },
+                },
+                reject: { path: `/api/site/editor/content/submit?contentId=${String(contentId)}`, method: "DELETE" },
+            };
+        }
+        case "entry": {
+            const contentId = item.contentId;
+            const entryKind = String(item.entryKind ?? "");
+            const base = `/api/site/editor/entries/${encodeURIComponent(entryKind)}`;
+            return {
+                id: `entry:${entryKind}:${String(contentId)}`,
+                kind: "entry",
+                what: readText(item.title) ?? readText(item.slug) ?? "",
+                where: entryKind,
+                by: readPerson(item.writtenBy),
+                at: item.writtenAt,
+                publishable: true,
+                rejectable: true,
+                publish: { path: `${base}/publish`, method: "POST", body: { contentId, versionId: item.submittedVersionId } },
+                reject: { path: `${base}/submit?contentId=${String(contentId)}`, method: "DELETE" },
+            };
+        }
+        case "page": {
+            const address = readText(item.path)
+                ? { path: item.path }
+                : { ownerModuleId: item.ownerModuleId, presetKey: item.presetKey };
+            return {
+                id: `page:${String(item.revisionId)}`,
+                kind: "page",
+                what: readText(item.path) ?? readText(item.presetKey) ?? "",
+                where: describePlace(item),
+                by: readPerson(item.savedBy),
+                at: item.savedAt,
+                publishable: true,
+                rejectable: false,
+                publish: {
+                    path: "/api/site/cms/page/publish",
+                    method: "POST",
+                    body: { area: item.area, revisionId: item.revisionId, ...address },
+                },
+                reject: null,
+            };
+        }
+        case "area":
+            return {
+                id: `area:${String(item.area)}:${String(item.part)}`,
+                kind: "area",
+                what: String(item.part ?? ""),
+                where: String(item.area ?? ""),
+                by: readPerson(item.savedBy),
+                at: item.savedAt,
+                // The Area's publish names the Shell preset it stands on; a draft without one has nothing to name.
+                publishable: Boolean(readText(item.ownerModuleId) && readText(item.presetKey)),
+                rejectable: false,
+                publish: readText(item.ownerModuleId) && readText(item.presetKey)
+                    ? {
+                        path: item.part === "modules" ? "/api/site/cms/area/modules/publish" : "/api/site/cms/area/publish",
+                        method: "POST",
+                        body: {
+                            area: item.area,
+                            revisionId: item.revisionId,
+                            ownerModuleId: item.ownerModuleId,
+                            presetKey: item.presetKey,
+                        },
+                    }
+                    : null,
+                reject: null,
+            };
+        default:
+            return null;
+    }
+}
+/**
+ * The Publisher's queue for a Table, and its two acts: publish what was submitted, or send it back.
+ *
+ * A refusal keeps its reason: Core answers `403` to anybody who may not publish and `409` to a version
+ * somebody wrote past, and that sentence is what the Table shows.
+ */
+export function PhiEditorReleasesTableProviderClient({ children }) {
+    const rowsRef = useRef(new Map());
+    const query = useCallback(async ({ resourceKey, signal }) => {
+        if (resourceKey !== PHI_EDITOR_RELEASES_RESOURCE_KEY) {
+            throw new PhiTableProviderError("resource-not-found", `Unknown releases resource "${resourceKey}".`);
+        }
+        const result = await readPhiTableProviderResponse(await fetch(RELEASES_API_PATH, createPhiTableProviderRequestInit(signal)), RESPONSE_OPTIONS);
+        const rows = readPhiTableRows(result?.items)
+            .map(toReleaseRow)
+            .filter((row) => row !== null);
+        rowsRef.current = new Map(rows.map((row) => [row.id, row]));
+        // The acts stay here; the Table gets the words.
+        const visible = rows.map((row) => {
+            const { publish, reject, ...rest } = row;
+            void publish;
+            void reject;
+            return rest;
+        });
+        return { rows: visible, total: visible.length, page: 1, pageSize: Math.max(visible.length, 1) };
+    }, []);
+    const mutate = useCallback(async (request) => {
+        if (request.kind !== "action") {
+            throw new PhiTableProviderError("mutation-not-supported", "Releases are acted on, not edited.");
+        }
+        if (request.actionKey === "refresh") {
+            return { status: "accepted", invalidation: "view" };
+        }
+        const row = rowsRef.current.get(String(request.rowIdentity));
+        if (!row) {
+            throw new PhiTableProviderError("record-not-loaded", "That item is no longer in the current view. Reload the Table and try again.");
+        }
+        const act = request.actionKey === "publish" ? row.publish : request.actionKey === "reject" ? row.reject : null;
+        if (!act) {
+            throw new PhiTableProviderError("action-not-supported", `"${request.actionKey}" does not apply to this item.`);
+        }
+        await readPhiTableProviderResponse(await fetch(act.path, {
+            method: act.method,
+            cache: "no-store",
+            credentials: "include",
+            headers: {
+                accept: "application/json",
+                ...(act.body ? { "content-type": "application/json" } : {}),
+            },
+            ...(act.body ? { body: JSON.stringify(act.body) } : {}),
+            signal: request.signal,
+        }), RESPONSE_OPTIONS);
+        // Either act takes the row out of the queue, so the whole list is read again.
+        return { status: "accepted", invalidation: "resource" };
+    }, []);
+    const registration = useMemo(() => ({
+        key: PHI_EDITOR_RELEASES_DATA_PROVIDER_KEY,
+        resources: PHI_EDITOR_RUNTIME_DATA_PROVIDER_DESCRIPTORS[0].resources,
+        query,
+        mutate,
+    }), [mutate, query]);
+    return _jsx(PhiTableProviderClient, { registration: registration, children: children });
+}

package/plugins/runtime-modules/editor/tour.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The Releases Tour: what lands here, and the two answers a Publisher gives. What the Page does not say is
+ * that everything submitted anywhere in the Site arrives in this one list, and that sending something back
+ * loses nothing.
+ */
+export declare const PHI_EDITOR_RELEASES_TOUR: {
+    readonly id: "@phis/ui/modules/editor/releases";
+    readonly version: 1;
+    readonly steps: readonly [{
+        readonly key: "queue";
+        readonly target: `cms:${import("@phis/contracts/cms").PhiCmsInstanceId}:header`;
+        readonly title: "Everything waiting for release";
+        readonly description: "What Authors submit anywhere in the Site lands here: texts on Pages, entries, Pages and Area changes. Kind says what it is, Where where it will appear, By who submitted it.";
+        readonly placement: "bottom";
+    }, {
+        readonly key: "answer";
+        readonly target: `cms:${import("@phis/contracts/cms").PhiCmsInstanceId}:row-actions`;
+        readonly title: "Publish or send back";
+        readonly description: "Publish puts the submitted version live. Send back withdraws the submission: nothing is published, and the words stay as they were written, so the Author can go on.";
+        readonly placement: "left";
+    }, {
+        readonly key: "count";
+        readonly target: `cms:${import("@phis/contracts/cms").PhiCmsInstanceId}:footer`;
+        readonly title: "How many wait";
+        readonly description: "The count of everything still waiting. The list is empty when everything submitted has an answer.";
+        readonly placement: "top";
+        readonly ifMissing: "skip";
+    }];
+};

package/plugins/runtime-modules/editor/tour.js

@@ -0,0 +1,34 @@
+import { PHI_EDITOR_RELEASES_WIDGET_ID, PHI_EDITOR_RUNTIME_MODULE_ID } from "./ids";
+/**
+ * The Releases Tour: what lands here, and the two answers a Publisher gives. What the Page does not say is
+ * that everything submitted anywhere in the Site arrives in this one list, and that sending something back
+ * loses nothing.
+ */
+export const PHI_EDITOR_RELEASES_TOUR = {
+    id: `${PHI_EDITOR_RUNTIME_MODULE_ID}/releases`,
+    version: 1,
+    steps: [
+        {
+            key: "queue",
+            target: `cms:${PHI_EDITOR_RELEASES_WIDGET_ID}:header`,
+            title: "Everything waiting for release",
+            description: "What Authors submit anywhere in the Site lands here: texts on Pages, entries, Pages and Area changes. Kind says what it is, Where where it will appear, By who submitted it.",
+            placement: "bottom",
+        },
+        {
+            key: "answer",
+            target: `cms:${PHI_EDITOR_RELEASES_WIDGET_ID}:row-actions`,
+            title: "Publish or send back",
+            description: "Publish puts the submitted version live. Send back withdraws the submission: nothing is published, and the words stay as they were written, so the Author can go on.",
+            placement: "left",
+        },
+        {
+            key: "count",
+            target: `cms:${PHI_EDITOR_RELEASES_WIDGET_ID}:footer`,
+            title: "How many wait",
+            description: "The count of everything still waiting. The list is empty when everything submitted has an answer.",
+            placement: "top",
+            ifMissing: "skip",
+        },
+    ],
+};

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

@@ -0,0 +1,35 @@
+import "server-only";
+import { type PhiGlobalTranslatorOptions } from "../../../../gateway/tr";
+export declare function getPhiEditorReleasesPageLabels(options: PhiGlobalTranslatorOptions): Promise<{
+    widgetLabel: string;
+    columns: {
+        kind: string;
+        what: string;
+        where: string;
+        by: string;
+        at: string;
+    };
+    footer: string;
+    kinds: {
+        content: string;
+        entry: string;
+        page: string;
+        area: string;
+    };
+    actions: {
+        publish: string;
+        reject: string;
+    };
+    publish: {
+        title: string;
+        description: string;
+    };
+    reject: {
+        title: string;
+        description: string;
+    };
+    empty: {
+        title: string;
+        text: string;
+    };
+}>;