windrunner 1.1.2 → 1.1.3

package/dist/index.js

@@ -20,9 +20,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   compileClass: () => compileClass,
+  compileCriticalCss: () => compileCriticalCss,
   createWindrunner: () => createWindrunner,
   defineResponsiveUtilities: () => defineResponsiveUtilities,
   defineUtilities: () => defineUtilities,
+  extractClassNames: () => extractClassNames,
   parseClass: () => parseClass,
   plugin: () => plugin,
   windrunner: () => windrunner
@@ -1385,29 +1387,70 @@ var config_default = configOptions;
 function isFunction(fn) {
   return fn && {}.toString.call(fn) === "[object Function]";
 }
+var configCache = /* @__PURE__ */ new WeakMap();
+var defaultContextCache = null;
+function createLazyTheme(userTheme = {}, userThemeExtend = {}) {
+  const resolved = /* @__PURE__ */ new Map();
+  const defaultTheme = config_default.theme;
+  return new Proxy({}, {
+    get(_, key) {
+      if (resolved.has(key)) {
+        return resolved.get(key);
+      }
+      let value = Object.prototype.hasOwnProperty.call(userTheme, key) ? userTheme[key] : defaultTheme[key];
+      if (isFunction(value)) {
+        value = value({
+          theme: (keyRef) => {
+            if (resolved.has(keyRef)) return resolved.get(keyRef);
+            return createLazyTheme(userTheme, userThemeExtend)[keyRef];
+          }
+        });
+      }
+      if (userThemeExtend[key]) {
+        value = Object.assign({}, value, userThemeExtend[key]);
+      }
+      resolved.set(key, value);
+      return value;
+    },
+    has(_, key) {
+      return key in defaultTheme || key in userTheme;
+    },
+    ownKeys(_) {
+      return [.../* @__PURE__ */ new Set([...Object.keys(defaultTheme), ...Object.keys(userTheme)])];
+    },
+    getOwnPropertyDescriptor(_, key) {
+      if (key in defaultTheme || key in userTheme) {
+        return {
+          enumerable: true,
+          configurable: true
+        };
+      }
+    }
+  });
+}
 function getConfigOptions(options = {}, pluginKeys = []) {
+  if (!options || typeof options === "object" && Object.keys(options).length === 0) {
+    if (!defaultContextCache) {
+      defaultContextCache = {
+        ...config_default,
+        theme: createLazyTheme({}, {})
+      };
+    }
+    return defaultContextCache;
+  }
+  if (configCache.has(options)) {
+    return configCache.get(options);
+  }
   const { theme: theme2 = {} } = options;
   const { extend: themeExtend = {} } = theme2;
-  const newTheme = {};
-  const themeKeys = Object.keys(config_default.theme);
-  themeKeys.forEach((key) => {
-    newTheme[key] = Object.prototype.hasOwnProperty.call(theme2, key) ? theme2[key] : config_default.theme[key];
-  });
-  themeKeys.forEach((key) => {
-    if (isFunction(newTheme[key])) {
-      newTheme[key] = newTheme[key]({
-        theme: (keyRef) => newTheme[keyRef]
-      });
-    }
-    if (themeExtend[key]) {
-      newTheme[key] = Object.assign({}, newTheme[key], themeExtend[key]);
-    }
-  });
-  return {
+  const lazyTheme = createLazyTheme(theme2, themeExtend);
+  const config = {
     ...config_default,
     ...options,
-    theme: newTheme
+    theme: lazyTheme
   };
+  configCache.set(options, config);
+  return config;
 }
 
 // src/constants.js
@@ -1491,112 +1534,93 @@ function escapeCssIdentifier(value) {
 }
 function appendImportant(declaration, isImportant) {
   if (!isImportant) return declaration;
-  const entries = declaration.split(";").map((item) => item.trim()).filter(Boolean).map((item) => item.includes("!important") ? item : `${item} !important`);
-  return `${entries.join("; ")};`;
+  return declaration.replace(/([^;{}]+);/g, (match, decl) => {
+    const trimmed = decl.trim();
+    if (!trimmed || trimmed.includes("!important")) return match;
+    return `${trimmed} !important;`;
+  });
 }
 function splitByVariantDelimiter(token) {
   const parts = [];
-  let current = "";
+  let start = 0;
   let bracketDepth = 0;
   for (let i = 0; i < token.length; i += 1) {
     const char = token[i];
-    if (char === "[") bracketDepth += 1;
-    if (char === "]") bracketDepth = Math.max(0, bracketDepth - 1);
-    if (char === ":" && bracketDepth === 0) {
-      parts.push(current);
-      current = "";
-    } else {
-      current += char;
+    if (char === "[") {
+      bracketDepth += 1;
+    } else if (char === "]") {
+      bracketDepth = Math.max(0, bracketDepth - 1);
+    } else if (char === ":" && bracketDepth === 0) {
+      parts.push(token.slice(start, i));
+      start = i + 1;
     }
   }
-  if (current) parts.push(current);
+  parts.push(token.slice(start));
   return parts;
 }
 
 // src/maps/layout.maps.js
+function createSimpleMap(prop, values, keyMap = {}) {
+  const map = {};
+  values.forEach((value) => {
+    const key = keyMap[value] || value;
+    map[key] = `${prop}: ${value};`;
+  });
+  return map;
+}
 var DISPLAY_MAP = {
-  block: "display: block;",
-  inline: "display: inline;",
-  "inline-block": "display: inline-block;",
-  flex: "display: flex;",
-  "inline-flex": "display: inline-flex;",
-  grid: "display: grid;",
-  "inline-grid": "display: inline-grid;",
-  hidden: "display: none;",
-  contents: "display: contents;",
-  "flow-root": "display: flow-root;",
-  "list-item": "display: list-item;",
-  table: "display: table;",
-  "inline-table": "display: inline-table;",
-  "table-caption": "display: table-caption;",
-  "table-cell": "display: table-cell;",
-  "table-column": "display: table-column;",
-  "table-column-group": "display: table-column-group;",
-  "table-footer-group": "display: table-footer-group;",
-  "table-header-group": "display: table-header-group;",
-  "table-row-group": "display: table-row-group;",
-  "table-row": "display: table-row;"
-};
-var POSITION_MAP = {
-  static: "position: static;",
-  fixed: "position: fixed;",
-  absolute: "position: absolute;",
-  relative: "position: relative;",
-  sticky: "position: sticky;"
+  ...createSimpleMap("display", [
+    "block",
+    "inline",
+    "inline-block",
+    "flex",
+    "inline-flex",
+    "grid",
+    "inline-grid",
+    "contents",
+    "flow-root",
+    "list-item",
+    "table",
+    "inline-table",
+    "table-caption",
+    "table-cell",
+    "table-column",
+    "table-column-group",
+    "table-footer-group",
+    "table-header-group",
+    "table-row-group",
+    "table-row"
+  ]),
+  hidden: "display: none;"
+  // Special case
 };
+var POSITION_MAP = createSimpleMap("position", [
+  "static",
+  "fixed",
+  "absolute",
+  "relative",
+  "sticky"
+]);
 var VISIBILITY_MAP = {
-  visible: "visibility: visible;",
-  invisible: "visibility: hidden;",
-  collapse: "visibility: collapse;"
-};
-var OVERFLOW_MAP = {
-  auto: "overflow: auto;",
-  hidden: "overflow: hidden;",
-  clip: "overflow: clip;",
-  visible: "overflow: visible;",
-  scroll: "overflow: scroll;"
-};
-var OVERFLOW_X_MAP = {
-  auto: "overflow-x: auto;",
-  hidden: "overflow-x: hidden;",
-  clip: "overflow-x: clip;",
-  visible: "overflow-x: visible;",
-  scroll: "overflow-x: scroll;"
-};
-var OVERFLOW_Y_MAP = {
-  auto: "overflow-y: auto;",
-  hidden: "overflow-y: hidden;",
-  clip: "overflow-y: clip;",
-  visible: "overflow-y: visible;",
-  scroll: "overflow-y: scroll;"
-};
-var OVERSCROLL_MAP = {
-  auto: "overscroll-behavior: auto;",
-  contain: "overscroll-behavior: contain;",
-  none: "overscroll-behavior: none;"
-};
-var OVERSCROLL_X_MAP = {
-  auto: "overscroll-behavior-x: auto;",
-  contain: "overscroll-behavior-x: contain;",
-  none: "overscroll-behavior-x: none;"
-};
-var OVERSCROLL_Y_MAP = {
-  auto: "overscroll-behavior-y: auto;",
-  contain: "overscroll-behavior-y: contain;",
-  none: "overscroll-behavior-y: none;"
+  ...createSimpleMap("visibility", ["visible", "collapse"]),
+  invisible: "visibility: hidden;"
+  // Key differs from value
 };
+var OVERFLOW_VALUES = ["auto", "hidden", "clip", "visible", "scroll"];
+var OVERFLOW_MAP = createSimpleMap("overflow", OVERFLOW_VALUES);
+var OVERFLOW_X_MAP = createSimpleMap("overflow-x", OVERFLOW_VALUES);
+var OVERFLOW_Y_MAP = createSimpleMap("overflow-y", OVERFLOW_VALUES);
+var OVERSCROLL_VALUES = ["auto", "contain", "none"];
+var OVERSCROLL_MAP = createSimpleMap("overscroll-behavior", OVERSCROLL_VALUES);
+var OVERSCROLL_X_MAP = createSimpleMap("overscroll-behavior-x", OVERSCROLL_VALUES);
+var OVERSCROLL_Y_MAP = createSimpleMap("overscroll-behavior-y", OVERSCROLL_VALUES);
 var FLOAT_MAP = {
-  left: "float: left;",
-  right: "float: right;",
-  none: "float: none;",
+  ...createSimpleMap("float", ["left", "right", "none"]),
   start: "float: inline-start;",
   end: "float: inline-end;"
 };
 var CLEAR_MAP = {
-  left: "clear: left;",
-  right: "clear: right;",
-  both: "clear: both;",
-  none: "clear: none;",
+  ...createSimpleMap("clear", ["left", "right", "both", "none"]),
   start: "clear: inline-start;",
   end: "clear: inline-end;"
 };
@@ -1604,13 +1628,13 @@ var ISOLATION_MAP = {
   isolate: "isolation: isolate;",
   "isolation-auto": "isolation: auto;"
 };
-var OBJECT_FIT_MAP = {
-  contain: "object-fit: contain;",
-  cover: "object-fit: cover;",
-  fill: "object-fit: fill;",
-  none: "object-fit: none;",
-  "scale-down": "object-fit: scale-down;"
-};
+var OBJECT_FIT_MAP = createSimpleMap("object-fit", [
+  "contain",
+  "cover",
+  "fill",
+  "none",
+  "scale-down"
+]);
 var TRANSFORM_STYLE_MAP = {
   "transform-style-flat": "transform-style: flat;",
   "transform-style-3d": "transform-style: preserve-3d;",
@@ -1628,81 +1652,64 @@ var BOX_SIZING_MAP = {
   border: "box-sizing: border-box;",
   content: "box-sizing: content-box;"
 };
+var BREAK_AFTER_BEFORE_VALUES = [
+  "auto",
+  "avoid",
+  "avoid-page",
+  "avoid-column",
+  "page",
+  "left",
+  "right",
+  "recto",
+  "verso"
+];
 var BREAK_AFTER_MAP = {
-  auto: "break-after: auto;",
-  avoid: "break-after: avoid;",
-  "avoid-page": "break-after: avoid-page;",
-  "avoid-column": "break-after: avoid-column;",
-  page: "break-after: page;",
-  all: "break-after: all;",
-  left: "break-after: left;",
-  right: "break-after: right;",
-  recto: "break-after: recto;",
-  verso: "break-after: verso;"
-};
-var BREAK_BEFORE_MAP = {
-  auto: "break-before: auto;",
-  avoid: "break-before: avoid;",
-  "avoid-page": "break-before: avoid-page;",
-  "avoid-column": "break-before: avoid-column;",
-  page: "break-before: page;",
-  left: "break-before: left;",
-  right: "break-before: right;",
-  recto: "break-before: recto;",
-  verso: "break-before: verso;"
-};
-var BREAK_INSIDE_MAP = {
-  auto: "break-inside: auto;",
-  avoid: "break-inside: avoid;",
-  "avoid-page": "break-inside: avoid-page;",
-  "avoid-column": "break-inside: avoid-column;"
-};
-var BOX_DECORATION_BREAK_MAP = {
-  slice: "box-decoration-break: slice;",
-  clone: "box-decoration-break: clone;"
-};
-var HYPHENS_MAP = {
-  none: "hyphens: none;",
-  manual: "hyphens: manual;",
-  auto: "hyphens: auto;"
-};
-var COLOR_SCHEME_MAP = {
-  light: "color-scheme: light;",
-  dark: "color-scheme: dark;",
-  normal: "color-scheme: normal;"
-};
-var SCROLLBAR_COLOR_MAP = {
-  auto: "scrollbar-color: auto;",
-  transparent: "scrollbar-color: transparent;",
-  current: "scrollbar-color: currentColor;"
-};
-var SCROLLBAR_WIDTH_MAP = {
-  auto: "scrollbar-width: auto;",
-  thin: "scrollbar-width: thin;",
-  none: "scrollbar-width: none;"
+  ...createSimpleMap("break-after", BREAK_AFTER_BEFORE_VALUES),
+  all: "break-after: all;"
 };
+var BREAK_BEFORE_MAP = createSimpleMap("break-before", BREAK_AFTER_BEFORE_VALUES);
+var BREAK_INSIDE_MAP = createSimpleMap("break-inside", [
+  "auto",
+  "avoid",
+  "avoid-page",
+  "avoid-column"
+]);
+var BOX_DECORATION_BREAK_MAP = createSimpleMap("box-decoration-break", [
+  "slice",
+  "clone"
+]);
+var HYPHENS_MAP = createSimpleMap("hyphens", ["none", "manual", "auto"]);
+var COLOR_SCHEME_MAP = createSimpleMap("color-scheme", [
+  "light",
+  "dark",
+  "normal"
+]);
+var SCROLLBAR_COLOR_MAP = createSimpleMap("scrollbar-color", [
+  "auto",
+  "transparent",
+  "current"
+]);
+var SCROLLBAR_WIDTH_MAP = createSimpleMap("scrollbar-width", [
+  "auto",
+  "thin",
+  "none"
+]);
 var SCROLLBAR_GUTTER_MAP = {
   auto: "scrollbar-gutter: auto;",
   stable: "scrollbar-gutter: stable;",
   "stable-both-edges": "scrollbar-gutter: stable both-edges;",
   "both-edges": "scrollbar-gutter: both-edges;"
 };
-var TABLE_LAYOUT_MAP = {
-  auto: "table-layout: auto;",
-  fixed: "table-layout: fixed;"
-};
-var CAPTION_SIDE_MAP = {
-  top: "caption-side: top;",
-  bottom: "caption-side: bottom;"
-};
-var BORDER_COLLAPSE_MAP = {
-  collapse: "border-collapse: collapse;",
-  separate: "border-collapse: separate;"
-};
-var SCROLL_BEHAVIOR_MAP = {
-  auto: "scroll-behavior: auto;",
-  smooth: "scroll-behavior: smooth;"
-};
+var TABLE_LAYOUT_MAP = createSimpleMap("table-layout", ["auto", "fixed"]);
+var CAPTION_SIDE_MAP = createSimpleMap("caption-side", ["top", "bottom"]);
+var BORDER_COLLAPSE_MAP = createSimpleMap("border-collapse", [
+  "collapse",
+  "separate"
+]);
+var SCROLL_BEHAVIOR_MAP = createSimpleMap("scroll-behavior", [
+  "auto",
+  "smooth"
+]);
 var SIDE_PROPS = {
   "": [""],
   t: ["-top"],
@@ -1733,71 +1740,69 @@ var ROUNDED_PROPS = {
 };
 
 // src/maps/interactivity.maps.js
-var CURSOR_MAP = {
-  auto: "cursor: auto;",
-  default: "cursor: default;",
-  pointer: "cursor: pointer;",
-  wait: "cursor: wait;",
-  text: "cursor: text;",
-  move: "cursor: move;",
-  help: "cursor: help;",
-  "not-allowed": "cursor: not-allowed;",
-  none: "cursor: none;",
-  "context-menu": "cursor: context-menu;",
-  progress: "cursor: progress;",
-  cell: "cursor: cell;",
-  crosshair: "cursor: crosshair;",
-  "vertical-text": "cursor: vertical-text;",
-  alias: "cursor: alias;",
-  copy: "cursor: copy;",
-  "no-drop": "cursor: no-drop;",
-  grab: "cursor: grab;",
-  grabbing: "cursor: grabbing;",
-  "all-scroll": "cursor: all-scroll;",
-  "zoom-in": "cursor: zoom-in;",
-  "zoom-out": "cursor: zoom-out;"
-};
-var POINTER_EVENTS_MAP = {
-  none: "pointer-events: none;",
-  auto: "pointer-events: auto;"
-};
-var USER_SELECT_MAP = {
-  none: "user-select: none;",
-  text: "user-select: text;",
-  all: "user-select: all;",
-  auto: "user-select: auto;"
-};
-var APPEARANCE_MAP = {
-  none: "appearance: none;",
-  auto: "appearance: auto;"
-};
-var TOUCH_ACTION_MAP = {
-  auto: "touch-action: auto;",
-  none: "touch-action: none;",
-  "pan-x": "touch-action: pan-x;",
-  "pan-left": "touch-action: pan-left;",
-  "pan-right": "touch-action: pan-right;",
-  "pan-y": "touch-action: pan-y;",
-  "pan-up": "touch-action: pan-up;",
-  "pan-down": "touch-action: pan-down;",
-  "pinch-zoom": "touch-action: pinch-zoom;",
-  manipulation: "touch-action: manipulation;"
-};
+function createSimpleMap2(prop, values) {
+  const map = {};
+  values.forEach((value) => {
+    map[value] = `${prop}: ${value};`;
+  });
+  return map;
+}
+var CURSOR_MAP = createSimpleMap2("cursor", [
+  "auto",
+  "default",
+  "pointer",
+  "wait",
+  "text",
+  "move",
+  "help",
+  "not-allowed",
+  "none",
+  "context-menu",
+  "progress",
+  "cell",
+  "crosshair",
+  "vertical-text",
+  "alias",
+  "copy",
+  "no-drop",
+  "grab",
+  "grabbing",
+  "all-scroll",
+  "zoom-in",
+  "zoom-out"
+]);
+var POINTER_EVENTS_MAP = createSimpleMap2("pointer-events", ["none", "auto"]);
+var USER_SELECT_MAP = createSimpleMap2("user-select", [
+  "none",
+  "text",
+  "all",
+  "auto"
+]);
+var APPEARANCE_MAP = createSimpleMap2("appearance", ["none", "auto"]);
+var TOUCH_ACTION_MAP = createSimpleMap2("touch-action", [
+  "auto",
+  "none",
+  "pan-x",
+  "pan-left",
+  "pan-right",
+  "pan-y",
+  "pan-up",
+  "pan-down",
+  "pinch-zoom",
+  "manipulation"
+]);
 var OUTLINE_STYLE_MAP = {
   none: "outline: 2px solid transparent; outline-offset: 2px;",
-  solid: "outline-style: solid;",
-  dashed: "outline-style: dashed;",
-  dotted: "outline-style: dotted;",
-  double: "outline-style: double;"
-};
-var BORDER_STYLE_MAP = {
-  solid: "border-style: solid;",
-  dashed: "border-style: dashed;",
-  dotted: "border-style: dotted;",
-  double: "border-style: double;",
-  hidden: "border-style: hidden;",
-  none: "border-style: none;"
+  ...createSimpleMap2("outline-style", ["solid", "dashed", "dotted", "double"])
 };
+var BORDER_STYLE_MAP = createSimpleMap2("border-style", [
+  "solid",
+  "dashed",
+  "dotted",
+  "double",
+  "hidden",
+  "none"
+]);
 var TRANSITION_PROPERTY_MAP = {
   none: "none",
   all: "all",
@@ -3250,7 +3255,8 @@ function buildDivideDeclaration(baseToken, theme2) {
 // src/plugins.js
 var PluginRegistry = class {
   constructor() {
-    this.utilities = /* @__PURE__ */ new Map();
+    this.exactUtilities = /* @__PURE__ */ new Map();
+    this.regexUtilities = [];
     this.variants = /* @__PURE__ */ new Map();
   }
   /**
@@ -3259,7 +3265,11 @@ var PluginRegistry = class {
    * @param {Function|string} handler - Function that returns CSS or CSS string
    */
   addUtility(pattern, handler) {
-    this.utilities.set(pattern, handler);
+    if (pattern instanceof RegExp) {
+      this.regexUtilities.push([pattern, handler]);
+    } else {
+      this.exactUtilities.set(pattern, handler);
+    }
   }
   /**
    * Register multiple utilities at once
@@ -3289,18 +3299,22 @@ var PluginRegistry = class {
   }
   /**
    * Check if a token matches any custom utility pattern
+   * Optimized: O(1) fast path for exact matches, O(n) only for regex patterns
    * @param {string} token - The base token to match
    * @returns {Object|null} - { handler, match } or null
    */
   matchUtility(token) {
-    for (const [pattern, handler] of this.utilities) {
-      if (pattern instanceof RegExp) {
-        const match = pattern.exec(token);
-        if (match) {
-          return { handler, match };
-        }
-      } else if (pattern === token) {
-        return { handler, match: [token] };
+    if (this.exactUtilities.has(token)) {
+      return {
+        handler: this.exactUtilities.get(token),
+        match: [token]
+      };
+    }
+    for (let i = 0; i < this.regexUtilities.length; i += 1) {
+      const [pattern, handler] = this.regexUtilities[i];
+      const match = pattern.exec(token);
+      if (match) {
+        return { handler, match };
       }
     }
     return null;
@@ -3317,7 +3331,10 @@ var PluginRegistry = class {
    * Get all registered utility patterns (for debugging)
    */
   getUtilities() {
-    return Array.from(this.utilities.keys());
+    return [
+      ...Array.from(this.exactUtilities.keys()),
+      ...this.regexUtilities.map(([pattern]) => pattern)
+    ];
   }
   /**
    * Get all registered variant names (for debugging)
@@ -3329,7 +3346,8 @@ var PluginRegistry = class {
    * Clear all registered plugins
    */
   clear() {
-    this.utilities.clear();
+    this.exactUtilities.clear();
+    this.regexUtilities = [];
     this.variants.clear();
   }
 };
@@ -3534,8 +3552,26 @@ function extractPrefix(token) {
   }
   return prefix;
 }
+var UNKNOWN_PREFIX_CACHE = /* @__PURE__ */ new Set();
+var MAX_UNKNOWN_CACHE_SIZE = 500;
 function checkAllBuilders(baseToken, theme2) {
-  return buildLayoutDeclaration(baseToken, theme2) || buildPositionInsetDeclaration(baseToken, theme2) || buildSpacingDeclaration(baseToken, theme2) || buildSpaceBetweenDeclaration(baseToken, theme2) || buildGapDeclaration(baseToken, theme2) || buildDimensionDeclaration(baseToken, theme2) || buildFlexGridDeclaration(baseToken, theme2) || buildBorderDeclaration(baseToken, theme2) || buildBorderRadiusDeclaration(baseToken, theme2) || buildBorderSpacingDeclaration(baseToken, theme2) || buildDivideDeclaration(baseToken, theme2) || buildOpacityDeclaration(baseToken, theme2) || buildShadowDeclaration(baseToken, theme2) || buildInsetShadowDeclaration(baseToken, theme2) || buildInsetRingDeclaration(baseToken, theme2) || buildRingDeclaration(baseToken, theme2) || buildRingOffsetDeclaration(baseToken, theme2) || buildTextShadowDeclaration(baseToken, theme2) || buildTransitionDeclaration(baseToken) || buildTransformDeclaration(baseToken, theme2) || buildFilterDeclaration(baseToken, theme2) || buildBackgroundDeclaration(baseToken, theme2) || buildGradientDeclaration(baseToken, theme2) || buildColorDeclaration(baseToken, theme2) || buildTypographyDeclaration(baseToken, theme2) || buildBlendingDeclaration(baseToken) || buildInteractivityDeclaration(baseToken, theme2) || buildAnimationDeclaration(baseToken) || buildMaskDeclaration(baseToken) || buildContainerQueryDeclaration(baseToken) || buildScrollSnapDeclaration(baseToken) || buildAccessibilityDeclaration(baseToken) || buildZoomDeclaration(baseToken, theme2) || buildForcedColorDeclaration(baseToken);
+  const prefix = extractPrefix(baseToken);
+  if (UNKNOWN_PREFIX_CACHE.has(prefix)) {
+    return void 0;
+  }
+  const result = buildLayoutDeclaration(baseToken, theme2) || buildPositionInsetDeclaration(baseToken, theme2) || buildSpacingDeclaration(baseToken, theme2) || buildSpaceBetweenDeclaration(baseToken, theme2) || buildGapDeclaration(baseToken, theme2) || buildDimensionDeclaration(baseToken, theme2) || buildFlexGridDeclaration(baseToken, theme2) || buildBorderDeclaration(baseToken, theme2) || buildBorderRadiusDeclaration(baseToken, theme2) || buildBorderSpacingDeclaration(baseToken, theme2) || buildDivideDeclaration(baseToken, theme2) || buildOpacityDeclaration(baseToken, theme2) || buildShadowDeclaration(baseToken, theme2) || buildInsetShadowDeclaration(baseToken, theme2) || buildInsetRingDeclaration(baseToken, theme2) || buildRingDeclaration(baseToken, theme2) || buildRingOffsetDeclaration(baseToken, theme2) || buildTextShadowDeclaration(baseToken, theme2) || buildTransitionDeclaration(baseToken) || buildTransformDeclaration(baseToken, theme2) || buildFilterDeclaration(baseToken, theme2) || buildBackgroundDeclaration(baseToken, theme2) || buildGradientDeclaration(baseToken, theme2) || buildColorDeclaration(baseToken, theme2) || buildTypographyDeclaration(baseToken, theme2) || buildBlendingDeclaration(baseToken) || buildInteractivityDeclaration(baseToken, theme2) || buildAnimationDeclaration(baseToken) || buildMaskDeclaration(baseToken) || buildContainerQueryDeclaration(baseToken) || buildScrollSnapDeclaration(baseToken) || buildAccessibilityDeclaration(baseToken) || buildZoomDeclaration(baseToken, theme2) || buildForcedColorDeclaration(baseToken);
+  if (!result && prefix) {
+    if (UNKNOWN_PREFIX_CACHE.size >= MAX_UNKNOWN_CACHE_SIZE) {
+      const toRemove = Math.floor(MAX_UNKNOWN_CACHE_SIZE / 2);
+      const iterator = UNKNOWN_PREFIX_CACHE.values();
+      for (let i = 0; i < toRemove; i += 1) {
+        const value = iterator.next().value;
+        if (value) UNKNOWN_PREFIX_CACHE.delete(value);
+      }
+    }
+    UNKNOWN_PREFIX_CACHE.add(prefix);
+  }
+  return result;
 }
 function compileBaseToken(baseToken, theme2, pluginRegistry) {
   if (pluginRegistry) {
@@ -3779,6 +3815,30 @@ function compileRuntimeClassNameWithContext(className, context) {
 function compileClass(className, options = {}) {
   return compileRuntimeClassNameWithContext(className, resolveRuntimeContext(options));
 }
+function compileCriticalCss(classNames, options = {}) {
+  const classList = typeof classNames === "string" ? classNames.split(/\s+/).filter(Boolean) : Array.isArray(classNames) ? classNames.flatMap(
+    (str) => typeof str === "string" ? str.split(/\s+/).filter(Boolean) : []
+  ) : [];
+  const context = resolveRuntimeContext(options);
+  const cssRules = /* @__PURE__ */ new Set();
+  classList.forEach((className) => {
+    const css = compileRuntimeClassNameWithContext(className, context);
+    if (css) {
+      cssRules.add(css);
+    }
+  });
+  return Array.from(cssRules).join("\n");
+}
+function extractClassNames(html) {
+  const classSet = /* @__PURE__ */ new Set();
+  const classRegex = /class(?:Name)?=["']([^"']+)["']/g;
+  let match;
+  while ((match = classRegex.exec(html)) !== null) {
+    const classes = match[1].split(/\s+/).filter(Boolean);
+    classes.forEach((cls) => classSet.add(cls));
+  }
+  return Array.from(classSet);
+}
 
 // src/preflight.js
 var preflight = `
@@ -3926,7 +3986,16 @@ function createWindrunner(options = {}) {
     const cssRule = compileWithCache(className);
     if (!cssRule) {
       ensureCompatStyle();
-      if (onError) onError(className);
+      if (onError) {
+        const parsed = parseClass(className, context.screens, context.containers);
+        const errorContext = {
+          reason: parsed ? "unknown-utility" : "parse-error",
+          baseToken: parsed ? parsed.baseToken : className,
+          variants: parsed ? parsed.variants : void 0,
+          details: parsed ? `Could not compile utility "${parsed.baseToken}"${parsed.variants.length ? ` with variants: ${parsed.variants.join(", ")}` : ""}` : `Failed to parse class name "${className}"`
+        };
+        onError(className, errorContext);
+      }
     } else {
       insertRule(cssRule);
       if (onCompile) onCompile(className, cssRule);
@@ -3950,9 +4019,39 @@ function createWindrunner(options = {}) {
   };
   const scan = (root = document) => {
     if (typeof document !== "object" || !root) return;
-    if (root.nodeType === 1) processElementTree(root);
+    const startTime = typeof performance !== "undefined" ? performance.now() : Date.now();
+    const scannedElements = /* @__PURE__ */ new Set();
+    const foundClasses = /* @__PURE__ */ new Set();
+    const initialRuleCount = insertedRules.size;
+    if (root.nodeType === 1) {
+      processElementTree(root);
+      if (root.classList) {
+        scannedElements.add(root);
+        root.classList.forEach((cls) => foundClasses.add(cls));
+      }
+    }
     const elements = root.querySelectorAll ? root.querySelectorAll("[class]") : [];
-    elements.forEach((element) => processElement(element));
+    elements.forEach((element) => {
+      processElement(element);
+      scannedElements.add(element);
+      if (element.classList) {
+        element.classList.forEach((cls) => foundClasses.add(cls));
+      }
+    });
+    if (typeof options.onScanComplete === "function") {
+      const endTime = typeof performance !== "undefined" ? performance.now() : Date.now();
+      const stats = {
+        elementCount: scannedElements.size,
+        classCount: foundClasses.size,
+        ruleCount: insertedRules.size - initialRuleCount,
+        duration: endTime - startTime
+      };
+      if (typeof requestAnimationFrame === "function") {
+        requestAnimationFrame(() => options.onScanComplete(stats));
+      } else {
+        setTimeout(() => options.onScanComplete(stats), 0);
+      }
+    }
   };
   const flushQueue = () => {
     scheduled = false;
@@ -3985,12 +4084,18 @@ function createWindrunner(options = {}) {
       });
       scheduleFlush();
     });
-    observer.observe(root, {
-      childList: true,
-      subtree: true,
-      attributes: true,
-      attributeFilter: ["class"]
-    });
+    const observerConfig = options.observerOptions || {};
+    const finalConfig = {
+      childList: observerConfig.childList !== false,
+      // default: true
+      subtree: observerConfig.subtree !== false,
+      // default: true
+      attributes: observerConfig.attributes !== false,
+      // default: true
+      attributeFilter: observerConfig.attributeFilter || ["class"]
+      // default: ["class"]
+    };
+    observer.observe(root, finalConfig);
   };
   const disconnect = () => {
     pendingElements.clear();
@@ -4068,10 +4173,13 @@ function windrunner(options = {}) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   compileClass,
+  compileCriticalCss,
   createWindrunner,
   defineResponsiveUtilities,
   defineUtilities,
+  extractClassNames,
   parseClass,
   plugin,
   windrunner
 });
+//# sourceMappingURL=index.js.map