@vielzeug/ripple 1.3.0 → 2.0.0

package/dist/types.d.ts

@@ -1,324 +1,60 @@
-export type CleanupFn = () => void;
-export type EffectCallback = () => CleanupFn | void;
-export type AsyncEffectCallback = (signal: AbortSignal, owner: Scope) => Promise<CleanupFn | void>;
-export type EqualityFn<T> = (a: T, b: T) => boolean;
-/**
- * Controls when an effect re-runs after a dependency changes.
- * - `'sync'` (default): runs immediately in the same flush.
- * - `'microtask'`: deferred to the next microtask.
- */
-export type EffectScheduler = 'microtask' | 'sync';
-/** Options accepted by `computed()`. */
-export type ComputedOptions<T> = {
-    equals?: EqualityFn<T>;
-    name?: string;
-};
-/** Options accepted by `signal()`. */
+export type Cleanup = () => void;
+export type Equality<T> = (previous: T, next: T) => boolean;
+export type Unsubscribe = () => void;
 export type SignalOptions<T> = {
-    equals?: EqualityFn<T>;
-    name?: string;
-};
-export type EffectOptions = {
+    equals?: Equality<T>;
     name?: string;
-    scheduler?: EffectScheduler;
 };
-export type EffectAsyncOptions = {
-    /** Name used to identify this async effect in DevTools. */
-    name?: string;
-    onError?: (error: unknown) => void;
-};
-export interface Subscription {
-    dispose(): void;
-    /** `true` after `dispose()` has been called. */
-    readonly disposed: boolean;
-    [Symbol.dispose](): void;
-}
-/**
- * A snapshot of one reactive dependency recorded by an effect.
- * Returned by `EffectHandle.getDependencies()`.
- */
-export type DepInfo = {
-    readonly kind: 'computed' | 'signal';
-    readonly name?: string;
-};
-/**
- * Extended handle returned by `effect()`.
- * Extends `Subscription` with `getDependencies()` for reactive graph introspection.
- *
- * @example
- * ```ts
- * const handle = effect(() => { console.log(count.value); });
- * console.log(handle.getDependencies()); // [{ name: 'count' }]
- * handle.dispose();
- * ```
- */
-export interface EffectHandle extends Subscription {
-    /**
-     * Returns the reactive sources the effect is currently subscribed to.
-     * Reflects the deps collected during the last completed run.
-     * Returns an empty array after `dispose()`.
-     */
-    getDependencies(): ReadonlyArray<DepInfo>;
-}
-/**
- * Extended async subscription returned by `effectAsync()`.
- * Adds `run()` for structured concurrency — await the current async run before proceeding.
- *
- * Sanctioned hybrid disposal shape (see `.ai/core/conventions.md`'s Teardown section):
- * `[Symbol.dispose]` (inherited from `Subscription`) aborts immediately and does
- * **not** wait for in-flight async work to settle; `[Symbol.asyncDispose]` aborts
- * **and** awaits full teardown. Pick `using` for a fire-and-forget stop, `await using`
- * when you need to know the last run has actually finished before continuing.
- */
-export interface AsyncSubscription extends Subscription {
-    /** Awaits the current async run without disposing the effect. Resolves immediately if idle. */
-    run(): Promise<void>;
-    /** ES2024 `await using` compatible async disposal. Stops the effect and awaits full teardown. */
-    [Symbol.asyncDispose](): Promise<void>;
-}
-export type WatchOptions<T> = {
-    equals?: EqualityFn<T>;
-    immediate?: boolean;
+export type ComputedOptions<T> = {
+    equals?: Equality<T>;
     name?: string;
-    /** Auto-dispose the watch after the first callback invocation. */
-    once?: boolean;
 };
-export type ResourceOptions<T> = {
-    /** Value exposed via `data` while the first run is loading. */
-    initialValue?: T;
-    /** Debug name for the internal effect and state signal. */
+export type EffectOptions = {
     name?: string;
+    scheduler?: 'microtask' | 'sync';
 };
-/**
- * Discriminated-union state emitted by a `resource()` signal.
- *
- * - `'loading'` — async factory is in-flight. `data` carries the last fulfilled value (if any).
- * - `'ready'`   — factory resolved. `data` is the fulfilled value.
- * - `'error'`   — factory rejected. `error` holds the thrown value. `data` carries the last fulfilled value (if any).
- *
- * @example
- * ```ts
- * const user = resource(async () => fetchUser(id.value));
- *
- * effect(() => {
- *   const s = user.value;
- *   if (s.status === 'loading') return showSpinner();
- *   if (s.status === 'error')   return showError(s.error);
- *   renderUser(s.data);
- * });
- * ```
- */
-export type ResourceState<T> = {
-    readonly data?: T;
-    readonly status: 'loading';
-} | {
-    readonly data: T;
-    readonly status: 'ready';
-} | {
-    readonly data?: T;
-    readonly error: unknown;
-    readonly status: 'error';
-};
-/**
- * Disposable handle returned by `resource()`. Extends `Computed<ResourceState<T>>`
- * with `refresh()` for manually forcing a re-fetch.
- */
-export interface Resource<T> extends Computed<ResourceState<T>> {
-    /**
-     * Forces the factory to re-run immediately, aborting any in-flight run —
-     * even if no tracked dependency changed. No-op after `dispose()`.
-     */
-    refresh(): void;
-}
-/**
- * A single snapshot entry in `StoreWithHistory`.
- * Carries the frozen state and an optional label for annotated checkpoints.
- */
-export type HistoryEntry<T> = {
-    readonly label?: string;
-    readonly state: Readonly<T>;
-};
-/**
- * The minimal read-only contract for consuming any reactive value.
- * Effects and computed functions read `.value` (tracked) or `peek()` (untracked).
- * Use `subscribe()` for external imperative listeners.
- */
 export interface Readable<T> {
-    /** `true` after the underlying node has been disposed. */
-    readonly disposed: boolean;
-    /** The debug name assigned at creation time, or `undefined` if unnamed. */
     readonly name?: string;
     peek(): T;
-    /**
-     * Subscribes a listener to value change notifications.
-     * Implementations MUST NOT invoke `listener` synchronously during registration.
-     */
-    subscribe(listener: () => void): Subscription;
+    subscribe(listener: () => void): Unsubscribe;
     readonly value: T;
 }
-/**
- * A disposable derived value. The holder is responsible for calling `dispose()`.
- * Returned by `computed()`, `readonly()`, and `resource()`.
- */
-export interface Computed<T> extends Readable<T> {
-    dispose(): void;
-    [Symbol.dispose](): void;
-}
-/**
- * A writable owned signal. The holder can both read and write `.value`,
- * and is responsible for calling `dispose()` when done.
- */
-export interface Signal<T> extends Computed<T> {
+export interface Signal<T> extends Readable<T> {
     value: T;
 }
-/**
- * Extracts the value type at a dot-separated path `P` within object type `T`.
- *
- * @example
- * type City = PathValue<{ user: { address: { city: string } } }, 'user.address.city'>
- * // → string
- */
-export type PathValue<T, P extends string> = P extends keyof T ? T[P] : P extends `${infer K}.${infer Rest}` ? K extends keyof T ? PathValue<T[K], Rest> : never : never;
-/**
- * A fine-grained reactive store for objects.
- * Extends `Computed<Readonly<T>>` — `store.value` provides a tracked whole-store read.
- *
- * `lens()` is the primary reactive read/write API — it returns a `Signal` for
- * a specific property or nested path and registers fine-grained dependencies.
- * `peek()` returns a non-reactive snapshot (useful for serialization).
- * `subscribe()` fires on any mutation (useful for adapters like `storeWithHistory`).
- */
-export interface Store<T extends object> extends Computed<Readonly<T>> {
-    /**
-     * Returns a writable `Signal` scoped to a single property or nested path.
-     * Reads register a fine-grained dependency on that property's signal —
-     * unrelated patches do NOT re-run effects watching this lens.
-     * Lenses are cached — `store.lens('x') === store.lens('x')`.
-     */
-    lens<P extends string>(path: P): Signal<PathValue<T, P>>;
-    /** Atomic partial update — only changed keys notify their subscribers. */
-    patch(partial: Partial<T>): void;
-    /**
-     * Returns a non-reactive snapshot of the current state.
-     * Use for serialization or one-off reads outside reactive contexts.
-     */
-    peek(): Readonly<T>;
-    /**
-     * Replaces the entire store state by passing the current state to `fn` and
-     * applying the returned value. Only changed properties trigger downstream effects.
-     */
-    replace(fn: (state: Readonly<T>) => T): void;
-    /** Resets the store to its initial state. */
-    reset(): void;
-    /**
-     * Subscribes to any store mutation (patch / replace / reset / lens write).
-     * Used by external adapters — prefer `store.lens()` for reactive reads.
-     */
-    subscribe(listener: () => void): Subscription;
-}
-/**
- * A lifecycle scope that collects cleanup functions and runs them on dispose.
- * Effects and computeds created inside `scope.run()` auto-register their disposal.
- */
-export interface Scope {
-    /**
-     * Registers `fn` to run when this scope is disposed.
-     * Throws `RippleDisposedScopeError` if called on an already-disposed scope.
-     * Use this from within an effect body to explicitly direct a cleanup into the scope
-     * rather than the effect's own cleanup queue.
-     */
-    add(fn: CleanupFn): void;
-    /** `AbortSignal` that is aborted when `dispose()` is called. Use to tie external lifetimes to this scope. */
-    readonly disposalSignal: AbortSignal;
+export interface Disposable {
     dispose(): void;
-    /** `true` after `dispose()` has been called. */
     readonly disposed: boolean;
-    /**
-     * Runs `fn` inside this scope's cleanup context.
-     * `onCleanup()` calls and resource auto-disposals inside `fn` are registered
-     * to this scope when there is no enclosing effect or computed context.
-     * Reactive reads inside `fn` are tracked normally against any enclosing effect.
-     * Throws `RippleDisposedScopeError` if the scope has already been disposed.
-     */
-    run<T>(fn: () => T): T;
+    readonly disposalSignal: AbortSignal;
     [Symbol.dispose](): void;
 }
-/**
- * An undo/redo adapter wrapping a `Store<T>`. Returned by `storeWithHistory()`
- * from the `@vielzeug/ripple/history` sub-path.
- * Extends `Store<T>` directly — all store mutations (`patch`, `replace`, `reset`, `lens`)
- * work on the history adapter without `.store` indirection.
- *
- * History is **explicit** — call `push()` or `pushNamed()` after any mutation you want undoable.
- *
- * @example
- * ```ts
- * import { storeWithHistory } from '@vielzeug/ripple/history';
- *
- * const h = storeWithHistory({ count: 0 });
- *
- * h.patch({ count: 1 });
- * h.push();           // save a checkpoint
- * h.undo();           // restore to { count: 0 }
- * h.redo();           // restore to { count: 1 }
- * ```
- */
-export interface StoreWithHistory<T extends object> extends Store<T> {
-    /** `true` when there is at least one snapshot ahead to redo. Reactive — reads inside effects re-run on change. */
-    readonly canRedo: boolean;
-    /** `true` when there is at least one snapshot to undo to. Reactive — reads inside effects re-run on change. */
-    readonly canUndo: boolean;
-    /** Returns the history entry at the given index (0 = oldest). */
-    historyAt(index: number): HistoryEntry<T> | undefined;
-    /** Number of snapshots currently in history. */
-    readonly historyLength: number;
-    /** Saves the current store state as an explicit undo checkpoint. */
-    push(): void;
-    /**
-     * Saves the current store state as an annotated checkpoint.
-     * Use to mark significant transitions (e.g. `'import'`, `'reset'`) so time-travel
-     * debuggers can distinguish user-initiated from programmatic mutations.
-     */
-    pushNamed(label: string): void;
-    /** Move forward one snapshot. No-op when at the most recent checkpoint. */
-    redo(): void;
-    /** The underlying store — kept as an escape hatch for adapters that need direct store access. */
-    readonly store: Store<T>;
-    /** Move back one snapshot. No-op when at the oldest checkpoint. */
-    undo(): void;
+export type EffectHandle = Disposable;
+export interface Scope extends Disposable {
+    run<T>(fn: () => T): T;
 }
-export type Subscriber = () => void;
-/** Event emitted when a signal's value changes. */
-export type WriteEvent = {
-    name: string | undefined;
-    newValue: unknown;
-    oldValue: unknown;
-};
-/** Event emitted when a computed recomputes, or when an effect runs. */
-export type NamedEvent = {
-    name: string | undefined;
-};
-/** Event emitted when a signal, computed, effect, or store is disposed. */
-export type DisposeEvent = {
-    kind: 'computed' | 'effect' | 'signal' | 'store';
-    name: string | undefined;
+export type ReactiveEvent = {
+    readonly kind: 'compute';
+    readonly name?: string;
+} | {
+    readonly kind: 'effect';
+    readonly name?: string;
+} | {
+    readonly kind: 'write';
+    readonly name?: string;
+    readonly next: unknown;
+    readonly previous: unknown;
+} | {
+    readonly kind: 'dispose';
+    readonly name?: string;
+    readonly node: 'effect' | 'scope';
 };
-/** Event emitted when a store-level mutation occurs. `path` is populated for `kind: 'lens'`. */
-export type MutateEvent = {
-    kind: 'patch' | 'replace' | 'reset' | 'lens';
-    name: string | undefined;
-    path?: string;
+export type ReactiveObserver = (event: ReactiveEvent) => void;
+export type ReactiveErrorContext = {
+    readonly kind: 'cleanup' | 'effect' | 'listener' | 'observer';
+    readonly name?: string;
 };
-export type RippleDevToolsHook = {
-    /** Called when a computed signal recomputes. */
-    compute?(event: NamedEvent): void;
-    /** Called when a signal, computed, or effect is disposed. */
-    dispose?(event: DisposeEvent): void;
-    /** Called when a store-level mutation (patch/replace/reset/lens) occurs. */
-    mutate?(event: MutateEvent): void;
-    /** Called when an effect starts running. */
-    run?(event: NamedEvent): void;
-    /** Called when a signal's value changes. */
-    write?(event: WriteEvent): void;
+export type RippleOptions = {
+    observer?: ReactiveObserver;
+    onError?: (error: unknown, context: ReactiveErrorContext) => void;
 };
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC;AACjC,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;AAC5D,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAErC,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAC7B,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI;IAC/B,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;CAClC,CAAC;AAEF,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,IAAI,CAAC,CAAC;IACV,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,WAAW,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;CACnB;AAED,MAAM,WAAW,MAAM,CAAC,CAAC,CAAE,SAAQ,QAAQ,CAAC,CAAC,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC;CACV;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,IAAI,IAAI,CAAC;IAChB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC;IACrC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;CAC1B;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC;AAEtC,MAAM,WAAW,KAAM,SAAQ,UAAU;IACvC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;CACxB;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GACtG;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAA;CAAE,CAAC;AAE5F,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAE9D,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;IAC9D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAC;CACnE,CAAC"}

package/dist/watch.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./index.cjs");exports.watch=e.watch;

package/dist/watch.d.ts

@@ -0,0 +1,3 @@
+export type { WatchOptions } from './_watch';
+export { watch } from './index';
+//# sourceMappingURL=watch.d.ts.map

package/dist/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../src/watch.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC"}

package/dist/watch.js

@@ -0,0 +1,2 @@
+import { watch as e } from "./index.js";
+export { e as watch };

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@vielzeug/ripple",
-  "version": "1.3.0",
+  "version": "2.0.0",
   "type": "module",
   "files": [
     "dist"
   ],
-  "description": "Fine-grained reactive state — signals, computed values, effects, stores, and reactive scopes",
+  "description": "Fine-grained reactive runtime — signals, derived values, effects, scopes, and optional state tools",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "dist/index.d.ts",
@@ -16,23 +16,23 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
-    "./devtools": {
-      "source": "./src/devtools.ts",
-      "types": "./dist/devtools.d.ts",
-      "import": "./dist/devtools.js",
-      "require": "./dist/devtools.cjs"
+    "./async": {
+      "source": "./src/async.ts",
+      "types": "./dist/async.d.ts",
+      "import": "./dist/async.js",
+      "require": "./dist/async.cjs"
     },
-    "./history": {
-      "source": "./src/history.ts",
-      "types": "./dist/history.d.ts",
-      "import": "./dist/history.js",
-      "require": "./dist/history.cjs"
+    "./store": {
+      "source": "./src/store.ts",
+      "types": "./dist/store.d.ts",
+      "import": "./dist/store.js",
+      "require": "./dist/store.cjs"
     },
-    "./ssr": {
-      "source": "./src/ssr/index.ts",
-      "types": "./dist/ssr/index.d.ts",
-      "import": "./dist/ssr/index.js",
-      "require": "./dist/ssr/index.cjs"
+    "./watch": {
+      "source": "./src/watch.ts",
+      "types": "./dist/watch.d.ts",
+      "import": "./dist/watch.js",
+      "require": "./dist/watch.cjs"
     }
   },
   "scripts": {
@@ -40,10 +40,11 @@
     "build:types": "tsc -p tsconfig.declarations.json",
     "fix": "eslint --fix src",
     "lint": "eslint src",
-    "prepublishOnly": "pnpm run build",
+    "prepublishOnly": "pnpm run build && pnpm run verify:exports",
     "preview": "vite preview",
     "test": "vitest",
-    "build:bundle": "vite build --config vite.bundle.config.ts"
+    "build:bundle": "vite build --config vite.bundle.config.ts",
+    "verify:exports": "node ./scripts/verify-exports.mjs"
   },
   "publishConfig": {
     "access": "public",
@@ -53,9 +54,9 @@
     "node": ">=22"
   },
   "devDependencies": {
-    "@types/node": "^26.1.0",
+    "@types/node": "^26.1.2",
     "typescript": "^6.0.3",
-    "vite": "^8.1.3",
+    "vite": "^8.2.0",
     "vitest": "^4.1.10"
   }
 }

package/dist/_dev.cjs

@@ -1,2 +0,0 @@
-var e=!globalThis.__RIPPLE_PROD__;function t(t){e&&console.warn(`[@vielzeug/ripple] ${t}`)}exports.warn=t;
-//# sourceMappingURL=_dev.cjs.map

package/dist/_dev.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"_dev.cjs","names":[],"sources":["../src/_dev.ts"],"sourcesContent":["const isDev = !(globalThis as { __RIPPLE_PROD__?: boolean }).__RIPPLE_PROD__;\n\n/** @internal @security Messages may include user-supplied data. */\nexport function warn(msg: string): void {\n  if (isDev) console.warn(`[@vielzeug/ripple] ${msg}`);\n}\n"],"mappings":"AAAA,IAAM,EAAQ,CAAE,WAA6C,gBAG7D,SAAgB,EAAK,EAAmB,CAClC,GAAO,QAAQ,KAAK,sBAAsB,GAAK,CACrD"}

package/dist/_dev.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=_dev.d.ts.map

package/dist/_dev.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"_dev.d.ts","sourceRoot":"","sources":["../src/_dev.ts"],"names":[],"mappings":""}

package/dist/_dev.js

@@ -1,9 +0,0 @@
-//#region src/_dev.ts
-var e = !globalThis.__RIPPLE_PROD__;
-function t(t) {
-	e && console.warn(`[@vielzeug/ripple] ${t}`);
-}
-//#endregion
-export { t as warn };
-
-//# sourceMappingURL=_dev.js.map

package/dist/_dev.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"_dev.js","names":[],"sources":["../src/_dev.ts"],"sourcesContent":["const isDev = !(globalThis as { __RIPPLE_PROD__?: boolean }).__RIPPLE_PROD__;\n\n/** @internal @security Messages may include user-supplied data. */\nexport function warn(msg: string): void {\n  if (isDev) console.warn(`[@vielzeug/ripple] ${msg}`);\n}\n"],"mappings":";AAAA,IAAM,IAAQ,CAAE,WAA6C;AAG7D,SAAgB,EAAK,GAAmB;CACtC,AAAI,KAAO,QAAQ,KAAK,sBAAsB,GAAK;AACrD"}

package/dist/_error-utils.cjs

@@ -1,2 +0,0 @@
-var e=e=>e instanceof Error?e:Error(`Non-Error thrown: ${String(e)}`),t=t=>{let n=[];for(let r of t)try{r()}catch(t){n.push(e(t))}return n},n=(e,n)=>{let r=t(e);if(r.length===1)throw r[0];if(r.length>0)throw AggregateError(r,n)},r=(t,n,r)=>{throw n.length===0?t:AggregateError([e(t),...n],r,{cause:e(t)})};exports.collectErrors=t,exports.ensureError=e,exports.rethrowWith=r,exports.runAll=n;
-//# sourceMappingURL=_error-utils.cjs.map

package/dist/_error-utils.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"_error-utils.cjs","names":[],"sources":["../src/_error-utils.ts"],"sourcesContent":["import type { CleanupFn } from './types';\n\n/**\n * Coerces any thrown value to an `Error`.\n * Non-Error throws (strings, numbers, etc.) are wrapped in a plain `Error`\n * with a descriptive message — they are NOT mis-branded as `RippleError`.\n */\nexport const ensureError = (error: unknown): Error =>\n  error instanceof Error ? error : new Error(`Non-Error thrown: ${String(error)}`);\n\n/**\n * Runs each fn in `fns`, collecting any thrown errors. Does NOT re-throw.\n */\nexport const collectErrors = (fns: Iterable<CleanupFn>): Error[] => {\n  const errors: Error[] = [];\n\n  for (const fn of fns) {\n    try {\n      fn();\n    } catch (e) {\n      errors.push(ensureError(e));\n    }\n  }\n\n  return errors;\n};\n\n/**\n * Runs all `fns`, collecting errors.\n * - Single error: re-throws the original error directly (preserves type + stack).\n * - Multiple errors: wraps in AggregateError with the given context label.\n */\nexport const runAll = (fns: Iterable<CleanupFn>, context: string): void => {\n  const errors = collectErrors(fns);\n\n  if (errors.length === 1) throw errors[0]!;\n\n  if (errors.length > 0) {\n    throw new AggregateError(errors, context);\n  }\n};\n\n/**\n * Re-throws `primary`, augmented with any extra errors as an AggregateError.\n * If `extras` is empty, throws `primary` directly (preserves original type + stack).\n * Otherwise, `primary` is set as the `.cause` so callers can identify the root failure.\n */\nexport const rethrowWith = (primary: unknown, extras: Error[], context: string): never => {\n  if (extras.length === 0) throw primary;\n\n  throw new AggregateError([ensureError(primary), ...extras], context, {\n    cause: ensureError(primary),\n  });\n};\n"],"mappings":"AAOA,IAAa,EAAe,GAC1B,aAAiB,MAAQ,EAAY,MAAM,qBAAqB,OAAO,CAAK,GAAG,EAKpE,EAAiB,GAAsC,CAClE,IAAM,EAAkB,CAAC,EAEzB,IAAK,IAAM,KAAM,EACf,GAAI,CACF,EAAG,CACL,OAAS,EAAG,CACV,EAAO,KAAK,EAAY,CAAC,CAAC,CAC5B,CAGF,OAAO,CACT,EAOa,GAAU,EAA0B,IAA0B,CACzE,IAAM,EAAS,EAAc,CAAG,EAEhC,GAAI,EAAO,SAAW,EAAG,MAAM,EAAO,GAEtC,GAAI,EAAO,OAAS,EAClB,MAAU,eAAe,EAAQ,CAAO,CAE5C,EAOa,GAAe,EAAkB,EAAiB,IAA2B,CAGxF,MAFI,EAAO,SAAW,EAAS,EAErB,eAAe,CAAC,EAAY,CAAO,EAAG,GAAG,CAAM,EAAG,EAAS,CACnE,MAAO,EAAY,CAAO,CAC5B,CAAC,CACH"}

package/dist/_error-utils.d.ts

@@ -1,24 +0,0 @@
-import type { CleanupFn } from './types';
-/**
- * Coerces any thrown value to an `Error`.
- * Non-Error throws (strings, numbers, etc.) are wrapped in a plain `Error`
- * with a descriptive message — they are NOT mis-branded as `RippleError`.
- */
-export declare const ensureError: (error: unknown) => Error;
-/**
- * Runs each fn in `fns`, collecting any thrown errors. Does NOT re-throw.
- */
-export declare const collectErrors: (fns: Iterable<CleanupFn>) => Error[];
-/**
- * Runs all `fns`, collecting errors.
- * - Single error: re-throws the original error directly (preserves type + stack).
- * - Multiple errors: wraps in AggregateError with the given context label.
- */
-export declare const runAll: (fns: Iterable<CleanupFn>, context: string) => void;
-/**
- * Re-throws `primary`, augmented with any extra errors as an AggregateError.
- * If `extras` is empty, throws `primary` directly (preserves original type + stack).
- * Otherwise, `primary` is set as the `.cause` so callers can identify the root failure.
- */
-export declare const rethrowWith: (primary: unknown, extras: Error[], context: string) => never;
-//# sourceMappingURL=_error-utils.d.ts.map

package/dist/_error-utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"_error-utils.d.ts","sourceRoot":"","sources":["../src/_error-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,KACqC,CAAC;AAEnF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,QAAQ,CAAC,SAAS,CAAC,KAAG,KAAK,EAY7D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,KAAK,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,KAAG,IAQlE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS,OAAO,EAAE,QAAQ,KAAK,EAAE,EAAE,SAAS,MAAM,KAAG,KAMhF,CAAC"}

package/dist/_error-utils.js

@@ -1,20 +0,0 @@
-//#region src/_error-utils.ts
-var e = (e) => e instanceof Error ? e : /* @__PURE__ */ Error(`Non-Error thrown: ${String(e)}`), t = (t) => {
-	let n = [];
-	for (let r of t) try {
-		r();
-	} catch (t) {
-		n.push(e(t));
-	}
-	return n;
-}, n = (e, n) => {
-	let r = t(e);
-	if (r.length === 1) throw r[0];
-	if (r.length > 0) throw AggregateError(r, n);
-}, r = (t, n, r) => {
-	throw n.length === 0 ? t : AggregateError([e(t), ...n], r, { cause: e(t) });
-};
-//#endregion
-export { t as collectErrors, e as ensureError, r as rethrowWith, n as runAll };
-
-//# sourceMappingURL=_error-utils.js.map

package/dist/_error-utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"_error-utils.js","names":[],"sources":["../src/_error-utils.ts"],"sourcesContent":["import type { CleanupFn } from './types';\n\n/**\n * Coerces any thrown value to an `Error`.\n * Non-Error throws (strings, numbers, etc.) are wrapped in a plain `Error`\n * with a descriptive message — they are NOT mis-branded as `RippleError`.\n */\nexport const ensureError = (error: unknown): Error =>\n  error instanceof Error ? error : new Error(`Non-Error thrown: ${String(error)}`);\n\n/**\n * Runs each fn in `fns`, collecting any thrown errors. Does NOT re-throw.\n */\nexport const collectErrors = (fns: Iterable<CleanupFn>): Error[] => {\n  const errors: Error[] = [];\n\n  for (const fn of fns) {\n    try {\n      fn();\n    } catch (e) {\n      errors.push(ensureError(e));\n    }\n  }\n\n  return errors;\n};\n\n/**\n * Runs all `fns`, collecting errors.\n * - Single error: re-throws the original error directly (preserves type + stack).\n * - Multiple errors: wraps in AggregateError with the given context label.\n */\nexport const runAll = (fns: Iterable<CleanupFn>, context: string): void => {\n  const errors = collectErrors(fns);\n\n  if (errors.length === 1) throw errors[0]!;\n\n  if (errors.length > 0) {\n    throw new AggregateError(errors, context);\n  }\n};\n\n/**\n * Re-throws `primary`, augmented with any extra errors as an AggregateError.\n * If `extras` is empty, throws `primary` directly (preserves original type + stack).\n * Otherwise, `primary` is set as the `.cause` so callers can identify the root failure.\n */\nexport const rethrowWith = (primary: unknown, extras: Error[], context: string): never => {\n  if (extras.length === 0) throw primary;\n\n  throw new AggregateError([ensureError(primary), ...extras], context, {\n    cause: ensureError(primary),\n  });\n};\n"],"mappings":";AAOA,IAAa,KAAe,MAC1B,aAAiB,QAAQ,IAAQ,gBAAI,MAAM,qBAAqB,OAAO,CAAK,GAAG,GAKpE,KAAiB,MAAsC;CAClE,IAAM,IAAkB,CAAC;CAEzB,KAAK,IAAM,KAAM,GACf,IAAI;EACF,EAAG;CACL,SAAS,GAAG;EACV,EAAO,KAAK,EAAY,CAAC,CAAC;CAC5B;CAGF,OAAO;AACT,GAOa,KAAU,GAA0B,MAA0B;CACzE,IAAM,IAAS,EAAc,CAAG;CAEhC,IAAI,EAAO,WAAW,GAAG,MAAM,EAAO;CAEtC,IAAI,EAAO,SAAS,GAClB,MAAU,eAAe,GAAQ,CAAO;AAE5C,GAOa,KAAe,GAAkB,GAAiB,MAA2B;CAGxF,MAFI,EAAO,WAAW,IAAS,IAErB,eAAe,CAAC,EAAY,CAAO,GAAG,GAAG,CAAM,GAAG,GAAS,EACnE,OAAO,EAAY,CAAO,EAC5B,CAAC;AACH"}

package/dist/_virtual/_rolldown/runtime.js

@@ -1,7 +0,0 @@
-//#region \0rolldown/runtime.js
-var e = /* @__PURE__ */ ((e) => typeof require < "u" ? require : typeof Proxy < "u" ? new Proxy(e, { get: (e, t) => (typeof require < "u" ? require : e)[t] }) : e)(function(e) {
-	if (typeof require < "u") return require.apply(this, arguments);
-	throw Error("Calling `require` for \"" + e + "\" in an environment that doesn't expose the `require` function. See https://rolldown.rs/in-depth/bundling-cjs#require-external-modules for more details.");
-});
-//#endregion
-export { e as __require };

package/dist/async-computed.cjs

@@ -1,2 +0,0 @@
-const e=require("./devtools-hook.cjs"),t=require("./symbols.cjs"),n=require("./tracking.cjs"),r=require("./effect.cjs"),i=require("./signal.cjs");var a=(a,o)=>{let s=o?.name,c=i.signal({data:o?.initialValue,status:`loading`},s?{name:s}:void 0),l=i.signal(0),u=null,d=!1,f=r.effect(()=>{l.value,e.getDevToolsHook()?.compute?.({name:s}),u?.abort(),u=new AbortController;let{signal:t}=u,n=c.peek(),r=`data`in n?n.data:void 0;c.value={data:r,status:`loading`},(async()=>{try{let e=await a(t);!t.aborted&&!d&&(c.value={data:e,status:`ready`})}catch(e){!t.aborted&&!d&&(c.value={data:r,error:e,status:`error`})}})()},{name:s,[t.SUPPRESS_RUN_EVENT]:!0}),p=()=>{d||(l.value=l.peek()+1)},m=()=>{d||(d=!0,u?.abort(),f.dispose(),c.dispose(),l.dispose())};return n.autoRegisterDisposal(m),{dispose:m,get disposed(){return d},[t.IS_COMPUTED]:!0,[t.IS_SIGNAL]:!0,get name(){return c.name},peek:()=>c.peek(),refresh:p,subscribe:e=>c.subscribe(e),[Symbol.dispose]:m,get value(){return c.value}}};exports.resource=a;
-//# sourceMappingURL=async-computed.cjs.map

package/dist/async-computed.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"async-computed.cjs","names":[],"sources":["../src/async-computed.ts"],"sourcesContent":["import type { Resource, ResourceOptions, ResourceState } from './types';\n\nimport { getDevToolsHook } from './devtools-hook';\nimport { effect } from './effect';\nimport { signal } from './signal';\nimport { IS_COMPUTED, IS_SIGNAL, SUPPRESS_RUN_EVENT } from './symbols';\nimport { autoRegisterDisposal } from './tracking';\n\n/**\n * Creates a reactive async resource that emits a `ResourceState<T>` discriminated union.\n *\n * Dependencies are tracked synchronously in the factory (before the first `await`).\n * The factory receives an `AbortSignal` that fires when dependencies change or\n * the resource is disposed, cancelling any in-flight work.\n *\n * If `resource()` is created inside an active `effect()` or `scope.run()` context,\n * it is automatically registered for cleanup and disposed with that context —\n * matching `computed()`'s auto-disposal behavior.\n *\n * Call `refresh()` to force the factory to re-run immediately, even if no tracked\n * dependency changed — useful for manual \"retry\"/\"refetch\" actions.\n *\n * @example\n * ```ts\n * const userId = signal('u1');\n * const user = resource(async (signal) => {\n *   const id = userId.value; // tracked dep — re-runs when userId changes\n *   return fetchUser(id, { signal });\n * });\n *\n * effect(() => {\n *   const s = user.value;\n *   if (s.status === 'loading') return showSpinner();\n *   if (s.status === 'error')   return showError(s.error);\n *   renderUser(s.data);\n * });\n *\n * user.refresh(); // force a re-fetch without changing userId\n * user.dispose();\n * ```\n */\nexport const resource = <T>(\n  factory: (abortSignal: AbortSignal) => Promise<T>,\n  options?: ResourceOptions<T>,\n): Resource<T> => {\n  const name = options?.name;\n  const state = signal<ResourceState<T>>(\n    { data: options?.initialValue, status: 'loading' },\n    name ? { name } : undefined,\n  );\n  // Internal-only trigger — never exposed. Read (but never written to a meaningful\n  // value) inside the effect purely so it becomes a tracked dep; refresh() bumps it\n  // to force a re-run without requiring a real dependency to change.\n  const epoch = signal(0);\n\n  let controller: AbortController | null = null;\n  let disposed = false;\n\n  // Built unannotated and passed by reference (not as an inline literal) so TypeScript\n  // checks it structurally against EffectOptions instead of excess-property-checking\n  // the SUPPRESS_RUN_EVENT symbol key that isn't part of the public type.\n  const internalEffectOptions = { name, [SUPPRESS_RUN_EVENT]: true };\n  const stop = effect(() => {\n    void epoch.value;\n\n    // A resource is a derived value like computed() — emit the same 'compute' event\n    // computed.ts fires before recomputing, so DevTools sees a resource re-run as a\n    // derived-value recompute. SUPPRESS_RUN_EVENT below stops the internal effect from\n    // also firing its own 'run' for the same re-run — one signal per re-run, not two.\n    getDevToolsHook()?.compute?.({ name });\n\n    controller?.abort();\n    controller = new AbortController();\n\n    const { signal: abortSignal } = controller;\n\n    const current = state.peek();\n    const prevData = 'data' in current ? current.data : undefined;\n\n    state.value = { data: prevData, status: 'loading' };\n\n    void (async () => {\n      try {\n        const result = await factory(abortSignal);\n\n        if (!abortSignal.aborted && !disposed) {\n          state.value = { data: result, status: 'ready' };\n        }\n      } catch (err) {\n        if (!abortSignal.aborted && !disposed) {\n          state.value = { data: prevData, error: err, status: 'error' };\n        }\n      }\n    })();\n  }, internalEffectOptions);\n\n  const refresh = (): void => {\n    if (disposed) return;\n\n    epoch.value = epoch.peek() + 1;\n  };\n\n  const dispose = (): void => {\n    if (disposed) return;\n\n    disposed = true;\n    controller?.abort();\n    stop.dispose();\n    state.dispose();\n    epoch.dispose();\n  };\n\n  autoRegisterDisposal(dispose);\n\n  // Built unannotated (the brand symbols aren't part of Resource<T>, and annotating the\n  // literal directly would trip excess-property checking on it) then assigned to a\n  // Resource<T>-typed binding — a structural check, not a cast, so a future member added\n  // to Computed<T>/Resource<T> fails this assignment at compile time instead of silently\n  // going missing.\n  const impl = {\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    [IS_COMPUTED]: true as const,\n    [IS_SIGNAL]: true as const,\n    get name() {\n      return state.name;\n    },\n    peek: () => state.peek(),\n    refresh,\n    subscribe: (listener: () => void) => state.subscribe(listener),\n    [Symbol.dispose]: dispose,\n    get value() {\n      return state.value;\n    },\n  };\n  const handle: Resource<T> = impl;\n\n  return handle;\n};\n"],"mappings":"kJAyCA,IAAa,GACX,EACA,IACgB,CAChB,IAAM,EAAO,GAAS,KAChB,EAAQ,EAAA,OACZ,CAAE,KAAM,GAAS,aAAc,OAAQ,SAAU,EACjD,EAAO,CAAE,MAAK,EAAI,IAAA,EACpB,EAIM,EAAQ,EAAA,OAAO,CAAC,EAElB,EAAqC,KACrC,EAAW,GAMT,EAAO,EAAA,WAAa,CACxB,EAAW,MAMX,EAAA,gBAAgB,CAAC,EAAE,UAAU,CAAE,MAAK,CAAC,EAErC,GAAY,MAAM,EAClB,EAAa,IAAI,gBAEjB,GAAM,CAAE,OAAQ,GAAgB,EAE1B,EAAU,EAAM,KAAK,EACrB,EAAW,SAAU,EAAU,EAAQ,KAAO,IAAA,GAEpD,EAAM,MAAQ,CAAE,KAAM,EAAU,OAAQ,SAAU,GAE5C,SAAY,CAChB,GAAI,CACF,IAAM,EAAS,MAAM,EAAQ,CAAW,EAEpC,CAAC,EAAY,SAAW,CAAC,IAC3B,EAAM,MAAQ,CAAE,KAAM,EAAQ,OAAQ,OAAQ,EAElD,OAAS,EAAK,CACR,CAAC,EAAY,SAAW,CAAC,IAC3B,EAAM,MAAQ,CAAE,KAAM,EAAU,MAAO,EAAK,OAAQ,OAAQ,EAEhE,CACF,EAAA,CAAG,CACL,EAAG,CAjC6B,QAAO,EAAA,oBAAqB,EAiCzD,CAAqB,EAElB,MAAsB,CACtB,IAEJ,EAAM,MAAQ,EAAM,KAAK,EAAI,EAC/B,EAEM,MAAsB,CACtB,IAEJ,EAAW,GACX,GAAY,MAAM,EAClB,EAAK,QAAQ,EACb,EAAM,QAAQ,EACd,EAAM,QAAQ,EAChB,EA6BA,OA3BA,EAAA,qBAAqB,CAAO,EA2BrB,CAnBL,UACA,IAAI,UAAW,CACb,OAAO,CACT,GACC,EAAA,aAAc,IACd,EAAA,WAAY,GACb,IAAI,MAAO,CACT,OAAO,EAAM,IACf,EACA,SAAY,EAAM,KAAK,EACvB,UACA,UAAY,GAAyB,EAAM,UAAU,CAAQ,GAC5D,OAAO,SAAU,EAClB,IAAI,OAAQ,CACV,OAAO,EAAM,KACf,CAIK,CACT"}