voodoojs 0.11.2 → 0.12.1

package/dist/index.d.ts

@@ -1,5 +1,6 @@
-import { S as Scope, c as core, V as VoodooCollection } from './query-Cf-7iibE.js';
-export { A as App, a as AppOptions, C as ComponentDefinition, D as DirectiveBinding, b as DirectiveHooks, P as PRIORITY, R as Resource, d as ResourceOptions, e as VoodooConfig, f as VoodooPlugin, g as VoodooRuntimeError, h as VoodooSyntaxError, i as addCleanup, j as allStores, k as allowedGlobals, l as cache, m as clearParseCache, n as config, o as cookie, p as createApp, q as createResource, r as defineComponent, s as defineDirective, t as destroy, u as documentReady, v as ensureTokens, w as enter, x as evaluate, y as fadeIn, z as fadeOut, B as findScope, E as fromHtml, F as getScope, G as injectStyle, H as instances, I as leave, J as magic, K as magics, L as mountComponent, M as parse, N as query, O as ready, Q as refresh, T as removeStore, q as resource, U as rootScope, W as session, X as slideDown, Y as slideUp, Z as start, _ as storage, $ as store, a0 as storeNames, a1 as stringify, a2 as theme, a3 as toast, a4 as tokenize, a5 as url, a6 as viewTransition, a7 as walk, a8 as whenElement, a9 as whenReady } from './query-Cf-7iibE.js';
+import { S as Scope, c as core, V as VoodooCollection } from './query-DzHfm8Kg.js';
+export { A as App, a as AppOptions, C as ComponentDefinition, D as DirectiveBinding, b as DirectiveHooks, P as PRIORITY, R as Resource, d as ResourceOptions, e as VoodooConfig, f as VoodooPlugin, g as VoodooRuntimeError, h as VoodooSyntaxError, i as addCleanup, j as allStores, k as allowedGlobals, l as cache, m as clearParseCache, n as config, o as cookie, p as createApp, q as createResource, r as defineComponent, s as defineDirective, t as destroy, u as documentReady, v as ensureTokens, w as enter, x as evaluate, y as fadeIn, z as fadeOut, B as findScope, E as fromHtml, F as getScope, G as hook, H as hooks, I as injectStyle, J as instances, K as leave, L as magic, M as magics, N as mountComponent, O as parse, Q as query, T as ready, U as refresh, W as removeStore, q as resource, X as rootScope, Y as session, Z as slideDown, _ as slideUp, $ as start, a0 as storage, a1 as store, a2 as storeNames, a3 as stringify, a4 as theme, a5 as toast, a6 as tokenize, a7 as url, a8 as viewTransition, a9 as walk, aa as whenElement, ab as whenReady } from './query-DzHfm8Kg.js';
+import { Ref } from './reactivity.js';
 export { EffectScope, computed, effect, effectScope, flushSync, isReactive, markRaw, nextTick, reactive, ref, shallowRef, stop, toRaw, unref, watch, watchEffect } from './reactivity.js';
 export { HttpError, HttpMethod, HttpResponse, RequestConfig, http, request } from './http.js';
 export { R as RoomOptions, a as RoomState, S as SocketMessage, b as SocketOptions, c as SocketRoom, d as SocketState, e as SocketTransport, V as VoodooSocket, f as createSocket, s as socket, g as socketSupported } from './index-DTllqUtj.js';
@@ -171,7 +172,16 @@ declare const sound: {
     unmute(): void;
     /** Toggles between muted and unmuted, and returns the new state. */
     toggle(): boolean;
-    /** `true` when muted. */
+    /**
+     * `true` when muted.
+     *
+     * Reads a revision ref first, so that an expression asking whether sound is
+     * muted actually re-runs when it changes. The state lives in a module
+     * variable and in localStorage, both invisible to the Proxy, so
+     * `v-show="$sound.muted"` used to render once and then never move: a page had
+     * no way to show whether it was muted, which made the mute button look like
+     * it did nothing at all.
+     */
     readonly muted: boolean;
     /** Names of all available effects. */
     readonly names: string[];
@@ -481,6 +491,80 @@ declare const charts: {
     colors: string[];
 };
 
+/**
+ * @module hooks
+ *
+ * React-style hooks, reachable by bare name inside any expression.
+ *
+ * These are a thin surface over primitives the library already had — `effect`,
+ * `computed`, `ref` and `store`. The value is not new machinery, it is that
+ * someone arriving from React can write what they already know and have it mean
+ * the right thing here.
+ *
+ * Two differences from React are deliberate, and both are improvements rather
+ * than gaps:
+ *
+ * 1. `deps` is optional everywhere. Voodoo tracks reads through a Proxy, so a
+ *    hook with no dependency array re-runs exactly when something it actually
+ *    read changes. The array is there for when you want to narrow that, not
+ *    because the library cannot work it out.
+ *
+ * 2. There is no rule against calling a hook in a branch. Slots are keyed per
+ *    scope in call order within one evaluation, and `v-data` and `v-init` each
+ *    evaluate once per scope, so the order is stable without a rule asking you
+ *    to keep it stable.
+ *
+ * `useState` and `useMemo` return refs, and `reactive()` unwraps refs on read,
+ * so inside `v-data` they read as plain values with no `.value` anywhere.
+ * `useRef` deliberately does not: it returns a raw `{ current }` box that no
+ * effect subscribes to, which is the whole point of it.
+ */
+
+/**
+ * A value that survives re-evaluation and re-renders whatever reads it.
+ *
+ * Returns a ref. Written into `v-data` it reads and assigns as a plain value,
+ * because reactive objects unwrap refs, so `count++` works with no `.value`.
+ */
+declare function useState<T>(scope: Scope, initial: T): Ref<T>;
+/**
+ * Runs a side effect, and re-runs it when what it depends on changes.
+ *
+ * With no dependency array it tracks its own reads and re-runs when any of them
+ * change. With `[]` it runs once. With `[a, b]` it re-runs only when one of
+ * those differs from last time. Returning a function from `fn` registers
+ * cleanup, called before the next run and again when the element is removed.
+ */
+declare function useEffect(scope: Scope, fn: () => void | (() => void), deps?: unknown): void;
+/**
+ * Caches a computation.
+ *
+ * With no dependency array it becomes a `computed`: lazy, cached, and
+ * recomputed only when something it read actually changed. With an array it
+ * recomputes when that array changes. Returns a ref, so inside `v-data` it
+ * reads as the value itself.
+ */
+declare function useMemo<T>(scope: Scope, fn: () => T, deps?: unknown): Ref<T>;
+/**
+ * A box that survives re-evaluation and that nothing subscribes to.
+ *
+ * Use it for a DOM element, a timer id, or a previous value — anything you want
+ * to keep without the page reacting when it changes. Deliberately not a ref, so
+ * reading `.current` inside an effect does not make that effect depend on it.
+ */
+declare function useRef<T>(scope: Scope, initial: T): {
+    current: T;
+};
+/**
+ * Shared state, reachable from any component without threading it through the
+ * markup by hand.
+ *
+ * Backed by the store registry, so `useContext('user')` and `$store.user` are
+ * the same object. Passing a second argument creates the store on first use.
+ */
+declare function useContext<T extends Record<string, any>>(name: string, initial?: T): T;
+declare function installHooks(): void;
+
 /**
  * @module runtime/magics
  *
@@ -1714,4 +1798,4 @@ interface Voodoo extends Omit<typeof core, never> {
 }
 declare const V: Voodoo;
 
-export { Scope, V, type Voodoo, VoodooCollection, activateJsx, alert, animate, applyMask, applyRegions, charts, clearErrors, clipboard, confirm, V as default, devtoolsBus, devtoolsWidget, dialog, disableXray, easings, enableXray, extractJsx, getLocale, hotkey, i18n, inView, isDevtoolsWidgetMounted, isXrayEnabled, jsx, mask, masks, modal, motionPresets, mountDevtoolsWidget, navigate, network, palette, prompt, readDeclarationBlock, registerMask, renderChart, route, router, screen, scrollProgress, serializeForm, setLocale, showFormErrors, sound, efeitos as soundEffects, spring, stagger, t, unmask, unmountDevtoolsWidget, validate, validator, xray };
+export { Scope, V, type Voodoo, VoodooCollection, activateJsx, alert, animate, applyMask, applyRegions, charts, clearErrors, clipboard, confirm, V as default, devtoolsBus, devtoolsWidget, dialog, disableXray, easings, enableXray, extractJsx, getLocale, hotkey, i18n, inView, installHooks, isDevtoolsWidgetMounted, isXrayEnabled, jsx, mask, masks, modal, motionPresets, mountDevtoolsWidget, navigate, network, palette, prompt, readDeclarationBlock, registerMask, renderChart, route, router, screen, scrollProgress, serializeForm, setLocale, showFormErrors, sound, efeitos as soundEffects, spring, stagger, t, unmask, unmountDevtoolsWidget, useContext, useEffect, useMemo, useRef, useState, validate, validator, xray };

package/dist/index.js

@@ -1,25 +1,25 @@
-import { core, sound, hotkey, palette, registerMask, unmask, applyMask, masks, mask, clearErrors, showFieldError, showFormErrors, messages, serializeForm, validate, validator, dialog, prompt, confirm, alert, modal, VoodooCollection, fromHtml, ready2, query, viewTransition, defineComponent, storage, ensurePalette, instances, storeNames, allStores } from './chunk-AH2VXDZD.js';
-export { VoodooCollection, alert, allStores, applyMask, cache, clearErrors, clipboard, confirm, cookie, createApp, createResource, defineComponent, dialog, ready as documentReady, enter, fadeIn, fadeOut, fromHtml, hotkey, instances, leave, mask, masks, modal, mountComponent, network, palette, prompt, query, ready2 as ready, registerMask, removeStore, createResource as resource, screen, serializeForm, session, showFormErrors, slideDown, slideUp, sound, efeitos as soundEffects, storage, store, storeNames, theme, toast, unmask, url, validate, validator, viewTransition, whenElement, whenReady } from './chunk-AH2VXDZD.js';
-export { gpu, reflectWgsl } from './chunk-KQYSJHZR.js';
-import { http } from './chunk-DJJB35SR.js';
-export { HttpError, http, request } from './chunk-DJJB35SR.js';
-import { devtoolsBus } from './chunk-DCE5WIGA.js';
-export { createSocket, devtoolsBus, socket, socketSupported } from './chunk-DCE5WIGA.js';
-import { magic, markSkipChildren, onStart, rootScope, findScope, destroy, readAttr, evaluate, parse, Scope, getScope, walk, unwrap, addCleanup, hadDirectives, collectDirectives, getEffectScopes, evaluateIn } from './chunk-H2ZUEQWV.js';
-export { Scope, VoodooRuntimeError, VoodooSyntaxError, addCleanup, allowedGlobals, clearParseCache, destroy, evaluate, findScope, getScope, magic, magics, parse, refresh, rootScope, start, stringify, tokenize, walk } from './chunk-H2ZUEQWV.js';
-import { reactive, warn, handleError, effect, queuePostFlush, nextTick } from './chunk-WJP3YGUI.js';
-export { EffectScope, computed, effect, effectScope, flushSync, isReactive, markRaw, nextTick, reactive, ref, shallowRef, stop, toRaw, unref, watch, watchEffect } from './chunk-WJP3YGUI.js';
-import { warnAlias } from './chunk-UV5PMS7P.js';
-import { parseDuration, formatNumber, formatCurrency, formatDate, relativeTime, device, setFormatDefaults, uid, merge, escapeHtml, truncate, get, titleCase } from './chunk-IGZSDZKU.js';
-export { capitalize, chunk, clone, debounce, device, escapeHtml, formatCurrency, formatDate, formatFileSize, formatNumber, formatPercent, get, groupBy, isBrowser, matchesMedia, memoize, merge, once, parseDuration, random, relativeTime, sample, set, setFormatDefaults, sleep, slugify, sortBy, stripTags, throttle, titleCase, truncate, uid, unique, uuid } from './chunk-IGZSDZKU.js';
-import { ensureTokens, injectStyle } from './chunk-V3O3WOZH.js';
-export { ensureTokens, injectStyle } from './chunk-V3O3WOZH.js';
-import { defineDirective, PRIORITY, config } from './chunk-NFDXVIII.js';
-export { PRIORITY, config, defineDirective } from './chunk-NFDXVIII.js';
-import './chunk-IS3DR2KY.js';
+import { core, sound, hotkey, palette, registerMask, unmask, applyMask, masks, mask, clearErrors, showFieldError, showFormErrors, messages, serializeForm, validate, validator, dialog, prompt, confirm, alert, modal, VoodooCollection, fromHtml, ready2, query, viewTransition, defineComponent, storage, ensurePalette, instances, storeNames, allStores } from './chunk-RDHYPGH6.js';
+export { VoodooCollection, alert, allStores, applyMask, cache, clearErrors, clipboard, confirm, cookie, createApp, createResource, defineComponent, dialog, ready as documentReady, enter, fadeIn, fadeOut, fromHtml, hotkey, installHooks, instances, leave, mask, masks, modal, mountComponent, network, palette, prompt, query, ready2 as ready, registerMask, removeStore, createResource as resource, screen, serializeForm, session, showFormErrors, slideDown, slideUp, sound, efeitos as soundEffects, storage, store, storeNames, theme, toast, unmask, url, useContext, useEffect, useMemo, useRef, useState, validate, validator, viewTransition, whenElement, whenReady } from './chunk-RDHYPGH6.js';
+export { gpu, reflectWgsl } from './chunk-AFMCDNYS.js';
+import { http } from './chunk-D7675IJG.js';
+export { HttpError, http, request } from './chunk-D7675IJG.js';
+import { devtoolsBus } from './chunk-HNM3CTBD.js';
+export { createSocket, devtoolsBus, socket, socketSupported } from './chunk-HNM3CTBD.js';
+import { magic, markSkipChildren, onStart, rootScope, findScope, destroy, readAttr, evaluate, parse, Scope, getScope, walk, unwrap, addCleanup, hadDirectives, collectDirectives, getEffectScopes, evaluateIn } from './chunk-4M4ZXHNY.js';
+export { Scope, VoodooRuntimeError, VoodooSyntaxError, addCleanup, allowedGlobals, clearParseCache, destroy, evaluate, findScope, getScope, hook, hooks, magic, magics, parse, refresh, rootScope, start, stringify, tokenize, walk } from './chunk-4M4ZXHNY.js';
+import { reactive, warn, handleError, effect, queuePostFlush, nextTick } from './chunk-LLNDLLKV.js';
+export { EffectScope, computed, effect, effectScope, flushSync, isReactive, markRaw, nextTick, reactive, ref, shallowRef, stop, toRaw, unref, watch, watchEffect } from './chunk-LLNDLLKV.js';
+import { warnAlias } from './chunk-72PMUUMT.js';
+import { parseDuration, formatNumber, formatCurrency, formatDate, relativeTime, device, setFormatDefaults, uid, merge, escapeHtml, truncate, get, titleCase } from './chunk-KN7NAKBL.js';
+export { capitalize, chunk, clone, debounce, device, escapeHtml, formatCurrency, formatDate, formatFileSize, formatNumber, formatPercent, get, groupBy, isBrowser, matchesMedia, memoize, merge, once, parseDuration, random, relativeTime, sample, set, setFormatDefaults, sleep, slugify, sortBy, stripTags, throttle, titleCase, truncate, uid, unique, uuid } from './chunk-KN7NAKBL.js';
+import { ensureTokens, injectStyle } from './chunk-NP66JM2P.js';
+export { ensureTokens, injectStyle } from './chunk-NP66JM2P.js';
+import { defineDirective, PRIORITY, config } from './chunk-T5ION5NG.js';
+export { PRIORITY, config, defineDirective } from './chunk-T5ION5NG.js';
+import './chunk-GXPNWCGE.js';
 
 /**
- * Voodoo.js v0.11.2
+ * Voodoo.js v0.12.1
  * JavaScript feels like magic.
  * (c) 2026 Voodoo.js contributors. MIT License.
  */

package/dist/{query-Cf-7iibE.d.ts → query-DzHfm8Kg.d.ts}

@@ -241,6 +241,17 @@ type MagicGetter = (scope: Scope) => unknown;
 declare const magics: Map<string, MagicGetter>;
 /** Register a magic variable available in any expression. */
 declare function magic(name: string, getter: MagicGetter): void;
+/**
+ * Registry of helpers reached by a bare name, with no `$` in front.
+ *
+ * Kept apart from `magics` because that one prefixes `$` onto anything missing
+ * it, which is the right default for `$store` and the wrong one for `useEffect`.
+ * Data in scope still wins: `lookup` walks the scope chain first, so a variable
+ * of your own named `useMemo` shadows the hook rather than colliding with it.
+ */
+declare const hooks: Map<string, MagicGetter>;
+/** Register a helper callable by bare name inside any expression. */
+declare function hook(name: string, getter: MagicGetter): void;
 /**
  * Fields are `declare`d and assigned in the constructor, not initialised at the
  * declaration.
@@ -1097,86 +1108,86 @@ declare const core: {
     http: {
         defaults: HttpDefaults;
         get<T = unknown>(url: string, options?: {
-            params?: Record<string, string | number | boolean | null | undefined> | undefined;
+            responseType?: "auto" | "json" | "text" | "blob" | "arrayBuffer" | "formData" | undefined;
             headers?: Record<string, string> | undefined;
+            credentials?: RequestCredentials | undefined;
+            signal?: AbortSignal | undefined;
+            params?: Record<string, string | number | boolean | null | undefined> | undefined;
             timeout?: number | undefined;
             retry?: number | undefined;
             retryDelay?: number | undefined;
             retryUnsafe?: boolean | undefined;
             cache?: number | undefined;
-            signal?: AbortSignal | undefined;
-            credentials?: RequestCredentials | undefined;
-            responseType?: "auto" | "json" | "text" | "blob" | "arrayBuffer" | "formData" | undefined;
             onProgress?: ((loaded: number, total: number) => void) | undefined;
             offlineQueue?: boolean | undefined;
         }): Promise<T>;
         post<T = unknown>(url: string, body?: unknown, options?: {
-            params?: Record<string, string | number | boolean | null | undefined> | undefined;
+            responseType?: "auto" | "json" | "text" | "blob" | "arrayBuffer" | "formData" | undefined;
             headers?: Record<string, string> | undefined;
+            credentials?: RequestCredentials | undefined;
+            signal?: AbortSignal | undefined;
+            params?: Record<string, string | number | boolean | null | undefined> | undefined;
             timeout?: number | undefined;
             retry?: number | undefined;
             retryDelay?: number | undefined;
             retryUnsafe?: boolean | undefined;
             cache?: number | undefined;
-            signal?: AbortSignal | undefined;
-            credentials?: RequestCredentials | undefined;
-            responseType?: "auto" | "json" | "text" | "blob" | "arrayBuffer" | "formData" | undefined;
             onProgress?: ((loaded: number, total: number) => void) | undefined;
             offlineQueue?: boolean | undefined;
         }): Promise<T>;
         put<T = unknown>(url: string, body?: unknown, options?: {
-            params?: Record<string, string | number | boolean | null | undefined> | undefined;
+            responseType?: "auto" | "json" | "text" | "blob" | "arrayBuffer" | "formData" | undefined;
             headers?: Record<string, string> | undefined;
+            credentials?: RequestCredentials | undefined;
+            signal?: AbortSignal | undefined;
+            params?: Record<string, string | number | boolean | null | undefined> | undefined;
             timeout?: number | undefined;
             retry?: number | undefined;
             retryDelay?: number | undefined;
             retryUnsafe?: boolean | undefined;
             cache?: number | undefined;
-            signal?: AbortSignal | undefined;
-            credentials?: RequestCredentials | undefined;
-            responseType?: "auto" | "json" | "text" | "blob" | "arrayBuffer" | "formData" | undefined;
             onProgress?: ((loaded: number, total: number) => void) | undefined;
             offlineQueue?: boolean | undefined;
         }): Promise<T>;
         patch<T = unknown>(url: string, body?: unknown, options?: {
-            params?: Record<string, string | number | boolean | null | undefined> | undefined;
+            responseType?: "auto" | "json" | "text" | "blob" | "arrayBuffer" | "formData" | undefined;
             headers?: Record<string, string> | undefined;
+            credentials?: RequestCredentials | undefined;
+            signal?: AbortSignal | undefined;
+            params?: Record<string, string | number | boolean | null | undefined> | undefined;
             timeout?: number | undefined;
             retry?: number | undefined;
             retryDelay?: number | undefined;
             retryUnsafe?: boolean | undefined;
             cache?: number | undefined;
-            signal?: AbortSignal | undefined;
-            credentials?: RequestCredentials | undefined;
-            responseType?: "auto" | "json" | "text" | "blob" | "arrayBuffer" | "formData" | undefined;
             onProgress?: ((loaded: number, total: number) => void) | undefined;
             offlineQueue?: boolean | undefined;
         }): Promise<T>;
         delete<T = unknown>(url: string, options?: {
-            params?: Record<string, string | number | boolean | null | undefined> | undefined;
+            responseType?: "auto" | "json" | "text" | "blob" | "arrayBuffer" | "formData" | undefined;
             headers?: Record<string, string> | undefined;
+            credentials?: RequestCredentials | undefined;
+            signal?: AbortSignal | undefined;
+            params?: Record<string, string | number | boolean | null | undefined> | undefined;
             timeout?: number | undefined;
             retry?: number | undefined;
             retryDelay?: number | undefined;
             retryUnsafe?: boolean | undefined;
             cache?: number | undefined;
-            signal?: AbortSignal | undefined;
-            credentials?: RequestCredentials | undefined;
-            responseType?: "auto" | "json" | "text" | "blob" | "arrayBuffer" | "formData" | undefined;
             onProgress?: ((loaded: number, total: number) => void) | undefined;
             offlineQueue?: boolean | undefined;
         }): Promise<T>;
         head(url: string, options?: {
-            params?: Record<string, string | number | boolean | null | undefined> | undefined;
+            responseType?: "auto" | "json" | "text" | "blob" | "arrayBuffer" | "formData" | undefined;
             headers?: Record<string, string> | undefined;
+            credentials?: RequestCredentials | undefined;
+            signal?: AbortSignal | undefined;
+            params?: Record<string, string | number | boolean | null | undefined> | undefined;
             timeout?: number | undefined;
             retry?: number | undefined;
             retryDelay?: number | undefined;
             retryUnsafe?: boolean | undefined;
             cache?: number | undefined;
-            signal?: AbortSignal | undefined;
-            credentials?: RequestCredentials | undefined;
-            responseType?: "auto" | "json" | "text" | "blob" | "arrayBuffer" | "formData" | undefined;
             onProgress?: ((loaded: number, total: number) => void) | undefined;
             offlineQueue?: boolean | undefined;
         }): Promise<unknown>;
@@ -1192,16 +1203,16 @@ declare const core: {
             error?: (e: Event) => void;
         }): EventSource;
         stream(url: string, onLine: (line: string) => void, options?: {
-            params?: Record<string, string | number | boolean | null | undefined> | undefined;
+            responseType?: "auto" | "json" | "text" | "blob" | "arrayBuffer" | "formData" | undefined;
             headers?: Record<string, string> | undefined;
+            credentials?: RequestCredentials | undefined;
+            signal?: AbortSignal | undefined;
+            params?: Record<string, string | number | boolean | null | undefined> | undefined;
             timeout?: number | undefined;
             retry?: number | undefined;
             retryDelay?: number | undefined;
             retryUnsafe?: boolean | undefined;
             cache?: number | undefined;
-            signal?: AbortSignal | undefined;
-            credentials?: RequestCredentials | undefined;
-            responseType?: "auto" | "json" | "text" | "blob" | "arrayBuffer" | "formData" | undefined;
             onProgress?: ((loaded: number, total: number) => void) | undefined;
             offlineQueue?: boolean | undefined;
         }): Promise<void>;
@@ -1643,4 +1654,4 @@ declare function ready(fn?: ReadyCallback): Promise<void>;
 /** Creates elements from an HTML string without inserting them in the document. */
 declare function fromHtml(html: string): VoodooCollection;
 
-export { store as $, type App as A, findScope as B, type ComponentDefinition as C, type DirectiveBinding as D, fromHtml as E, getScope as F, injectStyle as G, instances as H, leave as I, magic as J, magics as K, mountComponent as L, parse as M, query as N, ready as O, PRIORITY as P, refresh as Q, type Resource as R, Scope as S, removeStore as T, rootScope as U, VoodooCollection as V, session as W, slideDown as X, slideUp as Y, start as Z, storage as _, type AppOptions as a, storeNames as a0, stringify as a1, theme as a2, toast as a3, tokenize as a4, url as a5, viewTransition as a6, walk as a7, whenElement as a8, whenReady as a9, type DirectiveHooks as b, core as c, type ResourceOptions as d, type VoodooConfig as e, type VoodooPlugin as f, VoodooRuntimeError as g, VoodooSyntaxError as h, addCleanup as i, allStores as j, allowedGlobals as k, cache as l, clearParseCache as m, config as n, cookie as o, createApp as p, createResource as q, defineComponent as r, defineDirective as s, destroy as t, ready$1 as u, ensureTokens as v, enter as w, evaluate as x, fadeIn as y, fadeOut as z };
+export { start as $, type App as A, findScope as B, type ComponentDefinition as C, type DirectiveBinding as D, fromHtml as E, getScope as F, hook as G, hooks as H, injectStyle as I, instances as J, leave as K, magic as L, magics as M, mountComponent as N, parse as O, PRIORITY as P, query as Q, type Resource as R, Scope as S, ready as T, refresh as U, VoodooCollection as V, removeStore as W, rootScope as X, session as Y, slideDown as Z, slideUp as _, type AppOptions as a, storage as a0, store as a1, storeNames as a2, stringify as a3, theme as a4, toast as a5, tokenize as a6, url as a7, viewTransition as a8, walk as a9, whenElement as aa, whenReady as ab, type DirectiveHooks as b, core as c, type ResourceOptions as d, type VoodooConfig as e, type VoodooPlugin as f, VoodooRuntimeError as g, VoodooSyntaxError as h, addCleanup as i, allStores as j, allowedGlobals as k, cache as l, clearParseCache as m, config as n, cookie as o, createApp as p, createResource as q, defineComponent as r, defineDirective as s, destroy as t, ready$1 as u, ensureTokens as v, enter as w, evaluate as x, fadeIn as y, fadeOut as z };

package/dist/{query-DiQAS73Q.d.cts → query-XooOh4vB.d.cts}

@@ -241,6 +241,17 @@ type MagicGetter = (scope: Scope) => unknown;
 declare const magics: Map<string, MagicGetter>;
 /** Register a magic variable available in any expression. */
 declare function magic(name: string, getter: MagicGetter): void;
+/**
+ * Registry of helpers reached by a bare name, with no `$` in front.
+ *
+ * Kept apart from `magics` because that one prefixes `$` onto anything missing
+ * it, which is the right default for `$store` and the wrong one for `useEffect`.
+ * Data in scope still wins: `lookup` walks the scope chain first, so a variable
+ * of your own named `useMemo` shadows the hook rather than colliding with it.
+ */
+declare const hooks: Map<string, MagicGetter>;
+/** Register a helper callable by bare name inside any expression. */
+declare function hook(name: string, getter: MagicGetter): void;
 /**
  * Fields are `declare`d and assigned in the constructor, not initialised at the
  * declaration.
@@ -1097,86 +1108,86 @@ declare const core: {
     http: {
         defaults: HttpDefaults;
         get<T = unknown>(url: string, options?: {
-            params?: Record<string, string | number | boolean | null | undefined> | undefined;
+            responseType?: "auto" | "json" | "text" | "blob" | "arrayBuffer" | "formData" | undefined;
             headers?: Record<string, string> | undefined;
+            credentials?: RequestCredentials | undefined;
+            signal?: AbortSignal | undefined;
+            params?: Record<string, string | number | boolean | null | undefined> | undefined;
             timeout?: number | undefined;
             retry?: number | undefined;
             retryDelay?: number | undefined;
             retryUnsafe?: boolean | undefined;
             cache?: number | undefined;
-            signal?: AbortSignal | undefined;
-            credentials?: RequestCredentials | undefined;
-            responseType?: "auto" | "json" | "text" | "blob" | "arrayBuffer" | "formData" | undefined;
             onProgress?: ((loaded: number, total: number) => void) | undefined;
             offlineQueue?: boolean | undefined;
         }): Promise<T>;
         post<T = unknown>(url: string, body?: unknown, options?: {
-            params?: Record<string, string | number | boolean | null | undefined> | undefined;
+            responseType?: "auto" | "json" | "text" | "blob" | "arrayBuffer" | "formData" | undefined;
             headers?: Record<string, string> | undefined;
+            credentials?: RequestCredentials | undefined;
+            signal?: AbortSignal | undefined;
+            params?: Record<string, string | number | boolean | null | undefined> | undefined;
             timeout?: number | undefined;
             retry?: number | undefined;
             retryDelay?: number | undefined;
             retryUnsafe?: boolean | undefined;
             cache?: number | undefined;
-            signal?: AbortSignal | undefined;
-            credentials?: RequestCredentials | undefined;
-            responseType?: "auto" | "json" | "text" | "blob" | "arrayBuffer" | "formData" | undefined;
             onProgress?: ((loaded: number, total: number) => void) | undefined;
             offlineQueue?: boolean | undefined;
         }): Promise<T>;
         put<T = unknown>(url: string, body?: unknown, options?: {
-            params?: Record<string, string | number | boolean | null | undefined> | undefined;
+            responseType?: "auto" | "json" | "text" | "blob" | "arrayBuffer" | "formData" | undefined;
             headers?: Record<string, string> | undefined;
+            credentials?: RequestCredentials | undefined;
+            signal?: AbortSignal | undefined;
+            params?: Record<string, string | number | boolean | null | undefined> | undefined;
             timeout?: number | undefined;
             retry?: number | undefined;
             retryDelay?: number | undefined;
             retryUnsafe?: boolean | undefined;
             cache?: number | undefined;
-            signal?: AbortSignal | undefined;
-            credentials?: RequestCredentials | undefined;
-            responseType?: "auto" | "json" | "text" | "blob" | "arrayBuffer" | "formData" | undefined;
             onProgress?: ((loaded: number, total: number) => void) | undefined;
             offlineQueue?: boolean | undefined;
         }): Promise<T>;
         patch<T = unknown>(url: string, body?: unknown, options?: {
-            params?: Record<string, string | number | boolean | null | undefined> | undefined;
+            responseType?: "auto" | "json" | "text" | "blob" | "arrayBuffer" | "formData" | undefined;
             headers?: Record<string, string> | undefined;
+            credentials?: RequestCredentials | undefined;
+            signal?: AbortSignal | undefined;
+            params?: Record<string, string | number | boolean | null | undefined> | undefined;
             timeout?: number | undefined;
             retry?: number | undefined;
             retryDelay?: number | undefined;
             retryUnsafe?: boolean | undefined;
             cache?: number | undefined;
-            signal?: AbortSignal | undefined;
-            credentials?: RequestCredentials | undefined;
-            responseType?: "auto" | "json" | "text" | "blob" | "arrayBuffer" | "formData" | undefined;
             onProgress?: ((loaded: number, total: number) => void) | undefined;
             offlineQueue?: boolean | undefined;
         }): Promise<T>;
         delete<T = unknown>(url: string, options?: {
-            params?: Record<string, string | number | boolean | null | undefined> | undefined;
+            responseType?: "auto" | "json" | "text" | "blob" | "arrayBuffer" | "formData" | undefined;
             headers?: Record<string, string> | undefined;
+            credentials?: RequestCredentials | undefined;
+            signal?: AbortSignal | undefined;
+            params?: Record<string, string | number | boolean | null | undefined> | undefined;
             timeout?: number | undefined;
             retry?: number | undefined;
             retryDelay?: number | undefined;
             retryUnsafe?: boolean | undefined;
             cache?: number | undefined;
-            signal?: AbortSignal | undefined;
-            credentials?: RequestCredentials | undefined;
-            responseType?: "auto" | "json" | "text" | "blob" | "arrayBuffer" | "formData" | undefined;
             onProgress?: ((loaded: number, total: number) => void) | undefined;
             offlineQueue?: boolean | undefined;
         }): Promise<T>;
         head(url: string, options?: {
-            params?: Record<string, string | number | boolean | null | undefined> | undefined;
+            responseType?: "auto" | "json" | "text" | "blob" | "arrayBuffer" | "formData" | undefined;
             headers?: Record<string, string> | undefined;
+            credentials?: RequestCredentials | undefined;
+            signal?: AbortSignal | undefined;
+            params?: Record<string, string | number | boolean | null | undefined> | undefined;
             timeout?: number | undefined;
             retry?: number | undefined;
             retryDelay?: number | undefined;
             retryUnsafe?: boolean | undefined;
             cache?: number | undefined;
-            signal?: AbortSignal | undefined;
-            credentials?: RequestCredentials | undefined;
-            responseType?: "auto" | "json" | "text" | "blob" | "arrayBuffer" | "formData" | undefined;
             onProgress?: ((loaded: number, total: number) => void) | undefined;
             offlineQueue?: boolean | undefined;
         }): Promise<unknown>;
@@ -1192,16 +1203,16 @@ declare const core: {
             error?: (e: Event) => void;
         }): EventSource;
         stream(url: string, onLine: (line: string) => void, options?: {
-            params?: Record<string, string | number | boolean | null | undefined> | undefined;
+            responseType?: "auto" | "json" | "text" | "blob" | "arrayBuffer" | "formData" | undefined;
             headers?: Record<string, string> | undefined;
+            credentials?: RequestCredentials | undefined;
+            signal?: AbortSignal | undefined;
+            params?: Record<string, string | number | boolean | null | undefined> | undefined;
             timeout?: number | undefined;
             retry?: number | undefined;
             retryDelay?: number | undefined;
             retryUnsafe?: boolean | undefined;
             cache?: number | undefined;
-            signal?: AbortSignal | undefined;
-            credentials?: RequestCredentials | undefined;
-            responseType?: "auto" | "json" | "text" | "blob" | "arrayBuffer" | "formData" | undefined;
             onProgress?: ((loaded: number, total: number) => void) | undefined;
             offlineQueue?: boolean | undefined;
         }): Promise<void>;
@@ -1643,4 +1654,4 @@ declare function ready(fn?: ReadyCallback): Promise<void>;
 /** Creates elements from an HTML string without inserting them in the document. */
 declare function fromHtml(html: string): VoodooCollection;
 
-export { store as $, type App as A, findScope as B, type ComponentDefinition as C, type DirectiveBinding as D, fromHtml as E, getScope as F, injectStyle as G, instances as H, leave as I, magic as J, magics as K, mountComponent as L, parse as M, query as N, ready as O, PRIORITY as P, refresh as Q, type Resource as R, Scope as S, removeStore as T, rootScope as U, VoodooCollection as V, session as W, slideDown as X, slideUp as Y, start as Z, storage as _, type AppOptions as a, storeNames as a0, stringify as a1, theme as a2, toast as a3, tokenize as a4, url as a5, viewTransition as a6, walk as a7, whenElement as a8, whenReady as a9, type DirectiveHooks as b, core as c, type ResourceOptions as d, type VoodooConfig as e, type VoodooPlugin as f, VoodooRuntimeError as g, VoodooSyntaxError as h, addCleanup as i, allStores as j, allowedGlobals as k, cache as l, clearParseCache as m, config as n, cookie as o, createApp as p, createResource as q, defineComponent as r, defineDirective as s, destroy as t, ready$1 as u, ensureTokens as v, enter as w, evaluate as x, fadeIn as y, fadeOut as z };
+export { start as $, type App as A, findScope as B, type ComponentDefinition as C, type DirectiveBinding as D, fromHtml as E, getScope as F, hook as G, hooks as H, injectStyle as I, instances as J, leave as K, magic as L, magics as M, mountComponent as N, parse as O, PRIORITY as P, query as Q, type Resource as R, Scope as S, ready as T, refresh as U, VoodooCollection as V, removeStore as W, rootScope as X, session as Y, slideDown as Z, slideUp as _, type AppOptions as a, storage as a0, store as a1, storeNames as a2, stringify as a3, theme as a4, toast as a5, tokenize as a6, url as a7, viewTransition as a8, walk as a9, whenElement as aa, whenReady as ab, type DirectiveHooks as b, core as c, type ResourceOptions as d, type VoodooConfig as e, type VoodooPlugin as f, VoodooRuntimeError as g, VoodooSyntaxError as h, addCleanup as i, allStores as j, allowedGlobals as k, cache as l, clearParseCache as m, config as n, cookie as o, createApp as p, createResource as q, defineComponent as r, defineDirective as s, destroy as t, ready$1 as u, ensureTokens as v, enter as w, evaluate as x, fadeIn as y, fadeOut as z };

package/dist/reactivity.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 /**
- * Voodoo.js v0.11.2
+ * Voodoo.js v0.12.1
  * JavaScript feels like magic.
  * (c) 2026 Voodoo.js contributors. MIT License.
  */

package/dist/reactivity.js

@@ -1,4 +1,4 @@
-export { EffectScope, ITERATE_KEY, ReactiveEffect, TriggerType, computed, effect, effectScope, enableTracking, flushSync, getActiveEffect, getActiveScope, handleError, hasChanged, isReactive, isRef, markRaw, nextTick, pauseTracking, queueJob, queuePostFlush, reactive, ref, resetTracking, setErrorHandler, shallowRef, stop, toRaw, track, trigger, unref, warn, watch, watchEffect } from './chunk-WJP3YGUI.js';
-import './chunk-IS3DR2KY.js';
+export { EffectScope, ITERATE_KEY, ReactiveEffect, TriggerType, computed, effect, effectScope, enableTracking, flushSync, getActiveEffect, getActiveScope, handleError, hasChanged, isReactive, isRef, markRaw, nextTick, pauseTracking, queueJob, queuePostFlush, reactive, ref, resetTracking, setErrorHandler, shallowRef, stop, toRaw, track, trigger, unref, warn, watch, watchEffect } from './chunk-LLNDLLKV.js';
+import './chunk-GXPNWCGE.js';
 //# sourceMappingURL=reactivity.js.map
 //# sourceMappingURL=reactivity.js.map

package/dist/socket.cjs

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 /**
- * Voodoo.js v0.11.2
+ * Voodoo.js v0.12.1
  * JavaScript feels like magic.
  * (c) 2026 Voodoo.js contributors. MIT License.
  */

package/dist/socket.js

@@ -1,14 +1,14 @@
-import { socketSupported, createSocket, socket } from './chunk-DCE5WIGA.js';
-export { ENGINE, SIO, createSocket, decodeEngine, decodeSocketIo, encodeSocketIo, engineURL, resolveSocketURL, socket, socketSupported } from './chunk-DCE5WIGA.js';
-import { evaluateIn, readAttr } from './chunk-H2ZUEQWV.js';
-import { reactive } from './chunk-WJP3YGUI.js';
-import { warnAlias } from './chunk-UV5PMS7P.js';
-import { parseDuration } from './chunk-IGZSDZKU.js';
-import { defineDirective, PRIORITY, config } from './chunk-NFDXVIII.js';
-import './chunk-IS3DR2KY.js';
+import { socketSupported, createSocket, socket } from './chunk-HNM3CTBD.js';
+export { ENGINE, SIO, createSocket, decodeEngine, decodeSocketIo, encodeSocketIo, engineURL, resolveSocketURL, socket, socketSupported } from './chunk-HNM3CTBD.js';
+import { evaluateIn, readAttr } from './chunk-4M4ZXHNY.js';
+import { reactive } from './chunk-LLNDLLKV.js';
+import { warnAlias } from './chunk-72PMUUMT.js';
+import { parseDuration } from './chunk-KN7NAKBL.js';
+import { defineDirective, PRIORITY, config } from './chunk-T5ION5NG.js';
+import './chunk-GXPNWCGE.js';
 
 /**
- * Voodoo.js v0.11.2
+ * Voodoo.js v0.12.1
  * JavaScript feels like magic.
  * (c) 2026 Voodoo.js contributors. MIT License.
  */

package/dist/style-GR4X6O7I.js

@@ -0,0 +1,5 @@
+export { BASE_TOKENS, ensureTokens, injectStyle } from './chunk-NP66JM2P.js';
+import './chunk-T5ION5NG.js';
+import './chunk-GXPNWCGE.js';
+//# sourceMappingURL=style-GR4X6O7I.js.map
+//# sourceMappingURL=style-GR4X6O7I.js.map

package/dist/utils.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 /**
- * Voodoo.js v0.11.2
+ * Voodoo.js v0.12.1
  * JavaScript feels like magic.
  * (c) 2026 Voodoo.js contributors. MIT License.
  */

package/dist/utils.js

@@ -1,4 +1,4 @@
-export { capitalize, chunk, clone, debounce, device, escapeHtml, formatCurrency, formatDate, formatFileSize, formatNumber, formatPercent, get, groupBy, isBrowser, matchesMedia, memoize, merge, once, parseDuration, random, relativeTime, sample, set, setFormatDefaults, sleep, slugify, sortBy, stripTags, throttle, titleCase, truncate, uid, unique, uuid } from './chunk-IGZSDZKU.js';
-import './chunk-IS3DR2KY.js';
+export { capitalize, chunk, clone, debounce, device, escapeHtml, formatCurrency, formatDate, formatFileSize, formatNumber, formatPercent, get, groupBy, isBrowser, matchesMedia, memoize, merge, once, parseDuration, random, relativeTime, sample, set, setFormatDefaults, sleep, slugify, sortBy, stripTags, throttle, titleCase, truncate, uid, unique, uuid } from './chunk-KN7NAKBL.js';
+import './chunk-GXPNWCGE.js';
 //# sourceMappingURL=utils.js.map
 //# sourceMappingURL=utils.js.map