@gottheflag/nova 0.1.0-beta.1 → 0.1.0-beta.3

package/README.md

@@ -13,16 +13,38 @@ pnpm add @gottheflag/nova
 ```js
 import { Controller } from "@gottheflag/nova";
 import { Button } from "@gottheflag/nova/adapters";
+import { LocalStorage } from "@gottheflag/nova/storage";
 
 const ctl = new Controller(document, {
 	// all configs are optional
-	storage: { key: "theme" },
+	storage: new LocalStorage({
+		key: "theme",
+	}),
 	attribute: "data-theme",
 	initial: "dark",
 	dark: "dark",
 	light: "light",
 	system: "system",
+	observe: true,
 });
 
-ctl.use(Button); // use adapters
-```
+// use adapters
+ctl.use(Button, {
+	prefix: "theme:",
+	animate: {
+		enabled: true,
+		duration: 1000,
+		easing: "ease-in-out",
+	},
+});
+
+// listen for changes
+ctl.on("change", ({ theme }) => {
+	console.log("theme changed", theme);
+});
+
+// listen for applied theme
+ctl.on("apply", ({ theme }) => {
+	console.log("theme applied", theme);
+});
+```

package/dist/adapters/index.d.ts

@@ -1,23 +1,41 @@
-import { Adapter, Name } from '../core/index.js';
+import { AdapterDefinition } from '../core/index.js';
 
+/**
+ * Copyright (c) 2026 GTF
+ * SPDX-License-Identifier: Apache-2.0
+ */
+type Easing = "linear" | "ease" | "ease-in" | "ease-out" | "ease-in-out";
+interface ButtonOptions {
+    prefix?: string;
+    animate?: {
+        enabled?: boolean;
+        duration?: number;
+        easing?: Easing;
+    };
+}
 /**
  * @example
- * <button value="<prefix>light">Light</button>
- * <button value="<prefix>dark">Dark</button>
+ * <button value="theme:light">Light</button>
+ * <button value="theme:dark">Dark</button>
  */
-declare const Button: Adapter & {
-    registry: Map<Element, Name[]>;
-};
+declare const Button: AdapterDefinition<HTMLButtonElement, ButtonOptions>;
 
-interface Options$1 {
+interface RadioOptions {
     prefix?: string;
 }
-declare const Radio: Adapter<Options$1> & {
-    registry: Map<Element, Name[]>;
-    prefix?: string;
-};
+/**
+ * @example
+ * <input type="radio" name="theme" value="theme:light">
+ * <input type="radio" name="theme" value="theme:dark">
+ * <input type="radio" name="theme" value="theme:system">
+ */
+declare const Radio: AdapterDefinition<HTMLInputElement, RadioOptions>;
 
-interface Options {
+/**
+ * Copyright (c) 2026 GTF
+ * SPDX-License-Identifier: Apache-2.0
+ */
+interface SelectOptions {
     prefix?: string;
 }
 /**
@@ -30,9 +48,6 @@ interface Options {
  * </select>
  * ```
  */
-declare const Select: Adapter<Options> & {
-    registry: Map<Element, Name[]>;
-    prefix?: string;
-};
+declare const Select: AdapterDefinition<HTMLSelectElement, SelectOptions>;
 
 export { Button, Radio, Select };

package/dist/adapters/index.js

@@ -1,128 +1,91 @@
-import { __name } from '../chunk-7QVYU63E.js';
+import { __name, DEFAULT_PREFIX, parseValue } from '../chunk-NYMA6GFH.js';
 
-// src/adapters/button.ts
-var PREFIX = "theme:";
-function parseThemeName(btn) {
-  const value = btn.value;
-  const name = value.slice(PREFIX.length);
-  return name ? name : value;
+// src/core/adapter.ts
+function defineAdapter(definition) {
+  return definition;
 }
-__name(parseThemeName, "parseThemeName");
-var Button = {
+__name(defineAdapter, "defineAdapter");
+
+// src/adapters/button.ts
+var Button = defineAdapter({
   name: "button",
-  registry: /* @__PURE__ */ new Map(),
-  discover(ctl) {
-    const root = ctl.root;
-    root.querySelectorAll(`button[value^="${PREFIX}"]`).forEach((btn) => {
-      const detected = [];
-      const theme = parseThemeName(btn);
-      if (theme) detected.push(theme);
-      this.registry.set(btn, detected);
-    });
+  defaults: {
+    prefix: DEFAULT_PREFIX,
+    animate: {
+      enabled: false,
+      duration: 600,
+      easing: "ease-in-out"
+    }
   },
-  bind(ctl) {
-    const root = ctl.root;
-    root.querySelectorAll(`button[value^="${PREFIX}"]`).forEach((btn) => {
-      const theme = parseThemeName(btn);
-      btn.addEventListener("click", () => {
-        if (this.registry.get(btn)?.includes(theme)) {
-          ctl.set(theme);
-        }
+  selector: /* @__PURE__ */ __name((o) => `button[value^="${o.prefix ?? DEFAULT_PREFIX}"]`, "selector"),
+  bind(ctl, el, { prefix = DEFAULT_PREFIX, animate }) {
+    el.addEventListener("click", async (event) => {
+      const theme = parseValue(el.value, prefix);
+      if (theme === ctl.state) return;
+      if (!animate?.enabled || !document.startViewTransition) {
+        ctl.set(theme);
+        return;
+      }
+      const { clientX: x, clientY: y } = event;
+      const radius = Math.hypot(Math.max(x, innerWidth - x), Math.max(y, innerHeight - y));
+      const transition = document.startViewTransition(() => ctl.set(theme));
+      await transition.ready;
+      document.documentElement.animate({
+        clipPath: [
+          `circle(0px at ${x}px ${y}px)`,
+          `circle(${radius}px at ${x}px ${y}px)`
+        ]
+      }, {
+        duration: animate.duration ?? 500,
+        easing: animate.easing ?? "ease-in-out",
+        pseudoElement: "::view-transition-new(root)"
       });
     });
   }
-};
+});
 
 // src/adapters/radio.ts
-var PREFIX2 = "theme:";
-function parseThemeName2(btn, prefix) {
-  const value = btn.value;
-  const name = value.slice(prefix.length);
-  return name ? name : value;
-}
-__name(parseThemeName2, "parseThemeName");
-var Radio = {
+var Radio = defineAdapter({
   name: "radio",
-  registry: /* @__PURE__ */ new Map(),
-  setup(_ctl, options) {
-    this.prefix = options?.prefix ?? PREFIX2;
+  defaults: {
+    prefix: DEFAULT_PREFIX
   },
-  discover(ctl) {
-    const root = ctl.root;
-    root.querySelectorAll(`input[type="radio"][value^="${PREFIX2}"]`).forEach((radio) => {
-      const detected = [];
-      const theme = parseThemeName2(radio, this.prefix);
-      if (theme) detected.push(theme);
-      this.registry.set(radio, detected);
+  selector: /* @__PURE__ */ __name((o) => `input[type="radio"][value^="${o.prefix}"]`, "selector"),
+  bind(ctl, el, { prefix = DEFAULT_PREFIX }) {
+    el.addEventListener("change", () => {
+      if (!el.checked) return;
+      const theme = parseValue(el.value, prefix);
+      if (theme === ctl.state) return;
+      ctl.set(theme);
     });
   },
-  bind(ctl) {
-    const root = ctl.root;
-    root.querySelectorAll(`input[type="radio"][value^="${PREFIX2}"]`).forEach((radio) => {
-      radio.addEventListener("change", (e) => {
-        const target = e.currentTarget;
-        const theme = parseThemeName2(target, this.prefix);
-        if (theme) ctl.set(theme);
-      });
-    });
-  },
-  sync(ctl) {
-    const root = ctl.root;
-    const active = ctl.active();
-    root.querySelectorAll(`input[type="radio"][value^="${PREFIX2}"]`).forEach((radio) => {
-      const theme = parseThemeName2(radio, this.prefix);
-      radio.checked = theme === active;
-    });
+  sync(ctl, el, { prefix = DEFAULT_PREFIX }) {
+    el.checked = parseValue(el.value, prefix) === ctl.active();
   }
-};
+});
 
 // src/adapters/select.ts
-var PREFIX3 = "theme:";
-function parseThemeName3(btn, prefix) {
-  const value = btn.value;
-  const name = value.slice(prefix.length);
-  return name ? name : value;
-}
-__name(parseThemeName3, "parseThemeName");
-var Select = {
+var Select = defineAdapter({
   name: "select",
-  registry: /* @__PURE__ */ new Map(),
-  setup(_ctl, options) {
-    this.prefix = options?.prefix ?? PREFIX3;
-  },
-  discover(ctl) {
-    const root = ctl.root;
-    root.querySelectorAll(`select:has(option[value^="${this.prefix}"])`).forEach((sel) => {
-      const detected = [];
-      Array.from(sel.options).forEach((option) => {
-        const theme = parseThemeName3(option, this.prefix);
-        if (theme) detected.push(theme);
-      });
-      this.registry.set(sel, detected);
-    });
+  defaults: {
+    prefix: DEFAULT_PREFIX
   },
-  bind(ctl) {
-    const root = ctl.root;
-    root.querySelectorAll(`select:has(option[value^="${this.prefix}"])`).forEach((sel) => {
-      sel.addEventListener("change", (e) => {
-        const target = e.currentTarget;
-        const option = target.options[target.selectedIndex];
-        const theme = parseThemeName3(option, this.prefix);
-        if (theme) ctl.set(theme);
-      });
+  selector: /* @__PURE__ */ __name((o) => `select:has(option[value^="${o.prefix}"])`, "selector"),
+  bind(ctl, el, { prefix = DEFAULT_PREFIX }) {
+    el.addEventListener("change", () => {
+      const option = el.options[el.selectedIndex];
+      const theme = parseValue(option.value, prefix);
+      if (theme === ctl.state) return;
+      ctl.set(theme);
     });
   },
-  sync(ctl) {
-    const root = ctl.root;
+  sync(ctl, el, { prefix = DEFAULT_PREFIX }) {
     const active = ctl.active();
-    root.querySelectorAll(`select:has(option[value^="${this.prefix}"])`).forEach((sel) => {
-      Array.from(sel.options).forEach((option) => {
-        const theme = parseThemeName3(option, this.prefix);
-        option.selected = theme === active;
-      });
-    });
+    for (const option of el.options) {
+      option.selected = parseValue(option.value, prefix) === active;
+    }
   }
-};
+});
 
 export { Button, Radio, Select };
 //# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/adapters/button.ts","../../src/adapters/radio.ts","../../src/adapters/select.ts"],"names":["PREFIX","parseThemeName","btn","value","name","slice","length","Button","registry","Map","discover","ctl","root","querySelectorAll","forEach","detected","theme","push","set","bind","addEventListener","get","includes","prefix","Radio","setup","_ctl","options","radio","e","target","currentTarget","sync","active","checked","Select","sel","Array","from","option","selectedIndex","selected"],"mappings":"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","file":"index.js","sourcesContent":["import { Controller } from \"../core/controller.js\";\r\nimport type { Adapter } from \"../core/adapter.js\";\r\nimport { State, type Name } from \"../core/types.js\";\r\n\r\nconst PREFIX = \"theme:\";\r\n\r\nfunction parseThemeName(btn: HTMLButtonElement): State {\r\n    const value = btn.value;\r\n    const name = value.slice(PREFIX.length) as State;\r\n\r\n    return name ? name : value as State;\r\n}\r\n\r\n/**\r\n * @example\r\n * <button value=\"<prefix>light\">Light</button>\r\n * <button value=\"<prefix>dark\">Dark</button>\r\n */\r\nexport const Button: Adapter & {\r\n    registry: Map<Element, Name[]>;\r\n} = {\r\n    name: \"button\",\r\n\r\n    registry: new Map<Element, Name[]>(),\r\n\r\n    discover(ctl: Controller) {\r\n        const root = ctl.root;\r\n\r\n        root.querySelectorAll<HTMLButtonElement>(`button[value^=\"${PREFIX}\"]`).forEach(btn => {\r\n            const detected: Name[] = [];\r\n\r\n            const theme = parseThemeName(btn);\r\n            if (theme) detected.push(theme);\r\n\r\n            this.registry.set(btn, detected);\r\n        });\r\n    },\r\n\r\n    bind(ctl: Controller) {\r\n        const root = ctl.root;\r\n\r\n        root.querySelectorAll<HTMLButtonElement>(`button[value^=\"${PREFIX}\"]`).forEach(btn => {\r\n            const theme = parseThemeName(btn);\r\n\r\n            btn.addEventListener(\"click\", () => {\r\n                if (this.registry.get(btn)?.includes(theme)) {\r\n                    ctl.set(theme);\r\n                }\r\n            });\r\n        });\r\n    },\r\n};\r\n","import type { Adapter } from '../core/adapter.js';\r\nimport { Controller } from '../core/controller.js';\r\nimport { Name, State } from '../core/types.js';\r\n\r\nconst PREFIX = \"theme:\";\r\n\r\nfunction parseThemeName(btn: HTMLInputElement, prefix: string): State {\r\n    const value = btn.value;\r\n    const name = value.slice(prefix.length) as State;\r\n\r\n    return name ? name : value as State;\r\n}\r\n\r\ninterface Options {\r\n    prefix?: string;\r\n};\r\n\r\nexport const Radio: Adapter<Options> & {\r\n    registry: Map<Element, Name[]>;\r\n    prefix?: string;\r\n} = {\r\n    name: 'radio',\r\n\r\n    registry: new Map<Element, Name[]>(),\r\n\r\n    setup(_ctl: Controller, options) {\r\n        this.prefix = options?.prefix ?? PREFIX;\r\n    },\r\n\r\n    discover(ctl: Controller) {\r\n        const root = ctl.root;\r\n\r\n        root.querySelectorAll<HTMLInputElement>(`input[type=\"radio\"][value^=\"${PREFIX}\"]`).forEach(radio => {\r\n            const detected: Name[] = [];\r\n\r\n            const theme = parseThemeName(radio, this.prefix!);\r\n            if (theme) detected.push(theme);\r\n\r\n            this.registry.set(radio, detected);\r\n        });\r\n    },\r\n\r\n    bind(ctl: Controller) {\r\n        const root = ctl.root;\r\n\r\n        root.querySelectorAll<HTMLInputElement>(`input[type=\"radio\"][value^=\"${PREFIX}\"]`).forEach(radio => {            \r\n            radio.addEventListener('change', e => {\r\n                const target = e.currentTarget as HTMLInputElement;\r\n                const theme = parseThemeName(target, this.prefix!);\r\n                \r\n                if (theme) ctl.set(theme);\r\n            });\r\n        });\r\n    },\r\n\r\n    sync(ctl: Controller) {\r\n        const root = ctl.root;\r\n        const active = ctl.active();\r\n\r\n        root.querySelectorAll<HTMLInputElement>(`input[type=\"radio\"][value^=\"${PREFIX}\"]`).forEach(radio => {\r\n            const theme = parseThemeName(radio, this.prefix!);\r\n            radio.checked = theme === active;\r\n        });\r\n    }\r\n};\r\n","import type { Adapter } from \"../core/adapter.js\";\r\nimport { Controller } from \"../core/controller.js\";\r\nimport { State, type Name } from \"../core/types.js\";\r\n\r\nconst PREFIX = \"theme:\";\r\n\r\nfunction parseThemeName(btn: HTMLOptionElement, prefix: string): State {\r\n    const value = btn.value;\r\n    const name = value.slice(prefix.length) as State;\r\n\r\n    return name ? name : value as State;\r\n}\r\n\r\ninterface Options {\r\n    prefix?: string;\r\n};\r\n\r\n/**\r\n * @example\r\n * ```html\r\n * <select>\r\n *   <option value=\"theme:light\">Light</option>\r\n *   <option value=\"theme:system\">System</option>\r\n *   <option value=\"theme:dark\">Dark</option>\r\n * </select>\r\n * ```\r\n */\r\nexport const Select: Adapter<Options> & {\r\n    registry: Map<Element, Name[]>;\r\n    prefix?: string;\r\n} = {\r\n    name: \"select\",\r\n\r\n    registry: new Map<Element, Name[]>(),\r\n\r\n    setup(_ctl: Controller, options) {\r\n        this.prefix = options?.prefix ?? PREFIX;\r\n    },\r\n\r\n    discover(ctl: Controller) {\r\n        const root = ctl.root;\r\n\r\n        root.querySelectorAll<HTMLSelectElement>(`select:has(option[value^=\"${this.prefix}\"])`).forEach(sel => {\r\n            const detected: Name[] = [];\r\n\r\n            Array.from(sel.options).forEach(option => {\r\n                const theme = parseThemeName(option, this.prefix!);\r\n                if (theme) detected.push(theme);\r\n            });\r\n\r\n            this.registry.set(sel, detected);\r\n        });\r\n    },\r\n\r\n    bind(ctl: Controller) {\r\n        const root = ctl.root;\r\n\r\n        root.querySelectorAll<HTMLSelectElement>(`select:has(option[value^=\"${this.prefix}\"])`).forEach(sel => {\r\n            sel.addEventListener(\"change\", e => {\r\n                const target = e.currentTarget as HTMLSelectElement;\r\n                const option = target.options[ target.selectedIndex ];\r\n\r\n                const theme = parseThemeName(option as HTMLOptionElement, this.prefix!);\r\n                if (theme) ctl.set(theme);\r\n            });\r\n        });\r\n    },\r\n\r\n    sync(ctl: Controller) {\r\n        const root = ctl.root;\r\n        const active = ctl.active();\r\n\r\n        root.querySelectorAll<HTMLSelectElement>(`select:has(option[value^=\"${this.prefix}\"])`).forEach(sel => {\r\n            Array.from(sel.options).forEach(option => {\r\n                const theme = parseThemeName(option, this.prefix!);\r\n                option.selected = theme === active;\r\n            });\r\n        });\r\n    }\r\n};\r\n"]}
+{"version":3,"sources":["../../src/core/adapter.ts","../../src/adapters/button.ts","../../src/adapters/radio.ts","../../src/adapters/select.ts"],"names":["defineAdapter","definition","Button","name","defaults","prefix","DEFAULT_PREFIX","animate","enabled","duration","easing","selector","o","bind","ctl","el","addEventListener","event","theme","parseValue","value","state","document","startViewTransition","set","clientX","x","clientY","y","radius","Math","hypot","max","innerWidth","innerHeight","transition","ready","documentElement","clipPath","pseudoElement","Radio","checked","sync","active","Select","option","options","selectedIndex","selected"],"mappings":"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","file":"index.js","sourcesContent":["/**\r\n * Copyright (c) 2026 GTF\r\n * SPDX-License-Identifier: Apache-2.0\r\n */\r\n\r\nimport type { Controller } from \"./controller.js\";\r\n\r\nexport interface AdapterDefinition<\r\n\tE extends Element,\r\n\tO = void\r\n> {\r\n\tname: string;\r\n\r\n\t/** Default options — merged with options passed to `ctl.use()`. */\r\n\tdefaults?: Partial<O>;\r\n\r\n\t/** CSS selector string, or a function that returns one given resolved options. */\r\n\tselector: string | ((options: O) => string);\r\n\r\n\t/**\r\n\t * Attach event listeners to a single element.\r\n\t * Called once per element — at `use()` time, or when a new element is observed.\r\n\t */\r\n\tbind?(ctl: Controller, element: E, options: O): void;\r\n\r\n\t/**\r\n\t * Sync element UI state with the controller's current theme.\r\n\t * Called after every `ctl.set()` and on initial `use()`.\r\n\t */\r\n\tsync?(ctl: Controller, element: E, options: O): void;\r\n}\r\n\r\n/**\r\n * Type helper for defining adapters with full inference.\r\n * Zero runtime cost — returns the definition unchanged.\r\n * \r\n * @example\r\n * export const MyAdapter = defineAdapter<HTMLButtonElement, MyOptions>({\r\n *   name: \"my-adapter\",\r\n *   defaults: { prefix: \"theme:\" },\r\n *   selector: (o) => `button[value=\"${o.prefix}\"]`,\r\n *   bind(ctl, el, options) { ... },\r\n *   sync(ctl, el, options) { ... },\r\n * });\r\n */\r\nexport function defineAdapter<\r\n\tE extends Element,\r\n\tO = void\r\n>(\r\n\tdefinition: AdapterDefinition<E, O>\r\n): AdapterDefinition<E, O> {\r\n\treturn definition;\r\n}","/**\r\n * Copyright (c) 2026 GTF\r\n * SPDX-License-Identifier: Apache-2.0\r\n */\r\n\r\nimport { defineAdapter } from \"../core/adapter.js\";\r\nimport { State } from \"../core/types.js\";\r\nimport { DEFAULT_PREFIX, parseValue } from \"../core/utils.js\";\r\n\r\ntype Easing = \"linear\" | \"ease\" | \"ease-in\" | \"ease-out\" | \"ease-in-out\";\r\n\r\ninterface ButtonOptions {\r\n    prefix?: string;\r\n    animate?: {\r\n        enabled?: boolean;\r\n        duration?: number;\r\n        easing?: Easing;\r\n    }\r\n}\r\n\r\n/**\r\n * @example\r\n * <button value=\"theme:light\">Light</button>\r\n * <button value=\"theme:dark\">Dark</button>\r\n */\r\nexport const Button = defineAdapter<HTMLButtonElement, ButtonOptions>({\r\n    name: \"button\",\r\n\r\n    defaults: {\r\n        prefix: DEFAULT_PREFIX,\r\n        animate: {\r\n            enabled: false,\r\n            duration: 600,\r\n            easing: \"ease-in-out\"\r\n        }\r\n    },\r\n\r\n    selector: (o) => `button[value^=\"${o.prefix ?? DEFAULT_PREFIX}\"]`,\r\n\r\n    bind(ctl, el, { prefix = DEFAULT_PREFIX, animate }) {\r\n        el.addEventListener(\"click\", async (event) => {\r\n            const theme = parseValue(el.value, prefix) as State;\r\n\r\n            if (theme === ctl.state) return;\r\n\r\n            if (!animate?.enabled || !document.startViewTransition) {\r\n                ctl.set(theme);\r\n                return;\r\n            }\r\n\r\n            const { clientX: x, clientY: y } = event;\r\n\r\n            const radius = Math.hypot(\r\n                Math.max(x, innerWidth - x),\r\n                Math.max(y, innerHeight - y)\r\n            );\r\n\r\n            const transition = document.startViewTransition(() => ctl.set(theme));\r\n\r\n            await transition.ready;\r\n\r\n            document.documentElement.animate(\r\n                {\r\n                    clipPath: [\r\n                        `circle(0px at ${x}px ${y}px)`,\r\n                        `circle(${radius}px at ${x}px ${y}px)`\r\n                    ]\r\n                },\r\n                {\r\n                    duration: animate.duration ?? 500,\r\n                    easing: animate.easing ?? \"ease-in-out\",\r\n                    pseudoElement: \"::view-transition-new(root)\"\r\n                }\r\n            );\r\n        });\r\n    },\r\n});\r\n","// /**\r\n//  * Copyright (c) 2026 GTF\r\n//  * SPDX-License-Identifier: Apache-2.0\r\n//  */\r\n\r\nimport { defineAdapter } from \"../core/adapter.js\";\r\nimport { State } from \"../core/types.js\";\r\nimport { DEFAULT_PREFIX, parseValue } from \"../core/utils.js\";\r\n\r\ninterface RadioOptions {\r\n    prefix?: string;\r\n}\r\n\r\n/**\r\n * @example\r\n * <input type=\"radio\" name=\"theme\" value=\"theme:light\">\r\n * <input type=\"radio\" name=\"theme\" value=\"theme:dark\">\r\n * <input type=\"radio\" name=\"theme\" value=\"theme:system\">\r\n */\r\nexport const Radio = defineAdapter<HTMLInputElement, RadioOptions>({\r\n    name: \"radio\",\r\n\r\n    defaults: {\r\n        prefix: DEFAULT_PREFIX,\r\n    },\r\n\r\n    selector: (o) => `input[type=\"radio\"][value^=\"${o.prefix}\"]`,\r\n\r\n    bind(ctl, el, { prefix = DEFAULT_PREFIX }) {\r\n        el.addEventListener(\"change\", () => {\r\n            if (!el.checked) return;\r\n\r\n            const theme = parseValue(el.value, prefix) as State;\r\n\r\n            if (theme === ctl.state) return;\r\n\r\n            ctl.set(theme);\r\n        });\r\n    },\r\n\r\n    sync(ctl, el, { prefix = DEFAULT_PREFIX }) {\r\n        el.checked = parseValue(el.value, prefix) === ctl.active();\r\n    }\r\n});","/**\r\n * Copyright (c) 2026 GTF\r\n * SPDX-License-Identifier: Apache-2.0\r\n */\r\n\r\nimport { defineAdapter } from \"../core/adapter.js\";\r\nimport { State } from \"../core/types.js\";\r\nimport { DEFAULT_PREFIX, parseValue } from \"../core/utils.js\";\r\n\r\ninterface SelectOptions {\r\n    prefix?: string;\r\n}\r\n\r\n/**\r\n * @example\r\n * ```html\r\n * <select>\r\n *   <option value=\"theme:light\">Light</option>\r\n *   <option value=\"theme:system\">System</option>\r\n *   <option value=\"theme:dark\">Dark</option>\r\n * </select>\r\n * ```\r\n */\r\nexport const Select = defineAdapter<HTMLSelectElement, SelectOptions>({\r\n    name: \"select\",\r\n\r\n    defaults: {\r\n        prefix: DEFAULT_PREFIX,\r\n    },\r\n    \r\n    selector: (o) => `select:has(option[value^=\"${o.prefix}\"])`,\r\n\r\n    bind(ctl, el, { prefix = DEFAULT_PREFIX }) {\r\n        el.addEventListener(\"change\", () => {\r\n            const option = el.options[ el.selectedIndex ];\r\n            const theme = parseValue(option.value, prefix) as State;\r\n\r\n            if (theme === ctl.state) return;\r\n\r\n            ctl.set(theme);\r\n        });\r\n    },\r\n\r\n    sync(ctl, el, { prefix = DEFAULT_PREFIX }) {\r\n        const active = ctl.active();\r\n\r\n        for (const option of el.options) {\r\n            option.selected = parseValue(option.value, prefix) === active;\r\n        }\r\n    }\r\n});"]}

package/dist/chunk-NYMA6GFH.js

@@ -0,0 +1,34 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/core/utils.ts
+var DEFAULT_PREFIX = "theme:";
+function resolveStateOf(state, system, config) {
+  if (state === config.system) {
+    return system.prefers;
+  }
+  if (state === config.light || state === config.dark) {
+    return state;
+  }
+  return typeof state === "string" ? state : null;
+}
+__name(resolveStateOf, "resolveStateOf");
+function resolveRoot(root) {
+  if (root instanceof HTMLElement) {
+    return root;
+  } else if (root instanceof Document) {
+    return root.documentElement;
+  } else if (root instanceof ShadowRoot && root.host instanceof HTMLElement) {
+    return root.host;
+  }
+  return document.documentElement;
+}
+__name(resolveRoot, "resolveRoot");
+function parseValue(value, prefix) {
+  return value.startsWith(prefix) ? value.slice(prefix.length) : value;
+}
+__name(parseValue, "parseValue");
+
+export { DEFAULT_PREFIX, __name, parseValue, resolveRoot, resolveStateOf };
+//# sourceMappingURL=chunk-NYMA6GFH.js.map
+//# sourceMappingURL=chunk-NYMA6GFH.js.map

package/dist/chunk-NYMA6GFH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/utils.ts"],"names":["DEFAULT_PREFIX","resolveStateOf","state","system","config","prefers","light","dark","resolveRoot","root","HTMLElement","Document","documentElement","ShadowRoot","host","document","parseValue","value","prefix","startsWith","slice","length"],"mappings":";;;;AASO,IAAMA,cAAAA,GAAiB;AAYvB,SAASC,cAAAA,CAAeC,KAAAA,EAAcC,MAAAA,EAAgBC,MAAAA,EAAsB;AAClF,EAAA,IAAIF,KAAAA,KAAUE,OAAOD,MAAAA,EAAQ;AAC5B,IAAA,OAAOA,MAAAA,CAAOE,OAAAA;AACf,EAAA;AAEA,EAAA,IAAIH,KAAAA,KAAUE,MAAAA,CAAOE,KAAAA,IAASJ,KAAAA,KAAUE,OAAOG,IAAAA,EAAM;AACpD,IAAA,OAAOL,KAAAA;AACR,EAAA;AAEA,EAAA,OAAO,OAAOA,KAAAA,KAAU,QAAA,GAAWA,KAAAA,GAAQ,IAAA;AAC5C;AAVgBD,MAAAA,CAAAA,cAAAA,EAAAA,gBAAAA,CAAAA;AAuBT,SAASO,YAAYC,IAAAA,EAAa;AACxC,EAAA,IAAIA,gBAAgBC,WAAAA,EAAa;AAChC,IAAA,OAAOD,IAAAA;AACR,EAAA,CAAA,MAAA,IAAWA,gBAAgBE,QAAAA,EAAU;AACpC,IAAA,OAAOF,IAAAA,CAAKG,eAAAA;AACb,EAAA,CAAA,MAAA,IAAWH,IAAAA,YAAgBI,UAAAA,IAAcJ,IAAAA,CAAKK,IAAAA,YAAgBJ,WAAAA,EAAa;AAC1E,IAAA,OAAOD,IAAAA,CAAKK,IAAAA;AACb,EAAA;AAEA,EAAA,OAAOC,QAAAA,CAASH,eAAAA;AACjB;AAVgBJ,MAAAA,CAAAA,WAAAA,EAAAA,aAAAA,CAAAA;AAuBT,SAASQ,UAAAA,CAAWC,OAAeC,MAAAA,EAAc;AACvD,EAAA,OAAOD,KAAAA,CAAME,WAAWD,MAAAA,CAAAA,GACrBD,MAAMG,KAAAA,CAAMF,MAAAA,CAAOG,MAAM,CAAA,GACzBJ,KAAAA;AACJ;AAJgBD,MAAAA,CAAAA,UAAAA,EAAAA,YAAAA,CAAAA","file":"chunk-NYMA6GFH.js","sourcesContent":["/**\r\n * Copyright (c) 2026 GTF\r\n * SPDX-License-Identifier: Apache-2.0\r\n */\r\n\r\nimport { ResolvedConfig } from \"./config.js\";\r\nimport { System } from \"./system.js\";\r\nimport { State, type Name } from \"./types.js\";\r\n\r\nexport const DEFAULT_PREFIX = \"theme:\";\r\n\r\n/**\r\n * Resolve a theme state to an effective theme name.\r\n * \r\n * @see {@link State}\r\n * \r\n * @param theme Theme state\r\n * @param system System instance.\r\n * @param config Resolved set of configuration.\r\n * @returns \r\n */\r\nexport function resolveStateOf(state: State, system: System, config: ResolvedConfig): Name | null {\r\n\tif (state === config.system) {\r\n\t\treturn system.prefers;\r\n\t}\r\n\r\n\tif (state === config.light || state === config.dark) {\r\n\t\treturn state;\r\n\t}\r\n\r\n\treturn typeof state === \"string\" ? state : null;\r\n}\r\n\r\n/**\r\n * Resolve a root element from a given value.\r\n * \r\n * @description\r\n * This function takes a root value and returns the corresponding\r\n * HTMLElement. If the value is already an HTMLElement, it is returned\r\n * directly. If the value is a Document, it returns the documentElement.\r\n * If the value is a ShadowRoot, it returns the host element.\r\n * \r\n * @param root Root value\r\n */\r\nexport function resolveRoot(root: unknown): HTMLElement {\r\n\tif (root instanceof HTMLElement) {\r\n\t\treturn root\r\n\t} else if (root instanceof Document) {\r\n\t\treturn root.documentElement\r\n\t} else if (root instanceof ShadowRoot && root.host instanceof HTMLElement) {\r\n\t\treturn root.host\r\n\t};\r\n\r\n\treturn document.documentElement;\r\n}\r\n\r\n/**\r\n * Parse a value with a prefix.\r\n * \r\n * @description\r\n * This function takes a value and a prefix. If the value starts with\r\n * the prefix, it is sliced from the beginning. Otherwise, the value is\r\n * returned as-is.\r\n * \r\n * @param value Value to parse\r\n * @param prefix Prefix to check\r\n */\r\nexport function parseValue(value: string, prefix: string): string {\r\n\treturn value.startsWith(prefix)\r\n\t\t? value.slice(prefix.length)\r\n\t\t: value;\r\n}"]}

package/dist/core/index.d.ts

@@ -1,3 +1,44 @@
+/**
+ * Copyright (c) 2026 GTF
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+interface AdapterDefinition<E extends Element, O = void> {
+    name: string;
+    /** Default options — merged with options passed to `ctl.use()`. */
+    defaults?: Partial<O>;
+    /** CSS selector string, or a function that returns one given resolved options. */
+    selector: string | ((options: O) => string);
+    /**
+     * Attach event listeners to a single element.
+     * Called once per element — at `use()` time, or when a new element is observed.
+     */
+    bind?(ctl: Controller, element: E, options: O): void;
+    /**
+     * Sync element UI state with the controller's current theme.
+     * Called after every `ctl.set()` and on initial `use()`.
+     */
+    sync?(ctl: Controller, element: E, options: O): void;
+}
+/**
+ * Type helper for defining adapters with full inference.
+ * Zero runtime cost — returns the definition unchanged.
+ *
+ * @example
+ * export const MyAdapter = defineAdapter<HTMLButtonElement, MyOptions>({
+ *   name: "my-adapter",
+ *   defaults: { prefix: "theme:" },
+ *   selector: (o) => `button[value="${o.prefix}"]`,
+ *   bind(ctl, el, options) { ... },
+ *   sync(ctl, el, options) { ... },
+ * });
+ */
+declare function defineAdapter<E extends Element, O = void>(definition: AdapterDefinition<E, O>): AdapterDefinition<E, O>;
+
+/**
+ * Copyright (c) 2026 GTF
+ * SPDX-License-Identifier: Apache-2.0
+ */
 /**
  * Effective theme name (e.g. `day`, `night`, `mint`).
  */
@@ -9,38 +50,144 @@ type Name = string;
  * - Effective themes are the resolved values (e.g. `<dark>`, `<light>`, `mint`).
  */
 type State = "system" | "light" | "dark";
+/**
+ * Emitted when the theme state changes.
+ */
+interface ChangeEvent {
+    from: State | null;
+    to: State;
+    theme: Name;
+}
+interface ApplyEvent {
+    theme: Name;
+}
+type NEvents = {
+    change: ChangeEvent;
+    apply: ApplyEvent;
+};
+
+/**
+ * Copyright (c) 2026 GTF
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * A storage interface for persisting the theme state.
+ *
+ * @description
+ * The theme state is persisted in a storage mechanism that is
+ * specific to the application. For example, a web application might
+ * use cookies, local storage, or a database.
+ */
+interface StateStorage {
+    get(): State | null;
+    set(state: State): void;
+    remove(): void;
+}
+
+/**
+ * Copyright (c) 2026 GTF
+ * SPDX-License-Identifier: Apache-2.0
+ */
 
 /**
  * Raw configuration, passed by the user.
  */
 interface RawConfig {
+    /**
+     * Theme attribute name.
+     *
+     * @default "data-theme"
+     * @example
+     * <html data-theme="light">
+     */
     attribute?: string;
-    storage?: {
-        key: string;
-    };
+    /**
+     * Theme storage type.
+     *
+     * @description
+     * The controller will use the storage to persist the theme state.
+     *
+     * @default @see {@link LocalStorage}
+     */
+    storage?: StateStorage;
+    /**
+     * System theme name.
+     *
+     * @default "system"
+     * @example "auto" | "sync" | ...
+     */
     system?: string;
+    /**
+     * Light theme name.
+     *
+     * @default "light"
+     * @example "bright" | ...
+     */
     light?: Name;
+    /**
+     * Dark theme name.
+     *
+     * @default "dark"
+     * @example "dim" | ...
+     */
     dark?: Name;
+    /**
+     * Initial theme name.
+     *
+     * @default "dark"
+     * @example "light" | "mint" | ...
+     */
     initial?: Name;
+    /**
+     * Observe the DOM elements for changes.
+     * Automatically bind new matching elements.
+     *
+     * @default false
+     */
+    observe?: boolean;
 }
 /**
  * Resolved configuration by the controller.
  */
 interface ResolvedConfig {
     attribute: string;
-    storage: {
-        key: string;
-    };
+    storage: StateStorage;
     system: string;
     light: Name;
     dark: Name;
     initial?: Name;
+    observe: boolean;
 }
 
+/**
+ * Copyright (c) 2026 GTF
+ * SPDX-License-Identifier: Apache-2.0
+ */
+type Listener<T> = (event: T) => void;
+/**
+ * A simple event emitter implementation.
+ *
+ * @description
+ * This class is suitable for use in a web application that wants to
+ * listen for changes in the theme state.
+ */
+declare class EventEmitter<M extends Record<string, unknown>> {
+    private _map;
+    on<K extends keyof M>(event: K, listener: Listener<M[K]>): () => void;
+    off<K extends keyof M>(event: K, listener: Listener<M[K]>): void;
+    emit<K extends keyof M>(event: K, payload: M[K]): void;
+}
+
+/**
+ * Copyright (c) 2026 GTF
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
 /**
  * Theme controller logic.
  */
-declare class Controller {
+declare class Controller extends EventEmitter<NEvents> {
     private _root;
     /**
      * Resolved configuration.
@@ -50,7 +197,8 @@ declare class Controller {
      * System theme proxy.
      */
     private system;
-    private adapters;
+    private _adapters;
+    private _observer?;
     constructor(_root?: Document | ParentNode, cfg?: RawConfig);
     /**
      * The root element to apply theme to.
@@ -89,18 +237,29 @@ declare class Controller {
      * @param adapter Adapter instance
      * @param options Adapter options
      */
-    use<T extends Adapter<any>>(adapter: T, options?: T extends Adapter<infer O> ? O : never): this;
+    use<O>(def: AdapterDefinition<any, O>, options?: Partial<O>): this;
     /**
      * Set the effective theme from a theme state.
      *
      * @see {@link State}
      * @param state Theme State
      */
-    set(state: State): void;
+    set(state: State): this;
     /**
      * Read the stored theme state from local storage.
      */
     get state(): State | null;
+    /**
+     * Destroy the controller.
+     *
+     * @description
+     * This method disconnects the observer, stops the system listener.
+     */
+    destroy(): void;
+    /**
+     * Sync all adapters.
+     */
+    private syncAdapters;
     /**
      * Sync the system listener.
      */
@@ -117,58 +276,25 @@ declare class Controller {
      * @param theme Theme state
      */
     private write;
-}
-
-interface Adapter<Options = undefined> {
-    name: string;
     /**
-     * Setup the adapter.
-     * Used to initiate any one-time setup.
-     *
-     * ---
-     * @remarks
-     * Called once, when the controller is instantiated.
+     * Start the DOM elements observer.
      *
-     * ---
-     * @param ctl Controller instance
-     * @param options Adapter options
-     */
-    setup?(ctl: Controller, options: Options): void;
-    /**
-     * Discover themes that are available to this adapter. \
-     * Used to validate, or for example do a one-time setup.
-     *
-     * ---
-     * @remarks
-     * Called once, when the controller is instantiated.
-     *
-     * ---
-     * @param ctl the controller instance
-     * @returns a list of themes that are available to this adapter
-     */
-    discover?(ctl: Controller): void;
-    /**
-     * Define the theme selection mechanism.
-     *
-     * ---
-     * @remarks
-     * Called every time the controller is instantiated.
-     *
-     * ---
-     * @param ctl the controller instance
+     * @description
+     * This method starts a MutationObserver that watches for changes to
+     * the DOM elements that are registered as adapters. When a change
+     * is detected, the controller will bind the element to the adapter.
      */
-    bind?(ctl: Controller): void;
+    private startObserver;
     /**
-     * Sync theme adapter state with the controller.
+     * Bind a single DOM element to an adapter.
      *
-     * ---
-     * @remarks
-     * Called every time the controller is instantiated.
-     *
-     * ---
-     * @param ctl the controller instance
+     * @description
+     * This method checks if the element matches the adapter's selector.
+     * If it does, the adapter's `bind` method is called with the element
+     * and the adapter's options. If the adapter has a `sync` method, it
+     * is also called with the element and the adapter's options.
      */
-    sync?(ctl: Controller): void;
+    private bindNode;
 }
 
-export { type Adapter, Controller, type Name, type State };
+export { type AdapterDefinition, Controller, EventEmitter, type Name, type ResolvedConfig, type State, defineAdapter };

package/dist/core/index.js

@@ -1,4 +1,55 @@
-import { __name } from '../chunk-7QVYU63E.js';
+import { __name, resolveRoot, resolveStateOf } from '../chunk-NYMA6GFH.js';
+
+// src/storage/local.ts
+var LocalStorage = class {
+  static {
+    __name(this, "LocalStorage");
+  }
+  key;
+  constructor(options = {}) {
+    this.key = options.key ?? "theme";
+  }
+  get() {
+    try {
+      return localStorage.getItem(this.key);
+    } catch {
+      return null;
+    }
+  }
+  set(state) {
+    try {
+      localStorage.setItem(this.key, state);
+    } catch {
+      console.warn("[LOCAL] Failed to write theme state.");
+    }
+  }
+  remove() {
+    try {
+      localStorage.removeItem(this.key);
+    } catch {
+    }
+  }
+};
+
+// src/core/event.ts
+var EventEmitter = class {
+  static {
+    __name(this, "EventEmitter");
+  }
+  _map = /* @__PURE__ */ new Map();
+  on(event, listener) {
+    let set = this._map.get(event);
+    if (!set) this._map.set(event, set = /* @__PURE__ */ new Set());
+    set.add(listener);
+    return () => this.off(event, listener);
+  }
+  off(event, listener) {
+    this._map.get(event)?.delete(listener);
+  }
+  emit(event, payload) {
+    this._map.get(event)?.forEach((listener) => listener(payload));
+  }
+};
 
 // src/core/system.ts
 var System = class {
@@ -59,31 +110,8 @@ var System = class {
   }
 };
 
-// src/core/utils.ts
-function resolveStateOf(state, system, config) {
-  if (state === config.system) {
-    return system.prefers;
-  }
-  if (state === config.light || state === config.dark) {
-    return state;
-  }
-  return typeof state === "string" ? state : null;
-}
-__name(resolveStateOf, "resolveStateOf");
-function resolveRoot(root) {
-  if (root instanceof HTMLElement) {
-    return root;
-  } else if (root instanceof Document) {
-    return root.documentElement;
-  } else if (root instanceof ShadowRoot && root.host instanceof HTMLElement) {
-    return root.host;
-  }
-  return document.documentElement;
-}
-__name(resolveRoot, "resolveRoot");
-
 // src/core/controller.ts
-var Controller = class {
+var Controller = class extends EventEmitter {
   static {
     __name(this, "Controller");
   }
@@ -96,21 +124,24 @@ var Controller = class {
   * System theme proxy.
   */
   system;
-  adapters = [];
+  _adapters = [];
+  _observer;
   constructor(_root = document, cfg = {}) {
-    this._root = _root;
+    super(), this._root = _root;
     this.config = {
       attribute: cfg.attribute ?? "data-theme",
-      storage: {
-        key: cfg.storage?.key ?? "theme"
-      },
+      storage: cfg.storage ?? new LocalStorage(),
       system: cfg.system ?? "system",
       light: cfg.light ?? "light",
       dark: cfg.dark ?? "dark",
-      initial: cfg.initial
+      initial: cfg.initial,
+      observe: cfg.observe ?? false
     };
     this.system = new System(this);
     this.syncSystemListener();
+    if (this.config.observe) {
+      this.startObserver();
+    }
   }
   /**
   * The root element to apply theme to.
@@ -159,20 +190,21 @@ var Controller = class {
   * @param adapter Adapter instance
   * @param options Adapter options
   */
-  use(adapter, options) {
-    if (this.adapters.includes(adapter)) {
-      console.warn(`Adapter <${adapter.name}> is already installed.`);
-      return this;
-    }
-    this.adapters.push(adapter);
-    try {
-      adapter.setup?.(this, options);
-      adapter.discover?.(this);
-      adapter.bind?.(this);
-      adapter.sync?.(this);
-    } catch (err) {
-      console.warn(`Adapter <${adapter.name}> failed to install.`, err);
+  use(def, options) {
+    const resolved = {
+      ...def.defaults,
+      ...options
+    };
+    const selector = typeof def.selector === "function" ? def.selector(resolved) : def.selector;
+    for (const el of this.root.querySelectorAll(selector)) {
+      def.bind?.(this, el, resolved);
+      def.sync?.(this, el, resolved);
     }
+    this._adapters.push({
+      def,
+      options: resolved,
+      selector
+    });
     return this;
   }
   /**
@@ -182,25 +214,44 @@ var Controller = class {
   * @param state Theme State
   */
   set(state) {
+    const from = this.state;
     const theme = resolveStateOf(state, this.system, this.config);
-    if (!theme) {
-      return;
-    }
+    if (!theme) return this;
     this.write(state);
     this.syncSystemListener();
     this.apply(theme);
-    for (const a of this.adapters) {
-      a.sync?.(this);
-    }
+    this.syncAdapters();
+    this.emit("change", {
+      from,
+      to: state,
+      theme
+    });
+    return this;
   }
   /**
   * Read the stored theme state from local storage.
   */
   get state() {
-    try {
-      return localStorage.getItem(this.config.storage.key);
-    } catch {
-      return null;
+    return this.config.storage.get();
+  }
+  /**
+  * Destroy the controller.
+  * 
+  * @description
+  * This method disconnects the observer, stops the system listener.
+  */
+  destroy() {
+    this._observer?.disconnect();
+    this.system.stop();
+  }
+  /**
+  * Sync all adapters.
+  */
+  syncAdapters() {
+    for (const { def, options, selector } of this._adapters) {
+      for (const el of this.root.querySelectorAll(selector)) {
+        def.sync?.(this, el, options);
+      }
     }
   }
   /**
@@ -209,13 +260,11 @@ var Controller = class {
   syncSystemListener() {
     const state = this.active();
     if (state === this.config.system) {
-      this.system.start((_state) => {
+      this.system.start(() => {
         const theme = resolveStateOf("system", this.system, this.config);
         if (!theme) return;
         this.apply(theme);
-        for (const a of this.adapters) {
-          a.sync?.(this);
-        }
+        this.syncAdapters();
       });
     } else {
       this.system.stop();
@@ -228,6 +277,9 @@ var Controller = class {
   */
   apply(theme) {
     this.root.setAttribute(this.config.attribute, theme);
+    this.emit("apply", {
+      theme
+    });
   }
   /**
   * Write theme state to local storage.
@@ -235,10 +287,50 @@ var Controller = class {
   * @param theme Theme state
   */
   write(theme) {
-    try {
-      localStorage.setItem(this.config.storage.key, theme);
-    } catch {
-      console.warn(`Failed to write theme state to local storage.`);
+    this.config.storage.set(theme);
+  }
+  /**
+  * Start the DOM elements observer.
+  * 
+  * @description
+  * This method starts a MutationObserver that watches for changes to
+  * the DOM elements that are registered as adapters. When a change
+  * is detected, the controller will bind the element to the adapter.
+  */
+  startObserver() {
+    this._observer = new MutationObserver((mutations) => {
+      for (const mu of mutations) {
+        for (const node of mu.addedNodes) {
+          if (node instanceof Element) {
+            this.bindNode(node);
+          }
+        }
+      }
+    });
+    this._observer.observe(this.root, {
+      childList: true,
+      subtree: true
+    });
+  }
+  /**
+  * Bind a single DOM element to an adapter.
+  * 
+  * @description
+  * This method checks if the element matches the adapter's selector.
+  * If it does, the adapter's `bind` method is called with the element
+  * and the adapter's options. If the adapter has a `sync` method, it
+  * is also called with the element and the adapter's options.
+  */
+  bindNode(node) {
+    for (const { def, options, selector } of this._adapters) {
+      if (node.matches(selector)) {
+        def.bind?.(this, node, options);
+        def.sync?.(this, node, options);
+      }
+      for (const el of node.querySelectorAll(selector)) {
+        def.bind?.(this, el, options);
+        def.sync?.(this, el, options);
+      }
     }
   }
 };

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/system.ts","../../src/core/utils.ts","../../src/core/controller.ts"],"names":["System","mql","handler","ctl","prefers","matchMedia","matches","config","dark","light","prefersDark","prefersLight","start","onChange","e","addEventListener","stop","removeEventListener","undefined","resolveStateOf","state","system","resolveRoot","root","HTMLElement","Document","documentElement","ShadowRoot","host","document","Controller","adapters","_root","cfg","attribute","storage","key","initial","syncSystemListener","active","resolved","theme","use","adapter","options","includes","console","warn","name","push","setup","discover","bind","sync","err","set","write","apply","a","localStorage","getItem","_state","setAttribute","setItem"],"mappings":"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","file":"index.js","sourcesContent":["import { Controller } from \"./controller.js\";\r\nimport { Name, State } from \"./types.js\";\r\n\r\n/**\r\n * System theme proxy.\r\n * \r\n * Used to detect system theme preference and listen for changes.\r\n */\r\nexport class System {\r\n\t/**\r\n\t * Media query list instance.\r\n\t */\r\n\tprivate mql?: MediaQueryList;\r\n\t/**\r\n\t * Handles the media query list listener.\r\n\t */\r\n\tprivate handler?: (e: MediaQueryListEvent) => void;\r\n\t/**\r\n\t * Controller instance.\r\n\t */\r\n\r\n\tconstructor(private ctl: Controller) { }\r\n\r\n\t/**\r\n\t * Get the effective theme by system preference.\r\n\t */\r\n\tget prefers(): Name {\r\n\t\treturn matchMedia?.(\"(prefers-color-scheme: dark)\").matches\r\n\t\t\t? this.ctl.config.dark\r\n\t\t\t: this.ctl.config.light;\r\n\t}\r\n\r\n\t/**\r\n\t * Check if the effective theme is dark.\r\n\t */\r\n\tget prefersDark(): boolean {\r\n\t\treturn this.prefers === this.ctl.config.dark;\r\n\t}\r\n\r\n\t/**\r\n\t * Check if the effective theme is light.\r\n\t */\r\n\tget prefersLight(): boolean {\r\n\t\treturn this.prefers === this.ctl.config.light;\r\n\t}\r\n\r\n\t/**\r\n\t * Start listening for system theme changes.\r\n\t * \r\n\t * @param onChange Callback to be called when the system theme changes.\r\n\t */\r\n\tstart(onChange: (state: Exclude<State, \"system\">) => void) {\r\n\t\tif (this.handler) return;\r\n\r\n\t\tthis.mql = matchMedia(\"(prefers-color-scheme: dark)\");\r\n\t\tthis.handler = e => onChange(e.matches ? \"dark\" : \"light\");\r\n\r\n\t\tthis.mql.addEventListener?.(\"change\", this.handler);\r\n\t}\r\n\r\n\t/**\r\n\t * Stop listening for system theme changes.\r\n\t */\r\n\tstop() {\r\n\t\tif (!this.mql || !this.handler) return;\r\n\r\n\t\tthis.mql.removeEventListener?.(\"change\", this.handler);\r\n\t\t\r\n\t\tthis.mql = this.handler = undefined;\r\n\t}\r\n}","import { ResolvedConfig } from \"./config.js\";\r\nimport { System } from \"./system.js\";\r\nimport { State, type Name } from \"./types.js\";\r\n\r\n/**\r\n * Resolve a theme state to an effective theme name.\r\n * \r\n * @see {@link State}\r\n * \r\n * @param theme Theme state\r\n * @param system System instance.\r\n * @param config Resolved set of configuration.\r\n * @returns \r\n */\r\nexport function resolveStateOf(state: State, system: System, config: ResolvedConfig): Name | null {\r\n\tif (state === config.system) {\r\n\t\treturn system.prefers;\r\n\t}\r\n\r\n\tif (state === config.light || state === config.dark) {\r\n\t\treturn state;\r\n\t}\r\n\r\n\treturn typeof state === \"string\" ? state : null;\r\n}\r\n\r\nexport function resolveRoot(root: unknown): HTMLElement {\r\n\tif (root instanceof HTMLElement) {\r\n\t\treturn root\r\n\t} else if (root instanceof Document) {\r\n\t\treturn root.documentElement\r\n\t} else if (root instanceof ShadowRoot && root.host instanceof HTMLElement) {\r\n\t\treturn root.host\r\n\t};\r\n\r\n\treturn document.documentElement;\r\n}","import { Adapter } from \"./adapter.js\";\r\nimport { RawConfig, ResolvedConfig } from \"./config.js\";\r\nimport { System } from \"./system.js\";\r\nimport { Name, State } from \"./types.js\";\r\nimport { resolveRoot, resolveStateOf } from \"./utils.js\";\r\n\r\n/**\r\n * Theme controller logic.\r\n */\r\nexport class Controller {\r\n\t/**\r\n\t * Resolved configuration.\r\n\t */\r\n\tconfig: ResolvedConfig;\r\n\t/**\r\n\t * System theme proxy.\r\n\t */\r\n\tprivate system: System;\r\n\r\n\tprivate adapters: Adapter<any>[] = [];\r\n\r\n\tconstructor(\r\n\t\tprivate _root: Document | ParentNode = document,\r\n\t\tcfg: RawConfig = {}\r\n\t) {\r\n\t\tthis.config = {\r\n\t\t\tattribute: cfg.attribute ?? \"data-theme\",\r\n\t\t\tstorage: {\r\n\t\t\t\tkey: cfg.storage?.key ?? \"theme\",\r\n\t\t\t},\r\n\t\t\tsystem: cfg.system ?? \"system\",\r\n\t\t\tlight: cfg.light ?? \"light\",\r\n\t\t\tdark: cfg.dark ?? \"dark\",\r\n\t\t\tinitial: cfg.initial\r\n\t\t};\r\n\r\n\t\tthis.system = new System(this);\r\n\r\n\t\tthis.syncSystemListener();\r\n\t}\r\n\r\n\t/**\r\n\t * The root element to apply theme to.\r\n\t */\r\n\tget root(): HTMLElement {\r\n\t\treturn resolveRoot(this._root);\r\n\t}\r\n\r\n\t/**\r\n\t * @param resolved resolve state and effective themes to their values.\r\n\t * \r\n\t * @example\r\n\t * \r\n\t * system = config.system;\r\n\t * light = config.light;\r\n\t * dark = config.dark;\r\n\t * \r\n\t * resolved = true;\r\n\t * [\r\n\t * \t\t\"system\": light | dark,\r\n\t * \t\t\"light\": light,\r\n\t * \t\t\"dark\": dark\r\n\t * ]\r\n\t * resolved = false;\r\n\t * [\r\n\t * \t\t\"system\": system,\r\n\t * \t\t\"light\": light,\r\n\t * \t\t\"dark\": dark\r\n\t * ]\r\n\t */\r\n\tactive(resolved: boolean = false): State | Name | null {\r\n\t\tconst state = this.state;\r\n\r\n\t\tif (!state) {\r\n\t\t\treturn this.config.initial || null;\r\n\t\t}\r\n\r\n\t\tconst theme = resolveStateOf(state, this.system, this.config);\r\n\r\n\t\tif (!theme) return null;\r\n\r\n\r\n\t\treturn resolved ? theme : state;\r\n\t}\r\n\r\n\t/**\r\n\t * Register an adapter.\r\n\t * \r\n\t * @description\r\n\t * Adapters are toys used to change themes.\r\n\t * They define where themes lives and how they work with the controller.\r\n\t * \r\n\t * @param adapter Adapter instance\r\n\t * @param options Adapter options\r\n\t */\r\n\tuse<T extends Adapter<any>>(adapter: T, options?: T extends Adapter<infer O> ? O : never) {\r\n\t\tif (this.adapters.includes(adapter)) {\r\n\t\t\tconsole.warn(`Adapter <${adapter.name}> is already installed.`);\r\n\t\t\treturn this;\r\n\t\t}\r\n\r\n\t\tthis.adapters.push(adapter);\r\n\r\n\t\ttry {\r\n\t\t\tadapter.setup?.(this, options as any);\r\n\t\t\tadapter.discover?.(this);\r\n\t\t\tadapter.bind?.(this);\r\n\t\t\tadapter.sync?.(this);\r\n\t\t} catch (err) {\r\n\t\t\tconsole.warn(`Adapter <${adapter.name}> failed to install.`, err);\r\n\t\t}\r\n\r\n\t\treturn this;\r\n\t}\r\n\t\r\n\t/**\r\n\t * Set the effective theme from a theme state.\r\n\t * \r\n\t * @see {@link State}\r\n\t * @param state Theme State\r\n\t */\r\n\tset(state: State) {\r\n\t\tconst theme = resolveStateOf(state, this.system, this.config);\r\n\t\tif (!theme) {\r\n\t\t\treturn;\r\n\t\t}\r\n\r\n\t\tthis.write(state);\r\n\r\n\t\tthis.syncSystemListener();\r\n\r\n\t\tthis.apply(theme);\r\n\r\n\t\tfor (const a of this.adapters) {\r\n\t\t\ta.sync?.(this);\r\n\t\t}\r\n\t}\r\n\r\n\t/**\r\n\t * Read the stored theme state from local storage.\r\n\t */\r\n\tget state(): State | null {\r\n\t\ttry {\r\n\t\t\treturn localStorage.getItem(this.config.storage.key) as State | null;\r\n\t\t} catch { return null; }\r\n\t}\r\n\r\n\t/**\r\n\t * Sync the system listener.\r\n\t */\r\n\tprivate syncSystemListener() {\r\n\t\tconst state = this.active();\r\n\r\n\t\tif (state === this.config.system) {\r\n\t\t\tthis.system.start(_state => {\r\n\t\t\t\tconst theme = resolveStateOf(\r\n\t\t\t\t\t\"system\",\r\n\t\t\t\t\tthis.system,\r\n\t\t\t\t\tthis.config\r\n\t\t\t\t);\r\n\t\t\t\tif (!theme) return;\r\n\r\n\t\t\t\tthis.apply(theme);\r\n\r\n\t\t\t\tfor (const a of this.adapters) {\r\n\t\t\t\t\ta.sync?.(this);\r\n\t\t\t\t}\r\n\t\t\t});\r\n\t\t} else {\r\n\t\t\tthis.system.stop();\r\n\t\t}\r\n\t}\r\n\r\n\t/**\r\n\t * Applies the effective theme name to the root.\r\n\t * \r\n\t * @param theme Effective theme name (e.g. `<dark>`, `<light>`, `mint`)\r\n\t */\r\n\tprivate apply(theme: Name) {\r\n\t\tthis.root.setAttribute(this.config.attribute, theme);\r\n\t}\r\n\r\n\t/**\r\n\t * Write theme state to local storage.\r\n\t * \r\n\t * @param theme Theme state\r\n\t */\r\n\tprivate write(theme: State) {\r\n\t\ttry {\r\n\t\t\tlocalStorage.setItem(this.config.storage.key, theme);\r\n\t\t} catch {\r\n\t\t\tconsole.warn(`Failed to write theme state to local storage.`);\r\n\t\t}\r\n\t}\r\n}"]}
+{"version":3,"sources":["../../src/storage/local.ts","../../src/core/event.ts","../../src/core/system.ts","../../src/core/controller.ts"],"names":["LocalStorage","key","options","get","localStorage","getItem","set","state","setItem","console","warn","remove","removeItem","EventEmitter","_map","Map","on","event","listener","Set","add","off","delete","emit","payload","forEach","System","mql","handler","ctl","prefers","matchMedia","matches","config","dark","light","prefersDark","prefersLight","start","onChange","e","addEventListener","stop","removeEventListener","undefined","Controller","system","_adapters","_observer","_root","document","cfg","attribute","storage","initial","observe","syncSystemListener","startObserver","root","resolveRoot","active","resolved","theme","resolveStateOf","use","def","defaults","selector","el","querySelectorAll","bind","sync","push","from","write","apply","syncAdapters","to","destroy","disconnect","setAttribute","MutationObserver","mutations","mu","node","addedNodes","Element","bindNode","childList","subtree"],"mappings":"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","file":"index.js","sourcesContent":["/**\r\n * Copyright (c) 2026 GTF\r\n * SPDX-License-Identifier: Apache-2.0\r\n */\r\n\r\nimport { StateStorage } from \"../core/storage.js\";\r\nimport { State } from \"../core/types.js\";\r\n\r\nexport interface LocalStorageOptions {\r\n\t/**\r\n\t * Local storage key.\r\n\t * \r\n\t * @default \"theme\"\r\n\t */\r\n\tkey?: string;\r\n}\r\n\r\n/**\r\n * Simple local storage implementation that uses the browser's native `localStorage`.\r\n */\r\nexport class LocalStorage implements StateStorage {\r\n\treadonly key: string;\r\n\t\r\n\tconstructor(options: LocalStorageOptions = {}) {\r\n\t\tthis.key = options.key ?? \"theme\";\r\n\t}\r\n\t\r\n\tget(): State | null {\r\n\t\ttry {\r\n\t\t\treturn localStorage.getItem(this.key) as State | null;\r\n\t\t} catch {\r\n\t\t\treturn null;\r\n\t\t}\r\n\t}\r\n\r\n\tset(state: State): void {\r\n\t\ttry {\r\n\t\t\tlocalStorage.setItem(this.key, state);\r\n\t\t} catch {\r\n\t\t\tconsole.warn(\"[LOCAL] Failed to write theme state.\");\r\n\t\t}\r\n\t}\r\n\r\n\tremove(): void {\r\n\t\ttry {\r\n\t\t\tlocalStorage.removeItem(this.key);\r\n\t\t} catch {}\r\n\t}\r\n}","/**\r\n * Copyright (c) 2026 GTF\r\n * SPDX-License-Identifier: Apache-2.0\r\n */\r\n\r\nexport type Listener<T> = (event: T) => void;\r\n\r\n/**\r\n * A simple event emitter implementation.\r\n * \r\n * @description\r\n * This class is suitable for use in a web application that wants to\r\n * listen for changes in the theme state.\r\n */\r\nexport class EventEmitter<M extends Record<string, unknown>> {\r\n\tprivate _map = new Map<keyof M, Set<Listener<any>>>();\r\n\r\n\ton<K extends keyof M>(event: K, listener: Listener<M[ K ]>): () => void {\r\n\t\tlet set = this._map.get(event);\r\n\t\tif (!set) this._map.set(event, set = new Set());\r\n\r\n\t\tset.add(listener);\r\n\r\n\t\treturn () => this.off(event, listener);\r\n\t}\r\n\r\n\toff<K extends keyof M>(event: K, listener: Listener<M[ K ]>): void {\r\n\t\tthis._map.get(event)?.delete(listener);\r\n\t}\r\n\r\n\temit<K extends keyof M>(event: K, payload: M[ K ]): void {\r\n\t\tthis._map.get(event)?.forEach(listener => listener(payload));\r\n\t}\r\n}","/**\r\n * Copyright (c) 2026 GTF\r\n * SPDX-License-Identifier: Apache-2.0\r\n */\r\n\r\nimport { Controller } from \"./controller.js\";\r\nimport { Name, State } from \"./types.js\";\r\n\r\n/**\r\n * System theme proxy.\r\n * \r\n * Used to detect system theme preference and listen for changes.\r\n */\r\nexport class System {\r\n\t/**\r\n\t * Media query list instance.\r\n\t */\r\n\tprivate mql?: MediaQueryList;\r\n\t/**\r\n\t * Handles the media query list listener.\r\n\t */\r\n\tprivate handler?: (e: MediaQueryListEvent) => void;\r\n\t/**\r\n\t * Controller instance.\r\n\t */\r\n\r\n\tconstructor(private ctl: Controller) { }\r\n\r\n\t/**\r\n\t * Get the effective theme by system preference.\r\n\t */\r\n\tget prefers(): Name {\r\n\t\treturn matchMedia?.(\"(prefers-color-scheme: dark)\").matches\r\n\t\t\t? this.ctl.config.dark\r\n\t\t\t: this.ctl.config.light;\r\n\t}\r\n\r\n\t/**\r\n\t * Check if the effective theme is dark.\r\n\t */\r\n\tget prefersDark(): boolean {\r\n\t\treturn this.prefers === this.ctl.config.dark;\r\n\t}\r\n\r\n\t/**\r\n\t * Check if the effective theme is light.\r\n\t */\r\n\tget prefersLight(): boolean {\r\n\t\treturn this.prefers === this.ctl.config.light;\r\n\t}\r\n\r\n\t/**\r\n\t * Start listening for system theme changes.\r\n\t * \r\n\t * @param onChange Callback to be called when the system theme changes.\r\n\t */\r\n\tstart(onChange: (state: Exclude<State, \"system\">) => void) {\r\n\t\tif (this.handler) return;\r\n\r\n\t\tthis.mql = matchMedia(\"(prefers-color-scheme: dark)\");\r\n\t\tthis.handler = e => onChange(e.matches ? \"dark\" : \"light\");\r\n\r\n\t\tthis.mql.addEventListener?.(\"change\", this.handler);\r\n\t}\r\n\r\n\t/**\r\n\t * Stop listening for system theme changes.\r\n\t */\r\n\tstop() {\r\n\t\tif (!this.mql || !this.handler) return;\r\n\r\n\t\tthis.mql.removeEventListener?.(\"change\", this.handler);\r\n\t\t\r\n\t\tthis.mql = this.handler = undefined;\r\n\t}\r\n}","/**\r\n * Copyright (c) 2026 GTF\r\n * SPDX-License-Identifier: Apache-2.0\r\n */\r\n\r\nimport { LocalStorage } from \"../storage/local.js\";\r\nimport { AdapterDefinition } from \"./adapter.js\";\r\nimport { RawConfig, ResolvedConfig } from \"./config.js\";\r\nimport { EventEmitter } from \"./event.js\";\r\nimport { System } from \"./system.js\";\r\nimport { Name, NEvents, State } from \"./types.js\";\r\nimport { resolveRoot, resolveStateOf } from \"./utils.js\";\r\n\r\ninterface RegisteredAdapter {\r\n\tdef: AdapterDefinition<any, any>;\r\n\toptions: any;\r\n\tselector: string;\r\n}\r\n\r\n/**\r\n * Theme controller logic.\r\n */\r\nexport class Controller extends EventEmitter<NEvents> {\r\n\t/**\r\n\t * Resolved configuration.\r\n\t */\r\n\tconfig: ResolvedConfig;\r\n\t/**\r\n\t * System theme proxy.\r\n\t */\r\n\tprivate system: System;\r\n\r\n\tprivate _adapters: RegisteredAdapter[] = [];\r\n\tprivate _observer?: MutationObserver;\r\n\r\n\tconstructor(\r\n\t\tprivate _root: Document | ParentNode = document,\r\n\t\tcfg: RawConfig = {}\r\n\t) {\r\n\t\tsuper();\r\n\t\t\r\n\t\tthis.config = {\r\n\t\t\tattribute: cfg.attribute ?? \"data-theme\",\r\n\t\t\tstorage: cfg.storage ?? new LocalStorage(),\r\n\t\t\tsystem: cfg.system ?? \"system\",\r\n\t\t\tlight: cfg.light ?? \"light\",\r\n\t\t\tdark: cfg.dark ?? \"dark\",\r\n\t\t\tinitial: cfg.initial,\r\n\t\t\tobserve: cfg.observe ?? false\r\n\t\t};\r\n\r\n\t\tthis.system = new System(this);\r\n\r\n\t\tthis.syncSystemListener();\r\n\r\n\t\tif (this.config.observe) {\r\n\t\t\tthis.startObserver();\r\n\t\t}\r\n\t}\r\n\r\n\t/**\r\n\t * The root element to apply theme to.\r\n\t */\r\n\tget root(): HTMLElement {\r\n\t\treturn resolveRoot(this._root);\r\n\t}\r\n\r\n\t/**\r\n\t * @param resolved resolve state and effective themes to their values.\r\n\t * \r\n\t * @example\r\n\t * \r\n\t * system = config.system;\r\n\t * light = config.light;\r\n\t * dark = config.dark;\r\n\t * \r\n\t * resolved = true;\r\n\t * [\r\n\t * \t\t\"system\": light | dark,\r\n\t * \t\t\"light\": light,\r\n\t * \t\t\"dark\": dark\r\n\t * ]\r\n\t * resolved = false;\r\n\t * [\r\n\t * \t\t\"system\": system,\r\n\t * \t\t\"light\": light,\r\n\t * \t\t\"dark\": dark\r\n\t * ]\r\n\t */\r\n\tactive(resolved: boolean = false): State | Name | null {\r\n\t\tconst state = this.state;\r\n\r\n\t\tif (!state) {\r\n\t\t\treturn this.config.initial || null;\r\n\t\t}\r\n\r\n\t\tconst theme = resolveStateOf(\r\n\t\t\tstate,\r\n\t\t\tthis.system,\r\n\t\t\tthis.config\r\n\t\t);\r\n\r\n\t\tif (!theme) return null;\r\n\r\n\t\treturn resolved\r\n\t\t\t? theme\r\n\t\t\t: state;\r\n\t}\r\n\r\n\t/**\r\n\t * Register an adapter.\r\n\t * \r\n\t * @description\r\n\t * Adapters are toys used to change themes.\r\n\t * They define where themes lives and how they work with the controller.\r\n\t * \r\n\t * @param adapter Adapter instance\r\n\t * @param options Adapter options\r\n\t */\r\n\tuse<O>(\r\n\t\tdef: AdapterDefinition<any, O>,\r\n\t\toptions?: Partial<O>\r\n\t): this {\r\n\t\tconst resolved = { ...def.defaults, ...options } as O;\r\n\r\n\t\tconst selector = typeof def.selector === \"function\"\r\n\t\t\t? def.selector(resolved)\r\n\t\t\t: def.selector;\r\n\t\t\r\n\t\tfor (const el of this.root.querySelectorAll(selector)) {\r\n\t\t\tdef.bind?.(this, el, resolved);\r\n\t\t\tdef.sync?.(this, el, resolved);\r\n\t\t}\r\n\r\n\t\tthis._adapters.push({\r\n\t\t\tdef,\r\n\t\t\toptions: resolved,\r\n\t\t\tselector\r\n\t\t});\r\n\t\t\r\n\t\treturn this;\r\n\t}\r\n\t\r\n\t/**\r\n\t * Set the effective theme from a theme state.\r\n\t * \r\n\t * @see {@link State}\r\n\t * @param state Theme State\r\n\t */\r\n\tset(state: State) {\r\n\t\tconst from = this.state;\r\n\t\tconst theme = resolveStateOf(state, this.system, this.config);\r\n\r\n\t\tif (!theme) return this;\r\n\r\n\t\tthis.write(state);\r\n\t\tthis.syncSystemListener();\r\n\t\tthis.apply(theme);\r\n\t\tthis.syncAdapters();\r\n\r\n\t\tthis.emit(\"change\", {\r\n\t\t\tfrom,\r\n\t\t\tto: state,\r\n\t\t\ttheme\r\n\t\t});\r\n\r\n\t\treturn this;\r\n\t}\r\n\r\n\t/**\r\n\t * Read the stored theme state from local storage.\r\n\t */\r\n\tget state(): State | null {\r\n\t\treturn this.config.storage.get();\r\n\t}\r\n\r\n\t/**\r\n\t * Destroy the controller.\r\n\t * \r\n\t * @description\r\n\t * This method disconnects the observer, stops the system listener.\r\n\t */\r\n\tdestroy(): void {\r\n\t\tthis._observer?.disconnect();\r\n\t\tthis.system.stop();\r\n\t}\r\n\r\n\t/**\r\n\t * Sync all adapters.\r\n\t */\r\n\tprivate syncAdapters(): void {\r\n\t\tfor (const { def, options, selector } of this._adapters) {\r\n\t\t\tfor (const el of this.root.querySelectorAll(selector)) {\r\n\t\t\t\tdef.sync?.(this, el, options);\r\n\t\t\t}\r\n\t\t}\r\n\t}\r\n\r\n\t/**\r\n\t * Sync the system listener.\r\n\t */\r\n\tprivate syncSystemListener() {\r\n\t\tconst state = this.active();\r\n\r\n\t\tif (state === this.config.system) {\r\n\t\t\tthis.system.start(() => {\r\n\t\t\t\tconst theme = resolveStateOf(\r\n\t\t\t\t\t\"system\",\r\n\t\t\t\t\tthis.system,\r\n\t\t\t\t\tthis.config\r\n\t\t\t\t);\r\n\t\t\t\tif (!theme) return;\r\n\r\n\t\t\t\tthis.apply(theme);\r\n\r\n\t\t\t\tthis.syncAdapters();\r\n\t\t\t});\r\n\t\t} else {\r\n\t\t\tthis.system.stop();\r\n\t\t}\r\n\t}\r\n\r\n\t/**\r\n\t * Applies the effective theme name to the root.\r\n\t * \r\n\t * @param theme Effective theme name (e.g. `<dark>`, `<light>`, `mint`)\r\n\t */\r\n\tprivate apply(theme: Name) {\r\n\t\tthis.root.setAttribute(this.config.attribute, theme);\r\n\t\tthis.emit(\"apply\", { theme });\r\n\t}\r\n\r\n\t/**\r\n\t * Write theme state to local storage.\r\n\t * \r\n\t * @param theme Theme state\r\n\t */\r\n\tprivate write(theme: State) {\r\n\t\tthis.config.storage.set(theme);\r\n\t}\r\n\r\n\t/**\r\n\t * Start the DOM elements observer.\r\n\t * \r\n\t * @description\r\n\t * This method starts a MutationObserver that watches for changes to\r\n\t * the DOM elements that are registered as adapters. When a change\r\n\t * is detected, the controller will bind the element to the adapter.\r\n\t */\r\n\tprivate startObserver(): void {\r\n\t\tthis._observer = new MutationObserver((mutations) => {\r\n\t\t\tfor (const mu of mutations) {\r\n\t\t\t\tfor (const node of mu.addedNodes) {\r\n\t\t\t\t\tif (node instanceof Element) {\r\n\t\t\t\t\t\tthis.bindNode(node);\r\n\t\t\t\t\t}\r\n\t\t\t\t}\r\n\t\t\t}\r\n\t\t});\r\n\r\n\t\tthis._observer.observe(this.root, { childList: true, subtree: true });\r\n\t}\r\n\r\n\t/**\r\n\t * Bind a single DOM element to an adapter.\r\n\t * \r\n\t * @description\r\n\t * This method checks if the element matches the adapter's selector.\r\n\t * If it does, the adapter's `bind` method is called with the element\r\n\t * and the adapter's options. If the adapter has a `sync` method, it\r\n\t * is also called with the element and the adapter's options.\r\n\t */\r\n\tprivate bindNode(node: Element): void {\r\n\t\tfor (const { def, options, selector } of this._adapters) {\r\n\t\t\tif (node.matches(selector)) {\r\n\t\t\t\tdef.bind?.(this, node, options);\r\n\t\t\t\tdef.sync?.(this, node, options);\r\n\t\t\t}\r\n\r\n\t\t\tfor (const el of node.querySelectorAll(selector)) {\r\n\t\t\t\tdef.bind?.(this, el, options);\r\n\t\t\t\tdef.sync?.(this, el, options);\r\n\t\t\t}\r\n\t\t}\r\n\t}\r\n}"]}

package/dist/loader/index.min.js

@@ -1 +1 @@
-!function(){"use strict";!function(l=document.documentElement,t){var e,n,u,i,a,o,r;try{let d=null!=(n=null==(e=null==t?void 0:t.storage)?void 0:e.key)?n:"theme",c=null!=(u=null==t?void 0:t.attribute)?u:"data-theme",m=null!=(i=null==t?void 0:t.system)?i:"system",s=null!=(a=null==t?void 0:t.light)?a:"light",h=null!=(o=null==t?void 0:t.dark)?o:"dark",v=null!=(r=null==t?void 0:t.initial)?r:h;if(l&&l.hasAttribute(c))return;let g=localStorage.getItem(d),f=null;g===m?f=null!=matchMedia&&matchMedia("(prefers-color-scheme: dark)").matches?h:s:g===s||g===h?f=g:!g&&v&&(f=v),f&&l.setAttribute(c,f)}catch(l){}}()}();
+!function(){"use strict";var e=Object.defineProperty,t=(t,a,r)=>((t,a,r)=>a in t?e(t,a,{enumerable:!0,configurable:!0,writable:!0,value:r}):t[a]=r)(t,a+"",r),a=class{constructor(e={}){var a;t(this,"key"),this.key=null!=(a=e.key)?a:"theme"}get(){try{return localStorage.getItem(this.key)}catch(e){return null}}set(e){try{localStorage.setItem(this.key,e)}catch(e){console.warn("[LOCAL] Failed to write theme state.")}}remove(){try{localStorage.removeItem(this.key)}catch(e){}}};e(a,"name",{value:"LocalStorage",configurable:!0});var r=a;!function(e=document.documentElement,t){try{let a=t.storage,r=t.attribute,l=t.system,c=t.light,i=t.dark,n=t.initial;if(e&&e.hasAttribute(r))return;let o=a.get(),s=null;o===l?s=null!=matchMedia&&matchMedia("(prefers-color-scheme: dark)").matches?i:c:o===c||o===i?s=o:!o&&n&&(s=n),s&&e.setAttribute(r,s)}catch(e){}}(document.documentElement,{storage:new r,attribute:"data-theme",system:"system",light:"light",dark:"dark",initial:"dark",observe:!1})}();

package/package.json

@@ -1,57 +1,61 @@
-{
-	"name": "@gottheflag/nova",
-	"version": "0.1.0-beta.1",
-	"type": "module",
-	"license": "MIT",
-	"author": {
-		"name": "GTF",
-		"email": "dev@gottheflag.sa",
-		"url": "https://gottheflag.sa"
-	},
-	"description": "Theme state controller.",
-	"files": [
-		"dist"
-	],
-	"exports": {
-		".": {
-			"types": "./dist/core/index.d.ts",
-			"import": "./dist/core/index.js"
-		},
-		"./adapters": {
-			"types": "./dist/adapters/index.d.ts",
-			"import": "./dist/adapters/index.js"
-		}
-	},
-	"scripts": {
-		"dev": "concurrently -k -n TS,VITE -c blue,green \"tsc -p tsconfig.build.json --watch\" \"vite example\"",
-		"build": "tsup",
-		"typecheck": "tsc --noEmit",
-		"prepare": "pnpm run build"
-	},
-	"keywords": [
-		"theme",
-		"light",
-		"dark"
-	],
-	"publishConfig": {
-		"access": "public"
-	},
-	"repository": {
-		"type": "git",
-		"url": "https://github.com/gottheflag/nova"
-	},
-	"bugs": {
-		"url": "https://github.com/gottheflag/nova/issues"
-	},
-	"homepage": "https://github.com/gottheflag/nova#readme",
-	"devDependencies": {
-		"@swc/core": "^1.15.11",
-		"@types/node": "^25",
-		"concurrently": "^9.2.1",
-		"terser": "^5.46.0",
-		"tsup": "^8.5",
-		"tsx": "^4.21",
-		"typescript": "^5.9",
-		"vite": "^7.3.1"
-	}
-}
+{
+	"name": "@gottheflag/nova",
+	"version": "0.1.0-beta.3",
+	"type": "module",
+	"license": "Apache-2.0",
+	"author": {
+		"name": "GTF",
+		"email": "dev@gottheflag.sa",
+		"url": "https://gottheflag.sa"
+	},
+	"description": "Theme state controller.",
+	"files": [
+		"dist"
+	],
+	"exports": {
+		".": {
+			"types": "./dist/core/index.d.ts",
+			"import": "./dist/core/index.js"
+		},
+		"./adapters": {
+			"types": "./dist/adapters/index.d.ts",
+			"import": "./dist/adapters/index.js"
+		},
+		"./storage": {
+			"types": "./dist/storage/index.d.ts",
+			"import": "./dist/storage/index.js"
+		}
+	},
+	"scripts": {
+		"test": "concurrently -k -n TS,VITE -c blue,green \"tsc -p tsconfig.build.json --watch\" \"vite example\"",
+		"build": "tsup",
+		"typecheck": "tsc --noEmit",
+		"prepare": "pnpm run build"
+	},
+	"keywords": [
+		"theme",
+		"light",
+		"dark"
+	],
+	"publishConfig": {
+		"access": "public"
+	},
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/gottheflag/nova"
+	},
+	"bugs": {
+		"url": "https://github.com/gottheflag/nova/issues"
+	},
+	"homepage": "https://github.com/gottheflag/nova#readme",
+	"devDependencies": {
+		"@swc/core": "^1.15.11",
+		"@types/node": "^25",
+		"concurrently": "^9.2.1",
+		"terser": "^5.46.0",
+		"tsup": "^8.5",
+		"tsx": "^4.21",
+		"typescript": "^5.9",
+		"vite": "^7.3.1"
+	}
+}

package/dist/chunk-7QVYU63E.js

@@ -1,6 +0,0 @@
-var __defProp = Object.defineProperty;
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-
-export { __name };
-//# sourceMappingURL=chunk-7QVYU63E.js.map
-//# sourceMappingURL=chunk-7QVYU63E.js.map

package/dist/chunk-7QVYU63E.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-7QVYU63E.js"}