@bleedingdev/modern-js-create 3.2.0-ultramodern.12 → 3.2.0-ultramodern.120

package/dist/types/create-package-root.d.ts

@@ -0,0 +1 @@
+export declare function resolveCreatePackageRoot(fromDir: string): string;

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

@@ -1,12 +1,12 @@
 export declare const EN_LOCALE: {
     prompt: {
         projectName: string;
+        legacyModernJsConfirmation: string;
     };
     error: {
         projectNameEmpty: string;
         directoryExists: string;
-        invalidRouter: string;
-        invalidBffRuntime: string;
+        legacyModernJsNotConfirmed: string;
         createFailed: string;
     };
     message: {
@@ -16,6 +16,7 @@ export declare const EN_LOCALE: {
         step1: string;
         step2: string;
         step3: string;
+        legacyModernJsWarning: string;
     };
     help: {
         title: string;
@@ -26,16 +27,13 @@ export declare const EN_LOCALE: {
         optionHelp: string;
         optionVersion: string;
         optionLang: string;
-        optionRouter: string;
-        optionBff: string;
-        optionBffRuntime: string;
         optionTailwind: string;
         optionWorkspace: string;
-        optionUltramodernWorkspace: string;
         optionUltramodernPackageSource: string;
         optionUltramodernPackageScope: string;
         optionUltramodernPackageNamePrefix: string;
-        optionSub: string;
+        optionVertical: string;
+        optionLegacyModernJs: string;
         examples: string;
         example1: string;
         example2: string;
@@ -47,6 +45,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,112 @@
-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;
+        legacyModernJsConfirmation: string;
+    };
+    error: {
+        projectNameEmpty: string;
+        directoryExists: string;
+        legacyModernJsNotConfirmed: string;
+        createFailed: string;
+    };
+    message: {
+        welcome: string;
+        success: string;
+        nextSteps: string;
+        step1: string;
+        step2: string;
+        step3: string;
+        legacyModernJsWarning: string;
+    };
+    help: {
+        title: string;
+        description: string;
+        usage: string;
+        usageExample: string;
+        options: string;
+        optionHelp: string;
+        optionVersion: string;
+        optionLang: string;
+        optionTailwind: string;
+        optionWorkspace: string;
+        optionUltramodernPackageSource: string;
+        optionUltramodernPackageScope: string;
+        optionUltramodernPackageNamePrefix: string;
+        optionVertical: string;
+        optionLegacyModernJs: 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;
+        legacyModernJsConfirmation: string;
+    };
+    error: {
+        projectNameEmpty: string;
+        directoryExists: string;
+        legacyModernJsNotConfirmed: string;
+        createFailed: string;
+    };
+    message: {
+        welcome: string;
+        success: string;
+        nextSteps: string;
+        step1: string;
+        step2: string;
+        step3: string;
+        legacyModernJsWarning: string;
+    };
+    help: {
+        title: string;
+        description: string;
+        usage: string;
+        usageExample: string;
+        options: string;
+        optionHelp: string;
+        optionVersion: string;
+        optionLang: string;
+        optionTailwind: string;
+        optionWorkspace: string;
+        optionUltramodernPackageSource: string;
+        optionUltramodernPackageScope: string;
+        optionUltramodernPackageNamePrefix: string;
+        optionVertical: string;
+        optionLegacyModernJs: 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

@@ -1,12 +1,12 @@
 export declare const ZH_LOCALE: {
     prompt: {
         projectName: string;
+        legacyModernJsConfirmation: string;
     };
     error: {
         projectNameEmpty: string;
         directoryExists: string;
-        invalidRouter: string;
-        invalidBffRuntime: string;
+        legacyModernJsNotConfirmed: string;
         createFailed: string;
     };
     message: {
@@ -16,6 +16,7 @@ export declare const ZH_LOCALE: {
         step1: string;
         step2: string;
         step3: string;
+        legacyModernJsWarning: string;
     };
     help: {
         title: string;
@@ -26,16 +27,13 @@ export declare const ZH_LOCALE: {
         optionHelp: string;
         optionVersion: string;
         optionLang: string;
-        optionRouter: string;
-        optionBff: string;
-        optionBffRuntime: string;
         optionTailwind: string;
         optionWorkspace: string;
-        optionUltramodernWorkspace: string;
         optionUltramodernPackageSource: string;
         optionUltramodernPackageScope: string;
         optionUltramodernPackageNamePrefix: string;
-        optionSub: string;
+        optionVertical: string;
+        optionLegacyModernJs: string;
         examples: string;
         example1: string;
         example2: string;
@@ -47,6 +45,8 @@ export declare const ZH_LOCALE: {
         example8: string;
         example9: string;
         example10: string;
+        example11: string;
+        example12: string;
         moreInfo: string;
     };
     version: {

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/code-tools', '@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/code-tools', '@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,18 @@ export type UltramodernWorkspaceOptions = {
         aliasPackageNamePrefix?: string;
     };
 };
-export declare const ULTRAMODERN_WORKSPACE_FLAG = "--ultramodern-workspace";
+export type AddUltramodernVerticalOptions = {
+    workspaceRoot: string;
+    name: string;
+    modernVersion: string;
+    enableTailwind?: boolean;
+    packageSource?: UltramodernWorkspaceOptions['packageSource'];
+};
+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,27 +21,44 @@
   "engines": {
     "node": ">=20"
   },
-  "version": "3.2.0-ultramodern.12",
+  "version": "3.2.0-ultramodern.120",
   "types": "./dist/types/index.d.ts",
-  "main": "./dist/index.js",
+  "main": "./dist/esm-node/index.js",
   "bin": {
-    "create": "bin/run.js"
+    "create": "bin/run.js",
+    "modern-js-create": "bin/run.js"
+  },
+  "typesVersions": {
+    "*": {
+      ".": [
+        "./dist/types/index.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"
+    }
   },
   "files": [
-    "template",
     "template-workspace",
     "dist",
-    "bin.js"
+    "bin"
   ],
+  "dependencies": {
+    "@modern-js/i18n-utils": "npm:@bleedingdev/modern-js-i18n-utils@3.2.0-ultramodern.120"
+  },
   "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.12"
+    "@rslib/core": "0.22.0",
+    "@types/node": "^25.9.3",
+    "@typescript/native-preview": "7.0.0-dev.20260610.1",
+    "tsx": "^4.22.4",
+    "@scripts/rstest-config": "2.66.0"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
@@ -49,11 +66,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.12"
+    "frameworkVersion": "3.2.0-ultramodern.120"
   }
 }

package/template-workspace/.agents/agent-reference-repos.json

@@ -0,0 +1,24 @@
+{
+  "schemaVersion": 1,
+  "defaultEnabled": true,
+  "strategy": "git-subtree-squash",
+  "installDir": "repos",
+  "repositories": [
+    {
+      "id": "effect",
+      "name": "Effect",
+      "url": "https://github.com/Effect-TS/effect.git",
+      "ref": "main",
+      "path": "repos/effect",
+      "readOnly": true
+    },
+    {
+      "id": "ultramodern-js",
+      "name": "UltraModern.js",
+      "url": "https://github.com/BleedingDev/ultramodern.js.git",
+      "ref": "main-ultramodern",
+      "path": "repos/ultramodern.js",
+      "readOnly": true
+    }
+  ]
+}

package/template-workspace/.agents/skills-lock.json

@@ -17,6 +17,20 @@
       "licensePath": ".agents/rstackjs-agent-skills-LICENSE",
       "install": "vendored"
     },
+    {
+      "id": "module-federation-agent-skills",
+      "visibility": "public",
+      "repository": "https://github.com/module-federation/agent-skills",
+      "commit": "07bb5b6c43ad457609e00c081b72d4c42508ec76",
+      "install": "clone",
+      "baseline": [
+        {
+          "name": "mf",
+          "path": ".agents/skills/mf",
+          "reason": "Module Federation docs, config inspection, type checking, shared dependency checks, and observability troubleshooting"
+        }
+      ]
+    },
     {
       "id": "techsiocz-private",
       "visibility": "private",
@@ -81,6 +95,11 @@
       "name": "rstest-best-practices",
       "path": ".agents/skills/rstest-best-practices",
       "reason": "Rstest configuration, test writing, mocking, snapshots, coverage, and CI behavior"
+    },
+    {
+      "name": "mf",
+      "path": ".agents/skills/mf",
+      "reason": "Module Federation docs, config inspection, type checking, shared dependency checks, and observability troubleshooting"
     }
   ],
   "excludedByDefault": [

package/template-workspace/.codex/hooks.json

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

package/template-workspace/.github/renovate.json

@@ -0,0 +1,29 @@
+{
+  "$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-workspace/.github/workflows/ultramodern-workspace-gates.yml.handlebars

@@ -0,0 +1,70 @@
+name: Ultramodern Workspace Gates
+
+on:
+  push:
+  pull_request:
+
+permissions:
+  contents: read
+
+defaults:
+  run:
+    shell: bash
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+concurrency:
+  group: ultramodern-workspace-gates-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  workspace-gate:
+    name: ${{ matrix.name }}
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - name: Format
+            command: pnpm format:check
+          - name: Lint
+            command: pnpm lint
+          - name: Typecheck
+            command: pnpm typecheck
+          - name: Skills
+            command: pnpm skills:check
+          - name: I18n Boundaries
+            command: pnpm i18n:boundaries
+          - name: Contract
+            command: pnpm contract:check
+          - name: Build
+            command: pnpm build
+    steps:
+      - name: Harden Runner
+        uses: step-security/harden-runner@ab7a9404c0f3da075243ca237b5fac12c98deaa5 # v2
+        with:
+          egress-policy: audit
+
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          fetch-depth: 1
+          persist-credentials: false
+
+      - name: Setup Node.js
+        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
+        with:
+          node-version: 24
+
+      - name: Setup mise
+        uses: jdx/mise-action@5ac50f778e26fac95da98d50503682459e86d566 # v3.2.0
+
+      - name: Install Dependencies
+        run: mise exec -- pnpm install --frozen-lockfile
+
+      - name: Run ${{ matrix.name }}
+        env:
+          MODERN_PUBLIC_SITE_URL: http://localhost:8080
+        run: mise exec -- ${{ matrix.command }}

package/template-workspace/.gitignore.handlebars

@@ -0,0 +1,5 @@
+node_modules/
+dist/
+build/
+.modernjs/cache/
+.modernjs/agent-reference-repos-tmp/

package/template-workspace/.mise.toml.handlebars

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

package/template-workspace/AGENTS.md

@@ -1,18 +1,34 @@
 # UltraModern Agent Contract
 
-This workspace is generated as an agent-ready UltraModern.js SuperApp. Agents should treat the files under `.agents/skills` as local project instructions, not optional reading.
+This workspace is generated as an agent-ready UltraModern.js SuperApp shell.
+Agents should treat the files under `.agents/skills` as local project
+instructions, not optional reading.
 
 ## Quality Gates
 
 - `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 in generated apps.
-- `pnpm check` runs formatting, linting, effect-tsgo, i18n checks, private-skill availability checks, and the generated workspace contract.
-
-## Internationalization
-
-Runtime i18n is enabled by default for generated apps. Agents must put user-visible UI copy in each app's `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.
+- `pnpm i18n:boundaries` verifies workspace source boundaries through `@modern-js/code-tools`.
+- `pnpm contract:check` verifies the generated workspace contract.
+- `pnpm mf:types` verifies Module Federation type outputs after builds.
+- `pnpm check` is a local convenience aggregate for the primitive gates.
+- Generated CI runs primitive gates as separate matrix jobs instead of calling `pnpm check`.
+- Generated Codex stop hooks and subagent-stop hooks run `pnpm format && pnpm lint:fix && pnpm check`.
+- `postinstall` formats the generated tree, initializes Git when needed, prepares agent skills and reference repos, then installs `lefthook`. Generated `lefthook.yml` runs separate format and lint-fix commands on pre-commit; pre-push runs read-only primitive gates in parallel.
+
+## Localized Routes
+
+Generated apps keep locale-prefixed entry routes under `src/routes/[lang]`,
+static language links, and canonical plus `hreflang` metadata. A new workspace
+starts shell-only; `create <domain> --vertical` adds route-owned metadata,
+localized resources, and Effect BFF surfaces for that domain. Runtime i18n is
+not enabled in the starter because the current React 19 + Module Federation
+streaming SSR stack must render predictably first. Canonical and hreflang URLs
+use `MODERN_PUBLIC_SITE_URL` (falling back to per-app `ULTRAMODERN_PUBLIC_URL_<APP_ID>`),
+while asset URLs prefer the per-app `ULTRAMODERN_PUBLIC_URL_<APP_ID>`. Without
+any configured public URL, builds emit origin-relative asset paths so pages work
+behind tunnels and reverse proxies.
 
 ## Required Skill Baseline
 
@@ -25,6 +41,9 @@ Use these skills when the task touches the matching subsystem:
 - `rslib-best-practices`: Shared packages, generated libraries, declaration output, and Rslib configuration.
 - `rslib-modern-package`: Package contracts for shared libraries, exports, side effects, dependency placement, README, and release readiness.
 - `rstest-best-practices`: Rstest configuration, test writing, mocking, snapshots, coverage, and CI test behavior.
+- `mf`: Module Federation docs, Modern.js integration, DTS/type checks, shared dependency checks, runtime errors, and observability troubleshooting.
+
+The public `module-federation/agent-skills` repository is installed during `pnpm install` and `pnpm skills:install`. Postinstall mode skips unavailable clone sources instead of blocking dependency installation; `pnpm skills:install` remains strict for required public skills. Use `ULTRAMODERN_SKIP_AGENT_SKILLS=1` when an install must avoid external skill repositories completely. `pnpm skills:check` fails when the required public `mf` skill is missing unless that skip flag is set.
 
 ## Private Skills
 
@@ -34,17 +53,30 @@ ScriptedAlchemy/TechsioCZ skills are private and are cloned only when the curren
 pnpm skills:install
 ```
 
-The installer copies only the allowlisted private skills from `.agents/skills-lock.json`: `plan-graph`, `dag`, `subagent-graph`, `helm`, and `debugger-mode`.
+The installer copies only the pinned private skills from `.agents/skills-lock.json`: `plan-graph`, `dag`, `subagent-graph`, `helm`, and `debugger-mode`.
+
+## Agent Reference Repositories
+
+The workspace installs read-only source references under `repos/` by default during `pnpm install` using `git subtree add --squash`. These repositories are reference material for coding agents, not application source:
+
+- `repos/effect` from `Effect-TS/effect`.
+- `repos/ultramodern.js` from `BleedingDev/ultramodern.js`.
+
+Agents may read files under `repos/` to understand upstream patterns, APIs, and project conventions. Do not edit files under `repos/`, import from them, or make production code depend on them. To skip this setup, run installs with `ULTRAMODERN_SKIP_AGENT_REPOS=1`.
 
 ## Project Priorities
 
 - Keep `presetUltramodern` as the single preset.
-- Prefer Effect for BFF/service code.
+- Keep the initial workspace shell-only unless a user explicitly asks for a
+  starter vertical.
+- Use `create <domain> --vertical` as the growth path for real business
+  MicroVerticals.
+- Prefer Effect for BFF code.
 - Prefer TanStack Router for app routing.
-- Keep design-system code as a normal Micro Frontend or shared package, not a special core path.
+- Keep UI-kit or design-system code as ordinary vertical or shared package code, not a special core path.
 - Keep generated packages explicit and publishable: stable `exports`, correct declarations, small public APIs, and clear ownership metadata.
 - Do not add migration tooling or codemods unless the project owner explicitly asks for migration work.
 
 ## Skill Provenance
 
-The vendored Rstack skills and private TechsioCZ skill allowlist are pinned in `.agents/skills-lock.json`. Do not update, remove, or replace them casually. If a skill needs updating, update the lock file and run `pnpm check`.
+The vendored Rstack skills, public Module Federation skill, and private TechsioCZ skill set are pinned in `.agents/skills-lock.json`. Do not update, remove, or replace them casually. If a skill needs updating, update the lock file and run the affected primitive gate plus `pnpm check`.