@styleframe/scanner 3.1.1 → 3.1.2

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @styleframe/scanner
 
+## 3.1.2
+
+### Patch Changes
+
+- [#221](https://github.com/styleframe-dev/styleframe/pull/221) [`6d406c2`](https://github.com/styleframe-dev/styleframe/commit/6d406c289b39c666a3fb7468aa3ec08f5a6d316b) Thanks [@alexgrozav](https://github.com/alexgrozav)! - Add `treeshake` option to remove unused variables from CSS output.
+
+  `root._usage` now tracks both `variables` and `utilities` referenced during config execution and scanner registration. The transpiler's new `treeshake: true` option filters `root.variables` and theme variables down to only those present in `_usage.variables`. The plugin enables treeshaking by default when generating global CSS.
+
+- Updated dependencies [[`6d406c2`](https://github.com/styleframe-dev/styleframe/commit/6d406c289b39c666a3fb7468aa3ec08f5a6d316b)]:
+  - @styleframe/core@3.5.0
+
 ## 3.1.1
 
 ### Patch Changes

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const J=require("node:fs/promises"),W=require("fast-glob"),O=require("@styleframe/core");function V(s){let e=0;for(let t=0;t<s.length;t++){const n=s.charCodeAt(t);e=(e<<5)-e+n,e=e&e}return`${e.toString(16)}-${s.length}`}function D(){const s=new Map;return{get(e){return s.get(e)?.result??null},set(e,t,n){s.set(e,{hash:n,result:t,timestamp:Date.now()})},isValid(e,t){const n=s.get(e);return n!==void 0&&n.hash===t},getIfValid(e,t){const n=s.get(e);return n&&n.hash===t?n.result:null},invalidate(e){s.delete(e)},clear(){s.clear()}}}const $=/_[a-zA-Z][a-zA-Z0-9-]*(?::[a-zA-Z0-9._-]+|:\[[^\]]+\])*/g,j=/^\[(.+)\]$/,ee=["html","htm","vue","svelte","jsx","tsx","js","ts","astro","mdx","php","erb","twig","blade.php"],X=["**/node_modules/**","**/.git/**","**/dist/**","**/build/**","**/.next/**","**/.nuxt/**","**/coverage/**"];function C(s){if(!s.startsWith("_"))return null;const e=s.slice(1);if(!e)return null;const t=te(e);if(t.length===0)return null;let n,r,c=[];t.length===1?(n=t[0],r="default"):(r=t[t.length-1],n=t[t.length-2],c=t.slice(0,-2));let a=!1,l;const f=r.match(j);return f&&(a=!0,l=f[1]),{raw:s,name:n,value:r,modifiers:c,isArbitrary:a,arbitraryValue:l}}function te(s){const e=[];let t="",n=0;for(const r of s)r==="["?(n++,t+=r):r==="]"?(n--,t+=r):r===":"&&n===0?(t&&e.push(t),t=""):t+=r;return n!==0?[]:(t&&e.push(t),e)}function S(s,e){const t=s.match(e??$);return t?[...new Set(t)]:[]}function se(s,e,t=[]){const n=[...t,s];return e!=="default"&&n.push(e),`_${n.join(":")}`}const _=/\bclassName\s*=\s*\{/g,U=/\bclass\s*=\s*\{/g,F=/\bclass\s*=\s*["']([^"']+)["']/gi,I=/\bclassName\s*=\s*["']([^"']+)["']/gi,M=/\bclass:([^\s={>]+)/g,b=/'([^'\\]*(?:\\.[^'\\]*)*)'/g,L=/"([^"\\]*(?:\\.[^"\\]*)*)"/g,P=/`([^`\\]*(?:\\.[^`\\]*)*)`/g;function k(s){let e=1,t=0;for(;t<s.length&&e>0;){const n=s[t];n==="{"?e++:n==="}"&&e--,t++}return e!==0?null:s.slice(0,t-1)}function ne(s){const e=[];_.lastIndex=0;let t;for(;(t=_.exec(s))!==null;){const n=t.index+t[0].length,r=s.slice(n),c=k(r);c!==null&&e.push(c)}return e}function re(s){const e=[];U.lastIndex=0;let t;for(;(t=U.exec(s))!==null;){const n=t.index+t[0].length,r=s.slice(n),c=k(r);c!==null&&e.push(c)}return e}function u(s,e){const t=[];F.lastIndex=0;let n;for(;(n=F.exec(s))!==null;)n[1]&&t.push(...S(n[1],e));return t}function y(s,e){const t=[];I.lastIndex=0;let n;for(;(n=I.exec(s))!==null;)n[1]&&t.push(...S(n[1],e));const r=ne(s);for(const c of r)t.push(...m(c,e));return[...new Set(t)]}function z(s,e){const t=[],n=s.match(/<template[^>]*>([\s\S]*?)<\/template>/i);n?.[1]&&(t.push(...u(n[1],e)),t.push(...m(n[1],e)));const r=s.match(/<script[^>]*>([\s\S]*?)<\/script>/i);return r?.[1]&&t.push(...m(r[1],e)),[...new Set(t)]}function B(s,e){const t=[];t.push(...u(s,e));const n=re(s);for(const a of n)t.push(...m(a,e));M.lastIndex=0;let r;for(;(r=M.exec(s))!==null;)r[1]&&t.push(r[1]);const c=s.match(/<script[^>]*>([\s\S]*?)<\/script>/i);return c?.[1]&&t.push(...m(c[1],e)),[...new Set(t)]}function G(s,e){const t=[];t.push(...u(s,e)),t.push(...y(s,e));const n=s.match(/^---\n([\s\S]*?)\n---/);return n?.[1]&&t.push(...m(n[1],e)),[...new Set(t)]}function m(s,e){const t=[];let n;for(b.lastIndex=0;(n=b.exec(s))!==null;)n[1]&&t.push(...S(n[1],e));for(L.lastIndex=0;(n=L.exec(s))!==null;)n[1]&&t.push(...S(n[1],e));for(P.lastIndex=0;(n=P.exec(s))!==null;)n[1]&&t.push(...S(n[1],e));return t}function q(s,e){const t=[];return t.push(...u(s,e)),t.push(...y(s,e)),[...new Set(t)]}const ce={html:u,htm:u,vue:z,svelte:B,jsx:y,tsx:y,js:m,ts:m,astro:G,mdx:q,php:u,erb:u,twig:u,"blade.php":u};function ae(s){if(s.endsWith(".blade.php"))return"blade.php";const e=s.split(".");return e[e.length-1]?.toLowerCase()??""}function N(s,e,t,n){const r=[],c=ae(e);if(t)for(const l of t)r.push(...l(s,e));const a=ce[c];return a?r.push(...a(s,n)):r.push(...m(s,n)),[...new Set(r)]}function v(s,e){if(e.length===0)return s;const t=[...e].sort().join(",");return`${s}|${t}`}function H(s,e){const t=new Map,n=new Map,r=new Map;for(const a of e.utilities){t.set(a.name,a);const l=new Set;for(const f of a.values)l.add(v(f.key,f.modifiers));r.set(a,l)}for(const a of e.modifiers)for(const l of a.key)n.set(l,a);const c=[];for(const a of s){const l=t.get(a.name)??null,f=[];for(const E of a.modifiers){const A=n.get(E);A&&f.push(A)}let T=!1;if(l){const E=v(a.value,a.modifiers);T=r.get(l)?.has(E)??!1}c.push({parsed:a,factory:l,modifierFactories:f,exists:T})}return c}function le(s,e){const t=R(s,e);return O.classNameToCssSelector(t)}function R(s,e){return(e??O.defaultUtilitySelectorFn)(s)}function Q(s,e){return t=>{const n=R({name:t.name,value:t.value,modifiers:t.modifiers},e);return s.has(n)}}function ie(s,e,t){const n=Q(e,t);return s.children.filter(r=>r.type!=="utility"?!0:n(r))}function oe(s){const e=new Set;for(const t of s)e.add(t.parsed.raw);return e}function ue(s){return s.filter(e=>e.factory!==null)}function fe(s){return s.filter(e=>e.exists)}function he(s){return s.filter(e=>e.parsed.isArbitrary)}const w=new Map;function me(s){const e=s.replace(/\\/g,"/");if(w.has(e))return w.get(e);if(!e.includes("**")&&!e.includes("*")&&!e.includes("?"))return w.set(e,null),null;try{const t=ge(e),n=new RegExp(`^${t}$`);return w.set(e,n),n}catch{return w.set(e,null),null}}function pe(s,e){let t=null;return(...n)=>{t&&clearTimeout(t),t=setTimeout(()=>{s(...n),t=null},e)}}function Y(s,e={}){const{debounce:t=100}=e,n=new Set;let r=null;const c=()=>{if(n.size>0){const l=[...n];n.clear(),s(l)}};return{onChange:l=>{n.add(l),r&&clearTimeout(r),r=setTimeout(()=>{c(),r=null},t)},flush:c}}function de(s){return s.replace(/[.+^${}()|[\]\\]/g,"\\$&")}function ge(s){return s.replace(/\*\*/g,"<<<GLOBSTAR>>>").replace(/\*/g,"<<<STAR>>>").replace(/\?/g,"<<<QUESTION>>>").split("<<<GLOBSTAR>>>").map(de).join(".*").replace(/<<<STAR>>>/g,"[^/]*").replace(/<<<QUESTION>>>/g,".")}function xe(s,e){const t=s.replace(/\\/g,"/");for(const n of e){const r=me(n);if(r!==null){if(r.test(t))return!0}else{const c=n.replace(/\\/g,"/");if(t===c)return!0}}return!1}function Se(s){const e=D(),t=s.cwd??process.cwd(),n=s.extractors,r=s.utilities?.pattern,c=s.utilities?.parse??C;async function a(){return W(s.content,{cwd:t,absolute:!0,ignore:X})}async function l(i){const h=await J.readFile(i,"utf-8"),d=V(h),p=e.getIfValid(i,d);if(p)return p;const g=N(h,i,n,r),o=g.map(c).filter(Z=>Z!==null),x={path:i,classes:new Set(g),parsed:o,lastScanned:Date.now()};return e.set(i,x,d),x}function f(i,h="inline"){return N(i,h,n,r).map(c).filter(p=>p!==null)}async function T(){const i=await a(),h=new Map,d=new Set,p=[],g=await Promise.all(i.map(async o=>{try{return await l(o)}catch(x){return console.warn(`[styleframe/scanner] Failed to scan ${o}:`,x),null}}));for(const o of g)if(o){h.set(o.path,o);for(const x of o.classes)d.add(x);p.push(...o.parsed)}return{files:h,allClasses:d,allParsed:p}}function E(i,h){return H(i,h)}function A(i){const{onChange:h,flush:d}=Y(async p=>{for(const o of p)e.invalidate(o);const g=await T();i(g)});return()=>{d()}}function K(i){i?e.invalidate(i):e.clear()}return{scan:T,scanFile:l,scanContent:f,match:E,watch:A,invalidate:K}}function Te(s,e="inline.html",t){const n=t?.parse??C;return N(s,e,void 0,t?.pattern).map(n).filter(c=>c!==null)}function Ee(s,e){const t=e?.parse??C;return(n,r="inline")=>N(n,r,s,e?.pattern).map(t).filter(a=>a!==null)}exports.ARBITRARY_VALUE_PATTERN=j;exports.DEFAULT_EXTENSIONS=ee;exports.DEFAULT_IGNORE_PATTERNS=X;exports.UTILITY_CLASS_PATTERN=$;exports.classNameFromUtilityOptions=R;exports.createCache=D;exports.createChangeHandler=Y;exports.createContentScanner=Ee;exports.createScanner=Se;exports.createUtilityFilter=Q;exports.debounce=pe;exports.extractClasses=N;exports.extractFromAstro=G;exports.extractFromHTML=u;exports.extractFromJSX=y;exports.extractFromMDX=q;exports.extractFromStringLiterals=m;exports.extractFromSvelte=B;exports.extractFromVue=z;exports.extractUtilityClasses=S;exports.filterUtilities=ie;exports.generateUtilityClassName=se;exports.generateUtilitySelector=le;exports.getArbitraryMatches=he;exports.getExistingMatches=fe;exports.getUsedClassNames=oe;exports.getValidMatches=ue;exports.hashContent=V;exports.matchUtilities=H;exports.matchesPatterns=xe;exports.parseUtilityClass=C;exports.quickScan=Te;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./watcher-C8V8DPY6.cjs"),f=require("@styleframe/core");function p(n,s="inline.html",i){const c=i?.parse??e.parseUtilityClass;return e.extractClasses(n,s,void 0,i?.pattern).map(c).filter(t=>t!==null)}function g(n,s){const i=s?.parse??e.parseUtilityClass;return(c,l="inline")=>e.extractClasses(c,l,n,s?.pattern).map(i).filter(r=>r!==null)}function U(n,s){for(const t of s)t.factory&&n._usage.utilities.add(f.defaultUtilitySelectorFn({name:t.parsed.name,value:t.parsed.value,modifiers:t.parsed.modifiers}));const i=s.filter(t=>t.factory!==null&&!t.exists);if(i.length===0)return 0;const c=new Map;for(const t of i){const r=t.factory,m=`${r.name}:${t.parsed.value}`,o=c.get(m),a=t.modifierFactories.length>1?t.modifierFactories:t.modifierFactories[0];if(!o)c.set(m,{factory:r,parsed:t.parsed,modifierGroups:a?[a]:[]});else if(a){const y=Array.isArray(a)?a.map(u=>u.key.join(",")).join("|"):a.key.join(",");o.modifierGroups.some(u=>(Array.isArray(u)?u.map(d=>d.key.join(",")).join("|"):u.key.join(","))===y)||o.modifierGroups.push(a)}}let l=0;for(const{factory:t,parsed:r,modifierGroups:m}of c.values()){const o=m.length>0?m:void 0;if(r.isArbitrary&&r.arbitraryValue!==void 0)t.create({[r.value]:r.arbitraryValue},o);else{const a=t.autogenerate(`@${r.value}`);t.create(a,o)}l++}return l}exports.ARBITRARY_VALUE_PATTERN=e.ARBITRARY_VALUE_PATTERN;exports.DEFAULT_EXTENSIONS=e.DEFAULT_EXTENSIONS;exports.DEFAULT_IGNORE_PATTERNS=e.DEFAULT_IGNORE_PATTERNS;exports.UTILITY_CLASS_PATTERN=e.UTILITY_CLASS_PATTERN;exports.classNameFromUtilityOptions=e.classNameFromUtilityOptions;exports.createCache=e.createCache;exports.createChangeHandler=e.createChangeHandler;exports.createUtilityFilter=e.createUtilityFilter;exports.debounce=e.debounce;exports.extractClasses=e.extractClasses;exports.extractFromAstro=e.extractFromAstro;exports.extractFromHTML=e.extractFromHTML;exports.extractFromJSX=e.extractFromJSX;exports.extractFromMDX=e.extractFromMDX;exports.extractFromStringLiterals=e.extractFromStringLiterals;exports.extractFromSvelte=e.extractFromSvelte;exports.extractFromVue=e.extractFromVue;exports.extractUtilityClasses=e.extractUtilityClasses;exports.filterUtilities=e.filterUtilities;exports.generateUtilityClassName=e.generateUtilityClassName;exports.generateUtilitySelector=e.generateUtilitySelector;exports.getArbitraryMatches=e.getArbitraryMatches;exports.getExistingMatches=e.getExistingMatches;exports.getUsedClassNames=e.getUsedClassNames;exports.getValidMatches=e.getValidMatches;exports.hashContent=e.hashContent;exports.matchUtilities=e.matchUtilities;exports.matchesPatterns=e.matchesPatterns;exports.parseUtilityClass=e.parseUtilityClass;exports.createContentScanner=g;exports.quickScan=p;exports.registerMatchedUtilities=U;

package/dist/index.d.ts

@@ -59,24 +59,6 @@ export declare function createChangeHandler(callback: (changedFiles: string[]) =
  */
 export declare function createContentScanner(customExtractors?: Extractor[], utilities?: ScannerUtilitiesConfig): (content: string, filePath?: string) => ParsedUtility[];
 
-/**
- * Create a scanner instance for detecting utility classes in content files.
- *
- * @param config Scanner configuration
- * @returns Scanner instance
- *
- * @example
- * ```ts
- * const scanner = createScanner({
- *   content: ['./src/components/*.tsx', './src/pages/*.vue'],
- * });
- *
- * const result = await scanner.scan();
- * const matches = scanner.match(result.allParsed, root);
- * ```
- */
-export declare function createScanner(config: ScannerConfig): Scanner;
-
 /**
  * Create a filter function that checks if a utility is in the used set.
  *
@@ -303,6 +285,23 @@ export declare function parseUtilityClass(className: string): ParsedUtility | nu
  */
 export declare function quickScan(content: string, filePath?: string, utilities?: ScannerUtilitiesConfig): ParsedUtility[];
 
+/**
+ * Register utility values detected by the scanner that don't yet exist on the root.
+ *
+ * For non-arbitrary values, uses the factory's autogenerate function (treating the
+ * value key as a token reference). For arbitrary values, registers with the literal
+ * CSS value directly.
+ *
+ * Registration happens via `factory.create(...)` on each matched factory, which is
+ * already bound to the `root` that produced the matches via `matchUtilities(parsed, root)`.
+ * The `root` parameter is part of the signature to document the mutation target.
+ *
+ * @param root The Styleframe root that will receive the new utilities
+ * @param matches Scanner match results produced from this same root
+ * @returns Number of newly registered values
+ */
+export declare function registerMatchedUtilities(_root: Root, matches: UtilityMatch[]): number;
+
 /**
  * Scanner instance interface
  */

package/dist/index.js

@@ -1,496 +1,94 @@
-import { readFile as D } from "node:fs/promises";
-import j from "fast-glob";
-import { classNameToCssSelector as z, defaultUtilitySelectorFn as k } from "@styleframe/core";
-function B(s) {
-  let e = 0;
-  for (let t = 0; t < s.length; t++) {
-    const n = s.charCodeAt(t);
-    e = (e << 5) - e + n, e = e & e;
-  }
-  return `${e.toString(16)}-${s.length}`;
-}
-function G() {
-  const s = /* @__PURE__ */ new Map();
-  return {
-    get(e) {
-      return s.get(e)?.result ?? null;
-    },
-    set(e, t, n) {
-      s.set(e, {
-        hash: n,
-        result: t,
-        timestamp: Date.now()
+import { p as f, e as u } from "./watcher-Bn_8hGt2.js";
+import { A as v, D as E, z as C, U as _, l as j, v as k, x as L, n as M, w as R, h as b, b as D, c as G, i as I, j as V, f as P, d as K, a as O, o as X, g as $, k as q, t as w, s as H, q as Y, r as z, u as B, m as J, y as Q } from "./watcher-Bn_8hGt2.js";
+import { defaultUtilitySelectorFn as y } from "@styleframe/core";
+function U(n, r = "inline.html", s) {
+  const i = s?.parse ?? f;
+  return u(
+    n,
+    r,
+    void 0,
+    s?.pattern
+  ).map(i).filter((e) => e !== null);
+}
+function x(n, r) {
+  const s = r?.parse ?? f;
+  return (i, c = "inline") => u(
+    i,
+    c,
+    n,
+    r?.pattern
+  ).map(s).filter((t) => t !== null);
+}
+function N(n, r) {
+  for (const e of r)
+    e.factory && n._usage.utilities.add(
+      y({
+        name: e.parsed.name,
+        value: e.parsed.value,
+        modifiers: e.parsed.modifiers
+      })
+    );
+  const s = r.filter((e) => e.factory !== null && !e.exists);
+  if (s.length === 0)
+    return 0;
+  const i = /* @__PURE__ */ new Map();
+  for (const e of s) {
+    const t = e.factory, l = `${t.name}:${e.parsed.value}`, o = i.get(l), a = e.modifierFactories.length > 1 ? e.modifierFactories : e.modifierFactories[0];
+    if (!o)
+      i.set(l, {
+        factory: t,
+        parsed: e.parsed,
+        modifierGroups: a ? [a] : []
       });
-    },
-    isValid(e, t) {
-      const n = s.get(e);
-      return n !== void 0 && n.hash === t;
-    },
-    getIfValid(e, t) {
-      const n = s.get(e);
-      return n && n.hash === t ? n.result : null;
-    },
-    invalidate(e) {
-      s.delete(e);
-    },
-    clear() {
-      s.clear();
+    else if (a) {
+      const p = Array.isArray(a) ? a.map((m) => m.key.join(",")).join("|") : a.key.join(",");
+      o.modifierGroups.some((m) => (Array.isArray(m) ? m.map((d) => d.key.join(",")).join("|") : m.key.join(",")) === p) || o.modifierGroups.push(a);
     }
-  };
-}
-const X = /_[a-zA-Z][a-zA-Z0-9-]*(?::[a-zA-Z0-9._-]+|:\[[^\]]+\])*/g, Q = /^\[(.+)\]$/, he = [
-  "html",
-  "htm",
-  "vue",
-  "svelte",
-  "jsx",
-  "tsx",
-  "js",
-  "ts",
-  "astro",
-  "mdx",
-  "php",
-  "erb",
-  "twig",
-  "blade.php"
-], H = [
-  "**/node_modules/**",
-  "**/.git/**",
-  "**/dist/**",
-  "**/build/**",
-  "**/.next/**",
-  "**/.nuxt/**",
-  "**/coverage/**"
-];
-function C(s) {
-  if (!s.startsWith("_"))
-    return null;
-  const e = s.slice(1);
-  if (!e)
-    return null;
-  const t = K(e);
-  if (t.length === 0)
-    return null;
-  let n, r, c = [];
-  t.length === 1 ? (n = t[0], r = "default") : (r = t[t.length - 1], n = t[t.length - 2], c = t.slice(0, -2));
-  let a = !1, l;
-  const u = r.match(Q);
-  return u && (a = !0, l = u[1]), {
-    raw: s,
-    name: n,
-    value: r,
-    modifiers: c,
-    isArbitrary: a,
-    arbitraryValue: l
-  };
-}
-function K(s) {
-  const e = [];
-  let t = "", n = 0;
-  for (const r of s)
-    r === "[" ? (n++, t += r) : r === "]" ? (n--, t += r) : r === ":" && n === 0 ? (t && e.push(t), t = "") : t += r;
-  return n !== 0 ? [] : (t && e.push(t), e);
-}
-function A(s, e) {
-  const t = s.match(e ?? X);
-  return t ? [...new Set(t)] : [];
-}
-function pe(s, e, t = []) {
-  const n = [...t, s];
-  return e !== "default" && n.push(e), `_${n.join(":")}`;
-}
-const R = /\bclassName\s*=\s*\{/g, _ = /\bclass\s*=\s*\{/g, I = /\bclass\s*=\s*["']([^"']+)["']/gi, b = /\bclassName\s*=\s*["']([^"']+)["']/gi, M = /\bclass:([^\s={>]+)/g, L = /'([^'\\]*(?:\\.[^'\\]*)*)'/g, F = /"([^"\\]*(?:\\.[^"\\]*)*)"/g, v = /`([^`\\]*(?:\\.[^`\\]*)*)`/g;
-function P(s) {
-  let e = 1, t = 0;
-  for (; t < s.length && e > 0; ) {
-    const n = s[t];
-    n === "{" ? e++ : n === "}" && e--, t++;
-  }
-  return e !== 0 ? null : s.slice(0, t - 1);
-}
-function Z(s) {
-  const e = [];
-  R.lastIndex = 0;
-  let t;
-  for (; (t = R.exec(s)) !== null; ) {
-    const n = t.index + t[0].length, r = s.slice(n), c = P(r);
-    c !== null && e.push(c);
-  }
-  return e;
-}
-function W(s) {
-  const e = [];
-  _.lastIndex = 0;
-  let t;
-  for (; (t = _.exec(s)) !== null; ) {
-    const n = t.index + t[0].length, r = s.slice(n), c = P(r);
-    c !== null && e.push(c);
   }
-  return e;
-}
-function h(s, e) {
-  const t = [];
-  I.lastIndex = 0;
-  let n;
-  for (; (n = I.exec(s)) !== null; )
-    n[1] && t.push(...A(n[1], e));
-  return t;
-}
-function y(s, e) {
-  const t = [];
-  b.lastIndex = 0;
-  let n;
-  for (; (n = b.exec(s)) !== null; )
-    n[1] && t.push(...A(n[1], e));
-  const r = Z(s);
-  for (const c of r)
-    t.push(...m(c, e));
-  return [...new Set(t)];
-}
-function Y(s, e) {
-  const t = [], n = s.match(/<template[^>]*>([\s\S]*?)<\/template>/i);
-  n?.[1] && (t.push(...h(n[1], e)), t.push(...m(n[1], e)));
-  const r = s.match(/<script[^>]*>([\s\S]*?)<\/script>/i);
-  return r?.[1] && t.push(...m(r[1], e)), [...new Set(t)];
-}
-function q(s, e) {
-  const t = [];
-  t.push(...h(s, e));
-  const n = W(s);
-  for (const a of n)
-    t.push(...m(a, e));
-  M.lastIndex = 0;
-  let r;
-  for (; (r = M.exec(s)) !== null; )
-    r[1] && t.push(r[1]);
-  const c = s.match(/<script[^>]*>([\s\S]*?)<\/script>/i);
-  return c?.[1] && t.push(...m(c[1], e)), [...new Set(t)];
-}
-function J(s, e) {
-  const t = [];
-  t.push(...h(s, e)), t.push(...y(s, e));
-  const n = s.match(/^---\n([\s\S]*?)\n---/);
-  return n?.[1] && t.push(...m(n[1], e)), [...new Set(t)];
-}
-function m(s, e) {
-  const t = [];
-  let n;
-  for (L.lastIndex = 0; (n = L.exec(s)) !== null; )
-    n[1] && t.push(...A(n[1], e));
-  for (F.lastIndex = 0; (n = F.exec(s)) !== null; )
-    n[1] && t.push(...A(n[1], e));
-  for (v.lastIndex = 0; (n = v.exec(s)) !== null; )
-    n[1] && t.push(...A(n[1], e));
-  return t;
-}
-function ee(s, e) {
-  const t = [];
-  return t.push(...h(s, e)), t.push(...y(s, e)), [...new Set(t)];
-}
-const te = {
-  html: h,
-  htm: h,
-  vue: Y,
-  svelte: q,
-  jsx: y,
-  tsx: y,
-  js: m,
-  ts: m,
-  astro: J,
-  mdx: ee,
-  php: h,
-  erb: h,
-  twig: h,
-  "blade.php": h
-};
-function se(s) {
-  if (s.endsWith(".blade.php"))
-    return "blade.php";
-  const e = s.split(".");
-  return e[e.length - 1]?.toLowerCase() ?? "";
-}
-function N(s, e, t, n) {
-  const r = [], c = se(e);
-  if (t)
-    for (const l of t)
-      r.push(...l(s, e));
-  const a = te[c];
-  return a ? r.push(...a(s, n)) : r.push(...m(s, n)), [...new Set(r)];
-}
-function U(s, e) {
-  if (e.length === 0)
-    return s;
-  const t = [...e].sort().join(",");
-  return `${s}|${t}`;
-}
-function ne(s, e) {
-  const t = /* @__PURE__ */ new Map(), n = /* @__PURE__ */ new Map(), r = /* @__PURE__ */ new Map();
-  for (const a of e.utilities) {
-    t.set(a.name, a);
-    const l = /* @__PURE__ */ new Set();
-    for (const u of a.values)
-      l.add(U(u.key, u.modifiers));
-    r.set(a, l);
-  }
-  for (const a of e.modifiers)
-    for (const l of a.key)
-      n.set(l, a);
-  const c = [];
-  for (const a of s) {
-    const l = t.get(a.name) ?? null, u = [];
-    for (const T of a.modifiers) {
-      const w = n.get(T);
-      w && u.push(w);
-    }
-    let S = !1;
-    if (l) {
-      const T = U(
-        a.value,
-        a.modifiers
-      );
-      S = r.get(l)?.has(T) ?? !1;
+  let c = 0;
+  for (const { factory: e, parsed: t, modifierGroups: l } of i.values()) {
+    const o = l.length > 0 ? l : void 0;
+    if (t.isArbitrary && t.arbitraryValue !== void 0)
+      e.create({ [t.value]: t.arbitraryValue }, o);
+    else {
+      const a = e.autogenerate(`@${t.value}`);
+      e.create(a, o);
     }
-    c.push({
-      parsed: a,
-      factory: l,
-      modifierFactories: u,
-      exists: S
-    });
+    c++;
   }
   return c;
 }
-function me(s, e) {
-  const t = V(s, e);
-  return z(t);
-}
-function V(s, e) {
-  return (e ?? k)(s);
-}
-function re(s, e) {
-  return (t) => {
-    const n = V(
-      {
-        name: t.name,
-        value: t.value,
-        modifiers: t.modifiers
-      },
-      e
-    );
-    return s.has(n);
-  };
-}
-function de(s, e, t) {
-  const n = re(e, t);
-  return s.children.filter((r) => r.type !== "utility" ? !0 : n(r));
-}
-function ge(s) {
-  const e = /* @__PURE__ */ new Set();
-  for (const t of s)
-    e.add(t.parsed.raw);
-  return e;
-}
-function xe(s) {
-  return s.filter((e) => e.factory !== null);
-}
-function Se(s) {
-  return s.filter((e) => e.exists);
-}
-function Te(s) {
-  return s.filter((e) => e.parsed.isArbitrary);
-}
-const E = /* @__PURE__ */ new Map();
-function ce(s) {
-  const e = s.replace(/\\/g, "/");
-  if (E.has(e))
-    return E.get(e);
-  if (!e.includes("**") && !e.includes("*") && !e.includes("?"))
-    return E.set(e, null), null;
-  try {
-    const t = oe(e), n = new RegExp(`^${t}$`);
-    return E.set(e, n), n;
-  } catch {
-    return E.set(e, null), null;
-  }
-}
-function we(s, e) {
-  let t = null;
-  return (...n) => {
-    t && clearTimeout(t), t = setTimeout(() => {
-      s(...n), t = null;
-    }, e);
-  };
-}
-function ae(s, e = {}) {
-  const { debounce: t = 100 } = e, n = /* @__PURE__ */ new Set();
-  let r = null;
-  const c = () => {
-    if (n.size > 0) {
-      const l = [...n];
-      n.clear(), s(l);
-    }
-  };
-  return { onChange: (l) => {
-    n.add(l), r && clearTimeout(r), r = setTimeout(() => {
-      c(), r = null;
-    }, t);
-  }, flush: c };
-}
-function le(s) {
-  return s.replace(/[.+^${}()|[\]\\]/g, "\\$&");
-}
-function oe(s) {
-  return s.replace(/\*\*/g, "<<<GLOBSTAR>>>").replace(/\*/g, "<<<STAR>>>").replace(/\?/g, "<<<QUESTION>>>").split("<<<GLOBSTAR>>>").map(le).join(".*").replace(/<<<STAR>>>/g, "[^/]*").replace(/<<<QUESTION>>>/g, ".");
-}
-function Ee(s, e) {
-  const t = s.replace(/\\/g, "/");
-  for (const n of e) {
-    const r = ce(n);
-    if (r !== null) {
-      if (r.test(t))
-        return !0;
-    } else {
-      const c = n.replace(/\\/g, "/");
-      if (t === c)
-        return !0;
-    }
-  }
-  return !1;
-}
-function Ae(s) {
-  const e = G(), t = s.cwd ?? process.cwd(), n = s.extractors, r = s.utilities?.pattern, c = s.utilities?.parse ?? C;
-  async function a() {
-    return j(s.content, {
-      cwd: t,
-      absolute: !0,
-      ignore: H
-    });
-  }
-  async function l(o) {
-    const f = await D(o, "utf-8"), d = B(f), p = e.getIfValid(o, d);
-    if (p)
-      return p;
-    const g = N(
-      f,
-      o,
-      n,
-      r
-    ), i = g.map(c).filter((O) => O !== null), x = {
-      path: o,
-      classes: new Set(g),
-      parsed: i,
-      lastScanned: Date.now()
-    };
-    return e.set(o, x, d), x;
-  }
-  function u(o, f = "inline") {
-    return N(
-      o,
-      f,
-      n,
-      r
-    ).map(c).filter((p) => p !== null);
-  }
-  async function S() {
-    const o = await a(), f = /* @__PURE__ */ new Map(), d = /* @__PURE__ */ new Set(), p = [], g = await Promise.all(
-      o.map(async (i) => {
-        try {
-          return await l(i);
-        } catch (x) {
-          return console.warn(
-            `[styleframe/scanner] Failed to scan ${i}:`,
-            x
-          ), null;
-        }
-      })
-    );
-    for (const i of g)
-      if (i) {
-        f.set(i.path, i);
-        for (const x of i.classes)
-          d.add(x);
-        p.push(...i.parsed);
-      }
-    return {
-      files: f,
-      allClasses: d,
-      allParsed: p
-    };
-  }
-  function T(o, f) {
-    return ne(o, f);
-  }
-  function w(o) {
-    const { onChange: f, flush: d } = ae(async (p) => {
-      for (const i of p)
-        e.invalidate(i);
-      const g = await S();
-      o(g);
-    });
-    return () => {
-      d();
-    };
-  }
-  function $(o) {
-    o ? e.invalidate(o) : e.clear();
-  }
-  return {
-    scan: S,
-    scanFile: l,
-    scanContent: u,
-    match: T,
-    watch: w,
-    invalidate: $
-  };
-}
-function ye(s, e = "inline.html", t) {
-  const n = t?.parse ?? C;
-  return N(
-    s,
-    e,
-    void 0,
-    t?.pattern
-  ).map(n).filter((c) => c !== null);
-}
-function Ne(s, e) {
-  const t = e?.parse ?? C;
-  return (n, r = "inline") => N(
-    n,
-    r,
-    s,
-    e?.pattern
-  ).map(t).filter((a) => a !== null);
-}
 export {
-  Q as ARBITRARY_VALUE_PATTERN,
-  he as DEFAULT_EXTENSIONS,
-  H as DEFAULT_IGNORE_PATTERNS,
-  X as UTILITY_CLASS_PATTERN,
-  V as classNameFromUtilityOptions,
-  G as createCache,
-  ae as createChangeHandler,
-  Ne as createContentScanner,
-  Ae as createScanner,
-  re as createUtilityFilter,
-  we as debounce,
-  N as extractClasses,
-  J as extractFromAstro,
-  h as extractFromHTML,
-  y as extractFromJSX,
-  ee as extractFromMDX,
-  m as extractFromStringLiterals,
-  q as extractFromSvelte,
-  Y as extractFromVue,
-  A as extractUtilityClasses,
-  de as filterUtilities,
-  pe as generateUtilityClassName,
-  me as generateUtilitySelector,
-  Te as getArbitraryMatches,
-  Se as getExistingMatches,
-  ge as getUsedClassNames,
-  xe as getValidMatches,
+  v as ARBITRARY_VALUE_PATTERN,
+  E as DEFAULT_EXTENSIONS,
+  C as DEFAULT_IGNORE_PATTERNS,
+  _ as UTILITY_CLASS_PATTERN,
+  j as classNameFromUtilityOptions,
+  k as createCache,
+  L as createChangeHandler,
+  x as createContentScanner,
+  M as createUtilityFilter,
+  R as debounce,
+  u as extractClasses,
+  b as extractFromAstro,
+  D as extractFromHTML,
+  G as extractFromJSX,
+  I as extractFromMDX,
+  V as extractFromStringLiterals,
+  P as extractFromSvelte,
+  K as extractFromVue,
+  O as extractUtilityClasses,
+  X as filterUtilities,
+  $ as generateUtilityClassName,
+  q as generateUtilitySelector,
+  w as getArbitraryMatches,
+  H as getExistingMatches,
+  Y as getUsedClassNames,
+  z as getValidMatches,
   B as hashContent,
-  ne as matchUtilities,
-  Ee as matchesPatterns,
-  C as parseUtilityClass,
-  ye as quickScan
+  J as matchUtilities,
+  Q as matchesPatterns,
+  f as parseUtilityClass,
+  U as quickScan,
+  N as registerMatchedUtilities
 };

package/dist/node.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const g=require("node:fs/promises"),v=require("fast-glob"),c=require("./watcher-C8V8DPY6.cjs");function x(l){const i=c.createCache(),h=l.cwd??process.cwd(),u=l.extractors,d=l.utilities?.pattern,f=l.utilities?.parse??c.parseUtilityClass;async function m(){return v(l.content,{cwd:h,absolute:!0,ignore:c.DEFAULT_IGNORE_PATTERNS})}async function p(t){const s=await g.readFile(t,"utf-8"),a=c.hashContent(s),n=i.getIfValid(t,a);if(n)return n;const r=c.extractClasses(s,t,u,d),e=r.map(f).filter(F=>F!==null),o={path:t,classes:new Set(r),parsed:e,lastScanned:Date.now()};return i.set(t,o,a),o}function y(t,s="inline"){return c.extractClasses(t,s,u,d).map(f).filter(n=>n!==null)}async function w(){const t=await m(),s=new Map,a=new Set,n=[],r=await Promise.all(t.map(async e=>{try{return await p(e)}catch(o){return console.warn(`[styleframe/scanner] Failed to scan ${e}:`,o),null}}));for(const e of r)if(e){s.set(e.path,e);for(const o of e.classes)a.add(o);n.push(...e.parsed)}return{files:s,allClasses:a,allParsed:n}}function C(t,s){return c.matchUtilities(t,s)}function S(t){const{onChange:s,flush:a}=c.createChangeHandler(async n=>{for(const e of n)i.invalidate(e);const r=await w();t(r)});return()=>{a()}}function N(t){t?i.invalidate(t):i.clear()}return{scan:w,scanFile:p,scanContent:y,match:C,watch:S,invalidate:N}}exports.createScanner=x;

package/dist/node.d.ts

@@ -0,0 +1,138 @@
+import { ModifierFactory } from '@styleframe/core';
+import { Root } from '@styleframe/core';
+import { UtilityFactory } from '@styleframe/core';
+import { UtilitySelectorFn } from '@styleframe/core';
+
+/**
+ * Create a scanner instance for detecting utility classes in content files.
+ *
+ * @param config Scanner configuration
+ * @returns Scanner instance
+ *
+ * @example
+ * ```ts
+ * const scanner = createScanner({
+ *   content: ['./src/components/*.tsx', './src/pages/*.vue'],
+ * });
+ *
+ * const result = await scanner.scan();
+ * const matches = scanner.match(result.allParsed, root);
+ * ```
+ */
+export declare function createScanner(config: ScannerConfig): Scanner;
+
+/**
+ * Custom extractor function type
+ */
+declare type Extractor = (content: string, filePath: string) => string[];
+
+/**
+ * Scan result for a single file
+ */
+declare interface FileScanResult {
+    /** Absolute file path */
+    path: string;
+    /** Set of raw class names found */
+    classes: Set<string>;
+    /** Parsed utility classes */
+    parsed: ParsedUtility[];
+    /** Timestamp of last scan */
+    lastScanned: number;
+}
+
+/**
+ * Parsed utility class structure
+ */
+declare interface ParsedUtility {
+    /** Original class name as found in content (e.g., "_margin:sm") */
+    raw: string;
+    /** Utility name (e.g., "margin", "background") */
+    name: string;
+    /** Value key (e.g., "sm", "primary", "[16px]") */
+    value: string;
+    /** Applied modifiers in order (e.g., ["hover", "dark"]) */
+    modifiers: string[];
+    /** Whether this uses arbitrary value syntax [value] */
+    isArbitrary: boolean;
+    /** The arbitrary value if isArbitrary is true (e.g., "16px") */
+    arbitraryValue?: string;
+}
+
+/**
+ * Scanner instance interface
+ */
+declare interface Scanner {
+    /** Scan all content files */
+    scan(): Promise<ScanResult>;
+    /** Scan a single file */
+    scanFile(filePath: string): Promise<FileScanResult>;
+    /** Scan content string directly */
+    scanContent(content: string, filePath?: string): ParsedUtility[];
+    /** Match parsed utilities against a root instance */
+    match(parsed: ParsedUtility[], root: Root): UtilityMatch[];
+    /** Start watching content files for changes */
+    watch(callback: (result: ScanResult) => void): () => void;
+    /** Invalidate cache for a file or all files */
+    invalidate(filePath?: string): void;
+}
+
+/**
+ * Configuration for the content scanner
+ */
+declare interface ScannerConfig {
+    /** Glob patterns for files to scan */
+    content: string[];
+    /** Custom extraction functions */
+    extractors?: Extractor[];
+    /** Base directory for glob resolution (defaults to process.cwd()) */
+    cwd?: string;
+    /** Custom utility class syntax configuration */
+    utilities?: ScannerUtilitiesConfig;
+}
+
+/**
+ * Configuration for custom utility class syntax.
+ * All fields are optional — defaults match the `_modifier:property:value` format.
+ */
+declare interface ScannerUtilitiesConfig {
+    /** Regex pattern to extract utility class candidates from content strings. Must use the global (`g`) flag. */
+    pattern?: RegExp;
+    /** Parse a matched class name into its components (name, value, modifiers) */
+    parse?: UtilityClassParseFn;
+    /** Generate a raw class name from components (inverse of parse) */
+    selector?: UtilitySelectorFn;
+}
+
+/**
+ * Complete scan result across all files
+ */
+declare interface ScanResult {
+    /** Map of file path to scan result */
+    files: Map<string, FileScanResult>;
+    /** All unique class names found */
+    allClasses: Set<string>;
+    /** All parsed utilities */
+    allParsed: ParsedUtility[];
+}
+
+/**
+ * Function that parses a class name string into its structured components.
+ * Returns null if the string is not a valid utility class.
+ */
+declare type UtilityClassParseFn = (className: string) => ParsedUtility | null;
+
+/**
+ * Match result between a parsed class and a utility factory
+ */
+declare interface UtilityMatch {
+    /** The parsed utility class */
+    parsed: ParsedUtility;
+    /** The matched utility factory, or null if not found */
+    factory: UtilityFactory | null;
+    /** Matched modifier factories */
+    modifierFactories: ModifierFactory[];
+    /** Whether the utility value exists in the factory */
+    exists: boolean;
+}
+
+export { }

package/dist/node.js

@@ -0,0 +1,92 @@
+import { readFile as S } from "node:fs/promises";
+import v from "fast-glob";
+import { p as E, v as T, x as U, m as g, e as d, u as A, z as D } from "./watcher-Bn_8hGt2.js";
+function R(o) {
+  const l = T(), w = o.cwd ?? process.cwd(), i = o.extractors, u = o.utilities?.pattern, f = o.utilities?.parse ?? E;
+  async function h() {
+    return v(o.content, {
+      cwd: w,
+      absolute: !0,
+      ignore: D
+    });
+  }
+  async function m(t) {
+    const a = await S(t, "utf-8"), e = A(a), n = l.getIfValid(t, e);
+    if (n)
+      return n;
+    const c = d(
+      a,
+      t,
+      i,
+      u
+    ), s = c.map(f).filter((F) => F !== null), r = {
+      path: t,
+      classes: new Set(c),
+      parsed: s,
+      lastScanned: Date.now()
+    };
+    return l.set(t, r, e), r;
+  }
+  function y(t, a = "inline") {
+    return d(
+      t,
+      a,
+      i,
+      u
+    ).map(f).filter((n) => n !== null);
+  }
+  async function p() {
+    const t = await h(), a = /* @__PURE__ */ new Map(), e = /* @__PURE__ */ new Set(), n = [], c = await Promise.all(
+      t.map(async (s) => {
+        try {
+          return await m(s);
+        } catch (r) {
+          return console.warn(
+            `[styleframe/scanner] Failed to scan ${s}:`,
+            r
+          ), null;
+        }
+      })
+    );
+    for (const s of c)
+      if (s) {
+        a.set(s.path, s);
+        for (const r of s.classes)
+          e.add(r);
+        n.push(...s.parsed);
+      }
+    return {
+      files: a,
+      allClasses: e,
+      allParsed: n
+    };
+  }
+  function C(t, a) {
+    return g(t, a);
+  }
+  function N(t) {
+    const { onChange: a, flush: e } = U(async (n) => {
+      for (const s of n)
+        l.invalidate(s);
+      const c = await p();
+      t(c);
+    });
+    return () => {
+      e();
+    };
+  }
+  function x(t) {
+    t ? l.invalidate(t) : l.clear();
+  }
+  return {
+    scan: p,
+    scanFile: m,
+    scanContent: y,
+    match: C,
+    watch: N,
+    invalidate: x
+  };
+}
+export {
+  R as createScanner
+};

package/dist/watcher-Bn_8hGt2.js

@@ -0,0 +1,387 @@
+import { classNameToCssSelector as b, defaultUtilitySelectorFn as I } from "@styleframe/core";
+const M = /_[a-zA-Z][a-zA-Z0-9-]*(?::[a-zA-Z0-9._-]+|:\[[^\]]+\])*/g, L = /^\[(.+)\]$/, Q = [
+  "html",
+  "htm",
+  "vue",
+  "svelte",
+  "jsx",
+  "tsx",
+  "js",
+  "ts",
+  "astro",
+  "mdx",
+  "php",
+  "erb",
+  "twig",
+  "blade.php"
+], K = [
+  "**/node_modules/**",
+  "**/.git/**",
+  "**/dist/**",
+  "**/build/**",
+  "**/.next/**",
+  "**/.nuxt/**",
+  "**/coverage/**"
+];
+function Z(s) {
+  if (!s.startsWith("_"))
+    return null;
+  const e = s.slice(1);
+  if (!e)
+    return null;
+  const t = U(e);
+  if (t.length === 0)
+    return null;
+  let n, r, a = [];
+  t.length === 1 ? (n = t[0], r = "default") : (r = t[t.length - 1], n = t[t.length - 2], a = t.slice(0, -2));
+  let l = !1, c;
+  const u = r.match(L);
+  return u && (l = !0, c = u[1]), {
+    raw: s,
+    name: n,
+    value: r,
+    modifiers: a,
+    isArbitrary: l,
+    arbitraryValue: c
+  };
+}
+function U(s) {
+  const e = [];
+  let t = "", n = 0;
+  for (const r of s)
+    r === "[" ? (n++, t += r) : r === "]" ? (n--, t += r) : r === ":" && n === 0 ? (t && e.push(t), t = "") : t += r;
+  return n !== 0 ? [] : (t && e.push(t), e);
+}
+function h(s, e) {
+  const t = s.match(e ?? M);
+  return t ? [...new Set(t)] : [];
+}
+function H(s, e, t = []) {
+  const n = [...t, s];
+  return e !== "default" && n.push(e), `_${n.join(":")}`;
+}
+const x = /\bclassName\s*=\s*\{/g, T = /\bclass\s*=\s*\{/g, S = /\bclass\s*=\s*["']([^"']+)["']/gi, A = /\bclassName\s*=\s*["']([^"']+)["']/gi, E = /\bclass:([^\s={>]+)/g, w = /'([^'\\]*(?:\\.[^'\\]*)*)'/g, C = /"([^"\\]*(?:\\.[^"\\]*)*)"/g, y = /`([^`\\]*(?:\\.[^`\\]*)*)`/g;
+function _(s) {
+  let e = 1, t = 0;
+  for (; t < s.length && e > 0; ) {
+    const n = s[t];
+    n === "{" ? e++ : n === "}" && e--, t++;
+  }
+  return e !== 0 ? null : s.slice(0, t - 1);
+}
+function P(s) {
+  const e = [];
+  x.lastIndex = 0;
+  let t;
+  for (; (t = x.exec(s)) !== null; ) {
+    const n = t.index + t[0].length, r = s.slice(n), a = _(r);
+    a !== null && e.push(a);
+  }
+  return e;
+}
+function v(s) {
+  const e = [];
+  T.lastIndex = 0;
+  let t;
+  for (; (t = T.exec(s)) !== null; ) {
+    const n = t.index + t[0].length, r = s.slice(n), a = _(r);
+    a !== null && e.push(a);
+  }
+  return e;
+}
+function i(s, e) {
+  const t = [];
+  S.lastIndex = 0;
+  let n;
+  for (; (n = S.exec(s)) !== null; )
+    n[1] && t.push(...h(n[1], e));
+  return t;
+}
+function p(s, e) {
+  const t = [];
+  A.lastIndex = 0;
+  let n;
+  for (; (n = A.exec(s)) !== null; )
+    n[1] && t.push(...h(n[1], e));
+  const r = P(s);
+  for (const a of r)
+    t.push(...o(a, e));
+  return [...new Set(t)];
+}
+function F(s, e) {
+  const t = [], n = s.match(/<template[^>]*>([\s\S]*)<\/template>/i);
+  n?.[1] && (t.push(...i(n[1], e)), t.push(...o(n[1], e)));
+  const r = s.match(/<script[^>]*>([\s\S]*?)<\/script>/i);
+  return r?.[1] && t.push(...o(r[1], e)), [...new Set(t)];
+}
+function O(s, e) {
+  const t = [];
+  t.push(...i(s, e));
+  const n = v(s);
+  for (const l of n)
+    t.push(...o(l, e));
+  E.lastIndex = 0;
+  let r;
+  for (; (r = E.exec(s)) !== null; )
+    r[1] && t.push(r[1]);
+  const a = s.match(/<script[^>]*>([\s\S]*?)<\/script>/i);
+  return a?.[1] && t.push(...o(a[1], e)), [...new Set(t)];
+}
+function V(s, e) {
+  const t = [];
+  t.push(...i(s, e)), t.push(...p(s, e));
+  const n = s.match(/^---\n([\s\S]*?)\n---/);
+  return n?.[1] && t.push(...o(n[1], e)), [...new Set(t)];
+}
+function o(s, e) {
+  const t = [];
+  let n;
+  for (w.lastIndex = 0; (n = w.exec(s)) !== null; )
+    n[1] && t.push(...h(n[1], e));
+  for (C.lastIndex = 0; (n = C.exec(s)) !== null; )
+    n[1] && t.push(...h(n[1], e));
+  for (y.lastIndex = 0; (n = y.exec(s)) !== null; )
+    n[1] && t.push(...h(n[1], e));
+  return t;
+}
+function $(s, e) {
+  const t = [];
+  return t.push(...i(s, e)), t.push(...p(s, e)), [...new Set(t)];
+}
+const j = {
+  html: i,
+  htm: i,
+  vue: F,
+  svelte: O,
+  jsx: p,
+  tsx: p,
+  js: o,
+  ts: o,
+  astro: V,
+  mdx: $,
+  php: i,
+  erb: i,
+  twig: i,
+  "blade.php": i
+};
+function z(s) {
+  if (s.endsWith(".blade.php"))
+    return "blade.php";
+  const e = s.split(".");
+  return e[e.length - 1]?.toLowerCase() ?? "";
+}
+function W(s, e, t, n) {
+  const r = [], a = z(e);
+  if (t)
+    for (const c of t)
+      r.push(...c(s, e));
+  const l = j[a];
+  return l ? r.push(...l(s, n)) : r.push(...o(s, n)), [...new Set(r)];
+}
+function R(s, e) {
+  if (e.length === 0)
+    return s;
+  const t = [...e].sort().join(",");
+  return `${s}|${t}`;
+}
+function Y(s, e) {
+  const t = /* @__PURE__ */ new Map(), n = /* @__PURE__ */ new Map(), r = /* @__PURE__ */ new Map();
+  for (const l of e.utilities) {
+    t.set(l.name, l);
+    const c = /* @__PURE__ */ new Set();
+    for (const u of l.values)
+      c.add(R(u.key, u.modifiers));
+    r.set(l, c);
+  }
+  for (const l of e.modifiers)
+    for (const c of l.key)
+      n.set(c, l);
+  const a = [];
+  for (const l of s) {
+    const c = t.get(l.name) ?? null, u = [];
+    for (const d of l.modifiers) {
+      const m = n.get(d);
+      m && u.push(m);
+    }
+    let g = !1;
+    if (c) {
+      const d = R(
+        l.value,
+        l.modifiers
+      );
+      g = r.get(c)?.has(d) ?? !1;
+    }
+    a.push({
+      parsed: l,
+      factory: c,
+      modifierFactories: u,
+      exists: g
+    });
+  }
+  return a;
+}
+function q(s, e) {
+  const t = N(s, e);
+  return b(t);
+}
+function N(s, e) {
+  return (e ?? I)(s);
+}
+function D(s, e) {
+  return (t) => {
+    const n = N(
+      {
+        name: t.name,
+        value: t.value,
+        modifiers: t.modifiers
+      },
+      e
+    );
+    return s.has(n);
+  };
+}
+function J(s, e, t) {
+  const n = D(e, t);
+  return s.children.filter((r) => r.type !== "utility" ? !0 : n(r));
+}
+function ee(s) {
+  const e = /* @__PURE__ */ new Set();
+  for (const t of s)
+    e.add(t.parsed.raw);
+  return e;
+}
+function te(s) {
+  return s.filter((e) => e.factory !== null);
+}
+function se(s) {
+  return s.filter((e) => e.exists);
+}
+function ne(s) {
+  return s.filter((e) => e.parsed.isArbitrary);
+}
+function re(s) {
+  let e = 0;
+  for (let t = 0; t < s.length; t++) {
+    const n = s.charCodeAt(t);
+    e = (e << 5) - e + n, e = e & e;
+  }
+  return `${e.toString(16)}-${s.length}`;
+}
+function ae() {
+  const s = /* @__PURE__ */ new Map();
+  return {
+    get(e) {
+      return s.get(e)?.result ?? null;
+    },
+    set(e, t, n) {
+      s.set(e, {
+        hash: n,
+        result: t,
+        timestamp: Date.now()
+      });
+    },
+    isValid(e, t) {
+      const n = s.get(e);
+      return n !== void 0 && n.hash === t;
+    },
+    getIfValid(e, t) {
+      const n = s.get(e);
+      return n && n.hash === t ? n.result : null;
+    },
+    invalidate(e) {
+      s.delete(e);
+    },
+    clear() {
+      s.clear();
+    }
+  };
+}
+const f = /* @__PURE__ */ new Map();
+function k(s) {
+  const e = s.replace(/\\/g, "/");
+  if (f.has(e))
+    return f.get(e);
+  if (!e.includes("**") && !e.includes("*") && !e.includes("?"))
+    return f.set(e, null), null;
+  try {
+    const t = G(e), n = new RegExp(`^${t}$`);
+    return f.set(e, n), n;
+  } catch {
+    return f.set(e, null), null;
+  }
+}
+function le(s, e) {
+  let t = null;
+  return (...n) => {
+    t && clearTimeout(t), t = setTimeout(() => {
+      s(...n), t = null;
+    }, e);
+  };
+}
+function ce(s, e = {}) {
+  const { debounce: t = 100 } = e, n = /* @__PURE__ */ new Set();
+  let r = null;
+  const a = () => {
+    if (n.size > 0) {
+      const c = [...n];
+      n.clear(), s(c);
+    }
+  };
+  return { onChange: (c) => {
+    n.add(c), r && clearTimeout(r), r = setTimeout(() => {
+      a(), r = null;
+    }, t);
+  }, flush: a };
+}
+function B(s) {
+  return s.replace(/[.+^${}()|[\]\\]/g, "\\$&");
+}
+function G(s) {
+  return s.replace(/\*\*/g, "<<<GLOBSTAR>>>").replace(/\*/g, "<<<STAR>>>").replace(/\?/g, "<<<QUESTION>>>").split("<<<GLOBSTAR>>>").map(B).join(".*").replace(/<<<STAR>>>/g, "[^/]*").replace(/<<<QUESTION>>>/g, ".");
+}
+function ie(s, e) {
+  const t = s.replace(/\\/g, "/");
+  for (const n of e) {
+    const r = k(n);
+    if (r !== null) {
+      if (r.test(t))
+        return !0;
+    } else {
+      const a = n.replace(/\\/g, "/");
+      if (t === a)
+        return !0;
+    }
+  }
+  return !1;
+}
+export {
+  L as A,
+  Q as D,
+  M as U,
+  h as a,
+  i as b,
+  p as c,
+  F as d,
+  W as e,
+  O as f,
+  H as g,
+  V as h,
+  $ as i,
+  o as j,
+  q as k,
+  N as l,
+  Y as m,
+  D as n,
+  J as o,
+  Z as p,
+  ee as q,
+  te as r,
+  se as s,
+  ne as t,
+  re as u,
+  ae as v,
+  le as w,
+  ce as x,
+  ie as y,
+  K as z
+};

package/dist/watcher-C8V8DPY6.cjs

@@ -0,0 +1 @@
+"use strict";const w=require("@styleframe/core"),U=/_[a-zA-Z][a-zA-Z0-9-]*(?::[a-zA-Z0-9._-]+|:\[[^\]]+\])*/g,I=/^\[(.+)\]$/,O=["html","htm","vue","svelte","jsx","tsx","js","ts","astro","mdx","php","erb","twig","blade.php"],V=["**/node_modules/**","**/.git/**","**/dist/**","**/build/**","**/.next/**","**/.nuxt/**","**/coverage/**"];function D(s){if(!s.startsWith("_"))return null;const e=s.slice(1);if(!e)return null;const t=$(e);if(t.length===0)return null;let n,r,i=[];t.length===1?(n=t[0],r="default"):(r=t[t.length-1],n=t[t.length-2],i=t.slice(0,-2));let c=!1,l;const u=r.match(I);return u&&(c=!0,l=u[1]),{raw:s,name:n,value:r,modifiers:i,isArbitrary:c,arbitraryValue:l}}function $(s){const e=[];let t="",n=0;for(const r of s)r==="["?(n++,t+=r):r==="]"?(n--,t+=r):r===":"&&n===0?(t&&e.push(t),t=""):t+=r;return n!==0?[]:(t&&e.push(t),e)}function f(s,e){const t=s.match(e??U);return t?[...new Set(t)]:[]}function X(s,e,t=[]){const n=[...t,s];return e!=="default"&&n.push(e),`_${n.join(":")}`}const T=/\bclassName\s*=\s*\{/g,S=/\bclass\s*=\s*\{/g,A=/\bclass\s*=\s*["']([^"']+)["']/gi,E=/\bclassName\s*=\s*["']([^"']+)["']/gi,C=/\bclass:([^\s={>]+)/g,N=/'([^'\\]*(?:\\.[^'\\]*)*)'/g,R=/"([^"\\]*(?:\\.[^"\\]*)*)"/g,_=/`([^`\\]*(?:\\.[^`\\]*)*)`/g;function L(s){let e=1,t=0;for(;t<s.length&&e>0;){const n=s[t];n==="{"?e++:n==="}"&&e--,t++}return e!==0?null:s.slice(0,t-1)}function j(s){const e=[];T.lastIndex=0;let t;for(;(t=T.exec(s))!==null;){const n=t.index+t[0].length,r=s.slice(n),i=L(r);i!==null&&e.push(i)}return e}function z(s){const e=[];S.lastIndex=0;let t;for(;(t=S.exec(s))!==null;){const n=t.index+t[0].length,r=s.slice(n),i=L(r);i!==null&&e.push(i)}return e}function a(s,e){const t=[];A.lastIndex=0;let n;for(;(n=A.exec(s))!==null;)n[1]&&t.push(...f(n[1],e));return t}function m(s,e){const t=[];E.lastIndex=0;let n;for(;(n=E.exec(s))!==null;)n[1]&&t.push(...f(n[1],e));const r=j(s);for(const i of r)t.push(...o(i,e));return[...new Set(t)]}function M(s,e){const t=[],n=s.match(/<template[^>]*>([\s\S]*)<\/template>/i);n?.[1]&&(t.push(...a(n[1],e)),t.push(...o(n[1],e)));const r=s.match(/<script[^>]*>([\s\S]*?)<\/script>/i);return r?.[1]&&t.push(...o(r[1],e)),[...new Set(t)]}function b(s,e){const t=[];t.push(...a(s,e));const n=z(s);for(const c of n)t.push(...o(c,e));C.lastIndex=0;let r;for(;(r=C.exec(s))!==null;)r[1]&&t.push(r[1]);const i=s.match(/<script[^>]*>([\s\S]*?)<\/script>/i);return i?.[1]&&t.push(...o(i[1],e)),[...new Set(t)]}function F(s,e){const t=[];t.push(...a(s,e)),t.push(...m(s,e));const n=s.match(/^---\n([\s\S]*?)\n---/);return n?.[1]&&t.push(...o(n[1],e)),[...new Set(t)]}function o(s,e){const t=[];let n;for(N.lastIndex=0;(n=N.exec(s))!==null;)n[1]&&t.push(...f(n[1],e));for(R.lastIndex=0;(n=R.exec(s))!==null;)n[1]&&t.push(...f(n[1],e));for(_.lastIndex=0;(n=_.exec(s))!==null;)n[1]&&t.push(...f(n[1],e));return t}function P(s,e){const t=[];return t.push(...a(s,e)),t.push(...m(s,e)),[...new Set(t)]}const B={html:a,htm:a,vue:M,svelte:b,jsx:m,tsx:m,js:o,ts:o,astro:F,mdx:P,php:a,erb:a,twig:a,"blade.php":a};function G(s){if(s.endsWith(".blade.php"))return"blade.php";const e=s.split(".");return e[e.length-1]?.toLowerCase()??""}function k(s,e,t,n){const r=[],i=G(e);if(t)for(const l of t)r.push(...l(s,e));const c=B[i];return c?r.push(...c(s,n)):r.push(...o(s,n)),[...new Set(r)]}function y(s,e){if(e.length===0)return s;const t=[...e].sort().join(",");return`${s}|${t}`}function H(s,e){const t=new Map,n=new Map,r=new Map;for(const c of e.utilities){t.set(c.name,c);const l=new Set;for(const u of c.values)l.add(y(u.key,u.modifiers));r.set(c,l)}for(const c of e.modifiers)for(const l of c.key)n.set(l,c);const i=[];for(const c of s){const l=t.get(c.name)??null,u=[];for(const p of c.modifiers){const d=n.get(p);d&&u.push(d)}let x=!1;if(l){const p=y(c.value,c.modifiers);x=r.get(l)?.has(p)??!1}i.push({parsed:c,factory:l,modifierFactories:u,exists:x})}return i}function Q(s,e){const t=g(s,e);return w.classNameToCssSelector(t)}function g(s,e){return(e??w.defaultUtilitySelectorFn)(s)}function v(s,e){return t=>{const n=g({name:t.name,value:t.value,modifiers:t.modifiers},e);return s.has(n)}}function Y(s,e,t){const n=v(e,t);return s.children.filter(r=>r.type!=="utility"?!0:n(r))}function K(s){const e=new Set;for(const t of s)e.add(t.parsed.raw);return e}function Z(s){return s.filter(e=>e.factory!==null)}function J(s){return s.filter(e=>e.exists)}function W(s){return s.filter(e=>e.parsed.isArbitrary)}function q(s){let e=0;for(let t=0;t<s.length;t++){const n=s.charCodeAt(t);e=(e<<5)-e+n,e=e&e}return`${e.toString(16)}-${s.length}`}function ee(){const s=new Map;return{get(e){return s.get(e)?.result??null},set(e,t,n){s.set(e,{hash:n,result:t,timestamp:Date.now()})},isValid(e,t){const n=s.get(e);return n!==void 0&&n.hash===t},getIfValid(e,t){const n=s.get(e);return n&&n.hash===t?n.result:null},invalidate(e){s.delete(e)},clear(){s.clear()}}}const h=new Map;function te(s){const e=s.replace(/\\/g,"/");if(h.has(e))return h.get(e);if(!e.includes("**")&&!e.includes("*")&&!e.includes("?"))return h.set(e,null),null;try{const t=ie(e),n=new RegExp(`^${t}$`);return h.set(e,n),n}catch{return h.set(e,null),null}}function se(s,e){let t=null;return(...n)=>{t&&clearTimeout(t),t=setTimeout(()=>{s(...n),t=null},e)}}function ne(s,e={}){const{debounce:t=100}=e,n=new Set;let r=null;const i=()=>{if(n.size>0){const l=[...n];n.clear(),s(l)}};return{onChange:l=>{n.add(l),r&&clearTimeout(r),r=setTimeout(()=>{i(),r=null},t)},flush:i}}function re(s){return s.replace(/[.+^${}()|[\]\\]/g,"\\$&")}function ie(s){return s.replace(/\*\*/g,"<<<GLOBSTAR>>>").replace(/\*/g,"<<<STAR>>>").replace(/\?/g,"<<<QUESTION>>>").split("<<<GLOBSTAR>>>").map(re).join(".*").replace(/<<<STAR>>>/g,"[^/]*").replace(/<<<QUESTION>>>/g,".")}function ce(s,e){const t=s.replace(/\\/g,"/");for(const n of e){const r=te(n);if(r!==null){if(r.test(t))return!0}else{const i=n.replace(/\\/g,"/");if(t===i)return!0}}return!1}exports.ARBITRARY_VALUE_PATTERN=I;exports.DEFAULT_EXTENSIONS=O;exports.DEFAULT_IGNORE_PATTERNS=V;exports.UTILITY_CLASS_PATTERN=U;exports.classNameFromUtilityOptions=g;exports.createCache=ee;exports.createChangeHandler=ne;exports.createUtilityFilter=v;exports.debounce=se;exports.extractClasses=k;exports.extractFromAstro=F;exports.extractFromHTML=a;exports.extractFromJSX=m;exports.extractFromMDX=P;exports.extractFromStringLiterals=o;exports.extractFromSvelte=b;exports.extractFromVue=M;exports.extractUtilityClasses=f;exports.filterUtilities=Y;exports.generateUtilityClassName=X;exports.generateUtilitySelector=Q;exports.getArbitraryMatches=W;exports.getExistingMatches=J;exports.getUsedClassNames=K;exports.getValidMatches=Z;exports.hashContent=q;exports.matchUtilities=H;exports.matchesPatterns=ce;exports.parseUtilityClass=D;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@styleframe/scanner",
-  "version": "3.1.1",
+  "version": "3.1.2",
   "type": "module",
   "types": "./dist/index.d.ts",
   "module": "./dist/index.js",
@@ -10,6 +10,11 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js",
+      "require": "./dist/node.cjs"
     }
   },
   "files": [
@@ -22,13 +27,13 @@
     "fast-glob": "^3.3.2"
   },
   "peerDependencies": {
-    "@styleframe/core": "^3.3.0",
+    "@styleframe/core": "^3.5.0",
     "@styleframe/license": "^2.0.2"
   },
   "devDependencies": {
     "@styleframe/config-typescript": "^3.0.0",
     "@styleframe/config-vite": "^3.0.0",
-    "@styleframe/core": "^3.3.0",
+    "@styleframe/core": "^3.5.0",
     "@styleframe/license": "^2.0.2",
     "@vitest/coverage-v8": "^3.2.4",
     "typescript": "^5.8.3",