@wp-typia/project-tools 0.19.0 → 0.19.2

package/dist/runtime/built-in-block-non-ts-render-utils.d.ts

@@ -0,0 +1,27 @@
+import type { BuiltInCodeArtifact } from "./built-in-block-code-artifacts.js";
+import type { ScaffoldTemplateVariables } from "./scaffold.js";
+/**
+ * Renders a non-TypeScript artifact and normalizes the output to a trailing newline.
+ *
+ * @param relativePath Relative output path for the generated artifact.
+ * @param template Mustache template source to render.
+ * @param view Template view data passed to the Mustache renderer.
+ * @returns A built-in code artifact with normalized source text.
+ */
+export declare function renderArtifact(relativePath: string, template: string, view: Record<string, unknown>): BuiltInCodeArtifact;
+/**
+ * Builds a PHP entrypoint for a specific alternate render target.
+ *
+ * @param relativePath Relative output path for the generated PHP file.
+ * @param target Alternate render target identifier to dispatch.
+ * @param variables Scaffold template variables used to render the entrypoint.
+ * @returns A built-in code artifact for the requested alternate render target.
+ */
+export declare function buildAlternateRenderEntryArtifact(relativePath: string, target: "email" | "mjml" | "plain-text" | "web", variables: ScaffoldTemplateVariables): BuiltInCodeArtifact;
+/**
+ * Escapes a string for safe embedding in a PHP single-quoted literal.
+ *
+ * @param value Source string to escape.
+ * @returns A PHP single-quoted string literal.
+ */
+export declare function toPhpSingleQuotedString(value: string): string;

package/dist/runtime/built-in-block-non-ts-render-utils.js

@@ -0,0 +1,51 @@
+import { renderMustacheTemplateString } from "./template-render.js";
+/**
+ * Renders a non-TypeScript artifact and normalizes the output to a trailing newline.
+ *
+ * @param relativePath Relative output path for the generated artifact.
+ * @param template Mustache template source to render.
+ * @param view Template view data passed to the Mustache renderer.
+ * @returns A built-in code artifact with normalized source text.
+ */
+export function renderArtifact(relativePath, template, view) {
+    const source = renderMustacheTemplateString(template, view);
+    return {
+        relativePath,
+        source: source.endsWith("\n") ? source : `${source}\n`,
+    };
+}
+/**
+ * Builds a PHP entrypoint for a specific alternate render target.
+ *
+ * @param relativePath Relative output path for the generated PHP file.
+ * @param target Alternate render target identifier to dispatch.
+ * @param variables Scaffold template variables used to render the entrypoint.
+ * @returns A built-in code artifact for the requested alternate render target.
+ */
+export function buildAlternateRenderEntryArtifact(relativePath, target, variables) {
+    const template = `<?php
+/**
+ * Alternate ${target} render entry for {{title}}.
+ *
+ * @package {{pascalCase}}
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+\texit;
+}
+
+require_once __DIR__ . '/render-targets.php';
+
+return {{phpPrefix}}_{{slugSnakeCase}}_render_target( '${target}', $attributes, $content ?? '', $block ?? null );
+`;
+    return renderArtifact(relativePath, template, variables);
+}
+/**
+ * Escapes a string for safe embedding in a PHP single-quoted literal.
+ *
+ * @param value Source string to escape.
+ * @returns A PHP single-quoted string literal.
+ */
+export function toPhpSingleQuotedString(value) {
+    return `'${value.replace(/\\/g, "\\\\").replace(/'/g, "\\'")}'`;
+}

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

@@ -1,6 +1,5 @@
 import fs from "node:fs";
 import { promises as fsp } from "node:fs";
-import os from "node:os";
 import path from "node:path";
 import { syncBlockMetadata, } from "@wp-typia/block-runtime/metadata-core";
 import { ensureMigrationDirectories, parseMigrationConfig, writeInitialMigrationScaffold, writeMigrationConfig, } from "./migration-project.js";
@@ -9,6 +8,7 @@ import { snapshotProjectVersion } from "./migrations.js";
 import { getDefaultAnswers, scaffoldProject } from "./scaffold.js";
 import { copyInterpolatedDirectory, listInterpolatedDirectoryOutputs, } from "./template-render.js";
 import { appendWorkspaceInventoryEntries, } from "./workspace-inventory.js";
+import { createManagedTempRoot } from "./temp-roots.js";
 import { resolveWorkspaceProject, } from "./workspace-project.js";
 import { ADD_BLOCK_TEMPLATE_IDS, buildWorkspacePhpPrefix, isAddBlockTemplateId, patchFile, readOptionalFile, rollbackWorkspaceMutation, snapshotWorkspaceFiles, } from "./cli-add-shared.js";
 import { resolveNonEmptyNormalizedBlockSlug, } from "./scaffold-identifiers.js";
@@ -310,6 +310,7 @@ export async function runAddBlockCommand({ alternateRenderTargets, blockName, cw
         selectExternalLayerId,
     });
     let tempRoot = "";
+    let cleanupTempRoot;
     try {
         const normalizedSlug = resolveNonEmptyNormalizedBlockSlug({
             input: blockName,
@@ -317,7 +318,10 @@ export async function runAddBlockCommand({ alternateRenderTargets, blockName, cw
             usage: "wp-typia add block <name> --template <family>",
         });
         const defaults = getDefaultAnswers(normalizedSlug, resolvedTemplateId);
-        tempRoot = await fsp.mkdtemp(path.join(os.tmpdir(), "wp-typia-add-block-"));
+        ({
+            path: tempRoot,
+            cleanup: cleanupTempRoot,
+        } = await createManagedTempRoot("wp-typia-add-block-"));
         const tempProjectDir = path.join(tempRoot, normalizedSlug);
         const blockConfigPath = path.join(workspace.projectDir, "scripts", "block-config.ts");
         const migrationConfigPath = path.join(workspace.projectDir, "src", "migrations", "config.ts");
@@ -397,9 +401,11 @@ export async function runAddBlockCommand({ alternateRenderTargets, blockName, cw
         }
     }
     finally {
-        await resolvedExternalLayerSelection.cleanup?.();
-        if (tempRoot) {
-            await fsp.rm(tempRoot, { force: true, recursive: true });
+        try {
+            await resolvedExternalLayerSelection.cleanup?.();
+        }
+        finally {
+            await cleanupTempRoot?.();
         }
     }
 }

package/dist/runtime/cli-add-workspace-rest-anchors.d.ts

@@ -0,0 +1,3 @@
+import type { WorkspaceProject } from "./workspace-project.js";
+export declare function ensureRestResourceBootstrapAnchors(workspace: WorkspaceProject): Promise<void>;
+export declare function ensureRestResourceSyncScriptAnchors(workspace: WorkspaceProject): Promise<void>;

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

@@ -0,0 +1,188 @@
+import path from "node:path";
+import { getWorkspaceBootstrapPath, patchFile, } from "./cli-add-shared.js";
+const REST_RESOURCE_SERVER_GLOB = "/inc/rest/*.php";
+function escapeRegex(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+}
+export async function ensureRestResourceBootstrapAnchors(workspace) {
+    const bootstrapPath = getWorkspaceBootstrapPath(workspace);
+    await patchFile(bootstrapPath, (source) => {
+        let nextSource = source;
+        const registerFunctionName = `${workspace.workspace.phpPrefix}_register_rest_resources`;
+        const registerHook = `add_action( 'init', '${registerFunctionName}', 20 );`;
+        const registerFunction = `
+
+function ${registerFunctionName}() {
+\tforeach ( glob( __DIR__ . '${REST_RESOURCE_SERVER_GLOB}' ) ?: array() as $rest_resource_module ) {
+\t\trequire_once $rest_resource_module;
+\t}
+}
+`;
+        const insertionAnchors = [
+            /add_action\(\s*["']init["']\s*,\s*["'][^"']+_load_textdomain["']\s*\);\s*\n/u,
+            /\?>\s*$/u,
+        ];
+        const hasPhpFunctionDefinition = (functionName) => new RegExp(`function\\s+${escapeRegex(functionName)}\\s*\\(`, "u").test(nextSource);
+        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(registerFunctionName)) {
+            insertPhpSnippet(registerFunction);
+        }
+        else if (!nextSource.includes(REST_RESOURCE_SERVER_GLOB)) {
+            throw new Error([
+                `Unable to patch ${path.basename(bootstrapPath)} in ensureRestResourceBootstrapAnchors.`,
+                `The existing ${registerFunctionName}() definition does not include ${REST_RESOURCE_SERVER_GLOB}.`,
+                "Restore the generated bootstrap shape or wire the REST resource loader manually before retrying.",
+            ].join(" "));
+        }
+        if (!nextSource.includes(registerHook)) {
+            appendPhpSnippet(registerHook);
+        }
+        return nextSource;
+    });
+}
+function assertSyncRestAnchor(nextSource, target, anchorDescription, hasAnchor, syncRestScriptPath) {
+    if (!nextSource.includes(target) && !hasAnchor) {
+        throw new Error([
+            `ensureRestResourceSyncScriptAnchors could not patch ${path.basename(syncRestScriptPath)}.`,
+            `Missing expected ${anchorDescription} anchor in scripts/sync-rest-contracts.ts.`,
+            "Restore the generated template or add the REST_RESOURCES wiring manually before retrying.",
+        ].join(" "));
+    }
+}
+function replaceRequiredSyncRestSource(nextSource, target, anchor, replacement, anchorDescription, syncRestScriptPath) {
+    if (nextSource.includes(target)) {
+        return nextSource;
+    }
+    const hasAnchor = typeof anchor === "string" ? nextSource.includes(anchor) : anchor.test(nextSource);
+    assertSyncRestAnchor(nextSource, target, anchorDescription, hasAnchor, syncRestScriptPath);
+    return nextSource.replace(anchor, replacement);
+}
+export async function ensureRestResourceSyncScriptAnchors(workspace) {
+    const syncRestScriptPath = path.join(workspace.projectDir, "scripts", "sync-rest-contracts.ts");
+    await patchFile(syncRestScriptPath, (source) => {
+        let nextSource = source;
+        const importAnchor = "import { BLOCKS, type WorkspaceBlockConfig } from './block-config';";
+        const helperInsertionAnchor = "async function assertTypeArtifactsCurrent";
+        const restBlocksAnchor = "const restBlocks = BLOCKS.filter( isRestEnabledBlock );";
+        const noResourcesPattern = /if \( restBlocks.length === 0 \) \{[\s\S]*?\n\t\treturn;\n\t\}/u;
+        const consoleLogPattern = /\n\tconsole\.log\(\n\t\toptions\.check/u;
+        nextSource = replaceRequiredSyncRestSource(nextSource, "REST_RESOURCES", importAnchor, [
+            "import {",
+            "\tBLOCKS,",
+            "\tREST_RESOURCES,",
+            "\ttype WorkspaceBlockConfig,",
+            "\ttype WorkspaceRestResourceConfig,",
+            "} from './block-config';",
+        ].join("\n"), "BLOCKS import", syncRestScriptPath);
+        nextSource = replaceRequiredSyncRestSource(nextSource, "function isWorkspaceRestResource(", helperInsertionAnchor, [
+            "function isWorkspaceRestResource(",
+            "\tresource: WorkspaceRestResourceConfig",
+            "): resource is WorkspaceRestResourceConfig & {",
+            "\tclientFile: string;",
+            "\topenApiFile: string;",
+            "\trestManifest: NonNullable< WorkspaceRestResourceConfig[ 'restManifest' ] >;",
+            "\ttypesFile: string;",
+            "\tvalidatorsFile: string;",
+            "} {",
+            "\treturn (",
+            "\t\ttypeof resource.clientFile === 'string' &&",
+            "\t\ttypeof resource.openApiFile === 'string' &&",
+            "\t\ttypeof resource.typesFile === 'string' &&",
+            "\t\ttypeof resource.validatorsFile === 'string' &&",
+            "\t\ttypeof resource.restManifest === 'object' &&",
+            "\t\tresource.restManifest !== null",
+            "\t);",
+            "}",
+            "",
+            "async function assertTypeArtifactsCurrent",
+        ].join("\n"), "type artifact assertion helper", syncRestScriptPath);
+        nextSource = replaceRequiredSyncRestSource(nextSource, "const restResources = REST_RESOURCES.filter( isWorkspaceRestResource );", restBlocksAnchor, [
+            "const restBlocks = BLOCKS.filter( isRestEnabledBlock );",
+            "const restResources = REST_RESOURCES.filter( isWorkspaceRestResource );",
+        ].join("\n"), "restBlocks filter", syncRestScriptPath);
+        nextSource = replaceRequiredSyncRestSource(nextSource, "restBlocks.length === 0 && restResources.length === 0", noResourcesPattern, [
+            "if ( restBlocks.length === 0 && restResources.length === 0 ) {",
+            "\t\tconsole.log(",
+            "\t\t\toptions.check",
+            "\t\t\t\t? 'ℹ️ No REST-enabled workspace blocks or plugin-level REST resources are registered yet. `sync-rest --check` is already clean.'",
+            "\t\t\t\t: 'ℹ️ No REST-enabled workspace blocks or plugin-level REST resources are registered yet.'",
+            "\t\t);",
+            "\t\treturn;",
+            "\t}",
+        ].join("\n"), "no-resources guard", syncRestScriptPath);
+        nextSource = replaceRequiredSyncRestSource(nextSource, "for ( const resource of restResources ) {", consoleLogPattern, [
+            "",
+            "\tfor ( const resource of restResources ) {",
+            "\t\tconst contracts = resource.restManifest.contracts;",
+            "",
+            "\t\tfor ( const [ baseName, contract ] of Object.entries( contracts ) ) {",
+            "\t\t\tawait syncTypeSchemas(",
+            "\t\t\t\t{",
+            "\t\t\t\t\tjsonSchemaFile: path.join(",
+            "\t\t\t\t\t\tpath.dirname( resource.typesFile ),",
+            "\t\t\t\t\t\t'api-schemas',",
+            "\t\t\t\t\t\t`${ baseName }.schema.json`",
+            "\t\t\t\t\t),",
+            "\t\t\t\t\topenApiFile: path.join(",
+            "\t\t\t\t\t\tpath.dirname( resource.typesFile ),",
+            "\t\t\t\t\t\t'api-schemas',",
+            "\t\t\t\t\t\t`${ baseName }.openapi.json`",
+            "\t\t\t\t\t),",
+            "\t\t\t\t\tsourceTypeName: contract.sourceTypeName,",
+            "\t\t\t\t\ttypesFile: resource.typesFile,",
+            "\t\t\t\t},",
+            "\t\t\t\t{",
+            "\t\t\t\t\tcheck: options.check,",
+            "\t\t\t\t}",
+            "\t\t\t);",
+            "\t\t}",
+            "",
+            "\t\tawait syncRestOpenApi(",
+            "\t\t\t{",
+            "\t\t\t\tmanifest: resource.restManifest,",
+            "\t\t\t\topenApiFile: resource.openApiFile,",
+            "\t\t\t\ttypesFile: resource.typesFile,",
+            "\t\t\t},",
+            "\t\t\t{",
+            "\t\t\t\tcheck: options.check,",
+            "\t\t\t}",
+            "\t\t);",
+            "",
+            "\t\tawait syncEndpointClient(",
+            "\t\t\t{",
+            "\t\t\t\tclientFile: resource.clientFile,",
+            "\t\t\t\tmanifest: resource.restManifest,",
+            "\t\t\t\ttypesFile: resource.typesFile,",
+            "\t\t\t\tvalidatorsFile: resource.validatorsFile,",
+            "\t\t\t},",
+            "\t\t\t{",
+            "\t\t\t\tcheck: options.check,",
+            "\t\t\t}",
+            "\t\t);",
+            "\t}",
+            "",
+            "\tconsole.log(",
+            "\t\toptions.check",
+        ].join("\n"), "success log insertion point", syncRestScriptPath);
+        nextSource = nextSource.replace("✅ REST contract schemas, portable API clients, and endpoint-aware OpenAPI documents are already up to date with the TypeScript types!", "✅ REST contract schemas, portable API clients, and endpoint-aware OpenAPI documents are already up to date for workspace blocks and plugin-level resources!");
+        nextSource = nextSource.replace("✅ REST contract schemas, portable API clients, and endpoint-aware OpenAPI documents generated from TypeScript types!", "✅ REST contract schemas, portable API clients, and endpoint-aware OpenAPI documents generated for workspace blocks and plugin-level resources!");
+        return nextSource;
+    });
+}

package/dist/runtime/cli-add-workspace-rest-source-emitters.d.ts

@@ -0,0 +1,7 @@
+import { type RestResourceMethodId } from "./cli-add-shared.js";
+export declare function toPascalCaseFromSlug(slug: string): string;
+export declare function buildRestResourceConfigEntry(restResourceSlug: string, namespace: string, methods: RestResourceMethodId[]): string;
+export declare function buildRestResourceTypesSource(restResourceSlug: string, methods: RestResourceMethodId[]): string;
+export declare function buildRestResourceValidatorsSource(restResourceSlug: string, methods: RestResourceMethodId[]): string;
+export declare function buildRestResourceApiSource(restResourceSlug: string, methods: RestResourceMethodId[]): string;
+export declare function buildRestResourceDataSource(restResourceSlug: string, methods: RestResourceMethodId[]): string;