@phis/ui 0.2.1 → 0.3.0

package/components/widgets/shared/markdown-body-client.js

@@ -5,32 +5,13 @@ import { PhiLink } from "../../navigation/phi-link";
 import { PHI_SIGNAL_VALUE_SCHEMAS } from "../../../types/signals";
 import { usePhiSignalEmitter } from "../../runtime/runtime-signal-identity";
 import { usePhiConfig } from "../../root/phi-config-provider";
+import { resolvePhiSpacingScaleValue } from "../config/spacing-options";
+import { PHI_SPACE } from "../../../theme/antd-css-var-contract";
 import { PhiPlainTable } from "../../tables/phi-plain-table";
 import { PhiTypographyControl } from "../../controls/phi-typography-control";
 import { PhiDividerControl } from "../../controls/phi-divider-control";
-function resolveMarkdownSpacing(token, value, fallback) {
-    const nextValue = value ?? fallback;
-    switch (nextValue) {
-        case "none":
-            return 0;
-        case "xxs":
-            return token.paddingXXS;
-        case "xs":
-            return token.paddingXS;
-        case "sm":
-            return token.paddingSM;
-        case "base":
-            return token.padding;
-        case "md":
-            return token.paddingMD;
-        case "lg":
-            return token.paddingLG;
-        case "xl":
-            return token.paddingXL;
-        case "xxl":
-            return token.paddingXL;
-    }
-}
+import { PhiBulletListControl } from "../../controls/phi-bullet-list-control";
+import { resolvePhiBulletListStyle, } from "./bullet-list-vocabulary";
 /**
  * The colour a kind of code is drawn in, from the Theme and from nowhere else.
  *
@@ -87,7 +68,7 @@ function renderInlineNodes(inlines) {
         }
     });
 }
-function renderBlocks(blocks, token, paragraphBlockStyle, headingBlockStyle) {
+function renderBlocks(blocks, token, paragraphBlockStyle, headingBlockStyle, lists) {
     return blocks.map((block, index) => {
         const key = `${block.kind}-${index}`;
         switch (block.kind) {
@@ -98,17 +79,21 @@ function renderBlocks(blocks, token, paragraphBlockStyle, headingBlockStyle) {
             case "blockquote":
                 return (_jsx("blockquote", { style: {
                         margin: 0,
-                        paddingInlineStart: token.paddingLG,
+                        paddingInlineStart: PHI_SPACE.md,
                         borderInlineStart: `3px solid ${token.colorBorderSecondary}`,
-                    }, children: _jsx("div", { style: { display: "grid", gap: 0 }, children: renderBlocks(block.children, token, paragraphBlockStyle, headingBlockStyle) }) }, key));
-            case "list": {
-                const ListTag = block.ordered ? "ol" : "ul";
-                return (_jsx(ListTag, { start: block.ordered ? block.start : undefined, style: { margin: 0, paddingInlineStart: token.paddingMD }, children: block.items.map((itemBlocks, itemIndex) => (_jsx("li", { style: { marginBlockEnd: token.paddingXS }, children: _jsx("div", { style: { display: "grid", gap: token.paddingXS }, children: renderBlocks(itemBlocks, token, paragraphBlockStyle, headingBlockStyle) }) }, `${key}-item-${itemIndex}`))) }, key));
-            }
+                    }, children: _jsx("div", { style: { display: "grid", gap: 0 }, children: renderBlocks(block.children, token, paragraphBlockStyle, headingBlockStyle, lists) }) }, key));
+            case "list":
+                /*
+                 * The house's list, set by the Widget's list settings. A `1.` list counts whatever its level's
+                 * marker says: the numbers are the text's, not a look. A list inside an entry is one level down.
+                 */
+                return (_jsx(PhiBulletListControl, { listStyle: lists.style, depth: lists.depth, ordered: block.ordered, start: block.start, items: block.items.map((itemBlocks) => ({
+                        content: (_jsx("div", { style: { display: "grid", gap: PHI_SPACE.xs, minWidth: 0 }, children: renderBlocks(itemBlocks, token, paragraphBlockStyle, headingBlockStyle, { ...lists, depth: lists.depth + 1 }) })),
+                    })) }, key));
             case "code":
                 return (_jsx("pre", { "data-phi-code-language": block.language ?? undefined, style: {
                         margin: 0,
-                        padding: token.paddingLG,
+                        padding: PHI_SPACE.md,
                         overflowX: "auto",
                         borderRadius: token.borderRadiusSM,
                         background: token.colorFillQuaternary,
@@ -169,13 +154,16 @@ export function PhiMarkdownWidgetClient({ config }) {
     }
     const paragraphBlockStyle = {
         margin: 0,
-        marginBlockStart: resolveMarkdownSpacing(token, config?.textBlockSpacingBefore, "none"),
-        marginBlockEnd: resolveMarkdownSpacing(token, config?.textBlockSpacingAfter, "sm"),
+        marginBlockStart: resolvePhiSpacingScaleValue(config?.textBlockSpacingBefore ?? "none"),
+        marginBlockEnd: resolvePhiSpacingScaleValue(config?.textBlockSpacingAfter ?? "sm"),
     };
     const headingBlockStyle = {
         margin: 0,
-        marginBlockStart: resolveMarkdownSpacing(token, config?.headingBlockSpacingBefore, "none"),
-        marginBlockEnd: resolveMarkdownSpacing(token, config?.headingBlockSpacingAfter, "sm"),
+        marginBlockStart: resolvePhiSpacingScaleValue(config?.headingBlockSpacingBefore ?? "none"),
+        marginBlockEnd: resolvePhiSpacingScaleValue(config?.headingBlockSpacingAfter ?? "sm"),
     };
-    return (_jsx("div", { style: { display: "grid", gap: 0, width: "100%", textAlign: config?.textAlign }, children: renderBlocks(blocks, token, paragraphBlockStyle, headingBlockStyle) }));
+    return (_jsx("div", { style: { display: "grid", gap: 0, width: "100%", textAlign: config?.textAlign }, children: renderBlocks(blocks, token, paragraphBlockStyle, headingBlockStyle, {
+            style: resolvePhiBulletListStyle(config?.list),
+            depth: 1,
+        }) }));
 }

package/components/widgets/shared/markdown-render.d.ts

@@ -21,6 +21,17 @@ export type PhiMarkdownSourceConfig = {
     tocKey?: string;
     resolvedContent?: PhiCmsResolvedContent | null;
     renderMode?: PhiRenderableBlockRenderMode;
+    /**
+     * How much of the document is wanted. `first-paragraph` is a teaser's: the document is parsed whole and
+     * cut to its first paragraph before anything is translated, so a card under an entry does not pay a
+     * provider for paragraphs nobody is shown. `document`, the default, is all of it.
+     */
+    extent?: "document" | "first-paragraph";
+    /**
+     * How many levels a heading moves down. A text that stands under a title of its own -- an entry under its
+     * header -- starts at `h2`, so `#` does not draw a second title of the same size. The level stops at 5.
+     */
+    headingOffset?: number;
 };
 export type MarkdownRenderData = {
     blocks: PhiMarkdownBlock[];

package/components/widgets/shared/markdown-render.js

@@ -49,14 +49,22 @@ function normalizePotentialPhiScheme(value) {
     }
     return current.replace(/[\u0000-\u0020]+/gu, "").toLowerCase();
 }
+/*
+ * The schemes a link or picture in a fetched document may carry: the same list the inline path allows
+ * (`projectInternalMarkdownNodes`). A relative address is resolved against the document and comes out
+ * `http(s):`; an absolute one is kept only on this list. Resolving first and trusting whatever `URL`
+ * accepted let `javascript:` and `data:` through here while the inline path refused them.
+ */
+const PHI_EXTERNAL_DOCUMENT_URL_SCHEMES = /^(?:https?:|mailto:|tel:)$/iu;
 function resolveExternalDocumentUrl(value, sourceUrl) {
     const normalized = value.trim();
     if (!normalized || normalizePotentialPhiScheme(normalized).startsWith("phis:"))
         return null;
-    if (normalized.startsWith("#") || /^(?:https?:|mailto:|tel:)/iu.test(normalized))
+    if (normalized.startsWith("#"))
         return normalized;
     try {
-        return new URL(normalized, sourceUrl).toString();
+        const resolved = new URL(normalized, sourceUrl);
+        return PHI_EXTERNAL_DOCUMENT_URL_SCHEMES.test(resolved.protocol) ? resolved.toString() : null;
     }
     catch {
         return null;
@@ -352,7 +360,7 @@ function mapBlockNodes(nodes, context, inlineMap) {
         }
         switch (node.type) {
             case "heading": {
-                const level = Math.min(Math.max(node.depth ?? 1, 1), 5);
+                const level = Math.min(Math.max((node.depth ?? 1) + context.headingOffset, 1), 5);
                 const inlines = inlineMap.get(node) ?? mapInlineNodes(node.children);
                 const text = getInlineText(inlines).trim();
                 const id = resolveMarkdownHeadingId(text, context);
@@ -479,17 +487,27 @@ export async function resolveMarkdownRenderData(config, runtime) {
      */
     config?.sourceLocale?.trim() || undefined, sourceMode, sourceMode === "url" && config?.sourceUrl
         ? normalizeMarkdownSourceUrl(config.sourceUrl, runtime?.site.publicUrl)
-        : null, runtime);
+        : null, runtime, config?.extent ?? "document", config?.headingOffset ?? 0);
 }
-async function resolveMarkdownRenderDataFromSource(markdown, translate, headingIdPrefix, sourceLocale, sourceMode = "inline", sourceUrl = null, runtime) {
+async function resolveMarkdownRenderDataFromSource(markdown, translate, headingIdPrefix, sourceLocale, sourceMode = "inline", sourceUrl = null, runtime, extent = "document", headingOffset = 0) {
     const tree = parseMarkdown(markdown);
+    if (extent === "first-paragraph") {
+        // Cut by the parser's own reading, never by blank lines: a fence or a list may hold those too.
+        const paragraph = tree.children?.find((node) => node.type === "paragraph");
+        tree.children = paragraph ? [paragraph] : [];
+    }
     if (sourceMode === "url" && sourceUrl) {
         tree.children = projectExternalMarkdownNodes(tree.children, sourceUrl);
     }
     else if (runtime) {
         await projectInternalMarkdownNodes(tree, runtime);
     }
-    const context = { headings: [], headingIdCounts: new Map(), headingIdPrefix };
+    const context = {
+        headings: [],
+        headingIdCounts: new Map(),
+        headingIdPrefix,
+        headingOffset,
+    };
     const inlineMap = await buildMarkdownInlineMap(tree, translate, sourceLocale);
     const blocks = mapBlockNodes(tree.children, context, inlineMap);
     return { blocks, headings: context.headings };

package/components/widgets/shared/result-body-client.js

@@ -1,12 +1,12 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Result } from "antd";
 import { PhiButtonControl } from "../../controls/phi-button-control";
+import { PhiResultControl } from "../../controls/phi-result-control";
 export function PhiResultWidgetBody({ config, code, title, subTitle, homeHref, homeLinkLabel, }) {
     const renderedTitle = code && title && code !== title
         ? (_jsxs("span", { style: { display: "inline-flex", flexDirection: "column", gap: "var(--ant-padding-xxs)" }, children: [_jsx("span", { children: code }), _jsx("span", { style: { fontSize: "var(--ant-font-size-lg)", fontWeight: 400 }, children: title })] }))
         : (title || code || "Information");
-    return (_jsx(Result, { status: config?.status ?? "info", title: renderedTitle, subTitle: subTitle, extra: config?.homeLink
+    return (_jsx(PhiResultControl, { status: config?.status ?? "info", title: renderedTitle, subTitle: subTitle, extra: config?.homeLink
             ? _jsx(PhiButtonControl, { href: homeHref, label: homeLinkLabel, type: "primary" })
             : undefined }));
 }

package/components/widgets/signals/command-toolbar-address.d.ts

@@ -1,4 +1,2 @@
 import { type PhiCmsInstanceId } from "../../../types/cms-instance-id";
-import { type PhiSignalAddress } from "../../../types/signals";
 export declare function createPhiCommandToolbarId(ownerModuleId: string, presetKey: string): PhiCmsInstanceId;
-export declare function createPhiCommandToolbarControlAddress(ownerModuleId: string, presetKey: string, controlKey: "undo" | "redo"): PhiSignalAddress;

package/components/widgets/signals/command-toolbar-address.js

@@ -1,5 +1,4 @@
 import { createPhiPresetCmsInstanceId, } from "../../../types/cms-instance-id";
-import { createPhiSignalSubcontrolAddress, } from "../../../types/signals";
 export function createPhiCommandToolbarId(ownerModuleId, presetKey) {
     return createPhiPresetCmsInstanceId({
         domain: "area",
@@ -8,6 +7,3 @@ export function createPhiCommandToolbarId(ownerModuleId, presetKey) {
         nodeKey: "widgetToolbar",
     });
 }
-export function createPhiCommandToolbarControlAddress(ownerModuleId, presetKey, controlKey) {
-    return createPhiSignalSubcontrolAddress("cms", createPhiCommandToolbarId(ownerModuleId, presetKey), controlKey);
-}

package/components/widgets/signals/control-signal-capabilities.d.ts

@@ -37,19 +37,6 @@ export declare const PHI_COMMAND_CONTROL_SIGNALS: {
         target: "subcontrol";
     })[];
 };
-export declare const PHI_CONTROL_BADGE_SIGNALS: {
-    listens: ({
-        id: string;
-        channel: string;
-        action: "change";
-        valueType: "string";
-    } | {
-        id: string;
-        channel: string;
-        action: "change";
-        valueType: "number";
-    })[];
-};
 export declare const PHI_BUTTON_CONTROL_SIGNALS: {
     emits: ({
         id: string;
@@ -76,6 +63,29 @@ export declare const PHI_BUTTON_CONTROL_SIGNALS: {
         valueType: "number";
     })[];
 };
+/**
+ * What a Card answers and what it says. Its box -- size, visibility, enabled -- is the frame's, as for
+ * every block; these are the card's own: its words and its figure from a Controller, the figure's wait,
+ * the highlight that marks the card that is current, and the action button pressed.
+ */
+export declare const PHI_CARD_SIGNALS: {
+    emits: {
+        id: string;
+        action: "activate";
+        valueType: "none";
+    }[];
+    listens: ({
+        id: string;
+        channel: string;
+        action: "change";
+        valueType: "string";
+    } | {
+        id: string;
+        channel: string;
+        action: "change";
+        valueType: "boolean";
+    })[];
+};
 export declare const PHI_TEXT_CONTROL_SIGNALS: {
     emits: ({
         id: string;

package/components/widgets/signals/control-signal-capabilities.js

@@ -49,9 +49,14 @@ export const PHI_COMMAND_CONTROL_SIGNALS = {
         { id: "badgeCount", channel: "badge", action: "change", valueType: "number", target: "subcontrol" },
         { id: "icon", channel: "icon", action: "change", valueType: "icon", target: "subcontrol" },
         { id: "label", channel: "label", action: "change", valueType: "string", target: "subcontrol" },
+        /*
+         * What the button's tooltip says, for a command whose meaning moves with state -- Undo naming the
+         * step it would take back. The tooltip a button was placed with stands until a value arrives.
+         */
+        { id: "tooltip", channel: "tooltip", action: "change", valueType: "string", target: "subcontrol" },
     ],
 };
-export const PHI_CONTROL_BADGE_SIGNALS = {
+const PHI_CONTROL_BADGE_SIGNALS = {
     listens: [
         { id: "badgeText", channel: "badge", action: "change", valueType: "string" },
         { id: "badgeCount", channel: "badge", action: "change", valueType: "number" },
@@ -67,6 +72,25 @@ export const PHI_BUTTON_CONTROL_SIGNALS = {
         ...PHI_CONTROL_BADGE_SIGNALS.listens,
     ],
 };
+/**
+ * What a Card answers and what it says. Its box -- size, visibility, enabled -- is the frame's, as for
+ * every block; these are the card's own: its words and its figure from a Controller, the figure's wait,
+ * the highlight that marks the card that is current, and the action button pressed.
+ */
+export const PHI_CARD_SIGNALS = {
+    emits: [
+        { id: "activate", action: "activate", valueType: "none" },
+    ],
+    listens: [
+        { id: "value", channel: "value", action: "change", valueType: "string" },
+        { id: "loading", channel: "loading", action: "change", valueType: "boolean" },
+        { id: "eyebrow", channel: "eyebrow", action: "change", valueType: "string" },
+        { id: "title", channel: "title", action: "change", valueType: "string" },
+        { id: "description", channel: "description", action: "change", valueType: "string" },
+        { id: "meta", channel: "meta", action: "change", valueType: "string" },
+        { id: "highlight", channel: "highlight", action: "change", valueType: "boolean" },
+    ],
+};
 export const PHI_TEXT_CONTROL_SIGNALS = {
     emits: [
         { id: "change", action: "change", valueType: "string" },
@@ -108,13 +132,19 @@ export const PHI_NUMBER_CONTROL_SIGNALS = {
         { ...PHI_CONTROL_CLEAR_SIGNAL, channel: "number" },
     ],
 };
+/*
+ * The channel is named for the Control, not for its value type: `size/change` is the size of the block
+ * itself, which every renderable block receives (`PHI_RENDERABLE_BLOCK_RECEIVE_BINDINGS`), so a Dimension
+ * listening on it would have said twice that it takes a size -- once for its box, once for its value --
+ * and its endpoint was refused as soon as one was placed.
+ */
 export const PHI_DIMENSION_CONTROL_SIGNALS = {
     emits: [
         { id: "change", action: "change", valueType: "size" },
     ],
     listens: [
-        { ...PHI_CONTROL_SET_VALUE_SIGNAL, channel: "size", valueType: "size" },
-        { ...PHI_CONTROL_CLEAR_SIGNAL, channel: "size" },
+        { ...PHI_CONTROL_SET_VALUE_SIGNAL, channel: "dimension", valueType: "size" },
+        { ...PHI_CONTROL_CLEAR_SIGNAL, channel: "dimension" },
     ],
 };
 export const PHI_LENGTH_CONTROL_SIGNALS = {

package/components/widgets/signals/renderable-block-signal-capabilities.d.ts

@@ -73,3 +73,8 @@ export declare const PHI_RENDERABLE_BLOCK_RECEIVE_BINDINGS: readonly [{
     readonly valueType: "none";
 }];
 export declare const PHI_RENDERABLE_BLOCK_RECEIVE_CHANNELS: ReadonlySet<string>;
+/**
+ * The channels that change a block's Surface. A Widget whose slot frame does not draw its Surface
+ * (`surface: "own"`, `"none"` or nothing stated) has nobody to answer them, so it does not offer them.
+ */
+export declare const PHI_RENDERABLE_BLOCK_SURFACE_CHANNELS: ReadonlySet<string>;

package/components/widgets/signals/renderable-block-signal-capabilities.js

@@ -89,3 +89,8 @@ export const PHI_RENDERABLE_BLOCK_RECEIVE_BINDINGS = [
     },
 ];
 export const PHI_RENDERABLE_BLOCK_RECEIVE_CHANNELS = new Set(PHI_RENDERABLE_BLOCK_RECEIVE_BINDINGS.map((capability) => capability.channel));
+/**
+ * The channels that change a block's Surface. A Widget whose slot frame does not draw its Surface
+ * (`surface: "own"`, `"none"` or nothing stated) has nobody to answer them, so it does not offer them.
+ */
+export const PHI_RENDERABLE_BLOCK_SURFACE_CHANNELS = new Set(["background", "border", "shadow"]);

package/components/widgets/signals/signal-endpoints.d.ts

@@ -1,5 +1,6 @@
 import type { PhiSignalAddress, PhiSignalInputCapability, PhiSignalOutputCapability, PhiSignalPluginMeta, PhiSignalScope } from "../../../types/signals";
 import type { PhiCmsWidgetSignalSubcontrolCollection, PhiRuntimeModuleControllerDescriptor, PhiRuntimeControllerSetting } from "../../../types";
+import type { PhiSurfacePolicy } from "../../../types/surface";
 import type { PhiCmsInstanceId } from "../../../types/cms-instance-id";
 export type PhiSignalEndpointTarget = "self" | "subcontrol";
 export type PhiSignalEndpoint = {
@@ -15,13 +16,15 @@ export declare function resolvePhiWidgetSignalSubcontrolAddresses({ blockId, con
     config: Record<string, unknown> | null | undefined;
     signalSubcontrols: readonly PhiCmsWidgetSignalSubcontrolCollection[] | null | undefined;
 }): PhiSignalAddress[];
-export declare function resolvePhiWidgetSignalEndpoints({ blockId, label, typeKey, config, runtimeSignals, signalSubcontrols, routeScope, }: {
+export declare function resolvePhiWidgetSignalEndpoints({ blockId, label, typeKey, config, runtimeSignals, signalSubcontrols, surfacePolicy, routeScope, }: {
     blockId: PhiCmsInstanceId;
     label?: string | null;
     typeKey?: string | null;
     config?: Record<string, unknown> | null;
     runtimeSignals?: PhiSignalPluginMeta | null;
     signalSubcontrols?: readonly PhiCmsWidgetSignalSubcontrolCollection[] | null;
+    /** Who draws the Widget's Surface; only the slot frame answers the Surface channels. */
+    surfacePolicy?: PhiSurfacePolicy | null;
     routeScope?: PhiSignalScope;
 }): PhiSignalEndpoint[];
 export declare function resolvePhiLayoutSignalEndpoints({ blockId, label, typeKey, kind, runtimeSignals, routeScope, }: {

package/components/widgets/signals/signal-endpoints.js

@@ -1,5 +1,5 @@
 import { createPhiControllerSignalAddress, createPhiSignalAddress, createPhiSignalSubcontrolAddress, } from "../../../types/signals";
-import { PHI_RENDERABLE_BLOCK_RECEIVE_BINDINGS } from "./renderable-block-signal-capabilities";
+import { PHI_RENDERABLE_BLOCK_RECEIVE_BINDINGS, PHI_RENDERABLE_BLOCK_SURFACE_CHANNELS, } from "./renderable-block-signal-capabilities";
 import { isPhiRecord } from "../../../helpers/is-record";
 function readString(value) {
     return typeof value === "string" && value.trim() ? value.trim() : null;
@@ -51,7 +51,10 @@ function readWidgetSignalSubcontrols(config, collections) {
             }
             keys.add(key);
             const label = collection.labelFields
-                ?.map((field) => readString(rawItem[field]))
+                ?.map((field) => {
+                const value = readString(rawItem[field]);
+                return value == null ? undefined : collection.labelFieldValues?.[field]?.[value] ?? value;
+            })
                 .find((value) => value != null) ?? key;
             subcontrols.push({ key, label });
         }
@@ -150,13 +153,15 @@ function resolveSelfSignalEndpoint({ address, label, runtimeSignals, routeScope,
         listens,
     };
 }
-export function resolvePhiWidgetSignalEndpoints({ blockId, label, typeKey, config, runtimeSignals, signalSubcontrols, routeScope = "widget", }) {
+export function resolvePhiWidgetSignalEndpoints({ blockId, label, typeKey, config, runtimeSignals, signalSubcontrols, surfacePolicy, routeScope = "widget", }) {
     const parentEndpoint = resolveSelfSignalEndpoint({
         address: createPhiSignalAddress("cms", blockId),
         label: label?.trim() || typeKey?.trim() || `cms:${blockId}`,
         runtimeSignals,
         routeScope,
-        inheritedListens: PHI_RENDERABLE_BLOCK_RECEIVE_BINDINGS,
+        inheritedListens: surfacePolicy === "frame"
+            ? PHI_RENDERABLE_BLOCK_RECEIVE_BINDINGS
+            : PHI_RENDERABLE_BLOCK_RECEIVE_BINDINGS.filter((binding) => !PHI_RENDERABLE_BLOCK_SURFACE_CHANNELS.has(binding.channel)),
     });
     const subcontrolEndpoints = readWidgetSignalSubcontrolEndpoints(config, blockId, runtimeSignals, routeScope, signalSubcontrols);
     return [parentEndpoint, ...subcontrolEndpoints];

package/components/workspace/catalog-state.d.ts

@@ -13,6 +13,12 @@ export type PhiWorkspaceCatalogArea = PhiBuilderAreaKey;
  * the Editor will feed the same thing once it hosts a workspace of its own. Keeping it here is what
  * lets a Module like revisions read it without importing the Builder.
  */
+/** Why an installed Module does not run here: its provider, and the capabilities it lacks. */
+export type PhiWorkspaceServerUnavailableModule = {
+    providerId: string;
+    diagnosticCode: string;
+    missingCapabilities: readonly string[];
+};
 export type PhiWorkspaceCatalogState = {
     /** The Area being worked on. */
     area: PhiWorkspaceCatalogArea;
@@ -36,6 +42,13 @@ export type PhiWorkspaceCatalogState = {
      * them so that both facts are visible before that happens.
      */
     unresolvedModuleIdsByArea: Partial<Record<PhiWorkspaceCatalogArea, PhiRuntimeModuleId[]>>;
+    /**
+     * Installed Modules whose server half is not there on this Site, and what is missing.
+     *
+     * Such a Module is off in every Area whatever the selection says (MODULES.md, "Server binding"), and a
+     * workspace that drew it like any other would show a switch that does nothing -- so it shows why.
+     */
+    serverUnavailableModules: Partial<Record<PhiRuntimeModuleId, PhiWorkspaceServerUnavailableModule>>;
     /**
      * Every Public address an installed Module would answer on, switched on or not.
      *

package/components/workspace/catalog-store.js

@@ -19,6 +19,7 @@ function createDefaultWorkspaceCatalogState(scopeKey) {
         runtimeModuleDefinitions: [],
         runtimeModuleIdsByArea: {},
         unresolvedModuleIdsByArea: {},
+        serverUnavailableModules: {},
         publicRouteClaims: [],
         publicRoutePaths: [],
     };

package/constants/cms-layout-types.d.ts

@@ -40,6 +40,11 @@ export declare const PHI_CMS_DEFAULT_LAYOUT_SLOTS: readonly [{
         readonly vertical: "middle";
     };
 }];
+/**
+ * The most slots a sequential Layout offers. Flex, Grid and Masonry stop offering an insert once their
+ * last slot is taken, so no child is placed in a slot the Layout does not declare.
+ */
+export declare const PHI_CMS_MAX_LAYOUT_SLOTS = 24;
 export declare const PHI_CMS_SEQUENTIAL_LAYOUT_SLOTS: {
     key: string;
     label: string;
@@ -90,7 +95,7 @@ export declare const PHI_CMS_CAROUSEL_LAYOUT_SLOTS: {
     slotIndex: number;
     sequential: true;
 }[];
-export declare const PHI_CMS_COLLAPSIBLE_LAYOUT_MAX_SLOTS = 12;
+export declare const PHI_CMS_COLLAPSIBLE_LAYOUT_MAX_SLOTS = 24;
 export declare const PHI_CMS_COLLAPSIBLE_LAYOUT_SLOTS: {
     key: string;
     label: string;
@@ -167,5 +172,4 @@ export declare function splitPhiCmsLayoutNamespacedTypeKey(namespacedTypeKey: st
     pluginKey: string;
     typeKey: string;
 };
-export declare const PHI_CMS_LAYOUT_REGISTRY_BY_NAMESPACED_KEY: Map<string, PhiCmsRegistryEntry>;
 export {};

package/constants/cms-layout-types.js

@@ -35,7 +35,12 @@ export const PHI_CMS_DEFAULT_LAYOUT_SLOTS = [
         },
     },
 ];
-export const PHI_CMS_SEQUENTIAL_LAYOUT_SLOTS = Array.from({ length: 12 }, (_, index) => ({
+/**
+ * The most slots a sequential Layout offers. Flex, Grid and Masonry stop offering an insert once their
+ * last slot is taken, so no child is placed in a slot the Layout does not declare.
+ */
+export const PHI_CMS_MAX_LAYOUT_SLOTS = 24;
+export const PHI_CMS_SEQUENTIAL_LAYOUT_SLOTS = Array.from({ length: PHI_CMS_MAX_LAYOUT_SLOTS }, (_, index) => ({
     key: `slot_${index}`,
     label: `Slot ${index}`,
     slotIndex: index,
@@ -55,7 +60,7 @@ export const PHI_CMS_FLEX_VERTICAL_LAYOUT_SLOTS = PHI_CMS_SEQUENTIAL_LAYOUT_SLOT
         vertical: "top",
     },
 }));
-export const PHI_CMS_MASONRY_LAYOUT_SLOTS = Array.from({ length: 12 }, (_, index) => ({
+export const PHI_CMS_MASONRY_LAYOUT_SLOTS = Array.from({ length: PHI_CMS_MAX_LAYOUT_SLOTS }, (_, index) => ({
     key: `item_${index + 1}`,
     label: `Item ${index + 1}`,
     slotIndex: index,
@@ -64,7 +69,7 @@ export const PHI_CMS_MASONRY_LAYOUT_SLOTS = Array.from({ length: 12 }, (_, index
 export const PHI_CMS_GRID_LAYOUT_SLOTS = PHI_CMS_SEQUENTIAL_LAYOUT_SLOTS;
 export const PHI_CMS_STACK_LAYOUT_SLOTS = PHI_CMS_SEQUENTIAL_LAYOUT_SLOTS;
 export const PHI_CMS_CAROUSEL_LAYOUT_SLOTS = PHI_CMS_SEQUENTIAL_LAYOUT_SLOTS;
-export const PHI_CMS_COLLAPSIBLE_LAYOUT_MAX_SLOTS = 12;
+export const PHI_CMS_COLLAPSIBLE_LAYOUT_MAX_SLOTS = PHI_CMS_MAX_LAYOUT_SLOTS;
 export const PHI_CMS_COLLAPSIBLE_LAYOUT_SLOTS = PHI_CMS_SEQUENTIAL_LAYOUT_SLOTS;
 export const PHI_CMS_THREE_COLUMN_LAYOUT_SLOTS = [
     {
@@ -271,4 +276,3 @@ export function splitPhiCmsLayoutNamespacedTypeKey(namespacedTypeKey) {
         typeKey: parts[parts.length - 1],
     };
 }
-export const PHI_CMS_LAYOUT_REGISTRY_BY_NAMESPACED_KEY = new Map(PHI_CMS_LAYOUT_REGISTRY.map((entry) => [entry.namespacedTypeKey, entry]));

package/constants/cms-widget-types.d.ts

@@ -1,20 +1,3 @@
-/**
- * A Widget type is namespaced by the module that owns it, so loading a module loads its Widgets and
- * nothing else names them. The owner comes from the runtime module catalog, which refuses two modules
- * claiming one type.
- */
-export declare const PHI_CMS_WIDGET_PLUGIN_KEYS: {
-    readonly asset: "@phis/ui/modules/asset/widgets";
-    readonly auth: "@phis/ui/modules/auth/widgets";
-    readonly avatar: "@phis/ui/modules/avatar/widgets";
-    readonly builder: "@phis/ui/modules/builder/widgets";
-    readonly core: "@phis/ui/modules/core/widgets";
-    readonly news: "@phis/ui/modules/news/widgets";
-    readonly observability: "@phis/ui/modules/observability/widgets";
-    readonly theme: "@phis/ui/modules/theme/widgets";
-    readonly threads: "@phis/ui/modules/threads/widgets";
-    readonly video: "@phis/ui/modules/video/widgets";
-};
 export declare function resolvePhiCmsWidgetPluginKey(typeKey: string): string;
 export declare const PhiCmsWidgetType: {
     readonly Account: string;
@@ -23,7 +6,7 @@ export declare const PhiCmsWidgetType: {
     readonly Breadcrumb: string;
     readonly Button: string;
     readonly Dimension: string;
-    readonly DatePicker: string;
+    readonly DateInput: string;
     readonly Length: string;
     readonly Input: string;
     readonly NumberInput: string;
@@ -58,13 +41,19 @@ export declare const PhiCmsWidgetType: {
     readonly AccountAvatar: string;
     readonly AccountAvatarPicker: string;
     readonly ThreadConversation: string;
-    readonly NewsList: string;
+    readonly EntryList: string;
+    readonly EntryDetail: string;
+    readonly EntryHeader: string;
     readonly VideoEmbed: string;
+    readonly TourButton: string;
     readonly Result: string;
     readonly Pagination: string;
     readonly Segmented: string;
     readonly SelectBox: string;
     readonly Spacer: string;
+    readonly Steps: string;
+    readonly Timeline: string;
+    readonly FloatButton: string;
     readonly Switch: string;
     readonly ThemeModeSwitch: string;
     readonly Html: string;