@wp-typia/project-tools 0.24.11 → 0.24.13

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.d.ts

@@ -0,0 +1,32 @@
+import type { DoctorCheck } from './cli-doctor.js';
+import type { GeneratedPackageJson } from '../shared/package-json-types.js';
+/** Stable codes emitted by standalone-scaffold doctor rows. */
+export declare const STANDALONE_DOCTOR_CODES: {
+    readonly ARTIFACTS: "wp-typia.standalone.generated-artifacts";
+    readonly BOOTSTRAP: "wp-typia.standalone.bootstrap";
+    readonly DEPENDENCIES: "wp-typia.standalone.dependencies";
+    readonly PACKAGE: "wp-typia.standalone.package";
+    readonly SOURCE_LAYOUT: "wp-typia.standalone.source-layout";
+};
+type StandalonePackageJson = GeneratedPackageJson;
+/** A safely detected type-derived standalone wp-typia block project. */
+export interface StandaloneScaffoldProject {
+    packageJson: StandalonePackageJson;
+    packageName: string;
+    projectDir: string;
+}
+/**
+ * Resolve the nearest supported type-derived standalone scaffold.
+ *
+ * Detection deliberately combines generated sync/layout signals with wp-typia
+ * dependency signals. Requiring every signal would make a damaged scaffold
+ * fall back to the misleading environment-only scope, while the weighted
+ * threshold avoids treating an arbitrary WordPress package as generated merely
+ * because it contains one similarly named file or dependency.
+ *
+ * @throws {Error} When the nearest package manifest cannot be parsed.
+ */
+export declare function tryResolveStandaloneScaffoldProject(startDir: string): StandaloneScaffoldProject | null;
+/** Collect project-scoped checks for one supported standalone scaffold. */
+export declare function getStandaloneScaffoldDoctorChecks(project: StandaloneScaffoldProject): Promise<DoctorCheck[]>;
+export {};