@10up/block-renderer-patterns 0.1.4

package/README.md

@@ -0,0 +1,284 @@
+# @10up/block-renderer-patterns
+
+Scan WordPress theme pattern directories and parse PHP file headers to extract pattern metadata and content.
+
+## Installation
+
+```bash
+npm install @10up/block-renderer-patterns
+# or
+pnpm add @10up/block-renderer-patterns
+```
+
+## Overview
+
+WordPress themes can define [block patterns](https://developer.wordpress.org/themes/patterns/) in PHP files within the `/patterns` directory. This package:
+
+1. **Scans pattern directories** - Both `/patterns` and `/synced-patterns`
+2. **Parses PHP headers** - Extracts metadata from PHP file docblocks
+3. **Extracts block content** - Gets the actual block markup
+4. **Creates a searchable registry** - Query patterns by category, block type, or keywords
+
+## Usage
+
+### Load All Patterns from Theme
+
+The main entry point - loads all patterns and returns a registry:
+
+```typescript
+import { loadPatterns } from '@10up/block-renderer-patterns';
+
+const registry = loadPatterns('/path/to/theme');
+
+// Iterate over all patterns
+for (const [slug, pattern] of registry) {
+  console.log(pattern.slug);        // 'theme-name/hero-section'
+  console.log(pattern.title);       // 'Hero Section'
+  console.log(pattern.categories);  // ['featured', 'banner']
+  console.log(pattern.content);     // '<!-- wp:group -->...'
+}
+
+// Get a specific pattern
+const heroPattern = registry.get('theme-name/hero-section');
+```
+
+### Scan Patterns with Error Reporting
+
+Get detailed scan results including errors:
+
+```typescript
+import { scanPatterns, createPatternRegistry } from '@10up/block-renderer-patterns';
+
+const result = scanPatterns('/path/to/theme');
+
+// Check for errors
+if (result.errors.length > 0) {
+  console.log('Failed to parse:');
+  for (const error of result.errors) {
+    console.log(`  ${error.filePath}: ${error.error}`);
+  }
+}
+
+// Access successfully parsed patterns
+console.log(`Found ${result.patterns.length} patterns`);
+
+// Create a registry from results
+const registry = createPatternRegistry(result);
+```
+
+### Parse Single Pattern File
+
+```typescript
+import { parsePatternFile } from '@10up/block-renderer-patterns';
+
+const pattern = parsePatternFile(
+  '/path/to/theme/patterns/hero.php',
+  'theme-name',  // Theme name for slug prefix
+  false          // isSynced flag
+);
+
+console.log(pattern);
+// {
+//   slug: 'theme-name/hero',
+//   title: 'Hero Section',
+//   description: 'A hero section with...',
+//   categories: ['featured'],
+//   keywords: ['hero', 'banner'],
+//   blockTypes: ['core/post-content'],
+//   inserter: true,
+//   content: '<!-- wp:group -->...',
+//   filePath: '/path/to/theme/patterns/hero.php',
+//   isSynced: false
+// }
+```
+
+### Parse PHP Header Only
+
+Extract metadata from a PHP file's docblock:
+
+```typescript
+import { parsePatternHeader } from '@10up/block-renderer-patterns';
+
+const phpContent = `<?php
+/**
+ * Title: Hero Section
+ * Slug: theme-name/hero
+ * Categories: featured, banner
+ * Keywords: hero, cta
+ * Block Types: core/post-content
+ * Viewport Width: 1200
+ */
+?>
+<!-- wp:group -->...`;
+
+const metadata = parsePatternHeader(phpContent);
+// {
+//   title: 'Hero Section',
+//   slug: 'theme-name/hero',
+//   categories: ['featured', 'banner'],
+//   keywords: ['hero', 'cta'],
+//   blockTypes: ['core/post-content'],
+//   viewportWidth: 1200
+// }
+```
+
+### Extract Block Content
+
+Get the block markup without the PHP header:
+
+```typescript
+import { extractPatternContent } from '@10up/block-renderer-patterns';
+
+const content = extractPatternContent(phpContent);
+// '<!-- wp:group -->...'
+```
+
+## Querying Patterns
+
+### Get Patterns by Category
+
+```typescript
+import { loadPatterns, getPatternsByCategory } from '@10up/block-renderer-patterns';
+
+const registry = loadPatterns('/path/to/theme');
+const featuredPatterns = getPatternsByCategory(registry, 'featured');
+// Returns PatternDefinition[]
+```
+
+### Get Patterns by Block Type
+
+Patterns can be associated with specific block types:
+
+```typescript
+import { getPatternsByBlockType } from '@10up/block-renderer-patterns';
+
+// Get patterns for the post content block
+const contentPatterns = getPatternsByBlockType(registry, 'core/post-content');
+```
+
+### Search Patterns
+
+Search across title, description, keywords, and slug:
+
+```typescript
+import { searchPatterns } from '@10up/block-renderer-patterns';
+
+const results = searchPatterns(registry, 'hero');
+// Returns patterns matching "hero" in any searchable field
+```
+
+### Get All Categories
+
+```typescript
+import { getAllCategories } from '@10up/block-renderer-patterns';
+
+const categories = getAllCategories(registry);
+// ['banner', 'featured', 'footer', 'header', ...]
+```
+
+## Types
+
+### PatternDefinition
+
+```typescript
+interface PatternDefinition {
+  /** Human-readable title */
+  title: string;
+  /** Pattern slug, e.g., "theme-name/hero" */
+  slug: string;
+  /** Pattern categories */
+  categories?: string[];
+  /** Search keywords */
+  keywords?: string[];
+  /** Pattern description (for screen readers) */
+  description?: string;
+  /** Block types this pattern applies to */
+  blockTypes?: string[];
+  /** Post types where this pattern can be used */
+  postTypes?: string[];
+  /** Preview iframe width */
+  viewportWidth?: number;
+  /** Whether to show in inserter (default true) */
+  inserter?: boolean;
+  /** The actual block markup content */
+  content: string;
+  /** Source file path */
+  filePath: string;
+  /** Whether this is a synced pattern (reusable block) */
+  isSynced: boolean;
+}
+```
+
+### PatternRegistry
+
+```typescript
+type PatternRegistry = Map<string, PatternDefinition>;
+```
+
+### PatternScanResult
+
+```typescript
+interface PatternScanResult {
+  /** Successfully parsed patterns */
+  patterns: PatternDefinition[];
+  /** Files that failed to parse */
+  errors: Array<{
+    filePath: string;
+    error: string;
+  }>;
+}
+```
+
+### PatternMetadata
+
+```typescript
+interface PatternMetadata {
+  title?: string;
+  slug?: string;
+  categories?: string[];
+  keywords?: string[];
+  description?: string;
+  blockTypes?: string[];
+  postTypes?: string[];
+  viewportWidth?: number;
+  inserter?: boolean;
+}
+```
+
+## Complete Exports
+
+### Functions
+
+| Function | Description |
+|----------|-------------|
+| `loadPatterns(themePath)` | Load all patterns and return a registry |
+| `scanPatterns(themePath)` | Scan patterns with error reporting |
+| `createPatternRegistry(scanResult)` | Create registry from scan results |
+| `parsePatternFile(filePath, themeName, isSynced)` | Parse single pattern file |
+| `parsePatternHeader(content)` | Parse PHP header to metadata |
+| `extractPhpCommentHeader(content)` | Extract raw PHP docblock |
+| `extractPatternContent(content)` | Extract block markup from PHP |
+| `getPatternsByCategory(registry, category)` | Filter patterns by category |
+| `getPatternsByBlockType(registry, blockType)` | Filter patterns by block type |
+| `searchPatterns(registry, query)` | Search patterns by keyword |
+| `getAllCategories(registry)` | Get all unique categories |
+
+### Types
+
+| Type | Description |
+|------|-------------|
+| `PatternDefinition` | Complete pattern with metadata and content |
+| `PatternRegistry` | Map of slug to pattern definition |
+| `PatternScanResult` | Scan results with patterns and errors |
+| `PatternMetadata` | Metadata extracted from PHP header |
+
+### Zod Schemas
+
+| Schema | Description |
+|--------|-------------|
+| `patternMetadataSchema` | Validate pattern metadata objects |
+| `patternDefinitionSchema` | Validate complete pattern definitions |
+
+## License
+
+MIT

package/dist/header-parser.d.ts

@@ -0,0 +1,22 @@
+import type { PatternMetadata } from './types.js';
+/**
+ * Extracts the PHP comment header from file content.
+ * Handles both single-line and multi-line comment formats.
+ */
+export declare function extractPhpCommentHeader(content: string): string | null;
+/**
+ * Parses PHP file header to extract pattern metadata.
+ *
+ * Expects PHP files with docblock headers like:
+ * - Title: Hero Section
+ * - Slug: theme-name/hero
+ * - Categories: featured, header
+ * - Keywords: hero, banner, cta
+ */
+export declare function parsePatternHeader(content: string): PatternMetadata;
+/**
+ * Extracts the block content from a PHP pattern file.
+ * Content is everything after the PHP closing tag or after the comment block.
+ */
+export declare function extractPatternContent(content: string): string;
+//# sourceMappingURL=header-parser.d.ts.map

package/dist/header-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-parser.d.ts","sourceRoot":"","sources":["../src/header-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AA4ClD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAetE;AAmBD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CA8CnE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAc7D"}

package/dist/header-parser.js

@@ -0,0 +1,137 @@
+/**
+ * Known PHP header fields for WordPress patterns.
+ * @see https://developer.wordpress.org/themes/patterns/registering-patterns/
+ */
+const HEADER_FIELDS = {
+    'Title': 'title',
+    'Slug': 'slug',
+    'Categories': 'categories',
+    'Keywords': 'keywords',
+    'Description': 'description',
+    'Block Types': 'blockTypes',
+    'Post Types': 'postTypes',
+    'Viewport Width': 'viewportWidth',
+    'Inserter': 'inserter',
+};
+/**
+ * Parses a comma-separated list value from a PHP header.
+ */
+function parseListValue(value) {
+    return value
+        .split(',')
+        .map(item => item.trim())
+        .filter(item => item.length > 0);
+}
+/**
+ * Parses a boolean value from a PHP header.
+ */
+function parseBooleanValue(value) {
+    const lowered = value.toLowerCase().trim();
+    return lowered === 'true' || lowered === 'yes' || lowered === '1';
+}
+/**
+ * Parses a number value from a PHP header.
+ */
+function parseNumberValue(value) {
+    const num = parseInt(value.trim(), 10);
+    return isNaN(num) ? undefined : num;
+}
+/**
+ * Extracts the PHP comment header from file content.
+ * Handles both single-line and multi-line comment formats.
+ */
+export function extractPhpCommentHeader(content) {
+    // Match PHP opening tag followed by docblock comment
+    // Pattern: <?php followed by /** ... */
+    const docblockMatch = content.match(/^<\?php\s*\r?\n?\s*\/\*\*([\s\S]*?)\*\//);
+    if (docblockMatch) {
+        return docblockMatch[1];
+    }
+    // Also try matching multi-line comment without docblock asterisks
+    const multilineMatch = content.match(/^<\?php\s*\r?\n?\s*\/\*([\s\S]*?)\*\//);
+    if (multilineMatch) {
+        return multilineMatch[1];
+    }
+    return null;
+}
+/**
+ * Parses a single header line to extract field name and value.
+ */
+function parseHeaderLine(line) {
+    // Remove leading asterisks and whitespace from docblock format
+    const cleaned = line.replace(/^\s*\*\s*/, '').trim();
+    // Match "Field Name: Value" pattern
+    const match = cleaned.match(/^([^:]+):\s*(.+)$/);
+    if (!match)
+        return null;
+    return {
+        field: match[1].trim(),
+        value: match[2].trim(),
+    };
+}
+/**
+ * Parses PHP file header to extract pattern metadata.
+ *
+ * Expects PHP files with docblock headers like:
+ * - Title: Hero Section
+ * - Slug: theme-name/hero
+ * - Categories: featured, header
+ * - Keywords: hero, banner, cta
+ */
+export function parsePatternHeader(content) {
+    const metadata = {};
+    // Extract the PHP comment header
+    const header = extractPhpCommentHeader(content);
+    if (!header) {
+        return metadata;
+    }
+    // Split into lines and parse each
+    const lines = header.split('\n');
+    for (const line of lines) {
+        const parsed = parseHeaderLine(line);
+        if (!parsed)
+            continue;
+        const { field, value } = parsed;
+        const metadataKey = HEADER_FIELDS[field];
+        if (!metadataKey)
+            continue;
+        switch (metadataKey) {
+            case 'title':
+            case 'slug':
+            case 'description':
+                metadata[metadataKey] = value;
+                break;
+            case 'categories':
+            case 'keywords':
+            case 'blockTypes':
+            case 'postTypes':
+                metadata[metadataKey] = parseListValue(value);
+                break;
+            case 'viewportWidth':
+                metadata[metadataKey] = parseNumberValue(value);
+                break;
+            case 'inserter':
+                metadata[metadataKey] = parseBooleanValue(value);
+                break;
+        }
+    }
+    return metadata;
+}
+/**
+ * Extracts the block content from a PHP pattern file.
+ * Content is everything after the PHP closing tag or after the comment block.
+ */
+export function extractPatternContent(content) {
+    // Try to find content after PHP closing tag
+    const phpCloseMatch = content.match(/\?>\s*([\s\S]*)$/);
+    if (phpCloseMatch) {
+        return phpCloseMatch[1].trim();
+    }
+    // If no closing tag, try to extract content after the comment block
+    const afterCommentMatch = content.match(/\/\*[\s\S]*?\*\/\s*([\s\S]*)$/);
+    if (afterCommentMatch) {
+        return afterCommentMatch[1].trim();
+    }
+    return '';
+}
+//# sourceMappingURL=header-parser.js.map

package/dist/header-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-parser.js","sourceRoot":"","sources":["../src/header-parser.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export type { PatternDefinition, PatternRegistry, PatternScanResult, PatternMetadata, } from './types.js';
+export { patternMetadataSchema, patternDefinitionSchema, } from './types.js';
+export { extractPhpCommentHeader, parsePatternHeader, extractPatternContent, } from './header-parser.js';
+export { parsePatternFile, scanPatterns, createPatternRegistry, loadPatterns, getPatternsByCategory, getPatternsByBlockType, searchPatterns, getAllCategories, } from './scanner.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,qBAAqB,EACrB,YAAY,EACZ,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,EACd,gBAAgB,GACjB,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { patternMetadataSchema, patternDefinitionSchema, } from './types.js';
+// Header parser
+export { extractPhpCommentHeader, parsePatternHeader, extractPatternContent, } from './header-parser.js';
+// Scanner
+export { parsePatternFile, scanPatterns, createPatternRegistry, loadPatterns, getPatternsByCategory, getPatternsByBlockType, searchPatterns, getAllCategories, } from './scanner.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAEpB,gBAAgB;AAChB,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAE5B,UAAU;AACV,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,qBAAqB,EACrB,YAAY,EACZ,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,EACd,gBAAgB,GACjB,MAAM,cAAc,CAAC"}

package/dist/scanner.d.ts

@@ -0,0 +1,38 @@
+import type { PatternDefinition, PatternScanResult, PatternRegistry } from './types.js';
+/**
+ * Parses a single pattern file.
+ */
+export declare function parsePatternFile(filePath: string, themeName: string, isSynced?: boolean): PatternDefinition;
+/**
+ * Scans all pattern directories in a WordPress theme.
+ *
+ * Scans:
+ * - /patterns - Theme patterns
+ * - /synced-patterns - Synced (reusable) patterns
+ */
+export declare function scanPatterns(themePath: string): PatternScanResult;
+/**
+ * Creates a pattern registry from scan results.
+ */
+export declare function createPatternRegistry(scanResult: PatternScanResult): PatternRegistry;
+/**
+ * Loads patterns from a theme and returns a registry.
+ */
+export declare function loadPatterns(themePath: string): PatternRegistry;
+/**
+ * Gets patterns by category.
+ */
+export declare function getPatternsByCategory(registry: PatternRegistry, category: string): PatternDefinition[];
+/**
+ * Gets patterns by block type.
+ */
+export declare function getPatternsByBlockType(registry: PatternRegistry, blockType: string): PatternDefinition[];
+/**
+ * Searches patterns by keyword.
+ */
+export declare function searchPatterns(registry: PatternRegistry, query: string): PatternDefinition[];
+/**
+ * Gets all unique categories from the registry.
+ */
+export declare function getAllCategories(registry: PatternRegistry): string[];
+//# sourceMappingURL=scanner.d.ts.map

package/dist/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EAChB,MAAM,YAAY,CAAC;AAGpB;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,OAAe,GACxB,iBAAiB,CA0BnB;AAgDD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,CAoBjE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,iBAAiB,GAAG,eAAe,CAQpF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,CAG/D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,MAAM,GACf,iBAAiB,EAAE,CAUrB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,MAAM,GAChB,iBAAiB,EAAE,CAUrB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,MAAM,GACZ,iBAAiB,EAAE,CAgBrB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,EAAE,CAUpE"}

package/dist/scanner.js

@@ -0,0 +1,162 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { parsePatternHeader, extractPatternContent } from './header-parser.js';
+/**
+ * Parses a single pattern file.
+ */
+export function parsePatternFile(filePath, themeName, isSynced = false) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const metadata = parsePatternHeader(content);
+    const blockContent = extractPatternContent(content);
+    // Generate slug from filename if not specified
+    const fileName = path.basename(filePath, '.php');
+    const slug = metadata.slug || `${themeName}/${fileName}`;
+    // Title is required - use filename as fallback
+    const title = metadata.title || fileName.replace(/-/g, ' ').replace(/\b\w/g, c => c.toUpperCase());
+    return {
+        title,
+        slug,
+        categories: metadata.categories,
+        keywords: metadata.keywords,
+        description: metadata.description,
+        blockTypes: metadata.blockTypes,
+        postTypes: metadata.postTypes,
+        viewportWidth: metadata.viewportWidth,
+        inserter: metadata.inserter,
+        content: blockContent,
+        filePath,
+        isSynced,
+    };
+}
+/**
+ * Scans a directory for pattern files.
+ */
+function scanDirectory(dirPath, themeName, isSynced) {
+    const result = {
+        patterns: [],
+        errors: [],
+    };
+    if (!fs.existsSync(dirPath)) {
+        return result;
+    }
+    const files = fs.readdirSync(dirPath);
+    for (const file of files) {
+        if (!file.endsWith('.php'))
+            continue;
+        const filePath = path.join(dirPath, file);
+        try {
+            const pattern = parsePatternFile(filePath, themeName, isSynced);
+            result.patterns.push(pattern);
+        }
+        catch (error) {
+            result.errors.push({
+                filePath,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    return result;
+}
+/**
+ * Gets the theme name from the theme directory.
+ * Uses the directory name as the theme name.
+ */
+function getThemeName(themePath) {
+    return path.basename(themePath);
+}
+/**
+ * Scans all pattern directories in a WordPress theme.
+ *
+ * Scans:
+ * - /patterns - Theme patterns
+ * - /synced-patterns - Synced (reusable) patterns
+ */
+export function scanPatterns(themePath) {
+    const themeName = getThemeName(themePath);
+    const result = {
+        patterns: [],
+        errors: [],
+    };
+    // Scan main patterns directory
+    const patternsDir = path.join(themePath, 'patterns');
+    const patternsResult = scanDirectory(patternsDir, themeName, false);
+    result.patterns.push(...patternsResult.patterns);
+    result.errors.push(...patternsResult.errors);
+    // Scan synced patterns directory
+    const syncedPatternsDir = path.join(themePath, 'synced-patterns');
+    const syncedResult = scanDirectory(syncedPatternsDir, themeName, true);
+    result.patterns.push(...syncedResult.patterns);
+    result.errors.push(...syncedResult.errors);
+    return result;
+}
+/**
+ * Creates a pattern registry from scan results.
+ */
+export function createPatternRegistry(scanResult) {
+    const registry = new Map();
+    for (const pattern of scanResult.patterns) {
+        registry.set(pattern.slug, pattern);
+    }
+    return registry;
+}
+/**
+ * Loads patterns from a theme and returns a registry.
+ */
+export function loadPatterns(themePath) {
+    const scanResult = scanPatterns(themePath);
+    return createPatternRegistry(scanResult);
+}
+/**
+ * Gets patterns by category.
+ */
+export function getPatternsByCategory(registry, category) {
+    const patterns = [];
+    for (const pattern of registry.values()) {
+        if (pattern.categories?.includes(category)) {
+            patterns.push(pattern);
+        }
+    }
+    return patterns;
+}
+/**
+ * Gets patterns by block type.
+ */
+export function getPatternsByBlockType(registry, blockType) {
+    const patterns = [];
+    for (const pattern of registry.values()) {
+        if (pattern.blockTypes?.includes(blockType)) {
+            patterns.push(pattern);
+        }
+    }
+    return patterns;
+}
+/**
+ * Searches patterns by keyword.
+ */
+export function searchPatterns(registry, query) {
+    const loweredQuery = query.toLowerCase();
+    const patterns = [];
+    for (const pattern of registry.values()) {
+        const matchesTitle = pattern.title.toLowerCase().includes(loweredQuery);
+        const matchesDescription = pattern.description?.toLowerCase().includes(loweredQuery);
+        const matchesKeywords = pattern.keywords?.some(k => k.toLowerCase().includes(loweredQuery));
+        const matchesSlug = pattern.slug.toLowerCase().includes(loweredQuery);
+        if (matchesTitle || matchesDescription || matchesKeywords || matchesSlug) {
+            patterns.push(pattern);
+        }
+    }
+    return patterns;
+}
+/**
+ * Gets all unique categories from the registry.
+ */
+export function getAllCategories(registry) {
+    const categories = new Set();
+    for (const pattern of registry.values()) {
+        for (const category of pattern.categories || []) {
+            categories.add(category);
+        }
+    }
+    return Array.from(categories).sort();
+}
+//# sourceMappingURL=scanner.js.map

package/dist/scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,133 @@
+import { z } from 'zod';
+/**
+ * Pattern definition extracted from a PHP pattern file.
+ * @see https://developer.wordpress.org/themes/patterns/registering-patterns/
+ */
+export interface PatternDefinition {
+    /** Human-readable title */
+    title: string;
+    /** Pattern slug, e.g., "theme-name/hero" */
+    slug: string;
+    /** Pattern categories */
+    categories?: string[];
+    /** Search keywords */
+    keywords?: string[];
+    /** Pattern description (for screen readers) */
+    description?: string;
+    /** Block types this pattern applies to */
+    blockTypes?: string[];
+    /** Post types where this pattern can be used */
+    postTypes?: string[];
+    /** Preview iframe width */
+    viewportWidth?: number;
+    /** Whether to show in inserter (default true) */
+    inserter?: boolean;
+    /** The actual block markup content */
+    content: string;
+    /** Source file path */
+    filePath: string;
+    /** Whether this is a synced pattern (reusable block) */
+    isSynced: boolean;
+}
+/**
+ * Registry of all patterns in a theme
+ */
+export type PatternRegistry = Map<string, PatternDefinition>;
+/**
+ * Result of scanning patterns
+ */
+export interface PatternScanResult {
+    /** Successfully parsed patterns */
+    patterns: PatternDefinition[];
+    /** Files that failed to parse */
+    errors: Array<{
+        filePath: string;
+        error: string;
+    }>;
+}
+/**
+ * Metadata extracted from PHP file header
+ */
+export interface PatternMetadata {
+    title?: string;
+    slug?: string;
+    categories?: string[];
+    keywords?: string[];
+    description?: string;
+    blockTypes?: string[];
+    postTypes?: string[];
+    viewportWidth?: number;
+    inserter?: boolean;
+}
+export declare const patternMetadataSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    slug: z.ZodOptional<z.ZodString>;
+    categories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    keywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    description: z.ZodOptional<z.ZodString>;
+    blockTypes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    postTypes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    viewportWidth: z.ZodOptional<z.ZodNumber>;
+    inserter: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    title?: string | undefined;
+    slug?: string | undefined;
+    categories?: string[] | undefined;
+    keywords?: string[] | undefined;
+    description?: string | undefined;
+    blockTypes?: string[] | undefined;
+    postTypes?: string[] | undefined;
+    viewportWidth?: number | undefined;
+    inserter?: boolean | undefined;
+}, {
+    title?: string | undefined;
+    slug?: string | undefined;
+    categories?: string[] | undefined;
+    keywords?: string[] | undefined;
+    description?: string | undefined;
+    blockTypes?: string[] | undefined;
+    postTypes?: string[] | undefined;
+    viewportWidth?: number | undefined;
+    inserter?: boolean | undefined;
+}>;
+export declare const patternDefinitionSchema: z.ZodObject<{
+    title: z.ZodString;
+    slug: z.ZodString;
+    categories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    keywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    description: z.ZodOptional<z.ZodString>;
+    blockTypes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    postTypes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    viewportWidth: z.ZodOptional<z.ZodNumber>;
+    inserter: z.ZodOptional<z.ZodBoolean>;
+    content: z.ZodString;
+    filePath: z.ZodString;
+    isSynced: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    slug: string;
+    content: string;
+    filePath: string;
+    isSynced: boolean;
+    categories?: string[] | undefined;
+    keywords?: string[] | undefined;
+    description?: string | undefined;
+    blockTypes?: string[] | undefined;
+    postTypes?: string[] | undefined;
+    viewportWidth?: number | undefined;
+    inserter?: boolean | undefined;
+}, {
+    title: string;
+    slug: string;
+    content: string;
+    filePath: string;
+    isSynced: boolean;
+    categories?: string[] | undefined;
+    keywords?: string[] | undefined;
+    description?: string | undefined;
+    blockTypes?: string[] | undefined;
+    postTypes?: string[] | undefined;
+    viewportWidth?: number | undefined;
+    inserter?: boolean | undefined;
+}>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,2BAA2B;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,iCAAiC;IACjC,MAAM,EAAE,KAAK,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAGD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUhC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAalC,CAAC"}

package/dist/types.js

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+// Zod schema for pattern metadata validation
+export const patternMetadataSchema = z.object({
+    title: z.string().optional(),
+    slug: z.string().optional(),
+    categories: z.array(z.string()).optional(),
+    keywords: z.array(z.string()).optional(),
+    description: z.string().optional(),
+    blockTypes: z.array(z.string()).optional(),
+    postTypes: z.array(z.string()).optional(),
+    viewportWidth: z.number().optional(),
+    inserter: z.boolean().optional(),
+});
+export const patternDefinitionSchema = z.object({
+    title: z.string(),
+    slug: z.string(),
+    categories: z.array(z.string()).optional(),
+    keywords: z.array(z.string()).optional(),
+    description: z.string().optional(),
+    blockTypes: z.array(z.string()).optional(),
+    postTypes: z.array(z.string()).optional(),
+    viewportWidth: z.number().optional(),
+    inserter: z.boolean().optional(),
+    content: z.string(),
+    filePath: z.string(),
+    isSynced: z.boolean(),
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkExB,6CAA6C;AAC7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC1C,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC1C,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC1C,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC1C,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;CACtB,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@10up/block-renderer-patterns",
+  "version": "0.1.4",
+  "description": "Pattern directory scanner and PHP header parser for WordPress block patterns",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "zod": "^3.24.0",
+    "@10up/block-renderer-core": "0.1.4"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  },
+  "keywords": [
+    "wordpress",
+    "blocks",
+    "patterns",
+    "gutenberg"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/10up/json-block-renderer",
+    "directory": "packages/patterns"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}