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

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -48,3 +48,7 @@ ctl.on("apply", ({ theme }) => {
 	console.log("theme applied", theme);
 });
 ```
+
+## License
+
+[Apache-2.0](LICENSE)

package/dist/adapters/index.d.ts

@@ -1,4 +1,5 @@
 import { AdapterDefinition } from '../core/index.js';
+import '../storage-n1c3g6vy.js';
 
 /**
  * Copyright (c) 2026 GTF

package/dist/adapters/index.js

@@ -1,4 +1,5 @@
-import { __name, DEFAULT_PREFIX, parseValue } from '../chunk-NYMA6GFH.js';
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
 // src/core/adapter.ts
 function defineAdapter(definition) {
@@ -6,6 +7,13 @@ function defineAdapter(definition) {
 }
 __name(defineAdapter, "defineAdapter");
 
+// src/core/utils.ts
+var DEFAULT_PREFIX = "theme:";
+function parseValue(value, prefix) {
+  return value.startsWith(prefix) ? value.slice(prefix.length) : value;
+}
+__name(parseValue, "parseValue");
+
 // src/adapters/button.ts
 var Button = defineAdapter({
   name: "button",

package/dist/adapters/index.js.map

@@ -1 +1 @@
-{"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});"]}
+{"version":3,"sources":["../../src/core/adapter.ts","../../src/core/utils.ts","../../src/adapters/button.ts","../../src/adapters/radio.ts","../../src/adapters/select.ts"],"names":["defineAdapter","definition","DEFAULT_PREFIX","parseValue","value","prefix","startsWith","slice","length","Button","name","defaults","animate","enabled","duration","easing","selector","o","bind","ctl","el","addEventListener","event","theme","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":";;;;AA6CO,SAASA,cAIfC,UAAAA,EAAmC;AAEnC,EAAA,OAAOA,UAAAA;AACR;AAPgBD,MAAAA,CAAAA,aAAAA,EAAAA,eAAAA,CAAAA;;;ACpCT,IAAME,cAAAA,GAAiB,QAAA;AA0DvB,SAASC,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;;;AC1CT,IAAMM,SAAST,aAAAA,CAAgD;EAClEU,IAAAA,EAAM,QAAA;EAENC,QAAAA,EAAU;IACNN,MAAAA,EAAQH,cAAAA;IACRU,OAAAA,EAAS;MACLC,OAAAA,EAAS,KAAA;MACTC,QAAAA,EAAU,GAAA;MACVC,MAAAA,EAAQ;AACZ;AACJ,GAAA;AAEAC,EAAAA,QAAAA,0BAAWC,CAAAA,KAAM,CAAA,eAAA,EAAkBA,CAAAA,CAAEZ,MAAAA,IAAUH,cAAAA,CAAAA,EAAAA,CAAAA,EAArC,UAAA,CAAA;AAEVgB,EAAAA,IAAAA,CAAKC,KAAKC,EAAAA,EAAI,EAAEf,MAAAA,GAASH,cAAAA,EAAgBU,SAAO,EAAE;AAC9CQ,IAAAA,EAAAA,CAAGC,gBAAAA,CAAiB,OAAA,EAAS,OAAOC,KAAAA,KAAAA;AAChC,MAAA,MAAMC,KAAAA,GAAQpB,UAAAA,CAAWiB,EAAAA,CAAGhB,KAAAA,EAAOC,MAAAA,CAAAA;AAEnC,MAAA,IAAIkB,KAAAA,KAAUJ,IAAIK,KAAAA,EAAO;AAEzB,MAAA,IAAI,CAACZ,OAAAA,EAASC,OAAAA,IAAW,CAACY,SAASC,mBAAAA,EAAqB;AACpDP,QAAAA,GAAAA,CAAIQ,IAAIJ,KAAAA,CAAAA;AACR,QAAA;AACJ,MAAA;AAEA,MAAA,MAAM,EAAEK,OAAAA,EAASC,CAAAA,EAAGC,OAAAA,EAASC,GAAC,GAAKT,KAAAA;AAEnC,MAAA,MAAMU,MAAAA,GAASC,IAAAA,CAAKC,KAAAA,CAChBD,IAAAA,CAAKE,IAAIN,CAAAA,EAAGO,UAAAA,GAAaP,CAAAA,CAAAA,EACzBI,IAAAA,CAAKE,GAAAA,CAAIJ,CAAAA,EAAGM,WAAAA,GAAcN,CAAAA,CAAAA,CAAAA;AAG9B,MAAA,MAAMO,aAAab,QAAAA,CAASC,mBAAAA,CAAoB,MAAMP,GAAAA,CAAIQ,GAAAA,CAAIJ,KAAAA,CAAAA,CAAAA;AAE9D,MAAA,MAAMe,UAAAA,CAAWC,KAAAA;AAEjBd,MAAAA,QAAAA,CAASe,gBAAgB5B,OAAAA,CACrB;QACI6B,QAAAA,EAAU;UACN,CAAA,cAAA,EAAiBZ,CAAAA,MAAOE,CAAAA,CAAAA,GAAAA,CAAAA;AACxB,UAAA,CAAA,OAAA,EAAUC,MAAAA,CAAAA,MAAAA,EAAeH,CAAAA,CAAAA,GAAAA,EAAOE,CAAAA,CAAAA,GAAAA;;OAExC,EACA;AACIjB,QAAAA,QAAAA,EAAUF,QAAQE,QAAAA,IAAY,GAAA;AAC9BC,QAAAA,MAAAA,EAAQH,QAAQG,MAAAA,IAAU,aAAA;QAC1B2B,aAAAA,EAAe;OACnB,CAAA;IAER,CAAA,CAAA;AACJ,EAAA;AACJ,CAAA;;;ACzDO,IAAMC,QAAQ3C,aAAAA,CAA8C;EAC/DU,IAAAA,EAAM,OAAA;EAENC,QAAAA,EAAU;IACNN,MAAAA,EAAQH;AACZ,GAAA;AAEAc,EAAAA,QAAAA,kBAAU,MAAA,CAAA,CAACC,CAAAA,KAAM,CAAA,4BAAA,EAA+BA,CAAAA,CAAEZ,MAAM,CAAA,EAAA,CAAA,EAA9C,UAAA,CAAA;AAEVa,EAAAA,IAAAA,CAAKC,GAAAA,EAAKC,EAAAA,EAAI,EAAEf,MAAAA,GAASH,gBAAc,EAAE;AACrCkB,IAAAA,EAAAA,CAAGC,gBAAAA,CAAiB,UAAU,MAAA;AAC1B,MAAA,IAAI,CAACD,GAAGwB,OAAAA,EAAS;AAEjB,MAAA,MAAMrB,KAAAA,GAAQpB,UAAAA,CAAWiB,EAAAA,CAAGhB,KAAAA,EAAOC,MAAAA,CAAAA;AAEnC,MAAA,IAAIkB,KAAAA,KAAUJ,IAAIK,KAAAA,EAAO;AAEzBL,MAAAA,GAAAA,CAAIQ,IAAIJ,KAAAA,CAAAA;IACZ,CAAA,CAAA;AACJ,EAAA,CAAA;AAEAsB,EAAAA,IAAAA,CAAK1B,GAAAA,EAAKC,EAAAA,EAAI,EAAEf,MAAAA,GAASH,gBAAc,EAAE;AACrCkB,IAAAA,EAAAA,CAAGwB,UAAUzC,UAAAA,CAAWiB,EAAAA,CAAGhB,OAAOC,MAAAA,CAAAA,KAAYc,IAAI2B,MAAAA,EAAM;AAC5D,EAAA;AACJ,CAAA;;;ACpBO,IAAMC,SAAS/C,aAAAA,CAAgD;EAClEU,IAAAA,EAAM,QAAA;EAENC,QAAAA,EAAU;IACNN,MAAAA,EAAQH;AACZ,GAAA;AAEAc,EAAAA,QAAAA,kBAAU,MAAA,CAAA,CAACC,CAAAA,KAAM,CAAA,0BAAA,EAA6BA,CAAAA,CAAEZ,MAAM,CAAA,GAAA,CAAA,EAA5C,UAAA,CAAA;AAEVa,EAAAA,IAAAA,CAAKC,GAAAA,EAAKC,EAAAA,EAAI,EAAEf,MAAAA,GAASH,gBAAc,EAAE;AACrCkB,IAAAA,EAAAA,CAAGC,gBAAAA,CAAiB,UAAU,MAAA;AAC1B,MAAA,MAAM2B,MAAAA,GAAS5B,EAAAA,CAAG6B,OAAAA,CAAS7B,EAAAA,CAAG8B,aAAa,CAAA;AAC3C,MAAA,MAAM3B,KAAAA,GAAQpB,UAAAA,CAAW6C,MAAAA,CAAO5C,KAAAA,EAAOC,MAAAA,CAAAA;AAEvC,MAAA,IAAIkB,KAAAA,KAAUJ,IAAIK,KAAAA,EAAO;AAEzBL,MAAAA,GAAAA,CAAIQ,IAAIJ,KAAAA,CAAAA;IACZ,CAAA,CAAA;AACJ,EAAA,CAAA;AAEAsB,EAAAA,IAAAA,CAAK1B,GAAAA,EAAKC,EAAAA,EAAI,EAAEf,MAAAA,GAASH,gBAAc,EAAE;AACrC,IAAA,MAAM4C,MAAAA,GAAS3B,IAAI2B,MAAAA,EAAM;AAEzB,IAAA,KAAA,MAAWE,MAAAA,IAAU5B,GAAG6B,OAAAA,EAAS;AAC7BD,MAAAA,MAAAA,CAAOG,QAAAA,GAAWhD,UAAAA,CAAW6C,MAAAA,CAAO5C,KAAAA,EAAOC,MAAAA,CAAAA,KAAYyC,MAAAA;AAC3D,IAAA;AACJ,EAAA;AACJ,CAAA","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 { 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}","/**\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/core/index.d.ts

@@ -1,89 +1,4 @@
-/**
- * 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`).
- */
-type Name = string;
-/**
- * Theme state (`<dark>`, `<light>`, `<system>`).
- * Different between state themes and effective themes:
- * - State themes are the raw values used as identifiers (`<dark>`, `<light>`, `<system>`).
- * - 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;
-}
+import { S as StateStorage, N as Name, b as NEvents, a as State } from '../storage-n1c3g6vy.js';
 
 /**
  * Copyright (c) 2026 GTF
@@ -297,4 +212,41 @@ declare class Controller extends EventEmitter<NEvents> {
     private bindNode;
 }
 
-export { type AdapterDefinition, Controller, EventEmitter, type Name, type ResolvedConfig, type State, defineAdapter };
+/**
+ * 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>;
+
+export { type AdapterDefinition, Controller, EventEmitter, Name, type ResolvedConfig, State, defineAdapter };

package/dist/core/index.js

@@ -1,4 +1,5 @@
-import { __name, resolveRoot, resolveStateOf } from '../chunk-NYMA6GFH.js';
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
 // src/storage/local.ts
 var LocalStorage = class {
@@ -110,6 +111,29 @@ 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 extends EventEmitter {
   static {

package/dist/core/index.js.map

@@ -1 +1 @@
-{"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}"]}
+{"version":3,"sources":["../../src/storage/local.ts","../../src/core/event.ts","../../src/core/system.ts","../../src/core/utils.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","resolveStateOf","system","resolveRoot","root","HTMLElement","Document","documentElement","ShadowRoot","host","document","Controller","_adapters","_observer","_root","cfg","attribute","storage","initial","observe","syncSystemListener","startObserver","active","resolved","theme","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 { 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}","/**\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/storage/index.d.ts

@@ -0,0 +1,87 @@
+import { S as StateStorage, a as State } from '../storage-n1c3g6vy.js';
+
+/**
+ * Copyright (c) 2026 GTF
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+interface LocalStorageOptions {
+    /**
+     * Local storage key.
+     *
+     * @default "theme"
+     */
+    key?: string;
+}
+/**
+ * Simple local storage implementation that uses the browser's native `localStorage`.
+ */
+declare class LocalStorage implements StateStorage {
+    readonly key: string;
+    constructor(options?: LocalStorageOptions);
+    get(): State | null;
+    set(state: State): void;
+    remove(): void;
+}
+
+/**
+ * Copyright (c) 2026 GTF
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+interface CookieStorageOptions {
+    /**
+     * Cookie name.
+     *
+     * @default "theme"
+     */
+    key?: string;
+    /**
+     * Cookie path.
+     *
+     * @default "/"
+     */
+    path?: string;
+    /**
+     * Cookie domain.
+     *
+     * Example: ".nova.sa"
+     */
+    domain?: string;
+    /**
+     * Cookie lifetime in seconds.
+     *
+     * @default 31536000 (1 year)
+     */
+    maxAge?: number;
+    /**
+     * SameSite policy.
+     *
+     * @default "Lax"
+     */
+    sameSite?: "Strict" | "Lax" | "None";
+    /**
+     * Marks the cookie as secure.
+     *
+     * @default true if the page is served over HTTPS.
+     */
+    secure?: boolean;
+}
+/**
+ * A storage implementation that uses cookies to store the theme state.
+ *
+ * @description
+ * This storage implementation is suitable for use in a web application that
+ * wants to persist the theme state across sub-domains or across multiple
+ * applications on the same domain.
+ */
+declare class CookieStorage implements StateStorage {
+    private readonly options;
+    readonly key: string;
+    constructor(options?: CookieStorageOptions);
+    get(): State | null;
+    set(state: State): void;
+    remove(): void;
+}
+
+export { CookieStorage, LocalStorage };

package/dist/storage/index.js

@@ -0,0 +1,88 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// 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/storage/cookie.ts
+var CookieStorage = class {
+  static {
+    __name(this, "CookieStorage");
+  }
+  options;
+  key;
+  constructor(options = {}) {
+    this.options = options;
+    this.key = options.key ?? "theme";
+  }
+  get() {
+    const prefix = `${encodeURIComponent(this.key)}=`;
+    for (const cookie of document.cookie.split(";")) {
+      const c = cookie.trim();
+      if (c.startsWith(prefix)) {
+        return decodeURIComponent(c.slice(prefix.length));
+      }
+    }
+    return null;
+  }
+  set(state) {
+    const { path = "/", domain, maxAge = 60 * 60 * 24 * 365, sameSite = "Lax", secure = location.protocol === "https:" } = this.options;
+    const parts = [
+      `${encodeURIComponent(this.key)}=${encodeURIComponent(state)}`,
+      `Path=${path}`,
+      `Max-Age=${maxAge}`,
+      `SameSite=${sameSite}`
+    ];
+    if (domain) {
+      parts.push(`Domain=${domain}`);
+    }
+    if (secure) {
+      parts.push(`Secure`);
+    }
+    document.cookie = parts.join("; ");
+  }
+  remove() {
+    const { path = "/", domain } = this.options;
+    const parts = [
+      `${encodeURIComponent(this.key)}=`,
+      `Max-Age=0`,
+      `Path=${path}`
+    ];
+    if (domain) {
+      parts.push(`Domain=${domain}`);
+    }
+    document.cookie = parts.join("; ");
+  }
+};
+
+export { CookieStorage, LocalStorage };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/storage/local.ts","../../src/storage/cookie.ts"],"names":["LocalStorage","key","options","get","localStorage","getItem","set","state","setItem","console","warn","remove","removeItem","CookieStorage","prefix","encodeURIComponent","cookie","document","split","c","trim","startsWith","decodeURIComponent","slice","length","path","domain","maxAge","sameSite","secure","location","protocol","parts","push","join"],"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\nimport { StateStorage } from \"../core/storage.js\";\r\nimport { State } from \"../core/types.js\";\r\n\r\nexport interface CookieStorageOptions {\r\n\t/**\r\n\t * Cookie name.\r\n\t * \r\n\t * @default \"theme\"\r\n\t */\r\n\tkey?: string;\r\n\r\n\t/**\r\n\t * Cookie path.\r\n\t * \r\n\t * @default \"/\"\r\n\t */\r\n\tpath?: string;\r\n\r\n\t/**\r\n\t * Cookie domain.\r\n\t * \r\n\t * Example: \".nova.sa\"\r\n\t */\r\n\tdomain?: string;\r\n\r\n\t/**\r\n\t * Cookie lifetime in seconds.\r\n\t * \r\n\t * @default 31536000 (1 year)\r\n\t */\r\n\tmaxAge?: number;\r\n\r\n\t/**\r\n\t * SameSite policy.\r\n\t * \r\n\t * @default \"Lax\"\r\n\t */\r\n\tsameSite?: \"Strict\" | \"Lax\" | \"None\";\r\n\r\n\t/**\r\n\t * Marks the cookie as secure.\r\n\t *\r\n\t * @default true if the page is served over HTTPS.\r\n\t */\r\n\tsecure?: boolean;\r\n}\r\n\r\n/**\r\n * A storage implementation that uses cookies to store the theme state.\r\n * \r\n * @description\r\n * This storage implementation is suitable for use in a web application that\r\n * wants to persist the theme state across sub-domains or across multiple\r\n * applications on the same domain.\r\n */\r\nexport class CookieStorage implements StateStorage {\r\n\treadonly key: string;\r\n\t\r\n\tconstructor(\r\n\t\tprivate readonly options: CookieStorageOptions = {}\r\n\t) {\r\n\t\tthis.key = options.key ?? \"theme\";\r\n\t}\r\n\r\n\tget(): State | null {\r\n\t\tconst prefix = `${encodeURIComponent(this.key)}=`;\r\n\r\n\t\tfor (const cookie of document.cookie.split(\";\")) {\r\n\t\t\tconst c = cookie.trim();\r\n\t\t\t\r\n\t\t\tif (c.startsWith(prefix)) {\r\n\t\t\t\treturn decodeURIComponent(c.slice(prefix.length)) as State;\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\treturn null;\r\n\t}\r\n\r\n\tset(state: State): void {\r\n\t\tconst {\r\n\t\t\tpath = '/',\r\n\t\t\tdomain,\r\n\t\t\tmaxAge = 60 * 60 * 24 * 365,\r\n\t\t\tsameSite = \"Lax\",\r\n\t\t\tsecure = location.protocol === \"https:\"\r\n\t\t} = this.options;\r\n\r\n\t\tconst parts = [\r\n\t\t\t`${encodeURIComponent(this.key)}=${encodeURIComponent(state)}`,\r\n\t\t\t`Path=${path}`,\r\n\t\t\t`Max-Age=${maxAge}`,\r\n\t\t\t`SameSite=${sameSite}`,\r\n\t\t];\r\n\r\n\t\tif (domain) {\r\n\t\t\tparts.push(`Domain=${domain}`);\r\n\t\t}\r\n\r\n\t\tif (secure) {\r\n\t\t\tparts.push(`Secure`);\r\n\t\t}\r\n\r\n\t\tdocument.cookie = parts.join(\"; \");\r\n\t}\r\n\r\n\tremove(): void {\r\n\t\tconst { path = '/', domain } = this.options;\r\n\r\n\t\tconst parts = [\r\n\t\t\t`${encodeURIComponent(this.key)}=`,\r\n\t\t\t`Max-Age=0`,\r\n\t\t\t`Path=${path}`,\r\n\t\t];\r\n\r\n\t\tif (domain) {\r\n\t\t\tparts.push(`Domain=${domain}`);\r\n\t\t}\r\n\r\n\t\tdocument.cookie = parts.join(\"; \");\r\n\t}\r\n}"]}

package/dist/storage-n1c3g6vy.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Copyright (c) 2026 GTF
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Effective theme name (e.g. `day`, `night`, `mint`).
+ */
+type Name = string;
+/**
+ * Theme state (`<dark>`, `<light>`, `<system>`).
+ * Different between state themes and effective themes:
+ * - State themes are the raw values used as identifiers (`<dark>`, `<light>`, `<system>`).
+ * - 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;
+}
+
+export type { Name as N, StateStorage as S, State as a, NEvents as b };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@gottheflag/nova",
-	"version": "0.1.0-beta.3",
+	"version": "0.1.0-beta.4",
 	"type": "module",
 	"license": "Apache-2.0",
 	"author": {

package/dist/chunk-NYMA6GFH.js

@@ -1,34 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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}"]}