@ogxjs/core 0.1.2 → 0.2.0-alpha.1

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/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.2.0 "Turbo"
+ * @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 { 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;AAKH,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;AAIvB,OAAO,EACN,sBAAsB,EACtB,QAAQ,EACR,KAAK,EACL,gBAAgB,EAChB,UAAU,EACV,QAAQ,EACR,aAAa,GACb,MAAM,eAAe,CAAC;AAIvB,YAAY,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAI3C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EACN,UAAU,EACV,QAAQ,EACR,eAAe,EACf,aAAa,EACb,gBAAgB,GAChB,MAAM,SAAS,CAAC;AAIjB,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtC,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAIzE,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;AAInB,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;AAI1E,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;AAI1C,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;AAKjB,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"}

package/dist/index.js

@@ -1,19 +1,50 @@
-// @ogxjs/core - Main exports
-// Builder - Element construction
+/**
+ * @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.2.0 "Turbo"
+ * @see https://ogx-three.vercel.app
+ */
+// ═══════════════════════════════════════════════════════════════════════════
+// BUILDER - Element construction
+// ═══════════════════════════════════════════════════════════════════════════
 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";
-// Utilities
-export { snapshotCache } from "./cache";
-// Fonts - Loading and registration
+// ═══════════════════════════════════════════════════════════════════════════
+// CACHE - v2 with LRU + Fast Hash
+// ═══════════════════════════════════════════════════════════════════════════
+export { configureSnapshotCache, fastHash, fnv1a, getSnapshotCache, hashObject, LRUCache, snapshotCache, } from "./cache/index";
+// ═══════════════════════════════════════════════════════════════════════════
+// FONTS - Loading and registration
+// ═══════════════════════════════════════════════════════════════════════════
 export { fontRegistry } from "./font-registry";
 export { createFont, loadFont, loadFontFromUrl, loadInterFont, loadInterFromUrl, } from "./fonts";
-// Rendering - SVG and PNG generation
+// ═══════════════════════════════════════════════════════════════════════════
+// RENDERING - SVG and PNG generation
+// ═══════════════════════════════════════════════════════════════════════════
 export { ogx, ogxToSVG } from "./ogx";
-// Presets - Ready-to-use templates
+// ═══════════════════════════════════════════════════════════════════════════
+// PERFORMANCE - Timing API
+// ═══════════════════════════════════════════════════════════════════════════
+export { benchmark, benchmarkSync, quickTime, quickTimeSync, Timer, timing, } from "./perf";
+// ═══════════════════════════════════════════════════════════════════════════
+// PRESETS - Ready-to-use templates
+// ═══════════════════════════════════════════════════════════════════════════
 export { blogPreset, docsPreset, minimalPreset, presets, socialPreset, } from "./presets";
 export { render } from "./render-png";
 export { renderToSVG } from "./render-svg";
-export { parseTailwind } from "./tailwind";
-// Platform - Target dimensions
+// ═══════════════════════════════════════════════════════════════════════════
+// TAILWIND - Parser v2 with O(1) lookups
+// ═══════════════════════════════════════════════════════════════════════════
+export { clearAllCaches, getCacheStats, isStaticClass, parseTailwind, parseTailwindBatch, STATIC_CLASSES, } from "./tailwind";
+// ═══════════════════════════════════════════════════════════════════════════
+// PLATFORM - Target dimensions
+// ═══════════════════════════════════════════════════════════════════════════
 export { getPlatformDimensions } from "./targets";
+// ═══════════════════════════════════════════════════════════════════════════
+// UTILITIES
+// ═══════════════════════════════════════════════════════════════════════════
 export { loadAsset, toDataUri } from "./utils/assets";
 export { calculateFittingFontSize } from "./utils/text";

package/dist/ogx.js

@@ -25,7 +25,7 @@ export async function ogx(config) {
     if (!presetFn) {
         throw new Error(`Unknown preset: ${preset}`);
     }
-    const element = presetFn({ ...props, slots });
+    const element = presetFn({ ...props, slots, colorScheme });
     // Resolve fonts (Registry > Explicit > Default Inter)
     let resolvedFonts = fonts ?? [];
     if (resolvedFonts.length === 0) {
@@ -74,7 +74,7 @@ export async function ogxToSVG(config) {
     if (!presetFn) {
         throw new Error(`Unknown preset: ${preset}`);
     }
-    const element = presetFn({ ...props, slots });
+    const element = presetFn({ ...props, slots, colorScheme });
     // Resolve fonts
     let resolvedFonts = fonts ?? [];
     if (resolvedFonts.length === 0) {

package/dist/perf/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @ogxjs/core - Performance Module
+ * Timing and profiling utilities
+ *
+ * @version 0.2.0 "Turbo"
+ */
+export { benchmark, benchmarkSync, quickTime, quickTimeSync, Timer, type TimingAggregate, type TimingEntry, type TimingReport, timing, } from "./timing";
+//# sourceMappingURL=index.d.ts.map

package/dist/perf/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/perf/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACN,SAAS,EACT,aAAa,EACb,SAAS,EACT,aAAa,EACb,KAAK,EACL,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,MAAM,GACN,MAAM,UAAU,CAAC"}

package/dist/perf/index.js

@@ -0,0 +1,7 @@
+/**
+ * @ogxjs/core - Performance Module
+ * Timing and profiling utilities
+ *
+ * @version 0.2.0 "Turbo"
+ */
+export { benchmark, benchmarkSync, quickTime, quickTimeSync, Timer, timing, } from "./timing";