@wp-typia/project-tools 0.24.3 → 0.24.5

package/dist/runtime/migration-ui-capability.js

@@ -1,202 +1 @@
-import { promises as fsp } from "node:fs";
-import path from "node:path";
-import { getPackageVersions } from "./package-versions.js";
-import { formatPackageExecCommand } from "./package-managers.js";
-import { readJsonFile } from "./json-utils.js";
-import { seedProjectMigrations } from "./migrations.js";
-import { copyInterpolatedDirectory } from "./template-render.js";
-import { SHARED_MIGRATION_UI_TEMPLATE_ROOT, } from "./template-registry.js";
-const INITIAL_MIGRATION_VERSION = "v1";
-const BLOCK_METADATA_IMPORT_LINE = "import metadata from './block-metadata';";
-const LEGACY_BLOCK_JSON_IMPORT_LINE = "import metadata from './block.json';";
-async function mutatePackageJson(projectDir, mutate) {
-    const packageJsonPath = path.join(projectDir, "package.json");
-    const packageJson = await readJsonFile(packageJsonPath, {
-        context: "migration UI package manifest",
-    });
-    mutate(packageJson);
-    await fsp.writeFile(packageJsonPath, `${JSON.stringify(packageJson, null, "\t")}\n`, "utf8");
-}
-async function patchFile(filePath, transform) {
-    const source = await fsp.readFile(filePath, "utf8");
-    const nextSource = transform(source);
-    if (nextSource === source) {
-        throw new Error(`Unable to apply migration UI patch for ${filePath}`);
-    }
-    await fsp.writeFile(filePath, nextSource, "utf8");
-}
-function injectAfter(source, needle, insertion) {
-    if (source.includes(insertion)) {
-        return source;
-    }
-    if (!source.includes(needle)) {
-        return source;
-    }
-    return source.replace(needle, `${needle}\n${insertion}`);
-}
-function injectBefore(source, needle, insertion) {
-    if (source.includes(insertion)) {
-        return source;
-    }
-    if (!source.includes(needle)) {
-        return source;
-    }
-    return source.replace(needle, `${insertion}\n${needle}`);
-}
-function injectAfterBlockMetadataImport(source, insertion) {
-    const nextSource = injectAfter(source, BLOCK_METADATA_IMPORT_LINE, insertion);
-    if (nextSource !== source) {
-        return nextSource;
-    }
-    return injectAfter(source, LEGACY_BLOCK_JSON_IMPORT_LINE, insertion);
-}
-function buildMigrationBlocks(templateId, variables) {
-    if (templateId === "compound") {
-        return [
-            {
-                blockJsonFile: `src/blocks/${variables.slugKebabCase}/block.json`,
-                blockName: `${variables.namespace}/${variables.slugKebabCase}`,
-                key: variables.slugKebabCase,
-                manifestFile: `src/blocks/${variables.slugKebabCase}/typia.manifest.json`,
-                saveFile: `src/blocks/${variables.slugKebabCase}/save.tsx`,
-                typesFile: `src/blocks/${variables.slugKebabCase}/types.ts`,
-            },
-            {
-                blockJsonFile: `src/blocks/${variables.slugKebabCase}-item/block.json`,
-                blockName: `${variables.namespace}/${variables.slugKebabCase}-item`,
-                key: `${variables.slugKebabCase}-item`,
-                manifestFile: `src/blocks/${variables.slugKebabCase}-item/typia.manifest.json`,
-                saveFile: `src/blocks/${variables.slugKebabCase}-item/save.tsx`,
-                typesFile: `src/blocks/${variables.slugKebabCase}-item/types.ts`,
-            },
-        ];
-    }
-    return [
-        {
-            blockJsonFile: "src/block.json",
-            blockName: `${variables.namespace}/${variables.slugKebabCase}`,
-            key: variables.slugKebabCase,
-            manifestFile: "src/typia.manifest.json",
-            saveFile: "src/save.tsx",
-            typesFile: "src/types.ts",
-        },
-    ];
-}
-async function applySingleBlockPatches(projectDir, variables) {
-    const editPath = path.join(projectDir, "src", "edit.tsx");
-    const indexPath = path.join(projectDir, "src", "index.tsx");
-    const deprecatedImport = `import { deprecated } from './migrations/generated/${variables.slugKebabCase}/deprecated';`;
-    const deprecatedLine = "  deprecated,";
-    const dashboardImport = `import { MigrationDashboard } from './admin/migration-dashboard';`;
-    const migrationPanel = `\n        <PanelBody title={__('Migration Manager', '${variables.textDomain}')}>\n          <MigrationDashboard />\n        </PanelBody>\n      </InspectorControls>`;
-    await patchFile(indexPath, (source) => {
-        let nextSource = injectAfterBlockMetadataImport(source, deprecatedImport);
-        nextSource = injectBefore(nextSource, "  edit: Edit,", deprecatedLine);
-        return nextSource;
-    });
-    await patchFile(editPath, (source) => {
-        let nextSource = injectAfter(source, "import { useTypiaValidation } from './hooks';", dashboardImport);
-        nextSource = nextSource.replace("</InspectorControls>", migrationPanel);
-        return nextSource;
-    });
-}
-async function applyCompoundPatches(projectDir, variables) {
-    const parentEditPath = path.join(projectDir, "src", "blocks", variables.slugKebabCase, "edit.tsx");
-    const parentIndexPath = path.join(projectDir, "src", "blocks", variables.slugKebabCase, "index.tsx");
-    const childIndexPath = path.join(projectDir, "src", "blocks", `${variables.slugKebabCase}-item`, "index.tsx");
-    const addChildScriptPath = path.join(projectDir, "scripts", "add-compound-child.ts");
-    await patchFile(parentIndexPath, (source) => {
-        let nextSource = injectAfterBlockMetadataImport(source, `import { deprecated } from '../../migrations/generated/${variables.slugKebabCase}/deprecated';`);
-        nextSource = injectBefore(nextSource, "\tedit: Edit,", "\tdeprecated,");
-        return nextSource;
-    });
-    await patchFile(childIndexPath, (source) => {
-        let nextSource = injectAfterBlockMetadataImport(source, `import { deprecated } from '../../migrations/generated/${variables.slugKebabCase}-item/deprecated';`);
-        nextSource = injectBefore(nextSource, "\tedit: Edit,", "\tdeprecated,");
-        return nextSource;
-    });
-    await patchFile(parentEditPath, (source) => {
-        let nextSource = injectAfter(source, "import { useTypiaValidation } from './hooks';", `import { MigrationDashboard } from '../../admin/migration-dashboard';`);
-        nextSource = nextSource.replace("</InspectorControls>", `\n\t\t\t\t<PanelBody title={ __( 'Migration Manager', '${variables.textDomain}' ) }>\n\t\t\t\t\t<MigrationDashboard />\n\t\t\t\t</PanelBody>\n\t\t\t</InspectorControls>`);
-        return nextSource;
-    });
-    await patchFile(addChildScriptPath, (source) => {
-        let nextSource = injectAfter(source, "const PROJECT_ROOT = process.cwd();", "const MIGRATION_CONFIG_FILE = path.join( PROJECT_ROOT, 'src', 'migrations', 'config.ts' );");
-        nextSource = injectAfterBlockMetadataImport(nextSource, "import { deprecated } from '../../migrations/generated/${ childFolderSlug }/deprecated';");
-        nextSource = nextSource.replace("\\t\\tedit: Edit,\n\\t\\tsave: Save,", "\\t\\tdeprecated,\n\\t\\tedit: Edit,\n\\t\\tsave: Save,");
-        nextSource = injectAfter(nextSource, "function insertBeforeMarker( filePath: string, marker: string, insertionLines: string[] ) {", "");
-        if (!nextSource.includes("function appendMigrationBlockConfig")) {
-            const appendMigrationHelper = [
-                "function appendMigrationBlockConfig( filePath: string, childBlockName: string, childFolderSlug: string ) {",
-                "\tif ( ! fs.existsSync( filePath ) ) {",
-                "\t\treturn;",
-                "\t}",
-                "",
-                "\tconst source = fs.readFileSync( filePath, 'utf8' );",
-                "\tconst blockEntry = [",
-                "\t\t`\\t\\t{`,",
-                "\t\t`\\t\\t\\tkey: '${ childFolderSlug }',`,",
-                "\t\t`\\t\\t\\tblockName: '${ childBlockName }',`,",
-                "\t\t`\\t\\t\\tblockJsonFile: 'src/blocks/${ childFolderSlug }/block.json',`,",
-                "\t\t`\\t\\t\\tmanifestFile: 'src/blocks/${ childFolderSlug }/typia.manifest.json',`,",
-                "\t\t`\\t\\t\\tsaveFile: 'src/blocks/${ childFolderSlug }/save.tsx',`,",
-                "\t\t`\\t\\t\\ttypesFile: 'src/blocks/${ childFolderSlug }/types.ts',`,",
-                "\t\t`\\t\\t},`,",
-                "\t].join( '\\n' );",
-                "\tif ( source.includes( `key: '${ childFolderSlug }'` ) ) {",
-                "\t\treturn;",
-                "\t}",
-                "\tconst nextSource = source.replace( /\\tblocks:\\s*\\[([\\s\\S]*?)\\n\\t\\],/m, ( match ) => {",
-                "\t\treturn match.replace( /\\n\\t\\],$/, `\\n${ blockEntry }\\n\\t],` );",
-                "\t} );",
-                "\tfs.writeFileSync( filePath, nextSource, 'utf8' );",
-                "}",
-                "",
-                "function renderBlockJson(",
-            ].join("\n");
-            nextSource = nextSource.replace("function renderBlockJson(", appendMigrationHelper);
-        }
-        nextSource = nextSource.replace("console.log( `✅ Added compound child block ${ childBlockName }` );", "appendMigrationBlockConfig( MIGRATION_CONFIG_FILE, childBlockName, childFolderSlug );\n\n\tconsole.log( `✅ Added compound child block ${ childBlockName }` );");
-        return nextSource;
-    });
-}
-/**
- * Layer the migration dashboard capability onto a freshly scaffolded project.
- *
- * This copies the shared migration UI files, wires template-specific editor
- * hooks, and injects pinned migration scripts that shell out to the matching
- * `wp-typia` CLI version.
- */
-export async function applyMigrationUiCapability({ packageManager, projectDir, templateId, variables, }) {
-    const commonTemplateDir = path.join(SHARED_MIGRATION_UI_TEMPLATE_ROOT, "common");
-    await copyInterpolatedDirectory(commonTemplateDir, projectDir, variables);
-    await mutatePackageJson(projectDir, (packageJson) => {
-        const wpTypiaPackageVersion = getPackageVersions().wpTypiaPackageVersion;
-        const canonicalCliSpecifier = wpTypiaPackageVersion === "^0.0.0"
-            ? "wp-typia"
-            : `wp-typia@${wpTypiaPackageVersion.replace(/^[~^]/u, "")}`;
-        const migrationCli = (args) => formatPackageExecCommand(packageManager, canonicalCliSpecifier, `migrate ${args}`);
-        packageJson.dependencies = {
-            ...(packageJson.dependencies ?? {}),
-            "@wordpress/api-fetch": "^7.42.0",
-        };
-        packageJson.scripts = {
-            ...(packageJson.scripts ?? {}),
-            "migration:init": migrationCli(`init --current-migration-version ${INITIAL_MIGRATION_VERSION}`),
-            "migration:snapshot": migrationCli("snapshot"),
-            "migration:diff": migrationCli("diff"),
-            "migration:scaffold": migrationCli("scaffold"),
-            "migration:doctor": migrationCli("doctor --all"),
-            "migration:fixtures": migrationCli("fixtures --all"),
-            "migration:verify": migrationCli("verify --all"),
-            "migration:fuzz": migrationCli("fuzz --all"),
-        };
-    });
-    if (templateId === "compound") {
-        await applyCompoundPatches(projectDir, variables);
-    }
-    else {
-        await applySingleBlockPatches(projectDir, variables);
-    }
-    await seedProjectMigrations(projectDir, INITIAL_MIGRATION_VERSION, buildMigrationBlocks(templateId, variables));
-}
+export * from "./migration/migration-ui-capability.js";

package/dist/runtime/migration-utils.d.ts

@@ -1,71 +1 @@
-import { type PackageManagerId } from './package-managers.js';
-import type { JsonValue, ManifestAttribute, JsonObject } from './migration-types.js';
-import { type UnknownRecord } from './object-utils.js';
-export { cloneJsonValue } from './json-utils.js';
-export declare function getValueAtPath<TRecord extends UnknownRecord>(input: TRecord, pathLabel: string): unknown;
-export declare function setValueAtPath<TRecord extends UnknownRecord>(input: TRecord, pathLabel: string, value: unknown): TRecord;
-export declare function deleteValueAtPath<TRecord extends UnknownRecord>(input: TRecord, pathLabel: string): TRecord;
-export declare function createFixtureScalarValue(pathLabel: string): JsonValue;
-export declare function createTransformFixtureValue(attribute: ManifestAttribute | null | undefined, pathLabel: string): JsonValue;
-export declare function readJson<T = unknown>(filePath: string): T;
-export declare function renderPhpValue(value: unknown, indentLevel: number): string;
-export declare function copyFile(sourcePath: string, targetPath: string): void;
-export declare function sanitizeSaveSnapshotSource(source: string): string;
-export declare function sanitizeSnapshotBlockJson(blockJson: JsonObject): JsonObject;
-export declare function runProjectScriptIfPresent(projectDir: string, scriptName: string): void;
-export declare function detectPackageManagerId(projectDir: string): PackageManagerId;
-export declare function getLocalTsxBinary(projectDir: string): string;
-/**
- * Returns whether isInteractiveTerminal() is running with both stdin and stdout
- * attached to a TTY so CLI and migration flows can safely prompt the user.
- */
-export declare function isInteractiveTerminal(): boolean;
-/**
- * Resolves the `current` sentinel to the current migration version label.
- *
- * @param currentMigrationVersion Current migration version label for the workspace.
- * @param value Requested target value, which may be `current`.
- * @returns The concrete migration version label that should be used.
- */
-export declare function resolveTargetMigrationVersion(currentMigrationVersion: string, value: string): string;
-/**
- * Returns whether a value matches the canonical `vN` migration label format.
- *
- * @param value Candidate migration version label.
- * @returns `true` when the value is a valid `vN` label with `N >= 1`.
- */
-export declare function isMigrationVersionLabel(value: string): boolean;
-/**
- * Returns whether a value looks like a legacy semver-based migration label.
- *
- * @param value Candidate migration version label.
- * @returns `true` when the value matches the legacy `x.y.z` semver pattern.
- */
-export declare function isLegacySemverMigrationVersion(value: string): boolean;
-/**
- * Throws when a migration version label does not match the canonical `vN` format.
- *
- * @param value Candidate migration version label.
- * @param label Human-readable label used in the thrown error message.
- * @returns Nothing.
- * @throws Error When the provided value is not a valid `vN` migration label.
- */
-export declare function assertMigrationVersionLabel(value: string, label: string): void;
-/**
- * Compares two migration version labels by their numeric suffix.
- *
- * @param left Left migration version label.
- * @param right Right migration version label.
- * @returns A negative number when `left < right`, zero when equal, and a positive number when `left > right`.
- */
-export declare function compareMigrationVersionLabels(left: string, right: string): number;
-/**
- * Formats the reset guidance shown when a legacy semver migration workspace is detected.
- *
- * @param reason Optional leading reason that explains what legacy pattern was found.
- * @returns A user-facing guidance string that explains how to reset to `v1` labels.
- */
-export declare function formatLegacyMigrationWorkspaceResetGuidance(reason?: string): string;
-export declare function escapeForCode(value: unknown): string;
-export declare function renderObjectKey(key: string): string;
-export declare function isNumber(value: unknown): value is number;
+export * from "./migration/migration-utils.js";

package/dist/runtime/migration-utils.js

@@ -1,244 +1 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { execSync } from 'node:child_process';
-import { formatRunScript, inferPackageManagerId, parsePackageManagerField, } from './package-managers.js';
-import { isPlainObject } from './object-utils.js';
-import { readJsonFileSync } from './json-utils.js';
-export { cloneJsonValue } from './json-utils.js';
-const MIGRATION_VERSION_LABEL_PATTERN = /^v([1-9]\d*)$/;
-const LEGACY_SEMVER_MIGRATION_VERSION_PATTERN = /^\d+\.\d+\.\d+$/;
-export function getValueAtPath(input, pathLabel) {
-    return String(pathLabel)
-        .split('.')
-        .reduce((value, segment) => (isPlainObject(value) ? value[segment] : undefined), input);
-}
-export function setValueAtPath(input, pathLabel, value) {
-    const segments = String(pathLabel).split('.');
-    let target = input;
-    while (segments.length > 1) {
-        const segment = segments.shift();
-        if (!segment) {
-            continue;
-        }
-        if (!isPlainObject(target[segment])) {
-            target[segment] = {};
-        }
-        target = target[segment];
-    }
-    target[segments[0]] = value;
-    return input;
-}
-export function deleteValueAtPath(input, pathLabel) {
-    const segments = String(pathLabel).split('.');
-    let target = input;
-    while (segments.length > 1) {
-        const segment = segments.shift();
-        if (!segment || !isPlainObject(target[segment])) {
-            return input;
-        }
-        target = target[segment];
-    }
-    delete target[segments[0]];
-    return input;
-}
-export function createFixtureScalarValue(pathLabel) {
-    const normalized = String(pathLabel).toLowerCase();
-    if (normalized.includes('id')) {
-        return '00000000-0000-4000-8000-000000000000';
-    }
-    if (normalized.includes('count') || normalized.includes('number')) {
-        return 1;
-    }
-    if (normalized.includes('visible') || normalized.startsWith('is')) {
-        return true;
-    }
-    return `legacy:${pathLabel}`;
-}
-export function createTransformFixtureValue(attribute, pathLabel) {
-    switch (attribute?.ts?.kind) {
-        case 'number':
-            return '42';
-        case 'boolean':
-            return '1';
-        case 'union':
-            return { kind: 'unknown' };
-        default:
-            return createFixtureScalarValue(pathLabel);
-    }
-}
-export function readJson(filePath) {
-    return readJsonFileSync(filePath, {
-        context: 'migration JSON file',
-    });
-}
-export function renderPhpValue(value, indentLevel) {
-    const indent = '\t'.repeat(indentLevel);
-    const nestedIndent = '\t'.repeat(indentLevel + 1);
-    if (value === null) {
-        return 'null';
-    }
-    if (typeof value === 'string') {
-        return `'${value.replace(/\\/g, '\\\\').replace(/'/g, "\\'")}'`;
-    }
-    if (typeof value === 'number' || typeof value === 'boolean') {
-        return String(value);
-    }
-    if (Array.isArray(value)) {
-        if (value.length === 0) {
-            return '[]';
-        }
-        const items = value.map((item) => `${nestedIndent}${renderPhpValue(item, indentLevel + 1)}`);
-        return `[\n${items.join(',\n')}\n${indent}]`;
-    }
-    if (typeof value === 'object') {
-        const entries = Object.entries(value);
-        if (entries.length === 0) {
-            return '[]';
-        }
-        const items = entries.map(([key, item]) => `${nestedIndent}'${String(key).replace(/\\/g, '\\\\').replace(/'/g, "\\'")}' => ${renderPhpValue(item, indentLevel + 1)}`);
-        return `[\n${items.join(',\n')}\n${indent}]`;
-    }
-    throw new Error(`Unable to encode PHP migration registry value for ${String(value)}`);
-}
-export function copyFile(sourcePath, targetPath) {
-    fs.mkdirSync(path.dirname(targetPath), { recursive: true });
-    fs.copyFileSync(sourcePath, targetPath);
-}
-export function sanitizeSaveSnapshotSource(source) {
-    return source
-        .replace(/^import\s+\{[^}]+\}\s+from\s+['"]\.\/types['"];?\n?/gm, '')
-        .replace(/^interface\s+SaveProps\s*\{[\s\S]*?\}\n?/m, '')
-        .replace(/: SaveProps/g, ': { attributes: any }')
-        .replace(/attributes:\s*[A-Za-z0-9_<>{}\[\]|&,\s]+;/g, 'attributes: any;')
-        .replace(/\(\{\s*attributes\s*\}:\s*\{\s*attributes:\s*any\s*\}\)/g, '({ attributes }: { attributes: any })')
-        .replace(/\n{3,}/g, '\n\n')
-        .trimEnd()
-        .concat('\n');
-}
-export function sanitizeSnapshotBlockJson(blockJson) {
-    const snapshot = { ...blockJson };
-    for (const key of [
-        'editorScript',
-        'script',
-        'scriptModule',
-        'viewScript',
-        'viewScriptModule',
-        'style',
-        'editorStyle',
-        'render',
-    ]) {
-        delete snapshot[key];
-    }
-    return snapshot;
-}
-export function runProjectScriptIfPresent(projectDir, scriptName) {
-    const packageJson = readJson(path.join(projectDir, 'package.json'));
-    if (!packageJson.scripts?.[scriptName]) {
-        return;
-    }
-    const packageManagerId = detectPackageManagerId(projectDir);
-    execSync(formatRunScript(packageManagerId, scriptName), {
-        cwd: projectDir,
-        stdio: 'inherit',
-    });
-}
-export function detectPackageManagerId(projectDir) {
-    const packageJson = readJson(path.join(projectDir, 'package.json'));
-    return (parsePackageManagerField(packageJson.packageManager) ??
-        inferPackageManagerId(projectDir));
-}
-export function getLocalTsxBinary(projectDir) {
-    const filename = process.platform === 'win32' ? 'tsx.cmd' : 'tsx';
-    const binaryPath = path.join(projectDir, 'node_modules', '.bin', filename);
-    if (!fs.existsSync(binaryPath)) {
-        throw new Error('Local tsx binary was not found. Install project dependencies before running migration verification.');
-    }
-    return binaryPath;
-}
-/**
- * Returns whether isInteractiveTerminal() is running with both stdin and stdout
- * attached to a TTY so CLI and migration flows can safely prompt the user.
- */
-export function isInteractiveTerminal() {
-    return Boolean(process.stdin.isTTY && process.stdout.isTTY);
-}
-/**
- * Resolves the `current` sentinel to the current migration version label.
- *
- * @param currentMigrationVersion Current migration version label for the workspace.
- * @param value Requested target value, which may be `current`.
- * @returns The concrete migration version label that should be used.
- */
-export function resolveTargetMigrationVersion(currentMigrationVersion, value) {
-    return value === 'current' ? currentMigrationVersion : value;
-}
-/**
- * Returns whether a value matches the canonical `vN` migration label format.
- *
- * @param value Candidate migration version label.
- * @returns `true` when the value is a valid `vN` label with `N >= 1`.
- */
-export function isMigrationVersionLabel(value) {
-    return MIGRATION_VERSION_LABEL_PATTERN.test(value);
-}
-/**
- * Returns whether a value looks like a legacy semver-based migration label.
- *
- * @param value Candidate migration version label.
- * @returns `true` when the value matches the legacy `x.y.z` semver pattern.
- */
-export function isLegacySemverMigrationVersion(value) {
-    return LEGACY_SEMVER_MIGRATION_VERSION_PATTERN.test(value);
-}
-/**
- * Throws when a migration version label does not match the canonical `vN` format.
- *
- * @param value Candidate migration version label.
- * @param label Human-readable label used in the thrown error message.
- * @returns Nothing.
- * @throws Error When the provided value is not a valid `vN` migration label.
- */
-export function assertMigrationVersionLabel(value, label) {
-    if (!isMigrationVersionLabel(value)) {
-        throw new Error(`Invalid ${label}: ${value}. Expected vN with N >= 1.`);
-    }
-}
-function parseMigrationVersionNumber(value) {
-    const match = value.match(MIGRATION_VERSION_LABEL_PATTERN);
-    if (!match) {
-        throw new Error(`Invalid migration version label: ${value}. Expected vN with N >= 1.`);
-    }
-    return Number.parseInt(match[1], 10);
-}
-/**
- * Compares two migration version labels by their numeric suffix.
- *
- * @param left Left migration version label.
- * @param right Right migration version label.
- * @returns A negative number when `left < right`, zero when equal, and a positive number when `left > right`.
- */
-export function compareMigrationVersionLabels(left, right) {
-    return parseMigrationVersionNumber(left) - parseMigrationVersionNumber(right);
-}
-/**
- * Formats the reset guidance shown when a legacy semver migration workspace is detected.
- *
- * @param reason Optional leading reason that explains what legacy pattern was found.
- * @returns A user-facing guidance string that explains how to reset to `v1` labels.
- */
-export function formatLegacyMigrationWorkspaceResetGuidance(reason) {
-    return [
-        reason ? `${reason} ` : '',
-        'Back up `src/migrations/` if needed, remove or reset the existing migration workspace, ',
-        'then rerun `wp-typia migrate init --current-migration-version v1`.',
-    ].join('');
-}
-export function escapeForCode(value) {
-    return String(value).replace(/\\/g, '\\\\').replace(/"/g, '\\"');
-}
-export function renderObjectKey(key) {
-    return JSON.stringify(String(key));
-}
-export function isNumber(value) {
-    return typeof value === 'number' && Number.isFinite(value);
-}
+export * from "./migration/migration-utils.js";

package/dist/runtime/migrations.d.ts

@@ -1,152 +1 @@
-import { CommandRenderOptions, DiffLikeOptions, formatMigrationHelpText, parseMigrationArgs, WizardOptions } from "./migration-command-surface.js";
-import { createMigrationDiff } from "./migration-diff.js";
-import { formatDiffReport } from "./migration-render.js";
-import { createMigrationRiskSummary } from "./migration-risk.js";
-import { doctorProjectMigrations, fixturesProjectMigrations, fuzzProjectMigrations, verifyProjectMigrations } from "./migration-maintenance.js";
-import type { MigrationBlockConfig, ParsedMigrationArgs } from "./migration-types.js";
-type MigrationPlanBlockSummary = {
-    blockName: string;
-    diff: ReturnType<typeof createMigrationDiff>;
-    riskSummary: ReturnType<typeof createMigrationRiskSummary>;
-};
-type MigrationPlanSummary = {
-    availableLegacyVersions: string[];
-    currentMigrationVersion: string;
-    fromMigrationVersion: string;
-    includedBlocks: string[];
-    nextSteps: string[];
-    skippedBlocks: string[];
-    summaries: MigrationPlanBlockSummary[];
-    targetMigrationVersion: string;
-};
-export { formatMigrationHelpText, parseMigrationArgs };
-export { formatDiffReport };
-/**
- * Dispatch a parsed migration command to the matching runtime workflow.
- *
- * Most commands execute synchronously and preserve direct throw semantics for
- * existing callers. The interactive `wizard` command returns a promise because
- * it waits for prompt selection before running the shared read-only planner.
- *
- * @param command Parsed migration command and flags.
- * @param cwd Project directory to operate on.
- * @param options Optional prompt/render hooks for testable and interactive execution.
- * @returns The command result, or a promise when the selected command is interactive.
- */
-export declare function runMigrationCommand(command: ParsedMigrationArgs, cwd: string, { prompt, renderLine }?: CommandRenderOptions): import("./migration-types.js").MigrationProjectState | import("./migration-types.js").MigrationDiff | {
-    verifiedVersions: string[];
-} | {
-    checkedVersions: string[];
-    checks: {
-        detail: string;
-        label: string;
-        status: "fail" | "pass";
-    }[];
-} | {
-    generatedVersions: string[];
-    skippedVersions: string[];
-} | {
-    fuzzedVersions: string[];
-    seed: number | undefined;
-} | MigrationPlanSummary | Promise<MigrationPlanSummary | {
-    cancelled: true;
-}> | {
-    block: import("./migration-types.js").ResolvedMigrationBlockTarget;
-    diff: import("./migration-types.js").MigrationDiff;
-}[] | {
-    blockName: string;
-    diff: ReturnType<typeof createMigrationDiff>;
-    rulePath: string;
-} | {
-    scaffolded: {
-        blockName: string;
-        diff: ReturnType<typeof createMigrationDiff>;
-        rulePath: string;
-    }[];
-};
-/**
- * Preview one migration edge without scaffolding rules, fixtures, or generated files.
- *
- * @param projectDir Absolute or relative project directory containing the migration workspace.
- * @param options Selected source/target versions plus optional line rendering overrides.
- * @returns A structured summary of the selected edge, included/skipped block targets, and next steps.
- */
-export declare function planProjectMigrations(projectDir: string, { fromMigrationVersion, renderLine, toMigrationVersion }?: DiffLikeOptions): MigrationPlanSummary;
-/**
- * Interactively choose one legacy version to preview, then run the same read-only planner.
- *
- * @param projectDir Absolute or relative project directory containing the migration workspace.
- * @param options Interactive prompt and rendering settings. Throws when no TTY is available.
- * @returns The planned migration summary, or `{ cancelled: true }` when the user exits the wizard.
- */
-export declare function wizardProjectMigrations(projectDir: string, { isInteractive, prompt, renderLine, }?: WizardOptions): Promise<MigrationPlanSummary | {
-    cancelled: true;
-}>;
-/**
- * Initializes migration scaffolding for a detected single-block or multi-block project layout.
- *
- * @param projectDir Absolute or relative project directory containing the migration workspace.
- * @param currentMigrationVersion Initial migration version label to seed, such as `v1`.
- * @param options Console rendering options used to report retrofit detection and initialization output.
- * @returns The loaded migration project state after the config, snapshots, and generated files are written.
- * @throws Error When the project layout is unsupported or the migration version label is invalid.
- */
-export declare function initProjectMigrations(projectDir: string, currentMigrationVersion: string, { renderLine }?: CommandRenderOptions): import("./migration-types.js").MigrationProjectState;
-/**
- * Captures the current project state as a named migration snapshot and refreshes generated artifacts.
- *
- * @param projectDir Absolute or relative project directory containing the migration workspace.
- * @param migrationVersion Migration version label to snapshot, such as `v2`.
- * @param options Console rendering options and snapshot side-effect flags.
- * @returns The loaded migration project state after the snapshot files and registry outputs are refreshed.
- * @throws Error When the label is invalid, the project is not migration-capable, or `sync-types` fails.
- */
-export declare function snapshotProjectVersion(projectDir: string, migrationVersion: string, { renderLine, skipConfigUpdate, skipSyncTypes, }?: CommandRenderOptions & {
-    skipConfigUpdate?: boolean;
-    skipSyncTypes?: boolean;
-}): import("./migration-types.js").MigrationProjectState;
-/**
- * Computes and renders migration diffs for a selected legacy-to-target edge.
- *
- * @param projectDir Absolute or relative project directory containing the migration workspace.
- * @param options Selected source and target migration versions plus optional line rendering overrides.
- * @returns A single diff for single-block workspaces, or an array of per-block diffs for multi-block workspaces.
- * @throws Error When `fromMigrationVersion` is missing or no eligible snapshots exist for the selected edge.
- */
-export declare function diffProjectMigrations(projectDir: string, { fromMigrationVersion, toMigrationVersion, renderLine, }?: DiffLikeOptions): import("./migration-types.js").MigrationDiff | {
-    block: import("./migration-types.js").ResolvedMigrationBlockTarget;
-    diff: import("./migration-types.js").MigrationDiff;
-}[];
-/**
- * Scaffolds migration rule and fixture files for a selected legacy-to-target edge.
- *
- * @param projectDir Absolute or relative project directory containing the migration workspace.
- * @param options Selected source and target migration versions plus optional line rendering overrides.
- * @returns A single scaffold result for single-block workspaces, or a grouped result for multi-block workspaces.
- * @throws Error When `fromMigrationVersion` is missing or no eligible snapshots exist for the selected edge.
- */
-export declare function scaffoldProjectMigrations(projectDir: string, { fromMigrationVersion, toMigrationVersion, renderLine, }?: DiffLikeOptions): {
-    blockName: string;
-    diff: ReturnType<typeof createMigrationDiff>;
-    rulePath: string;
-} | {
-    scaffolded: {
-        blockName: string;
-        diff: ReturnType<typeof createMigrationDiff>;
-        rulePath: string;
-    }[];
-};
-export { doctorProjectMigrations, fixturesProjectMigrations, fuzzProjectMigrations, verifyProjectMigrations, };
-/**
- * Initialize migration scaffolding for one or more block targets.
- *
- * Writes the migration config, creates the initial scaffold files, snapshots
- * the current project state, and regenerates generated migration artifacts.
- *
- * @param projectDir Absolute or relative project directory containing the migration workspace.
- * @param currentMigrationVersion Initial migration version label to seed into the migration config.
- * @param blocks Block targets to register for migration-aware scaffolding.
- * @param options Console rendering options for initialization output.
- * @returns The loaded migration project state after initialization completes.
- */
-export declare function seedProjectMigrations(projectDir: string, currentMigrationVersion: string, blocks: MigrationBlockConfig[], { renderLine }?: CommandRenderOptions): import("./migration-types.js").MigrationProjectState;
+export * from "./migration/migrations.js";