@symbiote-native/clipboard 0.1.0 → 0.3.0

package/README.md

@@ -2,8 +2,8 @@
 
 A wrapper package for [SymbioteNative](../../README.md) that makes
 [`expo-clipboard`](https://docs.expo.dev/versions/latest/sdk/clipboard/) — read/write clipboard
-text, URLs, and images, plus a clipboard-change listener — usable from **every** adapter, React,
-Vue, and Angular, not just React. Unlike `@symbiote-native/sensors`, which is all
+text, URLs, and images, plus a clipboard-change listener — usable from **every** adapter: React,
+Vue, Svelte, Solid, and Angular, not just React. Unlike `@symbiote-native/sensors`, which is all
 `DeviceSensor`-shaped classes plus one free-function module (`Pedometer`), clipboard is closer to
 `@symbiote-native/local-auth`'s shape — mostly stateless async functions — plus **one**
 listener-based subscription (`addClipboardListener`) that each adapter wraps in its own
@@ -28,12 +28,12 @@ Unlike a plain RN native module, `expo-clipboard`'s native code is discovered by
 into the native host app **once**, covering this package and every other `expo-modules-core`
 package (`@symbiote-native/sensors`, `@symbiote-native/local-auth`) with zero further changes:
 
-| Platform | Touches |
-|---|---|
-| iOS | `ios/Podfile` — add `use_expo_modules!` |
-| iOS | `AppDelegate.swift` — Expo's runtime-bootstrap hook |
-| Android | `settings.gradle` / `app/build.gradle` — resolve and include the Expo Gradle projects |
-| Android | `MainApplication.kt` — Expo's bootstrap hook, plus a hand-written native-module name map (there's no `expo` meta-package here to auto-generate one) |
+| Platform | Touches                                                                                                                                             |
+| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
+| iOS      | `ios/Podfile` — add `use_expo_modules!`                                                                                                             |
+| iOS      | `AppDelegate.swift` — Expo's runtime-bootstrap hook                                                                                                 |
+| Android  | `settings.gradle` / `app/build.gradle` — resolve and include the Expo Gradle projects                                                               |
+| Android  | `MainApplication.kt` — Expo's bootstrap hook, plus a hand-written native-module name map (there's no `expo` meta-package here to auto-generate one) |
 
 Full mechanics live in the `symbiote-expo-native-module` skill. Clipboard itself needs no
 `Info.plist`/`AndroidManifest.xml` permission entry on either platform — reading/writing the
@@ -49,22 +49,30 @@ src/core/               getStringAsync/setStringAsync/hasStringAsync, getUrlAsyn
                          requireNativeModule.
 src/react/hooks/         @symbiote-native/clipboard/react   — useClipboard
 src/vue/composables/     @symbiote-native/clipboard/vue     — useClipboard (same name)
+src/svelte/runes/        @symbiote-native/clipboard/svelte  — useClipboard (same name)
+src/solid/primitives/    @symbiote-native/clipboard/solid   — createClipboard (Solid says
+                                                              create*, not use*)
 src/angular/services/    @symbiote-native/clipboard/angular — ClipboardService
 ```
 
 Every function except the listener is plain stateless async and re-exported as-is. The listener
 subscription (`addClipboardListener`) lives once in `core`, framework-agnostic; each adapter's
-`useClipboard` hook/composable/`ClipboardService.connect()` is a thin mount/unmount (or DI-scoped
-`effect()`, for Angular) wrapper around that same subscription — the plumbing is written once and
-shared by all three.
+`useClipboard` hook/composable/rune, Solid's `createClipboard`, and `ClipboardService.connect()`
+are thin mount/unmount wrappers (a DI-scoped `effect()` for Angular, a body-level subscription plus
+`onCleanup` for Solid) around that same subscription — the plumbing is written once and shared by
+every adapter.
 
 ## Use it
 
 ```ts
-import { getStringAsync, setStringAsync, addClipboardListener } from '@symbiote-native/clipboard';
+import {
+  getStringAsync,
+  setStringAsync,
+  addClipboardListener,
+} from '@symbiote-native/clipboard';
 ```
 
-`useClipboard()`'s event only carries the clipboard's changed content *types*
+`useClipboard()`'s event only carries the clipboard's changed content _types_
 (`IClipboardEvent.contentTypes`), never the string itself — every adapter's demo screen treats a
 change as a cue to re-fetch via `getStringAsync()`, not a value to render directly.
 
@@ -82,7 +90,8 @@ function ClipboardScreen() {
     getStringAsync().then(setText);
   }, [clipboardEvent]);
 
-  const handleCopy = (input: string) => setStringAsync(input).then(() => getStringAsync().then(setText));
+  const handleCopy = (input: string) =>
+    setStringAsync(input).then(() => getStringAsync().then(setText));
 
   return <Text>{text ?? 'checking…'}</Text>;
 }
@@ -97,12 +106,16 @@ import { useClipboard } from '@symbiote-native/clipboard/vue';
 
 const text = ref('checking…');
 function refresh(): void {
-  void getStringAsync().then(value => { text.value = value; });
+  void getStringAsync().then(value => {
+    text.value = value;
+  });
 }
 onMounted(refresh);
 
 const clipboardEvent = useClipboard(); // Ref<IClipboardEvent | null>
-watch(clipboardEvent, event => { if (event) refresh(); });
+watch(clipboardEvent, event => {
+  if (event) refresh();
+});
 
 function handleCopy(input: string): void {
   void setStringAsync(input).then(refresh);
@@ -116,9 +129,13 @@ function handleCopy(input: string): void {
 ```ts
 // Angular
 import { Component, Injector, effect, inject, signal } from '@angular/core';
-import { ClipboardService, getStringAsync, setStringAsync } from '@symbiote-native/clipboard/angular';
+import {
+  ClipboardService,
+  getStringAsync,
+  setStringAsync,
+} from '@symbiote-native/clipboard/angular';
 
-@Component({ /* ... */ })
+@Component({/* ... */})
 export class ClipboardScreen {
   private readonly injector = inject(Injector);
   private readonly clipboardEvent = inject(ClipboardService).connect(); // Signal<IClipboardEvent | null>
@@ -126,7 +143,12 @@ export class ClipboardScreen {
 
   constructor() {
     this.refresh();
-    effect(() => { if (this.clipboardEvent() !== null) this.refresh(); }, { injector: this.injector });
+    effect(
+      () => {
+        if (this.clipboardEvent() !== null) this.refresh();
+      },
+      { injector: this.injector },
+    );
   }
 
   handleCopy(input: string): void {
@@ -175,6 +197,14 @@ const clipboardEvent = useClipboard(); // IClipboardEvent | null
 import { useClipboard } from '@symbiote-native/clipboard/vue';
 const clipboardEvent = useClipboard(); // Ref<IClipboardEvent | null>
 
+// Svelte
+import { useClipboard } from '@symbiote-native/clipboard/svelte';
+const clipboard = useClipboard(); // clipboard.current: IClipboardEvent | null
+
+// Solid
+import { createClipboard } from '@symbiote-native/clipboard/solid';
+const clipboardEvent = createClipboard(); // Accessor<IClipboardEvent | null>
+
 // Angular
 import { ClipboardService } from '@symbiote-native/clipboard/angular';
 readonly clipboardEvent = inject(ClipboardService).connect(); // Signal<IClipboardEvent | null>
@@ -188,7 +218,8 @@ ported — out of scope for this pass. If it's ever wrapped, it follows
 
 Tests exercise the JS layer only, against a fake native module in place of the real
 `requireNativeModule` resolution (`src/core/**/*.test.ts`,
-`src/{react,vue,angular}/**/*.test.{ts,tsx}`) — no Fabric/Descriptor angle at all, since clipboard
+`src/{react,vue,svelte,solid,angular}/**/*.test.{ts,tsx}`) — no Fabric/Descriptor angle at all,
+since clipboard
 is a pure async-function + one-listener surface, never a view. Native rendering itself is verified
 on-device (see the parent [README](../../README.md) for the project's testing model).
 

package/build/angular/services/clipboard.service/index.js

@@ -32,7 +32,7 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
     }
     return useValue ? value : void 0;
 };
-import { effect, inject, Injectable, Injector, signal } from '@angular/core';
+import { effect, inject, Injectable, Injector, signal, } from '@angular/core';
 import { addClipboardListener } from '../../../core/index.js';
 // Angular twin of React's `useClipboard` hook and Vue's `useClipboard` composable. Angular has
 // no per-instance hook — state and lifecycle live in DI instead, so `connect()` stands in for

package/build/core/clipboard.js

@@ -36,7 +36,12 @@ export async function setStringAsync(text, options = {}) {
  * Returns whether the clipboard has text content. Returns `true` for both plain text and rich
  * text (e.g. HTML).
  */
-export function hasStringAsync() {
+// DELIBERATE DIVERGENCE from expo: Clipboard.ts:57 declares this one plain `function`, not
+// `async` like its 8 siblings, so on a build without the native method the UnavailabilityError
+// escapes synchronously at the call site and `hasStringAsync().catch(handler)` never catches it.
+// Parity would hand callers a guard that fires differently from every other method in this API,
+// so we add `async` here instead of tagging it. Everything else stays a verbatim port.
+export async function hasStringAsync() {
     if (!expoClipboard.hasStringAsync) {
         throw new UnavailabilityError(NATIVE_MODULE_NAME, 'hasStringAsync');
     }

package/build/solid/index.d.ts

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

package/build/solid/index.js

@@ -0,0 +1,8 @@
+// @symbiote-native/clipboard/solid: the Solid entry over the framework-agnostic core. Unlike
+// @symbiote-native/local-auth (all stateless functions, plain re-export), clipboard has one
+// listener-based piece — createClipboard wires addClipboardListener onto Solid's own ownership
+// tree (primitives/create-clipboard.ts). 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 { createClipboard } from './primitives/create-clipboard.js';
+export * from '../core/index.js';

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

@@ -0,0 +1,3 @@
+import { type Accessor } from 'solid-js';
+import { type IClipboardEvent } from '../../core';
+export declare function createClipboard(): Accessor<IClipboardEvent | null>;

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

@@ -0,0 +1,30 @@
+// Solid lifecycle wiring over the framework-agnostic addClipboardListener subscription (core/) —
+// the Solid twin of React's useClipboard hook, Vue's composable, Svelte's rune and Angular's
+// ClipboardService.connect(), adjusted for clipboard's single always-on subscription (no per-call
+// config to resubscribe on).
+//
+// `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 an ACCESSOR, never a snapshot: a Solid component body runs ONCE, so a plain returned
+// value would pin the consumer to `null` forever.
+//
+// Subscribes SYNCHRONOUSLY in the body with `onCleanup` for teardown, not from a mount hook
+// (React's useEffect, Vue's onMounted, Svelte's $effect) — this closes the gap those three have
+// between construction and subscription, in which a clipboard change fires and is never seen.
+//
+// Outside a component / createRoot there is no owner for `onCleanup`, so the subscription lives
+// for the process — see create-color-scheme's header for the same documented caveat.
+import { createSignal, onCleanup } from 'solid-js';
+import { addClipboardListener, } from '../../core/index.js';
+export function createClipboard() {
+    const [event, setEvent] = createSignal(null);
+    const subscription = addClipboardListener(next => {
+        setEvent(next);
+    });
+    onCleanup(() => {
+        subscription.remove();
+    });
+    return event;
+}

package/build/svelte/index.d.ts

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

package/build/svelte/index.js

@@ -0,0 +1,7 @@
+// @symbiote-native/clipboard/svelte: the Svelte entry over the framework-agnostic core. Unlike
+// @symbiote-native/local-auth (all stateless functions, plain re-export), clipboard has one
+// listener-based piece — useClipboard wires addClipboardListener's lifecycle onto a Svelte
+// `$effect` (runes/use-clipboard.svelte.ts), mirroring the lifecycle-bucket naming convention of
+// adapters/svelte/src/runes (never `hooks/`/`composables/`, those are React's and Vue's terms).
+export { useClipboard } from './runes/use-clipboard.svelte';
+export * from '../core/index.js';

package/build/svelte/runes/use-clipboard.svelte.d.ts

@@ -0,0 +1,4 @@
+import { type IClipboardEvent } from '../../core';
+export declare function useClipboard(): {
+    readonly current: IClipboardEvent | null;
+};

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

@@ -0,0 +1,30 @@
+// Svelte lifecycle wiring over the framework-agnostic addClipboardListener subscription (core/) —
+// the Svelte twin of vue/composables/use-clipboard and react/hooks/use-clipboard, adjusted for
+// clipboard's single always-on subscription (no per-call config to resubscribe on).
+//
+// `.svelte.ts` (not `.ts`): runes ($state/$effect) are only usable in a file with this extension
+// outside an actual `.svelte` component. `runes/` is Svelte's own term for the bucket React calls
+// `hooks/` and Vue calls `composables/` — see adapters/svelte/src/runes.
+//
+// Vue's onMounted/onUnmounted pair collapses into ONE `$effect` whose returned function is the
+// teardown. The effect only WRITES `event`, never reads it, so its dependency set stays empty: it
+// subscribes exactly once on mount and removes the subscription exactly once on unmount.
+//
+// Returns a boxed getter object, NOT a bare `$state`: Svelte 5 reactivity is lexically scoped to
+// the declaring module, so a raw `let x = $state(...)` handed out of a plain function arrives
+// dead at the caller. `.current` is the Svelte equivalent of unwrapping Vue's `Ref` via `.value`.
+import { addClipboardListener, } from '../../core/index.js';
+export function useClipboard() {
+    let event = $state(null);
+    $effect(() => {
+        const subscription = addClipboardListener(next => {
+            event = next;
+        });
+        return () => subscription.remove();
+    });
+    return {
+        get current() {
+            return event;
+        },
+    };
+}

package/build/vue/composables/use-clipboard/index.js

@@ -3,7 +3,7 @@
 // onMounted/onUnmounted shape of @symbiote-native/sensors' useAccelerometer composable, adjusted
 // for clipboard's single always-on subscription (no per-call config to resubscribe on).
 import { onMounted, onUnmounted, ref } from '@vue/runtime-core';
-import { addClipboardListener } from '../../../core/index.js';
+import { addClipboardListener, } from '../../../core/index.js';
 export function useClipboard() {
     // A plain ref: the value is a POJO clipboard event, not an engine node, so no shallowRef needed.
     const event = ref(null);

package/build-ngc/angular/services/clipboard.service/index.js

@@ -1,4 +1,4 @@
-import { effect, inject, Injectable, Injector, signal } from '@angular/core';
+import { effect, inject, Injectable, Injector, signal, } from '@angular/core';
 import { addClipboardListener } from '../../../core';
 import * as i0 from "@angular/core";
 // Angular twin of React's `useClipboard` hook and Vue's `useClipboard` composable. Angular has
@@ -26,10 +26,10 @@ export class ClipboardService {
         }, { injector: this.injector });
         return event.asReadonly();
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.5", ngImport: i0, type: ClipboardService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.5", ngImport: i0, type: ClipboardService, providedIn: 'root' });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: ClipboardService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: ClipboardService, providedIn: 'root' });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.5", ngImport: i0, type: ClipboardService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: ClipboardService, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/angular/services/clipboard.service/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAe,MAAM,eAAe,CAAC;AAC1F,OAAO,EAAE,oBAAoB,EAAwB,MAAM,eAAe,CAAC;;AAE3E,+FAA+F;AAC/F,8FAA8F;AAC9F,2FAA2F;AAC3F,sBAAsB;AACtB,EAAE;AACF,kEAAkE;AAClE,sDAAsD;AACtD,EAAE;AACF,iGAAiG;AACjG,wFAAwF;AACxF,8DAA8D;AAE9D,MAAM,OAAO,gBAAgB;IAC3B,8FAA8F;IAC9F,4FAA4F;IAC5F,4FAA4F;IAC3E,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE7C,OAAO;QACL,MAAM,KAAK,GAAG,MAAM,CAAyB,IAAI;kFAAC,CAAC;QAEnD,MAAM,CACJ,SAAS,CAAC,EAAE;YACV,MAAM,YAAY,GAAG,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;YACnE,SAAS,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;QACzC,CAAC,EACD,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAC5B,CAAC;QAEF,OAAO,KAAK,CAAC,UAAU,EAAE,CAAC;IAC5B,CAAC;uGAlBU,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/clipboard.service/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,MAAM,EACN,UAAU,EACV,QAAQ,EACR,MAAM,GAEP,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,oBAAoB,EAAwB,MAAM,eAAe,CAAC;;AAE3E,+FAA+F;AAC/F,8FAA8F;AAC9F,2FAA2F;AAC3F,sBAAsB;AACtB,EAAE;AACF,kEAAkE;AAClE,sDAAsD;AACtD,EAAE;AACF,iGAAiG;AACjG,wFAAwF;AACxF,8DAA8D;AAE9D,MAAM,OAAO,gBAAgB;IAC3B,8FAA8F;IAC9F,4FAA4F;IAC5F,4FAA4F;IAC3E,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE7C,OAAO;QACL,MAAM,KAAK,GAAG,MAAM,CAAyB,IAAI;kFAAC,CAAC;QAEnD,MAAM,CACJ,SAAS,CAAC,EAAE;YACV,MAAM,YAAY,GAAG,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;YACnE,SAAS,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;QACzC,CAAC,EACD,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAC5B,CAAC;QAEF,OAAO,KAAK,CAAC,UAAU,EAAE,CAAC;IAC5B,CAAC;uGAlBU,gBAAgB;2GAAhB,gBAAgB,cADH,MAAM;;2FACnB,gBAAgB;kBAD5B,UAAU;mBAAC,EAAE,UAAU,EAAE,MAAM,EAAE"}

package/build-ngc/core/clipboard.js

@@ -36,7 +36,12 @@ export async function setStringAsync(text, options = {}) {
  * Returns whether the clipboard has text content. Returns `true` for both plain text and rich
  * text (e.g. HTML).
  */
-export function hasStringAsync() {
+// DELIBERATE DIVERGENCE from expo: Clipboard.ts:57 declares this one plain `function`, not
+// `async` like its 8 siblings, so on a build without the native method the UnavailabilityError
+// escapes synchronously at the call site and `hasStringAsync().catch(handler)` never catches it.
+// Parity would hand callers a guard that fires differently from every other method in this API,
+// so we add `async` here instead of tagging it. Everything else stays a verbatim port.
+export async function hasStringAsync() {
     if (!expoClipboard.hasStringAsync) {
         throw new UnavailabilityError(NATIVE_MODULE_NAME, 'hasStringAsync');
     }

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

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@symbiote-native/clipboard",
-  "version": "0.1.0",
-  "description": "expo-clipboard wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, and Angular adapters. Reads and writes clipboard text, URLs, and images, plus a clipboard-change listener.",
+  "version": "0.3.0",
+  "description": "expo-clipboard wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, Svelte, Solid, and Angular adapters. Reads and writes clipboard text, URLs, and images, plus a clipboard-change listener.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -30,6 +30,14 @@
       "types": "./build/react/index.d.ts",
       "default": "./build/react/index.js"
     },
+    "./svelte": {
+      "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",
@@ -53,15 +61,19 @@
     "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/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",
-    "vue": ">=3.5.0",
-    "@symbiote-native/angular": "0.6.2",
-    "@symbiote-native/react": "0.2.8",
-    "@symbiote-native/vue": "0.3.8"
+    "solid-js": ">=1.9.0",
+    "svelte": ">=5.56.0",
+    "vue": ">=3.5.0"
   },
   "peerDependenciesMeta": {
     "@symbiote-native/angular": {
@@ -70,6 +82,12 @@
     "@symbiote-native/react": {
       "optional": true
     },
+    "@symbiote-native/solid": {
+      "optional": true
+    },
+    "@symbiote-native/svelte": {
+      "optional": true
+    },
     "@symbiote-native/vue": {
       "optional": true
     },
@@ -82,24 +100,34 @@
     "react": {
       "optional": true
     },
+    "solid-js": {
+      "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",
+    "solid-js": "^1.9.14",
+    "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/test-utils": "0.1.6",
-    "@symbiote-native/vue": "0.3.8"
+    "@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/clipboard.service/index.ts

@@ -1,4 +1,11 @@
-import { effect, inject, Injectable, Injector, signal, type Signal } from '@angular/core';
+import {
+  effect,
+  inject,
+  Injectable,
+  Injector,
+  signal,
+  type Signal,
+} from '@angular/core';
 import { addClipboardListener, type IClipboardEvent } from '../../../core';
 
 // Angular twin of React's `useClipboard` hook and Vue's `useClipboard` composable. Angular has

package/src/core/clipboard.ts

@@ -24,7 +24,9 @@ const NATIVE_MODULE_NAME = 'Clipboard';
  * @returns A promise that resolves to the content of the clipboard, or an empty string if the
  * clipboard is empty or permission was denied.
  */
-export async function getStringAsync(options: IGetStringOptions = {}): Promise<string> {
+export async function getStringAsync(
+  options: IGetStringOptions = {},
+): Promise<string> {
   if (!expoClipboard.getStringAsync) {
     throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getStringAsync');
   }
@@ -52,7 +54,12 @@ export async function setStringAsync(
  * Returns whether the clipboard has text content. Returns `true` for both plain text and rich
  * text (e.g. HTML).
  */
-export function hasStringAsync(): Promise<boolean> {
+// DELIBERATE DIVERGENCE from expo: Clipboard.ts:57 declares this one plain `function`, not
+// `async` like its 8 siblings, so on a build without the native method the UnavailabilityError
+// escapes synchronously at the call site and `hasStringAsync().catch(handler)` never catches it.
+// Parity would hand callers a guard that fires differently from every other method in this API,
+// so we add `async` here instead of tagging it. Everything else stays a verbatim port.
+export async function hasStringAsync(): Promise<boolean> {
   if (!expoClipboard.hasStringAsync) {
     throw new UnavailabilityError(NATIVE_MODULE_NAME, 'hasStringAsync');
   }
@@ -110,7 +117,9 @@ export async function hasUrlAsync(): Promise<boolean> {
  * containing the base64 string and metadata of the image. Otherwise resolves to `null` (this
  * includes cases where permission was denied).
  */
-export async function getImageAsync(options: IGetImageOptions): Promise<IClipboardImage | null> {
+export async function getImageAsync(
+  options: IGetImageOptions,
+): Promise<IClipboardImage | null> {
   if (!expoClipboard.getImageAsync) {
     throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getImageAsync');
   }

package/src/solid/index.ts

@@ -0,0 +1,9 @@
+// @symbiote-native/clipboard/solid: the Solid entry over the framework-agnostic core. Unlike
+// @symbiote-native/local-auth (all stateless functions, plain re-export), clipboard has one
+// listener-based piece — createClipboard wires addClipboardListener onto Solid's own ownership
+// tree (primitives/create-clipboard.ts). 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 { createClipboard } from './primitives/create-clipboard';
+export * from '../core';

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

@@ -0,0 +1,38 @@
+// Solid lifecycle wiring over the framework-agnostic addClipboardListener subscription (core/) —
+// the Solid twin of React's useClipboard hook, Vue's composable, Svelte's rune and Angular's
+// ClipboardService.connect(), adjusted for clipboard's single always-on subscription (no per-call
+// config to resubscribe on).
+//
+// `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 an ACCESSOR, never a snapshot: a Solid component body runs ONCE, so a plain returned
+// value would pin the consumer to `null` forever.
+//
+// Subscribes SYNCHRONOUSLY in the body with `onCleanup` for teardown, not from a mount hook
+// (React's useEffect, Vue's onMounted, Svelte's $effect) — this closes the gap those three have
+// between construction and subscription, in which a clipboard change fires and is never seen.
+//
+// Outside a component / createRoot there is no owner for `onCleanup`, so the subscription lives
+// for the process — see create-color-scheme's header for the same documented caveat.
+import { createSignal, onCleanup, type Accessor } from 'solid-js';
+import {
+  addClipboardListener,
+  type EventSubscription,
+  type IClipboardEvent,
+} from '../../core';
+
+export function createClipboard(): Accessor<IClipboardEvent | null> {
+  const [event, setEvent] = createSignal<IClipboardEvent | null>(null);
+
+  const subscription: EventSubscription = addClipboardListener(next => {
+    setEvent(next);
+  });
+
+  onCleanup(() => {
+    subscription.remove();
+  });
+
+  return event;
+}

package/src/svelte/index.ts

@@ -0,0 +1,8 @@
+// @symbiote-native/clipboard/svelte: the Svelte entry over the framework-agnostic core. Unlike
+// @symbiote-native/local-auth (all stateless functions, plain re-export), clipboard has one
+// listener-based piece — useClipboard wires addClipboardListener's lifecycle onto a Svelte
+// `$effect` (runes/use-clipboard.svelte.ts), mirroring the lifecycle-bucket naming convention of
+// adapters/svelte/src/runes (never `hooks/`/`composables/`, those are React's and Vue's terms).
+
+export { useClipboard } from './runes/use-clipboard.svelte';
+export * from '../core';

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

@@ -0,0 +1,37 @@
+// Svelte lifecycle wiring over the framework-agnostic addClipboardListener subscription (core/) —
+// the Svelte twin of vue/composables/use-clipboard and react/hooks/use-clipboard, adjusted for
+// clipboard's single always-on subscription (no per-call config to resubscribe on).
+//
+// `.svelte.ts` (not `.ts`): runes ($state/$effect) are only usable in a file with this extension
+// outside an actual `.svelte` component. `runes/` is Svelte's own term for the bucket React calls
+// `hooks/` and Vue calls `composables/` — see adapters/svelte/src/runes.
+//
+// Vue's onMounted/onUnmounted pair collapses into ONE `$effect` whose returned function is the
+// teardown. The effect only WRITES `event`, never reads it, so its dependency set stays empty: it
+// subscribes exactly once on mount and removes the subscription exactly once on unmount.
+//
+// Returns a boxed getter object, NOT a bare `$state`: Svelte 5 reactivity is lexically scoped to
+// the declaring module, so a raw `let x = $state(...)` handed out of a plain function arrives
+// dead at the caller. `.current` is the Svelte equivalent of unwrapping Vue's `Ref` via `.value`.
+import {
+  addClipboardListener,
+  type EventSubscription,
+  type IClipboardEvent,
+} from '../../core';
+
+export function useClipboard(): { readonly current: IClipboardEvent | null } {
+  let event = $state<IClipboardEvent | null>(null);
+
+  $effect(() => {
+    const subscription: EventSubscription = addClipboardListener(next => {
+      event = next;
+    });
+    return () => subscription.remove();
+  });
+
+  return {
+    get current(): IClipboardEvent | null {
+      return event;
+    },
+  };
+}

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-clipboard/index.ts

@@ -4,7 +4,11 @@
 // for clipboard's single always-on subscription (no per-call config to resubscribe on).
 
 import { onMounted, onUnmounted, ref, type Ref } from '@vue/runtime-core';
-import { addClipboardListener, type EventSubscription, type IClipboardEvent } from '../../../core';
+import {
+  addClipboardListener,
+  type EventSubscription,
+  type IClipboardEvent,
+} from '../../../core';
 
 export function useClipboard(): Ref<IClipboardEvent | null> {
   // A plain ref: the value is a POJO clipboard event, not an engine node, so no shallowRef needed.