@wp-typia/project-tools 0.23.1 → 0.24.0

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

@@ -7,9 +7,9 @@
  * - `cli-add-block` for built-in block scaffolding
  * - `cli-add-workspace` for workspace mutation commands
  */
-export { ADD_BLOCK_TEMPLATE_IDS, ADD_KIND_IDS, EDITOR_PLUGIN_SLOT_IDS, formatAddHelpText, isAddBlockTemplateId, suggestAddBlockTemplateId, } from "./cli-add-shared.js";
-export type { AddBlockTemplateId, AddKindId, EditorPluginSlotId, } from "./cli-add-shared.js";
+export { ADD_BLOCK_TEMPLATE_IDS, ADD_KIND_IDS, EDITOR_PLUGIN_SLOT_IDS, formatAddHelpText, isAddBlockTemplateId, PATTERN_CATALOG_SCOPE_IDS, suggestAddBlockTemplateId, } from "./cli-add-shared.js";
+export type { AddBlockTemplateId, AddKindId, EditorPluginSlotId, PatternCatalogScope, } from "./cli-add-shared.js";
 export { runAddBlockCommand, seedWorkspaceMigrationProject, } from "./cli-add-block.js";
-export { runAddAdminViewCommand, runAddAbilityCommand, runAddAiFeatureCommand, runAddBindingSourceCommand, runAddBlockStyleCommand, runAddBlockTransformCommand, runAddContractCommand, runAddEditorPluginCommand, runAddHookedBlockCommand, runAddIntegrationEnvCommand, runAddPatternCommand, runAddPostMetaCommand, runAddRestResourceCommand, runAddVariationCommand, } from "./cli-add-workspace.js";
+export { runAddAdminViewCommand, runAddAbilityCommand, runAddAiFeatureCommand, runAddBindingSourceCommand, runAddBlockStyleCommand, runAddBlockTransformCommand, runAddContractCommand, runAddCoreVariationCommand, runAddEditorPluginCommand, runAddHookedBlockCommand, runAddIntegrationEnvCommand, runAddPatternCommand, runAddPostMetaCommand, runAddRestResourceCommand, runAddVariationCommand, } from "./cli-add-workspace.js";
 export { getWorkspaceBlockSelectOptions, getWorkspaceBlockSelectOptionsAsync, } from "./workspace-inventory.js";
 export type { WorkspaceBlockSelectOption } from "./workspace-inventory.js";

package/dist/runtime/cli-add.js

@@ -7,7 +7,7 @@
  * - `cli-add-block` for built-in block scaffolding
  * - `cli-add-workspace` for workspace mutation commands
  */
-export { ADD_BLOCK_TEMPLATE_IDS, ADD_KIND_IDS, EDITOR_PLUGIN_SLOT_IDS, formatAddHelpText, isAddBlockTemplateId, suggestAddBlockTemplateId, } from "./cli-add-shared.js";
+export { ADD_BLOCK_TEMPLATE_IDS, ADD_KIND_IDS, EDITOR_PLUGIN_SLOT_IDS, formatAddHelpText, isAddBlockTemplateId, PATTERN_CATALOG_SCOPE_IDS, suggestAddBlockTemplateId, } from "./cli-add-shared.js";
 export { runAddBlockCommand, seedWorkspaceMigrationProject, } from "./cli-add-block.js";
-export { runAddAdminViewCommand, runAddAbilityCommand, runAddAiFeatureCommand, runAddBindingSourceCommand, runAddBlockStyleCommand, runAddBlockTransformCommand, runAddContractCommand, runAddEditorPluginCommand, runAddHookedBlockCommand, runAddIntegrationEnvCommand, runAddPatternCommand, runAddPostMetaCommand, runAddRestResourceCommand, runAddVariationCommand, } from "./cli-add-workspace.js";
+export { runAddAdminViewCommand, runAddAbilityCommand, runAddAiFeatureCommand, runAddBindingSourceCommand, runAddBlockStyleCommand, runAddBlockTransformCommand, runAddContractCommand, runAddCoreVariationCommand, runAddEditorPluginCommand, runAddHookedBlockCommand, runAddIntegrationEnvCommand, runAddPatternCommand, runAddPostMetaCommand, runAddRestResourceCommand, runAddVariationCommand, } from "./cli-add-workspace.js";
 export { getWorkspaceBlockSelectOptions, getWorkspaceBlockSelectOptionsAsync, } from "./workspace-inventory.js";

package/dist/runtime/cli-core.d.ts

@@ -33,7 +33,8 @@
 export { createDoctorRunSummary, getDoctorChecks, getDoctorExitFailureChecks, getDoctorExitFailureDetailLines, runDoctor, type DoctorCheck, type DoctorCheckScope, type DoctorExitPolicy, type DoctorFailureSummary, type DoctorRunSummary, } from "./cli-doctor.js";
 export { createCliCommandError, createCliDiagnosticCodeError, CliDiagnosticError, CLI_DIAGNOSTIC_CODE_METADATA, CLI_DIAGNOSTIC_CODES, formatCliDiagnosticError, formatDoctorCheckLine, formatDoctorSummaryLine, getCliDiagnosticCodeMetadata, getDoctorFailureDetailLines, getFailingDoctorChecks, isCliDiagnosticError, } from "./cli-diagnostics.js";
 export type { CliDiagnosticCode, CliDiagnosticCodeError, CliDiagnosticMessage, } from "./cli-diagnostics.js";
-export { EDITOR_PLUGIN_SLOT_IDS, formatAddHelpText, getWorkspaceBlockSelectOptions, getWorkspaceBlockSelectOptionsAsync, runAddAdminViewCommand, runAddAbilityCommand, runAddBindingSourceCommand, runAddAiFeatureCommand, runAddBlockCommand, runAddBlockStyleCommand, runAddBlockTransformCommand, runAddContractCommand, runAddEditorPluginCommand, runAddHookedBlockCommand, runAddPatternCommand, runAddPostMetaCommand, runAddRestResourceCommand, runAddVariationCommand, seedWorkspaceMigrationProject, } from "./cli-add.js";
+export { EDITOR_PLUGIN_SLOT_IDS, formatAddHelpText, getWorkspaceBlockSelectOptions, getWorkspaceBlockSelectOptionsAsync, PATTERN_CATALOG_SCOPE_IDS, runAddAdminViewCommand, runAddAbilityCommand, runAddBindingSourceCommand, runAddAiFeatureCommand, runAddBlockCommand, runAddBlockStyleCommand, runAddBlockTransformCommand, runAddContractCommand, runAddCoreVariationCommand, runAddEditorPluginCommand, runAddHookedBlockCommand, runAddPatternCommand, runAddPostMetaCommand, runAddRestResourceCommand, runAddVariationCommand, seedWorkspaceMigrationProject, } from "./cli-add.js";
+export type { PatternCatalogScope } from "./cli-add.js";
 export { COMPOUND_INNER_BLOCKS_PRESET_IDS, getCompoundInnerBlocksPresetDefinition, } from "./compound-inner-blocks.js";
 export type { CompoundInnerBlocksPresetId } from "./compound-inner-blocks.js";
 export { HOOKED_BLOCK_POSITION_IDS } from "./hooked-blocks.js";

package/dist/runtime/cli-core.js

@@ -32,7 +32,7 @@
  */
 export { createDoctorRunSummary, getDoctorChecks, getDoctorExitFailureChecks, getDoctorExitFailureDetailLines, runDoctor, } from "./cli-doctor.js";
 export { createCliCommandError, createCliDiagnosticCodeError, CliDiagnosticError, CLI_DIAGNOSTIC_CODE_METADATA, CLI_DIAGNOSTIC_CODES, formatCliDiagnosticError, formatDoctorCheckLine, formatDoctorSummaryLine, getCliDiagnosticCodeMetadata, getDoctorFailureDetailLines, getFailingDoctorChecks, isCliDiagnosticError, } from "./cli-diagnostics.js";
-export { EDITOR_PLUGIN_SLOT_IDS, formatAddHelpText, getWorkspaceBlockSelectOptions, getWorkspaceBlockSelectOptionsAsync, runAddAdminViewCommand, runAddAbilityCommand, runAddBindingSourceCommand, runAddAiFeatureCommand, runAddBlockCommand, runAddBlockStyleCommand, runAddBlockTransformCommand, runAddContractCommand, runAddEditorPluginCommand, runAddHookedBlockCommand, runAddPatternCommand, runAddPostMetaCommand, runAddRestResourceCommand, runAddVariationCommand, seedWorkspaceMigrationProject, } from "./cli-add.js";
+export { EDITOR_PLUGIN_SLOT_IDS, formatAddHelpText, getWorkspaceBlockSelectOptions, getWorkspaceBlockSelectOptionsAsync, PATTERN_CATALOG_SCOPE_IDS, runAddAdminViewCommand, runAddAbilityCommand, runAddBindingSourceCommand, runAddAiFeatureCommand, runAddBlockCommand, runAddBlockStyleCommand, runAddBlockTransformCommand, runAddContractCommand, runAddCoreVariationCommand, runAddEditorPluginCommand, runAddHookedBlockCommand, runAddPatternCommand, runAddPostMetaCommand, runAddRestResourceCommand, runAddVariationCommand, seedWorkspaceMigrationProject, } from "./cli-add.js";
 export { COMPOUND_INNER_BLOCKS_PRESET_IDS, getCompoundInnerBlocksPresetDefinition, } from "./compound-inner-blocks.js";
 export { HOOKED_BLOCK_POSITION_IDS } from "./hooked-blocks.js";
 export { formatHelpText } from "./cli-help.js";

package/dist/runtime/cli-doctor-workspace-bindings.js

@@ -4,6 +4,7 @@ import { parseScaffoldBlockMetadata } from "@wp-typia/block-runtime/blocks";
 import { checkExistingFiles, createDoctorCheck, resolveWorkspaceBootstrapPath, WORKSPACE_BINDING_EDITOR_ASSET, WORKSPACE_BINDING_EDITOR_SCRIPT, WORKSPACE_BINDING_SERVER_GLOB, } from "./cli-doctor-workspace-shared.js";
 import { readJsonFileSync } from "./json-utils.js";
 import { escapeRegex } from "./php-utils.js";
+import { assertPostMetaBindingPath, loadPostMetaBindingFieldsSync, } from "./post-meta-binding-fields.js";
 function checkWorkspaceBindingBootstrap(projectDir, packageName) {
     const bootstrapPath = resolveWorkspaceBootstrapPath(projectDir, packageName);
     if (!fs.existsSync(bootstrapPath)) {
@@ -108,6 +109,60 @@ function checkWorkspaceBindingTarget(projectDir, workspace, registeredBlockSlugs
         ? `${bindingSource.block}.${bindingSource.attribute} is declared and supported`
         : issues.join("; "));
 }
+function checkWorkspaceBindingPostMeta(projectDir, inventory, bindingSource) {
+    if (!bindingSource.postMeta) {
+        return undefined;
+    }
+    const postMeta = inventory.postMeta.find((entry) => entry.slug === bindingSource.postMeta);
+    if (!postMeta) {
+        return createDoctorCheck(`Binding post meta ${bindingSource.slug}`, "fail", `Binding source references unknown post meta contract "${bindingSource.postMeta}".`);
+    }
+    const issues = [];
+    try {
+        const fields = loadPostMetaBindingFieldsSync(projectDir, postMeta);
+        if (bindingSource.metaPath) {
+            assertPostMetaBindingPath(fields, postMeta.slug, bindingSource.metaPath);
+        }
+    }
+    catch (error) {
+        issues.push(error instanceof Error ? error.message : String(error));
+    }
+    const serverPath = path.join(projectDir, bindingSource.serverFile);
+    if (fs.existsSync(serverPath)) {
+        const serverSource = fs.readFileSync(serverPath, "utf8");
+        if (!serverSource.includes("get_post_meta")) {
+            issues.push(`${bindingSource.serverFile} must read post meta values`);
+        }
+        if (!serverSource.includes(postMeta.metaKey)) {
+            issues.push(`${bindingSource.serverFile} must reference ${postMeta.metaKey}`);
+        }
+        if (!serverSource.includes(postMeta.schemaFile)) {
+            issues.push(`${bindingSource.serverFile} must reference ${postMeta.schemaFile}`);
+        }
+    }
+    else {
+        issues.push(`Missing ${bindingSource.serverFile}`);
+    }
+    const editorPath = path.join(projectDir, bindingSource.editorFile);
+    if (fs.existsSync(editorPath)) {
+        const editorSource = fs.readFileSync(editorPath, "utf8");
+        if (!editorSource.includes("POST_META_BINDING_FIELDS")) {
+            issues.push(`${bindingSource.editorFile} must define post meta binding fields`);
+        }
+        if (!editorSource.includes(postMeta.schemaFile)) {
+            issues.push(`${bindingSource.editorFile} must reference ${postMeta.schemaFile}`);
+        }
+        if (bindingSource.metaPath && !editorSource.includes(bindingSource.metaPath)) {
+            issues.push(`${bindingSource.editorFile} must reference default meta path "${bindingSource.metaPath}"`);
+        }
+    }
+    else {
+        issues.push(`Missing ${bindingSource.editorFile}`);
+    }
+    return createDoctorCheck(`Binding post meta ${bindingSource.slug}`, issues.length === 0 ? "pass" : "fail", issues.length === 0
+        ? `${bindingSource.slug} reads ${postMeta.slug} via ${postMeta.schemaFile}`
+        : issues.join("; "));
+}
 /**
  * Collect workspace doctor checks for extracted binding-source diagnostics.
  *
@@ -131,6 +186,10 @@ export function getWorkspaceBindingDoctorChecks(workspace, inventory) {
         if (bindingTargetCheck) {
             checks.push(bindingTargetCheck);
         }
+        const bindingPostMetaCheck = checkWorkspaceBindingPostMeta(workspace.projectDir, inventory, bindingSource);
+        if (bindingPostMetaCheck) {
+            checks.push(bindingPostMetaCheck);
+        }
     }
     return checks;
 }

package/dist/runtime/cli-doctor-workspace-block-addons.js

@@ -1,6 +1,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import { checkExistingFiles, createDoctorCheck, resolveWorkspaceBootstrapPath, WORKSPACE_FULL_BLOCK_NAME_PATTERN, } from "./cli-doctor-workspace-shared.js";
+import { formatPatternCatalogDiagnostics, resolvePatternCatalogContentFile, validatePatternCatalog, } from "./pattern-catalog.js";
 import { hasExecutablePattern, hasUncommentedPattern, } from "./ts-source-masking.js";
 const WORKSPACE_VARIATIONS_IMPORT_PATTERN = /^\s*import\s*\{\s*registerWorkspaceVariations\s*\}\s*from\s*["']\.\/variations["']\s*;?\s*$/mu;
 const WORKSPACE_VARIATIONS_CALL_PATTERN = /registerWorkspaceVariations\s*\(\s*\)\s*;?/u;
@@ -8,7 +9,15 @@ const WORKSPACE_BLOCK_STYLES_IMPORT_PATTERN = /^\s*import\s*\{\s*registerWorkspa
 const WORKSPACE_BLOCK_STYLES_CALL_PATTERN = /registerWorkspaceBlockStyles\s*\(\s*\)\s*;?/u;
 const WORKSPACE_BLOCK_TRANSFORMS_IMPORT_PATTERN = /^\s*import\s*\{\s*applyWorkspaceBlockTransforms\s*\}\s*from\s*["']\.\/transforms["']\s*;?\s*$/mu;
 const WORKSPACE_BLOCK_TRANSFORMS_CALL_PATTERN = /applyWorkspaceBlockTransforms\s*\(\s*registration\s*\.\s*settings\s*\)\s*;?/u;
-function checkWorkspacePatternBootstrap(projectDir, packageName) {
+function isNestedPatternContentFile(patternFile) {
+    if (!patternFile) {
+        return false;
+    }
+    const normalizedPath = patternFile.replace(/\\/gu, "/");
+    return (normalizedPath.startsWith("src/patterns/") &&
+        normalizedPath.slice("src/patterns/".length).includes("/"));
+}
+function checkWorkspacePatternBootstrap(projectDir, packageName, requiresNestedPatternGlob) {
     const bootstrapPath = resolveWorkspaceBootstrapPath(projectDir, packageName);
     if (!fs.existsSync(bootstrapPath)) {
         return createDoctorCheck("Pattern bootstrap", "fail", `Missing ${path.basename(bootstrapPath)}`);
@@ -16,9 +25,13 @@ function checkWorkspacePatternBootstrap(projectDir, packageName) {
     const source = fs.readFileSync(bootstrapPath, "utf8");
     const hasCategoryAnchor = source.includes("register_block_pattern_category");
     const hasPatternGlob = source.includes("/src/patterns/*.php");
-    return createDoctorCheck("Pattern bootstrap", hasCategoryAnchor && hasPatternGlob ? "pass" : "fail", hasCategoryAnchor && hasPatternGlob
+    const hasNestedPatternGlob = source.includes("/src/patterns/*/*.php");
+    const hasRequiredPatternGlobs = hasPatternGlob && (!requiresNestedPatternGlob || hasNestedPatternGlob);
+    return createDoctorCheck("Pattern bootstrap", hasCategoryAnchor && hasRequiredPatternGlobs ? "pass" : "fail", hasCategoryAnchor && hasRequiredPatternGlobs
         ? "Pattern category and loader hooks are present"
-        : "Missing pattern category registration or src/patterns loader hook");
+        : requiresNestedPatternGlob
+            ? "Missing pattern category registration or nested src/patterns loader hook"
+            : "Missing pattern category registration or src/patterns loader hook");
 }
 function checkVariationEntrypoint(projectDir, blockSlug) {
     const entryPath = path.join(projectDir, "src", "blocks", blockSlug, "index.tsx");
@@ -125,10 +138,25 @@ export function getWorkspaceBlockAddonDoctorChecks(workspace, inventory, registe
     const shouldCheckPatternBootstrap = inventory.patterns.length > 0 ||
         fs.existsSync(path.join(workspace.projectDir, "src", "patterns"));
     if (shouldCheckPatternBootstrap) {
-        checks.push(checkWorkspacePatternBootstrap(workspace.projectDir, workspace.packageName));
+        const requiresNestedPatternGlob = inventory.patterns.some((pattern) => isNestedPatternContentFile(resolvePatternCatalogContentFile(pattern)));
+        checks.push(checkWorkspacePatternBootstrap(workspace.projectDir, workspace.packageName, requiresNestedPatternGlob));
+    }
+    if (inventory.patterns.length > 0) {
+        const catalogValidation = validatePatternCatalog(inventory.patterns, {
+            projectDir: workspace.projectDir,
+        });
+        checks.push(createDoctorCheck("Pattern catalog", catalogValidation.errors.length > 0
+            ? "fail"
+            : catalogValidation.warnings.length > 0
+                ? "warn"
+                : "pass", catalogValidation.diagnostics.length > 0
+            ? formatPatternCatalogDiagnostics(catalogValidation.diagnostics)
+            : "Pattern catalog metadata is valid"));
     }
     for (const pattern of inventory.patterns) {
-        checks.push(checkExistingFiles(workspace.projectDir, `Pattern ${pattern.slug}`, [pattern.file]));
+        checks.push(checkExistingFiles(workspace.projectDir, `Pattern ${pattern.slug}`, [
+            resolvePatternCatalogContentFile(pattern),
+        ]));
     }
     return checks;
 }

package/dist/runtime/cli-doctor.d.ts

@@ -81,6 +81,8 @@ export declare function createDoctorRunSummary(checks: readonly DoctorCheck[], o
  * @param cwd Working directory to validate.
  * @param options Optional renderer overrides and exit-policy selection.
  * @param options.exitPolicy Policy deciding which failed checks contribute to the process exit code.
+ * @param options.renderLine Optional renderer for each check row. Defaults to the stdout line printer.
+ * @param options.renderSummaryLine Optional renderer for the summary row. Defaults to the stdout line printer unless a custom `renderLine` suppresses implicit summary output.
  * @returns The completed list of doctor checks.
  * @throws {Error} When one or more failed checks contribute to the exit code under the active policy.
  */

package/dist/runtime/cli-doctor.js

@@ -2,6 +2,15 @@ import { CLI_DIAGNOSTIC_CODES, createCliCommandError, formatDoctorCheckLine, for
 import { getEnvironmentDoctorChecks } from "./cli-doctor-environment.js";
 import { getWorkspaceDoctorChecks } from "./cli-doctor-workspace.js";
 const DEFAULT_DOCTOR_EXIT_POLICY = "strict";
+const defaultDoctorLinePrinter = (line) => {
+    process.stdout.write(`${line}\n`);
+};
+function renderDefaultDoctorCheckLine(check) {
+    defaultDoctorLinePrinter(formatDoctorCheckLine(check));
+}
+function renderDefaultDoctorSummaryLine(summaryLine) {
+    defaultDoctorLinePrinter(summaryLine);
+}
 function annotateDoctorChecks(checks, scope) {
     return checks.map((check) => ({
         ...check,
@@ -92,14 +101,16 @@ export function createDoctorRunSummary(checks, options = {}) {
  * @param cwd Working directory to validate.
  * @param options Optional renderer overrides and exit-policy selection.
  * @param options.exitPolicy Policy deciding which failed checks contribute to the process exit code.
+ * @param options.renderLine Optional renderer for each check row. Defaults to the stdout line printer.
+ * @param options.renderSummaryLine Optional renderer for the summary row. Defaults to the stdout line printer unless a custom `renderLine` suppresses implicit summary output.
  * @returns The completed list of doctor checks.
  * @throws {Error} When one or more failed checks contribute to the exit code under the active policy.
  */
 export async function runDoctor(cwd, options = {}) {
     const exitPolicy = resolveDoctorExitPolicy(options);
-    const renderLine = options.renderLine ?? ((check) => console.log(formatDoctorCheckLine(check)));
+    const renderLine = options.renderLine ?? renderDefaultDoctorCheckLine;
     const renderSummaryLine = options.renderSummaryLine ??
-        (options.renderLine ? () => undefined : (summaryLine) => console.log(summaryLine));
+        (options.renderLine ? () => undefined : renderDefaultDoctorSummaryLine);
     const checks = await getDoctorChecks(cwd);
     for (const check of checks) {
         renderLine(check);

package/dist/runtime/cli-help.js

@@ -22,11 +22,13 @@ export function formatHelpText() {
   wp-typia add admin-view <name> [--source <rest-resource:slug|core-data:kind/name>]
   wp-typia add block <name> [--template <basic|interactivity|persistence|compound>] [--external-layer-source <./path|github:owner/repo/path[#ref]|npm-package>] [--external-layer-id <layer-id>] [--inner-blocks-preset <freeform|ordered|horizontal|locked-structure>] [--alternate-render-targets <email,mjml,plain-text>] [--data-storage <post-meta|custom-table>] [--persistence-policy <authenticated|public>]
   wp-typia add integration-env <name> [--wp-env] [--release-zip] [--service <none|docker-compose>]
+  wp-typia add core-variation <block-name> <name>
+  wp-typia add core-variation <name> --block <namespace/block>
   wp-typia add variation <name> --block <block-slug>
   wp-typia add style <name> --block <block-slug>
   wp-typia add transform <name> --from <namespace/block> --to <block-slug|namespace/block-slug>
-  wp-typia add pattern <name>
-  wp-typia add binding-source <name> [--block <block-slug|namespace/block-slug> --attribute <attribute>]
+  wp-typia add pattern <name> [--scope <full|section>] [--section-role <role>] [--tags <tag,...>] [--thumbnail-url <url>]
+  wp-typia add binding-source <name> [--block <block-slug|namespace/block-slug> --attribute <attribute>] [--from-post-meta|--post-meta <post-meta> [--meta-path <field>]]
   wp-typia add rest-resource <name> [--namespace <vendor/v1>] [--methods <method[,method...]>]
   wp-typia add rest-resource <name> --manual [--namespace <vendor/v1>] [--method <GET|POST|PUT|PATCH|DELETE>] [--auth <public|authenticated|public-write-protected>] [--path <route-pattern>|--route-pattern <route-pattern>] [--permission-callback <callback>] [--controller-class <ClassName>] [--controller-extends <BaseClass>] [--query-type <Type>] [--body-type <Type>] [--response-type <Type>] [--secret-field <field>] [--secret-state-field|--secret-has-value-field <field>] [--secret-preserve-on-empty <true|false>]
   wp-typia add post-meta <name> --post-type <post-type> [--type <ExportedTypeName>] [--meta-key <meta-key>] [--hide-from-rest]
@@ -65,8 +67,8 @@ Notes:
   \`add variation\` uses an existing workspace block 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/\`.
-  \`add binding-source\` scaffolds shared PHP and editor registration under \`src/bindings/\`; pass \`--block\` and \`--attribute\` together to declare a bindable generated-block attribute.
+  \`add pattern\` scaffolds a namespaced PHP pattern shell under \`src/patterns/full/\` or \`src/patterns/sections/\`.
+  \`add binding-source\` scaffolds shared PHP and editor registration under \`src/bindings/\`; pass \`--block\` and \`--attribute\` together to declare a bindable generated-block attribute. Pass \`--from-post-meta\` or \`--post-meta\` to back the source from a typed post-meta contract and \`--meta-path\` to choose its default top-level field.
   \`add rest-resource\` scaffolds plugin-level TypeScript REST contracts under \`src/rest/\` and PHP route glue under \`inc/rest/\`.
   \`add rest-resource --manual\` tracks an external/provider REST route with typed schemas, OpenAPI, clients, and drift checks without generating PHP route/controller files while still allowing route-owner metadata such as permission callbacks and controller classes. Settings contracts can add \`--secret-field\` plus \`--secret-preserve-on-empty\` to model write-only credentials and preserve blank submissions.
   \`add post-meta\` scaffolds typed post meta contracts under \`src/post-meta/\`, emits schema artifacts, and wires generated \`register_post_meta()\` helpers under \`inc/post-meta/\`.

package/dist/runtime/index.d.ts

@@ -7,7 +7,8 @@
  * and workspace-aware helpers such as `getWorkspaceBlockSelectOptions`,
  * `getWorkspaceBlockSelectOptionsAsync`,
  * `runAddBlockCommand`, `runAddBlockStyleCommand`,
- * `runAddBlockTransformCommand`, `runAddVariationCommand`,
+ * `runAddBlockTransformCommand`, `runAddCoreVariationCommand`,
+ * `runAddVariationCommand`,
  * `runAddPatternCommand`, `runAddBindingSourceCommand`,
  * `runAddEditorPluginCommand`,
  * `runAddAdminViewCommand`,
@@ -38,5 +39,7 @@ export { TEMPLATE_IDS, TEMPLATE_REGISTRY, getTemplateById, getTemplateSelectOpti
 export { EXTERNAL_TEMPLATE_CACHE_TTL_DAYS_ENV, pruneExternalTemplateCache, } from "./template-source-cache.js";
 export type { ExternalTemplateCachePruneOptions, ExternalTemplateCachePruneResult, } from "./template-source-cache.js";
 export { STALE_TEMP_ROOT_MAX_AGE_MS, WP_TYPIA_TEMP_ROOT_PREFIX, cleanupManagedTempRoot, cleanupStaleTempRoots, createManagedTempRoot, getTrackedTempRoots, } from "./temp-roots.js";
-export { createReadlinePrompt, createDoctorRunSummary, createCliCommandError, createCliDiagnosticCodeError, CliDiagnosticError, CLI_DIAGNOSTIC_CODES, formatCliDiagnosticError, formatAddHelpText, formatDoctorCheckLine, formatDoctorSummaryLine, formatHelpText, formatTemplateDetails, formatTemplateFeatures, formatTemplateSummary, getDoctorChecks, getDoctorExitFailureChecks, getDoctorExitFailureDetailLines, getDoctorFailureDetailLines, getFailingDoctorChecks, getNextSteps, getOptionalOnboarding, getWorkspaceBlockSelectOptions, getWorkspaceBlockSelectOptionsAsync, HOOKED_BLOCK_POSITION_IDS, EDITOR_PLUGIN_SLOT_IDS, isCliDiagnosticError, runAddAdminViewCommand, runAddAbilityCommand, runAddAiFeatureCommand, runAddBindingSourceCommand, runAddBlockCommand, runAddBlockStyleCommand, runAddBlockTransformCommand, runAddEditorPluginCommand, runAddHookedBlockCommand, runAddPatternCommand, runAddPostMetaCommand, runDoctor, runAddVariationCommand, runScaffoldFlow, } from "./cli-core.js";
+export { createReadlinePrompt, createDoctorRunSummary, createCliCommandError, createCliDiagnosticCodeError, CliDiagnosticError, CLI_DIAGNOSTIC_CODES, formatCliDiagnosticError, formatAddHelpText, formatDoctorCheckLine, formatDoctorSummaryLine, formatHelpText, formatTemplateDetails, formatTemplateFeatures, formatTemplateSummary, getDoctorChecks, getDoctorExitFailureChecks, getDoctorExitFailureDetailLines, getDoctorFailureDetailLines, getFailingDoctorChecks, getNextSteps, getOptionalOnboarding, getWorkspaceBlockSelectOptions, getWorkspaceBlockSelectOptionsAsync, HOOKED_BLOCK_POSITION_IDS, EDITOR_PLUGIN_SLOT_IDS, isCliDiagnosticError, runAddAdminViewCommand, runAddAbilityCommand, runAddAiFeatureCommand, runAddBindingSourceCommand, runAddBlockCommand, runAddBlockStyleCommand, runAddBlockTransformCommand, runAddCoreVariationCommand, runAddEditorPluginCommand, runAddHookedBlockCommand, runAddPatternCommand, runAddPostMetaCommand, runDoctor, runAddVariationCommand, runScaffoldFlow, } from "./cli-core.js";
+export { extractPatternSectionRoleMatches, extractPatternSectionRolesFromAttributes, formatPatternCatalogDiagnostics, PATTERN_CATALOG_SCOPE_IDS, resolvePatternCatalogContentFile, validatePatternCatalog, } from "./pattern-catalog.js";
 export type { CliDiagnosticCode, CliDiagnosticCodeError, CliDiagnosticMessage, DoctorCheck, DoctorCheckScope, DoctorExitPolicy, DoctorFailureSummary, DoctorRunSummary, EditorPluginSlotId, HookedBlockPositionId, ReadlinePrompt, WorkspaceBlockSelectOption, } from "./cli-core.js";
+export type { PatternCatalogDiagnostic, PatternCatalogDiagnosticCode, PatternCatalogDiagnosticSeverity, PatternCatalogEntry, PatternCatalogScope, PatternCatalogSectionRoleConvention, PatternCatalogSectionRoleMatch, PatternCatalogValidationOptions, PatternCatalogValidationResult, } from "./pattern-catalog.js";

package/dist/runtime/index.js

@@ -7,7 +7,8 @@
  * and workspace-aware helpers such as `getWorkspaceBlockSelectOptions`,
  * `getWorkspaceBlockSelectOptionsAsync`,
  * `runAddBlockCommand`, `runAddBlockStyleCommand`,
- * `runAddBlockTransformCommand`, `runAddVariationCommand`,
+ * `runAddBlockTransformCommand`, `runAddCoreVariationCommand`,
+ * `runAddVariationCommand`,
  * `runAddPatternCommand`, `runAddBindingSourceCommand`,
  * `runAddEditorPluginCommand`,
  * `runAddAdminViewCommand`,
@@ -29,4 +30,5 @@ export { clearPackageVersionsCache, getPackageVersions, invalidatePackageVersion
 export { TEMPLATE_IDS, TEMPLATE_REGISTRY, getTemplateById, getTemplateSelectOptions, listTemplates, } from "./template-registry.js";
 export { EXTERNAL_TEMPLATE_CACHE_TTL_DAYS_ENV, pruneExternalTemplateCache, } from "./template-source-cache.js";
 export { STALE_TEMP_ROOT_MAX_AGE_MS, WP_TYPIA_TEMP_ROOT_PREFIX, cleanupManagedTempRoot, cleanupStaleTempRoots, createManagedTempRoot, getTrackedTempRoots, } from "./temp-roots.js";
-export { createReadlinePrompt, createDoctorRunSummary, createCliCommandError, createCliDiagnosticCodeError, CliDiagnosticError, CLI_DIAGNOSTIC_CODES, formatCliDiagnosticError, formatAddHelpText, formatDoctorCheckLine, formatDoctorSummaryLine, formatHelpText, formatTemplateDetails, formatTemplateFeatures, formatTemplateSummary, getDoctorChecks, getDoctorExitFailureChecks, getDoctorExitFailureDetailLines, getDoctorFailureDetailLines, getFailingDoctorChecks, getNextSteps, getOptionalOnboarding, getWorkspaceBlockSelectOptions, getWorkspaceBlockSelectOptionsAsync, HOOKED_BLOCK_POSITION_IDS, EDITOR_PLUGIN_SLOT_IDS, isCliDiagnosticError, runAddAdminViewCommand, runAddAbilityCommand, runAddAiFeatureCommand, runAddBindingSourceCommand, runAddBlockCommand, runAddBlockStyleCommand, runAddBlockTransformCommand, runAddEditorPluginCommand, runAddHookedBlockCommand, runAddPatternCommand, runAddPostMetaCommand, runDoctor, runAddVariationCommand, runScaffoldFlow, } from "./cli-core.js";
+export { createReadlinePrompt, createDoctorRunSummary, createCliCommandError, createCliDiagnosticCodeError, CliDiagnosticError, CLI_DIAGNOSTIC_CODES, formatCliDiagnosticError, formatAddHelpText, formatDoctorCheckLine, formatDoctorSummaryLine, formatHelpText, formatTemplateDetails, formatTemplateFeatures, formatTemplateSummary, getDoctorChecks, getDoctorExitFailureChecks, getDoctorExitFailureDetailLines, getDoctorFailureDetailLines, getFailingDoctorChecks, getNextSteps, getOptionalOnboarding, getWorkspaceBlockSelectOptions, getWorkspaceBlockSelectOptionsAsync, HOOKED_BLOCK_POSITION_IDS, EDITOR_PLUGIN_SLOT_IDS, isCliDiagnosticError, runAddAdminViewCommand, runAddAbilityCommand, runAddAiFeatureCommand, runAddBindingSourceCommand, runAddBlockCommand, runAddBlockStyleCommand, runAddBlockTransformCommand, runAddCoreVariationCommand, runAddEditorPluginCommand, runAddHookedBlockCommand, runAddPatternCommand, runAddPostMetaCommand, runDoctor, runAddVariationCommand, runScaffoldFlow, } from "./cli-core.js";
+export { extractPatternSectionRoleMatches, extractPatternSectionRolesFromAttributes, formatPatternCatalogDiagnostics, PATTERN_CATALOG_SCOPE_IDS, resolvePatternCatalogContentFile, validatePatternCatalog, } from "./pattern-catalog.js";

package/dist/runtime/local-dev-presets.js

@@ -8,6 +8,7 @@ import fs from "node:fs";
 import { promises as fsp } from "node:fs";
 import path from "node:path";
 import { formatRunScript, } from "./package-managers.js";
+import { DEFAULT_WORDPRESS_ENV_VERSION } from "./package-versions.js";
 import { readJsonFile } from "./json-utils.js";
 import { OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE, SHARED_TEST_PRESET_TEMPLATE_ROOT, SHARED_WP_ENV_PRESET_TEMPLATE_ROOT, } from "./template-registry.js";
 import { copyInterpolatedDirectory } from "./template-render.js";
@@ -106,7 +107,7 @@ export async function applyGeneratedProjectDxPackageJson({ compoundPersistenceEn
                 : {}),
         };
         if (withWpEnv || withTestPreset) {
-            packageJson.devDependencies["@wordpress/env"] = "^11.2.0";
+            packageJson.devDependencies["@wordpress/env"] = DEFAULT_WORDPRESS_ENV_VERSION;
         }
         if (withTestPreset) {
             packageJson.devDependencies["@playwright/test"] = "^1.54.2";

package/dist/runtime/package-versions.d.ts

@@ -23,6 +23,7 @@ export declare const DEFAULT_WORDPRESS_CORE_ABILITIES_VERSION = "^0.9.0";
 export declare const DEFAULT_WORDPRESS_CORE_DATA_VERSION = "^7.44.0";
 export declare const DEFAULT_WORDPRESS_DATA_VERSION = "^9.28.0";
 export declare const DEFAULT_WORDPRESS_DATAVIEWS_VERSION = "^14.1.0";
+export declare const DEFAULT_WORDPRESS_ENV_VERSION = "^11.2.0";
 export declare const DEFAULT_WP_TYPIA_DATAVIEWS_VERSION = "^0.1.1";
 /**
  * Resolve a managed package version range from linked workspace packages first,

package/dist/runtime/package-versions.js

@@ -20,6 +20,7 @@ export const DEFAULT_WORDPRESS_CORE_ABILITIES_VERSION = '^0.9.0';
 export const DEFAULT_WORDPRESS_CORE_DATA_VERSION = '^7.44.0';
 export const DEFAULT_WORDPRESS_DATA_VERSION = '^9.28.0';
 export const DEFAULT_WORDPRESS_DATAVIEWS_VERSION = '^14.1.0';
+export const DEFAULT_WORDPRESS_ENV_VERSION = '^11.2.0';
 export const DEFAULT_WP_TYPIA_DATAVIEWS_VERSION = '^0.1.1';
 let cachedPackageVersions = null;
 function normalizeVersionRange(value) {
@@ -175,6 +176,7 @@ export function getPackageVersions() {
     const createManifestLocation = resolvePackageManifestLocation(path.join(PROJECT_TOOLS_PACKAGE_ROOT, 'package.json'));
     const monorepoManifestLocation = resolvePackageManifestLocation(path.join(PROJECT_TOOLS_PACKAGE_ROOT, '..', '..', 'package.json'));
     const blockRuntimeManifestLocation = resolvePackageManifestLocation(path.join(PROJECT_TOOLS_PACKAGE_ROOT, '..', 'wp-typia-block-runtime', 'package.json'));
+    const blockTypesManifestLocation = resolvePackageManifestLocation(path.join(PROJECT_TOOLS_PACKAGE_ROOT, '..', 'wp-typia-block-types', 'package.json'));
     const wpTypiaManifestLocation = resolvePackageManifestLocation(path.join(PROJECT_TOOLS_PACKAGE_ROOT, '..', 'wp-typia', 'package.json'));
     const installedProjectToolsManifestLocation = resolveInstalledPackageManifestLocation('@wp-typia/project-tools');
     const installedApiClientManifestLocation = resolveInstalledPackageManifestLocation('@wp-typia/api-client');
@@ -190,6 +192,7 @@ export function getPackageVersions() {
         createManifestLocation,
         monorepoManifestLocation,
         blockRuntimeManifestLocation,
+        blockTypesManifestLocation,
         wpTypiaManifestLocation,
         installedProjectToolsManifestLocation,
         installedApiClientManifestLocation,
@@ -212,18 +215,23 @@ export function getPackageVersions() {
     const blockRuntimeManifest = readPackageManifest(blockRuntimeManifestLocation) ??
         readPackageManifest(installedBlockRuntimeManifestLocation) ??
         {};
+    const blockTypesManifest = readPackageManifest(blockTypesManifestLocation) ??
+        readPackageManifest(installedBlockTypesManifestLocation) ??
+        {};
     const wpTypiaManifest = readPackageManifest(wpTypiaManifestLocation) ??
         readPackageManifest(installedWpTypiaManifestLocation) ??
         {};
     const blockRuntimeDependencyVersion = normalizeVersionRange(createManifest.dependencies?.['@wp-typia/block-runtime']);
+    const blockTypesDependencyVersion = normalizeVersionRange(createManifest.dependencies?.['@wp-typia/block-types']);
     const versions = {
         apiClientPackageVersion: normalizeVersionRange(createManifest.dependencies?.['@wp-typia/api-client'] ??
             readPackageManifest(installedApiClientManifestLocation)?.version),
         blockRuntimePackageVersion: blockRuntimeDependencyVersion !== DEFAULT_VERSION_RANGE
             ? blockRuntimeDependencyVersion
             : normalizeVersionRange(blockRuntimeManifest.version),
-        blockTypesPackageVersion: normalizeVersionRange(createManifest.dependencies?.['@wp-typia/block-types'] ??
-            readPackageManifest(installedBlockTypesManifestLocation)?.version),
+        blockTypesPackageVersion: blockTypesDependencyVersion !== DEFAULT_VERSION_RANGE
+            ? blockTypesDependencyVersion
+            : normalizeVersionRange(blockTypesManifest.version),
         projectToolsPackageVersion: normalizeVersionRange(createManifest.version),
         restPackageVersion: normalizeVersionRange(createManifest.dependencies?.['@wp-typia/rest'] ??
             readPackageManifest(installedRestManifestLocation)?.version),

package/dist/runtime/pattern-catalog.d.ts

@@ -0,0 +1,122 @@
+import { type ParsedBlockPatternBlock } from "@wp-typia/block-runtime/metadata-core";
+export declare const PATTERN_CATALOG_SCOPE_IDS: readonly ["full", "section"];
+export type PatternCatalogScope = (typeof PATTERN_CATALOG_SCOPE_IDS)[number];
+export type PatternCatalogEntry = {
+    contentFile?: string;
+    file?: string;
+    scope?: string;
+    sectionRole?: string;
+    slug: string;
+    tags?: readonly string[];
+    thumbnailUrl?: string;
+    title?: string;
+};
+export type PatternCatalogDiagnosticSeverity = "error" | "warning";
+export type PatternCatalogDiagnosticCode = "duplicate-pattern-slug" | "invalid-pattern-content-file" | "invalid-pattern-scope" | "invalid-pattern-section-role" | "invalid-pattern-section-role-convention" | "invalid-pattern-section-role-marker" | "invalid-pattern-slug" | "invalid-pattern-tag" | "invalid-pattern-thumbnail-url" | "mismatched-pattern-section-role" | "missing-pattern-content-file" | "missing-pattern-section-role" | "missing-pattern-section-role-marker" | "duplicate-pattern-section-role-marker" | "unknown-pattern-section-role-marker";
+export type PatternCatalogDiagnostic = {
+    code: PatternCatalogDiagnosticCode;
+    message: string;
+    patternSlug?: string;
+    severity: PatternCatalogDiagnosticSeverity;
+};
+/**
+ * Convention used to discover section role markers in serialized pattern
+ * content. Defaults target `core/group` wrappers with a `section` base class,
+ * `section--{role}` role class tokens, and `metadata.sectionRole` attributes.
+ */
+export type PatternCatalogSectionRoleConvention = {
+    /**
+     * Serialized block name used as the section wrapper. Defaults to
+     * `core/group`.
+     */
+    wrapperBlockName?: string;
+    /**
+     * Optional class that marks a wrapper block as section-like even when the
+     * role marker is missing. Defaults to `section`.
+     */
+    baseClassName?: string;
+    /**
+     * Class token pattern where exactly one `{role}` placeholder is replaced by
+     * the section role slug. Defaults to `section--{role}`.
+     */
+    roleClassNamePattern?: string;
+    /**
+     * Dot-separated block attribute paths that can carry role slugs. Defaults to
+     * `metadata.sectionRole`.
+     */
+    roleAttributePaths?: readonly string[];
+    /**
+     * Warn when a full pattern repeats the same section role marker. Defaults to
+     * `false`.
+     */
+    requireUniqueFullPatternRoles?: boolean;
+};
+/**
+ * Section wrapper match extracted from a parsed WordPress block tree.
+ */
+export type PatternCatalogSectionRoleMatch = {
+    blockName: string;
+    blockPath: string;
+    roles: readonly string[];
+};
+/**
+ * Options for validating typed pattern catalog entries and, when `projectDir`
+ * is provided, their serialized pattern content. Set `sectionRoleConvention` to
+ * `false` to keep file existence checks but opt out of section-role marker
+ * validation.
+ */
+export type PatternCatalogValidationOptions = {
+    projectDir?: string;
+    sectionRoleConvention?: PatternCatalogSectionRoleConvention | false;
+};
+export type PatternCatalogValidationResult = {
+    diagnostics: PatternCatalogDiagnostic[];
+    errors: PatternCatalogDiagnostic[];
+    warnings: PatternCatalogDiagnostic[];
+};
+/**
+ * Extract section role slugs from serialized block attributes using the
+ * configured class and metadata marker convention.
+ *
+ * @param attributes Parsed block attributes from serialized pattern content.
+ * @param convention Optional marker convention override.
+ * @returns Unique role marker values in discovery order.
+ */
+export declare function extractPatternSectionRolesFromAttributes(attributes: Record<string, unknown>, convention?: PatternCatalogSectionRoleConvention): string[];
+/**
+ * Find section wrapper blocks and their role markers in parsed pattern content.
+ *
+ * @param blocks Parsed block tree returned by `validateBlockPatternContentNesting`.
+ * @param convention Optional marker convention override.
+ * @returns Section wrapper matches with serialized block paths.
+ */
+export declare function extractPatternSectionRoleMatches(blocks: readonly ParsedBlockPatternBlock[], convention?: PatternCatalogSectionRoleConvention): PatternCatalogSectionRoleMatch[];
+/**
+ * Validate pattern thumbnail references with the same URL/path rules used by
+ * catalog diagnostics and `wp-typia add pattern`.
+ *
+ * @param value Candidate thumbnail URL or relative project path.
+ * @returns Whether the value is an http(s) URL or safe relative project path.
+ */
+export declare function isValidPatternThumbnailUrl(value: string): boolean;
+export declare function resolvePatternCatalogContentFile(pattern: Pick<PatternCatalogEntry, "contentFile" | "file">): string | undefined;
+/**
+ * Validate typed pattern catalog metadata declared in `scripts/block-config.ts`.
+ *
+ * The validator checks catalog shape, duplicate slugs, optional section-role
+ * rules, safe content file paths, and missing files when a workspace root is
+ * provided. With a workspace root, it also parses serialized block markup and
+ * compares section role markers against the catalog manifest.
+ *
+ * @param patterns Pattern catalog entries to validate.
+ * @param options Optional project root and section role marker convention.
+ * @returns Structured diagnostics split into errors and warnings.
+ */
+export declare function validatePatternCatalog(patterns: readonly PatternCatalogEntry[], options?: PatternCatalogValidationOptions): PatternCatalogValidationResult;
+/**
+ * Render pattern catalog diagnostics for CLI, sync, and doctor output.
+ *
+ * @param diagnostics Diagnostics returned from {@link validatePatternCatalog}.
+ * @returns Human-readable lines with stable diagnostic codes.
+ */
+export declare function formatPatternCatalogDiagnostics(diagnostics: readonly PatternCatalogDiagnostic[]): string;