@wp-typia/project-tools 0.20.1 → 0.21.0

package/dist/runtime/cli-doctor.d.ts

@@ -2,12 +2,14 @@
  * One doctor check rendered by the CLI diagnostics flow.
  */
 export interface DoctorCheck {
+    /** Stable machine-readable diagnostic id for structured integrations. */
+    code?: string;
     /** Human-readable status detail rendered next to the label. */
     detail: string;
     /** Short label for the dependency, directory, or template check. */
     label: string;
-    /** Final pass/fail status for this diagnostic row. */
-    status: "pass" | "fail";
+    /** Final pass/fail/warn status for this diagnostic row. */
+    status: "pass" | "fail" | "warn";
 }
 interface RunDoctorOptions {
     renderLine?: (check: DoctorCheck) => void;

package/dist/runtime/cli-doctor.js

@@ -1,4 +1,4 @@
-import { createCliCommandError, formatDoctorCheckLine, formatDoctorSummaryLine, getDoctorFailureDetailLines, } from "./cli-diagnostics.js";
+import { CLI_DIAGNOSTIC_CODES, createCliCommandError, formatDoctorCheckLine, formatDoctorSummaryLine, getDoctorFailureDetailLines, } from "./cli-diagnostics.js";
 import { getEnvironmentDoctorChecks } from "./cli-doctor-environment.js";
 import { getWorkspaceDoctorChecks } from "./cli-doctor-workspace.js";
 /**
@@ -38,6 +38,7 @@ export async function runDoctor(cwd, options = {}) {
     const failureDetailLines = getDoctorFailureDetailLines(checks);
     if (failureDetailLines.length > 0) {
         throw createCliCommandError({
+            code: CLI_DIAGNOSTIC_CODES.DOCTOR_CHECK_FAILED,
             command: "doctor",
             detailLines: failureDetailLines,
             summary: "One or more doctor checks failed.",

package/dist/runtime/cli-help.js

@@ -17,15 +17,18 @@ export function formatHelpText() {
   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]
-  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 init [project-dir] [--apply] [--package-manager <id>]
+  wp-typia add admin-view <name> [--source <rest-resource:slug>]
+  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 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>
-  wp-typia add binding-source <name>
+  wp-typia add binding-source <name> [--block <block-slug|namespace/block-slug> --attribute <attribute>]
   wp-typia add rest-resource <name> [--namespace <vendor/v1>] [--methods <method[,method...]>]
   wp-typia add ability <name>
   wp-typia add ai-feature <name> [--namespace <vendor/v1>]
-  wp-typia add editor-plugin <name> [--slot <PluginSidebar>]
+  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
@@ -37,22 +40,29 @@ export function formatHelpText() {
 
 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\` is a preview-only retrofit planner for existing projects. It does not write files yet.
+  \`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 ...\`.
+  Interactive add flows let you choose a template when \`--template\` is omitted; non-interactive runs default to \`basic\`.
+  \`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.
   \`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/\`.
-  \`add binding-source\` scaffolds shared PHP and editor registration under \`src/bindings/\`.
+  \`add binding-source\` scaffolds shared PHP and editor registration under \`src/bindings/\`; pass \`--block\` and \`--attribute\` together to declare a bindable generated-block attribute.
   \`add rest-resource\` scaffolds plugin-level TypeScript REST contracts under \`src/rest/\` and PHP route glue under \`inc/rest/\`.
   \`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/\`.
+  \`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 and source-tree drift checks.
-  \`wp-typia init\` previews the minimum sync/doctor/migration adoption layer for supported existing layouts before a future write mode exists.
+  \`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.`;
 }

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

@@ -1,6 +1,7 @@
 import { type PackageManagerId } from "./package-managers.js";
+type InitCommandMode = "apply" | "preview-only";
 type InitPlanAction = "add" | "update";
-type InitPlanStatus = "already-initialized" | "preview";
+type InitPlanStatus = "already-initialized" | "applied" | "preview";
 type InitPlanLayoutKind = "generated-project" | "multi-block" | "official-workspace" | "single-block" | "unsupported";
 interface InitDependencyChange {
     action: InitPlanAction;
@@ -20,11 +21,37 @@ interface InitPackageManagerFieldChange {
     requiredValue: string;
 }
 interface InitFilePlan {
+    action: InitPlanAction;
     path: string;
     purpose: string;
 }
+/**
+ * One existing block target that `wp-typia init` can retrofit into the shared
+ * sync surface.
+ *
+ * Each path stays relative to the project root so generated helper scripts can
+ * resolve the current block metadata and TypeScript source of truth without
+ * guessing layout-specific locations.
+ */
+export interface RetrofitInitBlockTarget {
+    attributeTypeName: string;
+    blockJsonFile: string;
+    blockName: string;
+    manifestFile: string;
+    saveFile: string;
+    slug: string;
+    typesFile: string;
+}
+/**
+ * Preview or apply result returned by `wp-typia init`.
+ *
+ * The plan describes the detected retrofit layout, package-level mutations,
+ * helper files, next steps, and any warnings gathered while preparing or
+ * applying the minimum sync surface for an existing project.
+ */
 export interface RetrofitInitPlan {
-    commandMode: "preview-only";
+    blockTargets: RetrofitInitBlockTarget[];
+    commandMode: InitCommandMode;
     detectedLayout: {
         blockNames: string[];
         description: string;
@@ -45,5 +72,42 @@ export interface RetrofitInitPlan {
     status: InitPlanStatus;
     summary: string;
 }
-export declare function getInitPlan(projectDir: string): 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;
+/**
+ * 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>;
+/**
+ * Execute `wp-typia init` in preview or apply mode.
+ *
+ * @param options Resolved command options including the target project
+ * directory, optional package-manager override, and whether writes should be
+ * applied.
+ * @returns The previewed or applied retrofit init plan.
+ */
+export declare function runInitCommand(options: {
+    apply?: boolean;
+    packageManager?: string;
+    projectDir: string;
+}): Promise<RetrofitInitPlan>;
 export {};