@manyducks.co/dolla 2.0.0-alpha.61 → 2.0.0-alpha.63

package/README.md

@@ -35,44 +35,38 @@ Dolla's goals include:
 A basic view. Note that the view function is called exactly once when the view is first mounted. All changes to DOM nodes thereafter happen as a result of `$state` values changing.
 
 ```jsx
-import { $, when, mount } from "@manyducks.co/dolla";
+import { $, effect, when, mount } from "@manyducks.co/dolla";
 
 function Counter(props, ctx) {
   const $count = $(0);
 
-  // An effect will re-run whenever any signal value accessed inside it changes.
-  ctx.effect(() => {
-    console.log(`Count is: ${$count()}`);
+  effect(() => {
+    console.log("Count is: " + $count());
+    // An effect will re-run whenever any signal accessed inside it receives a new value.
   });
 
-  function increment() {
-    // Pass a function that takes the current value and returns a new one.
-    $count((x) => x + 1);
+  function reset() {
+    $count.set(0);
   }
 
-  function decrement() {
-    $count((x) => x - 1);
+  function increment() {
+    $count.set((current) => current + 1);
   }
 
-  function reset() {
-    // Set state directly by passing a (non-function) value.
-    $count(0);
+  function decrement() {
+    $count.set((current) => current - 1);
   }
 
   return (
     <div>
-      {/* Signals can be slotted into the DOM to render them */}
       <p>Counter: {$count}</p>
+      {/* Signals can be slotted into the DOM to render them */}
+
       <div>
-        <button on:click={increment}>+1</button>
-        <button on:click={decrement}>-1</button>
+        <button onClick={increment}>+1</button>
+        <button onClick={decrement}>-1</button>
+        <button onClick={reset}>Reset</button>
       </div>
-
-      {/* We can derive a new signal on the fly and conditionally render something based on that condition */}
-      {when(
-        $(() => $count() > 10),
-        <span>That's a lot of clicks!</span>,
-      )}
     </div>
   );
 }
@@ -95,8 +89,8 @@ function MessageStore(options, ctx) {
   // Context objects contain methods for controlling the component, logging and attaching lifecycle hooks.
 
   return {
-    message: $(() => message()),
-    setMessage: (value: string) => message(value),
+    $message: $(() => message()),
+    setMessage: (value: string) => message.set(value.toUpperCase()),
   };
 }
 
@@ -104,7 +98,7 @@ function App(props, ctx) {
   // Provide a store for this and all child views.
   ctx.addStore(MessageStore);
 
-  const { message, setMessage } = ctx.getStore(MessageStore);
+  const { $message, setMessage } = ctx.getStore(MessageStore);
   // Provides a MessageStore on this context and any child contexts.
   // When a store is provided its value is returned right away.
 
@@ -116,8 +110,8 @@ function App(props, ctx) {
 
       <input
         type="text"
-        value={message}
-        on:input={(e) => {
+        value={$message}
+        onInput={(e) => {
           setMessage(e.currentTarget.value);
         }}
       />

package/dist/core/context.d.ts

@@ -52,6 +52,22 @@ declare class ContextLifecycle {
      */
     private notify;
 }
+export interface ContextGetStateOptions<T> {
+    fallback?: T;
+    /**
+     * Only check this context; skip parent contexts.
+     */
+    immediate?: boolean;
+}
+export interface ContextGetStateOptionsWithFallbackValue<T> extends ContextGetStateOptions<T> {
+    fallback: T;
+}
+export interface ContextGetStateMapOptions {
+    /**
+     * Only include state from this context; skip parent contexts.
+     */
+    immediate?: boolean;
+}
 export interface ContextOptions {
     logger?: LoggerOptions;
 }
@@ -118,17 +134,20 @@ export declare class Context implements Logger {
     onUnmount(listener: LifecycleListener): () => void;
     effect(callback: EffectFn): UnsubscribeFn;
     /**
-     * Gets the value stored at `key`, or returns the `defaultValue` if none is set.
+     * Gets the value stored at `key`, or returns `options.fallback` if none is set.
      */
-    getState<T>(key: any, defaultValue: T): T;
+    getState<T>(key: any, options: ContextGetStateOptionsWithFallbackValue<T>): T;
     /**
      * Gets the value stored at `key`, or throws an error if none is set.
      */
-    getState<T>(key: any): T;
+    getState<T>(key: any, options?: ContextGetStateOptions<T>): T;
     /**
      * Returns a Map containing all state values available to this context.
+     *
+     * Pass `options.immediate` to only include state stored on this context.
+     * By default all state stored on parent contexts is also included.
      */
-    getState(): Map<any, any>;
+    getStateMap(options?: ContextGetStateMapOptions): Map<any, any>;
     /**
      * Stores `value` at `key` in this context's state.
      */

package/dist/core/index.d.ts

@@ -1,9 +1,11 @@
-export { $, batch, effect, get, untracked } from "./signals.js";
-export type { MaybeSignal, Signal, Source } from "./signals.js";
+export { $, batch, effect, get, memo, writable, untracked } from "./signals.js";
+export type { MaybeSignal, Writable, Signal } from "./signals.js";
 export { createContext } from "./context.js";
 export type { Context } from "./context.js";
-export { m, MarkupNode, portal, render, repeat, unless, when } from "./markup.js";
+export { m, Markup, MarkupNode, portal, render, repeat, unless, when } from "./markup.js";
 export { ref, type Ref } from "./ref.js";
+export { For, type ForProps } from "./views/for.js";
+export { Show, type ShowProps } from "./views/show.js";
 export { mount, type UnmountFn } from "./mount.js";
 export { deepEqual, shallowEqual, strictEqual } from "../utils.js";
 export { getEnv, setEnv } from "./env.js";

package/dist/core/markup.d.ts

@@ -2,30 +2,25 @@ import type { IntrinsicElements, Renderable, View } from "../types.js";
 import { Context } from "./context.js";
 import { MarkupNode } from "./nodes/_markup.js";
 import { KeyFn, RenderFn } from "./nodes/repeat.js";
-import { type MaybeSignal, type Signal } from "./signals.js";
+import { type Signal, type MaybeSignal } from "./signals.js";
 export { MarkupNode };
+type PropsOf<V extends string | View<any>> = V extends View<infer U> ? U : any;
 /**
  * `Markup` is a set of metadata that will be constructed into a `MarkupNode`.
  */
-export declare class Markup<P = any> {
+export declare class Markup<Type extends string | View<any> = string | View<any>> {
     /**
      * In the case of a view, type will be the View function itself. It can also hold an identifier for special nodes like "$cond", "$repeat", etc.
      * DOM nodes can be created by name, such as HTML elements like "div", "ul" or "span", SVG elements like ""
      */
-    type: string | View<P>;
+    type: Type;
     /**
      * Data that will be passed to a new MarkupNode instance when it is constructed.
      * Includes a `children` prop if children were passed.
      */
-    props: P | undefined;
-    constructor(type: string | View<P>, props?: P);
+    props: PropsOf<Type>;
+    constructor(type: Type, props: PropsOf<Type>);
 }
-/**
- * A node that can be mounted by the Markup layout engine.
- * Implemented by the built in nodes, but can of course also be implemented to create your own custom nodes.
- *
- * A `MarkupNode` instance can be passed anywhere a `Renderable` is required.
- */
 export declare enum MarkupType {
     DOM = "$dom",
     Dynamic = "$dynamic",

package/dist/core/nodes/dynamic.d.ts

@@ -1,5 +1,5 @@
 import type { Context } from "../context.js";
-import { type Signal } from "../signals.js";
+import { Signal } from "../signals.js";
 import { MarkupNode } from "./_markup.js";
 /**
  * Renders any kind of content; markup, signals, DOM nodes, etc.
@@ -9,9 +9,9 @@ export declare class DynamicNode extends MarkupNode {
     private root;
     private children;
     private context;
-    private $slot;
+    private slot;
     private unsubscribe?;
-    constructor(context: Context, $slot: Signal<any>);
+    constructor(context: Context, slot: Signal<any>);
     getRoot(): Text;
     isMounted(): boolean;
     mount(parent: Node, after?: Node): void;

package/dist/core/nodes/element.d.ts

@@ -5,6 +5,7 @@ import { MarkupNode } from "./_markup.js";
  */
 export declare class ElementNode extends MarkupNode {
     private root;
+    private id;
     readonly tag: string;
     readonly props: Record<string, any>;
     private context;
@@ -19,6 +20,7 @@ export declare class ElementNode extends MarkupNode {
     unmount(skipDOM?: boolean): void;
     move(parent: Element, after?: Node): void;
     private attachProp;
+    private getKey;
     private applyProps;
     private applyStyles;
     private applyClasses;

package/dist/core/nodes/repeat.d.ts

@@ -2,7 +2,7 @@ import type { Renderable } from "../../types.js";
 import type { Context } from "../context.js";
 import { type Signal } from "../signals.js";
 import { MarkupNode } from "./_markup.js";
-export type Key = string | number | symbol;
+export type Key = any;
 export type KeyFn<T> = (item: T, index: number) => Key;
 export type RenderFn<T> = (item: Signal<T>, index: Signal<number>, ctx: Context) => Renderable;
 /**

package/dist/core/nodes/view.d.ts

@@ -6,10 +6,10 @@ export declare const VIEW: unique symbol;
  * Renders a View.
  */
 export declare class ViewNode<P> extends MarkupNode {
-    uniqueId: string;
-    context: Context;
-    props: P;
-    view: View<P>;
+    readonly id: string;
+    readonly props: P;
+    readonly context: Context;
+    readonly view: View<P>;
     node?: MarkupNode;
     /**
      * @param context - Parent contenxt to link to.

package/dist/core/scheduler.d.ts

@@ -0,0 +1,17 @@
+export type Callback = () => void;
+/**
+ * Centralized scheduling for DOM updates.
+ */
+declare class Scheduler {
+    #private;
+    /**
+     * Schedules an update on the next tick. If `key` is supplied, this update will replace any scheduled update with the same key.
+     */
+    scheduleUpdate(update: Callback, key?: string): void;
+    /**
+     * Registers a callback to run after all processing has finished in the next tick.
+     */
+    nextTick(callback: Callback): void;
+}
+declare const _default: Scheduler;
+export default _default;

package/dist/core/signals.d.ts

@@ -1,23 +1,30 @@
 import { Context } from "./context";
-interface ComputedGetterState<T> {
-    value?: T;
-}
 export declare function getCurrentContext(): Context | undefined;
 export declare function setCurrentContext(context: Context | undefined): Context | undefined;
 /**
- * A getter that returns the current value held within the signal.
- * If called inside a trackable scope this signal will be tracked as a dependency.
+ * A function that returns the current value of a signal.
+ * Automatically tracked as a dependency when called within a tracking scope (such as `memo` or `effect` functions).
  */
 export interface Signal<T> {
     (): T;
 }
 /**
- * Extends Signal with the ability to pass a value or an updater function to change the Signal's value.
+ * A function that sets the value of the signal.
  */
-export interface Source<T> extends Signal<T> {
+export interface Setter<T> {
     (value: T): void;
-    (updater: (value: T) => T): void;
+    (update: (current: T) => T): void;
+}
+/**
+ * A getter and setter in a single object. Callable like a getter, but includes a `set` method for updating the signal's value.
+ */
+export interface Writable<T> extends Signal<T> {
+    set: Setter<T>;
 }
+/**
+ * Utility type for a value that may be a getter or a plain value.
+ * This value can be unwrapped to a plain value with `get` or `untracked` (depending on whether you're in a tracking context and need to track it).
+ */
 export type MaybeSignal<T> = Signal<T> | T;
 export type EqualityFn<T> = (current: T, next: T) => boolean;
 export interface SignalOptions<T> {
@@ -26,6 +33,26 @@ export interface SignalOptions<T> {
      */
     equals?: EqualityFn<T>;
 }
+export declare function $<T>(compute: (previousValue?: T) => MaybeSignal<T>, options?: MemoOptions<T>): Signal<T>;
+export declare function $<T>(): Writable<T | undefined>;
+export declare function $<T>(value: undefined, options: SignalOptions<T | undefined>): Writable<T | undefined>;
+export declare function $<T>(value: T, options?: SignalOptions<T>): Writable<T>;
+export declare function writable<T>(): Writable<T | undefined>;
+export declare function writable<T>(value: undefined, options: SignalOptions<T | undefined>): Writable<T | undefined>;
+export declare function writable<T>(value: T, options?: SignalOptions<T>): Writable<T>;
+export interface MemoOptions<T> extends SignalOptions<T> {
+    /**
+     * An array of signals this `memo` depends on. If this is passed, calls to signals within `fn` will NOT be tracked.
+     * Instead the `deps` array will be tracked and `fn` will re-run when any value in `deps` changes.
+     */
+    deps?: Signal<any>[];
+}
+/**
+ * Creates a derived Signal that recomputes its value only when its dependencies change.
+ * Dependencies are tracked when called inside `fn` by default,
+ * but can be overridden by passing a `deps` array in the options object.
+ */
+export declare function memo<T>(fn: (previousValue?: T) => MaybeSignal<T>, options?: MemoOptions<T>): Signal<T>;
 /**
  * Suspends effects during `fn`. Effects for all updated Signal values are called at the end of the batch.
  */
@@ -43,6 +70,18 @@ export declare function get<T>(value: MaybeSignal<T>): T;
  */
 export type EffectFn = () => void | (() => void);
 export type UnsubscribeFn = () => void;
+export declare const INTERNAL_EFFECT: unique symbol;
+export interface EffectOptions {
+    /**
+     * An array of signals this effect depends on. If this is passed, calls to signals within `fn` will NOT be tracked.
+     * Instead the `deps` array will be tracked and `fn` will re-run when any value in `deps` changes.
+     */
+    deps?: Signal<any>[];
+    /**
+     * For internal use.
+     */
+    _type?: symbol;
+}
 /**
  * Creates a tracked scope that re-runs whenever the values of any tracked reactives changes.
  * Reactives are tracked by accessing their `value` within the body of the function.
@@ -50,9 +89,4 @@ export type UnsubscribeFn = () => void;
  * NOTE: You must call the unsubscribe function to stop watching for changes.
  * If you are using an effect inside a View or Store, use `ctx.effect` instead, which cleans up automatically when the component unmounts.
  */
-export declare function effect(fn: EffectFn): UnsubscribeFn;
-export declare function $<T>(compute: (this: ComputedGetterState<T>) => MaybeSignal<T>, options?: SignalOptions<T>): Signal<T>;
-export declare function $<T>(value: T, options?: SignalOptions<T>): Source<T>;
-export declare function $<T>(value: undefined, options?: SignalOptions<T>): Source<T | undefined>;
-export declare function $<T>(): Source<T | undefined>;
-export {};
+export declare function effect(fn: EffectFn, options?: EffectOptions): UnsubscribeFn;

package/dist/core/views/default-crash-view.d.ts

@@ -22,4 +22,4 @@ export interface CrashViewProps {
 /**
  * The crash view displayed unless you specify your own.
  */
-export declare function DefaultCrashView(props: CrashViewProps): import("../markup.js").Markup<any>;
+export declare function DefaultCrashView(props: CrashViewProps): import("../markup.js").Markup<string | import("../index.js").View<any>>;

package/dist/core/views/for.d.ts

@@ -0,0 +1,23 @@
+import type { Renderable } from "../../types";
+import type { Context } from "../context";
+import { type Key, RepeatNode } from "../nodes/repeat";
+import { type Signal } from "../signals";
+export interface ForProps<T> {
+    /**
+     * An array of items to render.
+     */
+    each: Signal<T[]>;
+    /**
+     * A function to extract a unique key that identifies each item.
+     * If no `key` function is passed, object identity (===) will be used.
+     */
+    key?: (item: T, index: number) => Key;
+    /**
+     * A render function. Takes the item and its index in signal form and returns something to display for each item.
+     */
+    children: (item: Signal<T>, index: Signal<number>, ctx: Context) => Renderable;
+}
+/**
+ *
+ */
+export declare function For<T>(props: ForProps<T>, context: Context): RepeatNode<T>;

package/dist/core/views/show.d.ts

@@ -0,0 +1,26 @@
+import type { Renderable } from "../../types";
+import type { Context } from "../context";
+import { DynamicNode } from "../nodes/dynamic";
+import { type Signal } from "../signals";
+export interface ShowProps {
+    /**
+     * If present, children will be rendered only when this signal holds a truthy value.
+     */
+    when?: Signal<any>;
+    /**
+     * If present, children will be rendered only when this signal holds a falsy value.
+     */
+    unless?: Signal<any>;
+    /**
+     * Content to render if conditions permit.
+     */
+    children: Renderable;
+    /**
+     * Content to render when conditions don't permit `children` to render.
+     */
+    fallback?: Renderable;
+}
+/**
+ * Conditionally display children.
+ */
+export declare function Show(props: ShowProps, context: Context): DynamicNode;

package/dist/hooks/index.d.ts

@@ -1,5 +1,5 @@
 import { Context, Logger, type Ref, type Store } from "../core";
-import { type EffectFn, MaybeSignal, type Signal } from "../core/signals";
+import { type EffectFn, Signal, MaybeSignal, Setter, SignalOptions } from "../core/signals";
 /**
  * Returns the Context object of the View, Store or Mixin this hook is called in.
  */
@@ -10,21 +10,18 @@ export declare function useContext(): Context;
  */
 export declare function useLogger(name?: MaybeSignal<string>): Logger;
 /**
- * Sets the value of the Signal it is bound to.
+ * Creates a new read-only Getter and a bound Setter function.
  */
-export interface Setter<T> {
-    (value: T): void;
-    (fn: (current: T) => T): void;
-}
+export declare function useState<T>(value: T, options?: SignalOptions<T>): [Signal<T>, Setter<T>];
 /**
  * Creates a new read-only Signal and a bound Setter function.
  */
-export declare function useState<T>(value: T): [Signal<T>, Setter<T>];
+export declare function useState<T>(value: undefined, options: SignalOptions<T>): [Signal<T | undefined>, Setter<T | undefined>];
 /**
  * Creates a new read-only Signal and a bound Setter function.
  */
 export declare function useState<T>(): [Signal<T | undefined>, Setter<T | undefined>];
-export declare function useMemo<T>(compute: (current?: T) => T, deps?: Signal<any>[]): Signal<T>;
+export declare function useMemo<T>(compute: (current?: T) => MaybeSignal<T>, deps?: Signal<any>[], options?: SignalOptions<T>): Signal<T>;
 export declare function useEffect(fn: EffectFn, deps?: Signal<any>[]): void;
 /**
  * Takes the current state and a dispatched action. Returns a new state based on the action.

package/dist/hooks.js

@@ -1,69 +1,64 @@
-import { $ as u, g as c, u as s, c as a } from "./signals-gCwiIe5X.js";
-import { r as x } from "./ref-BD79iqlg.js";
+import { w as s, m as f, g as i, u as a, h as x } from "./signals-DbDmN2gr.js";
+import { r as m } from "./ref-BD79iqlg.js";
 function o() {
-  const t = a();
+  const t = x();
   if (!t)
     throw new Error("No context found; hooks can only be called in the body of a View, Store or Mixin.");
   return t;
 }
-function m(t) {
+function p(t) {
   const e = o();
   return t && e.setName(t), e;
 }
-function l(t) {
+function d(t, e) {
   o();
-  const e = u(t);
-  return [() => e(), e];
+  const n = s(t, e);
+  return [() => n(), n.set];
 }
-function p(t, e) {
-  return o(), e ? u(function() {
-    for (const n of e) c(n);
-    return s(() => t(this.value));
-  }) : u(function() {
-    return t(this.value);
-  });
+function w(t, e, n) {
+  return o(), f(t, { ...n, deps: e });
 }
 function S(t, e) {
   const n = o();
   e ? n.effect(() => {
-    for (const r of e) c(r);
-    s(t);
+    for (const c of e) i(c);
+    a(t);
   }) : n.effect(t);
 }
-function v(t, e) {
-  const [n, r] = l(e);
-  return [n, (f) => {
-    r((i) => t(i, f));
+function b(t, e) {
+  const [n, c] = d(e);
+  return [n, (r) => {
+    c((u) => t(u, r));
   }];
 }
 function M(t) {
   return o().getStore(t);
 }
-function b(...t) {
+function y(...t) {
   o();
-  const e = x(...t);
+  const e = m(...t);
   return Object.defineProperty(e, "current", { get: e, set: e }), e;
 }
-function w(t) {
+function C(t) {
   const e = o();
   e.onMount(() => {
     const n = t();
     n && e.onUnmount(n);
   });
 }
-function y(t) {
+function R(t) {
   o().onUnmount(t);
 }
 export {
   o as useContext,
   S as useEffect,
-  m as useLogger,
-  p as useMemo,
-  w as useMount,
-  v as useReducer,
-  b as useRef,
-  l as useState,
+  p as useLogger,
+  w as useMemo,
+  C as useMount,
+  b as useReducer,
+  y as useRef,
+  d as useState,
   M as useStore,
-  y as useUnmount
+  R as useUnmount
 };
 //# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","sources":["../src/hooks/index.ts"],"sourcesContent":["import { Context, Logger, ref, type Ref, type Store } from \"../core\";\nimport { $, type EffectFn, get, getCurrentContext, MaybeSignal, type Signal, untracked } from \"../core/signals\";\n\n/**\n * Returns the Context object of the View, Store or Mixin this hook is called in.\n */\nexport function useContext(): Context {\n  const context = getCurrentContext();\n  if (!context) {\n    throw new Error(`No context found; hooks can only be called in the body of a View, Store or Mixin.`);\n  }\n  return context;\n}\n\n/**\n * Returns a logger. If a name is passed it will be used as a prefix for all console messages.\n * Otherwise the default name of the context will be used.\n */\nexport function useLogger(name?: MaybeSignal<string>): Logger {\n  const context = useContext();\n  if (name) context.setName(name);\n  return context;\n}\n\n/**\n * Sets the value of the Signal it is bound to.\n */\nexport interface Setter<T> {\n  (value: T): void;\n  (fn: (current: T) => T): void;\n}\n\n/**\n * Creates a new read-only Signal and a bound Setter function.\n */\nexport function useState<T>(value: T): [Signal<T>, Setter<T>];\n\n/**\n * Creates a new read-only Signal and a bound Setter function.\n */\nexport function useState<T>(): [Signal<T | undefined>, Setter<T | undefined>];\n\nexport function useState<T>(value?: T): [Signal<T>, Setter<T>] {\n  useContext(); // assert that we're in a valid context\n  const $value = $(value);\n  return [() => $value() as T, $value];\n}\n\nexport function useMemo<T>(compute: (current?: T) => T, deps?: Signal<any>[]): Signal<T> {\n  useContext(); // assert that we're in a valid context\n  if (deps) {\n    return $(function () {\n      // Track deps and run `compute` untracked.\n      for (const dep of deps) get(dep);\n      return untracked(() => compute(this.value));\n    });\n  } else {\n    return $(function () {\n      return compute(this.value);\n    });\n  }\n}\n\nexport function useEffect(fn: EffectFn, deps?: Signal<any>[]): void {\n  const context = useContext();\n  if (deps) {\n    context.effect(() => {\n      // Track deps and run `fn` untracked.\n      for (const dep of deps) get(dep);\n      untracked(fn);\n    });\n  } else {\n    context.effect(fn);\n  }\n}\n\n// TODO: What would layout effect even mean in dolla?\n// export function useLayoutEffect() {}\n\n/**\n * Takes the current state and a dispatched action. Returns a new state based on the action.\n * Typically the body of this function will be a large switch statement.\n */\nexport type ReducerFn<State, Action> = (state: State, action: Action) => State;\n\n/**\n * Dispatches an action to this reducer, causing the state to update.\n */\nexport type DispatchFn<Action> = (action: Action) => void;\n\n/**\n *\n */\nexport function useReducer<State, Action>(\n  reducer: ReducerFn<State, Action>,\n  initialState: State,\n): [Signal<State>, DispatchFn<Action>] {\n  const [state, setState] = useState(initialState);\n  const dispatch = (action: Action) => {\n    setState((current) => reducer(current, action));\n  };\n  return [state, dispatch];\n}\n\n/**\n * Uses a previously added Store. Takes the Store function itself and returns the nearest instance.\n */\nexport function useStore<T>(store: Store<any, T>): T {\n  const context = useContext();\n  return context.getStore(store);\n}\n\n/**\n * A hybrid Ref which is both a function ref and a React-style object ref with a `current` property.\n * Both the `current` property and the function syntax access the same value.\n */\nexport interface HybridRef<T> extends Ref<T> {\n  current: T;\n}\n\n/**\n * Creates a Ref. Useful for getting references to DOM nodes.\n */\nexport function useRef<T>(initialValue?: T): HybridRef<T>;\n\nexport function useRef<T>(...value: [T]): HybridRef<T> {\n  useContext(); // assert that we're in a valid context\n  const valueRef = ref(...value);\n  Object.defineProperty(valueRef, \"current\", { get: valueRef, set: valueRef });\n  return valueRef as HybridRef<T>;\n}\n\n/**\n * Calls `callback` when the context is mounted. If `callback` returns a function, that function is called when the context is unmounted.\n */\nexport function useMount(callback: () => void | (() => void)): void {\n  const context = useContext();\n  context.onMount(() => {\n    const result = callback();\n    if (result) context.onUnmount(result);\n  });\n}\n\n/**\n * Calls `callback` when the context is unmounted.\n */\nexport function useUnmount(callback: () => void): void {\n  const context = useContext();\n  context.onUnmount(callback);\n}\n"],"names":["useContext","context","getCurrentContext","useLogger","name","useState","value","$value","$","useMemo","compute","deps","dep","get","untracked","useEffect","fn","useReducer","reducer","initialState","state","setState","action","current","useStore","store","useRef","valueRef","ref","useMount","callback","result","useUnmount"],"mappings":";;AAMO,SAASA,IAAsB;AACpC,QAAMC,IAAUC,EAAkB;AAClC,MAAI,CAACD;AACG,UAAA,IAAI,MAAM,mFAAmF;AAE9F,SAAAA;AACT;AAMO,SAASE,EAAUC,GAAoC;AAC5D,QAAMH,IAAUD,EAAW;AACvB,SAAAI,KAAcH,EAAA,QAAQG,CAAI,GACvBH;AACT;AAoBO,SAASI,EAAYC,GAAmC;AAClD,EAAAN,EAAA;AACL,QAAAO,IAASC,EAAEF,CAAK;AACtB,SAAO,CAAC,MAAMC,EAAO,GAAQA,CAAM;AACrC;AAEgB,SAAAE,EAAWC,GAA6BC,GAAiC;AAEvF,SADWX,EAAA,GACPW,IACKH,EAAE,WAAY;AAER,eAAAI,KAAOD,EAAM,CAAAE,EAAID,CAAG;AAC/B,WAAOE,EAAU,MAAMJ,EAAQ,KAAK,KAAK,CAAC;AAAA,EAAA,CAC3C,IAEMF,EAAE,WAAY;AACZ,WAAAE,EAAQ,KAAK,KAAK;AAAA,EAAA,CAC1B;AAEL;AAEgB,SAAAK,EAAUC,GAAcL,GAA4B;AAClE,QAAMV,IAAUD,EAAW;AAC3B,EAAIW,IACFV,EAAQ,OAAO,MAAM;AAER,eAAAW,KAAOD,EAAM,CAAAE,EAAID,CAAG;AAC/B,IAAAE,EAAUE,CAAE;AAAA,EAAA,CACb,IAEDf,EAAQ,OAAOe,CAAE;AAErB;AAmBgB,SAAAC,EACdC,GACAC,GACqC;AACrC,QAAM,CAACC,GAAOC,CAAQ,IAAIhB,EAASc,CAAY;AAIxC,SAAA,CAACC,GAHS,CAACE,MAAmB;AACnC,IAAAD,EAAS,CAACE,MAAYL,EAAQK,GAASD,CAAM,CAAC;AAAA,EAChD,CACuB;AACzB;AAKO,SAASE,EAAYC,GAAyB;AAE5C,SADSzB,EAAW,EACZ,SAASyB,CAAK;AAC/B;AAeO,SAASC,KAAapB,GAA0B;AAC1C,EAAAN,EAAA;AACL,QAAA2B,IAAWC,EAAI,GAAGtB,CAAK;AACtB,gBAAA,eAAeqB,GAAU,WAAW,EAAE,KAAKA,GAAU,KAAKA,GAAU,GACpEA;AACT;AAKO,SAASE,EAASC,GAA2C;AAClE,QAAM7B,IAAUD,EAAW;AAC3B,EAAAC,EAAQ,QAAQ,MAAM;AACpB,UAAM8B,IAASD,EAAS;AACpB,IAAAC,KAAgB9B,EAAA,UAAU8B,CAAM;AAAA,EAAA,CACrC;AACH;AAKO,SAASC,EAAWF,GAA4B;AAErD,EADgB9B,EAAW,EACnB,UAAU8B,CAAQ;AAC5B;"}
+{"version":3,"file":"hooks.js","sources":["../src/hooks/index.ts"],"sourcesContent":["import { Context, Logger, ref, type Ref, type Store } from \"../core\";\nimport {\n  type EffectFn,\n  get,\n  getCurrentContext,\n  Signal,\n  MaybeSignal,\n  memo,\n  Setter,\n  writable,\n  SignalOptions,\n  untracked,\n} from \"../core/signals\";\n\n/**\n * Returns the Context object of the View, Store or Mixin this hook is called in.\n */\nexport function useContext(): Context {\n  const context = getCurrentContext();\n  if (!context) {\n    throw new Error(`No context found; hooks can only be called in the body of a View, Store or Mixin.`);\n  }\n  return context;\n}\n\n/**\n * Returns a logger. If a name is passed it will be used as a prefix for all console messages.\n * Otherwise the default name of the context will be used.\n */\nexport function useLogger(name?: MaybeSignal<string>): Logger {\n  const context = useContext();\n  if (name) context.setName(name);\n  return context;\n}\n\n/**\n * Creates a new read-only Getter and a bound Setter function.\n */\nexport function useState<T>(value: T, options?: SignalOptions<T>): [Signal<T>, Setter<T>];\n\n/**\n * Creates a new read-only Signal and a bound Setter function.\n */\nexport function useState<T>(\n  value: undefined,\n  options: SignalOptions<T>,\n): [Signal<T | undefined>, Setter<T | undefined>];\n\n/**\n * Creates a new read-only Signal and a bound Setter function.\n */\nexport function useState<T>(): [Signal<T | undefined>, Setter<T | undefined>];\n\nexport function useState<T>(value?: T, options?: SignalOptions<T>): [Signal<T>, Setter<T>] {\n  useContext(); // assert that we're in a valid context\n  const state = writable(value as T, options);\n  return [() => state(), state.set];\n}\n\nexport function useMemo<T>(\n  compute: (current?: T) => MaybeSignal<T>,\n  deps?: Signal<any>[],\n  options?: SignalOptions<T>,\n): Signal<T> {\n  useContext(); // assert that we're in a valid context\n  return memo(compute, { ...options, deps });\n}\n\nexport function useEffect(fn: EffectFn, deps?: Signal<any>[]): void {\n  const context = useContext();\n  if (deps) {\n    context.effect(() => {\n      // Track deps and run `fn` untracked.\n      for (const dep of deps) get(dep);\n      untracked(fn);\n    });\n  } else {\n    context.effect(fn);\n  }\n}\n\n/**\n * Takes the current state and a dispatched action. Returns a new state based on the action.\n * Typically the body of this function will be a large switch statement.\n */\nexport type ReducerFn<State, Action> = (state: State, action: Action) => State;\n\n/**\n * Dispatches an action to this reducer, causing the state to update.\n */\nexport type DispatchFn<Action> = (action: Action) => void;\n\n/**\n *\n */\nexport function useReducer<State, Action>(\n  reducer: ReducerFn<State, Action>,\n  initialState: State,\n): [Signal<State>, DispatchFn<Action>] {\n  const [state, setState] = useState(initialState);\n  const dispatch = (action: Action) => {\n    setState((current) => reducer(current, action));\n  };\n  return [state, dispatch];\n}\n\n/**\n * Uses a previously added Store. Takes the Store function itself and returns the nearest instance.\n */\nexport function useStore<T>(store: Store<any, T>): T {\n  const context = useContext();\n  return context.getStore(store);\n}\n\n/**\n * A hybrid Ref which is both a function ref and a React-style object ref with a `current` property.\n * Both the `current` property and the function syntax access the same value.\n */\nexport interface HybridRef<T> extends Ref<T> {\n  current: T;\n}\n\n/**\n * Creates a Ref. Useful for getting references to DOM nodes.\n */\nexport function useRef<T>(initialValue?: T): HybridRef<T>;\n\nexport function useRef<T>(...value: [T]): HybridRef<T> {\n  useContext(); // assert that we're in a valid context\n  const valueRef = ref(...value);\n  Object.defineProperty(valueRef, \"current\", { get: valueRef, set: valueRef });\n  return valueRef as HybridRef<T>;\n}\n\n/**\n * Calls `callback` when the context is mounted. If `callback` returns a function, that function is called when the context is unmounted.\n */\nexport function useMount(callback: () => void | (() => void)): void {\n  const context = useContext();\n  context.onMount(() => {\n    const result = callback();\n    if (result) context.onUnmount(result);\n  });\n}\n\n/**\n * Calls `callback` when the context is unmounted.\n */\nexport function useUnmount(callback: () => void): void {\n  const context = useContext();\n  context.onUnmount(callback);\n}\n"],"names":["useContext","context","getCurrentContext","useLogger","name","useState","value","options","state","writable","useMemo","compute","deps","memo","useEffect","fn","dep","get","untracked","useReducer","reducer","initialState","setState","action","current","useStore","store","useRef","valueRef","ref","useMount","callback","result","useUnmount"],"mappings":";;AAiBO,SAASA,IAAsB;AACpC,QAAMC,IAAUC,EAAkB;AAClC,MAAI,CAACD;AACG,UAAA,IAAI,MAAM,mFAAmF;AAE9F,SAAAA;AACT;AAMO,SAASE,EAAUC,GAAoC;AAC5D,QAAMH,IAAUD,EAAW;AACvB,SAAAI,KAAcH,EAAA,QAAQG,CAAI,GACvBH;AACT;AAoBgB,SAAAI,EAAYC,GAAWC,GAAoD;AAC9E,EAAAP,EAAA;AACL,QAAAQ,IAAQC,EAASH,GAAYC,CAAO;AAC1C,SAAO,CAAC,MAAMC,KAASA,EAAM,GAAG;AAClC;AAEgB,SAAAE,EACdC,GACAC,GACAL,GACW;AACA,SAAAP,EAAA,GACJa,EAAKF,GAAS,EAAE,GAAGJ,GAAS,MAAAK,GAAM;AAC3C;AAEgB,SAAAE,EAAUC,GAAcH,GAA4B;AAClE,QAAMX,IAAUD,EAAW;AAC3B,EAAIY,IACFX,EAAQ,OAAO,MAAM;AAER,eAAAe,KAAOJ,EAAM,CAAAK,EAAID,CAAG;AAC/B,IAAAE,EAAUH,CAAE;AAAA,EAAA,CACb,IAEDd,EAAQ,OAAOc,CAAE;AAErB;AAgBgB,SAAAI,EACdC,GACAC,GACqC;AACrC,QAAM,CAACb,GAAOc,CAAQ,IAAIjB,EAASgB,CAAY;AAIxC,SAAA,CAACb,GAHS,CAACe,MAAmB;AACnC,IAAAD,EAAS,CAACE,MAAYJ,EAAQI,GAASD,CAAM,CAAC;AAAA,EAChD,CACuB;AACzB;AAKO,SAASE,EAAYC,GAAyB;AAE5C,SADS1B,EAAW,EACZ,SAAS0B,CAAK;AAC/B;AAeO,SAASC,KAAarB,GAA0B;AAC1C,EAAAN,EAAA;AACL,QAAA4B,IAAWC,EAAI,GAAGvB,CAAK;AACtB,gBAAA,eAAesB,GAAU,WAAW,EAAE,KAAKA,GAAU,KAAKA,GAAU,GACpEA;AACT;AAKO,SAASE,EAASC,GAA2C;AAClE,QAAM9B,IAAUD,EAAW;AAC3B,EAAAC,EAAQ,QAAQ,MAAM;AACpB,UAAM+B,IAASD,EAAS;AACpB,IAAAC,KAAgB/B,EAAA,UAAU+B,CAAM;AAAA,EAAA,CACrC;AACH;AAKO,SAASC,EAAWF,GAA4B;AAErD,EADgB/B,EAAW,EACnB,UAAU+B,CAAQ;AAC5B;"}