@phis/ui 0.4.2 → 0.4.4

package/types/cms-plugins.d.ts

@@ -101,7 +101,6 @@ export type PhiCmsConfigFieldChoiceMode = "single" | "multiple";
 export type PhiCmsConfigFieldChoiceValueType = "string" | "string[]" | "number";
 export type PhiCmsConfigFieldChoiceCreateBehavior = "none" | "accept-custom" | "create-record";
 export type PhiCmsConfigFieldColorMode = "single" | "gradient" | "both";
-export type PhiCmsConfigFieldValueStorage = "field" | "self";
 export type PhiCmsConfigFieldChoiceFilter = {
     widgetType?: string;
     group?: string;
@@ -115,6 +114,8 @@ export type PhiCmsConfigField = (PhiCmsConfigFieldBase & {
      * Button that is only its icon.
      */
     emptyValue?: "";
+    /** What an empty box shows: what an unset value means, such as `Auto`. Not stored. */
+    placeholder?: string;
 }) | (PhiCmsConfigFieldBase & {
     /**
      * One link, chosen rather than typed.
@@ -290,14 +291,6 @@ export type PhiCmsConfigField = (PhiCmsConfigFieldBase & {
     presentation?: PhiCmsConfigFieldCollectionPresentation;
     /** What the button that opens the Overlay says. */
     editLabel?: string;
-}) | (PhiCmsConfigFieldBase & {
-    type: "background";
-    section?: string;
-    storage?: PhiCmsConfigFieldValueStorage;
-}) | (PhiCmsConfigFieldBase & {
-    type: "border";
-    section?: string;
-    storage?: PhiCmsConfigFieldValueStorage;
 }) | (PhiCmsConfigFieldBase & {
     /**
      * A Surface (`types/surface.ts`) of something the Widget draws inside itself -- each entry of a
@@ -308,7 +301,7 @@ export type PhiCmsConfigField = (PhiCmsConfigFieldBase & {
     /** Whether the mode is offered; left out, it is. */
     tone?: false;
 }) | (PhiCmsConfigFieldBase & {
-    type: "shadow" | "grid-placement" | "column-count";
+    type: "grid-placement" | "column-count";
     section?: string;
 });
 export type PhiCmsLayoutSlotDefinition = {
@@ -575,7 +568,9 @@ export type PhiCmsRuntimeRenderRegistry = {
     dataProviderDescriptorsByKey: ReadonlyMap<PhiRuntimeDataProviderKey, PhiRuntimeModuleDataProviderDescriptor>;
     formDefinitionsById: ReadonlyMap<string, PhiRuntimeModuleFormDefinition>;
 };
-export type PhiCmsRenderIssueCode = "missing-module" | "missing-renderer" | "renderer-load-failed" | "render-failed" | "invalid-render-output"
+export type PhiCmsRenderIssueCode = "missing-module" | "missing-renderer" | "renderer-load-failed" | "render-failed"
+/** The stored config holds a value the block cannot read (`PhiConfigError`); the detail names the field. */
+ | "invalid-config" | "invalid-render-output"
 /** A node whose `visibleWhen` reads a feature namespace whose Module could not be asked this render. */
  | "feature-unavailable"
 /** A Region or Overlay zone names a root layout node the tree does not contain. */

package/types/core-widget-placements.d.ts

@@ -18,7 +18,7 @@ import type { PhiTextTone } from "../components/widgets/config/text-tone";
 import type { PhiCommonControlActionKey } from "../components/widgets/label-types/common-controls";
 import type { PhiMaskConfig } from "../components/widgets/config/mask";
 import type { PhiSpacingScaleKey } from "../components/widgets/config/spacing-options";
-import type { PhiCardVariant } from "../components/widgets/shared/card-vocabulary";
+import type { PhiCardBillingPeriod, PhiCardVariant } from "../components/widgets/shared/card-vocabulary";
 import type { PhiControlBadgeConfig, PhiControlConfig } from "../components/widgets/config/control-signal-config";
 /**
  * The part of a placement every Widget shares, whatever it is.
@@ -285,10 +285,21 @@ export type PhiCmsCollectionCardPresentation = {
     actionLabel?: string;
     actionHref?: string;
     variant?: PhiCardVariant;
-    /** Every card in the View draws this body; `stat` needs `value`. */
-    body?: "text" | "stat";
+    /** Every card in the View draws this body; `stat` needs `value`, `plan` a `price`. */
+    body?: "text" | "stat" | "plan";
     /** A field whose truth marks the card as highlighted. */
     highlight?: string;
+    /** The words on the card's band. */
+    badge?: string;
+    /** A `plan`'s prices and their periods, as a provider answers them -- per country, if it knows one. */
+    price?: string;
+    pricePeriod?: string;
+    priceYearly?: string;
+    pricePeriodYearly?: string;
+    /** A field holding the plan's features, each `{ text, state? }` (`PhiBulletListEntry`). */
+    features?: string;
+    /** Which price every plan card of the View shows. Not a path: the View's own choice. */
+    billingPeriod?: PhiCardBillingPeriod;
 };
 export type PhiCollectionViewWidgetPlacement = PhiWidgetPlacementBase & {
     presentation?: {

package/types/dashboard-cards.d.ts

@@ -1,3 +1,4 @@
+import type { PhiRuntimeModuleCatalog } from "./cms-plugins";
 import type { PhiCmsAreaKey } from "../constants/cms-areas";
 import type { PhiTimelineEntry } from "@phis/contracts/timeline";
 import type { PhiAccessViewer, PhiViewerAccessPolicy } from "./access";
@@ -30,15 +31,48 @@ export declare function createPhiDashboardCardId(moduleId: string, leaf: string)
  * `stat` is a figure, what it is, and where to go for more. `list` is a handful of entries -- what
  * changed, what is waiting -- each a line with an optional time and tone; the Builder's Dashboard is the
  * case that asked for it, because what a structure author looks for first is what is open rather than
- * how many. The form names a renderer and the payload fills it, and a form Core offers is a promise it
- * then keeps: a series card stays open until somebody has a series (DASHBOARD.md section 9).
+ * how many. `series` is a figure over time -- a day's views, clones or downloads for the last month --
+ * drawn as a line per series under its headline; the project-stats Add-on is the case that asked for it
+ * (DASHBOARD.md section 9). The form names a renderer and the payload fills it, and a form Core offers
+ * is a promise it then keeps.
  */
-export type PhiDashboardCardForm = "stat" | "list";
+export type PhiDashboardCardForm = "stat" | "list" | "series";
 /**
  * How many entries a `list` card draws. A card shows little and leads out (DASHBOARD.md section 2); a
  * provider that has more says so in `meta` and lets the card's target show the rest.
  */
 export declare const PHI_DASHBOARD_CARD_LIST_LIMIT = 5;
+/**
+ * How many series a `series` card draws. Two or three lines on a card's width still read as a comparison
+ * -- views and unique visitors -- and a fourth is a chart that wants a page of its own; a provider that has
+ * more puts them on separate cards or on the card's target.
+ */
+export declare const PHI_DASHBOARD_CARD_SERIES_LIMIT = 3;
+/**
+ * A `series` card's figures over time.
+ *
+ * Point by point, oldest first, because that is how a provider counts: one row per day, each with a value
+ * for every series. `labels` names the series in the order each point's `values` states them, so a point
+ * carries exactly one number per label -- a day nothing was counted on is a `0`, not a missing value,
+ * because a gap a line would have to bridge or break is a decision the card should not be making.
+ *
+ * `at` is when the point stands: an ISO date (`2026-11-05`) for a day, or an instant. The card formats it
+ * in the page's locale, a date as the calendar day it names. `unit` is a word for what is counted,
+ * already translated ("views", "downloads"), drawn after the figure in the chart's spoken label.
+ *
+ * The headline is the payload's `value`, as on a `stat` card: a figure the provider states -- a total
+ * over the period, which the points cannot add up to when the provider counts uniques. Absent, the card
+ * shows the latest point of the first series.
+ */
+export type PhiDashboardCardSeries = {
+    labels: string[];
+    points: PhiDashboardCardSeriesPoint[];
+    unit?: string;
+};
+export type PhiDashboardCardSeriesPoint = {
+    at: string;
+    values: number[];
+};
 export type PhiDashboardCardDescriptor = {
     cardId: PhiDashboardCardId;
     form: PhiDashboardCardForm;
@@ -95,7 +129,7 @@ export type PhiDashboardCardDescriptor = {
  */
 export type PhiDashboardCardPayload = {
     cardId: PhiDashboardCardId;
-    /** A `stat` card's figure, drawn under the descriptor's title. */
+    /** A `stat` card's figure, drawn under the descriptor's title, and a `series` card's headline. */
     value?: string;
     /**
      * A `list` card's entries, newest or most pressing first, at most `PHI_DASHBOARD_CARD_LIST_LIMIT` of
@@ -103,6 +137,8 @@ export type PhiDashboardCardPayload = {
      * card formats in the page's locale, or in words where words are what the provider has.
      */
     entries?: PhiTimelineEntry[];
+    /** A `series` card's points, drawn under the headline `value`. */
+    series?: PhiDashboardCardSeries;
     description?: string;
     meta?: string;
     error?: string | null;
@@ -133,6 +169,14 @@ export type PhiDashboardCardContext = {
     locale: string;
     area: PhiCmsAreaKey;
     viewer: PhiAccessViewer;
+    /**
+     * The Module catalog of the Area the Dashboard stands in.
+     *
+     * A card about structure -- which Area has an open draft -- has to know the Area shells, and the
+     * only catalog it may know is the one it is running in. Importing the first-party catalog instead
+     * would compile every Module into the provider (MODULES.md, "The dependency rule").
+     */
+    runtimeModuleCatalog: PhiRuntimeModuleCatalog;
 };
 /**
  * One Module's answer, loaded on the server and never reached from the browser.

package/types/dashboard-cards.js

@@ -18,3 +18,9 @@ export function createPhiDashboardCardId(moduleId, leaf) {
  * provider that has more says so in `meta` and lets the card's target show the rest.
  */
 export const PHI_DASHBOARD_CARD_LIST_LIMIT = 5;
+/**
+ * How many series a `series` card draws. Two or three lines on a card's width still read as a comparison
+ * -- views and unique visitors -- and a fourth is a chart that wants a page of its own; a provider that has
+ * more puts them on separate cards or on the card's target.
+ */
+export const PHI_DASHBOARD_CARD_SERIES_LIMIT = 3;

package/types/media.d.ts

@@ -69,7 +69,6 @@ export type PhiMediaAssetVariant = {
     deliveryUrl: string;
     contentType: string;
     bytes: number | null;
-    checksumSha256: string | null;
     width: number;
     height: number;
     blurDataUrl: string | null;
@@ -90,7 +89,6 @@ export type PhiMediaAsset = {
     contentType: string;
     kind: PhiMediaKindValue;
     bytes: number | null;
-    checksumSha256: string | null;
     width: number | null;
     height: number | null;
     blurDataUrl: string | null;
@@ -127,7 +125,6 @@ export type PhiMediaAssetTile = {
     width: number | null;
     height: number | null;
     bytes: number | null;
-    checksumSha256: string | null;
     lifecycleStatus: number;
     deliveryPolicy: number;
     deliveryRevision: number;

package/types/renderable-block.d.ts

@@ -48,7 +48,12 @@ export type PhiRenderableBlockTransitionEasing = PhiMotionEasing;
 export type PhiRenderableBlockTransitionAxis = "x" | "y" | "z";
 export type PhiRenderableBlockTransitionOrigin = "top left" | "top center" | "top right" | "center left" | "center" | "center right" | "bottom left" | "bottom center" | "bottom right";
 export type PhiRenderableBlockTransitionTrigger = "on_mount" | "on_ready" | "on_visible" | "on_hover" | "on_focus" | "manual";
-export type PhiRenderableBlockViewportEffectAxis = "x" | "y";
+/**
+ * Along which axis a viewport effect moves, or about which one it turns. `z` turns flat in the page plane
+ * and only means something for `rotate`; a translate along `z` is refused when the config is read. Progress
+ * is measured along `x` for `x`, and along the page's own scroll direction for `y` and `z`.
+ */
+export type PhiRenderableBlockViewportEffectAxis = "x" | "y" | "z";
 export type PhiRenderableBlockViewportEffectProperty = "translate" | "opacity" | "rotate" | "scale";
 export type PhiRenderableBlockViewportEffectRangePoint = "enter" | "center" | "exit";
 export type PhiRenderableBlockViewportEffectUnit = "px" | "%" | "deg" | "";

package/types/site-theme.d.ts

@@ -1,4 +1,5 @@
 import type { PhiShadow } from "./layout-style";
+import type { PhiLinkTarget } from "./references";
 import type { PhiCmsBackgroundWidgetConfig } from "../components/widgets/config/background";
 /**
  * The Theme Root Background (SHELL.md "Root Background and Shell Backdrop Layers"): painted once at
@@ -113,8 +114,15 @@ export type PhiSiteThemeBrandLine = {
  * decides is whether and how the Brand Widget appears; what it shows is decided here.
  */
 export type PhiSiteThemeBrand = {
-    /** Where the Brand Widget leads when it is clicked. The Site root where nothing says otherwise. */
-    homeHref?: string | null;
+    /**
+     * Where the Brand Widget leads when it is clicked. The Site root where nothing says otherwise.
+     *
+     * A link target like every other destination an author picks (`REFERENCES.md`): a Page by reference,
+     * resolved to its address per render, so a Page that is renamed or moved keeps the Brand leading to
+     * it. A Page that no longer resolves leads to the Site root rather than to a 404. The key ends in
+     * `LinkTarget`, which is what the reference collectors go by.
+     */
+    homeLinkTarget?: PhiLinkTarget | null;
     /** The small line above the Wordmark, for Sites whose name needs a word of context. */
     eyebrow?: string | null;
     /** The Logo, one picture per mode. A mode the record says nothing about wears the Theme Set's. */

package/types/table-widget.d.ts

@@ -426,6 +426,15 @@ export type PhiTableProviderQueryCapabilities = {
     filterFields?: readonly string[];
     sorting?: "none" | "single" | "multiple";
     pagination?: "none" | "offset" | "cursor";
+    /**
+     * Whether a query of this resource answers `total`, the rows the whole query has.
+     *
+     * Counting is a query of its own on a large table, so a paging resource answers it only where it
+     * says so here. A Table that shows a count -- `totalRows` or `pageCount` in its footer or summary --
+     * needs a resource that counts or does not page; one that pages without a count is paged back and
+     * forward. A resource that does not page answers every row at once, and its rows are its count.
+     */
+    total?: boolean;
     facets?: readonly string[];
     expansion?: boolean;
 };

package/types/table-widget.js

@@ -260,6 +260,26 @@ export function validatePhiTableProviderFieldValue(field, value, row) {
 }
 export function validatePhiTableWidgetBinding(config, resource) {
     const errors = [];
+    /*
+     * A count shown needs a count given. The rows of one page are not the query's, so a Table that says
+     * how many there are, or how many pages, is bound to a resource that counts -- or one that does not
+     * page and so answers every row at once (`query.total`).
+     */
+    const resourceCounts = resource.query.total === true ||
+        (resource.query.pagination !== "offset" && resource.query.pagination !== "cursor");
+    if (!resourceCounts) {
+        const footer = config.presentation.footer;
+        const shownSources = [
+            ...(footer?.values ?? []).map((item) => item.value),
+            ...(footer?.variants ?? []).flatMap((variant) => [variant.when.value, ...(variant.values ?? []).map((item) => item.value)]),
+            ...(config.presentation.summary?.rows ?? []).flatMap((row) => row.cells.map((cell) => cell.item.value)),
+        ];
+        const counted = shownSources.find((source) => source.source === "core" && (source.fieldKey === "totalRows" || source.fieldKey === "pageCount"));
+        if (counted) {
+            errors.push(`Table shows "${counted.fieldKey}", but resource "${resource.resourceKey}" pages without a count ` +
+                "(declare query.total on a resource that answers total).");
+        }
+    }
     const fields = new Set(resource.fields.map((field) => field.key));
     const fieldsByKey = new Map(resource.fields.map((field) => [field.key, field]));
     const columns = config.presentation.columns;

package/types.d.ts

@@ -18,7 +18,7 @@ export * from "./types/spacing";
 export * from "./types/runtime-condition";
 export * from "./types/state-machine";
 export * from "./types/access";
-export type { PhiAuthoringRenderPolicy, PhiCmsBuilderWidgetEditorInteraction, PhiCmsBuilderWidgetPlugin, PhiCmsBuilderWidgetRenderArgs, PhiCmsConfigField, PhiCmsConfigFieldChoiceCreateBehavior, PhiCmsConfigFieldChoiceFilter, PhiCmsConfigFieldChoiceMode, PhiCmsConfigFieldChoicePresentation, PhiCmsConfigFieldChoiceValueType, PhiCmsConfigFieldCollectionPresentation, PhiCmsConfigFieldColorMode, PhiCmsConfigFieldValueStorage, PhiCmsConfigFieldVisibilityRule, PhiCmsLayoutPlugin, PhiCmsLayoutPluginDefinition, PhiCmsLayoutPluginRenderArgs, PhiCmsLayoutSlotDefinition, PhiCmsPluginCommercialMeta, PhiCmsPluginCommercialPlan, PhiCmsPluginLicenseState, PhiCmsPreviewWidgetPlugin, PhiCmsResolvedRequestLoaderArgs, PhiCmsRuntimeWidgetPlugin, PhiCmsServerWidgetPlugin, PhiCmsSiteBridge, PhiCmsSiteRuntime, PhiCmsWidgetAuthoringCanvas, PhiCmsWidgetAuthoringContext, PhiCmsWidgetContentBinding, PhiCmsWidgetPlugin, PhiCmsWidgetPluginDefinition, PhiCmsWidgetPluginRenderArgs, PhiCmsWidgetRuntimeControllerRequirementArgs, PhiCmsWidgetRuntimeControllerRequirementResolver, PhiCmsWidgetSignalSubcontrolCollection, PhiPreviewRenderPolicy, PhiResolvedCmsRequest, PhiRuntimeControllerDefinition, PhiRuntimeControllerFlag, PhiRuntimeControllerMountScope, PhiRuntimeControllerPlugin, PhiRuntimeControllerPreloadMap, PhiRuntimeControllerRenderArgs, PhiRuntimeControllerRequirement, PhiRuntimeControllerServerPreloadArgs, PhiRuntimeControllerSetting, PhiRuntimeModule, PhiRuntimeModuleAuthoringClientProps, PhiRuntimeModuleCalendarAdapterClientDefinition, PhiRuntimeModuleCatalog, PhiRuntimeModuleCatalogEntry, PhiRuntimeModuleClientWidgetDefinition, PhiRuntimeModuleControllerClientProps, PhiRuntimeModuleControllerDescriptor, PhiRuntimeModuleControllerMountPolicy, PhiRuntimeModuleDataProviderClientDefinition, PhiRuntimeModuleDataProviderClientProps, PhiRuntimeModuleDataProviderDescriptor, PhiRuntimeModuleDefinition, PhiRuntimeModuleFeatureContext, PhiRuntimeModuleFeatureResolver, PhiRuntimeModuleFormDefinition, PhiRuntimeModuleLayoutDefinition, PhiRuntimeModuleLoader, PhiRuntimeModuleRenderPolicies, PhiRuntimeModuleUiProvider, PhiRuntimeModuleWidgetDefinition, PhiRuntimeRenderPolicy, } from "./types/cms-plugins";
+export type { PhiAuthoringRenderPolicy, PhiCmsBuilderWidgetEditorInteraction, PhiCmsBuilderWidgetPlugin, PhiCmsBuilderWidgetRenderArgs, PhiCmsConfigField, PhiCmsConfigFieldChoiceCreateBehavior, PhiCmsConfigFieldChoiceFilter, PhiCmsConfigFieldChoiceMode, PhiCmsConfigFieldChoicePresentation, PhiCmsConfigFieldChoiceValueType, PhiCmsConfigFieldCollectionPresentation, PhiCmsConfigFieldColorMode, PhiCmsConfigFieldVisibilityRule, PhiCmsLayoutPlugin, PhiCmsLayoutPluginDefinition, PhiCmsLayoutPluginRenderArgs, PhiCmsLayoutSlotDefinition, PhiCmsPluginCommercialMeta, PhiCmsPluginCommercialPlan, PhiCmsPluginLicenseState, PhiCmsPreviewWidgetPlugin, PhiCmsResolvedRequestLoaderArgs, PhiCmsRuntimeWidgetPlugin, PhiCmsServerWidgetPlugin, PhiCmsSiteBridge, PhiCmsSiteRuntime, PhiCmsWidgetAuthoringCanvas, PhiCmsWidgetAuthoringContext, PhiCmsWidgetContentBinding, PhiCmsWidgetPlugin, PhiCmsWidgetPluginDefinition, PhiCmsWidgetPluginRenderArgs, PhiCmsWidgetRuntimeControllerRequirementArgs, PhiCmsWidgetRuntimeControllerRequirementResolver, PhiCmsWidgetSignalSubcontrolCollection, PhiPreviewRenderPolicy, PhiResolvedCmsRequest, PhiRuntimeControllerDefinition, PhiRuntimeControllerFlag, PhiRuntimeControllerMountScope, PhiRuntimeControllerPlugin, PhiRuntimeControllerPreloadMap, PhiRuntimeControllerRenderArgs, PhiRuntimeControllerRequirement, PhiRuntimeControllerServerPreloadArgs, PhiRuntimeControllerSetting, PhiRuntimeModule, PhiRuntimeModuleAuthoringClientProps, PhiRuntimeModuleCalendarAdapterClientDefinition, PhiRuntimeModuleCatalog, PhiRuntimeModuleCatalogEntry, PhiRuntimeModuleClientWidgetDefinition, PhiRuntimeModuleControllerClientProps, PhiRuntimeModuleControllerDescriptor, PhiRuntimeModuleControllerMountPolicy, PhiRuntimeModuleDataProviderClientDefinition, PhiRuntimeModuleDataProviderClientProps, PhiRuntimeModuleDataProviderDescriptor, PhiRuntimeModuleDefinition, PhiRuntimeModuleFeatureContext, PhiRuntimeModuleFeatureResolver, PhiRuntimeModuleFormDefinition, PhiRuntimeModuleLayoutDefinition, PhiRuntimeModuleLoader, PhiRuntimeModuleRenderPolicies, PhiRuntimeModuleUiProvider, PhiRuntimeModuleWidgetDefinition, PhiRuntimeRenderPolicy, } from "./types/cms-plugins";
 export type * from "./types/cms-presets";
 export type * from "./types/slot-size-policy";
 export type * from "./types/runtime-data-provider";

package/widget-config.d.ts

@@ -7,4 +7,6 @@
  */
 export { readBoolean, readCssSize, readInteger, readNavItems, readNumber, readRenderableBlockConfig, readString, } from "./components/widgets/config/parser-primitives";
 export type { PhiCmsWidgetConfigBase } from "./components/widgets/config/parser-primitives";
+export { PhiConfigError, createPhiConfigReader, isPhiConfigError, } from "./components/widgets/config/strict-config-reader";
+export type { PhiConfigReader } from "./components/widgets/config/strict-config-reader";
 export { normalizePhiRenderableBlockResponsiveSize, normalizePhiRenderableBlockSize, readPhiResponsiveLength, } from "./helpers/renderable-block-normalizers";

package/widget-config.js

@@ -6,5 +6,11 @@
  * logic into every package that ships a Widget.
  */
 export { readBoolean, readCssSize, readInteger, readNavItems, readNumber, readRenderableBlockConfig, readString, } from "./components/widgets/config/parser-primitives";
+/*
+ * Strict reading (THIRD_PARTY_MODULES.md, "Reading a config"). A `parseConfig` built on it throws for a
+ * value that is present and wrong, naming the field; the Site then refuses to store it and a live page
+ * leaves the Widget out. The lenient readers above stay for what has not moved yet.
+ */
+export { PhiConfigError, createPhiConfigReader, isPhiConfigError, } from "./components/widgets/config/strict-config-reader";
 /* A block's size and lengths are read where every other reader of a block reads them (D1). */
 export { normalizePhiRenderableBlockResponsiveSize, normalizePhiRenderableBlockSize, readPhiResponsiveLength, } from "./helpers/renderable-block-normalizers";

package/plugins/runtime-modules/area-base-presets.d.ts

@@ -1,139 +0,0 @@
-import type { PhiCmsDescriptorBuildContext, PhiCmsRoutePresetDescriptor } from "../../types/cms-module-descriptors";
-export declare const PHI_AREA_BASE_RUNTIME_MODULE_AREA_SHELLS: ({
-    ownerModuleId: "@phis/ui/modules/accounting";
-    presetKey: string;
-    shellPresetVersion: number;
-    area: "accounting";
-    loadTree: ({ page, runtime }: PhiCmsDescriptorBuildContext) => Promise<import("../../types").PhiResolvedCmsPageTree>;
-} | {
-    ownerModuleId: "@phis/ui/modules/public";
-    presetKey: string;
-    shellPresetVersion: number;
-    area: "public";
-    exportedNodeKeys: readonly ["widgetBrand", "widgetNav", "widgetLocale"];
-    loadTree: ({ page, runtime }: PhiCmsDescriptorBuildContext) => Promise<import("../../types").PhiResolvedCmsPageTree>;
-} | {
-    ownerModuleId: "@phis/ui/modules/app";
-    presetKey: string;
-    shellPresetVersion: number;
-    area: "app";
-    loadTree: ({ page, runtime }: PhiCmsDescriptorBuildContext) => Promise<{
-        pageMeta: import("../../types").PhiCmsResolvedPageMeta | null | undefined;
-        runtimeModuleIds: `${string}/${string}`[] | null | undefined;
-        regions: import("../../types").PhiCmsRegionNode[];
-        overlays: import("../../types").PhiCmsOverlayNode[];
-        layoutNodes: import("../../types").PhiCmsLayoutNode[];
-        contentWidgets: import("../../types").PhiCmsContentWidgetNode[];
-        controllerSettings: import("../../types/cms").PhiCmsTreeControllerSettings;
-        page: import("../../types").PhiCmsPageNode;
-    }>;
-    exportedNodeKeys?: undefined;
-})[];
-export declare const PHI_AREA_BASE_RUNTIME_MODULE_ROUTES: (PhiCmsRoutePresetDescriptor | {
-    ownerModuleId: "@phis/ui/modules/public";
-    presetKey: string;
-    presetVersion: number;
-    area: "public";
-    title: string;
-    path: string;
-    defaultPageFlags: number;
-    loadTree: ({ page }: PhiCmsDescriptorBuildContext) => Promise<import("../../types").PhiResolvedCmsPageTree>;
-})[];
-export declare const PHI_CORE_RUNTIME_MODULE_THEMES: {
-    loadPreset: () => {
-        readonly key: "phis";
-        readonly version: 1;
-        readonly title: "Phis";
-        readonly description: "Warm orange brand color with a deep blue text base.";
-        readonly palette: {
-            readonly seed: {
-                readonly colorPrimary: "#E05A2A";
-                readonly colorInfo: "#7088BA";
-                readonly colorSuccess: "#4D8F6B";
-                readonly colorWarning: "#D99A2B";
-                readonly colorError: "#C94A3A";
-                readonly colorLink: "#7088BA";
-            };
-            readonly modes: {
-                readonly light: {
-                    readonly seed: {
-                        readonly colorTextBase: "#223A61";
-                        readonly colorBgBase: "#ffffff";
-                    };
-                    readonly overrides: {
-                        readonly colorFillQuaternary: "rgba(34, 58, 97, 0.03)";
-                    };
-                };
-                readonly dark: {
-                    readonly seed: {
-                        readonly colorTextBase: "#DCE7F8";
-                        readonly colorBgBase: "#050914";
-                    };
-                    readonly overrides: {
-                        readonly colorFillQuaternary: "rgba(220, 231, 248, 0.06)";
-                    };
-                };
-            };
-        };
-    };
-    description?: "Warm orange brand color with a deep blue text base." | undefined;
-    ownerModuleId: "@phis/ui/modules/core";
-    presetKey: string;
-    presetVersion: number;
-    themeKey: "phis";
-    title: "Phis";
-}[];
-/**
- * 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>;
-})[];