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

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.2",
+	"version": "0.1.0-beta.4",
 	"type": "module",
 	"license": "Apache-2.0",
 	"author": {
@@ -20,10 +20,14 @@
 		"./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": {
-		"dev": "concurrently -k -n TS,VITE -c blue,green \"tsc -p tsconfig.build.json --watch\" \"vite example\"",
+		"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"

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"}