@ailuracode/alpine-battery 0.1.0

package/LICENSE

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

package/README.md

@@ -0,0 +1,39 @@
+# @ailuracode/alpine-battery
+
+Battery status magic for Alpine.js.
+
+**[Full documentation →](../../docs/battery.md)**
+
+## Install
+
+```bash
+npm install @ailuracode/alpine-battery alpinejs
+```
+
+## Quick example
+
+```js
+import Alpine from "alpinejs";
+import battery from "@ailuracode/alpine-battery";
+
+Alpine.plugin(battery);
+Alpine.start();
+```
+
+```html
+<div x-show="$battery.isAvailable">
+  Battery: <span x-text="Math.round($battery.level * 100)"></span>%
+  <span x-show="$battery.isCharging">(charging)</span>
+</div>
+```
+
+## API summary
+
+| | |
+|-|-|
+| **Magic** | `$battery` |
+| **Properties** | `isAvailable`, `level`, `isCharging`, `chargingTime`, `dischargingTime` |
+
+## License
+
+MIT

package/dist/global.d.ts

@@ -0,0 +1,17 @@
+/// <reference types="@types/alpinejs" />
+
+export interface BatteryMagic {
+  isAvailable: boolean;
+  level: number | null;
+  isCharging: boolean;
+  chargingTime: number | null;
+  dischargingTime: number | null;
+}
+
+declare global {
+  namespace Alpine {
+    interface Magics<T> {
+      $battery: BatteryMagic;
+    }
+  }
+}

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+import AlpineType from 'alpinejs';
+
+interface BatteryMagic {
+    isAvailable: boolean;
+    level: number | null;
+    isCharging: boolean;
+    chargingTime: number | null;
+    dischargingTime: number | null;
+}
+interface BatteryManagerLike {
+    charging: boolean;
+    chargingTime: number;
+    dischargingTime: number;
+    level: number;
+    addEventListener(type: string, listener: EventListener): void;
+    dispatchEvent(event: Event): boolean;
+}
+/** Reads battery state from a BatteryManager, or unavailable defaults. */
+declare function readBatteryState(manager?: BatteryManagerLike): BatteryMagic;
+/** Alpine.js battery plugin. Registers reactive magic `$battery`. */
+declare function batteryPlugin(Alpine: AlpineType.Alpine): void;
+declare global {
+    namespace Alpine {
+        interface Magics<T> {
+            $battery: BatteryMagic;
+        }
+    }
+}
+
+export { type BatteryMagic, type BatteryManagerLike, batteryPlugin as default, readBatteryState };

package/dist/index.js

@@ -0,0 +1,46 @@
+// src/index.ts
+function normalizeTime(seconds) {
+  return Number.isFinite(seconds) ? seconds : null;
+}
+function readBatteryState(manager) {
+  if (!manager) {
+    return {
+      isAvailable: false,
+      level: null,
+      isCharging: false,
+      chargingTime: null,
+      dischargingTime: null
+    };
+  }
+  return {
+    isAvailable: true,
+    level: manager.level,
+    isCharging: manager.charging,
+    chargingTime: normalizeTime(manager.chargingTime),
+    dischargingTime: normalizeTime(manager.dischargingTime)
+  };
+}
+function batteryPlugin(Alpine) {
+  const state = Alpine.reactive(readBatteryState());
+  Alpine.magic("battery", () => state);
+  const nav = navigator;
+  if (typeof nav.getBattery !== "function") {
+    return;
+  }
+  nav.getBattery().then((battery) => {
+    const update = () => {
+      Object.assign(state, readBatteryState(battery));
+    };
+    update();
+    battery.addEventListener("chargingchange", update);
+    battery.addEventListener("levelchange", update);
+    battery.addEventListener("chargingtimechange", update);
+    battery.addEventListener("dischargingtimechange", update);
+  }).catch(() => {
+  });
+}
+export {
+  batteryPlugin as default,
+  readBatteryState
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type AlpineType from \"alpinejs\";\n\nexport interface BatteryMagic {\n  isAvailable: boolean;\n  level: number | null;\n  isCharging: boolean;\n  chargingTime: number | null;\n  dischargingTime: number | null;\n}\n\nexport interface BatteryManagerLike {\n  charging: boolean;\n  chargingTime: number;\n  dischargingTime: number;\n  level: number;\n  addEventListener(type: string, listener: EventListener): void;\n  dispatchEvent(event: Event): boolean;\n}\n\ntype NavigatorWithBattery = Navigator & {\n  getBattery?: () => Promise<BatteryManagerLike>;\n};\n\nfunction normalizeTime(seconds: number): number | null {\n  return Number.isFinite(seconds) ? seconds : null;\n}\n\n/** Reads battery state from a BatteryManager, or unavailable defaults. */\nexport function readBatteryState(manager?: BatteryManagerLike): BatteryMagic {\n  if (!manager) {\n    return {\n      isAvailable: false,\n      level: null,\n      isCharging: false,\n      chargingTime: null,\n      dischargingTime: null,\n    };\n  }\n\n  return {\n    isAvailable: true,\n    level: manager.level,\n    isCharging: manager.charging,\n    chargingTime: normalizeTime(manager.chargingTime),\n    dischargingTime: normalizeTime(manager.dischargingTime),\n  };\n}\n\n/** Alpine.js battery plugin. Registers reactive magic `$battery`. */\nexport default function batteryPlugin(Alpine: AlpineType.Alpine): void {\n  const state = Alpine.reactive<BatteryMagic>(readBatteryState());\n\n  Alpine.magic(\"battery\", () => state);\n\n  const nav = navigator as NavigatorWithBattery;\n  if (typeof nav.getBattery !== \"function\") {\n    return;\n  }\n\n  nav\n    .getBattery()\n    .then((battery) => {\n      const update = () => {\n        Object.assign(state, readBatteryState(battery));\n      };\n\n      update();\n      battery.addEventListener(\"chargingchange\", update);\n      battery.addEventListener(\"levelchange\", update);\n      battery.addEventListener(\"chargingtimechange\", update);\n      battery.addEventListener(\"dischargingtimechange\", update);\n    })\n    .catch(() => {\n      // API present but unavailable — keep isAvailable false\n    });\n}\n\ndeclare global {\n  namespace Alpine {\n    interface Magics<T> {\n      $battery: BatteryMagic;\n    }\n  }\n}\n"],"mappings":";AAuBA,SAAS,cAAc,SAAgC;AACrD,SAAO,OAAO,SAAS,OAAO,IAAI,UAAU;AAC9C;AAGO,SAAS,iBAAiB,SAA4C;AAC3E,MAAI,CAAC,SAAS;AACZ,WAAO;AAAA,MACL,aAAa;AAAA,MACb,OAAO;AAAA,MACP,YAAY;AAAA,MACZ,cAAc;AAAA,MACd,iBAAiB;AAAA,IACnB;AAAA,EACF;AAEA,SAAO;AAAA,IACL,aAAa;AAAA,IACb,OAAO,QAAQ;AAAA,IACf,YAAY,QAAQ;AAAA,IACpB,cAAc,cAAc,QAAQ,YAAY;AAAA,IAChD,iBAAiB,cAAc,QAAQ,eAAe;AAAA,EACxD;AACF;AAGe,SAAR,cAA+B,QAAiC;AACrE,QAAM,QAAQ,OAAO,SAAuB,iBAAiB,CAAC;AAE9D,SAAO,MAAM,WAAW,MAAM,KAAK;AAEnC,QAAM,MAAM;AACZ,MAAI,OAAO,IAAI,eAAe,YAAY;AACxC;AAAA,EACF;AAEA,MACG,WAAW,EACX,KAAK,CAAC,YAAY;AACjB,UAAM,SAAS,MAAM;AACnB,aAAO,OAAO,OAAO,iBAAiB,OAAO,CAAC;AAAA,IAChD;AAEA,WAAO;AACP,YAAQ,iBAAiB,kBAAkB,MAAM;AACjD,YAAQ,iBAAiB,eAAe,MAAM;AAC9C,YAAQ,iBAAiB,sBAAsB,MAAM;AACrD,YAAQ,iBAAiB,yBAAyB,MAAM;AAAA,EAC1D,CAAC,EACA,MAAM,MAAM;AAAA,EAEb,CAAC;AACL;","names":[]}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@ailuracode/alpine-battery",
+  "version": "0.1.0",
+  "description": "Alpine.js battery status magic",
+  "type": "module",
+  "license": "MIT",
+  "author": "ailuracode",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ailuracode/alpine.git",
+    "directory": "packages/battery"
+  },
+  "bugs": {
+    "url": "https://github.com/ailuracode/alpine/issues"
+  },
+  "homepage": "https://github.com/ailuracode/alpine/tree/master/packages/battery#readme",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./global": {
+      "types": "./dist/global.d.ts"
+    }
+  },
+  "types": "./dist/global.d.ts",
+  "peerDependencies": {
+    "alpinejs": "^3.0.0",
+    "@types/alpinejs": "^3.13.11"
+  },
+  "peerDependenciesMeta": {
+    "@types/alpinejs": {
+      "optional": true
+    }
+  },
+  "keywords": [
+    "alpinejs",
+    "alpine",
+    "plugin",
+    "battery",
+    "power",
+    "charging"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean --sourcemap --out-dir dist && cp src/global.d.ts dist/global.d.ts",
+    "test": "vitest run --config ../../vitest.config.js test"
+  }
+}