@furystack/shades 11.0.35 → 12.0.0

package/esm/css-generator.spec.js

@@ -0,0 +1,162 @@
+import { describe, expect, it } from 'vitest';
+import { camelToKebab, generateCSS, generateCSSRule, isSelectorKey, propertiesToCSSString } from './css-generator.js';
+describe('css-generator', () => {
+    describe('camelToKebab', () => {
+        it('should convert camelCase to kebab-case', () => {
+            expect(camelToKebab('backgroundColor')).toBe('background-color');
+            expect(camelToKebab('fontSize')).toBe('font-size');
+            expect(camelToKebab('borderTopLeftRadius')).toBe('border-top-left-radius');
+        });
+        it('should handle single word properties', () => {
+            expect(camelToKebab('color')).toBe('color');
+            expect(camelToKebab('margin')).toBe('margin');
+        });
+        it('should handle empty string', () => {
+            expect(camelToKebab('')).toBe('');
+        });
+    });
+    describe('isSelectorKey', () => {
+        it('should return true for selector keys starting with &', () => {
+            expect(isSelectorKey('&:hover')).toBe(true);
+            expect(isSelectorKey('&:active')).toBe(true);
+            expect(isSelectorKey('& .className')).toBe(true);
+            expect(isSelectorKey('& > div')).toBe(true);
+        });
+        it('should return false for regular CSS property keys', () => {
+            expect(isSelectorKey('color')).toBe(false);
+            expect(isSelectorKey('backgroundColor')).toBe(false);
+            expect(isSelectorKey('fontSize')).toBe(false);
+        });
+    });
+    describe('propertiesToCSSString', () => {
+        it('should convert CSS properties object to CSS string', () => {
+            const result = propertiesToCSSString({
+                color: 'red',
+                backgroundColor: 'blue',
+            });
+            expect(result).toBe('color: red; background-color: blue');
+        });
+        it('should skip undefined and null values', () => {
+            const result = propertiesToCSSString({
+                color: 'red',
+                backgroundColor: undefined,
+            });
+            expect(result).toBe('color: red');
+        });
+        it('should skip empty string values', () => {
+            const result = propertiesToCSSString({
+                color: 'red',
+                backgroundColor: '',
+            });
+            expect(result).toBe('color: red');
+        });
+        it('should return empty string for empty object', () => {
+            const result = propertiesToCSSString({});
+            expect(result).toBe('');
+        });
+        it('should ignore selector keys', () => {
+            // Type assertion needed to test mixed object with selectors
+            const mixedObject = {
+                color: 'red',
+                '&:hover': { color: 'blue' },
+            };
+            const result = propertiesToCSSString(mixedObject);
+            expect(result).toBe('color: red');
+        });
+        it('should filter out non-string values', () => {
+            // Type assertion to test edge case with non-string values
+            const mixedObject = {
+                color: 'red',
+                opacity: 0.5, // number - should be filtered
+                display: 'flex',
+                hidden: true, // boolean - should be filtered
+            };
+            const result = propertiesToCSSString(mixedObject);
+            expect(result).toBe('color: red; display: flex');
+        });
+    });
+    describe('generateCSSRule', () => {
+        it('should generate a complete CSS rule', () => {
+            const result = generateCSSRule('my-component', {
+                color: 'red',
+                padding: '10px',
+            });
+            expect(result).toBe('my-component { color: red; padding: 10px; }');
+        });
+        it('should return empty string for empty properties', () => {
+            const result = generateCSSRule('my-component', {});
+            expect(result).toBe('');
+        });
+    });
+    describe('generateCSS', () => {
+        it('should generate CSS for base properties only', () => {
+            const result = generateCSS('my-component', {
+                color: 'red',
+                padding: '10px',
+            });
+            expect(result).toBe('my-component { color: red; padding: 10px; }');
+        });
+        it('should generate CSS with pseudo-selectors', () => {
+            const result = generateCSS('my-component', {
+                color: 'red',
+                '&:hover': { color: 'blue' },
+            });
+            expect(result).toContain('my-component { color: red; }');
+            expect(result).toContain('my-component:hover { color: blue; }');
+        });
+        it('should generate CSS with nested class selectors', () => {
+            const result = generateCSS('my-component', {
+                padding: '10px',
+                '& .inner': { fontWeight: 'bold' },
+            });
+            expect(result).toContain('my-component { padding: 10px; }');
+            expect(result).toContain('my-component .inner { font-weight: bold; }');
+        });
+        it('should generate CSS with child selectors', () => {
+            const result = generateCSS('my-component', {
+                display: 'flex',
+                '& > div': { margin: '5px' },
+            });
+            expect(result).toContain('my-component { display: flex; }');
+            expect(result).toContain('my-component > div { margin: 5px; }');
+        });
+        it('should handle multiple pseudo-selectors', () => {
+            const result = generateCSS('my-button', {
+                backgroundColor: 'blue',
+                '&:hover': { backgroundColor: 'darkblue' },
+                '&:active': { backgroundColor: 'navy' },
+                '&:disabled': { opacity: '0.5' },
+            });
+            expect(result).toContain('my-button { background-color: blue; }');
+            expect(result).toContain('my-button:hover { background-color: darkblue; }');
+            expect(result).toContain('my-button:active { background-color: navy; }');
+            expect(result).toContain('my-button:disabled { opacity: 0.5; }');
+        });
+        it('should handle empty css object', () => {
+            const result = generateCSS('my-component', {});
+            expect(result).toBe('');
+        });
+        it('should handle css object with only selectors', () => {
+            const result = generateCSS('my-component', {
+                '&:hover': { color: 'blue' },
+            });
+            expect(result).toBe('my-component:hover { color: blue; }');
+        });
+        it('should skip selector keys with non-object values', () => {
+            // Type assertion to test edge case with invalid selector values
+            const cssObject = {
+                color: 'red',
+                '&:hover': 'invalid', // string instead of object - should be skipped
+                '&:active': null, // null - should be skipped
+                '&:focus': { backgroundColor: 'blue' }, // valid - should be included
+            };
+            const result = generateCSS('my-component', cssObject);
+            expect(result).toContain('my-component { color: red; }');
+            expect(result).toContain('my-component:focus { background-color: blue; }');
+            expect(result).not.toContain('invalid');
+            expect(result).not.toContain(':hover');
+            expect(result).not.toContain(':active');
+        });
+    });
+});
+//# sourceMappingURL=css-generator.spec.js.map

package/esm/css-generator.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-generator.spec.js","sourceRoot":"","sources":["../src/css-generator.spec.ts"],"names":[],"mappings":"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"}

package/esm/index.d.ts

@@ -1,10 +1,12 @@
 export * from './compile-route.js';
 export * from './components/index.js';
+export * from './css-generator.js';
 export * from './initialize.js';
 export * from './models/index.js';
 export * from './services/index.js';
 export * from './shade-component.js';
 export * from './shade.js';
+export * from './style-manager.js';
 export * from './styled-element.js';
 export * from './styled-shade.js';
 import './jsx.js';

package/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,YAAY,CAAA;AAC1B,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,OAAO,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,OAAO,UAAU,CAAA"}

package/esm/index.js

@@ -1,10 +1,12 @@
 export * from './compile-route.js';
 export * from './components/index.js';
+export * from './css-generator.js';
 export * from './initialize.js';
 export * from './models/index.js';
 export * from './services/index.js';
 export * from './shade-component.js';
 export * from './shade.js';
+export * from './style-manager.js';
 export * from './styled-element.js';
 export * from './styled-shade.js';
 import './jsx.js';

package/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,YAAY,CAAA;AAC1B,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,OAAO,UAAU,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,OAAO,UAAU,CAAA"}

package/esm/initialize.d.ts

@@ -1,8 +1,19 @@
 import type { Injector } from '@furystack/inject';
+/**
+ * Options for bootstrapping a Shades application.
+ */
 export interface InitializeOptions {
+    /** The DOM element that will host the application */
     rootElement: HTMLElement;
+    /** The root JSX element to render */
     jsxElement: JSX.Element;
+    /** The root injector instance for dependency injection */
     injector: Injector;
 }
+/**
+ * Bootstraps a Shades application by attaching the root JSX element to a DOM node
+ * and wiring up the dependency injection context.
+ * @param options The initialization options
+ */
 export declare const initializeShadeRoot: (options: InitializeOptions) => void;
 //# sourceMappingURL=initialize.d.ts.map

package/esm/initialize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initialize.d.ts","sourceRoot":"","sources":["../src/initialize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAEjD,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,WAAW,CAAA;IACxB,UAAU,EAAE,GAAG,CAAC,OAAO,CAAA;IACvB,QAAQ,EAAE,QAAQ,CAAA;CACnB;AACD,eAAO,MAAM,mBAAmB,GAAI,SAAS,iBAAiB,SAG7D,CAAA"}
+{"version":3,"file":"initialize.d.ts","sourceRoot":"","sources":["../src/initialize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAEjD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,WAAW,EAAE,WAAW,CAAA;IACxB,qCAAqC;IACrC,UAAU,EAAE,GAAG,CAAC,OAAO,CAAA;IACvB,0DAA0D;IAC1D,QAAQ,EAAE,QAAQ,CAAA;CACnB;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,iBAAiB,SAG7D,CAAA"}

package/esm/initialize.js

@@ -1,3 +1,8 @@
+/**
+ * Bootstraps a Shades application by attaching the root JSX element to a DOM node
+ * and wiring up the dependency injection context.
+ * @param options The initialization options
+ */
 export const initializeShadeRoot = (options) => {
     options.jsxElement.injector = options.injector;
     options.rootElement.appendChild(options.jsxElement);

package/esm/initialize.js.map

@@ -1 +1 @@
-{"version":3,"file":"initialize.js","sourceRoot":"","sources":["../src/initialize.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAA0B,EAAE,EAAE;IAChE,OAAO,CAAC,UAAU,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAA;IAC9C,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;AACrD,CAAC,CAAA"}
+{"version":3,"file":"initialize.js","sourceRoot":"","sources":["../src/initialize.ts"],"names":[],"mappings":"AAcA;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAA0B,EAAE,EAAE;IAChE,OAAO,CAAC,UAAU,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAA;IAC9C,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;AACrD,CAAC,CAAA"}

package/esm/jsx.d.ts

@@ -1,6 +1,7 @@
 import type { Injector } from '@furystack/inject';
 import type { ChildrenList, PartialElement } from './models/index.js';
 import type { ResourceManager } from './services/resource-manager.js';
+import type { SvgAnimateAttributes, SvgAnimateMotionAttributes, SvgAnimateTransformAttributes, SvgCircleAttributes, SvgClipPathAttributes, SvgCoreAttributes, SvgDefsAttributes, SvgDescAttributes, SvgEllipseAttributes, SvgFeBlendAttributes, SvgFeColorMatrixAttributes, SvgFeCompositeAttributes, SvgFeFloodAttributes, SvgFeGaussianBlurAttributes, SvgFeMergeAttributes, SvgFeMergeNodeAttributes, SvgFeOffsetAttributes, SvgFilterAttributes, SvgForeignObjectAttributes, SvgGAttributes, SvgImageAttributes, SvgLinearGradientAttributes, SvgLineAttributes, SvgMarkerAttributes, SvgMaskAttributes, SvgPathAttributes, SvgPatternAttributes, SvgPolygonAttributes, SvgPolylineAttributes, SvgRadialGradientAttributes, SvgRectAttributes, SvgSetAttributes, SvgStopAttributes, SvgSvgAttributes, SvgSymbolAttributes, SvgTextAttributes, SvgTextPathAttributes, SvgTitleAttributes, SvgTspanAttributes, SvgUseAttributes } from './svg-types.js';
 declare global {
     export namespace JSX {
         interface Element<TProps = any> extends HTMLElement {
@@ -8,7 +9,6 @@ declare global {
             props: TProps;
             updateComponent: () => void;
             shadeChildren?: ChildrenList;
-            callConstructed: () => void;
             resourceManager: ResourceManager;
             getRenderCount(): number;
         }
@@ -427,7 +427,7 @@ declare global {
              * The <svg> tag defines a container for SVG graphics.
              * SVG has several methods for drawing paths, boxes, circles, text, and graphic images.
              */
-            svg: PartialElement<SVGElement>;
+            svg: SvgSvgAttributes;
             /**
              * The <table> tag defines an HTML table.
              * An HTML table consists of the <table> element and one or more <tr>, <th>, and <td> elements.
@@ -522,6 +522,87 @@ declare global {
              * Tip: When a word is too long, or you are afraid that the browser will break your lines at the wrong place, you can use the <wbr> element to add word break opportunities.
              */
             wbr: PartialElement<HTMLElement>;
+            /** The `<g>` element groups SVG elements together. */
+            g: SvgGAttributes;
+            /** The `<defs>` element stores graphical objects for later reuse. */
+            defs: SvgDefsAttributes;
+            /** The `<symbol>` element defines a reusable graphical template. */
+            symbol: SvgSymbolAttributes;
+            /** The `<use>` element references another element for rendering. */
+            use: SvgUseAttributes;
+            /** The `<path>` element defines a shape via SVG path commands. */
+            path: SvgPathAttributes;
+            /** The `<rect>` element draws a rectangle. */
+            rect: SvgRectAttributes;
+            /** The `<circle>` element draws a circle. */
+            circle: SvgCircleAttributes;
+            /** The `<ellipse>` element draws an ellipse. */
+            ellipse: SvgEllipseAttributes;
+            /** The `<line>` element draws a straight line between two points. */
+            line: SvgLineAttributes;
+            /** The `<polyline>` element draws connected straight line segments. */
+            polyline: SvgPolylineAttributes;
+            /** The `<polygon>` element draws a closed shape of connected line segments. */
+            polygon: SvgPolygonAttributes;
+            /** The `<text>` element renders text in SVG. */
+            text: SvgTextAttributes;
+            /** The `<tspan>` element defines a subtext within a `<text>` element. */
+            tspan: SvgTspanAttributes;
+            /** The `<textPath>` element renders text along a path. */
+            textPath: SvgTextPathAttributes;
+            /** The `<clipPath>` element defines a clipping region. */
+            clipPath: SvgClipPathAttributes;
+            /** The `<mask>` element defines an alpha mask for compositing. */
+            mask: SvgMaskAttributes;
+            /** The `<linearGradient>` element defines a linear color gradient. */
+            linearGradient: SvgLinearGradientAttributes;
+            /** The `<radialGradient>` element defines a radial color gradient. */
+            radialGradient: SvgRadialGradientAttributes;
+            /** The `<stop>` element defines a color stop in a gradient. */
+            stop: SvgStopAttributes;
+            /** The `<pattern>` element defines a repeating graphic pattern. */
+            pattern: SvgPatternAttributes;
+            /** The `<marker>` element defines a graphic for drawing on edges of shapes. */
+            marker: SvgMarkerAttributes;
+            /** The `<filter>` element defines a set of filter operations. */
+            filter: SvgFilterAttributes;
+            /** The `<feGaussianBlur>` filter primitive blurs the input image. */
+            feGaussianBlur: SvgFeGaussianBlurAttributes;
+            /** The `<feBlend>` filter primitive composites two inputs. */
+            feBlend: SvgFeBlendAttributes;
+            /** The `<feColorMatrix>` filter primitive applies a matrix color transform. */
+            feColorMatrix: SvgFeColorMatrixAttributes;
+            /** The `<feOffset>` filter primitive offsets the input image. */
+            feOffset: SvgFeOffsetAttributes;
+            /** The `<feFlood>` filter primitive fills with a solid color. */
+            feFlood: SvgFeFloodAttributes;
+            /** The `<feMerge>` filter primitive composites multiple inputs. */
+            feMerge: SvgFeMergeAttributes;
+            /** The `<feMergeNode>` element defines an input for `<feMerge>`. */
+            feMergeNode: SvgFeMergeNodeAttributes;
+            /** The `<feComposite>` filter primitive combines images using Porter-Duff operations. */
+            feComposite: SvgFeCompositeAttributes;
+            /** The `<image>` element (SVG) embeds a raster image. */
+            image: SvgImageAttributes;
+            /** The `<foreignObject>` element embeds external XML (e.g. HTML) in SVG. */
+            foreignObject: SvgForeignObjectAttributes;
+            /** The `<animate>` element animates an attribute over time. */
+            animate: SvgAnimateAttributes;
+            /** The `<animateMotion>` element animates an element along a path. */
+            animateMotion: SvgAnimateMotionAttributes;
+            /** The `<animateTransform>` element animates a transformation attribute. */
+            animateTransform: SvgAnimateTransformAttributes;
+            /** The `<set>` element sets an attribute to a value for a duration. */
+            set: SvgSetAttributes;
+            /** The `<title>` element (SVG) provides an accessible title. */
+            title: SvgTitleAttributes;
+            /** The `<desc>` element provides an accessible description. */
+            desc: SvgDescAttributes;
+            /**
+             * Catch-all for SVG filter primitives and other SVG elements
+             * not explicitly listed above.
+             */
+            [key: `fe${string}`]: SvgCoreAttributes;
         }
     }
 }

package/esm/jsx.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jsx.d.ts","sourceRoot":"","sources":["../src/jsx.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"jsx.d.ts","sourceRoot":"","sources":["../src/jsx.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AACrE,OAAO,KAAK,EACV,oBAAoB,EACpB,0BAA0B,EAC1B,6BAA6B,EAC7B,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAC1B,wBAAwB,EACxB,oBAAoB,EACpB,2BAA2B,EAC3B,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,0BAA0B,EAC1B,cAAc,EACd,kBAAkB,EAClB,2BAA2B,EAC3B,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,2BAA2B,EAC3B,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,CAAC,MAAM,CAAC;IAEb,MAAM,WAAW,GAAG,CAAC;QACnB,UAAU,OAAO,CAAC,MAAM,GAAG,GAAG,CAAE,SAAQ,WAAW;YACjD,QAAQ,EAAE,QAAQ,CAAA;YAClB,KAAK,EAAE,MAAM,CAAA;YACb,eAAe,EAAE,MAAM,IAAI,CAAA;YAC3B,aAAa,CAAC,EAAE,YAAY,CAAA;YAC5B,eAAe,EAAE,eAAe,CAAA;YAChC,cAAc,IAAI,MAAM,CAAA;SACzB;QAED,UAAU,iBAAiB;YACzB;;eAEG;YACH,CAAC,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAA;YACpC;;eAEG;YACH,IAAI,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YACjC;;;;eAIG;YACH,OAAO,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YACpC;;;eAGG;YACH,IAAI,EAAE,cAAc,CAAC,eAAe,CAAC,CAAA;YACrC;;;eAGG;YACH,OAAO,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YACpC;;;eAGG;YACH,KAAK,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YAClC;;eAEG;YACH,KAAK,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAA;YACvC;;eAEG;YACH,CAAC,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YAC9B;;eAEG;YACH,UAAU,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YACvC;;eAEG;YACH,EAAE,EAAE,cAAc,CAAC,aAAa,CAAC,CAAA;YACjC;;;eAGG;YACH,MAAM,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAA;YACzC;;eAEG;YACH,MAAM,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAA;YACzC;;eAEG;YACH,OAAO,EAAE,cAAc,CAAC,uBAAuB,CAAC,CAAA;YAChD;;eAEG;YACH,IAAI,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YACjC;;eAEG;YACH,IAAI,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YACjC;;;eAGG;YACH,GAAG,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YAChC;;;eAGG;YACH,QAAQ,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YACrC;;;eAGG;YACH,IAAI,EAAE,cAAc,CAAC,eAAe,CAAC,CAAA;YACrC;;;;eAIG;YACH,QAAQ,EAAE,cAAc,CAAC,mBAAmB,CAAC,CAAA;YAC7C;;;;eAIG;YACH,EAAE,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YAC/B;;;;eAIG;YACH,GAAG,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YAChC;;;;eAIG;YACH,OAAO,EAAE,cAAc,CAAC,kBAAkB,CAAC,CAAA;YAC3C;;;;;eAKG;YACH,GAAG,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YAChC;;;eAGG;YACH,MAAM,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAA;YACzC;;;eAGG;YACH,GAAG,EAAE,cAAc,CAAC,cAAc,CAAC,CAAA;YACnC;;;eAGG;YACH,EAAE,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YAC/B;;;eAGG;YACH,EAAE,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YAC/B;;;eAGG;YACH,EAAE,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YAC/B;;eAEG;YACH,KAAK,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAA;YACvC;;;eAGG;YACH,QAAQ,EAAE,cAAc,CAAC,mBAAmB,CAAC,CAAA;YAC7C;;;eAGG;YACH,UAAU,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YACvC;;;eAGG;YACH,MAAM,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YACnC;;;eAGG;YACH,MAAM,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YACnC;;eAEG;YACH,IAAI,EAAE,cAAc,CAAC,WAAW,CAAC,GAAG;gBAAE,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,KAAK,KAAK,IAAI,GAAG,SAAS,GAAG,OAAO,CAAA;aAAE,CAAA;YAC1F;;;eAGG;YACH,EAAE,EAAE,cAAc,CAAC,kBAAkB,CAAC,CAAA;YACtC;;;eAGG;YACH,EAAE,EAAE,cAAc,CAAC,kBAAkB,CAAC,CAAA;YACtC;;;eAGG;YACH,EAAE,EAAE,cAAc,CAAC,kBAAkB,CAAC,CAAA;YACtC;;;eAGG;YACH,EAAE,EAAE,cAAc,CAAC,kBAAkB,CAAC,CAAA;YACtC;;;eAGG;YACH,EAAE,EAAE,cAAc,CAAC,kBAAkB,CAAC,CAAA;YACtC;;;eAGG;YACH,EAAE,EAAE,cAAc,CAAC,kBAAkB,CAAC,CAAA;YACtC;;eAEG;YACH,MAAM,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YACnC;;eAEG;YACH,EAAE,EAAE,cAAc,CAAC,aAAa,CAAC,CAAA;YACjC;;eAEG;YACH,CAAC,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YAC9B;;;eAGG;YACH,MAAM,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAA;YACzC;;eAEG;YACH,GAAG,EAAE,cAAc,CAAC,gBAAgB,CAAC,GAAG;gBAAE,GAAG,EAAE,MAAM,CAAC;gBAAC,GAAG,EAAE,MAAM,CAAA;aAAE,CAAA;YACpE;;eAEG;YACH,KAAK,EAAE,cAAc,CAAC,gBAAgB,GAAG;gBAAE,SAAS,CAAC,EAAE,OAAO,CAAA;aAAE,CAAC,CAAA;YACjE;;eAEG;YACH,GAAG,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YAChC;;eAEG;YACH,GAAG,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YAChC;;eAEG;YACH,KAAK,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAA;YACvC;;eAEG;YACH,MAAM,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAA;YACzC;;eAEG;YACH,EAAE,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YAC/B;;;;eAIG;YACH,IAAI,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YACjC;;;;eAIG;YACH,GAAG,EAAE,cAAc,CAAC,cAAc,CAAC,CAAA;YACnC;;;eAGG;YACH,IAAI,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YACjC;;;;;eAKG;YACH,KAAK,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAA;YACvC;;;;eAIG;YACH,GAAG,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YAChC;;;;eAIG;YACH,MAAM,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAA;YACzC;;;eAGG;YACH,EAAE,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAA;YACpC;;;eAGG;YACH,QAAQ,EAAE,cAAc,CAAC,mBAAmB,CAAC,CAAA;YAC7C;;;eAGG;YACH,MAAM,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAA;YACzC;;eAEG;YACH,MAAM,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAA;YACzC;;eAEG;YACH,CAAC,EAAE,cAAc,CAAC,oBAAoB,CAAC,CAAA;YACvC;;;eAGG;YACH,KAAK,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAA;YACvC;;;;;;;;;;;;;;eAcG;YACH,OAAO,EAAE,cAAc,CAAC,kBAAkB,CAAC,CAAA;YAC3C;;;eAGG;YACH,GAAG,EAAE,cAAc,CAAC,cAAc,CAAC,CAAA;YACnC;;eAEG;YACH,QAAQ,EAAE,cAAc,CAAC,mBAAmB,CAAC,CAAA;YAC7C;;;eAGG;YACH,CAAC,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAA;YACnC;;;eAGG;YACH,EAAE,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YAC/B;;;eAGG;YACH,EAAE,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YAC/B;;;;eAIG;YACH,IAAI,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YACjC;;;eAGG;YACH,CAAC,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YAC9B;;eAEG;YACH,IAAI,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YACjC;;eAEG;YACH,OAAO,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YACpC;;;eAGG;YACH,MAAM,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAA;YACzC;;eAEG;YACH,KAAK,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YAClC;;;eAGG;YACH,MAAM,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAA;YACzC;;;;eAIG;YACH,IAAI,EAAE,cAAc,CAAC,eAAe,CAAC,CAAA;YACrC;;eAEG;YACH,MAAM,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YACnC;;eAEG;YACH,KAAK,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAA;YACvC;;eAEG;YACH,GAAG,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YAChC;;eAEG;YACH,OAAO,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YACpC;;eAEG;YACH,GAAG,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YAChC;;;eAGG;YACH,GAAG,EAAE,gBAAgB,CAAA;YACrB;;;;;eAKG;YACH,KAAK,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAA;YACvC;;;;;eAKG;YACH,KAAK,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YAClC;;;;;;;eAOG;YACH,EAAE,EAAE,cAAc,CAAC,oBAAoB,CAAC,CAAA;YACxC;;;;;eAKG;YACH,QAAQ,EAAE,cAAc,CAAC,mBAAmB,CAAC,CAAA;YAC7C;;;;eAIG;YACH,QAAQ,EAAE,cAAc,CAAC,mBAAmB,CAAC,CAAA;YAC7C;;;;;eAKG;YACH,KAAK,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YAElC;;;;;;;eAOG;YACH,EAAE,EAAE,cAAc,CAAC,0BAA0B,CAAC,CAAA;YAC9C;;;;eAIG;YACH,KAAK,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YAClC;;eAEG;YACH,IAAI,EAAE,cAAc,CAAC,eAAe,CAAC,CAAA;YACrC;;;eAGG;YACH,EAAE,EAAE,cAAc,CAAC,mBAAmB,CAAC,CAAA;YACvC;;;eAGG;YACH,KAAK,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAA;YACvC;;eAEG;YACH,CAAC,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YAC9B;;;eAGG;YACH,EAAE,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAA;YACpC;;eAEG;YACH,GAAG,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YAChC;;eAEG;YACH,KAAK,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAA;YACvC;;;eAGG;YACH,GAAG,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;YAMhC,sDAAsD;YACtD,CAAC,EAAE,cAAc,CAAA;YACjB,qEAAqE;YACrE,IAAI,EAAE,iBAAiB,CAAA;YACvB,oEAAoE;YACpE,MAAM,EAAE,mBAAmB,CAAA;YAC3B,oEAAoE;YACpE,GAAG,EAAE,gBAAgB,CAAA;YACrB,kEAAkE;YAClE,IAAI,EAAE,iBAAiB,CAAA;YACvB,8CAA8C;YAC9C,IAAI,EAAE,iBAAiB,CAAA;YACvB,6CAA6C;YAC7C,MAAM,EAAE,mBAAmB,CAAA;YAC3B,gDAAgD;YAChD,OAAO,EAAE,oBAAoB,CAAA;YAC7B,qEAAqE;YACrE,IAAI,EAAE,iBAAiB,CAAA;YACvB,uEAAuE;YACvE,QAAQ,EAAE,qBAAqB,CAAA;YAC/B,+EAA+E;YAC/E,OAAO,EAAE,oBAAoB,CAAA;YAC7B,gDAAgD;YAChD,IAAI,EAAE,iBAAiB,CAAA;YACvB,yEAAyE;YACzE,KAAK,EAAE,kBAAkB,CAAA;YACzB,0DAA0D;YAC1D,QAAQ,EAAE,qBAAqB,CAAA;YAC/B,0DAA0D;YAC1D,QAAQ,EAAE,qBAAqB,CAAA;YAC/B,kEAAkE;YAClE,IAAI,EAAE,iBAAiB,CAAA;YACvB,sEAAsE;YACtE,cAAc,EAAE,2BAA2B,CAAA;YAC3C,sEAAsE;YACtE,cAAc,EAAE,2BAA2B,CAAA;YAC3C,+DAA+D;YAC/D,IAAI,EAAE,iBAAiB,CAAA;YACvB,mEAAmE;YACnE,OAAO,EAAE,oBAAoB,CAAA;YAC7B,+EAA+E;YAC/E,MAAM,EAAE,mBAAmB,CAAA;YAC3B,iEAAiE;YACjE,MAAM,EAAE,mBAAmB,CAAA;YAC3B,qEAAqE;YACrE,cAAc,EAAE,2BAA2B,CAAA;YAC3C,8DAA8D;YAC9D,OAAO,EAAE,oBAAoB,CAAA;YAC7B,+EAA+E;YAC/E,aAAa,EAAE,0BAA0B,CAAA;YACzC,iEAAiE;YACjE,QAAQ,EAAE,qBAAqB,CAAA;YAC/B,iEAAiE;YACjE,OAAO,EAAE,oBAAoB,CAAA;YAC7B,mEAAmE;YACnE,OAAO,EAAE,oBAAoB,CAAA;YAC7B,oEAAoE;YACpE,WAAW,EAAE,wBAAwB,CAAA;YACrC,yFAAyF;YACzF,WAAW,EAAE,wBAAwB,CAAA;YACrC,yDAAyD;YACzD,KAAK,EAAE,kBAAkB,CAAA;YACzB,4EAA4E;YAC5E,aAAa,EAAE,0BAA0B,CAAA;YACzC,+DAA+D;YAC/D,OAAO,EAAE,oBAAoB,CAAA;YAC7B,sEAAsE;YACtE,aAAa,EAAE,0BAA0B,CAAA;YACzC,4EAA4E;YAC5E,gBAAgB,EAAE,6BAA6B,CAAA;YAC/C,uEAAuE;YACvE,GAAG,EAAE,gBAAgB,CAAA;YACrB,gEAAgE;YAChE,KAAK,EAAE,kBAAkB,CAAA;YACzB,+DAA+D;YAC/D,IAAI,EAAE,iBAAiB,CAAA;YACvB;;;eAGG;YACH,CAAC,GAAG,EAAE,KAAK,MAAM,EAAE,GAAG,iBAAiB,CAAA;SACxC;KACF;CACF"}

package/esm/models/children-list.d.ts

@@ -1,2 +1,6 @@
-export type ChildrenList = Array<string | HTMLElement | JSX.Element | string[] | HTMLElement[] | JSX.Element[]>;
+/**
+ * The type for children passed to Shade components and intrinsic JSX elements.
+ * Supports strings, HTML/SVG elements, JSX elements, and nested arrays of these.
+ */
+export type ChildrenList = Array<string | HTMLElement | SVGElement | JSX.Element | string[] | HTMLElement[] | SVGElement[] | JSX.Element[]>;
 //# sourceMappingURL=children-list.d.ts.map

package/esm/models/children-list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"children-list.d.ts","sourceRoot":"","sources":["../../src/models/children-list.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,GAAG,WAAW,GAAG,GAAG,CAAC,OAAO,GAAG,MAAM,EAAE,GAAG,WAAW,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC,CAAA"}
+{"version":3,"file":"children-list.d.ts","sourceRoot":"","sources":["../../src/models/children-list.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,CAC9B,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,GAAG,CAAC,OAAO,GAAG,MAAM,EAAE,GAAG,WAAW,EAAE,GAAG,UAAU,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,CAC1G,CAAA"}

package/esm/models/css-object.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Base CSS properties - subset of CSSStyleDeclaration
+ */
+export type CSSProperties = Partial<CSSStyleDeclaration>;
+/**
+ * Selector key pattern for pseudo-classes and nested selectors
+ * Examples: '&:hover', '&:active', '& .className', '& > div'
+ */
+export type SelectorKey = `&${string}`;
+/**
+ * CSS object supporting nested selectors for component-level styling.
+ *
+ * Use this type for the `css` property in Shade components to define
+ * styles that are injected as a stylesheet during component registration.
+ *
+ * @example
+ * ```typescript
+ * const styles: CSSObject = {
+ *   padding: '16px',
+ *   backgroundColor: 'white',
+ *   '&:hover': {
+ *     backgroundColor: '#f0f0f0'
+ *   },
+ *   '& .title': {
+ *     fontWeight: 'bold'
+ *   }
+ * }
+ * ```
+ */
+export type CSSObject = CSSProperties & {
+    [K in SelectorKey]?: CSSProperties;
+};
+//# sourceMappingURL=css-object.d.ts.map

package/esm/models/css-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-object.d.ts","sourceRoot":"","sources":["../../src/models/css-object.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;AAExD;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,MAAM,EAAE,CAAA;AAEtC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG;KACrC,CAAC,IAAI,WAAW,CAAC,CAAC,EAAE,aAAa;CACnC,CAAA"}

package/esm/models/css-object.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=css-object.js.map

package/esm/models/css-object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-object.js","sourceRoot":"","sources":["../../src/models/css-object.ts"],"names":[],"mappings":""}

package/esm/models/index.d.ts

@@ -1,4 +1,5 @@
 export * from './children-list.js';
+export * from './css-object.js';
 export * from './partial-element.js';
 export * from './render-options.js';
 export * from './selection-state.js';

package/esm/models/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA"}

package/esm/models/index.js

@@ -1,4 +1,5 @@
 export * from './children-list.js';
+export * from './css-object.js';
 export * from './partial-element.js';
 export * from './render-options.js';
 export * from './selection-state.js';

package/esm/models/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA"}

package/esm/models/partial-element.d.ts

@@ -1,6 +1,16 @@
-export type PartialElement<T> = T extends {
+import type { RefObject } from './render-options.js';
+/**
+ * Makes all properties of an HTML element type optional, with `style` narrowed
+ * to `Partial<CSSStyleDeclaration>` and a `ref` prop for capturing DOM references.
+ * Used as the props type for intrinsic JSX elements and component host element overrides.
+ * @typeParam T - The base HTML element type
+ */
+export type PartialElement<T> = (T extends {
     style?: CSSStyleDeclaration;
 } ? Omit<Partial<T>, 'style'> & {
     style?: Partial<CSSStyleDeclaration>;
-} : Partial<T>;
+} : Partial<T>) & {
+    /** Ref object to capture a reference to the underlying DOM element. */
+    ref?: RefObject<Element>;
+};
 //# sourceMappingURL=partial-element.d.ts.map

package/esm/models/partial-element.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"partial-element.d.ts","sourceRoot":"","sources":["../../src/models/partial-element.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,KAAK,CAAC,EAAE,mBAAmB,CAAA;CAAE,GACrE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAA;CACrC,GACD,OAAO,CAAC,CAAC,CAAC,CAAA"}
+{"version":3,"file":"partial-element.d.ts","sourceRoot":"","sources":["../../src/models/partial-element.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAEpD;;;;;GAKG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS;IAAE,KAAK,CAAC,EAAE,mBAAmB,CAAA;CAAE,GACtE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAA;CACrC,GACD,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG;IAChB,uEAAuE;IACvE,GAAG,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAA;CACzB,CAAA"}

package/esm/models/render-options.d.ts

@@ -2,12 +2,80 @@ import type { Injector } from '@furystack/inject';
 import type { ObservableValue, ValueObserverOptions } from '@furystack/utils';
 import type { ChildrenList } from './children-list.js';
 import type { PartialElement } from './partial-element.js';
+/**
+ * A reference object returned by `useRef`.
+ * `current` is set to the DOM element when it is mounted, and `null` when unmounted.
+ * The `readonly` modifier ensures covariance so that `RefObject<HTMLInputElement>`
+ * is assignable to `RefObject<Element>`.
+ */
+export type RefObject<T extends Element = HTMLElement> = {
+    readonly current: T | null;
+};
+/**
+ * Options provided to a Shade component's `render` function.
+ * Contains the current props, injector, children, and hooks for managing state, side effects, and host element attributes.
+ * @typeParam TProps - The component's props type
+ * @typeParam TElementBase - The base HTML element type (defaults to HTMLElement)
+ */
 export type RenderOptions<TProps, TElementBase extends HTMLElement = HTMLElement> = {
     readonly props: TProps & PartialElement<TElementBase>;
     renderCount: number;
     injector: Injector;
     children?: ChildrenList;
-    element: JSX.Element<TProps>;
+    /**
+     * Declaratively sets attributes and styles on the host custom element.
+     * Can be called multiple times per render; each call merges into the previous values.
+     *
+     * CSS custom properties (e.g. `--my-color`) are applied via `setProperty`.
+     * The `style` property accepts both standard camelCase properties and CSS custom properties.
+     *
+     * **Best practice:** Use `useHostProps` for data attributes, ARIA attributes, CSS variables,
+     * and event handlers on the host element instead of imperative DOM manipulation.
+     *
+     * @param hostProps An object of attribute key-value pairs, optionally including a `style` record
+     *
+     * **Note:** Object and function values are assigned as properties on the host element
+     * (not as attributes). This means you can set event handlers (e.g. `onclick`) and
+     * even class properties like `injector` via `useHostProps`.
+     *
+     * @example
+     * ```typescript
+     * useHostProps({
+     *   'data-variant': props.variant,
+     *   role: 'progressbar',
+     *   'aria-valuenow': String(value),
+     *   style: {
+     *     '--btn-color-main': colors.main,
+     *     display: 'flex',
+     *   },
+     * })
+     * ```
+     */
+    useHostProps: (hostProps: Record<string, unknown> & {
+        style?: Record<string, string>;
+    }) => void;
+    /**
+     * Creates a mutable ref object that can be attached to intrinsic JSX elements via the `ref` prop.
+     * The ref's `current` property will be set to the DOM element after mount and `null` on unmount.
+     *
+     * Refs are cached by key, so calling `useRef` with the same key returns the same object across renders.
+     *
+     * **Best practice:** Prefer declarative JSX and `useHostProps` when possible.
+     * Use refs sparingly for imperative needs like focus management or measuring elements.
+     *
+     * @param key A unique key for caching the ref object
+     * @returns A ref object with a `current` property
+     *
+     * @example
+     * ```typescript
+     * const inputRef = useRef<HTMLInputElement>('input')
+     * // In JSX:
+     * <input ref={inputRef} />
+     * // Later:
+     * inputRef.current?.focus()
+     * ```
+     */
+    useRef: <T extends Element = HTMLElement>(key: string) => RefObject<T>;
     /**
      * Creates and disposes a resource after the component has been detached from the DOM
      * @param key The key for caching the disposable resource
@@ -16,11 +84,29 @@ export type RenderOptions<TProps, TElementBase extends HTMLElement = HTMLElement
      */
     useDisposable: <T extends Disposable | AsyncDisposable>(key: string, factory: () => T) => T;
     /**
-     * Creates a state object from an existing observable value
+     * Creates a state object from an existing observable value.
+     *
+     * **Important:** By default, this will trigger a full component re-render when the observable value changes.
+     * To prevent re-renders (e.g., for manual DOM updates or animations), provide a custom `onChange` callback.
+     *
      * @param key The key for caching the observable value
      * @param observable The observable value to observe
-     * @param options Optional options for the observer including onChange callback
+     * @param options Optional options for the observer
+     * @param options.onChange Custom callback when value changes. If not provided, the component will re-render on each change.
      * @returns tuple with the current value and a setter function
+     *
+     * @example
+     * // Default behavior: re-renders component on change
+     * const [count] = useObservable('count', countObservable)
+     *
+     * @example
+     * // Custom onChange: no re-render, update host element via useHostProps
+     * useHostProps({ 'data-active': count > 0 ? '' : undefined })
+     * const [count] = useObservable('count', countObservable, {
+     *   onChange: () => {
+     *     // Triggers a re-render so useHostProps above picks up the new value
+     *   }
+     * })
      */
     useObservable: <T>(key: string, observable: ObservableValue<T>, options?: ValueObserverOptions<T> & {
         onChange?: (newValue: T) => void;