@ogxjs/core 0.1.1 → 0.2.0-alpha.1

package/dist/index.d.ts

@@ -1,17 +1,31 @@
-export { absolute, badge, card, div, fluent, footer, grid, h, h1, h2, header, img, imgFromUrl, main, p, row, spacer, span, stack, svgFromContent, validateImageUrl, } from "./builder";
-export { snapshotCache } from "./cache";
+/**
+ * @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 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,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
-export { absolute, badge, card, div, fluent, footer, grid, h, h1, h2, header, img, imgFromUrl, main, p, row, spacer, span, stack, svgFromContent, validateImageUrl, } from "./builder";
-// Utilities
-export { snapshotCache } from "./cache";
-// Fonts - Loading and registration
+/**
+ * @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";
+// ═══════════════════════════════════════════════════════════════════════════
+// 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";

package/dist/perf/timing.d.ts

@@ -0,0 +1,160 @@
+/**
+ * @ogxjs/core - Performance Timing API
+ * Profiling and performance measurement tools
+ *
+ * @description
+ * Provides timing utilities for measuring OGX performance:
+ * - Timer API for manual measurements
+ * - Automatic instrumentation for render pipeline
+ * - Report generation with statistics
+ *
+ * @version 0.2.0 "Turbo"
+ */
+export interface TimingEntry {
+    label: string;
+    startTime: number;
+    endTime?: number;
+    duration?: number;
+}
+export interface TimingReport {
+    entries: TimingEntry[];
+    totals: Record<string, TimingAggregate>;
+    summary: {
+        totalDuration: number;
+        entryCount: number;
+        averageDuration: number;
+    };
+}
+export interface TimingAggregate {
+    count: number;
+    totalMs: number;
+    minMs: number;
+    maxMs: number;
+    avgMs: number;
+}
+/**
+ * Performance timer for measuring code execution
+ *
+ * @example
+ * ```ts
+ * const timer = new Timer();
+ *
+ * timer.start("render");
+ * await render(element);
+ * timer.end("render");
+ *
+ * timer.start("png-conversion");
+ * const png = convertToPng(svg);
+ * timer.end("png-conversion");
+ *
+ * console.log(timer.getReport());
+ * // { entries: [...], totals: {...}, summary: {...} }
+ * ```
+ */
+export declare class Timer {
+    private entries;
+    private active;
+    private enabled;
+    constructor(enabled?: boolean);
+    /**
+     * Start a timing measurement
+     */
+    start(label: string): void;
+    /**
+     * End a timing measurement
+     * @returns Duration in milliseconds
+     */
+    end(label: string): number;
+    /**
+     * Measure an async operation
+     */
+    measure<T>(label: string, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Measure a sync operation
+     */
+    measureSync<T>(label: string, fn: () => T): T;
+    /**
+     * Get timing report
+     */
+    getReport(): TimingReport;
+    /**
+     * Get formatted report string
+     */
+    getFormattedReport(): string;
+    /**
+     * Clear all entries
+     */
+    clear(): void;
+    /**
+     * Enable/disable timing
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Check if timing is enabled
+     */
+    isEnabled(): boolean;
+}
+/**
+ * Global timing API
+ */
+export declare const timing: {
+    /**
+     * Start a timing measurement
+     */
+    start(label: string): void;
+    /**
+     * End a timing measurement
+     */
+    end(label: string): number;
+    /**
+     * Measure an async operation
+     */
+    measure<T>(label: string, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Measure a sync operation
+     */
+    measureSync<T>(label: string, fn: () => T): T;
+    /**
+     * Get timing report
+     */
+    getReport(): TimingReport;
+    /**
+     * Get formatted report string
+     */
+    getFormattedReport(): string;
+    /**
+     * Clear all timing entries
+     */
+    clear(): void;
+    /**
+     * Enable timing (useful for debugging in production)
+     */
+    enable(): void;
+    /**
+     * Disable timing
+     */
+    disable(): void;
+    /**
+     * Check if timing is enabled
+     */
+    isEnabled(): boolean;
+};
+/**
+ * Quick one-off timing for a function
+ * Returns [result, durationMs]
+ */
+export declare function quickTime<T>(fn: () => Promise<T>): Promise<[T, number]>;
+/**
+ * Quick one-off timing for a sync function
+ */
+export declare function quickTimeSync<T>(fn: () => T): [T, number];
+/**
+ * Benchmark a function multiple times
+ * Returns statistics
+ */
+export declare function benchmark(fn: () => Promise<void>, iterations?: number): Promise<TimingAggregate>;
+/**
+ * Benchmark a sync function
+ */
+export declare function benchmarkSync(fn: () => void, iterations?: number): TimingAggregate;
+//# sourceMappingURL=timing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../src/perf/timing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACxC,OAAO,EAAE;QACR,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC;KACxB,CAAC;CACF;AAED,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACd;AAID;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,KAAK;IACjB,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,OAAO,CAAU;gBAEb,OAAO,UAAO;IAI1B;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAW1B;;;OAGG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAkB1B;;OAEG;IACG,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IASjE;;OAEG;IACH,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAS7C;;OAEG;IACH,SAAS,IAAI,YAAY;IAkDzB;;OAEG;IACH,kBAAkB,IAAI,MAAM;IA2B5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIlC;;OAEG;IACH,SAAS,IAAI,OAAO;CAGpB;AAUD;;GAEG;AACH,eAAO,MAAM,MAAM;IAClB;;OAEG;iBACU,MAAM,GAAG,IAAI;IAI1B;;OAEG;eACQ,MAAM,GAAG,MAAM;IAI1B;;OAEG;YACK,CAAC,SAAS,MAAM,MAAM,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI3D;;OAEG;gBACS,CAAC,SAAS,MAAM,MAAM,MAAM,CAAC,GAAG,CAAC;IAI7C;;OAEG;iBACU,YAAY;IAIzB;;OAEG;0BACmB,MAAM;IAI5B;;OAEG;aACM,IAAI;IAIb;;OAEG;cACO,IAAI;IAId;;OAEG;eACQ,IAAI;IAIf;;OAEG;iBACU,OAAO;CAGpB,CAAC;AAIF;;;GAGG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAK7E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAKzD;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC9B,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACvB,UAAU,SAAM,GACd,OAAO,CAAC,eAAe,CAAC,CAkB1B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC5B,EAAE,EAAE,MAAM,IAAI,EACd,UAAU,SAAM,GACd,eAAe,CAkBjB"}

package/dist/perf/timing.js

@@ -0,0 +1,305 @@
+/**
+ * @ogxjs/core - Performance Timing API
+ * Profiling and performance measurement tools
+ *
+ * @description
+ * Provides timing utilities for measuring OGX performance:
+ * - Timer API for manual measurements
+ * - Automatic instrumentation for render pipeline
+ * - Report generation with statistics
+ *
+ * @version 0.2.0 "Turbo"
+ */
+// TIMING CLASS
+/**
+ * Performance timer for measuring code execution
+ *
+ * @example
+ * ```ts
+ * const timer = new Timer();
+ *
+ * timer.start("render");
+ * await render(element);
+ * timer.end("render");
+ *
+ * timer.start("png-conversion");
+ * const png = convertToPng(svg);
+ * timer.end("png-conversion");
+ *
+ * console.log(timer.getReport());
+ * // { entries: [...], totals: {...}, summary: {...} }
+ * ```
+ */
+export class Timer {
+    entries = [];
+    active = new Map();
+    enabled;
+    constructor(enabled = true) {
+        this.enabled = enabled;
+    }
+    /**
+     * Start a timing measurement
+     */
+    start(label) {
+        if (!this.enabled)
+            return;
+        const entry = {
+            label,
+            startTime: performance.now(),
+        };
+        this.active.set(label, entry);
+    }
+    /**
+     * End a timing measurement
+     * @returns Duration in milliseconds
+     */
+    end(label) {
+        if (!this.enabled)
+            return 0;
+        const entry = this.active.get(label);
+        if (!entry) {
+            console.warn(`Timer: No active timer for "${label}"`);
+            return 0;
+        }
+        entry.endTime = performance.now();
+        entry.duration = entry.endTime - entry.startTime;
+        this.entries.push(entry);
+        this.active.delete(label);
+        return entry.duration;
+    }
+    /**
+     * Measure an async operation
+     */
+    async measure(label, fn) {
+        this.start(label);
+        try {
+            return await fn();
+        }
+        finally {
+            this.end(label);
+        }
+    }
+    /**
+     * Measure a sync operation
+     */
+    measureSync(label, fn) {
+        this.start(label);
+        try {
+            return fn();
+        }
+        finally {
+            this.end(label);
+        }
+    }
+    /**
+     * Get timing report
+     */
+    getReport() {
+        // Aggregate by label
+        const totals = {};
+        for (const entry of this.entries) {
+            if (entry.duration === undefined)
+                continue;
+            if (!totals[entry.label]) {
+                totals[entry.label] = {
+                    count: 0,
+                    totalMs: 0,
+                    minMs: Infinity,
+                    maxMs: -Infinity,
+                    avgMs: 0,
+                };
+            }
+            const agg = totals[entry.label];
+            agg.count++;
+            agg.totalMs += entry.duration;
+            agg.minMs = Math.min(agg.minMs, entry.duration);
+            agg.maxMs = Math.max(agg.maxMs, entry.duration);
+        }
+        // Calculate averages
+        for (const label of Object.keys(totals)) {
+            const agg = totals[label];
+            agg.avgMs = agg.totalMs / agg.count;
+        }
+        // Calculate summary
+        const totalDuration = this.entries.reduce((sum, e) => sum + (e.duration ?? 0), 0);
+        const entryCount = this.entries.filter((e) => e.duration !== undefined).length;
+        return {
+            entries: [...this.entries],
+            totals,
+            summary: {
+                totalDuration,
+                entryCount,
+                averageDuration: entryCount > 0 ? totalDuration / entryCount : 0,
+            },
+        };
+    }
+    /**
+     * Get formatted report string
+     */
+    getFormattedReport() {
+        const report = this.getReport();
+        const lines = [
+            "┌─────────────────────────────────────────────────────┐",
+            "│              OGX Performance Report                 │",
+            "├─────────────────────────────────────────────────────┤",
+        ];
+        // Totals by label
+        for (const [label, agg] of Object.entries(report.totals)) {
+            lines.push(`│ ${label.padEnd(20)} │ ${agg.avgMs.toFixed(2).padStart(8)}ms avg │`);
+            lines.push(`│ ${"".padEnd(20)} │ ${agg.count.toString().padStart(8)} calls │`);
+        }
+        lines.push("├─────────────────────────────────────────────────────┤");
+        lines.push(`│ Total: ${report.summary.totalDuration.toFixed(2)}ms (${report.summary.entryCount} entries) │`);
+        lines.push("└─────────────────────────────────────────────────────┘");
+        return lines.join("\n");
+    }
+    /**
+     * Clear all entries
+     */
+    clear() {
+        this.entries = [];
+        this.active.clear();
+    }
+    /**
+     * Enable/disable timing
+     */
+    setEnabled(enabled) {
+        this.enabled = enabled;
+    }
+    /**
+     * Check if timing is enabled
+     */
+    isEnabled() {
+        return this.enabled;
+    }
+}
+// GLOBAL TIMER
+/**
+ * Global timer instance for OGX operations
+ * Disabled by default in production
+ */
+const globalTimer = new Timer(process.env.NODE_ENV !== "production");
+/**
+ * Global timing API
+ */
+export const timing = {
+    /**
+     * Start a timing measurement
+     */
+    start(label) {
+        globalTimer.start(label);
+    },
+    /**
+     * End a timing measurement
+     */
+    end(label) {
+        return globalTimer.end(label);
+    },
+    /**
+     * Measure an async operation
+     */
+    measure(label, fn) {
+        return globalTimer.measure(label, fn);
+    },
+    /**
+     * Measure a sync operation
+     */
+    measureSync(label, fn) {
+        return globalTimer.measureSync(label, fn);
+    },
+    /**
+     * Get timing report
+     */
+    getReport() {
+        return globalTimer.getReport();
+    },
+    /**
+     * Get formatted report string
+     */
+    getFormattedReport() {
+        return globalTimer.getFormattedReport();
+    },
+    /**
+     * Clear all timing entries
+     */
+    clear() {
+        globalTimer.clear();
+    },
+    /**
+     * Enable timing (useful for debugging in production)
+     */
+    enable() {
+        globalTimer.setEnabled(true);
+    },
+    /**
+     * Disable timing
+     */
+    disable() {
+        globalTimer.setEnabled(false);
+    },
+    /**
+     * Check if timing is enabled
+     */
+    isEnabled() {
+        return globalTimer.isEnabled();
+    },
+};
+// QUICK TIMING UTILITIES
+/**
+ * Quick one-off timing for a function
+ * Returns [result, durationMs]
+ */
+export async function quickTime(fn) {
+    const start = performance.now();
+    const result = await fn();
+    const duration = performance.now() - start;
+    return [result, duration];
+}
+/**
+ * Quick one-off timing for a sync function
+ */
+export function quickTimeSync(fn) {
+    const start = performance.now();
+    const result = fn();
+    const duration = performance.now() - start;
+    return [result, duration];
+}
+/**
+ * Benchmark a function multiple times
+ * Returns statistics
+ */
+export async function benchmark(fn, iterations = 100) {
+    const durations = [];
+    for (let i = 0; i < iterations; i++) {
+        const start = performance.now();
+        await fn();
+        durations.push(performance.now() - start);
+    }
+    const totalMs = durations.reduce((sum, d) => sum + d, 0);
+    return {
+        count: iterations,
+        totalMs,
+        minMs: Math.min(...durations),
+        maxMs: Math.max(...durations),
+        avgMs: totalMs / iterations,
+    };
+}
+/**
+ * Benchmark a sync function
+ */
+export function benchmarkSync(fn, iterations = 100) {
+    const durations = [];
+    for (let i = 0; i < iterations; i++) {
+        const start = performance.now();
+        fn();
+        durations.push(performance.now() - start);
+    }
+    const totalMs = durations.reduce((sum, d) => sum + d, 0);
+    return {
+        count: iterations,
+        totalMs,
+        minMs: Math.min(...durations),
+        maxMs: Math.max(...durations),
+        avgMs: totalMs / iterations,
+    };
+}

package/dist/presets/blog.js

@@ -60,7 +60,7 @@ export const blogPreset = (props) => {
                         span([
                             "text-lg",
                             "font-medium",
-                            isDark ? "text-zinc-400" : "text-zinc-500",
+                            isDark ? "text-zinc-400" : "text-zinc-600",
                         ], [date, readingTime].filter(Boolean).join(" · ")),
                     ]),
                 ]),

package/dist/presets/docs.d.ts

@@ -15,6 +15,8 @@ export interface DocsPresetProps {
         header?: OGXElement;
         footer?: OGXElement;
     };
+    /** Details Image */
+    detailsOG?: boolean;
 }
 /**
  * Docs preset - ideal for documentation sites

package/dist/presets/docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/presets/docs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC/B,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,4BAA4B;IAC5B,KAAK,CAAC,EAAE;QACP,MAAM,CAAC,EAAE,UAAU,CAAC;QACpB,MAAM,CAAC,EAAE,UAAU,CAAC;KACpB,CAAC;CACF;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,eAAe,CAuH9C,CAAC"}
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/presets/docs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC/B,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,4BAA4B;IAC5B,KAAK,CAAC,EAAE;QACP,MAAM,CAAC,EAAE,UAAU,CAAC;QACpB,MAAM,CAAC,EAAE,UAAU,CAAC;KACpB,CAAC;IACF,oBAAoB;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,eAAe,CA2H9C,CAAC"}