@wp-typia/project-tools 0.24.3 → 0.24.5

package/dist/runtime/persistence-rest-artifacts.js

@@ -1,99 +1 @@
-import path from "node:path";
-import { defineEndpointManifest, syncEndpointClient, syncRestOpenApi, syncTypeSchemas, } from "@wp-typia/block-runtime/metadata-core";
-/**
- * Build the canonical persistence REST endpoint manifest for scaffold-time
- * schema, OpenAPI, and client generation.
- *
- * @param variables Persistence template naming and auth metadata.
- * @returns Endpoint manifest covering bootstrap, state read, and state write operations.
- */
-export function buildPersistenceEndpointManifest(variables) {
-    return defineEndpointManifest({
-        contracts: {
-            "bootstrap-query": {
-                sourceTypeName: `${variables.pascalCase}BootstrapQuery`,
-            },
-            "bootstrap-response": {
-                sourceTypeName: `${variables.pascalCase}BootstrapResponse`,
-            },
-            "state-query": {
-                sourceTypeName: `${variables.pascalCase}StateQuery`,
-            },
-            "state-response": {
-                sourceTypeName: `${variables.pascalCase}StateResponse`,
-            },
-            "write-state-request": {
-                sourceTypeName: `${variables.pascalCase}WriteStateRequest`,
-            },
-        },
-        endpoints: [
-            {
-                auth: "public",
-                method: "GET",
-                operationId: `get${variables.pascalCase}State`,
-                path: `/${variables.namespace}/v1/${variables.slugKebabCase}/state`,
-                queryContract: "state-query",
-                responseContract: "state-response",
-                summary: "Read the current persisted state.",
-                tags: [variables.title],
-            },
-            {
-                auth: variables.restWriteAuthIntent,
-                bodyContract: "write-state-request",
-                method: "POST",
-                operationId: `write${variables.pascalCase}State`,
-                path: `/${variables.namespace}/v1/${variables.slugKebabCase}/state`,
-                responseContract: "state-response",
-                summary: "Write the current persisted state.",
-                tags: [variables.title],
-                wordpressAuth: {
-                    mechanism: variables.restWriteAuthMechanism,
-                },
-            },
-            {
-                auth: "public",
-                method: "GET",
-                operationId: `get${variables.pascalCase}Bootstrap`,
-                path: `/${variables.namespace}/v1/${variables.slugKebabCase}/bootstrap`,
-                queryContract: "bootstrap-query",
-                responseContract: "bootstrap-response",
-                summary: "Read fresh session bootstrap state for the current viewer.",
-                tags: [variables.title],
-            },
-        ],
-        info: {
-            title: `${variables.title} REST API`,
-            version: "1.0.0",
-        },
-    });
-}
-/**
- * Generate the REST-derived persistence artifacts for a scaffolded block.
- *
- * @param options Scaffold output paths plus persistence template variables.
- * @returns A promise that resolves after schema, OpenAPI, and client files are written.
- */
-export async function syncPersistenceRestArtifacts({ apiTypesFile, outputDir, projectDir, variables, }) {
-    const manifest = buildPersistenceEndpointManifest(variables);
-    for (const [baseName, contract] of Object.entries(manifest.contracts)) {
-        await syncTypeSchemas({
-            jsonSchemaFile: path.join(outputDir, "api-schemas", `${baseName}.schema.json`),
-            openApiFile: path.join(outputDir, "api-schemas", `${baseName}.openapi.json`),
-            projectRoot: projectDir,
-            sourceTypeName: contract.sourceTypeName,
-            typesFile: apiTypesFile,
-        });
-    }
-    await syncRestOpenApi({
-        manifest,
-        openApiFile: path.join(outputDir, "api.openapi.json"),
-        projectRoot: projectDir,
-        typesFile: apiTypesFile,
-    });
-    await syncEndpointClient({
-        clientFile: path.join(outputDir, "api-client.ts"),
-        manifest,
-        projectRoot: projectDir,
-        typesFile: apiTypesFile,
-    });
-}
+export * from "./add/persistence-rest-artifacts.js";

package/dist/runtime/php-utils.d.ts

@@ -1,32 +1 @@
-export type PhpFunctionRange = {
-    end: number;
-    source: string;
-    start: number;
-};
-export type PhpFunctionRangeOptions = {
-    includeTrailingNewlines?: boolean;
-};
-export type ReplacePhpFunctionDefinitionOptions = PhpFunctionRangeOptions & {
-    trimReplacementStart?: boolean;
-};
-export declare function escapeRegex(value: string): string;
-export declare function quotePhpString(value: string): string;
-export declare function hasPhpFunctionDefinition(source: string, functionName: string): boolean;
-/**
- * Detect a PHP function call outside strings, comments, heredoc, and nowdoc blocks.
- *
- * @param source PHP source to scan.
- * @param functionName Literal PHP function identifier to find.
- * @returns Whether `source` contains a code-mode call to `functionName`.
- */
-export declare function hasPhpFunctionCall(source: string, functionName: string): boolean;
-/**
- * Locate a PHP function body without counting braces in non-code regions.
- *
- * @param source PHP source to scan.
- * @param functionName Literal PHP function identifier to locate.
- * @param options Range options such as trailing newline inclusion.
- * @returns The matched {@link PhpFunctionRange}, or `null` when no safe range exists.
- */
-export declare function findPhpFunctionRange(source: string, functionName: string, options?: PhpFunctionRangeOptions): PhpFunctionRange | null;
-export declare function replacePhpFunctionDefinition(source: string, functionName: string, replacement: string, options?: ReplacePhpFunctionDefinitionOptions): string | null;
+export * from "./shared/php-utils.js";

package/dist/runtime/php-utils.js

@@ -1,382 +1 @@
-export function escapeRegex(value) {
-    return value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
-}
-export function quotePhpString(value) {
-    return `'${value.replace(/\\/gu, "\\\\").replace(/'/gu, "\\'")}'`;
-}
-export function hasPhpFunctionDefinition(source, functionName) {
-    return new RegExp(`function\\s+${escapeRegex(functionName)}\\s*\\(`, "u").test(source);
-}
-function isPhpIdentifierStart(character) {
-    return /^[A-Za-z_]$/u.test(character ?? "");
-}
-function isPhpIdentifierPart(character) {
-    return /^[A-Za-z0-9_]$/u.test(character ?? "");
-}
-function isPhpLineStart(source, index) {
-    return index === 0 || source[index - 1] === "\n";
-}
-function isPhpHorizontalWhitespace(character) {
-    return character === " " || character === "\t";
-}
-function isPhpWhitespace(character) {
-    return typeof character === "string" && /\s/u.test(character);
-}
-function findPhpLineBoundary(source, index) {
-    const newlineIndex = source.indexOf("\n", index);
-    if (newlineIndex === -1) {
-        return {
-            contentEnd: source.endsWith("\r") ? source.length - 1 : source.length,
-            nextStart: source.length,
-        };
-    }
-    return {
-        contentEnd: source[newlineIndex - 1] === "\r" ? newlineIndex - 1 : newlineIndex,
-        nextStart: newlineIndex + 1,
-    };
-}
-function parsePhpHeredocStart(source, index) {
-    if (!source.startsWith("<<<", index)) {
-        return null;
-    }
-    let cursor = index + 3;
-    while (isPhpHorizontalWhitespace(source[cursor])) {
-        cursor += 1;
-    }
-    const quote = source[cursor] === "'" || source[cursor] === '"' ? source[cursor] : "";
-    if (quote) {
-        cursor += 1;
-    }
-    if (!isPhpIdentifierStart(source[cursor])) {
-        return null;
-    }
-    const delimiterStart = cursor;
-    cursor += 1;
-    while (isPhpIdentifierPart(source[cursor])) {
-        cursor += 1;
-    }
-    const delimiter = source.slice(delimiterStart, cursor);
-    if (quote) {
-        if (source[cursor] !== quote) {
-            return null;
-        }
-        cursor += 1;
-    }
-    const lineBoundary = findPhpLineBoundary(source, cursor);
-    if (source.slice(cursor, lineBoundary.contentEnd).trim() !== "") {
-        return null;
-    }
-    return {
-        contentStart: lineBoundary.nextStart,
-        delimiter,
-    };
-}
-function findPhpHeredocClosingEnd(source, index, delimiter) {
-    if (!isPhpLineStart(source, index)) {
-        return null;
-    }
-    let cursor = index;
-    while (isPhpHorizontalWhitespace(source[cursor])) {
-        cursor += 1;
-    }
-    if (!source.startsWith(delimiter, cursor)) {
-        return null;
-    }
-    cursor += delimiter.length;
-    if (isPhpIdentifierPart(source[cursor])) {
-        return null;
-    }
-    let continuationCursor = cursor;
-    while (isPhpHorizontalWhitespace(source[continuationCursor])) {
-        continuationCursor += 1;
-    }
-    const continuation = source[continuationCursor];
-    if (continuationCursor >= source.length ||
-        continuation === "\r" ||
-        continuation === "\n" ||
-        !isPhpIdentifierPart(continuation)) {
-        return cursor;
-    }
-    return null;
-}
-function skipPhpCallTrivia(source, index) {
-    let cursor = index;
-    while (cursor < source.length) {
-        while (isPhpWhitespace(source[cursor])) {
-            cursor += 1;
-        }
-        if (source[cursor] === "/" && source[cursor + 1] === "*") {
-            const commentEnd = source.indexOf("*/", cursor + 2);
-            if (commentEnd === -1) {
-                return null;
-            }
-            cursor = commentEnd + 2;
-            continue;
-        }
-        if (source[cursor] === "/" && source[cursor + 1] === "/") {
-            cursor = findPhpLineBoundary(source, cursor + 2).nextStart;
-            continue;
-        }
-        if (source[cursor] === "#" && source[cursor + 1] !== "[") {
-            cursor = findPhpLineBoundary(source, cursor + 1).nextStart;
-            continue;
-        }
-        return cursor;
-    }
-    return cursor;
-}
-function matchesPhpFunctionCallAt(source, index, functionName) {
-    if (!source.startsWith(functionName, index)) {
-        return false;
-    }
-    if (isPhpIdentifierPart(source[index - 1])) {
-        return false;
-    }
-    const cursor = index + functionName.length;
-    if (isPhpIdentifierPart(source[cursor])) {
-        return false;
-    }
-    const callStart = skipPhpCallTrivia(source, cursor);
-    return callStart !== null && source[callStart] === "(";
-}
-function createPhpScannerState() {
-    return {
-        heredocDelimiter: "",
-        interpolationComment: "",
-        interpolationDepth: 0,
-        interpolationQuote: "",
-        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 (state.mode === "double-quoted" &&
-            character === "{" &&
-            source[index + 1] === "$") {
-            state.mode = "double-quoted-interpolation";
-            state.interpolationComment = "";
-            state.interpolationDepth = 1;
-            state.interpolationQuote = "";
-            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 === "double-quoted-interpolation") {
-        if (state.interpolationQuote) {
-            if (character === "\\") {
-                return { ambiguous: false, inCode: false, index: index + 2 };
-            }
-            if (character === state.interpolationQuote) {
-                state.interpolationQuote = "";
-            }
-            return { ambiguous: false, inCode: false, index: index + 1 };
-        }
-        if (state.interpolationComment === "line") {
-            if (character === "\r" || character === "\n") {
-                state.interpolationComment = "";
-            }
-            return { ambiguous: false, inCode: false, index: index + 1 };
-        }
-        if (state.interpolationComment === "block") {
-            if (character === "*" && source[index + 1] === "/") {
-                state.interpolationComment = "";
-                return { ambiguous: false, inCode: false, index: index + 2 };
-            }
-            return { ambiguous: false, inCode: false, index: index + 1 };
-        }
-        if (character === "/" && source[index + 1] === "/") {
-            state.interpolationComment = "line";
-            return { ambiguous: false, inCode: false, index: index + 2 };
-        }
-        if (character === "#" && source[index + 1] !== "[") {
-            state.interpolationComment = "line";
-            return { ambiguous: false, inCode: false, index: index + 1 };
-        }
-        if (character === "/" && source[index + 1] === "*") {
-            state.interpolationComment = "block";
-            return { ambiguous: false, inCode: false, index: index + 2 };
-        }
-        if (character === "'" || character === '"') {
-            state.interpolationQuote = character;
-            return { ambiguous: false, inCode: false, index: index + 1 };
-        }
-        if (character === "{") {
-            state.interpolationDepth += 1;
-            return { ambiguous: false, inCode: false, index: index + 1 };
-        }
-        if (character === "}") {
-            state.interpolationDepth -= 1;
-            if (state.interpolationDepth <= 0) {
-                state.interpolationComment = "";
-                state.interpolationDepth = 0;
-                state.mode = "double-quoted";
-            }
-            return { ambiguous: false, inCode: false, index: index + 1 };
-        }
-        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.
- *
- * @param source PHP source to scan.
- * @param functionName Literal PHP function identifier to find.
- * @returns Whether `source` contains a code-mode call to `functionName`.
- */
-export function hasPhpFunctionCall(source, functionName) {
-    const scanner = createPhpScannerState();
-    let index = 0;
-    while (index < source.length) {
-        const scan = advancePhpScanner(source, index, scanner);
-        if (scan.ambiguous) {
-            return false;
-        }
-        if (!scan.inCode) {
-            index = scan.index;
-            continue;
-        }
-        if (matchesPhpFunctionCallAt(source, index, functionName)) {
-            return true;
-        }
-        index += 1;
-    }
-    return false;
-}
-/**
- * Locate a PHP function body without counting braces in non-code regions.
- *
- * @param source PHP source to scan.
- * @param functionName Literal PHP function identifier to locate.
- * @param options Range options such as trailing newline inclusion.
- * @returns The matched {@link PhpFunctionRange}, or `null` when no safe range exists.
- */
-export function findPhpFunctionRange(source, functionName, options = {}) {
-    const signaturePattern = new RegExp(`function\\s+${escapeRegex(functionName)}\\s*\\([^)]*\\)\\s*(?::\\s*[^{};]+)?\\s*\\{`, "u");
-    const signatureMatch = signaturePattern.exec(source);
-    if (!signatureMatch) {
-        return null;
-    }
-    const functionStart = signatureMatch.index;
-    const openBraceOffset = signatureMatch[0].lastIndexOf("{");
-    if (openBraceOffset === -1) {
-        return null;
-    }
-    const openBraceIndex = functionStart + openBraceOffset;
-    let depth = 0;
-    const scanner = createPhpScannerState();
-    let index = openBraceIndex;
-    while (index < source.length) {
-        const scan = advancePhpScanner(source, index, scanner);
-        if (scan.ambiguous) {
-            return null;
-        }
-        if (!scan.inCode) {
-            index = scan.index;
-            continue;
-        }
-        const character = source[index];
-        if (character === "{") {
-            depth += 1;
-            index += 1;
-            continue;
-        }
-        if (character !== "}") {
-            index += 1;
-            continue;
-        }
-        depth -= 1;
-        if (depth === 0) {
-            let end = index + 1;
-            if (options.includeTrailingNewlines ?? true) {
-                while (end < source.length && /[\r\n]/u.test(source[end] ?? "")) {
-                    end += 1;
-                }
-            }
-            return {
-                end,
-                source: source.slice(functionStart, end),
-                start: functionStart,
-            };
-        }
-        index += 1;
-    }
-    return null;
-}
-export function replacePhpFunctionDefinition(source, functionName, replacement, options = {}) {
-    const functionRange = findPhpFunctionRange(source, functionName, options);
-    if (!functionRange) {
-        return null;
-    }
-    return [
-        source.slice(0, functionRange.start),
-        options.trimReplacementStart ? replacement.trimStart() : replacement,
-        source.slice(functionRange.end),
-    ].join("");
-}
+export * from "./shared/php-utils.js";

package/dist/runtime/post-meta-binding-fields.d.ts

@@ -1,46 +1 @@
-import type { WorkspacePostMetaInventoryEntry } from "./workspace-inventory-types.js";
-/**
- * Field metadata extracted from a typed post-meta schema for a generated block
- * bindings source.
- *
- * @property fallbackValue Editor preview value used when live post meta is unavailable.
- * @property label Human-readable label derived from the schema property name.
- * @property name Top-level schema property name used as the binding `field` arg.
- * @property required Whether the field is listed in the schema's required array.
- * @property schemaType Resolved JSON Schema type used to choose a preview value.
- */
-export interface PostMetaBindingField {
-    fallbackValue: string;
-    label: string;
-    name: string;
-    required: boolean;
-    schemaType: string;
-}
-/**
- * Load and extract binding fields from a post-meta JSON Schema artifact.
- *
- * @param projectDir Workspace root directory.
- * @param postMeta Post-meta inventory entry that points to the schema file.
- * @returns Promise resolving to the extracted top-level binding fields.
- * @throws If the schema cannot be read or does not expose object properties.
- */
-export declare function loadPostMetaBindingFields(projectDir: string, postMeta: WorkspacePostMetaInventoryEntry): Promise<PostMetaBindingField[]>;
-/**
- * Synchronously load and extract binding fields from a post-meta JSON Schema artifact.
- *
- * @param projectDir Workspace root directory.
- * @param postMeta Post-meta inventory entry that points to the schema file.
- * @returns Extracted top-level binding fields.
- * @throws If the schema cannot be read or does not expose object properties.
- */
-export declare function loadPostMetaBindingFieldsSync(projectDir: string, postMeta: WorkspacePostMetaInventoryEntry): PostMetaBindingField[];
-/**
- * Validate and resolve a top-level post-meta binding path.
- *
- * @param fields Binding fields extracted from the post-meta schema.
- * @param postMetaSlug Post-meta contract slug used in diagnostics.
- * @param metaPath User-provided field path to validate.
- * @returns The matching binding field.
- * @throws If the path is empty, nested, or missing from the schema fields.
- */
-export declare function assertPostMetaBindingPath(fields: readonly PostMetaBindingField[], postMetaSlug: string, metaPath: string): PostMetaBindingField;
+export * from "./add/post-meta-binding-fields.js";