@wp-typia/project-tools 0.22.4 → 0.22.6

package/dist/runtime/cli-add-workspace-ability-scaffold.js

@@ -10,7 +10,7 @@ import { getWorkspaceBootstrapPath, patchFile, } from "./cli-add-shared.js";
 import { appendPhpSnippetBeforeClosingTag, executeWorkspaceMutationPlan, insertPhpSnippetBeforeWorkspaceAnchors, } from "./cli-add-workspace-mutation.js";
 import { updatePluginHeaderCompatibility, } from "./scaffold-compatibility.js";
 import { DEFAULT_WORDPRESS_ABILITIES_VERSION, DEFAULT_WORDPRESS_CORE_ABILITIES_VERSION, } from "./package-versions.js";
-import { escapeRegex, findPhpFunctionRange, hasPhpFunctionDefinition, replacePhpFunctionDefinition, } from "./php-utils.js";
+import { escapeRegex, findPhpFunctionRange, hasPhpFunctionCall, hasPhpFunctionDefinition, replacePhpFunctionDefinition, } from "./php-utils.js";
 import { toPascalCase } from "./string-case.js";
 function resolveManagedDependencyVersion(existingVersion, requiredVersion) {
     if (!existingVersion) {
@@ -130,9 +130,18 @@ function ${enqueueFunctionName}() {
         if (!hasPhpFunctionDefinition(nextSource, enqueueFunctionName)) {
             nextSource = insertPhpSnippetBeforeWorkspaceAnchors(nextSource, enqueueFunction);
         }
-        else if (!findPhpFunctionRange(nextSource, enqueueFunctionName)?.source.includes("wp_enqueue_script_module")) {
-            nextSource =
-                replacePhpFunctionDefinition(nextSource, enqueueFunctionName, enqueueFunction, { trimReplacementStart: true }) ?? nextSource;
+        else {
+            const functionRange = findPhpFunctionRange(nextSource, enqueueFunctionName);
+            const functionSource = functionRange
+                ? nextSource.slice(functionRange.start, functionRange.end)
+                : "";
+            if (!hasPhpFunctionCall(functionSource, "wp_enqueue_script_module")) {
+                const replacedSource = replacePhpFunctionDefinition(nextSource, enqueueFunctionName, enqueueFunction, { trimReplacementStart: true });
+                if (!replacedSource) {
+                    throw new Error(`Unable to repair ${path.basename(bootstrapPath)} for ${enqueueFunctionName}.`);
+                }
+                nextSource = replacedSource;
+            }
         }
         if (!nextSource.includes(loadHook)) {
             nextSource = appendPhpSnippetBeforeClosingTag(nextSource, loadHook);
@@ -301,6 +310,7 @@ async function ensureAbilityWebpackAnchors(workspace) {
  * Write generated workflow ability sources and patch shared workspace anchors.
  */
 export async function scaffoldAbilityWorkspace({ abilitySlug, compatibilityPolicy, workspace, }) {
+    const compatibilityWarnings = [];
     const blockConfigPath = path.join(workspace.projectDir, "scripts", "block-config.ts");
     const bootstrapPath = getWorkspaceBootstrapPath(workspace);
     const buildScriptPath = path.join(workspace.projectDir, "scripts", "build-workspace.mjs");
@@ -331,7 +341,11 @@ export async function scaffoldAbilityWorkspace({ abilitySlug, compatibilityPolic
             await fsp.mkdir(abilityDir, { recursive: true });
             await fsp.mkdir(path.dirname(phpFilePath), { recursive: true });
             await ensureAbilityBootstrapAnchors(workspace);
-            await patchFile(bootstrapPath, (source) => updatePluginHeaderCompatibility(source, compatibilityPolicy));
+            await patchFile(bootstrapPath, (source) => updatePluginHeaderCompatibility(source, compatibilityPolicy, {
+                onWarning: (warning) => {
+                    compatibilityWarnings.push(warning);
+                },
+            }));
             await ensureAbilityPackageScripts(workspace);
             await ensureAbilitySyncProjectAnchors(workspace);
             await ensureAbilityBuildScriptAnchors(workspace);
@@ -363,4 +377,7 @@ export async function scaffoldAbilityWorkspace({ abilitySlug, compatibilityPolic
             });
         },
     });
+    return {
+        warnings: compatibilityWarnings,
+    };
 }

package/dist/runtime/cli-add-workspace-ability.d.ts

@@ -1,8 +1,12 @@
 import { type RunAddAbilityCommandOptions } from "./cli-add-shared.js";
 /**
  * Add one typed workflow ability scaffold to an official workspace project.
+ *
+ * @returns Generated ability metadata plus non-fatal scaffold warnings, such
+ * as repaired malformed existing plugin header floor values.
  */
 export declare function runAddAbilityCommand({ abilityName, cwd, }: RunAddAbilityCommandOptions): Promise<{
     abilitySlug: string;
     projectDir: string;
+    warnings: string[];
 }>;

package/dist/runtime/cli-add-workspace-ability.js

@@ -5,6 +5,9 @@ import { resolveWorkspaceProject } from "./workspace-project.js";
 import { REQUIRED_WORKSPACE_ABILITY_COMPATIBILITY, resolveScaffoldCompatibilityPolicy, } from "./scaffold-compatibility.js";
 /**
  * Add one typed workflow ability scaffold to an official workspace project.
+ *
+ * @returns Generated ability metadata plus non-fatal scaffold warnings, such
+ * as repaired malformed existing plugin header floor values.
  */
 export async function runAddAbilityCommand({ abilityName, cwd = process.cwd(), }) {
     const workspace = resolveWorkspaceProject(cwd);
@@ -12,7 +15,7 @@ export async function runAddAbilityCommand({ abilityName, cwd = process.cwd(), }
     const inventory = readWorkspaceInventory(workspace.projectDir);
     assertAbilityDoesNotExist(workspace.projectDir, abilitySlug, inventory);
     const compatibilityPolicy = resolveScaffoldCompatibilityPolicy(REQUIRED_WORKSPACE_ABILITY_COMPATIBILITY);
-    await scaffoldAbilityWorkspace({
+    const scaffoldResult = await scaffoldAbilityWorkspace({
         abilitySlug,
         compatibilityPolicy,
         workspace,
@@ -20,5 +23,6 @@ export async function runAddAbilityCommand({ abilityName, cwd = process.cwd(), }
     return {
         abilitySlug,
         projectDir: workspace.projectDir,
+        warnings: scaffoldResult.warnings,
     };
 }

package/dist/runtime/cli-add-workspace-admin-view-source.d.ts

@@ -1,4 +1,11 @@
 import { type AdminViewRestResource, type AdminViewSource } from './cli-add-workspace-admin-view-types.js';
+/**
+ * Assert that admin-view package dependencies are available before file writes.
+ *
+ * This is a no-op while `@wp-typia/dataviews` is publicly available on npm.
+ * The exported seam is retained so future availability checks can stay
+ * centralized ahead of scaffold mutations.
+ */
 export declare function assertAdminViewPackageAvailability(): void;
 export declare function parseAdminViewSource(source?: string): AdminViewSource | undefined;
 export declare function resolveRestResourceSource(restResources: AdminViewRestResource[], source: AdminViewSource | undefined): AdminViewRestResource | undefined;

package/dist/runtime/cli-add-workspace-admin-view-source.js

@@ -1,15 +1,14 @@
 import { assertValidGeneratedSlug } from './cli-add-shared.js';
-import { CLI_DIAGNOSTIC_CODES, createCliDiagnosticCodeError, } from './cli-diagnostics.js';
-import { ADMIN_VIEW_ALLOW_UNPUBLISHED_DATAVIEWS_ENV, ADMIN_VIEW_CORE_DATA_ENTITY_KIND_IDS, ADMIN_VIEW_CORE_DATA_ENTITY_NAME_PATTERN, ADMIN_VIEW_CORE_DATA_ENTITY_SEGMENT_PATTERN, ADMIN_VIEW_CORE_DATA_SOURCE_KIND, ADMIN_VIEW_PUBLIC_INSTALLS_ENABLED, ADMIN_VIEW_REST_SOURCE_KIND, ADMIN_VIEW_SOURCE_USAGE, isAdminViewCoreDataSource, isAdminViewRestResourceSource, } from './cli-add-workspace-admin-view-types.js';
-function isAdminViewUnpublishedDataViewsOverrideEnabled() {
-    return (process.env[ADMIN_VIEW_ALLOW_UNPUBLISHED_DATAVIEWS_ENV]?.trim() === '1');
-}
+import { ADMIN_VIEW_CORE_DATA_ENTITY_KIND_IDS, ADMIN_VIEW_CORE_DATA_ENTITY_NAME_PATTERN, ADMIN_VIEW_CORE_DATA_ENTITY_SEGMENT_PATTERN, ADMIN_VIEW_CORE_DATA_SOURCE_KIND, ADMIN_VIEW_REST_SOURCE_KIND, ADMIN_VIEW_SOURCE_USAGE, isAdminViewCoreDataSource, isAdminViewRestResourceSource, } from './cli-add-workspace-admin-view-types.js';
+/**
+ * Assert that admin-view package dependencies are available before file writes.
+ *
+ * This is a no-op while `@wp-typia/dataviews` is publicly available on npm.
+ * The exported seam is retained so future availability checks can stay
+ * centralized ahead of scaffold mutations.
+ */
 export function assertAdminViewPackageAvailability() {
-    if (isAdminViewUnpublishedDataViewsOverrideEnabled() ||
-        ADMIN_VIEW_PUBLIC_INSTALLS_ENABLED) {
-        return;
-    }
-    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.INVALID_ARGUMENT, '`wp-typia add admin-view` is temporarily unavailable because `@wp-typia/dataviews` is not published to npm for public installs yet.');
+    return;
 }
 function assertValidCoreDataEntitySegment(label, value) {
     const trimmed = value.trim();

package/dist/runtime/cli-add-workspace-admin-view-types.d.ts

@@ -10,8 +10,6 @@ export declare const ADMIN_VIEWS_ASSET = "build/admin-views/index.asset.php";
 export declare const ADMIN_VIEWS_STYLE = "build/admin-views/style-index.css";
 export declare const ADMIN_VIEWS_STYLE_RTL = "build/admin-views/style-index-rtl.css";
 export declare const ADMIN_VIEWS_PHP_GLOB = "/inc/admin-views/*.php";
-export declare const ADMIN_VIEW_ALLOW_UNPUBLISHED_DATAVIEWS_ENV = "WP_TYPIA_ALLOW_UNPUBLISHED_DATAVIEWS";
-export declare const ADMIN_VIEW_PUBLIC_INSTALLS_ENABLED = false;
 export interface AdminViewRestResourceSource {
     kind: typeof ADMIN_VIEW_REST_SOURCE_KIND;
     slug: string;

package/dist/runtime/cli-add-workspace-admin-view-types.js

@@ -12,9 +12,6 @@ export const ADMIN_VIEWS_ASSET = 'build/admin-views/index.asset.php';
 export const ADMIN_VIEWS_STYLE = 'build/admin-views/style-index.css';
 export const ADMIN_VIEWS_STYLE_RTL = 'build/admin-views/style-index-rtl.css';
 export const ADMIN_VIEWS_PHP_GLOB = '/inc/admin-views/*.php';
-export const ADMIN_VIEW_ALLOW_UNPUBLISHED_DATAVIEWS_ENV = 'WP_TYPIA_ALLOW_UNPUBLISHED_DATAVIEWS';
-// Lift this gate in the same release that publishes @wp-typia/dataviews.
-export const ADMIN_VIEW_PUBLIC_INSTALLS_ENABLED = false;
 export function isAdminViewCoreDataSource(source) {
     return source?.kind === ADMIN_VIEW_CORE_DATA_SOURCE_KIND;
 }

package/dist/runtime/cli-add-workspace-ai-anchors.js

@@ -2,6 +2,7 @@ import { promises as fsp } from "node:fs";
 import path from "node:path";
 import { getPackageVersions } from "./package-versions.js";
 import { getWorkspaceBootstrapPath, patchFile, } from "./cli-add-shared.js";
+import { appendPhpSnippetBeforeClosingTag, insertPhpSnippetBeforeWorkspaceAnchors, } from "./cli-add-workspace-mutation.js";
 import { hasPhpFunctionDefinition } from "./php-utils.js";
 const AI_FEATURE_SERVER_GLOB = "/inc/ai-features/*.php";
 /**
@@ -21,30 +22,8 @@ function ${registerFunctionName}() {
 \t}
 }
 `;
-        const insertionAnchors = [
-            /add_action\(\s*["']init["']\s*,\s*["'][^"']+_load_textdomain["']\s*\);\s*\n/u,
-            /\?>\s*$/u,
-        ];
-        const insertPhpSnippet = (snippet) => {
-            for (const anchor of insertionAnchors) {
-                const candidate = nextSource.replace(anchor, (match) => `${snippet}\n${match}`);
-                if (candidate !== nextSource) {
-                    nextSource = candidate;
-                    return;
-                }
-            }
-            nextSource = `${nextSource.trimEnd()}\n${snippet}\n`;
-        };
-        const appendPhpSnippet = (snippet) => {
-            const closingTagPattern = /\?>\s*$/u;
-            if (closingTagPattern.test(nextSource)) {
-                nextSource = nextSource.replace(closingTagPattern, `${snippet}\n?>`);
-                return;
-            }
-            nextSource = `${nextSource.trimEnd()}\n${snippet}\n`;
-        };
         if (!hasPhpFunctionDefinition(nextSource, registerFunctionName)) {
-            insertPhpSnippet(registerFunction);
+            nextSource = insertPhpSnippetBeforeWorkspaceAnchors(nextSource, registerFunction);
         }
         else if (!nextSource.includes(AI_FEATURE_SERVER_GLOB)) {
             throw new Error([
@@ -54,7 +33,7 @@ function ${registerFunctionName}() {
             ].join(" "));
         }
         if (!nextSource.includes(registerHook)) {
-            appendPhpSnippet(registerHook);
+            nextSource = appendPhpSnippetBeforeClosingTag(nextSource, registerHook);
         }
         return nextSource;
     });

package/dist/runtime/cli-add-workspace-ai-scaffold.js

@@ -14,6 +14,7 @@ import { syncAiFeatureRestArtifacts, syncAiFeatureSchemaArtifact, } from "./ai-f
  * Write generated AI feature sources and patch shared workspace anchors.
  */
 export async function scaffoldAiFeatureWorkspace({ aiFeatureSlug, compatibilityPolicy, namespace, workspace, }) {
+    const compatibilityWarnings = [];
     const blockConfigPath = path.join(workspace.projectDir, "scripts", "block-config.ts");
     const bootstrapPath = getWorkspaceBootstrapPath(workspace);
     const packageJsonPath = path.join(workspace.projectDir, "package.json");
@@ -40,7 +41,11 @@ export async function scaffoldAiFeatureWorkspace({ aiFeatureSlug, compatibilityP
             await fsp.mkdir(aiFeatureDir, { recursive: true });
             await fsp.mkdir(path.dirname(phpFilePath), { recursive: true });
             await ensureAiFeatureBootstrapAnchors(workspace);
-            await patchFile(bootstrapPath, (source) => updatePluginHeaderCompatibility(source, compatibilityPolicy));
+            await patchFile(bootstrapPath, (source) => updatePluginHeaderCompatibility(source, compatibilityPolicy, {
+                onWarning: (warning) => {
+                    compatibilityWarnings.push(warning);
+                },
+            }));
             const packageScriptChanges = await ensureAiFeaturePackageScripts(workspace);
             await ensureAiFeatureSyncProjectAnchors(workspace);
             await ensureAiFeatureSyncRestAnchors(workspace);
@@ -76,11 +81,14 @@ export async function scaffoldAiFeatureWorkspace({ aiFeatureSlug, compatibilityP
                 transformSource: ensureBlockConfigCanAddRestManifests,
             });
             return {
-                warnings: packageScriptChanges.addedProjectToolsDependency
-                    ? [
-                        "Added `@wp-typia/project-tools` to devDependencies for `sync-ai`. If this workspace was already installed, rerun your package manager install command before the first `wp-typia sync ai`.",
-                    ]
-                    : [],
+                warnings: [
+                    ...compatibilityWarnings,
+                    ...(packageScriptChanges.addedProjectToolsDependency
+                        ? [
+                            "Added `@wp-typia/project-tools` to devDependencies for `sync-ai`. If this workspace was already installed, rerun your package manager install command before the first `wp-typia sync ai`.",
+                        ]
+                        : []),
+                ],
             };
         },
     });

package/dist/runtime/cli-add-workspace-assets.js

@@ -8,6 +8,7 @@ import { readWorkspaceInventory, appendWorkspaceInventoryEntries, } from "./work
 import { toPascalCase, toTitleCase } from "./string-case.js";
 import { findPhpFunctionRange, hasPhpFunctionDefinition, quotePhpString, replacePhpFunctionDefinition, } from "./php-utils.js";
 import { assertBindingSourceDoesNotExist, assertEditorPluginDoesNotExist, assertPatternDoesNotExist, assertValidEditorPluginSlot, assertValidGeneratedSlug, getWorkspaceBootstrapPath, normalizeBlockSlug, patchFile, quoteTsString, resolveWorkspaceBlock, rollbackWorkspaceMutation, snapshotWorkspaceFiles, } from "./cli-add-shared.js";
+import { appendPhpSnippetBeforeClosingTag, insertPhpSnippetBeforeWorkspaceAnchors, } from "./cli-add-workspace-mutation.js";
 import { normalizeOptionalCliString } from "./cli-validation.js";
 const PATTERN_BOOTSTRAP_CATEGORY = "register_block_pattern_category";
 const BINDING_SOURCE_SERVER_GLOB = "/src/bindings/*/server.php";
@@ -597,39 +598,17 @@ function ${bindingEditorEnqueueFunctionName}() {
 \t);
 }
 `;
-        const insertionAnchors = [
-            /add_action\(\s*["']init["']\s*,\s*["'][^"']+_load_textdomain["']\s*\);\s*\n/u,
-            /\?>\s*$/u,
-        ];
-        const insertPhpSnippet = (snippet) => {
-            for (const anchor of insertionAnchors) {
-                const candidate = nextSource.replace(anchor, (match) => `${snippet}\n${match}`);
-                if (candidate !== nextSource) {
-                    nextSource = candidate;
-                    return;
-                }
-            }
-            nextSource = `${nextSource.trimEnd()}\n${snippet}\n`;
-        };
-        const appendPhpSnippet = (snippet) => {
-            const closingTagPattern = /\?>\s*$/u;
-            if (closingTagPattern.test(nextSource)) {
-                nextSource = nextSource.replace(closingTagPattern, `${snippet}\n?>`);
-                return;
-            }
-            nextSource = `${nextSource.trimEnd()}\n${snippet}\n`;
-        };
         if (!hasPhpFunctionDefinition(nextSource, bindingRegistrationFunctionName)) {
-            insertPhpSnippet(bindingRegistrationFunction);
+            nextSource = insertPhpSnippetBeforeWorkspaceAnchors(nextSource, bindingRegistrationFunction);
         }
         if (!hasPhpFunctionDefinition(nextSource, bindingEditorEnqueueFunctionName)) {
-            insertPhpSnippet(bindingEditorEnqueueFunction);
+            nextSource = insertPhpSnippetBeforeWorkspaceAnchors(nextSource, bindingEditorEnqueueFunction);
         }
         if (!nextSource.includes(bindingRegistrationHook)) {
-            appendPhpSnippet(bindingRegistrationHook);
+            nextSource = appendPhpSnippetBeforeClosingTag(nextSource, bindingRegistrationHook);
         }
         if (!nextSource.includes(bindingEditorEnqueueHook)) {
-            appendPhpSnippet(bindingEditorEnqueueHook);
+            nextSource = appendPhpSnippetBeforeClosingTag(nextSource, bindingEditorEnqueueHook);
         }
         return nextSource;
     });
@@ -679,30 +658,8 @@ function ${enqueueFunctionName}() {
 \t}
 }
 `;
-        const insertionAnchors = [
-            /add_action\(\s*["']init["']\s*,\s*["'][^"']+_load_textdomain["']\s*\);\s*\n/u,
-            /\?>\s*$/u,
-        ];
-        const insertPhpSnippet = (snippet) => {
-            for (const anchor of insertionAnchors) {
-                const candidate = nextSource.replace(anchor, (match) => `${snippet}\n${match}`);
-                if (candidate !== nextSource) {
-                    nextSource = candidate;
-                    return;
-                }
-            }
-            nextSource = `${nextSource.trimEnd()}\n${snippet}\n`;
-        };
-        const appendPhpSnippet = (snippet) => {
-            const closingTagPattern = /\?>\s*$/u;
-            if (closingTagPattern.test(nextSource)) {
-                nextSource = nextSource.replace(closingTagPattern, `${snippet}\n?>`);
-                return;
-            }
-            nextSource = `${nextSource.trimEnd()}\n${snippet}\n`;
-        };
         if (!hasPhpFunctionDefinition(nextSource, enqueueFunctionName)) {
-            insertPhpSnippet(enqueueFunction);
+            nextSource = insertPhpSnippetBeforeWorkspaceAnchors(nextSource, enqueueFunction);
         }
         else {
             const requiredReferences = [
@@ -726,7 +683,7 @@ function ${enqueueFunctionName}() {
             }
         }
         if (!nextSource.includes(enqueueHook)) {
-            appendPhpSnippet(enqueueHook);
+            nextSource = appendPhpSnippetBeforeClosingTag(nextSource, enqueueHook);
         }
         return nextSource;
     });

package/dist/runtime/cli-add-workspace-rest-anchors.js

@@ -1,5 +1,6 @@
 import path from "node:path";
 import { getWorkspaceBootstrapPath, patchFile, } from "./cli-add-shared.js";
+import { appendPhpSnippetBeforeClosingTag, insertPhpSnippetBeforeWorkspaceAnchors, } from "./cli-add-workspace-mutation.js";
 import { hasPhpFunctionDefinition } from "./php-utils.js";
 const REST_RESOURCE_SERVER_GLOB = "/inc/rest/*.php";
 export async function ensureRestResourceBootstrapAnchors(workspace) {
@@ -16,30 +17,8 @@ function ${registerFunctionName}() {
 \t}
 }
 `;
-        const insertionAnchors = [
-            /add_action\(\s*["']init["']\s*,\s*["'][^"']+_load_textdomain["']\s*\);\s*\n/u,
-            /\?>\s*$/u,
-        ];
-        const insertPhpSnippet = (snippet) => {
-            for (const anchor of insertionAnchors) {
-                const candidate = nextSource.replace(anchor, (match) => `${snippet}\n${match}`);
-                if (candidate !== nextSource) {
-                    nextSource = candidate;
-                    return;
-                }
-            }
-            nextSource = `${nextSource.trimEnd()}\n${snippet}\n`;
-        };
-        const appendPhpSnippet = (snippet) => {
-            const closingTagPattern = /\?>\s*$/u;
-            if (closingTagPattern.test(nextSource)) {
-                nextSource = nextSource.replace(closingTagPattern, `${snippet}\n?>`);
-                return;
-            }
-            nextSource = `${nextSource.trimEnd()}\n${snippet}\n`;
-        };
         if (!hasPhpFunctionDefinition(nextSource, registerFunctionName)) {
-            insertPhpSnippet(registerFunction);
+            nextSource = insertPhpSnippetBeforeWorkspaceAnchors(nextSource, registerFunction);
         }
         else if (!nextSource.includes(REST_RESOURCE_SERVER_GLOB)) {
             throw new Error([
@@ -49,7 +28,7 @@ function ${registerFunctionName}() {
             ].join(" "));
         }
         if (!nextSource.includes(registerHook)) {
-            appendPhpSnippet(registerHook);
+            nextSource = appendPhpSnippetBeforeClosingTag(nextSource, registerHook);
         }
         return nextSource;
     });

package/dist/runtime/cli-doctor-workspace-bindings.js

@@ -1,11 +1,10 @@
 import fs from "node:fs";
 import path from "node:path";
 import { parseScaffoldBlockMetadata } from "@wp-typia/block-runtime/blocks";
-import { checkExistingFiles, createDoctorCheck, WORKSPACE_BINDING_EDITOR_ASSET, WORKSPACE_BINDING_EDITOR_SCRIPT, WORKSPACE_BINDING_SERVER_GLOB, } from "./cli-doctor-workspace-shared.js";
+import { checkExistingFiles, createDoctorCheck, resolveWorkspaceBootstrapPath, WORKSPACE_BINDING_EDITOR_ASSET, WORKSPACE_BINDING_EDITOR_SCRIPT, WORKSPACE_BINDING_SERVER_GLOB, } from "./cli-doctor-workspace-shared.js";
 import { escapeRegex } from "./php-utils.js";
 function checkWorkspaceBindingBootstrap(projectDir, packageName) {
-    const packageBaseName = packageName.split("/").pop() ?? packageName;
-    const bootstrapPath = path.join(projectDir, `${packageBaseName}.php`);
+    const bootstrapPath = resolveWorkspaceBootstrapPath(projectDir, packageName);
     if (!fs.existsSync(bootstrapPath)) {
         return createDoctorCheck("Binding bootstrap", "fail", `Missing ${path.basename(bootstrapPath)}`);
     }

package/dist/runtime/cli-doctor-workspace-blocks.js

@@ -1,7 +1,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import { parseScaffoldBlockMetadata } from "@wp-typia/block-runtime/blocks";
-import { checkExistingFiles, createDoctorCheck, WORKSPACE_FULL_BLOCK_NAME_PATTERN, WORKSPACE_GENERATED_BLOCK_ARTIFACTS, } from "./cli-doctor-workspace-shared.js";
+import { checkExistingFiles, createDoctorCheck, resolveWorkspaceBootstrapPath, WORKSPACE_FULL_BLOCK_NAME_PATTERN, WORKSPACE_GENERATED_BLOCK_ARTIFACTS, } from "./cli-doctor-workspace-shared.js";
 import { HOOKED_BLOCK_ANCHOR_PATTERN, HOOKED_BLOCK_POSITION_SET, } from "./hooked-blocks.js";
 import { hasExecutablePattern, hasUncommentedPattern, maskTypeScriptCommentsAndLiterals, } from "./ts-source-masking.js";
 const WORKSPACE_COLLECTION_IMPORT_LINE = "import '../../collection';";
@@ -306,8 +306,7 @@ function checkWorkspaceBlockIframeCompatibility(projectDir, blockSlug) {
     ];
 }
 function checkWorkspacePatternBootstrap(projectDir, packageName) {
-    const packageBaseName = packageName.split("/").pop() ?? packageName;
-    const bootstrapPath = path.join(projectDir, `${packageBaseName}.php`);
+    const bootstrapPath = resolveWorkspaceBootstrapPath(projectDir, packageName);
     if (!fs.existsSync(bootstrapPath)) {
         return createDoctorCheck("Pattern bootstrap", "fail", `Missing ${path.basename(bootstrapPath)}`);
     }

package/dist/runtime/cli-doctor-workspace-features.js

@@ -1,7 +1,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import { EDITOR_PLUGIN_SLOT_IDS, REST_RESOURCE_METHOD_IDS, REST_RESOURCE_NAMESPACE_PATTERN, resolveEditorPluginSlotAlias, } from "./cli-add-shared.js";
-import { checkExistingFiles, createDoctorCheck, WORKSPACE_ABILITY_EDITOR_ASSET, WORKSPACE_ABILITY_EDITOR_SCRIPT, WORKSPACE_ABILITY_GLOB, WORKSPACE_ADMIN_VIEW_ASSET, WORKSPACE_ADMIN_VIEW_GLOB, WORKSPACE_ADMIN_VIEW_SCRIPT, WORKSPACE_ADMIN_VIEW_STYLE, WORKSPACE_AI_FEATURE_GLOB, WORKSPACE_EDITOR_PLUGIN_EDITOR_ASSET, WORKSPACE_EDITOR_PLUGIN_EDITOR_SCRIPT, WORKSPACE_EDITOR_PLUGIN_EDITOR_STYLE, WORKSPACE_REST_RESOURCE_GLOB, } from "./cli-doctor-workspace-shared.js";
+import { checkExistingFiles, createDoctorCheck, resolveWorkspaceBootstrapPath, WORKSPACE_ABILITY_EDITOR_ASSET, WORKSPACE_ABILITY_EDITOR_SCRIPT, WORKSPACE_ABILITY_GLOB, WORKSPACE_ADMIN_VIEW_ASSET, WORKSPACE_ADMIN_VIEW_GLOB, WORKSPACE_ADMIN_VIEW_SCRIPT, WORKSPACE_ADMIN_VIEW_STYLE, WORKSPACE_AI_FEATURE_GLOB, WORKSPACE_EDITOR_PLUGIN_EDITOR_ASSET, WORKSPACE_EDITOR_PLUGIN_EDITOR_SCRIPT, WORKSPACE_EDITOR_PLUGIN_EDITOR_STYLE, WORKSPACE_REST_RESOURCE_GLOB, } from "./cli-doctor-workspace-shared.js";
 import { escapeRegex } from "./php-utils.js";
 function getWorkspaceRestResourceRequiredFiles(restResource) {
     const schemaNames = new Set();
@@ -46,8 +46,7 @@ function checkWorkspaceRestResourceConfig(restResource) {
         : "REST resource namespace or methods are invalid");
 }
 function checkWorkspaceRestResourceBootstrap(projectDir, packageName, phpPrefix) {
-    const packageBaseName = packageName.split("/").pop() ?? packageName;
-    const bootstrapPath = path.join(projectDir, `${packageBaseName}.php`);
+    const bootstrapPath = resolveWorkspaceBootstrapPath(projectDir, packageName);
     if (!fs.existsSync(bootstrapPath)) {
         return createDoctorCheck("REST resource bootstrap", "fail", `Missing ${path.basename(bootstrapPath)}`);
     }
@@ -93,8 +92,7 @@ function checkWorkspaceAbilityConfig(projectDir, ability) {
     }
 }
 function checkWorkspaceAbilityBootstrap(projectDir, packageName, phpPrefix) {
-    const packageBaseName = packageName.split("/").pop() ?? packageName;
-    const bootstrapPath = path.join(projectDir, `${packageBaseName}.php`);
+    const bootstrapPath = resolveWorkspaceBootstrapPath(projectDir, packageName);
     if (!fs.existsSync(bootstrapPath)) {
         return createDoctorCheck("Ability bootstrap", "fail", `Missing ${path.basename(bootstrapPath)}`);
     }
@@ -169,8 +167,7 @@ function checkWorkspaceAiFeatureConfig(aiFeature) {
         : "AI feature namespace is invalid");
 }
 function checkWorkspaceAiFeatureBootstrap(projectDir, packageName, phpPrefix) {
-    const packageBaseName = packageName.split("/").pop() ?? packageName;
-    const bootstrapPath = path.join(projectDir, `${packageBaseName}.php`);
+    const bootstrapPath = resolveWorkspaceBootstrapPath(projectDir, packageName);
     if (!fs.existsSync(bootstrapPath)) {
         return createDoctorCheck("AI feature bootstrap", "fail", `Missing ${path.basename(bootstrapPath)}`);
     }
@@ -204,8 +201,7 @@ function checkWorkspaceEditorPluginConfig(editorPlugin) {
         : `Unsupported editor plugin slot "${editorPlugin.slot}". Expected one of: ${EDITOR_PLUGIN_SLOT_IDS.join(", ")} or legacy aliases PluginSidebar, PluginDocumentSettingPanel.`);
 }
 function checkWorkspaceEditorPluginBootstrap(projectDir, packageName, phpPrefix) {
-    const packageBaseName = packageName.split("/").pop() ?? packageName;
-    const bootstrapPath = path.join(projectDir, `${packageBaseName}.php`);
+    const bootstrapPath = resolveWorkspaceBootstrapPath(projectDir, packageName);
     if (!fs.existsSync(bootstrapPath)) {
         return createDoctorCheck("Editor plugin bootstrap", "fail", `Missing ${path.basename(bootstrapPath)}`);
     }
@@ -269,8 +265,7 @@ function checkWorkspaceAdminViewConfig(adminView, inventory) {
         : "Admin view source must use rest-resource:<slug> with a list-capable REST resource or core-data:<postType|taxonomy>/<name>");
 }
 function checkWorkspaceAdminViewBootstrap(projectDir, packageName, phpPrefix) {
-    const packageBaseName = packageName.split("/").pop() ?? packageName;
-    const bootstrapPath = path.join(projectDir, `${packageBaseName}.php`);
+    const bootstrapPath = resolveWorkspaceBootstrapPath(projectDir, packageName);
     if (!fs.existsSync(bootstrapPath)) {
         return createDoctorCheck("Admin view bootstrap", "fail", `Missing ${path.basename(bootstrapPath)}`);
     }

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

@@ -58,6 +58,14 @@ export declare function createDoctorScopeCheck(status: DoctorCheck["status"], de
  * @returns Relative PHP bootstrap filename for the workspace root.
  */
 export declare function getWorkspaceBootstrapRelativePath(packageName: string): string;
+/**
+ * Resolve the expected workspace bootstrap file inside a project root.
+ *
+ * @param projectDir Absolute workspace root directory.
+ * @param packageName Package name used to derive the plugin bootstrap basename.
+ * @returns Absolute PHP bootstrap file path for the workspace root.
+ */
+export declare function resolveWorkspaceBootstrapPath(projectDir: string, packageName: string): string;
 /**
  * Verify that every referenced relative file exists inside a workspace.
  *

package/dist/runtime/cli-doctor-workspace-shared.js

@@ -71,6 +71,16 @@ export function createDoctorScopeCheck(status, detail) {
 export function getWorkspaceBootstrapRelativePath(packageName) {
     return `${packageName.split("/").pop() ?? packageName}.php`;
 }
+/**
+ * Resolve the expected workspace bootstrap file inside a project root.
+ *
+ * @param projectDir Absolute workspace root directory.
+ * @param packageName Package name used to derive the plugin bootstrap basename.
+ * @returns Absolute PHP bootstrap file path for the workspace root.
+ */
+export function resolveWorkspaceBootstrapPath(projectDir, packageName) {
+    return path.join(projectDir, getWorkspaceBootstrapRelativePath(packageName));
+}
 /**
  * Verify that every referenced relative file exists inside a workspace.
  *

package/dist/runtime/cli-help.js

@@ -52,7 +52,7 @@ Notes:
   \`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.
-  Public installs currently gate this workflow until \`@wp-typia/dataviews\` is published to npm.
+  Generated admin-view workspaces add \`@wp-typia/dataviews\` and the needed WordPress DataViews packages as opt-in 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.

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

@@ -0,0 +1,15 @@
+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>;