@barocss/server 0.5.0 → 0.6.0

package/dist/index.cjs

@@ -1,6 +1,5 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("@barocss/kit");class l{constructor(s={}){this.context=a.createContext(s)}parseClass(s){return a.parseClassToAst(s,this.context)}generateCss(s){const r=a.generateCssRules(s,this.context),t=new Set(r.flatMap(({rootCssList:e})=>e).filter(Boolean)),c=r.map(({css:e})=>e).filter(Boolean),o=this.colorVarsBlock([...t,...c].join(`
-`));return[...o?[o]:[],...t,...c].join(`
-`)}colorVarsBlock(s){const r=e=>[...e.matchAll(/var\((--[\w-]*color-[\w-]+)/g)].map(n=>n[1]),t=r(s);if(t.length===0)return"";const c=new Map;for(const e of this.context.themeToCssVars().matchAll(/^\s*(--[\w-]+):\s*(.+);$/gm))c.set(e[1],e[2]);const o=new Map;for(;t.length;){const e=t.pop(),n=c.get(e);n===void 0||o.has(e)||(o.set(e,n),t.push(...r(n)))}return o.size===0?"":`:root,:host {
-`+[...o].map(([e,n])=>`  ${e}: ${n};`).join(`
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("@barocss/kit"),a=h=>[...h.matchAll(/var\((--[\w-]+)/g)].map(t=>t[1]);class l{constructor(t={},s={}){this.classCache=new Map,this.themeDefs=null,this.cacheSize=Math.max(0,s.cacheSize??1e4),this.setConfig(t)}setConfig(t){this.context=i.createContext(t),this.classCache.clear(),this.themeDefs=null}parseClass(t){return i.parseClassToAst(t,this.context)}generateCss(t){const s=t.split(/\s+/).filter(Boolean).map(r=>this.entryFor(r)),e=this.uniqueRoots(s.flatMap(r=>r.roots)),c=this.sortRules(s.filter(r=>r.css)),o=[...e.flatMap(r=>r.refs),...c.flatMap(r=>r.refs)],n=this.themeVarsBlock(o);return[...n?[n]:[],...e.map(r=>r.css),...c.map(r=>r.css)].join(`
+`)}entryFor(t){const s=this.classCache.get(t);if(s)return this.classCache.delete(t),this.classCache.set(t,s),s;const e={css:"",key:null,refs:[],roots:[]};for(const{css:c,rootCssList:o}of i.generateCssRules(t,this.context)){c&&(e.css=c);for(const n of o){if(!n)continue;const r=/^\s*@property\s+(--[\w-]+)/.exec(n)?.[1]??n;e.roots.push({css:n,dedupeKey:r,refs:a(n)})}}return e.css&&(e.key=i.ruleSortKey(e.css),e.refs=a(e.css)),this.cacheSize>0&&(this.classCache.size>=this.cacheSize&&this.classCache.delete(this.classCache.keys().next().value),this.classCache.set(t,e)),e}generateCssForClasses(t){return t.map(s=>({className:s,css:this.generateCss(s)}))}uniqueRoots(t){const s=new Set;return t.filter(({dedupeKey:e})=>!s.has(e)&&!!s.add(e))}sortRules(t){return t.map((s,e)=>({entry:s,i:e})).sort((s,e)=>i.compareKeys(s.entry.key,e.entry.key)||s.i-e.i).map(({entry:s})=>s)}themeVarsBlock(t){const s=t;if(s.length===0)return"";let e=this.themeDefs;if(!e){e=this.themeDefs=new Map;for(const o of this.context.themeToCssVars().matchAll(/^\s*(--[\w-]+):\s*(.+);$/gm))e.set(o[1],o[2])}const c=new Map;for(;s.length;){const o=s.pop(),n=e.get(o);n===void 0||c.has(o)||(c.set(o,n),s.push(...a(n)))}return c.size===0?"":`:root,:host {
+`+[...c].map(([o,n])=>`  ${o}: ${n};`).join(`
 `)+`
-}`}generateCssForClasses(s){return s.map(t=>({className:t,css:this.generateCss(t)}))}}exports.ServerRuntime=l;
+}`}}exports.ServerRuntime=l;

package/dist/index.d.ts

@@ -1,31 +1,47 @@
 import { Config } from '@barocss/kit';
-/**
- * Server-side runtime for Barocss
- *
- * This provides server-side utilities for parsing classes and generating CSS
- * without browser-specific features like DOM manipulation or MutationObserver.
- */
+export interface ServerRuntimeOptions {
+    /** Max classes kept in the per-class generation cache (LRU). Default 10000; 0 disables caching. */
+    cacheSize?: number;
+}
 export declare class ServerRuntime {
     private context;
-    constructor(config?: Config);
+    private readonly cacheSize;
+    /** class -> generated entry; Map insertion order doubles as LRU order (#272). */
+    private classCache;
+    /** Theme var definitions parsed once from themeToCssVars() (#272). */
+    private themeDefs;
+    constructor(config?: Config, options?: ServerRuntimeOptions);
+    /** Replace the config (theme included). Drops every cached result derived from the previous one. */
+    setConfig(config: Config): void;
     /**
      * Parse a class name and return its AST
      */
     parseClass(className: string): import('@barocss/kit').AstNode[];
     /**
-     * Generate CSS for a class name
+     * Generate CSS for a class name (or whitespace-separated class names) as one complete sheet (#267):
+     * one `:root,:host` block defining every theme var the output references, each root/@property block
+     * once, then the class rules in Tailwind variant order (base < sm < md < lg ...).
      */
     generateCss(className: string): string;
+    /** Generate (or reuse) one class's rules. Same per-class output generateCssRules gives for a class list. */
+    private entryFor;
     /**
-     * #228: theme colours are emitted as var(--color-*). Define only the ones this output references
-     * (the full theme block is large), including --color-* vars those definitions reference in turn.
-     */
-    private colorVarsBlock;
-    /**
-     * Parse multiple classes and return their CSS
+     * CSS per class, in input order. Each entry is self-contained (its own `:root,:host` vars block,
+     * @property blocks and variant-sorted rules), so entries repeat shared blocks and are not ordered
+     * against each other. For one complete sheet use `generateCss(classes.join(' '))`.
      */
     generateCssForClasses(classes: string[]): {
         className: string;
         css: string;
     }[];
+    /** Dedupe root-level blocks by content, and @property blocks by property name. */
+    private uniqueRoots;
+    /** Stable sort by the #254 variant key shared with @barocss/browser. */
+    private sortRules;
+    /**
+     * #228 generalised (#267): define every var(--x) the output references that the theme defines
+     * (radius, text, spacing, shadow, font, colour ...), including vars those definitions reference.
+     * themeToCssVars() already omits self-referencing entries (#260).
+     */
+    private themeVarsBlock;
 }

package/dist/index.es.js

@@ -1,52 +1,86 @@
-import { createContext as c, parseClassToAst as l, generateCssRules as i } from "@barocss/kit";
-class p {
-  constructor(e = {}) {
-    this.context = c(e);
+import { createContext as h, parseClassToAst as l, generateCssRules as f, ruleSortKey as u, compareKeys as p } from "@barocss/kit";
+const a = (i) => [...i.matchAll(/var\((--[\w-]+)/g)].map((t) => t[1]);
+class C {
+  constructor(t = {}, s = {}) {
+    this.classCache = /* @__PURE__ */ new Map(), this.themeDefs = null, this.cacheSize = Math.max(0, s.cacheSize ?? 1e4), this.setConfig(t);
+  }
+  /** Replace the config (theme included). Drops every cached result derived from the previous one. */
+  setConfig(t) {
+    this.context = h(t), this.classCache.clear(), this.themeDefs = null;
   }
   /**
    * Parse a class name and return its AST
    */
-  parseClass(e) {
-    return l(e, this.context);
+  parseClass(t) {
+    return l(t, this.context);
   }
   /**
-   * Generate CSS for a class name
+   * Generate CSS for a class name (or whitespace-separated class names) as one complete sheet (#267):
+   * one `:root,:host` block defining every theme var the output references, each root/@property block
+   * once, then the class rules in Tailwind variant order (base < sm < md < lg ...).
    */
-  generateCss(e) {
-    const r = i(e, this.context), t = new Set(r.flatMap(({ rootCssList: s }) => s).filter(Boolean)), a = r.map(({ css: s }) => s).filter(Boolean), o = this.colorVarsBlock([...t, ...a].join(`
-`));
-    return [...o ? [o] : [], ...t, ...a].join(`
+  generateCss(t) {
+    const s = t.split(/\s+/).filter(Boolean).map((r) => this.entryFor(r)), e = this.uniqueRoots(s.flatMap((r) => r.roots)), c = this.sortRules(s.filter((r) => r.css)), n = [...e.flatMap((r) => r.refs), ...c.flatMap((r) => r.refs)], o = this.themeVarsBlock(n);
+    return [...o ? [o] : [], ...e.map((r) => r.css), ...c.map((r) => r.css)].join(`
 `);
   }
+  /** Generate (or reuse) one class's rules. Same per-class output generateCssRules gives for a class list. */
+  entryFor(t) {
+    const s = this.classCache.get(t);
+    if (s)
+      return this.classCache.delete(t), this.classCache.set(t, s), s;
+    const e = { css: "", key: null, refs: [], roots: [] };
+    for (const { css: c, rootCssList: n } of f(t, this.context)) {
+      c && (e.css = c);
+      for (const o of n) {
+        if (!o) continue;
+        const r = /^\s*@property\s+(--[\w-]+)/.exec(o)?.[1] ?? o;
+        e.roots.push({ css: o, dedupeKey: r, refs: a(o) });
+      }
+    }
+    return e.css && (e.key = u(e.css), e.refs = a(e.css)), this.cacheSize > 0 && (this.classCache.size >= this.cacheSize && this.classCache.delete(this.classCache.keys().next().value), this.classCache.set(t, e)), e;
+  }
   /**
-   * #228: theme colours are emitted as var(--color-*). Define only the ones this output references
-   * (the full theme block is large), including --color-* vars those definitions reference in turn.
+   * CSS per class, in input order. Each entry is self-contained (its own `:root,:host` vars block,
+   * @property blocks and variant-sorted rules), so entries repeat shared blocks and are not ordered
+   * against each other. For one complete sheet use `generateCss(classes.join(' '))`.
    */
-  colorVarsBlock(e) {
-    const r = (s) => [...s.matchAll(/var\((--[\w-]*color-[\w-]+)/g)].map((n) => n[1]), t = r(e);
-    if (t.length === 0) return "";
-    const a = /* @__PURE__ */ new Map();
-    for (const s of this.context.themeToCssVars().matchAll(/^\s*(--[\w-]+):\s*(.+);$/gm)) a.set(s[1], s[2]);
-    const o = /* @__PURE__ */ new Map();
-    for (; t.length; ) {
-      const s = t.pop(), n = a.get(s);
-      n === void 0 || o.has(s) || (o.set(s, n), t.push(...r(n)));
-    }
-    return o.size === 0 ? "" : `:root,:host {
-` + [...o].map(([s, n]) => `  ${s}: ${n};`).join(`
-`) + `
-}`;
+  generateCssForClasses(t) {
+    return t.map((s) => ({ className: s, css: this.generateCss(s) }));
+  }
+  /** Dedupe root-level blocks by content, and @property blocks by property name. */
+  uniqueRoots(t) {
+    const s = /* @__PURE__ */ new Set();
+    return t.filter(({ dedupeKey: e }) => !s.has(e) && !!s.add(e));
+  }
+  /** Stable sort by the #254 variant key shared with @barocss/browser. */
+  sortRules(t) {
+    return t.map((s, e) => ({ entry: s, i: e })).sort((s, e) => p(s.entry.key, e.entry.key) || s.i - e.i).map(({ entry: s }) => s);
   }
   /**
-   * Parse multiple classes and return their CSS
+   * #228 generalised (#267): define every var(--x) the output references that the theme defines
+   * (radius, text, spacing, shadow, font, colour ...), including vars those definitions reference.
+   * themeToCssVars() already omits self-referencing entries (#260).
    */
-  generateCssForClasses(e) {
-    return e.map((t) => ({
-      className: t,
-      css: this.generateCss(t)
-    }));
+  themeVarsBlock(t) {
+    const s = t;
+    if (s.length === 0) return "";
+    let e = this.themeDefs;
+    if (!e) {
+      e = this.themeDefs = /* @__PURE__ */ new Map();
+      for (const n of this.context.themeToCssVars().matchAll(/^\s*(--[\w-]+):\s*(.+);$/gm)) e.set(n[1], n[2]);
+    }
+    const c = /* @__PURE__ */ new Map();
+    for (; s.length; ) {
+      const n = s.pop(), o = e.get(n);
+      o === void 0 || c.has(n) || (c.set(n, o), s.push(...a(o)));
+    }
+    return c.size === 0 ? "" : `:root,:host {
+` + [...c].map(([n, o]) => `  ${n}: ${o};`).join(`
+`) + `
+}`;
   }
 }
 export {
-  p as ServerRuntime
+  C as ServerRuntime
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barocss/server",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/barocss/barocss.git",
@@ -26,7 +26,7 @@
   },
   "dependencies": {
     "jsdom": "^26.1.0",
-    "@barocss/kit": "0.5.0"
+    "@barocss/kit": "0.6.0"
   },
   "devDependencies": {
     "vite": "^7.1.3",