wp-typia 0.24.0 → 0.24.2

package/dist-bunli/.bunli/commands.gen.js

@@ -36337,29 +36337,13 @@ function suggestCloseId(input, candidates, options = {}) {
   return bestCandidate && bestCandidate.distance <= maxDistance ? bestCandidate.id : null;
 }
 
-// ../wp-typia-project-tools/src/runtime/pattern-catalog.ts
-import fs8 from "fs";
-import path11 from "path";
+// ../wp-typia-project-tools/src/runtime/pattern-catalog-section-roles.ts
 import {
   validateBlockPatternContentNesting
 } from "@wp-typia/block-runtime/metadata-core";
 function createPatternCatalogDiagnostic(diagnostic) {
   return diagnostic;
 }
-function isPatternCatalogScope(value2) {
-  return PATTERN_CATALOG_SCOPE_IDS.includes(value2);
-}
-function isSafeRelativePath(value2) {
-  return value2.length > 0 && !path11.isAbsolute(value2) && !value2.includes("\\") && !value2.split(/[\\/]+/u).includes("..") && !/[<>:"|?*\u0000-\u001F]/u.test(value2);
-}
-function isPatternContentFilePath(value2) {
-  if (!isSafeRelativePath(value2) || !value2.startsWith(PATTERN_CONTENT_FILE_ROOT) || !value2.endsWith(".php")) {
-    return false;
-  }
-  const patternRelativePath = value2.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,
@@ -36379,7 +36363,7 @@ function createRoleClassNamePattern(pattern) {
   }
   return new RegExp(`^${escapeRegExp2(parts[0] ?? "")}(?<role>\\S*)${escapeRegExp2(parts[1] ?? "")}$`, "u");
 }
-function normalizeSectionRoleConvention(convention = {}) {
+function normalizePatternCatalogSectionRoleConvention(convention = {}) {
   const normalized = normalizeSectionRoleConventionInput(convention);
   return {
     ...normalized,
@@ -36441,7 +36425,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,
@@ -36464,27 +36448,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(value2) {
-  if (value2.length === 0) {
-    return false;
-  }
-  try {
-    const url2 = new URL(value2);
-    return url2.protocol === "http:" || url2.protocol === "https:";
-  } catch {
-    return isSafeRelativePath(value2);
-  }
-}
-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({
@@ -36576,26 +36545,72 @@ function validatePatternContentSectionRoles({
   }
   return diagnostics;
 }
+var PATTERN_SECTION_ROLE_PATTERN, DEFAULT_SECTION_ROLE_CONVENTION;
+var init_pattern_catalog_section_roles = __esm(() => {
+  PATTERN_SECTION_ROLE_PATTERN = /^[a-z][a-z0-9-]*$/u;
+  DEFAULT_SECTION_ROLE_CONVENTION = {
+    baseClassName: "section",
+    requireUniqueFullPatternRoles: false,
+    roleAttributePaths: ["metadata.sectionRole"],
+    roleClassNamePattern: "section--{role}",
+    wrapperBlockName: "core/group"
+  };
+});
+
+// ../wp-typia-project-tools/src/runtime/pattern-catalog.ts
+import fs8 from "fs";
+import path11 from "path";
+function createPatternCatalogDiagnostic2(diagnostic) {
+  return diagnostic;
+}
+function isPatternCatalogScope(value2) {
+  return PATTERN_CATALOG_SCOPE_IDS.includes(value2);
+}
+function isSafeRelativePath(value2) {
+  return value2.length > 0 && !path11.isAbsolute(value2) && !value2.includes("\\") && !value2.split(/[\\/]+/u).includes("..") && !/[<>:"|?*\u0000-\u001F]/u.test(value2);
+}
+function isPatternContentFilePath(value2) {
+  if (!isSafeRelativePath(value2) || !value2.startsWith(PATTERN_CONTENT_FILE_ROOT) || !value2.endsWith(".php")) {
+    return false;
+  }
+  const patternRelativePath = value2.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(value2) {
+  if (value2.length === 0) {
+    return false;
+  }
+  try {
+    const url2 = new URL(value2);
+    return url2.protocol === "http:" || url2.protocol === "https:";
+  } catch {
+    return isSafeRelativePath(value2);
+  }
+}
+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 (error48) {
-      diagnostics.push(createPatternCatalogDiagnostic({
+      diagnostics.push(createPatternCatalogDiagnostic2({
         code: "invalid-pattern-section-role-convention",
         message: `sectionRoleConvention.roleClassNamePattern is invalid: ${error48 instanceof Error ? error48.message : String(error48)}`,
         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,
@@ -36604,7 +36619,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,
@@ -36615,7 +36630,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,
@@ -36623,7 +36638,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,
@@ -36631,7 +36646,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,
@@ -36640,7 +36655,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,
@@ -36649,7 +36664,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,
@@ -36658,7 +36673,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,
@@ -36667,7 +36682,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,
@@ -36680,7 +36695,7 @@ function validatePatternCatalog(patterns, options = {}) {
     }
     const absoluteContentFile = path11.join(options.projectDir, contentFile);
     if (!fs8.existsSync(absoluteContentFile)) {
-      diagnostics.push(createPatternCatalogDiagnostic({
+      diagnostics.push(createPatternCatalogDiagnostic2({
         code: "missing-pattern-content-file",
         message: `${label}: missing pattern content file ${contentFile}.`,
         patternSlug: pattern.slug,
@@ -36693,7 +36708,7 @@ function validatePatternCatalog(patterns, options = {}) {
       try {
         content = fs8.readFileSync(absoluteContentFile, "utf8");
       } catch (error48) {
-        diagnostics.push(createPatternCatalogDiagnostic({
+        diagnostics.push(createPatternCatalogDiagnostic2({
           code: "invalid-pattern-content-file",
           message: `${label}: failed to read pattern content file ${contentFile}: ${error48 instanceof Error ? error48.message : String(error48)}.`,
           patternSlug: pattern.slug,
@@ -36723,19 +36738,13 @@ function formatPatternCatalogDiagnostics(diagnostics) {
   return diagnostics.map((diagnostic) => `- [${diagnostic.code}] ${diagnostic.message}`).join(`
 `);
 }
-var PATTERN_CATALOG_SCOPE_IDS, PATTERN_SLUG_PATTERN, PATTERN_SECTION_ROLE_PATTERN, PATTERN_TAG_PATTERN, PATTERN_CONTENT_FILE_ROOT = "src/patterns/", DEFAULT_SECTION_ROLE_CONVENTION;
+var PATTERN_CATALOG_SCOPE_IDS, PATTERN_SLUG_PATTERN, PATTERN_TAG_PATTERN, PATTERN_CONTENT_FILE_ROOT = "src/patterns/";
 var init_pattern_catalog = __esm(() => {
+  init_pattern_catalog_section_roles();
+  init_pattern_catalog_section_roles();
   PATTERN_CATALOG_SCOPE_IDS = ["full", "section"];
   PATTERN_SLUG_PATTERN = /^[a-z][a-z0-9-]*$/u;
-  PATTERN_SECTION_ROLE_PATTERN = PATTERN_SLUG_PATTERN;
   PATTERN_TAG_PATTERN = /^[a-z0-9][a-z0-9-]*$/u;
-  DEFAULT_SECTION_ROLE_CONVENTION = {
-    baseClassName: "section",
-    requireUniqueFullPatternRoles: false,
-    roleAttributePaths: ["metadata.sectionRole"],
-    roleClassNamePattern: "section--{role}",
-    wrapperBlockName: "core/group"
-  };
 });
 
 // ../wp-typia-project-tools/src/runtime/cli-add-types.ts
@@ -37558,7 +37567,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]
@@ -37574,6 +37583,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.
@@ -37585,7 +37595,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.
@@ -214439,11 +214449,10 @@ function readPackageManifest(location) {
   if (!location.packageJsonPath || location.source === null) {
     return null;
   }
-  try {
-    return JSON.parse(location.source);
-  } catch (error48) {
-    throw new Error(`Failed to parse package version manifest at ${location.packageJsonPath}: ${error48 instanceof Error ? error48.message : String(error48)}`);
-  }
+  return safeJsonParse(location.source, {
+    context: "package version manifest",
+    filePath: location.packageJsonPath
+  });
 }
 function tryReadPackageManifest(location) {
   if (!location) {
@@ -214544,6 +214553,7 @@ function getPackageVersions() {
 var require2, DEFAULT_VERSION_RANGE = "^0.0.0", DEFAULT_EXACT_VERSION = "0.0.0", DEFAULT_TSX_PACKAGE_VERSION = "^4.20.5", DEFAULT_TYPIA_UNPLUGIN_PACKAGE_VERSION = "^12.0.1", DEFAULT_WORDPRESS_ABILITIES_VERSION = "^0.10.0", DEFAULT_WORDPRESS_CORE_ABILITIES_VERSION = "^0.9.0", DEFAULT_WORDPRESS_CORE_DATA_VERSION = "^7.44.0", DEFAULT_WORDPRESS_DATA_VERSION = "^9.28.0", DEFAULT_WORDPRESS_DATAVIEWS_VERSION = "^14.1.0", DEFAULT_WORDPRESS_ENV_VERSION = "^11.2.0", DEFAULT_WP_TYPIA_DATAVIEWS_VERSION = "^0.1.1", cachedPackageVersions = null;
 var init_package_versions = __esm(() => {
   init_fs_async();
+  init_json_utils();
   init_template_registry();
   require2 = createRequire(import.meta.url);
 });
@@ -225957,7 +225967,9 @@ function sanitizeExternalTemplateCacheMetadata(metadata2) {
 function parseExternalTemplateCacheEntryMarker(markerText) {
   let marker;
   try {
-    marker = JSON.parse(markerText);
+    marker = safeJsonParse(markerText, {
+      context: "external template cache entry marker"
+    });
   } catch {
     return null;
   }
@@ -225991,7 +226003,9 @@ function isExternalTemplateCacheEntryFreshForTtl(createdAtMs, nowMs, ttlMs) {
 function parseExternalTemplateCachePruneMarker(markerText) {
   let marker;
   try {
-    marker = JSON.parse(markerText);
+    marker = safeJsonParse(markerText, {
+      context: "external template cache prune marker"
+    });
   } catch {
     return null;
   }
@@ -226045,6 +226059,7 @@ function formatExternalTemplateCachePruneMarker({
 }
 var CACHE_MARKER_FILE = "wp-typia-template-cache.json", CACHE_PRUNE_MARKER_FILE = "wp-typia-template-cache-prune.json", REDACTED_CACHE_METADATA_VALUE = "[redacted]", URL_LIKE_METADATA_KEY;
 var init_template_source_cache_markers = __esm(() => {
+  init_json_utils();
   URL_LIKE_METADATA_KEY = /(url|uri|registry|tarball)/iu;
 });
 
@@ -237341,11 +237356,6 @@ main().catch( ( error ) => {
 }
 
 // ../wp-typia-project-tools/src/runtime/cli-add-workspace-ai-source-emitters.ts
-function indentMultiline2(source, prefix) {
-  return source.split(`
-`).map((line) => `${prefix}${line}`).join(`
-`);
-}
 function buildAiFeatureConfigEntry(aiFeatureSlug, namespace) {
   const pascalCase = toPascalCase(aiFeatureSlug);
   const title = toTitleCase(aiFeatureSlug);
@@ -237367,7 +237377,7 @@ function buildAiFeatureConfigEntry(aiFeatureSlug, namespace) {
     `		openApiFile: ${quoteTsString(`src/ai-features/${aiFeatureSlug}/api.openapi.json`)},`,
     `		phpFile: ${quoteTsString(`inc/ai-features/${aiFeatureSlug}.php`)},`,
     "\t\trestManifest: defineEndpointManifest(",
-    indentMultiline2(JSON.stringify(manifest, null, "\t"), "\t\t\t"),
+    indentMultiline(JSON.stringify(manifest, null, "\t"), "\t\t\t"),
     "\t\t),",
     `		slug: ${quoteTsString(aiFeatureSlug)},`,
     `		typesFile: ${quoteTsString(`src/ai-features/${aiFeatureSlug}/api-types.ts`)},`,
@@ -237501,26 +237511,7 @@ import {
 	run${pascalCase}AiFeatureEndpoint,
 } from './api-client';
 
-function resolveRestNonce( fallback?: string ): string | undefined {
-	if ( typeof fallback === 'string' && fallback.length > 0 ) {
-		return fallback;
-	}
-
-	if ( typeof window === 'undefined' ) {
-		return undefined;
-	}
-
-	const wpApiSettings = (
-		window as typeof window & {
-			wpApiSettings?: { nonce?: string };
-		}
-	).wpApiSettings;
-
-	return typeof wpApiSettings?.nonce === 'string' &&
-		wpApiSettings.nonce.length > 0
-		? wpApiSettings.nonce
-		: undefined;
-}
+${formatResolveRestNonceSource("spaced")}
 
 function isPlainObject( value: unknown ): value is Record< string, unknown > {
 	return (
@@ -240190,17 +240181,21 @@ function resolvePatternScope(scope) {
   }
   throw new Error(`Pattern scope must be one of: ${PATTERN_CATALOG_SCOPE_IDS.join(", ")}.`);
 }
-function normalizeOptionalSlug(label, value2, usage) {
+function normalizePatternSectionRole(value2) {
   if (value2 === undefined || value2.trim() === "") {
     return;
   }
-  return assertValidGeneratedSlug(label, normalizeBlockSlug(value2), usage);
+  const sectionRole = normalizeBlockSlug(value2);
+  if (!PATTERN_SECTION_ROLE_PATTERN.test(sectionRole)) {
+    throw new Error("Pattern section role must start with a lowercase letter and contain only lowercase letters, numbers, and hyphens. Section roles apply only with `--scope section`.");
+  }
+  return sectionRole;
 }
 function normalizePatternTags(tags) {
-  const rawTags = typeof tags === "string" ? tags.split(",") : Array.isArray(tags) ? [...tags] : [];
+  const rawTags = typeof tags === "string" ? tags.split(",") : Array.isArray(tags) ? tags.flatMap((tag) => tag.split(",")) : [];
   const normalizedTags = rawTags.map((tag) => normalizeBlockSlug(tag)).filter((tag) => tag.length > 0);
   for (const tag of normalizedTags) {
-    if (!PATTERN_TAG_PATTERN2.test(tag)) {
+    if (!PATTERN_TAG_PATTERN.test(tag)) {
       throw new Error(`Pattern tag "${tag}" must contain only lowercase letters, numbers, and hyphens.`);
     }
   }
@@ -240225,12 +240220,12 @@ function resolvePatternContentFile(patternSlug, patternScope, contentFile) {
 }
 function resolvePatternCatalogOptions(patternSlug, options) {
   const patternScope = resolvePatternScope(options.patternScope);
-  const sectionRole = normalizeOptionalSlug("Pattern section role", options.sectionRole, "wp-typia add pattern <name> --scope section --section-role <role>");
+  const sectionRole = normalizePatternSectionRole(options.sectionRole);
   if (patternScope === "section" && !sectionRole) {
-    throw new Error("`wp-typia add pattern --scope section` requires --section-role <role>.");
+    throw new Error("`wp-typia add pattern --scope section` requires --section-role <role> because section-scoped patterns need a typed catalog section role.");
   }
   if (patternScope !== "section" && sectionRole) {
-    throw new Error("`--section-role` requires `--scope section`.");
+    throw new Error("`--section-role` only applies with `--scope section`. Use `--scope section --section-role <role>` or omit `--section-role` for full patterns.");
   }
   const title = options.catalogTitle && options.catalogTitle.trim() !== "" ? options.catalogTitle.trim() : toTitleCase(patternSlug);
   const thumbnailUrl = normalizePatternThumbnailUrl(options.thumbnailUrl);
@@ -240243,12 +240238,11 @@ function resolvePatternCatalogOptions(patternSlug, options) {
     title
   };
 }
-var PATTERN_CONTENT_FILE_ROOT2 = "src/patterns/", PATTERN_TAG_PATTERN2;
+var PATTERN_CONTENT_FILE_ROOT2 = "src/patterns/";
 var init_cli_add_workspace_pattern_options = __esm(() => {
   init_cli_add_shared();
   init_pattern_catalog();
   init_string_case();
-  PATTERN_TAG_PATTERN2 = /^[a-z0-9][a-z0-9-]*$/u;
 });
 
 // ../wp-typia-project-tools/src/runtime/cli-add-workspace-pattern-source-emitters.ts
@@ -241321,6 +241315,12 @@ function buildCoreVariationImportPath(ref) {
 function formatCoreVariationTitle(variationSlug) {
   return toTitleCase(variationSlug);
 }
+function getUnknownCoreVariationTargetWarning(targetBlockName) {
+  if (!targetBlockName.startsWith("core/") || KNOWN_CORE_VARIATION_TARGETS.has(targetBlockName)) {
+    return;
+  }
+  return `Target block "${targetBlockName}" uses the WordPress core namespace but is not in wp-typia's known core block list. The variation was generated for forward compatibility; verify the block name or update wp-typia if this is a newer core block.`;
+}
 function assertCoreVariationDoesNotExist(projectDir, targetBlockName, variationSlug) {
   const variationFilePath = getCoreVariationFilePath(projectDir, targetBlockName, variationSlug);
   if (fs31.existsSync(variationFilePath)) {
@@ -241528,6 +241528,7 @@ async function runAddCoreVariationCommand({
   const workspace = resolveWorkspaceProject(cwd);
   const resolvedTargetBlockName = assertFullBlockName(targetBlockName, "core-variation target");
   const variationSlug = assertValidGeneratedSlug("Core variation name", normalizeBlockSlug(variationName), CORE_VARIATION_USAGE);
+  const unknownCoreTargetWarning = getUnknownCoreVariationTargetWarning(resolvedTargetBlockName);
   assertCoreVariationSlugIsNotRegistryIndex(variationSlug);
   assertCoreVariationDoesNotExist(workspace.projectDir, resolvedTargetBlockName, variationSlug);
   const bootstrapPath = path82.join(workspace.projectDir, `${workspace.packageName.split("/").pop() ?? workspace.packageName}.php`);
@@ -241568,14 +241569,15 @@ async function runAddCoreVariationCommand({
       projectDir: workspace.projectDir,
       targetBlockName: resolvedTargetBlockName,
       variationFile: path82.relative(workspace.projectDir, variationFilePath),
-      variationSlug
+      variationSlug,
+      ...unknownCoreTargetWarning ? { warnings: [unknownCoreTargetWarning] } : {}
     };
   } catch (error48) {
     await rollbackWorkspaceMutation(mutationSnapshot);
     throw error48;
   }
 }
-var CORE_VARIATIONS_EDITOR_PLUGIN_SLUG = "core-variations", CORE_VARIATION_USAGE = "wp-typia add core-variation <block-name> <name> or wp-typia add core-variation <name> --block <namespace/block>", CORE_VARIATION_SIMPLE_CONTAINER_BLOCKS;
+var CORE_VARIATIONS_EDITOR_PLUGIN_SLUG = "core-variations", CORE_VARIATION_USAGE = "wp-typia add core-variation <block-name> <name> or wp-typia add core-variation <name> --block <namespace/block>", KNOWN_CORE_VARIATION_TARGETS, CORE_VARIATION_SIMPLE_CONTAINER_BLOCKS;
 var init_cli_add_workspace_core_variation = __esm(() => {
   init_block_targets();
   init_cli_add_shared();
@@ -241583,6 +241585,101 @@ var init_cli_add_workspace_core_variation = __esm(() => {
   init_fs_async();
   init_string_case();
   init_workspace_project();
+  KNOWN_CORE_VARIATION_TARGETS = new Set([
+    "core/archives",
+    "core/audio",
+    "core/avatar",
+    "core/block",
+    "core/button",
+    "core/buttons",
+    "core/calendar",
+    "core/categories",
+    "core/code",
+    "core/column",
+    "core/columns",
+    "core/comment-author-name",
+    "core/comment-content",
+    "core/comment-date",
+    "core/comment-edit-link",
+    "core/comment-reply-link",
+    "core/comment-template",
+    "core/comments",
+    "core/comments-pagination",
+    "core/comments-pagination-next",
+    "core/comments-pagination-numbers",
+    "core/comments-pagination-previous",
+    "core/comments-title",
+    "core/cover",
+    "core/details",
+    "core/embed",
+    "core/file",
+    "core/footnotes",
+    "core/freeform",
+    "core/gallery",
+    "core/group",
+    "core/heading",
+    "core/home-link",
+    "core/html",
+    "core/image",
+    "core/latest-comments",
+    "core/latest-posts",
+    "core/legacy-widget",
+    "core/list",
+    "core/list-item",
+    "core/loginout",
+    "core/media-text",
+    "core/missing",
+    "core/more",
+    "core/navigation",
+    "core/navigation-link",
+    "core/navigation-submenu",
+    "core/nextpage",
+    "core/page-list",
+    "core/paragraph",
+    "core/pattern",
+    "core/post-author",
+    "core/post-author-biography",
+    "core/post-author-name",
+    "core/post-comments",
+    "core/post-comments-form",
+    "core/post-content",
+    "core/post-date",
+    "core/post-excerpt",
+    "core/post-featured-image",
+    "core/post-navigation-link",
+    "core/post-terms",
+    "core/post-template",
+    "core/post-title",
+    "core/preformatted",
+    "core/pullquote",
+    "core/query",
+    "core/query-no-results",
+    "core/query-pagination",
+    "core/query-pagination-next",
+    "core/query-pagination-numbers",
+    "core/query-pagination-previous",
+    "core/query-title",
+    "core/quote",
+    "core/read-more",
+    "core/rss",
+    "core/search",
+    "core/separator",
+    "core/shortcode",
+    "core/site-logo",
+    "core/site-tagline",
+    "core/site-title",
+    "core/social-link",
+    "core/social-links",
+    "core/spacer",
+    "core/table",
+    "core/table-of-contents",
+    "core/tag-cloud",
+    "core/template-part",
+    "core/term-description",
+    "core/text-columns",
+    "core/verse",
+    "core/video"
+  ]);
   CORE_VARIATION_SIMPLE_CONTAINER_BLOCKS = new Set([
     "core/column",
     "core/cover",
@@ -244047,10 +244144,13 @@ __export(exports_cli_add, {
   runAddAiFeatureCommand: () => runAddAiFeatureCommand,
   runAddAdminViewCommand: () => runAddAdminViewCommand,
   runAddAbilityCommand: () => runAddAbilityCommand,
+  normalizeBlockSlug: () => normalizeBlockSlug,
   isAddBlockTemplateId: () => isAddBlockTemplateId,
   getWorkspaceBlockSelectOptionsAsync: () => getWorkspaceBlockSelectOptionsAsync,
   getWorkspaceBlockSelectOptions: () => getWorkspaceBlockSelectOptions,
   formatAddHelpText: () => formatAddHelpText,
+  PATTERN_TAG_PATTERN: () => PATTERN_TAG_PATTERN,
+  PATTERN_SECTION_ROLE_PATTERN: () => PATTERN_SECTION_ROLE_PATTERN,
   PATTERN_CATALOG_SCOPE_IDS: () => PATTERN_CATALOG_SCOPE_IDS,
   EDITOR_PLUGIN_SLOT_IDS: () => EDITOR_PLUGIN_SLOT_IDS,
   ADD_KIND_IDS: () => ADD_KIND_IDS,
@@ -299601,6 +299701,10 @@ var ADD_OPTION_METADATA = {
     description: "Target block slug/name for variation, core-variation, style, and end-to-end binding-source workflows.",
     type: "string"
   },
+  "catalog-title": {
+    description: "Human-readable title for typed pattern catalog entries; defaults to the pattern slug title.",
+    type: "string"
+  },
   "controller-class": {
     description: "REST resource controller class used for generated route callbacks or declared manual/provider route ownership.",
     type: "string"
@@ -299710,11 +299814,11 @@ var ADD_OPTION_METADATA = {
     type: "string"
   },
   scope: {
-    description: "Pattern catalog scope for pattern workflows (full or section).",
+    description: "Pattern catalog scope for pattern workflows; one of full or section.",
     type: "string"
   },
   "section-role": {
-    description: "Typed section role for section-scoped pattern catalog entries.",
+    description: "Typed section role for section-scoped pattern catalog entries; requires --scope section.",
     type: "string"
   },
   "secret-field": {
@@ -299758,7 +299862,13 @@ var ADD_OPTION_METADATA = {
     type: "string"
   },
   tags: {
-    description: "Comma-separated tags for typed pattern catalog entries.",
+    description: "Comma-separated tags for typed pattern catalog entries; combine with repeatable --tag for single tags.",
+    repeatable: true,
+    type: "string"
+  },
+  tag: {
+    description: "Repeatable single tag for typed pattern catalog entries; use --tags for comma-separated lists.",
+    repeatable: true,
     type: "string"
   },
   type: {
@@ -300008,7 +300118,8 @@ function buildCommandOptions(metadata2) {
     {
       ...option3.argumentKind ? { argumentKind: option3.argumentKind } : {},
       description: option3.description,
-      schema: option3.type === "boolean" ? exports_external.boolean().default(false) : exports_external.string().optional(),
+      ...option3.repeatable ? { repeatable: true } : {},
+      schema: option3.type === "boolean" ? exports_external.boolean().default(false) : option3.repeatable ? exports_external.union([exports_external.string(), exports_external.array(exports_external.string())]).optional() : exports_external.string().optional(),
       ...option3.short ? { short: option3.short } : {}
     }
   ]));
@@ -300028,6 +300139,7 @@ function buildCommandOptionParser(...metadataMaps) {
   }
   return {
     booleanOptionNames: new Set(collectOptionNamesByType(metadata2, "boolean")),
+    repeatableOptionNames: new Set(Object.entries(metadata2).filter(([, option3]) => option3.repeatable).map(([name2]) => name2)),
     shortFlagMap: new Map(Object.entries(metadata2).flatMap(([name2, option3]) => option3.short ? [[option3.short, { name: name2, type: option3.type }]] : [])),
     stringOptionNames: new Set(collectOptionNamesByType(metadata2, "string"))
   };
@@ -300054,6 +300166,10 @@ function resolveCommandOptionValues(metadata2, options) {
       resolved[name2] = Boolean(value2 ?? false);
       continue;
     }
+    if (descriptor.repeatable && Array.isArray(value2)) {
+      resolved[name2] = value2.every((item) => typeof item === "string") ? value2.join(",") : undefined;
+      continue;
+    }
     resolved[name2] = typeof value2 === "string" ? value2 : undefined;
   }
   return resolved;
@@ -300240,6 +300356,13 @@ var NAME_ONLY_VISIBLE_FIELDS = [
   "kind",
   "name"
 ];
+var PATTERN_CATALOG_VISIBLE_FIELDS = [
+  "kind",
+  "name",
+  "scope",
+  "section-role",
+  "catalog-title"
+];
 var NAME_SOURCE_VISIBLE_FIELDS = [
   "kind",
   "name",
@@ -300710,6 +300833,15 @@ var contractAddKindEntry = defineAddKindRegistryEntry({
 init_cli_diagnostics();
 var CORE_VARIATION_MISSING_NAME_MESSAGE = "`wp-typia add core-variation` requires <name>. Usage: wp-typia add core-variation <block-name> <name> or wp-typia add core-variation <name> --block <namespace/block>.";
 var CORE_VARIATION_MISSING_BLOCK_MESSAGE = "`wp-typia add core-variation` requires <block-name>. Usage: wp-typia add core-variation <block-name> <name> or wp-typia add core-variation <name> --block <namespace/block>.";
+var CORE_VARIATION_BLOCK_NAME_PATTERN = /^[^/\s]+\/[^/\s]+$/u;
+function formatCoreVariationMissingPositionalNameMessage(blockName) {
+  return [
+    `\`wp-typia add core-variation ${blockName}\` is missing <name>.`,
+    "Usage: wp-typia add core-variation <block-name> <name>",
+    "Alternative: wp-typia add core-variation <name> --block <namespace/block>"
+  ].join(`
+`);
+}
 function resolveCoreVariationInputs(context) {
   const positionalTargetBlockName = context.positionalArgs?.[1];
   const positionalVariationName = context.positionalArgs?.[2];
@@ -300722,16 +300854,17 @@ function resolveCoreVariationInputs(context) {
       variationName: positionalVariationName
     };
   }
-  if (context.name?.includes("/") && !readOptionalStrictStringFlag(context.flags, "block")) {
-    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, CORE_VARIATION_MISSING_NAME_MESSAGE);
+  const targetBlockFlag = readOptionalStrictStringFlag(context.flags, "block");
+  const missingPositionalNameTarget = context.name !== undefined && positionalTargetBlockName === context.name && CORE_VARIATION_BLOCK_NAME_PATTERN.test(context.name) ? context.name : undefined;
+  if (missingPositionalNameTarget && !targetBlockFlag) {
+    throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, formatCoreVariationMissingPositionalNameMessage(missingPositionalNameTarget));
   }
   const variationName = requireAddKindName(context, CORE_VARIATION_MISSING_NAME_MESSAGE);
-  const targetBlockName = readOptionalStrictStringFlag(context.flags, "block");
-  if (!targetBlockName) {
+  if (!targetBlockFlag) {
     throw createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, CORE_VARIATION_MISSING_BLOCK_MESSAGE);
   }
   return {
-    targetBlockName,
+    targetBlockName: targetBlockFlag,
     variationName
   };
 }
@@ -300763,6 +300896,7 @@ var coreVariationAddKindEntry = defineAddKindRegistryEntry({
         variationFile: result.variationFile,
         variationSlug: result.variationSlug
       }),
+      getWarnings: (result) => result.warnings,
       missingNameMessage: CORE_VARIATION_MISSING_NAME_MESSAGE,
       name: variationName,
       warnLine: context.warnLine
@@ -300909,10 +301043,12 @@ var integrationEnvAddKindEntry = defineAddKindRegistryEntry({
   supportsDryRun: true,
   usage: "wp-typia add integration-env <name> [--wp-env] [--release-zip] [--service <none|docker-compose>] [--dry-run]",
   visibleFieldNames: () => NAME_ONLY_VISIBLE_FIELDS,
-  hiddenBooleanSubmitFields: ["wp-env", "release-zip"]
+  hiddenBooleanSubmitFields: ["wp-env", "release-zip"],
+  hiddenStringSubmitFields: ["service"]
 });
 
 // src/add-kinds/pattern.ts
+init_cli_diagnostics();
 var PATTERN_MISSING_NAME_MESSAGE = "`wp-typia add pattern` requires <name>. Usage: wp-typia add pattern <name>.";
 var patternAddKindEntry = defineAddKindRegistryEntry({
   completion: {
@@ -300928,21 +301064,18 @@ var patternAddKindEntry = defineAddKindRegistryEntry({
     title: "Added workspace pattern"
   },
   description: "Add a PHP block pattern shell",
-  hiddenStringSubmitFields: [
-    "scope",
-    "section-role",
-    "tags",
-    "thumbnail-url"
-  ],
+  hiddenStringSubmitFields: ["tag", "tags", "thumbnail-url"],
   nameLabel: "Pattern name",
   async prepareExecution(context) {
     const name2 = requireAddKindName(context, PATTERN_MISSING_NAME_MESSAGE);
-    const scope = typeof context.flags.scope === "string" ? context.flags.scope : undefined;
-    const sectionRole = typeof context.flags["section-role"] === "string" ? context.flags["section-role"] : undefined;
-    const tags = typeof context.flags.tags === "string" ? context.flags.tags : undefined;
+    const scope = resolvePatternScopeFlag(context);
+    const sectionRole = resolvePatternSectionRoleFlag(context, scope);
+    const catalogTitle = typeof context.flags["catalog-title"] === "string" ? context.flags["catalog-title"] : undefined;
+    const tags = normalizePatternTagFlags(context.flags.tags, context.flags.tag);
     const thumbnailUrl = typeof context.flags["thumbnail-url"] === "string" ? context.flags["thumbnail-url"] : undefined;
     return {
       execute: (cwd) => context.addRuntime.runAddPatternCommand({
+        catalogTitle,
         cwd,
         patternScope: scope,
         patternName: name2,
@@ -300961,9 +301094,58 @@ var patternAddKindEntry = defineAddKindRegistryEntry({
   },
   sortOrder: 60,
   supportsDryRun: true,
-  usage: "wp-typia add pattern <name> [--scope <full|section>] [--section-role <role>] [--tags <tag,...>] [--thumbnail-url <url>] [--dry-run]",
-  visibleFieldNames: () => NAME_ONLY_VISIBLE_FIELDS
+  usage: "wp-typia add pattern <name> [--scope <full|section>] [--section-role <role>] [--catalog-title <title>] [--tags <tag,...>] [--tag <tag>...] [--thumbnail-url <url>] [--dry-run]",
+  visibleFieldNames: () => PATTERN_CATALOG_VISIBLE_FIELDS
 });
+function createInvalidPatternArgumentError(message) {
+  return createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.INVALID_ARGUMENT, message);
+}
+function createMissingPatternArgumentError(message) {
+  return createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, message);
+}
+function resolvePatternScopeFlag(context) {
+  const scope = readOptionalLooseStringFlag(context.flags, "scope");
+  if (!scope) {
+    return;
+  }
+  if (context.addRuntime.PATTERN_CATALOG_SCOPE_IDS.includes(scope)) {
+    return scope;
+  }
+  throw createInvalidPatternArgumentError(`\`--scope\` must be one of: ${context.addRuntime.PATTERN_CATALOG_SCOPE_IDS.join(", ")}. Usage: wp-typia add pattern <name> --scope <full|section>.`);
+}
+function resolvePatternSectionRoleFlag(context, scope) {
+  const sectionRole = readOptionalLooseStringFlag(context.flags, "section-role");
+  if (scope === "section" && sectionRole === undefined) {
+    throw createMissingPatternArgumentError("`wp-typia add pattern --scope section` requires --section-role <role> because section-scoped patterns need a typed catalog section role.");
+  }
+  if (scope !== "section" && sectionRole !== undefined) {
+    throw createInvalidPatternArgumentError("`--section-role` only applies with `--scope section`. Use `--scope section --section-role <role>` or omit `--section-role` for full patterns.");
+  }
+  const normalizedSectionRole = sectionRole === undefined ? undefined : context.addRuntime.normalizeBlockSlug(sectionRole);
+  if (normalizedSectionRole && !context.addRuntime.PATTERN_SECTION_ROLE_PATTERN.test(normalizedSectionRole)) {
+    throw createInvalidPatternArgumentError("`--section-role` must start with a lowercase letter and contain only lowercase letters, numbers, and hyphens. Section roles apply only with `--scope section`.");
+  }
+  if (sectionRole !== undefined && !normalizedSectionRole) {
+    throw createInvalidPatternArgumentError("`--section-role` must start with a lowercase letter and contain only lowercase letters, numbers, and hyphens. Section roles apply only with `--scope section`.");
+  }
+  return normalizedSectionRole;
+}
+function collectStringFlagValues(value2) {
+  if (typeof value2 === "string") {
+    return [value2];
+  }
+  if (Array.isArray(value2)) {
+    return value2.filter((item) => typeof item === "string");
+  }
+  return [];
+}
+function normalizePatternTagFlags(tagsFlag, tagFlag) {
+  const tags = [
+    ...collectStringFlagValues(tagsFlag),
+    ...collectStringFlagValues(tagFlag)
+  ];
+  return tags.length > 0 ? tags : undefined;
+}
 
 // src/add-kinds/post-meta.ts
 var POST_META_MISSING_NAME_MESSAGE = "`wp-typia add post-meta` requires <name>. Usage: wp-typia add post-meta <name> --post-type <post-type> [--type <ExportedTypeName>] [--meta-key <meta-key>].";
@@ -301712,7 +301894,7 @@ function buildStructuredInitSuccessPayload(plan) {
 // package.json
 var package_default2 = {
   name: "wp-typia",
-  version: "0.24.0",
+  version: "0.24.2",
   description: "Canonical CLI package for wp-typia scaffolding and project workflows",
   packageManager: "bun@1.3.11",
   type: "module",
@@ -301782,7 +301964,7 @@ var package_default2 = {
     "@bunli/tui": "0.6.0",
     "@bunli/utils": "0.6.0",
     "@wp-typia/api-client": "^0.4.5",
-    "@wp-typia/project-tools": "0.24.0",
+    "@wp-typia/project-tools": "0.24.2",
     "better-result": "^2.7.0",
     react: "^19.2.5",
     "react-dom": "^19.2.5",
@@ -304170,4 +304352,4 @@ export {
   cli
 };
 
-//# debugId=9B4E6E13B5DCD93064756E2164756E21
+//# debugId=EDC8802048054A1E64756E2164756E21