@ogxjs/core 0.1.2 → 0.3.0

package/dist/cache/snapshot.d.ts

@@ -0,0 +1,116 @@
+/**
+ * @ogxjs/core - Snapshot Cache v2
+ * High-performance image cache with LRU eviction
+ *
+ * @description
+ * Refactored cache system for v0.2.0 "Turbo":
+ * - Uses fast sync hash (FNV-1a/xxHash) instead of SHA-256
+ * - LRU eviction instead of simple Map
+ * - Optional TTL support
+ * - Memory bounded
+ *
+ * @version 0.2.0 "Turbo"
+ */
+import { type LRUCacheStats } from "./lru";
+export interface SnapshotCacheOptions {
+    /** Maximum number of cached images (default: 500) */
+    maxSize?: number;
+    /** Time-to-live in milliseconds (default: 0 = no expiration) */
+    ttl?: number;
+}
+export interface SnapshotCacheStats extends LRUCacheStats {
+    /** Memory estimate in bytes */
+    memoryEstimate: number;
+}
+/**
+ * Cache for generated OG images
+ *
+ * Uses LRU eviction to bound memory usage.
+ * Keys are generated from config objects using fast hash.
+ *
+ * @example
+ * ```ts
+ * const cache = new SnapshotCacheV2({ maxSize: 100, ttl: 60000 });
+ *
+ * const hash = cache.getHash(config);
+ * if (!cache.has(hash)) {
+ *   const image = await render(element);
+ *   cache.set(hash, image);
+ * }
+ * return cache.get(hash);
+ * ```
+ */
+export declare class SnapshotCacheV2 {
+    private cache;
+    private memoryEstimate;
+    constructor(options?: SnapshotCacheOptions);
+    /**
+     * Generate a hash key for a configuration object
+     * Uses fast sync hash (no await needed)
+     */
+    getHash(config: unknown): string;
+    /**
+     * Get a cached image by hash
+     */
+    get(hash: string): Uint8Array | string | undefined;
+    /**
+     * Check if a hash exists in cache
+     */
+    has(hash: string): boolean;
+    /**
+     * Store an image in cache
+     */
+    set(hash: string, data: Uint8Array | string): void;
+    /**
+     * Delete a cached image
+     */
+    delete(hash: string): boolean;
+    /**
+     * Clear the entire cache
+     */
+    clear(): void;
+    /**
+     * Get cache size
+     */
+    get size(): number;
+    /**
+     * Get cache statistics
+     */
+    get stats(): SnapshotCacheStats;
+    /**
+     * Prune expired entries
+     */
+    prune(): number;
+    /**
+     * @deprecated Use getHash() instead (sync, no await needed)
+     */
+    getHashAsync(config: unknown): Promise<string>;
+    /**
+     * Set cache TTL
+     * Note: Only affects new entries, not existing ones
+     */
+    setTTL(_milliseconds: number): void;
+}
+export declare function getSnapshotCache(): SnapshotCacheV2;
+/**
+ * Configure the global cache instance
+ * Must be called before any cache operations
+ */
+export declare function configureSnapshotCache(options: SnapshotCacheOptions): void;
+/**
+ * Legacy export for backward compatibility
+ */
+export declare const snapshotCache: {
+    readonly instance: SnapshotCacheV2;
+    getHash(config: unknown): string;
+    getHashAsync(config: unknown): Promise<string>;
+    get(hash: string): Uint8Array | string | undefined;
+    has(hash: string): boolean;
+    set(hash: string, data: Uint8Array | string): void;
+    delete(hash: string): boolean;
+    clear(): void;
+    readonly size: number;
+    readonly stats: SnapshotCacheStats;
+    setTTL(ms: number): void;
+};
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/cache/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/cache/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAY,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAIrD,MAAM,WAAW,oBAAoB;IACpC,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACxD,+BAA+B;IAC/B,cAAc,EAAE,MAAM,CAAC;CACvB;AAID;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,eAAe;IAC3B,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,cAAc,CAAK;gBAEf,OAAO,GAAE,oBAAyB;IAe9C;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM;IAIhC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS;IAIlD;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI;IAWlD;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAY7B;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,kBAAkB,CAK9B;IAED;;OAEG;IACH,KAAK,IAAI,MAAM;IAQf;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAIpD;;;OAGG;IACH,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;CAKnC;AAUD,wBAAgB,gBAAgB,IAAI,eAAe,CAQlD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAE1E;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;;oBAKT,OAAO,GAAG,MAAM;yBAIL,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;cAI1C,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS;cAIxC,MAAM,GAAG,OAAO;cAIhB,MAAM,QAAQ,UAAU,GAAG,MAAM,GAAG,IAAI;iBAIrC,MAAM,GAAG,OAAO;aAIpB,IAAI;mBAID,MAAM;oBAIL,kBAAkB;eAIpB,MAAM,GAAG,IAAI;CAGxB,CAAC"}

package/dist/cache/snapshot.js

@@ -0,0 +1,204 @@
+/**
+ * @ogxjs/core - Snapshot Cache v2
+ * High-performance image cache with LRU eviction
+ *
+ * @description
+ * Refactored cache system for v0.2.0 "Turbo":
+ * - Uses fast sync hash (FNV-1a/xxHash) instead of SHA-256
+ * - LRU eviction instead of simple Map
+ * - Optional TTL support
+ * - Memory bounded
+ *
+ * @version 0.2.0 "Turbo"
+ */
+import { hashObject } from "./hash";
+import { LRUCache } from "./lru";
+// SNAPSHOT CACHE CLASS
+/**
+ * Cache for generated OG images
+ *
+ * Uses LRU eviction to bound memory usage.
+ * Keys are generated from config objects using fast hash.
+ *
+ * @example
+ * ```ts
+ * const cache = new SnapshotCacheV2({ maxSize: 100, ttl: 60000 });
+ *
+ * const hash = cache.getHash(config);
+ * if (!cache.has(hash)) {
+ *   const image = await render(element);
+ *   cache.set(hash, image);
+ * }
+ * return cache.get(hash);
+ * ```
+ */
+export class SnapshotCacheV2 {
+    cache;
+    memoryEstimate = 0;
+    constructor(options = {}) {
+        this.cache = new LRUCache({
+            maxSize: options.maxSize ?? 500,
+            ttl: options.ttl ?? 0,
+            onEvict: (_key, value) => {
+                // Update memory estimate on eviction
+                if (value instanceof Uint8Array) {
+                    this.memoryEstimate -= value.byteLength;
+                }
+                else if (typeof value === "string") {
+                    this.memoryEstimate -= value.length * 2; // UTF-16
+                }
+            },
+        });
+    }
+    /**
+     * Generate a hash key for a configuration object
+     * Uses fast sync hash (no await needed)
+     */
+    getHash(config) {
+        return hashObject(config);
+    }
+    /**
+     * Get a cached image by hash
+     */
+    get(hash) {
+        return this.cache.get(hash);
+    }
+    /**
+     * Check if a hash exists in cache
+     */
+    has(hash) {
+        return this.cache.has(hash);
+    }
+    /**
+     * Store an image in cache
+     */
+    set(hash, data) {
+        // Update memory estimate
+        if (data instanceof Uint8Array) {
+            this.memoryEstimate += data.byteLength;
+        }
+        else if (typeof data === "string") {
+            this.memoryEstimate += data.length * 2;
+        }
+        this.cache.set(hash, data);
+    }
+    /**
+     * Delete a cached image
+     */
+    delete(hash) {
+        const existing = this.cache.get(hash);
+        if (existing) {
+            if (existing instanceof Uint8Array) {
+                this.memoryEstimate -= existing.byteLength;
+            }
+            else if (typeof existing === "string") {
+                this.memoryEstimate -= existing.length * 2;
+            }
+        }
+        return this.cache.delete(hash);
+    }
+    /**
+     * Clear the entire cache
+     */
+    clear() {
+        this.cache.clear();
+        this.memoryEstimate = 0;
+    }
+    /**
+     * Get cache size
+     */
+    get size() {
+        return this.cache.size;
+    }
+    /**
+     * Get cache statistics
+     */
+    get stats() {
+        return {
+            ...this.cache.stats,
+            memoryEstimate: this.memoryEstimate,
+        };
+    }
+    /**
+     * Prune expired entries
+     */
+    prune() {
+        return this.cache.prune();
+    }
+    // ═══════════════════════════════════════════════════════════════════════
+    // LEGACY COMPATIBILITY
+    // ═══════════════════════════════════════════════════════════════════════
+    /**
+     * @deprecated Use getHash() instead (sync, no await needed)
+     */
+    async getHashAsync(config) {
+        return this.getHash(config);
+    }
+    /**
+     * Set cache TTL
+     * Note: Only affects new entries, not existing ones
+     */
+    setTTL(_milliseconds) {
+        console.warn("SnapshotCacheV2.setTTL() is deprecated. Pass ttl in constructor options.");
+    }
+}
+// SINGLETON INSTANCE
+/**
+ * Global singleton cache instance
+ * Configured with sensible defaults
+ */
+let _instance = null;
+export function getSnapshotCache() {
+    if (!_instance) {
+        _instance = new SnapshotCacheV2({
+            maxSize: 500,
+            ttl: 0, // No expiration by default
+        });
+    }
+    return _instance;
+}
+/**
+ * Configure the global cache instance
+ * Must be called before any cache operations
+ */
+export function configureSnapshotCache(options) {
+    _instance = new SnapshotCacheV2(options);
+}
+/**
+ * Legacy export for backward compatibility
+ */
+export const snapshotCache = {
+    get instance() {
+        return getSnapshotCache();
+    },
+    getHash(config) {
+        return getSnapshotCache().getHash(config);
+    },
+    async getHashAsync(config) {
+        return getSnapshotCache().getHash(config);
+    },
+    get(hash) {
+        return getSnapshotCache().get(hash);
+    },
+    has(hash) {
+        return getSnapshotCache().has(hash);
+    },
+    set(hash, data) {
+        getSnapshotCache().set(hash, data);
+    },
+    delete(hash) {
+        return getSnapshotCache().delete(hash);
+    },
+    clear() {
+        getSnapshotCache().clear();
+    },
+    get size() {
+        return getSnapshotCache().size;
+    },
+    get stats() {
+        return getSnapshotCache().stats;
+    },
+    setTTL(ms) {
+        getSnapshotCache().setTTL(ms);
+    },
+};

package/dist/cache.d.ts

@@ -21,9 +21,9 @@ export declare class SnapshotCache {
      */
     getHashAsync(config: any): Promise<string>;
     /**
-     * Calculate a hash for a configuration object (sync fallback)
+     * Calculate a hash for a configuration object (sync)
      * Uses djb2 algorithm - fast but has higher collision probability
-     * @deprecated Use getHashAsync for better collision resistance
+     * Note: Cache v2 uses FNV-1a (fnv1a/fastHash) for better performance
      */
     getHash(config: any): string;
     /**

package/dist/cache.js

@@ -50,9 +50,9 @@ export class SnapshotCache {
         }
     }
     /**
-     * Calculate a hash for a configuration object (sync fallback)
+     * Calculate a hash for a configuration object (sync)
      * Uses djb2 algorithm - fast but has higher collision probability
-     * @deprecated Use getHashAsync for better collision resistance
+     * Note: Cache v2 uses FNV-1a (fnv1a/fastHash) for better performance
      */
     getHash(config) {
         const str = this.serializeConfig(config);

package/dist/css.d.ts

@@ -3,15 +3,15 @@
  * This is a subset of React.CSSProperties optimized for OG image generation
  */
 export interface CSSProperties {
-    display?: "flex" | "none";
-    position?: "relative" | "absolute";
+    display?: "flex" | "none" | "block" | "inline" | "inline-flex" | "inline-block";
+    position?: "relative" | "absolute" | "fixed" | "static" | "sticky";
     flexDirection?: "row" | "row-reverse" | "column" | "column-reverse";
     flexWrap?: "nowrap" | "wrap" | "wrap-reverse";
     flexGrow?: number;
     flexShrink?: number;
     flexBasis?: number | string;
     alignItems?: "flex-start" | "flex-end" | "center" | "baseline" | "stretch";
-    alignContent?: "flex-start" | "flex-end" | "center" | "space-between" | "space-around" | "stretch";
+    alignContent?: "flex-start" | "flex-end" | "center" | "space-between" | "space-around" | "space-evenly" | "stretch";
     alignSelf?: "auto" | "flex-start" | "flex-end" | "center" | "baseline" | "stretch";
     justifyContent?: "flex-start" | "flex-end" | "center" | "space-between" | "space-around" | "space-evenly";
     gap?: number | string;
@@ -39,7 +39,7 @@ export interface CSSProperties {
     left?: number | string;
     border?: string;
     borderWidth?: number | string;
-    borderStyle?: "solid" | "dashed";
+    borderStyle?: "solid" | "dashed" | "dotted" | "double" | "none";
     borderColor?: string;
     borderTop?: string;
     borderRight?: string;
@@ -71,13 +71,26 @@ export interface CSSProperties {
     whiteSpace?: "normal" | "pre" | "pre-wrap" | "pre-line" | "nowrap";
     wordBreak?: "normal" | "break-all" | "break-word" | "keep-all";
     opacity?: number;
-    overflow?: "visible" | "hidden";
+    overflow?: "visible" | "hidden" | "auto" | "scroll";
+    overflowX?: "visible" | "hidden" | "auto" | "scroll";
+    overflowY?: "visible" | "hidden" | "auto" | "scroll";
     boxShadow?: string;
     transform?: string;
     transformOrigin?: string;
-    objectFit?: "contain" | "cover" | "none";
+    objectFit?: "contain" | "cover" | "none" | "fill" | "scale-down";
     objectPosition?: string;
     filter?: string;
     clipPath?: string;
+    zIndex?: number | string;
+    aspectRatio?: string;
+    justifyItems?: "start" | "end" | "center" | "stretch";
+    justifySelf?: "auto" | "start" | "end" | "center" | "stretch";
+    pointerEvents?: "none" | "auto";
+    userSelect?: "none" | "text" | "all" | "auto";
+    borderTopWidth?: number | string;
+    borderRightWidth?: number | string;
+    borderBottomWidth?: number | string;
+    borderLeftWidth?: number | string;
+    overflowWrap?: "normal" | "break-word";
 }
 //# sourceMappingURL=css.d.ts.map

package/dist/css.d.ts.map

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

package/dist/font-registry.d.ts

@@ -14,6 +14,7 @@ export declare class FontRegistry {
     /**
      * Helper to register Inter fonts with specified weights (local files)
      * Only works in Bun/Node without bundlers
+     * @deprecated Use registerInterFromUrl() for universal compatibility. This method will be removed in v1.0.0
      */
     registerInter(weights?: (300 | 400 | 500 | 600 | 700)[]): Promise<void>;
     /**
@@ -21,6 +22,20 @@ export declare class FontRegistry {
      * Works with all bundlers (Next.js, Vite, etc.)
      */
     registerInterFromUrl(weights?: (300 | 400 | 500 | 600 | 700)[]): Promise<void>;
+    /**
+     * Helper to register any Google Font by name
+     * Works with all bundlers (Next.js, Vite, etc.)
+     */
+    registerGoogleFont(fontName: string, weights?: (100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900)[]): Promise<void>;
+    /**
+     * Helper to register a font from a local file
+     * Works in Node.js environments (Route Handlers, API routes)
+     */
+    registerFontFromFile(path: string, options: {
+        name: string;
+        weight?: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+        style?: "normal" | "italic";
+    }): Promise<void>;
     /**
      * Get all registered fonts
      */

package/dist/font-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"font-registry.d.ts","sourceRoot":"","sources":["../src/font-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;GAEG;AACH,qBAAa,YAAY;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAe;IACtC,OAAO,CAAC,KAAK,CAAoB;IAEjC,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,YAAY;IAOlC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,EAAE,GAAG,IAAI;IAgB/C;;;OAGG;IACG,aAAa,CAClB,OAAO,GAAE,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,EAAe,GACnD,OAAO,CAAC,IAAI,CAAC;IAMhB;;;OAGG;IACG,oBAAoB,CACzB,OAAO,GAAE,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,EAAe,GACnD,OAAO,CAAC,IAAI,CAAC;IAMhB;;OAEG;IACH,QAAQ,IAAI,UAAU,EAAE;IAIxB;;OAEG;IACH,KAAK,IAAI,IAAI;CAGb;AAED,eAAO,MAAM,YAAY,cAA6B,CAAC"}
+{"version":3,"file":"font-registry.d.ts","sourceRoot":"","sources":["../src/font-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;GAEG;AACH,qBAAa,YAAY;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAe;IACtC,OAAO,CAAC,KAAK,CAAoB;IAEjC,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,YAAY;IAOlC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,EAAE,GAAG,IAAI;IAgB/C;;;;OAIG;IACG,aAAa,CAClB,OAAO,GAAE,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,EAAe,GACnD,OAAO,CAAC,IAAI,CAAC;IAMhB;;;OAGG;IACG,oBAAoB,CACzB,OAAO,GAAE,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,EAAe,GACnD,OAAO,CAAC,IAAI,CAAC;IAMhB;;;OAGG;IACG,kBAAkB,CACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,EAAE,GAC/D,OAAO,CAAC,IAAI,CAAC;IAMhB;;;OAGG;IACG,oBAAoB,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;QAC7D,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;KAC5B,GACC,OAAO,CAAC,IAAI,CAAC;IAMhB;;OAEG;IACH,QAAQ,IAAI,UAAU,EAAE;IAIxB;;OAEG;IACH,KAAK,IAAI,IAAI;CAGb;AAED,eAAO,MAAM,YAAY,cAA6B,CAAC"}

package/dist/font-registry.js

@@ -28,6 +28,7 @@ export class FontRegistry {
     /**
      * Helper to register Inter fonts with specified weights (local files)
      * Only works in Bun/Node without bundlers
+     * @deprecated Use registerInterFromUrl() for universal compatibility. This method will be removed in v1.0.0
      */
     async registerInter(weights = [400, 700]) {
         const { loadInterFont } = await import("./fonts");
@@ -43,6 +44,24 @@ export class FontRegistry {
         const fonts = await Promise.all(weights.map((w) => loadInterFromUrl(w)));
         this.register(fonts);
     }
+    /**
+     * Helper to register any Google Font by name
+     * Works with all bundlers (Next.js, Vite, etc.)
+     */
+    async registerGoogleFont(fontName, weights) {
+        const { loadGoogleFont } = await import("./fonts");
+        const fonts = await loadGoogleFont(fontName, weights);
+        this.register(fonts);
+    }
+    /**
+     * Helper to register a font from a local file
+     * Works in Node.js environments (Route Handlers, API routes)
+     */
+    async registerFontFromFile(path, options) {
+        const { loadFontFromFile } = await import("./fonts");
+        const font = await loadFontFromFile(path, options);
+        this.register(font);
+    }
     /**
      * Get all registered fonts
      */

package/dist/fonts.d.ts

@@ -26,6 +26,27 @@ export declare function loadInterFromUrl(weight?: 300 | 400 | 500 | 600 | 700):
  * Load Inter font from local file
  * Only works in Bun/Node without bundlers
  * Supports weights: 300 (Light), 400 (Regular), 500 (Medium), 600 (SemiBold), 700 (Bold)
+ * @deprecated Use loadInterFromUrl() for universal compatibility. This function will be removed in v1.0.0
  */
 export declare function loadInterFont(weight?: 300 | 400 | 500 | 600 | 700): Promise<FontConfig>;
+/**
+ * Load any Google Font by name with specified weights
+ * Uses Bunny Fonts CDN (privacy-friendly Google Fonts mirror)
+ * @param fontName - Name of the Google Font (e.g., 'Roboto', 'Poppins', 'Playfair Display')
+ * @param weights - Array of font weights to load (default: [400, 700])
+ * @returns Promise resolving to array of FontConfig objects
+ */
+export declare function loadGoogleFont(fontName: string, weights?: (100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900)[]): Promise<FontConfig[]>;
+/**
+ * Load a font from a local file path
+ * Useful for loading custom fonts or integrating with next/font/local
+ * @param path - Path to the font file (relative or absolute)
+ * @param options - Font configuration options
+ * @returns Promise resolving to FontConfig object
+ */
+export declare function loadFontFromFile(path: string, options: {
+    name: string;
+    weight?: FontConfig["weight"];
+    style?: FontConfig["style"];
+}): Promise<FontConfig>;
 //# sourceMappingURL=fonts.d.ts.map

package/dist/fonts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fonts.d.ts","sourceRoot":"","sources":["../src/fonts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAI1C;;GAEG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAajE;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACpC,GAAG,EAAE,MAAM,EACX,SAAS,SAAQ,GACf,OAAO,CAAC,WAAW,CAAC,CAoCtB;AAED;;GAEG;AACH,wBAAgB,UAAU,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,CAAA;CAAO,GAC1E,UAAU,CAOZ;AAWD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACrC,MAAM,GAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAS,GACvC,OAAO,CAAC,UAAU,CAAC,CAIrB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAClC,MAAM,GAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAS,GACvC,OAAO,CAAC,UAAU,CAAC,CAkCrB"}
+{"version":3,"file":"fonts.d.ts","sourceRoot":"","sources":["../src/fonts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAI1C;;GAEG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAajE;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACpC,GAAG,EAAE,MAAM,EACX,SAAS,SAAQ,GACf,OAAO,CAAC,WAAW,CAAC,CAoCtB;AAED;;GAEG;AACH,wBAAgB,UAAU,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,CAAA;CAAO,GAC1E,UAAU,CAOZ;AAWD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACrC,MAAM,GAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAS,GACvC,OAAO,CAAC,UAAU,CAAC,CAIrB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAClC,MAAM,GAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAS,GACvC,OAAO,CAAC,UAAU,CAAC,CAkCrB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,EAAe,GAC3E,OAAO,CAAC,UAAU,EAAE,CAAC,CAcvB;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IACR,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC9B,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;CAC5B,GACC,OAAO,CAAC,UAAU,CAAC,CAMrB"}

package/dist/fonts.js

@@ -80,6 +80,7 @@ export async function loadInterFromUrl(weight = 400) {
  * Load Inter font from local file
  * Only works in Bun/Node without bundlers
  * Supports weights: 300 (Light), 400 (Regular), 500 (Medium), 600 (SemiBold), 700 (Bold)
+ * @deprecated Use loadInterFromUrl() for universal compatibility. This function will be removed in v1.0.0
  */
 export async function loadInterFont(weight = 400) {
     if (typeof globalThis !== "undefined" &&
@@ -108,3 +109,35 @@ export async function loadInterFont(weight = 400) {
     const data = await loadFont(path);
     return createFont("Inter", data, { weight });
 }
+/**
+ * Load any Google Font by name with specified weights
+ * Uses Bunny Fonts CDN (privacy-friendly Google Fonts mirror)
+ * @param fontName - Name of the Google Font (e.g., 'Roboto', 'Poppins', 'Playfair Display')
+ * @param weights - Array of font weights to load (default: [400, 700])
+ * @returns Promise resolving to array of FontConfig objects
+ */
+export async function loadGoogleFont(fontName, weights = [400, 700]) {
+    // Normalize font name for URL (replace spaces with hyphens, lowercase)
+    const urlFontName = fontName.toLowerCase().replace(/\s+/g, "-");
+    const fontConfigs = await Promise.all(weights.map(async (weight) => {
+        // Use Bunny Fonts CDN (privacy-friendly alternative to Google Fonts)
+        const url = `https://fonts.bunny.net/${urlFontName}/files/${urlFontName}-latin-${weight}-normal.woff`;
+        const data = await loadFontFromUrl(url);
+        return createFont(fontName, data, { weight });
+    }));
+    return fontConfigs;
+}
+/**
+ * Load a font from a local file path
+ * Useful for loading custom fonts or integrating with next/font/local
+ * @param path - Path to the font file (relative or absolute)
+ * @param options - Font configuration options
+ * @returns Promise resolving to FontConfig object
+ */
+export async function loadFontFromFile(path, options) {
+    const data = await loadFont(path);
+    return createFont(options.name, data, {
+        weight: options.weight,
+        style: options.style,
+    });
+}

package/dist/index.d.ts

@@ -1,17 +1,31 @@
+/**
+ * @ogxjs/core - High-performance OG Image Generator
+ *
+ * @description
+ * Generate beautiful Open Graph images using Tailwind CSS classes.
+ * Built for Node.js, Bun, and Deno.
+ *
+ * @version 0.3.0 "Universal Fonts"
+ * @see https://ogx-three.vercel.app
+ */
 export { absolute, badge, card, div, fluent, footer, grid, h, h1, h2, header, img, imgFromUrl, main, p, row, spacer, span, stack, svgFromContent, unsafe_img, validateImageUrl, } from "./builder";
-export { snapshotCache } from "./cache";
+export type { LRUCacheOptions, LRUCacheStats, SnapshotCacheOptions, SnapshotCacheStats, } from "./cache/index";
+export { configureSnapshotCache, fastHash, fnv1a, getSnapshotCache, hashObject, LRUCache, snapshotCache, } from "./cache/index";
 export type { CSSProperties } from "./css";
 export { fontRegistry } from "./font-registry";
-export { createFont, loadFont, loadFontFromUrl, loadInterFont, loadInterFromUrl, } from "./fonts";
+export { createFont, loadFont, loadFontFromFile, loadFontFromUrl, loadGoogleFont, loadInterFont, loadInterFromUrl, } from "./fonts";
 export { ogx, ogxToSVG } from "./ogx";
+export type { TimingAggregate, TimingEntry, TimingReport } from "./perf";
+export { benchmark, benchmarkSync, quickTime, quickTimeSync, Timer, timing, } from "./perf";
 export type { BlogPresetProps, DocsPresetProps, MinimalPresetProps, SocialPresetProps, } from "./presets";
 export { blogPreset, docsPreset, minimalPreset, presets, socialPreset, } from "./presets";
 export { render } from "./render-png";
 export { renderToSVG } from "./render-svg";
-export { parseTailwind } from "./tailwind";
+export type { CacheStats, GradientState, ParseContext } from "./tailwind";
+export { clearAllCaches, getCacheStats, isStaticClass, parseTailwind, parseTailwindBatch, STATIC_CLASSES, } from "./tailwind";
 export type { Platform } from "./targets";
 export { getPlatformDimensions } from "./targets";
-export type { FontConfig, OGXBaseConfig, OGXChildren, OGXConfig, OGXElement, OGXElementProps, Preset, PresetName, PresetProps, RenderOptions, } from "./types";
+export type { FontConfig, OGXBaseConfig, OGXChildren, OGXConfig, OGXElement, OGXElementProps, Preset, PresetName, PresetProps, RenderOptions, ThemeConfig, } from "./types";
 export { loadAsset, toDataUri } from "./utils/assets";
 export type { FitTextOptions } from "./utils/text";
 export { calculateFittingFontSize } from "./utils/text";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACN,QAAQ,EACR,KAAK,EACL,IAAI,EACJ,GAAG,EACH,MAAM,EACN,MAAM,EACN,IAAI,EACJ,CAAC,EACD,EAAE,EACF,EAAE,EACF,MAAM,EACN,GAAG,EACH,UAAU,EACV,IAAI,EACJ,CAAC,EACD,GAAG,EACH,MAAM,EACN,IAAI,EACJ,KAAK,EACL,cAAc,EACd,UAAU,EACV,gBAAgB,GAChB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,YAAY,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EACN,UAAU,EACV,QAAQ,EACR,eAAe,EACf,aAAa,EACb,gBAAgB,GAChB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtC,YAAY,EACX,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,iBAAiB,GACjB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACN,UAAU,EACV,UAAU,EACV,aAAa,EACb,OAAO,EACP,YAAY,GACZ,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,YAAY,EACX,UAAU,EACV,aAAa,EACb,WAAW,EACX,SAAS,EACT,UAAU,EACV,eAAe,EACf,MAAM,EACN,UAAU,EACV,WAAW,EACX,aAAa,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACN,QAAQ,EACR,KAAK,EACL,IAAI,EACJ,GAAG,EACH,MAAM,EACN,MAAM,EACN,IAAI,EACJ,CAAC,EACD,EAAE,EACF,EAAE,EACF,MAAM,EACN,GAAG,EACH,UAAU,EACV,IAAI,EACJ,CAAC,EACD,GAAG,EACH,MAAM,EACN,IAAI,EACJ,KAAK,EACL,cAAc,EACd,UAAU,EACV,gBAAgB,GAChB,MAAM,WAAW,CAAC;AACnB,YAAY,EACX,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,kBAAkB,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACN,sBAAsB,EACtB,QAAQ,EACR,KAAK,EACL,gBAAgB,EAChB,UAAU,EACV,QAAQ,EACR,aAAa,GACb,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EACN,UAAU,EACV,QAAQ,EACR,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,aAAa,EACb,gBAAgB,GAChB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtC,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEzE,OAAO,EACN,SAAS,EACT,aAAa,EACb,SAAS,EACT,aAAa,EACb,KAAK,EACL,MAAM,GACN,MAAM,QAAQ,CAAC;AAChB,YAAY,EACX,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,iBAAiB,GACjB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACN,UAAU,EACV,UAAU,EACV,aAAa,EACb,OAAO,EACP,YAAY,GACZ,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1E,OAAO,EACN,cAAc,EACd,aAAa,EACb,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,cAAc,GACd,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,YAAY,EACX,UAAU,EACV,aAAa,EACb,WAAW,EACX,SAAS,EACT,UAAU,EACV,eAAe,EACf,MAAM,EACN,UAAU,EACV,WAAW,EACX,aAAa,EACb,WAAW,GACX,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC"}