@barocss/browser 0.8.1 → 0.8.2

package/dist/index.cjs

@@ -0,0 +1,9 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@barocss/kit");var t=class{insertSorted(t,n,r){let i=t.keys??=[],a=(0,e.upperBound)(i,r),o=t.styleElement.sheet;o&&o.cssRules.length===i.length?(o.insertRule(this.escapeCssRule(n),a),t.styles.splice(a,0,n)):(t.styles.splice(a,0,n),t.styleElement.textContent=t.styles.join(`
+`)+`
+`),i.splice(a,0,r)}constructor(t,n=50,r=`barocss-style-partition-`,i=t=>(0,e.parseClassName)(t).utility?.category){this.partitions=[],this.categoryPartitions=new Map,this.partitionCounter=0,this.maxRulesPerPartition=50,this.classToPartitionMap=new Map,this.classToCategoryPartitionMap=new Map,this.styleIdPrefix=`barocss-style-partition-`,this.insertionPoint=t,this.maxRulesPerPartition=n,this.styleIdPrefix=r,this.getCategory=i,this.initializeDefaultPartition()}initializeDefaultPartition(){this.createNewPartition()}createNewCategoryPartition(e,t=!1){let n={id:this.styleIdPrefix+`-${e}`,styles:[],styleElement:document.createElement(`style`)};n.styleElement.id=n.id,n.styleElement.setAttribute(`data-barocss`,`partition`),n.styleElement.setAttribute(`data-category`,e);let r=this.insertionPoint.ownerDocument?.head;return t&&r?r.insertBefore(n.styleElement,r.firstChild):this.insertionPoint.appendChild(n.styleElement),this.categoryPartitions.set(e,n),n}createNewPartition(){let e={id:this.styleIdPrefix+`-${this.partitionCounter++}`,styles:[],styleElement:document.createElement(`style`)};return this.partitions.push(e),e.styleElement.id=e.id,e.styleElement.setAttribute(`data-barocss`,`partition`),e.styleElement.setAttribute(`data-partition-index`,this.partitionCounter.toString()),this.insertionPoint.appendChild(e.styleElement),e}hasRule(e){return this.classToPartitionMap.has(e)}hasCategoryRule(e,t){return this.classToCategoryPartitionMap.get(e)===t}setRuleCache(e,t){this.classToPartitionMap.set(e,t)}setCategoryRuleCache(e,t){this.classToCategoryPartitionMap.set(e,t)}get currentPartition(){return this.partitions[this.partitions.length-1]}getCategoryPartition(e){return this.categoryPartitions.get(e)}hasDetachedPartitions(){return[...this.partitions,...this.categoryPartitions.values()].some(e=>!e.styleElement.isConnected)}escapeCssRule(e){return e.replace(/\\\//g,`\\/`)}addRule(t){if(this.hasRule(t))return!1;let n=(0,e.ruleSortKey)(t),r=this.partitions.findIndex(t=>{let r=t.keys;return!!r&&r.length>0&&(0,e.compareKeys)(r[r.length-1],n)>0});r===-1&&(this.currentPartition.styles.length>=this.maxRulesPerPartition&&this.createNewPartition(),r=this.partitions.length-1);let i=this.partitions[r];try{return this.insertSorted(i,t,n),this.setRuleCache(t,r),!0}catch(n){return(0,e.isDebug)()&&console.warn(`[StylePartitionManager] Failed to insert rule: ${t}`,n),!1}}addCategoryRule(t,n){if(this.hasCategoryRule(t,n))return!1;let r=this.getCategoryPartition(n);r||=this.createNewCategoryPartition(n);try{this.insertSorted(r,t,(0,e.ruleSortKey)(t))}catch(r){return(0,e.isDebug)()&&console.warn(`[StylePartitionManager] Failed to insert rule in category: ${n} ${t}`,r),!1}return this.setCategoryRuleCache(t,n),!0}addRootRules(t){let n=this.getCategoryPartition(`root`);n||=this.createNewCategoryPartition(`root`);try{let e=n.styleElement.sheet;for(let r of t)e?e.insertRule(this.escapeCssRule(r),e.cssRules.length):n.styleElement.textContent+=r+`
+`}catch(n){return(0,e.isDebug)()&&console.warn(`[StylePartitionManager] Failed to insert rule in category: root ${t.join(`
+`)}`,n),{success:0,failed:t.length}}return{success:t.length,failed:0}}addRules(e){let t=0,n=0;for(let r of e){let e=this.getCategory(r.cls);if(e)for(let t of r.cssList)this.addCategoryRule(t,e);else for(let e of r.cssList)this.addRule(e)?t++:n++}return{success:t,failed:n}}removeRule(e,t){let n;if(t){if(this.classToCategoryPartitionMap.get(e)!==t)return!1;n=this.categoryPartitions.get(t)}else{let t=this.classToPartitionMap.get(e);n=t===void 0?void 0:this.partitions[t]}if(!n)return!1;let r=n.styles.indexOf(e);if(r===-1)return!1;let i=n.styleElement.sheet,a=!!i&&i.cssRules.length===n.styles.length;return n.styles.splice(r,1),n.keys?.splice(r,1),a&&i?i.deleteRule(r):n.styleElement.textContent=n.styles.length?n.styles.join(`
+`)+`
+`:``,t?this.classToCategoryPartitionMap.delete(e):this.classToPartitionMap.delete(e),!0}get ruleCount(){return this.classToPartitionMap.size+this.classToCategoryPartitionMap.size}findRulePartition(e){let t=this.classToPartitionMap.get(e);if(t!==void 0&&this.partitions[t])return this.partitions[t];let n=this.classToCategoryPartitionMap.get(e);return n===void 0?null:this.categoryPartitions.get(n)||null}updateRuleContent(t,n,r=!1){let i=this.getCategoryPartition(t);if(i)i.styleElement.textContent=n;else{let i=this.createNewCategoryPartition(t,r);(0,e.isDebug)()&&console.log(`[StylePartitionManager] Created new partition for category: ${t}`),i.styleElement.textContent=n}}cleanup(){this.partitions.forEach(e=>{e.styleElement.parentNode&&e.styleElement.parentNode.removeChild(e.styleElement)}),this.categoryPartitions.forEach(e=>{e.styleElement.parentNode&&e.styleElement.parentNode.removeChild(e.styleElement)}),this.partitions=[],this.categoryPartitions.clear(),this.partitionCounter=0,this.classToPartitionMap.clear(),this.classToCategoryPartitionMap.clear()}};function n(e){return e?typeof e==`object`&&typeof e.baseVal==`string`?e.baseVal:e.toString():``}function r(e){return e?n(e).split(/\s+/).filter(Boolean):[]}var i=class{constructor(t,n,r=t=>(0,e.parseClassName)(t).utility?.category){this.observer=null,this.gc=null,this.incrementalParser=t,this.BrowserRuntime=n,this.getCategory=r}setGc(e){this.gc=e}setParser(e){this.incrementalParser=e}observe(e=document.body,t){return typeof window>`u`?new MutationObserver(()=>{}):(this.observer&&this.observer.disconnect(),this.gc?.setRoot(e),this.observer=new MutationObserver(t=>{let n=new Set,i=this.gc;if(t.forEach(t=>{if(i&&(t.type===`attributes`?i.reconcile(t.target):t.type===`childList`&&(t.removedNodes.forEach(e=>i.reconcileTree(e)),t.addedNodes.forEach(e=>i.reconcileTree(e)))),t.type===`attributes`&&t.attributeName===`class`&&e.contains(t.target)){let e=t.target;e.className&&r(e.className).forEach(e=>{this.incrementalParser.isProcessed(e)||n.add(e)})}t.type===`childList`&&t.addedNodes.forEach(t=>{if(t.nodeType===Node.ELEMENT_NODE&&e.contains(t)){let e=t;this.processElement(e,n),e.querySelectorAll(`[class]`).forEach(e=>{this.processElement(e,n)})}})}),n.size>0){let e=Array.from(n),t=this.incrementalParser.processClasses(e);this.BrowserRuntime?.applyParseResults(t)}else this.BrowserRuntime?.applyParseResults([]);i?.afterBatch()}),this.observer.observe(e,{attributes:!0,subtree:!0,attributeFilter:[`class`],childList:!0}),t?.scan&&this.scanExistingClasses(e,t),this.observer)}scanExistingClasses(e,t){let n=new Set;e.className&&r(e.className).forEach(e=>{this.incrementalParser.isProcessed(e)||n.add(e)});let i=e.querySelectorAll(`[class]`);for(let e of i)if(e.className){let t=r(e.className);for(let e of t)this.incrementalParser.isProcessed(e)||n.add(e)}if(n.size>0){let e=Array.from(n),r=this.incrementalParser.processClasses(e),i=r.filter(e=>this.getCategory(e.cls)===`layout`),a=r.filter(e=>this.getCategory(e.cls)!==`layout`);this.BrowserRuntime?.applyParseResults(i),t?.onReady?.(),this.BrowserRuntime?.applyParseResults(a)}else t?.onReady?.()}processElement(e,t){e.className&&r(e.className).forEach(e=>{this.incrementalParser.isProcessed(e)||t.add(e)})}disconnect(){this.observer&&=(this.observer.disconnect(),null)}};function a(e){return e.replace(/\\([0-9a-fA-F]{1,6})\s?|\\(.)/g,(e,t,n)=>t?String.fromCodePoint(parseInt(t,16)):n)}var o=/^\s*(?::(?:where|is)\(\s*)?\.((?:\\[0-9a-fA-F]{1,6}\s?|\\.|[\w-]|[^\x00-\x7F])+)/;function s(e){let t=[],n=0,r=0;for(let i=0;i<e.length;i++){let a=e[i];a===`\\`?i++:a===`(`||a===`[`?n++:a===`)`||a===`]`?n--:a===`,`&&n===0&&(t.push(e.slice(r,i)),r=i+1)}return t.push(e.slice(r)),t}function c(e,t=new Set){for(let n of Array.from(e)){if(n.type===7&&typeof n.name==`string`){t.add(n.name);continue}let e=n.cssRules;e&&e.length&&c(e,t)}return t}function l(e,t=new Set){for(let n of Array.from(e)){let e=n.selectorText;if(typeof e==`string`)for(let n of s(e)){let e=o.exec(n);e&&t.add(a(e[1]))}let r=n.cssRules;r&&r.length&&l(r,t)}return t}var u=class{constructor(e,t,n,r=()=>Date.now()){this.host=e,this.graceMs=t,this.maxRules=n,this.now=r,this.counts=new Map,this.counted=new WeakMap,this.candidates=new Map,this.timer=null,this.root=null}setRoot(e){this.counts.clear(),this.counted=new WeakMap,this.candidates.clear(),this.cancel(),this.root=e,this.reconcileTree(e)}count(e){return this.counts.get(e)??0}reconcileTree(e){if(e.nodeType!==1)return;let t=e;this.reconcile(t),t.querySelectorAll(`[class]`).forEach(e=>this.reconcile(e))}reconcile(e){let t=this.root,n=t&&t.contains(e)?Array.from(new Set(r(e.getAttribute(`class`)))):[],i=this.counted.get(e);if(!i&&n.length===0)return;let a=new Set(i??[]),o=new Set(n);for(let e of o){if(a.has(e))continue;let t=(this.counts.get(e)??0)+1;this.counts.set(e,t),this.candidates.delete(e)}for(let e of a){if(o.has(e))continue;let t=(this.counts.get(e)??0)-1;t>0?this.counts.set(e,t):(this.counts.delete(e),this.candidates.delete(e),this.candidates.set(e,this.now()))}n.length?this.counted.set(e,n):this.counted.delete(e)}afterBatch(){this.candidates.size!==0&&(this.host.cachedCount()>this.maxRules?this.schedule(0):this.schedule(this.graceMs))}schedule(e){if(this.timer!==null){if(e>0)return;clearTimeout(this.timer)}this.timer=setTimeout(()=>{this.timer=null,this.sweep()},e)}sweep(){let e=this.now(),t=Math.max(0,this.host.cachedCount()-this.maxRules),n=[],r=0;for(let[i,a]of this.candidates){let o=e-a>=this.graceMs;!o&&r>=t||(this.candidates.delete(i),!(this.count(i)>0||this.inDom(i)||this.host.isPermanent(i))&&(n.push(i),o||r++))}n.length&&this.host.reclaim(n),this.candidates.size&&this.schedule(this.graceMs)}inDom(e){let t=this.root;if(!t)return!1;let n=t.ownerDocument??document;return t.classList.contains(e)||n.documentElement.classList.contains(e)||n.getElementsByClassName(e).length>0}cancel(){this.timer!==null&&clearTimeout(this.timer),this.timer=null}stats(){return{trackedClasses:this.counts.size,candidates:this.candidates.size}}},d=`style[data-barocss-ssr]`,f=`@layer theme, base, components, utilities;`,p=class{constructor(n={}){this.cache=new Map,this.rootCache=new Set,this.isDestroyed=!1,this.existing=null,this.existingKeyframes=new Set,this.existingSheetCount=-1,this.pinned=new Set,this.gc=null,this.reclaimedCount=0,this.ssrRules=[],this.ssrClasses=new Set,this.observedOnce=!1,this.getCategory=t=>(0,e.parseClassName)(t,this.context).utility?.category;let r={};this.options={config:n.config||r,styleId:n.styleId||`barocss-runtime`,insertionPoint:n.insertionPoint||`head`,maxRulesPerPartition:n.maxRulesPerPartition||50,skipExisting:n.skipExisting??!1,gc:n.gc??!0,gcGraceMs:n.gcGraceMs??3e3,maxRules:n.maxRules??1/0},this.context=(0,e.createContext)(this.options.config),this.incrementalParser=new e.IncrementalParser(this.context),this.changeDetector=new i(this.incrementalParser,this,this.getCategory),this.stylePartitionManager=new t(this.getInsertionPoint(),this.options.maxRulesPerPartition,`${this.options.styleId}-partition`,this.getCategory),this.options.gc&&(this.gc=new u({reclaim:e=>this.reclaim(e),isPermanent:e=>this.isPermanent(e),cachedCount:()=>this.cache.size},this.options.gcGraceMs,this.options.maxRules),this.changeDetector.setGc(this.gc)),this.init()}debugLog(t,n,r){(0,e.isDebug)()&&(console[t]||console.log)(`[BrowserRuntime:${t.toUpperCase()}] ${n}`,r||``)}init(){this.debugLog(`debug`,`init`),this.injectPreflightCSS(),this.ensureCssVars(),this.adoptSsrSheets()}adoptSsrSheets(){if(typeof document>`u`)return;let e=[];if(document.head){for(let t of Array.from(document.head.querySelectorAll(`${d}:not([data-barocss-adopted])`))){let n=t.sheet;if(!n)continue;t.setAttribute(`data-barocss-adopted`,``);let r=[];for(let e=n.cssRules.length-1;e>=0;e--){let t=n.cssRules[e],i=l([t]);i.size!==0&&(i.forEach(e=>this.ssrClasses.add(e)),r.unshift({css:t.cssText,cls:i.values().next().value}),n.deleteRule(e))}e.push(...r)}e.length!==0&&(this.ssrRules.push(...e),this.insertSsrRules(e))}}insertSsrRules(e){for(let{css:t,cls:n}of e){let e=this.getCategory(n);e?this.stylePartitionManager.addCategoryRule(t,e):this.stylePartitionManager.addRule(t)}}injectPreflightCSS(){let e=this.options.config.preflight??!0;if(e){let t=this.context.getPreflightCSS(e);this.stylePartitionManager.updateRuleContent(`preflight`,`${f}\n@layer base {\n${t}\n}`,!0)}}ensureCssVars(){if(this.isDestroyed)return;let e=this.context.themeToCssVars?this.context.themeToCssVars():`:root { /* CSS Variables will be generated here */ }`;this.stylePartitionManager.updateRuleContent(`css-vars`,e)}getInsertionPoint(){if(typeof this.options.insertionPoint!=`string`)return this.options.insertionPoint;switch(this.options.insertionPoint){case`body`:return document.body||document.head;default:return document.head}}addClass(e){if(this.isDestroyed)return;let t=this.normalizeClasses(e).filter(Boolean);t.forEach(e=>this.pinned.add(e)),this.processClasses(t)}processClasses(e){this.processClassesIncremental(e)}processClassesIncremental(e){let t=typeof window<`u`,n=this.incrementalParser.processClasses(e);this.debugLog(`debug`,`results`,{results:n,classList:e}),this.applyParseResults(n,{isBrowser:t})}applyParseResults(e,t){if(this.isDestroyed)return;if(this.getInsertionPoint().isConnected&&this.stylePartitionManager.hasDetachedPartitions()){let t=Array.from(this.cache.values());this.reset(),e=[...t,...e],e.forEach(e=>this.incrementalParser.markProcessed(e.cls))}if(this.ssrClasses.size>0&&(e=e.filter(e=>!this.ssrClasses.has(e.cls))),this.options.skipExisting&&e.length>0&&typeof document<`u`){let t=this.getExistingClasses();e=e.filter(e=>!t.has(e.cls))}if(e.length===0)return;let n=[],r=[],i=this.options.skipExisting&&typeof document<`u`?(this.getExistingClasses(),this.existingKeyframes):null;for(let t of e)if(t.css&&Array.isArray(t.cssList)&&(n.push(t),this.cache.set(t.cls,t)),t.rootCss&&Array.isArray(t.rootCssList))for(let e of t.rootCssList){if(i?.size){let t=/^\s*@keyframes\s+([^\s{]+)/.exec(e)?.[1];if(t&&i.has(t))continue}this.rootCache.has(e)||(this.rootCache.add(e),r.push(e))}r.length>0&&this.stylePartitionManager.addRootRules(r.filter(Boolean)),n.length>0&&this.stylePartitionManager.addRules(n),this.debugLog(`info`,`Applied ${e.length} parser results`,{cssRuleCount:n.length,rootCssCount:r.length})}isPermanent(e){return this.pinned.has(e)||this.ssrClasses.has(e)||typeof document>`u`?!0:this.getExistingClasses().has(e)}reclaim(e){if(this.isDestroyed)return;let t=e.filter(e=>this.cache.has(e));if(t.length===0)return;let n=t.map(e=>this.cache.get(e));t.forEach(e=>{this.cache.delete(e),this.incrementalParser.unmarkProcessed(e)});let r=new Set;for(let e of this.cache.values())e.cssList.forEach(e=>r.add(e));for(let e of n){let t=this.getCategory(e.cls);for(let n of e.cssList)r.has(n)||this.stylePartitionManager.removeRule(n,t)}this.reclaimedCount+=t.length}getExistingClasses(){let e=new Set(Array.from(document.querySelectorAll(`style[data-barocss]`),e=>e.sheet)),t=Array.from(document.styleSheets).filter(t=>{if(e.has(t))return!1;let n=t.ownerNode;return!(n&&typeof n.hasAttribute==`function`&&(n.hasAttribute(`data-barocss`)||(n.id||``).startsWith(this.options.styleId)))});if(this.existing&&t.length===this.existingSheetCount)return this.existing;let n=new Set,r=new Set;for(let e of t){let t;try{t=e.cssRules}catch{continue}l(t,n),c(t,r)}return this.existingKeyframes=r,this.existing=n,this.existingSheetCount=t.length,n}observe(e=document.body,t){return this.observedOnce||(this.observedOnce=!0,this.adoptSsrSheets()),this.changeDetector.observe(e,t)}normalizeClasses(e){return Array.isArray(e)?e.flatMap(e=>e.split(/\s+/)):e.split(/\s+/)}has(e){return this.cache.has(e)}getCss(e){return this.cache.get(e)?.cssList.join(`
+`)}getAllCss(){return[...this.rootCache,...Array.from(this.cache.values()).flatMap(e=>e.cssList)].join(`
+`)}getClasses(){return Array.from(this.cache.keys())}getCacheStats(){let e=this.incrementalParser.getStats();return{runtime:{cachedClasses:this.cache.size,rootCacheSize:this.rootCache.size,ruleCount:this.stylePartitionManager.ruleCount,reclaimedClasses:this.reclaimedCount,gc:this.gc?.stats()??null},ast:e.cacheStats.ast,incremental:e}}clearCaches(){this.isDestroyed||(this.cache.clear(),this.rootCache.clear(),(0,e.clearAstCache)(this.context),this.incrementalParser.clearProcessed(),this.stylePartitionManager.cleanup(),this.stylePartitionManager=new t(this.getInsertionPoint(),this.options.maxRulesPerPartition,`${this.options.styleId}-partition`,this.getCategory),this.injectPreflightCSS(),this.ensureCssVars(),this.insertSsrRules(this.ssrRules))}reset(){this.isDestroyed||(this.cache.clear(),this.rootCache.clear(),this.incrementalParser.clearProcessed(),this.stylePartitionManager.cleanup(),this.stylePartitionManager=new t(this.getInsertionPoint(),this.options.maxRulesPerPartition,`${this.options.styleId}-partition`,this.getCategory),this.injectPreflightCSS(),this.ensureCssVars(),this.insertSsrRules(this.ssrRules))}updateConfig(t){if(this.isDestroyed)return;let n=Array.from(this.cache.keys());this.options.config=t,this.context=(0,e.createContext)(t),this.incrementalParser=new e.IncrementalParser(this.context),this.changeDetector.setParser(this.incrementalParser),this.reset(),n.length>0&&this.addClass(n)}removeClass(e){if(this.isDestroyed)return;let t=new Set(this.normalizeClasses(e)),n=Array.from(this.cache.values()).filter(e=>!t.has(e.cls));n.length!==this.cache.size&&(this.reset(),n.forEach(e=>this.incrementalParser.markProcessed(e.cls)),this.applyParseResults(n))}destroy(){this.isDestroyed||=(this.changeDetector.disconnect(),this.gc?.cancel(),this.stylePartitionManager.cleanup(),this.cache.clear(),this.rootCache.clear(),!0)}getStats(){return{cachedClasses:this.cache.size,styleElementId:this.options.styleId,isDestroyed:this.isDestroyed,config:this.options.config,cacheStats:this.getCacheStats()}}},m=null,h;function g(e={}){return!m||m.getStats().isDestroyed?(m=new p(e),h=e.config):e.config&&e.config!==h&&(m.updateConfig(e.config),h=e.config),m}function _({loadingClassName:e=`baro-boot`,...t}={}){if(!document.body){document.addEventListener(`DOMContentLoaded`,()=>_({loadingClassName:e,...t}),{once:!0});return}let n=`${e}-doing`,r=`${e}-done`;try{document.body.classList.add(n),g(t).observe(document.body,{scan:!0,onReady:()=>{document.body.classList.remove(n),document.body.classList.add(r)}})}catch(e){document.body?.classList.remove(n),console.error(`BaroCSS boot failed:`,e)}}var v=_;function y(e){if(!e||typeof e!=`object`||Array.isArray(e))return[];let t=e.elements;if(!t||typeof t!=`object`||Array.isArray(t))return[];let n=new Set;for(let e of Object.keys(t)){let r=t[e];if(!r||typeof r!=`object`||Array.isArray(r))continue;let i=r.props;if(!i||typeof i!=`object`||Array.isArray(i))continue;let a=i.className;if(typeof a==`string`)for(let e of a.split(/\s+/))e&&n.add(e)}return Array.from(n)}function b(e,t){let n=y(e);n.length>0&&t.addClass(n)}var x={colors:Object.fromEntries(`background.foreground.card.card-foreground.popover.popover-foreground.primary.primary-foreground.secondary.secondary-foreground.muted.muted-foreground.accent.accent-foreground.destructive.border.input.ring.chart-1.chart-2.chart-3.chart-4.chart-5.sidebar.sidebar-foreground.sidebar-primary.sidebar-primary-foreground.sidebar-accent.sidebar-accent-foreground.sidebar-border.sidebar-ring`.split(`.`).map(e=>[e,`var(--${e})`])),borderRadius:{sm:`calc(var(--radius) - 4px)`,md:`calc(var(--radius) - 2px)`,lg:`var(--radius)`,xl:`calc(var(--radius) + 4px)`}};exports.BrowserRuntime=p,exports.ChangeDetector=i,exports.LAYER_ORDER=f,exports.SSR_STYLE_SELECTOR=d,exports.StylePartitionManager=t,exports.baroBoot=_,exports.baroStart=v,exports.collectJsonRenderClassNames=y,exports.getRuntime=g,exports.normalizeClassName=n,exports.normalizeClassNameList=r,exports.preloadJsonRenderClasses=b,exports.shadcnTheme=x;

package/dist/index.d.cts

@@ -0,0 +1,435 @@
+import { Config } from '@barocss/kit';
+import { GenerateCssRulesResult } from '@barocss/kit';
+import { IncrementalParser } from '@barocss/kit';
+import { RuleKey } from '@barocss/kit';
+
+export declare function baroBoot({ loadingClassName, ...options }?: BaroBootOptions): void;
+
+declare type BaroBootOptions = BrowserRuntimeOptions & {
+    loadingClassName?: string;
+};
+
+export declare const baroStart: typeof baroBoot;
+
+export declare class BrowserRuntime {
+    private cache;
+    private rootCache;
+    private context;
+    private options;
+    private isDestroyed;
+    private existing;
+    /** #274: @keyframes names the page's own sheets define (filled with `existing`). */
+    private existingKeyframes;
+    private existingSheetCount;
+    /** #269: classes requested explicitly through addClass(); never reclaimed. */
+    private pinned;
+    private gc;
+    private reclaimedCount;
+    /** #268: class rules adopted from `<style data-barocss-ssr>`, in sheet order, and the classes they lead. */
+    private ssrRules;
+    private ssrClasses;
+    private observedOnce;
+    private incrementalParser;
+    private changeDetector;
+    private stylePartitionManager;
+    private getCategory;
+    constructor(options?: BrowserRuntimeOptions);
+    /**
+     * Add debug logs (by level)
+     */
+    private debugLog;
+    private init;
+    /**
+     * #268: adopt the class rules of server-rendered `<style data-barocss-ssr>` sheets in <head>, at startup
+     * (constructor and the first observe()). Each rule moves
+     * (same task, so no paint in between) into the partition its class would get if generated here, at
+     * its #254 sorted position, so a later client `sm:` rule lands before a server `lg:` rule. Its classes
+     * are never regenerated and never reclaimed. `:root`, `@property` and `@keyframes` stay in the sheet.
+     */
+    private adoptSsrSheets;
+    private insertSsrRules;
+    private injectPreflightCSS;
+    private ensureCssVars;
+    private getInsertionPoint;
+    /**
+     * Dynamically add one or more class names and generate/insert CSS
+     */
+    addClass(classes: string | string[]): void;
+    /**
+     * Process classes
+     */
+    private processClasses;
+    /**
+     * Process classes using incremental parsing
+     */
+    private processClassesIncremental;
+    /**
+     * Public method to apply parser results, update internal caches, and inject CSS
+     */
+    applyParseResults(results: Array<GenerateCssRulesResult>, _opts?: {
+        isBrowser?: boolean;
+    }): void;
+    /** #269: a class that must never be reclaimed. */
+    private isPermanent;
+    /**
+     * #269: delete the generated rules of classes no live element uses. Root/@property/@keyframes rules stay
+     * (they are shared and harmless); a rule text another cached class still emits is kept.
+     */
+    private reclaim;
+    /** Class names defined by the page's own stylesheets (BaroCSS's sheets and cross-origin sheets excluded). */
+    getExistingClasses(): Set<string>;
+    /**
+     * MutationObserver instance method to automatically call addClass when class attributes change in DOM
+     */
+    observe(root?: HTMLElement, options?: {
+        scan?: boolean;
+        onReady?: () => void;
+    }): MutationObserver;
+    private normalizeClasses;
+    has(cls: string): boolean;
+    getCss(cls: string): string | undefined;
+    getAllCss(): string;
+    getClasses(): string[];
+    /**
+     * Get comprehensive cache statistics
+     */
+    getCacheStats(): {
+        runtime: {
+            cachedClasses: number;
+            rootCacheSize: number;
+            ruleCount: number;
+            reclaimedClasses: number;
+            gc: {
+                trackedClasses: number;
+                candidates: number;
+            } | null;
+        };
+        ast: {
+            size: number;
+            maxSize: number;
+            hitRate: number;
+        };
+        incremental: {
+            processedClasses: number;
+            pendingClasses: number;
+            cacheStats: {
+                ast: {
+                    size: number;
+                    maxSize: number;
+                    hitRate: number;
+                };
+                css: {};
+            };
+        };
+    };
+    /**
+     * Clear all caches (useful for debugging or memory management)
+     */
+    clearCaches(): void;
+    reset(): void;
+    updateConfig(newConfig: Config): void;
+    removeClass(classes: string | string[]): void;
+    destroy(): void;
+    getStats(): {
+        cachedClasses: number;
+        styleElementId: string;
+        isDestroyed: boolean;
+        config: Config;
+        cacheStats: {
+            runtime: {
+                cachedClasses: number;
+                rootCacheSize: number;
+                ruleCount: number;
+                reclaimedClasses: number;
+                gc: {
+                    trackedClasses: number;
+                    candidates: number;
+                } | null;
+            };
+            ast: {
+                size: number;
+                maxSize: number;
+                hitRate: number;
+            };
+            incremental: {
+                processedClasses: number;
+                pendingClasses: number;
+                cacheStats: {
+                    ast: {
+                        size: number;
+                        maxSize: number;
+                        hitRate: number;
+                    };
+                    css: {};
+                };
+            };
+        };
+    };
+}
+
+export declare interface BrowserRuntimeOptions {
+    config?: Config;
+    styleId?: string;
+    insertionPoint?: 'head' | 'body' | HTMLElement;
+    maxRulesPerPartition?: number;
+    /**
+     * #210: skip classes the page's existing (non-BaroCSS, same-origin) stylesheets already define,
+     * so a built app plus the runtime injects only what the build is missing. Opt-in. A class counts
+     * as covered only when a rule's selector starts with it (e.g. `.p-4`, `.md\:p-4` inside @media,
+     * `.hover\:x:hover`), so a class seen only as a descendant (`.group:hover .x`) is not skipped.
+     * The index is rebuilt when `document.styleSheets.length` changes. A page class that leads a selector
+     * with the same name is treated as covered, and rules added later to an already-indexed sheet aren't seen.
+     */
+    skipExisting?: boolean;
+    /**
+     * #269: reclaim the rules of classes that no element inside the observed root carries any more.
+     * On by default; it only acts on classes seen through `observe()`. A class is deleted only after
+     * its refcount has stayed 0 for `gcGraceMs` and a live-DOM re-check finds no element with it.
+     * Never reclaimed: classes passed to `addClass()`, classes any pre-existing (non-BaroCSS) sheet
+     * defines (build output, server sheet), root/@property/preflight rules. `false` disables it.
+     */
+    gc?: boolean;
+    /** #269: how long a class must stay unused before its rules are deleted (default 3000 ms). */
+    gcGraceMs?: number;
+    /**
+     * #269: soft cap on cached classes. When exceeded, unused (refcount 0) classes are evicted
+     * oldest-first without waiting for the grace period; classes in use are never evicted. Default: no cap.
+     */
+    maxRules?: number;
+}
+
+/**
+ * Change detection system for DOM mutations
+ *
+ * ⚠️ BROWSER-ONLY: This class is designed for browser environments only.
+ * It uses MutationObserver and DOM APIs that are not available in Node.js.
+ *
+ * This class monitors DOM changes and automatically processes new CSS classes
+ * that are added to elements. It uses MutationObserver to detect:
+ * - Class attribute changes on existing elements
+ * - New elements being added to the DOM
+ * - Changes in child elements
+ *
+ * For server-side usage, use IncrementalParser directly with processClassesSync()
+ * or processClasses() methods.
+ */
+export declare class ChangeDetector {
+    /** MutationObserver instance for DOM change detection */
+    private observer;
+    /** Reference to IncrementalParser for class processing */
+    private incrementalParser;
+    /** Reference to BrowserRuntime for CSS injection (optional) */
+    private BrowserRuntime?;
+    private getCategory;
+    /**
+     * Create a new ChangeDetector instance
+     *
+     * @param incrementalParser - IncrementalParser instance for class processing
+     * @param BrowserRuntime - Optional BrowserRuntime instance for CSS injection
+     */
+    constructor(incrementalParser: IncrementalParser, BrowserRuntime?: BrowserRuntime, getCategory?: (cls: string) => string | undefined);
+    /** #269: refcount/GC tracker, when the runtime has GC enabled. */
+    private gc;
+    setGc(gc: ClassGc | null): void;
+    setParser(parser: IncrementalParser): void;
+    /**
+     * Starts observing DOM changes for new CSS classes
+     *
+     * This method sets up a MutationObserver that monitors:
+     * - Attribute changes (specifically class attribute modifications)
+     * - Child list changes (new elements being added)
+     * - Subtree changes (changes in descendant elements)
+     *
+     * The observer automatically processes any new classes it discovers
+     * by adding them to the IncrementalParser's pending queue.
+     *
+     * @param root - The root element to observe (defaults to document.body)
+     * @param options - Configuration options including initial scan and onReady callback
+     * @returns The MutationObserver instance for external control
+     */
+    observe(root?: HTMLElement, options?: {
+        scan?: boolean;
+        onReady?: () => void;
+    }): MutationObserver;
+    /**
+     * Scan existing classes in the DOM and process them
+     */
+    private scanExistingClasses;
+    /**
+     * Processes an individual element and extracts new classes
+     *
+     * This method is called for each element discovered during DOM mutations.
+     * It:
+     * - Extracts all class names from the element's className
+     * - Filters out already processed classes
+     * - Adds new classes to the collection for batch processing
+     *
+     * @param element - The HTML element to process
+     * @param newClasses - Set to collect newly discovered class names
+     */
+    private processElement;
+    /**
+     * Stops observing DOM changes and cleans up resources
+     *
+     * This method disconnects the MutationObserver and clears the
+     * observer reference to prevent memory leaks and allow the
+     * ChangeDetector to be properly garbage collected.
+     */
+    disconnect(): void;
+}
+
+declare class ClassGc {
+    private host;
+    private graceMs;
+    private maxRules;
+    private now;
+    private counts;
+    private counted;
+    /** class -> time its count reached 0 (insertion order = oldest first). */
+    private candidates;
+    private timer;
+    private root;
+    constructor(host: ClassGcHost, graceMs: number, maxRules: number, now?: () => number);
+    /** Start counting for a new root: count every element currently inside it. */
+    setRoot(root: Element): void;
+    count(cls: string): number;
+    /** Re-count `el` and (optionally) all its descendants from their current state. */
+    reconcileTree(node: Node): void;
+    reconcile(el: Element): void;
+    /** Call after a mutation batch has been counted and its classes inserted. */
+    afterBatch(): void;
+    private schedule;
+    /** Reclaim candidates whose grace period elapsed (plus LRU overflow). Public for tests. */
+    sweep(): void;
+    private inDom;
+    cancel(): void;
+    stats(): {
+        trackedClasses: number;
+        candidates: number;
+    };
+}
+
+/**
+ * #269: per-class refcount over the observed root, plus a delayed sweep that
+ * reclaims classes no live element carries any more.
+ *
+ * Counting is reconciliation, not delta arithmetic: for every element a
+ * mutation batch touches (attribute target, added subtree, removed subtree) we
+ * compare the classes we last counted for it with what it carries *now*
+ * (nothing if it is no longer inside the root). That makes the count
+ * independent of record order, so remove-then-re-add in one batch, moves
+ * between parents and edits made while detached all settle to the true state.
+ * An element we miss can only leak a count (rule kept), never drop one.
+ *
+ * Before a class is reclaimed the sweep re-checks the live DOM
+ * (`getElementsByClassName`), so even a miscount cannot unstyle a live element.
+ */
+declare interface ClassGcHost {
+    /** Delete the rules of these classes. */
+    reclaim(classes: string[]): void;
+    /** Whether a class must never be reclaimed (pinned, found in a pre-existing sheet, ...). */
+    isPermanent(cls: string): boolean;
+    /** Number of generated rules/classes currently cached (for the LRU cap). */
+    cachedCount(): number;
+}
+
+/** Collect literal className tokens from a json-render Spec's flat elements map. */
+export declare function collectJsonRenderClassNames(spec: unknown): string[];
+
+/**
+ * Returns the shared runtime, creating it on first use. If a live runtime
+ * already exists and `options.config` is a different config object, it is
+ * applied via `updateConfig` (which replaces the whole config), so an early
+ * `getRuntime()` never makes a later `baroStart({ config })` lose its config.
+ */
+export declare function getRuntime(options?: BrowserRuntimeOptions): BrowserRuntime;
+
+/** Tailwind 4 layer order, declared by BaroCSS's first <style> in <head>. */
+export declare const LAYER_ORDER = "@layer theme, base, components, utilities;";
+
+export declare function normalizeClassName(className: any): string;
+
+export declare function normalizeClassNameList(className: any): string[];
+
+/** Submit literal classes synchronously before UI mount; the caller validates class support. */
+export declare function preloadJsonRenderClasses(spec: unknown, runtime: Pick<BrowserRuntime, 'addClass'>): void;
+
+export declare const shadcnTheme: {
+    colors: Record<string, string>;
+    borderRadius: Record<string, string>;
+};
+
+/** #268: marks a server-rendered sheet (`@barocss/server` `ssrStyleTag()`); the runtime adopts its class rules. */
+export declare const SSR_STYLE_SELECTOR = "style[data-barocss-ssr]";
+
+export declare interface StylePartition {
+    id: string;
+    styles: string[];
+    styleElement: HTMLStyleElement;
+    /** Sort keys parallel to `styles` / the sheet's cssRules (#254). */
+    keys?: RuleKey[];
+}
+
+export declare class StylePartitionManager {
+    /**
+     * Insert `rule` at its Tailwind variant position within `partition` (#254):
+     * one insertRule at a binary-searched index, no sheet rewrite.
+     */
+    private insertSorted;
+    private partitions;
+    private categoryPartitions;
+    private partitionCounter;
+    private maxRulesPerPartition;
+    private insertionPoint;
+    private classToPartitionMap;
+    private classToCategoryPartitionMap;
+    private styleIdPrefix;
+    private getCategory;
+    constructor(insertionPoint: HTMLElement, maxRulesPerPartition?: number, styleIdPrefix?: string, getCategory?: (cls: string) => string | undefined);
+    private initializeDefaultPartition;
+    private createNewCategoryPartition;
+    private createNewPartition;
+    hasRule(rule: string): boolean;
+    hasCategoryRule(rule: string, category: string): boolean;
+    setRuleCache(rule: string, partitionIndex: number): void;
+    setCategoryRuleCache(rule: string, category: string): void;
+    get currentPartition(): StylePartition;
+    getCategoryPartition(category: string): StylePartition | undefined;
+    hasDetachedPartitions(): boolean;
+    /**
+     * Escape CSS rule text
+     * - Properly escape special characters
+     * - Prevent CSS syntax errors
+     */
+    private escapeCssRule;
+    addRule(rule: string): boolean;
+    addCategoryRule(rule: string, category: string): boolean;
+    addRootRules(rules: string[]): {
+        success: number;
+        failed: number;
+    };
+    addRules(rules: GenerateCssRulesResult[]): {
+        success: number;
+        failed: number;
+    };
+    /**
+     * Remove one generated rule (#269 GC). Keeps `styles`, the #254 `keys` and the
+     * sheet's cssRules parallel: one deleteRule at the rule's index, or a text
+     * rebuild when the sheet isn't solely ours / has no CSSOM. Returns whether
+     * the rule was found.
+     */
+    removeRule(rule: string, category?: string): boolean;
+    /** Number of generated (non-root, non-preflight) rules currently held. */
+    get ruleCount(): number;
+    /**
+     * 특정 규칙이 어느 파티션에 있는지 찾기
+     */
+    findRulePartition(rule: string): StylePartition | null;
+    updateRuleContent(category: string, ruleContent: string, atDocumentStart?: boolean): void;
+    /**
+     * 모든 파티션 정리
+     */
+    cleanup(): void;
+}
+
+export { }