@wp-typia/project-tools 0.20.1 → 0.21.0

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

@@ -2,10 +2,8 @@ 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 { hasPhpFunctionDefinition } from "./php-utils.js";
 const AI_FEATURE_SERVER_GLOB = "/inc/ai-features/*.php";
-function escapeRegex(value) {
-    return value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
-}
 /**
  * Patch the workspace bootstrap file so it loads generated AI feature PHP modules.
  */
@@ -27,7 +25,6 @@ function ${registerFunctionName}() {
             /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}`);
@@ -46,7 +43,7 @@ function ${registerFunctionName}() {
             }
             nextSource = `${nextSource.trimEnd()}\n${snippet}\n`;
         };
-        if (!hasPhpFunctionDefinition(registerFunctionName)) {
+        if (!hasPhpFunctionDefinition(nextSource, registerFunctionName)) {
             insertPhpSnippet(registerFunction);
         }
         else if (!nextSource.includes(AI_FEATURE_SERVER_GLOB)) {

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

@@ -1,7 +1,3 @@
-/**
- * Convert an AI feature slug into the PascalCase identifier used by generated types.
- */
-export declare function toPascalCaseFromAiFeatureSlug(slug: string): string;
 /**
  * Build the workspace inventory entry written into `scripts/block-config.ts` for one AI feature.
  */

package/dist/runtime/cli-add-workspace-ai-source-emitters.js

@@ -1,17 +1,7 @@
-import { normalizeBlockSlug, quoteTsString, } from "./cli-add-shared.js";
+import { quoteTsString } from "./cli-add-shared.js";
 import { buildAiFeatureEndpointManifest } from "./ai-feature-artifacts.js";
 import { OPTIONAL_WORDPRESS_AI_CLIENT_COMPATIBILITY, renderScaffoldCompatibilityConfig, resolveScaffoldCompatibilityPolicy, } from "./scaffold-compatibility.js";
-import { toTitleCase } from "./string-case.js";
-/**
- * Convert an AI feature slug into the PascalCase identifier used by generated types.
- */
-export function toPascalCaseFromAiFeatureSlug(slug) {
-    return normalizeBlockSlug(slug)
-        .split("-")
-        .filter(Boolean)
-        .map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1))
-        .join("");
-}
+import { toPascalCase, toTitleCase } from "./string-case.js";
 function indentMultiline(source, prefix) {
     return source
         .split("\n")
@@ -22,7 +12,7 @@ function indentMultiline(source, prefix) {
  * Build the workspace inventory entry written into `scripts/block-config.ts` for one AI feature.
  */
 export function buildAiFeatureConfigEntry(aiFeatureSlug, namespace) {
-    const pascalCase = toPascalCaseFromAiFeatureSlug(aiFeatureSlug);
+    const pascalCase = toPascalCase(aiFeatureSlug);
     const title = toTitleCase(aiFeatureSlug);
     const compatibilityPolicy = resolveScaffoldCompatibilityPolicy(OPTIONAL_WORDPRESS_AI_CLIENT_COMPATIBILITY);
     const manifest = buildAiFeatureEndpointManifest({
@@ -54,7 +44,7 @@ export function buildAiFeatureConfigEntry(aiFeatureSlug, namespace) {
  * Generate TypeScript request, response, and telemetry contracts for an AI feature scaffold.
  */
 export function buildAiFeatureTypesSource(aiFeatureSlug) {
-    const pascalCase = toPascalCaseFromAiFeatureSlug(aiFeatureSlug);
+    const pascalCase = toPascalCase(aiFeatureSlug);
     return `import { tags } from 'typia';
 
 export interface ${pascalCase}AiFeatureRequest {
@@ -95,7 +85,7 @@ export interface ${pascalCase}AiFeatureResponse {
  * Generate runtime validators for the AI feature request/result/response contracts.
  */
 export function buildAiFeatureValidatorsSource(aiFeatureSlug) {
-    const pascalCase = toPascalCaseFromAiFeatureSlug(aiFeatureSlug);
+    const pascalCase = toPascalCase(aiFeatureSlug);
     return `import typia from 'typia';
 
 import { toValidationResult } from '@wp-typia/rest';
@@ -129,7 +119,7 @@ export const apiValidators = {
  * Generate the typed client wrapper that calls the scaffolded AI feature endpoint.
  */
 export function buildAiFeatureApiSource(aiFeatureSlug) {
-    const pascalCase = toPascalCaseFromAiFeatureSlug(aiFeatureSlug);
+    const pascalCase = toPascalCase(aiFeatureSlug);
     return `import {
 \tcallEndpoint,
 \tresolveRestRouteUrl,
@@ -187,7 +177,7 @@ export function runAiFeature( request: ${pascalCase}AiFeatureRequest ) {
  * Generate React endpoint-mutation hooks for the scaffolded AI feature client wrapper.
  */
 export function buildAiFeatureDataSource(aiFeatureSlug) {
-    const pascalCase = toPascalCaseFromAiFeatureSlug(aiFeatureSlug);
+    const pascalCase = toPascalCase(aiFeatureSlug);
     return `import {
 \tuseEndpointMutation,
 \ttype UseEndpointMutationOptions,

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

@@ -2,16 +2,14 @@ import { promises as fsp } from "node:fs";
 import path from "node:path";
 import { assertAiFeatureDoesNotExist, assertValidGeneratedSlug, getWorkspaceBootstrapPath, normalizeBlockSlug, patchFile, resolveRestResourceNamespace, rollbackWorkspaceMutation, snapshotWorkspaceFiles, } from "./cli-add-shared.js";
 import { ensureBlockConfigCanAddRestManifests } from "./cli-add-block-legacy-validator.js";
-import { buildAiFeatureConfigEntry, buildAiFeatureDataSource, buildAiFeatureSyncScriptSource, buildAiFeatureTypesSource, buildAiFeatureValidatorsSource, buildAiFeatureApiSource, toPascalCaseFromAiFeatureSlug, } from "./cli-add-workspace-ai-source-emitters.js";
+import { buildAiFeatureConfigEntry, buildAiFeatureDataSource, buildAiFeatureSyncScriptSource, buildAiFeatureTypesSource, buildAiFeatureValidatorsSource, buildAiFeatureApiSource, } from "./cli-add-workspace-ai-source-emitters.js";
 import { ensureAiFeatureBootstrapAnchors, ensureAiFeaturePackageScripts, ensureAiFeatureSyncProjectAnchors, ensureAiFeatureSyncRestAnchors, } from "./cli-add-workspace-ai-anchors.js";
 import { syncAiFeatureRestArtifacts, syncAiFeatureSchemaArtifact, } from "./ai-feature-artifacts.js";
 import { appendWorkspaceInventoryEntries, readWorkspaceInventory } from "./workspace-inventory.js";
 import { resolveWorkspaceProject } from "./workspace-project.js";
 import { OPTIONAL_WORDPRESS_AI_CLIENT_COMPATIBILITY, resolveScaffoldCompatibilityPolicy, updatePluginHeaderCompatibility, } from "./scaffold-compatibility.js";
-import { toTitleCase } from "./string-case.js";
-function quotePhpString(value) {
-    return `'${value.replace(/\\/gu, "\\\\").replace(/'/gu, "\\'")}'`;
-}
+import { quotePhpString } from "./php-utils.js";
+import { toPascalCase, toTitleCase } from "./string-case.js";
 function buildAiFeaturePhpSource(aiFeatureSlug, namespace, phpPrefix, textDomain) {
     const aiFeatureTitle = toTitleCase(aiFeatureSlug);
     const aiFeaturePhpId = aiFeatureSlug.replace(/-/g, "_");
@@ -441,7 +439,7 @@ export async function runAddAiFeatureCommand({ aiFeatureName, cwd = process.cwd(
         await fsp.writeFile(apiFilePath, buildAiFeatureApiSource(aiFeatureSlug), "utf8");
         await fsp.writeFile(dataFilePath, buildAiFeatureDataSource(aiFeatureSlug), "utf8");
         await fsp.writeFile(phpFilePath, buildAiFeaturePhpSource(aiFeatureSlug, resolvedNamespace, workspace.workspace.phpPrefix, workspace.workspace.textDomain), "utf8");
-        const pascalCase = toPascalCaseFromAiFeatureSlug(aiFeatureSlug);
+        const pascalCase = toPascalCase(aiFeatureSlug);
         await syncAiFeatureRestArtifacts({
             clientFile: `src/ai-features/${aiFeatureSlug}/api-client.ts`,
             outputDir: path.join("src", "ai-features", aiFeatureSlug),

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

@@ -7,7 +7,7 @@ import { type RunAddBindingSourceCommandOptions, type RunAddEditorPluginCommandO
  * Defaults to `process.cwd()`.
  * @param options.editorPluginName Human-entered editor-plugin name that will be
  * normalized and validated before files are written.
- * @param options.slot Optional editor plugin shell slot. Defaults to `PluginSidebar`.
+ * @param options.slot Optional editor plugin shell slot. Defaults to `sidebar`.
  * @returns A promise that resolves with the normalized `editorPluginSlug`, chosen
  * `slot`, and owning `projectDir` after the scaffold files and inventory entry
  * are written successfully.
@@ -42,17 +42,25 @@ export declare function runAddPatternCommand({ cwd, patternName, }: RunAddPatter
  * Add one block binding source scaffold to an official workspace project.
  *
  * @param options Command options for the binding-source scaffold workflow.
+ * @param options.attributeName Optional generated block attribute to declare as
+ * bindable. Must be provided together with `blockName`.
+ * @param options.blockName Optional generated block slug or full block name to
+ * receive the bindable attribute wiring. Must be provided together with
+ * `attributeName`.
  * @param options.bindingSourceName Human-entered binding source name that will
  * be normalized and validated before files are written.
  * @param options.cwd Working directory used to resolve the nearest official
  * workspace. Defaults to `process.cwd()`.
  * @returns A promise that resolves with the normalized `bindingSourceSlug` and
- * owning `projectDir` after the server/editor files and inventory entry have
- * been written successfully.
+ * owning `projectDir` after the server/editor files, optional target block
+ * metadata, and inventory entry have been written successfully.
  * @throws {Error} When the command is run outside an official workspace, when
- * the slug is invalid, or when a conflicting file or inventory entry exists.
+ * the slug is invalid, when a binding target is incomplete or unknown, or when
+ * a conflicting file or inventory entry exists.
  */
-export declare function runAddBindingSourceCommand({ bindingSourceName, cwd, }: RunAddBindingSourceCommandOptions): Promise<{
+export declare function runAddBindingSourceCommand({ attributeName, bindingSourceName, blockName, cwd, }: RunAddBindingSourceCommandOptions): Promise<{
+    attributeName?: string;
     bindingSourceSlug: string;
+    blockSlug?: string;
     projectDir: string;
 }>;