@phis/ui 0.1.0 → 0.2.0

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

@@ -0,0 +1,325 @@
+import { PHI_CMS_DEFAULT_SLOT_INDEX, PHI_CMS_SEQUENTIAL_LAYOUT_SLOTS, } from "../../../../constants/cms-layout-types";
+import { PhiCmsPageType } from "../../../../constants/phi-cms";
+import { createPhiCmsPresetNodes } from "../../../../helpers/cms-preset-nodes";
+import { PHI_SPACE } from "../../../../theme/antd-css-var-contract";
+import { createPhiSignalAddress, createPhiSignalSubcontrolAddress } from "../../../../types/signals";
+import { PHI_EDITOR_TRANSLATION_FORM_WIDGET_ID, PHI_EDITOR_TRANSLATION_COMMANDS_WIDGET_ID, PHI_EDITOR_TRANSLATION_OVERLAY_ID, PHI_EDITOR_TRANSLATION_OVERLAY_FOOTER_LAYOUT_ID, PHI_EDITOR_TRANSLATION_OVERLAY_LAYOUT_ID, PHI_EDITOR_TRANSLATIONS_SOURCE_LOCALE_WIDGET_ID, PHI_EDITOR_TRANSLATIONS_WIDGET_ID, } from "./editor-translations-shell";
+import { buildPhiBasePageContentScaffold, PHI_BASE_PAGE_LAYOUT_NODE_ID } from "../../../../components/regions/presets/phi-base-page-layout";
+import { getPhiEditorTranslationsPageLabels } from "./editor-translations-label-set";
+import { getPhiEditorTranslationsWidgetLabels } from "./editor-translations-widget-label-set";
+import { PHI_LOCALIZATION_RUNTIME_DATA_PROVIDER_KEYS } from "../ids";
+import { PHI_LOCALIZATION_FORM_IDS } from "../forms";
+import { PHI_SIGNAL_VALUE_SCHEMAS } from "../../../../types/signals";
+import { createPhiLocalizationControllerAddress } from "../controller/address";
+import { readPhiServerApiCredentials } from "../../../../helpers/phis-server-credentials";
+const SYNTHETIC_EDITOR_TRANSLATIONS_REGION_IDS = { regionContent: -561 };
+export async function buildPhiDefaultEditorTranslationsPageTree({ page, runtime, }) {
+    const labels = await getPhiEditorTranslationsPageLabels({
+        apiBaseUrl: readPhiServerApiCredentials().apiBaseUrl,
+        internalToken: readPhiServerApiCredentials().internalToken,
+        locale: runtime.locale.current,
+    });
+    const widgetLabels = await getPhiEditorTranslationsWidgetLabels({
+        apiBaseUrl: readPhiServerApiCredentials().apiBaseUrl,
+        internalToken: readPhiServerApiCredentials().internalToken,
+        locale: runtime.locale.current,
+    });
+    const scaffold = buildPhiBasePageContentScaffold({
+        page,
+        regionId: SYNTHETIC_EDITOR_TRANSLATIONS_REGION_IDS.regionContent,
+    });
+    const nodes = createPhiCmsPresetNodes(page);
+    return {
+        page: nodes.page({ pageType: PhiCmsPageType.Standard }),
+        overlays: [nodes.overlay({
+                id: PHI_EDITOR_TRANSLATION_OVERLAY_ID,
+                overlayType: "modal",
+                bodyLayoutNodeId: PHI_EDITOR_TRANSLATION_OVERLAY_LAYOUT_ID,
+                footerPresentation: "actions",
+                footerLayoutNodeId: PHI_EDITOR_TRANSLATION_OVERLAY_FOOTER_LAYOUT_ID,
+                sortOrder: 0,
+                label: "editor translation edit modal",
+                config: {
+                    title: widgetLabels.actions.edit,
+                    width: { compact: "calc(100vw - 32px)", medium: 640, wide: 720 },
+                    mountPolicy: "remount",
+                    closeMode: "request",
+                    signalRoutes: {
+                        emits: [
+                            { routeKey: "editor-translation-overlay-state", capabilityId: "openChange", scope: "page", channel: "state", action: "change", valueType: "boolean", receiver: createPhiLocalizationControllerAddress() },
+                            { routeKey: "editor-translation-overlay-close-request", capabilityId: "closeRequest", scope: "page", channel: "dialog", action: "close", valueType: "json", valueSchema: PHI_SIGNAL_VALUE_SCHEMAS.overlayCloseRequest, receiver: createPhiLocalizationControllerAddress() },
+                        ],
+                        listens: [
+                            { routeKey: "editor-translation-overlay-open", capabilityId: "open", scope: "page", channel: "dialog", action: "activate", valueType: "none", receiver: createPhiSignalAddress("cms", PHI_EDITOR_TRANSLATION_OVERLAY_ID) },
+                            { routeKey: "editor-translation-overlay-close", capabilityId: "close", scope: "page", channel: "dialog", action: "close", valueType: "none", receiver: createPhiSignalAddress("cms", PHI_EDITOR_TRANSLATION_OVERLAY_ID) },
+                        ],
+                    },
+                },
+            })],
+        regions: [scaffold.region],
+        layoutNodes: [
+            scaffold.layoutNode,
+            nodes.layout({
+                id: PHI_EDITOR_TRANSLATION_OVERLAY_LAYOUT_ID,
+                parentLayoutNodeId: null,
+                creationPreset: { layoutKind: "verticalflex", preset: "panel" },
+                typeKey: "flex-vertical",
+                slotIndex: PHI_CMS_DEFAULT_SLOT_INDEX,
+                sortOrder: 0,
+                label: "editor translation modal content",
+                /*
+                 * The Body's root Layout is its one padding owner (OVERLAYS.md, "Padding ownership"): the
+                 * Modal adds none, so the Form stands one `base` in from every edge, as in every other dialog.
+                 */
+                config: {
+                    anchor: { horizontal: "left", vertical: "top" },
+                    gap: PHI_SPACE.base,
+                    margin: 0,
+                    padding: PHI_SPACE.base,
+                    border: false,
+                },
+            }),
+            nodes.layout({
+                id: PHI_EDITOR_TRANSLATION_OVERLAY_FOOTER_LAYOUT_ID,
+                parentLayoutNodeId: null,
+                creationPreset: { layoutKind: "flex", preset: "overlay-actions" },
+                typeKey: "flex",
+                slotIndex: PHI_CMS_DEFAULT_SLOT_INDEX,
+                sortOrder: 0,
+                label: "editor translation modal footer",
+                config: {},
+            }),
+        ],
+        contentWidgets: [
+            nodes.widget({
+                id: PHI_EDITOR_TRANSLATIONS_SOURCE_LOCALE_WIDGET_ID,
+                parentLayoutNodeId: PHI_BASE_PAGE_LAYOUT_NODE_ID,
+                typeKey: "input",
+                slotIndex: PHI_CMS_SEQUENTIAL_LAYOUT_SLOTS[0].slotIndex,
+                sortOrder: 0,
+                label: "editor source locale",
+                config: {
+                    text: "",
+                    placeholder: widgetLabels.sourceLocaleLabel,
+                    readOnly: true,
+                    allowClear: false,
+                    controlSize: "small",
+                    signalRoutes: {
+                        listens: [{
+                                routeKey: "editor-translations-source-locale",
+                                capabilityId: "change",
+                                scope: "area",
+                                channel: "text",
+                                action: "change",
+                                valueType: "string",
+                                receiver: createPhiSignalAddress("cms", PHI_EDITOR_TRANSLATIONS_SOURCE_LOCALE_WIDGET_ID),
+                            }],
+                    },
+                },
+            }),
+            nodes.widget({
+                id: PHI_EDITOR_TRANSLATIONS_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_LOCALIZATION_RUNTIME_DATA_PROVIDER_KEYS.table,
+                        resourceKey: "editorTranslations",
+                    },
+                    presentation: {
+                        layout: { mode: "auto", overflowX: "auto" },
+                        columns: [
+                            { key: "source", fieldKey: "source", title: widgetLabels.columns.source, sizing: { mode: "content", minWidth: 320, maxWidth: 480 } },
+                            { key: "sourceContext", fieldKey: "sourceContext", title: widgetLabels.columns.context, renderer: "code", sizing: { mode: "content", minWidth: 144 } },
+                            {
+                                key: "status",
+                                fieldKey: "status",
+                                title: widgetLabels.columns.status,
+                                renderer: "badge",
+                                valueMap: { missing: widgetLabels.rowStatus.missing, translated: widgetLabels.rowStatus.translated },
+                                sizing: { mode: "content", minWidth: 104 },
+                            },
+                            { key: "translation", fieldKey: "translation", title: widgetLabels.columns.translation, sizing: { mode: "fill", minWidth: 480 } },
+                            { key: "createdAt", fieldKey: "createdAt", title: widgetLabels.columns.created, renderer: "datetime", sizing: { mode: "content", minWidth: 168 } },
+                            { key: "updatedAt", fieldKey: "updatedAt", title: widgetLabels.columns.updated, renderer: "datetime", sizing: { mode: "content", minWidth: 168 } },
+                        ],
+                        emptyState: { title: widgetLabels.empty.title, description: widgetLabels.empty.text },
+                        controlSize: "small",
+                    },
+                    features: {
+                        search: { enabled: true, placeholder: widgetLabels.searchPlaceholder },
+                        filters: [
+                            {
+                                key: "locale",
+                                type: "select",
+                                label: widgetLabels.targetLocaleLabel,
+                                optionsProvider: { providerKey: PHI_LOCALIZATION_RUNTIME_DATA_PROVIDER_KEYS.siteLocales },
+                            },
+                            {
+                                key: "context",
+                                type: "select",
+                                label: widgetLabels.contextLabel,
+                                optionsProvider: { providerKey: PHI_LOCALIZATION_RUNTIME_DATA_PROVIDER_KEYS.translationContexts },
+                                defaultValue: "all",
+                            },
+                            {
+                                key: "status",
+                                type: "select",
+                                label: widgetLabels.statusLabel,
+                                options: [
+                                    { value: "all", label: widgetLabels.statuses.all },
+                                    { value: "missing", label: widgetLabels.statuses.missing },
+                                    { value: "translated", label: widgetLabels.statuses.translated },
+                                ],
+                                defaultValue: "all",
+                            },
+                        ],
+                        pagination: { enabled: true, pageSize: 25, pageSizes: [25, 50, 100] },
+                        sorting: { mode: "none" },
+                        tools: { mode: "self-contained", reset: true, reload: true },
+                        actions: {
+                            row: [
+                                {
+                                    key: "edit",
+                                    label: widgetLabels.actions.edit,
+                                    icon: "edit",
+                                    display: "icon",
+                                    execution: "signal",
+                                    disabledWhen: { source: "row", valuePath: "protected", operator: "truthy" },
+                                },
+                                {
+                                    key: "delete",
+                                    label: widgetLabels.actions.delete,
+                                    icon: "antd:delete",
+                                    display: "icon",
+                                    mode: "danger",
+                                    execution: "provider",
+                                    confirm: {
+                                        title: widgetLabels.delete.title,
+                                        description: widgetLabels.delete.description,
+                                        okText: widgetLabels.actions.delete,
+                                    },
+                                },
+                            ],
+                        },
+                    },
+                    initialQuery: { filters: { context: "", status: "all" } },
+                    signalRoutes: {
+                        emits: [
+                            {
+                                routeKey: "editor-translations-table-action",
+                                capabilityId: "actionActivate",
+                                scope: "page",
+                                channel: "action",
+                                action: "activate",
+                                valueType: "json",
+                                valueSchema: PHI_SIGNAL_VALUE_SCHEMAS.tableAction,
+                                receiver: createPhiLocalizationControllerAddress(),
+                            },
+                            {
+                                routeKey: "editor-translations-table-query",
+                                capabilityId: "queryChange",
+                                scope: "page",
+                                channel: "query",
+                                action: "change",
+                                valueType: "json",
+                                valueSchema: PHI_SIGNAL_VALUE_SCHEMAS.tableQuery,
+                                receiver: createPhiLocalizationControllerAddress(),
+                            },
+                        ],
+                        listens: [
+                            {
+                                routeKey: "editor-translations-table-filters",
+                                capabilityId: "filtersChange",
+                                scope: "page",
+                                channel: "filters",
+                                action: "change",
+                                valueType: "json",
+                                valueSchema: PHI_SIGNAL_VALUE_SCHEMAS.tableFilters,
+                                receiver: createPhiSignalAddress("cms", PHI_EDITOR_TRANSLATIONS_WIDGET_ID),
+                            },
+                            {
+                                routeKey: "editor-translations-table-reload",
+                                capabilityId: "reload",
+                                scope: "page",
+                                channel: "reload",
+                                action: "activate",
+                                valueType: "none",
+                                receiver: createPhiSignalAddress("cms", PHI_EDITOR_TRANSLATIONS_WIDGET_ID),
+                            },
+                        ],
+                    },
+                },
+            }),
+            nodes.widget({
+                id: PHI_EDITOR_TRANSLATION_FORM_WIDGET_ID,
+                parentLayoutNodeId: PHI_EDITOR_TRANSLATION_OVERLAY_LAYOUT_ID,
+                typeKey: "form",
+                slotIndex: PHI_CMS_DEFAULT_SLOT_INDEX,
+                sortOrder: 10,
+                label: "editor translation form",
+                config: {
+                    formId: PHI_LOCALIZATION_FORM_IDS.editorTranslation,
+                    source: {
+                        providerKey: PHI_LOCALIZATION_RUNTIME_DATA_PROVIDER_KEYS.table,
+                        resourceKey: "editorTranslations",
+                    },
+                    openActionKey: "edit",
+                    signalRoutes: {
+                        emits: [
+                            { routeKey: "editor-translations-form-submit-success", capabilityId: "submitSuccess", scope: "page", channel: "submit", action: "activate", valueType: "json", valueSchema: PHI_SIGNAL_VALUE_SCHEMAS.formResult, receiver: createPhiLocalizationControllerAddress() },
+                            { routeKey: "editor-translations-form-submitting", capabilityId: "submitting", scope: "page", channel: "submitting", action: "change", valueType: "boolean", receiver: createPhiLocalizationControllerAddress() },
+                        ],
+                        listens: [
+                            { routeKey: "editor-translations-form-open", capabilityId: "recordOpen", scope: "page", channel: "action", action: "activate", valueType: "json", valueSchema: PHI_SIGNAL_VALUE_SCHEMAS.tableAction, receiver: createPhiSignalAddress("cms", PHI_EDITOR_TRANSLATION_FORM_WIDGET_ID) },
+                            { routeKey: "editor-translations-form-submit", capabilityId: "submit", scope: "page", channel: "submit", action: "activate", valueType: "none", receiver: createPhiSignalAddress("cms", PHI_EDITOR_TRANSLATION_FORM_WIDGET_ID) },
+                            { routeKey: "editor-translations-form-reset", capabilityId: "reset", scope: "page", channel: "reset", action: "activate", valueType: "none", receiver: createPhiSignalAddress("cms", PHI_EDITOR_TRANSLATION_FORM_WIDGET_ID) },
+                        ],
+                    },
+                },
+            }),
+            nodes.widget({
+                id: PHI_EDITOR_TRANSLATION_COMMANDS_WIDGET_ID,
+                parentLayoutNodeId: PHI_EDITOR_TRANSLATION_OVERLAY_FOOTER_LAYOUT_ID,
+                typeKey: "command-toolbar",
+                slotIndex: PHI_CMS_DEFAULT_SLOT_INDEX,
+                sortOrder: 0,
+                label: "editor translation commands",
+                config: {
+                    key: "editor-translation-commands",
+                    compact: false,
+                    wrap: true,
+                    showLabels: true,
+                    controlSize: "medium",
+                    buttons: [
+                        { key: "cancel", emits: [{ capabilityId: "command", value: "cancel" }], actionKey: "cancel", label: widgetLabels.actions.cancel },
+                        { key: "save", emits: [{ capabilityId: "command", value: "save" }], actionKey: "save", label: widgetLabels.actions.save, variant: "primary" },
+                    ],
+                    signalRoutes: {
+                        emits: [{
+                                routeKey: "editor-translation-command",
+                                capabilityId: "command",
+                                scope: "page",
+                                channel: "command",
+                                action: "activate",
+                                valueType: "string",
+                                receiver: createPhiLocalizationControllerAddress(),
+                            }],
+                        listens: [{
+                                routeKey: "editor-translation-save-loading",
+                                capabilityId: "loading",
+                                scope: "page",
+                                channel: "submitting",
+                                action: "change",
+                                valueType: "boolean",
+                                receiver: createPhiSignalSubcontrolAddress("cms", PHI_EDITOR_TRANSLATION_COMMANDS_WIDGET_ID, "save"),
+                            }],
+                    },
+                },
+            }),
+        ],
+    };
+}

package/plugins/runtime-modules/news/authoring-widgets.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("react").ComponentType<import("../client-authoring-widget-module").PhiAuthoringWidgetModuleProps>;
+export default _default;

package/plugins/runtime-modules/news/authoring-widgets.js

@@ -0,0 +1,7 @@
+"use client";
+import { createPhiAuthoringWidgetModule, definePhiAuthoringWidgetModuleLoader, } from "../client-authoring-widget-module";
+import { PHI_NEWS_LIST_WIDGET_DEFINITION } from "./widgets/news-list/config";
+export default createPhiAuthoringWidgetModule([
+    definePhiAuthoringWidgetModuleLoader(PHI_NEWS_LIST_WIDGET_DEFINITION, () => import("./widgets/news-list/authoring")
+        .then((module) => module.PHI_NEWS_LIST_WIDGET_BUILDER_PLUGIN)),
+]);

package/plugins/runtime-modules/news/authoring.d.ts

@@ -0,0 +1 @@
+export declare const PhiNewsRuntimeModuleAuthoringClient: import("react").ComponentType<import("../contracts").PhiRuntimeModuleAuthoringClientProps>;

package/plugins/runtime-modules/news/authoring.js

@@ -0,0 +1,8 @@
+"use client";
+import WidgetModule from "./authoring-widgets";
+import { createPhiRuntimeModuleAuthoringClient } from "../client-authoring-module";
+import { PHI_NEWS_RUNTIME_MODULE_ID } from "./ids";
+export const PhiNewsRuntimeModuleAuthoringClient = createPhiRuntimeModuleAuthoringClient({
+    moduleId: PHI_NEWS_RUNTIME_MODULE_ID,
+    WidgetModule,
+});

package/plugins/runtime-modules/news/client-data-providers.d.ts

@@ -0,0 +1,11 @@
+export declare const PHI_NEWS_RUNTIME_DATA_PROVIDER_CLIENT_DEFINITIONS: readonly [{
+    readonly key: `${string}/${string}`;
+    readonly ownerModuleId: "@phis/ui/modules/news";
+    readonly loadLive: () => Promise<typeof import("./services/table").PhiNewsTableProviderClient>;
+}, {
+    readonly key: `${string}/${string}`;
+    readonly ownerModuleId: "@phis/ui/modules/news";
+    readonly loadLive: () => Promise<import("react").ComponentType<{
+        children: import("react").ReactNode;
+    }>>;
+}];

package/plugins/runtime-modules/news/client-data-providers.js

@@ -0,0 +1,14 @@
+"use client";
+import { PHI_NEWS_RUNTIME_DATA_PROVIDER_KEYS, PHI_NEWS_RUNTIME_MODULE_ID } from "./ids";
+export const PHI_NEWS_RUNTIME_DATA_PROVIDER_CLIENT_DEFINITIONS = [
+    {
+        key: PHI_NEWS_RUNTIME_DATA_PROVIDER_KEYS.table,
+        ownerModuleId: PHI_NEWS_RUNTIME_MODULE_ID,
+        loadLive: async () => (await import("./services/table")).PhiNewsTableProviderClient,
+    },
+    {
+        key: PHI_NEWS_RUNTIME_DATA_PROVIDER_KEYS.tags,
+        ownerModuleId: PHI_NEWS_RUNTIME_MODULE_ID,
+        loadLive: async () => (await import("./services/options")).PhiNewsTagsOptionsProviderClient,
+    },
+];

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

@@ -0,0 +1,133 @@
+/**
+ * The Site's News entries, and the tags it already uses.
+ *
+ * Both are `live`: they are the Site's own records, read at runtime, not constants this package ships.
+ * Both are `authoringMode: "none"`, because the Builder has no business pulling editorial data while
+ * somebody is composing a Page -- what a Table looks like there is a question for the preview.
+ *
+ * The rows come from `GET /api/site/editor/news`, which is behind the content-editing guard. That is the
+ * whole access story: a Table bound to this resource on a Page nobody may edit answers nothing, because
+ * Core refuses the read rather than because the Widget was kept out.
+ */
+export declare const PHI_NEWS_RUNTIME_DATA_PROVIDER_DESCRIPTORS: ({
+    key: `${string}/${string}`;
+    ownerModuleId: "@phis/ui/modules/news";
+    kind: "table";
+    executionMode: "live";
+    authoringMode: "none";
+    title: string;
+    description: string;
+    resources: {
+        resourceKey: string;
+        title: string;
+        rowIdentityPath: string;
+        fields: ({
+            key: string;
+            title: string;
+            type: "number";
+            required: true;
+            options?: undefined;
+            mutable?: undefined;
+            optionsProvider?: undefined;
+        } | {
+            key: string;
+            title: string;
+            type: "string";
+            required: true;
+            options?: undefined;
+            mutable?: undefined;
+            optionsProvider?: undefined;
+        } | {
+            key: string;
+            title: string;
+            type: "string";
+            required?: undefined;
+            options?: undefined;
+            mutable?: undefined;
+            optionsProvider?: undefined;
+        } | {
+            key: string;
+            title: string;
+            type: "enum";
+            options: {
+                value: string;
+                label: string;
+            }[];
+            required?: undefined;
+            mutable?: undefined;
+            optionsProvider?: undefined;
+        } | {
+            key: string;
+            title: string;
+            type: "boolean";
+            required?: undefined;
+            options?: undefined;
+            mutable?: undefined;
+            optionsProvider?: undefined;
+        } | {
+            key: string;
+            title: string;
+            type: "enum[]";
+            mutable: true;
+            optionsProvider: {
+                providerKey: `${string}/${string}`;
+            };
+            required?: undefined;
+            options?: undefined;
+        } | {
+            key: string;
+            title: string;
+            type: "datetime";
+            required?: undefined;
+            options?: undefined;
+            mutable?: undefined;
+            optionsProvider?: undefined;
+        })[];
+        query: {
+            search: true;
+            filterFields: string[];
+            sorting: "none";
+            pagination: "offset";
+            facets: string[];
+        };
+        recordRead: true;
+        actions: ({
+            key: string;
+            title: string;
+            scope: "row";
+            disabledWhen: {
+                match: "any";
+                conditions: {
+                    source: "row";
+                    valuePath: string;
+                    operator: "falsy";
+                }[];
+            };
+            confirmation: "required";
+            intent?: undefined;
+        } | {
+            key: string;
+            title: string;
+            scope: "row";
+            intent: "destructive";
+            confirmation: "required";
+            disabledWhen?: undefined;
+        } | {
+            key: string;
+            title: string;
+            scope: "resource";
+            disabledWhen?: undefined;
+            confirmation?: undefined;
+            intent?: undefined;
+        })[];
+    }[];
+} | {
+    key: `${string}/${string}`;
+    ownerModuleId: "@phis/ui/modules/news";
+    kind: "options";
+    executionMode: "live";
+    authoringMode: "none";
+    title: string;
+    description: string;
+    resources?: undefined;
+})[];

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

@@ -0,0 +1,112 @@
+import { PHI_NEWS_RUNTIME_DATA_PROVIDER_KEYS, PHI_NEWS_RUNTIME_MODULE_ID, PHI_NEWS_TABLE_RESOURCE_KEY, } from "./ids";
+/**
+ * The Site's News entries, and the tags it already uses.
+ *
+ * Both are `live`: they are the Site's own records, read at runtime, not constants this package ships.
+ * Both are `authoringMode: "none"`, because the Builder has no business pulling editorial data while
+ * somebody is composing a Page -- what a Table looks like there is a question for the preview.
+ *
+ * The rows come from `GET /api/site/editor/news`, which is behind the content-editing guard. That is the
+ * whole access story: a Table bound to this resource on a Page nobody may edit answers nothing, because
+ * Core refuses the read rather than because the Widget was kept out.
+ */
+export const PHI_NEWS_RUNTIME_DATA_PROVIDER_DESCRIPTORS = [
+    {
+        key: PHI_NEWS_RUNTIME_DATA_PROVIDER_KEYS.table,
+        ownerModuleId: PHI_NEWS_RUNTIME_MODULE_ID,
+        kind: "table",
+        executionMode: "live",
+        authoringMode: "none",
+        title: "News entries",
+        description: "The Site's news entries, as the editor sees them.",
+        resources: [
+            {
+                resourceKey: PHI_NEWS_TABLE_RESOURCE_KEY,
+                title: "News entries",
+                rowIdentityPath: "contentId",
+                fields: [
+                    { key: "contentId", title: "ID", type: "number", required: true },
+                    { key: "slug", title: "Address", type: "string", required: true },
+                    { key: "title", title: "Title", type: "string" },
+                    { key: "subtitle", title: "Subtitle", type: "string" },
+                    { key: "content", title: "Body", type: "string" },
+                    /*
+                     * A word, not the store's number. `badge` can only render a `string` or an `enum`, and a column
+                     * that draws a status is the reason the field exists -- so the service says `draft` where the
+                     * row says `0`, which is also what the status filter sends.
+                     */
+                    {
+                        key: "status",
+                        title: "Status",
+                        type: "enum",
+                        /*
+                         * The vocabulary, not the words a reader sees: those come from the column's `valueMap`, in the
+                         * page's language. Stated here because an `enum` field must name its option source, and because
+                         * a Site binding another Widget to this resource should be able to read what the values are.
+                         */
+                        options: [
+                            { value: "draft", label: "Draft" },
+                            { value: "published", label: "Published" },
+                        ],
+                    },
+                    { key: "sourceLocale", title: "Written in", type: "string" },
+                    { key: "translate", title: "May be translated", type: "boolean" },
+                    /*
+                     * `enum[]` with the offer beside it: a tag is picked, not typed. What the options provider
+                     * answers is the set the Site already uses, so the field's choices are the Site's own history.
+                     */
+                    {
+                        key: "tags",
+                        title: "Tags",
+                        type: "enum[]",
+                        mutable: true,
+                        optionsProvider: { providerKey: PHI_NEWS_RUNTIME_DATA_PROVIDER_KEYS.tags },
+                    },
+                    { key: "link", title: "Link", type: "string" },
+                    { key: "publishedAt", title: "Published", type: "datetime" },
+                    { key: "expiresAt", title: "Expires", type: "datetime" },
+                    { key: "updatedAt", title: "Changed", type: "datetime" },
+                    { key: "hasUnpublishedChanges", title: "Unpublished changes", type: "boolean" },
+                ],
+                query: {
+                    search: true,
+                    filterFields: ["status"],
+                    sorting: "none",
+                    pagination: "offset",
+                    facets: ["tags"],
+                },
+                recordRead: true,
+                /*
+                 * What an entry can have done to it without opening a form. Saving and publishing both state
+                 * values -- words, dates -- so they are Forms; these three state nothing.
+                 *
+                 * `delete` is refused by Core while an entry is published, and that refusal arrives here as a
+                 * rejected mutation with its reason. Disabling it in the row as well would be a second answer to
+                 * the same question, and the one drawn from a stale row.
+                 */
+                actions: [
+                    {
+                        key: "withdraw",
+                        title: "Withdraw",
+                        scope: "row",
+                        disabledWhen: { match: "any", conditions: [
+                                { source: "row", valuePath: "publishedAt", operator: "falsy" },
+                            ] },
+                        confirmation: "required",
+                    },
+                    { key: "delete", title: "Delete", scope: "row", intent: "destructive", confirmation: "required" },
+                    { key: "refresh", title: "Refresh", scope: "resource" },
+                ],
+            },
+        ],
+    },
+    {
+        key: PHI_NEWS_RUNTIME_DATA_PROVIDER_KEYS.tags,
+        ownerModuleId: PHI_NEWS_RUNTIME_MODULE_ID,
+        kind: "options",
+        executionMode: "live",
+        authoringMode: "none",
+        title: "News tags",
+        description: "The tags this Site's news entries already carry.",
+    },
+];