@bleedingdev/modern-js-ultramodern-create 3.8.3-ultramodern.2

package/dist/esm-node/ultramodern-tooling/commands/migrate-strict-effect/generated-ui-source.js

@@ -0,0 +1,101 @@
+import "node:module";
+import node_fs from "node:fs";
+import { isDeepStrictEqual } from "node:util";
+import "./io.js";
+const multiCharacterTokens = [
+    '===',
+    '!==',
+    '**=',
+    '&&=',
+    '||=',
+    '??=',
+    '...',
+    '=>',
+    '==',
+    '!=',
+    '<=',
+    '>=',
+    '++',
+    '--',
+    '&&',
+    '||',
+    '??',
+    '?.',
+    '**',
+    '+=',
+    '-=',
+    '*=',
+    '/=',
+    '%=',
+    '&=',
+    '|=',
+    '^=',
+    '</',
+    '/>'
+];
+function isIdentifierPart(character) {
+    return /[$_\p{ID_Continue}\u200C\u200D]/u.test(character);
+}
+function generatedUiSourceTokens(source) {
+    const tokens = [];
+    let index = 0;
+    while(index < source.length){
+        const character = source[index] ?? '';
+        if (/\s/u.test(character)) {
+            index += 1;
+            continue;
+        }
+        if (source.startsWith('//', index)) {
+            const lineEnd = source.indexOf('\n', index + 2);
+            index = lineEnd < 0 ? source.length : lineEnd + 1;
+            continue;
+        }
+        if (source.startsWith('/*', index)) {
+            const commentEnd = source.indexOf('*/', index + 2);
+            index = commentEnd < 0 ? source.length : commentEnd + 2;
+            continue;
+        }
+        if ("'" === character || '"' === character || '`' === character) {
+            const quote = character;
+            const start = index;
+            index += 1;
+            let escaped = false;
+            while(index < source.length){
+                const current = source[index] ?? '';
+                index += 1;
+                if (escaped) escaped = false;
+                else if ('\\' === current) escaped = true;
+                else if (current === quote) break;
+            }
+            tokens.push(`literal:${source.slice(start, index)}`);
+            continue;
+        }
+        if (isIdentifierPart(character)) {
+            const start = index;
+            index += 1;
+            while(isIdentifierPart(source[index] ?? ''))index += 1;
+            tokens.push(`word:${source.slice(start, index)}`);
+            continue;
+        }
+        const multiCharacterToken = multiCharacterTokens.find((token)=>source.startsWith(token, index));
+        if (multiCharacterToken) {
+            tokens.push(`punctuator:${multiCharacterToken}`);
+            index += multiCharacterToken.length;
+            continue;
+        }
+        tokens.push(`punctuator:${character}`);
+        index += 1;
+    }
+    return tokens;
+}
+function generatedUiSourceRequiresRewrite(existingSource, nextSource) {
+    return !isDeepStrictEqual(generatedUiSourceTokens(existingSource), generatedUiSourceTokens(nextSource));
+}
+function writeGeneratedUiSourceIfChanged(io, filePath, nextSource) {
+    if (node_fs.existsSync(filePath)) {
+        const existingSource = node_fs.readFileSync(filePath, 'utf-8');
+        if (!generatedUiSourceRequiresRewrite(existingSource, nextSource)) return io.writeGenerated(filePath, existingSource);
+    }
+    return io.writeGenerated(filePath, nextSource);
+}
+export { generatedUiSourceRequiresRewrite, writeGeneratedUiSourceIfChanged };

package/dist/esm-node/ultramodern-tooling/commands/migrate-strict-effect/help.js

@@ -0,0 +1,30 @@
+import "node:module";
+const migrateStrictEffectHelp = `Usage:
+  ultramodern-create ultramodern migrate-strict-effect --version <version> [--dry-run] [--skip-install]
+
+Updates generated UltraModern package-source metadata, Modern package aliases,
+framework-owned toolchain pins, direct Effect API topology metadata, strict
+Effect pnpm overrides/trust policy, framework-owned TypeScript config
+surfaces, and the pnpm lockfile. Source code still has to pass pnpm api:check
+and pnpm contract:check.
+
+Existing Modern configs are treated as consumer-owned unless generated
+ownership can be proven. Package scripts and TypeScript configs are merged at
+their framework-owned boundaries so consumer command segments, includes,
+references, plugins, and diagnostic overrides survive. An ambiguous Module
+Federation config that requires a bridge update is refused before any file is
+written, with the config path and the manual resolution required.
+
+The obsolete react-router dependency is dropped from every generated app that
+does not import React Router in its own source. Each generated Module
+Federation config then declares bridge.enableBridgeRouter from what its app
+still depends on: true where the app declares react-router or react-router-dom,
+the router-free false everywhere else.
+
+When the compact config is absent but legacy UltraModern 3.2 metadata is
+present, the compact config is synthesized from it first. Shell-only
+workspaces skip the backend-federation and Zerops runtime stages. Pass
+--dry-run to print the planned filesystem changes without writing anything
+(including preserved consumer overlays; implies --skip-install).
+`;
+export { migrateStrictEffectHelp };

package/dist/esm-node/ultramodern-tooling/commands/migrate-strict-effect/install.js

@@ -0,0 +1,15 @@
+import "node:module";
+import { spawnSync } from "node:child_process";
+function runPnpmLockfileRefresh(context) {
+    const result = spawnSync('pnpm', [
+        'install',
+        '--lockfile-only',
+        "--ignore-scripts"
+    ], {
+        cwd: context.workspaceRoot,
+        stdio: 'inherit'
+    });
+    if (result.error) throw result.error;
+    return result.status ?? 1;
+}
+export { runPnpmLockfileRefresh };

package/dist/esm-node/ultramodern-tooling/commands/migrate-strict-effect/io.js

@@ -0,0 +1,386 @@
+import "node:module";
+import node_fs from "node:fs";
+import node_os from "node:os";
+import node_path from "node:path";
+import { formatGeneratedSourceCandidates } from "../../../ultramodern-workspace/fs-io.js";
+const stagingExcludedEntries = new Set([
+    '.git',
+    '.nx',
+    '.output',
+    'coverage',
+    'dist',
+    'node_modules'
+]);
+const stagingGeneratedOutputEntries = new Set([
+    'coverage',
+    'dist'
+]);
+const stagingWorkspacePackageDirectories = new Set([
+    'apps',
+    'packages',
+    'verticals'
+]);
+function lstatIfExists(filePath) {
+    try {
+        return node_fs.lstatSync(filePath);
+    } catch (error) {
+        if ('ENOENT' === error.code) return;
+        throw error;
+    }
+}
+function symlinkTypeForPath(filePath) {
+    return node_fs.statSync(filePath, {
+        throwIfNoEntry: false
+    })?.isDirectory() ? 'win32' === process.platform ? 'junction' : 'dir' : 'file';
+}
+function isPathInsideRoot(rootPath, targetPath) {
+    const relativePath = node_path.relative(rootPath, targetPath);
+    return '' === relativePath || !relativePath.startsWith(`..${node_path.sep}`) && '..' !== relativePath && !node_path.isAbsolute(relativePath);
+}
+function resolvePotentialRealPath(filePath, visitedSymlinks = new Set()) {
+    const absolutePath = node_path.resolve(filePath);
+    let existingAncestor = absolutePath;
+    while(!lstatIfExists(existingAncestor)){
+        const parentPath = node_path.dirname(existingAncestor);
+        if (parentPath === existingAncestor) return absolutePath;
+        existingAncestor = parentPath;
+    }
+    let realAncestor;
+    try {
+        realAncestor = node_fs.realpathSync.native(existingAncestor);
+    } catch (error) {
+        const ancestorStat = lstatIfExists(existingAncestor);
+        if (!ancestorStat?.isSymbolicLink()) throw error;
+        if (visitedSymlinks.has(existingAncestor)) throw new Error(`Refusing to follow cyclic migration symlink: ${existingAncestor}`);
+        visitedSymlinks.add(existingAncestor);
+        realAncestor = resolvePotentialRealPath(node_path.resolve(node_path.dirname(existingAncestor), node_fs.readlinkSync(existingAncestor)), visitedSymlinks);
+    }
+    return node_path.resolve(realAncestor, node_path.relative(existingAncestor, absolutePath));
+}
+function capturePath(filePath) {
+    const stat = lstatIfExists(filePath);
+    if (!stat) return;
+    const mode = 4095 & stat.mode;
+    if (stat.isFile()) return {
+        content: node_fs.readFileSync(filePath),
+        mode,
+        type: 'file'
+    };
+    if (stat.isDirectory()) {
+        const entries = new Map();
+        for (const entry of node_fs.readdirSync(filePath).sort((left, right)=>left.localeCompare(right))){
+            const snapshot = capturePath(node_path.join(filePath, entry));
+            if (snapshot) entries.set(entry, snapshot);
+        }
+        return {
+            entries,
+            mode,
+            type: 'directory'
+        };
+    }
+    if (stat.isSymbolicLink()) return {
+        linkType: symlinkTypeForPath(filePath),
+        mode,
+        target: node_fs.readlinkSync(filePath),
+        type: 'symlink'
+    };
+    throw new Error(`Unsupported migration transaction path: ${filePath}`);
+}
+function removePath(filePath) {
+    node_fs.rmSync(filePath, {
+        force: true,
+        recursive: true
+    });
+}
+function chmodSymlinkIfSupported(filePath, mode) {
+    if ('function' == typeof node_fs.lchmodSync) node_fs.lchmodSync(filePath, mode);
+}
+function restorePath(filePath, snapshot) {
+    if (!snapshot) return void removePath(filePath);
+    const current = lstatIfExists(filePath);
+    if ('file' === snapshot.type) {
+        if (!current?.isFile() || current.isSymbolicLink()) {
+            removePath(filePath);
+            node_fs.mkdirSync(node_path.dirname(filePath), {
+                recursive: true
+            });
+        }
+        node_fs.writeFileSync(filePath, snapshot.content);
+        node_fs.chmodSync(filePath, snapshot.mode);
+        return;
+    }
+    if ('symlink' === snapshot.type) {
+        if (!current?.isSymbolicLink() || node_fs.readlinkSync(filePath) !== snapshot.target || symlinkTypeForPath(filePath) !== snapshot.linkType) {
+            removePath(filePath);
+            node_fs.mkdirSync(node_path.dirname(filePath), {
+                recursive: true
+            });
+            node_fs.symlinkSync(snapshot.target, filePath, snapshot.linkType);
+        }
+        chmodSymlinkIfSupported(filePath, snapshot.mode);
+        return;
+    }
+    if (!current?.isDirectory() || current.isSymbolicLink()) {
+        removePath(filePath);
+        node_fs.mkdirSync(filePath, {
+            recursive: true
+        });
+    }
+    for (const entry of node_fs.readdirSync(filePath))if (!snapshot.entries.has(entry)) removePath(node_path.join(filePath, entry));
+    for (const [entry, childSnapshot] of snapshot.entries)restorePath(node_path.join(filePath, entry), childSnapshot);
+    node_fs.chmodSync(filePath, snapshot.mode);
+}
+function copyWorkspaceEntry(sourcePath, destinationPath, sourceWorkspaceRoot, stagedWorkspaceRoot, sourceWorkspaceAliases) {
+    const stat = node_fs.lstatSync(sourcePath);
+    if (stat.isDirectory()) {
+        node_fs.mkdirSync(destinationPath, {
+            mode: 4095 & stat.mode
+        });
+        const relativeSourcePath = node_path.relative(sourceWorkspaceRoot, sourcePath);
+        for (const entry of node_fs.readdirSync(sourcePath)){
+            const isNamedWorkspacePackage = stagingWorkspacePackageDirectories.has(relativeSourcePath) && stagingGeneratedOutputEntries.has(entry);
+            if (!stagingExcludedEntries.has(entry) || isNamedWorkspacePackage) copyWorkspaceEntry(node_path.join(sourcePath, entry), node_path.join(destinationPath, entry), sourceWorkspaceRoot, stagedWorkspaceRoot, sourceWorkspaceAliases);
+        }
+        node_fs.chmodSync(destinationPath, 4095 & stat.mode);
+        return;
+    }
+    if (stat.isFile()) {
+        node_fs.copyFileSync(sourcePath, destinationPath, node_fs.constants.COPYFILE_FICLONE);
+        node_fs.chmodSync(destinationPath, 4095 & stat.mode);
+        return;
+    }
+    if (stat.isSymbolicLink()) {
+        const target = node_fs.readlinkSync(sourcePath);
+        const stagedTarget = node_path.isAbsolute(target) ? relocateWorkspacePath(sourceWorkspaceAliases, stagedWorkspaceRoot, target) : target;
+        node_fs.symlinkSync(stagedTarget, destinationPath, symlinkTypeForPath(sourcePath));
+        chmodSymlinkIfSupported(destinationPath, 4095 & stat.mode);
+        return;
+    }
+    throw new Error(`Unsupported migration staging path: ${sourcePath}`);
+}
+function relocateWorkspacePath(sourceWorkspaceRoots, stagedWorkspaceRoot, sourcePath) {
+    for (const sourceWorkspaceRoot of sourceWorkspaceRoots){
+        const relativePath = node_path.relative(sourceWorkspaceRoot, sourcePath);
+        if (isPathInsideRoot(sourceWorkspaceRoot, sourcePath)) return node_path.join(stagedWorkspaceRoot, relativePath);
+    }
+    return sourcePath;
+}
+function isPromiseLike(value) {
+    return ('object' == typeof value || 'function' == typeof value) && null !== value && 'function' == typeof value.then;
+}
+function createMigrationIoWithBehavior(workspaceRoot, dryRun, behavior) {
+    const absoluteWorkspaceRoot = node_path.resolve(workspaceRoot);
+    const realWorkspaceRoot = resolvePotentialRealPath(absoluteWorkspaceRoot);
+    const plan = [];
+    let activeTransaction;
+    const rel = (p)=>(node_path.relative(absoluteWorkspaceRoot, p) || node_path.basename(p)).split(node_path.sep).join('/');
+    const assertRealWorkspacePath = (absolutePath, displayedPath, followFinalSymlink = true)=>{
+        const pathToResolve = followFinalSymlink ? absolutePath : node_path.dirname(absolutePath);
+        const realPath = resolvePotentialRealPath(pathToResolve);
+        if (!isPathInsideRoot(realWorkspaceRoot, realPath)) throw new Error(`Refusing to mutate outside workspace: ${displayedPath}`);
+    };
+    const assertWorkspacePath = (filePath, followFinalSymlink = true)=>{
+        const absolutePath = node_path.resolve(filePath);
+        const relativePath = node_path.relative(absoluteWorkspaceRoot, absolutePath);
+        if ('' === relativePath || '..' === relativePath || relativePath.startsWith(`..${node_path.sep}`) || node_path.isAbsolute(relativePath)) throw new Error(`Refusing to mutate outside workspace: ${filePath}`);
+        assertRealWorkspacePath(absolutePath, filePath, followFinalSymlink);
+        return absolutePath;
+    };
+    const captureForRollback = (filePath)=>{
+        if (!activeTransaction || activeTransaction.snapshots.has(filePath)) return;
+        activeTransaction.snapshots.set(filePath, capturePath(filePath));
+        activeTransaction.order.push(filePath);
+    };
+    const captureMissingParents = (filePath)=>{
+        const missing = [];
+        let current = node_path.dirname(filePath);
+        while(current !== absoluteWorkspaceRoot && !lstatIfExists(current)){
+            missing.push(current);
+            current = node_path.dirname(current);
+        }
+        for (const missingDirectory of missing.reverse())captureForRollback(missingDirectory);
+    };
+    const rollback = (transaction)=>{
+        for (const filePath of [
+            ...transaction.order
+        ].reverse())restorePath(filePath, transaction.snapshots.get(filePath));
+    };
+    const finishWithError = (transaction, error)=>{
+        try {
+            rollback(transaction);
+        } catch (rollbackError) {
+            throw new Error(`Migration failed (${String(error)}) and rollback failed (${String(rollbackError)}).`);
+        } finally{
+            activeTransaction = void 0;
+        }
+        throw error;
+    };
+    const formatGeneratedWrites = (generatedPaths)=>{
+        if (0 === generatedPaths.size) return;
+        const relativePaths = [
+            ...generatedPaths
+        ].map((filePath)=>node_path.relative(absoluteWorkspaceRoot, filePath)).sort((left, right)=>left.localeCompare(right));
+        const formattedSources = formatGeneratedSourceCandidates(relativePaths.map((relativePath)=>[
+                relativePath,
+                node_fs.readFileSync(node_path.join(absoluteWorkspaceRoot, relativePath), 'utf-8')
+            ]));
+        for (const [index, relativePath] of relativePaths.entries())io.write(node_path.join(absoluteWorkspaceRoot, relativePath), formattedSources[index]);
+    };
+    const io = {
+        workspaceRoot: absoluteWorkspaceRoot,
+        dryRun,
+        plan,
+        write (filePath, content) {
+            const absolutePath = assertWorkspacePath(filePath);
+            if (node_fs.existsSync(absolutePath) && node_fs.readFileSync(absolutePath, 'utf-8') === content) return false;
+            if (dryRun) {
+                plan.push(`[dry-run] would write ${rel(absolutePath)}`);
+                if (!behavior.materializeDryRun) return true;
+            }
+            captureMissingParents(absolutePath);
+            captureForRollback(absolutePath);
+            const current = lstatIfExists(absolutePath);
+            if (current?.isSymbolicLink()) {
+                const linkedPath = node_path.resolve(node_path.dirname(absolutePath), node_fs.readlinkSync(absolutePath));
+                let targetPath = linkedPath;
+                try {
+                    targetPath = node_fs.realpathSync.native(absolutePath);
+                } catch  {}
+                const absoluteTargetPath = node_path.resolve(targetPath);
+                assertRealWorkspacePath(absoluteTargetPath, filePath);
+                captureMissingParents(absoluteTargetPath);
+                captureForRollback(absoluteTargetPath);
+            }
+            assertRealWorkspacePath(absolutePath, filePath);
+            node_fs.mkdirSync(node_path.dirname(absolutePath), {
+                recursive: true
+            });
+            node_fs.writeFileSync(absolutePath, content, 'utf-8');
+            return true;
+        },
+        writeGenerated (filePath, content) {
+            const absolutePath = assertWorkspacePath(filePath);
+            const changed = io.write(absolutePath, content);
+            if (dryRun && !behavior.materializeDryRun) return changed;
+            if (activeTransaction) activeTransaction.generatedPaths.add(absolutePath);
+            else formatGeneratedWrites(new Set([
+                absolutePath
+            ]));
+            return changed;
+        },
+        remove (filePath) {
+            const absolutePath = assertWorkspacePath(filePath, false);
+            if (!lstatIfExists(absolutePath)) return false;
+            if (dryRun) {
+                plan.push(`[dry-run] would delete ${rel(absolutePath)}`);
+                if (!behavior.materializeDryRun) return true;
+            }
+            activeTransaction?.generatedPaths.delete(absolutePath);
+            captureForRollback(absolutePath);
+            assertRealWorkspacePath(absolutePath, filePath, false);
+            node_fs.rmSync(absolutePath);
+            return true;
+        },
+        log (message) {
+            if (dryRun) plan.push(`[dry-run] ${message}`);
+            else process.stdout.write(`[ultramodern] ${message}\n`);
+        },
+        transaction (operation, options) {
+            if (activeTransaction) throw new Error('Nested migration transactions are not supported.');
+            const transaction = {
+                generatedPaths: new Set(),
+                order: [],
+                snapshots: new Map()
+            };
+            activeTransaction = transaction;
+            const finish = (result)=>{
+                try {
+                    if (options?.commitWhen && !options.commitWhen(result)) rollback(transaction);
+                    else formatGeneratedWrites(transaction.generatedPaths);
+                    return result;
+                } catch (error) {
+                    return finishWithError(transaction, error);
+                } finally{
+                    activeTransaction = void 0;
+                }
+            };
+            try {
+                const result = operation();
+                if (isPromiseLike(result)) return Promise.resolve(result).then((value)=>finish(value), (error)=>finishWithError(transaction, error));
+                return finish(result);
+            } catch (error) {
+                return finishWithError(transaction, error);
+            }
+        },
+        withStagedWorkspace (operation) {
+            const temporaryRoot = node_fs.mkdtempSync(node_path.join(node_os.tmpdir(), 'ultramodern-migration-'));
+            const stagedWorkspaceRoot = node_path.join(temporaryRoot, 'workspace');
+            const sourceWorkspaceAliases = [
+                ...new Set([
+                    absoluteWorkspaceRoot,
+                    realWorkspaceRoot
+                ])
+            ];
+            try {
+                copyWorkspaceEntry(realWorkspaceRoot, stagedWorkspaceRoot, realWorkspaceRoot, stagedWorkspaceRoot, sourceWorkspaceAliases);
+                const result = operation(stagedWorkspaceRoot);
+                if (isPromiseLike(result)) return Promise.resolve(result).finally(()=>{
+                    node_fs.rmSync(temporaryRoot, {
+                        force: true,
+                        recursive: true
+                    });
+                });
+                node_fs.rmSync(temporaryRoot, {
+                    force: true,
+                    recursive: true
+                });
+                return result;
+            } catch (error) {
+                node_fs.rmSync(temporaryRoot, {
+                    force: true,
+                    recursive: true
+                });
+                throw error;
+            }
+        }
+    };
+    return io;
+}
+function createMigrationIo(workspaceRoot, dryRun) {
+    return createMigrationIoWithBehavior(workspaceRoot, dryRun, {
+        materializeDryRun: false
+    });
+}
+function withStagedDryRunMigrationIo(workspaceRoot, operation) {
+    const ownerIo = createMigrationIo(workspaceRoot, true);
+    return ownerIo.withStagedWorkspace((stagedWorkspaceRoot)=>operation(createMigrationIoWithBehavior(stagedWorkspaceRoot, true, {
+            materializeDryRun: true
+        })));
+}
+function readJsonFile(filePath) {
+    return JSON.parse(node_fs.readFileSync(filePath, 'utf-8'));
+}
+function writeJsonFile(io, filePath, value) {
+    return io.write(filePath, `${JSON.stringify(value, null, 2)}\n`);
+}
+function listWorkspacePackageFiles(workspaceRoot) {
+    const packageFiles = [
+        'package.json'
+    ];
+    for (const directory of [
+        'apps',
+        'verticals',
+        'packages'
+    ]){
+        const absoluteDirectory = node_path.join(workspaceRoot, directory);
+        if (node_fs.existsSync(absoluteDirectory)) for (const entry of node_fs.readdirSync(absoluteDirectory, {
+            withFileTypes: true
+        })){
+            if (!entry.isDirectory()) continue;
+            const packageFile = `${directory}/${entry.name}/package.json`;
+            if (node_fs.existsSync(node_path.join(workspaceRoot, packageFile))) packageFiles.push(packageFile);
+        }
+    }
+    return packageFiles;
+}
+export { createMigrationIo, listWorkspacePackageFiles, readJsonFile, withStagedDryRunMigrationIo, writeJsonFile };