wp-typia 0.24.1 → 0.24.2

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

@@ -37567,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>] [--catalog-title <title>] [--tags <tag,...>|--tag <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]
@@ -37595,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\`; pass \`--catalog-title "Hero Photo"\` to override the generated catalog title, and pass \`--tags hero,landing\` or repeat \`--tag hero --tag landing\` to set catalog tags.
+  \`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.
@@ -240181,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.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.`);
     }
   }
@@ -240216,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);
@@ -240234,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
@@ -244141,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,
@@ -299808,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": {
@@ -299856,12 +299862,12 @@ var ADD_OPTION_METADATA = {
     type: "string"
   },
   tags: {
-    description: "Comma-separated tags for typed pattern catalog entries; may be repeated.",
+    description: "Comma-separated tags for typed pattern catalog entries; combine with repeatable --tag for single tags.",
     repeatable: true,
     type: "string"
   },
   tag: {
-    description: "Repeatable singular tag for typed pattern catalog entries.",
+    description: "Repeatable single tag for typed pattern catalog entries; use --tags for comma-separated lists.",
     repeatable: true,
     type: "string"
   },
@@ -300350,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",
@@ -300820,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];
@@ -300832,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
   };
 }
@@ -301020,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: {
@@ -301039,19 +301064,12 @@ var patternAddKindEntry = defineAddKindRegistryEntry({
     title: "Added workspace pattern"
   },
   description: "Add a PHP block pattern shell",
-  hiddenStringSubmitFields: [
-    "catalog-title",
-    "scope",
-    "section-role",
-    "tag",
-    "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 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;
@@ -301076,9 +301094,42 @@ var patternAddKindEntry = defineAddKindRegistryEntry({
   },
   sortOrder: 60,
   supportsDryRun: true,
-  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: () => 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];
@@ -301093,13 +301144,7 @@ function normalizePatternTagFlags(tagsFlag, tagFlag) {
     ...collectStringFlagValues(tagsFlag),
     ...collectStringFlagValues(tagFlag)
   ];
-  if (tags.length === 0) {
-    return;
-  }
-  if (tags.length === 1) {
-    return tags[0];
-  }
-  return tags;
+  return tags.length > 0 ? tags : undefined;
 }
 
 // src/add-kinds/post-meta.ts
@@ -301849,7 +301894,7 @@ function buildStructuredInitSuccessPayload(plan) {
 // package.json
 var package_default2 = {
   name: "wp-typia",
-  version: "0.24.1",
+  version: "0.24.2",
   description: "Canonical CLI package for wp-typia scaffolding and project workflows",
   packageManager: "bun@1.3.11",
   type: "module",
@@ -301919,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.1",
+    "@wp-typia/project-tools": "0.24.2",
     "better-result": "^2.7.0",
     react: "^19.2.5",
     "react-dom": "^19.2.5",
@@ -304307,4 +304352,4 @@ export {
   cli
 };
 
-//# debugId=2782AF044AA7C53F64756E2164756E21
+//# debugId=EDC8802048054A1E64756E2164756E21

package/dist-bunli/{cli-4ah8dawy.js → cli-4eqznv15.js}

@@ -14,11 +14,11 @@ import {
   isOmittableBuiltInTemplateLayerDir,
   resolveBuiltInTemplateSource,
   resolveBuiltInTemplateSourceFromLayerDirs
-} from "./cli-gaq29kzp.js";
+} from "./cli-vxd8eyax.js";
 import {
   DEFAULT_WORDPRESS_ENV_VERSION,
   getPackageVersions
-} from "./cli-zjw3eqfj.js";
+} from "./cli-wfvf3tv1.js";
 import {
   BUILTIN_BLOCK_METADATA_VERSION,
   COMPOUND_CHILD_BLOCK_METADATA_DEFAULTS,
@@ -36,7 +36,7 @@ import {
 } from "./cli-8hxf9qw6.js";
 import {
   seedProjectMigrations
-} from "./cli-fzhkqzc7.js";
+} from "./cli-6ys6d16y.js";
 import {
   ensureMigrationDirectories,
   isPlainObject,
@@ -63,7 +63,7 @@ import {
   toTitleCase,
   validateBlockSlug,
   validateNamespace
-} from "./cli-h2v72j8q.js";
+} from "./cli-kbqztfkt.js";
 import {
   createManagedTempRoot
 } from "./cli-t73q5aqz.js";

package/dist-bunli/{cli-1xt99e09.js → cli-6mr6vja7.js}

@@ -14,7 +14,7 @@ import {
 // package.json
 var package_default = {
   name: "wp-typia",
-  version: "0.24.1",
+  version: "0.24.2",
   description: "Canonical CLI package for wp-typia scaffolding and project workflows",
   packageManager: "bun@1.3.11",
   type: "module",
@@ -84,7 +84,7 @@ var package_default = {
     "@bunli/tui": "0.6.0",
     "@bunli/utils": "0.6.0",
     "@wp-typia/api-client": "^0.4.5",
-    "@wp-typia/project-tools": "0.24.1",
+    "@wp-typia/project-tools": "0.24.2",
     "better-result": "^2.7.0",
     react: "^19.2.5",
     "react-dom": "^19.2.5",
@@ -286,11 +286,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": {
@@ -334,12 +334,12 @@ var ADD_OPTION_METADATA = {
     type: "string"
   },
   tags: {
-    description: "Comma-separated tags for typed pattern catalog entries; may be repeated.",
+    description: "Comma-separated tags for typed pattern catalog entries; combine with repeatable --tag for single tags.",
     repeatable: true,
     type: "string"
   },
   tag: {
-    description: "Repeatable singular tag for typed pattern catalog entries.",
+    description: "Repeatable single tag for typed pattern catalog entries; use --tags for comma-separated lists.",
     repeatable: true,
     type: "string"
   },
@@ -635,22 +635,32 @@ var COMMAND_ROUTING_METADATA = buildArgvWalkerRoutingMetadata(ALL_COMMAND_OPTION
 function createMissingOptionValueError(optionLabel) {
   return createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.MISSING_ARGUMENT, `\`${optionLabel}\` requires a value.`);
 }
-function extractKnownOptionValuesFromArgv(argv, options) {
+function createUnknownOptionError(optionLabel) {
+  return createCliDiagnosticCodeError(CLI_DIAGNOSTIC_CODES.INVALID_ARGUMENT, `Unknown option \`${optionLabel}\`.`);
+}
+function walkArgvOptions(argv, options) {
   const flags = {};
   const nextArgv = [];
-  const optionNames = new Set(options.optionNames);
+  const booleanOptionNames = new Set(options.parser.booleanOptionNames);
+  const optionNames = new Set(options.optionNames ?? []);
+  for (const optionName of options.extraBooleanOptionNames ?? []) {
+    booleanOptionNames.add(optionName);
+  }
   for (let index = 0;index < argv.length; index += 1) {
     const arg = argv[index];
     if (!arg) {
       continue;
     }
     if (arg === "--") {
-      nextArgv.push(...argv.slice(index));
+      nextArgv.push(...argv.slice(index + (options.strict ? 1 : 0)));
       break;
     }
     if (arg.length === 2 && arg.startsWith("-")) {
       const shortFlag = options.parser.shortFlagMap.get(arg.slice(1));
-      if (!shortFlag || !optionNames.has(shortFlag.name)) {
+      if (!shortFlag || !options.strict && !optionNames.has(shortFlag.name)) {
+        if (options.strict) {
+          throw createUnknownOptionError(arg);
+        }
         nextArgv.push(arg);
         continue;
       }
@@ -675,15 +685,18 @@ function extractKnownOptionValuesFromArgv(argv, options) {
       const separatorIndex = option.indexOf("=");
       const rawName = separatorIndex === -1 ? option : option.slice(0, separatorIndex);
       const inlineValue = separatorIndex === -1 ? undefined : option.slice(separatorIndex + 1);
-      if (!optionNames.has(rawName)) {
+      if (!options.strict && !optionNames.has(rawName)) {
         nextArgv.push(arg);
         continue;
       }
-      if (options.parser.booleanOptionNames.has(rawName)) {
+      if (booleanOptionNames.has(rawName)) {
         flags[rawName] = true;
         continue;
       }
       if (!options.parser.stringOptionNames.has(rawName)) {
+        if (options.strict) {
+          throw createUnknownOptionError(`--${rawName}`);
+        }
         nextArgv.push(arg);
         continue;
       }
@@ -710,6 +723,9 @@ function extractKnownOptionValuesFromArgv(argv, options) {
       index += 1;
       continue;
     }
+    if (arg.startsWith("-") && options.strict) {
+      throw createUnknownOptionError(arg);
+    }
     nextArgv.push(arg);
   }
   return {
@@ -717,6 +733,13 @@ function extractKnownOptionValuesFromArgv(argv, options) {
     flags
   };
 }
+function extractKnownOptionValuesFromArgv(argv, options) {
+  return walkArgvOptions(argv, {
+    optionNames: options.optionNames,
+    parser: options.parser,
+    strict: false
+  });
+}
 function resolveCommandOptionValues(metadata, options) {
   const resolved = {};
   const optionNames = options.optionNames ?? Object.keys(metadata);
@@ -1205,4 +1228,4 @@ function createPlugin(input) {
 }
 export { createPlugin, package_default, collectPositionalIndexes, findFirstPositionalIndex, ADD_OPTION_METADATA, CREATE_OPTION_METADATA, DOCTOR_OPTION_METADATA, GLOBAL_OPTION_METADATA, INIT_OPTION_METADATA, MCP_OPTION_METADATA, MIGRATE_OPTION_METADATA, SYNC_OPTION_METADATA, TEMPLATES_OPTION_METADATA, COMMAND_OPTION_METADATA_BY_GROUP, ALL_COMMAND_OPTION_METADATA, buildCommandOptions, collectOptionNamesByType, buildCommandOptionParser, COMMAND_ROUTING_METADATA, createMissingOptionValueError, extractKnownOptionValuesFromArgv, resolveCommandOptionValues, normalizeCliOutputFormatArgv, validateCliOutputFormatArgv, prefersStructuredCliOutput, emitCliDiagnosticFailure, writeStructuredCliDiagnosticError, formatAddKindList, formatAddKindUsagePlaceholder, WP_TYPIA_CANONICAL_CREATE_USAGE, WP_TYPIA_RESERVED_TOP_LEVEL_COMMAND_NAMES, WP_TYPIA_TOP_LEVEL_COMMAND_NAMES, WP_TYPIA_COMMAND_OPTION_GROUP_NAMES_BY_TOP_LEVEL_COMMAND, WP_TYPIA_CONFIG_SOURCES, mergeWpTypiaUserConfig, loadWpTypiaUserConfigFromSource, loadWpTypiaUserConfig, getCreateDefaults, getAddBlockDefaults, getMcpSchemaSources };
 
-//# debugId=C72B79CCBF0C2E7664756E2164756E21
+//# debugId=6550DDC468E315F664756E2164756E21

package/dist-bunli/{cli-fzhkqzc7.js → cli-6ys6d16y.js}

@@ -47,7 +47,7 @@ import {
 } from "./cli-e4bwd81c.js";
 import {
   readWorkspaceInventory
-} from "./cli-h2v72j8q.js";
+} from "./cli-kbqztfkt.js";
 import {
   getInvalidWorkspaceProjectReason,
   tryResolveWorkspaceProject

package/dist-bunli/{cli-add-mr731xtv.js → cli-add-r4c15g7g.js}

@@ -24,7 +24,7 @@ import {
   scaffoldProject,
   syncPersistenceRestArtifacts,
   updatePluginHeaderCompatibility
-} from "./cli-4ah8dawy.js";
+} from "./cli-4eqznv15.js";
 import {
   parseTemplateLocator,
   require_semver
@@ -53,7 +53,7 @@ import {
   loadPostMetaBindingFields,
   maskTypeScriptCommentsAndLiterals
 } from "./cli-z48frc8t.js";
-import"./cli-gaq29kzp.js";
+import"./cli-vxd8eyax.js";
 import {
   DEFAULT_WORDPRESS_ABILITIES_VERSION,
   DEFAULT_WORDPRESS_CORE_ABILITIES_VERSION,
@@ -63,13 +63,13 @@ import {
   DEFAULT_WP_TYPIA_DATAVIEWS_VERSION,
   getPackageVersions,
   resolveManagedPackageVersionRange
-} from "./cli-zjw3eqfj.js";
+} from "./cli-wfvf3tv1.js";
 import {
   SHARED_WORKSPACE_TEMPLATE_ROOT
 } from "./cli-8hxf9qw6.js";
 import {
   snapshotProjectVersion
-} from "./cli-fzhkqzc7.js";
+} from "./cli-6ys6d16y.js";
 import {
   ensureMigrationDirectories,
   parseMigrationConfig,
@@ -80,6 +80,8 @@ import {
   ADD_BLOCK_TEMPLATE_IDS,
   EDITOR_PLUGIN_SLOT_IDS,
   PATTERN_CATALOG_SCOPE_IDS,
+  PATTERN_SECTION_ROLE_PATTERN,
+  PATTERN_TAG_PATTERN,
   appendWorkspaceInventoryEntries,
   assertAbilityDoesNotExist,
   assertAdminViewDoesNotExist,
@@ -144,7 +146,7 @@ import {
   toPascalCase,
   toSnakeCase,
   toTitleCase
-} from "./cli-h2v72j8q.js";
+} from "./cli-kbqztfkt.js";
 import"./cli-cvxvcw7c.js";
 import {
   createManagedTempRoot
@@ -6901,7 +6903,6 @@ function ${patternRegistrationFunctionName}() {
 // ../wp-typia-project-tools/src/runtime/cli-add-workspace-pattern-options.ts
 import path19 from "path";
 var PATTERN_CONTENT_FILE_ROOT = "src/patterns/";
-var PATTERN_TAG_PATTERN = /^[a-z0-9][a-z0-9-]*$/u;
 function assertValidPatternRelativePath(label, value, usage) {
   const normalizedPath = value.trim().replace(/\\/gu, "/");
   if (normalizedPath.length === 0 || path19.isAbsolute(normalizedPath) || normalizedPath.split("/").includes("..") || /[<>:"|?*\u0000-\u001F]/u.test(normalizedPath)) {
@@ -6934,11 +6935,15 @@ function resolvePatternScope(scope) {
   }
   throw new Error(`Pattern scope must be one of: ${PATTERN_CATALOG_SCOPE_IDS.join(", ")}.`);
 }
-function normalizeOptionalSlug(label, value, usage) {
+function normalizePatternSectionRole(value) {
   if (value === undefined || value.trim() === "") {
     return;
   }
-  return assertValidGeneratedSlug(label, normalizeBlockSlug(value), usage);
+  const sectionRole = normalizeBlockSlug(value);
+  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.flatMap((tag) => tag.split(",")) : [];
@@ -6969,12 +6974,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);
@@ -10639,14 +10644,17 @@ export {
   runAddAiFeatureCommand,
   runAddAdminViewCommand,
   runAddAbilityCommand,
+  normalizeBlockSlug,
   isAddBlockTemplateId,
   getWorkspaceBlockSelectOptionsAsync,
   getWorkspaceBlockSelectOptions,
   formatAddHelpText,
+  PATTERN_TAG_PATTERN,
+  PATTERN_SECTION_ROLE_PATTERN,
   PATTERN_CATALOG_SCOPE_IDS,
   EDITOR_PLUGIN_SLOT_IDS,
   ADD_KIND_IDS,
   ADD_BLOCK_TEMPLATE_IDS
 };
 
-//# debugId=FE26DE542557245464756E2164756E21
+//# debugId=3EDD3B6180967F3A64756E2164756E21

package/dist-bunli/{cli-doctor-kf9gwdhh.js → cli-doctor-fd6mfx0f.js}

@@ -11,7 +11,7 @@ import {
 import {
   getBuiltInTemplateLayerDirs,
   isOmittableBuiltInTemplateLayerDir
-} from "./cli-gaq29kzp.js";
+} from "./cli-vxd8eyax.js";
 import {
   isBuiltInTemplateId,
   listTemplates
@@ -33,7 +33,7 @@ import {
   resolveEditorPluginSlotAlias,
   resolvePatternCatalogContentFile,
   validatePatternCatalog
-} from "./cli-h2v72j8q.js";
+} from "./cli-kbqztfkt.js";
 import"./cli-cvxvcw7c.js";
 import"./cli-t73q5aqz.js";
 import"./cli-bajwv85z.js";

package/dist-bunli/{cli-init-557vq109.js → cli-init-kmredfj7.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   getPackageVersions
-} from "./cli-zjw3eqfj.js";
+} from "./cli-wfvf3tv1.js";
 import"./cli-8hxf9qw6.js";
 import {
   discoverMigrationInitLayout
@@ -13,7 +13,7 @@ import {
   snapshotWorkspaceFiles,
   toPascalCase,
   updateWorkspaceInventorySource
-} from "./cli-h2v72j8q.js";
+} from "./cli-kbqztfkt.js";
 import"./cli-cvxvcw7c.js";
 import"./cli-bajwv85z.js";
 import {