blecsd 0.4.0 → 0.6.2

package/dist/style/index.js

@@ -0,0 +1 @@
+export{d as COLOR_ALIASES,c as COLOR_NAMES,j as CSS_COLORS,e as ColorNameSchema,g as colorToName,k as cssNameToColor,l as getColorNames,m as getCssColorNames,h as isColorName,i as isSpecialColor,f as nameToColor}from'../chunk-GIMWA5WA.js';export{a as Color256Schema,e as HSLASchema,d as HSLSchema,f as HexColorSchema,c as RGBASchema,b as RGBSchema,X as blend,ea as blendAlpha,da as blendWithAlpha,F as color256ToHex,D as color256ToRgb,ga as complement,la as contrastRatio,Z as darken,$ as darken256,ba as desaturate,ia as gradient,ja as gradient256,ca as grayscale,E as hexToColor256,v as hexToRgb,z as hslToRgb,B as hslaToRgba,ha as invert,g as isColor256,i as isRGB,ma as isReadable,Y as lighten,_ as lighten256,ka as luminance,W as mix,C as rgbToColor256,w as rgbToHex,y as rgbToHsl,x as rgbaToHex,A as rgbaToHsla,fa as rotateHue,aa as saturate}from'../chunk-FUW7OD3H.js';export{a as INHERITING_PROPERTIES,b as NON_INHERITING_PROPERTIES,f as clearStyleCache,l as computeInheritedStyle,n as doesPropertyInherit,p as findPropertySource,r as getComputedStyles,i as getDefaultStyle,o as getInheritedProperty,h as getLocalStyle,e as invalidateAllStyleCaches,d as invalidateStyleCache,k as isDefaultColor,j as mergeStyles,q as precomputeStyles,m as resolveStyle}from'../chunk-NYIMY4UV.js';import {a}from'../chunk-QS5QXZNJ.js';import {e,c}from'../chunk-JRRJCATR.js';import {I as I$1,J,M}from'../chunk-LIVVHEOU.js';import'../chunk-Z4EZERNE.js';import {k,m,r,o}from'../chunk-7ZFQO3OQ.js';export{u as colorToHex,t as hexToColor,r as packColor,s as unpackColor}from'../chunk-7ZFQO3OQ.js';import'../chunk-I7AUKTXE.js';import {z}from'zod';var w=z.object({fg:z.union([z.string(),z.number()]).optional(),bg:z.union([z.string(),z.number()]).optional(),bold:z.boolean().optional(),underline:z.boolean().optional(),blink:z.boolean().optional(),inverse:z.boolean().optional(),transparent:z.boolean().optional(),opacity:z.number().min(0).max(1).optional()}),A=z.object({tag:z.string().optional(),className:z.string().optional(),entityId:z.number().int().nonnegative().optional()}).refine(r=>r.tag!==void 0||r.className!==void 0||r.entityId!==void 0,{message:"Selector must have at least one of: tag, className, entityId"}),F=z.object({selector:A,style:w,priority:z.number().int().optional()}),qe=z.object({name:z.string().min(1),rules:z.array(F)}),Ke=1,Qe=10,Xe=100;function p(r){let t=0;return r.tag!==void 0&&(t+=Ke),r.className!==void 0&&(t+=Qe),r.entityId!==void 0&&(t+=Xe),t}function Ze(r,t){if(e(r,t)){let a=c(r,t);if(a&&typeof a.tag=="string")return a.tag}let n=a(r,t,"widgetTag",void 0);if(n!==void 0)return n}function er(r,t){if(e(r,t)){let a=c(r,t);if(a&&Array.isArray(a.classes))return a.classes}let n=a(r,t,"styleClasses",void 0);return n!==void 0&&Array.isArray(n)?n:[]}function h(r,t,n){return !(n.entityId!==void 0&&t!==n.entityId||n.tag!==void 0&&Ze(r,t)!==n.tag||n.className!==void 0&&!er(r,t).includes(n.className))}function rr(r){return {name:r,rules:[]}}function tr(r,t){return F.parse(t),{...r,rules:[...r.rules,t]}}function nr(r,t){return {...r,rules:r.rules.filter(n=>!t(n))}}function or(r){return {...r,rules:[]}}function ar(r,t){t.fg!==void 0&&(r.fg=t.fg),t.bg!==void 0&&(r.bg=t.bg),t.bold!==void 0&&(r.bold=t.bold),t.underline!==void 0&&(r.underline=t.underline),t.blink!==void 0&&(r.blink=t.blink),t.inverse!==void 0&&(r.inverse=t.inverse),t.transparent!==void 0&&(r.transparent=t.transparent),t.opacity!==void 0&&(r.opacity=t.opacity);}function P(r){let t=[...r].sort((a,i)=>a.specificity!==i.specificity?a.specificity-i.specificity:a.priority!==i.priority?a.priority-i.priority:a.order-i.order),n={};for(let a of t)ar(n,a.style);return n}function ir(r,t){let n=k(r),a=0,i=new Set;for(let s of n){if(!m(r,s,I$1))continue;let g=[];for(let u=0;u<t.rules.length;u++){let m=t.rules[u];m&&h(r,s,m.selector)&&(i.add(u),g.push({style:m.style,specificity:p(m.selector),priority:m.priority??0,order:u}));}if(g.length===0)continue;let W=P(g);J(r,s,W),M(r,s),a++;}return {entitiesStyled:a,rulesMatched:i.size}}function lr(r,t,n){if(!m(r,t,I$1))return  false;let a=[];for(let s=0;s<n.rules.length;s++){let g=n.rules[s];g&&h(r,t,g.selector)&&a.push({style:g.style,specificity:p(g.selector),priority:g.priority??0,order:s});}if(a.length===0)return  false;let i=P(a);return J(r,t,i),M(r,t),true}function sr(r,t,n){let a=[];for(let i of n.rules)h(r,t,i.selector)&&a.push({rule:i,specificity:p(i.selector)});return a}var gr=z.object({primary:z.number(),secondary:z.number(),accent:z.number(),background:z.number(),foreground:z.number(),error:z.number(),warning:z.number(),success:z.number(),info:z.number(),muted:z.number(),border:z.number()}),cr=z.object({style:z.enum(["single","double","rounded","heavy","none"]),fg:z.number(),bg:z.number()}),dr=z.object({fg:z.number(),bg:z.number(),borderFg:z.number()}),ur=z.object({button:z.object({fg:z.number(),bg:z.number(),activeFg:z.number(),activeBg:z.number()}),input:z.object({fg:z.number(),bg:z.number(),placeholderFg:z.number(),cursorFg:z.number()}),list:z.object({fg:z.number(),bg:z.number(),selectedFg:z.number(),selectedBg:z.number()}),panel:z.object({fg:z.number(),bg:z.number(),headerFg:z.number(),headerBg:z.number()})}),R=z.object({name:z.string(),colors:gr,borders:cr,focus:dr,widgets:ur}),d=new Map,C=new Map;function mr(r){R.parse(r),d.set(r.name,r);}function fr(r){return d.get(r)}function yr(r,t){if(!d.get(t))throw new Error(`Theme "${t}" is not registered`);C.set(r,t);}function v(r){let t=C.get(r)??"default",n=d.get(t);if(!n)throw new Error("No theme registered. Register at least one theme before use.");return n}function br(){d.clear(),C.clear();}function N(){return {name:"default",colors:{primary:r(33,150,243),secondary:r(156,39,176),accent:r(255,193,7),background:r(18,18,18),foreground:r(238,238,238),error:r(244,67,54),warning:r(255,152,0),success:r(76,175,80),info:r(33,150,243),muted:r(117,117,117),border:r(66,66,66)},borders:{style:"single",fg:r(66,66,66),bg:r(0,0,0,0)},focus:{fg:r(255,255,255),bg:r(33,150,243),borderFg:r(100,181,246)},widgets:{button:{fg:r(255,255,255),bg:r(33,150,243),activeFg:r(255,255,255),activeBg:r(25,118,210)},input:{fg:r(238,238,238),bg:r(38,38,38),placeholderFg:r(117,117,117),cursorFg:r(255,255,255)},list:{fg:r(238,238,238),bg:r(18,18,18),selectedFg:r(255,255,255),selectedBg:r(33,150,243)},panel:{fg:r(238,238,238),bg:r(28,28,28),headerFg:r(255,255,255),headerBg:r(48,48,48)}}}}function pr(){return {name:"dark",colors:{primary:r(66,165,245),secondary:r(186,104,200),accent:r(255,213,79),background:r(12,12,12),foreground:r(250,250,250),error:r(239,83,80),warning:r(255,167,38),success:r(102,187,106),info:r(66,165,245),muted:r(97,97,97),border:r(48,48,48)},borders:{style:"single",fg:r(48,48,48),bg:r(0,0,0,0)},focus:{fg:r(255,255,255),bg:r(66,165,245),borderFg:r(144,202,249)},widgets:{button:{fg:r(255,255,255),bg:r(66,165,245),activeFg:r(255,255,255),activeBg:r(42,139,230)},input:{fg:r(250,250,250),bg:r(24,24,24),placeholderFg:r(97,97,97),cursorFg:r(255,255,255)},list:{fg:r(250,250,250),bg:r(12,12,12),selectedFg:r(255,255,255),selectedBg:r(66,165,245)},panel:{fg:r(250,250,250),bg:r(18,18,18),headerFg:r(255,255,255),headerBg:r(33,33,33)}}}}function hr(){return {name:"light",colors:{primary:r(25,118,210),secondary:r(123,31,162),accent:r(255,160,0),background:r(250,250,250),foreground:r(33,33,33),error:r(211,47,47),warning:r(245,124,0),success:r(56,142,60),info:r(25,118,210),muted:r(158,158,158),border:r(224,224,224)},borders:{style:"single",fg:r(224,224,224),bg:r(0,0,0,0)},focus:{fg:r(255,255,255),bg:r(25,118,210),borderFg:r(66,165,245)},widgets:{button:{fg:r(255,255,255),bg:r(25,118,210),activeFg:r(255,255,255),activeBg:r(21,101,192)},input:{fg:r(33,33,33),bg:r(255,255,255),placeholderFg:r(158,158,158),cursorFg:r(33,33,33)},list:{fg:r(33,33,33),bg:r(250,250,250),selectedFg:r(255,255,255),selectedBg:r(25,118,210)},panel:{fg:r(33,33,33),bg:r(245,245,245),headerFg:r(33,33,33),headerBg:r(238,238,238)}}}}function Tr(){return {name:"high-contrast",colors:{primary:r(0,120,215),secondary:r(136,23,152),accent:r(255,185,0),background:r(0,0,0),foreground:r(255,255,255),error:r(255,0,0),warning:r(255,140,0),success:r(0,255,0),info:r(0,120,215),muted:r(128,128,128),border:r(255,255,255)},borders:{style:"heavy",fg:r(255,255,255),bg:r(0,0,0,0)},focus:{fg:r(0,0,0),bg:r(255,255,0),borderFg:r(255,255,0)},widgets:{button:{fg:r(0,0,0),bg:r(255,255,255),activeFg:r(255,255,255),activeBg:r(0,120,215)},input:{fg:r(255,255,255),bg:r(0,0,0),placeholderFg:r(128,128,128),cursorFg:r(255,255,0)},list:{fg:r(255,255,255),bg:r(0,0,0),selectedFg:r(0,0,0),selectedBg:r(255,255,255)},panel:{fg:r(255,255,255),bg:r(0,0,0),headerFg:r(0,0,0),headerBg:r(255,255,255)}}}}function Sr(){return {name:"solarized",colors:{primary:r(38,139,210),secondary:r(108,113,196),accent:r(181,137,0),background:r(0,43,54),foreground:r(131,148,150),error:r(220,50,47),warning:r(203,75,22),success:r(133,153,0),info:r(42,161,152),muted:r(88,110,117),border:r(7,54,66)},borders:{style:"single",fg:r(7,54,66),bg:r(0,0,0,0)},focus:{fg:r(253,246,227),bg:r(38,139,210),borderFg:r(108,113,196)},widgets:{button:{fg:r(253,246,227),bg:r(38,139,210),activeFg:r(253,246,227),activeBg:r(108,113,196)},input:{fg:r(131,148,150),bg:r(7,54,66),placeholderFg:r(88,110,117),cursorFg:r(253,246,227)},list:{fg:r(131,148,150),bg:r(0,43,54),selectedFg:r(253,246,227),selectedBg:r(38,139,210)},panel:{fg:r(131,148,150),bg:r(7,54,66),headerFg:r(147,161,161),headerBg:r(0,43,54)}}}}function xr(){return {name:"monokai",colors:{primary:r(102,217,239),secondary:r(171,157,242),accent:r(230,219,116),background:r(39,40,34),foreground:r(248,248,242),error:r(249,38,114),warning:r(253,151,31),success:r(166,226,46),info:r(102,217,239),muted:r(117,113,94),border:r(73,72,62)},borders:{style:"single",fg:r(73,72,62),bg:r(0,0,0,0)},focus:{fg:r(39,40,34),bg:r(230,219,116),borderFg:r(102,217,239)},widgets:{button:{fg:r(39,40,34),bg:r(102,217,239),activeFg:r(39,40,34),activeBg:r(171,157,242)},input:{fg:r(248,248,242),bg:r(73,72,62),placeholderFg:r(117,113,94),cursorFg:r(230,219,116)},list:{fg:r(248,248,242),bg:r(39,40,34),selectedFg:r(39,40,34),selectedBg:r(102,217,239)},panel:{fg:r(248,248,242),bg:r(73,72,62),headerFg:r(248,248,242),headerBg:r(39,40,34)}}}}function Fr(){return {name:"nord",colors:{primary:r(136,192,208),secondary:r(180,142,173),accent:r(235,203,139),background:r(46,52,64),foreground:r(236,239,244),error:r(191,97,106),warning:r(208,135,112),success:r(163,190,140),info:r(129,161,193),muted:r(76,86,106),border:r(59,66,82)},borders:{style:"single",fg:r(59,66,82),bg:r(0,0,0,0)},focus:{fg:r(46,52,64),bg:r(136,192,208),borderFg:r(129,161,193)},widgets:{button:{fg:r(46,52,64),bg:r(136,192,208),activeFg:r(46,52,64),activeBg:r(129,161,193)},input:{fg:r(236,239,244),bg:r(59,66,82),placeholderFg:r(76,86,106),cursorFg:r(236,239,244)},list:{fg:r(236,239,244),bg:r(46,52,64),selectedFg:r(46,52,64),selectedBg:r(136,192,208)},panel:{fg:r(236,239,244),bg:r(59,66,82),headerFg:r(236,239,244),headerBg:r(67,76,94)}}}}function Rr(){return {name:"dracula",colors:{primary:r(189,147,249),secondary:r(255,121,198),accent:r(241,250,140),background:r(40,42,54),foreground:r(248,248,242),error:r(255,85,85),warning:r(255,184,108),success:r(80,250,123),info:r(139,233,253),muted:r(98,114,164),border:r(68,71,90)},borders:{style:"single",fg:r(68,71,90),bg:r(0,0,0,0)},focus:{fg:r(40,42,54),bg:r(189,147,249),borderFg:r(255,121,198)},widgets:{button:{fg:r(40,42,54),bg:r(189,147,249),activeFg:r(40,42,54),activeBg:r(255,121,198)},input:{fg:r(248,248,242),bg:r(68,71,90),placeholderFg:r(98,114,164),cursorFg:r(248,248,242)},list:{fg:r(248,248,242),bg:r(40,42,54),selectedFg:r(40,42,54),selectedBg:r(189,147,249)},panel:{fg:r(248,248,242),bg:r(68,71,90),headerFg:r(248,248,242),headerBg:r(40,42,54)}}}}function Cr(){return {name:"gruvbox",colors:{primary:r(131,165,152),secondary:r(211,134,155),accent:r(250,189,47),background:r(40,40,40),foreground:r(235,219,178),error:r(251,73,52),warning:r(254,128,25),success:r(184,187,38),info:r(131,165,152),muted:r(146,131,116),border:r(60,56,54)},borders:{style:"single",fg:r(60,56,54),bg:r(0,0,0,0)},focus:{fg:r(40,40,40),bg:r(250,189,47),borderFg:r(131,165,152)},widgets:{button:{fg:r(40,40,40),bg:r(131,165,152),activeFg:r(40,40,40),activeBg:r(184,187,38)},input:{fg:r(235,219,178),bg:r(60,56,54),placeholderFg:r(146,131,116),cursorFg:r(235,219,178)},list:{fg:r(235,219,178),bg:r(40,40,40),selectedFg:r(40,40,40),selectedBg:r(131,165,152)},panel:{fg:r(235,219,178),bg:r(60,56,54),headerFg:r(235,219,178),headerBg:r(80,73,69)}}}}function I(r,t){let n={...r};for(let a in t)if(Object.hasOwn(t,a)){let i=t[a],s=n[a];i&&typeof i=="object"&&!Array.isArray(i)&&s&&typeof s=="object"&&!Array.isArray(s)?n[a]=I(s,i):i!==void 0&&(n[a]=i);}return n}function vr(r,t){let n=N();return {...E(n,t),name:r}}function E(r,t){return {name:r.name,colors:{...r.colors,...t.colors??{}},borders:{...r.borders,...t.borders??{}},focus:{...r.focus,...t.focus??{}},widgets:{button:{...r.widgets.button,...t.widgets?.button??{}},input:{...r.widgets.input,...t.widgets?.input??{}},list:{...r.widgets.list,...t.widgets?.list??{}},panel:{...r.widgets.panel,...t.widgets?.panel??{}}}}}function Br(r,t,n){let a=d.get(r);if(!a)throw new Error(`Base theme "${r}" is not registered`);return {...I(a,n),name:t}}function kr(r){return JSON.stringify(r)}function wr(r){let t=JSON.parse(r);return R.parse(t)}function Ar(r,t){let n=v(r);J(r,t,{fg:n.colors.foreground,bg:n.colors.background}),M(r,t);}function Pr(r){let t=v(r),n=o(r,[I$1]);for(let a of n)m(r,a,I$1)&&(I$1.fg[a]=t.colors.foreground,I$1.bg[a]=t.colors.background,I$1.dirty[a]=1);}export{w as StylePropertiesSchema,F as StyleRuleSchema,A as StyleSelectorSchema,qe as StylesheetSchema,R as ThemeSchema,tr as addRule,ir as applyStylesheet,lr as applyStylesheetToEntity,Ar as applyTheme,Pr as applyThemeToAll,p as calculateSpecificity,or as clearRules,pr as createDarkTheme,N as createDefaultTheme,Rr as createDraculaTheme,Cr as createGruvboxTheme,Tr as createHighContrastTheme,hr as createLightTheme,xr as createMonokaiTheme,Fr as createNordTheme,Sr as createSolarizedTheme,rr as createStylesheet,vr as createTheme,wr as deserializeTheme,Br as extendTheme,v as getActiveTheme,sr as getMatchingRules,fr as getTheme,h as matchesSelector,E as mergeThemes,mr as registerTheme,nr as removeRules,br as resetThemeRegistry,kr as serializeTheme,yr as setActiveTheme};

package/dist/styleInheritance-CuRb5Dmp.d.ts

@@ -0,0 +1,251 @@
+import { S as StyleData } from './renderable-IbSJao5y.js';
+import { W as World, E as Entity } from './types-B8LmNkzG.js';
+
+/**
+ * Style inheritance system for cascading styles through the hierarchy.
+ * Some style properties (like fg, bold) inherit from ancestors,
+ * while others (like bg) are local to each element.
+ * @module core/styleInheritance
+ */
+
+/**
+ * Style properties that inherit from parent to child.
+ * These cascade down the hierarchy if not explicitly set.
+ *
+ * - `fg`: Foreground color inherits (text color from parent)
+ * - `bold`: Bold text inherits
+ * - `underline`: Underline inherits
+ * - `blink`: Blink inherits
+ * - `inverse`: Inverse inherits
+ *
+ * Properties that do NOT inherit:
+ * - `bg`: Background is local to each element
+ * - `transparent`: Transparency is local
+ */
+declare const INHERITING_PROPERTIES: ReadonlyArray<keyof StyleData>;
+/**
+ * Properties that do NOT inherit from parent.
+ * These are always local to the element.
+ */
+declare const NON_INHERITING_PROPERTIES: ReadonlyArray<keyof StyleData>;
+/**
+ * Gets the current cache generation.
+ * @returns Current generation number
+ */
+declare function getCacheGeneration(): number;
+/**
+ * Invalidates the computed style cache for an entity and its descendants.
+ * Call this when a style property changes.
+ *
+ * @param eid - The entity whose cache to invalidate
+ *
+ * @example
+ * ```typescript
+ * import { invalidateStyleCache, setStyle } from 'blecsd';
+ *
+ * // After changing style, invalidate cache
+ * setStyle(world, entity, { fg: 0xff0000ff });
+ * invalidateStyleCache(entity);
+ * ```
+ */
+declare function invalidateStyleCache(eid: Entity): void;
+/**
+ * Invalidates all computed style caches.
+ * More efficient than invalidating individual entities when many change.
+ *
+ * @example
+ * ```typescript
+ * import { invalidateAllStyleCaches } from 'blecsd';
+ *
+ * // After bulk style changes
+ * invalidateAllStyleCaches();
+ * ```
+ */
+declare function invalidateAllStyleCaches(): void;
+/**
+ * Clears the style cache.
+ * Primarily for testing.
+ */
+declare function clearStyleCache(): void;
+/**
+ * Checks if an entity has a valid cached computed style.
+ *
+ * @param eid - The entity ID
+ * @returns true if valid cache exists
+ */
+declare function hasValidStyleCache(eid: Entity): boolean;
+/**
+ * Gets the local (non-inherited) style of an entity.
+ * Returns default values if entity has no Renderable component.
+ *
+ * @param world - The ECS world
+ * @param eid - The entity ID
+ * @returns The entity's local style
+ */
+declare function getLocalStyle(world: World, eid: Entity): StyleData;
+/**
+ * Gets the default style (used when no style is set).
+ *
+ * @returns Default style data
+ */
+declare function getDefaultStyle(): StyleData;
+/**
+ * Merges a parent style into a child style.
+ * Inheriting properties from parent are used if child hasn't set them.
+ * Non-inheriting properties always use the child's value.
+ *
+ * @param parent - The parent's computed style
+ * @param child - The child's local style
+ * @returns Merged style with inheritance applied
+ *
+ * @example
+ * ```typescript
+ * import { mergeStyles } from 'blecsd';
+ *
+ * const parentStyle = { fg: 0xff0000ff, bold: true, bg: 0x000000ff };
+ * const childStyle = { fg: 0x00ff00ff, bold: false, bg: 0x111111ff };
+ *
+ * const merged = mergeStyles(parentStyle, childStyle);
+ * // merged.fg = 0x00ff00ff (child overrides)
+ * // merged.bold = false (child overrides)
+ * // merged.bg = 0x111111ff (bg doesn't inherit, uses child)
+ * ```
+ */
+declare function mergeStyles(parent: StyleData, child: StyleData): StyleData;
+/**
+ * Checks if a color is the default (unset) color.
+ *
+ * @param color - The color to check
+ * @returns true if the color is the default
+ */
+declare function isDefaultColor(color: number): boolean;
+/**
+ * Computes the inherited style for an entity by walking up the hierarchy.
+ * Caches the result for efficiency.
+ *
+ * @param world - The ECS world
+ * @param eid - The entity ID
+ * @returns The computed style with inheritance applied
+ *
+ * @example
+ * ```typescript
+ * import { computeInheritedStyle, setStyle, appendChild } from 'blecsd';
+ *
+ * // Parent has red foreground
+ * setStyle(world, parent, { fg: 0xff0000ff });
+ *
+ * // Child has no foreground set
+ * appendChild(world, parent, child);
+ *
+ * const childStyle = computeInheritedStyle(world, child);
+ * // childStyle.fg === 0xff0000ff (inherited from parent)
+ * ```
+ */
+declare function computeInheritedStyle(world: World, eid: Entity): StyleData;
+/**
+ * Resolves the final style for an entity.
+ * This is an alias for computeInheritedStyle for clearer semantics.
+ *
+ * @param world - The ECS world
+ * @param eid - The entity ID
+ * @returns The resolved style with inheritance applied
+ *
+ * @example
+ * ```typescript
+ * import { resolveStyle, colorToHex } from 'blecsd';
+ *
+ * const style = resolveStyle(world, entity);
+ * console.log(`Foreground: ${colorToHex(style.fg)}`);
+ * ```
+ */
+declare function resolveStyle(world: World, eid: Entity): StyleData;
+/**
+ * Checks if a style property inherits from parent.
+ *
+ * @param property - The property name
+ * @returns true if the property inherits
+ *
+ * @example
+ * ```typescript
+ * import { doesPropertyInherit } from 'blecsd';
+ *
+ * doesPropertyInherit('fg');    // true
+ * doesPropertyInherit('bold');  // true
+ * doesPropertyInherit('bg');    // false
+ * ```
+ */
+declare function doesPropertyInherit(property: keyof StyleData): boolean;
+/**
+ * Gets the value of an inherited property for an entity.
+ * Walks up the hierarchy to find the first ancestor with a non-default value.
+ *
+ * @param world - The ECS world
+ * @param eid - The entity ID
+ * @param property - The property name
+ * @returns The inherited value
+ *
+ * @example
+ * ```typescript
+ * import { getInheritedProperty } from 'blecsd';
+ *
+ * const fg = getInheritedProperty(world, entity, 'fg');
+ * ```
+ */
+declare function getInheritedProperty<K extends keyof StyleData>(world: World, eid: Entity, property: K): StyleData[K];
+/**
+ * Gets the nearest ancestor with a non-default value for a property.
+ * Returns the entity itself if it has a non-default value.
+ *
+ * @param world - The ECS world
+ * @param eid - The entity ID
+ * @param property - The property name
+ * @returns The ancestor entity ID or 0 if no ancestor has the property set
+ *
+ * @example
+ * ```typescript
+ * import { findPropertySource } from 'blecsd';
+ *
+ * const source = findPropertySource(world, entity, 'fg');
+ * if (source !== 0) {
+ *   console.log(`Color inherited from entity ${source}`);
+ * }
+ * ```
+ */
+declare function findPropertySource(world: World, eid: Entity, property: keyof StyleData): Entity;
+/**
+ * Precomputes inherited styles for all entities in an array.
+ * Useful for batch processing before rendering.
+ *
+ * @param world - The ECS world
+ * @param entities - Array of entity IDs
+ *
+ * @example
+ * ```typescript
+ * import { precomputeStyles, getAllEntities } from 'blecsd';
+ *
+ * const entities = getAllEntities(world);
+ * precomputeStyles(world, entities);
+ *
+ * // Now all styles are cached for fast access
+ * ```
+ */
+declare function precomputeStyles(world: World, entities: readonly Entity[]): void;
+/**
+ * Gets all computed styles for entities.
+ * More efficient than calling resolveStyle individually.
+ *
+ * @param world - The ECS world
+ * @param entities - Array of entity IDs
+ * @returns Map of entity IDs to computed styles
+ *
+ * @example
+ * ```typescript
+ * import { getComputedStyles } from 'blecsd';
+ *
+ * const styles = getComputedStyles(world, [entity1, entity2]);
+ * const style1 = styles.get(entity1);
+ * ```
+ */
+declare function getComputedStyles(world: World, entities: readonly Entity[]): Map<Entity, StyleData>;
+
+export { INHERITING_PROPERTIES as I, NON_INHERITING_PROPERTIES as N, computeInheritedStyle as a, getComputedStyles as b, clearStyleCache as c, doesPropertyInherit as d, getDefaultStyle as e, findPropertySource as f, getCacheGeneration as g, getInheritedProperty as h, getLocalStyle as i, hasValidStyleCache as j, invalidateAllStyleCaches as k, invalidateStyleCache as l, isDefaultColor as m, mergeStyles as n, precomputeStyles as p, resolveStyle as r };