wp-typia 0.24.0 → 0.24.2

package/dist-bunli/{cli-v0nnagb3.js → cli-kbqztfkt.js}

@@ -170921,17 +170921,168 @@ Additional information: BADCLIENT: Bad error code, ${badCode} not found in range
   } });
 });
 
-// ../wp-typia-project-tools/src/runtime/pattern-catalog.ts
-import fs from "fs";
-import path from "path";
+// ../wp-typia-project-tools/src/runtime/string-case.ts
+var COMMON_ACRONYM_PREFIXES = [
+  "HTML",
+  "HTTP",
+  "JSON",
+  "REST",
+  "UUID",
+  "AJAX",
+  "API",
+  "CPT",
+  "CSS",
+  "CTA",
+  "DOM",
+  "PHP",
+  "SQL",
+  "SVG",
+  "URL",
+  "XML",
+  "ID",
+  "JS",
+  "UI",
+  "WP"
+];
+var COMMON_ACRONYM_LOWERCASE_SUFFIXES = ["slug"];
+function capitalizeSegment(segment) {
+  return segment.charAt(0).toUpperCase() + segment.slice(1);
+}
+function findCommonAcronymPrefix(segment) {
+  return COMMON_ACRONYM_PREFIXES.find((prefix) => segment.startsWith(prefix));
+}
+function isCommonAcronymLowercaseSuffix(suffix) {
+  return COMMON_ACRONYM_LOWERCASE_SUFFIXES.includes(suffix);
+}
+function splitKnownAcronymSegment(segment) {
+  const prefixes = [];
+  let remaining = segment;
+  while (remaining.length > 0) {
+    const prefix = findCommonAcronymPrefix(remaining);
+    if (!prefix) {
+      break;
+    }
+    const suffix = remaining.slice(prefix.length);
+    if (/^[A-Z][a-z]/.test(suffix)) {
+      return [...prefixes, prefix, suffix].join("-");
+    }
+    if (/^[a-z]+$/.test(suffix) && isCommonAcronymLowercaseSuffix(suffix)) {
+      return [...prefixes, prefix, suffix].join("-");
+    }
+    if (!findCommonAcronymPrefix(suffix)) {
+      break;
+    }
+    prefixes.push(prefix);
+    remaining = suffix;
+  }
+  return segment;
+}
+function splitAcronymBoundary(value) {
+  return value.replace(/[A-Z]{2,}[a-z]+/g, splitKnownAcronymSegment);
+}
+function toKebabCase(input) {
+  return splitAcronymBoundary(input.trim()).replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/[^A-Za-z0-9]+/g, "-").replace(/^-+|-+$/g, "").replace(/-{2,}/g, "-").toLowerCase();
+}
+function toSnakeCase(input) {
+  return toKebabCase(input).replace(/-/g, "_");
+}
+function toPascalCase(input) {
+  return toKebabCase(input).split("-").filter(Boolean).map(capitalizeSegment).join("");
+}
+function toCamelCase(input) {
+  const pascalCase = toPascalCase(input);
+  return `${pascalCase.charAt(0).toLowerCase()}${pascalCase.slice(1)}`;
+}
+function toSegmentPascalCase(input) {
+  return input.replace(/[^A-Za-z0-9]+/g, " ").trim().split(/\s+/).filter(Boolean).map(capitalizeSegment).join("");
+}
+function toTitleCase(input) {
+  return toKebabCase(input).split("-").filter(Boolean).map(capitalizeSegment).join(" ");
+}
+
+// ../wp-typia-project-tools/src/runtime/scaffold-identifiers.ts
+var BLOCK_SLUG_PATTERN = /^[a-z][a-z0-9-]*$/;
+var PHP_PREFIX_PATTERN = /^[a-z_][a-z0-9_]*$/;
+var PHP_PREFIX_MAX_LENGTH = 50;
+function validateBlockSlug(input) {
+  return BLOCK_SLUG_PATTERN.test(input) || "Use lowercase letters, numbers, and hyphens only";
+}
+function validateNamespace(input) {
+  return BLOCK_SLUG_PATTERN.test(toKebabCase(input)) ? true : "Use lowercase letters, numbers, and hyphens only";
+}
+function validateTextDomain(input) {
+  return BLOCK_SLUG_PATTERN.test(toKebabCase(input)) ? true : "Use lowercase letters, numbers, and hyphens only";
+}
+function validatePhpPrefix(input) {
+  const normalizedPrefix = toSnakeCase(input);
+  if (normalizedPrefix.length > PHP_PREFIX_MAX_LENGTH) {
+    return `Use ${PHP_PREFIX_MAX_LENGTH} characters or fewer to keep generated database identifiers within MySQL limits`;
+  }
+  return PHP_PREFIX_PATTERN.test(normalizedPrefix) ? true : "Use letters, numbers, and underscores only, starting with a letter";
+}
+function assertValidIdentifier(label, value, validate) {
+  const result = validate(value);
+  if (result !== true) {
+    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.INVALID_ARGUMENT, typeof result === "string" ? `${label}: ${result}` : `${label} is invalid`);
+  }
+  return value;
+}
+function normalizeBlockSlug(input) {
+  return toKebabCase(input);
+}
+function resolveNonEmptyNormalizedBlockSlug(options) {
+  const normalizedSlug = normalizeBlockSlug(options.input);
+  if (normalizedSlug.length > 0) {
+    return normalizedSlug;
+  }
+  if (options.input.trim().length === 0) {
+    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, `${options.label} is required. Use \`${options.usage}\`.`);
+  }
+  throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.INVALID_ARGUMENT, `${options.label} "${options.input.trim()}" normalizes to an empty slug. Use letters or numbers so wp-typia can generate a block slug.`);
+}
+function resolveValidatedBlockSlug(value) {
+  return assertValidIdentifier("Block slug", normalizeBlockSlug(value), validateBlockSlug);
+}
+function resolveValidatedNamespace(value) {
+  return assertValidIdentifier("Namespace", toKebabCase(value), validateNamespace);
+}
+function resolveValidatedTextDomain(value) {
+  return assertValidIdentifier("Text domain", toKebabCase(value), validateTextDomain);
+}
+function resolveValidatedPhpPrefix(value) {
+  return assertValidIdentifier("PHP prefix", toSnakeCase(value), validatePhpPrefix);
+}
+function buildBlockCssClassName(namespace, slug) {
+  const normalizedSlug = resolveValidatedBlockSlug(slug);
+  const normalizedNamespace = typeof namespace === "string" && namespace.trim().length > 0 ? resolveValidatedNamespace(namespace) : "";
+  if (normalizedNamespace === normalizedSlug) {
+    return `wp-block-${normalizedSlug}-block`;
+  }
+  return normalizedNamespace.length > 0 ? `wp-block-${normalizedNamespace}-${normalizedSlug}` : `wp-block-${normalizedSlug}`;
+}
+function buildFrontendCssClassName(blockCssClassName) {
+  return `${blockCssClassName}-frontend`;
+}
+function resolveScaffoldIdentifiers({
+  namespace,
+  phpPrefix,
+  slug,
+  textDomain
+}) {
+  const normalizedSlug = resolveValidatedBlockSlug(slug);
+  return {
+    namespace: resolveValidatedNamespace(namespace),
+    phpPrefix: resolveValidatedPhpPrefix(phpPrefix ?? normalizedSlug),
+    slug: normalizedSlug,
+    textDomain: resolveValidatedTextDomain(textDomain ?? normalizedSlug)
+  };
+}
+
+// ../wp-typia-project-tools/src/runtime/pattern-catalog-section-roles.ts
 import {
   validateBlockPatternContentNesting
 } from "@wp-typia/block-runtime/metadata-core";
-var PATTERN_CATALOG_SCOPE_IDS = ["full", "section"];
-var PATTERN_SLUG_PATTERN = /^[a-z][a-z0-9-]*$/u;
-var PATTERN_SECTION_ROLE_PATTERN = PATTERN_SLUG_PATTERN;
-var PATTERN_TAG_PATTERN = /^[a-z0-9][a-z0-9-]*$/u;
-var PATTERN_CONTENT_FILE_ROOT = "src/patterns/";
+var PATTERN_SECTION_ROLE_PATTERN = /^[a-z][a-z0-9-]*$/u;
 var DEFAULT_SECTION_ROLE_CONVENTION = {
   baseClassName: "section",
   requireUniqueFullPatternRoles: false,
@@ -170942,20 +171093,6 @@ var DEFAULT_SECTION_ROLE_CONVENTION = {
 function createPatternCatalogDiagnostic(diagnostic) {
   return diagnostic;
 }
-function isPatternCatalogScope(value) {
-  return PATTERN_CATALOG_SCOPE_IDS.includes(value);
-}
-function isSafeRelativePath(value) {
-  return value.length > 0 && !path.isAbsolute(value) && !value.includes("\\") && !value.split(/[\\/]+/u).includes("..") && !/[<>:"|?*\u0000-\u001F]/u.test(value);
-}
-function isPatternContentFilePath(value) {
-  if (!isSafeRelativePath(value) || !value.startsWith(PATTERN_CONTENT_FILE_ROOT) || !value.endsWith(".php")) {
-    return false;
-  }
-  const patternRelativePath = value.slice(PATTERN_CONTENT_FILE_ROOT.length);
-  const segments = patternRelativePath.split("/");
-  return (segments.length === 1 || segments.length === 2) && segments.every((segment) => segment.length > 0);
-}
 function normalizeSectionRoleConventionInput(convention = {}) {
   return {
     baseClassName: convention.baseClassName ?? DEFAULT_SECTION_ROLE_CONVENTION.baseClassName,
@@ -170975,7 +171112,7 @@ function createRoleClassNamePattern(pattern) {
   }
   return new RegExp(`^${escapeRegExp(parts[0] ?? "")}(?<role>\\S*)${escapeRegExp(parts[1] ?? "")}$`, "u");
 }
-function normalizeSectionRoleConvention(convention = {}) {
+function normalizePatternCatalogSectionRoleConvention(convention = {}) {
   const normalized = normalizeSectionRoleConventionInput(convention);
   return {
     ...normalized,
@@ -171037,7 +171174,7 @@ function collectSectionRoleMatches(blocks, convention, pathSegments = []) {
       `${block.blockName}[${index}]`
     ];
     const blockPath = blockPathSegments.join(" > ");
-    const roles = extractPatternSectionRolesFromAttributes(block.attributes, convention);
+    const roles = extractPatternSectionRolesFromNormalizedAttributes(block.attributes, convention);
     const matches = isSectionWrapperCandidate(block, roles, convention) ? [
       {
         blockName: block.blockName,
@@ -171060,27 +171197,12 @@ function unescapeSerializedBlockCommentJsonQuotes(content) {
     return `<!--${body.replace(/\\"/gu, '"')}-->`;
   });
 }
-function extractPatternSectionRolesFromAttributes(attributes, convention = {}) {
-  const normalized = normalizeSectionRoleConvention(convention);
+function extractPatternSectionRolesFromNormalizedAttributes(attributes, normalized) {
   const classRoles = getClassNameTokens(attributes).map((token) => normalized.roleClassNamePatternRegExp.exec(token)?.groups?.role).filter((role) => typeof role === "string");
   const attributeRoles = normalized.roleAttributePaths.flatMap((pathName) => collectStringValues(getAttributePathValue(attributes, pathName)));
   return uniqueValues([...classRoles, ...attributeRoles]);
 }
-function isValidPatternThumbnailUrl(value) {
-  if (value.length === 0) {
-    return false;
-  }
-  try {
-    const url = new URL(value);
-    return url.protocol === "http:" || url.protocol === "https:";
-  } catch {
-    return isSafeRelativePath(value);
-  }
-}
-function resolvePatternCatalogContentFile(pattern) {
-  return pattern.contentFile ?? pattern.file;
-}
-function createKnownSectionRoleSet(patterns) {
+function collectKnownPatternSectionRoles(patterns) {
   return new Set(patterns.map((pattern) => pattern.sectionRole).filter((sectionRole) => typeof sectionRole === "string" && PATTERN_SECTION_ROLE_PATTERN.test(sectionRole)));
 }
 function validatePatternContentSectionRoles({
@@ -171172,26 +171294,65 @@ function validatePatternContentSectionRoles({
   }
   return diagnostics;
 }
+
+// ../wp-typia-project-tools/src/runtime/pattern-catalog.ts
+import fs from "fs";
+import path from "path";
+var PATTERN_CATALOG_SCOPE_IDS = ["full", "section"];
+var PATTERN_SLUG_PATTERN = /^[a-z][a-z0-9-]*$/u;
+var PATTERN_TAG_PATTERN = /^[a-z0-9][a-z0-9-]*$/u;
+var PATTERN_CONTENT_FILE_ROOT = "src/patterns/";
+function createPatternCatalogDiagnostic2(diagnostic) {
+  return diagnostic;
+}
+function isPatternCatalogScope(value) {
+  return PATTERN_CATALOG_SCOPE_IDS.includes(value);
+}
+function isSafeRelativePath(value) {
+  return value.length > 0 && !path.isAbsolute(value) && !value.includes("\\") && !value.split(/[\\/]+/u).includes("..") && !/[<>:"|?*\u0000-\u001F]/u.test(value);
+}
+function isPatternContentFilePath(value) {
+  if (!isSafeRelativePath(value) || !value.startsWith(PATTERN_CONTENT_FILE_ROOT) || !value.endsWith(".php")) {
+    return false;
+  }
+  const patternRelativePath = value.slice(PATTERN_CONTENT_FILE_ROOT.length);
+  const segments = patternRelativePath.split("/");
+  return (segments.length === 1 || segments.length === 2) && segments.every((segment) => segment.length > 0);
+}
+function isValidPatternThumbnailUrl(value) {
+  if (value.length === 0) {
+    return false;
+  }
+  try {
+    const url = new URL(value);
+    return url.protocol === "http:" || url.protocol === "https:";
+  } catch {
+    return isSafeRelativePath(value);
+  }
+}
+function resolvePatternCatalogContentFile(pattern) {
+  return pattern.contentFile ?? pattern.file;
+}
 function validatePatternCatalog(patterns, options = {}) {
   const diagnostics = [];
   const seenSlugs = new Map;
   let sectionRoleConvention = null;
   if (options.sectionRoleConvention !== false) {
     try {
-      sectionRoleConvention = normalizeSectionRoleConvention(options.sectionRoleConvention);
+      sectionRoleConvention = normalizePatternCatalogSectionRoleConvention(options.sectionRoleConvention);
     } catch (error) {
-      diagnostics.push(createPatternCatalogDiagnostic({
+      diagnostics.push(createPatternCatalogDiagnostic2({
         code: "invalid-pattern-section-role-convention",
         message: `sectionRoleConvention.roleClassNamePattern is invalid: ${error instanceof Error ? error.message : String(error)}`,
         severity: "error"
       }));
     }
   }
-  const knownSectionRoles = createKnownSectionRoleSet(patterns);
+  const knownSectionRoles = collectKnownPatternSectionRoles(patterns);
   for (const [index, pattern] of patterns.entries()) {
     const label = pattern.slug || `PATTERNS[${index}]`;
     if (!PATTERN_SLUG_PATTERN.test(pattern.slug)) {
-      diagnostics.push(createPatternCatalogDiagnostic({
+      diagnostics.push(createPatternCatalogDiagnostic2({
         code: "invalid-pattern-slug",
         message: `${label}: slug must start with a lowercase letter and contain only lowercase letters, numbers, and hyphens.`,
         patternSlug: pattern.slug,
@@ -171200,7 +171361,7 @@ function validatePatternCatalog(patterns, options = {}) {
     }
     const previousIndex = seenSlugs.get(pattern.slug);
     if (previousIndex !== undefined) {
-      diagnostics.push(createPatternCatalogDiagnostic({
+      diagnostics.push(createPatternCatalogDiagnostic2({
         code: "duplicate-pattern-slug",
         message: `${label}: duplicate slug already declared at PATTERNS[${previousIndex}].`,
         patternSlug: pattern.slug,
@@ -171211,7 +171372,7 @@ function validatePatternCatalog(patterns, options = {}) {
     }
     const scope = pattern.scope ?? "full";
     if (!isPatternCatalogScope(scope)) {
-      diagnostics.push(createPatternCatalogDiagnostic({
+      diagnostics.push(createPatternCatalogDiagnostic2({
         code: "invalid-pattern-scope",
         message: `${label}: scope must be one of ${PATTERN_CATALOG_SCOPE_IDS.join(", ")}.`,
         patternSlug: pattern.slug,
@@ -171219,7 +171380,7 @@ function validatePatternCatalog(patterns, options = {}) {
       }));
     }
     if (scope === "section" && !pattern.sectionRole) {
-      diagnostics.push(createPatternCatalogDiagnostic({
+      diagnostics.push(createPatternCatalogDiagnostic2({
         code: "missing-pattern-section-role",
         message: `${label}: section-scoped patterns must declare sectionRole.`,
         patternSlug: pattern.slug,
@@ -171227,7 +171388,7 @@ function validatePatternCatalog(patterns, options = {}) {
       }));
     }
     if (pattern.sectionRole !== undefined && !PATTERN_SECTION_ROLE_PATTERN.test(pattern.sectionRole)) {
-      diagnostics.push(createPatternCatalogDiagnostic({
+      diagnostics.push(createPatternCatalogDiagnostic2({
         code: "invalid-pattern-section-role",
         message: `${label}: sectionRole must start with a lowercase letter and contain only lowercase letters, numbers, and hyphens.`,
         patternSlug: pattern.slug,
@@ -171236,7 +171397,7 @@ function validatePatternCatalog(patterns, options = {}) {
     }
     for (const [tagIndex, tag] of (pattern.tags ?? []).entries()) {
       if (!PATTERN_TAG_PATTERN.test(tag)) {
-        diagnostics.push(createPatternCatalogDiagnostic({
+        diagnostics.push(createPatternCatalogDiagnostic2({
           code: "invalid-pattern-tag",
           message: `${label}: tags[${tagIndex}] must contain only lowercase letters, numbers, and hyphens.`,
           patternSlug: pattern.slug,
@@ -171245,7 +171406,7 @@ function validatePatternCatalog(patterns, options = {}) {
       }
     }
     if (pattern.thumbnailUrl !== undefined && !isValidPatternThumbnailUrl(pattern.thumbnailUrl)) {
-      diagnostics.push(createPatternCatalogDiagnostic({
+      diagnostics.push(createPatternCatalogDiagnostic2({
         code: "invalid-pattern-thumbnail-url",
         message: `${label}: thumbnailUrl must be an http(s) URL or safe relative project path.`,
         patternSlug: pattern.slug,
@@ -171254,7 +171415,7 @@ function validatePatternCatalog(patterns, options = {}) {
     }
     const contentFile = resolvePatternCatalogContentFile(pattern);
     if (!contentFile) {
-      diagnostics.push(createPatternCatalogDiagnostic({
+      diagnostics.push(createPatternCatalogDiagnostic2({
         code: "missing-pattern-content-file",
         message: `${label}: contentFile or legacy file must point at the pattern PHP file.`,
         patternSlug: pattern.slug,
@@ -171263,7 +171424,7 @@ function validatePatternCatalog(patterns, options = {}) {
       continue;
     }
     if (!isPatternContentFilePath(contentFile)) {
-      diagnostics.push(createPatternCatalogDiagnostic({
+      diagnostics.push(createPatternCatalogDiagnostic2({
         code: "invalid-pattern-content-file",
         message: `${label}: contentFile must be a safe relative project path directly under src/patterns/ or one nested directory under src/patterns/ and end in .php.`,
         patternSlug: pattern.slug,
@@ -171276,7 +171437,7 @@ function validatePatternCatalog(patterns, options = {}) {
     }
     const absoluteContentFile = path.join(options.projectDir, contentFile);
     if (!fs.existsSync(absoluteContentFile)) {
-      diagnostics.push(createPatternCatalogDiagnostic({
+      diagnostics.push(createPatternCatalogDiagnostic2({
         code: "missing-pattern-content-file",
         message: `${label}: missing pattern content file ${contentFile}.`,
         patternSlug: pattern.slug,
@@ -171289,7 +171450,7 @@ function validatePatternCatalog(patterns, options = {}) {
       try {
         content = fs.readFileSync(absoluteContentFile, "utf8");
       } catch (error) {
-        diagnostics.push(createPatternCatalogDiagnostic({
+        diagnostics.push(createPatternCatalogDiagnostic2({
           code: "invalid-pattern-content-file",
           message: `${label}: failed to read pattern content file ${contentFile}: ${error instanceof Error ? error.message : String(error)}.`,
           patternSlug: pattern.slug,
@@ -171374,85 +171535,6 @@ var HOOKED_BLOCK_POSITION_IDS = ["before", "after", "firstChild", "lastChild"];
 var HOOKED_BLOCK_POSITION_SET = new Set(HOOKED_BLOCK_POSITION_IDS);
 var HOOKED_BLOCK_ANCHOR_PATTERN = /^[a-z0-9-]+\/[a-z0-9-]+$/;
 
-// ../wp-typia-project-tools/src/runtime/string-case.ts
-var COMMON_ACRONYM_PREFIXES = [
-  "HTML",
-  "HTTP",
-  "JSON",
-  "REST",
-  "UUID",
-  "AJAX",
-  "API",
-  "CPT",
-  "CSS",
-  "CTA",
-  "DOM",
-  "PHP",
-  "SQL",
-  "SVG",
-  "URL",
-  "XML",
-  "ID",
-  "JS",
-  "UI",
-  "WP"
-];
-var COMMON_ACRONYM_LOWERCASE_SUFFIXES = ["slug"];
-function capitalizeSegment(segment) {
-  return segment.charAt(0).toUpperCase() + segment.slice(1);
-}
-function findCommonAcronymPrefix(segment) {
-  return COMMON_ACRONYM_PREFIXES.find((prefix) => segment.startsWith(prefix));
-}
-function isCommonAcronymLowercaseSuffix(suffix) {
-  return COMMON_ACRONYM_LOWERCASE_SUFFIXES.includes(suffix);
-}
-function splitKnownAcronymSegment(segment) {
-  const prefixes = [];
-  let remaining = segment;
-  while (remaining.length > 0) {
-    const prefix = findCommonAcronymPrefix(remaining);
-    if (!prefix) {
-      break;
-    }
-    const suffix = remaining.slice(prefix.length);
-    if (/^[A-Z][a-z]/.test(suffix)) {
-      return [...prefixes, prefix, suffix].join("-");
-    }
-    if (/^[a-z]+$/.test(suffix) && isCommonAcronymLowercaseSuffix(suffix)) {
-      return [...prefixes, prefix, suffix].join("-");
-    }
-    if (!findCommonAcronymPrefix(suffix)) {
-      break;
-    }
-    prefixes.push(prefix);
-    remaining = suffix;
-  }
-  return segment;
-}
-function splitAcronymBoundary(value) {
-  return value.replace(/[A-Z]{2,}[a-z]+/g, splitKnownAcronymSegment);
-}
-function toKebabCase(input) {
-  return splitAcronymBoundary(input.trim()).replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/[^A-Za-z0-9]+/g, "-").replace(/^-+|-+$/g, "").replace(/-{2,}/g, "-").toLowerCase();
-}
-function toSnakeCase(input) {
-  return toKebabCase(input).replace(/-/g, "_");
-}
-function toPascalCase(input) {
-  return toKebabCase(input).split("-").filter(Boolean).map(capitalizeSegment).join("");
-}
-function toCamelCase(input) {
-  const pascalCase = toPascalCase(input);
-  return `${pascalCase.charAt(0).toLowerCase()}${pascalCase.slice(1)}`;
-}
-function toSegmentPascalCase(input) {
-  return input.replace(/[^A-Za-z0-9]+/g, " ").trim().split(/\s+/).filter(Boolean).map(capitalizeSegment).join("");
-}
-function toTitleCase(input) {
-  return toKebabCase(input).split("-").filter(Boolean).map(capitalizeSegment).join(" ");
-}
-
 // ../wp-typia-project-tools/src/runtime/cli-add-validation.ts
 var WORKSPACE_GENERATED_SLUG_PATTERN = /^[a-z][a-z0-9-]*$/;
 var WORDPRESS_POST_TYPE_PATTERN = /^[a-z0-9_][a-z0-9_-]*$/u;
@@ -171790,7 +171872,7 @@ function formatAddHelpText() {
 	wp-typia add variation <name> --block <block-slug> [--dry-run]
 	wp-typia add style <name> --block <block-slug> [--dry-run]
 	wp-typia add transform <name> --from <namespace/block> --to <block-slug|namespace/block-slug> [--dry-run]
-  wp-typia add pattern <name> [--scope <full|section>] [--section-role <role>] [--tags <tag,...>] [--thumbnail-url <url>] [--dry-run]
+  wp-typia add pattern <name> [--scope <full|section>] [--section-role <role>] [--catalog-title <title>] [--tags <tag,...>] [--tag <tag>...] [--thumbnail-url <url>] [--dry-run]
   wp-typia add binding-source <name> [--block <block-slug|namespace/block-slug> --attribute <attribute>] [--from-post-meta|--post-meta <post-meta> [--meta-path <field>]] [--dry-run]
   wp-typia add contract <name> [--type <ExportedTypeName>] [--dry-run]
   wp-typia add rest-resource <name> [--namespace <vendor/v1>] [--methods <${REST_RESOURCE_METHOD_IDS.join(",")}>] [--route-pattern <route-pattern>] [--permission-callback <callback>] [--controller-class <ClassName>] [--controller-extends <BaseClass>] [--dry-run]
@@ -171806,6 +171888,7 @@ Notes:
   Pass \`--dry-run\` to preview the workspace files that would change without writing them.
   Interactive add flows let you choose a template when \`--template\` is omitted; non-interactive runs default to \`basic\`.
   \`add core-variation\` registers editor-side variations for existing core or external blocks without generating block.json or Typia manifests.
+  Unknown \`core/*\` core-variation targets warn instead of failing so newer WordPress core blocks remain scaffoldable; third-party namespaces are allowed without local discovery.
   \`add admin-view\` scaffolds an opt-in DataViews-powered WordPress admin screen under \`src/admin-views/\`.
   Pass \`--source rest-resource:<slug>\` to reuse a list-capable REST resource.
   Pass \`--source core-data:postType/post\` or \`--source core-data:taxonomy/category\` to bind a WordPress-owned entity collection.
@@ -171817,7 +171900,7 @@ Notes:
   \`add variation\` targets an existing block slug from \`scripts/block-config.ts\`.
   \`add style\` registers a Block Styles option for an existing generated block.
   \`add transform\` adds a block-to-block transform into an existing generated block.
-  \`add pattern\` scaffolds a namespaced PHP pattern shell under \`src/patterns/full/\` or \`src/patterns/sections/\` and records typed catalog metadata in \`PATTERNS\`.
+  \`add pattern\` scaffolds a namespaced PHP pattern shell under \`src/patterns/full/\` or \`src/patterns/sections/\` and records typed catalog metadata in \`PATTERNS\`; pass \`--catalog-title "Hero Photo"\` to override the generated catalog title, pass \`--tags hero,landing\` for a comma-separated tag list, and repeat \`--tag hero --tag landing\` for single tag values.
   \`add binding-source\` scaffolds shared PHP and editor registration under \`src/bindings/\`; pass \`--block\` and \`--attribute\` together to declare an end-to-end bindable attribute on an existing generated block. Pass \`--from-post-meta\` or \`--post-meta\` to generate a source backed by a typed post-meta contract; \`--meta-path\` selects one top-level field as the default binding arg.
   \`add contract\` registers a standalone TypeScript wire contract under \`src/contracts/\` and generates a stable JSON Schema artifact without creating PHP route glue.
   \`add rest-resource\` scaffolds plugin-level TypeScript REST contracts under \`src/rest/\` and PHP route glue under \`inc/rest/\`. Use \`--route-pattern\`, \`--permission-callback\`, \`--controller-class\`, and \`--controller-extends\` when an existing WordPress controller or permission model needs to own part of the generated route surface.
@@ -171828,84 +171911,6 @@ Notes:
   \`add hooked-block\` patches an existing workspace block's \`block.json\` \`blockHooks\` metadata.
   \`add editor-plugin\` scaffolds a document-level editor extension under \`src/editor-plugins/\`; legacy aliases \`PluginSidebar\` and \`PluginDocumentSettingPanel\` resolve to \`sidebar\` and \`document-setting-panel\`.`;
 }
-
-// ../wp-typia-project-tools/src/runtime/scaffold-identifiers.ts
-var BLOCK_SLUG_PATTERN = /^[a-z][a-z0-9-]*$/;
-var PHP_PREFIX_PATTERN = /^[a-z_][a-z0-9_]*$/;
-var PHP_PREFIX_MAX_LENGTH = 50;
-function validateBlockSlug(input) {
-  return BLOCK_SLUG_PATTERN.test(input) || "Use lowercase letters, numbers, and hyphens only";
-}
-function validateNamespace(input) {
-  return BLOCK_SLUG_PATTERN.test(toKebabCase(input)) ? true : "Use lowercase letters, numbers, and hyphens only";
-}
-function validateTextDomain(input) {
-  return BLOCK_SLUG_PATTERN.test(toKebabCase(input)) ? true : "Use lowercase letters, numbers, and hyphens only";
-}
-function validatePhpPrefix(input) {
-  const normalizedPrefix = toSnakeCase(input);
-  if (normalizedPrefix.length > PHP_PREFIX_MAX_LENGTH) {
-    return `Use ${PHP_PREFIX_MAX_LENGTH} characters or fewer to keep generated database identifiers within MySQL limits`;
-  }
-  return PHP_PREFIX_PATTERN.test(normalizedPrefix) ? true : "Use letters, numbers, and underscores only, starting with a letter";
-}
-function assertValidIdentifier(label, value, validate) {
-  const result = validate(value);
-  if (result !== true) {
-    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.INVALID_ARGUMENT, typeof result === "string" ? `${label}: ${result}` : `${label} is invalid`);
-  }
-  return value;
-}
-function normalizeBlockSlug(input) {
-  return toKebabCase(input);
-}
-function resolveNonEmptyNormalizedBlockSlug(options) {
-  const normalizedSlug = normalizeBlockSlug(options.input);
-  if (normalizedSlug.length > 0) {
-    return normalizedSlug;
-  }
-  if (options.input.trim().length === 0) {
-    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, `${options.label} is required. Use \`${options.usage}\`.`);
-  }
-  throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.INVALID_ARGUMENT, `${options.label} "${options.input.trim()}" normalizes to an empty slug. Use letters or numbers so wp-typia can generate a block slug.`);
-}
-function resolveValidatedBlockSlug(value) {
-  return assertValidIdentifier("Block slug", normalizeBlockSlug(value), validateBlockSlug);
-}
-function resolveValidatedNamespace(value) {
-  return assertValidIdentifier("Namespace", toKebabCase(value), validateNamespace);
-}
-function resolveValidatedTextDomain(value) {
-  return assertValidIdentifier("Text domain", toKebabCase(value), validateTextDomain);
-}
-function resolveValidatedPhpPrefix(value) {
-  return assertValidIdentifier("PHP prefix", toSnakeCase(value), validatePhpPrefix);
-}
-function buildBlockCssClassName(namespace, slug) {
-  const normalizedSlug = resolveValidatedBlockSlug(slug);
-  const normalizedNamespace = typeof namespace === "string" && namespace.trim().length > 0 ? resolveValidatedNamespace(namespace) : "";
-  if (normalizedNamespace === normalizedSlug) {
-    return `wp-block-${normalizedSlug}-block`;
-  }
-  return normalizedNamespace.length > 0 ? `wp-block-${normalizedNamespace}-${normalizedSlug}` : `wp-block-${normalizedSlug}`;
-}
-function buildFrontendCssClassName(blockCssClassName) {
-  return `${blockCssClassName}-frontend`;
-}
-function resolveScaffoldIdentifiers({
-  namespace,
-  phpPrefix,
-  slug,
-  textDomain
-}) {
-  const normalizedSlug = resolveValidatedBlockSlug(slug);
-  return {
-    namespace: resolveValidatedNamespace(namespace),
-    phpPrefix: resolveValidatedPhpPrefix(phpPrefix ?? normalizedSlug),
-    slug: normalizedSlug,
-    textDomain: resolveValidatedTextDomain(textDomain ?? normalizedSlug)
-  };
-}
 // ../wp-typia-project-tools/src/runtime/cli-add-filesystem.ts
 import { promises as fsp2 } from "fs";
 import path2 from "path";
@@ -173811,6 +173816,6 @@ async function appendWorkspaceInventoryEntries(projectDir, options) {
     await writeFile(blockConfigPath, nextSource, "utf8");
   }
 }
-export { toKebabCase, toSnakeCase, toPascalCase, toCamelCase, toSegmentPascalCase, toTitleCase, validateBlockSlug, validateNamespace, normalizeBlockSlug, resolveNonEmptyNormalizedBlockSlug, buildBlockCssClassName, buildFrontendCssClassName, resolveScaffoldIdentifiers, PATTERN_CATALOG_SCOPE_IDS, isValidPatternThumbnailUrl, resolvePatternCatalogContentFile, validatePatternCatalog, formatPatternCatalogDiagnostics, REST_RESOURCE_METHOD_IDS, MANUAL_REST_CONTRACT_HTTP_METHOD_IDS, MANUAL_REST_CONTRACT_AUTH_IDS, EDITOR_PLUGIN_SLOT_IDS, resolveEditorPluginSlotAlias, ADD_BLOCK_TEMPLATE_IDS, suggestAddBlockTemplateId, HOOKED_BLOCK_POSITION_SET, HOOKED_BLOCK_ANCHOR_PATTERN, REST_RESOURCE_NAMESPACE_PATTERN, assertValidGeneratedSlug, assertValidTypeScriptIdentifier, resolveRestResourceNamespace, assertValidPostMetaPostType, resolvePostMetaKey, assertValidRestResourceMethods, resolveOptionalPhpCallbackReference, resolveOptionalPhpClassReference, assertValidManualRestContractHttpMethod, assertValidManualRestContractAuth, isGeneratedRestResourceRoutePatternCompatible, collectRestRouteNamedCaptureNames, resolveManualRestContractPathPattern, resolveGeneratedRestResourceRoutePattern, assertValidHookedBlockPosition, buildWorkspacePhpPrefix, isAddBlockTemplateId, quoteTsString, assertValidHookAnchor, assertValidEditorPluginSlot, assertValidIntegrationEnvService, pathExists, readOptionalUtf8File, getNodeErrorCode, getOptionalNodeErrorCode, isFileNotFoundError, getWorkspaceBootstrapPath, patchFile, readOptionalFile, snapshotWorkspaceFiles, rollbackWorkspaceMutation, resolveWorkspaceBlock, readWorkspaceBlockJson, getMutableBlockHooks, assertVariationDoesNotExist, assertBlockStyleDoesNotExist, assertBlockTransformDoesNotExist, assertPatternDoesNotExist, assertBindingSourceDoesNotExist, assertRestResourceDoesNotExist, assertPostMetaDoesNotExist, assertContractDoesNotExist, assertAdminViewDoesNotExist, assertAbilityDoesNotExist, assertAiFeatureDoesNotExist, assertEditorPluginDoesNotExist, formatAddHelpText, require_typescript, getPropertyNameText, readWorkspaceInventory, readWorkspaceInventoryAsync, getWorkspaceBlockSelectOptions, getWorkspaceBlockSelectOptionsAsync, escapeRegex, quotePhpString, hasPhpFunctionDefinition, hasPhpFunctionCall, findPhpFunctionRange, replacePhpFunctionDefinition, updateWorkspaceInventorySource, appendWorkspaceInventoryEntries };
+export { toKebabCase, toSnakeCase, toPascalCase, toCamelCase, toSegmentPascalCase, toTitleCase, validateBlockSlug, validateNamespace, normalizeBlockSlug, resolveNonEmptyNormalizedBlockSlug, buildBlockCssClassName, buildFrontendCssClassName, resolveScaffoldIdentifiers, PATTERN_SECTION_ROLE_PATTERN, PATTERN_CATALOG_SCOPE_IDS, PATTERN_TAG_PATTERN, isValidPatternThumbnailUrl, resolvePatternCatalogContentFile, validatePatternCatalog, formatPatternCatalogDiagnostics, REST_RESOURCE_METHOD_IDS, MANUAL_REST_CONTRACT_HTTP_METHOD_IDS, MANUAL_REST_CONTRACT_AUTH_IDS, EDITOR_PLUGIN_SLOT_IDS, resolveEditorPluginSlotAlias, ADD_BLOCK_TEMPLATE_IDS, suggestAddBlockTemplateId, HOOKED_BLOCK_POSITION_SET, HOOKED_BLOCK_ANCHOR_PATTERN, REST_RESOURCE_NAMESPACE_PATTERN, assertValidGeneratedSlug, assertValidTypeScriptIdentifier, resolveRestResourceNamespace, assertValidPostMetaPostType, resolvePostMetaKey, assertValidRestResourceMethods, resolveOptionalPhpCallbackReference, resolveOptionalPhpClassReference, assertValidManualRestContractHttpMethod, assertValidManualRestContractAuth, isGeneratedRestResourceRoutePatternCompatible, collectRestRouteNamedCaptureNames, resolveManualRestContractPathPattern, resolveGeneratedRestResourceRoutePattern, assertValidHookedBlockPosition, buildWorkspacePhpPrefix, isAddBlockTemplateId, quoteTsString, assertValidHookAnchor, assertValidEditorPluginSlot, assertValidIntegrationEnvService, pathExists, readOptionalUtf8File, getNodeErrorCode, getOptionalNodeErrorCode, isFileNotFoundError, getWorkspaceBootstrapPath, patchFile, readOptionalFile, snapshotWorkspaceFiles, rollbackWorkspaceMutation, resolveWorkspaceBlock, readWorkspaceBlockJson, getMutableBlockHooks, assertVariationDoesNotExist, assertBlockStyleDoesNotExist, assertBlockTransformDoesNotExist, assertPatternDoesNotExist, assertBindingSourceDoesNotExist, assertRestResourceDoesNotExist, assertPostMetaDoesNotExist, assertContractDoesNotExist, assertAdminViewDoesNotExist, assertAbilityDoesNotExist, assertAiFeatureDoesNotExist, assertEditorPluginDoesNotExist, formatAddHelpText, require_typescript, getPropertyNameText, readWorkspaceInventory, readWorkspaceInventoryAsync, getWorkspaceBlockSelectOptions, getWorkspaceBlockSelectOptionsAsync, escapeRegex, quotePhpString, hasPhpFunctionDefinition, hasPhpFunctionCall, findPhpFunctionRange, replacePhpFunctionDefinition, updateWorkspaceInventorySource, appendWorkspaceInventoryEntries };
 
-//# debugId=7B77B39B1AF35AE264756E2164756E21
+//# debugId=9E60A37E69B52ED864756E2164756E21

package/dist-bunli/{cli-scaffold-an2k0fnm.js → cli-scaffold-b49zc1rw.js}

@@ -21,19 +21,19 @@ import {
   resolvePackageManagerId,
   resolveTemplateId,
   scaffoldProject
-} from "./cli-74y6z3yx.js";
+} from "./cli-4eqznv15.js";
 import"./cli-9fx0qgb7.js";
-import"./cli-sw06c521.js";
-import"./cli-y0a8nztv.js";
+import"./cli-vxd8eyax.js";
+import"./cli-wfvf3tv1.js";
 import {
   OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE,
   isBuiltInTemplateId
 } from "./cli-8hxf9qw6.js";
-import"./cli-0v407aag.js";
+import"./cli-6ys6d16y.js";
 import"./cli-e4bwd81c.js";
 import {
   pathExists
-} from "./cli-v0nnagb3.js";
+} from "./cli-kbqztfkt.js";
 import"./cli-cvxvcw7c.js";
 import {
   createManagedTempRoot

package/dist-bunli/{cli-sw06c521.js → cli-vxd8eyax.js}

@@ -11,7 +11,7 @@ import {
 } from "./cli-8hxf9qw6.js";
 import {
   pathExists
-} from "./cli-v0nnagb3.js";
+} from "./cli-kbqztfkt.js";
 import {
   createManagedTempRoot
 } from "./cli-t73q5aqz.js";