@bleedingdev/modern-js-create 3.5.0-ultramodern.4 → 3.5.0-ultramodern.41

package/dist/esm-node/ultramodern-workspace/app-files.js

@@ -28,17 +28,14 @@ function createAppEnvDts(app, remotes = []) {
 }
 `;
         })).join('\n');
-    const reactTypeReference = remoteModuleDeclarations ? "/// <reference types='react' />\n" : '';
-    const siteUrlDeclaration = 'declare const ULTRAMODERN_SITE_URL: string;';
-    return `${reactTypeReference}/// <reference types='@modern-js/app-tools/types' />
-
-${siteUrlDeclaration}
-declare module '*.svg' {
-  const url: string;
-  export default url;
-}
-declare module '*.css';
-${remoteModuleDeclarations ? `\n${remoteModuleDeclarations}` : ''}`;
+    const reactTypeImport = remoteModuleDeclarations ? "import type React from 'react';\n" : '';
+    return [
+        `import '@modern-js/app-tools/types';\n${reactTypeImport}`.trimEnd(),
+        `declare global {
+  const ULTRAMODERN_SITE_URL: string;
+}`,
+        remoteModuleDeclarations.trimEnd()
+    ].filter((section)=>section.length > 0).join('\n\n').concat('\n');
 }
 function createAppRuntimeConfig(app, scope, remotes = []) {
     const pluginsConfig = 'shell' === app.kind ? `  plugins: [
@@ -115,29 +112,11 @@ function createRemoteStyles(enableTailwind, scope, app) {
 function createAppStyles(enableTailwind, scope, app) {
     return 'shell' === app.kind ? createShellStyles(enableTailwind, scope) : createRemoteStyles(enableTailwind, scope, app);
 }
-function createPostcssConfig() {
-    return `export default {
-  plugins: {
-    '@tailwindcss/postcss': {},
-  },
-};
-`;
-}
 function createTailwindConfig() {
-    return `import type { Config } from 'tailwindcss';
-
-export default {} satisfies Config;
-`;
+    return renderFileTemplate('workspace/tailwind.config.ts', {});
 }
 function createSharedDesignTokensCss() {
-    return `@theme {
-  --color-um-accent: #2f8f68;
-  --color-um-canvas: #f1eadc;
-  --color-um-foreground: #133225;
-  --color-um-link: #166b4b;
-  --color-um-surface: #f6fbf7;
-}
-`;
+    return renderFileTemplate('workspace/packages/shared-design-tokens/tokens.css', {});
 }
 function createRouteHeadModule(app) {
     return renderFileTemplate('app/ultramodern-route-head.tsx', {
@@ -147,4 +126,4 @@ function createRouteHeadModule(app) {
 function createShellFrameComponent() {
     return readFileTemplate('app/shell-frame.tsx');
 }
-export { createAppEnvDts, createAppRuntimeConfig, createAppStyles, createBoundaryDebugMetadata, createCssTokenImport, createPostcssConfig, createRemoteStyles, createRouteHeadModule, createSharedDesignTokensCss, createShellFrameComponent, createShellStyles, createTailwindConfig, createTailwindImport };
+export { createAppEnvDts, createAppRuntimeConfig, createAppStyles, createRouteHeadModule, createSharedDesignTokensCss, createShellFrameComponent, createTailwindConfig };

package/dist/esm-node/ultramodern-workspace/backend-federation.js

@@ -0,0 +1,232 @@
+import "node:module";
+import { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_EFFECT_EXPOSE, BACKEND_FEDERATION_NODE_ADAPTER_VERSION, formatBackendFederationValidationErrors, validateBackendFederationMetadata } from "@modern-js/utils/universal";
+import { verticalApiExport, verticalApiGroupName } from "./api.js";
+import { createDeliveryUnitRecord, deliveryUnitContractBlock } from "./delivery-unit.js";
+import { appHasApi, createBackendFederationContainerEntry, createBackendFederationManifestEnv, createBackendFederationManifestUrl, createBackendFederationName, createCloudflarePublicUrlEnv, createCloudflareWorkerName, createRemoteManifestEnv, resolveApiPrefix, resolveApiStem } from "./descriptors.js";
+import { packageName, toEnvSegment } from "./naming.js";
+import { EFFECT_VERSION, MODULE_FEDERATION_VERSION } from "./versions.js";
+function createZephyrEnv(app, suffix) {
+    return `ZEPHYR_${toEnvSegment(app.domain ?? app.id)}_${suffix}`;
+}
+function createWorkerBindingName(app) {
+    return `VERTICAL_${toEnvSegment(app.domain ?? app.id)}_WORKER`;
+}
+function createWorkerBindingEnv(app) {
+    return `VERTICAL_${toEnvSegment(app.domain ?? app.id)}_WORKER_BINDING`;
+}
+function createDispatchNamespaceEnv(app) {
+    return `VERTICAL_${toEnvSegment(app.domain ?? app.id)}_DISPATCH_NAMESPACE`;
+}
+function createDispatchWorkerNameEnv(app) {
+    return `VERTICAL_${toEnvSegment(app.domain ?? app.id)}_WORKER_NAME`;
+}
+function createEffectExpose(app) {
+    const apiStem = resolveApiStem(app);
+    return {
+        contract: `${app.directory}/shared/api.ts`,
+        runtime: `${app.directory}/api/index.ts`,
+        client: `${app.directory}/src/api/${app.api.stem}-client.ts`,
+        openapi: `${app.api.prefix}/openapi.json`,
+        readiness: `${app.api.prefix}/${apiStem}/readiness`
+    };
+}
+function createCloudflareExecutionSurface(scope, app) {
+    return {
+        kind: 'cloudflare-worker-snapshot',
+        workerName: createCloudflareWorkerName(scope, app),
+        publicUrlEnv: createCloudflarePublicUrlEnv(app),
+        ssr: {
+            workerEntry: '.output/server/index.mjs',
+            workerManifest: '.output/server/modern-worker-manifest.json',
+            routeManifest: '.output/server/route.json',
+            ssrBundle: '.output/worker/index.js',
+            effectBffBundle: '.output/worker/__modern_bff_effect.js',
+            assetsBinding: 'ASSETS'
+        },
+        zephyr: {
+            runtime: 'ssr-worker',
+            integration: 'managed-cloudflare',
+            snapshotIdEnv: createZephyrEnv(app, 'SNAPSHOT_ID'),
+            versionIdEnv: createZephyrEnv(app, 'VERSION_ID'),
+            applicationUidEnv: createZephyrEnv(app, 'APPLICATION_UID')
+        },
+        workerDispatch: {
+            preferred: 'service-binding',
+            serviceBinding: createWorkerBindingName(app),
+            serviceBindingEnv: createWorkerBindingEnv(app),
+            dispatchNamespaceEnv: createDispatchNamespaceEnv(app),
+            dispatchWorkerNameEnv: createDispatchWorkerNameEnv(app),
+            requestInterface: 'fetch'
+        }
+    };
+}
+function createNodeExecutionSurface(app, deliveryUnit) {
+    return {
+        kind: 'node-mf-runtime',
+        adapterVersion: BACKEND_FEDERATION_NODE_ADAPTER_VERSION,
+        remoteName: createBackendFederationName(app),
+        manifestEnv: createBackendFederationManifestEnv(app),
+        manifestUrl: createBackendFederationManifestUrl(app),
+        containerEntry: createBackendFederationContainerEntry(app),
+        remoteType: 'module',
+        expose: BACKEND_FEDERATION_EFFECT_EXPOSE,
+        runtimePackage: '@modern-js/plugin-bff/effect',
+        ...deliveryUnit ? {
+            expected: {
+                unitId: deliveryUnit.unitId,
+                buildMarker: deliveryUnit.buildMarker
+            }
+        } : {}
+    };
+}
+function createServerExecutionOverlay(scope, app) {
+    if (!appHasApi(app)) return;
+    const deliveryUnit = createDeliveryUnitRecord(scope, app);
+    return {
+        apiBaseUrl: `http://localhost:${app.port}${resolveApiPrefix(app)}`,
+        versionBoundary: 'web-and-api-same-build',
+        deliveryUnit: {
+            unitId: deliveryUnit.unitId,
+            buildMarker: deliveryUnit.buildMarker
+        },
+        cloudflare: createCloudflareExecutionSurface(scope, app),
+        node: createNodeExecutionSurface(app, deliveryUnit)
+    };
+}
+function createBackendFederationContract(scope, app) {
+    if (!appHasApi(app)) return;
+    const readiness = `${app.api.prefix}/${resolveApiStem(app)}/readiness`;
+    const deliveryUnit = createDeliveryUnitRecord(scope, app);
+    const contract = {
+        role: 'microvertical-server',
+        name: createBackendFederationName(app),
+        runtimeFramework: 'effect',
+        strictEffectApproach: true,
+        deliveryUnit: deliveryUnitContractBlock(deliveryUnit),
+        exposes: {
+            [BACKEND_FEDERATION_EFFECT_EXPOSE]: createEffectExpose(app)
+        },
+        versionBoundary: {
+            invariant: 'web-and-api-same-build',
+            identityRoot: 'deliveryUnit',
+            packageName: packageName(scope, app.packageSuffix),
+            ui: {
+                manifestEnv: createRemoteManifestEnv(app),
+                manifestUrl: `http://localhost:${app.port}/mf-manifest.json`,
+                buildMarker: `${app.directory}/src/routes/ultramodern-route-metadata.ts`
+            },
+            api: {
+                readiness,
+                buildMarker: `${app.directory}/shared/ultramodern-build.ts`,
+                publicUrlEnv: createCloudflarePublicUrlEnv(app)
+            }
+        },
+        executionSurfaces: {
+            cloudflare: createCloudflareExecutionSurface(scope, app),
+            node: createNodeExecutionSurface(app, deliveryUnit)
+        },
+        compatibility: {
+            contractVersion: BACKEND_FEDERATION_CONTRACT_VERSION,
+            packageName: packageName(scope, app.packageSuffix),
+            effectVersion: EFFECT_VERSION,
+            moduleFederationVersion: MODULE_FEDERATION_VERSION
+        },
+        cache: {
+            cloudflareSnapshot: 'immutable',
+            nodeManifest: 'no-store',
+            nodeVersionedContainer: 'immutable',
+            nodeUnpinnedContainer: 'revalidate'
+        },
+        fallback: {
+            timeoutMs: 1500,
+            failureEvent: 'modernjs:microvertical-server-fallback',
+            strategy: 'typed-effect-error'
+        }
+    };
+    const validation = validateBackendFederationMetadata(contract, {
+        path: `${app.id}.backendFederation`,
+        requireEffectExpose: true,
+        requireEffectRuntime: true,
+        requireVersionFields: true
+    });
+    if (!validation.ok) throw new Error(`Backend federation contract invalid for ${app.id}: ${formatBackendFederationValidationErrors(validation.errors)}.`);
+    return contract;
+}
+function createBackendFederationMetadata(scope, app) {
+    if (!appHasApi(app)) return;
+    return {
+        contractVersion: BACKEND_FEDERATION_CONTRACT_VERSION,
+        deliveryUnit: deliveryUnitContractBlock(createDeliveryUnitRecord(scope, app)),
+        executionSurfaces: [
+            'node-mf-runtime'
+        ],
+        exposes: [
+            BACKEND_FEDERATION_EFFECT_EXPOSE
+        ],
+        name: createBackendFederationName(app),
+        nodeAdapterVersion: BACKEND_FEDERATION_NODE_ADAPTER_VERSION,
+        openapiPath: `${app.api.prefix}/openapi.json`,
+        readinessPath: `${app.api.prefix}/${resolveApiStem(app)}/readiness`,
+        role: 'microvertical-server',
+        runtimeFramework: 'effect',
+        strictEffectApproach: true
+    };
+}
+function createBackendFederationContractFile(app) {
+    if (!app.api) throw new Error(`App ${app.id} does not define an Effect API.`);
+    const apiExport = verticalApiExport(app);
+    const groupName = verticalApiGroupName(app);
+    const readinessPath = `${app.api.prefix}/${resolveApiStem(app)}/readiness`;
+    return `import runtime from './index.ts';
+import { ultramodernApiMarker } from '../shared/ultramodern-build.ts';
+import {
+  ${apiExport} as api,
+  ${groupName}ApiContract as contract,
+  ${groupName}OperationContexts as operationContexts,
+} from '../shared/api.ts';
+
+export const backendFederationContract = {
+  compatibility: {
+    build: ultramodernApiMarker.build,
+    contractVersion: '${BACKEND_FEDERATION_CONTRACT_VERSION}',
+    nodeAdapterVersion: '${BACKEND_FEDERATION_NODE_ADAPTER_VERSION}',
+    packageName: ultramodernApiMarker.packageName,
+    sourceRevision: ultramodernApiMarker.sourceRevision,
+    unitId: ultramodernApiMarker.unitId,
+  },
+  contractVersion: '${BACKEND_FEDERATION_CONTRACT_VERSION}',
+  executionSurfaces: ['node-mf-runtime'],
+  exposes: ['${BACKEND_FEDERATION_EFFECT_EXPOSE}'],
+  name: '${createBackendFederationName(app)}',
+  nodeAdapterVersion: '${BACKEND_FEDERATION_NODE_ADAPTER_VERSION}',
+  openapiPath: '${app.api.prefix}/openapi.json',
+  readinessPath: '${readinessPath}',
+  role: 'microvertical-server',
+  runtimeFramework: 'effect',
+  strictEffectApproach: true,
+} as const;
+
+export { api, contract, operationContexts, runtime };
+
+export default runtime;
+`;
+}
+function createBackendFederationSummary(scope, app) {
+    if (!appHasApi(app)) return;
+    const deliveryUnit = createDeliveryUnitRecord(scope, app);
+    return {
+        id: app.id,
+        path: app.directory,
+        role: 'microvertical-server',
+        name: createBackendFederationName(app),
+        runtimeFramework: 'effect',
+        strictEffectApproach: true,
+        contractVersion: BACKEND_FEDERATION_CONTRACT_VERSION,
+        deliveryUnit: deliveryUnitContractBlock(deliveryUnit),
+        executionSurfaces: {
+            cloudflare: createCloudflareExecutionSurface(scope, app),
+            node: createNodeExecutionSurface(app, deliveryUnit)
+        }
+    };
+}
+export { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_NODE_ADAPTER_VERSION, createBackendFederationContract, createBackendFederationContractFile, createBackendFederationMetadata, createBackendFederationSummary, createDispatchWorkerNameEnv, createServerExecutionOverlay, createWorkerBindingEnv, createWorkerBindingName };

package/dist/esm-node/ultramodern-workspace/bridge-config/cli.js

@@ -0,0 +1,31 @@
+import "node:module";
+import { readBridgeGates } from "./gates.js";
+import { normalizeUltramodernBridgeConfig } from "./normalize.js";
+import { ultramodernBridgeCliBooleanFlags, ultramodernBridgeCliFlags, ultramodernBridgeCliValueFlags } from "./schema.js";
+import { parseLockfilePolicy, readCsvOptionValues, readSingleValue, rejectBooleanFlagValues, requireNonEmptyValue } from "./shared.js";
+import { readWorkspacePackages } from "./workspace-packages.js";
+function hasUltramodernBridgeCliOptions(args) {
+    return args.some((arg)=>[
+            ...ultramodernBridgeCliBooleanFlags,
+            ...ultramodernBridgeCliValueFlags
+        ].some((flag)=>arg === flag || arg.startsWith(`${flag}=`)));
+}
+function parseUltramodernBridgeCliOptions(args) {
+    rejectBooleanFlagValues(args);
+    if (!hasUltramodernBridgeCliOptions(args)) return;
+    const parentRoot = readSingleValue(args, ultramodernBridgeCliFlags.parentRoot);
+    const lockfilePolicy = readSingleValue(args, ultramodernBridgeCliFlags.lockfilePolicy) ?? 'nested';
+    const workspacePackages = readWorkspacePackages(args);
+    const gates = readBridgeGates(args);
+    const reactSingletons = readCsvOptionValues(args, ultramodernBridgeCliFlags.reactSingleton);
+    return normalizeUltramodernBridgeConfig({
+        enabled: true,
+        parentRoot: requireNonEmptyValue(parentRoot, ultramodernBridgeCliFlags.parentRoot),
+        workspacePackages,
+        dependencies: readCsvOptionValues(args, ultramodernBridgeCliFlags.dependency),
+        lockfilePolicy: parseLockfilePolicy(lockfilePolicy),
+        gates,
+        reactSingletons: reactSingletons.length > 0 ? reactSingletons : void 0
+    });
+}
+export { hasUltramodernBridgeCliOptions, parseUltramodernBridgeCliOptions };

package/dist/esm-node/ultramodern-workspace/bridge-config/defaults.js

@@ -0,0 +1,6 @@
+import "node:module";
+const defaultReactSingletons = [
+    'react',
+    'react-dom'
+];
+export { defaultReactSingletons };

package/dist/esm-node/ultramodern-workspace/bridge-config/gates.js

@@ -0,0 +1,53 @@
+import "node:module";
+import { ultramodernBridgeCliFlags } from "./schema.js";
+import { readRepeatedOptionValues, requireNonEmptyValue, splitAssignment } from "./shared.js";
+function readBridgeGates(args) {
+    const gates = new Map();
+    const getGate = (name)=>{
+        const normalizedName = requireNonEmptyValue(name, `${ultramodernBridgeCliFlags.gate} name`);
+        const existing = gates.get(normalizedName);
+        if (existing) return existing;
+        const draft = {
+            name: normalizedName
+        };
+        gates.set(normalizedName, draft);
+        return draft;
+    };
+    for (const value of readRepeatedOptionValues(args, ultramodernBridgeCliFlags.gate)){
+        const { left: name, right: command } = splitAssignment(value, ultramodernBridgeCliFlags.gate, '<name>=<command>');
+        getGate(name).command = requireNonEmptyValue(command, `${ultramodernBridgeCliFlags.gate} command`);
+    }
+    for (const value of readRepeatedOptionValues(args, ultramodernBridgeCliFlags.gateCwd)){
+        const { left: name, right: cwd } = splitAssignment(value, ultramodernBridgeCliFlags.gateCwd, '<name>=<cwd>');
+        getGate(name).cwd = requireNonEmptyValue(cwd, `${ultramodernBridgeCliFlags.gateCwd} cwd`);
+    }
+    const missingCommand = [
+        ...gates.values()
+    ].find((gate)=>!gate.command);
+    if (missingCommand) throw new Error(`${ultramodernBridgeCliFlags.gateCwd} references "${missingCommand.name}" without a matching ${ultramodernBridgeCliFlags.gate}.`);
+    return normalizeBridgeGates([
+        ...gates.values()
+    ].map((gate)=>({
+            name: gate.name,
+            command: gate.command,
+            cwd: gate.cwd
+        })));
+}
+function normalizeBridgeGates(gates) {
+    const normalized = new Map();
+    for (const [index, gate] of gates.entries()){
+        const label = `bridge.gates[${index}]`;
+        const name = requireNonEmptyValue(gate.name, `${label}.name`);
+        normalized.set(name, {
+            name,
+            command: requireNonEmptyValue(gate.command, `${label}.command`),
+            ...gate.cwd ? {
+                cwd: requireNonEmptyValue(gate.cwd, `${label}.cwd`)
+            } : {}
+        });
+    }
+    return [
+        ...normalized.values()
+    ];
+}
+export { normalizeBridgeGates, readBridgeGates };

package/dist/esm-node/ultramodern-workspace/bridge-config/index.js

@@ -0,0 +1,4 @@
+import "node:module";
+export { hasUltramodernBridgeCliOptions, parseUltramodernBridgeCliOptions } from "./cli.js";
+export { normalizeUltramodernBridgeConfig } from "./normalize.js";
+export { ultramodernBridgeCliBooleanFlags, ultramodernBridgeCliFlags, ultramodernBridgeCliValueFlags, ultramodernBridgeLockfilePolicies } from "./schema.js";

package/dist/esm-node/ultramodern-workspace/bridge-config/normalize.js

@@ -0,0 +1,31 @@
+import "node:module";
+import { defaultReactSingletons } from "./defaults.js";
+import { normalizeBridgeGates } from "./gates.js";
+import { parseLockfilePolicy, requireNonEmptyValue, uniqueNonEmptyValues } from "./shared.js";
+import { validateParentPackageCoverage, validateReactSingletons } from "./validation.js";
+import { normalizeWorkspacePackages } from "./workspace-packages.js";
+function normalizeUltramodernBridgeConfig(bridge) {
+    if (!bridge || false === bridge.enabled) return;
+    const parentRoot = requireNonEmptyValue(bridge.parentRoot, 'bridge.parentRoot');
+    const workspacePackages = normalizeWorkspacePackages(bridge.workspacePackages);
+    const dependencies = uniqueNonEmptyValues(bridge.dependencies, 'bridge.dependencies');
+    const gates = normalizeBridgeGates(bridge.gates);
+    const reactSingletons = bridge.reactSingletons && bridge.reactSingletons.length > 0 ? uniqueNonEmptyValues(bridge.reactSingletons, 'bridge.reactSingletons') : [
+        ...defaultReactSingletons
+    ];
+    if (0 === workspacePackages.length) throw new Error('Bridge mode requires at least one bridge.workspacePackages entry.');
+    if (0 === dependencies.length) throw new Error('Bridge mode requires at least one explicit bridge.dependencies package name.');
+    if (0 === gates.length) throw new Error('Bridge mode requires at least one bridge.gates delegated parent command.');
+    validateParentPackageCoverage(workspacePackages, dependencies);
+    validateReactSingletons(reactSingletons);
+    return {
+        enabled: true,
+        parentRoot,
+        workspacePackages,
+        dependencies,
+        lockfilePolicy: parseLockfilePolicy(bridge.lockfilePolicy ?? 'nested'),
+        gates,
+        reactSingletons
+    };
+}
+export { normalizeUltramodernBridgeConfig };

package/dist/esm-node/ultramodern-workspace/bridge-config/schema.js

@@ -0,0 +1,32 @@
+import "node:module";
+const ultramodernBridgeCliFlags = {
+    enabled: '--bridge',
+    parentRoot: '--bridge-parent-root',
+    workspacePackage: '--bridge-workspace-package',
+    workspacePackageName: '--bridge-workspace-package-name',
+    testAlias: '--bridge-test-alias',
+    dependency: '--bridge-dependency',
+    lockfilePolicy: '--bridge-lockfile-policy',
+    gate: '--bridge-gate',
+    gateCwd: '--bridge-gate-cwd',
+    reactSingleton: '--bridge-react-singleton'
+};
+const ultramodernBridgeCliValueFlags = [
+    ultramodernBridgeCliFlags.parentRoot,
+    ultramodernBridgeCliFlags.workspacePackage,
+    ultramodernBridgeCliFlags.workspacePackageName,
+    ultramodernBridgeCliFlags.testAlias,
+    ultramodernBridgeCliFlags.dependency,
+    ultramodernBridgeCliFlags.lockfilePolicy,
+    ultramodernBridgeCliFlags.gate,
+    ultramodernBridgeCliFlags.gateCwd,
+    ultramodernBridgeCliFlags.reactSingleton
+];
+const ultramodernBridgeCliBooleanFlags = [
+    ultramodernBridgeCliFlags.enabled
+];
+const ultramodernBridgeLockfilePolicies = [
+    'nested',
+    'parent'
+];
+export { ultramodernBridgeCliBooleanFlags, ultramodernBridgeCliFlags, ultramodernBridgeCliValueFlags, ultramodernBridgeLockfilePolicies };

package/dist/esm-node/ultramodern-workspace/bridge-config/shared.js

@@ -0,0 +1,52 @@
+import "node:module";
+import { ultramodernBridgeCliBooleanFlags, ultramodernBridgeCliFlags, ultramodernBridgeLockfilePolicies } from "./schema.js";
+function rejectBooleanFlagValues(args) {
+    for (const flag of ultramodernBridgeCliBooleanFlags)if (args.some((arg)=>arg.startsWith(`${flag}=`))) throw new Error(`${flag} does not accept a value.`);
+}
+function readRepeatedOptionValues(args, flag) {
+    const values = [];
+    for(let index = 0; index < args.length; index++){
+        const arg = args[index];
+        if (arg === flag) {
+            const value = args[index + 1];
+            if (!value || value.startsWith('-')) throw new Error(`${flag} requires a value.`);
+            values.push(value);
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith(`${flag}=`)) values.push(arg.slice(flag.length + 1));
+    }
+    return values;
+}
+function readSingleValue(args, flag) {
+    const values = readRepeatedOptionValues(args, flag);
+    if (values.length > 1) throw new Error(`${flag} can be provided only once.`);
+    return values[0];
+}
+function readCsvOptionValues(args, flag) {
+    return readRepeatedOptionValues(args, flag).flatMap((value)=>value.split(',').map((entry)=>entry.trim()).filter(Boolean));
+}
+function requireNonEmptyValue(value, label) {
+    if ('string' != typeof value || 0 === value.trim().length) throw new Error(`${label} must be a non-empty string.`);
+    return value.trim();
+}
+function parseLockfilePolicy(value) {
+    if (!ultramodernBridgeLockfilePolicies.includes(value)) throw new Error(`${ultramodernBridgeCliFlags.lockfilePolicy} must be "nested" or "parent".`);
+    return value;
+}
+function splitAssignment(value, flag, usage) {
+    const separator = value.indexOf('=');
+    if (-1 === separator) throw new Error(`${flag} must use ${usage}.`);
+    return {
+        left: value.slice(0, separator),
+        right: value.slice(separator + 1)
+    };
+}
+function uniqueNonEmptyValues(values, label) {
+    const unique = new Set();
+    for (const [index, value] of values.entries())unique.add(requireNonEmptyValue(value, `${label}[${index}]`));
+    return [
+        ...unique
+    ];
+}
+export { parseLockfilePolicy, readCsvOptionValues, readRepeatedOptionValues, readSingleValue, rejectBooleanFlagValues, requireNonEmptyValue, splitAssignment, uniqueNonEmptyValues };

package/dist/esm-node/ultramodern-workspace/bridge-config/validation.js

@@ -0,0 +1,28 @@
+import "node:module";
+import { defaultReactSingletons } from "./defaults.js";
+function validateParentPackageCoverage(workspacePackages, dependencies) {
+    const declaredPackages = new Set();
+    for (const [index, entry] of workspacePackages.entries()){
+        const label = `bridge.workspacePackages[${index}]`;
+        const packageNames = entry.packageNames ?? [];
+        if (0 === packageNames.length && (entry.testAliases ?? []).length > 0) throw new Error(`${label}.packageNames must declare the parent package names covered by "${entry.pattern}" before testAliases can be checked.`);
+        for (const packageName of packageNames)declaredPackages.add(packageName);
+        for (const alias of entry.testAliases ?? []){
+            if (!packageNames.some((packageName)=>aliasMatchesPackage(alias.alias, packageName))) throw new Error(`${label}.testAliases entry "${alias.alias}" must match one of ${label}.packageNames.`);
+            if (pointsAtBuildOutput(alias.target)) throw new Error(`${label}.testAliases target "${alias.target}" must point at source files, not dist output.`);
+        }
+    }
+    const missingDependencies = dependencies.filter((dependency)=>!declaredPackages.has(dependency));
+    if (declaredPackages.size > 0 && missingDependencies.length > 0) throw new Error(`Bridge mode dependencies must be declared by bridge.workspacePackages[].packageNames: ${missingDependencies.join(', ')}.`);
+}
+function aliasMatchesPackage(alias, packageName) {
+    return alias === packageName || alias.startsWith(`${packageName}/`);
+}
+function pointsAtBuildOutput(target) {
+    return target.split(/[\\/]/u).includes('dist');
+}
+function validateReactSingletons(reactSingletons) {
+    const missing = defaultReactSingletons.filter((packageName)=>!reactSingletons.includes(packageName));
+    if (missing.length > 0) throw new Error(`Bridge mode React singleton/dedupe declarations must include ${defaultReactSingletons.join(' and ')}. Missing: ${missing.join(', ')}.`);
+}
+export { validateParentPackageCoverage, validateReactSingletons };

package/dist/esm-node/ultramodern-workspace/bridge-config/workspace-packages.js

@@ -0,0 +1,68 @@
+import "node:module";
+import { ultramodernBridgeCliFlags } from "./schema.js";
+import { readRepeatedOptionValues, requireNonEmptyValue, splitAssignment, uniqueNonEmptyValues } from "./shared.js";
+function readWorkspacePackages(args) {
+    const drafts = new Map();
+    const getDraft = (pattern)=>{
+        const normalizedPattern = requireNonEmptyValue(pattern, ultramodernBridgeCliFlags.workspacePackage);
+        const existing = drafts.get(normalizedPattern);
+        if (existing) return existing;
+        const draft = {
+            pattern: normalizedPattern,
+            packageNames: [],
+            testAliases: []
+        };
+        drafts.set(normalizedPattern, draft);
+        return draft;
+    };
+    for (const pattern of readRepeatedOptionValues(args, ultramodernBridgeCliFlags.workspacePackage))getDraft(pattern);
+    for (const value of readRepeatedOptionValues(args, ultramodernBridgeCliFlags.workspacePackageName)){
+        const { left: pattern, right: packageNames } = splitAssignment(value, ultramodernBridgeCliFlags.workspacePackageName, '<pattern>=<package-name>[,<package-name>]');
+        getDraft(pattern).packageNames.push(...packageNames.split(',').map((packageName)=>packageName.trim()).filter(Boolean));
+    }
+    for (const value of readRepeatedOptionValues(args, ultramodernBridgeCliFlags.testAlias)){
+        const separator = value.indexOf(':');
+        if (-1 === separator) throw new Error(`${ultramodernBridgeCliFlags.testAlias} must use <pattern>:<alias>=<target>.`);
+        const pattern = value.slice(0, separator);
+        const aliasDefinition = value.slice(separator + 1);
+        const { left: alias, right: target } = splitAssignment(aliasDefinition, ultramodernBridgeCliFlags.testAlias, '<pattern>:<alias>=<target>');
+        getDraft(pattern).testAliases.push({
+            alias: requireNonEmptyValue(alias, `${ultramodernBridgeCliFlags.testAlias} alias`),
+            target: requireNonEmptyValue(target, `${ultramodernBridgeCliFlags.testAlias} target`)
+        });
+    }
+    return normalizeWorkspacePackages([
+        ...drafts.values()
+    ]);
+}
+function normalizeWorkspacePackages(workspacePackages) {
+    return workspacePackages.map((entry, index)=>{
+        const label = `bridge.workspacePackages[${index}]`;
+        const packageNames = entry.packageNames && entry.packageNames.length > 0 ? uniqueNonEmptyValues(entry.packageNames, `${label}.packageNames`) : void 0;
+        const testAliases = entry.testAliases && entry.testAliases.length > 0 ? normalizeTestAliases(entry.testAliases, label) : void 0;
+        return {
+            pattern: requireNonEmptyValue(entry.pattern, `${label}.pattern`),
+            ...packageNames ? {
+                packageNames
+            } : {},
+            ...testAliases ? {
+                testAliases
+            } : {}
+        };
+    });
+}
+function normalizeTestAliases(testAliases, parentLabel) {
+    const aliases = new Map();
+    for (const [index, alias] of testAliases.entries()){
+        const label = `${parentLabel}.testAliases[${index}]`;
+        const normalizedAlias = requireNonEmptyValue(alias.alias, `${label}.alias`);
+        aliases.set(normalizedAlias, {
+            alias: normalizedAlias,
+            target: requireNonEmptyValue(alias.target, `${label}.target`)
+        });
+    }
+    return [
+        ...aliases.values()
+    ];
+}
+export { normalizeWorkspacePackages, readWorkspacePackages };