@symbiote-native/brightness 0.2.0 → 0.3.0

package/README.md

@@ -3,8 +3,8 @@
 A wrapper package for [SymbioteNative](../../README.md) that makes
 [`expo-brightness`](https://github.com/expo/expo/tree/main/packages/expo-brightness) — screen
 brightness get/set, Android-only system-brightness-mode control, an iOS-only brightness-change
-listener, and permission get/request — usable from **every** adapter, React, Vue, and Angular, not
-just React. Unlike [`@symbiote-native/sensors`](../sensors) — a `DeviceSensor` class per instance,
+listener, and permission get/request — usable from **every** adapter: React, Vue, Svelte, Solid,
+and Angular, not just React. Unlike [`@symbiote-native/sensors`](../sensors) — a `DeviceSensor` class per instance,
 subscribed through a hook/composable/service — this package's surface is mostly stateless free
 async functions plus one listener; only the permission surface gets its own lifecycle hook/
 composable/service, mirroring upstream's own `usePermissions`. Built the same way as
@@ -31,13 +31,13 @@ Unlike a plain RN native module, `expo-brightness`'s native code is discovered b
 this repo use — this needs wiring into the native host app **once**, covering this package and
 every other `expo-modules-core` package 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) |
-| Android | `AndroidManifest.xml` — `android.permission.WRITE_SETTINGS`, required to set the system-wide brightness (`setSystemBrightnessAsync`/`setSystemBrightnessModeAsync`) |
+| 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)                 |
+| Android  | `AndroidManifest.xml` — `android.permission.WRITE_SETTINGS`, required to set the system-wide brightness (`setSystemBrightnessAsync`/`setSystemBrightnessModeAsync`) |
 
 Full mechanics — the Podfile pieces that normally ship inside the `expo` package, the `expo`
 peer-dependency exclusion list — live in the `symbiote-expo-native-module` skill. Reference
@@ -55,14 +55,17 @@ src/core/                 isAvailableAsync, get/setBrightnessAsync, the Android-
                           ExpoBrightness through expo-modules-core's requireNativeModule.
 src/react/hooks/           @symbiote-native/brightness/react   — usePermissions
 src/vue/composables/       @symbiote-native/brightness/vue     — usePermissions (same name)
+src/svelte/runes/          @symbiote-native/brightness/svelte  — usePermissions (same name)
+src/solid/primitives/      @symbiote-native/brightness/solid   — createPermissions (Solid says
+                                                                 create*, not use*)
 src/angular/services/      @symbiote-native/brightness/angular — PermissionsService
 ```
 
 Each adapter's hook/composable/service wraps the same one-shot `getPermissionsAsync`/
 `requestPermissionsAsync` pair in its own lifecycle idiom (auto-fetch on mount, exposed as a
-tuple/object/signal). Every other export — brightness get/set, the system-brightness-mode surface,
-the listener — is a stateless free-function re-export, written once in `core/` and shared verbatim
-by all three adapters.
+tuple/object/accessor/signal). Every other export — brightness get/set, the system-brightness-mode
+surface, the listener — is a stateless free-function re-export, written once in `core/` and shared
+verbatim by every adapter.
 
 ## Use it
 
@@ -84,13 +87,17 @@ function BrightnessScreen() {
   useEffect(() => {
     getBrightnessAsync().then(setBrightness);
     // iOS only — never fires on Android, so there the value only changes via setBrightnessAsync.
-    const subscription = addBrightnessListener(event => setBrightness(event.brightness));
+    const subscription = addBrightnessListener(event =>
+      setBrightness(event.brightness),
+    );
     return () => subscription.remove();
   }, []);
 
   return (
     <View>
-      <Text>{brightness === null ? 'checking…' : `${Math.round(brightness * 100)}%`}</Text>
+      <Text>
+        {brightness === null ? 'checking…' : `${Math.round(brightness * 100)}%`}
+      </Text>
       <Pressable onPress={() => setBrightnessAsync(0.5)}>
         <Text>Set to 50%</Text>
       </Pressable>
@@ -117,20 +124,25 @@ import {
 import { usePermissions } from '@symbiote-native/brightness/vue';
 
 const brightness = ref<number | null>(null);
-const { status: permissionStatus, request: requestPermission } = usePermissions();
+const { status: permissionStatus, request: requestPermission } =
+  usePermissions();
 
 let subscription: EventSubscription | undefined;
 
 onMounted(() => {
   void getBrightnessAsync().then(value => (brightness.value = value));
-  subscription = addBrightnessListener(event => (brightness.value = event.brightness));
+  subscription = addBrightnessListener(
+    event => (brightness.value = event.brightness),
+  );
 });
 onUnmounted(() => subscription?.remove());
 </script>
 
 <template>
   <View>
-    <Text>{{ brightness === null ? 'checking…' : `${Math.round(brightness * 100)}%` }}</Text>
+    <Text>{{
+      brightness === null ? 'checking…' : `${Math.round(brightness * 100)}%`
+    }}</Text>
     <Pressable @press="setBrightnessAsync(0.5)">
       <Text>Set to 50%</Text>
     </Pressable>
@@ -160,9 +172,13 @@ import {
   template: `
     <View>
       <Text>{{ brightnessLabel() }}</Text>
-      <Pressable (press)="setBrightnessAsync(0.5)"><Text>Set to 50%</Text></Pressable>
+      <Pressable (press)="setBrightnessAsync(0.5)"
+        ><Text>Set to 50%</Text></Pressable
+      >
       <Text>{{ permissionStatus()?.status ?? 'checking…' }}</Text>
-      <Pressable (press)="permissionsService.request()"><Text>Request permission</Text></Pressable>
+      <Pressable (press)="permissionsService.request()"
+        ><Text>Request permission</Text></Pressable
+      >
     </View>
   `,
 })
@@ -182,7 +198,9 @@ export class BrightnessScreen {
   }
 
   setBrightnessAsync(value: number): void {
-    setBrightnessAsync(value).then(() => getBrightnessAsync().then(result => this.brightness.set(result)));
+    setBrightnessAsync(value).then(() =>
+      getBrightnessAsync().then(result => this.brightness.set(result)),
+    );
   }
 }
 ```
@@ -230,18 +248,25 @@ Plus `BrightnessMode` (enum: `UNKNOWN`/`AUTOMATIC`/`MANUAL`), `BrightnessEvent`,
 verbatim from `expo-modules-core`, never the `expo` meta-package.
 
 ```ts
-import { getBrightnessAsync, setBrightnessAsync } from '@symbiote-native/brightness';
+import {
+  getBrightnessAsync,
+  setBrightnessAsync,
+} from '@symbiote-native/brightness';
 
 // framework-scoped entry points re-export the same free functions, plus a usePermissions
 // hook/composable/service:
 import { usePermissions } from '@symbiote-native/brightness/react';
 import { usePermissions } from '@symbiote-native/brightness/vue';
+import { usePermissions } from '@symbiote-native/brightness/svelte';
+import { createPermissions } from '@symbiote-native/brightness/solid';
 import { PermissionsService } from '@symbiote-native/brightness/angular';
 ```
 
-`usePermissions` (React/Vue) auto-fetches the current permission status on mount and returns a
-`[status, request, get]` tuple (React) / `{ status, request, get }` object (Vue); Angular's
-`PermissionsService.connect()` does the same, returning a readonly `Signal`:
+`usePermissions` (React/Vue/Svelte) auto-fetches the current permission status on mount and
+returns a `[status, request, get]` tuple (React) / a `{ status, request, get }` object (Vue refs,
+Svelte getters). Solid's `createPermissions` fetches synchronously from the primitive body and
+returns the same object with `status`/`error` as ACCESSORS; Angular's
+`PermissionsService.connect()` returns a readonly `Signal`:
 
 ```ts
 // React
@@ -250,6 +275,12 @@ const [status, request] = usePermissions();
 // Vue
 const { status, request } = usePermissions();
 
+// Svelte — a boxed getter, read as permissions.status
+const permissions = usePermissions();
+
+// Solid — accessors, so status() is what a tracked scope reads
+const { status, request } = createPermissions();
+
 // Angular
 readonly status = inject(PermissionsService).connect();
 ```
@@ -275,7 +306,8 @@ readonly status = inject(PermissionsService).connect();
 
 No Fabric/Descriptor angle at all — brightness is a pure async-function + listener + permission
 surface, never a view. Tests inject a fake native-module object in place of the real
-`requireNativeModule` resolution (`src/core/*.test.ts`, `src/{react,vue,angular}/**/*.test.{ts,tsx}`,
+`requireNativeModule` resolution (`src/core/*.test.ts`,
+`src/{react,vue,svelte,solid,angular}/**/*.test.{ts,tsx}`,
 `vitest`), the same pattern `expo-brightness` itself uses upstream — no `installFabric()`, no
 ViewConfig. Native rendering itself is verified on-device (see the parent
 [README](../../README.md) for the project's testing model).

package/build/core/brightness.js

@@ -4,7 +4,7 @@
 // native module, so those branches are preserved verbatim rather than guessed.
 import { Platform, UnavailabilityError } from 'expo-modules-core';
 import { expoBrightness } from './native-module.js';
-import { BrightnessMode } from './types.js';
+import { BrightnessMode, } from './types.js';
 const NATIVE_MODULE_NAME = 'expo-brightness';
 function clampBrightness(brightnessValue, callerName) {
     const clamped = Math.max(0, Math.min(brightnessValue, 1));

package/build/solid/index.d.ts

@@ -0,0 +1,2 @@
+export { createPermissions } from './primitives/create-permissions';
+export * from '../core';

package/build/solid/index.js

@@ -0,0 +1,7 @@
+// @symbiote-native/brightness/solid: the Solid entry over the framework-agnostic core, plus
+// createPermissions — the only stateful surface this package needs a lifecycle wrapper for. 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 { createPermissions } from './primitives/create-permissions.js';
+export * from '../core/index.js';

package/build/solid/primitives/create-permissions.d.ts

@@ -0,0 +1,8 @@
+import { type Accessor } from 'solid-js';
+import { type PermissionResponse } from '../../core';
+export declare function createPermissions(): {
+    status: Accessor<PermissionResponse | null>;
+    error: Accessor<Error | null>;
+    request: () => Promise<PermissionResponse>;
+    get: () => Promise<PermissionResponse>;
+};

package/build/solid/primitives/create-permissions.js

@@ -0,0 +1,55 @@
+// Solid lifecycle wiring over the framework-agnostic core (core/brightness.ts) — the Solid twin of
+// React's usePermissions hook, Vue's composable, Svelte's rune and Angular's PermissionsService.
+//
+// `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.
+//
+// Returns ACCESSORS, never a snapshot: a Solid component body runs ONCE, so a plain returned value
+// would freeze at "not fetched yet" and never move again.
+//
+// The initial fetch is fired SYNCHRONOUSLY from the primitive body rather than from a mount hook
+// (React's useEffect, Vue's onMounted, Svelte's $effect) — same reason create-color-scheme
+// subscribes synchronously: nothing can interleave between construction and the fetch starting, so
+// there is no window in which a consumer sees a primitive that has not asked for status yet.
+//
+// That fetch has nobody to reject to, so its failure lands in `error` instead of escaping as an
+// unhandled rejection: a null status with a non-null error is how a consumer tells "the fetch
+// failed" from "not fetched yet". get()/request() still reject to their direct caller — only the
+// automatic call is made safe.
+//
+// `onCleanup` drops the writes of a call still in flight when the owner is disposed — the Solid
+// equivalent of React's isMounted ref. Outside a component / createRoot there is no owner to hang
+// it on, so those late writes land instead (harmless: nothing reads a disposed signal).
+import { createSignal, onCleanup } from 'solid-js';
+import { getPermissionsAsync, requestPermissionsAsync, } from '../../core/index.js';
+export function createPermissions() {
+    const [status, setStatus] = createSignal(null);
+    const [error, setError] = createSignal(null);
+    let isDisposed = false;
+    const record = (response) => {
+        if (isDisposed)
+            return;
+        setStatus(response);
+        setError(null);
+    };
+    const get = async () => {
+        const response = await getPermissionsAsync();
+        record(response);
+        return response;
+    };
+    const request = async () => {
+        const response = await requestPermissionsAsync();
+        record(response);
+        return response;
+    };
+    get().catch((cause) => {
+        if (isDisposed)
+            return;
+        setError(cause instanceof Error ? cause : new Error(String(cause)));
+    });
+    onCleanup(() => {
+        isDisposed = true;
+    });
+    return { status, error, request, get };
+}

package/build/svelte/runes/use-permissions.svelte.js

@@ -19,7 +19,7 @@
 // same reason as `status`) instead of escaping as an unhandled rejection: a null status with a
 // non-null error is how a consumer tells "the fetch failed" from "not fetched yet".
 // get()/request() still reject to their direct caller — only the automatic call is made safe.
-import { getPermissionsAsync, requestPermissionsAsync } from '../../core/index.js';
+import { getPermissionsAsync, requestPermissionsAsync, } from '../../core/index.js';
 export function usePermissions() {
     let status = $state(null);
     let error = $state(null);

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/angular/services/permissions.service/index.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,4FAA4F;AAC5F,yFAAyF;AACzF,+BAA+B;AAC/B,EAAE;AACF,4DAA4D;AAC5D,yCAAyC;AACzC,EAAE;AACF,gGAAgG;AAChG,kGAAkG;AAClG,mGAAmG;AACnG,wCAAwC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAe,MAAM,eAAe,CAAC;AAChE,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GAExB,MAAM,eAAe,CAAC;;AAGvB,MAAM,OAAO,kBAAkB;IACZ,MAAM,GAAG,MAAM,CAA4B,IAAI;+EAAC,CAAC;IACjD,UAAU,GAAG,MAAM,CAAe,IAAI;mFAAC,CAAC;IACjD,kBAAkB,GAAG,KAAK,CAAC;IAEnC,gGAAgG;IACvF,KAAK,GAAyB,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;IAEpE,OAAO;QACL,wFAAwF;QACxF,8FAA8F;QAC9F,8FAA8F;QAC9F,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC7B,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;YAC/B,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBAClC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACjF,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,GAAG;QACP,MAAM,QAAQ,GAAG,MAAM,mBAAmB,EAAE,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,QAAQ,GAAG,MAAM,uBAAuB,EAAE,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1B,OAAO,QAAQ,CAAC;IAClB,CAAC;uGAjCU,kBAAkB;2GAAlB,kBAAkB,cADL,MAAM;;2FACnB,kBAAkB;kBAD9B,UAAU;mBAAC,EAAE,UAAU,EAAE,MAAM,EAAE"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/angular/services/permissions.service/index.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,4FAA4F;AAC5F,yFAAyF;AACzF,+BAA+B;AAC/B,EAAE;AACF,4DAA4D;AAC5D,yCAAyC;AACzC,EAAE;AACF,gGAAgG;AAChG,kGAAkG;AAClG,mGAAmG;AACnG,wCAAwC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAe,MAAM,eAAe,CAAC;AAChE,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GAExB,MAAM,eAAe,CAAC;;AAGvB,MAAM,OAAO,kBAAkB;IACZ,MAAM,GAAG,MAAM,CAA4B,IAAI;+EAAC,CAAC;IACjD,UAAU,GAAG,MAAM,CAAe,IAAI;mFAAC,CAAC;IACjD,kBAAkB,GAAG,KAAK,CAAC;IAEnC,gGAAgG;IACvF,KAAK,GAAyB,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;IAEpE,OAAO;QACL,wFAAwF;QACxF,8FAA8F;QAC9F,8FAA8F;QAC9F,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC7B,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;YAC/B,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBAClC,IAAI,CAAC,UAAU,CAAC,GAAG,CACjB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAC1D,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,GAAG;QACP,MAAM,QAAQ,GAAG,MAAM,mBAAmB,EAAE,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,QAAQ,GAAG,MAAM,uBAAuB,EAAE,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1B,OAAO,QAAQ,CAAC;IAClB,CAAC;uGAnCU,kBAAkB;2GAAlB,kBAAkB,cADL,MAAM;;2FACnB,kBAAkB;kBAD9B,UAAU;mBAAC,EAAE,UAAU,EAAE,MAAM,EAAE"}

package/build-ngc/core/brightness.js

@@ -4,7 +4,7 @@
 // native module, so those branches are preserved verbatim rather than guessed.
 import { Platform, UnavailabilityError } from 'expo-modules-core';
 import { expoBrightness } from './native-module';
-import { BrightnessMode } from './types';
+import { BrightnessMode, } from './types';
 const NATIVE_MODULE_NAME = 'expo-brightness';
 function clampBrightness(brightnessValue, callerName) {
     const clamped = Math.max(0, Math.min(brightnessValue, 1));

package/build-ngc/core/brightness.js.map

@@ -1 +1 @@
-{"version":3,"file":"brightness.js","sourceRoot":"","sources":["../../src/core/brightness.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"brightness.js","sourceRoot":"","sources":["../../src/core/brightness.ts"],"names":[],"mappings":"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"}

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,gBAAgB,CAAC;AAyBrD,MAAM,CAAC,MAAM,cAAc,GAAG,mBAAmB,CAC/C,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;AAQxD,MAAM,2BAA2B,GAAG,gBAAgB,CAAC;AAyBrD,MAAM,CAAC,MAAM,cAAc,GAAG,mBAAmB,CAC/C,2BAA2B,CAC5B,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@symbiote-native/brightness",
-  "version": "0.2.0",
-  "description": "expo-brightness wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, and Angular adapters. Screen brightness get/set, Android-only system-brightness-mode control, an iOS-only brightness-change listener, and permission get/request.",
+  "version": "0.3.0",
+  "description": "expo-brightness wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, Svelte, Solid, and Angular adapters. Screen brightness get/set, Android-only system-brightness-mode control, an iOS-only brightness-change listener, and permission get/request.",
   "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/permissions.service/index.ts

@@ -33,7 +33,9 @@ export class PermissionsService {
     if (!this.isAutoFetchStarted) {
       this.isAutoFetchStarted = true;
       this.get().catch((cause: unknown) => {
-        this.fetchError.set(cause instanceof Error ? cause : new Error(String(cause)));
+        this.fetchError.set(
+          cause instanceof Error ? cause : new Error(String(cause)),
+        );
       });
     }
     return this.status.asReadonly();

package/src/core/brightness.ts

@@ -6,14 +6,20 @@ import { Platform, UnavailabilityError } from 'expo-modules-core';
 import type { EventSubscription } from 'expo-modules-core';
 
 import { expoBrightness } from './native-module';
-import { BrightnessMode, type BrightnessEvent, type PermissionResponse } from './types';
+import {
+  BrightnessMode,
+  type BrightnessEvent,
+  type PermissionResponse,
+} from './types';
 
 const NATIVE_MODULE_NAME = 'expo-brightness';
 
 function clampBrightness(brightnessValue: number, callerName: string): number {
   const clamped = Math.max(0, Math.min(brightnessValue, 1));
   if (Number.isNaN(clamped)) {
-    throw new TypeError(`${callerName} cannot be called with ${brightnessValue}`);
+    throw new TypeError(
+      `${callerName} cannot be called with ${brightnessValue}`,
+    );
   }
   return clamped;
 }
@@ -35,7 +41,9 @@ export async function getBrightnessAsync(): Promise<number> {
  * Sets the current screen brightness. On iOS this only affects the screen while the app is
  * foregrounded; on Android it persists until changed again.
  */
-export async function setBrightnessAsync(brightnessValue: number): Promise<void> {
+export async function setBrightnessAsync(
+  brightnessValue: number,
+): Promise<void> {
   const clamped = clampBrightness(brightnessValue, 'setBrightnessAsync');
   if (!expoBrightness.setBrightnessAsync) {
     throw new UnavailabilityError(NATIVE_MODULE_NAME, 'setBrightnessAsync');
@@ -53,7 +61,10 @@ export async function getSystemBrightnessAsync(): Promise<number> {
     return getBrightnessAsync();
   }
   if (!expoBrightness.getSystemBrightnessAsync) {
-    throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getSystemBrightnessAsync');
+    throw new UnavailabilityError(
+      NATIVE_MODULE_NAME,
+      'getSystemBrightnessAsync',
+    );
   }
   return expoBrightness.getSystemBrightnessAsync();
 }
@@ -63,13 +74,18 @@ export async function getSystemBrightnessAsync(): Promise<number> {
  * no separate system-level brightness to set.
  * @platform android
  */
-export async function setSystemBrightnessAsync(brightnessValue: number): Promise<void> {
+export async function setSystemBrightnessAsync(
+  brightnessValue: number,
+): Promise<void> {
   const clamped = clampBrightness(brightnessValue, 'setSystemBrightnessAsync');
   if (Platform.OS !== 'android') {
     return setBrightnessAsync(clamped);
   }
   if (!expoBrightness.setSystemBrightnessAsync) {
-    throw new UnavailabilityError(NATIVE_MODULE_NAME, 'setSystemBrightnessAsync');
+    throw new UnavailabilityError(
+      NATIVE_MODULE_NAME,
+      'setSystemBrightnessAsync',
+    );
   }
   await expoBrightness.setSystemBrightnessAsync(clamped);
 }
@@ -84,7 +100,10 @@ export async function restoreSystemBrightnessAsync(): Promise<void> {
     return;
   }
   if (!expoBrightness.restoreSystemBrightnessAsync) {
-    throw new UnavailabilityError(NATIVE_MODULE_NAME, 'restoreSystemBrightnessAsync');
+    throw new UnavailabilityError(
+      NATIVE_MODULE_NAME,
+      'restoreSystemBrightnessAsync',
+    );
   }
   await expoBrightness.restoreSystemBrightnessAsync();
 }
@@ -102,7 +121,10 @@ export async function isUsingSystemBrightnessAsync(): Promise<boolean> {
     return false;
   }
   if (!expoBrightness.isUsingSystemBrightnessAsync) {
-    throw new UnavailabilityError(NATIVE_MODULE_NAME, 'isUsingSystemBrightnessAsync');
+    throw new UnavailabilityError(
+      NATIVE_MODULE_NAME,
+      'isUsingSystemBrightnessAsync',
+    );
   }
   return expoBrightness.isUsingSystemBrightnessAsync();
 }
@@ -117,7 +139,10 @@ export async function getSystemBrightnessModeAsync(): Promise<BrightnessMode> {
     return BrightnessMode.UNKNOWN;
   }
   if (!expoBrightness.getSystemBrightnessModeAsync) {
-    throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getSystemBrightnessModeAsync');
+    throw new UnavailabilityError(
+      NATIVE_MODULE_NAME,
+      'getSystemBrightnessModeAsync',
+    );
   }
   return expoBrightness.getSystemBrightnessModeAsync();
 }
@@ -127,12 +152,17 @@ export async function getSystemBrightnessModeAsync(): Promise<BrightnessMode> {
  * when passed `BrightnessMode.UNKNOWN` (there is nothing meaningful to set it to).
  * @platform android
  */
-export async function setSystemBrightnessModeAsync(brightnessMode: BrightnessMode): Promise<void> {
+export async function setSystemBrightnessModeAsync(
+  brightnessMode: BrightnessMode,
+): Promise<void> {
   if (Platform.OS !== 'android' || brightnessMode === BrightnessMode.UNKNOWN) {
     return;
   }
   if (!expoBrightness.setSystemBrightnessModeAsync) {
-    throw new UnavailabilityError(NATIVE_MODULE_NAME, 'setSystemBrightnessModeAsync');
+    throw new UnavailabilityError(
+      NATIVE_MODULE_NAME,
+      'setSystemBrightnessModeAsync',
+    );
   }
   await expoBrightness.setSystemBrightnessModeAsync(brightnessMode);
 }

package/src/core/native-module.ts

@@ -1,6 +1,10 @@
 import { requireNativeModule } from 'expo-modules-core';
 import type { EventSubscription } from 'expo-modules-core';
-import type { BrightnessEvent, BrightnessMode, PermissionResponse } from './types';
+import type {
+  BrightnessEvent,
+  BrightnessMode,
+  PermissionResponse,
+} from './types';
 
 const EXPO_BRIGHTNESS_MODULE_NAME = 'ExpoBrightness';
 

package/src/react/hooks/use-permissions/index.ts

@@ -45,7 +45,8 @@ export function usePermissions(): [
   useEffect(() => {
     isMounted.current = true;
     getPermission().catch((cause: unknown) => {
-      if (isMounted.current) setError(cause instanceof Error ? cause : new Error(String(cause)));
+      if (isMounted.current)
+        setError(cause instanceof Error ? cause : new Error(String(cause)));
     });
     return () => {
       isMounted.current = false;

package/src/solid/index.ts

@@ -0,0 +1,7 @@
+// @symbiote-native/brightness/solid: the Solid entry over the framework-agnostic core, plus
+// createPermissions — the only stateful surface this package needs a lifecycle wrapper for. 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 { createPermissions } from './primitives/create-permissions';
+export * from '../core';

package/src/solid/primitives/create-permissions.ts

@@ -0,0 +1,69 @@
+// Solid lifecycle wiring over the framework-agnostic core (core/brightness.ts) — the Solid twin of
+// React's usePermissions hook, Vue's composable, Svelte's rune and Angular's PermissionsService.
+//
+// `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.
+//
+// Returns ACCESSORS, never a snapshot: a Solid component body runs ONCE, so a plain returned value
+// would freeze at "not fetched yet" and never move again.
+//
+// The initial fetch is fired SYNCHRONOUSLY from the primitive body rather than from a mount hook
+// (React's useEffect, Vue's onMounted, Svelte's $effect) — same reason create-color-scheme
+// subscribes synchronously: nothing can interleave between construction and the fetch starting, so
+// there is no window in which a consumer sees a primitive that has not asked for status yet.
+//
+// That fetch has nobody to reject to, so its failure lands in `error` instead of escaping as an
+// unhandled rejection: a null status with a non-null error is how a consumer tells "the fetch
+// failed" from "not fetched yet". get()/request() still reject to their direct caller — only the
+// automatic call is made safe.
+//
+// `onCleanup` drops the writes of a call still in flight when the owner is disposed — the Solid
+// equivalent of React's isMounted ref. Outside a component / createRoot there is no owner to hang
+// it on, so those late writes land instead (harmless: nothing reads a disposed signal).
+import { createSignal, onCleanup, type Accessor } from 'solid-js';
+import {
+  getPermissionsAsync,
+  requestPermissionsAsync,
+  type PermissionResponse,
+} from '../../core';
+
+export function createPermissions(): {
+  status: Accessor<PermissionResponse | null>;
+  error: Accessor<Error | null>;
+  request: () => Promise<PermissionResponse>;
+  get: () => Promise<PermissionResponse>;
+} {
+  const [status, setStatus] = createSignal<PermissionResponse | null>(null);
+  const [error, setError] = createSignal<Error | null>(null);
+  let isDisposed = false;
+
+  const record = (response: PermissionResponse): void => {
+    if (isDisposed) return;
+    setStatus(response);
+    setError(null);
+  };
+
+  const get = async (): Promise<PermissionResponse> => {
+    const response = await getPermissionsAsync();
+    record(response);
+    return response;
+  };
+
+  const request = async (): Promise<PermissionResponse> => {
+    const response = await requestPermissionsAsync();
+    record(response);
+    return response;
+  };
+
+  get().catch((cause: unknown) => {
+    if (isDisposed) return;
+    setError(cause instanceof Error ? cause : new Error(String(cause)));
+  });
+
+  onCleanup(() => {
+    isDisposed = true;
+  });
+
+  return { status, error, request, get };
+}

package/src/svelte/runes/use-permissions.svelte.ts

@@ -19,7 +19,11 @@
 // same reason as `status`) instead of escaping as an unhandled rejection: a null status with a
 // non-null error is how a consumer tells "the fetch failed" from "not fetched yet".
 // get()/request() still reject to their direct caller — only the automatic call is made safe.
-import { getPermissionsAsync, requestPermissionsAsync, type PermissionResponse } from '../../core';
+import {
+  getPermissionsAsync,
+  requestPermissionsAsync,
+  type PermissionResponse,
+} from '../../core';
 
 export function usePermissions(): {
   readonly status: PermissionResponse | null;