@wp-typia/project-tools 0.24.4 → 0.24.6

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

@@ -1,89 +1 @@
-import { suggestCloseId } from "./id-suggestions.js";
-import { PATTERN_CATALOG_SCOPE_IDS, PATTERN_SECTION_ROLE_PATTERN, PATTERN_TAG_PATTERN, } from "./pattern-catalog.js";
-export { ADD_KIND_IDS } from "./cli-add-kind-ids.js";
-export { PATTERN_CATALOG_SCOPE_IDS, PATTERN_SECTION_ROLE_PATTERN, PATTERN_TAG_PATTERN, };
-/**
- * Supported plugin-level REST resource methods accepted by
- * `wp-typia add rest-resource --methods`.
- */
-export const REST_RESOURCE_METHOD_IDS = [
-    "list",
-    "read",
-    "create",
-    "update",
-    "delete",
-];
-/**
- * Supported HTTP methods accepted by manual REST contract mode.
- */
-export const MANUAL_REST_CONTRACT_HTTP_METHOD_IDS = [
-    "DELETE",
-    "GET",
-    "PATCH",
-    "POST",
-    "PUT",
-];
-/**
- * Supported auth intent values accepted by manual REST contract mode.
- */
-export const MANUAL_REST_CONTRACT_AUTH_IDS = [
-    "authenticated",
-    "public",
-    "public-write-protected",
-];
-/**
- * Canonical editor-plugin shell surface ids accepted by
- * `wp-typia add editor-plugin --slot`.
- */
-export const EDITOR_PLUGIN_SLOT_IDS = ["sidebar", "document-setting-panel"];
-/**
- * Legacy and canonical editor-plugin slot aliases keyed by user-facing input.
- */
-export const EDITOR_PLUGIN_SLOT_ALIASES = {
-    PluginDocumentSettingPanel: "document-setting-panel",
-    PluginSidebar: "sidebar",
-    "document-setting-panel": "document-setting-panel",
-    sidebar: "sidebar",
-};
-/**
- * Resolve a user-provided editor-plugin slot alias to its canonical id.
- *
- * @param slot Raw slot value from CLI input.
- * @returns The canonical slot id, or `undefined` when unsupported.
- */
-export function resolveEditorPluginSlotAlias(slot) {
-    const trimmed = slot.trim();
-    if (!Object.prototype.hasOwnProperty.call(EDITOR_PLUGIN_SLOT_ALIASES, trimmed)) {
-        return undefined;
-    }
-    return EDITOR_PLUGIN_SLOT_ALIASES[trimmed];
-}
-/**
- * Optional local service starter ids accepted by
- * `wp-typia add integration-env --service`.
- */
-export const INTEGRATION_ENV_SERVICE_IDS = [
-    "none",
-    "docker-compose",
-];
-/**
- * Supported built-in block families accepted by `wp-typia add block --template`.
- */
-export const ADD_BLOCK_TEMPLATE_IDS = [
-    "basic",
-    "interactivity",
-    "persistence",
-    "compound",
-];
-/**
- * Suggest the closest supported add-block template id for typo diagnostics.
- *
- * @param templateId Raw `wp-typia add block --template` value.
- * @returns The closest supported template id when it is within the shared
- * close-id threshold, otherwise `null`.
- */
-export function suggestAddBlockTemplateId(templateId) {
-    return suggestCloseId(templateId, ADD_BLOCK_TEMPLATE_IDS, {
-        maxDistance: 3,
-    });
-}
+export * from "./add/cli-add-types.js";

package/dist/runtime/cli-add-validation.d.ts

@@ -1,183 +1 @@
-import { type HookedBlockPositionId } from "./hooked-blocks.js";
-import { type AddBlockTemplateId, type EditorPluginSlotId, type IntegrationEnvServiceId, type ManualRestContractAuthId, type ManualRestContractHttpMethodId, type RestResourceMethodId } from "./cli-add-types.js";
-/**
- * Namespace format accepted by plugin-level REST resources.
- */
-export declare const REST_RESOURCE_NAMESPACE_PATTERN: RegExp;
-/**
- * Validate a normalized workspace-generated slug.
- *
- * @param label Human-readable field label used in error messages.
- * @param slug Normalized slug value to validate.
- * @param usage CLI usage hint shown when the slug is empty.
- * @returns The validated slug.
- * @throws {Error} When the slug is empty or contains unsupported characters.
- */
-export declare function assertValidGeneratedSlug(label: string, slug: string, usage: string): string;
-/**
- * Validate a source type name used by generated schema artifact workflows.
- *
- * @param label Human-readable field label used in error messages.
- * @param value TypeScript identifier candidate from CLI input or defaults.
- * @param usage CLI usage hint shown when the identifier is empty.
- * @returns The trimmed, validated TypeScript identifier.
- * @throws {Error} When the value is empty or not a TypeScript identifier.
- */
-export declare function assertValidTypeScriptIdentifier(label: string, value: string, usage: string): string;
-/**
- * Validate a REST resource namespace.
- *
- * @param namespace Namespace candidate such as `vendor/v1`.
- * @returns The trimmed namespace.
- * @throws {Error} When the namespace is empty or not lowercase slash-separated.
- */
-export declare function assertValidRestResourceNamespace(namespace: string): string;
-/**
- * Resolve the effective REST resource namespace for a workspace.
- *
- * @param workspaceNamespace Default workspace namespace prefix.
- * @param namespace Optional explicit namespace from CLI input.
- * @returns A validated namespace, defaulting to `<workspaceNamespace>/v1`.
- * @throws {Error} When the resolved namespace is invalid.
- */
-export declare function resolveRestResourceNamespace(workspaceNamespace: string, namespace?: string): string;
-/**
- * Validate a WordPress post type key used as post-meta scope.
- *
- * @param postType Raw post type key from CLI input.
- * @returns The trimmed post type key.
- * @throws {Error} When the key is empty or contains unsupported characters.
- */
-export declare function assertValidPostMetaPostType(postType: string): string;
-/**
- * Resolve a post-meta key from explicit input or the workspace slug default.
- *
- * @param options Optional explicit meta key plus workspace prefix and slug.
- * @returns A validated post-meta key.
- * @throws {Error} When the key is empty or contains whitespace/control characters.
- */
-export declare function resolvePostMetaKey({ metaKey, phpPrefix, slug, }: {
-    metaKey?: string;
-    phpPrefix: string;
-    slug: string;
-}): string;
-/**
- * Parse and validate REST resource method ids from a comma-separated list.
- *
- * @param methods Optional comma-separated method list. Defaults to list, read, and create.
- * @returns Deduplicated canonical REST resource method ids.
- * @throws {Error} When any method is unsupported or the list is empty.
- */
-export declare function assertValidRestResourceMethods(methods?: string): RestResourceMethodId[];
-/**
- * Validate a PHP callable reference supplied to generated REST route metadata.
- *
- * @param label Human-readable field label for errors.
- * @param callback Optional PHP function or `ClassName::method` callback string.
- * @returns The trimmed callback when present.
- * @throws {Error} When the callback cannot be emitted as a safe PHP callable string.
- */
-export declare function resolveOptionalPhpCallbackReference(label: string, callback?: string): string | undefined;
-/**
- * Validate a PHP class reference used by generated REST controller wrappers.
- *
- * @param label Human-readable field label for errors.
- * @param classReference Optional PHP class name.
- * @returns The trimmed class reference when present.
- * @throws {Error} When the class reference cannot be emitted safely.
- */
-export declare function resolveOptionalPhpClassReference(label: string, classReference?: string): string | undefined;
-/**
- * Normalize and validate the HTTP method used by a manual REST contract.
- *
- * @param method Optional method input. Defaults to GET.
- * @returns A canonical uppercase HTTP method.
- * @throws {Error} When the method is unsupported.
- */
-export declare function assertValidManualRestContractHttpMethod(method?: string): ManualRestContractHttpMethodId;
-/**
- * Normalize and validate the auth intent used by a manual REST contract.
- *
- * @param auth Optional auth intent input. Defaults to public.
- * @returns A canonical auth intent.
- * @throws {Error} When the auth intent is unsupported.
- */
-export declare function assertValidManualRestContractAuth(auth?: string): ManualRestContractAuthId;
-/**
- * Check whether a generated REST item route keeps the generated `id` contract aligned.
- *
- * @param routePattern Route pattern relative to the namespace.
- * @returns True when the pattern has no regex groups or uses only `(?P<id>...)`.
- */
-export declare function isGeneratedRestResourceRoutePatternCompatible(routePattern: string): boolean;
-/**
- * Collect unique WordPress named capture parameters from a REST route pattern.
- *
- * @param routePattern Route pattern relative to the namespace.
- * @returns Capture names in first-seen order.
- */
-export declare function collectRestRouteNamedCaptureNames(routePattern: string): string[];
-export declare function resolveManualRestContractPathPattern(slug: string, pathPattern?: string): string;
-/**
- * Normalize and validate a generated REST resource item route pattern.
- *
- * @param slug Generated resource slug used for the default item route path.
- * @param routePattern Optional route path pattern, relative to the namespace.
- * @returns A route pattern with a leading slash.
- * @throws {Error} When the route pattern is empty or clearly not a route path.
- */
-export declare function resolveGeneratedRestResourceRoutePattern(slug: string, routePattern?: string): string;
-/**
- * Validate a hooked block insertion position.
- *
- * @param position Position candidate from CLI input.
- * @returns The canonical hooked block position id.
- * @throws {Error} When the position is not supported.
- */
-export declare function assertValidHookedBlockPosition(position: string): HookedBlockPositionId;
-/**
- * Build a PHP-safe workspace identifier prefix for a generated artifact.
- *
- * @param workspacePhpPrefix Workspace PHP prefix from project metadata.
- * @param slug Generated artifact slug to append.
- * @returns Snake-case PHP prefix for generated identifiers.
- */
-export declare function buildWorkspacePhpPrefix(workspacePhpPrefix: string, slug: string): string;
-/**
- * Check whether a value is a supported built-in add block template id.
- *
- * @param value Candidate template id from CLI input.
- * @returns True when the value is an `AddBlockTemplateId`.
- */
-export declare function isAddBlockTemplateId(value: string): value is AddBlockTemplateId;
-/**
- * Quote a value for safe insertion into generated TypeScript source.
- *
- * @param value Raw string value.
- * @returns JSON-escaped TypeScript string literal.
- */
-export declare function quoteTsString(value: string): string;
-/**
- * Validate a full block name used as a hooked block anchor.
- *
- * @param anchorBlockName Anchor block name from CLI input.
- * @returns The trimmed full block name.
- * @throws {Error} When the anchor is empty or not `namespace/slug`.
- */
-export declare function assertValidHookAnchor(anchorBlockName: string): string;
-/**
- * Validate and normalize the editor plugin shell slot.
- *
- * @param slot Optional shell slot. Defaults to `sidebar`.
- * @returns The canonical editor plugin slot id.
- * @throws {Error} When the slot is not supported by the workspace scaffold.
- */
-export declare function assertValidEditorPluginSlot(slot?: string): EditorPluginSlotId;
-/**
- * Validate and normalize the optional integration environment service starter.
- *
- * @param service Optional service starter id. Defaults to `none`.
- * @returns The canonical integration environment service id.
- * @throws {Error} When the service starter is unsupported.
- */
-export declare function assertValidIntegrationEnvService(service?: string): IntegrationEnvServiceId;
+export * from "./add/cli-add-validation.js";