@phis/ui 0.2.1 → 0.4.0

package/plugins/runtime-modules/localization/controller/client.js

@@ -1,47 +1,35 @@
 "use client";
-import { createElement, useCallback, useEffect, useRef, useState } from "react";
+import { isPhiRecord } from "../../../../helpers/is-record";
+import { createElement, useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { createPhiRuntimeControllerClient } from "../../../../components/runtime/runtime-controller-client-factory";
 import { usePhiSignalDispatcher, usePhiSignalListener } from "../../../../components/runtime/runtime-signal-bus";
 import { PHI_SIGNAL_VALUE_SCHEMAS } from "../../../../types/signals";
-import { createPhiSignalAddress, createPhiSignalSubcontrolAddress } from "../../../../types/signals";
 import { readPhiTableQuery } from "../../../../types/table-widget";
 import { readPhiTableActionSignalValue } from "../../../../types/table-signal-values";
 import { readPhiOverlayCloseRequest } from "../../../../types/cms-overlay";
-import { PHI_EDITOR_TRANSLATION_FORM_WIDGET_ID, PHI_EDITOR_TRANSLATION_COMMANDS_WIDGET_ID, PHI_EDITOR_TRANSLATION_OVERLAY_ID, PHI_EDITOR_TRANSLATIONS_SOURCE_LOCALE_WIDGET_ID, PHI_EDITOR_TRANSLATIONS_WIDGET_ID, } from "../trees/editor-translations-shell";
+import { dispatchPhiSignalCapability } from "../../../../components/runtime/runtime-signal-identity";
 import { PHI_LOCALIZATION_RUNTIME_CONTROLLER_DEFINITION, } from "../controller/definition";
-function PhiLocalizationControllerMount({ address }) {
+function PhiLocalizationControllerMount({ address, config, }) {
     const dispatchSignal = usePhiSignalDispatcher();
     const filtersRef = useRef({ locale: "", context: "", status: "all" });
     const [pendingEdit, setPendingEdit] = useState(null);
     const submittingRef = useRef(false);
     const deliveredEditRef = useRef(null);
-    const formAddress = createPhiSignalAddress("cms", PHI_EDITOR_TRANSLATION_FORM_WIDGET_ID);
-    const overlayAddress = createPhiSignalAddress("cms", PHI_EDITOR_TRANSLATION_OVERLAY_ID);
-    const tableAddress = createPhiSignalAddress("cms", PHI_EDITOR_TRANSLATIONS_WIDGET_ID);
-    const sourceLocaleAddress = createPhiSignalAddress("cms", PHI_EDITOR_TRANSLATIONS_SOURCE_LOCALE_WIDGET_ID);
-    const saveActionAddress = createPhiSignalSubcontrolAddress("cms", PHI_EDITOR_TRANSLATION_COMMANDS_WIDGET_ID, "save");
-    const send = useCallback((input) => dispatchSignal({
-        scope: "page",
-        sender: address,
-        receiver: input.receiver,
-        channel: input.channel,
-        action: input.action,
-        value: input.value,
-        valueType: input.valueType,
-        valueSchema: input.valueSchema ?? null,
-        correlationId: input.correlationId,
-        timestamp: Date.now(),
-    }), [address, dispatchSignal]);
+    const emitRoutes = useMemo(() => config.signalRoutes?.emits ?? [], [config.signalRoutes?.emits]);
+    /* One declared output, delivered through every route the Page wrote for it. */
+    const emitCapability = useCallback((capabilityId, value, correlationId) => dispatchPhiSignalCapability(dispatchSignal, address, emitRoutes, capabilityId, value, correlationId), [address, dispatchSignal, emitRoutes]);
     const closeEditor = useCallback((correlationId) => {
-        send({ receiver: overlayAddress, channel: "dialog", action: "close", value: null, valueType: "none", correlationId });
-    }, [overlayAddress, send]);
+        emitCapability("dialogClose", null, correlationId);
+    }, [emitCapability]);
     usePhiSignalListener(useCallback((signal) => {
+        if (signal.receiver !== address)
+            return;
         if (signal.channel === "localizationWorkspace" &&
             signal.action === "change" &&
             signal.valueSchema === PHI_SIGNAL_VALUE_SCHEMAS.localizationWorkspace &&
-            signal.value && typeof signal.value === "object" && !Array.isArray(signal.value)) {
+            isPhiRecord(signal.value)) {
             const value = signal.value;
-            const query = value.query && typeof value.query === "object" && !Array.isArray(value.query)
+            const query = isPhiRecord(value.query)
                 ? value.query
                 : {};
             filtersRef.current = {
@@ -49,36 +37,11 @@ function PhiLocalizationControllerMount({ address }) {
                 context: typeof query.context === "string" ? query.context : filtersRef.current.context,
                 status: typeof query.status === "string" ? query.status : filtersRef.current.status,
             };
-            if (typeof value.sourceLocale === "string" && value.sourceLocale) {
-                dispatchSignal({
-                    scope: "area",
-                    channel: "text",
-                    action: "change",
-                    value: value.sourceLocale,
-                    valueType: "string",
-                    sender: address,
-                    receiver: sourceLocaleAddress,
-                    correlationId: signal.correlationId,
-                    timestamp: Date.now(),
-                });
-            }
             if (filtersRef.current.locale) {
-                dispatchSignal({
-                    scope: "area",
-                    channel: "targetLocaleSelection",
-                    action: "change",
-                    value: filtersRef.current.locale,
-                    valueType: "string",
-                    sender: address,
-                    receiver: "broadcast",
-                    correlationId: signal.correlationId,
-                    timestamp: Date.now(),
-                });
+                emitCapability("targetSelection", filtersRef.current.locale, signal.correlationId);
             }
             return;
         }
-        if (signal.receiver !== address)
-            return;
         if (signal.channel === "query" && signal.action === "change") {
             const query = readPhiTableQuery(signal.value);
             if (!query)
@@ -91,11 +54,7 @@ function PhiLocalizationControllerMount({ address }) {
                 status: typeof filters.status === "string" ? filters.status : filtersRef.current.status,
             };
             if (previousContext !== filtersRef.current.context) {
-                dispatchSignal({
-                    scope: "area", channel: "contextSelection", action: "change",
-                    value: filtersRef.current.context || "all", valueType: "string", sender: address,
-                    receiver: "broadcast", correlationId: signal.correlationId, timestamp: Date.now(),
-                });
+                emitCapability("contextSelection", filtersRef.current.context || "all", signal.correlationId);
             }
             return;
         }
@@ -105,16 +64,16 @@ function PhiLocalizationControllerMount({ address }) {
                 return;
             deliveredEditRef.current = null;
             setPendingEdit({ value: action, correlationId: signal.correlationId });
-            send({ receiver: overlayAddress, channel: "dialog", action: "activate", value: null, valueType: "none", correlationId: signal.correlationId });
+            emitCapability("dialogOpen", null, signal.correlationId);
             return;
         }
         if (signal.channel === "command" && signal.action === "activate" && (signal.value === "save" || signal.value === "cancel")) {
             if (signal.value === "save") {
                 if (!submittingRef.current)
-                    send({ receiver: formAddress, channel: "submit", action: "activate", value: null, valueType: "none", correlationId: signal.correlationId });
+                    emitCapability("formSubmit", null, signal.correlationId);
             }
             else if (!submittingRef.current) {
-                send({ receiver: formAddress, channel: "reset", action: "activate", value: null, valueType: "none", correlationId: signal.correlationId });
+                emitCapability("formReset", null, signal.correlationId);
                 closeEditor(signal.correlationId);
             }
             return;
@@ -122,19 +81,19 @@ function PhiLocalizationControllerMount({ address }) {
         if (signal.channel === "dialog" && signal.action === "close") {
             const request = readPhiOverlayCloseRequest(signal.value);
             if (request && !submittingRef.current) {
-                send({ receiver: formAddress, channel: "reset", action: "activate", value: null, valueType: "none", correlationId: signal.correlationId });
+                emitCapability("formReset", null, signal.correlationId);
                 closeEditor(signal.correlationId);
             }
             return;
         }
         if (signal.channel === "submitting" && signal.action === "change" && typeof signal.value === "boolean") {
             submittingRef.current = signal.value;
-            send({ receiver: saveActionAddress, channel: "submitting", action: "change", value: signal.value, valueType: "boolean", correlationId: signal.correlationId });
+            emitCapability("saveSubmitting", signal.value, signal.correlationId);
             return;
         }
-        if (signal.channel === "submit" && signal.action === "activate" && signal.sender === formAddress) {
+        if (signal.channel === "submit" && signal.action === "activate") {
             closeEditor(signal.correlationId);
-            send({ receiver: tableAddress, channel: "reload", action: "activate", value: null, valueType: "none", correlationId: signal.correlationId });
+            emitCapability("reload", null, signal.correlationId);
             return;
         }
         if (signal.channel === "state" && signal.action === "change" && signal.value === false) {
@@ -159,71 +118,20 @@ function PhiLocalizationControllerMount({ address }) {
             (signal.channel === "command" && signal.action === "activate" && signal.value === "reset")) {
             next.context = "";
             next.status = "all";
-            dispatchSignal({
-                scope: "page",
-                channel: "search",
-                action: "clear",
-                value: null,
-                valueType: "none",
-                sender: address,
-                receiver: "broadcast",
-                correlationId: signal.correlationId,
-                timestamp: Date.now(),
-            });
-            dispatchSignal({
-                scope: "area",
-                channel: "contextSelection",
-                action: "change",
-                value: "all",
-                valueType: "string",
-                sender: address,
-                receiver: "broadcast",
-                correlationId: signal.correlationId,
-                timestamp: Date.now(),
-            });
-            dispatchSignal({
-                scope: "area",
-                channel: "statusSelection",
-                action: "change",
-                value: "all",
-                valueType: "string",
-                sender: address,
-                receiver: "broadcast",
-                correlationId: signal.correlationId,
-                timestamp: Date.now(),
-            });
+            emitCapability("searchClear", null, signal.correlationId);
+            emitCapability("contextSelection", "all", signal.correlationId);
+            emitCapability("statusSelection", "all", signal.correlationId);
         }
         else if (signal.channel === "command" && signal.action === "activate" && signal.value === "reload") {
-            dispatchSignal({
-                scope: "page",
-                channel: "reload",
-                action: "activate",
-                value: null,
-                valueType: "none",
-                sender: address,
-                receiver: "broadcast",
-                correlationId: signal.correlationId,
-                timestamp: Date.now(),
-            });
+            emitCapability("reload", null, signal.correlationId);
             return;
         }
         else {
             return;
         }
         filtersRef.current = next;
-        dispatchSignal({
-            scope: "page",
-            channel: "filters",
-            action: "change",
-            value: next,
-            valueType: "json",
-            valueSchema: PHI_SIGNAL_VALUE_SCHEMAS.tableFilters,
-            sender: address,
-            receiver: "broadcast",
-            correlationId: signal.correlationId,
-            timestamp: Date.now(),
-        });
-    }, [address, closeEditor, dispatchSignal, formAddress, overlayAddress, saveActionAddress, send, sourceLocaleAddress, tableAddress]), {
+        emitCapability("filters", next, signal.correlationId);
+    }, [address, closeEditor, emitCapability]), {
         scopes: ["page", "area"],
         channels: ["locale", "context", "status", "query", "command", "localizationWorkspace", "action", "dialog", "submitting", "submit", "state"],
     }, 
@@ -236,20 +144,12 @@ function PhiLocalizationControllerMount({ address }) {
         if (deliveredEditRef.current === deliveryKey)
             return;
         deliveredEditRef.current = deliveryKey;
-        send({
-            receiver: formAddress,
-            channel: "action",
-            action: "activate",
-            value: pendingEdit.value,
-            valueType: "json",
-            valueSchema: PHI_SIGNAL_VALUE_SCHEMAS.tableAction,
-            correlationId: pendingEdit.correlationId,
-        });
-    }, [formAddress, pendingEdit, send]);
+        emitCapability("recordOpen", pendingEdit.value, pendingEdit.correlationId);
+    }, [emitCapability, pendingEdit]);
     return null;
 }
 export const PHI_LOCALIZATION_RUNTIME_CONTROLLER_PLUGIN = {
     ...PHI_LOCALIZATION_RUNTIME_CONTROLLER_DEFINITION,
-    renderController: ({ address }) => createElement(PhiLocalizationControllerMount, { address }),
+    renderController: ({ address, config }) => createElement(PhiLocalizationControllerMount, { address, config }),
 };
 export const PhiLocalizationRuntimeControllerClient = createPhiRuntimeControllerClient(PHI_LOCALIZATION_RUNTIME_CONTROLLER_PLUGIN);

package/plugins/runtime-modules/localization/controller/definition.d.ts

@@ -1,4 +1,12 @@
-export type PhiLocalizationControllerConfig = Record<string, never>;
+import { type PhiSignalRouteSet } from "../../../../types/signals";
+export type PhiLocalizationControllerConfig = {
+    /**
+     * Who this Controller speaks to, written by the Page that mounts it: the edit Overlay, its Form, the
+     * save button, the source-locale field and the Table. It used to name those Widgets itself, so the
+     * Page could not be rearranged without the Controller going quiet (SIGNALS.md, "Button address").
+     */
+    signalRoutes: PhiSignalRouteSet | null;
+};
 export declare const PHI_LOCALIZATION_RUNTIME_CONTROLLER_DEFINITION: {
     kind: "controller";
     pluginKey: string;
@@ -6,7 +14,7 @@ export declare const PHI_LOCALIZATION_RUNTIME_CONTROLLER_DEFINITION: {
     title: string;
     description: string;
     iconFamily: string;
-    allowedMountScopes: "area"[];
+    allowedMountScopes: "page"[];
     runtimeSignals: {
         emits: ({
             id: string;
@@ -38,6 +46,11 @@ export declare const PHI_LOCALIZATION_RUNTIME_CONTROLLER_DEFINITION: {
             action: "change";
             valueType: "string";
             valueSchema?: undefined;
+        } | {
+            id: string;
+            action: "change";
+            valueType: "boolean";
+            valueSchema?: undefined;
         })[];
         listens: ({
             id: string;
@@ -83,6 +96,8 @@ export declare const PHI_LOCALIZATION_RUNTIME_CONTROLLER_DEFINITION: {
             valueSchema: `${string}/signals/${string}`;
         })[];
     };
-    defaultConfig: {};
-    parseConfig: () => PhiLocalizationControllerConfig;
+    defaultConfig: {
+        signalRoutes: null;
+    };
+    parseConfig: (raw: Record<string, unknown>) => PhiLocalizationControllerConfig;
 };

package/plugins/runtime-modules/localization/controller/definition.js

@@ -1,4 +1,4 @@
-import { PHI_SIGNAL_VALUE_SCHEMAS } from "../../../../types/signals";
+import { PHI_SIGNAL_VALUE_SCHEMAS, readPhiSignalRouteSet, } from "../../../../types/signals";
 import { PHI_LOCALIZATION_CONTROLLER_KEY, PHI_LOCALIZATION_CONTROLLER_PLUGIN_KEY } from "../controller/address";
 export const PHI_LOCALIZATION_RUNTIME_CONTROLLER_DEFINITION = {
     kind: "controller",
@@ -7,7 +7,7 @@ export const PHI_LOCALIZATION_RUNTIME_CONTROLLER_DEFINITION = {
     title: "Localization Controller",
     description: "Module owner for locale and translation administration.",
     iconFamily: "localization",
-    allowedMountScopes: ["area"],
+    allowedMountScopes: ["page"],
     runtimeSignals: {
         emits: [
             {
@@ -32,6 +32,7 @@ export const PHI_LOCALIZATION_RUNTIME_CONTROLLER_DEFINITION = {
             { id: "targetSelection", action: "change", valueType: "string" },
             { id: "contextSelection", action: "change", valueType: "string" },
             { id: "statusSelection", action: "change", valueType: "string" },
+            { id: "saveSubmitting", action: "change", valueType: "boolean" },
         ],
         listens: [
             { id: "locale", channel: "locale", action: "change", valueType: "string" },
@@ -75,6 +76,8 @@ export const PHI_LOCALIZATION_RUNTIME_CONTROLLER_DEFINITION = {
             },
         ],
     },
-    defaultConfig: {},
-    parseConfig: () => ({}),
+    defaultConfig: { signalRoutes: null },
+    parseConfig: (raw) => ({
+        signalRoutes: readPhiSignalRouteSet(raw.signalRoutes),
+    }),
 };

package/plugins/runtime-modules/localization/data-providers.js

@@ -146,7 +146,7 @@ export const PHI_LOCALIZATION_RUNTIME_DATA_PROVIDER_DESCRIPTORS = [
                     filterFields: ["locale", "context", "status"],
                     sorting: "none",
                     pagination: "offset",
-                    facets: ["sourceLocale", "selectedLocale", "availableLocales", "contexts"],
+                    facets: ["selectedLocale", "availableLocales", "contexts"],
                 },
                 recordRead: true,
                 actions: [

package/plugins/runtime-modules/localization/definition.d.ts

@@ -1,5 +1,4 @@
 export declare const PHI_LOCALIZATION_RUNTIME_MODULE_DEFINITION: {
-    moduleId: "@phis/ui/modules/localization";
     kind: "module";
     eligibleAreas: readonly ["admin", "editor"];
     serverBinding: import("../../../types").PhiRuntimeModuleServerBinding;
@@ -9,7 +8,7 @@ export declare const PHI_LOCALIZATION_RUNTIME_MODULE_DEFINITION: {
     description: string;
     category: "foundation";
     iconFamily: string;
-    controllerMountPolicy: "area";
+    controllerMountPolicy: "demand";
     formProviders: {
         handlers: {
             key: `${string}/${string}`;
@@ -277,4 +276,5 @@ export declare const PHI_LOCALIZATION_RUNTIME_MODULE_DEFINITION: {
             summaryFields?: undefined;
         })[];
     })[];
+    moduleId: "@phis/ui/modules/localization";
 };

package/plugins/runtime-modules/localization/definition.js

@@ -1,12 +1,12 @@
 import { PHI_LOCALIZATION_RUNTIME_CONTROLLER_DEFINITION } from "../../../plugins/runtime-modules/localization/controller/definition";
 import { PHI_LOCALIZATION_CONTROLLER_TYPE } from "../../../plugins/runtime-modules/localization/controller/address";
 import { buildPhiRuntimeModuleControllerDescriptor } from "../contracts";
-import { PHI_LOCALIZATION_RUNTIME_MODULE_ID } from "./ids";
+import { PHI_LOCALIZATION_RUNTIME_MODULE_IDENTITY } from "./ids";
 import { PHI_LOCALIZATION_FORM_HANDLER_PROVIDER_DESCRIPTORS } from "../../../plugins/runtime-modules/localization/forms";
 import { PHI_CORE_SERVER_BINDING } from "../../../types/server-capabilities";
 import { PHI_LOCALIZATION_RUNTIME_DATA_PROVIDER_DESCRIPTORS } from "./data-providers";
 export const PHI_LOCALIZATION_RUNTIME_MODULE_DEFINITION = {
-    moduleId: PHI_LOCALIZATION_RUNTIME_MODULE_ID,
+    ...PHI_LOCALIZATION_RUNTIME_MODULE_IDENTITY,
     kind: "module",
     eligibleAreas: ["admin", "editor"],
     serverBinding: PHI_CORE_SERVER_BINDING,
@@ -16,7 +16,7 @@ export const PHI_LOCALIZATION_RUNTIME_MODULE_DEFINITION = {
     description: "Locale and translation administration.",
     category: "foundation",
     iconFamily: "localization",
-    controllerMountPolicy: "area",
+    controllerMountPolicy: "demand",
     formProviders: { handlers: PHI_LOCALIZATION_FORM_HANDLER_PROVIDER_DESCRIPTORS },
     dataProviders: PHI_LOCALIZATION_RUNTIME_DATA_PROVIDER_DESCRIPTORS,
 };

package/plugins/runtime-modules/localization/forms.d.ts

@@ -2,10 +2,6 @@ export declare const PHI_LOCALIZATION_FORM_IDS: {
     readonly siteLocales: `${string}/forms/${string}`;
     readonly editorTranslation: `${string}/forms/${string}`;
 };
-export declare const PHI_LOCALIZATION_FORM_HANDLER_KEYS: {
-    readonly siteLocales: "localization.site-locales";
-    readonly editorTranslation: "localization.editor-translation";
-};
 export declare const PHI_LOCALIZATION_RUNTIME_MODULE_FORMS: readonly [import("../contracts").PhiRuntimeModuleFormDefinition, import("../contracts").PhiRuntimeModuleFormDefinition];
 export declare const PHI_LOCALIZATION_FORM_HANDLER_PROVIDER_DESCRIPTORS: {
     key: `${string}/${string}`;

package/plugins/runtime-modules/localization/forms.js

@@ -1,16 +1,15 @@
+import { createPhiFormLabelSetLoader } from "../../../components/forms/shared-form-loaders";
 import { definePhiRuntimeModuleForm } from "../../../components/forms/form-registry";
-import { flattenPhiFormLabels } from "../../../components/forms/form-labels";
 import { PHI_FORM_FIELD_PROVIDER_KEYS, PHI_FORM_VALIDATION_PROVIDER_KEYS, createPhiSharedFormProviderKey, } from "../../../components/forms/form-provider-contract";
 import { createPhiFormId } from "../../../types/form-id";
 import { PHI_LOCALIZATION_RUNTIME_MODULE_ID } from "../../../plugins/runtime-modules/localization/ids";
 import { PHI_SHARED_PACKAGE_NAME } from "../../../types/signals";
 import { PHI_LOCALIZATION_RUNTIME_DATA_PROVIDER_KEYS } from "./ids";
-import { readPhiServerApiCredentials } from "../../../helpers/phis-server-credentials";
 export const PHI_LOCALIZATION_FORM_IDS = {
     siteLocales: createPhiFormId(PHI_SHARED_PACKAGE_NAME, "localization/site-locales"),
     editorTranslation: createPhiFormId(PHI_SHARED_PACKAGE_NAME, "localization/editor-translation"),
 };
-export const PHI_LOCALIZATION_FORM_HANDLER_KEYS = {
+const PHI_LOCALIZATION_FORM_HANDLER_KEYS = {
     siteLocales: "localization.site-locales",
     editorTranslation: "localization.editor-translation",
 };
@@ -38,7 +37,7 @@ const translationFields = [
         fieldProviderKey: PHI_FORM_FIELD_PROVIDER_KEYS.textarea,
         label: label("translationLabel", "Translation"),
         placeholder: label("translationPlaceholder", "Enter translation"),
-        validation: required("saveError", "A translation is required."),
+        validation: required("translationRequired", "A translation is required."),
         config: { rows: 6 },
     },
 ];
@@ -50,43 +49,31 @@ function translationDescriptor(formId) {
         fields: translationFields,
     };
 }
-async function loadAdminLabels(context) {
-    const { getPhiAdminLocalesWidgetLabels } = await import("../../../components/widgets/label-sets/admin-locales");
-    const labels = await getPhiAdminLocalesWidgetLabels({
-        apiBaseUrl: readPhiServerApiCredentials().apiBaseUrl,
-        internalToken: readPhiServerApiCredentials().internalToken,
-        locale: context.runtime.locale.current,
-    });
-    return flattenPhiFormLabels({
-        defaultLocaleLabel: labels.defaultLocaleLabel,
-        availableLocalesLabel: labels.availableLocalesLabel,
-        actions: { submitLabel: labels.saveLocalesLabel },
-        searchLabel: labels.searchPlaceholder,
-        searchPlaceholder: labels.searchPlaceholder,
-        languageLabel: labels.languageLabel,
-        applyLabel: "Apply",
-        resetLabel: labels.resetLabel,
-        reloadLabel: labels.refreshLabel,
-        translationLabel: labels.edit.translationLabel,
-        translationPlaceholder: labels.edit.translationLabel,
-        saveError: labels.errors.save,
-    });
-}
-async function loadEditorLabels(context) {
-    const { getPhiEditorTranslationsWidgetLabels } = await import("./trees/editor-translations-widget-label-set");
-    const labels = await getPhiEditorTranslationsWidgetLabels({
-        apiBaseUrl: readPhiServerApiCredentials().apiBaseUrl,
-        internalToken: readPhiServerApiCredentials().internalToken,
-        locale: context.runtime.locale.current,
-    });
-    return flattenPhiFormLabels({
-        saveLabel: labels.actions.save,
-        savingLabel: labels.actions.save,
-        translationLabel: labels.columns.translation,
-        translationPlaceholder: labels.translationPlaceholder,
-        saveError: labels.errors.save,
-    });
-}
+const loadAdminLabels = createPhiFormLabelSetLoader(() => import("../../../components/widgets/label-sets/admin-locales").then((module) => module.getPhiAdminLocalesWidgetLabels), (labels) => ({
+    defaultLocaleLabel: labels.defaultLocaleLabel,
+    availableLocalesLabel: labels.availableLocalesLabel,
+    actions: { submitLabel: labels.saveLocalesLabel },
+    searchLabel: labels.searchPlaceholder,
+    searchPlaceholder: labels.searchPlaceholder,
+    languageLabel: labels.languageLabel,
+    applyLabel: labels.applyLabel,
+    resetLabel: labels.resetLabel,
+    reloadLabel: labels.refreshLabel,
+    translationLabel: labels.edit.translationLabel,
+    translationPlaceholder: labels.edit.translationLabel,
+    saveError: labels.errors.save,
+    translationRequired: labels.errors.requiredTranslation,
+    availableLocalesRequired: labels.errors.requiredAvailableLocales,
+    defaultLocaleRequired: labels.errors.requiredDefaultLocale,
+}));
+const loadEditorLabels = createPhiFormLabelSetLoader(() => import("./trees/editor-translations-widget-label-set").then((module) => module.getPhiEditorTranslationsWidgetLabels), (labels) => ({
+    saveLabel: labels.actions.save,
+    savingLabel: labels.actions.saving,
+    translationLabel: labels.columns.translation,
+    translationPlaceholder: labels.translationPlaceholder,
+    saveError: labels.errors.save,
+    translationRequired: labels.errors.requiredTranslation,
+}));
 export const PHI_LOCALIZATION_RUNTIME_MODULE_FORMS = [
     definePhiRuntimeModuleForm({
         ownerModuleId: PHI_LOCALIZATION_RUNTIME_MODULE_ID,
@@ -109,14 +96,18 @@ export const PHI_LOCALIZATION_RUNTIME_MODULE_FORMS = [
                     fieldProviderKey: PHI_FORM_FIELD_PROVIDER_KEYS.multiSelect,
                     label: label("availableLocalesLabel", "Available languages"),
                     optionsProvider: { providerKey: PHI_LOCALIZATION_RUNTIME_DATA_PROVIDER_KEYS.platformLocales },
-                    validation: required("saveError", "Select at least one language."),
+                    validation: required("availableLocalesRequired", "Select at least one language."),
                 },
                 {
                     key: "defaultLocale",
                     fieldProviderKey: PHI_FORM_FIELD_PROVIDER_KEYS.select,
                     label: label("defaultLocaleLabel", "Default language"),
-                    optionsProvider: { providerKey: PHI_LOCALIZATION_RUNTIME_DATA_PROVIDER_KEYS.platformLocales },
-                    validation: required("saveError", "Select a default language."),
+                    // The default is one of the languages chosen above, not any the platform knows.
+                    optionsProvider: {
+                        providerKey: PHI_LOCALIZATION_RUNTIME_DATA_PROVIDER_KEYS.platformLocales,
+                        dependencies: [{ param: "availableLocales", source: "form", valuePath: "availableLocales" }],
+                    },
+                    validation: required("defaultLocaleRequired", "Select a default language."),
                 },
             ],
         },

package/plugins/runtime-modules/localization/ids.d.ts

@@ -1,4 +1,13 @@
 export declare const PHI_LOCALIZATION_RUNTIME_MODULE_ID: "@phis/ui/modules/localization";
+/**
+ * The Module's identity as its Label Sets inherit it (`definePhiRuntimeModuleLabelSet`): the id and,
+ * where a Module declares one, its source locale. Stated here beside the id and spread into the
+ * definition, so a Label Set a tree or a form reads does not import the definition that imports the
+ * tree -- and a Module that writes in another language says so once.
+ */
+export declare const PHI_LOCALIZATION_RUNTIME_MODULE_IDENTITY: {
+    readonly moduleId: "@phis/ui/modules/localization";
+};
 export declare const PHI_LOCALIZATION_RUNTIME_DATA_PROVIDER_KEYS: {
     readonly table: `${string}/${string}`;
     readonly platformLocales: `${string}/${string}`;

package/plugins/runtime-modules/localization/ids.js

@@ -1,6 +1,15 @@
 import { PHI_SHARED_PACKAGE_NAME } from "../../../types/signals";
 import { createPhiSharedRuntimeDataProviderKey } from "../../../constants/runtime-data-provider-key";
 export const PHI_LOCALIZATION_RUNTIME_MODULE_ID = `${PHI_SHARED_PACKAGE_NAME}/modules/localization`;
+/**
+ * The Module's identity as its Label Sets inherit it (`definePhiRuntimeModuleLabelSet`): the id and,
+ * where a Module declares one, its source locale. Stated here beside the id and spread into the
+ * definition, so a Label Set a tree or a form reads does not import the definition that imports the
+ * tree -- and a Module that writes in another language says so once.
+ */
+export const PHI_LOCALIZATION_RUNTIME_MODULE_IDENTITY = {
+    moduleId: PHI_LOCALIZATION_RUNTIME_MODULE_ID,
+};
 export const PHI_LOCALIZATION_RUNTIME_DATA_PROVIDER_KEYS = {
     table: createPhiSharedRuntimeDataProviderKey("tables", "localization"),
     platformLocales: createPhiSharedRuntimeDataProviderKey("options", "localization-locales"),

package/plugins/runtime-modules/localization/presets.d.ts

@@ -1,2 +1,46 @@
 import type { PhiCmsRoutePresetDescriptor } from "../../../types/cms-module-descriptors";
-export declare const PHI_LOCALIZATION_RUNTIME_MODULE_ROUTES: PhiCmsRoutePresetDescriptor[];
+export declare const PHI_LOCALIZATION_RUNTIME_MODULE_ROUTES: (PhiCmsRoutePresetDescriptor | {
+    tour: {
+        readonly id: "@phis/ui/modules/localization/editor-translations";
+        readonly version: 1;
+        readonly steps: readonly [{
+            readonly key: "source-language";
+            readonly target: `cms:${import("@phis/contracts/cms").PhiCmsInstanceId}`;
+            readonly title: "The language the Site is written in";
+            readonly description: "Every text of the Site is written in this language and translated from it. It is chosen when the Site is created and does not change.";
+            readonly placement: "bottom";
+        }, {
+            readonly key: "texts";
+            readonly target: `cms:${import("@phis/contracts/cms").PhiCmsInstanceId}:header`;
+            readonly title: "Each text and its translation";
+            readonly description: "One row per text of the Site -- a Page's words, a menu entry, an entry's title: the text as written, where it is used, and its translation in the chosen language. Missing means it has none in that language yet.";
+            readonly placement: "bottom";
+        }, {
+            readonly key: "filters";
+            readonly target: `cms:${import("@phis/contracts/cms").PhiCmsInstanceId}:filters`;
+            readonly title: "Finding what to check";
+            readonly description: "Pick the language, narrow to one context -- where a text is used -- or show only what is missing. Search looks through the text, its context and its translation.";
+            readonly placement: "bottom";
+            readonly ifMissing: "skip";
+        }, {
+            readonly key: "correcting";
+            readonly target: `cms:${import("@phis/contracts/cms").PhiCmsInstanceId}:row-actions`;
+            readonly title: "Correcting a translation";
+            readonly description: "Edit opens one translation; what you save is shown from then on. Delete removes it, and the text is translated anew the next time a Page needs it.";
+            readonly placement: "left";
+        }];
+    };
+    ownerModuleId: import("../contracts").PhiRuntimeModuleId;
+    presetKey: string;
+    presetVersion: number;
+    area: import("@phis/contracts/cms").PhiCmsAreaKey;
+    path: string;
+    landingPage?: true;
+    title: string;
+    defaultPageFlags?: number;
+    loadTree: (context: import("../../../types").PhiCmsDescriptorBuildContext & {
+        activeModuleIds: ReadonlySet<import("../contracts").PhiRuntimeModuleId>;
+        params: Readonly<Record<string, string>>;
+    }) => import("../../../types").PhiResolvedCmsPageTree | Promise<import("../../../types").PhiResolvedCmsPageTree>;
+    navigation?: readonly import("../../../types").PhiCmsNavigationInjectionDescriptor[];
+})[];