@symbiote-native/keep-awake 0.1.0 → 0.2.0

package/build/angular/index.d.ts

@@ -1,2 +1,2 @@
 export { KeepAwakeService } from './services/keep-awake.service';
-export { ExpoKeepAwakeTag, isAvailableAsync, activateKeepAwakeAsync, deactivateKeepAwake, addListener, type KeepAwakeEvent, type KeepAwakeListener, type KeepAwakeOptions, type EventSubscription, } from '../core';
+export * from '../core';

package/build/angular/index.js

@@ -1,4 +1,4 @@
 // KeepAwakeService is the Angular-only lifecycle half; the free functions and event
 // subscription plumbing all live in core, shared with React/Vue.
 export { KeepAwakeService } from './services/keep-awake.service/index.js';
-export { ExpoKeepAwakeTag, isAvailableAsync, activateKeepAwakeAsync, deactivateKeepAwake, addListener, } from '../core/index.js';
+export * from '../core/index.js';

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

@@ -33,7 +33,8 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
     return useValue ? value : void 0;
 };
 import { effect, inject, Injectable, Injector } from '@angular/core';
-import { activateKeepAwakeAsync, addListener, 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
 // wiring, but keep-awake has no value to surface as a Signal since it's a pure side effect for
@@ -60,14 +61,14 @@ let KeepAwakeService = (() => {
         connect(tag, options) {
             const tagOrDefault = tag ?? `keep-awake-tag-${++tagCounter}`;
             effect(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);
                 activateKeepAwakeAsync(tagOrDefault)
-                    .then(() => {
-                    if (options?.listener) {
-                        addListener(tagOrDefault, options.listener);
-                    }
-                })
+                    .then(() => attachment.attach())
                     .catch(() => { });
                 onCleanup(() => {
+                    attachment.release();
                     if (options?.suppressDeactivateWarnings) {
                         deactivateKeepAwake(tagOrDefault).catch(() => { });
                     }

package/build/core/listener-attachment.d.ts

@@ -0,0 +1,8 @@
+import type { KeepAwakeListener } from './types';
+export type IKeepAwakeListenerAttachment = {
+    /** Registers the listener for `tag`. A no-op once `release` has run, or with no listener. */
+    attach: () => void;
+    /** Cancels a not-yet-run `attach` and removes the subscription if one was already registered. */
+    release: () => void;
+};
+export declare function createKeepAwakeListenerAttachment(tag: string, listener?: KeepAwakeListener): IKeepAwakeListenerAttachment;

package/build/core/listener-attachment.js

@@ -0,0 +1,18 @@
+import { addListener } from './keep-awake.js';
+export function createKeepAwakeListenerAttachment(tag, listener) {
+    let isReleased = false;
+    let subscription;
+    return {
+        attach: () => {
+            if (isReleased || !listener) {
+                return;
+            }
+            subscription = addListener(tag, listener);
+        },
+        release: () => {
+            isReleased = true;
+            subscription?.remove();
+            subscription = undefined;
+        },
+    };
+}

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

@@ -1,29 +1,26 @@
-// React lifecycle wiring over the framework-agnostic core (core/keep-awake.ts) — activates on
-// mount, deactivates on unmount, mirroring upstream's own useKeepAwake. Uses React's useId for
-// the default per-instance tag exactly like upstream, so two components calling useKeepAwake()
-// concurrently without an explicit tag don't clobber each other's activation/deactivation.
+// React lifecycle wiring over the framework-agnostic core (core/keep-awake.ts): activates on
+// mount, deactivates on unmount, mirroring upstream's useKeepAwake. Uses React's useId for the
+// default per-instance tag so concurrent callers without an explicit tag don't clobber each
+// other's activation/deactivation.
 //
-// Upstream also checks the native module's own `addListenerForTag` presence directly before
-// calling `addListener`; that private module isn't reachable from here (only core's public API
-// is), so registering the listener just goes through the same promise chain — an
-// UnavailabilityError from `addListener` is swallowed by the trailing `.catch(() => {})` exactly
-// like a rejected `activateKeepAwakeAsync`, same net effect as upstream's own guard.
+// Upstream guards `addListener` by checking the native module's `addListenerForTag` directly;
+// 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, addListener, 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();
     const tagOrDefault = tag ?? defaultTag;
     useEffect(() => {
-        let isMounted = true;
+        // 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);
         activateKeepAwakeAsync(tagOrDefault)
-            .then(() => {
-            if (isMounted && options?.listener) {
-                addListener(tagOrDefault, options.listener);
-            }
-        })
+            .then(() => attachment.attach())
             .catch(() => { });
         return () => {
-            isMounted = false;
+            attachment.release();
             if (options?.suppressDeactivateWarnings) {
                 deactivateKeepAwake(tagOrDefault).catch(() => { });
             }

package/build/react/index.d.ts

@@ -1,2 +1,2 @@
 export { useKeepAwake } from './hooks/use-keep-awake';
-export { ExpoKeepAwakeTag, isAvailableAsync, activateKeepAwakeAsync, deactivateKeepAwake, addListener, type KeepAwakeEvent, type KeepAwakeListener, type KeepAwakeOptions, type EventSubscription, } from '../core';
+export * from '../core';

package/build/react/index.js

@@ -2,4 +2,4 @@
 // lifecycle bucket is `hooks/` (never `composables/`, that's Vue's term) — see
 // adapters/react/src/hooks for the same convention.
 export { useKeepAwake } from './hooks/use-keep-awake/index.js';
-export { ExpoKeepAwakeTag, isAvailableAsync, activateKeepAwakeAsync, deactivateKeepAwake, addListener, } from '../core/index.js';
+export * from '../core/index.js';

package/build/svelte/index.d.ts

@@ -0,0 +1,2 @@
+export { useKeepAwake } from './runes/use-keep-awake.svelte';
+export * from '../core';

package/build/svelte/index.js

@@ -0,0 +1,5 @@
+// @symbiote-native/keep-awake/svelte: the Svelte entry over the framework-agnostic core. The
+// lifecycle bucket is `runes/` (never `hooks/`/`composables/`, those are React's and Vue's terms)
+// — see adapters/svelte/src/runes for the same convention.
+export { useKeepAwake } from './runes/use-keep-awake.svelte';
+export * from '../core/index.js';

package/build/svelte/runes/use-keep-awake.svelte.d.ts

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

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

@@ -0,0 +1,37 @@
+// Svelte lifecycle wiring over the framework-agnostic core (core/keep-awake.ts): activates on
+// mount, deactivates on unmount, mirroring React's hook and Vue's composable.
+//
+// `.svelte.ts` extension: `$effect` only works there outside a `.svelte` component. `runes/` is
+// Svelte's name for what React calls `hooks/` and Vue calls `composables/`.
+//
+// The effect reads no reactive state, so it fires once per mount (its return value is the
+// teardown) - same once-per-mount contract as Vue's composable, unlike React's hook, which
+// re-runs when `tagOrDefault` changes.
+//
+// `tag`/`options` are plain values, not getters, because the `<script>` body (like Vue's setup)
+// runs once - nothing here re-reads them.
+//
+// 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 { createKeepAwakeListenerAttachment } from '../../core/listener-attachment.js';
+let tagCounter = 0;
+export function useKeepAwake(tag, options) {
+    const tagOrDefault = tag ?? `keep-awake-tag-${++tagCounter}`;
+    $effect(() => {
+        // Inside the effect, so the attachment shares the teardown returned below.
+        const attachment = createKeepAwakeListenerAttachment(tagOrDefault, options?.listener);
+        activateKeepAwakeAsync(tagOrDefault)
+            .then(() => attachment.attach())
+            .catch(() => { });
+        return () => {
+            attachment.release();
+            if (options?.suppressDeactivateWarnings) {
+                deactivateKeepAwake(tagOrDefault).catch(() => { });
+            }
+            else {
+                deactivateKeepAwake(tagOrDefault);
+            }
+        };
+    });
+}

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

@@ -4,20 +4,21 @@
 // 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, addListener, 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) {
     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);
     onMounted(() => {
         activateKeepAwakeAsync(tagOrDefault)
-            .then(() => {
-            if (options?.listener) {
-                addListener(tagOrDefault, options.listener);
-            }
-        })
+            .then(() => attachment.attach())
             .catch(() => { });
     });
     onUnmounted(() => {
+        attachment.release();
         if (options?.suppressDeactivateWarnings) {
             deactivateKeepAwake(tagOrDefault).catch(() => { });
         }

package/build/vue/index.d.ts

@@ -1,2 +1,2 @@
 export { useKeepAwake } from './composables/use-keep-awake';
-export { ExpoKeepAwakeTag, isAvailableAsync, activateKeepAwakeAsync, deactivateKeepAwake, addListener, type KeepAwakeEvent, type KeepAwakeListener, type KeepAwakeOptions, type EventSubscription, } from '../core';
+export * from '../core';

package/build/vue/index.js

@@ -2,4 +2,4 @@
 // lifecycle bucket is `composables/` (never `hooks/`, that's React's term) — see
 // adapters/vue/src/composables for the same convention.
 export { useKeepAwake } from './composables/use-keep-awake/index.js';
-export { ExpoKeepAwakeTag, isAvailableAsync, activateKeepAwakeAsync, deactivateKeepAwake, addListener, } from '../core/index.js';
+export * from '../core/index.js';

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

@@ -1,2 +1,2 @@
 export { KeepAwakeService } from './services/keep-awake.service';
-export { ExpoKeepAwakeTag, isAvailableAsync, activateKeepAwakeAsync, deactivateKeepAwake, addListener, type KeepAwakeEvent, type KeepAwakeListener, type KeepAwakeOptions, type EventSubscription, } from '../core';
+export * from '../core';

package/build-ngc/angular/index.js

@@ -1,5 +1,5 @@
 // KeepAwakeService is the Angular-only lifecycle half; the free functions and event
 // subscription plumbing all live in core, shared with React/Vue.
 export { KeepAwakeService } from './services/keep-awake.service';
-export { ExpoKeepAwakeTag, isAvailableAsync, activateKeepAwakeAsync, deactivateKeepAwake, addListener, } from '../core';
+export * from '../core';
 //# sourceMappingURL=index.js.map

package/build-ngc/angular/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/angular/index.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,iEAAiE;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,WAAW,GAKZ,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/angular/index.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,iEAAiE;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,cAAc,SAAS,CAAC"}

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

@@ -1,5 +1,6 @@
 import { effect, inject, Injectable, Injector } from '@angular/core';
-import { activateKeepAwakeAsync, addListener, 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
 // LowPowerModeService (packages/battery) for the `connect()`/`effect()` pattern rationale — same
@@ -14,14 +15,14 @@ export class KeepAwakeService {
     connect(tag, options) {
         const tagOrDefault = tag ?? `keep-awake-tag-${++tagCounter}`;
         effect(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);
             activateKeepAwakeAsync(tagOrDefault)
-                .then(() => {
-                if (options?.listener) {
-                    addListener(tagOrDefault, options.listener);
-                }
-            })
+                .then(() => attachment.attach())
                 .catch(() => { });
             onCleanup(() => {
+                attachment.release();
                 if (options?.suppressDeactivateWarnings) {
                     deactivateKeepAwake(tagOrDefault).catch(() => { });
                 }
@@ -31,10 +32,10 @@ export class KeepAwakeService {
             });
         }, { injector: this.injector });
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.5", ngImport: i0, type: KeepAwakeService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.5", ngImport: i0, type: KeepAwakeService, providedIn: 'root' });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: KeepAwakeService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: KeepAwakeService, providedIn: 'root' });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.5", ngImport: i0, type: KeepAwakeService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: KeepAwakeService, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });

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,EACL,sBAAsB,EACtB,WAAW,EACX,mBAAmB,GAEpB,MAAM,eAAe,CAAC;;AAEvB,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,sBAAsB,CAAC,YAAY,CAAC;iBACjC,IAAI,CAAC,GAAG,EAAE;gBACT,IAAI,OAAO,EAAE,QAAQ,EAAE,CAAC;oBACtB,WAAW,CAAC,YAAY,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAC9C,CAAC;YACH,CAAC,CAAC;iBACD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAEnB,SAAS,CAAC,GAAG,EAAE;gBACb,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;uGA1BU,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,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"}

package/build-ngc/core/listener-attachment.d.ts

@@ -0,0 +1,8 @@
+import type { KeepAwakeListener } from './types';
+export type IKeepAwakeListenerAttachment = {
+    /** Registers the listener for `tag`. A no-op once `release` has run, or with no listener. */
+    attach: () => void;
+    /** Cancels a not-yet-run `attach` and removes the subscription if one was already registered. */
+    release: () => void;
+};
+export declare function createKeepAwakeListenerAttachment(tag: string, listener?: KeepAwakeListener): IKeepAwakeListenerAttachment;

package/build-ngc/core/listener-attachment.js

@@ -0,0 +1,19 @@
+import { addListener } from './keep-awake';
+export function createKeepAwakeListenerAttachment(tag, listener) {
+    let isReleased = false;
+    let subscription;
+    return {
+        attach: () => {
+            if (isReleased || !listener) {
+                return;
+            }
+            subscription = addListener(tag, listener);
+        },
+        release: () => {
+            isReleased = true;
+            subscription?.remove();
+            subscription = undefined;
+        },
+    };
+}
+//# sourceMappingURL=listener-attachment.js.map

package/build-ngc/core/listener-attachment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listener-attachment.js","sourceRoot":"","sources":["../../src/core/listener-attachment.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAU3C,MAAM,UAAU,iCAAiC,CAC/C,GAAW,EACX,QAA4B;IAE5B,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,YAA2C,CAAC;IAEhD,OAAO;QACL,MAAM,EAAE,GAAG,EAAE;YACX,IAAI,UAAU,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC5B,OAAO;YACT,CAAC;YACD,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,EAAE,GAAG,EAAE;YACZ,UAAU,GAAG,IAAI,CAAC;YAClB,YAAY,EAAE,MAAM,EAAE,CAAC;YACvB,YAAY,GAAG,SAAS,CAAC;QAC3B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@symbiote-native/keep-awake",
-  "version": "0.1.0",
+  "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.",
   "license": "MIT",
   "repository": {
@@ -30,6 +30,10 @@
       "types": "./build/react/index.d.ts",
       "default": "./build/react/index.js"
     },
+    "./svelte": {
+      "types": "./build/svelte/index.d.ts",
+      "default": "./build/svelte/index.js"
+    },
     "./angular": {
       "types": "./build-ngc/angular/index.d.ts",
       "react-native": "./build-ngc/angular/index.js",
@@ -53,15 +57,17 @@
     "expo-modules-core": "57.0.5"
   },
   "peerDependencies": {
+    "@symbiote-native/angular": ">=0.6.2",
     "@symbiote-native/engine": ">=0.1.7",
+    "@symbiote-native/react": ">=0.2.8",
+    "@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",
-    "vue": ">=3.5.0",
-    "@symbiote-native/angular": "0.6.2",
-    "@symbiote-native/react": "0.2.8",
-    "@symbiote-native/vue": "0.3.8"
+    "svelte": ">=5.56.0",
+    "vue": ">=3.5.0"
   },
   "peerDependenciesMeta": {
     "@symbiote-native/angular": {
@@ -70,6 +76,9 @@
     "@symbiote-native/react": {
       "optional": true
     },
+    "@symbiote-native/svelte": {
+      "optional": true
+    },
     "@symbiote-native/vue": {
       "optional": true
     },
@@ -82,24 +91,29 @@
     "react": {
       "optional": true
     },
+    "svelte": {
+      "optional": true
+    },
     "vue": {
       "optional": true
     }
   },
   "devDependencies": {
-    "@angular/compiler": "^22",
-    "@angular/compiler-cli": "^22",
-    "@angular/core": "^22",
+    "@angular/compiler": "~22.0.8",
+    "@angular/compiler-cli": "~22.0.8",
+    "@angular/core": "~22.0.8",
     "@types/node": "^26.0.0",
     "@types/react": "^19.2.0",
     "@vue/runtime-core": "^3.5.13",
     "react": "19.2.3",
+    "svelte": "^5.56.0",
     "typescript": "~6.0.0",
-    "@symbiote-native/angular": "0.6.2",
-    "@symbiote-native/engine": "0.1.7",
-    "@symbiote-native/react": "0.2.8",
+    "@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.3.8"
+    "@symbiote-native/vue": "0.4.0"
   },
   "scripts": {
     "typecheck": "tsc --build",

package/src/angular/index.ts

@@ -1,14 +1,4 @@
 // KeepAwakeService is the Angular-only lifecycle half; the free functions and event
 // subscription plumbing all live in core, shared with React/Vue.
 export { KeepAwakeService } from './services/keep-awake.service';
-export {
-  ExpoKeepAwakeTag,
-  isAvailableAsync,
-  activateKeepAwakeAsync,
-  deactivateKeepAwake,
-  addListener,
-  type KeepAwakeEvent,
-  type KeepAwakeListener,
-  type KeepAwakeOptions,
-  type EventSubscription,
-} from '../core';
+export * from '../core';

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

@@ -1,10 +1,6 @@
 import { effect, inject, Injectable, Injector } from '@angular/core';
-import {
-  activateKeepAwakeAsync,
-  addListener,
-  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
 // LowPowerModeService (packages/battery) for the `connect()`/`effect()` pattern rationale — same
@@ -24,15 +20,16 @@ export class KeepAwakeService {
 
     effect(
       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);
+
         activateKeepAwakeAsync(tagOrDefault)
-          .then(() => {
-            if (options?.listener) {
-              addListener(tagOrDefault, options.listener);
-            }
-          })
+          .then(() => attachment.attach())
           .catch(() => {});
 
         onCleanup(() => {
+          attachment.release();
           if (options?.suppressDeactivateWarnings) {
             deactivateKeepAwake(tagOrDefault).catch(() => {});
           } else {

package/src/core/listener-attachment.ts

@@ -0,0 +1,43 @@
+// The listener half of a keep-awake session, plus the teardown race that comes with it:
+// activation is async, so the consumer can be gone by the time it resolves. Whoever tears down
+// first has to do two things - cancel an attach that hasn't run yet, AND remove a subscription
+// that already landed. Miss either and the listener outlives the consumer with nothing left
+// holding a reference to remove it.
+//
+// It lives here rather than in each adapter because the flag-plus-subscription bookkeeping is
+// identical in all four; only WHERE attach/release get called differs (useEffect cleanup,
+// onUnmounted, effect's onCleanup, $effect teardown). Deliberately NOT re-exported from
+// core/index.ts - every framework entry does `export * from '../core'`, and this is lifecycle
+// plumbing for the adapters, not public API.
+import type { EventSubscription } from 'expo-modules-core';
+import { addListener } from './keep-awake';
+import type { KeepAwakeListener } from './types';
+
+export type IKeepAwakeListenerAttachment = {
+  /** Registers the listener for `tag`. A no-op once `release` has run, or with no listener. */
+  attach: () => void;
+  /** Cancels a not-yet-run `attach` and removes the subscription if one was already registered. */
+  release: () => void;
+};
+
+export function createKeepAwakeListenerAttachment(
+  tag: string,
+  listener?: KeepAwakeListener,
+): IKeepAwakeListenerAttachment {
+  let isReleased = false;
+  let subscription: EventSubscription | undefined;
+
+  return {
+    attach: () => {
+      if (isReleased || !listener) {
+        return;
+      }
+      subscription = addListener(tag, listener);
+    },
+    release: () => {
+      isReleased = true;
+      subscription?.remove();
+      subscription = undefined;
+    },
+  };
+}

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

@@ -1,38 +1,30 @@
-// React lifecycle wiring over the framework-agnostic core (core/keep-awake.ts) — activates on
-// mount, deactivates on unmount, mirroring upstream's own useKeepAwake. Uses React's useId for
-// the default per-instance tag exactly like upstream, so two components calling useKeepAwake()
-// concurrently without an explicit tag don't clobber each other's activation/deactivation.
+// React lifecycle wiring over the framework-agnostic core (core/keep-awake.ts): activates on
+// mount, deactivates on unmount, mirroring upstream's useKeepAwake. Uses React's useId for the
+// default per-instance tag so concurrent callers without an explicit tag don't clobber each
+// other's activation/deactivation.
 //
-// Upstream also checks the native module's own `addListenerForTag` presence directly before
-// calling `addListener`; that private module isn't reachable from here (only core's public API
-// is), so registering the listener just goes through the same promise chain — an
-// UnavailabilityError from `addListener` is swallowed by the trailing `.catch(() => {})` exactly
-// like a rejected `activateKeepAwakeAsync`, same net effect as upstream's own guard.
+// Upstream guards `addListener` by checking the native module's `addListenerForTag` directly;
+// 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,
-  addListener,
-  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 {
   const defaultTag = useId();
   const tagOrDefault = tag ?? defaultTag;
 
   useEffect(() => {
-    let isMounted = true;
+    // 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);
 
     activateKeepAwakeAsync(tagOrDefault)
-      .then(() => {
-        if (isMounted && options?.listener) {
-          addListener(tagOrDefault, options.listener);
-        }
-      })
+      .then(() => attachment.attach())
       .catch(() => {});
 
     return () => {
-      isMounted = false;
+      attachment.release();
       if (options?.suppressDeactivateWarnings) {
         deactivateKeepAwake(tagOrDefault).catch(() => {});
       } else {

package/src/react/index.ts

@@ -3,14 +3,4 @@
 // adapters/react/src/hooks for the same convention.
 
 export { useKeepAwake } from './hooks/use-keep-awake';
-export {
-  ExpoKeepAwakeTag,
-  isAvailableAsync,
-  activateKeepAwakeAsync,
-  deactivateKeepAwake,
-  addListener,
-  type KeepAwakeEvent,
-  type KeepAwakeListener,
-  type KeepAwakeOptions,
-  type EventSubscription,
-} from '../core';
+export * from '../core';

package/src/svelte/index.ts

@@ -0,0 +1,6 @@
+// @symbiote-native/keep-awake/svelte: the Svelte entry over the framework-agnostic core. The
+// lifecycle bucket is `runes/` (never `hooks/`/`composables/`, those are React's and Vue's terms)
+// — see adapters/svelte/src/runes for the same convention.
+
+export { useKeepAwake } from './runes/use-keep-awake.svelte';
+export * from '../core';

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

@@ -0,0 +1,41 @@
+// Svelte lifecycle wiring over the framework-agnostic core (core/keep-awake.ts): activates on
+// mount, deactivates on unmount, mirroring React's hook and Vue's composable.
+//
+// `.svelte.ts` extension: `$effect` only works there outside a `.svelte` component. `runes/` is
+// Svelte's name for what React calls `hooks/` and Vue calls `composables/`.
+//
+// The effect reads no reactive state, so it fires once per mount (its return value is the
+// teardown) - same once-per-mount contract as Vue's composable, unlike React's hook, which
+// re-runs when `tagOrDefault` changes.
+//
+// `tag`/`options` are plain values, not getters, because the `<script>` body (like Vue's setup)
+// runs once - nothing here re-reads them.
+//
+// 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 { createKeepAwakeListenerAttachment } from '../../core/listener-attachment';
+
+let tagCounter = 0;
+
+export function useKeepAwake(tag?: string, options?: KeepAwakeOptions): void {
+  const tagOrDefault = tag ?? `keep-awake-tag-${++tagCounter}`;
+
+  $effect(() => {
+    // Inside the effect, so the attachment shares the teardown returned below.
+    const attachment = createKeepAwakeListenerAttachment(tagOrDefault, options?.listener);
+
+    activateKeepAwakeAsync(tagOrDefault)
+      .then(() => attachment.attach())
+      .catch(() => {});
+
+    return () => {
+      attachment.release();
+      if (options?.suppressDeactivateWarnings) {
+        deactivateKeepAwake(tagOrDefault).catch(() => {});
+      } else {
+        deactivateKeepAwake(tagOrDefault);
+      }
+    };
+  });
+}

package/src/svelte/svelte-ambient.d.ts

@@ -0,0 +1,6 @@
+// Pulls in svelte's ambient global declarations ($state/$effect/...) for this package's tsc
+// program. adapters/svelte gets these for free because render.ts does a real value import from
+// 'svelte' (any file in a program importing a module loads its ambient globals for the whole
+// program); this package has no such import, so a triple-slash reference does the same job
+// explicitly rather than relying on an incidental side-effect.
+/// <reference types="svelte" />

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

@@ -4,29 +4,25 @@
 // 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,
-  addListener,
-  deactivateKeepAwake,
-  type KeepAwakeOptions,
-} from '../../../core';
+import { activateKeepAwakeAsync, deactivateKeepAwake, type KeepAwakeOptions } from '../../../core';
+import { createKeepAwakeListenerAttachment } from '../../../core/listener-attachment';
 
 let tagCounter = 0;
 
 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);
 
   onMounted(() => {
     activateKeepAwakeAsync(tagOrDefault)
-      .then(() => {
-        if (options?.listener) {
-          addListener(tagOrDefault, options.listener);
-        }
-      })
+      .then(() => attachment.attach())
       .catch(() => {});
   });
 
   onUnmounted(() => {
+    attachment.release();
     if (options?.suppressDeactivateWarnings) {
       deactivateKeepAwake(tagOrDefault).catch(() => {});
     } else {

package/src/vue/index.ts

@@ -3,14 +3,4 @@
 // adapters/vue/src/composables for the same convention.
 
 export { useKeepAwake } from './composables/use-keep-awake';
-export {
-  ExpoKeepAwakeTag,
-  isAvailableAsync,
-  activateKeepAwakeAsync,
-  deactivateKeepAwake,
-  addListener,
-  type KeepAwakeEvent,
-  type KeepAwakeListener,
-  type KeepAwakeOptions,
-  type EventSubscription,
-} from '../core';
+export * from '../core';