@bleedingdev/modern-js-create 3.2.0-ultramodern.11 → 3.2.0-ultramodern.110

package/dist/esm/locale/en.js

@@ -0,0 +1,59 @@
+const EN_LOCALE = {
+    prompt: {
+        projectName: 'Please enter project name: '
+    },
+    error: {
+        projectNameEmpty: 'Error: Project name cannot be empty',
+        directoryExists: 'Error: Directory "{projectName}" already exists and is not empty',
+        invalidRouter: 'Error: Unsupported router "{router}". Use "react-router" or "tanstack".',
+        invalidBffRuntime: 'Error: Unsupported BFF runtime "{runtime}". Use "hono" or "effect".',
+        createFailed: 'Error creating project:'
+    },
+    message: {
+        welcome: '🚀 Welcome to UltraModern.js',
+        success: '✨ Created successfully!',
+        nextSteps: '📋 Next steps:',
+        step1: 'cd {projectName}',
+        step2: 'pnpm install',
+        step3: 'pnpm dev'
+    },
+    help: {
+        title: '🚀 UltraModern.js Project Creator',
+        description: 'Create a new UltraModern.js app with TanStack Router and Effect BFF by default',
+        usage: '📖 Usage:',
+        usageExample: '  pnpm dlx @bleedingdev/modern-js-create [project-name] [options]',
+        options: '⚙️  Options:',
+        optionHelp: '  -h, --help     Display this help message',
+        optionVersion: '  -v, --version  Display version information',
+        optionLang: '  -l, --lang     Set the language (zh or en)',
+        optionRouter: '  -r, --router   Select router framework (tanstack default; react-router is compatibility mode)',
+        optionBff: '      --bff      Keep Effect BFF enabled (default for UltraModern apps)',
+        optionBffRuntime: '      --bff-runtime Select BFF runtime (hono or effect)',
+        optionTailwind: '      --no-tailwind Disable default Tailwind CSS v4 scaffold',
+        optionWorkspace: '      --workspace Use workspace protocol for @modern-js dependencies (for local monorepo testing)',
+        optionUltramodernWorkspace: '      --ultramodern-workspace Generate an UltraModern SuperApp workspace (default is a full UltraModern single app)',
+        optionUltramodernPackageSource: '      --ultramodern-package-source Select UltraModern package source (workspace or install; BleedingDev defaults to install aliases)',
+        optionUltramodernPackageScope: '      --ultramodern-package-scope Publish scope for npm alias installs (for example bleedingdev)',
+        optionUltramodernPackageNamePrefix: '      --ultramodern-package-name-prefix Prefix for npm alias package names (default: modern-js-)',
+        optionVertical: '      --vertical Mutate the current existing UltraModern workspace and wire a MicroVertical named <project-name>',
+        optionSub: '  -s, --sub       Mark as a subproject (package in monorepo)',
+        examples: '💡 Examples:',
+        example1: '  pnpm dlx @bleedingdev/modern-js-create my-app',
+        example2: '  pnpm dlx @bleedingdev/modern-js-create my-app --lang zh',
+        example3: '  pnpm dlx @bleedingdev/modern-js-create my-app --sub',
+        example4: '  pnpm dlx @bleedingdev/modern-js-create --help',
+        example5: '  pnpm dlx @bleedingdev/modern-js-create .',
+        example6: '  pnpm dlx @bleedingdev/modern-js-create my-app --router react-router --no-tailwind',
+        example7: '  pnpm dlx @bleedingdev/modern-js-create my-app --bff-runtime hono',
+        example8: '  pnpm dlx @bleedingdev/modern-js-create my-app --workspace',
+        example9: '  pnpm dlx @bleedingdev/modern-js-create my-super-app --ultramodern-workspace',
+        example10: '  pnpm dlx @bleedingdev/modern-js-create my-app --no-tailwind',
+        example11: '  pnpm dlx @bleedingdev/modern-js-create my-app --router react-router # compatibility mode',
+        example12: '  pnpm dlx @bleedingdev/modern-js-create catalog --vertical',
+        moreInfo: '📚 Learn more: https://modernjs.dev'
+    },
+    version: {
+        message: '@bleedingdev/modern-js-create version: {version}'
+    }
+};
+export { EN_LOCALE };

package/dist/esm/locale/index.js

@@ -0,0 +1,9 @@
+import { I18n } from "@modern-js/i18n-utils";
+import { EN_LOCALE } from "./en.js";
+import { ZH_LOCALE } from "./zh.js";
+const i18n = new I18n();
+const localeKeys = i18n.init('en', {
+    zh: ZH_LOCALE,
+    en: EN_LOCALE
+});
+export { i18n, localeKeys };

package/dist/esm/locale/zh.js

@@ -0,0 +1,59 @@
+const ZH_LOCALE = {
+    prompt: {
+        projectName: '请输入项目名称: '
+    },
+    error: {
+        projectNameEmpty: '错误: 项目名称不能为空',
+        directoryExists: '错误: 目录 "{projectName}" 已存在且不为空',
+        invalidRouter: '错误: 不支持的路由器 "{router}"，请使用 "react-router" 或 "tanstack"',
+        invalidBffRuntime: '错误: 不支持的 BFF 运行时 "{runtime}"，请使用 "hono" 或 "effect"',
+        createFailed: '创建项目时出错:'
+    },
+    message: {
+        welcome: '🚀 欢迎使用 UltraModern.js',
+        success: '✨ 创建成功！',
+        nextSteps: '📋 下一步：',
+        step1: 'cd {projectName}',
+        step2: 'pnpm install',
+        step3: 'pnpm dev'
+    },
+    help: {
+        title: '🚀 UltraModern.js 项目创建工具',
+        description: '创建默认包含 TanStack Router 和 Effect BFF 的 UltraModern.js 应用',
+        usage: '📖 用法:',
+        usageExample: '  pnpm dlx @bleedingdev/modern-js-create [项目名称] [选项]',
+        options: '⚙️  选项:',
+        optionHelp: '  -h, --help     显示帮助信息',
+        optionVersion: '  -v, --version  显示版本信息',
+        optionLang: '  -l, --lang     设置语言 (zh 或 en)',
+        optionRouter: '  -r, --router   选择路由框架（默认 tanstack；react-router 为兼容模式）',
+        optionBff: '      --bff      保持启用 Effect BFF（UltraModern 应用默认值）',
+        optionBffRuntime: '      --bff-runtime 选择 BFF 运行时（hono 或 effect）',
+        optionTailwind: '      --no-tailwind 禁用默认 Tailwind CSS v4 模板',
+        optionWorkspace: '      --workspace 对 @modern-js 依赖使用 workspace 协议（用于本地 monorepo 联调）',
+        optionUltramodernWorkspace: '      --ultramodern-workspace 生成 UltraModern SuperApp 工作区（默认创建完整 UltraModern 单应用）',
+        optionUltramodernPackageSource: '      --ultramodern-package-source 选择 UltraModern 依赖来源（workspace 或 install；BleedingDev 默认使用 install alias）',
+        optionUltramodernPackageScope: '      --ultramodern-package-scope npm alias 安装使用的发布 scope（例如 bleedingdev）',
+        optionUltramodernPackageNamePrefix: '      --ultramodern-package-name-prefix npm alias 包名前缀（默认：modern-js-）',
+        optionVertical: '      --vertical 修改当前已有的 UltraModern 工作区，并接入名为 <项目名称> 的 MicroVertical',
+        optionSub: '  -s, --sub       标记为子项目（monorepo 中的子包）',
+        examples: '💡 示例:',
+        example1: '  pnpm dlx @bleedingdev/modern-js-create my-app',
+        example2: '  pnpm dlx @bleedingdev/modern-js-create my-app --lang zh',
+        example3: '  pnpm dlx @bleedingdev/modern-js-create my-app --sub',
+        example4: '  pnpm dlx @bleedingdev/modern-js-create --help',
+        example5: '  pnpm dlx @bleedingdev/modern-js-create .',
+        example6: '  pnpm dlx @bleedingdev/modern-js-create my-app --router react-router --no-tailwind',
+        example7: '  pnpm dlx @bleedingdev/modern-js-create my-app --bff-runtime hono',
+        example8: '  pnpm dlx @bleedingdev/modern-js-create my-app --workspace',
+        example9: '  pnpm dlx @bleedingdev/modern-js-create my-super-app --ultramodern-workspace',
+        example10: '  pnpm dlx @bleedingdev/modern-js-create my-app --no-tailwind',
+        example11: '  pnpm dlx @bleedingdev/modern-js-create my-app --router react-router # 兼容模式',
+        example12: '  pnpm dlx @bleedingdev/modern-js-create catalog --vertical',
+        moreInfo: '📚 更多信息: https://modernjs.dev'
+    },
+    version: {
+        message: '@bleedingdev/modern-js-create 版本: {version}'
+    }
+};
+export { ZH_LOCALE };

package/dist/esm/ultramodern-checks/cli/i18n-check.js

@@ -0,0 +1,26 @@
+import { printOxlintOutput, runOxlintRules } from "./oxlint.js";
+const SINGLE_APP_I18N_SUCCESS = 'No hardcoded user-visible JSX strings found.';
+const SINGLE_APP_I18N_FAILURE = 'Hardcoded user-visible JSX strings found. Move copy to locale JSON files.';
+const runSingleAppI18nCheck = ({ cwd = process.cwd(), targets = [
+    'src'
+] } = {})=>{
+    const result = runOxlintRules({
+        cwd,
+        targets,
+        rules: {
+            'ultramodern/no-hardcoded-jsx-text': 'error',
+            'ultramodern/no-literal-visible-jsx-attributes': 'error'
+        }
+    });
+    if (0 === result.exitCode) {
+        console.log(SINGLE_APP_I18N_SUCCESS);
+        return 0;
+    }
+    console.error(SINGLE_APP_I18N_FAILURE);
+    printOxlintOutput(result);
+    return result.exitCode;
+};
+const main = ()=>{
+    process.exitCode = runSingleAppI18nCheck();
+};
+export { SINGLE_APP_I18N_FAILURE, SINGLE_APP_I18N_SUCCESS, main, runSingleAppI18nCheck };

package/dist/esm/ultramodern-checks/cli/oxlint.js

@@ -0,0 +1,118 @@
+import { spawnSync } from "node:child_process";
+import node_fs from "node:fs";
+import { createRequire } from "node:module";
+import node_os from "node:os";
+import node_path from "node:path";
+import { fileURLToPath } from "node:url";
+const oxlint_require = createRequire(import.meta.url);
+const ignoredDirectories = new Set([
+    '.modern',
+    '.modernjs',
+    '.output',
+    'dist',
+    'node_modules'
+]);
+const packageNames = new Set([
+    '@modern-js/create',
+    '@bleedingdev/modern-js-create'
+]);
+const resolveExistingPath = (candidates)=>candidates.find((candidate)=>node_fs.existsSync(candidate));
+const findPackageRoot = ()=>{
+    let directory = node_path.dirname(fileURLToPath(import.meta.url));
+    while(directory !== node_path.dirname(directory)){
+        const packageJsonPath = node_path.join(directory, 'package.json');
+        if (node_fs.existsSync(packageJsonPath)) try {
+            const packageJson = JSON.parse(node_fs.readFileSync(packageJsonPath, 'utf-8'));
+            if (packageNames.has(packageJson.name)) return directory;
+        } catch  {
+            return directory;
+        }
+        directory = node_path.dirname(directory);
+    }
+    throw new Error('Unable to resolve @modern-js/create package root.');
+};
+const resolvePluginPath = ()=>{
+    const root = findPackageRoot();
+    const sourcePluginPath = node_path.join(root, 'src/ultramodern-checks/oxlint-plugin.ts');
+    const pluginPath = resolveExistingPath([
+        node_path.join(root, 'dist/esm-node/ultramodern-checks/oxlint-plugin.mjs'),
+        node_path.join(root, 'dist/esm-node/ultramodern-checks/oxlint-plugin.js'),
+        node_path.join(root, 'dist/esm/ultramodern-checks/oxlint-plugin.mjs'),
+        node_path.join(root, 'dist/esm/ultramodern-checks/oxlint-plugin.js'),
+        node_path.join(root, 'dist/cjs/ultramodern-checks/oxlint-plugin.js'),
+        node_path.join(root, 'dist/cjs/ultramodern-checks/oxlint-plugin.cjs'),
+        sourcePluginPath
+    ]);
+    if (!pluginPath) throw new Error('Unable to resolve @modern-js/create UltraModern Oxlint plugin.');
+    return pluginPath;
+};
+const resolveOxlintBin = ()=>{
+    const packageJsonPath = oxlint_require.resolve('oxlint/package.json');
+    const packageJson = JSON.parse(node_fs.readFileSync(packageJsonPath, 'utf-8'));
+    const binRelativePath = 'string' == typeof packageJson.bin ? packageJson.bin : packageJson.bin?.oxlint;
+    if (!binRelativePath) throw new Error('Unable to resolve oxlint binary.');
+    return node_path.join(node_path.dirname(packageJsonPath), binRelativePath);
+};
+const existingTargets = (cwd, targets)=>targets.map((target)=>node_path.resolve(cwd, target)).filter((target)=>node_fs.existsSync(target));
+const containsLintableSource = (filePath)=>{
+    if (!node_fs.existsSync(filePath)) return false;
+    const stats = node_fs.statSync(filePath);
+    if (stats.isFile()) return /\.(?:js|jsx|ts|tsx)$/u.test(filePath) && !filePath.endsWith('.d.ts');
+    if (!stats.isDirectory()) return false;
+    for (const entry of node_fs.readdirSync(filePath, {
+        withFileTypes: true
+    }))if (!(entry.isDirectory() && ignoredDirectories.has(entry.name))) {
+        if (containsLintableSource(node_path.join(filePath, entry.name))) return true;
+    }
+    return false;
+};
+const runOxlintRules = ({ cwd, targets, rules })=>{
+    const resolvedTargets = existingTargets(cwd, targets);
+    if (0 === resolvedTargets.length || !resolvedTargets.some((target)=>containsLintableSource(target))) return {
+        exitCode: 0,
+        stdout: '',
+        stderr: ''
+    };
+    const tempDir = node_fs.mkdtempSync(node_path.join(node_os.tmpdir(), 'ultramodern-oxlint-'));
+    const configPath = node_path.join(tempDir, 'oxlint.config.mjs');
+    const pluginPath = resolvePluginPath();
+    node_fs.writeFileSync(configPath, `export default {
+  jsPlugins: [${JSON.stringify(pluginPath)}],
+  rules: ${JSON.stringify(rules, null, 2)}
+};
+`, 'utf-8');
+    try {
+        const result = spawnSync(process.execPath, [
+            resolveOxlintBin(),
+            ...resolvedTargets,
+            '--config',
+            configPath,
+            '--format',
+            'unix',
+            '--quiet'
+        ], {
+            cwd,
+            encoding: 'utf-8',
+            stdio: [
+                'ignore',
+                'pipe',
+                'pipe'
+            ]
+        });
+        return {
+            exitCode: result.status ?? 1,
+            stdout: result.stdout ?? '',
+            stderr: result.stderr ?? ''
+        };
+    } finally{
+        node_fs.rmSync(tempDir, {
+            recursive: true,
+            force: true
+        });
+    }
+};
+const printOxlintOutput = ({ stdout, stderr })=>{
+    if (stdout) process.stdout.write(stdout);
+    if (stderr) process.stderr.write(stderr);
+};
+export { printOxlintOutput, runOxlintRules };

package/dist/esm/ultramodern-checks/cli/workspace-source-check.js

@@ -0,0 +1,124 @@
+import node_fs from "node:fs";
+import node_path from "node:path";
+import { printOxlintOutput, runOxlintRules } from "./oxlint.js";
+const WORKSPACE_SOURCE_SUCCESS = 'UltraModern i18n and boundary guardrails validated';
+const ignoredDirectories = new Set([
+    '.modern',
+    '.modernjs',
+    '.output',
+    'dist',
+    'node_modules'
+]);
+const normalizePath = (filePath)=>filePath.replaceAll('\\', '/');
+const relativePath = (root, filePath)=>normalizePath(node_path.relative(root, filePath));
+const walk = (directory, files = [])=>{
+    if (!node_fs.existsSync(directory)) return files;
+    for (const entry of node_fs.readdirSync(directory, {
+        withFileTypes: true
+    })){
+        if (entry.isDirectory() && ignoredDirectories.has(entry.name)) continue;
+        const entryPath = node_path.join(directory, entry.name);
+        if (entry.isDirectory()) {
+            walk(entryPath, files);
+            continue;
+        }
+        if (entry.isFile()) files.push(entryPath);
+    }
+    return files;
+};
+const isSourceFile = (filePath)=>/\.(?:ts|tsx|js|jsx)$/u.test(filePath);
+const isLocaleJson = (root, filePath)=>/\/locales\/(?:en|cs)\/[^/]+\.json$/u.test(`/${relativePath(root, filePath)}`);
+const readText = (filePath)=>node_fs.readFileSync(filePath, 'utf-8');
+const checkRuntimeResources = (root, filePath, text)=>{
+    const relative = relativePath(root, filePath);
+    if (!relative.endsWith('/src/modern.runtime.ts')) return;
+    const importsLocaleResources = /import\s+csResource\s+from\s+['"]\.\.\/locales\/cs\/[^'"]+\.json['"]/u.test(text) && /import\s+enResource\s+from\s+['"]\.\.\/locales\/en\/[^'"]+\.json['"]/u.test(text);
+    if (!importsLocaleResources || !/initOptions\s*:\s*\{[\s\S]*?\bresources\s*,/u.test(text)) throw new Error(`${relative} must register locale JSON resources in modern.runtime.ts so Worker SSR and hydration use the same first-render translations.`);
+};
+const visitLocaleKeys = (value, visitor, pathParts = [])=>{
+    if (!value || 'object' != typeof value || Array.isArray(value)) return;
+    for (const [key, child] of Object.entries(value)){
+        const nextPath = [
+            ...pathParts,
+            key
+        ];
+        visitor(key, child, nextPath);
+        visitLocaleKeys(child, visitor, nextPath);
+    }
+};
+const checkPluralResources = (root, filePath, json)=>{
+    const relative = relativePath(root, filePath);
+    const language = relative.split('/locales/')[1]?.split('/')[0];
+    const requiredSuffixes = 'cs' === language ? [
+        'one',
+        'few',
+        'many',
+        'other'
+    ] : [
+        'one',
+        'other'
+    ];
+    const groups = new Map();
+    visitLocaleKeys(json, (key, value, pathParts)=>{
+        if ('string' != typeof value || !value.includes('{{count}}')) return;
+        const suffixMatch = key.match(/^(.*)_(one|few|many|other)$/u);
+        if (!suffixMatch) throw new Error(`${relative} key ${pathParts.join('.')} contains {{count}} but is not plural-suffixed.`);
+        const [, base = '', suffix = ''] = suffixMatch;
+        const parentPath = pathParts.slice(0, -1).join('.');
+        const groupKey = `${parentPath}.${base}`;
+        const existing = groups.get(groupKey) ?? new Set();
+        existing.add(suffix);
+        groups.set(groupKey, existing);
+    });
+    for (const [group, suffixes] of groups)for (const suffix of requiredSuffixes)if (!suffixes.has(suffix)) throw new Error(`${relative} plural group ${group} is missing _${suffix}.`);
+};
+const runRuntimeAndLocaleResourceChecks = (root, sourceRoots)=>{
+    const files = sourceRoots.flatMap((sourceRoot)=>walk(node_path.join(root, sourceRoot)));
+    for (const filePath of files.filter(isSourceFile))checkRuntimeResources(root, filePath, readText(filePath));
+    for (const filePath of files.filter((filePath)=>isLocaleJson(root, filePath)))checkPluralResources(root, filePath, JSON.parse(readText(filePath)));
+};
+const runWorkspaceSourceCheck = ({ cwd = process.cwd(), sourceRoots = [
+    'apps',
+    'verticals'
+] } = {})=>{
+    const oxlintResult = runOxlintRules({
+        cwd,
+        targets: sourceRoots,
+        rules: {
+            'ultramodern/no-legacy-mf-boundary-attributes': 'error',
+            'ultramodern/no-literal-visible-jsx-attributes': [
+                'error',
+                {
+                    visibleAttributes: [
+                        'aria-label',
+                        "aria-description",
+                        "aria-roledescription",
+                        'aria-valuetext',
+                        'alt',
+                        'label',
+                        'placeholder',
+                        'title'
+                    ]
+                }
+            ],
+            'ultramodern/no-manual-locale-copy-branching': 'error',
+            'ultramodern/no-split-translation-keys': 'error'
+        }
+    });
+    if (0 !== oxlintResult.exitCode) {
+        printOxlintOutput(oxlintResult);
+        return oxlintResult.exitCode;
+    }
+    try {
+        runRuntimeAndLocaleResourceChecks(cwd, sourceRoots);
+    } catch (error) {
+        console.error(error instanceof Error ? error.message : 'UltraModern workspace source checks failed.');
+        return 1;
+    }
+    console.log(WORKSPACE_SOURCE_SUCCESS);
+    return 0;
+};
+const main = ()=>{
+    process.exitCode = runWorkspaceSourceCheck();
+};
+export { WORKSPACE_SOURCE_SUCCESS, main, runWorkspaceSourceCheck };

package/dist/esm/ultramodern-checks/index.js

@@ -0,0 +1,3 @@
+export { runSingleAppI18nCheck } from "./cli/i18n-check.js";
+export { runWorkspaceSourceCheck } from "./cli/workspace-source-check.js";
+export { default as oxlintPlugin } from "./oxlint-plugin.js";