@bleedingdev/modern-js-create 3.5.0-ultramodern.6 → 3.5.0-ultramodern.75

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/api-metadata.d.ts

@@ -0,0 +1,12 @@
+import type { ResolvedUltramodernPackageSource } from '../../../ultramodern-package-source';
+import { type MigrationIo } from './io';
+type PackageSourceReconciliationOptions = {
+    canonical: Record<string, unknown>;
+    label: string;
+    ownedKeys: readonly string[];
+};
+export declare function reconcilePackageSourceMetadata(value: unknown, { canonical, label, ownedKeys }: PackageSourceReconciliationOptions): Record<string, unknown>;
+export declare function reconcileCompactPackageSourceMetadata(value: unknown, packageSource: ResolvedUltramodernPackageSource): Record<string, unknown>;
+export declare function updateUltramodernConfig(io: MigrationIo, config: Record<string, any>, packageSource: ResolvedUltramodernPackageSource): void;
+export declare function updateReferenceTopology(io: MigrationIo): boolean;
+export {};

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/declaration-patches.d.ts

@@ -0,0 +1,4 @@
+import type { MigrationIo } from './io';
+export declare function ensureGeneratedDeclarationPatches(io: MigrationIo, options: {
+    includeDrizzleOrmPatch: boolean;
+}): boolean;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/dependency-usage.d.ts

@@ -0,0 +1 @@
+export declare function workspaceUsesDependency(workspaceRoot: string, packageName: string): boolean;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts-backend-federation.d.ts

@@ -0,0 +1,3 @@
+import { type UltramodernToolingConfig } from '../../config';
+import { type MigrationIo } from './io';
+export declare function updateGeneratedBackendFederationContractFiles(io: MigrationIo, config: UltramodernToolingConfig): boolean;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts-build-identity.d.ts

@@ -0,0 +1,4 @@
+import { type UltramodernToolingConfig } from '../../config';
+import { type MigrationIo } from './io';
+export declare function rewriteLegacyApiMarkerBinding(source: string): string;
+export declare function updateGeneratedBuildIdentityModules(io: MigrationIo, config: UltramodernToolingConfig): boolean;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts-modern-configs.d.ts

@@ -0,0 +1,3 @@
+import { type UltramodernToolingConfig } from '../../config';
+import { type MigrationIo } from './io';
+export declare function updateGeneratedModernConfigs(io: MigrationIo, config: UltramodernToolingConfig): boolean;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts-oxfmt.d.ts

@@ -0,0 +1,2 @@
+import { type MigrationIo } from './io';
+export declare function ensureGeneratedOxfmtIgnorePatterns(io: MigrationIo): boolean;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts-removal.d.ts

@@ -0,0 +1,4 @@
+import { type UltramodernToolingConfig } from '../../config';
+import { type MigrationIo } from './io';
+export declare function removeGeneratedFileIfExists(io: MigrationIo, relativePath: string): boolean;
+export declare function removeStaleBackendFederationArtifacts(io: MigrationIo, config: UltramodernToolingConfig): boolean;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts-typescript.d.ts

@@ -0,0 +1,3 @@
+import { type UltramodernToolingConfig } from '../../config';
+import { type MigrationIo } from './io';
+export declare function updateGeneratedTypeScriptSurfaces(io: MigrationIo, config: UltramodernToolingConfig): boolean;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts-zerops.d.ts

@@ -0,0 +1,3 @@
+import { type UltramodernToolingConfig } from '../../config';
+import { type MigrationIo } from './io';
+export declare function updateGeneratedZeropsArtifacts(io: MigrationIo, config: UltramodernToolingConfig): boolean;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts.d.ts

@@ -0,0 +1,7 @@
+export { updateGeneratedBackendFederationContractFiles } from './generated-artifacts-backend-federation';
+export { updateGeneratedBuildIdentityModules } from './generated-artifacts-build-identity';
+export { updateGeneratedModernConfigs } from './generated-artifacts-modern-configs';
+export { ensureGeneratedOxfmtIgnorePatterns } from './generated-artifacts-oxfmt';
+export { removeGeneratedFileIfExists, removeStaleBackendFederationArtifacts, } from './generated-artifacts-removal';
+export { updateGeneratedTypeScriptSurfaces } from './generated-artifacts-typescript';
+export { updateGeneratedZeropsArtifacts } from './generated-artifacts-zerops';

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/generated-patches.d.ts

@@ -0,0 +1,3 @@
+import type { MigrationIo } from './io';
+export declare function ensureGeneratedPatchFile(io: MigrationIo, relativePatchPath: string, sourcePatchPath: string): boolean;
+export declare function removeGeneratedPatchFileIfUnchanged(io: MigrationIo, relativePatchPath: string, sourcePatchPath: string): boolean;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/help.d.ts

@@ -0,0 +1 @@
+export declare const migrateStrictEffectHelp = "Usage:\n  modern-js-create ultramodern migrate-strict-effect --version <version> [--dry-run] [--skip-install]\n\nUpdates generated UltraModern package-source metadata, Modern package aliases,\nframework-owned toolchain pins, direct Effect API topology metadata, strict\nEffect pnpm overrides/trust policy, framework-owned TypeScript config\nsurfaces, and the pnpm lockfile. Source code still has to pass pnpm api:check\nand pnpm contract:check.\n\nWhen the compact config is absent but legacy UltraModern 3.2 metadata is\npresent, the compact config is synthesized from it first. Shell-only\nworkspaces skip the backend-federation and Zerops runtime stages. Pass\n--dry-run to print the planned filesystem changes without writing anything\n(implies --skip-install).\n";

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/install.d.ts

@@ -0,0 +1,2 @@
+import type { CommandContext } from '../context';
+export declare function runPnpmLockfileRefresh(context: CommandContext): number;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/io.d.ts

@@ -0,0 +1,20 @@
+type MigrationTransactionOptions<T> = {
+    commitWhen?: (result: T) => boolean;
+};
+export type MigrationIo = {
+    workspaceRoot: string;
+    dryRun: boolean;
+    plan: string[];
+    write(filePath: string, content: string): boolean;
+    remove(filePath: string): boolean;
+    log(message: string): void;
+    transaction<T>(operation: () => T, options?: MigrationTransactionOptions<Awaited<T>>): T;
+    withStagedWorkspace<T>(operation: (stagedWorkspaceRoot: string) => T): T;
+};
+export declare function createMigrationIo(workspaceRoot: string, dryRun: boolean): MigrationIo;
+export declare function readJsonFile(filePath: string): any;
+export declare function writeJsonFile(io: MigrationIo, filePath: string, value: unknown): boolean;
+export declare function writeJsonIfChanged(io: MigrationIo, filePath: string, value: unknown): boolean;
+export declare function writeTextIfChanged(io: MigrationIo, filePath: string, value: string): boolean;
+export declare function listWorkspacePackageFiles(workspaceRoot: string): string[];
+export {};

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/package-cohort.d.ts

@@ -0,0 +1,9 @@
+import { type ResolvedUltramodernPackageSource } from '../../../ultramodern-package-source';
+import type { WorkspaceApp } from '../../../ultramodern-workspace/types';
+export declare function updateModernDependencies(packageJson: Record<string, any>, packageSource: ResolvedUltramodernPackageSource): boolean;
+export declare function updateGeneratedToolingDependencies(packageJson: Record<string, any>): boolean;
+export declare function updateGeneratedPackageScripts(packageJson: Record<string, any>, options?: {
+    relativePackageFile?: string;
+    apps?: WorkspaceApp[];
+    shellOnly?: boolean;
+}): boolean;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/package-source.d.ts

@@ -0,0 +1,3 @@
+import { type ResolvedUltramodernPackageSource } from '../../../ultramodern-package-source';
+import { readUltramodernConfig } from '../../config';
+export declare function createMigrationPackageSource(args: string[], current: ReturnType<typeof readUltramodernConfig>): ResolvedUltramodernPackageSource;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/pnpm-policy.d.ts

@@ -0,0 +1,27 @@
+import type { ResolvedUltramodernPackageSource } from '../../../ultramodern-package-source';
+import { type UltramodernReleaseCohort } from '../../../ultramodern-release-cohort';
+import type { MigrationIo } from './io';
+export { ensureGeneratedDeclarationPatches } from './declaration-patches';
+export { workspaceUsesDependency } from './dependency-usage';
+type RegistryResponse = {
+    ok: boolean;
+    status: number;
+    json: () => Promise<unknown>;
+};
+export type ReleaseAgeRegistryFetch = (url: URL, init: {
+    headers: Record<string, string>;
+    redirect: 'error';
+}) => Promise<RegistryResponse>;
+export declare function updateGeneratedPnpmWorkspacePolicy(io: MigrationIo, packageSource: ResolvedUltramodernPackageSource, options?: {
+    now?: Date;
+    releaseCohort?: UltramodernReleaseCohort;
+}): boolean;
+export declare function validateGeneratedPnpmLockReleaseAgePolicy(workspaceRoot: string, packageSource: ResolvedUltramodernPackageSource, options?: {
+    fetchImpl?: ReleaseAgeRegistryFetch;
+    now?: Date;
+    registryUrl?: string;
+    releaseCohort?: UltramodernReleaseCohort;
+}): Promise<{
+    reviewCandidates: import("../../../ultramodern-workspace/policy").UltramodernReleaseAgeCandidate[];
+    minimumReleaseAgeExclude: string[];
+}>;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/pnpm-yaml.d.ts

@@ -0,0 +1,26 @@
+export type PnpmWorkspaceYaml = Record<string, any>;
+export type PnpmLockReleaseAgeCandidate = {
+    packageName: string;
+    version: string;
+    registry: {
+        dist: {
+            integrity: string;
+        };
+    };
+    path: string[];
+};
+export type PnpmLockReleaseAgeClosure = {
+    candidates: PnpmLockReleaseAgeCandidate[];
+    unresolved: Array<{
+        package?: string;
+        path: string[];
+        reason: string;
+    }>;
+};
+export declare function isYamlRecord(value: unknown): value is PnpmWorkspaceYaml;
+export declare function discoverReachablePnpmLockReleaseAgeClosure(lockfile: unknown): PnpmLockReleaseAgeClosure;
+export declare function parsePnpmWorkspaceYaml(source: string, filename?: string): {
+    document: PnpmWorkspaceYaml;
+    lineEnding: string;
+};
+export declare function stringifyPnpmWorkspaceYaml(document: PnpmWorkspaceYaml, lineEnding?: string): string;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/policy-constants.d.ts

@@ -0,0 +1,10 @@
+export declare const moduleFederationModernJsPatchPath: string;
+export declare const moduleFederationModernJsPatchSourcePath: string;
+export declare const moduleFederationBridgeReactPatchPath: string;
+export declare const moduleFederationBridgeReactPatchSourcePath: string;
+export declare const effectDeclarationPatchPath: string;
+export declare const tanstackRouterCorePatchPath: string;
+export declare const tanstackRouterCorePatchSourcePath: string;
+export declare const effectDeclarationPatchSourcePath: string;
+export declare const drizzleOrmDeclarationPatchPath: string;
+export declare const drizzleOrmDeclarationPatchSourcePath: string;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/toolchain-pins.d.ts

@@ -0,0 +1,4 @@
+import type { MigrationIo } from './io';
+export declare function updateUltramodernConfigToolchain(config: Record<string, any>): void;
+export declare function updateRootPackageToolchain(packageJson: Record<string, any>): void;
+export declare function updateGeneratedToolchainFiles(io: MigrationIo): void;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect.d.ts

@@ -0,0 +1,2 @@
+import type { CommandContext } from './context';
+export declare function runMigrateStrictEffect(args: string[], context: CommandContext): number | Promise<number>;

package/dist/types/ultramodern-tooling/commands/options.d.ts

@@ -0,0 +1,2 @@
+export declare function readOption(args: string[], name: string): string | undefined;
+export declare function hasFlag(args: string[], name: string): boolean;

package/dist/types/ultramodern-tooling/commands/routes-generate.d.ts

@@ -0,0 +1,2 @@
+import { type CommandContext } from './context';
+export declare function runRoutesGenerate(args: string[], context: CommandContext): number;

package/dist/types/ultramodern-tooling/commands/skills.d.ts

@@ -0,0 +1,2 @@
+import { type CommandContext } from './context';
+export declare function runSkills(args: string[], context: CommandContext): number;

package/dist/types/ultramodern-tooling/commands/sync-delivery-unit.d.ts

@@ -0,0 +1 @@
+export { runSyncDeliveryUnit } from '../../ultramodern-workspace/delivery-unit-sync';

package/dist/types/ultramodern-tooling/commands/validate.d.ts

@@ -0,0 +1,2 @@
+import { type CommandContext } from './context';
+export declare function runValidate(context: CommandContext): number;

package/dist/types/ultramodern-tooling/commands.d.ts

@@ -1 +1 @@
-export declare function runUltramodernToolingCli(args: string[], workspaceRoot?: any): Promise<number>;
+export declare function runUltramodernToolingCli(args: string[], workspaceRoot?: string): Promise<number>;

package/dist/types/ultramodern-tooling/config/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const LEGACY_GENERATED_CONTRACT_PATH = ".modernjs/ultramodern-generated-contract.json";
+export declare const LEGACY_PACKAGE_SOURCE_METADATA_PATH = ".modernjs/ultramodern-package-source.json";
+export declare const LEGACY_DEVELOPMENT_OVERLAY_PATH = "topology/local-overlays/development.json";

package/dist/types/ultramodern-tooling/config/index.d.ts

@@ -0,0 +1,7 @@
+export * from './constants';
+export * from './json';
+export * from './load';
+export * from './metadata';
+export * from './normalize';
+export * from './synthesize';
+export * from './types';

package/dist/types/ultramodern-tooling/config/json.d.ts

@@ -0,0 +1,2 @@
+export declare function readJsonObject(filePath: string): Record<string, any>;
+export declare function readOptionalJsonObject(filePath: string): Record<string, any>;

package/dist/types/ultramodern-tooling/config/load.d.ts

@@ -0,0 +1,2 @@
+import type { UltramodernToolingConfig } from './types';
+export declare function readUltramodernConfig(workspaceRoot?: string): UltramodernToolingConfig;

package/dist/types/ultramodern-tooling/config/metadata.d.ts

@@ -0,0 +1,4 @@
+import type { ResolvedPackageSource } from '../../ultramodern-workspace/types';
+export declare function packageScopeFromRoot(workspaceRoot: string): string;
+export declare function packageSourceFromMetadata(workspaceRoot: string): ResolvedPackageSource | undefined;
+export declare function readOverlayPorts(workspaceRoot: string): Record<string, number>;

package/dist/types/ultramodern-tooling/config/normalize.d.ts

@@ -0,0 +1,22 @@
+import type { WorkspaceApp } from '../../ultramodern-workspace/types';
+import type { UltramodernToolingConfig } from './types';
+type UnsupportedUltramodernConfigIssue = {
+    field: 'schemaVersion';
+    value: unknown;
+    reason: 'missing' | 'non-integer' | 'unsupported';
+} | {
+    field: 'topology.apps.kind';
+    index: number;
+    value: unknown;
+};
+export declare class UnsupportedUltramodernConfigError extends Error {
+    readonly sourcePath: string;
+    readonly issue: UnsupportedUltramodernConfigIssue;
+    constructor(sourcePath: string, issue: UnsupportedUltramodernConfigIssue);
+}
+export declare function normalizeCompactConfig(workspaceRoot: string, sourcePath: string, config: Record<string, any>): UltramodernToolingConfig;
+export declare function normalizeCompactUltramodernConfig(workspaceRoot: string, compact: Record<string, any>): UltramodernToolingConfig;
+export declare function workspaceAppsFromToolingConfig(config: UltramodernToolingConfig): WorkspaceApp[];
+export declare function additionalShellsFromToolingConfig(config: UltramodernToolingConfig): WorkspaceApp[];
+export declare function allWorkspaceAppsFromToolingConfig(config: UltramodernToolingConfig): WorkspaceApp[];
+export {};

package/dist/types/ultramodern-tooling/config/synthesize.d.ts

@@ -0,0 +1,5 @@
+export declare function synthesizeCompactUltramodernConfig(workspaceRoot: string): {
+    compact: Record<string, any>;
+    missing: string[];
+    sources: string[];
+} | undefined;

package/dist/types/ultramodern-tooling/config/types.d.ts

@@ -0,0 +1,45 @@
+import type { UltramodernBridgeConfig } from '../../ultramodern-workspace/bridge-config';
+import type { ResolvedPackageSource, VerticalPreset, WorkspaceApi, WorkspaceApp, WorkspaceDeliveryUnitKind } from '../../ultramodern-workspace/types';
+export type UltramodernToolingConfigSource = 'compact';
+export type UltramodernToolingConfigApp = {
+    id: string;
+    kind: WorkspaceApp['kind'];
+    path: string;
+    package?: string;
+    packageSuffix?: string;
+    displayName?: string;
+    domain?: string;
+    surfaceProfile?: VerticalPreset;
+    deliveryUnitKind?: WorkspaceDeliveryUnitKind;
+    port?: number;
+    portEnv?: string;
+    moduleFederation?: {
+        role?: 'host' | 'remote';
+        name?: string;
+        exposes?: string[];
+        exposePaths?: Record<string, string>;
+        verticalRefs?: string[];
+        hostOnly?: boolean;
+        noExposes?: boolean;
+    };
+    api?: WorkspaceApi;
+};
+export type UltramodernToolingConfig = {
+    schemaVersion: number;
+    profile?: string;
+    source: UltramodernToolingConfigSource;
+    sourcePath: string;
+    workspace: {
+        packageScope: string;
+    };
+    packageSource?: ResolvedPackageSource;
+    features: {
+        tailwind: boolean;
+    };
+    bridge?: UltramodernBridgeConfig;
+    topology: {
+        apps: UltramodernToolingConfigApp[];
+    };
+    /** Additional shells live in the additive compact-config collection. */
+    shells?: Array<Record<string, unknown>>;
+};

package/dist/types/ultramodern-tooling/config.d.ts

@@ -1,43 +1 @@
-import { type UltramodernBridgeConfig } from '../ultramodern-workspace/bridge-config';
-import type { ResolvedPackageSource, WorkspaceApi, WorkspaceApp } from '../ultramodern-workspace/types';
-export type UltramodernToolingConfigSource = 'compact';
-export type UltramodernToolingConfigApp = {
-    id: string;
-    kind: WorkspaceApp['kind'];
-    path: string;
-    package?: string;
-    packageSuffix?: string;
-    displayName?: string;
-    domain?: string;
-    port?: number;
-    portEnv?: string;
-    moduleFederation?: {
-        role?: 'host' | 'remote';
-        name?: string;
-        exposes?: string[];
-        exposePaths?: Record<string, string>;
-        verticalRefs?: string[];
-        hostOnly?: boolean;
-        noExposes?: boolean;
-    };
-    api?: WorkspaceApi;
-};
-export type UltramodernToolingConfig = {
-    schemaVersion: number;
-    profile?: string;
-    source: UltramodernToolingConfigSource;
-    sourcePath: string;
-    workspace: {
-        packageScope: string;
-    };
-    packageSource?: ResolvedPackageSource;
-    features: {
-        tailwind: boolean;
-    };
-    bridge?: UltramodernBridgeConfig;
-    topology: {
-        apps: UltramodernToolingConfigApp[];
-    };
-};
-export declare function readUltramodernConfig(workspaceRoot?: any): UltramodernToolingConfig;
-export declare function workspaceAppsFromToolingConfig(config: UltramodernToolingConfig): WorkspaceApp[];
+export * from './config/index';

package/dist/types/ultramodern-workspace/add-shell.d.ts

@@ -0,0 +1,14 @@
+import type { AddUltramodernShellOptions, UltramodernGenerationResult, UltramodernVerticalPlan } from './types';
+/**
+ * Add an additional thin shell to an existing workspace (G28). Transactional:
+ * the whole write-set is applied inside {@link runWorkspaceTransaction}; any
+ * failure restores the workspace byte-identical to its pre-call state.
+ */
+export declare function addUltramodernShell(options: AddUltramodernShellOptions): UltramodernGenerationResult;
+/**
+ * Dry-run parity for {@link addUltramodernShell} (G28). Applies the operation
+ * against a throwaway copy of the workspace and returns the planned result
+ * (created/rewritten paths, delivery-unit identity) without touching the real
+ * workspace.
+ */
+export declare function planUltramodernShell(options: AddUltramodernShellOptions): UltramodernVerticalPlan;

package/dist/types/ultramodern-workspace/add-vertical/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const FIRST_VERTICAL_PORT = 4101;
+export declare const TOPOLOGY_PATH = "topology/reference-topology.json";
+export declare const OWNERSHIP_PATH = "topology/ownership.json";
+export declare const DEVELOPMENT_OVERLAY_PATH = "topology/local-overlays/development.json";

package/dist/types/ultramodern-workspace/add-vertical/execute.d.ts

@@ -0,0 +1,9 @@
+import type { AddUltramodernVerticalOptions, UltramodernGenerationResult } from '../types';
+/**
+ * Add a MicroVertical to an existing workspace. Transactional (G1c): the
+ * whole write-set is applied inside {@link runWorkspaceTransaction}; if any
+ * step throws (preflight rejection, write failure, overlay failure,
+ * formatting failure) the workspace is restored byte-identical to its
+ * pre-call state and the error is rethrown.
+ */
+export declare function addUltramodernVertical(options: AddUltramodernVerticalOptions): UltramodernGenerationResult;

package/dist/types/ultramodern-workspace/add-vertical/plan.d.ts

@@ -0,0 +1,2 @@
+import type { AddUltramodernVerticalOptions, UltramodernVerticalPlan } from '../types';
+export declare function planUltramodernVertical(options: AddUltramodernVerticalOptions): UltramodernVerticalPlan;

package/dist/types/ultramodern-workspace/add-vertical/preflight.d.ts

@@ -0,0 +1,42 @@
+import type { UltramodernBridgeConfig } from '../bridge-config';
+import type { AddUltramodernVerticalOptions, ResolvedPackageSource, WorkspaceApp } from '../types';
+export type AddUltramodernVerticalPreflight = {
+    name: string;
+    scope: string;
+    topologyPath: string;
+    ownershipPath: string;
+    overlayPath: string;
+    rootPackage: Record<string, any>;
+    topology: Record<string, any>;
+    ownership: Record<string, any>;
+    overlay: Record<string, any>;
+    packageSource: ResolvedPackageSource;
+    enableTailwind: boolean;
+    bridge?: UltramodernBridgeConfig;
+    config: Record<string, any>;
+    primaryShell: WorkspaceApp;
+    additionalShells: WorkspaceApp[];
+    targetShell: WorkspaceApp;
+    targetVerticals: WorkspaceApp[];
+    vertical: WorkspaceApp;
+    updatedVerticals: WorkspaceApp[];
+};
+export type UnknownUltramodernShellIssue = {
+    field: 'shell';
+    value: string;
+    reason: 'unknown';
+    available: string[];
+};
+/**
+ * Typed preflight rejection for an add-vertical request whose shell target is
+ * not present in the workspace's additive config.shells collection.
+ */
+export declare class UnknownUltramodernShellError extends Error {
+    readonly sourcePath: string;
+    readonly code = "ULTRAMODERN_UNKNOWN_TARGET_SHELL";
+    readonly issue: UnknownUltramodernShellIssue;
+    constructor(sourcePath: string, requestedShellId: string, available: string[]);
+}
+export declare function prepareAddUltramodernVertical(options: AddUltramodernVerticalOptions): AddUltramodernVerticalPreflight;
+export declare function createPrimaryShellDescriptor(topology: Record<string, any>, config: Record<string, any>): WorkspaceApp;
+export declare function assertNonEmptyString(value: unknown, label: string): void;

package/dist/types/ultramodern-workspace/add-vertical/shell-files.d.ts

@@ -0,0 +1,6 @@
+import type { UltramodernBridgeConfig } from '../bridge-config';
+import type { ResolvedPackageSource, WorkspaceApp } from '../types';
+export declare function updateRootWorkspaceScripts(workspaceRoot: string, scope: string, packageSource: ResolvedPackageSource, remotes: WorkspaceApp[], bridge?: UltramodernBridgeConfig, additionalShells?: WorkspaceApp[]): void;
+export declare function rewriteShellAppFiles(workspaceRoot: string, scope: string, packageSource: ResolvedPackageSource, enableTailwind: boolean, remotes: WorkspaceApp[], bridge?: UltramodernBridgeConfig, shell?: WorkspaceApp, devPorts?: number[]): void;
+export declare function addShellZephyrDependency(workspaceRoot: string, scope: string, remote: WorkspaceApp, shell?: WorkspaceApp): void;
+export declare function addShellWorkspaceDependency(workspaceRoot: string, scope: string, remote: WorkspaceApp, shell?: WorkspaceApp): void;

package/dist/types/ultramodern-workspace/add-vertical/topology.d.ts

@@ -0,0 +1,9 @@
+import type { JsonValue, Ownership, WorkspaceApp } from '../types';
+export declare function verticalTopologyEntry(scope: string, vertical: WorkspaceApp, remotes?: WorkspaceApp[]): JsonValue;
+export declare function ownershipEntry(scope: string, owner: {
+    id: string;
+    packageSuffix: string;
+    directory: string;
+    ownership: Ownership;
+}): JsonValue;
+export declare function verticalsFromTopology(topology: Record<string, any>, ports: Record<string, unknown>): WorkspaceApp[];

package/dist/types/ultramodern-workspace/add-vertical/transaction.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Transactional workspace mutation support (G1c). `captureWorkspaceBackup`
+ * records the full byte content of every tracked workspace file before a
+ * mutation; `restoreWorkspaceBackup` puts the tree back byte-identical when
+ * the mutation fails part-way: files created by the failed run are removed
+ * (with now-empty directories pruned), and files it rewrote or deleted are
+ * restored from the backed-up bytes.
+ *
+ * The same ignore set as the generation-result snapshots applies, so build
+ * output and dependency trees are never captured or touched.
+ */
+export type WorkspaceBackup = {
+    root: string;
+    files: Map<string, Buffer>;
+};
+export declare function captureWorkspaceBackup(root: string): WorkspaceBackup;
+export declare function restoreWorkspaceBackup(backup: WorkspaceBackup): void;
+/** Directory (relative to the workspace root) holding the mutation lockfile. */
+export declare const ULTRAMODERN_LOCK_DIRECTORY = ".modernjs";
+/** Lockfile name for the workspace-wide exclusive mutation lock. */
+export declare const ULTRAMODERN_LOCK_FILE = ".ultramodern-mutation.lock";
+/**
+ * Default age after which a held lock is treated as stale and taken over. A
+ * mutation is a short synchronous burst; a lock older than this almost always
+ * belongs to a crashed process that never released it.
+ */
+export declare const DEFAULT_STALE_LOCK_MS = 30000;
+/**
+ * A typed error raised when a second mutation tries to enter a workspace that
+ * is already locked by a live mutation. `code` is always `'workspace-locked'`.
+ * Concurrent attempts fail immediately (no queueing).
+ */
+export declare class WorkspaceLockedError extends Error {
+    readonly code: 'workspace-locked';
+    constructor(message: string);
+}
+/**
+ * Raised when release or takeover detects that the on-disk lock state can no
+ * longer be reconciled without discarding a lock some other live holder may
+ * still own — e.g. a newer claimant seized the pathname during the restore
+ * window. This is deliberately never swallowed: surfacing the corruption is
+ * strictly safer than silently double-granting the workspace, and the moved
+ * lock bytes are left in place for recovery. `code` is always
+ * `'workspace-lock-integrity'`.
+ */
+export declare class WorkspaceLockIntegrityError extends Error {
+    readonly code: 'workspace-lock-integrity';
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Test-only seam. `releaseWorkspaceLock` invokes these hooks between its
+ * in-place ownership read and the rename (`afterOwnershipRead`) and between the
+ * rename and a mismatch restore (`beforeRestore`), letting a test deterministically
+ * inject a successor lock or a competing claimant into the release windows
+ * without timing races. Never set in production code.
+ */
+export declare const __releaseTestHooks: {
+    afterOwnershipRead?: (handle: {
+        lockPath: string;
+        token: string;
+    }) => void;
+    beforeRestore?: (handle: {
+        lockPath: string;
+        token: string;
+    }) => void;
+};
+/**
+ * Run a workspace mutation transactionally under an exclusive lock (G1c). The
+ * whole transaction — backup, mutation, and any restore — is wrapped in a
+ * workspace-wide lock so concurrent adds cannot interleave snapshot/restore and
+ * erase each other; a concurrent attempt fails immediately with a typed
+ * {@link WorkspaceLockedError}. On any thrown error the workspace is restored
+ * byte-identical from the pre-mutation backup and the original error is
+ * rethrown. The lock is released on success, failure, and restore paths.
+ */
+export declare function runWorkspaceTransaction<T>(root: string, mutate: () => T, options?: {
+    staleLockMs?: number;
+}): T;

package/dist/types/ultramodern-workspace/add-vertical/workspace-state.d.ts

@@ -0,0 +1,15 @@
+import type { UltramodernBridgeConfig } from '../bridge-config';
+import type { ResolvedPackageSource, UltramodernWorkspaceOptions, WorkspaceApp } from '../types';
+export declare function existingPackageSource(workspaceRoot: string, modernVersion: string, packageSource?: UltramodernWorkspaceOptions['packageSource']): ResolvedPackageSource;
+export declare function existingTailwindEnabled(workspaceRoot: string): boolean;
+export declare function existingBridgeConfig(workspaceRoot: string): UltramodernBridgeConfig | undefined;
+export declare function assertValidVerticalName(name: string): string;
+export declare function configuredDevelopmentPorts(ports: Record<string, unknown>, additionalShells?: WorkspaceApp[]): number[];
+export declare function assertGlobalPortUniqueness(ports: Record<string, unknown>, additionalShells?: WorkspaceApp[]): void;
+/**
+ * Allocate from the one workspace-wide port set. The caller supplies the
+ * lower bound for its app class (verticals start at 4101; additional shells at
+ * 3120), while existing overlay and shell ports always participate.
+ */
+export declare function nextAvailablePort(ports: Record<string, unknown>, additionalShells?: WorkspaceApp[], minimumPort?: number): number;
+export declare function assertCanCreate(workspaceRoot: string, relativePath: string): void;

package/dist/types/ultramodern-workspace/add-vertical.d.ts

@@ -1,39 +1,7 @@
-import type { UltramodernBridgeConfig } from './bridge-config';
-import type { AddUltramodernVerticalOptions, JsonValue, Ownership, ResolvedPackageSource, UltramodernGenerationResult, UltramodernVerticalPlan, UltramodernWorkspaceOptions, WorkspaceApp } from './types';
-export type AddUltramodernVerticalPreflight = {
-    name: string;
-    scope: string;
-    topologyPath: string;
-    ownershipPath: string;
-    overlayPath: string;
-    rootPackage: Record<string, any>;
-    topology: Record<string, any>;
-    ownership: Record<string, any>;
-    overlay: Record<string, any>;
-    packageSource: ResolvedPackageSource;
-    enableTailwind: boolean;
-    bridge?: UltramodernBridgeConfig;
-    vertical: WorkspaceApp;
-    updatedVerticals: WorkspaceApp[];
-};
-export declare function existingPackageSource(workspaceRoot: string, modernVersion: string, packageSource?: UltramodernWorkspaceOptions['packageSource']): ResolvedPackageSource;
-export declare function existingTailwindEnabled(workspaceRoot: string): boolean;
-export declare function existingBridgeConfig(workspaceRoot: string): UltramodernBridgeConfig | undefined;
-export declare function assertValidVerticalName(name: string): string;
-export declare function nextAvailablePort(ports: Record<string, unknown>): number;
-export declare function assertCanCreate(workspaceRoot: string, relativePath: string): void;
-export declare function updateRootWorkspaceScripts(workspaceRoot: string, scope: string, packageSource: ResolvedPackageSource, remotes: WorkspaceApp[], bridge?: UltramodernBridgeConfig): void;
-export declare function rewriteShellAppFiles(workspaceRoot: string, scope: string, packageSource: ResolvedPackageSource, enableTailwind: boolean, remotes: WorkspaceApp[], bridge?: UltramodernBridgeConfig): void;
-export declare function addShellZephyrDependency(workspaceRoot: string, scope: string, remote: WorkspaceApp): void;
-export declare function addShellWorkspaceDependency(workspaceRoot: string, scope: string, remote: WorkspaceApp): void;
-export declare function verticalTopologyEntry(scope: string, vertical: WorkspaceApp, remotes?: WorkspaceApp[]): JsonValue;
-export declare function ownershipEntry(scope: string, owner: {
-    id: string;
-    packageSuffix: string;
-    directory: string;
-    ownership: Ownership;
-}): JsonValue;
-export declare function verticalsFromTopology(topology: Record<string, any>, ports: Record<string, unknown>): WorkspaceApp[];
-export declare function prepareAddUltramodernVertical(options: AddUltramodernVerticalOptions): AddUltramodernVerticalPreflight;
-export declare function planUltramodernVertical(options: AddUltramodernVerticalOptions): UltramodernVerticalPlan;
-export declare function addUltramodernVertical(options: AddUltramodernVerticalOptions): UltramodernGenerationResult;
+export { addUltramodernVertical } from './add-vertical/execute';
+export { planUltramodernVertical } from './add-vertical/plan';
+export type { AddUltramodernVerticalPreflight } from './add-vertical/preflight';
+export { prepareAddUltramodernVertical } from './add-vertical/preflight';
+export { addShellWorkspaceDependency, addShellZephyrDependency, rewriteShellAppFiles, updateRootWorkspaceScripts, } from './add-vertical/shell-files';
+export { ownershipEntry, verticalsFromTopology, verticalTopologyEntry, } from './add-vertical/topology';
+export { assertCanCreate, assertValidVerticalName, existingBridgeConfig, existingPackageSource, existingTailwindEnabled, nextAvailablePort, } from './add-vertical/workspace-state';