@bleedingdev/modern-js-app-tools 3.5.0-ultramodern.5 → 3.5.0-ultramodern.75

package/dist/esm-node/ultramodern-release-envelope/index.mjs

@@ -0,0 +1,336 @@
+import "node:module";
+import { createHash } from "node:crypto";
+import promises from "node:fs/promises";
+import node_path from "node:path";
+import { canonicalSerializeMicroVerticalReleaseEnvelope, digestMicroVerticalReleaseEnvelopePayload, releaseEnvelopePayload } from "./canonical.mjs";
+import { MICROVERTICAL_RELEASE_ENVELOPE_KIND, MICROVERTICAL_RELEASE_ENVELOPE_SCHEMA_VERSION, MICROVERTICAL_RELEASE_TARGETS } from "./types.mjs";
+const SHA256_PATTERN = /^[a-f0-9]{64}$/u;
+const SOURCE_REVISION_PATTERN = /^(?:[a-f0-9]{40}|[a-f0-9]{64})$/u;
+const TARGETS = new Set(MICROVERTICAL_RELEASE_TARGETS);
+const isRecord = (value)=>'object' == typeof value && null !== value && !Array.isArray(value);
+const assertRecord = (value, location)=>{
+    if (!isRecord(value)) throw new Error(`${location} must be an object.`);
+    return value;
+};
+const assertExactKeys = (value, expected, location)=>{
+    const expectedKeys = new Set(expected);
+    for (const key of Object.keys(value))if (!expectedKeys.has(key)) throw new Error(`${location} contains unknown field "${key}".`);
+    for (const key of expected)if (!(key in value)) throw new Error(`${location}.${key} is required.`);
+};
+const assertNonEmptyString = (value, location)=>{
+    if ('string' != typeof value || 0 === value.trim().length) throw new Error(`${location} must be a non-empty string.`);
+    if (value !== value.trim()) throw new Error(`${location} must not contain surrounding whitespace.`);
+    return value;
+};
+const assertTarget = (value, location = 'target')=>{
+    const target = assertNonEmptyString(value, location);
+    if (!TARGETS.has(target)) throw new Error(`${location} must be one of: ${MICROVERTICAL_RELEASE_TARGETS.join(', ')}.`);
+    return target;
+};
+const assertReleaseIdentity = (value, location = 'identity')=>{
+    const identity = assertRecord(value, location);
+    assertExactKeys(identity, [
+        'unitId',
+        'buildMarker',
+        'sourceRevision',
+        'releaseVersion'
+    ], location);
+    const sourceRevision = assertNonEmptyString(identity.sourceRevision, `${location}.sourceRevision`);
+    if (!SOURCE_REVISION_PATTERN.test(sourceRevision)) throw new Error(`${location}.sourceRevision must be an exact lowercase 40- or 64-character Git object ID; "${sourceRevision}" is not promotable.`);
+    return {
+        unitId: assertNonEmptyString(identity.unitId, `${location}.unitId`),
+        buildMarker: assertNonEmptyString(identity.buildMarker, `${location}.buildMarker`),
+        sourceRevision,
+        releaseVersion: assertNonEmptyString(identity.releaseVersion, `${location}.releaseVersion`)
+    };
+};
+const assertNormalizedLogicalPath = (value, location)=>{
+    const logicalPath = assertNonEmptyString(value, location);
+    if (logicalPath.includes('\\') || node_path.posix.isAbsolute(logicalPath) || node_path.posix.normalize(logicalPath) !== logicalPath || '.' === logicalPath || logicalPath.split('/').some((segment)=>'..' === segment || '.' === segment)) throw new Error(`${location} must be a normalized relative POSIX path.`);
+    return logicalPath;
+};
+const isPathInside = (root, candidate)=>{
+    const relative = node_path.relative(root, candidate);
+    return '' === relative || !relative.startsWith(`..${node_path.sep}`) && '..' !== relative && !node_path.isAbsolute(relative);
+};
+const assertArtifactInput = (value, location)=>{
+    const artifact = assertRecord(value, location);
+    assertExactKeys(artifact, [
+        'logicalPath',
+        'runtime'
+    ], location);
+    return {
+        logicalPath: assertNormalizedLogicalPath(artifact.logicalPath, `${location}.logicalPath`),
+        runtime: assertNonEmptyString(artifact.runtime, `${location}.runtime`)
+    };
+};
+const readFinalArtifact = async (artifactRoot, input, resolvedLogicalPath = input.logicalPath)=>{
+    const artifactInput = {
+        logicalPath: input.logicalPath,
+        runtime: input.runtime
+    };
+    const logicalPath = assertNormalizedLogicalPath(resolvedLogicalPath, `staged path for ${input.logicalPath}`);
+    const resolvedRoot = node_path.resolve(artifactRoot);
+    const logicalSegments = logicalPath.split('/');
+    const lexicalPath = node_path.resolve(resolvedRoot, ...logicalSegments);
+    if (!isPathInside(resolvedRoot, lexicalPath)) throw new Error(`Artifact logicalPath "${logicalPath}" resolves outside artifactRoot.`);
+    const realRoot = await promises.realpath(resolvedRoot);
+    for(let index = 0; index < logicalSegments.length - 1; index++){
+        const linkLogicalPath = logicalSegments.slice(0, index + 1).join('/');
+        const candidate = node_path.join(resolvedRoot, ...logicalSegments.slice(0, index + 1));
+        let candidateStat;
+        try {
+            candidateStat = await promises.lstat(candidate);
+        } catch  {
+            throw new Error(`Artifact "${logicalPath}" does not exist.`);
+        }
+        if (candidateStat.isSymbolicLink()) throw new Error(`Artifact "${logicalPath}" traverses symbolic-link ancestor "${linkLogicalPath}"; bind the symbolic link itself.`);
+    }
+    let lexicalStat;
+    try {
+        lexicalStat = await promises.lstat(lexicalPath);
+    } catch  {
+        throw new Error(`Artifact "${logicalPath}" does not exist.`);
+    }
+    if (lexicalStat.isSymbolicLink()) {
+        let realTarget;
+        try {
+            realTarget = await promises.realpath(lexicalPath);
+        } catch  {
+            throw new Error(`Artifact symbolic link "${logicalPath}" cannot be resolved.`);
+        }
+        if (!isPathInside(realRoot, realTarget)) throw new Error(`Artifact logicalPath "${logicalPath}" resolves outside artifactRoot.`);
+        const targetStat = await promises.stat(realTarget);
+        const targetKind = targetStat.isFile() ? 'file' : targetStat.isDirectory() ? 'directory' : void 0;
+        if (!targetKind) throw new Error(`Artifact symbolic link "${logicalPath}" must resolve to a file or directory.`);
+        const targetLogicalPath = node_path.relative(realRoot, realTarget).split(node_path.sep).join('/');
+        if ('release' === targetLogicalPath || targetLogicalPath.startsWith('release/')) throw new Error(`Artifact symbolic link "${logicalPath}" targets private release metadata.`);
+        if ('directory' === targetKind && isPathInside(realTarget, await promises.realpath(node_path.dirname(lexicalPath)))) throw new Error(`Artifact symbolic link "${logicalPath}" targets an ancestor directory.`);
+        return {
+            ...artifactInput,
+            kind: 'symbolic-link',
+            linkTarget: await promises.readlink(lexicalPath),
+            targetKind,
+            targetLogicalPath
+        };
+    }
+    if (!lexicalStat.isFile()) throw new Error(`Artifact "${logicalPath}" must be a file or symlink.`);
+    const realPath = await promises.realpath(lexicalPath);
+    if (!isPathInside(realRoot, realPath)) throw new Error(`Artifact logicalPath "${logicalPath}" resolves outside artifactRoot.`);
+    const bytes = await promises.readFile(realPath);
+    return {
+        ...artifactInput,
+        kind: 'file',
+        byteLength: bytes.byteLength,
+        sha256: createHash('sha256').update(bytes).digest('hex')
+    };
+};
+const assertReleaseArtifact = (value, location)=>{
+    const artifact = assertRecord(value, location);
+    const kind = assertNonEmptyString(artifact.kind, `${location}.kind`);
+    const input = {
+        logicalPath: artifact.logicalPath,
+        runtime: artifact.runtime
+    };
+    if ('file' === kind) {
+        assertExactKeys(artifact, [
+            'kind',
+            'logicalPath',
+            'runtime',
+            'byteLength',
+            'sha256'
+        ], location);
+        const byteLength = artifact.byteLength;
+        if ('number' != typeof byteLength || !Number.isSafeInteger(byteLength) || byteLength < 0) throw new Error(`${location}.byteLength must be a non-negative integer.`);
+        const sha256 = assertNonEmptyString(artifact.sha256, `${location}.sha256`);
+        if (!SHA256_PATTERN.test(sha256)) throw new Error(`${location}.sha256 must be a lowercase SHA-256 digest.`);
+        return {
+            ...assertArtifactInput(input, location),
+            kind,
+            byteLength,
+            sha256
+        };
+    }
+    if ('symbolic-link' === kind) {
+        assertExactKeys(artifact, [
+            'kind',
+            'logicalPath',
+            'runtime',
+            'linkTarget',
+            'targetKind',
+            'targetLogicalPath'
+        ], location);
+        const targetKind = assertNonEmptyString(artifact.targetKind, `${location}.targetKind`);
+        if ('directory' !== targetKind && 'file' !== targetKind) throw new Error(`${location}.targetKind must be "directory" or "file".`);
+        return {
+            ...assertArtifactInput(input, location),
+            kind,
+            linkTarget: assertNonEmptyString(artifact.linkTarget, `${location}.linkTarget`),
+            targetKind,
+            targetLogicalPath: assertNormalizedLogicalPath(artifact.targetLogicalPath, `${location}.targetLogicalPath`)
+        };
+    }
+    throw new Error(`${location}.kind must be "file" or "symbolic-link".`);
+};
+const assertUniqueSortedArtifacts = (artifacts, location)=>{
+    const paths = artifacts.map((artifact)=>artifact.logicalPath);
+    const unique = new Set(paths);
+    if (unique.size !== paths.length) {
+        const duplicate = paths.find((logicalPath, index)=>paths.indexOf(logicalPath) !== index);
+        throw new Error(`Duplicate artifact logicalPath "${duplicate}".`);
+    }
+    const sorted = [
+        ...paths
+    ].sort((left, right)=>left.localeCompare(right));
+    if (paths.some((logicalPath, index)=>logicalPath !== sorted[index])) throw new Error(`${location} must be sorted by logicalPath.`);
+};
+const assertSurfacePaths = (value, location)=>{
+    if (!Array.isArray(value) || 0 === value.length) throw new Error(`${location} must contain at least one artifact path.`);
+    const paths = value.map((item, index)=>assertNormalizedLogicalPath(item, `${location}[${index}]`));
+    const sorted = [
+        ...paths
+    ].sort((left, right)=>left.localeCompare(right));
+    if (paths.some((logicalPath, index)=>logicalPath !== sorted[index])) throw new Error(`${location} must be sorted by logicalPath.`);
+    if (new Set(paths).size !== paths.length) throw new Error(`${location} must not contain duplicate artifact paths.`);
+    return paths;
+};
+const assertSurfaces = (value)=>{
+    const surfaces = assertRecord(value, 'surfaces');
+    assertExactKeys(surfaces, [
+        'uiClient',
+        'ssr',
+        'apiBackend',
+        'backendFederation'
+    ], 'surfaces');
+    const backendFederation = assertRecord(surfaces.backendFederation, 'surfaces.backendFederation');
+    assertExactKeys(backendFederation, [
+        'manifest',
+        'container'
+    ], 'surfaces.backendFederation');
+    return {
+        uiClient: assertSurfacePaths(surfaces.uiClient, 'surfaces.uiClient'),
+        ssr: assertSurfacePaths(surfaces.ssr, 'surfaces.ssr'),
+        apiBackend: assertSurfacePaths(surfaces.apiBackend, 'surfaces.apiBackend'),
+        backendFederation: {
+            manifest: assertNormalizedLogicalPath(backendFederation.manifest, 'surfaces.backendFederation.manifest'),
+            container: assertNormalizedLogicalPath(backendFederation.container, 'surfaces.backendFederation.container')
+        }
+    };
+};
+const assertSurfaceReferences = (artifacts, surfaces)=>{
+    const artifactPaths = new Set(artifacts.map((artifact)=>artifact.logicalPath));
+    for (const [surface, paths] of Object.entries({
+        uiClient: surfaces.uiClient,
+        ssr: surfaces.ssr,
+        apiBackend: surfaces.apiBackend,
+        'backendFederation.manifest': [
+            surfaces.backendFederation.manifest
+        ],
+        'backendFederation.container': [
+            surfaces.backendFederation.container
+        ]
+    }))for (const logicalPath of paths)if (!artifactPaths.has(logicalPath)) throw new Error(`surfaces.${surface} references unbound artifact "${logicalPath}".`);
+};
+const assertTargetSurfaceContract = (target, artifacts, surfaces)=>{
+    const byPath = new Map(artifacts.map((artifact)=>[
+            artifact.logicalPath,
+            artifact
+        ]));
+    const assertRuntime = (paths, expected, surface)=>{
+        for (const logicalPath of paths){
+            const artifact = byPath.get(logicalPath);
+            if (artifact?.runtime !== expected) throw new Error(`${target} ${surface} artifact "${logicalPath}" must use runtime "${expected}"; received "${String(artifact?.runtime)}".`);
+            if ('kind' in artifact && 'file' !== artifact.kind) throw new Error(`${target} ${surface} artifact "${logicalPath}" must be a file.`);
+        }
+    };
+    assertRuntime(surfaces.uiClient, 'browser', 'UI/client');
+    assertRuntime(surfaces.ssr, 'node' === target ? 'nodejs' : 'workerd', 'SSR');
+    assertRuntime(surfaces.apiBackend, 'node' === target ? 'nodejs' : 'workerd-effect', 'API/backend');
+    assertRuntime([
+        surfaces.backendFederation.manifest
+    ], 'module-federation-manifest', 'backend federation manifest');
+    assertRuntime([
+        surfaces.backendFederation.container
+    ], 'node' === target ? 'nodejs' : 'commonjs-module', 'backend federation container');
+};
+const deepFreeze = (value)=>{
+    if (null !== value && 'object' == typeof value && !Object.isFrozen(value)) {
+        Object.freeze(value);
+        for (const child of Object.values(value))deepFreeze(child);
+    }
+    return value;
+};
+const assertEnvelope = (value)=>{
+    const envelope = assertRecord(value, 'envelope');
+    assertExactKeys(envelope, [
+        'schemaVersion',
+        'kind',
+        'target',
+        'identity',
+        'artifacts',
+        'surfaces',
+        'envelopeDigest'
+    ], 'envelope');
+    if (envelope.schemaVersion !== MICROVERTICAL_RELEASE_ENVELOPE_SCHEMA_VERSION) throw new Error(`envelope.schemaVersion must be ${MICROVERTICAL_RELEASE_ENVELOPE_SCHEMA_VERSION}.`);
+    if (envelope.kind !== MICROVERTICAL_RELEASE_ENVELOPE_KIND) throw new Error(`envelope.kind must be "${MICROVERTICAL_RELEASE_ENVELOPE_KIND}".`);
+    if (!Array.isArray(envelope.artifacts) || 0 === envelope.artifacts.length) throw new Error('envelope.artifacts must contain at least one artifact.');
+    const artifacts = envelope.artifacts.map((artifact, index)=>assertReleaseArtifact(artifact, `envelope.artifacts[${index}]`));
+    assertUniqueSortedArtifacts(artifacts, 'envelope.artifacts');
+    const target = assertTarget(envelope.target, 'envelope.target');
+    const surfaces = assertSurfaces(envelope.surfaces);
+    assertSurfaceReferences(artifacts, surfaces);
+    assertTargetSurfaceContract(target, artifacts, surfaces);
+    const parsed = {
+        schemaVersion: MICROVERTICAL_RELEASE_ENVELOPE_SCHEMA_VERSION,
+        kind: MICROVERTICAL_RELEASE_ENVELOPE_KIND,
+        target,
+        identity: assertReleaseIdentity(envelope.identity, 'envelope.identity'),
+        artifacts,
+        surfaces,
+        envelopeDigest: assertNonEmptyString(envelope.envelopeDigest, 'envelope.envelopeDigest')
+    };
+    if (!SHA256_PATTERN.test(parsed.envelopeDigest)) throw new Error('envelope.envelopeDigest must be a lowercase SHA-256 digest.');
+    const expectedDigest = digestMicroVerticalReleaseEnvelopePayload(releaseEnvelopePayload(parsed));
+    if (parsed.envelopeDigest !== expectedDigest) throw new Error('envelope.envelopeDigest does not match canonical payload.');
+    return parsed;
+};
+const createMicroVerticalReleaseEnvelope = async (input)=>{
+    const artifactRoot = await promises.realpath(node_path.resolve(input.artifactRoot));
+    const target = assertTarget(input.target);
+    const identity = assertReleaseIdentity(input.identity);
+    if (!Array.isArray(input.artifacts) || 0 === input.artifacts.length) throw new Error('artifacts must contain at least one artifact.');
+    const inputs = input.artifacts.map((artifact, index)=>assertArtifactInput(artifact, `artifacts[${index}]`));
+    const sortedInputs = [
+        ...inputs
+    ].sort((left, right)=>left.logicalPath.localeCompare(right.logicalPath));
+    assertUniqueSortedArtifacts(sortedInputs, 'artifacts');
+    const surfaces = assertSurfaces(input.surfaces);
+    assertSurfaceReferences(sortedInputs, surfaces);
+    assertTargetSurfaceContract(target, sortedInputs, surfaces);
+    const artifacts = await Promise.all(sortedInputs.map((artifact)=>readFinalArtifact(artifactRoot, artifact)));
+    assertTargetSurfaceContract(target, artifacts, surfaces);
+    const payload = {
+        schemaVersion: MICROVERTICAL_RELEASE_ENVELOPE_SCHEMA_VERSION,
+        kind: MICROVERTICAL_RELEASE_ENVELOPE_KIND,
+        target,
+        identity,
+        artifacts,
+        surfaces
+    };
+    return deepFreeze({
+        ...payload,
+        envelopeDigest: digestMicroVerticalReleaseEnvelopePayload(payload)
+    });
+};
+const verifyMicroVerticalReleaseEnvelope = async (value, options)=>{
+    const envelope = assertEnvelope(value);
+    if (void 0 !== options.expectedTarget && envelope.target !== options.expectedTarget) throw new Error(`envelope.target must be "${options.expectedTarget}" for this staging target; received "${envelope.target}".`);
+    const artifactRoot = await promises.realpath(node_path.resolve(options.artifactRoot));
+    for (const artifact of envelope.artifacts){
+        const finalArtifact = await readFinalArtifact(artifactRoot, artifact, options.logicalPathForArtifact?.(artifact) ?? artifact.logicalPath);
+        const matches = finalArtifact.kind === artifact.kind && ('file' === artifact.kind && 'file' === finalArtifact.kind ? finalArtifact.byteLength === artifact.byteLength && finalArtifact.sha256 === artifact.sha256 : 'symbolic-link' === artifact.kind && 'symbolic-link' === finalArtifact.kind && finalArtifact.linkTarget === artifact.linkTarget && finalArtifact.targetKind === artifact.targetKind && finalArtifact.targetLogicalPath === artifact.targetLogicalPath);
+        if (!matches) throw new Error('file' === artifact.kind && 'file' === finalArtifact.kind ? `Artifact "${artifact.logicalPath}" digest does not match final artifact bytes.` : `Artifact "${artifact.logicalPath}" does not match its final filesystem binding.`);
+    }
+    return deepFreeze(envelope);
+};
+export { MICROVERTICAL_RELEASE_ENVELOPE_KIND, MICROVERTICAL_RELEASE_ENVELOPE_SCHEMA_VERSION, MICROVERTICAL_RELEASE_TARGETS, canonicalSerializeMicroVerticalReleaseEnvelope, createMicroVerticalReleaseEnvelope, verifyMicroVerticalReleaseEnvelope };

package/dist/esm-node/ultramodern-release-envelope/types.mjs

@@ -0,0 +1,8 @@
+import "node:module";
+const MICROVERTICAL_RELEASE_ENVELOPE_SCHEMA_VERSION = 3;
+const MICROVERTICAL_RELEASE_ENVELOPE_KIND = 'ultramodern-target-microvertical-release-envelope';
+const MICROVERTICAL_RELEASE_TARGETS = [
+    'node',
+    'cloudflare'
+];
+export { MICROVERTICAL_RELEASE_ENVELOPE_KIND, MICROVERTICAL_RELEASE_ENVELOPE_SCHEMA_VERSION, MICROVERTICAL_RELEASE_TARGETS };

package/dist/esm-node/ultramodern-release-identity.mjs

@@ -0,0 +1,67 @@
+import "node:module";
+import { execFileSync } from "node:child_process";
+import { createHash } from "node:crypto";
+const BUILD_MARKER_NAMESPACE = 'ultramodern-delivery-unit-release-build-marker:v1';
+const PROMOTABLE_SOURCE_REVISION_PATTERN = /^(?:[a-f0-9]{40}|[a-f0-9]{64})$/u;
+const gitOutput = (workspaceRoot, args)=>{
+    try {
+        return execFileSync('git', [
+            '-C',
+            workspaceRoot,
+            ...args
+        ], {
+            encoding: 'utf8',
+            stdio: [
+                'ignore',
+                'pipe',
+                'ignore'
+            ]
+        }).trim();
+    } catch  {
+        return;
+    }
+};
+const createUltramodernReleaseBuildMarker = ({ generationBuildMarker, sourceRevision, unitId })=>createHash('sha256').update(`${BUILD_MARKER_NAMESPACE}:${unitId}:${generationBuildMarker}:${sourceRevision}`).digest('hex').slice(0, 16);
+const resolveUltramodernSourceRevision = (workspaceRoot = process.cwd(), configuredSourceRevision)=>{
+    const configuredArgumentValue = configuredSourceRevision?.trim();
+    const configuredEnvironmentValue = process.env.ULTRAMODERN_SOURCE_REVISION?.trim();
+    const configuredArgument = configuredArgumentValue && 'workspace' !== configuredArgumentValue ? configuredArgumentValue : void 0;
+    const configuredEnvironment = configuredEnvironmentValue && 'workspace' !== configuredEnvironmentValue ? configuredEnvironmentValue : void 0;
+    if (configuredArgument && configuredEnvironment && configuredArgument !== configuredEnvironment) throw new Error(`Configured source revision ${configuredArgument} does not match environment source revision ${configuredEnvironment}.`);
+    const configured = configuredArgument ?? configuredEnvironment;
+    const gitRoot = gitOutput(workspaceRoot, [
+        'rev-parse',
+        '--show-toplevel'
+    ]);
+    if (!gitRoot) {
+        if (!configured) return 'workspace';
+        if (!PROMOTABLE_SOURCE_REVISION_PATTERN.test(configured)) throw new Error(`Configured source revision ${configured} must be an exact lowercase 40- or 64-character Git object ID.`);
+        return configured;
+    }
+    const revision = gitOutput(gitRoot, [
+        'rev-parse',
+        'HEAD'
+    ]);
+    const status = gitOutput(gitRoot, [
+        'status',
+        '--porcelain=v1',
+        '--untracked-files=all'
+    ]);
+    if (!revision || void 0 === status || status.length > 0) return 'workspace';
+    if (!PROMOTABLE_SOURCE_REVISION_PATTERN.test(revision)) return 'workspace';
+    if (configured && configured !== revision) throw new Error(`Configured source revision ${configured} does not match clean Git HEAD ${revision}.`);
+    return revision;
+};
+const resolveUltramodernReleaseIdentity = ({ generationBuildMarker, sourceRevision: configuredSourceRevision, unitId, workspaceRoot })=>{
+    const explicitSourceRevision = configuredSourceRevision?.trim();
+    const sourceRevision = resolveUltramodernSourceRevision(workspaceRoot, explicitSourceRevision);
+    return {
+        buildMarker: 'workspace' === sourceRevision ? generationBuildMarker : createUltramodernReleaseBuildMarker({
+            generationBuildMarker,
+            sourceRevision,
+            unitId
+        }),
+        sourceRevision
+    };
+};
+export { createUltramodernReleaseBuildMarker, resolveUltramodernReleaseIdentity, resolveUltramodernSourceRevision };

package/dist/types/builder/generator/createCopyPattern.d.ts

@@ -1,12 +1,13 @@
 import type { Rspack, RspackChain } from '@rsbuild/core';
 import type { AppNormalizedConfig } from '../../types';
 import type { AppToolsContext } from '../../types/plugin';
+declare const info: (file: {
+    sourceFilename: string;
+}) => {
+    minimized: boolean;
+};
 export declare function createPublicPattern(appContext: AppToolsContext, config: AppNormalizedConfig, chain: RspackChain): {
-    info: (file: {
-        sourceFilename: string;
-    }) => {
-        minimized: boolean;
-    };
+    info: typeof info;
     from: string;
     to: string;
     context: string;
@@ -14,3 +15,4 @@ export declare function createPublicPattern(appContext: AppToolsContext, config:
     transform: (content: Buffer, absoluteFrom: string) => string | Buffer<ArrayBufferLike>;
 };
 export declare function createUploadPattern(appContext: AppToolsContext, config: AppNormalizedConfig): Rspack.CopyRspackPluginOptions['patterns']['0'];
+export {};

package/dist/types/builder/shared/bundlerPlugins/CssExtractRuntimePlugin.d.ts

@@ -0,0 +1,6 @@
+import type { Rspack } from '@rsbuild/core';
+export declare const normalizeCssExtractRuntimeStylesheetLookup: (source: string) => string;
+export declare class CssExtractRuntimePlugin {
+    readonly name = "ModernjsCssExtractRuntimePlugin";
+    apply(compiler: Rspack.Compiler): void;
+}

package/dist/types/builder/shared/bundlerPlugins/RouterPlugin.d.ts

@@ -16,6 +16,7 @@ type Options = {
     nonce?: string;
     useRsc?: boolean;
 };
+export declare const normalizeRouterAssetPublicPath: (publicPath: string | undefined) => string;
 export declare class RouterPlugin {
     readonly name: string;
     private HtmlBundlerPlugin;

package/dist/types/builder/shared/bundlerPlugins/index.d.ts

@@ -1,3 +1,4 @@
+export * from './CssExtractRuntimePlugin';
 export * from './HtmlAsyncChunkPlugin';
 export * from './HtmlBottomTemplate';
 export * from './RouterPlugin';

package/dist/types/builder/shared/lazyCompilation.d.ts

@@ -6,7 +6,7 @@ type ModuleLike = {
 type LazyCompilationTestFn = (m: ModuleLike) => boolean;
 /** Matches Rspack's `LazyCompilationOptions['test']`. */
 type LazyCompilationTest = RegExp | LazyCompilationTestFn | undefined;
-export type EagerRouteComponentInfo = {
+type EagerRouteComponentInfo = {
     files: Set<string>;
     /** Specifiers that could not be resolved, keyed by entry name. */
     unresolvedByEntry: Map<string, string[]>;
@@ -26,8 +26,7 @@ export declare function aggregateEagerRouteComponentFiles(byEntry: EagerRouteCom
  * (defaulting to lazy when the user did not provide one).
  */
 export declare function buildRouteEagerLazyCompilationTest(eagerRouteFiles: Set<string>, userTest?: LazyCompilationTest): LazyCompilationTestFn;
-export declare const buildSSRLazyCompilationTest: typeof buildRouteEagerLazyCompilationTest;
-export type SSRLazyPlan = {
+type SSRLazyPlan = {
     apply: false;
     unresolvedByEntry?: Map<string, string[]>;
 } | {
@@ -42,4 +41,3 @@ export type SSRLazyPlan = {
  * existing `dev.lazyCompilation` value (lazy must be enabled for this to apply).
  */
 export declare function planRouteEagerLazyCompilation(current: unknown, info: EagerRouteComponentInfo): SSRLazyPlan;
-export declare const planSSRLazyCompilation: typeof planRouteEagerLazyCompilation;

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

@@ -7,4 +7,3 @@ export declare const serverCommand: (program: Command, api: CLIPluginAPI<AppTool
 export declare const deployCommand: (program: Command, api: CLIPluginAPI<AppTools>) => void;
 export declare const inspectCommand: (program: Command, api: CLIPluginAPI<AppTools>) => void;
 export declare const infoCommand: (program: Command, api: CLIPluginAPI<AppTools>) => void;
-export { runtimeCommand } from './runtime';

package/dist/types/config/build-environment.d.ts

@@ -0,0 +1,22 @@
+import type { URL } from 'node:url';
+import type { Rspack } from '@rsbuild/core';
+/**
+ * Reads an environment variable while keeping generated build configs free of
+ * direct process access.
+ */
+export declare function getBuildConfigEnvironment(name: string): string | undefined;
+/**
+ * Runs a Rspack config setup under a leased environment value. The lease is
+ * restored when that compiler reaches any supported terminal hook.
+ */
+export declare function withBuildConfigEnvironment<Config extends {
+    plugins?: Rspack.Plugin[];
+}, SetupArguments extends unknown[]>(name: string, value: string, setup: (config: Config, ...args: SetupArguments) => Config | void | Promise<Config | void>): (config: Config, ...args: SetupArguments) => Promise<Config>;
+export type ResolveEffectTsgoCompilerOptions = {
+    /** Module URL or absolute filename used to resolve the consumer's compiler. */
+    from: string | URL;
+};
+/**
+ * Resolves the Effect TS-Go executable used by Module Federation DTS builds.
+ */
+export declare function resolveEffectTsgoCompiler(options: ResolveEffectTsgoCompilerOptions): string;

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

@@ -1,2 +1,3 @@
+export * from './build-environment';
 export * from './default';
 export * from './initialize';

package/dist/types/config/public.d.ts

@@ -0,0 +1,2 @@
+export type { ResolveEffectTsgoCompilerOptions } from './build-environment';
+export { getBuildConfigEnvironment, resolveEffectTsgoCompiler, withBuildConfigEnvironment, } from './build-environment';

package/dist/types/index.d.ts

@@ -1,9 +1,7 @@
 import type { AppTools, CliPlugin } from './types';
 import { initAppContext } from './utils/initAppContext';
-export * from './baseline';
 export * from './defineConfig';
 export * from './presetUltramodern';
-export * from './ultramodern/designSystem';
 export declare const appTools: () => CliPlugin<AppTools>;
 export { dev } from './commands/dev';
 export { serve } from './commands/serve';

package/dist/types/plugins/analyze/getServerRoutes.d.ts

@@ -6,3 +6,4 @@ export declare const getServerRoutes: (entrypoints: Entrypoint[], { appContext,
     config: AppNormalizedConfig;
 }) => ServerRoute[];
 export declare const getProdServerRoutes: (distDirectory: string) => any;
+export declare const getProdEntrypoints: (distDirectory: string, routes: ServerRoute[], mainEntryName?: any) => Entrypoint[];

package/dist/types/plugins/backend-federation/codegen.d.ts

@@ -0,0 +1,83 @@
+import { type BackendFederationApp } from './config';
+export declare const createBackendRemoteEntrySource: (workspaceRoot: string, app: BackendFederationApp, effectApiPath: string, entryPath: string) => Promise<string>;
+export declare const createBackendManifest: (workspaceRoot: string, distDirectory: string, app: BackendFederationApp) => {
+    schemaVersion: number;
+    id: string;
+    name: string;
+    version: string | undefined;
+    buildVersion: string | undefined;
+    metaData: {
+        name: string;
+        type: string;
+        buildInfo: {
+            buildVersion: string | undefined;
+            buildName: string | undefined;
+        };
+        remoteEntry: {
+            name: string;
+            path: string;
+            type: string;
+        };
+        globalName: string;
+        publicPath: string;
+        ssrRemoteEntry: {
+            name: string;
+            path: string;
+            type: string;
+        };
+        ssrPublicPath: string;
+    };
+    entry: {
+        file: string;
+        path: string;
+        type: string;
+        url: string;
+    };
+    exposes: {
+        id: string;
+        name: string;
+        path: string;
+        assets: {
+            js: {
+                async: never[];
+                sync: string[];
+            };
+            css: {
+                async: never[];
+                sync: never[];
+            };
+        };
+    }[];
+    shared: never[];
+    backendFederation: {
+        role: string;
+        appId: string;
+        name: string;
+        runtimeFramework: string;
+        strictEffectApproach: boolean;
+        contractVersion: string;
+        nodeAdapterVersion: string;
+        remoteType: string;
+        expose: string;
+        manifestUrl: string;
+        containerEntry: string;
+        source: {
+            module: string;
+        };
+        readinessPath: string;
+        openapiPath: string;
+        deliveryUnit?: import("@modern-js/utils/universal").DeliveryUnitContractBlock | undefined;
+        versionBoundary: {
+            invariant: string;
+            packageName: string | undefined;
+            version: string | undefined;
+            buildVersion: string | undefined;
+            uiManifestUrl?: string | undefined;
+            deliveryUnit?: {
+                unitId: string;
+                buildMarker: string;
+                sourceRevision: string;
+            } | undefined;
+        };
+    };
+};