@phis/ui 0.4.0 → 0.4.1

package/components/controls/phi-table-control.d.ts

@@ -122,6 +122,11 @@ export type PhiTableControlProps<TRow extends Record<string, unknown>> = {
     bordered?: boolean;
     striped?: boolean;
     showHeader?: boolean;
+    /**
+     * The header row stays at the top while the rows scroll under it: under the Shell's Header on a page,
+     * at the top edge of a Modal's or Drawer's body. `styles/controls.css` places it.
+     */
+    stickyHeader?: boolean;
     footer?: PhiTableControlFooter;
     summary?: PhiTableControlSummary;
     size?: PhiControlSize;
@@ -141,4 +146,4 @@ export type PhiTableControlProps<TRow extends Record<string, unknown>> = {
     onExternalDrop?: (event: DragEvent<HTMLDivElement>) => void;
 };
 export declare function readPhiTableControlValue(row: Record<string, unknown>, path: string): unknown;
-export declare function PhiTableControl<TRow extends Record<string, unknown>>({ rows, rowIdentityPath, columns, columnOrder, sortingMode, sorts, onSortsChange, columnReordering, onColumnOrderChange, rowSelection, pagination, tree, rowReordering, editing, loading, bordered, striped, showHeader, footer, summary, size, emptyText, layout, rowStyle, onRowActivate, onExternalRowDragOver, onExternalRowDrop, onExternalDragOver, onExternalDrop, }: PhiTableControlProps<TRow>): import("react").JSX.Element;
+export declare function PhiTableControl<TRow extends Record<string, unknown>>({ rows, rowIdentityPath, columns, columnOrder, sortingMode, sorts, onSortsChange, columnReordering, onColumnOrderChange, rowSelection, pagination, tree, rowReordering, editing, loading, bordered, striped, stickyHeader, showHeader, footer, summary, size, emptyText, layout, rowStyle, onRowActivate, onExternalRowDragOver, onExternalRowDrop, onExternalDragOver, onExternalDrop, }: PhiTableControlProps<TRow>): import("react").JSX.Element;

package/components/controls/phi-table-control.js

@@ -1,5 +1,6 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { usePhiShellStickyTop } from "../shell/use-phi-shell-sticky-top";
 import { Button, Flex, Table } from "antd";
 import { DndContext, KeyboardSensor, PointerSensor, closestCenter, useSensor, useSensors, } from "@dnd-kit/core";
 import { SortableContext, sortableKeyboardCoordinates, useSortable, } from "@dnd-kit/sortable";
@@ -354,7 +355,7 @@ function buildRowMove(rows, rowIdentityPath, parentRowIdentityPath, movedRowIden
         afterRowIdentity: placement === "after" ? targetRowIdentity : null,
     };
 }
-export function PhiTableControl({ rows, rowIdentityPath, columns, columnOrder, sortingMode, sorts, onSortsChange, columnReordering = false, onColumnOrderChange, rowSelection, pagination = false, tree, rowReordering, editing, loading = false, bordered, striped = false, showHeader, footer, summary, size, emptyText, layout, rowStyle, onRowActivate, onExternalRowDragOver, onExternalRowDrop, onExternalDragOver, onExternalDrop, }) {
+export function PhiTableControl({ rows, rowIdentityPath, columns, columnOrder, sortingMode, sorts, onSortsChange, columnReordering = false, onColumnOrderChange, rowSelection, pagination = false, tree, rowReordering, editing, loading = false, bordered, striped = false, stickyHeader = false, showHeader, footer, summary, size, emptyText, layout, rowStyle, onRowActivate, onExternalRowDragOver, onExternalRowDrop, onExternalDragOver, onExternalDrop, }) {
     const { token } = usePhiConfig();
     const [editingRowIdentityState, setEditingRowIdentity] = useState(null);
     const [rowEditPatch, setRowEditPatch] = useState({});
@@ -988,6 +989,8 @@ export function PhiTableControl({ rows, rowIdentityPath, columns, columnOrder, s
     const hasClosingBlock = !loading &&
         (Boolean(footer) || (summary != null && summary.placement !== "sticky-top"));
     const frameRef = useRef(null);
+    // Where the Shell's Header ends, which is where a sticky header row stops (`styles/controls.css`).
+    usePhiShellStickyTop({ active: stickyHeader && showHeader !== false, elementRef: frameRef });
     const [headerBox, setHeaderBox] = useState(null);
     useEffect(() => {
         const frame = frameRef.current;
@@ -1007,11 +1010,15 @@ export function PhiTableControl({ rows, rowIdentityPath, columns, columnOrder, s
         observer.observe(frame);
         return () => observer.disconnect();
     }, [showHeader, loading]);
-    const table = (_jsx(Table, { className: ["phi-table-control", hasClosingBlock ? "phi-table-control--closing-block" : null]
+    const table = (_jsx(Table, { className: [
+            "phi-table-control",
+            hasClosingBlock ? "phi-table-control--closing-block" : null,
+            stickyHeader && showHeader !== false ? "phi-table-control--sticky-header" : null,
+        ]
             .filter(Boolean)
             .join(" "), style: { "--phi-table-striped-row-background": token.colorFillAlter }, rowKey: (row) => loading
             ? `__phi_table_loading_${String(row[PHI_TABLE_LOADING_ROW])}`
-            : String(readIdentity(row, rowIdentityPath)), columns: renderedColumns, dataSource: loading ? loadingRows : dataSource, bordered: bordered, showHeader: showHeader, tableLayout: layout.mode, size: size, rowClassName: (_row, index) => striped && index % 2 === 1 ? "phi-table-control__row--striped" : "", rowSelection: loading ? undefined : antdRowSelection, components: rowReordering?.enabled && !loading ? { body: { row: PhiTableSortableRow } } : undefined, scroll: layout.overflowX === "auto" ? { x: true } : undefined, pagination: pagination === false ? false : {
+            : String(readIdentity(row, rowIdentityPath)), columns: renderedColumns, dataSource: loading ? loadingRows : dataSource, bordered: bordered, showHeader: showHeader, tableLayout: layout.mode, size: size, rowClassName: (_row, index) => striped && index % 2 === 1 ? "phi-table-control__row--striped" : "", rowSelection: loading ? undefined : antdRowSelection, components: rowReordering?.enabled && !loading ? { body: { row: PhiTableSortableRow } } : undefined, scroll: layout.overflowX === "auto" ? { x: true } : undefined, sticky: stickyHeader && showHeader !== false ? true : undefined, pagination: pagination === false ? false : {
             ...{ [PHI_VISUAL_ANCHOR_PART_ATTRIBUTE]: "pagination" },
             current: pagination.page,
             pageSize: pagination.pageSize,
@@ -1097,7 +1104,12 @@ export function PhiTableControl({ rows, rowIdentityPath, columns, columnOrder, s
                     insertionGapIndex,
                     insertionGapHeight: activeDragRowHeight,
                 }, children: table }) }) })) : table;
-    const constrainedTable = (_jsxs("div", { ref: frameRef, style: { position: "relative", width: "100%", maxWidth: "100%", minWidth: 0, overflow: "hidden" }, children: [renderedTable, headerBox ? (_jsx("div", { "aria-hidden": true, [PHI_VISUAL_ANCHOR_PART_ATTRIBUTE]: "header", style: { position: "absolute", left: 0, right: 0, top: headerBox.top, height: headerBox.height, pointerEvents: "none" } })) : null] }));
+    /*
+     * Clipped, not hidden: `hidden` makes the frame a scroll container, and a sticky header row then sticks
+     * to the frame's own top -- pushed down inside the Table by the Shell's Header height -- instead of to
+     * the page. `clip` cuts off the same overflow and leaves the page the one that scrolls.
+     */
+    const constrainedTable = (_jsxs("div", { ref: frameRef, style: { position: "relative", width: "100%", maxWidth: "100%", minWidth: 0, overflow: "clip" }, children: [renderedTable, headerBox ? (_jsx("div", { "aria-hidden": true, [PHI_VISUAL_ANCHOR_PART_ATTRIBUTE]: "header", style: { position: "absolute", left: 0, right: 0, top: headerBox.top, height: headerBox.height, pointerEvents: "none" } })) : null] }));
     return onExternalDragOver || onExternalDrop ? (_jsx("div", { onDragOver: (event) => {
             if (event.defaultPrevented) {
                 setExternalAppendActive(false);

package/components/layouts/layout-definitions.d.ts

@@ -483,7 +483,7 @@ export declare const PHI_GRID_LAYOUT_DEFINITION: {
     kind: "layout";
     pluginKey: string;
     typeKey: string;
-    slotSizePolicy: "fill";
+    slotSizePolicy: "fill-inline";
     title: string;
     description: string;
     category: "structure";
@@ -1176,7 +1176,7 @@ export declare const PHI_CORE_LAYOUT_DEFINITIONS: readonly [{
     kind: "layout";
     pluginKey: string;
     typeKey: string;
-    slotSizePolicy: "fill";
+    slotSizePolicy: "fill-inline";
     title: string;
     description: string;
     category: "structure";

package/components/layouts/layout-definitions.js

@@ -415,7 +415,12 @@ export const PHI_GRID_LAYOUT_DEFINITION = {
     kind: "layout",
     pluginKey: resolvePhiCmsLayoutPluginKey("grid"),
     typeKey: "grid",
-    slotSizePolicy: "fill",
+    /*
+     * As wide as its slot, as tall as its rows. A Grid is content in flow: filling the block axis as well
+     * let a vertical stack share its height out among the Grids in it, and each one, held to its share,
+     * spilled its rows over the next section.
+     */
+    slotSizePolicy: "fill-inline",
     title: "Grid",
     description: "Slots in rows, as many to a row as the Grid's own width allows.",
     category: "structure",

package/components/shell/use-phi-shell-sticky-top.d.ts

@@ -0,0 +1,5 @@
+import { type RefObject } from "react";
+export declare function usePhiShellStickyTop({ active, elementRef, }: {
+    active: boolean;
+    elementRef: RefObject<HTMLElement | null>;
+}): void;

package/components/shell/use-phi-shell-sticky-top.js

@@ -0,0 +1,78 @@
+"use client";
+import { useEffect } from "react";
+/**
+ * How far down the viewport the Shell's Header holds right now, published on the Shell.
+ *
+ * Something that sticks to the top of the page -- a Table's header row -- has to stick under the Header
+ * rather than behind it, and where the Header ends is not a constant: each band sticks or scrolls by its
+ * own config, and a revealing `header_top` slides away while the visitor reads down and comes back when
+ * they scroll up. So the edge is measured, not configured: the lowest bottom of every Header band that is
+ * stuck at this moment, written as `--phi-shell-sticky-top` on the Shell element. Unset, a reader falls
+ * back to `0px`, which is right for a Shell without a sticky Header.
+ *
+ * Run by whatever sticks under it -- every sticky Table does -- so a page without one loads nothing for
+ * it. Each runner measures all the bands and they all write the same value. Not inside an Overlay: a
+ * Modal's or Drawer's body scrolls on its own, and its top edge is the line.
+ */
+const PHI_SHELL_STICKY_TOP_PROPERTY = "--phi-shell-sticky-top";
+const HEADER_BANDS = '[data-phi-region-key^="header_"]:not([hidden])';
+function measurePhiShellStickyTop(shell) {
+    let bottom = 0;
+    for (const band of shell.querySelectorAll(HEADER_BANDS)) {
+        const style = window.getComputedStyle(band);
+        if (style.position !== "sticky" && style.position !== "fixed") {
+            continue;
+        }
+        const rect = band.getBoundingClientRect();
+        const stuckAt = Number.parseFloat(style.top) || 0;
+        // Below its sticking line it is still in flow; above the viewport it has slid away.
+        if (rect.height === 0 || rect.top > stuckAt + 1 || rect.bottom <= 0) {
+            continue;
+        }
+        bottom = Math.max(bottom, rect.bottom);
+    }
+    return `${Math.round(bottom)}px`;
+}
+const OVERLAY_BODIES = "[data-phi-modal-body-content], [data-phi-drawer-body-content]";
+export function usePhiShellStickyTop({ active, elementRef, }) {
+    useEffect(() => {
+        const element = elementRef.current;
+        const shell = active && element && !element.closest(OVERLAY_BODIES)
+            ? element.closest("[data-phi-shell-layout]")
+            : null;
+        if (!element || !shell) {
+            return undefined;
+        }
+        let frame = 0;
+        const publish = () => {
+            frame = 0;
+            const next = measurePhiShellStickyTop(shell);
+            if (shell.style.getPropertyValue(PHI_SHELL_STICKY_TOP_PROPERTY) !== next) {
+                shell.style.setProperty(PHI_SHELL_STICKY_TOP_PROPERTY, next);
+            }
+        };
+        const schedule = () => {
+            if (frame === 0) {
+                frame = window.requestAnimationFrame(publish);
+            }
+        };
+        publish();
+        window.addEventListener("scroll", schedule, { passive: true });
+        window.addEventListener("resize", schedule);
+        // A revealing band moves by a transition; its end is where it settled.
+        shell.addEventListener("transitionend", schedule);
+        const observer = new ResizeObserver(schedule);
+        for (const band of shell.querySelectorAll(HEADER_BANDS)) {
+            observer.observe(band);
+        }
+        return () => {
+            if (frame !== 0) {
+                window.cancelAnimationFrame(frame);
+            }
+            window.removeEventListener("scroll", schedule);
+            window.removeEventListener("resize", schedule);
+            shell.removeEventListener("transitionend", schedule);
+            observer.disconnect();
+        };
+    }, [active, elementRef]);
+}

package/components/widgets/helpers/semantic-html-translation.d.ts

@@ -1,2 +1,4 @@
 import "server-only";
-export declare function translateSemanticHtml(sourceHtml: string, sourceLocale?: string): Promise<string>;
+export declare function translateSemanticHtml(sourceHtml: string, sourceLocale?: string, 
+/** The render's locale. Without it the request's is asked, and a static render has no request. */
+locale?: string): Promise<string>;

package/components/widgets/helpers/semantic-html-translation.js

@@ -1,7 +1,7 @@
 import "server-only";
 import renderHtml from "dom-serializer";
 import { parseDocument } from "htmlparser2";
-import { trBulk } from "../../../server-helpers/translate";
+import { trBulk, trBulkForLocale } from "../../../server-helpers/translate";
 import { sanitizePhiHtmlWidgetMarkup } from "./html-content";
 const SEMANTIC_HTML_BLOCKS = new Set([
     "p",
@@ -49,7 +49,9 @@ function renderNodes(nodes) {
 function hasVisibleText(html) {
     return html.replace(/<[^>]+>/g, "").replace(/&nbsp;/g, " ").trim().length > 0;
 }
-export async function translateSemanticHtml(sourceHtml, sourceLocale) {
+export async function translateSemanticHtml(sourceHtml, sourceLocale, 
+/** The render's locale. Without it the request's is asked, and a static render has no request. */
+locale) {
     const sanitized = sanitizePhiHtmlWidgetMarkup(sourceHtml);
     if (!sanitized) {
         return "";
@@ -64,7 +66,10 @@ export async function translateSemanticHtml(sourceHtml, sourceLocale) {
     if (units.length === 0) {
         return sanitized;
     }
-    const translated = await trBulk(units.map((unit) => unit.html), 0, "html", sourceLocale);
+    const msgs = units.map((unit) => unit.html);
+    const translated = locale
+        ? await trBulkForLocale(locale, msgs, 0, "html", sourceLocale)
+        : await trBulk(msgs, 0, "html", sourceLocale);
     units.forEach((unit, index) => {
         const fragment = parseDocument(translated[index] ?? unit.html);
         unit.node.children = fragment.children ?? [];

package/components/widgets/navigation-descriptor-resolver.server.js

@@ -127,6 +127,11 @@ export async function resolvePhiDescriptorNavigationItems(runtime, navKey, overl
     /*
      * One batch per source language. A Module's label names its language and is translated from it; an
      * operator's names none and is read in the Site's source language, which the server supplies.
+     *
+     * The batch also decides the store. A Module's label is the platform's text, the same on every Site,
+     * so it is translated once in the global store, which only the operator edits. A Site that wants
+     * other words renames the entry, the label loses its `sourceLocale`, and from then on it is the
+     * Site's own text in the Site's store. The Builder's surfaces carry Module labels only.
      */
     await Promise.all([...collectNavigationLabels(surface.items)].map(async ([sourceLocale, group]) => {
         const labels = [...group];
@@ -136,7 +141,7 @@ export async function resolvePhiDescriptorNavigationItems(runtime, navKey, overl
             locale: runtime.locale.current,
             ...(sourceLocale ? { sourceLocale } : {}),
         };
-        const translator = runtime.area === "builder"
+        const translator = sourceLocale || runtime.area === "builder"
             ? createGlobalTranslator(options)
             : createSiteTranslator({ ...options, siteKey: rt.siteKey });
         /*

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

@@ -2,7 +2,7 @@ import { cache } from "react";
 import { unified } from "unified";
 import remarkParse from "remark-parse";
 import remarkGfm from "remark-gfm";
-import { trBulk } from "../../../server-helpers/translate";
+import { trBulk, trBulkForLocale } from "../../../server-helpers/translate";
 import { resolvePhiCodeLanguage, tokenizePhiCode } from "./markdown-code-tokens";
 import { readPhiInternalReference } from "../../../types/references";
 import { resolvePhiWidgetInternalReferences } from "../helpers/internal-reference-resolver.server";
@@ -294,11 +294,21 @@ function parseTranslatedMarkdownInlines(translatedHtml, metadata) {
     appendText(translatedHtml.slice(cursor));
     return stack.length === 1 ? stack[0]?.children ?? [] : null;
 }
-async function buildMarkdownInlineMap(tree, translate, sourceLocale) {
+/*
+ * The render's own locale where there is one. A static render has no request to ask: `trBulk` reads the
+ * locale from the request headers, finds none, and answers in the Site's default -- which left every
+ * static Public page's body in its source language under a translated header.
+ */
+function translateUnits(locale, msgs, format, sourceLocale) {
+    return locale
+        ? trBulkForLocale(locale, msgs, 0, format, sourceLocale)
+        : trBulk(msgs, 0, format, sourceLocale);
+}
+async function buildMarkdownInlineMap(tree, translate, sourceLocale, locale) {
     const units = [];
     collectMarkdownTranslationUnits(tree, units);
     const translated = translate && units.length > 0
-        ? await trBulk(units.map((unit) => unit.html), 0, "html", sourceLocale)
+        ? await translateUnits(locale, units.map((unit) => unit.html), "html", sourceLocale)
         : units.map((unit) => unit.html);
     /*
      * Image titles are prose and translate as plain text, each on its own: they are separate sentences
@@ -307,7 +317,7 @@ async function buildMarkdownInlineMap(tree, translate, sourceLocale) {
      */
     const titleSlots = units.flatMap((unit) => unit.metadata.titles.flatMap((title, index) => title ? [{ metadata: unit.metadata, index, title }] : []));
     if (translate && titleSlots.length > 0) {
-        const translatedTitles = await trBulk(titleSlots.map((slot) => slot.title), 0, "text", sourceLocale);
+        const translatedTitles = await translateUnits(locale, titleSlots.map((slot) => slot.title), "text", sourceLocale);
         titleSlots.forEach((slot, index) => {
             slot.metadata.titles[slot.index] = translatedTitles[index] || slot.title;
         });
@@ -508,7 +518,7 @@ async function resolveMarkdownRenderDataFromSource(markdown, translate, headingI
         headingIdPrefix,
         headingOffset,
     };
-    const inlineMap = await buildMarkdownInlineMap(tree, translate, sourceLocale);
+    const inlineMap = await buildMarkdownInlineMap(tree, translate, sourceLocale, runtime?.locale.current);
     const blocks = mapBlockNodes(tree.children, context, inlineMap);
     return { blocks, headings: context.headings };
 }

package/helpers/text-source.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Whose words a text Widget holds, which decides the store that translates them.
+ *
+ * A Preset's text is the platform's: the same sentence on every installation, translated once in the
+ * global store, which only the operator edits. Text an author wrote on a Site is the Site's and goes to
+ * the Site's store. The Preset says so by writing `textSource: "preset"` beside its words; the Builder
+ * drops the marker the moment an author changes one of the Widget's texts, and from then on all of them
+ * are the Site's.
+ *
+ * A marker rather than a translation done by the Preset itself: adopting a Preset stores the tree it
+ * built, so a Preset that translated its words would freeze one locale into the Site's copy.
+ */
+export declare const PHI_TEXT_SOURCE_PRESET: "preset";
+export type PhiTextSource = typeof PHI_TEXT_SOURCE_PRESET;
+export declare function readPhiTextSource(value: unknown): PhiTextSource | undefined;
+/** Whether a Builder edit of this field ends the Preset's ownership of the Widget's words. */
+export declare function isPhiAuthoredTextField(field: {
+    type?: string;
+}): boolean;

package/helpers/text-source.js

@@ -0,0 +1,20 @@
+/**
+ * Whose words a text Widget holds, which decides the store that translates them.
+ *
+ * A Preset's text is the platform's: the same sentence on every installation, translated once in the
+ * global store, which only the operator edits. Text an author wrote on a Site is the Site's and goes to
+ * the Site's store. The Preset says so by writing `textSource: "preset"` beside its words; the Builder
+ * drops the marker the moment an author changes one of the Widget's texts, and from then on all of them
+ * are the Site's.
+ *
+ * A marker rather than a translation done by the Preset itself: adopting a Preset stores the tree it
+ * built, so a Preset that translated its words would freeze one locale into the Site's copy.
+ */
+export const PHI_TEXT_SOURCE_PRESET = "preset";
+export function readPhiTextSource(value) {
+    return value === PHI_TEXT_SOURCE_PRESET ? value : undefined;
+}
+/** Whether a Builder edit of this field ends the Preset's ownership of the Widget's words. */
+export function isPhiAuthoredTextField(field) {
+    return field.type === "string";
+}

package/next/config.mjs

@@ -57,7 +57,7 @@ function customRenders(antd, h, Fragment) {
     Form: (Form) => h(Form, null, h(Form.Item, { label: "Label" }, h(antd.Input))),
     Dropdown: (Dropdown) => h(Dropdown, { menu: { items: [] } }, h("div")),
     Menu: (Menu) => h(Menu, { items: [] }),
-    QRCode: (QRCode) => h(QRCode, { value: "https://phisys.com" }),
+    QRCode: (QRCode) => h(QRCode, { value: "https://phis.dev" }),
     Tree: (Tree) => h(Tree, { treeData: [] }),
     Tag: (Tag) => h(Fragment, null, h(Tag, { color: "blue" }, "Tag"), h(Tag, { color: "success" }, "Tag")),
     Badge: (Badge) => h(Fragment, null, h(Badge), h(Badge.Ribbon)),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phis/ui",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "license": "Apache-2.0",
   "publishConfig": {
     "access": "public"

package/plugins/runtime-modules/auth/trees/phi-default-pub-confirm-page-tree.js

@@ -1,3 +1,4 @@
+import { PHI_TEXT_SOURCE_PRESET } from "../../../../helpers/text-source";
 import { createPhiPresetCmsInstanceIdMap } from "../../../../types/cms-instance-id";
 import { PHI_SPACE } from "../../../../theme/antd-css-var-contract";
 import { PHI_AUTH_RUNTIME_MODULE_ID } from "../ids";
@@ -97,6 +98,7 @@ export async function buildPhiDefaultPubConfirmPageTree({ page, presetKey, }) {
                 sortOrder: 0,
                 label: "pub confirmation description widget",
                 config: {
+                    textSource: PHI_TEXT_SOURCE_PRESET,
                     eyebrow: "Confirm Email",
                     title: "Activate your account",
                     description: "Review your registration details and confirm your email address to activate access.",
@@ -160,6 +162,7 @@ export async function buildPhiDefaultPubConfirmPageTree({ page, presetKey, }) {
                 slotIndex: 2,
                 label: "pub confirmation missing token",
                 config: {
+                    textSource: PHI_TEXT_SOURCE_PRESET,
                     text: "No confirmation token was provided. Open the confirmation link from your email.",
                     tone: "secondary",
                     visibleWhen: withoutToken,

package/plugins/runtime-modules/auth/trees/phi-default-pub-login-page-tree.js

@@ -1,3 +1,4 @@
+import { PHI_TEXT_SOURCE_PRESET } from "../../../../helpers/text-source";
 import { createPhiPresetCmsInstanceIdMap } from "../../../../types/cms-instance-id";
 import { PHI_SPACE } from "../../../../theme/antd-css-var-contract";
 import { PHI_LAYOUT } from "../../../../theme/phi-tokens";
@@ -98,6 +99,7 @@ export async function buildPhiDefaultPubLoginPageTree({ page, presetKey, runtime
                 sortOrder: 0,
                 label: "pub login description widget",
                 config: {
+                    textSource: PHI_TEXT_SOURCE_PRESET,
                     eyebrow: "Login",
                     title: "Sign in to your account",
                     description: "Access your customer workspace, orders, and account details.",

package/plugins/runtime-modules/auth/trees/phi-default-pub-registration-page-tree.js

@@ -1,3 +1,4 @@
+import { PHI_TEXT_SOURCE_PRESET } from "../../../../helpers/text-source";
 import { createPhiPresetCmsInstanceIdMap } from "../../../../types/cms-instance-id";
 import { PHI_SPACE } from "../../../../theme/antd-css-var-contract";
 import { PHI_AUTH_RUNTIME_MODULE_ID } from "../ids";
@@ -68,6 +69,7 @@ export async function buildPhiDefaultPubRegistrationPageTree({ page, presetKey,
                 sortOrder: 0,
                 label: "pub registration description widget",
                 config: {
+                    textSource: PHI_TEXT_SOURCE_PRESET,
                     eyebrow: "Register",
                     title: "Create account",
                     description: "Create your account to access your personalized workspace.",
@@ -113,6 +115,7 @@ export async function buildPhiDefaultPubRegistrationPageTree({ page, presetKey,
                 slotIndex: 1,
                 label: "pub registration notice",
                 config: {
+                    textSource: PHI_TEXT_SOURCE_PRESET,
                     text: "We only use your details to create and support your account.",
                     tone: "secondary",
                 },

package/plugins/runtime-modules/auth/trees/phi-default-pub-reset-password-page-tree.js

@@ -1,3 +1,4 @@
+import { PHI_TEXT_SOURCE_PRESET } from "../../../../helpers/text-source";
 import { createPhiPresetCmsInstanceIdMap } from "../../../../types/cms-instance-id";
 import { PHI_SPACE } from "../../../../theme/antd-css-var-contract";
 import { PHI_AUTH_RUNTIME_MODULE_ID } from "../ids";
@@ -89,6 +90,7 @@ export async function buildPhiDefaultPubResetPasswordPageTree({ page, presetKey,
                 sortOrder: 0,
                 label: "pub reset password description widget",
                 config: {
+                    textSource: PHI_TEXT_SOURCE_PRESET,
                     eyebrow: "Reset password",
                     title: "Choose a new password",
                     description: "Use the reset link from your email to choose a new secure password.",
@@ -113,6 +115,7 @@ export async function buildPhiDefaultPubResetPasswordPageTree({ page, presetKey,
                 slotIndex: 0,
                 label: "pub reset password intro",
                 config: {
+                    textSource: PHI_TEXT_SOURCE_PRESET,
                     text: "If the account exists, a reset email is on its way. Open the link in that email to choose a new password.",
                     tone: "secondary",
                     visibleWhen: withoutToken,

package/plugins/runtime-modules/builder/clients/widget-inspector.js

@@ -1,5 +1,6 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { isPhiAuthoredTextField, readPhiTextSource } from "../../../../helpers/text-source";
 import { useEffect } from "react";
 import { PhiGeometryControl } from "../../../../components/controls/phi-geometry-control";
 import { PhiSurfaceControl } from "../../../../components/controls/phi-surface-control";
@@ -81,6 +82,14 @@ export function PhiDeveloperBuilderWidgetInspectorWidgetClient({ section, builde
             videoProviderDescriptors,
             onChange: (next) => {
                 const patch = buildPhiInspectorConfigPathPatch(currentWidgetSettingsConfigRecord, next);
+                /*
+                 * An author writing into a Preset's text makes the Widget's words the Site's: from here on the
+                 * Site's store translates them, not the global one (`helpers/text-source.ts`).
+                 */
+                if (readPhiTextSource(currentWidgetSettingsConfigRecord.textSource) != null
+                    && isPhiAuthoredTextField(field)) {
+                    patch.textSource = undefined;
+                }
                 onConfigChange?.(patch);
             },
         });

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

@@ -1663,6 +1663,8 @@ async function buildPhiDefaultBuilderPagePresetTemplateTree({ page, runtime, pre
                             }),
                             nodes.widget({
                                 typeKey: "simple-text",
+                                /* Label set text, translated already; a second pass would hand the translator a non-source text. */
+                                flags: PhiCmsFlags.NoTranslate,
                                 id: PHI_BUILDER_MODULE_USAGE_WIDGET_IDS.moduleUsageIntro,
                                 parentLayoutNodeId: PHI_BUILDER_MODULE_USAGE_LAYOUT_IDS.moduleUsageBody,
                                 slotIndex: PHI_CMS_DEFAULT_SLOT_INDEX,
@@ -1737,6 +1739,8 @@ async function buildPhiDefaultBuilderPagePresetTemplateTree({ page, runtime, pre
                             }),
                             nodes.widget({
                                 typeKey: "simple-text",
+                                /* Label set text, translated already; a second pass would hand the translator a non-source text. */
+                                flags: PhiCmsFlags.NoTranslate,
                                 id: PHI_BUILDER_PUBLIC_ROUTES_WIDGET_IDS.publicRoutesIntro,
                                 parentLayoutNodeId: PHI_BUILDER_PUBLIC_ROUTES_LAYOUT_IDS.publicRoutesBody,
                                 slotIndex: PHI_CMS_DEFAULT_SLOT_INDEX,

package/plugins/runtime-modules/core/widgets/card/server.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { trBulk } from "../../../../../server-helpers/translate";
+import { trBulk, trBulkForLocale } from "../../../../../server-helpers/translate";
 import { isPhiMediaSvgContentType } from "../../../../../constants/media";
 import { resolvePhiImagePresentation } from "../../../../../components/media/image-presentation";
 import { resolvePhiPublicAssetReference } from "../../../../../components/widgets/helpers/internal-reference-resolver.server";
@@ -23,7 +23,9 @@ export async function PhiCardWidget({ labels, config, runtime, links, translate,
         ["actionLabel", actionEnabled ? ownActionLabel : undefined],
     ];
     const translatedTexts = translate
-        ? await trBulk(textEntries.map(([, value]) => value ?? ""))
+        ? await (runtime?.locale.current
+            ? trBulkForLocale(runtime.locale.current, textEntries.map(([, value]) => value ?? ""))
+            : trBulk(textEntries.map(([, value]) => value ?? "")))
         : textEntries.map(([, value]) => value ?? "");
     const translatedByKey = new Map(textEntries.map(([key], index) => [key, translatedTexts[index] || undefined]));
     /*

package/plugins/runtime-modules/core/widgets/description/config.d.ts

@@ -1,3 +1,4 @@
+import { type PhiTextSource } from "../../../../../helpers/text-source";
 import { type PhiCmsWidgetConfigBase } from "../../../../../components/widgets/config/parser-primitives";
 import { type PhiTextTone } from "../../../../../components/widgets/config/text-tone";
 import { type PhiBulletListEntry, type PhiBulletListStyle } from "../../../../../components/widgets/shared/bullet-list-vocabulary";
@@ -13,6 +14,8 @@ export type PhiCmsDescriptionWidgetConfig = PhiCmsWidgetConfigBase & {
     footer?: string;
     /** The tone of the description text; absent is the default secondary text. */
     tone?: PhiTextTone;
+    /** `"preset"` while the words are a Preset's and translated globally (`helpers/text-source.ts`). */
+    textSource?: PhiTextSource;
 };
 declare function parsePhiCmsDescriptionWidgetConfig(config: Record<string, unknown>): PhiCmsDescriptionWidgetConfig;
 export declare const PHI_DESCRIPTION_WIDGET_DEFINITION: {

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

@@ -1,4 +1,5 @@
 import { resolvePhiCmsWidgetPluginKey } from "../../../../../constants/cms-widget-types";
+import { readPhiTextSource } from "../../../../../helpers/text-source";
 import { PhiCmsWidgetType } from "../../../../../constants/cms-widget-types";
 import { readRenderableBlockConfig, readString } from "../../../../../components/widgets/config/parser-primitives";
 import { PHI_TEXT_TONE_FIELD_OPTIONS, readPhiTextTone, } from "../../../../../components/widgets/config/text-tone";
@@ -15,6 +16,7 @@ function parsePhiCmsDescriptionWidgetConfig(config) {
         asideList: readPhiBulletListStyle(config.asideList),
         footer: readString(config.footer),
         tone: readPhiTextTone(config.tone),
+        textSource: readPhiTextSource(config.textSource),
     };
 }
 export const PHI_DESCRIPTION_WIDGET_DEFINITION = {

package/plugins/runtime-modules/core/widgets/description/server.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { trGlobal, trGlobalForLocale, } from "../../../../../server-helpers/translate";
+import { trWidgetText } from "../../../../../server-helpers/translate";
 import { maskPhiTextPlaceholders, resolvePhiTextPlaceholders } from "../../../../../helpers/text-placeholders";
 import { PhiBulletListControl } from "../../../../../components/controls/phi-bullet-list-control";
 import { buildPhiBulletListTree, resolvePhiBulletListStyle, } from "../../../../../components/widgets/shared/bullet-list-vocabulary";
@@ -12,17 +12,15 @@ import { PHI_COLOR, PHI_FONT_SIZE, PHI_LINE_HEIGHT, PHI_SPACE, } from "../../../
  * `{year}` out of the translator's hands, which would otherwise hand back `{Jahr}`.
  */
 async function translateLabel(locale, value, runtime, translate, 
+/** Whose words these are, which decides the store (`helpers/text-source.ts`). */
+textSource, 
 /** The text's own values, which stand in it as `%1` onwards and are never translated. */
 values = []) {
     if (!value) {
         return undefined;
     }
     const masked = maskPhiTextPlaceholders(value, values.length);
-    const translated = !translate
-        ? masked.text
-        : locale
-            ? await trGlobalForLocale(locale, masked.text)
-            : await trGlobal(masked.text);
+    const translated = translate ? await trWidgetText(locale, masked.text, textSource) : masked.text;
     return resolvePhiTextPlaceholders(translated, masked.names, runtime, values);
 }
 function resolveDescriptionToneColor(tone) {
@@ -39,15 +37,15 @@ function resolveDescriptionToneColor(tone) {
 }
 export async function PhiDescriptionWidget({ labels, config, runtime, translate, }) {
     const locale = runtime?.locale.current;
-    const eyebrow = await translateLabel(locale, labels.eyebrow ?? config?.eyebrow, runtime, translate);
-    const title = await translateLabel(locale, labels.title ?? config?.title, runtime, translate);
-    const description = await translateLabel(locale, labels.description ?? config?.description, runtime, translate);
-    const asideTitle = await translateLabel(locale, labels.asideTitle ?? config?.asideTitle, runtime, translate);
+    const eyebrow = await translateLabel(locale, labels.eyebrow ?? config?.eyebrow, runtime, translate, config?.textSource);
+    const title = await translateLabel(locale, labels.title ?? config?.title, runtime, translate, config?.textSource);
+    const description = await translateLabel(locale, labels.description ?? config?.description, runtime, translate, config?.textSource);
+    const asideTitle = await translateLabel(locale, labels.asideTitle ?? config?.asideTitle, runtime, translate, config?.textSource);
     const asideEntries = await Promise.all((labels.asideItems ?? config?.asideItems ?? []).map(async (entry) => ({
         ...entry,
-        text: await translateLabel(locale, entry.text, runtime, translate, entry.values),
+        text: await translateLabel(locale, entry.text, runtime, translate, config?.textSource, entry.values),
     })));
-    const footer = await translateLabel(locale, labels.footer ?? config?.footer, runtime, translate);
+    const footer = await translateLabel(locale, labels.footer ?? config?.footer, runtime, translate, config?.textSource);
     const resolvedAsideItems = buildPhiBulletListTree(asideEntries.filter((entry) => Boolean(entry.text)), (entry) => entry.text);
     const stackStyle = {
         display: "grid",

package/plugins/runtime-modules/core/widgets/entry-list/server.js

@@ -5,7 +5,7 @@ import { getPhiContentEntryReaderLabels } from "../../../../../components/widget
 import { PhiCmsWidgetType } from "../../../../../constants/cms-widget-types";
 import { fetchPhiSiteContentEntries } from "../../../../../gateway/content-entries";
 import { phiRuntime } from "../../../../../server-helpers/phi-runtime";
-import { trBulk } from "../../../../../server-helpers/translate";
+import { trBulkForLocale } from "../../../../../server-helpers/translate";
 import { readPhiBoundContentEntry } from "../../content-entries/record-source.server";
 import { buildPhiEntryViews } from "./view.server";
 import { normalizePhiEntryListWidgetConfig } from "./config";
@@ -74,7 +74,7 @@ export async function PhiEntryListWidget({ config, runtime, registry, links, tra
         // A stacked entry's title is an `h2`; its text's headings start under it.
         headingOffset: 2,
     });
-    const [title] = settings.title && translate ? await trBulk([settings.title]) : [settings.title];
+    const [title] = settings.title && translate ? await trBulkForLocale(locale, [settings.title]) : [settings.title];
     return (_jsx(PhiRuntimeModuleRenderClientHost, { type: PhiCmsWidgetType.EntryList, componentProps: {
             entries: views,
             labels,

package/plugins/runtime-modules/core/widgets/html/server.js

@@ -52,7 +52,7 @@ export async function PhiHtmlWidget({ blockId, config, runtime, }) {
     }
     const translatedHtml = (sourceMode !== "url" && config?.resolvedContent != null) || config?.preferSource === true
         ? sourceHtml
-        : await translateSemanticHtml(sourceHtml, sourceMode === "url" ? config?.sourceLocale?.trim() : undefined);
+        : await translateSemanticHtml(sourceHtml, sourceMode === "url" ? config?.sourceLocale?.trim() : undefined, runtime.locale.current);
     if (!translatedHtml) {
         return null;
     }

package/plugins/runtime-modules/core/widgets/markdown-toc/server.js

@@ -1,7 +1,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { PhiCmsFlags } from "../../../../../constants/phi-cms";
 import { hasPhiFlag } from "../../../../../helpers/flags";
-import { tr } from "../../../../../server-helpers/translate";
+import { trForLocale } from "../../../../../server-helpers/translate";
 import { PhiCmsWidgetType } from "../../../../../constants/cms-widget-types";
 import { parsePhiCmsMarkdownWidgetConfig } from "../markdown/config";
 import { PhiRuntimeModuleRenderClientHost } from "../../../../../components/runtime/runtime-module-render-client-manifest";
@@ -25,7 +25,12 @@ function filterHeadings(headings, config) {
     return headings.filter((heading) => heading.level >= minLevel && heading.level <= maxLevel);
 }
 export async function PhiMarkdownTocWidget({ config, defaultLabels, tree, runtime, }) {
-    const title = await tr(config?.title?.trim() || defaultLabels.title);
+    /*
+     * The author's title in the render's locale; the default is a label set's and arrives translated, so
+     * asking for it again would hand a translator text that is no longer in the source language.
+     */
+    const ownTitle = config?.title?.trim();
+    const title = ownTitle ? await trForLocale(runtime.locale.current, ownTitle) : defaultLabels.title;
     const targetWidget = resolveTargetMarkdownWidget(tree, config);
     if (!targetWidget) {
         return (_jsx(PhiRuntimeModuleRenderClientHost, { type: PhiCmsWidgetType.MarkdownToc, componentProps: { config: { ...config, title, headings: [] } } }));

package/plugins/runtime-modules/core/widgets/quick-links/config.d.ts

@@ -1,9 +1,12 @@
+import { type PhiTextSource } from "../../../../../helpers/text-source";
 import { type PhiCmsWidgetConfigBase } from "../../../../../components/widgets/config/parser-primitives";
 export type PhiCmsQuickLinksWidgetConfig = PhiCmsWidgetConfigBase & {
     navKey?: string;
     title?: string;
     columns?: 1 | 2 | 3;
     separator?: boolean;
+    /** `"preset"` while the words are a Preset's and translated globally (`helpers/text-source.ts`). */
+    textSource?: PhiTextSource;
 };
 declare function parsePhiCmsQuickLinksWidgetConfig(config: Record<string, unknown>): PhiCmsQuickLinksWidgetConfig;
 export declare const PHI_QUICK_LINKS_WIDGET_DEFINITION: {

package/plugins/runtime-modules/core/widgets/quick-links/config.js

@@ -1,4 +1,5 @@
 import { resolvePhiCmsWidgetPluginKey } from "../../../../../constants/cms-widget-types";
+import { readPhiTextSource } from "../../../../../helpers/text-source";
 import { PhiCmsWidgetType } from "../../../../../constants/cms-widget-types";
 import { PHI_AUTHORING_OPTION_PROVIDER_KEYS } from "../../../../../constants/authoring-option-provider-keys";
 import { readBoolean, readNumber, readRenderableBlockConfig, readString, } from "../../../../../components/widgets/config/parser-primitives";
@@ -11,6 +12,7 @@ function parsePhiCmsQuickLinksWidgetConfig(config) {
         title: readString(config.title),
         columns: columns === 1 || columns === 3 ? columns : 2,
         separator: readBoolean(config.separator) ?? true,
+        textSource: readPhiTextSource(config.textSource),
     };
 }
 export const PHI_QUICK_LINKS_WIDGET_DEFINITION = {

package/plugins/runtime-modules/core/widgets/quick-links/plugin.js

@@ -1,9 +1,11 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { PhiCmsFlags } from "../../../../../constants/phi-cms";
+import { hasPhiFlag } from "../../../../../helpers/flags";
 import { PhiQuickLinksWidget } from "./server";
 import { PHI_QUICK_LINKS_WIDGET_DEFINITION, PHI_QUICK_LINKS_WIDGET_PLUGIN_TYPE, } from "./config";
 export const PHI_QUICK_LINKS_WIDGET_PLUGIN = {
     ...PHI_QUICK_LINKS_WIDGET_DEFINITION,
-    render: ({ widget, runtime, config }) => (_jsx(PhiQuickLinksWidget, { runtime: runtime, navKey: config.navKey, title: config.title, columns: config.columns, separator: config.separator }, `widget-${widget.id}`)),
-    renderPreview: ({ widget, runtime, config }) => (_jsx(PhiQuickLinksWidget, { runtime: runtime, navKey: config.navKey, title: config.title, columns: config.columns, separator: config.separator, interactive: false }, `widget-${widget.id}`)),
+    render: ({ widget, runtime, config }) => (_jsx(PhiQuickLinksWidget, { runtime: runtime, navKey: config.navKey, title: config.title, textSource: config.textSource, translate: !hasPhiFlag(widget.flags, PhiCmsFlags.NoTranslate), columns: config.columns, separator: config.separator }, `widget-${widget.id}`)),
+    renderPreview: ({ widget, runtime, config }) => (_jsx(PhiQuickLinksWidget, { runtime: runtime, navKey: config.navKey, title: config.title, textSource: config.textSource, translate: !hasPhiFlag(widget.flags, PhiCmsFlags.NoTranslate), columns: config.columns, separator: config.separator, interactive: false }, `widget-${widget.id}`)),
 };
 export { PHI_QUICK_LINKS_WIDGET_PLUGIN_TYPE };

package/plugins/runtime-modules/core/widgets/quick-links/server.d.ts

@@ -1,10 +1,14 @@
 import type { PhiBlockRuntime } from "../../../../../types";
+import type { PhiTextSource } from "../../../../../helpers/text-source";
 export type PhiQuickLinksWidgetProps = {
     runtime: Pick<PhiBlockRuntime, "site" | "locale" | "area" | "viewer" | "request">;
     navKey?: string;
     title?: string;
+    /** Whose words the title is, which decides the store that translates it. */
+    textSource?: PhiTextSource;
+    translate?: boolean;
     columns?: 1 | 2 | 3;
     separator?: boolean;
     interactive?: boolean;
 };
-export declare function PhiQuickLinksWidget({ runtime, navKey, title, columns, separator, interactive, }: PhiQuickLinksWidgetProps): Promise<import("react").JSX.Element | null>;
+export declare function PhiQuickLinksWidget({ runtime, navKey, title, textSource, translate, columns, separator, interactive, }: PhiQuickLinksWidgetProps): Promise<import("react").JSX.Element | null>;

package/plugins/runtime-modules/core/widgets/quick-links/server.js

@@ -3,15 +3,17 @@ import { PhiCmsWidgetType } from "../../../../../constants/cms-widget-types";
 import { PhiRuntimeModuleRenderClientHost } from "../../../../../components/runtime/runtime-module-render-client-manifest";
 import { resolvePhiNavigationItems } from "../../../../../components/widgets/server/navigation-request";
 import { mapPhiNavItemsToQuickLinksItems } from "./items";
-export async function PhiQuickLinksWidget({ runtime, navKey, title, columns = 2, separator = true, interactive = true, }) {
+import { trWidgetText } from "../../../../../server-helpers/translate";
+export async function PhiQuickLinksWidget({ runtime, navKey, title, textSource, translate = true, columns = 2, separator = true, interactive = true, }) {
     const resolvedNavKey = navKey?.trim() ||
         `${runtime.area}:footer`;
     const resolvedNavigationItems = (await resolvePhiNavigationItems(runtime, resolvedNavKey)) ?? [];
     if (resolvedNavigationItems.length === 0) {
         return null;
     }
+    const ownTitle = title?.trim();
     const labels = {
-        title,
+        title: ownTitle && translate ? await trWidgetText(runtime.locale.current, ownTitle, textSource) : title,
     };
     const config = {
         columns,

package/plugins/runtime-modules/core/widgets/simple-text/config.d.ts

@@ -1,3 +1,4 @@
+import { type PhiTextSource } from "../../../../../helpers/text-source";
 import { type PhiSimpleTextMark } from "../../../../../types/core-widget-placements";
 import type { PhiCmsResolvedContent } from "../../../../../types";
 import type { PhiWidgetFontFamilyKey, PhiWidgetFontSizeKey } from "../../../../../types/site-theme";
@@ -15,6 +16,8 @@ export type PhiCmsSimpleTextWidgetConfig = PhiCmsWidgetConfigBase & {
     tone?: PhiTextTone;
     marks?: PhiSimpleTextMark[];
     disabled?: boolean;
+    /** `"preset"` while the words are a Preset's and translated globally (`helpers/text-source.ts`). */
+    textSource?: PhiTextSource;
 };
 declare function parsePhiCmsSimpleTextWidgetConfig(config: Record<string, unknown>): PhiCmsSimpleTextWidgetConfig;
 export type PhiSimpleTextWidgetRenderableConfig = PhiCmsSimpleTextWidgetConfig & {

package/plugins/runtime-modules/core/widgets/simple-text/config.js

@@ -1,4 +1,5 @@
 import { resolvePhiCmsWidgetPluginKey } from "../../../../../constants/cms-widget-types";
+import { readPhiTextSource } from "../../../../../helpers/text-source";
 import { PHI_SIMPLE_TEXT_MARKS } from "../../../../../types/core-widget-placements";
 import { PhiCmsWidgetType } from "../../../../../constants/cms-widget-types";
 import { PHI_RENDERABLE_BLOCK_GEOMETRY_FIELDS } from "../../../../../helpers/renderable-block-plugin-fields";
@@ -27,6 +28,7 @@ function parsePhiCmsSimpleTextWidgetConfig(config) {
         tone: readPhiTextTone(config.tone),
         marks: readSimpleTextMarks(config.marks),
         disabled: readBoolean(config.disabled),
+        textSource: readPhiTextSource(config.textSource),
     };
 }
 export const PHI_SIMPLE_TEXT_WIDGET_DEFINITION = {

package/plugins/runtime-modules/core/widgets/simple-text/plugin.js

@@ -9,7 +9,7 @@ export const PHI_SIMPLE_TEXT_WIDGET_PLUGIN = {
         const noTranslate = hasPhiFlag(widget.flags, PhiCmsFlags.NoTranslate);
         // A record's text is already translated; only the Widget's own still has to be.
         const hasResolvedText = Boolean(widget.resolvedContent?.textFields.text);
-        return (_jsx(PhiSimpleTextWidget, { blockId: widget.id, translate: !noTranslate && !hasResolvedText, labels: {
+        return (_jsx(PhiSimpleTextWidget, { blockId: widget.id, translate: !noTranslate && !hasResolvedText, textSource: config.textSource, labels: {
                 text: resolvePhiSimpleTextWidgetText({
                     ...config,
                     label: widget.label ?? undefined,

package/plugins/runtime-modules/core/widgets/simple-text/server.d.ts

@@ -1,3 +1,4 @@
+import type { PhiTextSource } from "../../../../../helpers/text-source";
 import type { PhiCmsInstanceId, PhiRenderableBlockBase, PhiServerBlockBaseProps } from "../../../../../types";
 import type { PhiSimpleTextWidgetClientConfig } from "./client";
 export type PhiSimpleTextWidgetLabels = {
@@ -6,6 +7,8 @@ export type PhiSimpleTextWidgetLabels = {
 export type PhiSimpleTextWidgetConfig = PhiSimpleTextWidgetClientConfig & PhiRenderableBlockBase;
 export type PhiSimpleTextWidgetProps = PhiServerBlockBaseProps<PhiSimpleTextWidgetLabels, PhiSimpleTextWidgetConfig> & {
     blockId: PhiCmsInstanceId;
+    /** Whose words the text is, which decides the store that translates it (`helpers/text-source.ts`). */
+    textSource?: PhiTextSource;
     /**
      * Whether the text still has to be translated, which is true only where it is the Widget's own.
      *
@@ -16,4 +19,4 @@ export type PhiSimpleTextWidgetProps = PhiServerBlockBaseProps<PhiSimpleTextWidg
      */
     translate?: boolean;
 };
-export declare function PhiSimpleTextWidget({ blockId, labels, config, translate, runtime, }: PhiSimpleTextWidgetProps): Promise<import("react").JSX.Element>;
+export declare function PhiSimpleTextWidget({ blockId, labels, config, translate, textSource, runtime, }: PhiSimpleTextWidgetProps): Promise<import("react").JSX.Element>;

package/plugins/runtime-modules/core/widgets/simple-text/server.js

@@ -1,9 +1,9 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { trGlobal, trGlobalForLocale, } from "../../../../../server-helpers/translate";
+import { trWidgetText } from "../../../../../server-helpers/translate";
 import { maskPhiTextPlaceholders, resolvePhiTextPlaceholders } from "../../../../../helpers/text-placeholders";
 import { PhiCmsWidgetType } from "../../../../../constants/cms-widget-types";
 import { PhiRuntimeModuleRenderClientHost } from "../../../../../components/runtime/runtime-module-render-client-manifest";
-export async function PhiSimpleTextWidget({ blockId, labels, config, translate, runtime, }) {
+export async function PhiSimpleTextWidget({ blockId, labels, config, translate, textSource, runtime, }) {
     const locale = runtime?.locale.current;
     /*
      * Masked before the translation and filled after it.
@@ -14,7 +14,7 @@ export async function PhiSimpleTextWidget({ blockId, labels, config, translate,
      */
     const masked = maskPhiTextPlaceholders(labels.text);
     const translated = translate && masked.text
-        ? locale ? await trGlobalForLocale(locale, masked.text) : await trGlobal(masked.text)
+        ? await trWidgetText(locale, masked.text, textSource)
         : masked.text;
     const text = resolvePhiTextPlaceholders(translated, masked.names, runtime);
     return (_jsx(PhiRuntimeModuleRenderClientHost, { type: PhiCmsWidgetType.SimpleText, componentProps: {

package/plugins/runtime-modules/core/widgets/table/client.js

@@ -913,7 +913,7 @@ export function PhiTableWidgetClient({ config: inputConfig, externalSearch, exte
                             afterRowIdentity: null,
                         }).catch(() => undefined).finally(clearPhiDataDragPayload);
                     }
-                    : undefined, loading: effectiveLoading, bordered: presentation.borders, striped: presentation.row?.striped, showHeader: presentation.header, size: resolvedControlSize, emptyText: (_jsxs(PhiFlexControl, { vertical: true, gap: "small", children: [_jsx(PhiTypographyControl, { strong: true, children: presentation.emptyState?.title ?? labels.emptyTitle }), _jsx(PhiTypographyControl, { type: "secondary", children: presentation.emptyState?.description ?? labels.emptyDescription })] })), layout: presentation.layout, footer: footer, summary: tableSummary })] }));
+                    : undefined, loading: effectiveLoading, bordered: presentation.borders, striped: presentation.row?.striped, showHeader: presentation.header, stickyHeader: presentation.stickyHeader !== false, size: resolvedControlSize, emptyText: (_jsxs(PhiFlexControl, { vertical: true, gap: "small", children: [_jsx(PhiTypographyControl, { strong: true, children: presentation.emptyState?.title ?? labels.emptyTitle }), _jsx(PhiTypographyControl, { type: "secondary", children: presentation.emptyState?.description ?? labels.emptyDescription })] })), layout: presentation.layout, footer: footer, summary: tableSummary })] }));
 }
 function TableAction({ action, disabled = false, disabledReason, templateValue, size, onActivate }) {
     const icon = action.icon ? resolvePhiButtonIcon(action.icon) : null;

package/plugins/runtime-modules/core/widgets/table/config.d.ts

@@ -1217,6 +1217,7 @@ export declare const PHI_TABLE_WIDGET_DEFINITION: {
             };
             borders: false;
             header: true;
+            stickyHeader: true;
             row: {
                 striped: false;
             };

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

@@ -537,6 +537,7 @@ export function parsePhiTableWidgetConfig(config) {
             },
             borders: readBoolean(presentation.borders),
             header: readBoolean(presentation.header),
+            stickyHeader: readBoolean(presentation.stickyHeader),
             footer: readTableFooter(presentation.footer),
             summary: readTableSummary(presentation.summary),
             row: {
@@ -1153,6 +1154,7 @@ export const PHI_TABLE_WIDGET_DEFINITION = {
         { ...PHI_CONTROL_SIZE_FIELD, key: "presentation.controlSize" },
         { key: "presentation.borders", type: "boolean", label: "Borders" },
         { key: "presentation.header", type: "boolean", label: "Header" },
+        { key: "presentation.stickyHeader", type: "boolean", label: "Sticky Header" },
         { key: "presentation.row.striped", type: "boolean", label: "Striped Rows" },
         ...buildPhiTableConditionExpressionConfigFields("presentation.row.mutedWhen", "Muted Row Conditions", "any", "No muted rows"),
     ],
@@ -1162,6 +1164,7 @@ export const PHI_TABLE_WIDGET_DEFINITION = {
             layout: { mode: "auto", overflowX: "auto" },
             borders: false,
             header: true,
+            stickyHeader: true,
             row: { striped: false },
         },
         features: {

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

@@ -4,8 +4,7 @@ import { PhiCmsFlags, PhiCmsRegionType } from "../../constants/phi-cms";
 import { resolvePhiCmsWidgetPluginKey } from "../../constants/cms-widget-types";
 import { buildPhiCmsLayoutNamespacedTypeKey } from "../../constants/cms-layout-types";
 import { resolvePhiCmsLayoutPluginKey } from "../../constants/cms-layout-type-keys";
-import { trGlobal } from "../../server-helpers/translate";
-import { PHI_TR_CTX_WEB_UI_LABEL } from "../../gateway/tr";
+import { PHI_TEXT_SOURCE_PRESET } from "../../helpers/text-source";
 import { PHI_SPACE } from "../../theme/antd-css-var-contract";
 import { buildPhiCmsWidgetNamespacedTypeKey } from "../../constants/cms-widget-types";
 import { createPhiCmsPresetNodes } from "../../helpers/cms-preset-nodes";
@@ -44,7 +43,12 @@ export async function buildPhiDefaultSiteAreaPresetTree({ page, runtime, presetK
     const footerTopRegion = PHI_DEFAULT_PUB_AREA_PRESET.regions.find((region) => region.key === "footer_top");
     const footerBottomRegion = PHI_DEFAULT_PUB_AREA_PRESET.regions.find((region) => region.key === "footer_bottom");
     const { label: contactLabel, href: contactHref, icon: contactIcon, } = resolvePhiBrandContact(runtime);
-    const defaultQuickLinksTitle = await trGlobal("Quick Links", 0, PHI_TR_CTX_WEB_UI_LABEL);
+    /*
+     * The Preset's words stay in the source language and say they are the Preset's; the Widgets translate
+     * them through the global store (`helpers/text-source.ts`). The contact label is the Preset's only
+     * while the Site's theme names none.
+     */
+    const contactLabelIsPreset = !runtime.site.theme?.contact?.label?.trim();
     /*
      * A template rather than a finished sentence, and left untranslated here.
      *
@@ -477,6 +481,7 @@ export async function buildPhiDefaultSiteAreaPresetTree({ page, runtime, presetK
                         label: "pub header top right",
                         config: {
                             text: contactLabel,
+                            ...(contactLabelIsPreset ? { textSource: PHI_TEXT_SOURCE_PRESET } : {}),
                             href: contactHref,
                             icon: contactIcon,
                         },
@@ -581,7 +586,8 @@ export async function buildPhiDefaultSiteAreaPresetTree({ page, runtime, presetK
                         visibilityMask: page.visibilityMask,
                         label: "pub footer main quick links",
                         config: {
-                            title: defaultQuickLinksTitle,
+                            title: "Quick Links",
+                            textSource: PHI_TEXT_SOURCE_PRESET,
                             navKey: `${navigationArea}:footer`,
                             columns: 2,
                             separator: true,
@@ -601,6 +607,7 @@ export async function buildPhiDefaultSiteAreaPresetTree({ page, runtime, presetK
                         label: "pub footer main right",
                         config: {
                             text: contactLabel,
+                            ...(contactLabelIsPreset ? { textSource: PHI_TEXT_SOURCE_PRESET } : {}),
                             href: contactHref,
                             icon: contactIcon,
                         },
@@ -623,6 +630,7 @@ export async function buildPhiDefaultSiteAreaPresetTree({ page, runtime, presetK
                         label: "pub footer bottom text",
                         config: {
                             text: footerBottomText,
+                            textSource: PHI_TEXT_SOURCE_PRESET,
                             tone: "secondary",
                         },
                         contentVersionId: null,

package/plugins/runtime-modules/public/trees/phi-default-pub-contact-page-tree.js

@@ -1,3 +1,4 @@
+import { PHI_TEXT_SOURCE_PRESET } from "../../../../helpers/text-source";
 import { createPhiPresetCmsInstanceIdMap } from "../../../../types/cms-instance-id";
 import { PHI_SPACE } from "../../../../theme/antd-css-var-contract";
 import { PHI_PUBLIC_RUNTIME_MODULE_ID } from "../ids";
@@ -73,6 +74,7 @@ export async function buildPhiDefaultPubContactPageTree({ page, }) {
                 sortOrder: 0,
                 label: "pub contact description widget",
                 config: {
+                    textSource: PHI_TEXT_SOURCE_PRESET,
                     eyebrow: "Contact",
                     title: "Get in touch",
                     description: "Send us your question, project request, or product inquiry and we will get back to you.",

package/plugins/runtime-modules/public/trees/phi-default-pub-unsubscribe-page-tree.js

@@ -1,3 +1,4 @@
+import { PHI_TEXT_SOURCE_PRESET } from "../../../../helpers/text-source";
 import { createPhiPresetCmsInstanceIdMap } from "../../../../types/cms-instance-id";
 import { PHI_PUBLIC_RUNTIME_MODULE_ID } from "../ids";
 import { PhiCmsPageType } from "../../../../constants/phi-cms";
@@ -58,6 +59,7 @@ export async function buildPhiDefaultPubUnsubscribePageTree({ page, presetKey, }
                 sortOrder: 0,
                 label: "pub unsubscribe intro widget",
                 config: {
+                    textSource: PHI_TEXT_SOURCE_PRESET,
                     title: "Stop receiving updates",
                     description: "Press the button below and this site will send you no further updates.",
                     visibleWhen: withToken,
@@ -75,6 +77,7 @@ export async function buildPhiDefaultPubUnsubscribePageTree({ page, presetKey, }
                 sortOrder: 0,
                 label: "pub unsubscribe incomplete widget",
                 config: {
+                    textSource: PHI_TEXT_SOURCE_PRESET,
                     title: "This link is incomplete",
                     description: "Open the unsubscribe link from the message itself, or use the most recent one you received.",
                     tone: "secondary",

package/plugins/runtime-modules/public/trees/phi-default-pub-welcome-page-tree.js

@@ -1,3 +1,4 @@
+import { PHI_TEXT_SOURCE_PRESET } from "../../../../helpers/text-source";
 import { createPhiPresetCmsInstanceIdMap } from "../../../../types/cms-instance-id";
 import { PHI_PUBLIC_RUNTIME_MODULE_ID } from "../ids";
 import { PHI_PUBLIC_BASE_PAGE_REFERENCES } from "../../public-base-page-references";
@@ -125,7 +126,7 @@ export async function buildPhiDefaultPubWelcomePageTree({ page, runtime, }) {
                 sortOrder: 0,
                 label: "pub welcome greeting",
                 // English source, like every Preset sentence: the Site translator makes it "Herzlich willkommen".
-                config: { text: "A warm welcome" },
+                config: { textSource: PHI_TEXT_SOURCE_PRESET, text: "A warm welcome" },
             }),
             nodes.widget({
                 typeKey: "markdown",

package/plugins/runtime-modules/revisions/trees/phi-default-builder-revisions-page-tree.js

@@ -265,6 +265,8 @@ export async function buildPhiDefaultBuilderRevisionsPageTree({ page, runtime, }
              */
             nodes.widget({
                 typeKey: "simple-text",
+                /* Label set text, translated already; a second pass would hand the translator a non-source text. */
+                flags: PhiCmsFlags.NoTranslate,
                 id: PHI_REVISIONS_DELETE_AREA_WIDGET_IDS.deleteAreaWarning,
                 parentLayoutNodeId: PHI_REVISIONS_DELETE_AREA_LAYOUT_IDS.deleteAreaBody,
                 slotIndex: PHI_CMS_DEFAULT_SLOT_INDEX,
@@ -279,6 +281,8 @@ export async function buildPhiDefaultBuilderRevisionsPageTree({ page, runtime, }
             }),
             nodes.widget({
                 typeKey: "simple-text",
+                /* Label set text, translated already; a second pass would hand the translator a non-source text. */
+                flags: PhiCmsFlags.NoTranslate,
                 id: PHI_REVISIONS_DELETE_AREA_WIDGET_IDS.deleteAreaSurvives,
                 parentLayoutNodeId: PHI_REVISIONS_DELETE_AREA_LAYOUT_IDS.deleteAreaBody,
                 slotIndex: PHI_CMS_SEQUENTIAL_LAYOUT_SLOTS[1].slotIndex,

package/server-helpers/translate.d.ts

@@ -1,10 +1,19 @@
 import "server-only";
 import { type PhiTranslationParams } from "../helpers/translation-format";
 import { PHI_TR_CTX_WEB_UI_LABEL, type PhiTranslationFormat } from "../gateway/tr";
+import { type PhiTextSource } from "../helpers/text-source";
 export { PHI_TR_CTX_WEB_UI_LABEL };
 export type { PhiTranslationParams } from "../helpers/translation-format";
 export declare function tr(msg: string, params?: PhiTranslationParams, ctx?: string | number, format?: PhiTranslationFormat): Promise<string>;
 export declare function trGlobal(msg: string, params?: PhiTranslationParams, ctx?: string | number, format?: PhiTranslationFormat): Promise<string>;
+/**
+ * A text Widget's own words in the render's locale, from the store their source names.
+ *
+ * `textSource: "preset"` is a Preset's sentence and the platform's, so the global store answers it;
+ * anything else an author wrote and the Site's store does (`helpers/text-source.ts`). The locale is the
+ * render's where there is one: a static render has no request to read it from.
+ */
+export declare function trWidgetText(locale: string | undefined, msg: string, textSource: PhiTextSource | undefined): Promise<string>;
 export declare function trForLocale(localeInput: string, msg: string, params?: PhiTranslationParams, ctx?: string | number, format?: PhiTranslationFormat, 
 /** The language `msg` is written in, when it is not the Site's own -- a Module's text. */
 sourceLocale?: string): Promise<string>;

package/server-helpers/translate.js

@@ -6,6 +6,7 @@ import { PHI_TR_CTX_WEB_UI_LABEL, trBulk as requestInternalTranslationBulk, tr a
 import { getPhiRequestRuntime } from "./request-runtime";
 import { resolvePhiRequestLocale } from "./request-locale";
 import { readPhiServerApiCredentials } from "../helpers/phis-server-credentials";
+import { PHI_TEXT_SOURCE_PRESET } from "../helpers/text-source";
 export { PHI_TR_CTX_WEB_UI_LABEL };
 function buildTranslatorOptions(locale, sourceLocale) {
     const requestRuntime = getPhiRequestRuntime();
@@ -46,6 +47,19 @@ export async function trGlobal(msg, params = 0, ctx = 0, format = "text") {
     const locale = await resolvePhiRequestLocale();
     return trGlobalForLocale(locale, msg, params, ctx, format);
 }
+/**
+ * A text Widget's own words in the render's locale, from the store their source names.
+ *
+ * `textSource: "preset"` is a Preset's sentence and the platform's, so the global store answers it;
+ * anything else an author wrote and the Site's store does (`helpers/text-source.ts`). The locale is the
+ * render's where there is one: a static render has no request to read it from.
+ */
+export async function trWidgetText(locale, msg, textSource) {
+    if (textSource === PHI_TEXT_SOURCE_PRESET) {
+        return locale ? trGlobalForLocale(locale, msg) : trGlobal(msg);
+    }
+    return locale ? trForLocale(locale, msg) : tr(msg);
+}
 /**
  * Trimmed, one per message and in order: an empty message stays in its place, and `trBulk` answers it
  * with an empty text, so every answer lines up with the message it belongs to.

package/styles/controls.css

@@ -492,10 +492,24 @@ h5.phi-typography, .phi-typography h5 {
  * as a Table closed with one instead of with a footer. Clipping the Table is what both cases want, which
  * is why the rule names neither.
  */
+/*
+ * A sticky header row sticks under the Shell's Header, which publishes where it ends right now
+ * (`components/shell/use-phi-shell-sticky-top.ts`), and at the top edge of an Overlay's body,
+ * which scrolls on its own. Ant Design writes the offset inline, so the position is stated over it.
+ */
+.phi-table-control.phi-table-control--sticky-header [class~="ant-table-sticky-holder"] {
+  top: var(--phi-table-sticky-top, var(--phi-shell-sticky-top, 0px)) !important;
+}
+
+:is([data-phi-modal-body-content], [data-phi-drawer-body-content]) {
+  --phi-table-sticky-top: 0px;
+}
+
 .phi-table-control.phi-table-control--closing-block [class~="ant-table"] {
   border-end-start-radius: var(--phi-surface-radius, var(--ant-border-radius-lg));
   border-end-end-radius: var(--phi-surface-radius, var(--ant-border-radius-lg));
-  overflow: hidden;
+  /* `clip`, not `hidden`, so the corners are cut without making this the sticky header's scroller. */
+  overflow: clip;
 }
 
 /*

package/styles/root.css

@@ -114,29 +114,30 @@ samp {
   animation-timing-function: var(--phi-effects-animation-easing, ease-out);
 }
 
-:where([data-phi-renderable-block="true"][data-phi-effects-transition="composite"][data-phi-effects-trigger="on_visible"]) {
-  animation-composition: var(--phi-effects-animation-composition, replace);
-  animation-delay: var(--phi-effects-animation-delay, 0ms);
-  animation-duration: var(--phi-effects-animation-duration, 1000ms);
-  animation-name: var(--phi-effects-animation-name);
-  animation-play-state: paused;
-  animation-timing-function: var(--phi-effects-animation-easing, ease-out);
-}
-
-:where([data-phi-renderable-block="true"][data-phi-effects-transition="composite"][data-phi-effects-trigger="on_visible"][data-phi-effects-state="running"]) {
-  animation-play-state: running;
-}
-
 /*
- * On ready, the whole rule inside the query that asks whether anything can release it.
+ * On visible and on ready, the whole rule inside the query that asks whether anything can release it.
  *
- * The animation is held at its first frame until the page has finished arriving, so a Widget whose
- * content the server streams in a segment of its own can land, and everything below it can settle,
- * behind an entrance that has not started. Only scripting sets the state that releases it; where there
- * is none the Block would stand at that first frame for good, which for a fade in means invisible. So
- * without scripting there is no animation at all and the Block is simply there.
+ * The animation is held at its first frame -- until the Block is scrolled into view, or until the page
+ * has finished arriving, so a Widget whose content the server streams in a segment of its own can land,
+ * and everything below it can settle, behind an entrance that has not started. Only scripting sets the
+ * state that releases it; where there is none the Block would stand at that first frame for good, which
+ * for a fade in means invisible. So without scripting there is no animation at all and the Block is
+ * simply there.
  */
 @media (scripting: enabled) {
+  :where([data-phi-renderable-block="true"][data-phi-effects-transition="composite"][data-phi-effects-trigger="on_visible"]) {
+    animation-composition: var(--phi-effects-animation-composition, replace);
+    animation-delay: var(--phi-effects-animation-delay, 0ms);
+    animation-duration: var(--phi-effects-animation-duration, 1000ms);
+    animation-name: var(--phi-effects-animation-name);
+    animation-play-state: paused;
+    animation-timing-function: var(--phi-effects-animation-easing, ease-out);
+  }
+
+  :where([data-phi-renderable-block="true"][data-phi-effects-transition="composite"][data-phi-effects-trigger="on_visible"][data-phi-effects-state="running"]) {
+    animation-play-state: running;
+  }
+
   :where([data-phi-renderable-block="true"][data-phi-effects-transition="composite"][data-phi-effects-trigger="on_ready"]) {
     animation-composition: var(--phi-effects-animation-composition, replace);
     animation-delay: var(--phi-effects-animation-delay, 0ms);

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

@@ -1,5 +1,6 @@
 import type { PhiBulletListEntry, PhiBulletListStyle } from "../components/widgets/shared/bullet-list-vocabulary";
 import type { PhiRenderableBlockBase } from "./renderable-block";
+import type { PhiTextSource } from "../helpers/text-source";
 import type { PhiRuntimeConditionExpression } from "./runtime-condition";
 import type { PhiSignalRoute, PhiSignalValue } from "./signals";
 import type { PhiCssLength } from "./length";
@@ -71,6 +72,8 @@ export type PhiSimpleTextWidgetPlacement = PhiWidgetPlacementBase & {
     tone?: PhiTextTone;
     marks?: PhiSimpleTextMark[];
     disabled?: boolean;
+    /** `"preset"` while the words are a Preset's (`helpers/text-source.ts`). */
+    textSource?: PhiTextSource;
 };
 export type PhiDescriptionWidgetPlacement = PhiWidgetPlacementBase & {
     eyebrow?: string;
@@ -81,6 +84,8 @@ export type PhiDescriptionWidgetPlacement = PhiWidgetPlacementBase & {
     asideList?: PhiBulletListStyle;
     footer?: string;
     tone?: PhiTextTone;
+    /** `"preset"` while the words are a Preset's (`helpers/text-source.ts`). */
+    textSource?: PhiTextSource;
 };
 export type PhiButtonWidgetPlacement = PhiWidgetPlacementBase & PhiControlPlacement & PhiControlBadgeConfig & {
     action?: PhiCommonControlActionKey;

package/types/table-widget.d.ts

@@ -306,6 +306,8 @@ export type PhiTableWidgetPresentation = PhiControlPresentationConfig & {
     borders?: boolean;
     /** The header row; shown unless this says `false`. */
     header?: boolean;
+    /** Whether the header row stays at the top while the rows scroll under it; on unless this says `false`. */
+    stickyHeader?: boolean;
     footer?: PhiTableFooterConfig;
     summary?: PhiTableSummaryConfig;
     row?: {