, BlockTemplateEntry[]]; // Full entry\n```\n\nExamples:\n- `['core/separator']` - Block with no attributes\n- `['core/paragraph', { content: 'Hello' }]` - Block with attributes\n- `['core/group', {}, [['core/paragraph', {}]]]` - Block with inner blocks\n\n### Convert Template to Blocks\n\nFor lower-level access, convert templates to WordPress block objects:\n\n```typescript\nimport { convertTemplateToBlocks } from '@10up/block-renderer-serializer';\n\nconst blocks = convertTemplateToBlocks(template);\n// Returns WordPress BlockInstance[] for further manipulation\n```\n\n## Third-Party Block Support\n\nThe renderer supports third-party blocks from plugins and themes. These blocks must be registered before rendering.\n\n### Scan WordPress Installation\n\nScan a WordPress installation for all available blocks:\n\n```typescript\nimport {\n scanBlocksFromWpContent,\n registerScannedBlocks\n} from '@10up/block-renderer-serializer';\n\n// Scan wp-content directory for block.json files\nconst scannedBlocks = scanBlocksFromWpContent(\n '/path/to/wp-content',\n 'theme-name' // Optional: scan theme blocks too\n);\n\n// Register all found blocks\nconst registeredCount = registerScannedBlocks(scannedBlocks);\nconsole.log(`Registered ${registeredCount} third-party blocks`);\n```\n\nThis scans:\n- `/wp-content/plugins/*/` (excluding `gutenberg` to avoid duplicates)\n- `/wp-content/mu-plugins/*/`\n- `/wp-content/client-mu-plugins/*/` (VIP)\n- `/wp-content/themes/{theme-name}/blocks/`\n\n### Register Custom Block Manually\n\n```typescript\nimport { registerCustomBlock } from '@10up/block-renderer-serializer';\n\nregisterCustomBlock({\n name: 'my-plugin/custom-block',\n title: 'Custom Block',\n attributes: {\n title: { type: 'string' }\n }\n});\n```\n\n### Path Utilities\n\n```typescript\nimport {\n getThemeNameFromPath,\n getWpContentPathFromTheme\n} from '@10up/block-renderer-serializer';\n\ngetThemeNameFromPath('/var/www/wp-content/themes/my-theme');\n// 'my-theme'\n\ngetWpContentPathFromTheme('/var/www/wp-content/themes/my-theme');\n// '/var/www/wp-content'\n```\n\n## Block Registration\n\n### Check Registration Status\n\n```typescript\nimport {\n areCoreBlocksRegistered,\n isBlockRegistered,\n getRegisteredBlockNames,\n getBlocksByCategory\n} from '@10up/block-renderer-serializer';\n\n// Check if core blocks are registered\nif (!areCoreBlocksRegistered()) {\n await registerCoreBlocks();\n}\n\n// Check specific block\nisBlockRegistered('core/paragraph'); // true\nisBlockRegistered('my-plugin/block'); // false (until registered)\n\n// Get all registered block names\nconst allBlocks = getRegisteredBlockNames();\n// ['core/paragraph', 'core/heading', 'core/group', ...]\n\n// Get blocks by category\nconst categories = getBlocksByCategory();\n// Map { 'text' => ['core/paragraph', 'core/heading', ...], ... }\n```\n\n### Unregister Blocks\n\n```typescript\nimport { unregisterBlock } from '@10up/block-renderer-serializer';\n\nunregisterBlock('core/freeform'); // Remove Classic Editor block\n```\n\n## Browser Environment\n\nWordPress block APIs require DOM APIs that don't exist in Node.js. This package sets up a browser-like environment using jsdom.\n\n```typescript\nimport {\n setupBrowserEnvironment,\n isBrowserEnvironmentReady\n} from '@10up/block-renderer-serializer';\n\n// Check if already initialized\nif (!isBrowserEnvironmentReady()) {\n setupBrowserEnvironment();\n}\n```\n\nThe setup must be called before registering any blocks.\n\n## Low-Level APIs\n\n### Convert Tree to Blocks\n\nConvert without serializing (useful for inspection):\n\n```typescript\nimport { convertTreeToBlocks } from '@10up/block-renderer-serializer';\n\nconst blocks = convertTreeToBlocks(tree);\n// Returns WordPress block objects\n```\n\n### Convert Multiple Roots\n\n```typescript\nimport { convertMultipleRootsToBlocks } from '@10up/block-renderer-serializer';\n\nconst blocks = convertMultipleRootsToBlocks([tree1, tree2]);\n```\n\n### Validate Tree References\n\nCheck that all parent/child references are valid:\n\n```typescript\nimport { validateTreeReferences } from '@10up/block-renderer-serializer';\n\nconst isValid = validateTreeReferences(tree);\n// true if all children/parentKey references exist\n```\n\n### Serialize Block Objects\n\n```typescript\nimport { serializeBlocks } from '@10up/block-renderer-serializer';\n\nconst markup = serializeBlocks(blocks);\n```\n\n## Pretty Printing\n\nFormat block markup for better readability:\n\n```typescript\nimport { formatBlockMarkup } from '@10up/block-renderer-serializer';\nimport type { PrettyPrintOptions } from '@10up/block-renderer-serializer';\n\nconst markup = 'Hello
';\n\nconst formatted = formatBlockMarkup(markup, {\n indentSize: 2, // Spaces per indent level (default: 2)\n indentChar: ' ', // Character to use for indentation (default: space)\n newlineBetweenBlocks: true // Add newlines between top-level blocks (default: true)\n});\n\n// Output:\n// \n// Hello
\n// \n```\n\n## PHP Pattern Transformation\n\nTransform rendered markup into production-ready PHP patterns with internationalization:\n\n```typescript\nimport {\n transformToPhpPatternSync,\n escapeText,\n escapeImagePath,\n} from '@10up/block-renderer-serializer';\n\n// Transform complete markup\nconst phpMarkup = transformToPhpPatternSync(markup, {\n textDomain: 'my-theme',\n assetDirectory: 'assets' // optional, default: 'assets'\n});\n\n// Individual escape functions\nescapeText('Hello World', 'my-theme');\n// \"\"\n\nescapeImagePath('assets/images/hero.jpg', 'my-theme');\n// \"/assets/images/hero.jpg\"\n```\n\n### What Gets Transformed\n\n| Content Type | Transformation |\n|-------------|----------------|\n| Text inside tags (``, `
`, ``, etc.) | `` |\n| `alt` attribute | `` |\n| `title` attribute | `` |\n| `placeholder` attribute | `` |\n| `aria-label` attribute | `` |\n| Local image `src` (with `assets/`) | `/assets/...` |\n| Block JSON attributes | Escaped with appropriate function |\n\n### Usage with renderBlockTree\n\n```typescript\nimport { renderBlockTree } from '@10up/block-renderer-serializer';\n\n// Regular rendering\nconst markup = renderBlockTree(tree);\n\n// With PHP pattern transformation\nconst phpMarkup = renderBlockTree(tree, {\n phpPattern: {\n textDomain: 'my-theme',\n assetDirectory: 'assets'\n }\n});\n```\n\n## Types\n\n### ScannedBlock\n\n```typescript\ninterface ScannedBlock {\n blockJson: BlockJson;\n source: 'plugin' | 'mu-plugin' | 'theme';\n sourceName: string;\n}\n```\n\n### SerializeOptions\n\n```typescript\ninterface SerializeOptions {\n pretty?: boolean;\n}\n```\n\n## Complete Exports\n\n### Setup Functions\n\n| Function | Description |\n|----------|-------------|\n| `setupBrowserEnvironment()` | Initialize browser environment for Node.js |\n| `isBrowserEnvironmentReady()` | Check if environment is initialized |\n\n### Rendering Functions\n\n| Function | Description |\n|----------|-------------|\n| `renderBlockTree(tree, options?)` | Render single block tree to markup |\n| `renderBlockTrees(trees, options?)` | Render multiple block trees |\n| `renderBlockTemplate(template, options?)` | Render PHP-style nested array template to markup |\n| `serializeBlocks(blocks)` | Serialize WordPress block objects |\n\n### Conversion Functions\n\n| Function | Description |\n|----------|-------------|\n| `convertTreeToBlocks(tree)` | Convert BlockTree to WordPress blocks |\n| `convertTemplateToBlocks(template)` | Convert BlockTemplate to WordPress blocks |\n| `convertMultipleRootsToBlocks(trees)` | Convert multiple trees to blocks |\n| `validateTreeReferences(tree)` | Validate tree has valid references |\n\n### Registration Functions\n\n| Function | Description |\n|----------|-------------|\n| `registerCoreBlocks()` | Register all WordPress core blocks |\n| `registerCustomBlock(blockJson, settings?)` | Register a custom block |\n| `registerScannedBlocks(blocks)` | Register multiple scanned blocks |\n| `unregisterBlock(name)` | Unregister a block |\n| `areCoreBlocksRegistered()` | Check if core blocks are registered |\n| `isBlockRegistered(name)` | Check if specific block is registered |\n| `getRegisteredBlockNames()` | Get all registered block names |\n| `getBlocksByCategory()` | Get blocks grouped by category |\n\n### Block Scanning Functions\n\n| Function | Description |\n|----------|-------------|\n| `scanBlocksFromWpContent(wpContentPath, themeName?)` | Scan for block.json files |\n| `getThemeNameFromPath(themePath)` | Extract theme name from path |\n| `getWpContentPathFromTheme(themePath)` | Derive wp-content path from theme |\n\n### Pretty Printing Functions\n\n| Function | Description |\n|----------|-------------|\n| `formatBlockMarkup(markup, options?)` | Format block markup for readability |\n\n### PHP Pattern Transformation Functions\n\n| Function | Description |\n|----------|-------------|\n| `transformToPhpPatternSync(markup, options)` | Transform markup to PHP pattern |\n| `escapeText(text, textDomain)` | Escape text with esc_html__ |\n| `escapeImagePath(path, textDomain)` | Escape image path with get_template_directory_uri |\n\n### Types\n\n| Type | Description |\n|------|-------------|\n| `ScannedBlock` | Block found during scanning |\n| `SerializeOptions` | Options for BlockTree serialization |\n| `TemplateSerializeOptions` | Options for BlockTemplate serialization |\n| `PrettyPrintOptions` | Options for formatBlockMarkup |\n| `BlockTemplate` | PHP-style nested array template (from core) |\n| `BlockTemplateEntry` | Single entry in a BlockTemplate (from core) |\n\n## License\n\nMIT\n","readmeFilename":"README.md"}