@thomasfosterau/effect-svelte 0.0.0

package/dist/stream.svelte.js

@@ -0,0 +1,34 @@
+import { getRuntimeContext } from "./context.svelte.js";
+import { streamState } from "./internal/subscribe.js";
+//#region src/stream.svelte.ts
+/**
+* Subscribe to a Stream and collect emissions.
+*
+* The subscription starts the first time `current`/`values`/`latest` is read
+* inside an effect or template, and is interrupted automatically when the last
+* reader is destroyed (via Svelte's `createSubscriber`).
+*
+* @example
+* ```svelte
+* <script lang="ts">
+*   import { useStream } from '@thomasfosterau/effect-svelte';
+*   import { Stream, Schedule } from 'effect';
+*
+*   const counter = useStream(
+*     Stream.iterate(0, n => n + 1).pipe(
+*       Stream.schedule(Schedule.spaced('1 second'))
+*     )
+*   );
+* <\/script>
+*
+* <p>Latest: {counter.latest}</p>
+* <p>All values: {counter.values.join(', ')}</p>
+* ```
+*/
+function useStream(stream) {
+	return streamState(getRuntimeContext(), () => stream);
+}
+//#endregion
+export { useStream };
+
+//# sourceMappingURL=stream.svelte.js.map

package/dist/stream.svelte.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.svelte.js","names":["getRuntime"],"sources":["../src/stream.svelte.ts"],"sourcesContent":["import type { Stream } from \"effect\";\nimport type * as AsyncResult from \"effect/unstable/reactivity/AsyncResult\";\nimport { getRuntime } from \"./context.svelte.js\";\nimport type { RuntimeLike } from \"./internal/run.js\";\nimport { streamState } from \"./internal/subscribe.js\";\n\nexport interface UseStreamReturn<A, E> {\n  /**\n   * The current result state of the stream. `Initial`/`Success` carry a\n   * `waiting` flag while the stream is still live (stale-while-revalidate), and\n   * settle to a non-waiting `Success`/`Failure` once it completes.\n   */\n  readonly current: AsyncResult.AsyncResult<ReadonlyArray<A>, E>;\n\n  /**\n   * All values emitted by the stream so far\n   */\n  readonly values: ReadonlyArray<A>;\n\n  /**\n   * The most recent value emitted by the stream (undefined if none)\n   */\n  readonly latest: A | undefined;\n}\n\n/**\n * Subscribe to a Stream and collect emissions.\n *\n * The subscription starts the first time `current`/`values`/`latest` is read\n * inside an effect or template, and is interrupted automatically when the last\n * reader is destroyed (via Svelte's `createSubscriber`).\n *\n * @example\n * ```svelte\n * <script lang=\"ts\">\n *   import { useStream } from '@thomasfosterau/effect-svelte';\n *   import { Stream, Schedule } from 'effect';\n *\n *   const counter = useStream(\n *     Stream.iterate(0, n => n + 1).pipe(\n *       Stream.schedule(Schedule.spaced('1 second'))\n *     )\n *   );\n * </script>\n *\n * <p>Latest: {counter.latest}</p>\n * <p>All values: {counter.values.join(', ')}</p>\n * ```\n */\nexport function useStream<A, E, R>(stream: Stream.Stream<A, E, R>): UseStreamReturn<A, E> {\n  const runtime = getRuntime() as RuntimeLike<R>;\n  return streamState(runtime, () => stream);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAiDA,SAAgB,UAAmB,QAAuD;CAExF,OAAO,YADSA,kBACS,SAAS,MAAM;AAC1C"}

package/dist/subscription.svelte.d.ts

@@ -0,0 +1,69 @@
+import { PubSub, SubscriptionRef } from "effect";
+
+//#region src/subscription.svelte.d.ts
+interface UseSubscriptionRefReturn<A> {
+  /**
+   * The current value of the SubscriptionRef
+   */
+  readonly current: A;
+}
+/**
+ * Subscribe to an Effect SubscriptionRef and get reactive updates.
+ * Returns an object exposing the current value via the `current` property.
+ *
+ * The initial value is read synchronously; the subscription that keeps it up to
+ * date starts when `current` is first read inside an effect or template, and is
+ * interrupted when the last reader is destroyed.
+ *
+ * @example
+ * ```svelte
+ * <script lang="ts">
+ *   import { useSubscriptionRef } from '@thomasfosterau/effect-svelte';
+ *   import { SubscriptionRef, Effect } from 'effect';
+ *
+ *   // Assume counterRef is a SubscriptionRef<number>
+ *   const count = useSubscriptionRef(counterRef);
+ * </script>
+ *
+ * <p>Count: {count.current}</p>
+ * ```
+ */
+declare function useSubscriptionRef<A>(ref: SubscriptionRef.SubscriptionRef<A>): UseSubscriptionRefReturn<A>;
+interface UsePubSubReturn<A> {
+  /**
+   * All values received from the PubSub
+   */
+  readonly values: ReadonlyArray<A>;
+  /**
+   * The most recent value (undefined if none)
+   */
+  readonly latest: A | undefined;
+}
+/**
+ * Subscribe to an Effect PubSub and collect messages.
+ *
+ * The subscription starts when `values`/`latest` is first read inside an effect
+ * or template, and is interrupted when the last reader is destroyed.
+ *
+ * @example
+ * ```svelte
+ * <script lang="ts">
+ *   import { usePubSub } from '@thomasfosterau/effect-svelte';
+ *   import { PubSub } from 'effect';
+ *
+ *   // Assume messagePubSub is a PubSub<string>
+ *   const messages = usePubSub(messagePubSub);
+ * </script>
+ *
+ * <p>Latest: {messages.latest}</p>
+ * <ul>
+ *   {#each messages.values as msg}
+ *     <li>{msg}</li>
+ *   {/each}
+ * </ul>
+ * ```
+ */
+declare function usePubSub<A>(pubsub: PubSub.PubSub<A>): UsePubSubReturn<A>;
+//#endregion
+export { UsePubSubReturn, UseSubscriptionRefReturn, usePubSub, useSubscriptionRef };
+//# sourceMappingURL=subscription.svelte.d.ts.map

package/dist/subscription.svelte.js

@@ -0,0 +1,69 @@
+import { getRuntimeContext } from "./context.svelte.js";
+import { runSync } from "./internal/run.js";
+import { streamState, valueState } from "./internal/subscribe.js";
+import { Stream, SubscriptionRef } from "effect";
+//#region src/subscription.svelte.ts
+/**
+* Subscribe to an Effect SubscriptionRef and get reactive updates.
+* Returns an object exposing the current value via the `current` property.
+*
+* The initial value is read synchronously; the subscription that keeps it up to
+* date starts when `current` is first read inside an effect or template, and is
+* interrupted when the last reader is destroyed.
+*
+* @example
+* ```svelte
+* <script lang="ts">
+*   import { useSubscriptionRef } from '@thomasfosterau/effect-svelte';
+*   import { SubscriptionRef, Effect } from 'effect';
+*
+*   // Assume counterRef is a SubscriptionRef<number>
+*   const count = useSubscriptionRef(counterRef);
+* <\/script>
+*
+* <p>Count: {count.current}</p>
+* ```
+*/
+function useSubscriptionRef(ref) {
+	const runtime = getRuntimeContext();
+	return valueState(runtime, runSync(runtime)(SubscriptionRef.get(ref)), () => SubscriptionRef.changes(ref));
+}
+/**
+* Subscribe to an Effect PubSub and collect messages.
+*
+* The subscription starts when `values`/`latest` is first read inside an effect
+* or template, and is interrupted when the last reader is destroyed.
+*
+* @example
+* ```svelte
+* <script lang="ts">
+*   import { usePubSub } from '@thomasfosterau/effect-svelte';
+*   import { PubSub } from 'effect';
+*
+*   // Assume messagePubSub is a PubSub<string>
+*   const messages = usePubSub(messagePubSub);
+* <\/script>
+*
+* <p>Latest: {messages.latest}</p>
+* <ul>
+*   {#each messages.values as msg}
+*     <li>{msg}</li>
+*   {/each}
+* </ul>
+* ```
+*/
+function usePubSub(pubsub) {
+	const state = streamState(getRuntimeContext(), () => Stream.fromPubSub(pubsub));
+	return {
+		get values() {
+			return state.values;
+		},
+		get latest() {
+			return state.latest;
+		}
+	};
+}
+//#endregion
+export { usePubSub, useSubscriptionRef };
+
+//# sourceMappingURL=subscription.svelte.js.map

package/dist/subscription.svelte.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.svelte.js","names":["getRuntime"],"sources":["../src/subscription.svelte.ts"],"sourcesContent":["import { PubSub, Stream, SubscriptionRef } from \"effect\";\nimport { getRuntime } from \"./context.svelte.js\";\nimport { runSync, type RuntimeLike } from \"./internal/run.js\";\nimport { streamState, valueState } from \"./internal/subscribe.js\";\n\nexport interface UseSubscriptionRefReturn<A> {\n  /**\n   * The current value of the SubscriptionRef\n   */\n  readonly current: A;\n}\n\n/**\n * Subscribe to an Effect SubscriptionRef and get reactive updates.\n * Returns an object exposing the current value via the `current` property.\n *\n * The initial value is read synchronously; the subscription that keeps it up to\n * date starts when `current` is first read inside an effect or template, and is\n * interrupted when the last reader is destroyed.\n *\n * @example\n * ```svelte\n * <script lang=\"ts\">\n *   import { useSubscriptionRef } from '@thomasfosterau/effect-svelte';\n *   import { SubscriptionRef, Effect } from 'effect';\n *\n *   // Assume counterRef is a SubscriptionRef<number>\n *   const count = useSubscriptionRef(counterRef);\n * </script>\n *\n * <p>Count: {count.current}</p>\n * ```\n */\nexport function useSubscriptionRef<A>(\n  ref: SubscriptionRef.SubscriptionRef<A>,\n): UseSubscriptionRefReturn<A> {\n  const runtime = getRuntime() as RuntimeLike<never>;\n\n  // Get the initial value synchronously so it is available before (and during\n  // SSR, instead of) the subscription. `SubscriptionRef.changes` re-emits the\n  // current value on subscribe, so no update is missed.\n  const initial = runSync(runtime)(SubscriptionRef.get(ref));\n  return valueState(runtime, initial, () => SubscriptionRef.changes(ref));\n}\n\nexport interface UsePubSubReturn<A> {\n  /**\n   * All values received from the PubSub\n   */\n  readonly values: ReadonlyArray<A>;\n\n  /**\n   * The most recent value (undefined if none)\n   */\n  readonly latest: A | undefined;\n}\n\n/**\n * Subscribe to an Effect PubSub and collect messages.\n *\n * The subscription starts when `values`/`latest` is first read inside an effect\n * or template, and is interrupted when the last reader is destroyed.\n *\n * @example\n * ```svelte\n * <script lang=\"ts\">\n *   import { usePubSub } from '@thomasfosterau/effect-svelte';\n *   import { PubSub } from 'effect';\n *\n *   // Assume messagePubSub is a PubSub<string>\n *   const messages = usePubSub(messagePubSub);\n * </script>\n *\n * <p>Latest: {messages.latest}</p>\n * <ul>\n *   {#each messages.values as msg}\n *     <li>{msg}</li>\n *   {/each}\n * </ul>\n * ```\n */\nexport function usePubSub<A>(pubsub: PubSub.PubSub<A>): UsePubSubReturn<A> {\n  const runtime = getRuntime() as RuntimeLike<never>;\n  const state = streamState(runtime, () => Stream.fromPubSub(pubsub));\n  return {\n    get values() {\n      return state.values;\n    },\n    get latest() {\n      return state.latest;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,SAAgB,mBACd,KAC6B;CAC7B,MAAM,UAAUA,kBAAW;CAM3B,OAAO,WAAW,SADF,QAAQ,OAAO,EAAE,gBAAgB,IAAI,GAAG,CACvB,SAAS,gBAAgB,QAAQ,GAAG,CAAC;AACxE;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,SAAgB,UAAa,QAA8C;CAEzE,MAAM,QAAQ,YADEA,kBACgB,SAAS,OAAO,WAAW,MAAM,CAAC;CAClE,OAAO;EACL,IAAI,SAAS;GACX,OAAO,MAAM;EACf;EACA,IAAI,SAAS;GACX,OAAO,MAAM;EACf;CACF;AACF"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@thomasfosterau/effect-svelte",
+  "version": "0.0.0",
+  "description": "Effect integration for Svelte 5 runes",
+  "keywords": [
+    "effect",
+    "functional-programming",
+    "runes",
+    "svelte",
+    "typescript"
+  ],
+  "homepage": "https://github.com/thomasfosterau/effect-svelte/tree/main/packages/svelte#readme",
+  "bugs": {
+    "url": "https://github.com/thomasfosterau/effect-svelte/issues"
+  },
+  "license": "MIT",
+  "author": "Thomas Foster",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/thomasfosterau/effect-svelte.git",
+    "directory": "packages/svelte"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "effect": "^4.0.0-beta.75",
+    "svelte": "^5.40.0"
+  },
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "scripts": {
+    "build": "vp pack",
+    "test": "vp test",
+    "clean": "rm -rf dist"
+  }
+}