@praxisjs/css 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,26 @@
+# @praxisjs/css
+
+## 0.1.0
+
+### Minor Changes
+
+- 74fabcc: Initial release of `@praxisjs/css`.
+
+  Scoped CSS with typed class names, reactive CSS custom properties, a fluent builder, design tokens, and static build-time extraction via the `praxisjsCSS()` Vite plugin.
+
+  **Stylesheet API**: `Stylesheet`, `ReactiveStylesheet`, `@Styled()`, `this.css({})`, `@Param()`, `@Style()`, `keyframes()`, `cx()`.
+
+  **`globalStyle(factory)`** — injects unscoped CSS via a factory that receives `css` (= `createCSSBuilder`, same as `this.css()` in `Stylesheet`) and returns a `CSSBuilder` or raw string. Use `.on(selector, props)` for element rules.
+
+  **`preflight()`** — opinionated browser reset inspired by Tailwind CSS preflight, with standard system font stacks (no Tailwind-specific references). Idempotent and statically extracted by the Vite plugin.
+
+  **Design tokens**: `TokenSheet`, `tokenVars()`, `ThemeInstance`, `@Themed()`, `@Theme()`, `theme()`.
+
+  **Static extraction**: `praxisjsCSS()` Vite plugin (exported from `@praxisjs/vite-plugin`) extracts all CSS at build time into `virtual:praxisjs/styles.css`.
+
+  **SSR / integrator APIs**: `@praxisjs/css/server` (collector API) and `@praxisjs/css/extract` (build-time extraction module).
+
+### Patch Changes
+
+- Updated dependencies [a0372af]
+  - @praxisjs/decorators@1.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-present Mateus Martins
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/__tests__/css-builder.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=css-builder.test.d.ts.map

package/dist/__tests__/css-builder.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-builder.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/css-builder.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/css-builder.test.js

@@ -0,0 +1,198 @@
+import { describe, expect, it } from "vitest";
+import { createCSSBuilder, isCSSBuilder } from "../builder/css-builder";
+describe("createCSSBuilder()", () => {
+    it("serialises a flat property object to CSS declarations", () => {
+        const css = createCSSBuilder({ display: "flex", gap: "12px", padding: "16px" });
+        expect(String(css)).toBe("display: flex;\ngap: 12px;\npadding: 16px;");
+    });
+    it("converts camelCase properties to kebab-case", () => {
+        const css = createCSSBuilder({ flexDirection: "column", borderRadius: "8px", fontSize: "1rem" });
+        expect(String(css)).toContain("flex-direction: column;");
+        expect(String(css)).toContain("border-radius: 8px;");
+        expect(String(css)).toContain("font-size: 1rem;");
+    });
+    it("skips null and undefined values", () => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const css = createCSSBuilder({ display: "flex", color: undefined });
+        expect(String(css)).toBe("display: flex;");
+    });
+    it("returns empty string when no properties are given", () => {
+        expect(String(createCSSBuilder({}))).toBe("");
+    });
+    it("accepts CSS custom properties (--var)", () => {
+        const css = createCSSBuilder({ "--accent": "#3b82f6" });
+        expect(String(css)).toContain("--accent: #3b82f6;");
+    });
+});
+describe("CSSBuilder — pseudo-state nesting", () => {
+    it(".hover() adds &:hover block", () => {
+        const css = createCSSBuilder({ display: "flex" }).hover({ opacity: 0.9 });
+        const out = String(css);
+        expect(out).toContain("display: flex;");
+        expect(out).toContain("&:hover {");
+        expect(out).toContain("  opacity: 0.9;");
+    });
+    it(".focus() adds &:focus block", () => {
+        const out = String(createCSSBuilder({ color: "red" }).focus({ outline: "2px solid blue" }));
+        expect(out).toContain("&:focus {");
+        expect(out).toContain("  outline: 2px solid blue;");
+    });
+    it(".focusWithin() adds &:focus-within block", () => {
+        expect(String(createCSSBuilder({}).focusWithin({ color: "red" }))).toContain("&:focus-within {");
+    });
+    it(".focusVisible() adds &:focus-visible block", () => {
+        expect(String(createCSSBuilder({}).focusVisible({ outline: "none" }))).toContain("&:focus-visible {");
+    });
+    it(".active() adds &:active block", () => {
+        expect(String(createCSSBuilder({}).active({ transform: "scale(0.98)" }))).toContain("&:active {");
+    });
+    it(".disabled() adds &:disabled + aria-disabled block", () => {
+        const out = String(createCSSBuilder({}).disabled({ opacity: 0.4 }));
+        expect(out).toContain("&:disabled");
+        expect(out).toContain("aria-disabled");
+    });
+    it(".checked() adds &:checked block", () => {
+        expect(String(createCSSBuilder({}).checked({ background: "blue" }))).toContain("&:checked {");
+    });
+    it(".placeholder() adds &::placeholder block", () => {
+        expect(String(createCSSBuilder({}).placeholder({ color: "#999" }))).toContain("&::placeholder {");
+    });
+    it(".first() adds &:first-child block", () => {
+        expect(String(createCSSBuilder({}).first({ marginTop: 0 }))).toContain("&:first-child {");
+    });
+    it(".last() adds &:last-child block", () => {
+        expect(String(createCSSBuilder({}).last({ marginBottom: 0 }))).toContain("&:last-child {");
+    });
+    it(".nthChild() adds &:nth-child(n) block", () => {
+        expect(String(createCSSBuilder({}).nthChild("2n+1", { background: "#f0f0f0" }))).toContain("&:nth-child(2n+1) {");
+    });
+    it(".not() adds &:not(selector) block", () => {
+        expect(String(createCSSBuilder({}).not(".active", { opacity: 0.5 }))).toContain("&:not(.active) {");
+    });
+});
+describe("CSSBuilder — at-rule nesting", () => {
+    it(".media() adds @media (query) block", () => {
+        const out = String(createCSSBuilder({ display: "flex" }).media("max-width: 640px", { flexDirection: "column" }));
+        expect(out).toContain("@media (max-width: 640px) {");
+        expect(out).toContain("  flex-direction: column;");
+    });
+    it(".container() adds @container (query) block", () => {
+        const out = String(createCSSBuilder({}).container("min-width: 400px", { padding: "16px" }));
+        expect(out).toContain("@container (min-width: 400px) {");
+    });
+    it(".on() adds any arbitrary selector or at-rule", () => {
+        const out = String(createCSSBuilder({}).on("&::before", { content: '""', display: "block" }));
+        expect(out).toContain("&::before {");
+        expect(out).toContain("  content: \"\";");
+    });
+});
+describe("CSSBuilder — chaining", () => {
+    it("chains multiple nesting calls correctly", () => {
+        const out = String(createCSSBuilder({ display: "flex" })
+            .hover({ opacity: 0.9 })
+            .focus({ outline: "2px solid blue" })
+            .media("max-width: 640px", { flexDirection: "column" }));
+        expect(out).toContain("display: flex;");
+        expect(out).toContain("&:hover {");
+        expect(out).toContain("&:focus {");
+        expect(out).toContain("@media (max-width: 640px) {");
+    });
+    it("each chained call returns the same builder (fluent pattern)", () => {
+        const b1 = createCSSBuilder({ display: "flex" });
+        const b2 = b1.hover({ opacity: 0.9 });
+        expect(b1).toBe(b2);
+    });
+    it("skips nested block when props are empty", () => {
+        const out = String(createCSSBuilder({ display: "flex" }).hover({}));
+        expect(out).not.toContain("&:hover");
+    });
+});
+describe("CSSBuilder — pseudo-elements", () => {
+    it(".before() adds &::before block", () => {
+        expect(String(createCSSBuilder({}).before({ content: '""', display: "block" }))).toContain("&::before {");
+    });
+    it(".after() adds &::after block", () => {
+        expect(String(createCSSBuilder({}).after({ content: '""' }))).toContain("&::after {");
+    });
+    it(".selection() adds &::selection block", () => {
+        expect(String(createCSSBuilder({}).selection({ background: "blue" }))).toContain("&::selection {");
+    });
+    it(".firstLine() adds &::first-line block", () => {
+        expect(String(createCSSBuilder({}).firstLine({ fontWeight: "bold" }))).toContain("&::first-line {");
+    });
+    it(".firstLetter() adds &::first-letter block", () => {
+        expect(String(createCSSBuilder({}).firstLetter({ fontSize: "2em" }))).toContain("&::first-letter {");
+    });
+    it(".marker() adds &::marker block", () => {
+        expect(String(createCSSBuilder({}).marker({ color: "red" }))).toContain("&::marker {");
+    });
+    it(".backdrop() adds &::backdrop block", () => {
+        expect(String(createCSSBuilder({}).backdrop({ background: "rgba(0,0,0,0.5)" }))).toContain("&::backdrop {");
+    });
+});
+describe("CSSBuilder — form pseudo-classes", () => {
+    it(".enabled() adds &:enabled block", () => {
+        expect(String(createCSSBuilder({}).enabled({ opacity: 1 }))).toContain("&:enabled {");
+    });
+    it(".indeterminate() adds &:indeterminate block", () => {
+        expect(String(createCSSBuilder({}).indeterminate({ opacity: 0.5 }))).toContain("&:indeterminate {");
+    });
+    it(".required() adds &:required block", () => {
+        expect(String(createCSSBuilder({}).required({ borderColor: "red" }))).toContain("&:required {");
+    });
+    it(".optional() adds &:optional block", () => {
+        expect(String(createCSSBuilder({}).optional({ borderColor: "gray" }))).toContain("&:optional {");
+    });
+    it(".valid() adds &:valid block", () => {
+        expect(String(createCSSBuilder({}).valid({ borderColor: "green" }))).toContain("&:valid {");
+    });
+    it(".invalid() adds &:invalid block", () => {
+        expect(String(createCSSBuilder({}).invalid({ borderColor: "red" }))).toContain("&:invalid {");
+    });
+    it(".readOnly() adds &:read-only block", () => {
+        expect(String(createCSSBuilder({}).readOnly({ opacity: 0.7 }))).toContain("&:read-only {");
+    });
+    it(".visited() adds &:visited block", () => {
+        expect(String(createCSSBuilder({}).visited({ color: "purple" }))).toContain("&:visited {");
+    });
+    it(".target() adds &:target block", () => {
+        expect(String(createCSSBuilder({}).target({ outline: "2px solid blue" }))).toContain("&:target {");
+    });
+    it(".empty() adds &:empty block", () => {
+        expect(String(createCSSBuilder({}).empty({ display: "none" }))).toContain("&:empty {");
+    });
+});
+describe("CSSBuilder — relational pseudo-classes", () => {
+    it(".has() adds &:has(selector) block", () => {
+        expect(String(createCSSBuilder({}).has(".active", { fontWeight: "bold" }))).toContain("&:has(.active) {");
+    });
+    it(".is() adds &:is(selector) block", () => {
+        expect(String(createCSSBuilder({}).is("h1, h2", { lineHeight: 1.2 }))).toContain("&:is(h1, h2) {");
+    });
+    it(".where() adds &:where(selector) block", () => {
+        expect(String(createCSSBuilder({}).where("a, button", { cursor: "pointer" }))).toContain("&:where(a, button) {");
+    });
+});
+describe("CSSBuilder — @supports", () => {
+    it(".supports() adds @supports (condition) block", () => {
+        const out = String(createCSSBuilder({ display: "flex" }).supports("display: grid", { display: "grid" }));
+        expect(out).toContain("@supports (display: grid) {");
+        expect(out).toContain("  display: grid;");
+    });
+});
+describe("isCSSBuilder()", () => {
+    it("returns true for a CSSBuilder instance", () => {
+        expect(isCSSBuilder(createCSSBuilder({ display: "flex" }))).toBe(true);
+    });
+    it("returns false for plain strings", () => {
+        expect(isCSSBuilder("display: flex;")).toBe(false);
+    });
+    it("returns false for null and undefined", () => {
+        expect(isCSSBuilder(null)).toBe(false);
+        expect(isCSSBuilder(undefined)).toBe(false);
+    });
+    it("returns false for plain objects", () => {
+        expect(isCSSBuilder({ display: "flex" })).toBe(false);
+    });
+});
+//# sourceMappingURL=css-builder.test.js.map

package/dist/__tests__/css-builder.test.js.map

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

package/dist/__tests__/cx.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cx.test.d.ts.map

package/dist/__tests__/cx.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cx.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/cx.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/cx.test.js

@@ -0,0 +1,47 @@
+import { describe, expect, it } from "vitest";
+import { cx } from "../cx";
+describe("cx()", () => {
+    it("returns empty string with no args", () => {
+        expect(cx()).toBe("");
+    });
+    it("handles plain strings", () => {
+        expect(cx("a", "b", "c")).toBe("a b c");
+    });
+    it("filters falsy values", () => {
+        expect(cx(null, undefined, false, "valid")).toBe("valid");
+    });
+    it("includes 0 as a string", () => {
+        expect(cx(0)).toBe("0");
+    });
+    it("includes numeric class names", () => {
+        expect(cx(1, 2)).toBe("1 2");
+    });
+    it("handles objects — includes truthy keys", () => {
+        expect(cx({ active: true, disabled: false, loading: true })).toBe("active loading");
+    });
+    it("handles objects with zero values as falsy", () => {
+        expect(cx({ a: 1, b: 0, c: "", d: null, e: "yes" })).toBe("a e");
+    });
+    it("handles arrays recursively", () => {
+        expect(cx("a", ["b", false, "c"])).toBe("a b c");
+    });
+    it("handles deeply nested arrays", () => {
+        expect(cx(["a", ["b", ["c"]]])).toBe("a b c");
+    });
+    it("combines strings, objects, and arrays", () => {
+        expect(cx("base", { active: true, disabled: false }, ["extra"])).toBe("base active extra");
+    });
+    it("returns empty string for all-falsy input", () => {
+        expect(cx(false, null, undefined, "")).toBe("");
+    });
+    it("skips empty result from all-falsy nested array", () => {
+        // inner = cx(false, null) = "" → falsy → not pushed
+        expect(cx("a", [false, null, undefined])).toBe("a");
+        expect(cx([false, null])).toBe("");
+    });
+    it("ignores boolean true — not a string, number, array, or object", () => {
+        // boolean true passes the !arg guard but hits the else-if(object) false branch
+        expect(cx(true, "valid")).toBe("valid");
+    });
+});
+//# sourceMappingURL=cx.test.js.map

package/dist/__tests__/cx.test.js.map

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

package/dist/__tests__/decorators.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=decorators.test.d.ts.map

package/dist/__tests__/decorators.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/decorators.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/decorators.test.js

@@ -0,0 +1,268 @@
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+// @vitest-environment jsdom
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { Themed, Theme } from "../tokens/decorators";
+import { theme, ThemeInstance, createThemeInstance } from "../tokens/theme-instance";
+import { TokenSheet } from "../tokens/token-sheet";
+// ─── Fixtures ─────────────────────────────────────────────────────────────────
+class AppTokens extends TokenSheet {
+}
+class LightTheme extends AppTokens {
+    constructor() {
+        super(...arguments);
+        this.colorPrimary = "#3b82f6";
+        this.colorBg = "#ffffff";
+    }
+}
+class DarkTheme extends LightTheme {
+    constructor() {
+        super(...arguments);
+        this.colorPrimary = "#60a5fa";
+        this.colorBg = "#0f172a";
+    }
+}
+function styleEl() {
+    return document.querySelector("style[data-praxis-theme]");
+}
+beforeEach(() => { styleEl()?.remove(); });
+afterEach(() => { styleEl()?.remove(); });
+// ─── @Themed ──────────────────────────────────────────────────────────────────
+describe("@Themed — class decorator", () => {
+    it("initialize() creates a ThemeInstance singleton at class-decoration time", () => {
+        let App = (() => {
+            let _classDecorators = [Themed(AppTokens, LightTheme)];
+            let _classDescriptor;
+            let _classExtraInitializers = [];
+            let _classThis;
+            var App = class {
+                static { _classThis = this; }
+                static {
+                    const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+                    __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+                    App = _classThis = _classDescriptor.value;
+                    if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+                    __runInitializers(_classThis, _classExtraInitializers);
+                }
+            };
+            return App = _classThis;
+        })();
+        void App;
+        expect(theme()).toBeInstanceOf(ThemeInstance);
+        expect(styleEl()).not.toBeNull();
+    });
+    it("injected :root vars match the default theme", () => {
+        let App = (() => {
+            let _classDecorators = [Themed(AppTokens, LightTheme)];
+            let _classDescriptor;
+            let _classExtraInitializers = [];
+            let _classThis;
+            var App = class {
+                static { _classThis = this; }
+                static {
+                    const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+                    __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+                    App = _classThis = _classDescriptor.value;
+                    if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+                    __runInitializers(_classThis, _classExtraInitializers);
+                }
+            };
+            return App = _classThis;
+        })();
+        void App;
+        const css = styleEl()?.textContent ?? "";
+        expect(css).toContain("--color-primary: #3b82f6");
+        expect(css).toContain("--color-bg: #ffffff");
+    });
+    it("create() re-creates the singleton when the class is instantiated", () => {
+        let App = (() => {
+            let _classDecorators = [Themed(AppTokens, DarkTheme)];
+            let _classDescriptor;
+            let _classExtraInitializers = [];
+            let _classThis;
+            var App = class {
+                static { _classThis = this; }
+                static {
+                    const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+                    __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+                    App = _classThis = _classDescriptor.value;
+                    if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+                    __runInitializers(_classThis, _classExtraInitializers);
+                }
+                // minimal render so createClassDecorator doesn't strip it
+                render() { return null; }
+            };
+            return App = _classThis;
+        })();
+        const t = theme();
+        expect(t.current).toBeInstanceOf(DarkTheme);
+        // Instantiating the class triggers create() which calls createThemeInstance again
+        new App();
+        expect(theme()).toBeInstanceOf(ThemeInstance);
+    });
+    it("passes persist config to ThemeInstance", () => {
+        let App = (() => {
+            let _classDecorators = [Themed(AppTokens, LightTheme, { persist: true })];
+            let _classDescriptor;
+            let _classExtraInitializers = [];
+            let _classThis;
+            var App = class {
+                static { _classThis = this; }
+                static {
+                    const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+                    __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+                    App = _classThis = _classDescriptor.value;
+                    if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+                    __runInitializers(_classThis, _classExtraInitializers);
+                }
+            };
+            return App = _classThis;
+        })();
+        void App;
+        theme().switch(DarkTheme);
+        expect(localStorage.getItem("praxis-theme")).not.toBeNull();
+        localStorage.clear();
+    });
+    it("second @Themed decoration overwrites the singleton", () => {
+        let App = (() => {
+            let _classDecorators = [Themed(AppTokens, LightTheme)];
+            let _classDescriptor;
+            let _classExtraInitializers = [];
+            let _classThis;
+            var App = class {
+                static { _classThis = this; }
+                static {
+                    const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+                    __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+                    App = _classThis = _classDescriptor.value;
+                    if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+                    __runInitializers(_classThis, _classExtraInitializers);
+                }
+            };
+            return App = _classThis;
+        })();
+        void App;
+        let App2 = (() => {
+            let _classDecorators = [Themed(AppTokens, DarkTheme)];
+            let _classDescriptor;
+            let _classExtraInitializers = [];
+            let _classThis;
+            var App2 = class {
+                static { _classThis = this; }
+                static {
+                    const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+                    __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+                    App2 = _classThis = _classDescriptor.value;
+                    if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+                    __runInitializers(_classThis, _classExtraInitializers);
+                }
+            };
+            return App2 = _classThis;
+        })();
+        void App2;
+        expect(theme().current.colorPrimary).toBe("#60a5fa");
+    });
+});
+// ─── @Theme ───────────────────────────────────────────────────────────────────
+describe("@Theme — field decorator", () => {
+    it("returns the singleton ThemeInstance via getter", () => {
+        createThemeInstance(LightTheme);
+        let Comp = (() => {
+            let _theme_decorators;
+            let _theme_initializers = [];
+            let _theme_extraInitializers = [];
+            return class Comp {
+                static {
+                    const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+                    _theme_decorators = [Theme()];
+                    __esDecorate(null, null, _theme_decorators, { kind: "field", name: "theme", static: false, private: false, access: { has: obj => "theme" in obj, get: obj => obj.theme, set: (obj, value) => { obj.theme = value; } }, metadata: _metadata }, _theme_initializers, _theme_extraInitializers);
+                    if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+                }
+                constructor() {
+                    this.theme = __runInitializers(this, _theme_initializers, void 0);
+                    __runInitializers(this, _theme_extraInitializers);
+                }
+            };
+        })();
+        expect(new Comp().theme).toBe(theme());
+    });
+    it("same reference on every access", () => {
+        createThemeInstance(LightTheme);
+        let Comp = (() => {
+            let _theme_decorators;
+            let _theme_initializers = [];
+            let _theme_extraInitializers = [];
+            return class Comp {
+                static {
+                    const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+                    _theme_decorators = [Theme()];
+                    __esDecorate(null, null, _theme_decorators, { kind: "field", name: "theme", static: false, private: false, access: { has: obj => "theme" in obj, get: obj => obj.theme, set: (obj, value) => { obj.theme = value; } }, metadata: _metadata }, _theme_initializers, _theme_extraInitializers);
+                    if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+                }
+                constructor() {
+                    this.theme = __runInitializers(this, _theme_initializers, void 0);
+                    __runInitializers(this, _theme_extraInitializers);
+                }
+            };
+        })();
+        const c = new Comp();
+        expect(c.theme).toBe(c.theme);
+    });
+    it("setter is a no-op — value stays unchanged", () => {
+        createThemeInstance(LightTheme);
+        let Comp = (() => {
+            let _theme_decorators;
+            let _theme_initializers = [];
+            let _theme_extraInitializers = [];
+            return class Comp {
+                static {
+                    const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+                    _theme_decorators = [Theme()];
+                    __esDecorate(null, null, _theme_decorators, { kind: "field", name: "theme", static: false, private: false, access: { has: obj => "theme" in obj, get: obj => obj.theme, set: (obj, value) => { obj.theme = value; } }, metadata: _metadata }, _theme_initializers, _theme_extraInitializers);
+                    if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+                }
+                constructor() {
+                    this.theme = __runInitializers(this, _theme_initializers, void 0);
+                    __runInitializers(this, _theme_extraInitializers);
+                }
+            };
+        })();
+        const c = new Comp();
+        const before = c.theme;
+        c.theme = "anything";
+        expect(c.theme).toBe(before);
+    });
+});
+//# sourceMappingURL=decorators.test.js.map

package/dist/__tests__/decorators.test.js.map

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

package/dist/__tests__/extract.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=extract.test.d.ts.map

package/dist/__tests__/extract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/extract.test.ts"],"names":[],"mappings":""}