@phis/ui 0.4.1 → 0.4.3

package/plugins/runtime-modules/core/widgets/tree/config.js

@@ -56,11 +56,14 @@ function readBindingTools(value) {
     });
 }
 function readSource(value) {
-    if (!isPhiRecord(value) || !isPhiRuntimeDataProviderKey(value.providerKey) || !readString(value.resourceKey))
+    if (!isPhiRecord(value) || !isPhiRuntimeDataProviderKey(value.providerKey))
+        return null;
+    const resourceKey = readString(value.resourceKey);
+    if (!resourceKey)
         return null;
     return {
         providerKey: value.providerKey,
-        resourceKey: readString(value.resourceKey),
+        resourceKey,
         params: isPhiRecord(value.params) ? value.params : undefined,
     };
 }

package/plugins/runtime-modules/dashboard/card-rows.d.ts

@@ -0,0 +1,5 @@
+import { type PhiDashboardCardPayload, type PhiDashboardCardRow } from "../../../types/dashboard-cards";
+/** The card rows a list answer carries, or a Collection holds. */
+export declare function readPhiDashboardCardRows(value: unknown, source?: string): PhiDashboardCardRow[];
+/** One card's refreshed payload. */
+export declare function readPhiDashboardCardPayload(value: unknown): PhiDashboardCardPayload;

package/plugins/runtime-modules/dashboard/card-rows.js

@@ -0,0 +1,59 @@
+import { readPhiTimelineEntry } from "@phis/contracts/timeline";
+import { isPhiDashboardCardId, } from "../../../types/dashboard-cards";
+import { createPhiResponseReader, requirePhiField, } from "../../../components/widgets/config/strict-config-reader";
+/*
+ * The Dashboard's rows and payloads, read as the Site's door writes them (`gateway/dashboard-cards-route.ts`).
+ *
+ * Both came in by cast: the list's rows as "an object, so a row", and a refreshed payload as whatever
+ * the door answered. A row without its title then disappeared without a word, and a payload of the wrong
+ * shape rendered as an empty card. Read field by field now, a wrong answer is an error naming the field,
+ * which the Collection shows as the card list's error.
+ */
+const PHI_DASHBOARD_CARD_FORMS = ["stat", "list"];
+function readCardId(reader) {
+    return requirePhiField(reader, "cardId", "a Dashboard card id", (key) => reader.value(key, "a Dashboard card id", (value) => (isPhiDashboardCardId(value) ? value : undefined)));
+}
+function readTimelineEntry(reader, index) {
+    return readPhiTimelineEntry(reader.record) ?? reader.fail(String(index), "a timeline entry with a key", reader.record);
+}
+function readPayloadFields(reader) {
+    const value = reader.string("value");
+    const entries = reader.list("entries", readTimelineEntry);
+    const description = reader.string("description");
+    const meta = reader.string("meta");
+    const error = reader.string("error");
+    return {
+        cardId: readCardId(reader),
+        ...(value === undefined ? {} : { value }),
+        ...(entries === undefined ? {} : { entries }),
+        ...(description === undefined ? {} : { description }),
+        ...(meta === undefined ? {} : { meta }),
+        ...(error === undefined ? {} : { error }),
+        resolvedAt: requirePhiField(reader, "resolvedAt", "an instant", reader.string),
+    };
+}
+function readRowFields(reader) {
+    const eyebrow = reader.string("eyebrow");
+    const description = reader.string("description");
+    const mark = reader.string("mark");
+    const href = reader.string("href");
+    const payload = reader.object("payload", readPayloadFields);
+    return {
+        cardId: readCardId(reader),
+        form: requirePhiField(reader, "form", '"stat" or "list"', (key) => reader.oneOf(key, PHI_DASHBOARD_CARD_FORMS)),
+        title: requirePhiField(reader, "title", "a text", reader.string),
+        ...(eyebrow === undefined ? {} : { eyebrow }),
+        ...(description === undefined ? {} : { description }),
+        ...(mark === undefined ? {} : { mark }),
+        ...(href === undefined ? {} : { href }),
+        ...(payload === undefined ? {} : { payload }),
+    };
+}
+/** The card rows a list answer carries, or a Collection holds. */
+export function readPhiDashboardCardRows(value, source = "The Dashboard card list") {
+    return createPhiResponseReader({ cards: value }, source).list("cards", readRowFields) ?? [];
+}
+/** One card's refreshed payload. */
+export function readPhiDashboardCardPayload(value) {
+    return readPayloadFields(createPhiResponseReader(value, "The Dashboard card"));
+}

package/plugins/runtime-modules/dashboard/clients/dashboard-card-view.js

@@ -9,8 +9,8 @@ import { PHI_SURFACE_CARD } from "../../../../helpers/surface-presets";
 import { PhiCollectionViewControl } from "../../../../components/controls/phi-collection-view-control";
 import { PhiAlertControl } from "../../../../components/controls/phi-alert-control";
 import { PhiEmptyControl } from "../../../../components/controls/phi-empty-control";
-import { isPhiRecord } from "../../../../helpers/is-record";
 import { usePhiPathname } from "../../../../components/runtime/use-phi-pathname";
+import { readPhiDashboardCardPayload, readPhiDashboardCardRows } from "../card-rows";
 import { PhiTimelineControl } from "../../../../components/controls/phi-timeline-control";
 import { usePhiIntlLocale } from "../../../../components/root/phi-intl-locale";
 import { formatPhiRelativeTime } from "../../../../helpers/format-date-time";
@@ -63,10 +63,8 @@ function PhiDashboardCardList({ entries }) {
         })) }));
 }
 function readRows(binding) {
-    return (binding.data?.items ?? [])
-        .filter(isPhiRecord)
-        .map((item) => item)
-        .filter((row) => typeof row.cardId === "string" && typeof row.title === "string");
+    // A Collection holds items of no particular type; the rows are read again, not cast.
+    return readPhiDashboardCardRows(binding.data?.items ?? [], "The Dashboard Collection");
 }
 /**
  * One card, and its own request where the list did not bring its payload.
@@ -106,7 +104,7 @@ function PhiDashboardCard({ row, area, pathname, }) {
             if (!response.ok) {
                 throw new Error(`Card payload request failed (${response.status}).`);
             }
-            return (await response.json());
+            return readPhiDashboardCardPayload(await response.json());
         })
             .then((payload) => setResolved({ key: requestKey, payload, failure: null }))
             .catch((error) => {

package/plugins/runtime-modules/dashboard/services/collection.js

@@ -3,13 +3,22 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { useMemo } from "react";
 import { PHI_DASHBOARD_CARD_DATA_PROVIDER_KEY, PHI_DASHBOARD_CARD_ITEM_RENDERER_KEY, PHI_DASHBOARD_CARD_RESOURCE_KEY, } from "../../../../constants/dashboard-card-provider-keys";
 import { PhiCollectionProviderClient, } from "../../../../components/widgets/client/shared/phi-collection-provider";
+import { readPhiDashboardCardRows } from "../card-rows";
 import { isPhiRecord } from "../../../../helpers/is-record";
 import { usePhiPathname } from "../../../../components/runtime/use-phi-pathname";
-function readCardRows(payload) {
-    return Array.isArray(payload.cards)
-        ? payload.cards.filter(isPhiRecord).map((card) => ({ ...card }))
-        : [];
-}
+/**
+ * The fan-in, from the browser's side: one request, and no idea what stands behind it.
+ *
+ * Everything that decides which cards exist -- the Area's Module catalog, each contributor's own list,
+ * who is looking -- is server knowledge, so this asks the Site's own door and passes the answer on as
+ * ordinary Collection rows. That is the whole reason the door exists: a Module definition must never
+ * reach the browser, and a provider that collected the contributions here would drag every one of them
+ * in with it.
+ *
+ * It sends where it stands. The Area is config, because a page belongs to one and the preset that
+ * placed this Widget knows which; the path is read live, because that is what changes when a Site puts
+ * a Dashboard somewhere else.
+ */
 async function queryDashboardCards(request, pathname) {
     if (request.resourceKey !== PHI_DASHBOARD_CARD_RESOURCE_KEY) {
         throw new Error(`Unknown Dashboard collection "${request.resourceKey}".`);
@@ -36,10 +45,11 @@ async function queryDashboardCards(request, pathname) {
         if (!response.ok) {
             throw new Error(`Dashboard cards request failed (${response.status}).`);
         }
-        const rows = readCardRows((await response.json()));
+        const payload = await response.json();
+        const rows = readPhiDashboardCardRows(isPhiRecord(payload) ? payload.cards : undefined);
         return {
             resourceKey: request.resourceKey,
-            items: rows,
+            items: rows.map((row) => ({ ...row })),
             total: rows.length,
             loading: false,
             error: null,

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

@@ -98,6 +98,7 @@ export declare const PHI_GROUPS_RUNTIME_DATA_PROVIDER_DESCRIPTORS: ({
             search: false;
             sorting: "none";
             pagination: "offset";
+            total: true;
             filterFields?: undefined;
         };
         actions: ({
@@ -210,6 +211,7 @@ export declare const PHI_GROUPS_RUNTIME_DATA_PROVIDER_DESCRIPTORS: ({
             filterFields: string[];
             sorting: "none";
             pagination: "offset";
+            total: true;
             search?: undefined;
         };
         actions: {

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

@@ -117,7 +117,7 @@ export const PHI_GROUPS_RUNTIME_DATA_PROVIDER_DESCRIPTORS = [
                     { key: "spaceUsedBytes", title: "Space used", type: "number" },
                     { key: "spaceQuotaBytes", title: "Space quota", type: "number" },
                 ],
-                query: { search: false, sorting: "none", pagination: "offset" },
+                query: { search: false, sorting: "none", pagination: "offset", total: true },
                 actions: [
                     { key: "refresh", title: "Refresh", scope: "resource" },
                     { key: "create", title: "Create", scope: "resource", valueType: "json" },
@@ -196,7 +196,7 @@ export const PHI_GROUPS_RUNTIME_DATA_PROVIDER_DESCRIPTORS = [
                     { key: "spaceUsedBytes", title: "Space used", type: "number" },
                     { key: "spaceQuotaBytes", title: "Space quota", type: "number" },
                 ],
-                query: { search: false, sorting: "none", pagination: "offset" },
+                query: { search: false, sorting: "none", pagination: "offset", total: true },
                 actions: [
                     { key: "refresh", title: "Refresh", scope: "resource" },
                     // A Manager runs the team and may end it. Putting one back is not offered here, because a
@@ -246,7 +246,7 @@ export const PHI_GROUPS_RUNTIME_DATA_PROVIDER_DESCRIPTORS = [
                     { key: "sourceProviderId", title: "Source", type: "string" },
                     { key: "createdAt", title: "Since", type: "datetime" },
                 ],
-                query: { filterFields: ["groupId"], sorting: "none", pagination: "offset" },
+                query: { filterFields: ["groupId"], sorting: "none", pagination: "offset", total: true },
                 actions: [
                     {
                         key: "delete", title: "Remove", scope: "row",

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

@@ -110,6 +110,7 @@ export declare const PHI_GROUPS_RUNTIME_MODULE_DEFINITION: {
                 search: false;
                 sorting: "none";
                 pagination: "offset";
+                total: true;
                 filterFields?: undefined;
             };
             actions: ({
@@ -222,6 +223,7 @@ export declare const PHI_GROUPS_RUNTIME_MODULE_DEFINITION: {
                 filterFields: string[];
                 sorting: "none";
                 pagination: "offset";
+                total: true;
                 search?: undefined;
             };
             actions: {

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

@@ -57,6 +57,7 @@ export declare const PHI_LOCALIZATION_RUNTIME_DATA_PROVIDER_DESCRIPTORS: ({
             filterFields: never[];
             sorting: "none";
             pagination: "none";
+            total?: undefined;
             facets?: undefined;
         };
         recordRead: true;
@@ -128,6 +129,7 @@ export declare const PHI_LOCALIZATION_RUNTIME_DATA_PROVIDER_DESCRIPTORS: ({
             filterFields: string[];
             sorting: "none";
             pagination: "offset";
+            total: true;
             facets: string[];
         };
         actions: ({
@@ -206,6 +208,7 @@ export declare const PHI_LOCALIZATION_RUNTIME_DATA_PROVIDER_DESCRIPTORS: ({
             filterFields: string[];
             sorting: "none";
             pagination: "offset";
+            total: true;
             facets: string[];
         };
         recordRead: true;

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

@@ -107,6 +107,7 @@ export const PHI_LOCALIZATION_RUNTIME_DATA_PROVIDER_DESCRIPTORS = [
                     filterFields: ["locale"],
                     sorting: "none",
                     pagination: "offset",
+                    total: true,
                     facets: ["site", "platformLocales", "selectedLocale"],
                 },
                 actions: [
@@ -146,6 +147,7 @@ export const PHI_LOCALIZATION_RUNTIME_DATA_PROVIDER_DESCRIPTORS = [
                     filterFields: ["locale", "context", "status"],
                     sorting: "none",
                     pagination: "offset",
+                    total: true,
                     facets: ["selectedLocale", "availableLocales", "contexts"],
                 },
                 recordRead: true,

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

@@ -85,6 +85,7 @@ export declare const PHI_LOCALIZATION_RUNTIME_MODULE_DEFINITION: {
                 filterFields: never[];
                 sorting: "none";
                 pagination: "none";
+                total?: undefined;
                 facets?: undefined;
             };
             recordRead: true;
@@ -156,6 +157,7 @@ export declare const PHI_LOCALIZATION_RUNTIME_MODULE_DEFINITION: {
                 filterFields: string[];
                 sorting: "none";
                 pagination: "offset";
+                total: true;
                 facets: string[];
             };
             actions: ({
@@ -234,6 +236,7 @@ export declare const PHI_LOCALIZATION_RUNTIME_MODULE_DEFINITION: {
                 filterFields: string[];
                 sorting: "none";
                 pagination: "offset";
+                total: true;
                 facets: string[];
             };
             recordRead: true;

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

@@ -37,12 +37,8 @@ async function loadSiteTranslations({ query, signal, }) {
     }));
     return {
         rows,
-        total: typeof translations.total === "number" ? translations.total : rows.length,
-        summary: {
-            localeTotal: typeof translations.localeTotal === "number"
-                ? translations.localeTotal
-                : rows.length,
-        },
+        total: typeof translations.total === "number" ? translations.total : undefined,
+        summary: typeof translations.localeTotal === "number" ? { localeTotal: translations.localeTotal } : {},
         resolvedQuery: selectedLocale
             ? { filters: { locale: selectedLocale } }
             : undefined,
@@ -74,7 +70,7 @@ async function loadEditorTranslations({ query, signal, }) {
     const site = isPhiRecord(result?.site) ? result.site : {};
     return {
         rows,
-        total: typeof translations.total === "number" ? translations.total : rows.length,
+        total: typeof translations.total === "number" ? translations.total : undefined,
         resolvedQuery: selectedLocale
             ? { filters: { locale: selectedLocale } }
             : undefined,

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

@@ -41,6 +41,7 @@ export declare const PHI_OBSERVABILITY_RUNTIME_DATA_PROVIDER_DESCRIPTORS: {
             filterFields: string[];
             sorting: "none";
             pagination: "offset";
+            total: true;
         };
         recordRead: true;
     }[];

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

@@ -39,6 +39,7 @@ export const PHI_OBSERVABILITY_RUNTIME_DATA_PROVIDER_DESCRIPTORS = [
                     filterFields: ["service", "level", "event", "area", "since"],
                     sorting: "none",
                     pagination: "offset",
+                    total: true,
                 },
                 recordRead: true,
             }],

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

@@ -49,6 +49,7 @@ export declare const PHI_OBSERVABILITY_RUNTIME_MODULE_DEFINITION: {
                 filterFields: string[];
                 sorting: "none";
                 pagination: "offset";
+                total: true;
             };
             recordRead: true;
         }[];

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

@@ -49,6 +49,7 @@ export declare const PHI_OBSERVABILITY_RUNTIME_MODULE: {
                 filterFields: string[];
                 sorting: "none";
                 pagination: "offset";
+                total: true;
             };
             recordRead: true;
         }[];

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

@@ -44,7 +44,7 @@ async function loadRows({ resourceKey, query, signal, }) {
     const rows = readPhiTableRows(payload.rows);
     return {
         rows,
-        total: typeof payload.total === "number" && Number.isFinite(payload.total) ? payload.total : rows.length,
+        total: typeof payload.total === "number" && Number.isFinite(payload.total) ? payload.total : undefined,
     };
 }
 async function readRecord({ resourceKey, rowIdentity, signal, }) {

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

@@ -17,8 +17,6 @@ import { PHI_DEFAULT_PUB_AREA_LAYOUT_NODE_KEYS, PHI_DEFAULT_PUB_AREA_WIDGET_NODE
 const SYNTHETIC_REGION_IDS = {
     regionHeaderTop: -1,
     regionHeaderMain: -2,
-    regionHeaderBottom: -3,
-    regionSiderRight: -24,
     regionFooterTop: -27,
     regionFooterMain: -28,
     regionFooterBottom: -33,
@@ -34,11 +32,8 @@ export async function buildPhiDefaultSiteAreaPresetTree({ page, runtime, presetK
         ownerModuleId,
         presetKey,
     }, PHI_DEFAULT_PUB_AREA_WIDGET_NODE_KEYS);
-    const navigationArea = runtimeModuleArea === "public" ? "public" : runtimeModuleArea;
     const headerMainRegion = PHI_DEFAULT_PUB_AREA_PRESET.regions.find((region) => region.key === "header_main");
     const headerTopRegion = PHI_DEFAULT_PUB_AREA_PRESET.regions.find((region) => region.key === "header_top");
-    const headerBottomRegion = PHI_DEFAULT_PUB_AREA_PRESET.regions.find((region) => region.key === "header_bottom");
-    const siderRightRegion = PHI_DEFAULT_PUB_AREA_PRESET.regions.find((region) => region.key === "sider_right");
     const footerMainRegion = PHI_DEFAULT_PUB_AREA_PRESET.regions.find((region) => region.key === "footer_main");
     const footerTopRegion = PHI_DEFAULT_PUB_AREA_PRESET.regions.find((region) => region.key === "footer_top");
     const footerBottomRegion = PHI_DEFAULT_PUB_AREA_PRESET.regions.find((region) => region.key === "footer_bottom");
@@ -68,19 +63,6 @@ export async function buildPhiDefaultSiteAreaPresetTree({ page, runtime, presetK
         family: "header",
         region: "main",
     });
-    const shellHeaderBottomHeight = resolvePhiShellHeaderHeight(runtime.site.theme?.shell, "bottom");
-    const shellHeaderBottomOffsetTop = resolvePhiShellMetric(runtime.site.theme?.shell, "offsetTop", {
-        family: "header",
-        region: "bottom",
-    });
-    const shellSiderRightWidth = resolvePhiShellMetric(runtime.site.theme?.shell, "width", {
-        family: "sider",
-        region: "right",
-    });
-    const shellSiderRightOffsetTop = resolvePhiShellMetric(runtime.site.theme?.shell, "offsetTop", {
-        family: "sider",
-        region: "right",
-    });
     const shellFooterMainHeight = resolvePhiShellMetric(runtime.site.theme?.shell, "height", {
         family: "footer",
         region: "main",
@@ -135,44 +117,6 @@ export async function buildPhiDefaultSiteAreaPresetTree({ page, runtime, presetK
                     }),
                 ]
                 : []),
-            ...(headerBottomRegion
-                ? [
-                    nodes.region({
-                        id: SYNTHETIC_REGION_IDS.regionHeaderBottom,
-                        regionType: PhiCmsRegionType.HeaderBottom,
-                        rootLayoutNodeId: PHI_DEFAULT_PUB_AREA_LAYOUT_IDS.layoutHeaderBottom,
-                        status: headerBottomRegion.status,
-                        flags: headerBottomRegion.flags,
-                        visibilityMask: headerBottomRegion.visibilityMask,
-                        sortOrder: headerBottomRegion.sortOrder,
-                        config: {
-                            ...headerBottomRegion.config,
-                            size: { ...(headerBottomRegion.config.size ?? {}), height: `${shellHeaderBottomHeight}px` },
-                            ...(typeof shellHeaderBottomOffsetTop === "number" ? { offsetTop: shellHeaderBottomOffsetTop } : {}),
-                        },
-                    }),
-                ]
-                : []),
-            ...(siderRightRegion
-                ? [
-                    nodes.region({
-                        id: SYNTHETIC_REGION_IDS.regionSiderRight,
-                        regionType: PhiCmsRegionType.SiderRight,
-                        rootLayoutNodeId: PHI_DEFAULT_PUB_AREA_LAYOUT_IDS.layoutSiderRight,
-                        status: siderRightRegion.status,
-                        flags: siderRightRegion.flags,
-                        visibilityMask: siderRightRegion.visibilityMask,
-                        sortOrder: siderRightRegion.sortOrder,
-                        config: {
-                            ...siderRightRegion.config,
-                            ...(typeof shellSiderRightWidth === "number"
-                                ? { size: { ...(siderRightRegion.config.size ?? {}), width: `${shellSiderRightWidth}px` } }
-                                : {}),
-                            ...(typeof shellSiderRightOffsetTop === "number" ? { offsetTop: shellSiderRightOffsetTop } : {}),
-                        },
-                    }),
-                ]
-                : []),
             ...(footerTopRegion
                 ? [
                     nodes.region({
@@ -295,53 +239,6 @@ export async function buildPhiDefaultSiteAreaPresetTree({ page, runtime, presetK
                     paddingRight: 0,
                 },
             },
-            ...(headerBottomRegion
-                ? [
-                    {
-                        id: PHI_DEFAULT_PUB_AREA_LAYOUT_IDS.layoutHeaderBottom,
-                        siteId: page.siteId,
-                        parentLayoutNodeId: null,
-                        widgetType: buildPhiCmsLayoutNamespacedTypeKey(resolvePhiCmsLayoutPluginKey("flex"), "flex"),
-                        slotIndex: PHI_CMS_DEFAULT_SLOT_INDEX,
-                        sortOrder: 10,
-                        status: 1,
-                        flags: 0,
-                        visibilityMask: page.visibilityMask,
-                        label: "pub header bottom flex",
-                        config: {
-                            anchor: {
-                                horizontal: "left",
-                                vertical: "middle",
-                            },
-                            gap: 0,
-                            wrap: false,
-                        },
-                    },
-                ]
-                : []),
-            ...(siderRightRegion
-                ? [
-                    {
-                        id: PHI_DEFAULT_PUB_AREA_LAYOUT_IDS.layoutSiderRight,
-                        siteId: page.siteId,
-                        parentLayoutNodeId: null,
-                        widgetType: buildPhiCmsLayoutNamespacedTypeKey(resolvePhiCmsLayoutPluginKey("flex-vertical"), "flex-vertical"),
-                        slotIndex: PHI_CMS_DEFAULT_SLOT_INDEX,
-                        sortOrder: 16,
-                        status: 1,
-                        flags: 0,
-                        visibilityMask: page.visibilityMask,
-                        label: "pub sider right vertical",
-                        config: {
-                            anchor: {
-                                horizontal: "center",
-                                vertical: "top",
-                            },
-                            gap: 0,
-                        },
-                    },
-                ]
-                : []),
             ...(footerTopRegion
                 ? [
                     {
@@ -516,7 +413,7 @@ export async function buildPhiDefaultSiteAreaPresetTree({ page, runtime, presetK
                 visibilityMask: page.visibilityMask,
                 label: "pub header main navigation",
                 config: {
-                    navKey: `${navigationArea}:header`,
+                    navKey: `${runtimeModuleArea}:header`,
                 },
                 contentVersionId: null,
             },
@@ -588,7 +485,7 @@ export async function buildPhiDefaultSiteAreaPresetTree({ page, runtime, presetK
                         config: {
                             title: "Quick Links",
                             textSource: PHI_TEXT_SOURCE_PRESET,
-                            navKey: `${navigationArea}:footer`,
+                            navKey: `${runtimeModuleArea}:footer`,
                             columns: 2,
                             separator: true,
                         },

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

@@ -0,0 +1,115 @@
+import type { PhiCmsDescriptorBuildContext } from "../../../types/cms-module-descriptors";
+export declare const PHI_PUBLIC_RUNTIME_MODULE_AREA_SHELLS: {
+    ownerModuleId: "@phis/ui/modules/public";
+    presetKey: string;
+    shellPresetVersion: number;
+    area: "public";
+    exportedNodeKeys: readonly ["widgetBrand", "widgetNav", "widgetLocale"];
+    loadTree: ({ page, runtime }: PhiCmsDescriptorBuildContext) => Promise<import("../../../types").PhiResolvedCmsPageTree>;
+}[];
+export declare const PHI_PUBLIC_RUNTIME_MODULE_ROUTES: ({
+    ownerModuleId: "@phis/ui/modules/public";
+    presetKey: string;
+    presetVersion: number;
+    area: "public";
+    title: string;
+    path: string;
+    defaultPageFlags: number;
+    loadTree: ({ page }: PhiCmsDescriptorBuildContext) => Promise<import("../../../types").PhiResolvedCmsPageTree>;
+} | {
+    ownerModuleId: "@phis/ui/modules/public";
+    presetKey: "public-welcome-page";
+    presetVersion: number;
+    area: "public";
+    title: string;
+    path: string;
+    loadTree: ({ page, runtime }: PhiCmsDescriptorBuildContext) => Promise<import("../../../types").PhiResolvedCmsPageTree>;
+    navigation?: undefined;
+} | {
+    ownerModuleId: "@phis/ui/modules/public";
+    presetKey: "public-home-page";
+    presetVersion: number;
+    area: "public";
+    title: string;
+    path: string;
+    navigation: {
+        navKey: "public:header";
+        parentItemKey: null;
+        before: string;
+        item: {
+            itemKey: string;
+            label: {
+                defaultMessage: string;
+            };
+            icon: string;
+            routePresetKey: string;
+        };
+    }[];
+    loadTree: ({ page }: PhiCmsDescriptorBuildContext) => Promise<import("../../../types").PhiResolvedCmsPageTree>;
+} | {
+    ownerModuleId: "@phis/ui/modules/public";
+    presetKey: "public-terms-page";
+    presetVersion: number;
+    area: "public";
+    title: string;
+    path: string;
+    loadTree: ({ page }: PhiCmsDescriptorBuildContext & {
+        activeModuleIds: ReadonlySet<import("../contracts").PhiRuntimeModuleId>;
+        params: Readonly<Record<string, string>>;
+    }) => Promise<import("../../../types").PhiResolvedCmsPageTree>;
+    navigation?: undefined;
+})[];
+/**
+ * The Public form pages, in their own list because they appear only where Forms are allowed. The
+ * contact page is Core's like the terms: every Site starts with a way to be reached, and neither is
+ * a landing -- the front door is the Site package's business.
+ */
+export declare const PHI_PUBLIC_FORM_RUNTIME_MODULE_ROUTES: ({
+    ownerModuleId: "@phis/ui/modules/public";
+    presetKey: "public-contact-page";
+    presetVersion: number;
+    area: "public";
+    title: string;
+    path: string;
+    navigation: ({
+        navKey: "public:header";
+        parentItemKey: null;
+        after: string;
+        item: {
+            itemKey: string;
+            label: {
+                defaultMessage: string;
+            };
+            icon: string;
+            routePresetKey: string;
+        };
+    } | {
+        navKey: "public:footer";
+        parentItemKey: null;
+        after: string;
+        item: {
+            itemKey: string;
+            label: {
+                defaultMessage: string;
+            };
+            routePresetKey: string;
+            icon?: undefined;
+        };
+    })[];
+    loadTree: ({ page }: PhiCmsDescriptorBuildContext & {
+        activeModuleIds: ReadonlySet<import("../contracts").PhiRuntimeModuleId>;
+        params: Readonly<Record<string, string>>;
+    }) => Promise<import("../../../types").PhiResolvedCmsPageTree>;
+} | {
+    ownerModuleId: "@phis/ui/modules/public";
+    presetKey: "public-unsubscribe-page";
+    presetVersion: number;
+    area: "public";
+    title: string;
+    path: string;
+    navigation: never[];
+    loadTree: ({ page }: PhiCmsDescriptorBuildContext & {
+        activeModuleIds: ReadonlySet<import("../contracts").PhiRuntimeModuleId>;
+        params: Readonly<Record<string, string>>;
+    }) => Promise<import("../../../types").PhiResolvedCmsPageTree>;
+})[];