@nocobase/cli 2.1.0-alpha.21 → 2.1.0-alpha.23

package/dist/lib/prompt-validators.js

@@ -8,6 +8,7 @@
  */
 import { spawn } from 'node:child_process';
 import net from 'node:net';
+import { translateCli } from "./cli-locale.js";
 const API_BASE_URL_EXAMPLE = 'http://localhost:13000/api';
 const ENV_KEY_PATTERN = /^[A-Za-z0-9]+$/;
 const TCP_PORT_EXAMPLE = '13000';
@@ -21,10 +22,10 @@ export function validateApiBaseUrl(value) {
         url = new URL(raw);
     }
     catch {
-        return `Enter a valid URL, for example ${API_BASE_URL_EXAMPLE}.`;
+        return translateCli('validators.apiBaseUrl.invalid', { example: API_BASE_URL_EXAMPLE });
     }
     if (url.protocol !== 'http:' && url.protocol !== 'https:') {
-        return `URL must start with http:// or https://, for example ${API_BASE_URL_EXAMPLE}.`;
+        return translateCli('validators.apiBaseUrl.invalidProtocol', { example: API_BASE_URL_EXAMPLE });
     }
     return undefined;
 }
@@ -34,7 +35,7 @@ export function validateEnvKey(value) {
         return undefined;
     }
     if (!ENV_KEY_PATTERN.test(raw)) {
-        return 'Use letters and numbers only.';
+        return translateCli('validators.envKey.invalid');
     }
     return undefined;
 }
@@ -59,7 +60,7 @@ export function validateTcpPort(value) {
     }
     const port = parseTcpPort(raw);
     if (port === undefined) {
-        return `Enter a valid TCP port between 1 and 65535, for example ${TCP_PORT_EXAMPLE}.`;
+        return translateCli('validators.tcpPort.invalid', { example: TCP_PORT_EXAMPLE });
     }
     return undefined;
 }
@@ -138,7 +139,7 @@ async function allocateAvailableTcpPort() {
                 : undefined;
             if (!port) {
                 server.close(() => {
-                    reject(new Error('Failed to allocate an available TCP port.'));
+                    reject(new Error(translateCli('validators.tcpPort.allocateFailed')));
                 });
                 return;
             }
@@ -160,7 +161,7 @@ export async function findAvailableTcpPort() {
             return candidate;
         }
     }
-    throw new Error('Failed to allocate an available TCP port that is not already published by Docker.');
+    throw new Error(translateCli('validators.tcpPort.allocateNotDockerPublished'));
 }
 export async function validateAvailableTcpPort(value) {
     const raw = String(value ?? '').trim();
@@ -174,11 +175,11 @@ export async function validateAvailableTcpPort(value) {
     const port = parseTcpPort(raw);
     const available = await canListenOnTcpPort(port);
     if (!available) {
-        return `Port ${port} is already in use. Choose another port.`;
+        return translateCli('validators.tcpPort.alreadyInUse', { port });
     }
     const dockerPorts = await getDockerPublishedTcpPorts();
     if (dockerPorts.has(port)) {
-        return `Port ${port} is already in use by a Docker container. Choose another port.`;
+        return translateCli('validators.tcpPort.alreadyInUseByDocker', { port });
     }
     return undefined;
 }

package/dist/lib/prompt-web-ui.js

@@ -8,7 +8,8 @@
  */
 import { spawn } from 'node:child_process';
 import { createServer } from 'node:http';
-import { isPromptBlockSkipped, runPromptFieldValidate, selectOptionValues, } from "./prompt-catalog.js";
+import { createCliTranslate, resolveCliLocale, resolveLocalizedText, } from "./cli-locale.js";
+import { isPromptBlockSkipped, runPromptFieldValidate, } from "./prompt-catalog.js";
 const DEFAULT_SUBMIT = '/__pwc_ui_submit';
 const DEFAULT_REFLOW = '/__pwc_ui_reflow';
 const DEFAULT_VALIDATE_STEP = '/__pwc_ui_validate_step';
@@ -19,6 +20,9 @@ export const PWC_FORM_META_STEP = '_pwcStep';
 export const PWC_FORM_META_FIELD = '_pwcField';
 const DEFAULT_TIMEOUT_MS = 30 * 60 * 1000;
 const DEFAULT_HOST = '127.0.0.1';
+function resolveUiText(text, locale, fallback = '') {
+    return resolveLocalizedText(text, { locale, fallback });
+}
 function hasValueKey(iv, key) {
     return (Object.prototype.hasOwnProperty.call(iv, key) && iv[key] !== undefined && iv[key] !== null);
 }
@@ -72,12 +76,17 @@ function defaultValueForInput(key, def, out) {
         case 'boolean':
             return def.initialValue !== undefined ? Boolean(def.initialValue) : true;
         case 'select': {
-            const first = selectOptionValues(def.options)[0];
+            const first = def.options
+                .find((o) => typeof o === 'string' || o.disabled !== true);
+            const firstValue = typeof first === 'string' ? first : first?.value;
             const i = def.initialValue;
-            if (i !== undefined && selectOptionValues(def.options).includes(i)) {
+            const enabledValues = def.options
+                .filter((o) => typeof o === 'string' || o.disabled !== true)
+                .map((o) => (typeof o === 'string' ? o : o.value));
+            if (i !== undefined && enabledValues.includes(i)) {
                 return i;
             }
-            return first ?? '';
+            return firstValue ?? '';
         }
         case 'password':
             return def.initialValue ?? '';
@@ -143,7 +152,9 @@ function normalizeWebRawForBlock(def, raw, key) {
         }
         case 'select': {
             const s = String(raw ?? '');
-            const list = selectOptionValues(def.options);
+            const list = def.options
+                .filter((o) => typeof o === 'string' || o.disabled !== true)
+                .map((o) => (typeof o === 'string' ? o : o.value));
             if (list.includes(s)) {
                 return s;
             }
@@ -171,6 +182,8 @@ function normalizeWebRawForBlock(def, raw, key) {
  * Runs per-field **`validate`** (including async) from the catalog (honoring {@link BuildWebPresetFromBodyOptions}).
  */
 export async function buildWebPresetFromBody(catalog, raw, userSeed = {}, buildOpts = {}) {
+    const locale = resolveCliLocale(buildOpts.locale);
+    const t = createCliTranslate(locale);
     const scope = buildOpts.scopeKeys ?? null;
     const inScope = (k) => scope === null || scope.has(k);
     const preset = {};
@@ -198,18 +211,18 @@ export async function buildWebPresetFromBody(catalog, raw, userSeed = {}, buildO
             val = defaultValueForInput(key, def, preset);
         }
         if (def.type === 'text' && def.required && val === '' && inScope(key)) {
-            return { preset: {}, error: `Field "${key}" is required.`, fieldKey: key };
+            return { preset: {}, error: t('promptCatalog.web.fieldRequired', { key }), fieldKey: key };
         }
         if (def.type === 'password' && def.required && val === '' && inScope(key)) {
-            return { preset: {}, error: `Field "${key}" is required.`, fieldKey: key };
+            return { preset: {}, error: t('promptCatalog.web.fieldRequired', { key }), fieldKey: key };
         }
         if (def.type === 'integer' && def.required && inScope(key)) {
-            const t = String(raw[key] ?? '').trim();
-            if (t === '') {
-                return { preset: {}, error: `Field "${key}" is required.`, fieldKey: key };
+            const trimmed = String(raw[key] ?? '').trim();
+            if (trimmed === '') {
+                return { preset: {}, error: t('promptCatalog.web.fieldRequired', { key }), fieldKey: key };
             }
-            if (!/^-?\d+$/.test(t)) {
-                return { preset: {}, error: `Field "${key}" must be an integer.`, fieldKey: key };
+            if (!/^-?\d+$/.test(trimmed)) {
+                return { preset: {}, error: t('promptCatalog.web.fieldMustBeInteger', { key }), fieldKey: key };
             }
         }
         preset[key] = val;
@@ -229,7 +242,8 @@ function escapeHtml(s) {
         .replace(/"/g, '"')
         .replace(/'/g, ''');
 }
-function computePwcWizardSteps(options, merged) {
+function computePwcWizardSteps(options, merged, locale) {
+    const t = createCliTranslate(locale);
     if (options.stages && options.stages.length > 0) {
         if (options.stages.length === 1) {
             const st0 = options.stages[0];
@@ -239,12 +253,12 @@ function computePwcWizardSteps(options, merged) {
                     allKeys.push(key);
                 }
             }
-            const t = st0.sectionTitle?.trim();
-            const d = st0.sectionDescription?.trim();
+            const title = resolveUiText(st0.sectionTitle, locale).trim();
+            const description = resolveUiText(st0.sectionDescription, locale).trim();
             return [
                 {
-                    title: t && t.length > 0 ? t : 'Form',
-                    ...(d && d.length > 0 ? { description: d } : {}),
+                    title: title && title.length > 0 ? title : t('promptCatalog.web.defaultFormTitle'),
+                    ...(description && description.length > 0 ? { description } : {}),
                     keys: allKeys,
                 },
             ];
@@ -256,11 +270,11 @@ function computePwcWizardSteps(options, merged) {
                     keys.push(key);
                 }
             }
-            const t = st.sectionTitle?.trim();
-            const d = st.sectionDescription?.trim();
+            const title = resolveUiText(st.sectionTitle, locale).trim();
+            const description = resolveUiText(st.sectionDescription, locale).trim();
             return {
-                title: t && t.length > 0 ? t : `Step ${i + 1}`,
-                ...(d && d.length > 0 ? { description: d } : {}),
+                title: title && title.length > 0 ? title : t('promptCatalog.web.defaultStepTitle', { index: i + 1 }),
+                ...(description && description.length > 0 ? { description } : {}),
                 keys,
             };
         });
@@ -275,23 +289,31 @@ function computePwcWizardSteps(options, merged) {
         return [];
     }
     /* Single `catalog` (no `stages`): one page, no side Steps nav — use `stages` for multi-page UI. */
-    return [{ title: 'Form', keys: allKeys }];
+    return [{ title: t('promptCatalog.web.defaultFormTitle'), keys: allKeys }];
 }
 /** antd Form.Item-style explain line (per-field error / help). */
 const PWC_FORM_ITEM_EXPLAIN = '<div class="pwc-form-item-explain" data-pwc-explain="1" role="alert" hidden></div>';
 /** Suffix slot for status icon (e.g. fail) — filled by client script. */
 const PWC_FORM_ITEM_SUFFIX = '<span class="pwc-form-item-suffix" data-pwc-suffix="1" aria-hidden="true"></span>';
-function renderPwcRadioOptions(key, def, defaults, hidden) {
+function renderPwcRadioOptions(key, def, defaults, hidden, locale) {
     return def.options
         .map((o, index) => {
         const val = typeof o === 'string' ? o : o.value;
-        const lab = typeof o === 'string' ? o : o.label ?? o.value;
-        const hint = typeof o === 'string' ? '' : o.hint ? `<div class="pwc-radio-option-hint">${escapeHtml(o.hint)}</div>` : '';
+        const lab = typeof o === 'string' ? o : resolveUiText(o.label, locale, o.value);
+        const hint = typeof o === 'string'
+            ? ''
+            : o.hint
+                ? `<div class="pwc-radio-option-hint">${escapeHtml(resolveUiText(o.hint, locale))}</div>`
+                : '';
+        const optionDisabled = typeof o !== 'string' && o.disabled === true;
         const checked = String(defaults[key] ?? '') === val ? ' checked' : '';
         const required = def.required && index === 0 ? ' required' : '';
-        const disabled = hidden ? ' disabled' : '';
-        return (`<label class="pwc-radio-option">` +
-            `<input class="pwc-radio-input" name="${escapeHtml(key)}" type="radio" value="${escapeHtml(String(val))}"${checked}${required}${disabled} />` +
+        const disabled = hidden || optionDisabled ? ' disabled' : '';
+        const optionClass = optionDisabled ? 'pwc-radio-option pwc-radio-option--disabled' : 'pwc-radio-option';
+        const ariaDisabled = optionDisabled ? ' aria-disabled="true"' : '';
+        const staticDisabled = optionDisabled ? ' data-pwc-static-disabled="1"' : '';
+        return (`<label class="${optionClass}"${ariaDisabled}>` +
+            `<input class="pwc-radio-input" name="${escapeHtml(key)}" type="radio" value="${escapeHtml(String(val))}"${checked}${required}${disabled}${staticDisabled} />` +
             `<span class="pwc-radio-option-body">` +
             `<span class="pwc-radio-option-label">${escapeHtml(String(lab))}</span>` +
             hint +
@@ -300,18 +322,18 @@ function renderPwcRadioOptions(key, def, defaults, hidden) {
     })
         .join('');
 }
-function renderPwcFieldRow(key, def, defaults, show) {
+function renderPwcFieldRow(key, def, defaults, show, locale) {
     if (!isInputBlock(def)) {
         return '';
     }
-    const labelText = 'message' in def ? def.message : key;
+    const labelText = 'message' in def ? resolveUiText(def.message, locale, key) : key;
     const hidden = show[key] === false;
     const display = hidden ? 'none' : 'block';
     const itemOpen = (extraClass) => `<div class="pwc-form-item${extraClass ? ` ${extraClass}` : ''}" data-pwc-wrap="${escapeHtml(key)}" data-pwc-field="${escapeHtml(key)}" style="display:${display}">`;
     if (def.type === 'text') {
         const req = def.required ? ' required' : '';
         const disabled = hidden ? ' disabled' : '';
-        const ph = def.placeholder ? ` placeholder="${escapeHtml(def.placeholder)}"` : '';
+        const ph = def.placeholder ? ` placeholder="${escapeHtml(resolveUiText(def.placeholder, locale))}"` : '';
         const v = escapeHtml(String(defaults[key] ?? ''));
         return (itemOpen('') +
             `<div class="pwc-form-item-label"><span class="pwc-l">${escapeHtml(labelText)}</span></div>` +
@@ -334,7 +356,7 @@ function renderPwcFieldRow(key, def, defaults, show) {
     }
     if (def.type === 'select') {
         if (def.variant === 'radio') {
-            const opts = renderPwcRadioOptions(key, def, defaults, hidden);
+            const opts = renderPwcRadioOptions(key, def, defaults, hidden, locale);
             return (itemOpen('') +
                 `<div class="pwc-form-item-label"><span class="pwc-l">${escapeHtml(labelText)}</span></div>` +
                 `<div class="pwc-form-item-control">` +
@@ -348,9 +370,10 @@ function renderPwcFieldRow(key, def, defaults, show) {
         const opts = def.options
             .map((o) => {
             const val = typeof o === 'string' ? o : o.value;
-            const lab = typeof o === 'string' ? o : o.label ?? o.value;
+            const lab = typeof o === 'string' ? o : resolveUiText(o.label, locale, o.value);
             const sel = String(defaults[key] ?? '') === val ? ' selected' : '';
-            return `<option value="${escapeHtml(String(val))}"${sel}>${escapeHtml(String(lab))}</option>`;
+            const disabledOpt = typeof o !== 'string' && o.disabled === true ? ' disabled' : '';
+            return `<option value="${escapeHtml(String(val))}"${sel}${disabledOpt}>${escapeHtml(String(lab))}</option>`;
         })
             .join('');
         const req = def.required ? ' required' : '';
@@ -382,7 +405,7 @@ function renderPwcFieldRow(key, def, defaults, show) {
             `</div></div>`);
     }
     if (def.type === 'integer') {
-        const ph = def.placeholder ? ` placeholder="${escapeHtml(def.placeholder)}"` : '';
+        const ph = def.placeholder ? ` placeholder="${escapeHtml(resolveUiText(def.placeholder, locale))}"` : '';
         const req = def.required ? ' required' : '';
         const disabled = hidden ? ' disabled' : '';
         const v = String(defaults[key] ?? 0);
@@ -412,7 +435,7 @@ const PWC_FORM_FAIL_ICON_SVG = `<svg class="pwc-form-fail__svg" viewBox="0 0 14
  * with CSS aligned to antd tokens (icon 32px, 14px title, `colorSplit` rail, `wait` / `process` / `finish`).
  * Primary in steps uses antd default blue in light / `#1668dc` in dark; form primary buttons still use the page accent.
  */
-function buildPwcAntdStyleStepsHeader(stepDefs, currentIndex, total, visibleStepIndices) {
+function buildPwcAntdStyleStepsHeader(stepDefs, currentIndex, total, visibleStepIndices, uiText) {
     const parts = [];
     for (let i = 0; i < total; i += 1) {
         const st = i < stepDefs.length ? stepDefs[i] : { title: `Step ${i + 1}`, keys: [] };
@@ -427,7 +450,7 @@ function buildPwcAntdStyleStepsHeader(stepDefs, currentIndex, total, visibleStep
         const num = visiblePos + 1;
         const hiddenAttr = visiblePos === -1 ? ' hidden' : '';
         const iconHtml = state === 'finish'
-            ? `<span class="pwc-ad-icon pwc-ad-icon--finish" aria-label="done">${PWC_AD_CHECK_SVG}</span>`
+            ? `<span class="pwc-ad-icon pwc-ad-icon--finish" aria-label="${escapeHtml(uiText.doneAriaLabel)}">${PWC_AD_CHECK_SVG}</span>`
             : `<span class="pwc-ad-icon" aria-label="${num}"><span class="pwc-ad-icon-num">${num}</span></span>`;
         const ariaCurrent = state === 'process' ? 'step' : 'false';
         const nextVisible = visibleStepIndices.indexOf(i + 1) !== -1;
@@ -447,7 +470,7 @@ function buildPwcAntdStyleStepsHeader(stepDefs, currentIndex, total, visibleStep
             `</div>` +
             `</div></li>`);
     }
-    return (`<nav class="pwc-ad-steps pwc-ad-steps--vertical" id="pwcAntSteps" aria-label="Form steps" style="--pwc-ad-n:${total}">` +
+    return (`<nav class="pwc-ad-steps pwc-ad-steps--vertical" id="pwcAntSteps" aria-label="${escapeHtml(uiText.stepsAriaLabel)}" style="--pwc-ad-n:${total}">` +
         `<ol class="pwc-ad-steps-list pwc-ad-steps-list--vertical">${parts.join('')}</ol></nav>`);
 }
 function computeInitialVisibleStepIndices(catalog, stepDefs, show) {
@@ -467,7 +490,7 @@ function computeInitialVisibleStepIndices(catalog, stepDefs, show) {
     }
     return visible.length > 0 ? visible : [0];
 }
-function buildPwcFormHtml(catalog, defaults, show, stepDefs, initialStepIndex, totalSteps) {
+function buildPwcFormHtml(catalog, defaults, show, stepDefs, initialStepIndex, totalSteps, locale, uiText) {
     if (stepDefs.length === 0) {
         return '';
     }
@@ -476,8 +499,8 @@ function buildPwcFormHtml(catalog, defaults, show, stepDefs, initialStepIndex, t
     const out = [];
     if (!oneStep) {
         out.push('<div class="pwc-wizard pwc-wizard--with-sidebar" id="pwcWizard">');
-        out.push('<aside class="pwc-wizard-sidenav" id="pwcWizardSidenav" aria-label="Steps">');
-        out.push(buildPwcAntdStyleStepsHeader(stepDefs, initialStepIndex, totalSteps, visibleStepIndices));
+        out.push(`<aside class="pwc-wizard-sidenav" id="pwcWizardSidenav" aria-label="${escapeHtml(uiText.stepsSidebarAriaLabel)}">`);
+        out.push(buildPwcAntdStyleStepsHeader(stepDefs, initialStepIndex, totalSteps, visibleStepIndices, uiText));
         out.push('</aside><div class="pwc-wizard-main">');
     }
     else {
@@ -494,23 +517,23 @@ function buildPwcFormHtml(catalog, defaults, show, stepDefs, initialStepIndex, t
         for (const key of sd.keys) {
             const def = catalog[key];
             if (def) {
-                out.push(renderPwcFieldRow(key, def, defaults, show));
+                out.push(renderPwcFieldRow(key, def, defaults, show, locale));
             }
         }
         out.push('</section>');
     }
     if (!oneStep) {
-        out.push(`<div class="pwc-wizard-ctl" id="pwcWizardCtl" role="group" aria-label="Step navigation and submit">` +
-            `<button type="button" class="pwc-btn-pager" id="pwcBack" ${initialStepIndex === 0 ? 'hidden' : ''}>Back</button>` +
+        out.push(`<div class="pwc-wizard-ctl" id="pwcWizardCtl" role="group" aria-label="${escapeHtml(uiText.stepNavigationAriaLabel)}">` +
+            `<button type="button" class="pwc-btn-pager" id="pwcBack" ${initialStepIndex === 0 ? 'hidden' : ''}>${escapeHtml(uiText.back)}</button>` +
             `<div class="pwc-wizard-ctl-spacer" aria-hidden="true"></div>` +
-            `<button type="button" class="pwc-btn-pager pwc-btn-pager--primary" id="pwcNext" ${initialStepIndex >= totalSteps - 1 ? 'hidden' : ''}>Next</button>` +
-            `<button type="submit" class="pwc-btn-submit pwc-wizard-ctl__submit" id="pwcFormSubmit" ${initialStepIndex < totalSteps - 1 ? 'hidden' : ''}>Submit &amp; continue in terminal</button>` +
+            `<button type="button" class="pwc-btn-pager pwc-btn-pager--primary" id="pwcNext" ${initialStepIndex >= totalSteps - 1 ? 'hidden' : ''}>${escapeHtml(uiText.next)}</button>` +
+            `<button type="submit" class="pwc-btn-submit pwc-wizard-ctl__submit" id="pwcFormSubmit" ${initialStepIndex < totalSteps - 1 ? 'hidden' : ''}>${escapeHtml(uiText.submit)}</button>` +
             `</div>`);
     }
     else {
-        out.push(`<div class="pwc-wizard-ctl" id="pwcWizardCtl" role="group" aria-label="Submit">` +
+        out.push(`<div class="pwc-wizard-ctl" id="pwcWizardCtl" role="group" aria-label="${escapeHtml(uiText.submitAriaLabel)}">` +
             `<div class="pwc-wizard-ctl-spacer" aria-hidden="true"></div>` +
-            `<button type="submit" class="pwc-btn-submit pwc-wizard-ctl__submit" id="pwcFormSubmit">Submit &amp; continue in terminal</button>` +
+            `<button type="submit" class="pwc-btn-submit pwc-wizard-ctl__submit" id="pwcFormSubmit">${escapeHtml(uiText.submit)}</button>` +
             `</div>`);
     }
     /* Status / error Alert: under main form column only, not full-width under the side Steps. */
@@ -565,7 +588,7 @@ export function mergeWebUICatalogsFromStages(stages) {
     const sectionBeforeKey = new Map();
     const used = new Set();
     for (const stage of stages) {
-        const title = stage.sectionTitle?.trim();
+        const title = typeof stage.sectionTitle === 'string' ? stage.sectionTitle.trim() : '';
         let needTitle = Boolean(title);
         for (const [key, def] of Object.entries(stage.catalog)) {
             if (isInputBlock(def) && needTitle && title) {
@@ -652,6 +675,8 @@ export function runPromptCatalogWebUI(catalogOrOptions, options) {
     return runPromptCatalogWebUIImpl({ catalog: catalogOrOptions });
 }
 function runPromptCatalogWebUIImpl(options) {
+    const locale = resolveCliLocale(options.locale);
+    const t = createCliTranslate(locale);
     const { merged } = resolveMergedCatalog(options);
     const userSeed = mergeValueSeedsFromOptions(options);
     const formDefaults = buildWebFormValuesFromCatalog(merged, userSeed);
@@ -660,15 +685,34 @@ function runPromptCatalogWebUIImpl(options) {
     const reflowPath = options.reflowPath ?? DEFAULT_REFLOW;
     const host = options.host ?? DEFAULT_HOST;
     const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-    const pageTitle = options.pageTitle ?? 'Prompt catalog (local UI)';
-    const h1 = options.documentHeading ?? 'Configure parameters (localhost only)';
-    const documentHint = options.documentHint ??
-        'This server is only bound to the loopback interface. After submit, the CLI continues in the same terminal session.';
+    const pageTitle = resolveUiText(options.pageTitle, locale, t('promptCatalog.web.pageTitle'));
+    const h1 = resolveUiText(options.documentHeading, locale, t('promptCatalog.web.documentHeading'));
+    const documentHint = resolveUiText(options.documentHint, locale, t('promptCatalog.web.documentHint'));
     const catalog = merged;
-    const pwcStepDefs = computePwcWizardSteps(options, catalog);
+    const pwcStepDefs = computePwcWizardSteps(options, catalog, locale);
     const pwcNSteps = Math.max(1, pwcStepDefs.length);
     const resolveValidateStepPath = options.validateStepPath ?? DEFAULT_VALIDATE_STEP;
     const resolveValidateFieldPath = options.validateFieldPath ?? DEFAULT_VALIDATE_FIELD;
+    const uiText = {
+        stepsAriaLabel: t('promptCatalog.web.stepsAriaLabel'),
+        stepsSidebarAriaLabel: t('promptCatalog.web.stepsSidebarAriaLabel'),
+        stepNavigationAriaLabel: t('promptCatalog.web.stepNavigationAriaLabel'),
+        submitAriaLabel: t('promptCatalog.web.submitAriaLabel'),
+        back: t('promptCatalog.web.back'),
+        next: t('promptCatalog.web.next'),
+        submit: t('promptCatalog.web.submit'),
+        checking: t('promptCatalog.web.checking'),
+        sending: t('promptCatalog.web.sending'),
+        successTitle: t('promptCatalog.web.successTitle'),
+        errorTitle: t('promptCatalog.web.errorTitle'),
+        savedAndClosing: t('promptCatalog.web.savedAndClosing'),
+        savedCloseBlocked: t('promptCatalog.web.savedCloseBlocked'),
+        invalidValue: t('promptCatalog.web.invalidValue'),
+        invalidRequest: t('promptCatalog.web.invalidRequest'),
+        invalidStep: t('promptCatalog.web.invalidStep'),
+        invalidField: t('promptCatalog.web.invalidField'),
+        doneAriaLabel: 'done',
+    };
     let server;
     let timeoutId;
     return new Promise((resolve, reject) => {
@@ -686,15 +730,16 @@ function runPromptCatalogWebUIImpl(options) {
         };
         const servePage = (port) => {
             const base = `http://${host}:${port}`;
-            const formInner = buildPwcFormHtml(catalog, formDefaults, initialShow, pwcStepDefs, 0, pwcNSteps);
+            const formInner = buildPwcFormHtml(catalog, formDefaults, initialShow, pwcStepDefs, 0, pwcNSteps, locale, uiText);
             const wizardClientJson = JSON.stringify({ n: pwcNSteps, stepDefs: pwcStepDefs });
             const pwcValStepUrl = pwcNSteps > 1 ? JSON.stringify(base + resolveValidateStepPath) : 'null';
             const pwcValFieldUrl = JSON.stringify(base + resolveValidateFieldPath);
+            const uiTextJson = JSON.stringify(uiText);
             const pwcShellClass = options.stages && options.stages.length > 0
                 ? 'pwc-shell pwc-shell--stages'
                 : 'pwc-shell';
             const page = `<!doctype html>
-<html lang="en">
+<html lang="${escapeHtml(locale)}">
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1" />
@@ -1099,6 +1144,15 @@ function runPromptCatalogWebUIImpl(options) {
       box-shadow: 0 0 0 2px color-mix(in srgb, var(--pwc-ad-color-primary) 8%, transparent);
       background: color-mix(in srgb, var(--pwc-ad-color-primary) 2%, var(--pwc-ad-color-container));
     }
+    .pwc-radio-option--disabled {
+      cursor: not-allowed;
+      background: var(--pwc-ad-color-fill-alter);
+    }
+    .pwc-radio-option--disabled:hover {
+      border-color: var(--pwc-ad-color-border);
+      box-shadow: none;
+      background: var(--pwc-ad-color-fill-alter);
+    }
     .pwc-radio-input {
       margin: 3px 0 0;
       width: 16px;
@@ -1107,6 +1161,9 @@ function runPromptCatalogWebUIImpl(options) {
       accent-color: var(--pwc-ad-color-primary);
       cursor: pointer;
     }
+    .pwc-radio-option--disabled .pwc-radio-input {
+      cursor: not-allowed;
+    }
     .pwc-radio-option-body { min-width: 0; }
     .pwc-radio-option-label {
       display: block;
@@ -1114,12 +1171,18 @@ function runPromptCatalogWebUIImpl(options) {
       line-height: 1.5715;
       color: var(--pwc-ad-color-text);
     }
+    .pwc-radio-option--disabled .pwc-radio-option-label {
+      color: color-mix(in srgb, var(--pwc-ad-color-text) 55%, transparent);
+    }
     .pwc-radio-option-hint {
       margin-top: 2px;
       font-size: 12px;
       line-height: 1.5;
       color: var(--pwc-ad-color-text-description);
     }
+    .pwc-radio-option--disabled .pwc-radio-option-hint {
+      color: color-mix(in srgb, var(--pwc-ad-color-text-description) 70%, transparent);
+    }
     .pwc-radio-input:focus-visible {
       outline: none;
       box-shadow: 0 0 0 2px color-mix(in srgb, var(--pwc-ad-color-primary) 20%, transparent);
@@ -1130,6 +1193,11 @@ function runPromptCatalogWebUIImpl(options) {
       box-shadow: 0 0 0 2px color-mix(in srgb, var(--pwc-ad-color-primary) 12%, transparent);
       background: color-mix(in srgb, var(--pwc-ad-color-primary) 5%, var(--pwc-ad-color-container));
     }
+    .pwc-radio-option--disabled:has(.pwc-radio-input:checked) {
+      border-color: var(--pwc-ad-color-border);
+      box-shadow: none;
+      background: var(--pwc-ad-color-fill-alter);
+    }
     .pwc-form-item-has-error .pwc-radio-option {
       border-color: var(--pwc-form-color-error);
     }
@@ -1328,6 +1396,7 @@ function runPromptCatalogWebUIImpl(options) {
     var pwcFieldMeta = ${JSON.stringify(PWC_FORM_META_FIELD)};
     var s = document.getElementById('pwcStatus');
     var wcfg = ${wizardClientJson};
+    var uiText = ${uiTextJson};
     var pwcN = wcfg && typeof wcfg.n === 'number' ? wcfg.n : 1;
     var pwcSteps = (wcfg && wcfg.stepDefs) || [];
     var pwcCur = 0;
@@ -1367,7 +1436,7 @@ function runPromptCatalogWebUIImpl(options) {
       s.setAttribute('role', 'alert');
       s.innerHTML =
         '<span class="pwc-ad-alert__icon" aria-hidden="true">' + pwcErrIcon + '</span>' +
-        '<div class="pwc-ad-alert__inner"><div class="pwc-ad-alert__title">Error</div>' +
+        '<div class="pwc-ad-alert__inner"><div class="pwc-ad-alert__title">' + pwcEsc(uiText.errorTitle) + '</div>' +
         '<div class="pwc-ad-alert__desc">' + pwcEsc(t) + '</div></div>';
     }
     function pwcSetStatusSuccess(message) {
@@ -1377,7 +1446,7 @@ function runPromptCatalogWebUIImpl(options) {
       s.setAttribute('role', 'status');
       s.innerHTML =
         '<span class="pwc-ad-alert__icon" aria-hidden="true">' + pwcOkIcon + '</span>' +
-        '<div class="pwc-ad-alert__inner"><div class="pwc-ad-alert__title">Success</div>' +
+        '<div class="pwc-ad-alert__inner"><div class="pwc-ad-alert__title">' + pwcEsc(uiText.successTitle) + '</div>' +
         '<div class="pwc-ad-alert__desc">' + pwcEsc(t) + '</div></div>';
     }
     function pwcScheduleWindowClose() {
@@ -1387,9 +1456,9 @@ function runPromptCatalogWebUIImpl(options) {
         window.close();
         pwcCloseProbeTimer = setTimeout(function () {
           if (!s || document.visibilityState !== 'visible') { return; }
-          pwcSetStatusSuccess('Saved. Automatic close was blocked by the browser. You can close this tab now.');
+          pwcSetStatusSuccess(uiText.savedCloseBlocked);
         }, 600);
-      }, 2000);
+      }, 5000);
     }
     function pwcSetFieldError(key, message) {
       if (!form || !key) { return; }
@@ -1536,7 +1605,7 @@ function runPromptCatalogWebUIImpl(options) {
             w.style.display = hidden ? 'none' : 'block';
             var ctrls = w.querySelectorAll('input, select, textarea');
             for (var i = 0; i < ctrls.length; i++) {
-              ctrls[i].disabled = hidden;
+              ctrls[i].disabled = hidden || ctrls[i].getAttribute('data-pwc-static-disabled') === '1';
             }
             if (!hidden && k && !pwcIsFieldDirty(k) && Object.prototype.hasOwnProperty.call(vals, k)) {
               setControlValue(form, k, vals[k]);
@@ -1701,8 +1770,8 @@ function runPromptCatalogWebUIImpl(options) {
         var inp = getControl(form, k);
         if (inp == null) { continue; }
         if (typeof inp.checkValidity === 'function' && !inp.checkValidity()) {
-          var vm = (typeof inp.validationMessage === 'string' && inp.validationMessage) ? inp.validationMessage : 'Invalid value';
-          pwcSetFieldError(k, vm);
+            var vm = (typeof inp.validationMessage === 'string' && inp.validationMessage) ? inp.validationMessage : uiText.invalidValue;
+            pwcSetFieldError(k, vm);
           if (typeof inp.focus === 'function') { inp.focus(); }
           return false;
         }
@@ -1760,7 +1829,7 @@ function runPromptCatalogWebUIImpl(options) {
       if (pwcValStep == null) {
         return reflow().then(function () { pwcSetStep(pwcVisibleNext(pwcCur)); });
       }
-      pwcSetStatusHint('Checking…');
+      pwcSetStatusHint(uiText.checking);
       return fetch(pwcValStep, {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
@@ -1828,7 +1897,7 @@ function runPromptCatalogWebUIImpl(options) {
       form.addEventListener('submit', function (e) {
         e.preventDefault();
         if (pwcN > 1 && pwcVisibleStepPosition(pwcCur) < pwcVisibleSteps.length - 1) { return; }
-        pwcSetStatusHint('Sending…');
+        pwcSetStatusHint(uiText.sending);
         pwcClearAllFieldErrors();
         fetch(sub, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(collect()) })
           .then(function (r) {
@@ -1843,7 +1912,7 @@ function runPromptCatalogWebUIImpl(options) {
             return r.json();
           })
           .then(function () {
-            pwcSetStatusSuccess('Saved. This tab will close automatically in 2 seconds.');
+            pwcSetStatusSuccess(uiText.savedAndClosing);
             pwcScheduleWindowClose();
           })
           .catch(function (err) {
@@ -1913,10 +1982,10 @@ function runPromptCatalogWebUIImpl(options) {
                                     : NaN;
                             if (!Number.isInteger(step) || step < 0 || step >= pwcStepDefs.length) {
                                 res.writeHead(400, { 'Content-Type': 'application/json' });
-                                res.end(JSON.stringify({ ok: false, error: 'Invalid or missing wizard step.' }));
+                                res.end(JSON.stringify({ ok: false, error: t('promptCatalog.web.invalidStep') }));
                                 return;
                             }
-                            const { error, fieldKey } = await buildWebPresetFromBody(catalog, readFormFromClient(readFormFromClientStrippingPwcMeta(raw)), userSeed, { scopeKeys: new Set(pwcStepDefs[step].keys) });
+                            const { error, fieldKey } = await buildWebPresetFromBody(catalog, readFormFromClient(readFormFromClientStrippingPwcMeta(raw)), userSeed, { scopeKeys: new Set(pwcStepDefs[step].keys), locale });
                             if (error) {
                                 res.writeHead(400, { 'Content-Type': 'application/json' });
                                 res.end(JSON.stringify(fieldKey ? { ok: false, error, fieldKey } : { ok: false, error }));
@@ -1927,7 +1996,7 @@ function runPromptCatalogWebUIImpl(options) {
                         }
                         catch {
                             res.writeHead(400, { 'Content-Type': 'application/json' });
-                            res.end(JSON.stringify({ ok: false, error: 'Invalid request' }));
+                            res.end(JSON.stringify({ ok: false, error: t('promptCatalog.web.invalidRequest') }));
                         }
                     })();
                 });
@@ -1946,10 +2015,10 @@ function runPromptCatalogWebUIImpl(options) {
                                 : '';
                             if (!fieldKey || !Object.prototype.hasOwnProperty.call(catalog, fieldKey)) {
                                 res.writeHead(400, { 'Content-Type': 'application/json' });
-                                res.end(JSON.stringify({ ok: false, error: 'Invalid or missing field key.' }));
+                                res.end(JSON.stringify({ ok: false, error: t('promptCatalog.web.invalidField') }));
                                 return;
                             }
-                            const { error } = await buildWebPresetFromBody(catalog, readFormFromClient(readFormFromClientStrippingPwcMeta(raw)), userSeed, { scopeKeys: new Set([fieldKey]) });
+                            const { error } = await buildWebPresetFromBody(catalog, readFormFromClient(readFormFromClientStrippingPwcMeta(raw)), userSeed, { scopeKeys: new Set([fieldKey]), locale });
                             if (error) {
                                 res.writeHead(400, { 'Content-Type': 'application/json' });
                                 res.end(JSON.stringify({ ok: false, error, fieldKey }));
@@ -1960,7 +2029,7 @@ function runPromptCatalogWebUIImpl(options) {
                         }
                         catch {
                             res.writeHead(400, { 'Content-Type': 'application/json' });
-                            res.end(JSON.stringify({ ok: false, error: 'Invalid request' }));
+                            res.end(JSON.stringify({ ok: false, error: t('promptCatalog.web.invalidRequest') }));
                         }
                     })();
                 });
@@ -1973,7 +2042,7 @@ function runPromptCatalogWebUIImpl(options) {
                     void (async () => {
                         try {
                             const raw = JSON.parse(Buffer.concat(chunks).toString('utf8'));
-                            const { preset, error, fieldKey } = await buildWebPresetFromBody(catalog, readFormFromClient(raw), userSeed);
+                            const { preset, error, fieldKey } = await buildWebPresetFromBody(catalog, readFormFromClient(raw), userSeed, { locale });
                             if (error) {
                                 res.writeHead(400, { 'Content-Type': 'application/json' });
                                 res.end(JSON.stringify(fieldKey ? { ok: false, error, fieldKey } : { ok: false, error }));
@@ -1994,7 +2063,7 @@ function runPromptCatalogWebUIImpl(options) {
                         }
                         catch (e) {
                             res.writeHead(400, { 'Content-Type': 'text/plain' });
-                            res.end('Invalid request');
+                            res.end(t('promptCatalog.web.invalidRequest'));
                         }
                     })();
                 });