zero-query 1.0.9 → 1.2.0

package/types/ssr.d.ts

@@ -1,102 +1,102 @@
-/**
- * Server-Side Rendering - render components to HTML strings.
- *
- * @module ssr
- */
-
-import type { ComponentDefinition } from './component';
-
-/** SSR application instance for server-side component rendering. */
-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.
-   * @param props Props to pass to the component.
-   * @param options Rendering options.
-   */
-  renderToString(
-    componentName: string,
-    props?: Record<string, any>,
-    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.
-   */
-  renderPage(options: {
-    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>;
-
-  /**
-   * Render a component into an existing HTML shell template.
-   *
-   * Unlike `renderPage()` which generates a full document from scratch,
-   * `renderShell()` takes your own `index.html` (with nav, footer, custom
-   * markup) and injects the SSR-rendered component body plus metadata.
-   *
-   * Handles `<z-outlet>` injection, `<title>` replacement, meta description,
-   * Open Graph tags, and `window.__SSR_DATA__` hydration data.
-   *
-   * @param shell - HTML template string (your index.html content).
-   * @param options - Rendering and metadata options.
-   */
-  renderShell(shell: string, options?: {
-    /** Registered component name to render into `<z-outlet>`. */
-    component?: string;
-    /** Props passed to the component. */
-    props?: Record<string, any>;
-    /** Page title — replaces `<title>`. */
-    title?: string;
-    /** Meta description — replaces `<meta name="description">`. */
-    description?: string;
-    /** Open Graph tags to replace or inject (e.g. `{ title, description, type, image }`). */
-    og?: Record<string, string>;
-    /** Data embedded as `window.__SSR_DATA__` for client-side hydration. */
-    ssrData?: any;
-    /** Options passed through to `renderToString()` (hydrate, mode). */
-    renderOptions?: { hydrate?: boolean; mode?: 'html' | 'fragment' };
-  }): Promise<string>;
-}
-
-/** Create an SSR application instance. */
-export function createSSRApp(): SSRApp;
-
-/**
- * Quick one-shot render of a component definition to an HTML string.
- * @param definition Component definition object.
- * @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;
-
-// Re-exported from router for SSR server convenience
-export { matchRoute, RouteMatch } from './router';
+/**
+ * Server-Side Rendering - render components to HTML strings.
+ *
+ * @module ssr
+ */
+
+import type { ComponentDefinition } from './component';
+
+/** SSR application instance for server-side component rendering. */
+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.
+   * @param props Props to pass to the component.
+   * @param options Rendering options.
+   */
+  renderToString(
+    componentName: string,
+    props?: Record<string, any>,
+    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.
+   */
+  renderPage(options: {
+    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>;
+
+  /**
+   * Render a component into an existing HTML shell template.
+   *
+   * Unlike `renderPage()` which generates a full document from scratch,
+   * `renderShell()` takes your own `index.html` (with nav, footer, custom
+   * markup) and injects the SSR-rendered component body plus metadata.
+   *
+   * Handles `<z-outlet>` injection, `<title>` replacement, meta description,
+   * Open Graph tags, and `window.__SSR_DATA__` hydration data.
+   *
+   * @param shell - HTML template string (your index.html content).
+   * @param options - Rendering and metadata options.
+   */
+  renderShell(shell: string, options?: {
+    /** Registered component name to render into `<z-outlet>`. */
+    component?: string;
+    /** Props passed to the component. */
+    props?: Record<string, any>;
+    /** Page title — replaces `<title>`. */
+    title?: string;
+    /** Meta description — replaces `<meta name="description">`. */
+    description?: string;
+    /** Open Graph tags to replace or inject (e.g. `{ title, description, type, image }`). */
+    og?: Record<string, string>;
+    /** Data embedded as `window.__SSR_DATA__` for client-side hydration. */
+    ssrData?: any;
+    /** Options passed through to `renderToString()` (hydrate, mode). */
+    renderOptions?: { hydrate?: boolean; mode?: 'html' | 'fragment' };
+  }): Promise<string>;
+}
+
+/** Create an SSR application instance. */
+export function createSSRApp(): SSRApp;
+
+/**
+ * Quick one-shot render of a component definition to an HTML string.
+ * @param definition Component definition object.
+ * @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;
+
+// Re-exported from router for SSR server convenience
+export { matchRoute, RouteMatch } from './router';

package/types/store.d.ts

@@ -1,145 +1,146 @@
-/**
- * Store - reactive global state management.
- *
- * @module store
- */
-
-import type { ReactiveProxy } from './reactive';
-
-/** Store configuration. */
-export interface StoreConfig<
-  S extends Record<string, any> = Record<string, any>,
-  A extends Record<string, (state: S, ...args: any[]) => any> = Record<string, (state: S, ...args: any[]) => any>,
-  G extends Record<string, (state: S) => any> = Record<string, (state: S) => any>,
-> {
-  /** Initial state. Function form creates a fresh copy. */
-  state?: S | (() => S);
-
-  /** Named action functions. The first argument is always the reactive `state`. */
-  actions?: A;
-
-  /** Computed getters derived from state (lazily evaluated). */
-  getters?: G;
-
-  /** Log dispatched actions to the console. */
-  debug?: boolean;
-
-  /** 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. */
-export interface StoreHistoryEntry {
-  action: string;
-  args: any[];
-  timestamp: number;
-}
-
-/** The reactive store instance. */
-export interface StoreInstance<
-  S extends Record<string, any> = Record<string, any>,
-  A extends Record<string, (state: S, ...args: any[]) => any> = Record<string, (state: S, ...args: any[]) => any>,
-  G extends Record<string, (state: S) => any> = Record<string, (state: S) => any>,
-> {
-  /** Reactive state proxy. Read / write triggers subscriptions. */
-  state: S & ReactiveProxy<S>;
-
-  /** Computed getters object. */
-  readonly getters: { readonly [K in keyof G]: ReturnType<G[K]> };
-
-  /** Log of all dispatched actions. */
-  readonly history: ReadonlyArray<StoreHistoryEntry>;
-
-  /**
-   * Execute a named action.
-   * @returns The action's return value.
-   */
-  dispatch<K extends keyof A>(
-    name: K,
-    ...args: A[K] extends (state: any, ...rest: infer P) => any ? P : any[]
-  ): ReturnType<A[K]>;
-  dispatch(name: string, ...args: any[]): any;
-
-  /**
-   * Subscribe to changes on a specific state key.
-   * Callback receives `(key, newValue, oldValue)`.
-   * @returns An unsubscribe function.
-   */
-  subscribe(key: string, fn: (key: string, value: any, oldValue: any) => void): () => void;
-
-  /**
-   * Subscribe to all state changes (wildcard).
-   * Callback receives `(key, newValue, oldValue)`.
-   * @returns An unsubscribe function.
-   */
-  subscribe(fn: (key: string, value: any, oldValue: any) => void): () => void;
-
-  /** Deep clone of the current state. */
-  snapshot(): S;
-
-  /** Replace the entire state. */
-  replaceState(newState: Partial<S>): void;
-
-  /**
-   * Add middleware. Return `false` from `fn` to block the action.
-   * Chainable.
-   */
-  use(fn: (actionName: string, args: any[], state: S) => boolean | void): StoreInstance<S, A, G>;
-
-  /**
-   * 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. */
-export function createStore<
-  S extends Record<string, any>,
-  A extends Record<string, (state: S, ...args: any[]) => any>,
-  G extends Record<string, (state: S) => any>,
->(config: StoreConfig<S, A, G>): StoreInstance<S, A, G>;
-export function createStore<
-  S extends Record<string, any>,
-  A extends Record<string, (state: S, ...args: any[]) => any>,
-  G extends Record<string, (state: S) => any>,
->(name: string, config: StoreConfig<S, A, G>): StoreInstance<S, A, G>;
-
-/** Retrieve a previously created store by name (default: `'default'`). */
-export function getStore<
-  S extends Record<string, any> = Record<string, any>,
-  A extends Record<string, (state: S, ...args: any[]) => any> = Record<string, (state: S, ...args: any[]) => any>,
-  G extends Record<string, (state: S) => any> = Record<string, (state: S) => any>,
->(name?: string): StoreInstance<S, A, G> | null;
+/**
+ * Store - reactive global state management.
+ *
+ * @module store
+ */
+
+import type { ReactiveProxy } from './reactive';
+
+/** Store configuration. */
+export interface StoreConfig<
+  S extends Record<string, any> = Record<string, any>,
+  A extends Record<string, (state: S, ...args: any[]) => any> = Record<string, (state: S, ...args: any[]) => any>,
+  G extends Record<string, (state: S) => any> = Record<string, (state: S) => any>,
+> {
+  /** Initial state. Function form creates a fresh copy. */
+  state?: S | (() => S);
+
+  /** Named action functions. The first argument is always the reactive `state`. */
+  actions?: A;
+
+  /** Computed getters derived from state (lazily evaluated). */
+  getters?: G;
+
+  /** Log dispatched actions to the console. */
+  debug?: boolean;
+
+  /** 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. */
+export interface StoreHistoryEntry {
+  action: string;
+  args: any[];
+  timestamp: number;
+}
+
+/** The reactive store instance. */
+export interface StoreInstance<
+  S extends Record<string, any> = Record<string, any>,
+  A extends Record<string, (state: S, ...args: any[]) => any> = Record<string, (state: S, ...args: any[]) => any>,
+  G extends Record<string, (state: S) => any> = Record<string, (state: S) => any>,
+> {
+  /** Reactive state proxy. Read / write triggers subscriptions. */
+  state: S & ReactiveProxy<S>;
+
+  /** Computed getters object. */
+  readonly getters: { readonly [K in keyof G]: ReturnType<G[K]> };
+
+  /** Log of all dispatched actions. */
+  readonly history: ReadonlyArray<StoreHistoryEntry>;
+
+  /**
+   * Execute a named action.
+   * @returns The action's return value.
+   */
+  dispatch<K extends keyof A>(
+    name: K,
+    ...args: A[K] extends (state: any, ...rest: infer P) => any ? P : any[]
+  ): ReturnType<A[K]>;
+  dispatch(name: string, ...args: any[]): any;
+
+  /**
+   * Subscribe to changes on a specific state key.
+   * Callback receives `(key, newValue, oldValue)`.
+   * @returns An unsubscribe function.
+   */
+  subscribe(key: string, fn: (key: string, value: any, oldValue: any) => void): () => void;
+
+  /**
+   * Subscribe to all state changes (wildcard).
+   * Callback receives `(key, newValue, oldValue)`.
+   * @returns An unsubscribe function.
+   */
+  subscribe(fn: (key: string, value: any, oldValue: any) => void): () => void;
+
+  /** Deep clone of the current state. */
+  snapshot(): S;
+
+  /** Replace the entire state. */
+  replaceState(newState: Partial<S>): void;
+
+  /**
+   * Add middleware. Return `false` from `fn` to block the action.
+   * Chainable.
+   */
+  use(fn: (actionName: string, args: any[], state: S) => boolean | void): StoreInstance<S, A, G>;
+
+  /**
+   * 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.
+   * @returns The callback's return value.
+   */
+  batch<R = void>(fn: (state: S) => R): R;
+
+  /**
+   * 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. */
+export function createStore<
+  S extends Record<string, any>,
+  A extends Record<string, (state: S, ...args: any[]) => any>,
+  G extends Record<string, (state: S) => any>,
+>(config: StoreConfig<S, A, G>): StoreInstance<S, A, G>;
+export function createStore<
+  S extends Record<string, any>,
+  A extends Record<string, (state: S, ...args: any[]) => any>,
+  G extends Record<string, (state: S) => any>,
+>(name: string, config: StoreConfig<S, A, G>): StoreInstance<S, A, G>;
+
+/** Retrieve a previously created store by name (default: `'default'`). */
+export function getStore<
+  S extends Record<string, any> = Record<string, any>,
+  A extends Record<string, (state: S, ...args: any[]) => any> = Record<string, (state: S, ...args: any[]) => any>,
+  G extends Record<string, (state: S) => any> = Record<string, (state: S) => any>,
+>(name?: string): StoreInstance<S, A, G> | null;