zero-query 0.9.8 → 1.0.0

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
  */
@@ -11,6 +11,9 @@ export interface SSRApp {
   /** Register a component for SSR. */
   component(name: string, definition: ComponentDefinition): SSRApp;
 
+  /** Check whether a component is registered. */
+  has(name: string): boolean;
+
   /**
    * Render a component to an HTML string.
    * @param componentName Registered component name.
@@ -20,9 +23,16 @@ export interface SSRApp {
   renderToString(
     componentName: string,
     props?: Record<string, any>,
-    options?: { hydrate?: boolean },
+    options?: { hydrate?: boolean; mode?: 'html' | 'fragment' },
   ): Promise<string>;
 
+  /**
+   * Render multiple components as a batch.
+   */
+  renderBatch(
+    entries: Array<{ name: string; props?: Record<string, any>; options?: { hydrate?: boolean; mode?: 'html' | 'fragment' } }>,
+  ): Promise<string[]>;
+
   /**
    * Render a full HTML page with a component mounted in a shell.
    */
@@ -30,11 +40,16 @@ export interface SSRApp {
     component?: string;
     props?: Record<string, any>;
     title?: string;
+    description?: string;
     styles?: string[];
     scripts?: string[];
     lang?: string;
     meta?: string;
     bodyAttrs?: string;
+    head?: {
+      canonical?: string;
+      og?: Record<string, string>;
+    };
   }): Promise<string>;
 }
 
@@ -47,3 +62,8 @@ export function createSSRApp(): SSRApp;
  * @param props Props to pass.
  */
 export function renderToString(definition: ComponentDefinition, props?: Record<string, any>): string;
+
+/**
+ * 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
  */