@symbiote-native/battery 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 A. Prokopenko
+
+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,44 @@
+# @symbiote-native/battery
+
+**Status: skeleton only — not implemented, published early to reserve the npm name.**
+This package currently ships nothing but `package.json` and this README. No `src/`, no
+dependencies, no build. See the `symbiote-new-package-skeleton` project skill for what a
+tier-1 skeleton package is and isn't.
+
+Planned: a port of [`expo-battery`](https://docs.expo.dev/versions/latest/sdk/battery/) for
+[SymbioteNative](../../README.md) — battery level and state, low-power-mode detection, reachable
+from every adapter (React, Vue, Angular), not just React.
+
+## Planned API
+
+Forward-looking reference only, transcribed from upstream's actual
+`.vendors/expo/packages/expo-battery/src/Battery.ts` — signatures here are what will be ported,
+not yet implemented.
+
+```ts
+isAvailableAsync(): Promise<boolean>                          // battery API availability on this device
+getBatteryLevelAsync(): Promise<number>                       // 0..1, or -1 if unsupported
+getBatteryStateAsync(): Promise<BatteryState>                 // UNKNOWN/UNPLUGGED/CHARGING/FULL/NOT_CHARGING
+isLowPowerModeEnabledAsync(): Promise<boolean>                // Low Power Mode (iOS) / Power Saver (Android)
+isBatteryOptimizationEnabledAsync(): Promise<boolean>         // Android only
+getPowerStateAsync(): Promise<PowerState>                     // combined level + state + lowPowerMode
+addBatteryLevelListener(listener): Subscription                // fires on battery level change
+addBatteryStateListener(listener): Subscription                // fires on battery state change
+addLowPowerModeListener(listener): Subscription                // fires when low-power mode toggles
+```
+
+Plus `BatteryState` (enum), `PowerState`, `BatteryLevelEvent`, `BatteryStateEvent`,
+`PowerModeEvent` — ported from upstream's `Battery.types.ts`. Upstream also exposes
+`useBatteryLevel` / `useBatteryState` / `useLowPowerMode` / `usePowerState` React hooks; per this
+repo's core/adapter split, those become adapter-owned lifecycle wrappers (React hooks, Vue
+composables, …) over the same shared core, not core exports themselves.
+
+## Reference
+
+- [`../local-auth`](../local-auth) — nearest already-implemented sibling package: an
+  `expo-modules-core`-based wrapper with the same shape this package will follow (framework-agnostic
+  `core/`, thin per-adapter re-export entries).
+- [`symbiote-expo-native-module`](../../.claude/skills/symbiote-expo-native-module/SKILL.md) — the
+  real wrapping mechanics (depend on `expo-modules-core` only, never the `expo` meta-package; port
+  upstream JS into `core/` rather than importing it; autolinking) that will apply once this moves
+  past skeleton.

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@symbiote-native/battery",
+  "version": "0.0.1",
+  "description": "expo-battery wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, and Angular adapters. Battery level and state (charging/full/unplugged/unknown), low-power-mode detection, plus event listeners for level and state changes.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OneEyed1366/symbiote-native.git",
+    "directory": "packages/battery"
+  },
+  "homepage": "https://github.com/OneEyed1366/symbiote-native/tree/master/packages/battery#readme",
+  "bugs": {
+    "url": "https://github.com/OneEyed1366/symbiote-native/issues"
+  },
+  "author": "Andrey Prokopenko <psevdoproger@gmail.com>",
+  "publishConfig": {
+    "access": "public"
+  }
+}