@10up/block-renderer-validator 0.1.4

package/dist/template-validator.d.ts

@@ -0,0 +1,61 @@
+import type { BlockTemplate, BlockCatalog, ValidationResult } from '@10up/block-renderer-core';
+/**
+ * Result of template validation with path information.
+ */
+export interface TemplateValidationResult extends ValidationResult {
+    /** Paths to elements with errors (e.g., "[0][2][1]") */
+    paths?: string[];
+}
+/**
+ * Validates the structural format of a block template using Zod.
+ *
+ * @param template - The template to validate
+ * @returns Validation result with structural errors
+ */
+export declare function validateTemplateStructure(template: unknown): TemplateValidationResult;
+/**
+ * Validates that all block types in the template exist in the catalog.
+ *
+ * @param template - The template to validate
+ * @param catalog - The block catalog to check against
+ * @returns Validation result with unknown block warnings
+ */
+export declare function validateTemplateBlockTypes(template: BlockTemplate, catalog: BlockCatalog): TemplateValidationResult;
+/**
+ * Validates nesting constraints for a block template.
+ *
+ * Checks:
+ * - `parent` constraints: block must be direct child of specified parent types
+ * - `ancestor` constraints: block must have specified ancestor somewhere above
+ * - `allowedBlocks` constraints: parent can only contain specified child types
+ *
+ * @param template - The template to validate
+ * @param catalog - The block catalog with nesting rules
+ * @returns Validation result with nesting errors
+ */
+export declare function validateTemplateNesting(template: BlockTemplate, catalog: BlockCatalog): TemplateValidationResult;
+/**
+ * Options for template validation.
+ */
+export interface ValidateTemplateOptions {
+    /** Block catalog for block type and nesting validation */
+    catalog?: BlockCatalog;
+    /** Whether to validate block types exist (default: true if catalog provided) */
+    validateBlockTypes?: boolean;
+    /** Whether to validate nesting rules (default: true if catalog provided) */
+    validateNesting?: boolean;
+}
+/**
+ * Full validation of a block template.
+ *
+ * Performs:
+ * 1. Structural validation (always)
+ * 2. Block type validation (if catalog provided)
+ * 3. Nesting constraint validation (if catalog provided)
+ *
+ * @param template - The template to validate
+ * @param options - Validation options
+ * @returns Combined validation result
+ */
+export declare function validateTemplate(template: unknown, options?: ValidateTemplateOptions): TemplateValidationResult;
+//# sourceMappingURL=template-validator.d.ts.map

package/dist/template-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-validator.d.ts","sourceRoot":"","sources":["../src/template-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAEb,YAAY,EACZ,gBAAgB,EACjB,MAAM,2BAA2B,CAAC;AAGnC;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,gBAAgB;IAChE,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,OAAO,GAChB,wBAAwB,CAa1B;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,YAAY,GACpB,wBAAwB,CA2B1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,YAAY,GACpB,wBAAwB,CAiF1B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,gFAAgF;IAChF,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,4EAA4E;IAC5E,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,OAAO,EACjB,OAAO,GAAE,uBAA4B,GACpC,wBAAwB,CA8B1B"}

package/dist/template-validator.js

@@ -0,0 +1,158 @@
+import { blockTemplateSchema } from '@10up/block-renderer-core';
+/**
+ * Validates the structural format of a block template using Zod.
+ *
+ * @param template - The template to validate
+ * @returns Validation result with structural errors
+ */
+export function validateTemplateStructure(template) {
+    const result = blockTemplateSchema.safeParse(template);
+    if (result.success) {
+        return { valid: true, errors: [] };
+    }
+    const errors = result.error.issues.map((issue) => {
+        const path = issue.path.join('.');
+        return `Invalid template structure at ${path || 'root'}: ${issue.message}`;
+    });
+    return { valid: false, errors };
+}
+/**
+ * Validates that all block types in the template exist in the catalog.
+ *
+ * @param template - The template to validate
+ * @param catalog - The block catalog to check against
+ * @returns Validation result with unknown block warnings
+ */
+export function validateTemplateBlockTypes(template, catalog) {
+    const errors = [];
+    const warnings = [];
+    function validateEntry(entry, path) {
+        const [blockType, , innerBlocks] = entry;
+        if (!catalog.has(blockType)) {
+            warnings.push(`${path}: Unknown block type "${blockType}"`);
+        }
+        if (innerBlocks) {
+            innerBlocks.forEach((child, i) => {
+                validateEntry(child, `${path}[2][${i}]`);
+            });
+        }
+    }
+    template.forEach((entry, i) => {
+        validateEntry(entry, `[${i}]`);
+    });
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings: warnings.length > 0 ? warnings : undefined,
+    };
+}
+/**
+ * Validates nesting constraints for a block template.
+ *
+ * Checks:
+ * - `parent` constraints: block must be direct child of specified parent types
+ * - `ancestor` constraints: block must have specified ancestor somewhere above
+ * - `allowedBlocks` constraints: parent can only contain specified child types
+ *
+ * @param template - The template to validate
+ * @param catalog - The block catalog with nesting rules
+ * @returns Validation result with nesting errors
+ */
+export function validateTemplateNesting(template, catalog) {
+    const errors = [];
+    function validateEntry(entry, path, parentType, ancestorTypes) {
+        const [blockType, , innerBlocks] = entry;
+        const definition = catalog.get(blockType);
+        if (!definition) {
+            // Skip validation for unknown blocks but still recurse into children
+            if (innerBlocks) {
+                const newAncestors = [...ancestorTypes, blockType];
+                innerBlocks.forEach((child, i) => {
+                    validateEntry(child, `${path}[2][${i}]`, blockType, newAncestors);
+                });
+            }
+            return;
+        }
+        // Validate parent constraint
+        if (definition.parent && definition.parent.length > 0) {
+            if (!parentType) {
+                errors.push(`${path}: Block "${blockType}" must be inside one of: ${definition.parent.join(', ')}`);
+            }
+            else if (!definition.parent.includes(parentType)) {
+                errors.push(`${path}: Block "${blockType}" cannot be a direct child of "${parentType}". ` +
+                    `Allowed parents: ${definition.parent.join(', ')}`);
+            }
+        }
+        // Validate ancestor constraint
+        if (definition.ancestor && definition.ancestor.length > 0) {
+            const hasRequiredAncestor = definition.ancestor.some((required) => ancestorTypes.includes(required));
+            if (!hasRequiredAncestor && parentType) {
+                errors.push(`${path}: Block "${blockType}" must be nested inside one of: ${definition.ancestor.join(', ')}`);
+            }
+        }
+        // Validate children constraints (allowedBlocks)
+        if (innerBlocks && innerBlocks.length > 0) {
+            if (definition.allowedBlocks !== true &&
+                Array.isArray(definition.allowedBlocks)) {
+                for (let i = 0; i < innerBlocks.length; i++) {
+                    const childType = innerBlocks[i][0];
+                    if (!definition.allowedBlocks.includes(childType)) {
+                        errors.push(`${path}[2][${i}]: Block "${blockType}" cannot contain "${childType}". ` +
+                            `Allowed children: ${definition.allowedBlocks.join(', ')}`);
+                    }
+                }
+            }
+        }
+        // Recurse into inner blocks
+        if (innerBlocks) {
+            const newAncestors = [...ancestorTypes, blockType];
+            innerBlocks.forEach((child, i) => {
+                validateEntry(child, `${path}[2][${i}]`, blockType, newAncestors);
+            });
+        }
+    }
+    template.forEach((entry, i) => {
+        validateEntry(entry, `[${i}]`, null, []);
+    });
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Full validation of a block template.
+ *
+ * Performs:
+ * 1. Structural validation (always)
+ * 2. Block type validation (if catalog provided)
+ * 3. Nesting constraint validation (if catalog provided)
+ *
+ * @param template - The template to validate
+ * @param options - Validation options
+ * @returns Combined validation result
+ */
+export function validateTemplate(template, options = {}) {
+    const errors = [];
+    const warnings = [];
+    // 1. Structural validation
+    const structureResult = validateTemplateStructure(template);
+    if (!structureResult.valid) {
+        return structureResult;
+    }
+    const validTemplate = template;
+    // 2. Block type validation (if catalog provided)
+    if (options.catalog && options.validateBlockTypes !== false) {
+        const typeResult = validateTemplateBlockTypes(validTemplate, options.catalog);
+        errors.push(...typeResult.errors);
+        if (typeResult.warnings)
+            warnings.push(...typeResult.warnings);
+    }
+    // 3. Nesting validation (if catalog provided)
+    if (options.catalog && options.validateNesting !== false) {
+        const nestingResult = validateTemplateNesting(validTemplate, options.catalog);
+        errors.push(...nestingResult.errors);
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings: warnings.length > 0 ? warnings : undefined,
+    };
+}
+//# sourceMappingURL=template-validator.js.map

package/dist/template-validator.js.map

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

package/dist/token-validator.d.ts

@@ -0,0 +1,23 @@
+import type { BlockTree, BlockElement, ValidationResult } from '@10up/block-renderer-core';
+import type { ThemeTokens } from '@10up/block-renderer-theme-json';
+/**
+ * Validates color tokens used in a block element.
+ */
+export declare function validateColorTokens(element: BlockElement, tokens: ThemeTokens): ValidationResult;
+/**
+ * Validates typography tokens used in a block element.
+ */
+export declare function validateTypographyTokens(element: BlockElement, tokens: ThemeTokens): ValidationResult;
+/**
+ * Validates spacing tokens used in a block element.
+ */
+export declare function validateSpacingTokens(element: BlockElement, tokens: ThemeTokens): ValidationResult;
+/**
+ * Validates all theme tokens used in a block element.
+ */
+export declare function validateElementTokens(element: BlockElement, tokens: ThemeTokens): ValidationResult;
+/**
+ * Validates all theme tokens used in a block tree.
+ */
+export declare function validateTreeTokens(tree: BlockTree, tokens: ThemeTokens): ValidationResult;
+//# sourceMappingURL=token-validator.d.ts.map

package/dist/token-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-validator.d.ts","sourceRoot":"","sources":["../src/token-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC3F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AA0EnE;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,WAAW,GAClB,gBAAgB,CAiDlB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,WAAW,GAClB,gBAAgB,CA0BlB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,WAAW,GAClB,gBAAgB,CAwBlB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,WAAW,GAClB,gBAAgB,CAmBlB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,WAAW,GAClB,gBAAgB,CAqBlB"}

package/dist/token-validator.js

@@ -0,0 +1,192 @@
+import { validateSlug, parseCssVarReference } from '@10up/block-renderer-theme-json';
+/**
+ * Color-related attribute names that should use theme tokens.
+ */
+const COLOR_ATTRIBUTES = [
+    'backgroundColor',
+    'textColor',
+    'borderColor',
+    'overlayColor',
+    'customBackgroundColor',
+    'customTextColor',
+];
+/**
+ * Spacing-related style paths that should use theme tokens.
+ */
+const SPACING_STYLE_PATHS = [
+    'style.spacing.margin',
+    'style.spacing.padding',
+    'style.spacing.blockGap',
+];
+/**
+ * Checks if a value is a direct token slug (not a CSS var reference).
+ */
+function isDirectSlug(value) {
+    if (typeof value !== 'string')
+        return false;
+    // Direct slugs don't start with var: or have CSS variable syntax
+    return !value.startsWith('var:') && !value.startsWith('var(') && !value.startsWith('#');
+}
+/**
+ * Gets a nested value from an object using a dot-separated path.
+ */
+function getNestedValue(obj, path) {
+    const parts = path.split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined || typeof current !== 'object') {
+            return undefined;
+        }
+        current = current[part];
+    }
+    return current;
+}
+/**
+ * Extracts spacing values from a sides object or string.
+ */
+function extractSpacingValues(value) {
+    if (typeof value === 'string') {
+        return [value];
+    }
+    if (typeof value === 'object' && value !== null) {
+        const sides = value;
+        const values = [];
+        for (const side of ['top', 'right', 'bottom', 'left', 'horizontal', 'vertical']) {
+            if (typeof sides[side] === 'string') {
+                values.push(sides[side]);
+            }
+        }
+        return values;
+    }
+    return [];
+}
+/**
+ * Validates color tokens used in a block element.
+ */
+export function validateColorTokens(element, tokens) {
+    const errors = [];
+    const warnings = [];
+    // Check direct color attributes
+    for (const attr of COLOR_ATTRIBUTES) {
+        const value = element.props[attr];
+        if (isDirectSlug(value)) {
+            if (!validateSlug(tokens, 'color', value)) {
+                errors.push(`[${element.key}] Unknown color token "${value}" in ${attr}. ` +
+                    `Available: ${tokens.colors.palette.map(c => c.slug).join(', ')}`);
+            }
+        }
+    }
+    // Check gradient attribute
+    const gradient = element.props.gradient;
+    if (isDirectSlug(gradient)) {
+        if (!validateSlug(tokens, 'gradient', gradient)) {
+            errors.push(`[${element.key}] Unknown gradient token "${gradient}". ` +
+                `Available: ${tokens.colors.gradients.map(g => g.slug).join(', ')}`);
+        }
+    }
+    // Check style.color values
+    const styleColor = getNestedValue(element.props, 'style.color');
+    if (styleColor) {
+        for (const [key, value] of Object.entries(styleColor)) {
+            if (typeof value === 'string' && value.startsWith('var:preset|color|')) {
+                const parsed = parseCssVarReference(value);
+                if (parsed && !validateSlug(tokens, parsed.type, parsed.slug)) {
+                    errors.push(`[${element.key}] Unknown color token "${parsed.slug}" in style.color.${key}`);
+                }
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings: warnings.length > 0 ? warnings : undefined,
+    };
+}
+/**
+ * Validates typography tokens used in a block element.
+ */
+export function validateTypographyTokens(element, tokens) {
+    const errors = [];
+    // Check fontSize
+    const fontSize = element.props.fontSize;
+    if (isDirectSlug(fontSize)) {
+        if (!validateSlug(tokens, 'font-size', fontSize)) {
+            errors.push(`[${element.key}] Unknown font size token "${fontSize}". ` +
+                `Available: ${tokens.typography.fontSizes.map(f => f.slug).join(', ')}`);
+        }
+    }
+    // Check fontFamily
+    const fontFamily = element.props.fontFamily;
+    if (isDirectSlug(fontFamily)) {
+        if (!validateSlug(tokens, 'font-family', fontFamily)) {
+            errors.push(`[${element.key}] Unknown font family token "${fontFamily}". ` +
+                `Available: ${tokens.typography.fontFamilies.map(f => f.slug).join(', ')}`);
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Validates spacing tokens used in a block element.
+ */
+export function validateSpacingTokens(element, tokens) {
+    const errors = [];
+    for (const path of SPACING_STYLE_PATHS) {
+        const value = getNestedValue(element.props, path);
+        if (value === undefined)
+            continue;
+        const spacingValues = extractSpacingValues(value);
+        for (const spacing of spacingValues) {
+            // Check if it's a CSS var reference
+            if (spacing.startsWith('var:preset|spacing|')) {
+                const parsed = parseCssVarReference(spacing);
+                if (parsed && !validateSlug(tokens, 'spacing', parsed.slug)) {
+                    errors.push(`[${element.key}] Unknown spacing token "${parsed.slug}" in ${path}. ` +
+                        `Available: ${tokens.spacing.spacingSizes.map(s => s.slug).join(', ')}`);
+                }
+            }
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Validates all theme tokens used in a block element.
+ */
+export function validateElementTokens(element, tokens) {
+    const errors = [];
+    const warnings = [];
+    const colorResult = validateColorTokens(element, tokens);
+    errors.push(...colorResult.errors);
+    if (colorResult.warnings)
+        warnings.push(...colorResult.warnings);
+    const typographyResult = validateTypographyTokens(element, tokens);
+    errors.push(...typographyResult.errors);
+    const spacingResult = validateSpacingTokens(element, tokens);
+    errors.push(...spacingResult.errors);
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings: warnings.length > 0 ? warnings : undefined,
+    };
+}
+/**
+ * Validates all theme tokens used in a block tree.
+ */
+export function validateTreeTokens(tree, tokens) {
+    const errors = [];
+    const warnings = [];
+    for (const element of Object.values(tree.elements)) {
+        const result = validateElementTokens(element, tokens);
+        if (!result.valid) {
+            errors.push(...result.errors);
+        }
+        if (result.warnings) {
+            warnings.push(...result.warnings);
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings: warnings.length > 0 ? warnings : undefined,
+    };
+}
+//# sourceMappingURL=token-validator.js.map

package/dist/token-validator.js.map

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

package/dist/tree-validator.d.ts

@@ -0,0 +1,26 @@
+import type { BlockTree, BlockElement, BlockDefinition, BlockCatalog, ValidationResult } from '@10up/block-renderer-core';
+/**
+ * Validates parent constraints for a block.
+ * Checks if the block's direct parent is in its allowed `parent` list.
+ */
+export declare function validateParent(element: BlockElement, tree: BlockTree, definition: BlockDefinition): ValidationResult;
+/**
+ * Validates ancestor constraints for a block.
+ * Checks if any required ancestors exist somewhere in the tree path.
+ */
+export declare function validateAncestor(element: BlockElement, tree: BlockTree, definition: BlockDefinition): ValidationResult;
+/**
+ * Validates children constraints for a block.
+ * Checks if all children are in the block's `allowedBlocks` list.
+ */
+export declare function validateChildren(element: BlockElement, tree: BlockTree, definition: BlockDefinition): ValidationResult;
+/**
+ * Validates the `multiple` constraint.
+ * Checks if blocks with `multiple: false` appear only once.
+ */
+export declare function validateMultiple(tree: BlockTree, catalog: BlockCatalog): ValidationResult;
+/**
+ * Validates all nesting rules for a tree.
+ */
+export declare function validateTreeNesting(tree: BlockTree, catalog: BlockCatalog): ValidationResult;
+//# sourceMappingURL=tree-validator.d.ts.map

package/dist/tree-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-validator.d.ts","sourceRoot":"","sources":["../src/tree-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,gBAAgB,EACjB,MAAM,2BAA2B,CAAC;AA6CnC;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,SAAS,EACf,UAAU,EAAE,eAAe,GAC1B,gBAAgB,CA4BlB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,SAAS,EACf,UAAU,EAAE,eAAe,GAC1B,gBAAgB,CAwBlB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,SAAS,EACf,UAAU,EAAE,eAAe,GAC1B,gBAAgB,CAyBlB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,YAAY,GACpB,gBAAgB,CAuBlB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,YAAY,GACpB,gBAAgB,CA2ClB"}

package/dist/tree-validator.js

@@ -0,0 +1,160 @@
+/**
+ * Gets the parent element of a block in the tree.
+ */
+function getParentElement(element, tree) {
+    if (!element.parentKey)
+        return null;
+    return tree.elements[element.parentKey] || null;
+}
+/**
+ * Gets all ancestor elements of a block (from immediate parent to root).
+ */
+function getAncestors(element, tree) {
+    const ancestors = [];
+    let current = getParentElement(element, tree);
+    while (current) {
+        ancestors.push(current);
+        current = getParentElement(current, tree);
+    }
+    return ancestors;
+}
+/**
+ * Gets the children elements of a block.
+ */
+function getChildren(element, tree) {
+    if (!element.children)
+        return [];
+    return element.children
+        .map(key => tree.elements[key])
+        .filter((child) => child !== undefined);
+}
+/**
+ * Validates parent constraints for a block.
+ * Checks if the block's direct parent is in its allowed `parent` list.
+ */
+export function validateParent(element, tree, definition) {
+    const errors = [];
+    // If no parent constraint, all parents are valid
+    if (!definition.parent || definition.parent.length === 0) {
+        return { valid: true, errors: [] };
+    }
+    const parent = getParentElement(element, tree);
+    // If block requires a parent but has none
+    if (!parent) {
+        errors.push(`[${element.key}] Block "${element.type}" must be inside one of: ${definition.parent.join(', ')}`);
+        return { valid: false, errors };
+    }
+    // Check if parent type is in allowed list
+    if (!definition.parent.includes(parent.type)) {
+        errors.push(`[${element.key}] Block "${element.type}" cannot be a direct child of "${parent.type}". ` +
+            `Allowed parents: ${definition.parent.join(', ')}`);
+        return { valid: false, errors };
+    }
+    return { valid: true, errors: [] };
+}
+/**
+ * Validates ancestor constraints for a block.
+ * Checks if any required ancestors exist somewhere in the tree path.
+ */
+export function validateAncestor(element, tree, definition) {
+    const errors = [];
+    // If no ancestor constraint, all ancestors are valid
+    if (!definition.ancestor || definition.ancestor.length === 0) {
+        return { valid: true, errors: [] };
+    }
+    const ancestors = getAncestors(element, tree);
+    const ancestorTypes = ancestors.map(a => a.type);
+    // Check if at least one required ancestor exists
+    const hasRequiredAncestor = definition.ancestor.some(requiredType => ancestorTypes.includes(requiredType));
+    if (!hasRequiredAncestor) {
+        errors.push(`[${element.key}] Block "${element.type}" must be nested inside one of: ${definition.ancestor.join(', ')}`);
+        return { valid: false, errors };
+    }
+    return { valid: true, errors: [] };
+}
+/**
+ * Validates children constraints for a block.
+ * Checks if all children are in the block's `allowedBlocks` list.
+ */
+export function validateChildren(element, tree, definition) {
+    const errors = [];
+    // If allowedBlocks is true, any block is allowed
+    if (definition.allowedBlocks === true) {
+        return { valid: true, errors: [] };
+    }
+    // If no allowedBlocks constraint, all children are valid
+    if (!definition.allowedBlocks || !Array.isArray(definition.allowedBlocks)) {
+        return { valid: true, errors: [] };
+    }
+    const children = getChildren(element, tree);
+    for (const child of children) {
+        if (!definition.allowedBlocks.includes(child.type)) {
+            errors.push(`[${element.key}] Block "${element.type}" cannot contain "${child.type}". ` +
+                `Allowed children: ${definition.allowedBlocks.join(', ')}`);
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Validates the `multiple` constraint.
+ * Checks if blocks with `multiple: false` appear only once.
+ */
+export function validateMultiple(tree, catalog) {
+    const errors = [];
+    const blockCounts = new Map();
+    // Count occurrences of each block type
+    for (const element of Object.values(tree.elements)) {
+        const existing = blockCounts.get(element.type) || [];
+        existing.push(element.key);
+        blockCounts.set(element.type, existing);
+    }
+    // Check blocks with multiple: false
+    for (const [blockType, keys] of blockCounts.entries()) {
+        const definition = catalog.get(blockType);
+        if (definition?.multiple === false && keys.length > 1) {
+            errors.push(`Block "${blockType}" can only appear once, but found ${keys.length} instances: ${keys.join(', ')}`);
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Validates all nesting rules for a tree.
+ */
+export function validateTreeNesting(tree, catalog) {
+    const errors = [];
+    const warnings = [];
+    // Validate each element's nesting
+    for (const element of Object.values(tree.elements)) {
+        const definition = catalog.get(element.type);
+        if (!definition) {
+            // Unknown block type - skip nesting validation
+            continue;
+        }
+        // Validate parent constraint
+        const parentResult = validateParent(element, tree, definition);
+        if (!parentResult.valid) {
+            errors.push(...parentResult.errors);
+        }
+        // Validate ancestor constraint
+        const ancestorResult = validateAncestor(element, tree, definition);
+        if (!ancestorResult.valid) {
+            errors.push(...ancestorResult.errors);
+        }
+        // Validate children constraint
+        const childrenResult = validateChildren(element, tree, definition);
+        if (!childrenResult.valid) {
+            errors.push(...childrenResult.errors);
+        }
+    }
+    // Validate multiple constraints
+    const multipleResult = validateMultiple(tree, catalog);
+    if (!multipleResult.valid) {
+        errors.push(...multipleResult.errors);
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings: warnings.length > 0 ? warnings : undefined,
+    };
+}
+//# sourceMappingURL=tree-validator.js.map