@wp-typia/project-tools 0.24.4 → 0.24.5

package/dist/runtime/cli-help.js

@@ -1,84 +1 @@
-import { PACKAGE_MANAGER_IDS } from "./package-managers.js";
-import { TEMPLATE_IDS } from "./template-registry.js";
-/**
- * Return the canonical CLI usage text for `wp-typia`.
- *
- * The rendered help includes the current built-in template ids and supported
- * package manager ids from the runtime registry.
- *
- * @returns Human-readable help text for CLI usage output.
- */
-export function formatHelpText() {
-    return `Usage:
-  wp-typia create <project-dir> [--template <basic|interactivity>] [--external-layer-source <./path|github:owner/repo/path[#ref]|npm-package>] [--external-layer-id <layer-id>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-migration-ui] [--with-wp-env] [--with-test-preset] [--yes] [--dry-run] [--no-install] [--package-manager <id>]
-  wp-typia create <project-dir> [--template workspace] [--profile <plugin-qa>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-migration-ui] [--with-wp-env] [--with-test-preset] [--yes] [--dry-run] [--no-install] [--package-manager <id>]
-  wp-typia create <project-dir> [--template query-loop] [--external-layer-source <./path|github:owner/repo/path[#ref]|npm-package>] [--external-layer-id <layer-id>] [--query-post-type <post-type>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-migration-ui] [--with-wp-env] [--with-test-preset] [--yes] [--dry-run] [--no-install] [--package-manager <id>]
-  wp-typia create <project-dir> [--template <./path|github:owner/repo/path[#ref]>] [--variant <name>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-wp-env] [--with-test-preset] [--yes] [--dry-run] [--no-install] [--package-manager <id>]
-  wp-typia create <project-dir> [--template <npm-package>] [--variant <name>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-wp-env] [--with-test-preset] [--yes] [--dry-run] [--no-install] [--package-manager <id>]
-  wp-typia create <project-dir> [--template persistence] [--external-layer-source <./path|github:owner/repo/path[#ref]|npm-package>] [--external-layer-id <layer-id>] [--alternate-render-targets <email,mjml,plain-text>] [--data-storage <post-meta|custom-table>] [--persistence-policy <authenticated|public>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-migration-ui] [--with-wp-env] [--with-test-preset] [--yes] [--dry-run] [--no-install] [--package-manager <id>]
-  wp-typia create <project-dir> [--template compound] [--external-layer-source <./path|github:owner/repo/path[#ref]|npm-package>] [--external-layer-id <layer-id>] [--inner-blocks-preset <freeform|ordered|horizontal|locked-structure>] [--alternate-render-targets <email,mjml,plain-text>] [--data-storage <post-meta|custom-table>] [--persistence-policy <authenticated|public>] [--namespace <value>] [--text-domain <value>] [--php-prefix <value>] [--with-migration-ui] [--with-wp-env] [--with-test-preset] [--yes] [--dry-run] [--no-install] [--package-manager <id>]
-  wp-typia <project-dir> [create flags...]
-  wp-typia init [project-dir] [--apply] [--package-manager <id>]
-  wp-typia add admin-view <name> [--source <rest-resource:slug|core-data:kind/name>]
-  wp-typia add block <name> [--template <basic|interactivity|persistence|compound>] [--external-layer-source <./path|github:owner/repo/path[#ref]|npm-package>] [--external-layer-id <layer-id>] [--inner-blocks-preset <freeform|ordered|horizontal|locked-structure>] [--alternate-render-targets <email,mjml,plain-text>] [--data-storage <post-meta|custom-table>] [--persistence-policy <authenticated|public>]
-  wp-typia add integration-env <name> [--wp-env] [--release-zip] [--service <none|docker-compose>]
-  wp-typia add core-variation <block-name> <name>
-  wp-typia add core-variation <name> --block <namespace/block>
-  wp-typia add variation <name> --block <block-slug>
-  wp-typia add style <name> --block <block-slug>
-  wp-typia add transform <name> --from <namespace/block> --to <block-slug|namespace/block-slug>
-  wp-typia add pattern <name> [--scope <full|section>] [--section-role <role>] [--catalog-title <title>] [--tags <tag,...>] [--tag <tag>...] [--thumbnail-url <url>]
-  wp-typia add binding-source <name> [--block <block-slug|namespace/block-slug> --attribute <attribute>] [--from-post-meta|--post-meta <post-meta> [--meta-path <field>]]
-  wp-typia add rest-resource <name> [--namespace <vendor/v1>] [--methods <method[,method...]>]
-  wp-typia add rest-resource <name> --manual [--namespace <vendor/v1>] [--method <GET|POST|PUT|PATCH|DELETE>] [--auth <public|authenticated|public-write-protected>] [--path <route-pattern>|--route-pattern <route-pattern>] [--permission-callback <callback>] [--controller-class <ClassName>] [--controller-extends <BaseClass>] [--query-type <Type>] [--body-type <Type>] [--response-type <Type>] [--secret-field <field>] [--secret-state-field|--secret-has-value-field <field>] [--secret-preserve-on-empty <true|false>]
-  wp-typia add post-meta <name> --post-type <post-type> [--type <ExportedTypeName>] [--meta-key <meta-key>] [--hide-from-rest]
-  wp-typia add ability <name>
-  wp-typia add ai-feature <name> [--namespace <vendor/v1>]
-  wp-typia add editor-plugin <name> [--slot <sidebar|document-setting-panel>]
-  wp-typia add hooked-block <block-slug> --anchor <anchor-block-name> --position <before|after|firstChild|lastChild>
-  wp-typia migrate <init|snapshot|diff|scaffold|verify|doctor|fixtures|fuzz> [...]
-  wp-typia templates list
-  wp-typia templates inspect <id>
-  wp-typia doctor
-  wp-typia mcp <list|sync>
-  wp-typia skills <list|sync>
-  wp-typia completions <bash|zsh|fish|powershell>
-
-Built-in templates: ${TEMPLATE_IDS.join(", ")}
-Package managers: ${PACKAGE_MANAGER_IDS.join(", ")}
-Output environment:
-  WP_TYPIA_ASCII=1 forces ASCII status markers; WP_TYPIA_ASCII=0 opts back into Unicode markers even when NO_COLOR is set.
-  A non-empty NO_COLOR requests ASCII-safe markers such as [ok], [dry-run], [!], and [...] when WP_TYPIA_ASCII is not set.
-Notes:
-  \`wp-typia create\` is the canonical scaffold command.
-  \`wp-typia <project-dir>\` remains a backward-compatible alias to \`create\` when \`<project-dir>\` is the only positional argument.
-  \`wp-typia init\` previews the minimum retrofit sync surface by default; rerun with \`--apply\` to write package.json updates and generated helper scripts.
-  Use \`--template workspace\` as shorthand for \`@wp-typia/create-workspace-template\`, the official empty workspace scaffold behind \`wp-typia add ...\`.
-  Use \`--profile plugin-qa\` with \`--template workspace\` when a plugin needs local wp-env smoke checks, \`.env.example\`, and release zip scripts from day one; omit it for the minimal workspace shell.
-  Interactive add flows let you choose a template when \`--template\` is omitted; non-interactive runs default to \`basic\`.
-  Unknown \`core/*\` targets for \`add core-variation\` warn instead of failing so newer WordPress core blocks remain scaffoldable; third-party namespaces are allowed without local discovery.
-  \`add admin-view\` scaffolds an opt-in DataViews-powered WordPress admin screen under \`src/admin-views/\`.
-  Pass \`--source rest-resource:<slug>\` to reuse a list-capable REST resource.
-  Pass \`--source core-data:postType/post\` or \`--source core-data:taxonomy/category\` to bind a WordPress-owned entity collection.
-  Generated admin-view workspaces add \`@wp-typia/dataviews\` and the needed WordPress DataViews packages as opt-in dependencies.
-  \`add integration-env\` generates an opt-in local smoke starter under \`scripts/integration-smoke/\`, updates \`.env.example\`, and can add \`@wordpress/env\` plus \`.wp-env.json\` when \`--wp-env\` is passed.
-  Pass \`--release-zip\` to add \`release:zip\`, \`release:zip:check\`, and \`qa:check\` scripts for plugin QA packaging.
-  Pass \`--service docker-compose\` to include a placeholder local service stack that can be adapted to project-specific dependencies.
-  \`query-loop\` is create-only. Use \`wp-typia create <project-dir> --template query-loop\`; \`wp-typia add block\` accepts only basic, interactivity, persistence, and compound families.
-  \`add variation\` uses an existing workspace block from \`scripts/block-config.ts\`.
-  \`add style\` registers a Block Styles option for an existing generated block.
-  \`add transform\` adds a block-to-block transform into an existing generated block.
-  \`add pattern\` scaffolds a namespaced PHP pattern shell under \`src/patterns/full/\` or \`src/patterns/sections/\`; pass \`--catalog-title "Hero Photo"\` to override the generated catalog title, pass \`--tags hero,landing\` for a comma-separated tag list, and repeat \`--tag hero --tag landing\` for single tag values.
-  \`add binding-source\` scaffolds shared PHP and editor registration under \`src/bindings/\`; pass \`--block\` and \`--attribute\` together to declare a bindable generated-block attribute. Pass \`--from-post-meta\` or \`--post-meta\` to back the source from a typed post-meta contract and \`--meta-path\` to choose its default top-level field.
-  \`add rest-resource\` scaffolds plugin-level TypeScript REST contracts under \`src/rest/\` and PHP route glue under \`inc/rest/\`.
-  \`add rest-resource --manual\` tracks an external/provider REST route with typed schemas, OpenAPI, clients, and drift checks without generating PHP route/controller files while still allowing route-owner metadata such as permission callbacks and controller classes. Settings contracts can add \`--secret-field\` plus \`--secret-preserve-on-empty\` to model write-only credentials and preserve blank submissions.
-  \`add post-meta\` scaffolds typed post meta contracts under \`src/post-meta/\`, emits schema artifacts, and wires generated \`register_post_meta()\` helpers under \`inc/post-meta/\`.
-  \`add ability\` scaffolds typed workflow abilities under \`src/abilities/\` and server registration under \`inc/abilities/\`.
-  \`add ai-feature\` scaffolds server-owned AI feature endpoints under \`src/ai-features/\` and PHP route glue under \`inc/ai-features/\`.
-  \`add editor-plugin\` scaffolds a document-level editor extension under \`src/editor-plugins/\`; legacy aliases \`PluginSidebar\` and \`PluginDocumentSettingPanel\` resolve to \`sidebar\` and \`document-setting-panel\`.
-  \`add hooked-block\` patches an existing workspace block's \`block.json\` \`blockHooks\` metadata.
-  \`wp-typia doctor\` always checks environment readiness and reports when it only ran environment-level diagnostics; official workspace roots also get inventory, source-tree drift, shared convention checks, and iframe/API v3 compatibility checks.
-  \`wp-typia init\` previews or applies the minimum sync/doctor/migration adoption layer for supported existing layouts; pass \`--package-manager <id>\` to pin emitted scripts and next steps.
-  \`wp-typia migrate doctor --all\` checks migration target alignment, snapshots, fixtures, and generated migration artifacts.
-  \`migrate\` is the canonical migration command; \`migrations\` is no longer supported.`;
-}
+export * from "./cli/cli-help.js";

package/dist/runtime/cli-init-apply.d.ts

@@ -1,15 +1 @@
-import { type RetrofitInitPlan } from "./cli-init-types.js";
-/**
- * Apply the previewed retrofit init plan to disk.
- *
- * The command snapshots package.json and generated helper targets before
- * writing, then rolls those files back automatically if any write fails.
- *
- * @param projectDir Project root that should receive the retrofit surface.
- * @param options Optional package-manager override used for emitted scripts and
- * follow-up guidance.
- * @returns The applied retrofit init plan describing the persisted changes.
- */
-export declare function applyInitPlan(projectDir: string, options?: {
-    packageManager?: string;
-}): Promise<RetrofitInitPlan>;
+export * from "./cli/cli-init-apply.js";

package/dist/runtime/cli-init-apply.js

@@ -1,99 +1 @@
-import fs from "node:fs";
-import { promises as fsp } from "node:fs";
-import path from "node:path";
-import { CLI_DIAGNOSTIC_CODES, createCliDiagnosticCodeError, } from "./cli-diagnostics.js";
-import { rollbackWorkspaceMutation, snapshotWorkspaceFiles, } from "./cli-add-shared.js";
-import { buildNextProjectPackageJson, buildProjectPackageJsonSource, readProjectPackageJson, } from "./cli-init-package-json.js";
-import { createRetrofitPlan, getInitPlan } from "./cli-init-plan.js";
-import { buildRetrofitHelperFiles } from "./cli-init-templates.js";
-import { RETROFIT_APPLY_PREVIEW_NOTE, RETROFIT_ROLLBACK_NOTE, } from "./cli-init-types.js";
-async function createRetrofitMutationSnapshot(projectDir, filePaths) {
-    const scriptsDir = path.join(projectDir, "scripts");
-    const scriptsDirExisted = fs.existsSync(scriptsDir);
-    const fileSources = await snapshotWorkspaceFiles(filePaths);
-    const targetPaths = fileSources
-        .filter((entry) => entry.source === null)
-        .map((entry) => entry.filePath);
-    if (!scriptsDirExisted) {
-        targetPaths.push(scriptsDir);
-    }
-    return {
-        fileSources,
-        snapshotDirs: [],
-        targetPaths,
-    };
-}
-async function writeRetrofitFiles(options) {
-    const helperFiles = buildRetrofitHelperFiles(options.blockTargets);
-    const scriptsDir = path.join(options.projectDir, "scripts");
-    await fsp.mkdir(scriptsDir, { recursive: true });
-    await fsp.writeFile(path.join(options.projectDir, "package.json"), buildProjectPackageJsonSource(options.packageJson), "utf8");
-    for (const [relativePath, source] of Object.entries(helperFiles)) {
-        await fsp.writeFile(path.join(options.projectDir, relativePath), source, "utf8");
-    }
-}
-function buildApplyFailureError(error) {
-    const message = error instanceof Error ? error.message : String(error);
-    return createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.INVALID_ARGUMENT, `Unable to apply the retrofit init plan safely. The command restored the previous package.json/helper-file snapshot. ${message}`, error instanceof Error ? { cause: error } : undefined);
-}
-function toApplyNotes(previewNotes) {
-    return Array.from(new Set([
-        ...previewNotes.filter((note) => note !== "Preview only: `wp-typia init` does not write files yet." &&
-            note !== RETROFIT_APPLY_PREVIEW_NOTE),
-        RETROFIT_ROLLBACK_NOTE,
-    ]));
-}
-/**
- * Apply the previewed retrofit init plan to disk.
- *
- * The command snapshots package.json and generated helper targets before
- * writing, then rolls those files back automatically if any write fails.
- *
- * @param projectDir Project root that should receive the retrofit surface.
- * @param options Optional package-manager override used for emitted scripts and
- * follow-up guidance.
- * @returns The applied retrofit init plan describing the persisted changes.
- */
-export async function applyInitPlan(projectDir, options = {}) {
-    const previewPlan = getInitPlan(projectDir, options);
-    if (previewPlan.detectedLayout.kind === "unsupported") {
-        throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.INVALID_ARGUMENT, "`wp-typia init --apply` requires a supported retrofit layout. Run `wp-typia init` first to inspect the preview plan and any blocking notes.");
-    }
-    if (previewPlan.status === "already-initialized") {
-        return createRetrofitPlan({
-            ...previewPlan,
-            commandMode: "apply",
-            notes: toApplyNotes(previewPlan.notes),
-            status: "already-initialized",
-        });
-    }
-    const nextPackageJson = buildNextProjectPackageJson({
-        packageChanges: previewPlan.packageChanges,
-        packageJson: readProjectPackageJson(previewPlan.projectDir),
-        packageManager: previewPlan.packageManager,
-        projectName: previewPlan.projectName,
-    });
-    const helperFiles = buildRetrofitHelperFiles(previewPlan.blockTargets);
-    const filePaths = [
-        path.join(previewPlan.projectDir, "package.json"),
-        ...Object.keys(helperFiles).map((relativePath) => path.join(previewPlan.projectDir, relativePath)),
-    ];
-    const mutationSnapshot = await createRetrofitMutationSnapshot(previewPlan.projectDir, filePaths);
-    try {
-        await writeRetrofitFiles({
-            blockTargets: previewPlan.blockTargets,
-            packageJson: nextPackageJson,
-            projectDir: previewPlan.projectDir,
-        });
-    }
-    catch (error) {
-        await rollbackWorkspaceMutation(mutationSnapshot);
-        throw buildApplyFailureError(error);
-    }
-    return createRetrofitPlan({
-        ...previewPlan,
-        commandMode: "apply",
-        notes: toApplyNotes(previewPlan.notes),
-        status: "applied",
-    });
-}
+export * from "./cli/cli-init-apply.js";

package/dist/runtime/cli-init-package-json.d.ts

@@ -1,19 +1 @@
-import { type PackageManagerId } from "./package-managers.js";
-import type { InitDependencyChange, InitPackageManagerFieldChange, InitScriptChange, ProjectPackageJson, RetrofitInitPlan } from "./cli-init-types.js";
-export declare function readProjectPackageJson(projectDir: string): ProjectPackageJson | null;
-export declare function resolveInitPackageManager(projectDir: string, packageJson: ProjectPackageJson | null, override?: string): PackageManagerId;
-export declare function getWpTypiaCliSpecifier(): string;
-export declare function buildDependencyChanges(packageJson: ProjectPackageJson | null): InitDependencyChange[];
-export declare function buildScriptChanges(packageJson: ProjectPackageJson | null, packageManager: PackageManagerId): InitScriptChange[];
-export declare function buildPackageManagerFieldChange(packageJson: ProjectPackageJson | null, packageManager: PackageManagerId, options?: {
-    persistExplicitOverride?: boolean;
-}): InitPackageManagerFieldChange | undefined;
-export declare function hasExistingWpTypiaProjectSurface(projectDir: string, packageJson: ProjectPackageJson | null): boolean;
-export declare function buildRequiredDevDependencyMapEntries(): string[];
-export declare function buildNextProjectPackageJson(options: {
-    packageChanges: RetrofitInitPlan["packageChanges"];
-    packageJson: ProjectPackageJson | null;
-    packageManager: PackageManagerId;
-    projectName: string;
-}): ProjectPackageJson;
-export declare function buildProjectPackageJsonSource(packageJson: ProjectPackageJson): string;
+export * from "./cli/cli-init-package-json.js";

package/dist/runtime/cli-init-package-json.js

@@ -1,193 +1 @@
-import fs from "node:fs";
-import path from "node:path";
-import { CLI_DIAGNOSTIC_CODES, createCliDiagnosticCodeError, } from "./cli-diagnostics.js";
-import { getPackageManager, transformPackageManagerText, } from "./package-managers.js";
-import { getPackageVersions } from "./package-versions.js";
-import { readJsonFileSync } from "./json-utils.js";
-import { parseWorkspacePackageManagerId } from "./workspace-project.js";
-const BASE_RETROFIT_SCRIPTS = {
-    sync: "tsx scripts/sync-project.ts",
-    "sync-types": "tsx scripts/sync-types-to-block-json.ts",
-    typecheck: "bun run sync --check && tsc --noEmit",
-};
-const BASE_RETROFIT_DEV_DEPENDENCIES = [
-    "@typia/unplugin",
-    "@wp-typia/block-runtime",
-    "@wp-typia/block-types",
-    "tsx",
-    "typescript",
-    "typia",
-];
-export function readProjectPackageJson(projectDir) {
-    const packageJsonPath = path.join(projectDir, "package.json");
-    if (!fs.existsSync(packageJsonPath)) {
-        return null;
-    }
-    try {
-        return readJsonFileSync(packageJsonPath, {
-            context: "project package manifest",
-        });
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.INVALID_ARGUMENT, `Unable to parse ${packageJsonPath}: ${message}`, error instanceof Error ? { cause: error } : undefined);
-    }
-}
-function inferInitPackageManager(projectDir, packageJson) {
-    if (packageJson?.packageManager) {
-        return parseWorkspacePackageManagerId(packageJson.packageManager);
-    }
-    if (fs.existsSync(path.join(projectDir, "bun.lock")) ||
-        fs.existsSync(path.join(projectDir, "bun.lockb"))) {
-        return "bun";
-    }
-    if (fs.existsSync(path.join(projectDir, "pnpm-lock.yaml"))) {
-        return "pnpm";
-    }
-    if (fs.existsSync(path.join(projectDir, "yarn.lock")) ||
-        fs.existsSync(path.join(projectDir, ".yarnrc.yml"))) {
-        return "yarn";
-    }
-    return "npm";
-}
-export function resolveInitPackageManager(projectDir, packageJson, override) {
-    if (!override) {
-        return inferInitPackageManager(projectDir, packageJson);
-    }
-    if (override !== "bun" &&
-        override !== "npm" &&
-        override !== "pnpm" &&
-        override !== "yarn") {
-        throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.INVALID_ARGUMENT, `Unknown package manager "${override}". Expected one of: bun, npm, pnpm, yarn.`);
-    }
-    return override;
-}
-export function getWpTypiaCliSpecifier() {
-    const versions = getPackageVersions();
-    return versions.wpTypiaPackageExactVersion === "0.0.0"
-        ? "wp-typia"
-        : `wp-typia@${versions.wpTypiaPackageExactVersion}`;
-}
-function buildRequiredDevDependencyMap() {
-    const versions = getPackageVersions();
-    return {
-        "@typia/unplugin": versions.typiaUnpluginPackageVersion,
-        "@wp-typia/block-runtime": versions.blockRuntimePackageVersion,
-        "@wp-typia/block-types": versions.blockTypesPackageVersion,
-        tsx: versions.tsxPackageVersion,
-        typescript: versions.typescriptPackageVersion,
-        typia: versions.typiaPackageVersion,
-    };
-}
-function getExistingDependencyVersion(packageJson, name) {
-    return packageJson?.devDependencies?.[name] ?? packageJson?.dependencies?.[name];
-}
-export function buildDependencyChanges(packageJson) {
-    const requiredDependencies = buildRequiredDevDependencyMap();
-    return BASE_RETROFIT_DEV_DEPENDENCIES.flatMap((name) => {
-        const requiredValue = requiredDependencies[name];
-        const currentValue = getExistingDependencyVersion(packageJson, name);
-        if (currentValue === requiredValue) {
-            return [];
-        }
-        return [
-            {
-                action: currentValue ? "update" : "add",
-                ...(currentValue ? { currentValue } : {}),
-                name,
-                requiredValue,
-            },
-        ];
-    });
-}
-export function buildScriptChanges(packageJson, packageManager) {
-    const scripts = packageJson?.scripts ?? {};
-    return Object.entries(BASE_RETROFIT_SCRIPTS).flatMap(([name, commandSource]) => {
-        const requiredValue = transformPackageManagerText(commandSource, packageManager);
-        const currentValue = scripts[name];
-        if (currentValue === requiredValue) {
-            return [];
-        }
-        return [
-            {
-                action: typeof currentValue === "string" ? "update" : "add",
-                ...(typeof currentValue === "string" ? { currentValue } : {}),
-                name,
-                requiredValue,
-            },
-        ];
-    });
-}
-export function buildPackageManagerFieldChange(packageJson, packageManager, options = {}) {
-    if (!options.persistExplicitOverride && packageManager === "npm") {
-        return undefined;
-    }
-    const requiredValue = getPackageManager(packageManager).packageManagerField;
-    const currentValue = packageJson?.packageManager;
-    if (currentValue === requiredValue) {
-        return undefined;
-    }
-    return {
-        action: typeof currentValue === "string" ? "update" : "add",
-        ...(typeof currentValue === "string" ? { currentValue } : {}),
-        requiredValue,
-    };
-}
-export function hasExistingWpTypiaProjectSurface(projectDir, packageJson) {
-    const scripts = packageJson?.scripts ?? {};
-    const hasSyncSurface = typeof scripts.sync === "string" || typeof scripts["sync-types"] === "string";
-    const hasHelperFiles = [
-        path.join("scripts", "block-config.ts"),
-        path.join("scripts", "sync-project.ts"),
-        path.join("scripts", "sync-types-to-block-json.ts"),
-    ].every((relativePath) => fs.existsSync(path.join(projectDir, relativePath)));
-    const hasRuntimeDeps = typeof getExistingDependencyVersion(packageJson, "@wp-typia/block-runtime") ===
-        "string" &&
-        typeof getExistingDependencyVersion(packageJson, "@wp-typia/block-types") ===
-            "string";
-    return hasSyncSurface && hasHelperFiles && hasRuntimeDeps;
-}
-export function buildRequiredDevDependencyMapEntries() {
-    return Object.entries(buildRequiredDevDependencyMap()).map(([name, version]) => `${name}@${version.replace(/^workspace:/u, "")}`);
-}
-function setDependencyVersion(packageJson, name, requiredValue) {
-    if (packageJson.devDependencies?.[name] !== undefined) {
-        packageJson.devDependencies[name] = requiredValue;
-        return;
-    }
-    if (packageJson.dependencies?.[name] !== undefined) {
-        packageJson.dependencies[name] = requiredValue;
-        return;
-    }
-    packageJson.devDependencies ?? (packageJson.devDependencies = {});
-    packageJson.devDependencies[name] = requiredValue;
-}
-export function buildNextProjectPackageJson(options) {
-    const nextPackageJson = options.packageJson
-        ? JSON.parse(JSON.stringify(options.packageJson))
-        : {
-            name: options.projectName,
-            private: true,
-        };
-    nextPackageJson.devDependencies ?? (nextPackageJson.devDependencies = {});
-    nextPackageJson.scripts ?? (nextPackageJson.scripts = {});
-    for (const dependencyChange of options.packageChanges.addDevDependencies) {
-        setDependencyVersion(nextPackageJson, dependencyChange.name, dependencyChange.requiredValue);
-    }
-    if (options.packageChanges.packageManagerField) {
-        nextPackageJson.packageManager =
-            options.packageChanges.packageManagerField.requiredValue;
-    }
-    else if (!nextPackageJson.packageManager &&
-        options.packageManager !== "npm") {
-        nextPackageJson.packageManager =
-            getPackageManager(options.packageManager).packageManagerField;
-    }
-    for (const scriptChange of options.packageChanges.scripts) {
-        nextPackageJson.scripts[scriptChange.name] = scriptChange.requiredValue;
-    }
-    return nextPackageJson;
-}
-export function buildProjectPackageJsonSource(packageJson) {
-    return `${JSON.stringify(packageJson, null, 2)}\n`;
-}
+export * from "./cli/cli-init-package-json.js";

package/dist/runtime/cli-init-plan-presentation.d.ts

@@ -1,16 +1 @@
-import { type PackageManagerId } from "./package-managers.js";
-import type { InitCommandMode, InitPlanLayoutKind, InitPlanStatus, RetrofitInitPlan } from "./cli-init-types.js";
-export declare function buildInitPlanChangeSummary(changes: Pick<RetrofitInitPlan, "generatedArtifacts" | "packageChanges" | "plannedFiles">, options: {
-    includeGeneratedArtifacts: boolean;
-}): string[];
-export declare function buildInitPlanNextSteps(options: {
-    commandMode: InitCommandMode;
-    dependencyChangeCount: number;
-    hasPlannedChanges: boolean;
-    layoutKind: InitPlanLayoutKind;
-    packageManager: PackageManagerId;
-}): string[];
-export declare function buildRetrofitPlanSummary(options: {
-    commandMode: InitCommandMode;
-    status: InitPlanStatus;
-}): string;
+export * from "./cli/cli-init-plan-presentation.js";

package/dist/runtime/cli-init-plan-presentation.js

@@ -1,74 +1 @@
-import { formatAddDevDependenciesCommand, formatPackageExecCommand, formatRunScript, } from "./package-managers.js";
-import { buildRequiredDevDependencyMapEntries, getWpTypiaCliSpecifier, } from "./cli-init-package-json.js";
-export function buildInitPlanChangeSummary(changes, options) {
-    const lines = [];
-    for (const dependencyChange of changes.packageChanges.addDevDependencies) {
-        lines.push(`devDependency ${dependencyChange.action} ${dependencyChange.name} -> ${dependencyChange.requiredValue}`);
-    }
-    if (changes.packageChanges.packageManagerField) {
-        lines.push(`packageManager ${changes.packageChanges.packageManagerField.action} -> ${changes.packageChanges.packageManagerField.requiredValue}`);
-    }
-    for (const scriptChange of changes.packageChanges.scripts) {
-        lines.push(`script ${scriptChange.action} ${scriptChange.name} -> ${scriptChange.requiredValue}`);
-    }
-    for (const filePlan of changes.plannedFiles) {
-        lines.push(`file ${filePlan.action} ${filePlan.path} (${filePlan.purpose})`);
-    }
-    if (options.includeGeneratedArtifacts) {
-        for (const artifactPath of changes.generatedArtifacts) {
-            lines.push(`generated artifact ${artifactPath}`);
-        }
-    }
-    return lines;
-}
-export function buildInitPlanNextSteps(options) {
-    const cliSpecifier = getWpTypiaCliSpecifier();
-    const syncTypesRun = formatRunScript(options.packageManager, "sync-types");
-    const syncRun = formatRunScript(options.packageManager, "sync");
-    const doctorRun = formatPackageExecCommand(options.packageManager, cliSpecifier, "doctor");
-    const migrationInitRun = formatPackageExecCommand(options.packageManager, cliSpecifier, "migrate init --current-migration-version v1");
-    const dependencyInstallCommand = formatAddDevDependenciesCommand(options.packageManager, buildRequiredDevDependencyMapEntries());
-    if (options.layoutKind === "unsupported") {
-        return [
-            "Align the project to one of the supported retrofit layouts listed below, then rerun `wp-typia init`.",
-            dependencyInstallCommand,
-            syncTypesRun,
-            doctorRun,
-        ];
-    }
-    if (options.commandMode === "apply") {
-        return [
-            ...(options.dependencyChangeCount > 0
-                ? [
-                    "Install or reinstall project dependencies so the retrofit sync scripts and metadata generators are available locally.",
-                    dependencyInstallCommand,
-                ]
-                : []),
-            syncRun,
-            doctorRun,
-            `Optional migration bootstrap: ${migrationInitRun}`,
-        ];
-    }
-    return [
-        ...(options.hasPlannedChanges
-            ? [
-                "Re-run `wp-typia init --apply` to write the planned package.json changes and helper files automatically.",
-                ...(options.dependencyChangeCount > 0 ? [dependencyInstallCommand] : []),
-            ]
-            : []),
-        syncRun,
-        doctorRun,
-        `Optional migration bootstrap: ${migrationInitRun}`,
-    ];
-}
-export function buildRetrofitPlanSummary(options) {
-    if (options.status === "already-initialized") {
-        return options.commandMode === "apply"
-            ? "This project already exposes the minimum wp-typia retrofit surface. No files were changed."
-            : "This project already exposes the minimum wp-typia retrofit surface.";
-    }
-    if (options.commandMode === "apply") {
-        return "Applied the minimum wp-typia retrofit surface so package.json and helper scripts are ready for the next install and sync run.";
-    }
-    return "This command previews the minimum wp-typia adoption layer for the current project without rewriting it into a full scaffold.";
-}
+export * from "./cli/cli-init-plan-presentation.js";

package/dist/runtime/cli-init-plan.d.ts

@@ -1,39 +1 @@
-import { type PackageManagerId } from "./package-managers.js";
-import { type InitCommandMode, type InitFilePlan, type InitPlanLayoutKind, type InitPlanStatus, type RetrofitInitBlockTarget, type RetrofitInitPlan } from "./cli-init-types.js";
-export declare function buildInitLayoutDetails(projectDir: string): {
-    blockNames: string[];
-    blockTargets: RetrofitInitBlockTarget[];
-    description: string;
-    generatedArtifacts: string[];
-    kind: InitPlanLayoutKind;
-    notes: string[];
-};
-export declare function createRetrofitPlan(options: {
-    commandMode: InitCommandMode;
-    detectedLayout: {
-        blockNames: string[];
-        description: string;
-        kind: InitPlanLayoutKind;
-    };
-    blockTargets: RetrofitInitBlockTarget[];
-    generatedArtifacts: string[];
-    nextSteps?: string[];
-    notes: string[];
-    packageChanges: RetrofitInitPlan["packageChanges"];
-    packageManager: PackageManagerId;
-    plannedFiles: InitFilePlan[];
-    projectDir: string;
-    projectName: string;
-    status: InitPlanStatus;
-}): RetrofitInitPlan;
-/**
- * Inspect one project directory and return the current retrofit init plan.
- *
- * @param projectDir Project root or nested path that should be analyzed.
- * @param options Optional package-manager override used for emitted scripts and
- * follow-up guidance.
- * @returns The preview-only retrofit init plan for the resolved project.
- */
-export declare function getInitPlan(projectDir: string, options?: {
-    packageManager?: string;
-}): RetrofitInitPlan;
+export * from "./cli/cli-init-plan.js";