@phis/ui 0.1.0 → 0.2.0

package/plugins/runtime-modules/avatar/widgets/account-avatar/config.js

@@ -1,5 +1,4 @@
 import { resolvePhiCmsWidgetPluginKey } from "../../../../../constants/cms-widget-types";
-import { PhiCmsWidgetType } from "../../../../../constants/cms-widget-types";
 import { parsePhiPaddingOnlyWidgetConfig } from "../../../../../components/widgets/config/helpers";
 /**
  * Shows the signed-in person their own picture and lets them change it.
@@ -12,10 +11,10 @@ export const PHI_ACCOUNT_AVATAR_WIDGET_DEFINITION = {
     kind: "widget",
     pluginKey: resolvePhiCmsWidgetPluginKey("account-avatar"),
     typeKey: "account-avatar",
+    slotSizePolicy: "intrinsic",
     title: "Account avatar",
     description: "The signed-in person's own picture, with a control to change it.",
     category: "account",
     fields: [],
     parseConfig: parsePhiPaddingOnlyWidgetConfig,
 };
-export const PHI_ACCOUNT_AVATAR_WIDGET_PLUGIN_TYPE = PhiCmsWidgetType.AccountAvatar;

package/plugins/runtime-modules/avatar/widgets/account-avatar/server.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { getPhiAvatarWidgetLabels } from "../../../../../components/widgets/label-sets/avatar";
+import { getPhiAvatarWidgetLabels } from "../../labels";
 import { PhiCmsWidgetType } from "../../../../../constants/cms-widget-types";
 import { PhiRuntimeModuleRenderClientHost } from "../../../../../components/runtime/runtime-module-render-client-manifest";
 import { readPhiServerApiCredentials } from "../../../../../helpers/phis-server-credentials";

package/plugins/runtime-modules/avatar/widgets/account-avatar-picker/authoring.d.ts

@@ -1,3 +1,2 @@
-import type { PhiCmsBuilderWidgetPlugin } from "../../../../../types";
 import type { PhiCmsPaddingOnlyWidgetConfig } from "../../../../../components/widgets/config/helpers";
-export declare const PHI_ACCOUNT_AVATAR_PICKER_WIDGET_BUILDER_PLUGIN: PhiCmsBuilderWidgetPlugin<PhiCmsPaddingOnlyWidgetConfig>;
+export declare const PHI_ACCOUNT_AVATAR_PICKER_WIDGET_BUILDER_PLUGIN: import("../../../../../types").PhiCmsBuilderWidgetPlugin<PhiCmsPaddingOnlyWidgetConfig>;

package/plugins/runtime-modules/avatar/widgets/account-avatar-picker/authoring.js

@@ -1,8 +1,6 @@
 "use client";
 import { jsx as _jsx } from "react/jsx-runtime";
+import { createPhiCmsBuilderWidgetPlugin } from "../../../../../plugins/factories/widget-builder-plugin";
 import { PHI_ACCOUNT_AVATAR_PICKER_WIDGET_DEFINITION } from "../../../../../plugins/runtime-modules/avatar/widgets/account-avatar-picker/config";
 import { PhiWidgetEditorPlaceholder } from "../../../../../components/widgets/builder/widget-editor-placeholder";
-export const PHI_ACCOUNT_AVATAR_PICKER_WIDGET_BUILDER_PLUGIN = {
-    ...PHI_ACCOUNT_AVATAR_PICKER_WIDGET_DEFINITION,
-    renderEditor: ({ widget }) => (_jsx(PhiWidgetEditorPlaceholder, { widget: widget, pluginTitle: PHI_ACCOUNT_AVATAR_PICKER_WIDGET_DEFINITION.title, summary: "Uploads a picture into the viewer's own Media Space." })),
-};
+export const PHI_ACCOUNT_AVATAR_PICKER_WIDGET_BUILDER_PLUGIN = createPhiCmsBuilderWidgetPlugin(PHI_ACCOUNT_AVATAR_PICKER_WIDGET_DEFINITION, ({ widget }) => (_jsx(PhiWidgetEditorPlaceholder, { widget: widget, pluginTitle: PHI_ACCOUNT_AVATAR_PICKER_WIDGET_DEFINITION.title, summary: "Uploads a picture into the viewer's own Media Space." })));

package/plugins/runtime-modules/avatar/widgets/account-avatar-picker/client.js

@@ -1,15 +1,18 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useCallback, useMemo } from "react";
-import { Flex, Progress, Typography, Upload } from "antd";
+import { PhiFileDropControl } from "../../../../../components/controls/phi-file-drop-control";
+import { PhiProgressControl } from "../../../../../components/controls/phi-progress-control";
 import { PhiAlertControl } from "../../../../../components/controls/phi-alert-control";
 import { usePhiMediaUpload } from "../../../../../components/media/phi-media-upload";
-import { PHI_AVATAR_RUNTIME_MODULE_DEFINITION } from "../../../../../plugins/runtime-modules/avatar/definition";
+import { PHI_AVATAR_USER_SPACE_MEDIA_KINDS } from "../../../../../plugins/runtime-modules/avatar/media-spaces";
 import { setPhiViewerAvatar } from "../../../../../components/account/avatar-client";
 import { PHI_AVATAR_REVISION } from "../../../../../components/account/avatar-revision";
-import { PHI_AVATAR_OVERLAY_IDS } from "../../../../../components/runtime/avatar-overlay-ids";
+import { PHI_AVATAR_OVERLAY_IDS } from "../../addresses";
 import { createPhiSignalAddress } from "../../../../../types/signals";
 import { createPhiSignalCorrelationId, usePhiSignalDispatcher, } from "../../../../../components/runtime/runtime-signal-bus";
+import { PhiFlexControl } from "../../../../../components/controls/phi-flex-control";
+import { PhiTypographyControl } from "../../../../../components/controls/phi-typography-control";
 /**
  * Uploads a picture into the viewer's own Space and binds it as their avatar.
  *
@@ -55,7 +58,7 @@ export function PhiAccountAvatarPickerWidgetClient({ labels, config, }) {
          * be accepted.
          */
         acceptance: {
-            kinds: PHI_AVATAR_RUNTIME_MODULE_DEFINITION.mediaSpaces.user.kinds,
+            kinds: PHI_AVATAR_USER_SPACE_MEDIA_KINDS,
             multiple: false,
         },
         initOptions: { spaceAddress: "user" },
@@ -67,9 +70,7 @@ export function PhiAccountAvatarPickerWidgetClient({ labels, config, }) {
     });
     const active = items[0];
     const busy = active?.status === "uploading";
-    return (_jsxs(Flex, { vertical: true, gap: "small", style: { padding: config?.padding }, children: [_jsx(Typography.Text, { type: "secondary", children: labels.uploadHint }), active?.error
+    return (_jsxs(PhiFlexControl, { vertical: true, gap: "small", style: { padding: config?.padding }, children: [_jsx(PhiTypographyControl, { type: "secondary", children: labels.uploadHint }), active?.error
                 ? _jsx(PhiAlertControl, { level: "error", title: labels.feedback.errorTitle, description: active.error })
-                : null, _jsx(Upload.Dragger, { accept: accept, multiple: false, showUploadList: false, disabled: busy, 
-                // Never hand the file to Ant Design's own uploader: the transport is the Provider-issued plan.
-                beforeUpload: (file) => { void upload(file); return false; }, children: _jsx(Typography.Text, { children: labels.uploadLabel }) }), busy ? _jsx(Progress, { percent: Math.round(active?.progress ?? 0), size: "small" }) : null] }));
+                : null, _jsx(PhiFileDropControl, { dropZone: true, accept: accept, multiple: false, disabled: busy, onFile: (file) => void upload(file), children: _jsx(PhiTypographyControl, { children: labels.uploadLabel }) }), busy ? _jsx(PhiProgressControl, { percent: Math.round(active?.progress ?? 0), size: "small" }) : null] }));
 }

package/plugins/runtime-modules/avatar/widgets/account-avatar-picker/config.d.ts

@@ -10,10 +10,10 @@ export declare const PHI_ACCOUNT_AVATAR_PICKER_WIDGET_DEFINITION: {
     kind: "widget";
     pluginKey: string;
     typeKey: string;
+    slotSizePolicy: "intrinsic";
     title: string;
     description: string;
     category: "account";
     fields: never[];
     parseConfig: typeof parsePhiPaddingOnlyWidgetConfig;
 };
-export declare const PHI_ACCOUNT_AVATAR_PICKER_WIDGET_PLUGIN_TYPE: string;

package/plugins/runtime-modules/avatar/widgets/account-avatar-picker/config.js

@@ -1,5 +1,4 @@
 import { resolvePhiCmsWidgetPluginKey } from "../../../../../constants/cms-widget-types";
-import { PhiCmsWidgetType } from "../../../../../constants/cms-widget-types";
 import { parsePhiPaddingOnlyWidgetConfig } from "../../../../../components/widgets/config/helpers";
 /**
  * The body of the Avatar Overlay: upload a picture, and bind it.
@@ -12,10 +11,10 @@ export const PHI_ACCOUNT_AVATAR_PICKER_WIDGET_DEFINITION = {
     kind: "widget",
     pluginKey: resolvePhiCmsWidgetPluginKey("account-avatar-picker"),
     typeKey: "account-avatar-picker",
+    slotSizePolicy: "intrinsic",
     title: "Account avatar picker",
     description: "Uploads a picture into the viewer's own Media Space and binds it as their avatar.",
     category: "account",
     fields: [],
     parseConfig: parsePhiPaddingOnlyWidgetConfig,
 };
-export const PHI_ACCOUNT_AVATAR_PICKER_WIDGET_PLUGIN_TYPE = PhiCmsWidgetType.AccountAvatarPicker;

package/plugins/runtime-modules/avatar/widgets/account-avatar-picker/server.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { getPhiAvatarWidgetLabels } from "../../../../../components/widgets/label-sets/avatar";
+import { getPhiAvatarWidgetLabels } from "../../labels";
 import { PhiCmsWidgetType } from "../../../../../constants/cms-widget-types";
 import { PhiRuntimeModuleRenderClientHost } from "../../../../../components/runtime/runtime-module-render-client-manifest";
 import { readPhiServerApiCredentials } from "../../../../../helpers/phis-server-credentials";

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

@@ -0,0 +1,23 @@
+export declare const PHI_BUILDER_MODULES_TABLE_WIDGET_ID: import("@phis/contracts/cms").PhiCmsInstanceId;
+export declare const PHI_BUILDER_AREA_SETTINGS_OVERLAY_IDS: Readonly<Record<"overlayAreaSettings", import("@phis/contracts/cms").PhiCmsInstanceId>>;
+export declare const PHI_BUILDER_AREA_SETTINGS_LAYOUT_IDS: Readonly<Record<"areaSettingsBody" | "areaSettingsFields" | "areaSettingsFooter", import("@phis/contracts/cms").PhiCmsInstanceId>>;
+export declare const PHI_BUILDER_AREA_SETTINGS_WIDGET_IDS: Readonly<Record<"areaSettingsAction" | "areaSettingsForm" | "areaSettingsCommands", import("@phis/contracts/cms").PhiCmsInstanceId>>;
+export declare const PHI_BUILDER_MODULE_DETAIL_OVERLAY_IDS: Readonly<Record<"overlayModuleDetail", import("@phis/contracts/cms").PhiCmsInstanceId>>;
+export declare const PHI_BUILDER_MODULE_DETAIL_LAYOUT_IDS: Readonly<Record<"body", import("@phis/contracts/cms").PhiCmsInstanceId>>;
+export declare const PHI_BUILDER_MODULE_DETAIL_WIDGET_IDS: Readonly<Record<"fields", import("@phis/contracts/cms").PhiCmsInstanceId>>;
+/**
+ * The dialog that asks where a Module's Public routes should answer.
+ *
+ * Its own address map rather than more keys in the Modules detail map, because it is a different
+ * conversation: the detail overlay reads a Module, this one holds an unanswered question about one.
+ */
+export declare const PHI_BUILDER_PUBLIC_ROUTES_OVERLAY_IDS: Readonly<Record<"overlayPublicRoutes", import("@phis/contracts/cms").PhiCmsInstanceId>>;
+export declare const PHI_BUILDER_PUBLIC_ROUTES_LAYOUT_IDS: Readonly<Record<"publicRoutesBody" | "publicRoutesFooter", import("@phis/contracts/cms").PhiCmsInstanceId>>;
+export declare const PHI_BUILDER_PUBLIC_ROUTES_WIDGET_IDS: Readonly<Record<"publicRoutesIntro" | "publicRoutesTable" | "publicRoutesCommands", import("@phis/contracts/cms").PhiCmsInstanceId>>;
+/** The dialog that says what switching a Module off stops drawing. */
+export declare const PHI_BUILDER_MODULE_USAGE_OVERLAY_IDS: Readonly<Record<"overlayModuleUsage", import("@phis/contracts/cms").PhiCmsInstanceId>>;
+export declare const PHI_BUILDER_MODULE_USAGE_LAYOUT_IDS: Readonly<Record<"moduleUsageBody" | "moduleUsageFooter", import("@phis/contracts/cms").PhiCmsInstanceId>>;
+export declare const PHI_BUILDER_MODULE_USAGE_WIDGET_IDS: Readonly<Record<"moduleUsageIntro" | "moduleUsageTable" | "moduleUsageCommands", import("@phis/contracts/cms").PhiCmsInstanceId>>;
+export declare const PHI_BUILDER_PAGE_META_OVERLAY_IDS: Readonly<Record<"editor", import("@phis/contracts/cms").PhiCmsInstanceId>>;
+export declare const PHI_BUILDER_PAGE_META_LAYOUT_IDS: Readonly<Record<"body" | "footer", import("@phis/contracts/cms").PhiCmsInstanceId>>;
+export declare const PHI_BUILDER_PAGE_META_WIDGET_IDS: Readonly<Record<"form" | "commands", import("@phis/contracts/cms").PhiCmsInstanceId>>;

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

@@ -0,0 +1,53 @@
+import { PHI_BUILDER_RUNTIME_MODULE_ID } from "./ids";
+import { createPhiPresetCmsInstanceId, createPhiPresetCmsInstanceIdMap } from "../../../types/cms-instance-id";
+export const PHI_BUILDER_MODULES_TABLE_WIDGET_ID = createPhiPresetCmsInstanceId({
+    domain: "page",
+    ownerModuleId: PHI_BUILDER_RUNTIME_MODULE_ID,
+    presetKey: "builder-area-preset",
+    nodeKey: "widgetModulesTable",
+});
+/**
+ * The Area settings dialog the Shells workspace opens, and what stands in it.
+ *
+ * Its own map because it is a conversation about the Area rather than about the canvas: the root
+ * route, the titles, and -- for Public, the only Area anything indexes -- whether the Area may be
+ * found at all. All of it is one Form, so the controller reaches three addresses: the overlay to
+ * open and close it, the Form to fill it and to ask it for what it holds, and the toolbar that asks.
+ */
+const AREA_SETTINGS_ID_CONTEXT = {
+    domain: "page",
+    ownerModuleId: PHI_BUILDER_RUNTIME_MODULE_ID,
+    presetKey: "builder-area-preset",
+};
+export const PHI_BUILDER_AREA_SETTINGS_OVERLAY_IDS = createPhiPresetCmsInstanceIdMap(AREA_SETTINGS_ID_CONTEXT, ["overlayAreaSettings"]);
+export const PHI_BUILDER_AREA_SETTINGS_LAYOUT_IDS = createPhiPresetCmsInstanceIdMap(AREA_SETTINGS_ID_CONTEXT, ["areaSettingsBody", "areaSettingsFields", "areaSettingsFooter"]);
+export const PHI_BUILDER_AREA_SETTINGS_WIDGET_IDS = createPhiPresetCmsInstanceIdMap(AREA_SETTINGS_ID_CONTEXT, ["areaSettingsAction", "areaSettingsForm", "areaSettingsCommands"]);
+const MODULES_DETAIL_ID_CONTEXT = {
+    domain: "page",
+    ownerModuleId: PHI_BUILDER_RUNTIME_MODULE_ID,
+    presetKey: "builder-area-preset",
+};
+export const PHI_BUILDER_MODULE_DETAIL_OVERLAY_IDS = createPhiPresetCmsInstanceIdMap(MODULES_DETAIL_ID_CONTEXT, ["overlayModuleDetail"]);
+export const PHI_BUILDER_MODULE_DETAIL_LAYOUT_IDS = createPhiPresetCmsInstanceIdMap(MODULES_DETAIL_ID_CONTEXT, ["body"]);
+export const PHI_BUILDER_MODULE_DETAIL_WIDGET_IDS = createPhiPresetCmsInstanceIdMap(MODULES_DETAIL_ID_CONTEXT, ["fields"]);
+/**
+ * The dialog that asks where a Module's Public routes should answer.
+ *
+ * Its own address map rather than more keys in the Modules detail map, because it is a different
+ * conversation: the detail overlay reads a Module, this one holds an unanswered question about one.
+ */
+export const PHI_BUILDER_PUBLIC_ROUTES_OVERLAY_IDS = createPhiPresetCmsInstanceIdMap(MODULES_DETAIL_ID_CONTEXT, ["overlayPublicRoutes"]);
+export const PHI_BUILDER_PUBLIC_ROUTES_LAYOUT_IDS = createPhiPresetCmsInstanceIdMap(MODULES_DETAIL_ID_CONTEXT, ["publicRoutesBody", "publicRoutesFooter"]);
+export const PHI_BUILDER_PUBLIC_ROUTES_WIDGET_IDS = createPhiPresetCmsInstanceIdMap(MODULES_DETAIL_ID_CONTEXT, ["publicRoutesIntro", "publicRoutesTable", "publicRoutesCommands"]);
+/** The dialog that says what switching a Module off stops drawing. */
+export const PHI_BUILDER_MODULE_USAGE_OVERLAY_IDS = createPhiPresetCmsInstanceIdMap(MODULES_DETAIL_ID_CONTEXT, ["overlayModuleUsage"]);
+export const PHI_BUILDER_MODULE_USAGE_LAYOUT_IDS = createPhiPresetCmsInstanceIdMap(MODULES_DETAIL_ID_CONTEXT, ["moduleUsageBody", "moduleUsageFooter"]);
+export const PHI_BUILDER_MODULE_USAGE_WIDGET_IDS = createPhiPresetCmsInstanceIdMap(MODULES_DETAIL_ID_CONTEXT, ["moduleUsageIntro", "moduleUsageTable", "moduleUsageCommands"]);
+const PAGE_META_ID_CONTEXT = {
+    domain: "page",
+    ownerModuleId: PHI_BUILDER_RUNTIME_MODULE_ID,
+    presetKey: "builder-pages-preset",
+};
+export const PHI_BUILDER_PAGE_META_OVERLAY_IDS = createPhiPresetCmsInstanceIdMap(PAGE_META_ID_CONTEXT, ["editor"]);
+export const PHI_BUILDER_PAGE_META_LAYOUT_IDS = createPhiPresetCmsInstanceIdMap(PAGE_META_ID_CONTEXT, ["body", "footer"]);
+export const PHI_BUILDER_PAGE_META_WIDGET_IDS = createPhiPresetCmsInstanceIdMap(PAGE_META_ID_CONTEXT, ["form", "commands"]);

package/plugins/runtime-modules/builder/area-settings-form.d.ts

@@ -0,0 +1,2 @@
+export declare const PHI_BUILDER_AREA_SETTINGS_FORM_ID: `${string}/forms/${string}`;
+export declare const PHI_BUILDER_AREA_SETTINGS_FORM: import("../contracts").PhiRuntimeModuleFormDefinition;

package/plugins/runtime-modules/builder/area-settings-form.js

@@ -0,0 +1,137 @@
+import { definePhiRuntimeModuleForm } from "../../../components/forms/form-registry";
+import { PHI_FORM_FIELD_PROVIDER_KEYS } from "../../../components/forms/form-provider-contract";
+import { createPhiFormId } from "../../../types/form-id";
+import { PHI_SHARED_PACKAGE_NAME } from "../../../types/signals";
+import { PHI_BUILDER_RUNTIME_MODULE_ID, PHI_BUILDER_RUNTIME_DATA_PROVIDER_KEYS } from "./ids";
+import { PHI_BUILDER_AREA_LANDING_PAGE_EMPTY, PHI_BUILDER_AREA_ROOT_ROUTE_AUTOMATIC, PHI_BUILDER_AREA_ROOT_ROUTE_LANDING, } from "./area-settings-values";
+export const PHI_BUILDER_AREA_SETTINGS_FORM_ID = createPhiFormId(PHI_SHARED_PACKAGE_NAME, "builder/area-settings");
+/**
+ * Every sentence an Area says about itself, read from where the form stands.
+ *
+ * `config` rather than `label`: a Form label set is loaded by the form's own registration, and these
+ * strings are already loaded -- the Builder's preset holds the whole translated chrome label set when
+ * it places this form, and wrote them straight into the Widget configs before. Taking them from the
+ * placement keeps one translation source for the dialog instead of two that have to be kept saying
+ * the same thing.
+ */
+const text = (key, fallback) => ({ kind: "config", key, fallback });
+/**
+ * What an Area answers about itself, as one form rather than as six Controls that each carry a label.
+ *
+ * The form is what puts the labels in a column of their own: `PHI_FORM_DEFAULT_LAYOUT` gives every
+ * field a label range of 1-9 and a control range of 9-25, so six rows line up on one edge instead of
+ * each being indented by the width of its own caption. That is the whole reason this is a form and
+ * not a stack -- the questions did not change.
+ *
+ * Field keys are the keys the Controls carried, because the Builder's controller reads the submitted
+ * record by them and the Area's stored config is written from the same names.
+ */
+const descriptor = {
+    schemaVersion: 1,
+    key: PHI_BUILDER_AREA_SETTINGS_FORM_ID,
+    fields: [
+        /*
+         * Where `/` goes. The two answers that are not a Page are stated here rather than by the
+         * Provider: they are the same two on every Site, and a static option carries the placement's
+         * translated caption, which a Client Provider has no way to reach.
+         */
+        {
+            key: "areaRootRoute",
+            fieldProviderKey: PHI_FORM_FIELD_PROVIDER_KEYS.select,
+            label: text("rootRouteTitle", "Area root"),
+            options: [
+                {
+                    value: PHI_BUILDER_AREA_ROOT_ROUTE_AUTOMATIC,
+                    label: text("rootRouteAutomatic", "First navigation entry"),
+                },
+                {
+                    value: PHI_BUILDER_AREA_ROOT_ROUTE_LANDING,
+                    label: text("rootRouteLanding", "Landing page"),
+                },
+            ],
+            optionsProvider: { providerKey: PHI_BUILDER_RUNTIME_DATA_PROVIDER_KEYS.areaRootRoute },
+        },
+        /*
+         * Which landing answers the slot, asked only once the answer above is "landing".
+         *
+         * Shown rather than disabled, which is what the Control it replaces did by signal: a question
+         * that does not apply is not a question an Area left unanswered, and a greyed-out Select beside a
+         * root that forwards reads as one.
+         */
+        {
+            key: "areaLandingPage",
+            fieldProviderKey: PHI_FORM_FIELD_PROVIDER_KEYS.select,
+            label: text("landingPageLabel", "Landing"),
+            options: [
+                {
+                    value: PHI_BUILDER_AREA_LANDING_PAGE_EMPTY,
+                    label: text("landingPageEmpty", "Builder"),
+                },
+            ],
+            optionsProvider: { providerKey: PHI_BUILDER_RUNTIME_DATA_PROVIDER_KEYS.landingPage },
+            visibleWhen: {
+                source: "form",
+                valuePath: "areaRootRoute",
+                operator: "equals",
+                value: PHI_BUILDER_AREA_ROOT_ROUTE_LANDING,
+            },
+        },
+        /*
+         * What the Area writes into the title of every Page it draws. Both may be left alone -- an Area
+         * that says nothing here still gets titles -- which is why the placeholders state the resting
+         * value rather than repeating the label.
+         */
+        {
+            key: "areaTitleTemplate",
+            fieldProviderKey: PHI_FORM_FIELD_PROVIDER_KEYS.text,
+            label: text("titleTemplateLabel", "Title template"),
+            placeholder: text("titleTemplatePlaceholder", "%s -- site name"),
+            config: { allowClear: true },
+        },
+        {
+            key: "areaDefaultTitle",
+            fieldProviderKey: PHI_FORM_FIELD_PROVIDER_KEYS.text,
+            label: text("defaultTitleLabel", "Default title"),
+            placeholder: text("defaultTitlePlaceholder", "Site name"),
+            config: { allowClear: true },
+        },
+        /*
+         * What the Area says about being found, and who may say it.
+         *
+         * Shown in every Area and answerable in none but Public, so they are disabled rather than hidden:
+         * outside Public the answer is still true -- an authenticated Area is never indexed -- and a
+         * switch that vanishes reads as a question nobody thought to ask. Which Area this is arrives with
+         * the values, in `seoLocked`, because a form may only ask its own record.
+         */
+        {
+            key: "areaMetaIndex",
+            fieldProviderKey: PHI_FORM_FIELD_PROVIDER_KEYS.switch,
+            label: text("seoIndexLabel", "Allow indexing"),
+            disabledWhen: { source: "form", valuePath: "seoLocked", operator: "equals", value: "true" },
+        },
+        {
+            key: "areaMetaSitemap",
+            fieldProviderKey: PHI_FORM_FIELD_PROVIDER_KEYS.switch,
+            label: text("seoSitemapLabel", "List pages in the sitemap"),
+            disabledWhen: { source: "form", valuePath: "seoLocked", operator: "equals", value: "true" },
+        },
+        {
+            key: "seoLocked",
+            fieldProviderKey: PHI_FORM_FIELD_PROVIDER_KEYS.hidden,
+            initialValue: "false",
+        },
+    ],
+};
+export const PHI_BUILDER_AREA_SETTINGS_FORM = definePhiRuntimeModuleForm({
+    ownerModuleId: PHI_BUILDER_RUNTIME_MODULE_ID,
+    areas: ["builder"],
+    formId: PHI_BUILDER_AREA_SETTINGS_FORM_ID,
+    version: 1,
+    flags: 0,
+    title: "Builder area settings",
+    description: "Edit what an Area says about its root, its titles and being found.",
+    category: "forms",
+    tags: ["builder", "area"],
+    descriptor,
+    submitHandlerKey: null,
+});

package/plugins/runtime-modules/builder/area-settings-values.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The answers the Area settings carry that are not a Page.
+ *
+ * Their own file because three readers need them and only one of them runs in a browser: the Client
+ * provider that fills the Selects, the Client controller that reads what was picked, and the form
+ * descriptor, which is registered on the server. A `"use client"` module cannot be the source for the
+ * third, and a second copy of a sentinel is a value that goes on matching until the day somebody
+ * edits one of them.
+ */
+/**
+ * Where the target Area's `/` goes, for the two answers that are not a Page.
+ *
+ * Everything else in that Select is a Page, and what a choice stores is the Page's reference, never
+ * its path: a path is a fact about today's routing table and would rot the first time a Page moved or
+ * a Module renamed its route.
+ */
+export declare const PHI_BUILDER_AREA_ROOT_ROUTE_AUTOMATIC: "phi-root-route:automatic";
+export declare const PHI_BUILDER_AREA_ROOT_ROUTE_LANDING: "phi-root-route:landing";
+/**
+ * "Nobody -- I will author it myself", as a value the Select can carry.
+ *
+ * The state has always existed in storage as a landing without a target; what it never had was a way
+ * to be said. A cleared Select is indistinguishable from one nobody has touched, so a Builder who
+ * meant "none" was read as "never asked" and the single applicant on offer was adopted behind them.
+ */
+export declare const PHI_BUILDER_AREA_LANDING_PAGE_EMPTY: "phi-landing-page:empty";

package/plugins/runtime-modules/builder/area-settings-values.js

@@ -0,0 +1,26 @@
+/**
+ * The answers the Area settings carry that are not a Page.
+ *
+ * Their own file because three readers need them and only one of them runs in a browser: the Client
+ * provider that fills the Selects, the Client controller that reads what was picked, and the form
+ * descriptor, which is registered on the server. A `"use client"` module cannot be the source for the
+ * third, and a second copy of a sentinel is a value that goes on matching until the day somebody
+ * edits one of them.
+ */
+/**
+ * Where the target Area's `/` goes, for the two answers that are not a Page.
+ *
+ * Everything else in that Select is a Page, and what a choice stores is the Page's reference, never
+ * its path: a path is a fact about today's routing table and would rot the first time a Page moved or
+ * a Module renamed its route.
+ */
+export const PHI_BUILDER_AREA_ROOT_ROUTE_AUTOMATIC = "phi-root-route:automatic";
+export const PHI_BUILDER_AREA_ROOT_ROUTE_LANDING = "phi-root-route:landing";
+/**
+ * "Nobody -- I will author it myself", as a value the Select can carry.
+ *
+ * The state has always existed in storage as a landing without a target; what it never had was a way
+ * to be said. A cleared Select is indistinguishable from one nobody has touched, so a Builder who
+ * meant "none" was read as "never asked" and the single applicant on offer was adopted behind them.
+ */
+export const PHI_BUILDER_AREA_LANDING_PAGE_EMPTY = "phi-landing-page:empty";

package/plugins/runtime-modules/builder/area-shell-presets.server.d.ts

@@ -34,7 +34,6 @@ export declare const buildPhiBuilderCurrentStructureShellDrafts: (runtime: PhiBl
     drafts: Record<string, PhiDeveloperBuilderRegionDraft>;
 }>;
 export declare const buildPhiBuilderStructureShellDraftsForArea: (runtime: PhiBlockRuntime, area: PhiDeveloperBuilderArea, runtimeModuleCatalog: PhiRuntimeModuleCatalog) => Promise<Record<string, PhiDeveloperBuilderRegionDraft>>;
-export declare function buildPhiBuilderStructureShellDraftsByArea(runtime: PhiBlockRuntime, runtimeModuleCatalog: PhiRuntimeModuleCatalog): Promise<Record<PhiDeveloperBuilderArea, Record<string, PhiDeveloperBuilderRegionDraft>>>;
 export declare function buildPhiBuilderRuntimeModulesConfigForArea(runtime: PhiBlockRuntime, area: PhiDeveloperBuilderArea, runtimeModuleCatalog: PhiRuntimeModuleCatalog): Promise<PhiBuilderAreaModulesConfig>;
 export declare function buildPhiBuilderRuntimeModuleIdsForArea(runtime: PhiBlockRuntime, area: PhiDeveloperBuilderArea, runtimeModuleCatalog: PhiRuntimeModuleCatalog): Promise<`${string}/${string}`[]>;
 export declare function buildPhiBuilderStructureRuntimeModuleIdsByArea(runtime: PhiBlockRuntime, runtimeModuleCatalog: PhiRuntimeModuleCatalog): Promise<Record<PhiDeveloperBuilderArea, PhiRuntimeModuleId[]>>;

package/plugins/runtime-modules/builder/area-shell-presets.server.js

@@ -137,11 +137,21 @@ const buildPhiBuilderAreaPresetConfig = cache(async function buildPhiBuilderArea
         cookieHeader,
         sourcePreset,
     };
-    const draftPreset = await getCurrentSiteAreaDraft({ ...request, area }).catch(() => null);
+    // A failed read is not "never asked": answering with the preset default would let the Builder show and
+    // save it over what the Area actually stores.
+    const draftPreset = await getCurrentSiteAreaDraft({ ...request, area }).catch((error) => {
+        throw new Error(`Failed to resolve builder structure draft config for area "${area}" at "${path}".`, {
+            cause: error,
+        });
+    });
     if (draftPreset?.preset) {
         return draftPreset.preset.preset.config ?? null;
     }
-    const resolvedPreset = await getExactSiteArea(request).catch(() => null);
+    const resolvedPreset = await getExactSiteArea(request).catch((error) => {
+        throw new Error(`Failed to resolve builder structure config for area "${area}" at "${path}".`, {
+            cause: error,
+        });
+    });
     return resolvedPreset?.preset ? resolvedPreset.preset.preset.config ?? null : null;
 });
 /** What an Area says its `/` resolves to. */
@@ -176,14 +186,6 @@ export const buildPhiBuilderCurrentStructureShellDrafts = cache(async function b
 export const buildPhiBuilderStructureShellDraftsForArea = cache(async function buildPhiBuilderStructureShellDraftsForArea(runtime, area, runtimeModuleCatalog) {
     return buildShellDraftsForArea(runtime, runtime.site.key, runtime.locale.current, readPhiServerApiCredentials().apiBaseUrl, readPhiServerApiCredentials().internalToken, area, runtimeModuleCatalog);
 });
-export async function buildPhiBuilderStructureShellDraftsByArea(runtime, runtimeModuleCatalog) {
-    const areas = PHI_BUILDER_AREA_KEYS;
-    const entries = await Promise.all(areas.map(async (area) => [
-        area,
-        await buildShellDraftsForArea(runtime, runtime.site.key, runtime.locale.current, readPhiServerApiCredentials().apiBaseUrl, readPhiServerApiCredentials().internalToken, area, runtimeModuleCatalog),
-    ]));
-    return Object.fromEntries(entries);
-}
 /**
  * What an Area's Modules namespace says, as the Builder sees it: the draft first, then what is
  * published, then the preset the code ships. Both answers come from one load because they are one

package/plugins/runtime-modules/builder/authoring-canvas.js

@@ -34,5 +34,10 @@ export function usePhiBuilderAuthoringCanvas() {
             return surface ? materializePhiBuilderNavigationSurface(surface, null) : null;
         },
         pageCatalog: resolvePhiBuilderActivePageCatalog(area, modulePresetPagesByArea, customPages, persistedPageCatalogByArea),
+        /*
+         * The same catalog for an Area that is not the one being edited, which a Navigation needs: a link
+         * may point into another Area, and only that Area's catalog holds its Page and can prefix its path.
+         */
+        pageCatalogForArea: (targetArea) => resolvePhiBuilderActivePageCatalog(targetArea, modulePresetPagesByArea, customPages, persistedPageCatalogByArea),
     }), [area, catalogHydrated, customPages, modulePresetPagesByArea, navigationSurfaces, persistedPageCatalogByArea]);
 }

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

@@ -1,5 +1,5 @@
 "use client";
-import { PHI_BUILDER_INSPECTOR_SECTION_WIDGET_DEFINITIONS, PHI_BUILDER_INSPECTOR_HEADER_WIDGET_DEFINITION, PHI_BUILDER_MODE_SWITCH_WIDGET_DEFINITION, PHI_DEVELOPER_BUILDER_DRAFT_STATUS_WIDGET_DEFINITION, } from "./widgets/chrome/config";
+import { PHI_BUILDER_INSPECTOR_SECTION_WIDGET_DEFINITIONS, PHI_BUILDER_INSPECTOR_HEADER_WIDGET_DEFINITION, PHI_BUILDER_MODE_SWITCH_WIDGET_DEFINITION, } from "./widgets/chrome/config";
 import { PHI_BUILDER_CHROME_CONTROLS_WIDGET_DEFINITION, } from "./widgets/chrome-controls/config";
 import { PHI_DEVELOPER_BUILDER_PAGES_HEADER_WIDGET_DEFINITION, } from "./widgets/workspace-headers/config";
 import { PHI_BUILDER_PAGES_WORKSPACE_WIDGET_DEFINITION, PHI_BUILDER_SHELLS_WORKSPACE_WIDGET_DEFINITION, } from "./widgets/workspaces/config";
@@ -14,9 +14,8 @@ export default createPhiAuthoringWidgetModule([
     definePhiAuthoringWidgetModuleLoader(PHI_BUILDER_MODE_SWITCH_WIDGET_DEFINITION, () => import("./widgets/mode-switch/authoring").then((module) => module.PHI_BUILDER_MODE_SWITCH_WIDGET_BUILDER_PLUGIN)),
     definePhiAuthoringWidgetModuleLoader(PHI_BUILDER_PAGES_WORKSPACE_WIDGET_DEFINITION, () => import("./widgets/pages-workspace/authoring").then((module) => module.PHI_BUILDER_PAGES_WORKSPACE_WIDGET_BUILDER_PLUGIN)),
     definePhiAuthoringWidgetModuleLoader(PHI_BUILDER_SHELLS_WORKSPACE_WIDGET_DEFINITION, () => import("./widgets/shells-workspace/authoring").then((module) => module.PHI_BUILDER_SHELLS_WORKSPACE_WIDGET_BUILDER_PLUGIN)),
-    definePhiAuthoringWidgetModuleLoader(PHI_DEVELOPER_BUILDER_DRAFT_STATUS_WIDGET_DEFINITION, () => import("./widgets/draft-status/authoring-plugin").then((module) => module.PHI_DEVELOPER_BUILDER_DRAFT_STATUS_WIDGET_BUILDER_PLUGIN)),
     definePhiAuthoringWidgetModuleLoader(PHI_DEVELOPER_BUILDER_PAGES_HEADER_WIDGET_DEFINITION, () => import("./widgets/developer-builder-pages-header/authoring").then((module) => module.PHI_DEVELOPER_BUILDER_PAGES_HEADER_WIDGET_BUILDER_PLUGIN)),
     definePhiAuthoringWidgetModuleLoader(PHI_HELLO_WORLD_WIDGET_DEFINITION, () => import("./widgets/hello-world/authoring").then((module) => module.PHI_HELLO_WORLD_WIDGET_BUILDER_PLUGIN)),
-    definePhiAuthoringWidgetModuleLoader(PHI_STRUCTURE_REGION_WIDGET_DEFINITION, () => import("../../../components/widgets/builder/internal-builder").then((module) => module.PHI_STRUCTURE_REGION_WIDGET_BUILDER_PLUGIN)),
+    definePhiAuthoringWidgetModuleLoader(PHI_STRUCTURE_REGION_WIDGET_DEFINITION, () => import("./widgets/structure-region/internal-builder").then((module) => module.PHI_STRUCTURE_REGION_WIDGET_BUILDER_PLUGIN)),
     definePhiAuthoringWidgetModuleLoader(PHI_TEST_BLOCK_WIDGET_DEFINITION, () => import("./widgets/test-block/authoring").then((module) => module.PHI_TEST_BLOCK_WIDGET_BUILDER_PLUGIN)),
 ]);

package/plugins/runtime-modules/builder/builder-geometry.d.ts

@@ -0,0 +1,28 @@
+import { type PhiRenderableBlockGeometryInput, type PhiResolvedBlockGeometry } from "../../../types/renderable-block-geometry";
+/**
+ * The two things the root scaffold adds to what the slot frame already writes.
+ *
+ * The scaffold's slot is a `PhiSlotChildFrame`, and that frame states the general answers inline: a
+ * minimum of `0`, a maximum of `100%`, and a width and a height from its policy -- `100%` where the
+ * root fills, `fit-content` where it is its content, the stated length where it states one. An inline
+ * style wins over every stylesheet, so a scaffold that restated those answers was writing into a
+ * declaration that never applied. It restated all six of them, with fallbacks of its own (`100%`,
+ * `auto`, `0`, `none`) and with a band handed down by the Region -- and none of it could be seen.
+ * That is the answer to the open question: the general answers are the frame's, and the scaffold does
+ * not have an exception to state. A Region that wants a band writes it on the box that gives the room,
+ * which is where the Structure Region already writes it.
+ *
+ * What is left is what the frame cannot say. The flex is one: the frame writes no `flex`, and a root
+ * that states a size on either axis must stop flexing or the slot stretches it past the size it just
+ * stated. The stated width and height are the other, and only for the server preview, which builds its
+ * frame without the root's config and would otherwise lose them; everywhere else the frame writes the
+ * same value inline and these are inherited and unused. They are written only when there is one, so the
+ * declaration that reads them is never left holding an empty variable -- the attribute that gates it is
+ * the same "the root stated a size" the value comes from.
+ */
+export declare function resolvePhiRootScaffoldProperties(geometry: PhiResolvedBlockGeometry): Record<`--phi-root-scaffold-${string}`, string>;
+/**
+ * The width the Canvas gives a sider Region, from the draft's geometry read once: its stated width,
+ * else its minimum, else the house sidebar width -- the same order the live Shell falls through.
+ */
+export declare function resolvePhiBuilderSiderWidth(draft: PhiRenderableBlockGeometryInput | null | undefined): string;

package/plugins/runtime-modules/builder/builder-geometry.js

@@ -0,0 +1,38 @@
+import { PHI_LAYOUT } from "../../../theme/phi-tokens";
+import { resolvePhiRenderableBlockGeometry, } from "../../../types/renderable-block-geometry";
+/**
+ * The two things the root scaffold adds to what the slot frame already writes.
+ *
+ * The scaffold's slot is a `PhiSlotChildFrame`, and that frame states the general answers inline: a
+ * minimum of `0`, a maximum of `100%`, and a width and a height from its policy -- `100%` where the
+ * root fills, `fit-content` where it is its content, the stated length where it states one. An inline
+ * style wins over every stylesheet, so a scaffold that restated those answers was writing into a
+ * declaration that never applied. It restated all six of them, with fallbacks of its own (`100%`,
+ * `auto`, `0`, `none`) and with a band handed down by the Region -- and none of it could be seen.
+ * That is the answer to the open question: the general answers are the frame's, and the scaffold does
+ * not have an exception to state. A Region that wants a band writes it on the box that gives the room,
+ * which is where the Structure Region already writes it.
+ *
+ * What is left is what the frame cannot say. The flex is one: the frame writes no `flex`, and a root
+ * that states a size on either axis must stop flexing or the slot stretches it past the size it just
+ * stated. The stated width and height are the other, and only for the server preview, which builds its
+ * frame without the root's config and would otherwise lose them; everywhere else the frame writes the
+ * same value inline and these are inherited and unused. They are written only when there is one, so the
+ * declaration that reads them is never left holding an empty variable -- the attribute that gates it is
+ * the same "the root stated a size" the value comes from.
+ */
+export function resolvePhiRootScaffoldProperties(geometry) {
+    return {
+        "--phi-root-scaffold-flex": geometry.explicitInline || geometry.explicitBlock ? "0 0 auto" : "1 1 auto",
+        ...(geometry.inline.size == null ? {} : { "--phi-root-scaffold-explicit-width": geometry.inline.size.css }),
+        ...(geometry.block.size == null ? {} : { "--phi-root-scaffold-explicit-height": geometry.block.size.css }),
+    };
+}
+/**
+ * The width the Canvas gives a sider Region, from the draft's geometry read once: its stated width,
+ * else its minimum, else the house sidebar width -- the same order the live Shell falls through.
+ */
+export function resolvePhiBuilderSiderWidth(draft) {
+    const geometry = resolvePhiRenderableBlockGeometry(draft);
+    return geometry.inline.size?.css ?? geometry.inline.min?.css ?? `${PHI_LAYOUT.sidebarWidth}px`;
+}

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

@@ -59,6 +59,14 @@ export const PHI_BUILDER_RUNTIME_DATA_PROVIDER_CLIENT_DEFINITIONS = [
         loadAuthoring: async () => (await import("./options-providers"))
             .PhiBuilderNavigationSetsOptionsProviderClient,
     },
+    {
+        key: PHI_BUILDER_RUNTIME_DATA_PROVIDER_KEYS.collectionItemRenderers,
+        ownerModuleId: PHI_BUILDER_RUNTIME_MODULE_ID,
+        loadLive: async () => (await import("./options-providers"))
+            .PhiBuilderCollectionItemRenderersOptionsProviderClient,
+        loadAuthoring: async () => (await import("./options-providers"))
+            .PhiBuilderCollectionItemRenderersOptionsProviderClient,
+    },
     {
         key: PHI_BUILDER_RUNTIME_DATA_PROVIDER_KEYS.forms,
         ownerModuleId: PHI_BUILDER_RUNTIME_MODULE_ID,

package/plugins/runtime-modules/builder/client.d.ts

@@ -1,2 +1 @@
 export declare const PhiLazyBuilderRuntimeControllerClient: import("react").ComponentType<import("../contracts").PhiRuntimeModuleControllerClientProps>;
-export declare function loadPhiBuilderRuntimeAuthoringClient(): Promise<import("react").ComponentClass<import("../contracts").PhiRuntimeModuleAuthoringClientProps, any> | import("react").FunctionComponent<import("../contracts").PhiRuntimeModuleAuthoringClientProps>>;

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

@@ -5,7 +5,3 @@ import dynamic from "next/dynamic";
  * route's loadable manifest, and the HTML asks for them before hydration instead of after it.
  */
 export const PhiLazyBuilderRuntimeControllerClient = dynamic(() => import("./controller/client").then((module) => module.PhiBuilderRuntimeControllerClient));
-export function loadPhiBuilderRuntimeAuthoringClient() {
-    return import("./authoring")
-        .then((module) => module.PhiBuilderRuntimeModuleAuthoringClient);
-}

package/plugins/runtime-modules/builder/clients/builder-region-overrides.js

@@ -1,8 +1,7 @@
 "use client";
 import { jsx as _jsx } from "react/jsx-runtime";
 import { useMemo } from "react";
-import { resolvePhiCssLength } from "../../../../helpers/css-length";
-import { PHI_LAYOUT } from "../../../../theme/phi-tokens";
+import { resolvePhiBuilderSiderWidth } from "../builder-geometry";
 import { PhiAuthoringRegionOverridesProvider } from "../../../../components/runtime/authoring-region-overrides";
 import { getDefaultRegionDraft, resolveRegionDraftKey } from "../developer-region-drafts";
 import { usePhiDeveloperBuilderStateValue, usePhiDeveloperRegionDrafts } from "../developer-workspace-store";
@@ -16,8 +15,8 @@ export function PhiBuilderCanvasRegionOverrides({ children }) {
         const siderLeft = resolveRegionDraftKey(regionDrafts, area, "sider_left", pageKey) ?? getDefaultRegionDraft("sider_left");
         return {
             preview: builderMode === "preview",
-            pageSiderRight: { visible: siderRight.rootNodeTypeKey != null, width: resolvePhiCssLength(siderRight.size?.width ?? siderRight.minSize?.width ?? PHI_LAYOUT.sidebarWidth) ?? `${PHI_LAYOUT.sidebarWidth}px` },
-            structureSiderLeft: { visible: siderLeft.rootNodeTypeKey != null, width: resolvePhiCssLength(siderLeft.size?.width ?? siderLeft.minSize?.width ?? PHI_LAYOUT.sidebarWidth) ?? `${PHI_LAYOUT.sidebarWidth}px`, fullHeight: siderLeft.regionConfig?.fullHeight === true },
+            pageSiderRight: { visible: siderRight.rootNodeTypeKey != null, width: resolvePhiBuilderSiderWidth(siderRight) },
+            structureSiderLeft: { visible: siderLeft.rootNodeTypeKey != null, width: resolvePhiBuilderSiderWidth(siderLeft), fullHeight: siderLeft.regionConfig?.fullHeight === true },
         };
     }, [area, builderMode, pageKey, regionDrafts]);
     return _jsx(PhiAuthoringRegionOverridesProvider, { value: value, children: children });