@symbiote-native/cellular 0.2.0 → 0.3.0

package/README.md

@@ -2,8 +2,8 @@
 
 A wrapper package for [SymbioteNative](../../README.md) that makes
 [`expo-cellular`](https://docs.expo.dev/versions/latest/sdk/cellular/) — cellular connection
-generation, carrier/SIM info, and VoIP-support detection — reachable from **every** adapter,
-React, Vue, and Angular, not just React. Like [`@symbiote-native/sensors`](../sensors) and
+generation, carrier/SIM info, and VoIP-support detection — reachable from **every** adapter:
+React, Vue, Svelte, Solid, and Angular, not just React. Like [`@symbiote-native/sensors`](../sensors) and
 unlike this repo's plain-RN-module/view wrappers ([`@symbiote-native/slider`](../slider),
 [`@symbiote-native/splash-screen`](../splash-screen)), `expo-cellular` is built on
 `expo-modules-core`, so its native code autolinks straight out of `node_modules` via
@@ -30,13 +30,13 @@ Unlike a plain RN native module, `expo-cellular`'s native code is discovered by
 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` — the `READ_PHONE_STATE` permission, needed to read carrier/SIM info |
+| 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` — the `READ_PHONE_STATE` permission, needed to read carrier/SIM info                                                          |
 
 Full mechanics — the Podfile pieces that normally ship inside the `expo` package, the `expo`
 peer-dependency exclusion list, per-module permission strings — live in the
@@ -51,19 +51,26 @@ src/core/              cellular.ts (the free functions) + types.ts (CellularGene
                         expo-modules-core's requireNativeModule.
 src/react/hooks/        @symbiote-native/cellular/react   — usePermissions
 src/vue/composables/    @symbiote-native/cellular/vue     — usePermissions
+src/svelte/runes/       @symbiote-native/cellular/svelte  — usePermissions
+src/solid/primitives/   @symbiote-native/cellular/solid   — createPermissions (Solid says
+                                                            create*, not use*)
 src/angular/services/   @symbiote-native/cellular/angular — PermissionsService
 ```
 
 Each adapter's `usePermissions` hook/composable/service is a thin lifecycle wrapper (fetch on
 mount, expose `request`/`get` to re-check imperatively) over the same `core` functions — the
-permission-fetch logic is written once and shared by all three.
+permission-fetch logic is written once and shared by every adapter.
 
 ## Use it
 
 ```tsx
 // React
 import { useEffect, useState } from 'react';
-import { CellularGeneration, getCarrierNameAsync, getCellularGenerationAsync } from '@symbiote-native/cellular';
+import {
+  CellularGeneration,
+  getCarrierNameAsync,
+  getCellularGenerationAsync,
+} from '@symbiote-native/cellular';
 import { usePermissions } from '@symbiote-native/cellular/react';
 
 function CellularScreen() {
@@ -72,15 +79,19 @@ function CellularScreen() {
   const [status, requestPermission] = usePermissions();
 
   useEffect(() => {
-    Promise.all([getCellularGenerationAsync(), getCarrierNameAsync()]).then(([gen, carrier]) => {
-      setGeneration(gen);
-      setCarrierName(carrier);
-    });
+    Promise.all([getCellularGenerationAsync(), getCarrierNameAsync()]).then(
+      ([gen, carrier]) => {
+        setGeneration(gen);
+        setCarrierName(carrier);
+      },
+    );
   }, []);
 
   return (
     <>
-      <Text>{generation === null ? 'checking…' : CellularGeneration[generation]}</Text>
+      <Text>
+        {generation === null ? 'checking…' : CellularGeneration[generation]}
+      </Text>
       <Text>{carrierName ?? 'checking…'}</Text>
       <Text>{status === null ? 'checking…' : status.status}</Text>
       <Button title="Request permission" onPress={() => requestPermission()} />
@@ -93,7 +104,11 @@ function CellularScreen() {
 <!-- Vue -->
 <script setup lang="ts">
 import { onMounted, ref } from 'vue';
-import { CellularGeneration, getCarrierNameAsync, getCellularGenerationAsync } from '@symbiote-native/cellular';
+import {
+  CellularGeneration,
+  getCarrierNameAsync,
+  getCellularGenerationAsync,
+} from '@symbiote-native/cellular';
 import { usePermissions } from '@symbiote-native/cellular/vue';
 
 const generation = ref<CellularGeneration | null>(null);
@@ -101,14 +116,18 @@ const carrierName = ref<string | null>(null);
 const { status, request: requestPermission } = usePermissions();
 
 onMounted(() => {
-  Promise.all([getCellularGenerationAsync(), getCarrierNameAsync()]).then(([gen, carrier]) => {
-    generation.value = gen;
-    carrierName.value = carrier;
-  });
+  Promise.all([getCellularGenerationAsync(), getCarrierNameAsync()]).then(
+    ([gen, carrier]) => {
+      generation.value = gen;
+      carrierName.value = carrier;
+    },
+  );
 });
 </script>
 <template>
-  <Text>{{ generation === null ? 'checking…' : CellularGeneration[generation] }}</Text>
+  <Text>{{
+    generation === null ? 'checking…' : CellularGeneration[generation]
+  }}</Text>
   <Text>{{ carrierName ?? 'checking…' }}</Text>
   <Text>{{ status === null ? 'checking…' : status.status }}</Text>
   <Button title="Request permission" :onPress="() => requestPermission()" />
@@ -118,15 +137,25 @@ onMounted(() => {
 ```ts
 // Angular
 import { Component, inject, signal } from '@angular/core';
-import { CellularGeneration, PermissionsService, getCarrierNameAsync, getCellularGenerationAsync } from '@symbiote-native/cellular/angular';
+import {
+  CellularGeneration,
+  PermissionsService,
+  getCarrierNameAsync,
+  getCellularGenerationAsync,
+} from '@symbiote-native/cellular/angular';
 
 @Component({
   selector: 'CellularScreen',
   template: `
-    <Text>{{ generation() === null ? 'checking…' : CellularGeneration[generation()!] }}</Text>
+    <Text>{{
+      generation() === null ? 'checking…' : CellularGeneration[generation()!]
+    }}</Text>
     <Text>{{ carrierName() ?? 'checking…' }}</Text>
     <Text>{{ permissionStatus()?.status ?? 'checking…' }}</Text>
-    <Button title="Request permission" (press)="permissionsService.request()"></Button>
+    <Button
+      title="Request permission"
+      (press)="permissionsService.request()"
+    ></Button>
   `,
 })
 export class CellularScreen {
@@ -138,10 +167,12 @@ export class CellularScreen {
   readonly carrierName = signal<string | null>(null);
 
   constructor() {
-    Promise.all([getCellularGenerationAsync(), getCarrierNameAsync()]).then(([generation, carrier]) => {
-      this.generation.set(generation);
-      this.carrierName.set(carrier);
-    });
+    Promise.all([getCellularGenerationAsync(), getCarrierNameAsync()]).then(
+      ([generation, carrier]) => {
+        this.generation.set(generation);
+        this.carrierName.set(carrier);
+      },
+    );
   }
 }
 ```
@@ -191,11 +222,16 @@ Plus `CellularGeneration` (enum) and `PermissionResponse`/`PermissionStatus`/
 ported by hand.
 
 ```ts
-import { getCellularGenerationAsync, getCarrierNameAsync } from '@symbiote-native/cellular';
+import {
+  getCellularGenerationAsync,
+  getCarrierNameAsync,
+} from '@symbiote-native/cellular';
 
 // framework-scoped entry points re-export the same free functions, plus usePermissions:
 import { usePermissions } from '@symbiote-native/cellular/react';
 import { usePermissions } from '@symbiote-native/cellular/vue';
+import { usePermissions } from '@symbiote-native/cellular/svelte';
+import { createPermissions } from '@symbiote-native/cellular/solid';
 import { PermissionsService } from '@symbiote-native/cellular/angular';
 ```
 
@@ -216,6 +252,16 @@ const [status, requestPermission, getPermission] = usePermissions();
 const { status, request, get } = usePermissions();
 ```
 
+```ts
+// Svelte — the same object, boxed as getters: permissions.status
+const permissions = usePermissions();
+```
+
+```ts
+// Solid — createPermissions, and status/error are accessors: status()
+const { status, request, get } = createPermissions();
+```
+
 ```ts
 // Angular — connect() returns a readonly Signal; request()/get() live on the service itself
 readonly status = inject(PermissionsService).connect();
@@ -227,6 +273,6 @@ readonly status = inject(PermissionsService).connect();
 No Fabric/Descriptor angle at all — cellular info is a pure async-function + permission surface,
 never a view. Tests inject a fake native-module object in place of the real
 `requireNativeModule` resolution (`src/core/cellular.test.ts`,
-`src/{react,vue,angular}/**/*.test.{ts,tsx}`, run via `vitest`) — no `installFabric()`, no
+`src/{react,vue,svelte,solid,angular}/**/*.test.{ts,tsx}`, run via `vitest`) — no `installFabric()`, no
 ViewConfig. Native rendering itself is verified on-device (see the parent
 [README](../../README.md)).

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/cellular/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/cellular.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,wFAAwF;AACxF,uEAAuE;AACvE,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,wFAAwF;AACxF,uEAAuE;AACvE,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/cellular.js.map

@@ -1 +1 @@
-{"version":3,"file":"cellular.js","sourceRoot":"","sources":["../../src/core/cellular.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cellular.js","sourceRoot":"","sources":["../../src/core/cellular.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,yBAAyB,GAAG,cAAc,CAAC;AAmBjD,MAAM,CAAC,MAAM,YAAY,GAAG,mBAAmB,CAAwB,yBAAyB,CAAC,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,yBAAyB,GAAG,cAAc,CAAC;AAmBjD,MAAM,CAAC,MAAM,YAAY,GAAG,mBAAmB,CAC7C,yBAAyB,CAC1B,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@symbiote-native/cellular",
-  "version": "0.2.0",
-  "description": "expo-cellular wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, and Angular adapters. Cellular generation (2G/3G/4G/5G), carrier/SIM info on Android (ISO country code, carrier name, MCC/MNC), VoIP-support detection, and the permission get/request pair gating carrier info on Android.",
+  "version": "0.3.0",
+  "description": "expo-cellular wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, Svelte, Solid, and Angular adapters. Cellular generation (2G/3G/4G/5G), carrier/SIM info on Android (ISO country code, carrier name, MCC/MNC), VoIP-support detection, and the permission get/request pair gating carrier info on Android.",
   "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

@@ -31,7 +31,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/cellular.ts

@@ -26,7 +26,10 @@ const GRANTED_PERMISSION_RESPONSE: PermissionResponse = {
 /** Gets the generation of the device's current connection. */
 export async function getCellularGenerationAsync(): Promise<CellularGeneration> {
   if (!expoCellular.getCellularGenerationAsync) {
-    throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getCellularGenerationAsync');
+    throw new UnavailabilityError(
+      NATIVE_MODULE_NAME,
+      'getCellularGenerationAsync',
+    );
   }
   return expoCellular.getCellularGenerationAsync();
 }
@@ -83,7 +86,10 @@ export async function getMobileCountryCodeAsync(): Promise<string | null> {
     return null;
   }
   if (!expoCellular.getMobileCountryCodeAsync) {
-    throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getMobileCountryCodeAsync');
+    throw new UnavailabilityError(
+      NATIVE_MODULE_NAME,
+      'getMobileCountryCodeAsync',
+    );
   }
   return expoCellular.getMobileCountryCodeAsync();
 }
@@ -97,7 +103,10 @@ export async function getMobileNetworkCodeAsync(): Promise<string | null> {
     return null;
   }
   if (!expoCellular.getMobileNetworkCodeAsync) {
-    throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getMobileNetworkCodeAsync');
+    throw new UnavailabilityError(
+      NATIVE_MODULE_NAME,
+      'getMobileNetworkCodeAsync',
+    );
   }
   return expoCellular.getMobileNetworkCodeAsync();
 }
@@ -123,7 +132,10 @@ export async function getPermissionsAsync(): Promise<PermissionResponse> {
 export async function requestPermissionsAsync(): Promise<PermissionResponse> {
   if (Platform.OS === 'android') {
     if (!expoCellular.requestPermissionsAsync) {
-      throw new UnavailabilityError(NATIVE_MODULE_NAME, 'requestPermissionsAsync');
+      throw new UnavailabilityError(
+        NATIVE_MODULE_NAME,
+        'requestPermissionsAsync',
+      );
     }
     return expoCellular.requestPermissionsAsync();
   }

package/src/core/native-module.ts

@@ -21,4 +21,6 @@ export type INativeCellularModule = {
   requestPermissionsAsync?(): Promise<PermissionResponse>;
 };
 
-export const expoCellular = requireNativeModule<INativeCellularModule>(EXPO_CELLULAR_MODULE_NAME);
+export const expoCellular = requireNativeModule<INativeCellularModule>(
+  EXPO_CELLULAR_MODULE_NAME,
+);

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

@@ -43,7 +43,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/cellular/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/cellular.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;