@nocobase/cli 2.3.0-beta.6 → 2.4.0-alpha.1

package/dist/lib/prompt-catalog-core.js

@@ -60,7 +60,7 @@ export function mergedBoolean(key, def, iv, useYesInitial) {
     }
     return def.initialValue ?? true;
 }
-export function mergedSelect(key, def, iv, useYesInitial) {
+export function mergedSelect(key, def, iv, useYesInitial, valuesSoFar = {}) {
     const enabledValueList = enabledSelectOptionValues(def.options);
     if (hasIvKey(iv, key)) {
         const s = String(iv[key]);
@@ -72,7 +72,7 @@ export function mergedSelect(key, def, iv, useYesInitial) {
     if (useYesInitial && def.yesInitialValue !== undefined && enabledValueList.includes(def.yesInitialValue)) {
         return def.yesInitialValue;
     }
-    const d = def.initialValue;
+    const d = typeof def.initialValue === 'function' ? def.initialValue(valuesSoFar) : def.initialValue;
     if (d !== undefined && enabledValueList.includes(d)) {
         return d;
     }

package/dist/lib/prompt-catalog-terminal.js

@@ -221,11 +221,12 @@ export async function runPromptCatalog(catalog, options = {}) {
         if (def.type === 'select') {
             const message = resolvePromptText(def.message, locale, key);
             const valueList = selectOptionValues(def.options);
+            const valuesSoFar = { ...computationSeed, ...out };
             if (def.required && def.options.length === 0) {
                 hooks.onMissingNonInteractive(t('promptCatalog.nonInteractive.selectRequiredNoOptions', { key }));
             }
             if (!interactive) {
-                const merged = mergedSelect(key, def, resolveIv, useYesInitial);
+                const merged = mergedSelect(key, def, resolveIv, useYesInitial, valuesSoFar);
                 if (merged === undefined || !valueList.includes(merged)) {
                     const bad = hasIvKey(resolveIv, key) && !valueList.includes(String(resolveIv[key]))
                         ? String(resolveIv[key])
@@ -243,10 +244,8 @@ export async function runPromptCatalog(catalog, options = {}) {
                 }
                 continue;
             }
-            const merged = mergedSelect(key, def, promptIv, false);
-            const uiInitial = merged ??
-                (def.initialValue && valueList.includes(def.initialValue) ? def.initialValue : undefined) ??
-                valueList[0];
+            const merged = mergedSelect(key, def, promptIv, false, valuesSoFar);
+            const uiInitial = merged ?? valueList[0];
             if (uiInitial === undefined || !valueList.includes(uiInitial)) {
                 const hint = def.required
                     ? t('promptCatalog.nonInteractive.selectRequiredInteractive', { key })

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

@@ -34,6 +34,13 @@ function resolveTextDefault(def, out) {
     }
     return String(iv ?? '');
 }
+function resolveSelectDefault(def, out) {
+    const iv = def.initialValue;
+    if (typeof iv === 'function') {
+        return iv(out);
+    }
+    return iv;
+}
 function resolvePasswordDefault(def, out) {
     const iv = def.initialValue;
     if (typeof iv === 'function') {
@@ -98,7 +105,7 @@ function defaultValueForInput(key, def, out) {
             const first = def.options
                 .find((o) => typeof o === 'string' || o.disabled !== true);
             const firstValue = typeof first === 'string' ? first : first?.value;
-            const i = def.initialValue;
+            const i = resolveSelectDefault(def, out);
             const enabledValues = def.options
                 .filter((o) => typeof o === 'string' || o.disabled !== true)
                 .map((o) => (typeof o === 'string' ? o : o.value));
@@ -765,11 +772,10 @@ function runPromptCatalogWebUIImpl(options) {
             }
         };
         const servePage = (port) => {
-            const base = `http://${publicHost}:${port}`;
             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 pwcValStepUrl = pwcNSteps > 1 ? JSON.stringify(resolveValidateStepPath) : 'null';
+            const pwcValFieldUrl = JSON.stringify(resolveValidateFieldPath);
             const uiTextJson = JSON.stringify(uiText);
             const pwcShellClass = options.stages && options.stages.length > 0
                 ? 'pwc-shell pwc-shell--stages'
@@ -1493,8 +1499,8 @@ function runPromptCatalogWebUIImpl(options) {
   </div>
   <script>
   (function () {
-    var sub = ${JSON.stringify(base + submitPath)};
-    var ref = ${JSON.stringify(base + reflowPath)};
+    var sub = ${JSON.stringify(submitPath)};
+    var ref = ${JSON.stringify(reflowPath)};
     var pwcValStep = ${pwcValStepUrl};
     var pwcValField = ${pwcValFieldUrl};
     var pwcStepMeta = ${JSON.stringify(PWC_FORM_META_STEP)};

package/dist/lib/proxy-caddy.js

@@ -79,6 +79,7 @@ export async function writeCaddyProxyBundle(runtime, appEntryOptions, runtimeCon
         writeFile(bundle.appConfigPath, nextAppConfigContent, 'utf8'),
         writeFile(bundle.indexV1Path, bundle.indexV1Content, 'utf8'),
         writeFile(bundle.indexV2Path, bundle.indexV2Content, 'utf8'),
+        writeFile(bundle.indexSettingsPath, bundle.indexSettingsContent, 'utf8'),
         writeFile(bundle.mainConfigPath, bundle.mainConfigContent, 'utf8'),
     ]);
     return {
@@ -100,6 +101,7 @@ export async function writeManualCaddyProxyBundle(input, appEntryOptions, runtim
         writeFile(bundle.appConfigPath, nextAppConfigContent, 'utf8'),
         writeFile(bundle.indexV1Path, bundle.indexV1Content, 'utf8'),
         writeFile(bundle.indexV2Path, bundle.indexV2Content, 'utf8'),
+        writeFile(bundle.indexSettingsPath, bundle.indexSettingsContent, 'utf8'),
         writeFile(bundle.mainConfigPath, bundle.mainConfigContent, 'utf8'),
     ]);
     return {

package/dist/lib/proxy-nginx.js

@@ -107,6 +107,7 @@ async function writeResolvedNginxProxyBundle(bundle, appEntryOptions, options) {
         writeFile(bundle.appConfigPath, nextAppConfigContent, 'utf8'),
         writeFile(bundle.indexV1Path, bundle.indexV1Content, 'utf8'),
         writeFile(bundle.indexV2Path, bundle.indexV2Content, 'utf8'),
+        writeFile(bundle.indexSettingsPath, bundle.indexSettingsContent, 'utf8'),
         writeFile(bundle.mainConfigPath, bundle.mainConfigContent, 'utf8'),
         syncEnvProxyNginxSnippets(),
     ]);

package/dist/lib/run-npm.js

@@ -48,6 +48,10 @@ const MISSING_COMMAND_SPECS = {
         displayName: 'pnpm',
         configKey: 'bin.pnpm',
     },
+    npm: {
+        displayName: 'npm',
+        configKey: 'bin.npm',
+    },
 };
 const DOCKER_DAEMON_UNAVAILABLE_PATTERNS = [
     /cannot connect to the docker daemon/i,
@@ -61,19 +65,92 @@ async function resolveCommandName(name) {
 function shouldTeeInheritedOutput(options) {
     return options?.stdio === 'inherit' && Boolean(String(process.env.NB_CLI_ACTIVE_LOG_FILE ?? '').trim());
 }
-function createMissingCommandError(name, label, error) {
-    const code = error && typeof error === 'object' && 'code' in error ? String(error.code) : undefined;
-    if (code !== 'ENOENT') {
-        return undefined;
+function buildProcessEnv(options) {
+    if (options?.envMode === 'replace') {
+        return options.env ?? {};
     }
+    return {
+        ...process.env,
+        ...options?.env,
+    };
+}
+function createMissingCommandError(name, label, error) {
     if (!Object.prototype.hasOwnProperty.call(MISSING_COMMAND_SPECS, name)) {
         return undefined;
     }
     const spec = MISSING_COMMAND_SPECS[name];
+    if (!isMissingCommandError(name, spec.displayName, error)) {
+        return undefined;
+    }
     return new Error(translateCli('commands.shared.missingCommand', { action: label, displayName: spec.displayName, configKey: spec.configKey }, {
         fallback: `Couldn't run \`${label}\` because the ${spec.displayName} executable could not be found. Install ${spec.displayName} or update \`nb config set ${spec.configKey} <path>\` and try again.`,
     }));
 }
+function isMissingCommandError(name, displayName, error) {
+    const code = error && typeof error === 'object' && 'code' in error ? String(error.code) : undefined;
+    if (code === 'ENOENT') {
+        return true;
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    const lowerMessage = message.toLowerCase();
+    return (lowerMessage.includes(`spawn ${name.toLowerCase()} enoent`) ||
+        lowerMessage.includes(`${name.toLowerCase()} executable could not be found`) ||
+        lowerMessage.includes(`${displayName.toLowerCase()} executable could not be found`));
+}
+export async function runPnpmCommand(runCommand, args, options) {
+    try {
+        await runCommand('pnpm', args, options);
+    }
+    catch (error) {
+        throw createMissingCommandError('pnpm', options.errorName ?? `pnpm ${args.join(' ')}`.trim(), error) ?? error;
+    }
+}
+function createInstallArgsWithoutTrustLockfile(args) {
+    if (!args.includes('install') || !args.includes('--trust-lockfile')) {
+        return undefined;
+    }
+    return args.filter((arg) => arg !== '--trust-lockfile');
+}
+function isFriendlyMissingPnpmError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return message.includes('because the pnpm executable could not be found');
+}
+function formatPnpmLabel(args) {
+    return `pnpm ${args.join(' ')}`.trim();
+}
+export async function resolvePnpmInstallCommand(cwd) {
+    const hasLockfile = await fsp
+        .stat(path.join(cwd, 'pnpm-lock.yaml'))
+        .then((stats) => stats.isFile())
+        .catch(() => false);
+    if (hasLockfile) {
+        const args = ['install', '--frozen-lockfile', '--trust-lockfile'];
+        return {
+            args,
+            errorName: formatPnpmLabel(args),
+        };
+    }
+    const args = ['install'];
+    return {
+        args,
+        errorName: formatPnpmLabel(args),
+    };
+}
+export async function runPnpmInstallCommand(runCommand, args, options) {
+    try {
+        await runPnpmCommand(runCommand, args, options);
+    }
+    catch (error) {
+        const fallbackArgs = createInstallArgsWithoutTrustLockfile(args);
+        if (!fallbackArgs || isFriendlyMissingPnpmError(error)) {
+            throw error;
+        }
+        await runPnpmCommand(runCommand, fallbackArgs, {
+            ...options,
+            errorName: formatPnpmLabel(fallbackArgs),
+        });
+    }
+}
 function isDockerDaemonUnavailableError(error) {
     const message = error instanceof Error ? error.message : String(error);
     return DOCKER_DAEMON_UNAVAILABLE_PATTERNS.some((pattern) => pattern.test(message));
@@ -146,10 +223,7 @@ export async function run(name, args, options) {
         const child = spawn(command, [...args], {
             stdio,
             cwd,
-            env: {
-                ...process.env,
-                ...options?.env,
-            },
+            env: buildProcessEnv(options),
             windowsHide: process.platform === 'win32',
         });
         if (options?.stdio === 'pipe' || shouldTeeInheritedOutput(options)) {
@@ -268,10 +342,7 @@ export async function commandSucceeds(name, args, options) {
     return await new Promise((resolve, reject) => {
         const child = spawn(command, [...args], {
             cwd,
-            env: {
-                ...process.env,
-                ...options?.env,
-            },
+            env: buildProcessEnv(options),
             stdio: 'ignore',
             windowsHide: process.platform === 'win32',
         });
@@ -302,10 +373,7 @@ export async function commandOutput(name, args, options) {
     return await new Promise((resolve, reject) => {
         const child = spawn(command, [...args], {
             cwd,
-            env: {
-                ...process.env,
-                ...options?.env,
-            },
+            env: buildProcessEnv(options),
             stdio: ['ignore', 'pipe', 'pipe'],
             windowsHide: process.platform === 'win32',
         });
@@ -364,10 +432,7 @@ export async function commandOutputViaFile(name, args, options) {
         const result = await new Promise((resolve, reject) => {
             const child = spawn(command, [...args], {
                 cwd,
-                env: {
-                    ...process.env,
-                    ...options?.env,
-                },
+                env: buildProcessEnv(options),
                 stdio: ['ignore', stdoutHandle.fd, stderrHandle.fd],
                 windowsHide: process.platform === 'win32',
             });

package/dist/lib/swagger-command.js

@@ -0,0 +1,52 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { Flags } from '@oclif/core';
+import { executeRawApiRequest } from './api-client.js';
+import { ensureCrossEnvConfirmed } from './env-guard.js';
+export const swaggerRequestFlags = {
+    env: Flags.string({
+        char: 'e',
+        description: 'CLI env name; omitted uses the current env',
+    }),
+    yes: Flags.boolean({
+        char: 'y',
+        description: 'Confirm using --env when it targets a different env than the current env',
+        default: false,
+    }),
+    'api-base-url': Flags.string({
+        description: 'NocoBase API base URL, for example http://localhost:13000/api',
+    }),
+    role: Flags.string({
+        description: 'Role override, sent as X-Role',
+    }),
+    token: Flags.string({
+        char: 't',
+        description: 'API key or access token override',
+    }),
+};
+export async function executeSwaggerRequest(command, flags, path, query) {
+    const requestedEnv = flags.env?.trim() || undefined;
+    const confirmed = await ensureCrossEnvConfirmed({
+        command,
+        requestedEnv,
+        yes: flags.yes,
+    });
+    if (!confirmed) {
+        return undefined;
+    }
+    return executeRawApiRequest({
+        envName: requestedEnv,
+        baseUrl: flags['api-base-url'],
+        token: flags.token,
+        role: flags.role,
+        method: 'GET',
+        path,
+        query,
+    });
+}

package/dist/lib/ui.js

@@ -15,8 +15,35 @@ let verboseMode = false;
 let lastStaticTaskMessage;
 let lastStaticTaskAt = 0;
 const STATIC_TASK_UPDATE_THROTTLE_MS = 3_000;
+function isCombiningCodePoint(codePoint) {
+    return ((codePoint >= 0x0300 && codePoint <= 0x036f) ||
+        (codePoint >= 0x1ab0 && codePoint <= 0x1aff) ||
+        (codePoint >= 0x1dc0 && codePoint <= 0x1dff) ||
+        (codePoint >= 0x20d0 && codePoint <= 0x20ff) ||
+        (codePoint >= 0xfe20 && codePoint <= 0xfe2f));
+}
+function isFullWidthCodePoint(codePoint) {
+    return (codePoint >= 0x1100 &&
+        (codePoint <= 0x115f ||
+            codePoint === 0x2329 ||
+            codePoint === 0x232a ||
+            (codePoint >= 0x2e80 && codePoint <= 0xa4cf && codePoint !== 0x303f) ||
+            (codePoint >= 0xac00 && codePoint <= 0xd7a3) ||
+            (codePoint >= 0xf900 && codePoint <= 0xfaff) ||
+            (codePoint >= 0xfe10 && codePoint <= 0xfe19) ||
+            (codePoint >= 0xfe30 && codePoint <= 0xfe6f) ||
+            (codePoint >= 0xff00 && codePoint <= 0xff60) ||
+            (codePoint >= 0xffe0 && codePoint <= 0xffe6) ||
+            (codePoint >= 0x20000 && codePoint <= 0x3fffd)));
+}
 function stringWidth(value) {
-    return Array.from(value).length;
+    return Array.from(value).reduce((width, character) => {
+        const codePoint = character.codePointAt(0);
+        if (!codePoint || codePoint === 0 || codePoint < 32 || isCombiningCodePoint(codePoint)) {
+            return width;
+        }
+        return width + (isFullWidthCodePoint(codePoint) ? 2 : 1);
+    }, 0);
 }
 function pad(value, width) {
     const padding = Math.max(0, width - stringWidth(value));

package/dist/locale/en-US.json

@@ -89,6 +89,9 @@
       "lowerCaseTableNamesRequiresUnderscored": "MySQL lower_case_table_names=1 requires DB_UNDERSCORED=true."
     }
   },
+  "apiClient": {
+    "authRequiredHint": "Authentication failed or the saved session has expired. Run `{{command}}` to sign in again."
+  },
   "commands": {
     "envAdd": {
       "prompts": {
@@ -168,6 +171,204 @@
         "refusal": "Refusing to run against env \"{{requestedEnv}}\" because the current env is \"{{currentEnv}}\" and interactive confirmation is unavailable in the current agent session.\n\nFor safety, the agent will not switch envs automatically and will not add --yes on your behalf.\n\nTo continue:\n- run `nb env use {{requestedEnv}}` yourself and then re-run the command, or\n- re-run the same command with `--env {{requestedEnv}} --yes` to confirm this one-off cross-env operation."
       }
     },
+    "portalCreate": {
+      "errors": {
+        "envNotConfigured": "Env \"{{envName}}\" is not configured. Run `nb env add {{envName}} --api-base-url <url>` first.",
+        "noEnvConfigured": "No NocoBase env is configured yet. Run `nb init --ui` to create one first.",
+        "templateInvalidDirectory": "Portal template \"{{source}}\" is invalid: expected a directory.",
+        "localTemplateMissing": "Portal template directory does not exist: {{source}}",
+        "templateUnresolved": "Portal template \"{{source}}\" could not be resolved. {{details}}",
+        "templateDownloadFailed": "Failed to download portal template \"{{source}}\" with npm pack. {{details}}",
+        "templateExtractFailed": "Failed to extract portal template \"{{source}}\": {{details}}",
+        "templateMissingPackageJson": "Portal template \"{{source}}\" is invalid: package.json is missing.",
+        "npmPackNoTarball": "npm pack did not produce a local tarball for {{source}}.",
+        "npmPackMultipleTarballs": "npm pack produced multiple tarballs for {{source}}.",
+        "invalidPortalName": "Invalid portal name \"{{value}}\". Use lowercase letters, numbers, underscores, or hyphens, and start with a lowercase letter or number.",
+        "invalidPortalAppName": "Invalid portal app name \"{{value}}\" from apiBaseUrl. Use letters, numbers, underscores, or hyphens, and start with a letter or number.",
+        "missingApiBaseUrl": "Cannot create a portal because the selected env has no apiBaseUrl.",
+        "outsideParent": "Refusing to modify a portal outside {{parentDir}}: {{portalDir}}",
+        "sshUnsupported": "Cannot create a portal for ssh envs in the first version.",
+        "workspaceExists": "Portal already exists: {{portalDir}}\nPass --force to delete it and create a new portal.",
+        "workspaceNotReplaceable": "Refusing to replace a non-portal directory: {{portalDir}}\nThe target directory must be empty or contain package.json with a nocobase field."
+      },
+      "messages": {
+        "skipInstall": "Skipped pnpm install because package.json was not found in {{portalDir}}.",
+        "created": "Portal \"{{portal}}\" created at {{portalDir}}",
+        "app": "App: {{app}}",
+        "base": "Base: {{base}}",
+        "sourceStorage": "Source storage: {{sourceStorage}}",
+        "installFailed": "Dependency installation did not finish successfully. Run `pnpm install` manually in {{portalDir}}."
+      }
+    },
+    "portalConfig": {
+      "errors": {
+        "invalidSourceStorage": "Invalid source storage \"{{value}}\". Use \"nocobase\" or \"git\".",
+        "invalidGitPath": "--git-path must be a relative path inside the Git repository.",
+        "gitOptionsForNocobaseStorage": "--git-repo, --git-branch, and --git-path can only be used with --source-storage git.",
+        "gitRepoRequired": "--git-repo is required when --source-storage is git.",
+        "gitRepoInvalid": "--git-repo must be a full Git remote URL.",
+        "updateFailed": "Portal config update failed with status {{status}}\n{{details}}"
+      }
+    },
+    "portalConfigure": {
+      "errors": {
+        "envNotConfigured": "Env \"{{envName}}\" is not configured. Run `nb env add {{envName}} --api-base-url <url>` first.",
+        "noEnvConfigured": "No NocoBase env is configured yet. Run `nb init --ui` to create one first.",
+        "noChanges": "No portal configuration changes were provided. Pass --path, --source-storage, or a --git-* flag.",
+        "notFound": "Portal \"{{portal}}\" was not found. Run `nb portal list` to see available portals."
+      },
+      "messages": {
+        "updated": "Portal \"{{portal}}\" configuration updated.",
+        "pathUpdated": "Development path: {{portalDir}}",
+        "remoteSynced": "Remote portal record: synced",
+        "remoteSkipped": "Remote portal record: not found; local config only"
+      }
+    },
+    "portalDeploy": {
+      "errors": {
+        "envNotConfigured": "Env \"{{envName}}\" is not configured. Run `nb env add {{envName}} --api-base-url <url>` first.",
+        "noEnvConfigured": "No NocoBase env is configured yet. Run `nb init --ui` to create one first.",
+        "workspaceMissing": "Portal does not exist: {{portalDir}}\nRun `nb portal create {{portal}}` first.",
+        "packageJsonMissing": "Portal is invalid: package.json is missing in {{portalDir}}.",
+        "distMissing": "Portal build did not produce {{distDir}}/index.html.",
+        "unsupportedEnvKind": "Cannot deploy a portal for {{kind}} envs in the first version.",
+        "uploadFailed": "Portal dist upload failed with status {{status}}\n{{details}}",
+        "recordSyncFailed": "Portal record sync failed with status {{status}}\n{{details}}"
+      },
+      "messages": {
+        "deployed": "Portal \"{{portal}}\" deployed.",
+        "mode": "Mode: {{mode}}",
+        "app": "App: {{app}}",
+        "base": "Base: {{base}}",
+        "record": "Record: synced",
+        "dist": "Dist: {{dist}}",
+        "localDist": "Local dist: {{dist}}",
+        "serverDist": "Server dist: {{dist}}"
+      }
+    },
+    "portalList": {
+      "errors": {
+        "envNotConfigured": "Env \"{{envName}}\" is not configured. Run `nb env add {{envName}} --api-base-url <url>` first.",
+        "noEnvConfigured": "No NocoBase env is configured yet. Run `nb init --ui` to create one first.",
+        "unsupportedEnvKind": "Cannot list portals for {{kind}} envs in the first version.",
+        "listFailed": "Portal list failed with status {{status}}\n{{details}}"
+      },
+      "messages": {
+        "empty": "No portal records found."
+      },
+      "table": {
+        "name": "Name",
+        "url": "URL",
+        "portalType": "Portal type",
+        "path": "Development path",
+        "enabled": "Enabled",
+        "default": "Default"
+      }
+    },
+    "portalPull": {
+      "errors": {
+        "envNotConfigured": "Env \"{{envName}}\" is not configured. Run `nb env add {{envName}} --api-base-url <url>` first.",
+        "noEnvConfigured": "No NocoBase env is configured yet. Run `nb init --ui` to create one first.",
+        "gitRepoRequiredForTemporaryPull": "--git-branch and --git-path require --git-repo for a temporary Git pull. To update the portal configuration, use `nb portal config`."
+      },
+      "messages": {
+        "noop": "No pull is needed.",
+        "pulled": "Pulled portal source \"{{portal}}\" into {{portalDir}}",
+        "installFailed": "Dependency installation did not finish successfully. Run `pnpm install` manually in {{portalDir}}."
+      }
+    },
+    "portalSource": {
+      "errors": {
+        "workspaceNotReplaceable": "Refusing to replace a non-portal directory: {{portalDir}}\nThe target directory must be empty or contain package.json with a nocobase field."
+      }
+    },
+    "swagger": {
+      "errors": {
+        "pluginDisabled": "The API documentation plugin is not enabled. Enable it before requesting Swagger documents.",
+        "requestFailed": "Swagger request failed with status {{status}}\n{{details}}",
+        "invalidDestinations": "swagger:getUrls returned an invalid destination list.",
+        "invalidDocument": "swagger:get returned an invalid OpenAPI document."
+      },
+      "messages": {
+        "empty": "No Swagger document namespaces are available.",
+        "saved": "Saved Swagger document to {{output}}."
+      },
+      "table": {
+        "name": "Name",
+        "namespace": "Namespace",
+        "url": "URL",
+        "field": "Field",
+        "value": "Value"
+      },
+      "fields": {
+        "namespace": "Namespace",
+        "title": "Title",
+        "version": "Version",
+        "openapi": "OpenAPI",
+        "paths": "Paths"
+      }
+    },
+    "portalInfo": {
+      "errors": {
+        "envNotConfigured": "Env \"{{envName}}\" is not configured. Run `nb env add {{envName}} --api-base-url <url>` first.",
+        "noEnvConfigured": "No NocoBase env is configured yet. Run `nb init --ui` to create one first.",
+        "notFound": "Portal \"{{portal}}\" was not found."
+      },
+      "fields": {
+        "name": "Name",
+        "url": "URL",
+        "portalType": "Portal type",
+        "developmentPath": "Development path",
+        "deploymentPath": "Deployment path",
+        "enabled": "Enabled"
+      }
+    },
+    "portalDestroy": {
+      "errors": {
+        "envNotConfigured": "Env \"{{envName}}\" is not configured. Run `nb env add {{envName}} --api-base-url <url>` first.",
+        "noEnvConfigured": "No NocoBase env is configured yet. Run `nb init --ui` to create one first.",
+        "confirmationRequired": "Refusing to destroy a portal in non-interactive mode without --yes.",
+        "outsideParent": "Refusing to delete a portal outside {{parentDir}}: {{portalDir}}",
+        "workspaceMissing": "Portal deployment path does not exist: {{portalDir}}\nPass --force to ignore missing deployment files.",
+        "unsupportedEnvKind": "Cannot destroy a portal for {{kind}} envs in the first version.",
+        "unsafeDevelopmentPath": "Refusing to delete an unsafe portal development path: {{portalDir}}",
+        "recordDestroyFailed": "Portal record destroy failed with status {{status}}\n{{details}}"
+      },
+      "prompts": {
+        "confirm": "Destroy portal \"{{portal}}\" and delete its deployment directory?"
+      },
+      "statuses": {
+        "deleted": "deleted",
+        "missing": "missing",
+        "retained": "retained"
+      },
+      "messages": {
+        "destroyed": "Portal \"{{portal}}\" destroyed.",
+        "mode": "Mode: {{mode}}",
+        "app": "App: {{app}}",
+        "base": "Base: {{base}}",
+        "record": "Record: {{status}}",
+        "deploymentPath": "Deployment path: {{status}} ({{dir}})",
+        "developmentPath": "Development path: {{status}} ({{dir}})",
+        "developmentPathMissing": "Development path: missing"
+      }
+    },
+    "portalDev": {
+      "errors": {
+        "envNotConfigured": "Env \"{{envName}}\" is not configured. Run `nb env add {{envName}} --api-base-url <url>` first.",
+        "noEnvConfigured": "No NocoBase env is configured yet. Run `nb init --ui` to create one first.",
+        "workspaceMissing": "Portal does not exist: {{portalDir}}\nRun `nb portal create {{portal}}` first.",
+        "packageJsonMissing": "Portal is invalid: package.json is missing in {{portalDir}}.",
+        "sshUnsupported": "Cannot start a portal in dev mode for ssh envs in the first version."
+      },
+      "messages": {
+        "starting": "Starting portal \"{{portal}}\"...",
+        "mode": "Mode: {{mode}}",
+        "app": "App: {{app}}",
+        "base": "Base: {{base}}",
+        "dir": "Dir: {{dir}}"
+      }
+    },
     "license": {
       "activate": {
         "interactive": {
@@ -267,7 +468,7 @@
           "betaLabel": "beta",
           "betaHint": "Preview release. Good for trying upcoming features before general release.",
           "alphaLabel": "alpha",
-          "alphaHint": "Development release. Includes the newest changes, but may be incomplete or unstable.",
+          "alphaHint": "Choose this version to try the new features in 3.0.",
           "otherLabel": "Other",
           "otherHint": "Enter another package version, Docker tag, or Git ref manually, such as a branch name."
         },
@@ -341,6 +542,21 @@
           "message": "App subpath (for example, /nocobase/)",
           "placeholder": "/ or /nocobase/"
         },
+        "portalType": {
+          "message": "Portal type",
+          "noCodeLabel": "No-code portal",
+          "noCodeHint": "Create with visual configuration. AI can help adjust the configuration. Path: /v/<name>",
+          "aiLabel": "AI portal",
+          "aiHint": "Create with AI Agent and code. Users can request changes in natural language. Path: /x/<name>"
+        },
+        "portalName": {
+          "message": "Portal name",
+          "placeholder": "admin"
+        },
+        "portalTemplate": {
+          "message": "Starter template (copied to ./storage/portals/)",
+          "placeholder": "git@github.com:nocobase/admin-starter.git"
+        },
         "storagePath": {
           "message": "Uploads and local files directory",
           "placeholder": "./<env>/storage/"
@@ -440,6 +656,30 @@
         },
         "skipDownload": {
           "message": "Skip downloading NocoBase and reuse existing local app files or Docker images"
+        },
+        "appClientEntryMode": {
+          "message": "App client entry mode",
+          "modernOnlyLabel": "Modern UI only",
+          "modernOnlyHint": "Only the modern UI is available; the legacy UI cannot be accessed.",
+          "modernDefaultLabel": "Modern UI by default",
+          "modernDefaultHint": "Open the modern UI by default while keeping the legacy UI available.",
+          "legacyDefaultLabel": "Legacy UI by default",
+          "legacyDefaultHint": "Open the legacy UI by default while keeping the modern UI available."
+        },
+        "portalType": {
+          "message": "Portal type",
+          "noCodeLabel": "No-code portal",
+          "noCodeHint": "Create with visual configuration. AI can help adjust the configuration. Path: /v/<name>",
+          "aiLabel": "AI portal",
+          "aiHint": "Create with AI Agent and code. Users can request changes in natural language. Path: /x/<name>"
+        },
+        "portalName": {
+          "message": "Portal name",
+          "placeholder": "admin"
+        },
+        "portalTemplate": {
+          "message": "Starter template (copied to ./storage/portals/)",
+          "placeholder": "git@github.com:nocobase/admin-starter.git"
         }
       },
       "webUi": {
@@ -462,6 +702,10 @@
           "title": "App source and version",
           "description": "Choose how to get the app and which source and version to use."
         },
+        "portalType": {
+          "title": "Configure portal",
+          "description": "Set the default portal name and type."
+        },
         "configureDatabase": {
           "title": "Configure the database",
           "description": "Use built-in or custom."