@ogxjs/core 0.1.1 → 0.2.0-alpha.1

package/dist/tailwind/parser-v2.js

@@ -0,0 +1,250 @@
+/**
+ * @ogxjs/core - Tailwind Parser v2 "Turbo"
+ * High-performance Tailwind CSS parser with O(1) lookups
+ *
+ * @description
+ * Complete rewrite of the parser for maximum performance:
+ * - O(1) static class lookup via Map
+ * - Efficient prefix matching via ordered prefix list
+ * - Multi-level caching (class + string level)
+ * - Minimal allocations
+ *
+ * @performance
+ * v0.1.x: ~5ms for 100 classes (O(n) if/else chain)
+ * v0.2.0: ~0.5ms for 100 classes (O(1) lookups + cache)
+ *
+ * @version 0.2.0 "Turbo"
+ */
+import { classCache, stringCache } from "./class-cache";
+import { getStaticClass, isStaticClass } from "./lookup-tables";
+import { findPrefixHandler, handleArbitraryValue, } from "./prefix-handlers";
+// MAIN PARSER
+/**
+ * Parse Tailwind classes to CSS properties
+ *
+ * @param tw - Tailwind class string or array
+ * @param theme - Optional theme config for custom colors
+ * @param colorScheme - Optional color scheme for dark: variants
+ * @returns CSS properties object
+ *
+ * @example
+ * ```ts
+ * parseTailwind("flex bg-blue-500 p-4")
+ * // → { display: "flex", backgroundColor: "#3b82f6", padding: 16 }
+ *
+ * parseTailwind(["flex", "items-center", "gap-4"])
+ * // → { display: "flex", alignItems: "center", gap: 16 }
+ * ```
+ */
+export function parseTailwind(tw, theme, colorScheme) {
+    // Normalize input to array of classes (optimized for common cases)
+    const classes = normalizeClasses(tw);
+    // Early return for empty input
+    if (classes.length === 0) {
+        return { display: "flex" };
+    }
+    // Build cache key (only if no custom theme)
+    // Use colorScheme inline to avoid extra string allocation
+    const cacheKey = theme
+        ? null
+        : colorScheme === "dark"
+            ? `${classes.join(" ")}|dark`
+            : `${classes.join(" ")}|light`;
+    // Check string-level cache first
+    if (cacheKey) {
+        const cached = stringCache.get(cacheKey);
+        if (cached) {
+            // Return a copy to allow mutations by caller
+            return { ...cached };
+        }
+    }
+    // Initialize style object with flex default
+    const style = { display: "flex" };
+    const gradient = {};
+    const isDark = colorScheme === "dark";
+    const hasTheme = theme !== undefined;
+    // Parse context for handlers (reused object)
+    const ctx = {
+        style,
+        gradient,
+        theme,
+        colorScheme,
+    };
+    // Process each class with optimized loop
+    const len = classes.length;
+    for (let i = 0; i < len; i++) {
+        parseClass(classes[i], ctx, isDark, hasTheme);
+    }
+    // Apply gradient if direction is set
+    if (gradient.direction) {
+        applyGradient(style, gradient);
+    }
+    // Cache the result (store copy since we return original)
+    if (cacheKey) {
+        stringCache.set(cacheKey, { ...style });
+    }
+    return style;
+}
+// CLASS PARSING
+/**
+ * Parse a single Tailwind class
+ * @performance Inline checks to avoid function call overhead
+ */
+function parseClass(cls, ctx, isDark, hasTheme) {
+    // Handle dark: variant inline
+    if (cls.charCodeAt(0) === 100 && cls.startsWith("dark:")) {
+        // 'd' = 100
+        if (!isDark)
+            return;
+        cls = cls.slice(5);
+    }
+    // Check class-level cache (only for non-theme classes)
+    if (!hasTheme) {
+        const cached = classCache.get(cls);
+        if (cached) {
+            Object.assign(ctx.style, cached);
+            return;
+        }
+    }
+    // Try static lookup first (O(1))
+    if (isStaticClass(cls)) {
+        const props = getStaticClass(cls);
+        Object.assign(ctx.style, props);
+        // Cache for future use (static classes are immutable)
+        if (!hasTheme) {
+            classCache.set(cls, props);
+        }
+        return;
+    }
+    // Check for arbitrary values: p-[32px], bg-[#ff0000]
+    // Optimized: check for '[' before regex
+    if (cls.includes("[")) {
+        const bracketIdx = cls.indexOf("[");
+        if (bracketIdx > 1 && cls.charCodeAt(bracketIdx - 1) === 45) {
+            // '-' = 45
+            const prefix = cls.slice(0, bracketIdx - 1);
+            const value = cls.slice(bracketIdx + 1, -1);
+            handleArbitraryValue(prefix, value, ctx);
+            return;
+        }
+    }
+    // Try prefix handlers
+    const prefixMatch = findPrefixHandler(cls);
+    if (prefixMatch) {
+        const [handler, value] = prefixMatch;
+        // If no theme, we want to cache the result
+        // Create temporary style object to capture just this class's effect
+        if (!hasTheme) {
+            const tempStyle = {};
+            const tempCtx = {
+                style: tempStyle,
+                gradient: ctx.gradient,
+                theme: ctx.theme,
+                colorScheme: ctx.colorScheme,
+            };
+            handler(value, tempCtx);
+            // Apply to main style and cache
+            Object.assign(ctx.style, tempStyle);
+            // Only cache if something was set
+            const keys = Object.keys(tempStyle);
+            if (keys.length > 0) {
+                classCache.set(cls, tempStyle);
+            }
+        }
+        else {
+            // With theme, apply directly (no caching)
+            handler(value, ctx);
+        }
+        return;
+    }
+    // Unknown class - ignore silently in production
+    if (process.env.NODE_ENV !== "production") {
+        // Only warn for classes that look like Tailwind (have a hyphen)
+        if (cls.includes("-")) {
+            console.debug?.(`OGX: Unknown Tailwind class "${cls}"`);
+        }
+    }
+}
+// HELPERS
+/**
+ * Normalize input to flat array of class strings
+ * @performance Optimized for common cases with minimal allocations
+ */
+function normalizeClasses(tw) {
+    // Fast path: single string (most common case)
+    if (typeof tw === "string") {
+        // Check if it contains spaces
+        if (!tw.includes(" ")) {
+            return tw.length > 0 ? [tw] : [];
+        }
+        // Split on whitespace
+        const result = [];
+        let start = 0;
+        let inWhitespace = true;
+        for (let i = 0; i <= tw.length; i++) {
+            const isSpace = i === tw.length || tw.charCodeAt(i) <= 32;
+            if (isSpace && !inWhitespace) {
+                result.push(tw.slice(start, i));
+                inWhitespace = true;
+            }
+            else if (!isSpace && inWhitespace) {
+                start = i;
+                inWhitespace = false;
+            }
+        }
+        return result;
+    }
+    // Array path: flatten and split
+    const result = [];
+    const len = tw.length;
+    for (let i = 0; i < len; i++) {
+        const t = tw[i];
+        if (typeof t === "string" && t.length > 0) {
+            if (!t.includes(" ")) {
+                result.push(t);
+            }
+            else {
+                // Split this string and add each part
+                const parts = t.split(/\s+/);
+                for (let j = 0; j < parts.length; j++) {
+                    if (parts[j].length > 0) {
+                        result.push(parts[j]);
+                    }
+                }
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Apply gradient to style object
+ */
+function applyGradient(style, gradient) {
+    const from = gradient.from || "transparent";
+    const to = gradient.to || "transparent";
+    if (gradient.via) {
+        style.backgroundImage = `linear-gradient(${gradient.direction}, ${from}, ${gradient.via}, ${to})`;
+    }
+    else {
+        style.backgroundImage = `linear-gradient(${gradient.direction}, ${from}, ${to})`;
+    }
+}
+// BATCH PARSING
+/**
+ * Parse multiple class strings in batch
+ * More efficient than calling parseTailwind multiple times
+ *
+ * @param items - Array of class strings
+ * @param theme - Optional theme config
+ * @param colorScheme - Optional color scheme
+ * @returns Array of CSS properties in same order
+ */
+export function parseTailwindBatch(items, theme, colorScheme) {
+    return items.map((tw) => parseTailwind(tw, theme, colorScheme));
+}
+// RE-EXPORTS
+export { clearAllCaches, getCacheStats } from "./class-cache";
+export { colors } from "./colors";
+export { getStaticClass, isStaticClass, STATIC_CLASSES } from "./lookup-tables";
+export { ORDERED_PREFIXES, PREFIX_HANDLERS, parseSpacingValue, resolveColorValue, } from "./prefix-handlers";
+export { borderRadius, fontSize, fontWeight, opacity, spacing } from "./scales";

package/dist/tailwind/parser.d.ts

@@ -8,6 +8,7 @@ export interface GradientState {
 }
 /**
  * Main Tailwind parser function
+ * @deprecated Use parseTailwind from parser-v2 instead (exported from tailwind/index)
  */
 export declare function parseTailwind(tw: string | string[], theme?: ThemeConfig, colorScheme?: "light" | "dark"): CSSProperties;
 export { colors } from "./colors";

package/dist/tailwind/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/tailwind/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAY5C,MAAM,WAAW,aAAa;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAID;;GAEG;AACH,wBAAgB,aAAa,CAC5B,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,EACrB,KAAK,CAAC,EAAE,WAAW,EACnB,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,GAC5B,aAAa,CAwCf;AAyhCD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/tailwind/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAY5C,MAAM,WAAW,aAAa;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAID;;;GAGG;AACH,wBAAgB,aAAa,CAC5B,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,EACrB,KAAK,CAAC,EAAE,WAAW,EACnB,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,GAC5B,aAAa,CAwCf;AAyhCD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC"}

package/dist/tailwind/parser.js

@@ -4,6 +4,7 @@ import { borderRadius, boxShadow, fontSize, fontWeight, opacity, spacing, } from
 const parserCache = new Map();
 /**
  * Main Tailwind parser function
+ * @deprecated Use parseTailwind from parser-v2 instead (exported from tailwind/index)
  */
 export function parseTailwind(tw, theme, colorScheme) {
     const style = { display: "flex" };

package/dist/tailwind/prefix-handlers.d.ts

@@ -0,0 +1,68 @@
+/**
+ * @ogxjs/core - Tailwind Prefix Handlers
+ * Modular handlers for dynamic Tailwind classes with prefixes
+ *
+ * @description
+ * Instead of a giant if/else chain, we use a Map of prefix -> handler.
+ * This allows O(1) prefix lookup + targeted parsing.
+ *
+ * @performance
+ * - Before: O(n) linear scan through all if/else conditions
+ * - After: O(1) prefix lookup + O(1) value parsing
+ *
+ * @version 0.2.0 "Turbo"
+ */
+import type { CSSProperties } from "../css";
+import type { ThemeConfig } from "../types";
+export interface GradientState {
+    from?: string;
+    via?: string;
+    to?: string;
+    direction?: string;
+}
+export interface ParseContext {
+    style: CSSProperties;
+    gradient: GradientState;
+    theme?: ThemeConfig;
+    colorScheme?: "light" | "dark";
+}
+/**
+ * Handler function type for prefix-based classes
+ * @param value - The value after the prefix (e.g., "4" from "p-4")
+ * @param ctx - Parse context with style object and gradient state
+ */
+export type PrefixHandler = (value: string, ctx: ParseContext) => void;
+/**
+ * Parse a spacing value from Tailwind scale or fraction
+ */
+export declare function parseSpacingValue(value: string): number | string | undefined;
+/**
+ * Resolve a color value from theme or palette with opacity support
+ */
+export declare function resolveColorValue(name: string, theme?: ThemeConfig): string | undefined;
+/**
+ * Parse arbitrary value from brackets [value]
+ */
+export declare function parseArbitraryValue(value: string): string | number;
+/**
+ * Map of prefix -> handler function
+ * Order matters for prefixes that share common starts (e.g., "px-" before "p-")
+ */
+export declare const PREFIX_HANDLERS: ReadonlyMap<string, PrefixHandler>;
+/**
+ * Handle arbitrary values like p-[32px], bg-[#ff0000]
+ */
+export declare function handleArbitraryValue(prefix: string, value: string, ctx: ParseContext): void;
+/**
+ * Ordered list of prefixes for matching (longest first to avoid false matches)
+ */
+export declare const ORDERED_PREFIXES: readonly string[];
+/**
+ * Find matching prefix handler for a class
+ * @performance O(k) where k = prefixes starting with same char (usually 2-4)
+ *
+ * @param cls - Tailwind class name
+ * @returns [handler, value] tuple or undefined
+ */
+export declare function findPrefixHandler(cls: string): [PrefixHandler, string] | undefined;
+//# sourceMappingURL=prefix-handlers.d.ts.map

package/dist/tailwind/prefix-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefix-handlers.d.ts","sourceRoot":"","sources":["../../src/tailwind/prefix-handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAO5C,MAAM,WAAW,aAAa;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,KAAK,IAAI,CAAC;AAIvE;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAuB5E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,WAAW,GACjB,MAAM,GAAG,SAAS,CA6BpB;AASD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CA6BlE;AAID;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CA6e7D,CAAC;AA2EH;;GAEG;AACH,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,YAAY,GACf,IAAI,CAkKN;AAID;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAiD7C,CAAC;AA0BF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAChC,GAAG,EAAE,MAAM,GACT,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,SAAS,CAoBrC"}