@wp-typia/project-tools 0.24.12 → 0.24.13

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

@@ -1,6 +1,7 @@
 import { promises as fsp } from "node:fs";
 import path from "node:path";
-import { assertValidHookAnchor, assertValidHookedBlockPosition, getMutableBlockHooks, normalizeBlockSlug, readWorkspaceBlockJson, resolveWorkspaceBlock, rollbackWorkspaceMutation, snapshotWorkspaceFiles, } from "./cli-add-shared.js";
+import { executeWorkspaceMutationPlan } from "./cli-add-workspace-mutation.js";
+import { assertValidHookAnchor, assertValidHookedBlockPosition, getMutableBlockHooks, normalizeBlockSlug, readWorkspaceBlockJson, resolveWorkspaceBlock, } from "./cli-add-shared.js";
 import { readWorkspaceInventoryAsync } from "../workspace/workspace-inventory.js";
 import { resolveWorkspaceProject } from "../workspace/workspace-project.js";
 /**
@@ -35,23 +36,17 @@ export async function runAddHookedBlockCommand({ anchorBlockName, blockName, cwd
     if (Object.prototype.hasOwnProperty.call(blockHooks, resolvedAnchorBlockName)) {
         throw new Error(`${blockJsonRelativePath} already defines a blockHooks entry for "${resolvedAnchorBlockName}".`);
     }
-    const mutationSnapshot = {
-        fileSources: await snapshotWorkspaceFiles([blockJsonPath]),
-        snapshotDirs: [],
-        targetPaths: [],
-    };
-    try {
-        blockHooks[resolvedAnchorBlockName] = resolvedPosition;
-        await fsp.writeFile(blockJsonPath, JSON.stringify(blockJson, null, "\t"), "utf8");
-        return {
-            anchorBlockName: resolvedAnchorBlockName,
-            blockSlug,
-            position: resolvedPosition,
-            projectDir: workspace.projectDir,
-        };
-    }
-    catch (error) {
-        await rollbackWorkspaceMutation(mutationSnapshot);
-        throw error;
-    }
+    return executeWorkspaceMutationPlan({
+        filePaths: [blockJsonPath],
+        run: async () => {
+            blockHooks[resolvedAnchorBlockName] = resolvedPosition;
+            await fsp.writeFile(blockJsonPath, JSON.stringify(blockJson, null, "\t"), "utf8");
+            return {
+                anchorBlockName: resolvedAnchorBlockName,
+                blockSlug,
+                position: resolvedPosition,
+                projectDir: workspace.projectDir,
+            };
+        },
+    });
 }

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

@@ -1,10 +1,19 @@
-export interface WorkspaceMutationPlan<TResult> {
+import { type WorkspaceMutationSnapshot } from "./cli-add-shared.js";
+/**
+ * Paths captured before a workspace mutation so its filesystem changes can be rolled back.
+ */
+export interface WorkspaceMutationSnapshotPlan {
     /** Files to capture before the mutation starts. Missing files are restored as absent. */
     filePaths: string[];
     /** Snapshot directories created by the mutation, usually migration fixtures. */
     snapshotDirs?: string[];
     /** Created files or directories to remove if the mutation fails. */
     targetPaths?: string[];
+}
+/**
+ * A workspace mutation snapshot plan paired with the operation to execute.
+ */
+export interface WorkspaceMutationPlan<TResult> extends WorkspaceMutationSnapshotPlan {
     /** Mutating work to execute after the snapshot is captured. */
     run: () => Promise<TResult>;
 }
@@ -16,10 +25,14 @@ export declare class WorkspaceMutationRollbackError extends Error {
     readonly rollbackError: unknown;
     constructor(mutationError: unknown, rollbackError: unknown);
 }
+/**
+ * Capture the files and paths needed to roll back a workspace add mutation.
+ */
+export declare function createWorkspaceMutationSnapshot({ filePaths, snapshotDirs, targetPaths, }: WorkspaceMutationSnapshotPlan): Promise<WorkspaceMutationSnapshot>;
 /**
  * Execute a workspace add mutation with rollback on any failure.
  */
-export declare function executeWorkspaceMutationPlan<TResult>({ filePaths, run, snapshotDirs, targetPaths, }: WorkspaceMutationPlan<TResult>): Promise<TResult>;
+export declare function executeWorkspaceMutationPlan<TResult>(plan: WorkspaceMutationPlan<TResult>): Promise<TResult>;
 /**
  * Insert a PHP snippet before the workspace textdomain hook or closing tag.
  */

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

@@ -15,16 +15,22 @@ export class WorkspaceMutationRollbackError extends Error {
     }
 }
 /**
- * Execute a workspace add mutation with rollback on any failure.
+ * Capture the files and paths needed to roll back a workspace add mutation.
  */
-export async function executeWorkspaceMutationPlan({ filePaths, run, snapshotDirs = [], targetPaths = [], }) {
-    const mutationSnapshot = {
+export async function createWorkspaceMutationSnapshot({ filePaths, snapshotDirs = [], targetPaths = [], }) {
+    return {
         fileSources: await snapshotWorkspaceFiles(filePaths),
         snapshotDirs: [...snapshotDirs],
         targetPaths: [...targetPaths],
     };
+}
+/**
+ * Execute a workspace add mutation with rollback on any failure.
+ */
+export async function executeWorkspaceMutationPlan(plan) {
+    const mutationSnapshot = await createWorkspaceMutationSnapshot(plan);
     try {
-        return await run();
+        return await plan.run();
     }
     catch (error) {
         try {

package/dist/runtime/doctor/cli-doctor-standalone-rest.js

@@ -2,6 +2,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import ts from 'typescript';
 import { containsCompletion, countOuterParserContinues, hasCanonicalRuntimeImports, hasCanonicalUnknownFlagThrow, hasEarlierAbruptCompletion, hasOnlyCanonicalParserEffects, isAllowedSyncHelperTopLevelStatement, isCanonicalSyncMainCatchHandler, isSafeErrorConstruction, unwrapStaticExpression, } from './cli-doctor-standalone-control-flow.js';
+import { hasTypeScriptSyntaxErrors, isSafeProjectRelativePath, } from './cli-doctor-standalone-shared.js';
 const STANDALONE_SYNC_REST_SCRIPT = path.join('scripts', 'sync-rest-contracts.ts');
 const STANDALONE_REST_OPEN_API_FILE = path.join('src', 'api.openapi.json');
 const STANDALONE_REST_CLIENT_FILE = path.join('src', 'api-client.ts');
@@ -99,26 +100,6 @@ const REST_SYNC_RUNTIME_IMPORTS = new Map([
 ]);
 const WORDPRESS_NAMED_CAPTURE_PREFIX = '(?P<';
 const WORDPRESS_CAPTURE_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/u;
-function hasTypeScriptSyntaxErrors(source, fileName) {
-    const result = ts.transpileModule(source, {
-        compilerOptions: { target: ts.ScriptTarget.Latest },
-        fileName,
-        reportDiagnostics: true,
-    });
-    return (result.diagnostics ?? []).some((diagnostic) => diagnostic.category === ts.DiagnosticCategory.Error);
-}
-function isProjectLocalRelativePath(relativePath) {
-    return (relativePath.length > 0 &&
-        !relativePath.startsWith(`..${path.sep}`) &&
-        relativePath !== '..' &&
-        !path.isAbsolute(relativePath));
-}
-function isSafeProjectRelativePath(projectDir, filePath) {
-    if (path.isAbsolute(filePath)) {
-        return false;
-    }
-    return isProjectLocalRelativePath(path.relative(projectDir, path.resolve(projectDir, filePath)));
-}
 function getStandaloneRestContractArtifactPaths(baseName) {
     return {
         jsonSchemaFile: path.join('src', 'api-schemas', `${baseName}.schema.json`),

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

@@ -0,0 +1,24 @@
+/**
+ * Detect TypeScript errors reported during isolated transpilation.
+ * This includes syntax errors and does not perform a full type check.
+ *
+ * @param source TypeScript source text to parse.
+ * @param fileName File name to associate with parser diagnostics.
+ * @returns Whether the source produces at least one error diagnostic.
+ */
+export declare function hasTypeScriptSyntaxErrors(source: string, fileName: string): boolean;
+/**
+ * Check whether a relative path stays within its project boundary.
+ *
+ * @param relativePath Relative path to validate.
+ * @returns Whether the path is non-empty, rootless, and does not escape upward.
+ */
+export declare function isProjectLocalRelativePath(relativePath: string): boolean;
+/**
+ * Check whether a file path resolves inside a project directory.
+ *
+ * @param projectDir Absolute project directory used as the resolution base.
+ * @param filePath Project-relative file path to validate.
+ * @returns Whether the resolved file path remains inside the project directory.
+ */
+export declare function isSafeProjectRelativePath(projectDir: string, filePath: string): boolean;

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

@@ -0,0 +1,50 @@
+import path from 'node:path';
+import ts from 'typescript';
+function hasFilesystemRoot(filePath) {
+    return (path.isAbsolute(filePath) || path.win32.parse(filePath).root.length > 0);
+}
+/**
+ * Detect TypeScript errors reported during isolated transpilation.
+ * This includes syntax errors and does not perform a full type check.
+ *
+ * @param source TypeScript source text to parse.
+ * @param fileName File name to associate with parser diagnostics.
+ * @returns Whether the source produces at least one error diagnostic.
+ */
+export function hasTypeScriptSyntaxErrors(source, fileName) {
+    const result = ts.transpileModule(source, {
+        compilerOptions: { target: ts.ScriptTarget.Latest },
+        fileName,
+        reportDiagnostics: true,
+    });
+    return (result.diagnostics ?? []).some((diagnostic) => diagnostic.category === ts.DiagnosticCategory.Error);
+}
+/**
+ * Check whether a relative path stays within its project boundary.
+ *
+ * @param relativePath Relative path to validate.
+ * @returns Whether the path is non-empty, rootless, and does not escape upward.
+ */
+export function isProjectLocalRelativePath(relativePath) {
+    if (relativePath.length === 0 || hasFilesystemRoot(relativePath)) {
+        return false;
+    }
+    return [path.posix, path.win32].every((pathApi) => {
+        const normalizedPath = pathApi.normalize(relativePath);
+        return (normalizedPath !== '..' &&
+            !normalizedPath.startsWith(`..${pathApi.sep}`));
+    });
+}
+/**
+ * Check whether a file path resolves inside a project directory.
+ *
+ * @param projectDir Absolute project directory used as the resolution base.
+ * @param filePath Project-relative file path to validate.
+ * @returns Whether the resolved file path remains inside the project directory.
+ */
+export function isSafeProjectRelativePath(projectDir, filePath) {
+    if (!path.isAbsolute(projectDir) || hasFilesystemRoot(filePath)) {
+        return false;
+    }
+    return isProjectLocalRelativePath(path.relative(projectDir, path.resolve(projectDir, filePath)));
+}

package/dist/runtime/doctor/cli-doctor-standalone.js

@@ -9,6 +9,7 @@ import { findPhpFunctionCallEnd, findPhpFunctionRange, getPhpCodeBraceDepth, has
 import { readJsonFileSync } from '../shared/json-utils.js';
 import { createDoctorCheck, createDoctorScopeCheck, } from './cli-doctor-workspace-shared.js';
 import { containsCompletion, countOuterParserContinues, getSafeErrorConstruction, hasCanonicalRuntimeImports, hasCanonicalUnknownFlagThrow, hasEarlierAbruptCompletion, hasOnlyCanonicalParserEffects, isAllowedSyncHelperTopLevelStatement, isCanonicalSyncMainCatchHandler, unwrapStaticExpression, } from './cli-doctor-standalone-control-flow.js';
+import { hasTypeScriptSyntaxErrors, isProjectLocalRelativePath, isSafeProjectRelativePath, } from './cli-doctor-standalone-shared.js';
 import { checkStandaloneRestArtifacts, parseStandaloneRestConfig, STANDALONE_PERSISTENCE_BLOCK_SCHEMA_ARTIFACTS, standaloneProjectRequiresRest, } from './cli-doctor-standalone-rest.js';
 const STANDALONE_SYNC_SCRIPT = path.join('scripts', 'sync-types-to-block-json.ts');
 const STANDALONE_SYNC_PROJECT_SCRIPT = path.join('scripts', 'sync-project.ts');
@@ -496,26 +497,6 @@ function findSyncOptionsObject(sourceFile, syncImportBindings) {
         ? call.options
         : null;
 }
-function hasTypeScriptSyntaxErrors(source, fileName) {
-    const result = ts.transpileModule(source, {
-        compilerOptions: { target: ts.ScriptTarget.Latest },
-        fileName,
-        reportDiagnostics: true,
-    });
-    return (result.diagnostics ?? []).some((diagnostic) => diagnostic.category === ts.DiagnosticCategory.Error);
-}
-function isProjectLocalRelativePath(relativePath) {
-    return (relativePath.length > 0 &&
-        !relativePath.startsWith(`..${path.sep}`) &&
-        relativePath !== '..' &&
-        !path.isAbsolute(relativePath));
-}
-function isSafeProjectRelativePath(projectDir, filePath) {
-    if (path.isAbsolute(filePath)) {
-        return false;
-    }
-    return isProjectLocalRelativePath(path.relative(projectDir, path.resolve(projectDir, filePath)));
-}
 function parseStandaloneSyncConfig(project) {
     const syncScriptPath = path.join(project.projectDir, STANDALONE_SYNC_SCRIPT);
     let source;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wp-typia/project-tools",
-  "version": "0.24.12",
+  "version": "0.24.13",
   "description": "Project orchestration and programmatic tooling for wp-typia",
   "packageManager": "bun@1.3.11",
   "type": "module",
@@ -126,8 +126,8 @@
     "postpack": "node ./scripts/publish-manifest.mjs restore",
     "test": "bun run build && bun test tests/*.test.ts",
     "test:quick": "bun run build && bun test tests/workspace-add.test.ts tests/cli-add-workspace-ability.test.ts tests/cli-add-workspace-ai.test.ts tests/workspace-doctor.test.ts tests/scaffold-compound.test.ts",
-    "test:scaffold-core": "bun run build && bun test tests/block-generator-service.test.ts tests/built-in-block-artifacts.test.ts tests/scaffold-basic.test.ts tests/scaffold-persistence.test.ts tests/template-source.test.ts tests/init-command.test.ts tests/package-versions.test.ts tests/cli-entry.test.ts tests/cli-prompt.test.ts tests/import-policy.test.ts tests/wordpress-ai-spec.test.ts tests/typia-llm.test.ts",
-    "test:workspace": "bun run build && bun test tests/workspace-add.test.ts tests/cli-add-workspace-ability.test.ts tests/cli-add-workspace-ai.test.ts tests/workspace-doctor.test.ts",
+    "test:scaffold-core": "bun run build && bun test tests/block-generator-service.test.ts tests/built-in-block-artifacts.test.ts tests/cli-doctor-boundaries.test.ts tests/cli-doctor-standalone-shared.test.ts tests/scaffold-basic.test.ts tests/scaffold-persistence.test.ts tests/template-source.test.ts tests/init-command.test.ts tests/package-versions.test.ts tests/cli-entry.test.ts tests/cli-prompt.test.ts tests/import-policy.test.ts tests/wordpress-ai-spec.test.ts tests/typia-llm.test.ts",
+    "test:workspace": "bun run build && bun test tests/cli-add-workspace-mutation.test.ts tests/cli-add-workspace-boundaries.test.ts tests/workspace-add.test.ts tests/cli-add-workspace-ability.test.ts tests/cli-add-workspace-ai.test.ts tests/workspace-doctor.test.ts",
     "test:compound": "bun run build && bun test tests/scaffold-compound.test.ts",
     "test:migration-planning": "bun run build && bun test tests/migration-init.test.ts tests/migration-config.test.ts tests/migration-plan-wizard.test.ts",
     "test:migration-execution": "bun run build && bun test tests/migration-scaffold-diff.test.ts tests/migration-doctor.test.ts tests/migration-fixtures-fuzz.test.ts",