@marvalt/wparser 0.1.5 → 0.1.7

package/dist/index.d.ts

@@ -47,6 +47,46 @@ interface ComponentRegistry {
     /** Fallback renderer for unknown blocks */
     fallback: BlockRenderer;
 }
+/**
+ * Pattern matching for blocks - allows matching blocks by name and attributes
+ */
+interface BlockPattern {
+    /** Block name (e.g., 'core/cover', 'core/media-text') */
+    name: string;
+    /** Optional attribute matching - all specified attributes must match */
+    attributes?: Record<string, any>;
+    /** Optional nested block patterns for innerBlocks */
+    innerBlocks?: BlockPattern[];
+}
+/**
+ * Component mapping configuration for enhanced registry
+ * Maps block patterns to React components with prop extraction
+ */
+interface ComponentMapping<TProps = any> {
+    /** Pattern to match against blocks */
+    pattern: BlockPattern;
+    /** React component to render when pattern matches */
+    component: React.ComponentType<TProps>;
+    /** Function to extract props from block data */
+    extractProps: (block: WordPressBlock, context: RenderContext) => TProps;
+    /** Optional wrapper component (e.g., for section spacing) */
+    wrapper?: React.ComponentType<{
+        children: React.ReactNode;
+        block?: WordPressBlock;
+    }>;
+    /** Priority for matching (higher = more specific, checked first) */
+    priority?: number;
+}
+/**
+ * Enhanced registry that supports pattern-based component mapping
+ * Extends the base ComponentRegistry with pattern matching capabilities
+ */
+interface EnhancedRegistry extends ComponentRegistry {
+    /** Array of component mappings with patterns */
+    mappings: ComponentMapping[];
+    /** Find matching component mapping for a block */
+    matchBlock: (block: WordPressBlock) => ComponentMapping | null;
+}
 
 type WPNode = WordPressBlock;
 interface ParseOptions {
@@ -60,6 +100,36 @@ declare function renderNodes(blocks: WordPressBlock[], registry: ComponentRegist
 
 declare function createDefaultRegistry(): ComponentRegistry;
 
+/**
+ * Create an enhanced registry that supports pattern-based component mapping
+ *
+ * This combines the default registry (for fallback) with app-specific component mappings.
+ * When a block matches a pattern, it uses the mapped component. Otherwise, it falls back
+ * to the default renderer.
+ *
+ * @param mappings - Array of component mappings with patterns
+ * @param baseRegistry - Optional base registry (defaults to createDefaultRegistry())
+ * @returns Enhanced registry with pattern matching capabilities
+ *
+ * @example
+ * ```ts
+ * const mappings: ComponentMapping[] = [
+ *   {
+ *     pattern: { name: 'core/cover' },
+ *     component: HomeHeroSection,
+ *     extractProps: (block) => ({
+ *       backgroundImage: extractBackgroundImage(block),
+ *       title: extractTitle(block),
+ *     }),
+ *     wrapper: SectionWrapper,
+ *   },
+ * ];
+ *
+ * const registry = createEnhancedRegistry(mappings);
+ * ```
+ */
+declare function createEnhancedRegistry(mappings?: ComponentMapping[], baseRegistry?: ComponentRegistry): EnhancedRegistry;
+
 interface WPContentProps {
     blocks: WordPressBlock[];
     registry: ComponentRegistry;
@@ -136,6 +206,7 @@ declare function getBlockTextContent(block: WordPressBlock): string;
 /**
  * Extract image URL from block attributes
  * Checks for Cloudflare URLs first, then falls back to regular URLs
+ * Also extracts from innerHTML if needed
  */
 declare function getImageUrl(block: WordPressBlock): string | null;
 /**
@@ -201,5 +272,141 @@ declare const isCloudflareImageUrl: (url: string | undefined | null) => boolean;
  */
 declare const getCloudflareVariantUrl: (url: string, options: CloudflareVariantOptions) => string;
 
-export { WPContent, WPErrorBoundary, WPPage, buildClassName, createDefaultRegistry, extractTextFromHTML, findShortcodes, getAlignmentClasses, getBlockTextContent, getCloudflareVariantUrl, getContainerClasses, getContentSpacingClasses, getFontSizeClasses, getImageAttributes, getImageUrl, getSectionSpacingClasses, getTextAlignClasses, isCloudflareImageUrl, parseGutenbergBlocks, parseShortcodeAttrs, renderNodes, renderTextWithShortcodes };
-export type { AuthMode, BlockRenderer, BlockRendererProps, CloudflareVariantOptions, ComponentRegistry, ParseOptions, ParsedShortcode, RenderContext, RenderOptions, ShortcodeAttributes, ShortcodeRenderer, WPContentProps, WPNode, WPPageProps, WordPressBlock, WordPressEmbedded, WordPressFeaturedMedia, WordPressPageMinimal, WordPressTitleField };
+/**
+ * Check if a block matches a pattern
+ */
+declare function matchesPattern(block: WordPressBlock, pattern: BlockPattern): boolean;
+/**
+ * Find the best matching component mapping for a block
+ * Returns the mapping with highest priority that matches, or null
+ */
+declare function findMatchingMapping(block: WordPressBlock, mappings: ComponentMapping[]): ComponentMapping | null;
+
+/**
+ * Extract background image URL from a block
+ * Checks various possible sources: url, backgroundImage, innerHTML
+ */
+declare function extractBackgroundImage(block: WordPressBlock): string | null;
+/**
+ * Extract image URL from a block
+ * Returns Cloudflare URL if available, otherwise WordPress URL
+ */
+declare function extractImageUrl(block: WordPressBlock): string | null;
+/**
+ * Extract image attributes (url, alt, width, height)
+ */
+declare function extractImageAttributes(block: WordPressBlock): {
+    url: string | null;
+    alt: string;
+    width?: number;
+    height?: number;
+};
+/**
+ * Extract title/heading text from a block
+ */
+declare function extractTitle(block: WordPressBlock): string | null;
+/**
+ * Extract content/text from a block
+ * Returns React node for rendering
+ */
+declare function extractContent(block: WordPressBlock, context: RenderContext): React$1.ReactNode;
+/**
+ * Extract media position from media-text block
+ */
+declare function extractMediaPosition(block: WordPressBlock): 'left' | 'right';
+/**
+ * Extract vertical alignment from block
+ */
+declare function extractVerticalAlignment(block: WordPressBlock): 'top' | 'center' | 'bottom';
+/**
+ * Extract alignment (full, wide, contained) from block
+ */
+declare function extractAlignment(block: WordPressBlock): 'full' | 'wide' | 'contained';
+/**
+ * Extract overlay color from cover block
+ */
+declare function extractOverlayColor(block: WordPressBlock): string | null;
+/**
+ * Extract dim ratio (overlay opacity) from cover block
+ */
+declare function extractDimRatio(block: WordPressBlock): number;
+/**
+ * Extract min height from block
+ */
+declare function extractMinHeight(block: WordPressBlock): {
+    value: number;
+    unit: string;
+} | null;
+/**
+ * Extract heading level from heading block
+ */
+declare function extractHeadingLevel(block: WordPressBlock): number;
+/**
+ * Extract text alignment from block
+ */
+declare function extractTextAlign(block: WordPressBlock): 'left' | 'center' | 'right' | null;
+/**
+ * Extract font size from block
+ */
+declare function extractFontSize(block: WordPressBlock): string | null;
+/**
+ * Convert image URL to Cloudflare variant if it's a Cloudflare URL
+ */
+declare function convertImageToCloudflareVariant(url: string | null, options?: {
+    width?: number;
+    height?: number;
+}): string | null;
+
+interface ImageConversionOptions {
+    /** Convert to Cloudflare variant if URL is already Cloudflare */
+    convertToCloudflare?: boolean;
+    /** Default width for Cloudflare variant */
+    defaultWidth?: number;
+    /** Default height for Cloudflare variant */
+    defaultHeight?: number;
+    /** Force conversion even if URL is not Cloudflare (not recommended) */
+    forceCloudflare?: boolean;
+}
+/**
+ * Convert image URL with optional Cloudflare variant transformation
+ *
+ * @param url - Image URL (WordPress or Cloudflare)
+ * @param options - Conversion options
+ * @returns Converted URL or original if conversion not applicable
+ */
+declare function convertImageUrl(url: string | null | undefined, options?: ImageConversionOptions): string | null;
+/**
+ * Batch convert multiple image URLs
+ */
+declare function convertImageUrls(urls: (string | null | undefined)[], options?: ImageConversionOptions): (string | null)[];
+
+interface SectionWrapperProps {
+    children: React$1.ReactNode;
+    /** Background color variant */
+    background?: 'light' | 'dark' | 'transparent';
+    /** Vertical spacing between sections */
+    spacing?: 'none' | 'small' | 'medium' | 'large';
+    /** Container width */
+    container?: 'full' | 'wide' | 'contained';
+    /** Additional CSS classes */
+    className?: string;
+    /** Optional block reference for extracting additional props */
+    block?: WordPressBlock;
+}
+/**
+ * Generic section wrapper component for consistent spacing and layout
+ *
+ * Usage in component mappings:
+ * ```ts
+ * {
+ *   pattern: { name: 'core/cover' },
+ *   component: HeroSection,
+ *   wrapper: SectionWrapper,
+ *   extractProps: (block) => ({ ... })
+ * }
+ * ```
+ */
+declare const SectionWrapper: React$1.FC<SectionWrapperProps>;
+
+export { SectionWrapper, WPContent, WPErrorBoundary, WPPage, buildClassName, convertImageToCloudflareVariant, convertImageUrl, convertImageUrls, createDefaultRegistry, createEnhancedRegistry, extractAlignment, extractBackgroundImage, extractContent, extractDimRatio, extractFontSize, extractHeadingLevel, extractImageAttributes, extractImageUrl, extractMediaPosition, extractMinHeight, extractOverlayColor, extractTextAlign, extractTextFromHTML, extractTitle, extractVerticalAlignment, findMatchingMapping, findShortcodes, getAlignmentClasses, getBlockTextContent, getCloudflareVariantUrl, getContainerClasses, getContentSpacingClasses, getFontSizeClasses, getImageAttributes, getImageUrl, getSectionSpacingClasses, getTextAlignClasses, isCloudflareImageUrl, matchesPattern, parseGutenbergBlocks, parseShortcodeAttrs, renderNodes, renderTextWithShortcodes };
+export type { AuthMode, BlockPattern, BlockRenderer, BlockRendererProps, CloudflareVariantOptions, ComponentMapping, ComponentRegistry, EnhancedRegistry, ImageConversionOptions, ParseOptions, ParsedShortcode, RenderContext, RenderOptions, SectionWrapperProps, ShortcodeAttributes, ShortcodeRenderer, WPContentProps, WPNode, WPPageProps, WordPressBlock, WordPressEmbedded, WordPressFeaturedMedia, WordPressPageMinimal, WordPressTitleField };

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC"}