@marvalt/wparser 0.1.23 → 0.1.25

package/dist/index.d.ts

@@ -1,6 +1,26 @@
 import React$1 from 'react';
 
 type AuthMode = 'cloudflare_proxy' | 'direct' | string;
+/**
+ * Maps WordPress theme color names to app-specific CSS classes
+ * WordPress controls which color is applied, app controls what it means
+ *
+ * @param wpColorName - WordPress theme color name (e.g., 'accent-5', 'base', 'contrast')
+ * @returns CSS class string (e.g., 'bg-gray-100') or null if no mapping
+ *
+ * @example
+ * ```ts
+ * const colorMapper: ColorMapper = (wpColorName) => {
+ *   const colorMap: Record<string, string> = {
+ *     'accent-5': 'bg-gray-100',
+ *     'base': 'bg-white',
+ *     'contrast': 'bg-gray-900',
+ *   };
+ *   return wpColorName ? colorMap[wpColorName] || null : null;
+ * };
+ * ```
+ */
+type ColorMapper = (wpColorName: string | undefined | null) => string | null;
 interface WordPressFeaturedMedia {
     source_url?: string;
     alt_text?: string;
@@ -29,6 +49,7 @@ interface WordPressPageMinimal {
 interface RenderContext {
     registry: ComponentRegistry;
     page?: WordPressPageMinimal;
+    colorMapper?: ColorMapper;
 }
 interface BlockRendererProps {
     block: WordPressBlock;
@@ -47,6 +68,8 @@ interface ComponentRegistry {
     shortcodes: Record<string, ShortcodeRenderer>;
     /** Fallback renderer for unknown blocks */
     fallback: BlockRenderer;
+    /** Optional color mapper for converting WordPress theme colors to CSS classes */
+    colorMapper?: ColorMapper;
 }
 /**
  * Pattern matching for blocks - allows matching blocks by name and attributes
@@ -99,7 +122,7 @@ interface RenderOptions {
 }
 declare function renderNodes(blocks: WordPressBlock[], registry: ComponentRegistry, options?: RenderOptions, page?: WordPressPageMinimal): React$1.ReactNode;
 
-declare function createDefaultRegistry(): ComponentRegistry;
+declare function createDefaultRegistry(colorMapper?: ColorMapper): ComponentRegistry;
 
 /**
  * Create an enhanced registry that supports pattern-based component mapping
@@ -129,7 +152,7 @@ declare function createDefaultRegistry(): ComponentRegistry;
  * const registry = createEnhancedRegistry(mappings);
  * ```
  */
-declare function createEnhancedRegistry(mappings?: ComponentMapping[], baseRegistry?: ComponentRegistry): EnhancedRegistry;
+declare function createEnhancedRegistry(mappings?: ComponentMapping[], baseRegistry?: ComponentRegistry, colorMapper?: ColorMapper): EnhancedRegistry;
 
 interface WPContentProps {
     blocks: WordPressBlock[];
@@ -413,6 +436,25 @@ declare function parseContentPosition(contentPosition: string | undefined): {
  * Extract video iframe HTML from innerBlocks (finds HTML block with iframe)
  */
 declare function extractVideoIframeFromInnerBlocks(block: WordPressBlock): string | null;
+/**
+ * Extract and map background color from block attributes
+ * Uses colorMapper from context to convert WordPress theme colors to app CSS classes
+ *
+ * WordPress controls which color is applied (via backgroundColor attribute),
+ * app controls what it means (via colorMapper function)
+ *
+ * @param block - WordPress block to extract background color from
+ * @param context - Render context containing optional colorMapper
+ * @returns CSS class string (e.g., 'bg-gray-100') or null if no mapping
+ *
+ * @example
+ * ```ts
+ * // In WordPress, group block has: backgroundColor: "accent-5"
+ * // In app, colorMapper maps: "accent-5" → "bg-gray-100"
+ * // Result: extractBackgroundColor returns "bg-gray-100"
+ * ```
+ */
+declare function extractBackgroundColor(block: WordPressBlock, context: RenderContext): string | null;
 
 interface ImageConversionOptions {
     /** Convert to Cloudflare variant if URL is already Cloudflare */
@@ -465,5 +507,5 @@ interface SectionWrapperProps {
  */
 declare const SectionWrapper: React$1.FC<SectionWrapperProps>;
 
-export { SectionWrapper, WPContent, WPErrorBoundary, WPPage, buildClassName, convertImageToCloudflareVariant, convertImageUrl, convertImageUrls, createDefaultRegistry, createEnhancedRegistry, extractAlignment, extractBackgroundImage, extractButtonsFromInnerBlocks, extractContent, extractDimRatio, extractFontSize, extractHeadingLevel, extractImageAttributes, extractImageUrl, extractImageUrlWithFallback, extractMediaPosition, extractMinHeight, extractOverlayColor, extractSubtitleFromInnerBlocks, extractTextAlign, extractTextAlignFromInnerBlocks, extractTextFromHTML, extractTitle, extractTitleFromInnerBlocks, extractVerticalAlignment, extractVideoIframeFromInnerBlocks, findMatchingMapping, findShortcodes, getAlignmentClasses, getBlockTextContent, getCloudflareVariantUrl, getContainerClasses, getContentSpacingClasses, getFontSizeClasses, getImageAttributes, getImageUrl, getSectionSpacingClasses, getTextAlignClasses, isCloudflareImageUrl, isValidCloudflareUrl, matchesPattern, parseContentPosition, 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 };
+export { SectionWrapper, WPContent, WPErrorBoundary, WPPage, buildClassName, convertImageToCloudflareVariant, convertImageUrl, convertImageUrls, createDefaultRegistry, createEnhancedRegistry, extractAlignment, extractBackgroundColor, extractBackgroundImage, extractButtonsFromInnerBlocks, extractContent, extractDimRatio, extractFontSize, extractHeadingLevel, extractImageAttributes, extractImageUrl, extractImageUrlWithFallback, extractMediaPosition, extractMinHeight, extractOverlayColor, extractSubtitleFromInnerBlocks, extractTextAlign, extractTextAlignFromInnerBlocks, extractTextFromHTML, extractTitle, extractTitleFromInnerBlocks, extractVerticalAlignment, extractVideoIframeFromInnerBlocks, findMatchingMapping, findShortcodes, getAlignmentClasses, getBlockTextContent, getCloudflareVariantUrl, getContainerClasses, getContentSpacingClasses, getFontSizeClasses, getImageAttributes, getImageUrl, getSectionSpacingClasses, getTextAlignClasses, isCloudflareImageUrl, isValidCloudflareUrl, matchesPattern, parseContentPosition, parseGutenbergBlocks, parseShortcodeAttrs, renderNodes, renderTextWithShortcodes };
+export type { AuthMode, BlockPattern, BlockRenderer, BlockRendererProps, CloudflareVariantOptions, ColorMapper, 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,6BAA6B,CAAC;AAC5C,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAClH,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,OAAO,EACL,2BAA2B,EAC3B,8BAA8B,EAC9B,6BAA6B,EAC7B,iCAAiC,EACjC,+BAA+B,EAC/B,+BAA+B,EAC/B,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,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,OAAO,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAClH,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,OAAO,EACL,2BAA2B,EAC3B,8BAA8B,EAC9B,6BAA6B,EAC7B,iCAAiC,EACjC,+BAA+B,EAC/B,+BAA+B,EAC/B,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC"}