@phis/ui 0.4.0 → 0.4.2

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/config.d.ts

@@ -1,4 +1,4 @@
-import type { PhiMarkdownTextAlign } from "../../../../../types/core-widget-placements";
+import type { PhiMarkdownImageFloat, PhiMarkdownTextAlign } from "../../../../../types/core-widget-placements";
 import { type PhiSpacingScaleKey } from "../../../../../components/widgets/config/spacing-options";
 import type { PhiCmsResolvedContent } from "../../../../../types/cms";
 import { type PhiBulletListStyle } from "../../../../../components/widgets/shared/bullet-list-vocabulary";
@@ -13,6 +13,8 @@ export type PhiCmsMarkdownWidgetConfig = PhiCmsWidgetConfigBase & {
     /** Set at render from the node's `NoTranslate` flag, or by a caller that knows; never authored. */
     translate?: boolean;
     textAlign?: PhiMarkdownTextAlign;
+    /** Pictures stand at this edge and the text flows past them; absent, a picture is a line of its own. */
+    imageFloat?: PhiMarkdownImageFloat;
     textBlockSpacingBefore?: PhiSpacingScaleKey;
     textBlockSpacingAfter?: PhiSpacingScaleKey;
     headingBlockSpacingBefore?: PhiSpacingScaleKey;

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

@@ -9,6 +9,13 @@ const PHI_MARKDOWN_TEXT_ALIGN_OPTIONS = [
     { value: "end", label: "End" },
     { value: "justify", label: "Justify" },
 ];
+const PHI_MARKDOWN_IMAGE_FLOAT_OPTIONS = [
+    { value: "start", label: "Start" },
+    { value: "end", label: "End" },
+];
+function readMarkdownImageFloat(value) {
+    return value === "start" || value === "end" ? value : undefined;
+}
 // The one spacing scale every padding and gap speaks (`theme/phi-tokens.ts`), stored by its key.
 const PHI_MARKDOWN_SPACING_OPTIONS = PHI_SPACING_SCALE_KEYS.map((key) => ({ value: key, label: key }));
 function readMarkdownSourceMode(value) {
@@ -41,6 +48,7 @@ export function parsePhiCmsMarkdownWidgetConfig(config) {
         sourceLocale: readString(config.sourceLocale),
         revalidateSeconds: readNumber(config.revalidateSeconds),
         textAlign: readMarkdownTextAlign(config.textAlign),
+        imageFloat: readMarkdownImageFloat(config.imageFloat),
         textBlockSpacingBefore: readMarkdownSpacingKey(config.textBlockSpacingBefore),
         textBlockSpacingAfter: readMarkdownSpacingKey(config.textBlockSpacingAfter),
         headingBlockSpacingBefore: readMarkdownSpacingKey(config.headingBlockSpacingBefore),
@@ -115,6 +123,12 @@ export const PHI_MARKDOWN_WIDGET_DEFINITION = {
             label: "Align",
             options: PHI_MARKDOWN_TEXT_ALIGN_OPTIONS,
         },
+        {
+            key: "imageFloat",
+            type: "choice",
+            label: "Image Float",
+            options: PHI_MARKDOWN_IMAGE_FLOAT_OPTIONS,
+        },
         {
             key: "textBlockSpacingBefore",
             type: "choice",

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;
 }
 
 /*
@@ -584,3 +598,29 @@ h5.phi-typography, .phi-typography h5 {
 .phi-plain-table tbody tr:last-child td {
   border-block-end: none;
 }
+
+/*
+ * Markdown pictures the text flows past (`imageFloat` on the Markdown Widget).
+ *
+ * Only where there is room for both: below 560px a picture beside the words leaves each of them a column
+ * nobody reads, so there the picture stands on its own line at full width, as an unfloated one does. The
+ * width is a share of the text with a ceiling, so a wide column does not grow the picture past a glance.
+ */
+.phi-markdown-body :is(img) {
+  display: block;
+  margin-block-end: var(--ant-margin, 16px);
+}
+
+@container (min-width: 560px) {
+  .phi-markdown-body--float-start :is(img) {
+    float: inline-start;
+    width: min(45%, 440px);
+    margin-inline-end: var(--ant-margin-lg, 24px);
+  }
+
+  .phi-markdown-body--float-end :is(img) {
+    float: inline-end;
+    width: min(45%, 440px);
+    margin-inline-start: var(--ant-margin-lg, 24px);
+  }
+}