zero-query 0.9.9 → 1.0.1

package/types/reactive.d.ts

@@ -1,12 +1,12 @@
 /**
- * Reactive primitives — deep proxies and signals.
+ * Reactive primitives - deep proxies and signals.
  *
  * @module reactive
  */
 
 /** Marker properties added to every reactive proxy. */
 export interface ReactiveProxy<T extends object = object> {
-  /** Always `true` — indicates this object is wrapped in a reactive Proxy. */
+  /** Always `true` - indicates this object is wrapped in a reactive Proxy. */
   readonly __isReactive: true;
   /** The original un-proxied object. */
   readonly __raw: T;
@@ -65,7 +65,7 @@ export function computed<T>(fn: () => T): Signal<T>;
  * Re-runs automatically when any tracked signal changes.
  *
  * @param fn The effect function. Executed immediately on creation, then on signal changes.
- * @returns A dispose function — calling it stops tracking and prevents re-runs.
+ * @returns A dispose function - calling it stops tracking and prevents re-runs.
  *
  * @example
  * const count = signal(0);
@@ -74,3 +74,25 @@ export function computed<T>(fn: () => T): Signal<T>;
  * stop();          // effect no longer runs
  */
 export function effect(fn: () => void): () => void;
+
+/**
+ * Batch multiple signal writes - subscribers and effects fire once at the end.
+ * Nested batches are merged into the outermost one.
+ *
+ * @example
+ * const a = signal(0);
+ * const b = signal(0);
+ * batch(() => {
+ *   a.value = 1;
+ *   b.value = 2;
+ * }); // effects run once with both values updated
+ */
+export function batch(fn: () => void): void;
+
+/**
+ * Execute a function without tracking signal reads as dependencies.
+ * Useful inside effects when you need to read a signal without subscribing.
+ *
+ * @returns The return value of `fn`.
+ */
+export function untracked<T>(fn: () => T): T;

package/types/router.d.ts

@@ -1,5 +1,5 @@
 /**
- * SPA Router — history and hash-based client-side routing.
+ * SPA Router - history and hash-based client-side routing.
  *
  * @module router
  */
@@ -39,7 +39,11 @@ export interface NavigationContext {
 
 /** Router configuration. */
 export interface RouterConfig {
-  /** Outlet element where route components are rendered. */
+  /**
+   * Outlet element where route components are rendered.
+   * If omitted, the router auto-detects a `<z-outlet>` element in the DOM.
+   * Acts as an explicit override of the default `<z-outlet>` lookup.
+   */
   el?: string | Element;
   /** Routing mode (default: `'history'`; `'hash'` for file:// or hash routing). */
   mode?: 'history' | 'hash';
@@ -86,7 +90,7 @@ export interface RouterInstance {
   remove(path: string): RouterInstance;
 
   /**
-   * Navigation guard — runs before each route change.
+   * Navigation guard - runs before each route change.
    * Return `false` to cancel, or a `string` to redirect.
    */
   beforeEach(
@@ -111,10 +115,10 @@ export interface RouterInstance {
 
   /**
    * Push a lightweight history entry for in-component UI state (modal, tab, panel).
-   * The URL does NOT change — only a history entry is added so the back button
+   * The URL does NOT change - only a history entry is added so the back button
    * can undo the UI change before navigating away from the route.
-   * @param key — identifier for the substate (e.g. 'modal', 'tab')
-   * @param data — arbitrary serializable state
+   * @param key - identifier for the substate (e.g. 'modal', 'tab')
+   * @param data - arbitrary serializable state
    * @example
    * router.pushSubstate('modal', { id: 'confirm-delete' });
    */

package/types/ssr.d.ts

@@ -1,5 +1,5 @@
 /**
- * Server-Side Rendering — render components to HTML strings.
+ * Server-Side Rendering - render components to HTML strings.
  *
  * @module ssr
  */
@@ -64,6 +64,6 @@ export function createSSRApp(): SSRApp;
 export function renderToString(definition: ComponentDefinition, props?: Record<string, any>): string;
 
 /**
- * Escape HTML entities — exposed for use in SSR templates.
+ * Escape HTML entities - exposed for use in SSR templates.
  */
 export function escapeHtml(str: string): string;

package/types/store.d.ts

@@ -1,5 +1,5 @@
 /**
- * Store — reactive global state management.
+ * Store - reactive global state management.
  *
  * @module store
  */
@@ -26,6 +26,9 @@ export interface StoreConfig<
 
   /** Maximum number of action history entries to keep (default `1000`). */
   maxHistory?: number;
+
+  /** Maximum number of undo checkpoints to keep (default `50`). */
+  maxUndo?: number;
 }
 
 /** A store action history entry. */
@@ -62,10 +65,10 @@ export interface StoreInstance<
 
   /**
    * Subscribe to changes on a specific state key.
-   * Callback receives `(newValue, oldValue, key)`.
+   * Callback receives `(key, newValue, oldValue)`.
    * @returns An unsubscribe function.
    */
-  subscribe(key: string, fn: (value: any, oldValue: any, key: string) => void): () => void;
+  subscribe(key: string, fn: (key: string, value: any, oldValue: any) => void): () => void;
 
   /**
    * Subscribe to all state changes (wildcard).
@@ -86,8 +89,40 @@ export interface StoreInstance<
    */
   use(fn: (actionName: string, args: any[], state: S) => boolean | void): StoreInstance<S, A, G>;
 
-  /** Replace state and clear action history. */
-  reset(initialState: Partial<S>): void;
+  /**
+   * Replace state and clear action history.
+   * If no argument, resets to the original initial state.
+   */
+  reset(initialState?: Partial<S>): void;
+
+  /**
+   * Batch multiple state changes - subscribers fire once at the end
+   * with only the latest value per key.
+   */
+  batch(fn: (state: S) => void): void;
+
+  /**
+   * Save a state snapshot for undo. Call before making changes you want to be undoable.
+   */
+  checkpoint(): void;
+
+  /**
+   * Undo to the last checkpoint.
+   * @returns `true` if undo was performed, `false` if nothing to undo.
+   */
+  undo(): boolean;
+
+  /**
+   * Redo the last undone state change.
+   * @returns `true` if redo was performed, `false` if nothing to redo.
+   */
+  redo(): boolean;
+
+  /** Whether undo is available. */
+  readonly canUndo: boolean;
+
+  /** Whether redo is available. */
+  readonly canRedo: boolean;
 }
 
 /** Create a new global reactive store. */

package/types/utils.d.ts

@@ -1,5 +1,5 @@
 /**
- * Utility functions — debounce, throttle, strings, objects, URL, storage, event bus.
+ * Utility functions - debounce, throttle, strings, objects, URL, storage, event bus.
  *
  * @module utils
  */