@bleedingdev/modern-js-ultramodern-app-tools 0.0.0 → 3.9.0-ultramodern.10

package/dist/types-esm/native-composition/preset.d.mts

@@ -0,0 +1,86 @@
+import type { AppUserConfig } from './types.mjs';
+export interface PresetUltramodernOptions {
+    /**
+     * Stable producer identity used by BFF cross-project clients.
+     * @default "app"
+     */
+    appId?: string;
+    /**
+     * Generation-time identity root for a generated delivery unit. When set, the
+     * preset derives one build identity from the immutable source revision and
+     * injects it into every browser, SSR, API, and backend bundle.
+     */
+    deliveryUnit?: {
+        buildMarker: string;
+        unitId: string;
+        version: string;
+    };
+    /**
+     * Enable BFF requestId contract by default.
+     * @default true
+     */
+    enableBffRequestId?: boolean;
+    /**
+     * Enable telemetry contract by default.
+     * Exporters are still configured separately by applications.
+     * @default true
+     */
+    enableTelemetry?: boolean;
+    /**
+     * Enable telemetry exporters.
+     *
+     * By default each exporter is enabled only when its endpoint is explicitly
+     * configured (via the matching option or environment variable), so a bare
+     * preset app boots in production without local collectors.
+     * Set `true` to force both exporters on with their default localhost
+     * endpoints, or `false` to disable exporters entirely.
+     * @default undefined (endpoint-driven)
+     */
+    enableTelemetryExporters?: boolean;
+    /**
+     * OTLP exporter endpoint. Setting it (or the environment variable)
+     * enables the OTLP exporter unless `enableTelemetryExporters` is `false`.
+     * The localhost endpoint is used only when exporters are forced on with
+     * `enableTelemetryExporters: true` and no endpoint was provided.
+     * @default process.env.MODERN_TELEMETRY_OTLP_ENDPOINT
+     */
+    otlpEndpoint?: string;
+    /**
+     * VictoriaMetrics exporter endpoint. Setting it (or the environment
+     * variable) enables the VictoriaMetrics exporter unless
+     * `enableTelemetryExporters` is `false`.
+     * The localhost endpoint is used only when exporters are forced on with
+     * `enableTelemetryExporters: true` and no endpoint was provided.
+     * @default process.env.MODERN_TELEMETRY_VICTORIA_ENDPOINT
+     */
+    victoriaMetricsEndpoint?: string;
+    /**
+     * Enable fail-loud startup probing for telemetry exporters.
+     * Probes only run for exporters that are actually enabled.
+     * @default false
+     */
+    telemetryFailLoudStartup?: boolean;
+    /**
+     * Enable app-level Module Federation SSR handshake by default.
+     * @default true
+     */
+    enableModuleFederationSSR?: boolean;
+}
+/**
+ * Materialize a fresh UltraModern preset config.
+ *
+ * This is the advanced inspection API. Use `presetUltramodern` when composing
+ * an application config so nested records, arrays, and hooks keep the normal
+ * Modern.js merge behavior.
+ */
+export declare const createPresetUltramodernConfig: (options?: PresetUltramodernOptions) => AppUserConfig;
+/**
+ * Compose an application config over the UltraModern preset.
+ *
+ * The application config is merged after the preset. Nested records are
+ * preserved, scalar values and `false` override preset values, and omitted or
+ * `undefined` values keep the preset value. Arrays and hooks compose in
+ * preset-first order. An empty record does not reset nested preset defaults;
+ * use the typed `PresetUltramodernOptions` opt-outs instead.
+ */
+export declare const presetUltramodern: (config: AppUserConfig, options?: PresetUltramodernOptions) => AppUserConfig;

package/dist/types-esm/native-composition/release-envelope-plugin.d.mts

@@ -0,0 +1,2 @@
+import type { AppTools, CliPlugin } from '@modern-js/app-tools';
+export declare const ultramodernReleaseEnvelopePlugin: () => CliPlugin<AppTools>;

package/dist/types-esm/native-composition/router-integration-plugin.d.mts

@@ -0,0 +1,3 @@
+import type { AppTools, CliPlugin } from '@modern-js/app-tools';
+/** Add fork router policy after the native and optional provider selectors. */
+export declare const ultramodernRouterIntegrationPlugin: () => CliPlugin<AppTools>;

package/dist/types-esm/native-composition/router-runtime.d.mts

@@ -0,0 +1,4 @@
+import { routerPlugin as nativeRouterPlugin } from '@modern-js/runtime/router/internal';
+/** Install fork observers before the native provider registers its lifecycle. */
+export declare const routerPlugin: typeof nativeRouterPlugin;
+export default routerPlugin;

package/dist/types-esm/native-composition/rsc-disabled-plugin.d.mts

@@ -0,0 +1,2 @@
+import type { RsbuildPlugin } from '@rsbuild/core';
+export declare function rscDisabledRuntimePlugin(): RsbuildPlugin;

package/dist/types-esm/native-composition/server-plugin.d.mts

@@ -0,0 +1 @@
+export { default } from '@modern-js/server-runtime-extensions/server-plugin';

package/dist/types-esm/native-composition/ssr-integration-plugin.d.mts

@@ -0,0 +1,7 @@
+import type { AppTools, CliPlugin } from '@modern-js/app-tools';
+import type { MergedEnvironmentConfig } from '@rsbuild/core';
+type EnvironmentConfigLike = Partial<Pick<MergedEnvironmentConfig, 'output' | 'source' | 'tools'>>;
+export declare const shouldUseModuleFederationNodeOutput: (config: EnvironmentConfigLike) => boolean;
+/** Apply fork SSR policy after native SSR defaults through Rsbuild hooks. */
+export declare const ultramodernSSRIntegrationPlugin: () => CliPlugin<AppTools>;
+export {};

package/dist/types-esm/native-composition/types.d.mts

@@ -0,0 +1,24 @@
+import type { AppUserConfig as NativeAppUserConfig } from '@modern-js/app-tools';
+import type { PrecompressConfig } from '@modern-js/app-tools-extensions/build-config/precompress/plugin';
+import type { CloudflareDeployConfig } from '@modern-js/app-tools-extensions/config';
+import type { BffRuntimeUserConfig, ServerTelemetryUserConfig } from '@modern-js/runtime-extensions/server-config';
+type NativeServerConfig = NonNullable<NativeAppUserConfig['server']>;
+type NativeSSRConfig = Exclude<NativeServerConfig['ssr'], boolean | undefined>;
+/** Native Modern.js configuration with the fork's explicitly owned options. */
+export type UltramodernAppUserConfig = Omit<NativeAppUserConfig, 'output' | 'server' | 'bff' | 'deploy'> & {
+    output?: Omit<NonNullable<NativeAppUserConfig['output']>, 'precompress'> & {
+        precompress?: boolean | PrecompressConfig;
+    };
+    server?: Omit<NativeServerConfig, 'ssr' | 'telemetry'> & {
+        ssr?: boolean | (NativeSSRConfig & {
+            moduleFederationAppSSR?: boolean;
+        });
+        telemetry?: ServerTelemetryUserConfig;
+    };
+    bff?: Omit<NonNullable<NativeAppUserConfig['bff']>, keyof BffRuntimeUserConfig> & BffRuntimeUserConfig & {
+        requestId?: string;
+    };
+    deploy?: NonNullable<NativeAppUserConfig['deploy']> & CloudflareDeployConfig;
+};
+export type AppUserConfig = UltramodernAppUserConfig;
+export {};

package/package.json

@@ -1,16 +1,111 @@
 {
   "name": "@bleedingdev/modern-js-ultramodern-app-tools",
-  "version": "0.0.0",
-  "description": "Package-name registration for the forthcoming UltraModern.js release. This setup version contains no runtime implementation.",
-  "license": "MIT",
+  "description": "Native UltraModern.js build, preset and release plugin composition.",
+  "homepage": "https://github.com/BleedingDev/ultramodern.js#readme",
+  "bugs": {
+    "url": "https://github.com/BleedingDev/ultramodern.js/issues"
+  },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/BleedingDev/ultramodern.js.git"
+    "url": "git+https://github.com/BleedingDev/ultramodern.js.git",
+    "directory": "packages/solutions/ultramodern-app-tools"
   },
+  "license": "MIT",
+  "version": "3.9.0-ultramodern.10",
   "files": [
-    "README.md"
+    "dist",
+    "src"
   ],
+  "types": "./dist/types/native-composition/index.d.ts",
+  "main": "./dist/cjs/native-composition/index.js",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/types-esm/native-composition/index.d.mts",
+        "default": "./dist/esm-node/native-composition/index.mjs"
+      },
+      "require": {
+        "types": "./dist/types/native-composition/index.d.ts",
+        "default": "./dist/cjs/native-composition/index.js"
+      },
+      "types": "./dist/types/native-composition/index.d.ts"
+    },
+    "./server-plugin": {
+      "node": {
+        "import": {
+          "types": "./dist/types-esm/native-composition/server-plugin.d.mts",
+          "default": "./dist/esm-node/native-composition/server-plugin.mjs"
+        },
+        "require": {
+          "types": "./dist/types/native-composition/server-plugin.d.ts",
+          "default": "./dist/cjs/native-composition/server-plugin.js"
+        }
+      },
+      "types": "./dist/types/native-composition/server-plugin.d.ts"
+    },
+    "./router-runtime": {
+      "node": {
+        "import": {
+          "types": "./dist/types-esm/native-composition/router-runtime.d.mts",
+          "default": "./dist/esm-node/native-composition/router-runtime.mjs"
+        },
+        "require": {
+          "types": "./dist/types/native-composition/router-runtime.d.ts",
+          "default": "./dist/cjs/native-composition/router-runtime.js"
+        }
+      },
+      "default": "./dist/esm/native-composition/router-runtime.mjs",
+      "types": "./dist/types-esm/native-composition/router-runtime.d.mts"
+    }
+  },
+  "engines": {
+    "node": ">=26.7.0"
+  },
+  "dependencies": {
+    "@modern-js/app-tools": "npm:@bleedingdev/modern-js-app-tools@3.9.0-ultramodern.10",
+    "@modern-js/app-tools-extensions": "npm:@bleedingdev/modern-js-app-tools-extensions@3.9.0-ultramodern.10",
+    "@modern-js/i18n-integration": "npm:@bleedingdev/modern-js-i18n-integration@3.9.0-ultramodern.10",
+    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.9.0-ultramodern.10",
+    "@modern-js/runtime": "npm:@bleedingdev/modern-js-runtime@3.9.0-ultramodern.10",
+    "@modern-js/runtime-extensions": "npm:@bleedingdev/modern-js-runtime-extensions@3.9.0-ultramodern.10",
+    "@modern-js/runtime-renderer-extensions": "npm:@bleedingdev/modern-js-runtime-renderer-extensions@3.9.0-ultramodern.10",
+    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.9.0-ultramodern.10",
+    "@modern-js/server-runtime-extensions": "npm:@bleedingdev/modern-js-server-runtime-extensions@3.9.0-ultramodern.10",
+    "@rsbuild/core": "2.2.3"
+  },
+  "devDependencies": {
+    "@modern-js/backend-federation-contracts": "npm:@bleedingdev/modern-js-backend-federation-contracts@3.9.0-ultramodern.10",
+    "@modern-js/builder": "npm:@bleedingdev/modern-js-builder@3.9.0-ultramodern.10",
+    "@modern-js/plugin-bff": "npm:@bleedingdev/modern-js-plugin-bff@3.9.0-ultramodern.10",
+    "@modern-js/plugin-tanstack": "npm:@bleedingdev/modern-js-plugin-tanstack@3.9.0-ultramodern.10",
+    "@modern-js/prod-server": "npm:@bleedingdev/modern-js-prod-server@3.9.0-ultramodern.10",
+    "@modern-js/server": "npm:@bleedingdev/modern-js-server@3.9.0-ultramodern.10",
+    "@modern-js/tsconfig": "npm:@bleedingdev/modern-js-tsconfig@3.9.0-ultramodern.10",
+    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.0-ultramodern.10",
+    "@rslib/core": "1.0.0",
+    "@scripts/rstest-config": "2.66.0",
+    "@types/node": "^26.4.1",
+    "@typescript/native-preview": "7.0.0-dev.20260707.2"
+  },
+  "sideEffects": false,
   "publishConfig": {
     "access": "public"
+  },
+  "typesVersions": {
+    "*": {
+      "server-plugin": [
+        "./dist/types/native-composition/server-plugin.d.ts",
+        "./src/native-composition/server-plugin.ts"
+      ],
+      "router-runtime": [
+        "./dist/types/native-composition/router-runtime.d.ts",
+        "./src/native-composition/router-runtime.ts"
+      ]
+    }
+  },
+  "scripts": {
+    "build": "rslib build && pnpm run verify:deploy-output",
+    "test": "rstest",
+    "verify:deploy-output": "node ./tests/deploy-output/verify-public-surface.mjs"
   }
 }

package/src/native-composition/index.ts

@@ -0,0 +1,92 @@
+import { type AppTools, appTools, type CliPlugin } from '@modern-js/app-tools';
+import backendFederationBuildPlugin from '@modern-js/app-tools-extensions/backend-federation-build';
+import { createCloudflareBuilderPlugin } from '@modern-js/app-tools-extensions/cloudflare-builder';
+import { createDeployOutputAliasesPlugin } from '@modern-js/app-tools-extensions/deploy-output/plugin';
+import {
+  RENDERER_EXTENSIONS_PACKAGE,
+  SERVER_EXTENSIONS_PLUGIN_NAME,
+} from '@modern-js/app-tools-extensions/policy-defaults';
+import {
+  collectRuntimePackageModuleDirectories,
+  createRuntimePackageResolutionPlugin,
+} from '@modern-js/app-tools-extensions/runtime-package-resolution';
+import { ultramodernI18nIntegrationPlugin } from '@modern-js/i18n-integration';
+import { ultramodernReleaseEnvelopePlugin } from './release-envelope-plugin';
+import { ultramodernRouterIntegrationPlugin } from './router-integration-plugin';
+import { rscDisabledRuntimePlugin } from './rsc-disabled-plugin';
+import { ultramodernSSRIntegrationPlugin } from './ssr-integration-plugin';
+
+export {
+  createPresetUltramodernConfig,
+  type PresetUltramodernOptions,
+  presetUltramodern,
+} from './preset';
+export { ultramodernReleaseEnvelopePlugin } from './release-envelope-plugin';
+export type { AppUserConfig, UltramodernAppUserConfig } from './types';
+
+/** Compose the fork's build and release features through native CLI plugins. */
+export const ultramodernAppTools = (): CliPlugin<AppTools> => ({
+  name: '@modern-js/ultramodern-app-tools',
+  usePlugins: [
+    appTools(),
+    ultramodernI18nIntegrationPlugin(),
+    ultramodernRouterIntegrationPlugin(),
+    ultramodernSSRIntegrationPlugin(),
+    backendFederationBuildPlugin(),
+    createCloudflareBuilderPlugin(),
+    createDeployOutputAliasesPlugin(),
+    ultramodernReleaseEnvelopePlugin(),
+  ],
+  setup(api) {
+    // The composed runtime packages are dependencies of this package, not of
+    // the app that composes it. Contribute the directories that host them so
+    // the generated `runtime-register.js` resolves them under an isolated
+    // (pnpm) linker without the app having to declare them itself.
+    const runtimeModuleDirectories = collectRuntimePackageModuleDirectories(
+      [RENDERER_EXTENSIONS_PACKAGE, '@modern-js/i18n-integration'],
+      import.meta.url,
+    );
+
+    api.modifyResolvedConfig(config => {
+      const builderPlugins = [
+        ...(config.builderPlugins ?? []),
+        ...(runtimeModuleDirectories.length > 0
+          ? [createRuntimePackageResolutionPlugin(runtimeModuleDirectories)]
+          : []),
+        ...(config.server?.rsc ? [] : [rscDisabledRuntimePlugin()]),
+      ];
+      return { ...config, builderPlugins };
+    });
+    api._internalServerPlugins(({ plugins }) => {
+      // `appTools()` already registered the fork's server policy under its own
+      // specifier. An app that composes this package declares *this* package,
+      // so the descriptor is renamed rather than duplicated: both specifiers
+      // export the same server plugin, and this one is the one such an app can
+      // always resolve.
+      const name = '@modern-js/ultramodern-app-tools/server-plugin';
+      const renamed = plugins.map(plugin =>
+        plugin.name === SERVER_EXTENSIONS_PLUGIN_NAME
+          ? { ...plugin, name }
+          : plugin,
+      );
+      if (!renamed.some(plugin => plugin.name === name)) {
+        renamed.push({ name });
+      }
+      return { plugins: renamed };
+    });
+    api._internalRuntimePlugins(({ entrypoint, plugins }) => {
+      // Same story for the renderer descriptor: `appTools()` already appended
+      // it unless the app opted out.
+      if (
+        !plugins.some(plugin => plugin.path === RENDERER_EXTENSIONS_PACKAGE)
+      ) {
+        plugins.push({
+          name: 'rendererHead',
+          path: RENDERER_EXTENSIONS_PACKAGE,
+          config: {},
+        });
+      }
+      return { entrypoint, plugins };
+    });
+  },
+});