@symbiote-native/keep-awake 0.2.0 → 0.3.0

package/README.md

@@ -2,8 +2,8 @@
 
 Port of [`expo-keep-awake`](https://docs.expo.dev/versions/latest/sdk/keep-awake/) for
 [SymbioteNative](../../README.md) — keeps the screen on for the lifetime of a mounted
-component/composable/service, reachable from every adapter (React, Vue, Angular), not just
-React.
+component/composable/service, reachable from every adapter (React, Vue, Svelte, Solid, Angular),
+not just React.
 
 Built the same way as [`@symbiote-native/battery`](../battery) and
 [`@symbiote-native/device`](../device), an `expo-modules-core`-based wrapper (see the
@@ -31,12 +31,12 @@ into the native host app **once**, covering this package and every other `expo-m
 package (`@symbiote-native/battery`, `@symbiote-native/device`, `@symbiote-native/sensors`, …)
 with zero further changes:
 
-| Platform | Touches |
-|---|---|
-| iOS | `ios/Podfile` — add `use_expo_modules!` |
-| iOS | `AppDelegate.swift` — Expo's runtime-bootstrap hook |
-| Android | `settings.gradle` / `app/build.gradle` — resolve and include the Expo Gradle projects |
-| Android | `MainApplication.kt` — Expo's bootstrap hook, plus a hand-written native-module name map (there's no `expo` meta-package here to auto-generate one) |
+| Platform | Touches                                                                                                                                             |
+| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
+| iOS      | `ios/Podfile` — add `use_expo_modules!`                                                                                                             |
+| iOS      | `AppDelegate.swift` — Expo's runtime-bootstrap hook                                                                                                 |
+| Android  | `settings.gradle` / `app/build.gradle` — resolve and include the Expo Gradle projects                                                               |
+| Android  | `MainApplication.kt` — Expo's bootstrap hook, plus a hand-written native-module name map (there's no `expo` meta-package here to auto-generate one) |
 
 The recurring per-package half of the Android wiring (`app/build.gradle`'s
 `implementation project(':expo-keep-awake')` line and `MainApplication.kt`'s module-name map
@@ -59,15 +59,18 @@ src/core/               keep-awake.ts — isAvailableAsync/activateKeepAwakeAsyn
                         KeepAwakeOptions, hand-ported from KeepAwake.types.ts.
 src/react/hooks/        @symbiote-native/keep-awake/react   — useKeepAwake
 src/vue/composables/    @symbiote-native/keep-awake/vue     — useKeepAwake
+src/svelte/runes/       @symbiote-native/keep-awake/svelte  — useKeepAwake
+src/solid/primitives/   @symbiote-native/keep-awake/solid   — createKeepAwake (Solid says
+                                                              create*, not use*)
 src/angular/services/   @symbiote-native/keep-awake/angular — KeepAwakeService (`.connect()`,
                         no return value — a pure side effect for the component's lifetime)
 ```
 
-Each adapter's hook/composable/service activates a keep-awake lock on mount and deactivates it on
-unmount, over the same `core` functions — the tag-generation and activate/deactivate lifecycle is
-written once and shared by all three. React uses `useId()` for its default per-instance tag,
-matching upstream; Vue and Angular have no `useId` equivalent, so both fall back to a small
-monotonically-incrementing module-local counter (`keep-awake-tag-1`, `keep-awake-tag-2`, …) when
+Each adapter's hook/composable/rune/primitive/service activates a keep-awake lock on mount and
+deactivates it on unmount, over the same `core` functions — the tag-generation and
+activate/deactivate lifecycle is written once and shared by every adapter. React uses `useId()`
+for its default per-instance tag, matching upstream; Vue, Svelte, Solid and Angular have no
+`useId` equivalent, so they fall back to a small monotonically-incrementing module-local counter (`keep-awake-tag-1`, `keep-awake-tag-2`, …) when
 no explicit tag is given.
 
 ## Use it
@@ -100,7 +103,7 @@ useKeepAwake();
 import { Component, inject } from '@angular/core';
 import { KeepAwakeService } from '@symbiote-native/keep-awake/angular';
 
-@Component({ /* ... */ })
+@Component({/* ... */})
 export class KeepAwakeScreen {
   constructor() {
     inject(KeepAwakeService).connect();
@@ -123,25 +126,31 @@ as a minimal `unknown` placeholder: upstream's own shape there is web-specific a
 analogue, and native listeners for it rarely fire.
 
 ```ts
-import { activateKeepAwakeAsync, deactivateKeepAwake } from '@symbiote-native/keep-awake';
+import {
+  activateKeepAwakeAsync,
+  deactivateKeepAwake,
+} from '@symbiote-native/keep-awake';
 
 // framework-scoped entry points re-export the same free functions, plus a lifecycle
 // hook/composable/service:
 import { useKeepAwake } from '@symbiote-native/keep-awake/react';
 import { useKeepAwake } from '@symbiote-native/keep-awake/vue';
+import { useKeepAwake } from '@symbiote-native/keep-awake/svelte';
+import { createKeepAwake } from '@symbiote-native/keep-awake/solid';
 import { KeepAwakeService } from '@symbiote-native/keep-awake/angular';
 ```
 
-Each hook/composable/service activates a lock on mount (optionally registering `options.listener`
-once activation resolves) and deactivates it on unmount — mirroring upstream's own
-`useKeepAwake(tag?, options?)`.
+Each hook/composable/rune/primitive/service activates a lock on mount (optionally registering
+`options.listener` once activation resolves) and deactivates it on unmount — mirroring upstream's
+own `useKeepAwake(tag?, options?)`. Solid's `createKeepAwake(tag?, options?)` does it from the
+primitive body, releasing through `onCleanup`.
 
 ## Test it
 
 No Fabric/Descriptor angle at all — keep-awake is a pure async-function + `EventEmitter` listener
 surface, never a view. Tests inject a fake native-module object in place of the real
 `requireNativeModule` resolution (`src/core/keep-awake.test.ts`,
-`src/{react,vue,angular}/**/*.test.{ts,tsx}`, `vitest`), the same pattern
+`src/{react,vue,svelte,solid,angular}/**/*.test.{ts,tsx}`, `vitest`), the same pattern
 `@symbiote-native/battery` and `@symbiote-native/device` use — no `installFabric()`-driven Fabric
 assertions on the core level, only the adapter lifecycle tests mount through the fake Fabric slot
 to prove activate-on-mount/deactivate-on-unmount. Native rendering itself is verified on-device —

package/build/angular/services/keep-awake.service/index.js

@@ -33,7 +33,7 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
     return useValue ? value : void 0;
 };
 import { effect, inject, Injectable, Injector } from '@angular/core';
-import { activateKeepAwakeAsync, deactivateKeepAwake } from '../../../core/index.js';
+import { activateKeepAwakeAsync, deactivateKeepAwake, } from '../../../core/index.js';
 import { createKeepAwakeListenerAttachment } from '../../../core/listener-attachment.js';
 // Angular twin of React's `useKeepAwake` hook and Vue's `useKeepAwake` composable. See
 // LowPowerModeService (packages/battery) for the `connect()`/`effect()` pattern rationale — same

package/build/core/index.d.ts

@@ -1,3 +1,3 @@
 export { ExpoKeepAwakeTag, isAvailableAsync, activateKeepAwakeAsync, deactivateKeepAwake, addListener, } from './keep-awake';
-export type { KeepAwakeEvent, KeepAwakeListener, KeepAwakeOptions } from './types';
+export type { KeepAwakeEvent, KeepAwakeListener, KeepAwakeOptions, } from './types';
 export type { EventSubscription } from 'expo-modules-core';

package/build/react/hooks/use-keep-awake/index.js

@@ -7,7 +7,7 @@
 // that's not reachable here (only core's public API is), so an UnavailabilityError from
 // `addListener` is just swallowed by the trailing `.catch(() => {})` instead - same net effect.
 import { useEffect, useId } from 'react';
-import { activateKeepAwakeAsync, deactivateKeepAwake } from '../../../core/index.js';
+import { activateKeepAwakeAsync, deactivateKeepAwake, } from '../../../core/index.js';
 import { createKeepAwakeListenerAttachment } from '../../../core/listener-attachment.js';
 export function useKeepAwake(tag, options) {
     const defaultTag = useId();

package/build/solid/index.d.ts

@@ -0,0 +1,2 @@
+export { createKeepAwake } from './primitives/create-keep-awake';
+export * from '../core';

package/build/solid/index.js

@@ -0,0 +1,6 @@
+// @symbiote-native/keep-awake/solid: the Solid entry over the framework-agnostic core. The
+// lifecycle bucket is `primitives/` and the name is `create*` (never `hooks/`/`use*`, that is
+// React's term and Solid's word for consuming an existing thing) — see
+// adapters/solid/src/primitives for the same convention.
+export { createKeepAwake } from './primitives/create-keep-awake.js';
+export * from '../core/index.js';

package/build/solid/primitives/create-keep-awake.d.ts

@@ -0,0 +1,2 @@
+import { type KeepAwakeOptions } from '../../core';
+export declare function createKeepAwake(tag?: string, options?: KeepAwakeOptions): void;

package/build/solid/primitives/create-keep-awake.js

@@ -0,0 +1,41 @@
+// Solid lifecycle wiring over the framework-agnostic core (core/keep-awake.ts): activates a
+// keep-awake lock in the primitive body, deactivates it when the owner is disposed — the Solid
+// twin of React's hook, Vue's composable, Svelte's rune and Angular's KeepAwakeService.connect().
+//
+// `primitives/` and `create*`, not `hooks/`/`use*`: Solid's ecosystem calls a composable reactive
+// function a PRIMITIVE and reserves `use*` for consuming something that already exists. Full
+// rationale in adapters/solid/src/primitives/create-color-scheme.ts's header.
+//
+// Activation runs SYNCHRONOUSLY in the body with `onCleanup` for teardown, not from a mount hook
+// (React's useEffect, Vue's onMounted, Svelte's $effect) — the lock is requested one tick earlier,
+// and nothing can interleave between construction and the request.
+//
+// Nothing reactive is returned: keeping the screen awake is a pure side effect for the owner's
+// lifetime, so there is no accessor and the once-per-owner contract matches Vue/Svelte/Angular
+// rather than React's hook, which re-runs when the tag changes.
+//
+// No `useId` in Solid, so the default tag comes from a module-local counter, as in Vue and Svelte.
+//
+// Outside a component / createRoot there is no owner for `onCleanup`, so the lock is never
+// released — see create-color-scheme's header for the same documented caveat.
+import { onCleanup } from 'solid-js';
+import { activateKeepAwakeAsync, deactivateKeepAwake, } from '../../core/index.js';
+import { createKeepAwakeListenerAttachment } from '../../core/listener-attachment.js';
+let tagCounter = 0;
+export function createKeepAwake(tag, options) {
+    const tagOrDefault = tag ?? `keep-awake-tag-${++tagCounter}`;
+    // One attachment per owner: the body runs once, so it spans the single activate/onCleanup pair.
+    const attachment = createKeepAwakeListenerAttachment(tagOrDefault, options?.listener);
+    activateKeepAwakeAsync(tagOrDefault)
+        .then(() => attachment.attach())
+        .catch(() => { });
+    onCleanup(() => {
+        attachment.release();
+        if (options?.suppressDeactivateWarnings) {
+            deactivateKeepAwake(tagOrDefault).catch(() => { });
+        }
+        else {
+            deactivateKeepAwake(tagOrDefault);
+        }
+    });
+}

package/build/svelte/runes/use-keep-awake.svelte.js

@@ -13,7 +13,7 @@
 //
 // No `useId` in Svelte, so the default tag comes from a module-local counter, as in Vue's
 // composable.
-import { activateKeepAwakeAsync, deactivateKeepAwake } from '../../core/index.js';
+import { activateKeepAwakeAsync, deactivateKeepAwake, } from '../../core/index.js';
 import { createKeepAwakeListenerAttachment } from '../../core/listener-attachment.js';
 let tagCounter = 0;
 export function useKeepAwake(tag, options) {

package/build/vue/composables/use-keep-awake/index.js

@@ -4,7 +4,7 @@
 // counter instead — simplest robust way to give each composable instance its own tag when the
 // caller doesn't supply one.
 import { onMounted, onUnmounted } from '@vue/runtime-core';
-import { activateKeepAwakeAsync, deactivateKeepAwake } from '../../../core/index.js';
+import { activateKeepAwakeAsync, deactivateKeepAwake, } from '../../../core/index.js';
 import { createKeepAwakeListenerAttachment } from '../../../core/listener-attachment.js';
 let tagCounter = 0;
 export function useKeepAwake(tag, options) {

package/build-ngc/angular/services/keep-awake.service/index.js

@@ -1,5 +1,5 @@
 import { effect, inject, Injectable, Injector } from '@angular/core';
-import { activateKeepAwakeAsync, deactivateKeepAwake } from '../../../core';
+import { activateKeepAwakeAsync, deactivateKeepAwake, } from '../../../core';
 import { createKeepAwakeListenerAttachment } from '../../../core/listener-attachment';
 import * as i0 from "@angular/core";
 // Angular twin of React's `useKeepAwake` hook and Vue's `useKeepAwake` composable. See

package/build-ngc/angular/services/keep-awake.service/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/angular/services/keep-awake.service/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAyB,MAAM,eAAe,CAAC;AACnG,OAAO,EAAE,iCAAiC,EAAE,MAAM,mCAAmC,CAAC;;AAEtF,uFAAuF;AACvF,iGAAiG;AACjG,+FAA+F;AAC/F,6FAA6F;AAC7F,yFAAyF;AACzF,EAAE;AACF,0DAA0D;AAC1D,IAAI,UAAU,GAAG,CAAC,CAAC;AAGnB,MAAM,OAAO,gBAAgB;IACV,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE7C,OAAO,CAAC,GAAY,EAAE,OAA0B;QAC9C,MAAM,YAAY,GAAG,GAAG,IAAI,kBAAkB,EAAE,UAAU,EAAE,CAAC;QAE7D,MAAM,CACJ,SAAS,CAAC,EAAE;YACV,sFAAsF;YACtF,2DAA2D;YAC3D,MAAM,UAAU,GAAG,iCAAiC,CAAC,YAAY,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;YAEtF,sBAAsB,CAAC,YAAY,CAAC;iBACjC,IAAI,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;iBAC/B,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAEnB,SAAS,CAAC,GAAG,EAAE;gBACb,UAAU,CAAC,OAAO,EAAE,CAAC;gBACrB,IAAI,OAAO,EAAE,0BAA0B,EAAE,CAAC;oBACxC,mBAAmB,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBACpD,CAAC;qBAAM,CAAC;oBACN,mBAAmB,CAAC,YAAY,CAAC,CAAC;gBACpC,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,EACD,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAC5B,CAAC;IACJ,CAAC;uGA3BU,gBAAgB;2GAAhB,gBAAgB,cADH,MAAM;;2FACnB,gBAAgB;kBAD5B,UAAU;mBAAC,EAAE,UAAU,EAAE,MAAM,EAAE"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/angular/services/keep-awake.service/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EACL,sBAAsB,EACtB,mBAAmB,GAEpB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iCAAiC,EAAE,MAAM,mCAAmC,CAAC;;AAEtF,uFAAuF;AACvF,iGAAiG;AACjG,+FAA+F;AAC/F,6FAA6F;AAC7F,yFAAyF;AACzF,EAAE;AACF,0DAA0D;AAC1D,IAAI,UAAU,GAAG,CAAC,CAAC;AAGnB,MAAM,OAAO,gBAAgB;IACV,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE7C,OAAO,CAAC,GAAY,EAAE,OAA0B;QAC9C,MAAM,YAAY,GAAG,GAAG,IAAI,kBAAkB,EAAE,UAAU,EAAE,CAAC;QAE7D,MAAM,CACJ,SAAS,CAAC,EAAE;YACV,sFAAsF;YACtF,2DAA2D;YAC3D,MAAM,UAAU,GAAG,iCAAiC,CAClD,YAAY,EACZ,OAAO,EAAE,QAAQ,CAClB,CAAC;YAEF,sBAAsB,CAAC,YAAY,CAAC;iBACjC,IAAI,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;iBAC/B,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAEnB,SAAS,CAAC,GAAG,EAAE;gBACb,UAAU,CAAC,OAAO,EAAE,CAAC;gBACrB,IAAI,OAAO,EAAE,0BAA0B,EAAE,CAAC;oBACxC,mBAAmB,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBACpD,CAAC;qBAAM,CAAC;oBACN,mBAAmB,CAAC,YAAY,CAAC,CAAC;gBACpC,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,EACD,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAC5B,CAAC;IACJ,CAAC;uGA9BU,gBAAgB;2GAAhB,gBAAgB,cADH,MAAM;;2FACnB,gBAAgB;kBAD5B,UAAU;mBAAC,EAAE,UAAU,EAAE,MAAM,EAAE"}

package/build-ngc/core/index.d.ts

@@ -1,3 +1,3 @@
 export { ExpoKeepAwakeTag, isAvailableAsync, activateKeepAwakeAsync, deactivateKeepAwake, addListener, } from './keep-awake';
-export type { KeepAwakeEvent, KeepAwakeListener, KeepAwakeOptions } from './types';
+export type { KeepAwakeEvent, KeepAwakeListener, KeepAwakeOptions, } from './types';
 export type { EventSubscription } from 'expo-modules-core';

package/build-ngc/core/keep-awake.js.map

@@ -1 +1 @@
-{"version":3,"file":"keep-awake.js","sourceRoot":"","sources":["../../src/core/keep-awake.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,oFAAoF;AACpF,2FAA2F;AAC3F,6EAA6E;AAC7E,qFAAqF;AACrF,OAAO,EAAE,mBAAmB,EAA0B,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,MAAM,CAAC,MAAM,gBAAgB,GAAG,yBAAyB,CAAC;AAE1D,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,IAAI,aAAa,CAAC,gBAAgB,EAAE,CAAC;QACnC,OAAO,MAAM,aAAa,CAAC,gBAAgB,EAAE,CAAC;IAChD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,MAAc,gBAAgB;IACzE,MAAM,aAAa,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC;AAED,iGAAiG;AACjG,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAAc,gBAAgB;IACtE,MAAM,aAAa,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,aAAyC,EACzC,QAA4B;IAE5B,IAAI,CAAC,aAAa,CAAC,iBAAiB,EAAE,CAAC;QACrC,MAAM,IAAI,mBAAmB,CAAC,eAAe,EAAE,mBAAmB,CAAC,CAAC;IACtE,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,gBAAgB,CAAC;IACjF,MAAM,gBAAgB,GAAG,OAAO,aAAa,KAAK,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC;IACxF,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,MAAM,IAAI,SAAS,CAAC,0CAA0C,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,aAAa,CAAC,iBAAiB,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;AAChE,CAAC"}
+{"version":3,"file":"keep-awake.js","sourceRoot":"","sources":["../../src/core/keep-awake.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,oFAAoF;AACpF,2FAA2F;AAC3F,6EAA6E;AAC7E,qFAAqF;AACrF,OAAO,EAAE,mBAAmB,EAA0B,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,MAAM,CAAC,MAAM,gBAAgB,GAAG,yBAAyB,CAAC;AAE1D,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,IAAI,aAAa,CAAC,gBAAgB,EAAE,CAAC;QACnC,OAAO,MAAM,aAAa,CAAC,gBAAgB,EAAE,CAAC;IAChD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAc,gBAAgB;IAE9B,MAAM,aAAa,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC;AAED,iGAAiG;AACjG,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAc,gBAAgB;IAE9B,MAAM,aAAa,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,aAAyC,EACzC,QAA4B;IAE5B,IAAI,CAAC,aAAa,CAAC,iBAAiB,EAAE,CAAC;QACrC,MAAM,IAAI,mBAAmB,CAAC,eAAe,EAAE,mBAAmB,CAAC,CAAC;IACtE,CAAC;IACD,MAAM,GAAG,GACP,OAAO,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,gBAAgB,CAAC;IACvE,MAAM,gBAAgB,GACpB,OAAO,aAAa,KAAK,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC;IACjE,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,MAAM,IAAI,SAAS,CAAC,0CAA0C,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,aAAa,CAAC,iBAAiB,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;AAChE,CAAC"}

package/build-ngc/core/native-module.js.map

@@ -1 +1 @@
-{"version":3,"file":"native-module.js","sourceRoot":"","sources":["../../src/core/native-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAIxD,MAAM,2BAA2B,GAAG,eAAe,CAAC;AAapD,MAAM,CAAC,MAAM,aAAa,GAAG,mBAAmB,CAC9C,2BAA2B,CAC5B,CAAC"}
+{"version":3,"file":"native-module.js","sourceRoot":"","sources":["../../src/core/native-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAIxD,MAAM,2BAA2B,GAAG,eAAe,CAAC;AAgBpD,MAAM,CAAC,MAAM,aAAa,GAAG,mBAAmB,CAC9C,2BAA2B,CAC5B,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@symbiote-native/keep-awake",
-  "version": "0.2.0",
-  "description": "expo-keep-awake wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, and Angular adapters. Keeps the screen awake for the lifetime of a mounted component/composable/service, with an optional listener for keep-awake state changes.",
+  "version": "0.3.0",
+  "description": "expo-keep-awake wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, Svelte, Solid, and Angular adapters. Keeps the screen awake for the lifetime of a mounted component/composable/service, with an optional listener for keep-awake state changes.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -34,6 +34,10 @@
       "types": "./build/svelte/index.d.ts",
       "default": "./build/svelte/index.js"
     },
+    "./solid": {
+      "types": "./build/solid/index.d.ts",
+      "default": "./build/solid/index.js"
+    },
     "./angular": {
       "types": "./build-ngc/angular/index.d.ts",
       "react-native": "./build-ngc/angular/index.js",
@@ -60,12 +64,14 @@
     "@symbiote-native/angular": ">=0.6.2",
     "@symbiote-native/engine": ">=0.1.7",
     "@symbiote-native/react": ">=0.2.8",
+    "@symbiote-native/solid": ">=0.0.1",
     "@symbiote-native/svelte": ">=0.1.0",
     "@symbiote-native/vue": ">=0.3.8",
     "@angular/core": ">=20",
     "@vue/runtime-core": "^3.5.13",
     "react": ">=19.0.0",
     "react-native": ">=0.86",
+    "solid-js": ">=1.9.0",
     "svelte": ">=5.56.0",
     "vue": ">=3.5.0"
   },
@@ -76,6 +82,9 @@
     "@symbiote-native/react": {
       "optional": true
     },
+    "@symbiote-native/solid": {
+      "optional": true
+    },
     "@symbiote-native/svelte": {
       "optional": true
     },
@@ -91,6 +100,9 @@
     "react": {
       "optional": true
     },
+    "solid-js": {
+      "optional": true
+    },
     "svelte": {
       "optional": true
     },
@@ -106,14 +118,16 @@
     "@types/react": "^19.2.0",
     "@vue/runtime-core": "^3.5.13",
     "react": "19.2.3",
+    "solid-js": "^1.9.14",
     "svelte": "^5.56.0",
     "typescript": "~6.0.0",
-    "@symbiote-native/angular": "0.7.0",
-    "@symbiote-native/engine": "0.2.0",
-    "@symbiote-native/react": "0.3.0",
-    "@symbiote-native/svelte": "0.2.0",
-    "@symbiote-native/test-utils": "0.1.6",
-    "@symbiote-native/vue": "0.4.0"
+    "@symbiote-native/angular": "0.8.0",
+    "@symbiote-native/engine": "0.3.0",
+    "@symbiote-native/react": "0.4.0",
+    "@symbiote-native/solid": "0.1.0",
+    "@symbiote-native/svelte": "0.3.0",
+    "@symbiote-native/test-utils": "0.2.0",
+    "@symbiote-native/vue": "0.5.0"
   },
   "scripts": {
     "typecheck": "tsc --build",

package/src/angular/services/keep-awake.service/index.ts

@@ -1,5 +1,9 @@
 import { effect, inject, Injectable, Injector } from '@angular/core';
-import { activateKeepAwakeAsync, deactivateKeepAwake, type KeepAwakeOptions } from '../../../core';
+import {
+  activateKeepAwakeAsync,
+  deactivateKeepAwake,
+  type KeepAwakeOptions,
+} from '../../../core';
 import { createKeepAwakeListenerAttachment } from '../../../core/listener-attachment';
 
 // Angular twin of React's `useKeepAwake` hook and Vue's `useKeepAwake` composable. See
@@ -22,7 +26,10 @@ export class KeepAwakeService {
       onCleanup => {
         // Per effect run: onCleanup releases this exact attachment, so a re-run always starts
         // from a fresh one rather than reviving a released attach.
-        const attachment = createKeepAwakeListenerAttachment(tagOrDefault, options?.listener);
+        const attachment = createKeepAwakeListenerAttachment(
+          tagOrDefault,
+          options?.listener,
+        );
 
         activateKeepAwakeAsync(tagOrDefault)
           .then(() => attachment.attach())

package/src/core/index.ts

@@ -5,5 +5,9 @@ export {
   deactivateKeepAwake,
   addListener,
 } from './keep-awake';
-export type { KeepAwakeEvent, KeepAwakeListener, KeepAwakeOptions } from './types';
+export type {
+  KeepAwakeEvent,
+  KeepAwakeListener,
+  KeepAwakeOptions,
+} from './types';
 export type { EventSubscription } from 'expo-modules-core';

package/src/core/keep-awake.ts

@@ -21,12 +21,16 @@ export async function isAvailableAsync(): Promise<boolean> {
  * Activates a keep-awake lock under `tag` (the shared default tag when none is given) — the
  * screen stays on for as long as any tag holds an active lock.
  */
-export async function activateKeepAwakeAsync(tag: string = ExpoKeepAwakeTag): Promise<void> {
+export async function activateKeepAwakeAsync(
+  tag: string = ExpoKeepAwakeTag,
+): Promise<void> {
   await expoKeepAwake.activate?.(tag);
 }
 
 /** Releases the keep-awake lock held under `tag` (the shared default tag when none is given). */
-export async function deactivateKeepAwake(tag: string = ExpoKeepAwakeTag): Promise<void> {
+export async function deactivateKeepAwake(
+  tag: string = ExpoKeepAwakeTag,
+): Promise<void> {
   await expoKeepAwake.deactivate?.(tag);
 }
 
@@ -41,8 +45,10 @@ export function addListener(
   if (!expoKeepAwake.addListenerForTag) {
     throw new UnavailabilityError('ExpoKeepAwake', 'addListenerForTag');
   }
-  const tag = typeof tagOrListener === 'string' ? tagOrListener : ExpoKeepAwakeTag;
-  const resolvedListener = typeof tagOrListener === 'function' ? tagOrListener : listener;
+  const tag =
+    typeof tagOrListener === 'string' ? tagOrListener : ExpoKeepAwakeTag;
+  const resolvedListener =
+    typeof tagOrListener === 'function' ? tagOrListener : listener;
   if (!resolvedListener) {
     throw new TypeError('addListener requires a listener function');
   }

package/src/core/native-module.ts

@@ -12,7 +12,10 @@ export type INativeKeepAwakeModule = {
   isAvailableAsync?(): Promise<boolean>;
   activate?(tag: string): Promise<void>;
   deactivate?(tag: string): Promise<void>;
-  addListenerForTag?(tag: string, listener: KeepAwakeListener): EventSubscription;
+  addListenerForTag?(
+    tag: string,
+    listener: KeepAwakeListener,
+  ): EventSubscription;
 };
 
 export const expoKeepAwake = requireNativeModule<INativeKeepAwakeModule>(

package/src/react/hooks/use-keep-awake/index.ts

@@ -7,7 +7,11 @@
 // that's not reachable here (only core's public API is), so an UnavailabilityError from
 // `addListener` is just swallowed by the trailing `.catch(() => {})` instead - same net effect.
 import { useEffect, useId } from 'react';
-import { activateKeepAwakeAsync, deactivateKeepAwake, type KeepAwakeOptions } from '../../../core';
+import {
+  activateKeepAwakeAsync,
+  deactivateKeepAwake,
+  type KeepAwakeOptions,
+} from '../../../core';
 import { createKeepAwakeListenerAttachment } from '../../../core/listener-attachment';
 
 export function useKeepAwake(tag?: string, options?: KeepAwakeOptions): void {
@@ -17,7 +21,10 @@ export function useKeepAwake(tag?: string, options?: KeepAwakeOptions): void {
   useEffect(() => {
     // Per effect run, not per hook call - a changed tag tears the old attachment down with the
     // rest of the cleanup and starts a fresh one.
-    const attachment = createKeepAwakeListenerAttachment(tagOrDefault, options?.listener);
+    const attachment = createKeepAwakeListenerAttachment(
+      tagOrDefault,
+      options?.listener,
+    );
 
     activateKeepAwakeAsync(tagOrDefault)
       .then(() => attachment.attach())

package/src/solid/index.ts

@@ -0,0 +1,7 @@
+// @symbiote-native/keep-awake/solid: the Solid entry over the framework-agnostic core. The
+// lifecycle bucket is `primitives/` and the name is `create*` (never `hooks/`/`use*`, that is
+// React's term and Solid's word for consuming an existing thing) — see
+// adapters/solid/src/primitives for the same convention.
+
+export { createKeepAwake } from './primitives/create-keep-awake';
+export * from '../core';

package/src/solid/primitives/create-keep-awake.ts

@@ -0,0 +1,54 @@
+// Solid lifecycle wiring over the framework-agnostic core (core/keep-awake.ts): activates a
+// keep-awake lock in the primitive body, deactivates it when the owner is disposed — the Solid
+// twin of React's hook, Vue's composable, Svelte's rune and Angular's KeepAwakeService.connect().
+//
+// `primitives/` and `create*`, not `hooks/`/`use*`: Solid's ecosystem calls a composable reactive
+// function a PRIMITIVE and reserves `use*` for consuming something that already exists. Full
+// rationale in adapters/solid/src/primitives/create-color-scheme.ts's header.
+//
+// Activation runs SYNCHRONOUSLY in the body with `onCleanup` for teardown, not from a mount hook
+// (React's useEffect, Vue's onMounted, Svelte's $effect) — the lock is requested one tick earlier,
+// and nothing can interleave between construction and the request.
+//
+// Nothing reactive is returned: keeping the screen awake is a pure side effect for the owner's
+// lifetime, so there is no accessor and the once-per-owner contract matches Vue/Svelte/Angular
+// rather than React's hook, which re-runs when the tag changes.
+//
+// No `useId` in Solid, so the default tag comes from a module-local counter, as in Vue and Svelte.
+//
+// Outside a component / createRoot there is no owner for `onCleanup`, so the lock is never
+// released — see create-color-scheme's header for the same documented caveat.
+import { onCleanup } from 'solid-js';
+import {
+  activateKeepAwakeAsync,
+  deactivateKeepAwake,
+  type KeepAwakeOptions,
+} from '../../core';
+import { createKeepAwakeListenerAttachment } from '../../core/listener-attachment';
+
+let tagCounter = 0;
+
+export function createKeepAwake(
+  tag?: string,
+  options?: KeepAwakeOptions,
+): void {
+  const tagOrDefault = tag ?? `keep-awake-tag-${++tagCounter}`;
+  // One attachment per owner: the body runs once, so it spans the single activate/onCleanup pair.
+  const attachment = createKeepAwakeListenerAttachment(
+    tagOrDefault,
+    options?.listener,
+  );
+
+  activateKeepAwakeAsync(tagOrDefault)
+    .then(() => attachment.attach())
+    .catch(() => {});
+
+  onCleanup(() => {
+    attachment.release();
+    if (options?.suppressDeactivateWarnings) {
+      deactivateKeepAwake(tagOrDefault).catch(() => {});
+    } else {
+      deactivateKeepAwake(tagOrDefault);
+    }
+  });
+}

package/src/svelte/runes/use-keep-awake.svelte.ts

@@ -13,7 +13,11 @@
 //
 // No `useId` in Svelte, so the default tag comes from a module-local counter, as in Vue's
 // composable.
-import { activateKeepAwakeAsync, deactivateKeepAwake, type KeepAwakeOptions } from '../../core';
+import {
+  activateKeepAwakeAsync,
+  deactivateKeepAwake,
+  type KeepAwakeOptions,
+} from '../../core';
 import { createKeepAwakeListenerAttachment } from '../../core/listener-attachment';
 
 let tagCounter = 0;
@@ -23,7 +27,10 @@ export function useKeepAwake(tag?: string, options?: KeepAwakeOptions): void {
 
   $effect(() => {
     // Inside the effect, so the attachment shares the teardown returned below.
-    const attachment = createKeepAwakeListenerAttachment(tagOrDefault, options?.listener);
+    const attachment = createKeepAwakeListenerAttachment(
+      tagOrDefault,
+      options?.listener,
+    );
 
     activateKeepAwakeAsync(tagOrDefault)
       .then(() => attachment.attach())

package/src/vue/composables/use-keep-awake/index.ts

@@ -4,7 +4,11 @@
 // counter instead — simplest robust way to give each composable instance its own tag when the
 // caller doesn't supply one.
 import { onMounted, onUnmounted } from '@vue/runtime-core';
-import { activateKeepAwakeAsync, deactivateKeepAwake, type KeepAwakeOptions } from '../../../core';
+import {
+  activateKeepAwakeAsync,
+  deactivateKeepAwake,
+  type KeepAwakeOptions,
+} from '../../../core';
 import { createKeepAwakeListenerAttachment } from '../../../core/listener-attachment';
 
 let tagCounter = 0;
@@ -13,7 +17,10 @@ export function useKeepAwake(tag?: string, options?: KeepAwakeOptions): void {
   const tagOrDefault = tag ?? `keep-awake-tag-${++tagCounter}`;
   // Setup body scope: it runs once per instance, so one attachment spans the single
   // onMounted/onUnmounted pair - no need to re-create it on the mount hook.
-  const attachment = createKeepAwakeListenerAttachment(tagOrDefault, options?.listener);
+  const attachment = createKeepAwakeListenerAttachment(
+    tagOrDefault,
+    options?.listener,
+  );
 
   onMounted(() => {
     activateKeepAwakeAsync(tagOrDefault)