@marvalt/wadapter 2.3.20 → 2.3.22

package/dist/index.d.ts

@@ -466,6 +466,39 @@ declare class WordPressClient {
         site_name?: string;
         site_description?: string;
     }>;
+    /**
+     * Fetch Theme Styles from custom endpoint
+     * @returns Theme customization settings (typography, colors, backgrounds, shadows, layout)
+     */
+    getThemeStyles(): Promise<{
+        typography?: {
+            heading_font_family?: string;
+            body_font_family?: string;
+            base_font_size?: string;
+            line_height?: string;
+        };
+        colors?: {
+            primary?: string;
+            secondary?: string;
+            text?: string;
+            background?: string;
+        };
+        backgrounds?: {
+            image?: string;
+            repeat?: string;
+            position?: string;
+            size?: string;
+        };
+        shadows?: {
+            box_shadow?: string;
+            text_shadow?: string;
+        };
+        layout?: {
+            container_max_width?: string;
+            wide_container_max_width?: string;
+            content_padding?: string;
+        };
+    }>;
 }
 
 /**
@@ -921,10 +954,40 @@ interface SiteSettings {
     site_name?: string;
     site_description?: string;
 }
+interface ThemeStyles {
+    typography?: {
+        heading_font_family?: string;
+        body_font_family?: string;
+        base_font_size?: string;
+        line_height?: string;
+    };
+    colors?: {
+        primary?: string;
+        secondary?: string;
+        text?: string;
+        background?: string;
+    };
+    backgrounds?: {
+        image?: string;
+        repeat?: string;
+        position?: string;
+        size?: string;
+    };
+    shadows?: {
+        box_shadow?: string;
+        text_shadow?: string;
+    };
+    layout?: {
+        container_max_width?: string;
+        wide_container_max_width?: string;
+        content_padding?: string;
+    };
+}
 interface WordPressStaticData {
     generatedAt?: string;
     front_page?: FrontPageMetadata;
     site_settings?: SiteSettings;
+    theme_styles?: ThemeStyles;
     posts: WordPressPost[];
     pages: WordPressPage[];
     media: WordPressMedia[];
@@ -948,6 +1011,11 @@ declare function getFrontpageMetadata(): FrontPageMetadata | undefined;
  * This is set by the generator from WordPress theme mods and options
  */
 declare function getSiteSettings(): SiteSettings | undefined;
+/**
+ * Get theme styles (typography, colors, backgrounds, shadows, layout) from static data
+ * This is set by the generator from WordPress Customizer settings
+ */
+declare function getThemeStyles(): ThemeStyles | undefined;
 
 /**
  * @license GPL-3.0-or-later
@@ -1160,5 +1228,55 @@ declare function getFrontpageSlug(pages?: WordPressPage[], frontPageMetadata?: {
     slug: string;
 } | undefined): string | undefined;
 
-export { GravityForm, GravityFormsClient, GravityFormsProvider, WordPressClient, WordPressContent, WordPressProvider, buildMenuStructure, buildPageHierarchy, createFormProtectionConfig, createGravityFormsConfig, createWordPressConfig, findPageById, findPageBySlug, getActiveForms, getChildPages, getFormById, getFrontpage, getFrontpageMetadata, getFrontpageSlug, getPublishedForms, getRootPages, getSiteSettings, getWordPressCategories, getWordPressMedia, getWordPressPages, getWordPressPosts, getWordPressTags, hasGravityFormsStatic, hasWordPressStatic, loadGravityFormsData, loadWordPressData, sanitizeHtml, transformWordPressMedia, transformWordPressMediaItems, transformWordPressPage, transformWordPressPages, transformWordPressPost, transformWordPressPosts, useFrontpageSlug, useGravityForms, useGravityFormsConfig, useGravityFormsContext, useWordPress, useWordPressCategories, useWordPressContext, useWordPressMedia, useWordPressPage, useWordPressPages, useWordPressPost, useWordPressPosts, useWordPressTags, validateEmail, validateFormData, validateFormProtectionConfig, validateGravityFormsConfig, validateMaxLength, validateMinLength, validatePhoneNumber, validateRequired, validateUrl, validateWordPressConfig };
-export type { EmailVerificationData, FormProtectionConfig, FormProtectionResult, FormProtectionValidation, FrontPageMetadata, GravityFormConfirmation, GravityFormField, GravityFormNotification, GravityFormSubmission, GravityFormSubmissionResult, GravityFormsConfig, GravityFormsStaticData, HierarchicalPage, MenuItem, SiteSettings, TransformedWordPressMedia, TransformedWordPressPage, TransformedWordPressPost, UseGravityFormsResult, UseWordPressResult, WordPressAuthor, WordPressCategory, WordPressConfig, WordPressMedia, WordPressPage, WordPressPost, WordPressQueryParams, WordPressStaticData, WordPressTag };
+/**
+ * @license GPL-3.0-or-later
+ *
+ * This file is part of the MarVAlt Open SDK.
+ * Copyright (c) 2025 Vibune Pty Ltd.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU General Public License for more details.
+ */
+/**
+ * List of popular Google Fonts (for detection and validation)
+ */
+declare const GOOGLE_FONTS: readonly ["Montserrat", "Open Sans", "Roboto", "Lato", "Poppins", "Source Sans Pro", "Raleway", "Oswald", "Playfair Display", "Merriweather", "Ubuntu", "Nunito", "Inter", "Work Sans", "Crimson Text", "Libre Baskerville", "PT Sans", "PT Serif", "Dancing Script", "Bebas Neue", "Fira Sans", "Noto Sans", "Noto Serif", "Rubik", "Mukta", "Cabin", "Dosis", "Arimo", "Titillium Web"];
+/**
+ * Sanitize font name - removes "family" prefix and cleans the name
+ *
+ * @param fontName - Font name to sanitize
+ * @returns Sanitized font name
+ */
+declare function sanitizeFontName(fontName: string): string;
+/**
+ * Format font-family CSS value with quotes and fallback
+ *
+ * @param fontName - Font name to format
+ * @param fallback - Fallback font (default: 'sans-serif')
+ * @returns Formatted font-family CSS value
+ */
+declare function formatFontFamily(fontName: string, fallback?: string): string;
+/**
+ * Load Google Font dynamically via link tag
+ *
+ * @param fontName - Google Font name to load
+ * @param weights - Font weights to load (default: 400, 500, 600, 700)
+ */
+declare function loadGoogleFont(fontName: string, weights?: number[]): void;
+/**
+ * Check if a font name is a Google Font
+ *
+ * @param fontName - Font name to check
+ * @returns True if the font is a Google Font
+ */
+declare function isGoogleFont(fontName: string): boolean;
+
+export { GOOGLE_FONTS, GravityForm, GravityFormsClient, GravityFormsProvider, WordPressClient, WordPressContent, WordPressProvider, buildMenuStructure, buildPageHierarchy, createFormProtectionConfig, createGravityFormsConfig, createWordPressConfig, findPageById, findPageBySlug, formatFontFamily, getActiveForms, getChildPages, getFormById, getFrontpage, getFrontpageMetadata, getFrontpageSlug, getPublishedForms, getRootPages, getSiteSettings, getThemeStyles, getWordPressCategories, getWordPressMedia, getWordPressPages, getWordPressPosts, getWordPressTags, hasGravityFormsStatic, hasWordPressStatic, isGoogleFont, loadGoogleFont, loadGravityFormsData, loadWordPressData, sanitizeFontName, sanitizeHtml, transformWordPressMedia, transformWordPressMediaItems, transformWordPressPage, transformWordPressPages, transformWordPressPost, transformWordPressPosts, useFrontpageSlug, useGravityForms, useGravityFormsConfig, useGravityFormsContext, useWordPress, useWordPressCategories, useWordPressContext, useWordPressMedia, useWordPressPage, useWordPressPages, useWordPressPost, useWordPressPosts, useWordPressTags, validateEmail, validateFormData, validateFormProtectionConfig, validateGravityFormsConfig, validateMaxLength, validateMinLength, validatePhoneNumber, validateRequired, validateUrl, validateWordPressConfig };
+export type { EmailVerificationData, FormProtectionConfig, FormProtectionResult, FormProtectionValidation, FrontPageMetadata, GravityFormConfirmation, GravityFormField, GravityFormNotification, GravityFormSubmission, GravityFormSubmissionResult, GravityFormsConfig, GravityFormsStaticData, HierarchicalPage, MenuItem, SiteSettings, ThemeStyles, TransformedWordPressMedia, TransformedWordPressPage, TransformedWordPressPost, UseGravityFormsResult, UseWordPressResult, WordPressAuthor, WordPressCategory, WordPressConfig, WordPressMedia, WordPressPage, WordPressPost, WordPressQueryParams, WordPressStaticData, WordPressTag };

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uCAAuC,CAAC;AAGtD,cAAc,sCAAsC,CAAC;AAGrD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,cAAc,qCAAqC,CAAC;AACpD,cAAc,wCAAwC,CAAC;AAGvD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAM9C,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AAGxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uCAAuC,CAAC;AAGtD,cAAc,sCAAsC,CAAC;AAGrD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,cAAc,qCAAqC,CAAC;AACpD,cAAc,wCAAwC,CAAC;AAGvD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAM9C,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AAGxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC"}

package/dist/index.esm.js

@@ -262,6 +262,13 @@ class WordPressClient {
     async getSettings() {
         return this.makeRequest('/wp-custom/v1/settings');
     }
+    /**
+     * Fetch Theme Styles from custom endpoint
+     * @returns Theme customization settings (typography, colors, backgrounds, shadows, layout)
+     */
+    async getThemeStyles() {
+        return this.makeRequest('/wp-custom/v1/theme-styles');
+    }
 }
 
 /**
@@ -754,6 +761,13 @@ function getFrontpageMetadata() {
 function getSiteSettings() {
     return wordpressStaticData?.site_settings;
 }
+/**
+ * Get theme styles (typography, colors, backgrounds, shadows, layout) from static data
+ * This is set by the generator from WordPress Customizer settings
+ */
+function getThemeStyles() {
+    return wordpressStaticData?.theme_styles;
+}
 
 /**
  * @license GPL-3.0-or-later
@@ -2728,5 +2742,136 @@ function validateFormData(formData, rules) {
     return { isValid, errors };
 }
 
-export { GravityForm, GravityFormsClient, GravityFormsProvider, WordPressClient, WordPressContent, WordPressProvider, buildMenuStructure, buildPageHierarchy, createFormProtectionConfig, createGravityFormsConfig, createWordPressConfig, findPageById, findPageBySlug, getActiveForms, getChildPages, getFormById, getFrontpage, getFrontpageMetadata, getFrontpageSlug, getPublishedForms, getRootPages, getSiteSettings, getWordPressCategories, getWordPressMedia, getWordPressPages, getWordPressPosts, getWordPressTags, hasGravityFormsStatic, hasWordPressStatic, loadGravityFormsData, loadWordPressData, sanitizeHtml, transformWordPressMedia, transformWordPressMediaItems, transformWordPressPage, transformWordPressPages, transformWordPressPost, transformWordPressPosts, useFrontpageSlug, useGravityForms, useGravityFormsConfig, useGravityFormsContext, useWordPress, useWordPressCategories, useWordPressContext, useWordPressMedia, useWordPressPage, useWordPressPages, useWordPressPost, useWordPressPosts, useWordPressTags, validateEmail, validateFormData, validateFormProtectionConfig, validateGravityFormsConfig, validateMaxLength, validateMinLength, validatePhoneNumber, validateRequired, validateUrl, validateWordPressConfig };
+/**
+ * @license GPL-3.0-or-later
+ *
+ * This file is part of the MarVAlt Open SDK.
+ * Copyright (c) 2025 Vibune Pty Ltd.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU General Public License for more details.
+ */
+/**
+ * List of popular Google Fonts (for detection and validation)
+ */
+const GOOGLE_FONTS = [
+    'Montserrat',
+    'Open Sans',
+    'Roboto',
+    'Lato',
+    'Poppins',
+    'Source Sans Pro',
+    'Raleway',
+    'Oswald',
+    'Playfair Display',
+    'Merriweather',
+    'Ubuntu',
+    'Nunito',
+    'Inter',
+    'Work Sans',
+    'Crimson Text',
+    'Libre Baskerville',
+    'PT Sans',
+    'PT Serif',
+    'Dancing Script',
+    'Bebas Neue',
+    'Fira Sans',
+    'Noto Sans',
+    'Noto Serif',
+    'Rubik',
+    'Mukta',
+    'Cabin',
+    'Dosis',
+    'Arimo',
+    'Titillium Web',
+];
+/**
+ * Sanitize font name - removes "family" prefix and cleans the name
+ *
+ * @param fontName - Font name to sanitize
+ * @returns Sanitized font name
+ */
+function sanitizeFontName(fontName) {
+    if (!fontName)
+        return '';
+    // Remove "family" prefix if present (case insensitive)
+    let cleaned = fontName.replace(/^family\s*/i, '').trim();
+    return cleaned;
+}
+/**
+ * Format font-family CSS value with quotes and fallback
+ *
+ * @param fontName - Font name to format
+ * @param fallback - Fallback font (default: 'sans-serif')
+ * @returns Formatted font-family CSS value
+ */
+function formatFontFamily(fontName, fallback = 'sans-serif') {
+    if (!fontName)
+        return fallback;
+    const cleaned = sanitizeFontName(fontName);
+    if (!cleaned)
+        return fallback;
+    // If font name contains spaces, wrap in quotes
+    const quotedFont = cleaned.includes(' ') ? `"${cleaned}"` : cleaned;
+    return `${quotedFont}, ${fallback}`;
+}
+/**
+ * Load Google Font dynamically via link tag
+ *
+ * @param fontName - Google Font name to load
+ * @param weights - Font weights to load (default: 400, 500, 600, 700)
+ */
+function loadGoogleFont(fontName, weights = [400, 500, 600, 700]) {
+    if (typeof document === 'undefined') {
+        // Server-side rendering - skip
+        return;
+    }
+    if (!fontName)
+        return;
+    const cleaned = sanitizeFontName(fontName);
+    if (!cleaned)
+        return;
+    // Check if it's a Google Font
+    const isGoogleFont = GOOGLE_FONTS.some(font => font.toLowerCase() === cleaned.toLowerCase());
+    if (!isGoogleFont) {
+        // Not a Google Font, assume it's a system font or custom font
+        return;
+    }
+    // Check if font is already loaded
+    const fontId = `wp-google-font-${cleaned.toLowerCase().replace(/\s+/g, '-')}`;
+    if (document.getElementById(fontId)) {
+        return; // Already loaded
+    }
+    // Create link element for Google Fonts
+    const link = document.createElement('link');
+    link.id = fontId;
+    link.rel = 'stylesheet';
+    // Build Google Fonts URL with weights
+    const weightsParam = weights.join(';');
+    link.href = `https://fonts.googleapis.com/css2?family=${encodeURIComponent(cleaned)}:wght@${weightsParam}&display=swap`;
+    document.head.appendChild(link);
+}
+/**
+ * Check if a font name is a Google Font
+ *
+ * @param fontName - Font name to check
+ * @returns True if the font is a Google Font
+ */
+function isGoogleFont(fontName) {
+    if (!fontName)
+        return false;
+    const cleaned = sanitizeFontName(fontName);
+    if (!cleaned)
+        return false;
+    return GOOGLE_FONTS.some(font => font.toLowerCase() === cleaned.toLowerCase());
+}
+
+export { GOOGLE_FONTS, GravityForm, GravityFormsClient, GravityFormsProvider, WordPressClient, WordPressContent, WordPressProvider, buildMenuStructure, buildPageHierarchy, createFormProtectionConfig, createGravityFormsConfig, createWordPressConfig, findPageById, findPageBySlug, formatFontFamily, getActiveForms, getChildPages, getFormById, getFrontpage, getFrontpageMetadata, getFrontpageSlug, getPublishedForms, getRootPages, getSiteSettings, getThemeStyles, getWordPressCategories, getWordPressMedia, getWordPressPages, getWordPressPosts, getWordPressTags, hasGravityFormsStatic, hasWordPressStatic, isGoogleFont, loadGoogleFont, loadGravityFormsData, loadWordPressData, sanitizeFontName, sanitizeHtml, transformWordPressMedia, transformWordPressMediaItems, transformWordPressPage, transformWordPressPages, transformWordPressPost, transformWordPressPosts, useFrontpageSlug, useGravityForms, useGravityFormsConfig, useGravityFormsContext, useWordPress, useWordPressCategories, useWordPressContext, useWordPressMedia, useWordPressPage, useWordPressPages, useWordPressPost, useWordPressPosts, useWordPressTags, validateEmail, validateFormData, validateFormProtectionConfig, validateGravityFormsConfig, validateMaxLength, validateMinLength, validatePhoneNumber, validateRequired, validateUrl, validateWordPressConfig };
 //# sourceMappingURL=index.esm.js.map