@wp-typia/project-tools 0.22.6 → 0.22.7

package/dist/runtime/cli-add-block-json.d.ts

@@ -16,10 +16,10 @@ export declare function resolveWorkspaceBlock(inventory: WorkspaceInventory, blo
  * @returns Parsed block metadata and the absolute `block.json` path.
  * @throws {Error} When the file is missing or cannot be parsed as scaffold metadata.
  */
-export declare function readWorkspaceBlockJson(projectDir: string, blockSlug: string): {
+export declare function readWorkspaceBlockJson(projectDir: string, blockSlug: string): Promise<{
     blockJson: Record<string, unknown>;
     blockJsonPath: string;
-};
+}>;
 /**
  * Return a mutable `blockHooks` object for a parsed block metadata document.
  *

package/dist/runtime/cli-add-block-json.js

@@ -1,6 +1,6 @@
-import fs from "node:fs";
 import path from "node:path";
 import { parseScaffoldBlockMetadata } from "@wp-typia/block-runtime/blocks";
+import { readOptionalUtf8File } from "./fs-async.js";
 /**
  * Resolve an existing workspace block inventory entry by slug.
  *
@@ -24,14 +24,15 @@ export function resolveWorkspaceBlock(inventory, blockSlug) {
  * @returns Parsed block metadata and the absolute `block.json` path.
  * @throws {Error} When the file is missing or cannot be parsed as scaffold metadata.
  */
-export function readWorkspaceBlockJson(projectDir, blockSlug) {
+export async function readWorkspaceBlockJson(projectDir, blockSlug) {
     const blockJsonPath = path.join(projectDir, "src", "blocks", blockSlug, "block.json");
-    if (!fs.existsSync(blockJsonPath)) {
+    const source = await readOptionalUtf8File(blockJsonPath);
+    if (source === null) {
         throw new Error(`Missing ${path.relative(projectDir, blockJsonPath)} for workspace block "${blockSlug}".`);
     }
     let blockJson;
     try {
-        blockJson = parseScaffoldBlockMetadata(JSON.parse(fs.readFileSync(blockJsonPath, "utf8")));
+        blockJson = parseScaffoldBlockMetadata(JSON.parse(source));
     }
     catch (error) {
         throw new Error(error instanceof Error

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

@@ -1,6 +1,6 @@
-import fs from "node:fs";
 import { promises as fsp } from "node:fs";
 import path from "node:path";
+import { pathExists } from "./fs-async.js";
 import { resolveWorkspaceProject } from "./workspace-project.js";
 import { appendWorkspaceInventoryEntries, readWorkspaceInventory } from "./workspace-inventory.js";
 import { toKebabCase, toSnakeCase, toTitleCase } from "./string-case.js";
@@ -381,8 +381,7 @@ async function writeVariationRegistry(projectDir, blockSlug, variationSlug) {
     const variationsDir = path.join(projectDir, "src", "blocks", blockSlug, "variations");
     const variationsIndexPath = path.join(variationsDir, "index.ts");
     await fsp.mkdir(variationsDir, { recursive: true });
-    const existingVariationSlugs = fs
-        .readdirSync(variationsDir)
+    const existingVariationSlugs = (await fsp.readdir(variationsDir))
         .filter((entry) => entry.endsWith(".ts") && entry !== "index.ts")
         .map((entry) => entry.replace(/\.ts$/u, ""));
     const nextVariationSlugs = Array.from(new Set([...existingVariationSlugs, variationSlug])).sort();
@@ -392,8 +391,7 @@ async function writeBlockStyleRegistry(projectDir, blockSlug, styleSlug) {
     const stylesDir = path.join(projectDir, "src", "blocks", blockSlug, "styles");
     const stylesIndexPath = path.join(stylesDir, "index.ts");
     await fsp.mkdir(stylesDir, { recursive: true });
-    const existingStyleSlugs = fs
-        .readdirSync(stylesDir)
+    const existingStyleSlugs = (await fsp.readdir(stylesDir))
         .filter((entry) => entry.endsWith(".ts") && entry !== "index.ts")
         .map((entry) => entry.replace(/\.ts$/u, ""));
     const nextStyleSlugs = Array.from(new Set([...existingStyleSlugs, styleSlug])).sort();
@@ -403,8 +401,7 @@ async function writeBlockTransformRegistry(projectDir, blockSlug, transformSlug)
     const transformsDir = path.join(projectDir, "src", "blocks", blockSlug, "transforms");
     const transformsIndexPath = path.join(transformsDir, "index.ts");
     await fsp.mkdir(transformsDir, { recursive: true });
-    const existingTransformSlugs = fs
-        .readdirSync(transformsDir)
+    const existingTransformSlugs = (await fsp.readdir(transformsDir))
         .filter((entry) => entry.endsWith(".ts") && entry !== "index.ts")
         .map((entry) => entry.replace(/\.ts$/u, ""));
     const nextTransformSlugs = Array.from(new Set([...existingTransformSlugs, transformSlug])).sort();
@@ -495,7 +492,7 @@ export async function runAddVariationCommand({ blockName, cwd = process.cwd(), v
     const variationsDir = path.join(workspace.projectDir, "src", "blocks", blockSlug, "variations");
     const variationFilePath = path.join(variationsDir, `${variationSlug}.ts`);
     const variationsIndexPath = path.join(variationsDir, "index.ts");
-    const shouldRemoveVariationsDirOnRollback = !fs.existsSync(variationsDir);
+    const shouldRemoveVariationsDirOnRollback = !(await pathExists(variationsDir));
     const mutationSnapshot = {
         fileSources: await snapshotWorkspaceFiles([
             blockConfigPath,
@@ -555,7 +552,7 @@ export async function runAddBlockStyleCommand({ blockName, cwd = process.cwd(),
     const stylesDir = path.join(workspace.projectDir, "src", "blocks", blockSlug, "styles");
     const styleFilePath = path.join(stylesDir, `${styleSlug}.ts`);
     const stylesIndexPath = path.join(stylesDir, "index.ts");
-    const shouldRemoveStylesDirOnRollback = !fs.existsSync(stylesDir);
+    const shouldRemoveStylesDirOnRollback = !(await pathExists(stylesDir));
     const mutationSnapshot = {
         fileSources: await snapshotWorkspaceFiles([
             blockConfigPath,
@@ -624,7 +621,7 @@ export async function runAddBlockTransformCommand({ cwd = process.cwd(), fromBlo
     const transformsDir = path.join(workspace.projectDir, "src", "blocks", target.blockSlug, "transforms");
     const transformFilePath = path.join(transformsDir, `${transformSlug}.ts`);
     const transformsIndexPath = path.join(transformsDir, "index.ts");
-    const shouldRemoveTransformsDirOnRollback = !fs.existsSync(transformsDir);
+    const shouldRemoveTransformsDirOnRollback = !(await pathExists(transformsDir));
     const mutationSnapshot = {
         fileSources: await snapshotWorkspaceFiles([
             blockConfigPath,
@@ -695,7 +692,7 @@ export async function runAddHookedBlockCommand({ anchorBlockName, blockName, cwd
     if (resolvedAnchorBlockName === selfHookAnchor) {
         throw new Error("`wp-typia add hooked-block` cannot hook a block relative to its own block name.");
     }
-    const { blockJson, blockJsonPath } = readWorkspaceBlockJson(workspace.projectDir, blockSlug);
+    const { blockJson, blockJsonPath } = await readWorkspaceBlockJson(workspace.projectDir, blockSlug);
     const blockJsonRelativePath = path.relative(workspace.projectDir, blockJsonPath);
     const blockHooks = getMutableBlockHooks(blockJson, blockJsonRelativePath);
     if (Object.prototype.hasOwnProperty.call(blockHooks, resolvedAnchorBlockName)) {

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

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

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

@@ -0,0 +1,74 @@
+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.";
+}

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

@@ -3,9 +3,10 @@ import path from "node:path";
 import { analyzeSourceTypes } from "@wp-typia/block-runtime/metadata-parser";
 import ts from "typescript";
 import { discoverMigrationInitLayout } from "./migration-project.js";
-import { formatAddDevDependenciesCommand, formatPackageExecCommand, formatRunScript, } from "./package-managers.js";
+import { formatPackageExecCommand, formatRunScript } from "./package-managers.js";
 import { toPascalCase } from "./string-case.js";
-import { buildDependencyChanges, buildPackageManagerFieldChange, buildRequiredDevDependencyMapEntries, buildScriptChanges, getWpTypiaCliSpecifier, hasExistingWpTypiaProjectSurface, readProjectPackageJson, resolveInitPackageManager, } from "./cli-init-package-json.js";
+import { buildDependencyChanges, buildPackageManagerFieldChange, buildScriptChanges, getWpTypiaCliSpecifier, hasExistingWpTypiaProjectSurface, readProjectPackageJson, resolveInitPackageManager, } from "./cli-init-package-json.js";
+import { buildInitPlanChangeSummary, buildInitPlanNextSteps, buildRetrofitPlanSummary, } from "./cli-init-plan-presentation.js";
 import { RETROFIT_APPLY_PREVIEW_NOTE, SUPPORTED_RETROFIT_LAYOUT_NOTE, } from "./cli-init-types.js";
 import { tryResolveWorkspaceProject } from "./workspace-project.js";
 function normalizeRelativePath(value) {
@@ -161,82 +162,9 @@ function buildPlannedFiles(projectDir, layoutKind) {
         },
     ];
 }
-function buildChangeSummary(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;
-}
-function buildNextSteps(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}`,
-        ];
-    }
-    const steps = [
-        ...(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}`,
-    ];
-    return steps;
-}
-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 function createRetrofitPlan(options) {
     const includeGeneratedArtifacts = options.commandMode === "preview-only";
-    const plannedChanges = buildChangeSummary({
+    const plannedChanges = buildInitPlanChangeSummary({
         generatedArtifacts: options.generatedArtifacts,
         packageChanges: options.packageChanges,
         plannedFiles: options.plannedFiles,
@@ -249,7 +177,7 @@ export function createRetrofitPlan(options) {
         detectedLayout: options.detectedLayout,
         generatedArtifacts: options.generatedArtifacts,
         nextSteps: options.nextSteps ??
-            buildNextSteps({
+            buildInitPlanNextSteps({
                 commandMode: options.commandMode,
                 dependencyChangeCount: options.packageChanges.addDevDependencies.length,
                 hasPlannedChanges: plannedChanges.length > 0,

package/dist/runtime/package-versions.d.ts

@@ -23,7 +23,7 @@ export declare const DEFAULT_WORDPRESS_CORE_ABILITIES_VERSION = "^0.9.0";
 export declare const DEFAULT_WORDPRESS_CORE_DATA_VERSION = "^7.44.0";
 export declare const DEFAULT_WORDPRESS_DATA_VERSION = "^9.28.0";
 export declare const DEFAULT_WORDPRESS_DATAVIEWS_VERSION = "^14.1.0";
-export declare const DEFAULT_WP_TYPIA_DATAVIEWS_VERSION = "^0.1.0";
+export declare const DEFAULT_WP_TYPIA_DATAVIEWS_VERSION = "^0.1.1";
 /**
  * Resolve a managed package version range from linked workspace packages first,
  * then installed package manifests, while preserving the shared normalization

package/dist/runtime/package-versions.js

@@ -19,7 +19,7 @@ export const DEFAULT_WORDPRESS_CORE_ABILITIES_VERSION = '^0.9.0';
 export const DEFAULT_WORDPRESS_CORE_DATA_VERSION = '^7.44.0';
 export const DEFAULT_WORDPRESS_DATA_VERSION = '^9.28.0';
 export const DEFAULT_WORDPRESS_DATAVIEWS_VERSION = '^14.1.0';
-export const DEFAULT_WP_TYPIA_DATAVIEWS_VERSION = '^0.1.0';
+export const DEFAULT_WP_TYPIA_DATAVIEWS_VERSION = '^0.1.1';
 let cachedPackageVersions = null;
 function getErrorCode(error) {
     return typeof error === 'object' && error !== null && 'code' in error

package/dist/runtime/php-utils.js

@@ -139,6 +139,84 @@ function matchesPhpFunctionCallAt(source, index, functionName) {
     const callStart = skipPhpCallTrivia(source, cursor);
     return callStart !== null && source[callStart] === "(";
 }
+function createPhpScannerState() {
+    return {
+        heredocDelimiter: "",
+        mode: "code",
+    };
+}
+function advancePhpScanner(source, index, state) {
+    const character = source[index];
+    if (state.mode === "heredoc") {
+        const closingEnd = findPhpHeredocClosingEnd(source, index, state.heredocDelimiter);
+        if (closingEnd !== null) {
+            state.mode = "code";
+            state.heredocDelimiter = "";
+            return { ambiguous: false, inCode: false, index: closingEnd };
+        }
+        const nextLineStart = findPhpLineBoundary(source, index).nextStart;
+        if (nextLineStart <= index) {
+            return { ambiguous: true, inCode: false, index };
+        }
+        return { ambiguous: false, inCode: false, index: nextLineStart };
+    }
+    if (state.mode === "single-quoted" || state.mode === "double-quoted") {
+        const quote = state.mode === "single-quoted" ? "'" : '"';
+        if (character === "\\") {
+            return { ambiguous: false, inCode: false, index: index + 2 };
+        }
+        if (character === quote) {
+            state.mode = "code";
+        }
+        return { ambiguous: false, inCode: false, index: index + 1 };
+    }
+    if (state.mode === "line-comment") {
+        if (character === "\r" || character === "\n") {
+            state.mode = "code";
+        }
+        return { ambiguous: false, inCode: false, index: index + 1 };
+    }
+    if (state.mode === "block-comment") {
+        if (character === "*" && source[index + 1] === "/") {
+            state.mode = "code";
+            return { ambiguous: false, inCode: false, index: index + 2 };
+        }
+        return { ambiguous: false, inCode: false, index: index + 1 };
+    }
+    if (character === "'") {
+        state.mode = "single-quoted";
+        return { ambiguous: false, inCode: false, index: index + 1 };
+    }
+    if (character === '"') {
+        state.mode = "double-quoted";
+        return { ambiguous: false, inCode: false, index: index + 1 };
+    }
+    if (character === "/" && source[index + 1] === "/") {
+        state.mode = "line-comment";
+        return { ambiguous: false, inCode: false, index: index + 2 };
+    }
+    if (character === "#" && source[index + 1] !== "[") {
+        state.mode = "line-comment";
+        return { ambiguous: false, inCode: false, index: index + 1 };
+    }
+    if (character === "/" && source[index + 1] === "*") {
+        state.mode = "block-comment";
+        return { ambiguous: false, inCode: false, index: index + 2 };
+    }
+    if (character === "<") {
+        const heredocStart = parsePhpHeredocStart(source, index);
+        if (heredocStart) {
+            state.mode = "heredoc";
+            state.heredocDelimiter = heredocStart.delimiter;
+            return {
+                ambiguous: false,
+                inCode: false,
+                index: heredocStart.contentStart,
+            };
+        }
+    }
+    return { ambiguous: false, inCode: true, index };
+}
 /**
  * Detect a PHP function call outside strings, comments, heredoc, and nowdoc blocks.
  *
@@ -147,88 +225,17 @@ function matchesPhpFunctionCallAt(source, index, functionName) {
  * @returns Whether `source` contains a code-mode call to `functionName`.
  */
 export function hasPhpFunctionCall(source, functionName) {
-    let mode = "code";
-    let heredocDelimiter = "";
+    const scanner = createPhpScannerState();
     let index = 0;
     while (index < source.length) {
-        const character = source[index];
-        if (mode === "heredoc") {
-            const closingEnd = findPhpHeredocClosingEnd(source, index, heredocDelimiter);
-            if (closingEnd !== null) {
-                mode = "code";
-                heredocDelimiter = "";
-                index = closingEnd;
-                continue;
-            }
-            const nextLineStart = findPhpLineBoundary(source, index).nextStart;
-            if (nextLineStart <= index) {
-                return false;
-            }
-            index = nextLineStart;
-            continue;
-        }
-        if (mode === "single-quoted" || mode === "double-quoted") {
-            const quote = mode === "single-quoted" ? "'" : '"';
-            if (character === "\\") {
-                index += 2;
-                continue;
-            }
-            if (character === quote) {
-                mode = "code";
-            }
-            index += 1;
-            continue;
-        }
-        if (mode === "line-comment") {
-            if (character === "\r" || character === "\n") {
-                mode = "code";
-            }
-            index += 1;
-            continue;
-        }
-        if (mode === "block-comment") {
-            if (character === "*" && source[index + 1] === "/") {
-                mode = "code";
-                index += 2;
-                continue;
-            }
-            index += 1;
-            continue;
-        }
-        if (character === "'") {
-            mode = "single-quoted";
-            index += 1;
-            continue;
+        const scan = advancePhpScanner(source, index, scanner);
+        if (scan.ambiguous) {
+            return false;
         }
-        if (character === '"') {
-            mode = "double-quoted";
-            index += 1;
-            continue;
-        }
-        if (character === "/" && source[index + 1] === "/") {
-            mode = "line-comment";
-            index += 2;
-            continue;
-        }
-        if (character === "#" && source[index + 1] !== "[") {
-            mode = "line-comment";
-            index += 1;
+        if (!scan.inCode) {
+            index = scan.index;
             continue;
         }
-        if (character === "/" && source[index + 1] === "*") {
-            mode = "block-comment";
-            index += 2;
-            continue;
-        }
-        if (character === "<") {
-            const heredocStart = parsePhpHeredocStart(source, index);
-            if (heredocStart) {
-                mode = "heredoc";
-                heredocDelimiter = heredocStart.delimiter;
-                index = heredocStart.contentStart;
-                continue;
-            }
-        }
         if (matchesPhpFunctionCallAt(source, index, functionName)) {
             return true;
         }
@@ -257,88 +264,18 @@ export function findPhpFunctionRange(source, functionName, options = {}) {
     }
     const openBraceIndex = functionStart + openBraceOffset;
     let depth = 0;
-    let mode = "code";
-    let heredocDelimiter = "";
+    const scanner = createPhpScannerState();
     let index = openBraceIndex;
     while (index < source.length) {
-        const character = source[index];
-        if (mode === "heredoc") {
-            const closingEnd = findPhpHeredocClosingEnd(source, index, heredocDelimiter);
-            if (closingEnd !== null) {
-                mode = "code";
-                heredocDelimiter = "";
-                index = closingEnd;
-                continue;
-            }
-            const nextLineStart = findPhpLineBoundary(source, index).nextStart;
-            if (nextLineStart <= index) {
-                return null;
-            }
-            index = nextLineStart;
-            continue;
-        }
-        if (mode === "single-quoted" || mode === "double-quoted") {
-            const quote = mode === "single-quoted" ? "'" : '"';
-            if (character === "\\") {
-                index += 2;
-                continue;
-            }
-            if (character === quote) {
-                mode = "code";
-            }
-            index += 1;
-            continue;
-        }
-        if (mode === "line-comment") {
-            if (character === "\r" || character === "\n") {
-                mode = "code";
-            }
-            index += 1;
-            continue;
-        }
-        if (mode === "block-comment") {
-            if (character === "*" && source[index + 1] === "/") {
-                mode = "code";
-                index += 2;
-                continue;
-            }
-            index += 1;
-            continue;
-        }
-        if (character === "'") {
-            mode = "single-quoted";
-            index += 1;
-            continue;
-        }
-        if (character === '"') {
-            mode = "double-quoted";
-            index += 1;
-            continue;
-        }
-        if (character === "/" && source[index + 1] === "/") {
-            mode = "line-comment";
-            index += 2;
-            continue;
-        }
-        if (character === "#" && source[index + 1] !== "[") {
-            mode = "line-comment";
-            index += 1;
-            continue;
+        const scan = advancePhpScanner(source, index, scanner);
+        if (scan.ambiguous) {
+            return null;
         }
-        if (character === "/" && source[index + 1] === "*") {
-            mode = "block-comment";
-            index += 2;
+        if (!scan.inCode) {
+            index = scan.index;
             continue;
         }
-        if (character === "<") {
-            const heredocStart = parsePhpHeredocStart(source, index);
-            if (heredocStart) {
-                mode = "heredoc";
-                heredocDelimiter = heredocStart.delimiter;
-                index = heredocStart.contentStart;
-                continue;
-            }
-        }
+        const character = source[index];
         if (character === "{") {
             depth += 1;
             index += 1;

package/dist/runtime/string-case.js

@@ -1,3 +1,5 @@
+// Keep this list fixed so generated slugs and file paths do not drift when
+// project config changes. Domain-specific acronyms should use separators.
 const COMMON_ACRONYM_PREFIXES = [
     'HTML',
     'HTTP',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wp-typia/project-tools",
-  "version": "0.22.6",
+  "version": "0.22.7",
   "description": "Project orchestration and programmatic tooling for wp-typia",
   "packageManager": "bun@1.3.11",
   "type": "module",