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

package/dist/types/locale/en.d.ts

@@ -35,6 +35,7 @@ export declare const EN_LOCALE: {
         optionUltramodernPackageSource: string;
         optionUltramodernPackageScope: string;
         optionUltramodernPackageNamePrefix: string;
+        optionVertical: string;
         optionSub: string;
         examples: string;
         example1: string;
@@ -47,6 +48,8 @@ export declare const EN_LOCALE: {
         example8: string;
         example9: string;
         example10: string;
+        example11: string;
+        example12: string;
         moreInfo: string;
     };
     version: {

package/dist/types/locale/index.d.ts

@@ -1,3 +1,118 @@
-declare const i18n: any;
-declare const localeKeys: any;
+import { I18n } from '@modern-js/i18n-utils';
+declare const i18n: I18n;
+declare const localeKeys: {
+    prompt: {
+        projectName: string;
+    };
+    error: {
+        projectNameEmpty: string;
+        directoryExists: string;
+        invalidRouter: string;
+        invalidBffRuntime: string;
+        createFailed: string;
+    };
+    message: {
+        welcome: string;
+        success: string;
+        nextSteps: string;
+        step1: string;
+        step2: string;
+        step3: string;
+    };
+    help: {
+        title: string;
+        description: string;
+        usage: string;
+        usageExample: string;
+        options: string;
+        optionHelp: string;
+        optionVersion: string;
+        optionLang: string;
+        optionRouter: string;
+        optionBff: string;
+        optionBffRuntime: string;
+        optionTailwind: string;
+        optionWorkspace: string;
+        optionUltramodernWorkspace: string;
+        optionUltramodernPackageSource: string;
+        optionUltramodernPackageScope: string;
+        optionUltramodernPackageNamePrefix: string;
+        optionVertical: string;
+        optionSub: string;
+        examples: string;
+        example1: string;
+        example2: string;
+        example3: string;
+        example4: string;
+        example5: string;
+        example6: string;
+        example7: string;
+        example8: string;
+        example9: string;
+        example10: string;
+        example11: string;
+        example12: string;
+        moreInfo: string;
+    };
+    version: {
+        message: string;
+    };
+} | {
+    prompt: {
+        projectName: string;
+    };
+    error: {
+        projectNameEmpty: string;
+        directoryExists: string;
+        invalidRouter: string;
+        invalidBffRuntime: string;
+        createFailed: string;
+    };
+    message: {
+        welcome: string;
+        success: string;
+        nextSteps: string;
+        step1: string;
+        step2: string;
+        step3: string;
+    };
+    help: {
+        title: string;
+        description: string;
+        usage: string;
+        usageExample: string;
+        options: string;
+        optionHelp: string;
+        optionVersion: string;
+        optionLang: string;
+        optionRouter: string;
+        optionBff: string;
+        optionBffRuntime: string;
+        optionTailwind: string;
+        optionWorkspace: string;
+        optionUltramodernWorkspace: string;
+        optionUltramodernPackageSource: string;
+        optionUltramodernPackageScope: string;
+        optionUltramodernPackageNamePrefix: string;
+        optionVertical: string;
+        optionSub: string;
+        examples: string;
+        example1: string;
+        example2: string;
+        example3: string;
+        example4: string;
+        example5: string;
+        example6: string;
+        example7: string;
+        example8: string;
+        example9: string;
+        example10: string;
+        example11: string;
+        example12: string;
+        moreInfo: string;
+    };
+    version: {
+        message: string;
+    };
+};
 export { i18n, localeKeys };

package/dist/types/locale/zh.d.ts

@@ -35,6 +35,7 @@ export declare const ZH_LOCALE: {
         optionUltramodernPackageSource: string;
         optionUltramodernPackageScope: string;
         optionUltramodernPackageNamePrefix: string;
+        optionVertical: string;
         optionSub: string;
         examples: string;
         example1: string;
@@ -47,6 +48,8 @@ export declare const ZH_LOCALE: {
         example8: string;
         example9: string;
         example10: string;
+        example11: string;
+        example12: string;
         moreInfo: string;
     };
     version: {

package/dist/types/ultramodern-checks/cli/i18n-check.d.ts

@@ -0,0 +1,9 @@
+type SingleAppI18nCheckOptions = {
+    readonly cwd?: string;
+    readonly targets?: readonly string[];
+};
+export declare const SINGLE_APP_I18N_SUCCESS = "No hardcoded user-visible JSX strings found.";
+export declare const SINGLE_APP_I18N_FAILURE = "Hardcoded user-visible JSX strings found. Move copy to locale JSON files.";
+export declare const runSingleAppI18nCheck: ({ cwd, targets, }?: SingleAppI18nCheckOptions) => number;
+export declare const main: () => void;
+export {};

package/dist/types/ultramodern-checks/cli/oxlint.d.ts

@@ -0,0 +1,22 @@
+type OxlintRuleConfig = string | readonly [
+    string,
+    {
+        readonly [key: string]: unknown;
+    }
+];
+type OxlintRules = {
+    readonly [ruleName: string]: OxlintRuleConfig;
+};
+type OxlintRulesOptions = {
+    readonly cwd: string;
+    readonly targets: readonly string[];
+    readonly rules: OxlintRules;
+};
+type OxlintRulesResult = {
+    readonly exitCode: number;
+    readonly stdout: string;
+    readonly stderr: string;
+};
+export declare const runOxlintRules: ({ cwd, targets, rules, }: OxlintRulesOptions) => OxlintRulesResult;
+export declare const printOxlintOutput: ({ stdout, stderr, }: OxlintRulesResult) => void;
+export {};

package/dist/types/ultramodern-checks/cli/workspace-source-check.d.ts

@@ -0,0 +1,8 @@
+type WorkspaceSourceCheckOptions = {
+    readonly cwd?: string;
+    readonly sourceRoots?: readonly string[];
+};
+export declare const WORKSPACE_SOURCE_SUCCESS = "UltraModern i18n and boundary guardrails validated";
+export declare const runWorkspaceSourceCheck: ({ cwd, sourceRoots, }?: WorkspaceSourceCheckOptions) => number;
+export declare const main: () => void;
+export {};

package/dist/types/ultramodern-checks/index.d.ts

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

package/dist/types/ultramodern-checks/oxlint-plugin.d.ts

@@ -0,0 +1,63 @@
+type AstNode = {
+    readonly type?: string;
+    readonly parent?: AstNode;
+    readonly loc?: {
+        readonly start?: {
+            readonly line?: number;
+        };
+        readonly end?: {
+            readonly line?: number;
+        };
+    };
+    readonly value?: unknown;
+    readonly raw?: unknown;
+    readonly name?: unknown;
+    readonly openingElement?: AstNode;
+    readonly expression?: AstNode;
+    readonly expressions?: readonly AstNode[];
+    readonly quasis?: readonly AstNode[];
+    readonly test?: AstNode;
+    readonly consequent?: AstNode;
+    readonly alternate?: AstNode;
+    readonly arguments?: readonly AstNode[];
+    readonly callee?: AstNode;
+    readonly object?: AstNode;
+    readonly property?: AstNode;
+    readonly computed?: boolean;
+};
+type RuleContext = {
+    readonly options?: readonly unknown[];
+    readonly filename?: string;
+    getSourceCode?: () => {
+        readonly text?: string;
+        getAllComments?: () => readonly AstNode[];
+        getText?: (node: AstNode) => string;
+    };
+    report: (descriptor: {
+        readonly node: AstNode;
+        readonly message: string;
+    }) => void;
+};
+type Rule = {
+    readonly meta: {
+        readonly type: string;
+        readonly docs: {
+            readonly description: string;
+        };
+        readonly schema: unknown[];
+    };
+    create(context: RuleContext): Record<string, (node: AstNode) => void>;
+};
+declare const plugin: {
+    meta: {
+        name: string;
+    };
+    rules: {
+        'no-hardcoded-jsx-text': Rule;
+        'no-legacy-mf-boundary-attributes': Rule;
+        'no-literal-visible-jsx-attributes': Rule;
+        'no-manual-locale-copy-branching': Rule;
+        'no-split-translation-keys': Rule;
+    };
+};
+export default plugin;

package/dist/types/ultramodern-package-source.d.ts

@@ -0,0 +1,28 @@
+export declare const WORKSPACE_PACKAGE_VERSION = "workspace:*";
+export declare const BLEEDINGDEV_CREATE_PACKAGE = "@bleedingdev/modern-js-create";
+export declare const BLEEDINGDEV_PACKAGE_SCOPE = "bleedingdev";
+export declare const BLEEDINGDEV_PACKAGE_NAME_PREFIX = "modern-js-";
+export declare const BLEEDINGDEV_FRAMEWORK_VERSION_ENV = "MODERN_CREATE_ULTRAMODERN_FRAMEWORK_VERSION";
+export declare const ULTRAMODERN_SINGLE_APP_MODERN_PACKAGES: readonly ['@modern-js/create', '@modern-js/runtime', '@modern-js/app-tools', '@modern-js/tsconfig', '@modern-js/plugin-i18n', '@modern-js/plugin-tanstack', '@modern-js/plugin-bff', '@modern-js/adapter-rstest'];
+export declare const ULTRAMODERN_WORKSPACE_MODERN_PACKAGES: readonly ['@modern-js/create', '@modern-js/app-tools', '@modern-js/plugin-bff', '@modern-js/plugin-i18n', '@modern-js/plugin-tanstack', '@modern-js/runtime'];
+export type UltramodernPackageSourceStrategy = 'workspace' | 'install';
+export type ResolvedUltramodernPackageSource = {
+    strategy: UltramodernPackageSourceStrategy;
+    modernPackageVersion: string;
+    registry?: string;
+    aliasScope?: string;
+    aliasPackageNamePrefix?: string;
+};
+export type UltramodernModernPackagesMetadata = {
+    packages: string[];
+    specifier: string;
+    registry?: string;
+    aliases?: Record<string, string>;
+};
+export declare function modernPackageVersion(packageSource: ResolvedUltramodernPackageSource): string;
+export declare function modernAliasPackageName(packageName: string, packageSource: ResolvedUltramodernPackageSource): string;
+export declare function modernPackageSpecifier(packageName: string, packageSource: ResolvedUltramodernPackageSource): string;
+export declare function modernPackageAliases(packageNames: readonly string[], packageSource: ResolvedUltramodernPackageSource): Record<string, string> | undefined;
+export declare function createModernPackagesMetadata(packageNames: readonly string[], packageSource: ResolvedUltramodernPackageSource, options?: {
+    includeAliases?: boolean;
+}): UltramodernModernPackagesMetadata;

package/dist/types/ultramodern-workspace.d.ts

@@ -1,8 +1,9 @@
-type UltramodernPackageSourceStrategy = 'workspace' | 'install';
+import { type UltramodernPackageSourceStrategy } from './ultramodern-package-source';
 export type UltramodernWorkspaceOptions = {
     targetDir: string;
     packageName: string;
     modernVersion: string;
+    enableTailwind?: boolean;
     packageSource?: {
         strategy?: UltramodernPackageSourceStrategy;
         modernPackageVersion?: string;
@@ -11,10 +12,19 @@ export type UltramodernWorkspaceOptions = {
         aliasPackageNamePrefix?: string;
     };
 };
+export type AddUltramodernVerticalOptions = {
+    workspaceRoot: string;
+    name: string;
+    modernVersion: string;
+    enableTailwind?: boolean;
+    packageSource?: UltramodernWorkspaceOptions['packageSource'];
+};
 export declare const ULTRAMODERN_WORKSPACE_FLAG = "--ultramodern-workspace";
+export declare function addUltramodernVertical(options: AddUltramodernVerticalOptions): void;
 export declare function generateUltramodernWorkspace(options: UltramodernWorkspaceOptions): void;
 export declare const ultramodernWorkspaceVersions: {
     tanstackRouter: string;
     moduleFederation: string;
+    tailwind: string;
+    tailwindPostcss: string;
 };
-export {};

package/package.json

@@ -21,14 +21,50 @@
   "engines": {
     "node": ">=20"
   },
-  "version": "3.2.0-ultramodern.11",
+  "version": "3.2.0-ultramodern.110",
   "types": "./dist/types/index.d.ts",
-  "main": "./dist/index.js",
+  "main": "./dist/esm-node/index.js",
   "bin": {
     "create": "bin/run.js"
   },
+  "typesVersions": {
+    "*": {
+      ".": [
+        "./dist/types/index.d.ts"
+      ],
+      "ultramodern-checks": [
+        "./dist/types/ultramodern-checks/index.d.ts"
+      ],
+      "ultramodern-checks/oxlint-plugin": [
+        "./dist/types/ultramodern-checks/oxlint-plugin.d.ts"
+      ]
+    }
+  },
   "exports": {
-    ".": "./dist/index.js"
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "node": {
+        "import": "./dist/esm-node/index.js",
+        "require": "./dist/cjs/index.cjs"
+      },
+      "default": "./dist/esm-node/index.js"
+    },
+    "./ultramodern-checks": {
+      "types": "./dist/types/ultramodern-checks/index.d.ts",
+      "node": {
+        "import": "./dist/esm-node/ultramodern-checks/index.js",
+        "require": "./dist/cjs/ultramodern-checks/index.cjs"
+      },
+      "default": "./dist/esm-node/ultramodern-checks/index.js"
+    },
+    "./ultramodern-checks/oxlint-plugin": {
+      "types": "./dist/types/ultramodern-checks/oxlint-plugin.d.ts",
+      "node": {
+        "import": "./dist/esm-node/ultramodern-checks/oxlint-plugin.js",
+        "require": "./dist/cjs/ultramodern-checks/oxlint-plugin.cjs"
+      },
+      "default": "./dist/esm-node/ultramodern-checks/oxlint-plugin.js"
+    }
   },
   "files": [
     "template",
@@ -36,12 +72,16 @@
     "dist",
     "bin.js"
   ],
+  "dependencies": {
+    "oxlint": "1.68.0"
+  },
   "devDependencies": {
     "@rslib/core": "0.21.5",
-    "@types/node": "^25.8.0",
-    "@typescript/native-preview": "7.0.0-dev.20260516.1",
-    "tsx": "^4.22.0",
-    "@modern-js/i18n-utils": "npm:@bleedingdev/modern-js-i18n-utils@3.2.0-ultramodern.11"
+    "@types/node": "^25.9.1",
+    "@typescript/native-preview": "7.0.0-dev.20260606.1",
+    "tsx": "^4.22.3",
+    "@modern-js/i18n-utils": "npm:@bleedingdev/modern-js-i18n-utils@3.2.0-ultramodern.110",
+    "@scripts/rstest-config": "2.66.0"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
@@ -49,11 +89,12 @@
   },
   "modern:source": "./src/index.ts",
   "scripts": {
-    "build": "rslib build && pnpm -w tsgo:dts \"$PWD\"",
-    "dev": "rslib build -w",
-    "start": "node ./dist/index.js"
+    "build": "rm -rf dist && rslib build -c rslibconfig.mts && pnpm -w tsgo:dts \"$PWD\"",
+    "dev": "rslib build -c rslibconfig.mts -w",
+    "start": "node ./dist/esm-node/index.js",
+    "test": "rm -rf dist && rslib build -c rslibconfig.mts && rstest --passWithNoTests"
   },
   "ultramodern": {
-    "frameworkVersion": "3.2.0-ultramodern.11"
+    "frameworkVersion": "3.2.0-ultramodern.110"
   }
 }

package/template/.codex/hooks.json

@@ -0,0 +1,16 @@
+{
+  "Stop": [
+    {
+      "command": "pnpm format && pnpm lint:fix && pnpm ultramodern:check",
+      "timeout": 600000,
+      "statusMessage": "Running UltraModern quality gates"
+    }
+  ],
+  "SubagentStop": [
+    {
+      "command": "pnpm format && pnpm lint:fix && pnpm ultramodern:check",
+      "timeout": 600000,
+      "statusMessage": "Running UltraModern quality gates"
+    }
+  ]
+}

package/template/.github/renovate.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "extends": [
+    "config:recommended",
+    "helpers:pinGitHubActionDigests"
+  ],
+  "dependencyDashboard": true,
+  "minimumReleaseAge": "1 day",
+  "prConcurrentLimit": 5,
+  "prHourlyLimit": 2,
+  "rangeStrategy": "bump",
+  "schedule": [
+    "before 5am on monday"
+  ],
+  "timezone": "Etc/UTC",
+  "packageRules": [
+    {
+      "matchManagers": [
+        "github-actions"
+      ],
+      "groupName": "github-actions",
+      "labels": [
+        "dependencies",
+        "github-actions",
+        "security"
+      ]
+    },
+    {
+      "matchManagers": [
+        "npm"
+      ],
+      "matchUpdateTypes": [
+        "patch",
+        "minor"
+      ],
+      "groupName": "npm minor and patch updates",
+      "labels": [
+        "dependencies",
+        "npm"
+      ]
+    },
+    {
+      "matchUpdateTypes": [
+        "major"
+      ],
+      "dependencyDashboardApproval": true,
+      "labels": [
+        "dependencies",
+        "major"
+      ]
+    }
+  ]
+}

package/template/.github/workflows/ultramodern-gates.yml.handlebars

@@ -4,27 +4,51 @@ on:
   push:
   pull_request:
 
+permissions:
+  contents: read
+
+defaults:
+  run:
+    shell: bash
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+concurrency:
+  group: ultramodern-gates-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
   ultramodern-gates:
     runs-on: ubuntu-latest
+    timeout-minutes: 20
     steps:
-      - name: Checkout
-        uses: actions/checkout@v4
+      - name: Harden Runner
+        uses: step-security/harden-runner@ab7a9404c0f3da075243ca237b5fac12c98deaa5 # v2
+        with:
+          egress-policy: audit
 
-      - name: Setup pnpm
-        uses: pnpm/action-setup@v4
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          fetch-depth: 1
+          persist-credentials: false
 
       - name: Setup Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
         with:
-          node-version: 20
-          cache: pnpm
+          node-version: 24
+
+      - name: Setup mise
+        uses: jdx/mise-action@5ac50f778e26fac95da98d50503682459e86d566 # v3.2.0
 
       - name: Install Dependencies
-        run: pnpm install
+        run: mise exec -- pnpm install --frozen-lockfile
 
       - name: Validate Ultramodern Contract
-        run: pnpm run ultramodern:check
+        run: mise exec -- pnpm run ultramodern:check
 
       - name: Build
-        run: pnpm run build
+        env:
+          MODERN_PUBLIC_SITE_URL: http://localhost:8080
+        run: mise exec -- pnpm run build

package/template/.mise.toml.handlebars

@@ -0,0 +1,2 @@
+[tools]
+pnpm = "{{pnpmVersion}}"

package/template/AGENTS.md

@@ -7,14 +7,17 @@ This project is generated for Codex-first UltraModern.js work.
 - `pnpm lint` runs Oxlint with the Ultracite preset.
 - `pnpm format` runs oxfmt.
 - `pnpm typecheck` runs effect-tsgo as the TypeScript checker.
+- `pnpm i18n:check` rejects hardcoded user-visible JSX text.
 - `pnpm ultramodern:check` verifies the generated contract.
+- Generated Codex stop hooks and subagent-stop hooks run `pnpm format && pnpm lint:fix && pnpm ultramodern:check`.
+- `postinstall` formats the generated tree, installs private orchestration skills when available, initializes a Git repository when needed, and installs `lefthook`. Generated `lefthook.yml` runs `pnpm format && pnpm lint:fix && pnpm ultramodern:check` on pre-commit; pre-push runs `pnpm ultramodern:check`.
 
-## Private Skills
+## Internationalization
+
+Runtime i18n is enabled by default. Agents must put user-visible UI copy in `config/public/locales/<lang>/translation.json` and render it through `react-i18next` or `@modern-js/plugin-i18n/runtime`. Do not add hardcoded JSX text, `aria-label`, `title`, `alt`, or `placeholder` strings unless the value is a non-translatable technical token.
 
-Private orchestration skills are not vendored into this template. If you are authorized for `TechsioCZ/skills`, run:
+Routes are locale-prefixed by default through `localePathRedirect: true`. Keep localized pages under `src/routes/[lang]`, use links for language switching, and preserve canonical plus `hreflang` metadata. Production builds fail unless `MODERN_PUBLIC_SITE_URL` is set, so deployed canonical URLs always use the production origin.
 
-```bash
-pnpm skills:install
-```
+## Private Skills
 
-The installer clones that private repository and copies only the allowlisted skills from `.agents/skills-lock.json`.
+Private orchestration skills are installed automatically during `pnpm install` when the current developer is authorized for `TechsioCZ/skills`. The installer clones that private repository and copies only the allowlisted skills from `.agents/skills-lock.json`; unauthorized developers get a warning and can continue with the public contract.