@10up/block-renderer-core 0.1.4

package/README.md

@@ -0,0 +1,376 @@
+# @10up/block-renderer-core
+
+Shared TypeScript types and Zod schemas for the JSON Block Renderer ecosystem. This package provides the foundational types used across all other packages in the monorepo.
+
+## Installation
+
+```bash
+npm install @10up/block-renderer-core
+# or
+pnpm add @10up/block-renderer-core
+```
+
+## Overview
+
+This package exports three categories of types:
+
+1. **Block Tree Types** - The JSON format for representing WordPress blocks
+2. **Block Definition Types** - Metadata and schemas for block validation
+3. **Block JSON Types** - TypeScript definitions for WordPress `block.json` files
+
+## Block Tree Format
+
+The block tree uses a **flat structure with key references** instead of deep nesting. This design (inspired by [Vercel's json-render](https://github.com/vercel-labs/json-render)) makes it easier for AI to generate valid structures.
+
+### BlockElement
+
+A single block element in the tree:
+
+```typescript
+interface BlockElement {
+  /** Unique identifier for this element */
+  key: string;
+  /** Block name, e.g., "core/paragraph", "core/group" */
+  type: string;
+  /** Block attributes/props */
+  props: Record<string, unknown>;
+  /** Keys of child elements (for blocks with InnerBlocks) */
+  children?: string[];
+  /** Key of the parent element */
+  parentKey?: string;
+}
+```
+
+### BlockTree
+
+The complete block tree structure:
+
+```typescript
+interface BlockTree {
+  /** Key of the root element */
+  root: string;
+  /** Map of element keys to BlockElement objects */
+  elements: Record<string, BlockElement>;
+}
+```
+
+### Example
+
+```typescript
+import type { BlockTree, BlockElement } from '@10up/block-renderer-core';
+
+const tree: BlockTree = {
+  root: 'group-1',
+  elements: {
+    'group-1': {
+      key: 'group-1',
+      type: 'core/group',
+      props: { layout: { type: 'constrained' } },
+      children: ['heading-1', 'para-1']
+    },
+    'heading-1': {
+      key: 'heading-1',
+      type: 'core/heading',
+      props: { content: 'Welcome', level: 2 },
+      parentKey: 'group-1'
+    },
+    'para-1': {
+      key: 'para-1',
+      type: 'core/paragraph',
+      props: { content: 'Hello world' },
+      parentKey: 'group-1'
+    }
+  }
+};
+```
+
+## Block Template Format
+
+An alternative PHP-style nested array format, useful for migration scripts and server-side rendering:
+
+### BlockTemplateEntry
+
+A single entry in a block template:
+
+```typescript
+type BlockTemplateEntry =
+  | [string]                                           // Just block type
+  | [string, Record<string, unknown>]                  // Block type + attributes
+  | [string, Record<string, unknown>, BlockTemplateEntry[]]; // Full entry with children
+```
+
+### BlockTemplate
+
+An array of block template entries:
+
+```typescript
+type BlockTemplate = BlockTemplateEntry[];
+```
+
+### Example
+
+```typescript
+import type { BlockTemplate, BlockTemplateEntry } from '@10up/block-renderer-core';
+
+const template: BlockTemplate = [
+  ['core/group', { layout: { type: 'constrained' } }, [
+    ['core/heading', { content: 'Welcome', level: 2 }],
+    ['core/paragraph', { content: 'Hello world' }],
+  ]],
+];
+
+// This corresponds to the WordPress PHP format:
+// array(
+//   array( 'core/group', array( 'layout' => array( 'type' => 'constrained' ) ), array(
+//     array( 'core/heading', array( 'content' => 'Welcome', 'level' => 2 ) ),
+//     array( 'core/paragraph', array( 'content' => 'Hello world' ) ),
+//   )),
+// )
+```
+
+### When to Use Each Format
+
+| Format | Best For |
+|--------|----------|
+| **BlockTree** (flat) | AI generation, complex validation, IDE tooling |
+| **BlockTemplate** (nested) | Migration scripts, PHP-to-JS conversion, manual authoring |
+
+## Block Definition Types
+
+Used for validation and prompt generation:
+
+### BlockDefinition
+
+```typescript
+interface BlockDefinition {
+  /** Block name, e.g., "core/paragraph" */
+  name: string;
+  /** Human-readable title */
+  title?: string;
+  /** Block description */
+  description?: string;
+  /** Zod schema for validating block attributes */
+  schema: z.ZodObject<z.ZodRawShape>;
+  /** Valid parent blocks (direct parent) */
+  parent?: string[];
+  /** Valid ancestor blocks (anywhere in tree path) */
+  ancestor?: string[];
+  /** Valid child blocks, or true for any */
+  allowedBlocks?: string[] | true;
+  /** Whether block supports InnerBlocks (children) */
+  hasInnerBlocks: boolean;
+  /** Whether block is dynamic (server-rendered) */
+  isDynamic: boolean;
+  /** Block category */
+  category?: string;
+  /** Block keywords for search */
+  keywords?: string[];
+}
+```
+
+### BlockCatalog
+
+A map of block names to their definitions:
+
+```typescript
+type BlockCatalog = Map<string, BlockDefinition>;
+```
+
+### Validation Result Types
+
+```typescript
+interface ValidationResult {
+  valid: boolean;
+  errors: string[];
+  warnings?: string[];
+}
+
+interface TreeValidationResult extends ValidationResult {
+  /** Per-element validation results keyed by element key */
+  elementResults?: Record<string, ValidationResult>;
+}
+```
+
+## Block JSON Types
+
+TypeScript definitions matching the WordPress [block.json schema](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-metadata/):
+
+### BlockJson
+
+```typescript
+interface BlockJson {
+  name: string;                                    // Required: Block name
+  title: string;                                   // Required: Display title
+  category?: string;                               // Block category
+  description?: string;                            // Block description
+  keywords?: string[];                             // Search keywords
+  attributes?: Record<string, BlockAttributeDefinition>;
+  supports?: BlockSupports;                        // Feature support flags
+  parent?: string[];                               // Direct parent constraints
+  ancestor?: string[];                             // Ancestor constraints
+  allowedBlocks?: string[];                        // Allowed child blocks
+  providesContext?: Record<string, string>;        // Context provided to children
+  usesContext?: string[];                          // Context consumed from parents
+  styles?: Array<{ name: string; label: string; isDefault?: boolean }>;
+  variations?: Array<BlockVariation>;
+  render?: string;                                 // Server-side render callback
+  // ... and more
+}
+```
+
+### BlockAttributeDefinition
+
+```typescript
+interface BlockAttributeDefinition {
+  type?: BlockAttributeType | BlockAttributeType[];
+  enum?: (string | number | boolean)[];
+  default?: unknown;
+  source?: 'attribute' | 'text' | 'html' | 'query' | 'meta' | 'raw';
+  selector?: string;
+  attribute?: string;
+  items?: BlockAttributeDefinition;              // For array types
+  properties?: Record<string, BlockAttributeDefinition>; // For object types
+}
+
+type BlockAttributeType =
+  | 'string' | 'number' | 'integer' | 'boolean'
+  | 'object' | 'array' | 'null' | 'rich-text';
+```
+
+### BlockSupports
+
+Comprehensive type for WordPress block supports:
+
+```typescript
+interface BlockSupports {
+  anchor?: boolean;
+  align?: boolean | ('left' | 'center' | 'right' | 'wide' | 'full')[];
+  className?: boolean;
+  color?: boolean | {
+    background?: boolean;
+    gradients?: boolean;
+    link?: boolean;
+    text?: boolean;
+  };
+  typography?: boolean | {
+    fontSize?: boolean;
+    lineHeight?: boolean;
+    fontFamily?: boolean;
+    fontWeight?: boolean;
+    // ... and more
+  };
+  spacing?: boolean | {
+    margin?: boolean | ('top' | 'right' | 'bottom' | 'left')[];
+    padding?: boolean | ('top' | 'right' | 'bottom' | 'left')[];
+    blockGap?: boolean | ('horizontal' | 'vertical')[];
+  };
+  border?: boolean | { color?: boolean; radius?: boolean; style?: boolean; width?: boolean };
+  layout?: boolean | { default?: { type?: 'constrained' | 'flex' | 'flow' | 'grid' } };
+  // ... and more
+}
+```
+
+## Zod Schemas
+
+Runtime validation schemas for block trees:
+
+```typescript
+import { blockTreeSchema, blockElementSchema } from '@10up/block-renderer-core';
+
+// Validate a complete tree
+const result = blockTreeSchema.safeParse(input);
+if (result.success) {
+  const tree: BlockTree = result.data;
+} else {
+  console.error(result.error.issues);
+}
+
+// Validate a single element
+const elementResult = blockElementSchema.safeParse(element);
+```
+
+### Schema Definitions
+
+```typescript
+// BlockElement schema
+const blockElementSchema = z.object({
+  key: z.string().min(1),
+  type: z.string().min(1),
+  props: z.record(z.unknown()),
+  children: z.array(z.string()).optional(),
+  parentKey: z.string().optional(),
+});
+
+// BlockTree schema
+const blockTreeSchema = z.object({
+  root: z.string().min(1),
+  elements: z.record(blockElementSchema),
+});
+```
+
+## PHP Pattern Options
+
+Options for transforming rendered markup into production-ready PHP patterns with internationalization:
+
+```typescript
+interface PhpPatternOptions {
+  /** Theme text domain for translation functions (required) */
+  textDomain: string;
+  /** Asset directory name for image path detection (default: 'assets') */
+  assetDirectory?: string;
+}
+```
+
+### Example
+
+```typescript
+import type { PhpPatternOptions } from '@10up/block-renderer-core';
+
+const options: PhpPatternOptions = {
+  textDomain: 'my-theme',
+  assetDirectory: 'assets'
+};
+
+// When used with renderBlockTree, text content will be wrapped:
+// "Hello World" → <?php echo esc_html__( 'Hello World', 'my-theme' ); ?>
+// Image paths will use get_template_directory_uri()
+```
+
+## Complete Exports
+
+### Types
+
+| Type | Description |
+|------|-------------|
+| `BlockElement` | Single block in the tree |
+| `BlockTree` | Complete block tree structure |
+| `BlockElementSchema` | Zod inferred type for BlockElement |
+| `BlockTreeSchema` | Zod inferred type for BlockTree |
+| `BlockTemplate` | PHP-style nested array format |
+| `BlockTemplateEntry` | Single entry in a BlockTemplate |
+| `BlockTemplateEntrySchema` | Zod inferred type for BlockTemplateEntry |
+| `BlockTemplateSchema` | Zod inferred type for BlockTemplate |
+| `BlockDefinition` | Block schema and metadata for validation |
+| `BlockCatalog` | Map of block names to definitions |
+| `ValidationResult` | Single element validation result |
+| `TreeValidationResult` | Full tree validation result |
+| `BlockJson` | WordPress block.json structure |
+| `BlockSupports` | Block supports configuration |
+| `BlockAttributeDefinition` | Block attribute definition |
+| `BlockAttributeType` | Attribute type union |
+| `PhpPatternOptions` | Options for PHP pattern transformation |
+| `PhpPatternOptionsSchema` | Zod inferred type for PhpPatternOptions |
+
+### Schemas
+
+| Schema | Description |
+|--------|-------------|
+| `blockElementSchema` | Zod schema for validating BlockElement |
+| `blockTreeSchema` | Zod schema for validating BlockTree |
+| `blockTemplateEntrySchema` | Zod schema for validating BlockTemplateEntry |
+| `blockTemplateSchema` | Zod schema for validating BlockTemplate |
+| `phpPatternOptionsSchema` | Zod schema for validating PhpPatternOptions |
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export type { BlockElement, BlockTree, BlockElementSchema, BlockTreeSchema, } from './types/block-tree.js';
+export { blockElementSchema, blockTreeSchema } from './types/block-tree.js';
+export type { BlockDefinition, BlockCatalog, ValidationResult, TreeValidationResult, } from './types/block-definition.js';
+export type { BlockAttributeType, BlockAttributeDefinition, BlockSupports, BlockJson, } from './types/block-json.js';
+export type { BlockTemplate, BlockTemplateEntry, BlockTemplateEntrySchema, BlockTemplateSchema, } from './types/block-template.js';
+export { blockTemplateEntrySchema, blockTemplateSchema, } from './types/block-template.js';
+export type { PhpPatternOptions, PhpPatternOptionsSchema, } from './types/php-transforms.js';
+export { phpPatternOptionsSchema } from './types/php-transforms.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,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG5E,YAAY,EACV,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AAGrC,YAAY,EACV,kBAAkB,EAClB,wBAAwB,EACxB,aAAa,EACb,SAAS,GACV,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AAGnC,YAAY,EACV,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { blockElementSchema, blockTreeSchema } from './types/block-tree.js';
+export { blockTemplateEntrySchema, blockTemplateSchema, } from './types/block-template.js';
+export { phpPatternOptionsSchema } from './types/php-transforms.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,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AA0B5E,OAAO,EACL,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AAQnC,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/types/block-definition.d.ts

@@ -0,0 +1,62 @@
+import type { z } from 'zod';
+import type { BlockAttributeDefinition } from './block-json.js';
+/**
+ * Complete definition of a block type including schema and metadata.
+ * Used for validation, prompt generation, and rendering.
+ */
+export interface BlockDefinition {
+    /** Block name, e.g., "core/paragraph" */
+    name: string;
+    /** Human-readable title */
+    title?: string;
+    /** Block description */
+    description?: string;
+    /** Zod schema for validating block attributes */
+    schema: z.ZodObject<z.ZodRawShape>;
+    /** Raw attribute definitions from block.json */
+    attributes?: Record<string, BlockAttributeDefinition>;
+    /** Valid parent blocks (direct parent) */
+    parent?: string[];
+    /** Valid ancestor blocks (anywhere in tree path) */
+    ancestor?: string[];
+    /** Valid child blocks, or true for any */
+    allowedBlocks?: string[] | true;
+    /** Whether block can be used multiple times per post */
+    multiple?: boolean;
+    /** Whether block can be converted to reusable block */
+    reusable?: boolean;
+    /** Whether block supports InnerBlocks (children) */
+    hasInnerBlocks: boolean;
+    /** Whether block is dynamic (server-rendered, save = null) */
+    isDynamic: boolean;
+    /** Block category */
+    category?: string;
+    /** Block icon */
+    icon?: string;
+    /** Block keywords for search */
+    keywords?: string[];
+}
+/**
+ * Catalog of all available block definitions.
+ * Maps block name to its definition.
+ */
+export type BlockCatalog = Map<string, BlockDefinition>;
+/**
+ * Result of validating a block element against its definition.
+ */
+export interface ValidationResult {
+    /** Whether validation passed */
+    valid: boolean;
+    /** List of validation error messages */
+    errors: string[];
+    /** List of validation warning messages */
+    warnings?: string[];
+}
+/**
+ * Result of validating an entire block tree.
+ */
+export interface TreeValidationResult extends ValidationResult {
+    /** Per-element validation results keyed by element key */
+    elementResults?: Record<string, ValidationResult>;
+}
+//# sourceMappingURL=block-definition.d.ts.map

package/dist/types/block-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-definition.d.ts","sourceRoot":"","sources":["../../src/types/block-definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAEhE;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACnC,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;IACtD,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAChC,wDAAwD;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,cAAc,EAAE,OAAO,CAAC;IACxB,8DAA8D;IAC9D,SAAS,EAAE,OAAO,CAAC;IACnB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,wCAAwC;IACxC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CACnD"}

package/dist/types/block-definition.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=block-definition.js.map

package/dist/types/block-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-definition.js","sourceRoot":"","sources":["../../src/types/block-definition.ts"],"names":[],"mappings":""}

package/dist/types/block-json.d.ts

@@ -0,0 +1,262 @@
+/**
+ * WordPress block.json type definitions.
+ * Based on the official block.json schema from Gutenberg.
+ * @see https://developer.wordpress.org/block-editor/reference-guides/block-api/block-metadata/
+ */
+/**
+ * Attribute type as defined in block.json
+ */
+export type BlockAttributeType = 'string' | 'number' | 'integer' | 'boolean' | 'object' | 'array' | 'null' | 'rich-text';
+/**
+ * Single attribute definition from block.json
+ */
+export interface BlockAttributeDefinition {
+    /** Attribute type or array of types for union */
+    type?: BlockAttributeType | BlockAttributeType[];
+    /** Enum values for string attributes */
+    enum?: (string | number | boolean)[];
+    /** Default value */
+    default?: unknown;
+    /** Attribute source (for parsing from saved content) */
+    source?: 'attribute' | 'text' | 'html' | 'query' | 'meta' | 'raw';
+    /** CSS selector for source */
+    selector?: string;
+    /** HTML attribute name for source */
+    attribute?: string;
+    /** Allow multiple elements for query source */
+    multiline?: string | boolean;
+    /** Query object for nested attributes */
+    query?: Record<string, BlockAttributeDefinition>;
+    /** Items schema for array type */
+    items?: BlockAttributeDefinition;
+    /** Properties schema for object type */
+    properties?: Record<string, BlockAttributeDefinition>;
+}
+/**
+ * Block supports configuration.
+ * @see https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/
+ */
+export interface BlockSupports {
+    /** Support for anchor/id */
+    anchor?: boolean;
+    /** Support for alignment */
+    align?: boolean | ('left' | 'center' | 'right' | 'wide' | 'full')[];
+    /** Support for text alignment */
+    alignWide?: boolean;
+    /** Support for custom class name */
+    className?: boolean;
+    customClassName?: boolean;
+    /** Support for HTML editing */
+    html?: boolean;
+    /** Support for inserter visibility */
+    inserter?: boolean;
+    /** Support for multiple instances */
+    multiple?: boolean;
+    /** Support for reusable blocks */
+    reusable?: boolean;
+    /** Support for lock UI */
+    lock?: boolean;
+    /** Support for mode switching */
+    mode?: boolean;
+    /** Color supports */
+    color?: boolean | {
+        background?: boolean;
+        gradients?: boolean;
+        link?: boolean;
+        text?: boolean;
+        enableContrastChecker?: boolean;
+        /** Specific palette colors to use */
+        __experimentalDuotone?: string;
+        heading?: boolean;
+        button?: boolean;
+        caption?: boolean;
+    };
+    /** Typography supports */
+    typography?: boolean | {
+        fontSize?: boolean;
+        lineHeight?: boolean;
+        textAlign?: boolean | ('left' | 'center' | 'right')[];
+        /** @deprecated Use fontFamily */
+        __experimentalFontFamily?: boolean;
+        fontFamily?: boolean;
+        /** @deprecated Use fontStyle */
+        __experimentalFontStyle?: boolean;
+        fontStyle?: boolean;
+        /** @deprecated Use fontWeight */
+        __experimentalFontWeight?: boolean;
+        fontWeight?: boolean;
+        /** @deprecated Use letterSpacing */
+        __experimentalLetterSpacing?: boolean;
+        letterSpacing?: boolean;
+        /** @deprecated Use textDecoration */
+        __experimentalTextDecoration?: boolean;
+        textDecoration?: boolean;
+        /** @deprecated Use textTransform */
+        __experimentalTextTransform?: boolean;
+        textTransform?: boolean;
+        /** @deprecated Use writingMode */
+        __experimentalWritingMode?: boolean;
+        writingMode?: boolean;
+    };
+    /** Spacing supports */
+    spacing?: boolean | {
+        margin?: boolean | ('top' | 'right' | 'bottom' | 'left')[];
+        padding?: boolean | ('top' | 'right' | 'bottom' | 'left')[];
+        blockGap?: boolean | ('horizontal' | 'vertical')[];
+        /** @deprecated Use margin/padding */
+        __experimentalSkipSerialization?: boolean | string[];
+    };
+    /** Border supports */
+    border?: boolean | {
+        color?: boolean;
+        radius?: boolean;
+        style?: boolean;
+        width?: boolean;
+        /** @deprecated Use individual properties */
+        __experimentalSkipSerialization?: boolean | string[];
+        __experimentalDefaultControls?: {
+            color?: boolean;
+            radius?: boolean;
+            style?: boolean;
+            width?: boolean;
+        };
+    };
+    /** Dimensions supports */
+    dimensions?: boolean | {
+        minHeight?: boolean;
+        aspectRatio?: boolean;
+    };
+    /** Position supports */
+    position?: boolean | {
+        sticky?: boolean;
+    };
+    /** Shadow support */
+    shadow?: boolean;
+    /** Layout support */
+    layout?: boolean | {
+        default?: {
+            type?: 'constrained' | 'flex' | 'flow' | 'grid';
+            justifyContent?: string;
+            orientation?: 'horizontal' | 'vertical';
+        };
+        allowSwitching?: boolean;
+        allowEditing?: boolean;
+        allowInheriting?: boolean;
+        allowSizingOnChildren?: boolean;
+        allowVerticalAlignment?: boolean;
+        allowJustification?: boolean;
+        allowOrientation?: boolean;
+        allowCustomContentAndWideSize?: boolean;
+    };
+    /** Background support */
+    background?: boolean | {
+        backgroundImage?: boolean;
+        backgroundSize?: boolean;
+    };
+    /** Interactivity support */
+    interactivity?: boolean | {
+        clientNavigation?: boolean;
+        interactive?: boolean;
+    };
+    /** Splitting support for text blocks */
+    splitting?: boolean;
+    /** Renaming support */
+    renaming?: boolean;
+    /** Allow additional CSS class names */
+    [key: `__experimental${string}`]: unknown;
+}
+/**
+ * Complete block.json structure.
+ * @see https://developer.wordpress.org/block-editor/reference-guides/block-api/block-metadata/
+ */
+export interface BlockJson {
+    /** JSON schema reference */
+    $schema?: string;
+    /** API version */
+    apiVersion?: number;
+    /** Block name (required) */
+    name: string;
+    /** Block title (required) */
+    title: string;
+    /** Block category */
+    category?: string;
+    /** Parent blocks that can contain this block */
+    parent?: string[];
+    /** Ancestor blocks (any level up) */
+    ancestor?: string[];
+    /** Allowed child blocks */
+    allowedBlocks?: string[];
+    /** Block icon */
+    icon?: string;
+    /** Block description */
+    description?: string;
+    /** Search keywords */
+    keywords?: string[];
+    /** Version string */
+    version?: string;
+    /** Text domain for translations */
+    textdomain?: string;
+    /** Block attributes */
+    attributes?: Record<string, BlockAttributeDefinition>;
+    /** Provides context to child blocks */
+    providesContext?: Record<string, string>;
+    /** Uses context from parent blocks */
+    usesContext?: string[];
+    /** Block supports */
+    supports?: BlockSupports;
+    /** Block styles */
+    styles?: Array<{
+        name: string;
+        label: string;
+        isDefault?: boolean;
+    }>;
+    /** Example for block preview */
+    example?: {
+        attributes?: Record<string, unknown>;
+        innerBlocks?: Array<{
+            name: string;
+            attributes?: Record<string, unknown>;
+            innerBlocks?: unknown[];
+        }>;
+        viewportWidth?: number;
+    };
+    /** Editor script handle or path */
+    editorScript?: string | string[];
+    /** Frontend script handle or path */
+    script?: string | string[];
+    /** Frontend script handle or path (non-admin) */
+    viewScript?: string | string[];
+    /** Editor style handle or path */
+    editorStyle?: string | string[];
+    /** Frontend style handle or path */
+    style?: string | string[];
+    /** View style (non-admin, non-editor) */
+    viewStyle?: string | string[];
+    /** Render callback path */
+    render?: string;
+    /** Block variations */
+    variations?: Array<{
+        name: string;
+        title: string;
+        description?: string;
+        category?: string;
+        icon?: string;
+        isDefault?: boolean;
+        attributes?: Record<string, unknown>;
+        innerBlocks?: Array<{
+            name: string;
+            attributes?: Record<string, unknown>;
+            innerBlocks?: unknown[];
+        }>;
+        example?: Record<string, unknown>;
+        scope?: ('inserter' | 'block' | 'transform')[];
+        keywords?: string[];
+        isActive?: string[] | ((blockAttributes: Record<string, unknown>, variationAttributes: Record<string, unknown>) => boolean);
+    }>;
+    /** Block bindings sources */
+    selectors?: Record<string, string | {
+        source: string;
+        args?: Record<string, unknown>;
+    }>;
+}
+//# sourceMappingURL=block-json.d.ts.map

package/dist/types/block-json.d.ts.map

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

package/dist/types/block-json.js

@@ -0,0 +1,7 @@
+/**
+ * WordPress block.json type definitions.
+ * Based on the official block.json schema from Gutenberg.
+ * @see https://developer.wordpress.org/block-editor/reference-guides/block-api/block-metadata/
+ */
+export {};
+//# sourceMappingURL=block-json.js.map

package/dist/types/block-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-json.js","sourceRoot":"","sources":["../../src/types/block-json.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/types/block-template.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+/**
+ * A single entry in a WordPress block template.
+ * Format: [blockType, attributes?, innerBlocks?]
+ *
+ * This matches the PHP array format used in WordPress templates:
+ * ```php
+ * array(
+ *     'core/paragraph',
+ *     array( 'content' => 'Hello world' ),
+ *     array() // inner blocks
+ * )
+ * ```
+ */
+export type BlockTemplateEntry = [string] | [string, Record<string, unknown>] | [string, Record<string, unknown>, BlockTemplateEntry[]];
+/**
+ * A WordPress block template (array of template entries).
+ * This is the PHP-style nested array format used in WordPress block templates.
+ *
+ * Example:
+ * ```typescript
+ * const template: BlockTemplate = [
+ *   ['core/group', { layout: { type: 'constrained' } }, [
+ *     ['core/heading', { content: 'Title', level: 2 }],
+ *     ['core/paragraph', { content: 'Content' }],
+ *   ]],
+ * ];
+ * ```
+ */
+export type BlockTemplate = BlockTemplateEntry[];
+/**
+ * Zod schema for recursive BlockTemplateEntry validation.
+ */
+export declare const blockTemplateEntrySchema: z.ZodType<BlockTemplateEntry>;
+/**
+ * Zod schema for BlockTemplate validation.
+ */
+export declare const blockTemplateSchema: z.ZodArray<z.ZodType<BlockTemplateEntry, z.ZodTypeDef, BlockTemplateEntry>, "many">;
+export type BlockTemplateEntrySchema = z.infer<typeof blockTemplateEntrySchema>;
+export type BlockTemplateSchema = z.infer<typeof blockTemplateSchema>;
+//# sourceMappingURL=block-template.d.ts.map

package/dist/types/block-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-template.d.ts","sourceRoot":"","sources":["../../src/types/block-template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,kBAAkB,GAC1B,CAAC,MAAM,CAAC,GACR,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACjC,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAC;AAE5D;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,aAAa,GAAG,kBAAkB,EAAE,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAWlE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,qFAAoC,CAAC;AAErE,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAChF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/types/block-template.js

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+/**
+ * Zod schema for recursive BlockTemplateEntry validation.
+ */
+export const blockTemplateEntrySchema = z.lazy(() => z.union([
+    z.tuple([z.string().min(1)]),
+    z.tuple([z.string().min(1), z.record(z.unknown())]),
+    z.tuple([
+        z.string().min(1),
+        z.record(z.unknown()),
+        z.array(blockTemplateEntrySchema),
+    ]),
+]));
+/**
+ * Zod schema for BlockTemplate validation.
+ */
+export const blockTemplateSchema = z.array(blockTemplateEntrySchema);
+//# sourceMappingURL=block-template.js.map

package/dist/types/block-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-template.js","sourceRoot":"","sources":["../../src/types/block-template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoCxB;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAkC,CAAC,CAAC,IAAI,CAC3E,GAAG,EAAE,CACH,CAAC,CAAC,KAAK,CAAC;IACN,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACnD,CAAC,CAAC,KAAK,CAAC;QACN,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACjB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACrB,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC;KAClC,CAAC;CACH,CAAC,CACL,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC"}

package/dist/types/block-tree.d.ts

@@ -0,0 +1,95 @@
+import { z } from 'zod';
+/**
+ * A single block element in the tree.
+ * Uses a flat structure with key references instead of deep nesting.
+ */
+export interface BlockElement {
+    /** Unique identifier for this element */
+    key: string;
+    /** Block name, e.g., "core/paragraph", "core/group" */
+    type: string;
+    /** Block attributes/props */
+    props: Record<string, unknown>;
+    /** Keys of child elements (for blocks with InnerBlocks) */
+    children?: string[];
+    /** Key of the parent element */
+    parentKey?: string;
+}
+/**
+ * The complete block tree structure.
+ * Inspired by Vercel's json-render - uses a flat map with key references.
+ */
+export interface BlockTree {
+    /** Key of the root element */
+    root: string;
+    /** Map of element keys to BlockElement objects */
+    elements: Record<string, BlockElement>;
+}
+/**
+ * Zod schema for BlockElement
+ */
+export declare const blockElementSchema: z.ZodObject<{
+    key: z.ZodString;
+    type: z.ZodString;
+    props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    children: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    parentKey: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    type: string;
+    props: Record<string, unknown>;
+    children?: string[] | undefined;
+    parentKey?: string | undefined;
+}, {
+    key: string;
+    type: string;
+    props: Record<string, unknown>;
+    children?: string[] | undefined;
+    parentKey?: string | undefined;
+}>;
+/**
+ * Zod schema for BlockTree
+ */
+export declare const blockTreeSchema: z.ZodObject<{
+    root: z.ZodString;
+    elements: z.ZodRecord<z.ZodString, z.ZodObject<{
+        key: z.ZodString;
+        type: z.ZodString;
+        props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        children: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        parentKey: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        type: string;
+        props: Record<string, unknown>;
+        children?: string[] | undefined;
+        parentKey?: string | undefined;
+    }, {
+        key: string;
+        type: string;
+        props: Record<string, unknown>;
+        children?: string[] | undefined;
+        parentKey?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    root: string;
+    elements: Record<string, {
+        key: string;
+        type: string;
+        props: Record<string, unknown>;
+        children?: string[] | undefined;
+        parentKey?: string | undefined;
+    }>;
+}, {
+    root: string;
+    elements: Record<string, {
+        key: string;
+        type: string;
+        props: Record<string, unknown>;
+        children?: string[] | undefined;
+        parentKey?: string | undefined;
+    }>;
+}>;
+export type BlockElementSchema = z.infer<typeof blockElementSchema>;
+export type BlockTreeSchema = z.infer<typeof blockTreeSchema>;
+//# sourceMappingURL=block-tree.d.ts.map

package/dist/types/block-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-tree.d.ts","sourceRoot":"","sources":["../../src/types/block-tree.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;EAM7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAG1B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACpE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/types/block-tree.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+/**
+ * Zod schema for BlockElement
+ */
+export const blockElementSchema = z.object({
+    key: z.string().min(1),
+    type: z.string().min(1),
+    props: z.record(z.unknown()),
+    children: z.array(z.string()).optional(),
+    parentKey: z.string().optional(),
+});
+/**
+ * Zod schema for BlockTree
+ */
+export const blockTreeSchema = z.object({
+    root: z.string().min(1),
+    elements: z.record(blockElementSchema),
+});
+//# sourceMappingURL=block-tree.js.map

package/dist/types/block-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-tree.js","sourceRoot":"","sources":["../../src/types/block-tree.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA8BxB;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC5B,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC;CACvC,CAAC,CAAC"}

package/dist/types/php-transforms.d.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+/**
+ * Options for PHP pattern transformation.
+ * Enables conversion of rendered block markup to PHP pattern format
+ * with translatable strings and dynamic asset URLs.
+ */
+export interface PhpPatternOptions {
+    /** Theme text domain for translation functions (e.g., 'theme-slug') */
+    textDomain: string;
+    /** Asset directory name for image path transformation (default: 'assets') */
+    assetDirectory?: string;
+}
+/**
+ * Zod schema for PhpPatternOptions
+ */
+export declare const phpPatternOptionsSchema: z.ZodObject<{
+    textDomain: z.ZodString;
+    assetDirectory: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    textDomain: string;
+    assetDirectory?: string | undefined;
+}, {
+    textDomain: string;
+    assetDirectory?: string | undefined;
+}>;
+export type PhpPatternOptionsSchema = z.infer<typeof phpPatternOptionsSchema>;
+//# sourceMappingURL=php-transforms.d.ts.map

package/dist/types/php-transforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"php-transforms.d.ts","sourceRoot":"","sources":["../../src/types/php-transforms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;EAGlC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/types/php-transforms.js

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+/**
+ * Zod schema for PhpPatternOptions
+ */
+export const phpPatternOptionsSchema = z.object({
+    textDomain: z.string().min(1),
+    assetDirectory: z.string().optional(),
+});
+//# sourceMappingURL=php-transforms.js.map

package/dist/types/php-transforms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"php-transforms.js","sourceRoot":"","sources":["../../src/types/php-transforms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@10up/block-renderer-core",
+  "version": "0.1.4",
+  "description": "Core types and interfaces for block-renderer",
+  "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"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  },
+  "keywords": [
+    "wordpress",
+    "blocks",
+    "gutenberg",
+    "json",
+    "renderer"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/10up/json-block-renderer",
+    "directory": "packages/core"
+  },
+  "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"
+  }
+}