@pulse-js/svelte 0.1.0

package/README.md

@@ -0,0 +1,57 @@
+# @pulse-js/svelte
+
+The standard Svelte integration for Pulse.
+
+[![npm version](https://img.shields.io/npm/v/@pulse-js/svelte.svg)](https://www.npmjs.com/package/@pulse-js/svelte)
+
+## Features
+
+- **Store-based API**: Pulse Units (Sources and Guards) are converted into native Svelte Stores.
+- **Auto-Subscription**: Works seamlessly with Svelte's `$` syntax.
+- **Type Safety**: Full TypeScript support.
+
+## Installation
+
+```bash
+npm install @pulse-js/core @pulse-js/svelte
+```
+
+## Usage
+
+### Using Sources
+
+Wrap your sources with `usePulse` to get a writable/readable store.
+
+```svelte
+<script lang="ts">
+  import { source } from '@pulse-js/core';
+  import { usePulse } from '@pulse-js/svelte';
+
+  const count = source(0);
+  const $count = usePulse(count);
+</script>
+
+<button on:click={() => count.set(count.value + 1)}>
+  Count is {$count}
+</button>
+```
+
+### Using Guards
+
+Wrap guards with `useGuard` to get a readable store containing the status and result.
+
+```svelte
+<script lang="ts">
+  import { guard } from '@pulse-js/core';
+  import { useGuard } from '@pulse-js/svelte';
+
+  const isAdult = guard(() => age.value >= 18);
+  const $isAdult = useGuard(isAdult);
+</script>
+
+{#if $isAdult.status === 'ok'}
+  <p>Result: {$isAdult.value}</p>
+{:else if $isAdult.status === 'fail'}
+  <p class="error">Error: {$isAdult.reason}</p>
+{/if}
+```

package/dist/index.cjs

@@ -0,0 +1,41 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  useGuard: () => useGuard,
+  usePulse: () => usePulse
+});
+module.exports = __toCommonJS(index_exports);
+var import_store = require("svelte/store");
+function usePulse(unit) {
+  const isGuard = unit !== null && typeof unit === "function" && "state" in unit;
+  return (0, import_store.readable)(isGuard ? unit.state() : unit(), (set) => {
+    return unit.subscribe(set);
+  });
+}
+function useGuard(guard) {
+  return usePulse(guard);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useGuard,
+  usePulse
+});

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import { type Readable } from 'svelte/store';
+import type { Guard, Source, GuardState } from '@pulse-js/core';
+/**
+ * Hook to consume a Pulse Unit (Source or Guard) as a Svelte Store.
+ */
+export declare function usePulse<T>(unit: Source<T>): Readable<T>;
+export declare function usePulse<T>(unit: Guard<T>): Readable<GuardState<T>>;
+/**
+ * Explicit hook for Pulse Guards in Svelte.
+ */
+export declare function useGuard<T>(guard: Guard<T>): Readable<GuardState<T>>;

package/dist/index.js

@@ -0,0 +1,15 @@
+// src/index.ts
+import { readable } from "svelte/store";
+function usePulse(unit) {
+  const isGuard = unit !== null && typeof unit === "function" && "state" in unit;
+  return readable(isGuard ? unit.state() : unit(), (set) => {
+    return unit.subscribe(set);
+  });
+}
+function useGuard(guard) {
+  return usePulse(guard);
+}
+export {
+  useGuard,
+  usePulse
+};

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@pulse-js/svelte",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "bun x tsup src/index.ts --format esm,cjs --clean --external svelte,@pulse-js/core && bun x tsc src/index.ts --declaration --emitDeclarationOnly --outDir dist --skipLibCheck",
+    "lint": "bun x tsc --noEmit"
+  },
+  "peerDependencies": {
+    "svelte": "^4.0.0 || ^5.0.0"
+  },
+  "dependencies": {
+    "@pulse-js/core": "^0.1.8"
+  },
+  "devDependencies": {
+    "svelte": "^5.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  }
+}