@bleedingdev/modern-js-create 3.5.0-ultramodern.9 → 3.5.0-ultramodern.90

package/package.json

@@ -21,7 +21,7 @@
   "engines": {
     "node": ">=20"
   },
-  "version": "3.5.0-ultramodern.9",
+  "version": "3.5.0-ultramodern.90",
   "types": "./dist/types/index.d.ts",
   "main": "./dist/esm-node/index.js",
   "bin": {
@@ -75,20 +75,21 @@
   ],
   "dependencies": {
     "@modern-js/codesmith": "2.6.9",
-    "oxfmt": "0.56.0",
-    "ultracite": "7.8.3",
-    "@modern-js/i18n-utils": "npm:@bleedingdev/modern-js-i18n-utils@3.5.0-ultramodern.9"
+    "@modern-js/i18n-utils": "npm:@bleedingdev/modern-js-i18n-utils@3.5.0-ultramodern.90",
+    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.5.0-ultramodern.90",
+    "esbuild": "^0.28.1",
+    "oxfmt": "0.58.0",
+    "ultracite": "7.9.3"
   },
   "devDependencies": {
-    "@rslib/core": "0.23.1",
-    "@types/node": "^26.0.1",
-    "@typescript/native-preview": "7.0.0-dev.20260628.1",
-    "tsx": "^4.22.4",
-    "typescript": "^6.0.3",
-    "@scripts/rstest-config": "2.66.0"
+    "@rslib/core": "0.23.2",
+    "@scripts/rstest-config": "2.66.0",
+    "@types/node": "^26.1.1",
+    "@typescript/native-preview": "7.0.0-dev.20260707.2",
+    "tsx": "^4.23.0",
+    "typescript": "^7.0.2"
   },
   "publishConfig": {
-    "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
   "modern:source": "./src/index.ts",
@@ -96,9 +97,10 @@
     "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"
+    "test": "rm -rf dist && rslib build -c rslibconfig.mts && pnpm -w tsgo:dts \"$PWD\" && rstest --passWithNoTests",
+    "type-check": "tsgo --noEmit -p tsconfig.json"
   },
   "ultramodern": {
-    "frameworkVersion": "3.5.0-ultramodern.9"
+    "frameworkVersion": "3.5.0-ultramodern.90"
   }
 }

package/template-workspace/.gitignore.handlebars

@@ -1,8 +1,16 @@
 node_modules/
 dist/
+dist-cloudflare/
+.output/
+**/.output/
 build/
 .modernjs/cache/
 .modern-js/
 **/.modern-js/
+**/src/modern-tanstack/
+**/.tsgo.*.resolved.json
+.mf/
+**/.mf/
 .modernjs/agent-reference-repos-tmp/
 .codex/reports/
+.zerops/runtime/

package/template-workspace/.modernjs/release-cohort.json

@@ -0,0 +1,208 @@
+{
+  "aliases": {
+    "@modern-js/adapter-rstest": "@bleedingdev/modern-js-adapter-rstest",
+    "@modern-js/app-tools": "@bleedingdev/modern-js-app-tools",
+    "@modern-js/bff-core": "@bleedingdev/modern-js-bff-core",
+    "@modern-js/bff-runtime": "@bleedingdev/modern-js-bff-runtime",
+    "@modern-js/builder": "@bleedingdev/modern-js-builder",
+    "@modern-js/code-tools": "@bleedingdev/modern-js-code-tools",
+    "@modern-js/create": "@bleedingdev/modern-js-create",
+    "@modern-js/create-request": "@bleedingdev/modern-js-create-request",
+    "@modern-js/i18n-utils": "@bleedingdev/modern-js-i18n-utils",
+    "@modern-js/image": "@bleedingdev/modern-js-image",
+    "@modern-js/main-doc": "@bleedingdev/modern-js-main-doc",
+    "@modern-js/plugin": "@bleedingdev/modern-js-plugin",
+    "@modern-js/plugin-bff": "@bleedingdev/modern-js-plugin-bff",
+    "@modern-js/plugin-data-loader": "@bleedingdev/modern-js-plugin-data-loader",
+    "@modern-js/plugin-i18n": "@bleedingdev/modern-js-plugin-i18n",
+    "@modern-js/plugin-polyfill": "@bleedingdev/modern-js-plugin-polyfill",
+    "@modern-js/plugin-ssg": "@bleedingdev/modern-js-plugin-ssg",
+    "@modern-js/plugin-styled-components": "@bleedingdev/modern-js-plugin-styled-components",
+    "@modern-js/plugin-tanstack": "@bleedingdev/modern-js-plugin-tanstack",
+    "@modern-js/prod-server": "@bleedingdev/modern-js-prod-server",
+    "@modern-js/render": "@bleedingdev/modern-js-render",
+    "@modern-js/runtime": "@bleedingdev/modern-js-runtime",
+    "@modern-js/runtime-utils": "@bleedingdev/modern-js-runtime-utils",
+    "@modern-js/sandpack-react": "@bleedingdev/modern-js-sandpack-react",
+    "@modern-js/server": "@bleedingdev/modern-js-server",
+    "@modern-js/server-core": "@bleedingdev/modern-js-server-core",
+    "@modern-js/server-runtime": "@bleedingdev/modern-js-server-runtime",
+    "@modern-js/server-runtime-extensions": "@bleedingdev/modern-js-server-runtime-extensions",
+    "@modern-js/server-utils": "@bleedingdev/modern-js-server-utils",
+    "@modern-js/tsconfig": "@bleedingdev/modern-js-tsconfig",
+    "@modern-js/types": "@bleedingdev/modern-js-types",
+    "@modern-js/utils": "@bleedingdev/modern-js-utils"
+  },
+  "packages": [
+    {
+      "sourceName": "@modern-js/adapter-rstest",
+      "targetName": "@bleedingdev/modern-js-adapter-rstest",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/app-tools",
+      "targetName": "@bleedingdev/modern-js-app-tools",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/bff-core",
+      "targetName": "@bleedingdev/modern-js-bff-core",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/bff-runtime",
+      "targetName": "@bleedingdev/modern-js-bff-runtime",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/builder",
+      "targetName": "@bleedingdev/modern-js-builder",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/code-tools",
+      "targetName": "@bleedingdev/modern-js-code-tools",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/create",
+      "targetName": "@bleedingdev/modern-js-create",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/create-request",
+      "targetName": "@bleedingdev/modern-js-create-request",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/i18n-utils",
+      "targetName": "@bleedingdev/modern-js-i18n-utils",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/image",
+      "targetName": "@bleedingdev/modern-js-image",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/main-doc",
+      "targetName": "@bleedingdev/modern-js-main-doc",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/plugin",
+      "targetName": "@bleedingdev/modern-js-plugin",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/plugin-bff",
+      "targetName": "@bleedingdev/modern-js-plugin-bff",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/plugin-data-loader",
+      "targetName": "@bleedingdev/modern-js-plugin-data-loader",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/plugin-i18n",
+      "targetName": "@bleedingdev/modern-js-plugin-i18n",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/plugin-polyfill",
+      "targetName": "@bleedingdev/modern-js-plugin-polyfill",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/plugin-ssg",
+      "targetName": "@bleedingdev/modern-js-plugin-ssg",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/plugin-styled-components",
+      "targetName": "@bleedingdev/modern-js-plugin-styled-components",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/plugin-tanstack",
+      "targetName": "@bleedingdev/modern-js-plugin-tanstack",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/prod-server",
+      "targetName": "@bleedingdev/modern-js-prod-server",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/render",
+      "targetName": "@bleedingdev/modern-js-render",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/runtime",
+      "targetName": "@bleedingdev/modern-js-runtime",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/runtime-utils",
+      "targetName": "@bleedingdev/modern-js-runtime-utils",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/sandpack-react",
+      "targetName": "@bleedingdev/modern-js-sandpack-react",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/server",
+      "targetName": "@bleedingdev/modern-js-server",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/server-core",
+      "targetName": "@bleedingdev/modern-js-server-core",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/server-runtime",
+      "targetName": "@bleedingdev/modern-js-server-runtime",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/server-runtime-extensions",
+      "targetName": "@bleedingdev/modern-js-server-runtime-extensions",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/server-utils",
+      "targetName": "@bleedingdev/modern-js-server-utils",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/tsconfig",
+      "targetName": "@bleedingdev/modern-js-tsconfig",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/types",
+      "targetName": "@bleedingdev/modern-js-types",
+      "version": "3.5.0-ultramodern.90"
+    },
+    {
+      "sourceName": "@modern-js/utils",
+      "targetName": "@bleedingdev/modern-js-utils",
+      "version": "3.5.0-ultramodern.90"
+    }
+  ],
+  "release": {
+    "tag": "latest",
+    "version": "3.5.0-ultramodern.90"
+  },
+  "schema": "bleedingdev.ultramodern.release-cohort",
+  "schemaVersion": 1,
+  "source": {
+    "commit": "2c97f471e61e0d312120bb4efb98bf043661ec0e",
+    "repository": "BleedingDev/ultramodern.js"
+  }
+}

package/template-workspace/AGENTS.md.handlebars

@@ -1,94 +1,21 @@
-# UltraModern Agent Contract
+# UltraModern.js Workspace
 
-This workspace is generated as an agent-ready UltraModern.js SuperApp shell.
-Codex should treat the files under `.codex/skills` as local project
-instructions, not optional reading.
+This is an UltraModern.js SuperApp: a composition shell plus independently
+owned business MicroVerticals.
 
-## Quality Gates
+## Work Here
 
-Generated workspaces target Node `>=26` and pnpm `{{pnpmVersion}}`. Keep
-`packageManager`, `.mise.toml`, generated validation, and CI aligned to that
-baseline; do not reintroduce Corepack or older pnpm aliases.
+- Use Node `>=26` and pnpm `{{pnpmVersion}}`. Run `mise install` before
+  `pnpm install` when the active toolchain differs.
+- Keep business features out of the shell. Follow [README.md](./README.md) to
+  add a MicroVertical.
+- Run checks relevant to the change. Before finishing code changes, run
+  `pnpm check`; also run `pnpm build` for runtime, build, routing, or deployment
+  changes.
 
-- `pnpm lint` runs Oxlint with the Ultracite preset.
-- `pnpm format` runs oxfmt.
-- `pnpm typecheck` runs TS7 native-preview through effect-tsgo in project-reference build mode with parallel `--checkers` and `--builders`.
-- `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, installs/updates pinned Codex skills, and installs `lefthook`. It never installs system packages. Clone-backed public skills are attempted by default; offline clone failures are advisory. Reference repos remain an explicit `pnpm agents:refs:install` step. Generated `lefthook.yml` runs separate format and lint-fix commands on pre-commit; pre-push runs read-only primitive gates in parallel.
+## Reusable Guidance
 
-## 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` only. JS/CSS/static assets use
-`MODERN_ASSET_PREFIX`, then `ULTRAMODERN_ASSET_PREFIX`, then `/`; do not use
-`MODERN_PUBLIC_SITE_URL` or stale public URL aliases as asset-prefix fallbacks.
-Without an asset prefix, builds emit origin-relative asset paths so pages work
-behind tunnels and reverse proxies.
-
-## Required Skill Baseline
-
-Use these skills when the task touches the matching subsystem:
-
-- `rsbuild-best-practices`: Modern.js app build configuration, Rsbuild options, assets, type checking, and build debugging.
-- `rspack-best-practices`: Rspack-level bundling, CSS, assets, profiling, and production build behavior.
-- `rspack-tracing`: Rspack build failures, slow builds, crash localization, and trace analysis.
-- `rsdoctor-analysis`: Evidence-based bundle analysis from `rsdoctor-data.json`, including duplicate packages, large chunks, and retained modules.
-- `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.
-
-Skill bodies are lockfile-pinned in `.codex/skills-lock.json` and installed
-into the repo-owned `.codex/skills` directory by default. The installer updates
-only pinned skill directories and preserves unrelated user skills already
-present under `.codex/skills`. Set `ULTRAMODERN_SKIP_CODEX_SKILLS=1` or
-`ULTRAMODERN_CODEX_SKILLS=0` to opt out during install. `pnpm skills:check` is
-advisory when local skill bodies are missing so offline CI can still run the
-normal gate.
-
-## Private Skills
-
-ScriptedAlchemy/TechsioCZ skills are private and are cloned only when the current developer is authorized for `TechsioCZ/skills`.
-
-```bash
-pnpm skills:install
-```
-
-The installer copies only the pinned private skills from `.codex/skills-lock.json`: `plan-graph`, `dag`, `subagent-graph`, `helm`, and `debugger-mode`.
-
-## Agent Reference Repositories
-
-The workspace can install read-only source references under `repos/` with the explicit `pnpm agents:refs:install` command 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. `ULTRAMODERN_SKIP_AGENT_REPOS=1` disables the installer even when invoked explicitly.
-
-## Project Priorities
-
-- Keep `presetUltramodern` as the single preset.
-- Maximize TS7 latest dev usage through `@typescript/native-preview` and TS-Go. Keep classic `typescript` on latest TS6 only for compatibility peers and tooling that cannot consume native-preview yet.
-- 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 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 Rstack skills, public Module Federation skill, and private TechsioCZ skill set are pinned in `.codex/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`.
+- Read only the relevant sections of [README.md](./README.md) for architecture,
+  routes and i18n, environment variables, deployment, and troubleshooting.
+- Use a skill under [`.codex/skills`](./.codex/skills) only when its description
+  matches the task; read that skill's `SKILL.md` and referenced files on demand.

package/template-workspace/README.md.handlebars

@@ -70,10 +70,9 @@ separate matrix jobs so failures are isolated and parallelizable.
 
 Type checking is TS7-first. `pnpm typecheck` runs
 `scripts/ultramodern-typecheck.mts` in TS-Go build mode over
-`tsconfig.json` project references, with native-preview `--checkers` and
-`--builders` enabled by default. `@typescript/native-preview` is the TS7 latest
-dev compiler lane. The classic `typescript` package is pinned to latest TS6
-only where compatibility peers or tooling still require it.
+`tsconfig.json` project references, with `--checkers` and `--builders`
+enabled by default. The stable `typescript` package is pinned to TS7 so
+Modern/Rspack type checking uses TS-Go by default.
 
 Read-only agent reference repositories under `repos/` (Effect and
 UltraModern.js source lookup using squashed git subtrees) are an explicit
@@ -117,19 +116,21 @@ regenerating or updating the workspace.
 | `ULTRAMODERN_ASSET_PREFIX` | UltraModern compatibility asset prefix | Modern/Rspack-emitted asset URLs when `MODERN_ASSET_PREFIX` is unset |
 | `ULTRAMODERN_PUBLIC_URL_<APP_ID>` | Per-app deployment/proof URL | Cloudflare proof inputs and Module Federation remote URLs |
 
-Asset URLs use this precedence: `MODERN_ASSET_PREFIX` →
-`ULTRAMODERN_ASSET_PREFIX` → origin-relative `/`. `MODERN_PUBLIC_SITE_URL` is
-canonical/SEO-only and must not be used as an asset-prefix fallback.
+Shell asset URLs use this precedence: `MODERN_ASSET_PREFIX` →
+`ULTRAMODERN_ASSET_PREFIX` → origin-relative `/`. Module Federation remotes use
+the same env precedence, then fall back to their per-app public origin:
+configured public URL, inferred workers.dev URL, or local dev port.
+`MODERN_PUBLIC_SITE_URL` is canonical/SEO-only and must not be used as an
+asset-prefix fallback.
 SEO output uses `MODERN_PUBLIC_SITE_URL`; if it is unset, generated local and
 preview outputs remain non-public until deployment proof provides explicit
 public URLs.
 
-Without public URLs configured, asset paths are origin-relative (`/`), and the
-dev server uses `dev.assetPrefix: '/'` — so apps work through tunnels and
-reverse proxies (ngrok, cloudflared) without triggering Chrome's Local Network
-Access prompt or mixed-content errors. Shell-only workspaces can set
-`MODERN_PUBLIC_SITE_URL` for SEO output without changing where assets load
-from.
+Without public URLs configured, shell asset paths are origin-relative (`/`).
+Remote dev manifests publish their own local origin so host shells load
+`remoteEntry.js` and exposed chunks from the remote dev server. Shell-only
+workspaces can set `MODERN_PUBLIC_SITE_URL` for SEO output without changing
+where assets load from.
 
 ## Cloudflare Proof
 
@@ -144,7 +145,7 @@ pattern with hyphens converted to underscores and uppercased.
 ```bash
 pnpm cloudflare:deploy
 ULTRAMODERN_PUBLIC_URL_SHELL_SUPER_APP=https://shell-super-app.example.workers.dev \
-pnpm cloudflare:proof -- --require-public-urls
+pnpm cloudflare:proof --require-public-urls
 ```
 
 ## Strict Effect API
@@ -177,8 +178,8 @@ from trusted-publisher metadata to provenance attestations.
 For older generated workspaces, run the framework migration command first:
 
 ```bash
-pnpm dlx @bleedingdev/modern-js-create@3.5.0-ultramodern.9 ultramodern \
-  migrate-strict-effect --version 3.5.0-ultramodern.9
+pnpm dlx @bleedingdev/modern-js-create@3.5.0-ultramodern.10 ultramodern \
+  migrate-strict-effect --version 3.5.0-ultramodern.10
 pnpm api:check
 pnpm contract:check
 ```

package/template-workspace/patches/@module-federation__bridge-react@2.8.0.patch

@@ -0,0 +1,185 @@
+diff --git a/dist/lazy-load-component-plugin-FKp6nQa-.js b/dist/lazy-load-component-plugin-FKp6nQa-.js
+--- a/dist/lazy-load-component-plugin-FKp6nQa-.js
++++ b/dist/lazy-load-component-plugin-FKp6nQa-.js
+@@ -236,6 +236,41 @@ function getTargetModuleInfo(id, instance) {
+     remoteEntry
+   };
+ }
++function normalizeHref(href) {
++  if (typeof document === "undefined") {
++    return href;
++  }
++  try {
++    return new URL(href, document.baseURI).href;
++  } catch {
++    return href;
++  }
++}
++function isStylesheetLink(link) {
++  return link.relList.contains("stylesheet") || link.rel.toLowerCase().split(/\s+/u).includes("stylesheet");
++}
++function hasStylesheetLinkInHead(href, ignoredLink) {
++  if (typeof document === "undefined" || !document.head) {
++    return false;
++  }
++  const normalizedHref = normalizeHref(href);
++  return Array.from(
++    document.head.querySelectorAll("link[href]")
++  ).some(
++    (link) => link !== ignoredLink && isStylesheetLink(link) && normalizeHref(link.href) === normalizedHref
++  );
++}
++function StylesheetAsset({ href }) {
++  const [shouldRender, setShouldRender] = React.useState(true);
++  const linkRef = React.useRef(null);
++  React.useEffect(() => {
++    setShouldRender(!hasStylesheetLinkInHead(href, linkRef.current));
++  }, [href]);
++  if (!shouldRender) {
++    return null;
++  }
++  return /* @__PURE__ */ React.createElement("link", { ref: linkRef, href, rel: "stylesheet", type: "text/css" });
++}
+ function collectSSRAssets(options) {
+   const {
+     id,
+@@ -254,15 +289,19 @@ function collectSSRAssets(options) {
+   }
+   const { module: targetModule, publicPath, remoteEntry } = moduleAndPublicPath;
+   if (injectLink) {
++    const stylesheetHrefs = /* @__PURE__ */ new Set();
+     [...targetModule.assets.css.sync, ...targetModule.assets.css.async].sort().forEach((file, index) => {
++      const href = `${publicPath}${file}`;
++      if (stylesheetHrefs.has(href)) {
++        return;
++      }
++      stylesheetHrefs.add(href);
+       links.push(
+         /* @__PURE__ */ React.createElement(
+-          "link",
++          StylesheetAsset,
+           {
+             key: `${file.split(".")[0]}_${index}`,
+-            href: `${publicPath}${file}`,
+-            rel: "stylesheet",
+-            type: "text/css"
++            href
+           }
+         )
+       );
+diff --git a/dist/lazy-load-component-plugin-DEu-DfZt.mjs b/dist/lazy-load-component-plugin-DEu-DfZt.mjs
+--- a/dist/lazy-load-component-plugin-DEu-DfZt.mjs
++++ b/dist/lazy-load-component-plugin-DEu-DfZt.mjs
+@@ -235,6 +235,41 @@ function getTargetModuleInfo(id, instance) {
+     remoteEntry
+   };
+ }
++function normalizeHref(href) {
++  if (typeof document === "undefined") {
++    return href;
++  }
++  try {
++    return new URL(href, document.baseURI).href;
++  } catch {
++    return href;
++  }
++}
++function isStylesheetLink(link) {
++  return link.relList.contains("stylesheet") || link.rel.toLowerCase().split(/\s+/u).includes("stylesheet");
++}
++function hasStylesheetLinkInHead(href, ignoredLink) {
++  if (typeof document === "undefined" || !document.head) {
++    return false;
++  }
++  const normalizedHref = normalizeHref(href);
++  return Array.from(
++    document.head.querySelectorAll("link[href]")
++  ).some(
++    (link) => link !== ignoredLink && isStylesheetLink(link) && normalizeHref(link.href) === normalizedHref
++  );
++}
++function StylesheetAsset({ href }) {
++  const [shouldRender, setShouldRender] = useState(true);
++  const linkRef = useRef(null);
++  useEffect(() => {
++    setShouldRender(!hasStylesheetLinkInHead(href, linkRef.current));
++  }, [href]);
++  if (!shouldRender) {
++    return null;
++  }
++  return /* @__PURE__ */ React__default.createElement("link", { ref: linkRef, href, rel: "stylesheet", type: "text/css" });
++}
+ function collectSSRAssets(options) {
+   const {
+     id,
+@@ -253,15 +288,19 @@ function collectSSRAssets(options) {
+   }
+   const { module: targetModule, publicPath, remoteEntry } = moduleAndPublicPath;
+   if (injectLink) {
++    const stylesheetHrefs = /* @__PURE__ */ new Set();
+     [...targetModule.assets.css.sync, ...targetModule.assets.css.async].sort().forEach((file, index) => {
++      const href = `${publicPath}${file}`;
++      if (stylesheetHrefs.has(href)) {
++        return;
++      }
++      stylesheetHrefs.add(href);
+       links.push(
+         /* @__PURE__ */ React__default.createElement(
+-          "link",
++          StylesheetAsset,
+           {
+             key: `${file.split(".")[0]}_${index}`,
+-            href: `${publicPath}${file}`,
+-            rel: "stylesheet",
+-            type: "text/css"
++            href
+           }
+         )
+       );
+diff --git a/dist/lazy/wrapNoSSR.d.ts b/dist/lazy/wrapNoSSR.d.ts
+--- a/dist/lazy/wrapNoSSR.d.ts
++++ b/dist/lazy/wrapNoSSR.d.ts
+@@ -6,4 +6,4 @@ export declare function wrapNoSSR<T, E extends keyof T>(createLazyComponentFn:
+     key?: React.Key | null;
+ } : {
+     key?: React.Key | null;
+-}) => import("node_modules/@types/react").JSX.Element;
++}) => import("react").JSX.Element;
+diff --git a/dist/provider/versions/v18.d.ts b/dist/provider/versions/v18.d.ts
+--- a/dist/provider/versions/v18.d.ts
++++ b/dist/provider/versions/v18.d.ts
+@@ -12,7 +12,7 @@ export interface Root {
+     unmount(): void;
+ }
+ export declare function createReact18Root(container: Element | DocumentFragment, options?: CreateRootOptions): Root;
+-export declare function hydrateReact18Root(container: Element | DocumentFragment, initialChildren: React.ReactNode, options?: CreateRootOptions): import("node_modules/@types/react-dom/client").Root;
++export declare function hydrateReact18Root(container: Element | DocumentFragment, initialChildren: React.ReactNode, options?: CreateRootOptions): import("react-dom/client").Root;
+ export declare function createBridgeComponent<T = any>(bridgeInfo: Omit<ProviderFnParams<T>, 'createRoot'>): () => {
+     render(info: import("../..").RenderParams): Promise<void>;
+     destroy(info: import("../..").DestroyParams): void;
+diff --git a/dist/remote/base-component/create.d.ts b/dist/remote/base-component/create.d.ts
+--- a/dist/remote/base-component/create.d.ts
++++ b/dist/remote/base-component/create.d.ts
+@@ -1,7 +1,7 @@
+ import { type LazyRemoteComponentInfo } from '../createHelpers';
+ export type { LazyRemoteComponentInfo };
+-declare const createLazyRemoteComponent: <T = Record<string, unknown>, E extends keyof T = keyof T>(info: LazyRemoteComponentInfo<T, E>) => import("node_modules/@types/react").LazyExoticComponent<import("node_modules/@types/react").ForwardRefExoticComponent<Omit<import("../..").RemoteComponentProps<Record<string, unknown>>, "ref"> & import("node_modules/@types/react").RefAttributes<HTMLDivElement>>>;
+-export declare const createRemoteAppComponent: <T = Record<string, unknown>, E extends keyof T = keyof T>(info: LazyRemoteComponentInfo<T, E>) => import("node_modules/@types/react").ForwardRefExoticComponent<Omit<import("../..").RemoteComponentProps<Record<string, unknown>>, "ref"> & import("node_modules/@types/react").RefAttributes<HTMLDivElement>>;
++declare const createLazyRemoteComponent: <T = Record<string, unknown>, E extends keyof T = keyof T>(info: LazyRemoteComponentInfo<T, E>) => import("react").LazyExoticComponent<import("react").ForwardRefExoticComponent<Omit<import("../..").RemoteComponentProps<Record<string, unknown>>, "ref"> & import("react").RefAttributes<HTMLDivElement>>>;
++export declare const createRemoteAppComponent: <T = Record<string, unknown>, E extends keyof T = keyof T>(info: LazyRemoteComponentInfo<T, E>) => import("react").ForwardRefExoticComponent<Omit<import("../..").RemoteComponentProps<Record<string, unknown>>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+ /**
+  * @deprecated createRemoteComponent is deprecated, please use createRemoteAppComponent instead!
+  */
+diff --git a/dist/remote/router-component/create.d.ts b/dist/remote/router-component/create.d.ts
+--- a/dist/remote/router-component/create.d.ts
++++ b/dist/remote/router-component/create.d.ts
+@@ -1,7 +1,7 @@
+ import { type LazyRemoteComponentInfo } from '../createHelpers';
+ export type { LazyRemoteComponentInfo };
+-declare const createLazyRemoteComponent: <T = Record<string, unknown>, E extends keyof T = keyof T>(info: LazyRemoteComponentInfo<T, E>) => import("node_modules/@types/react").LazyExoticComponent<import("node_modules/@types/react").ForwardRefExoticComponent<Omit<import("../..").RemoteComponentProps<Record<string, unknown>>, "ref"> & import("node_modules/@types/react").RefAttributes<HTMLDivElement>>>;
+-export declare const createRemoteAppComponent: <T = Record<string, unknown>, E extends keyof T = keyof T>(info: LazyRemoteComponentInfo<T, E>) => import("node_modules/@types/react").ForwardRefExoticComponent<Omit<import("../..").RemoteComponentProps<Record<string, unknown>>, "ref"> & import("node_modules/@types/react").RefAttributes<HTMLDivElement>>;
++declare const createLazyRemoteComponent: <T = Record<string, unknown>, E extends keyof T = keyof T>(info: LazyRemoteComponentInfo<T, E>) => import("react").LazyExoticComponent<import("react").ForwardRefExoticComponent<Omit<import("../..").RemoteComponentProps<Record<string, unknown>>, "ref"> & import("react").RefAttributes<HTMLDivElement>>>;
++export declare const createRemoteAppComponent: <T = Record<string, unknown>, E extends keyof T = keyof T>(info: LazyRemoteComponentInfo<T, E>) => import("react").ForwardRefExoticComponent<Omit<import("../..").RemoteComponentProps<Record<string, unknown>>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+ /**
+  * @deprecated createRemoteComponent is deprecated, please use createRemoteAppComponent instead!
+  */