zero-query 0.6.3 → 0.8.6

package/index.d.ts

@@ -4,1278 +4,133 @@
  * Lightweight modern frontend library — jQuery-like selectors, reactive
  * components, SPA router, state management, HTTP client & utilities.
  *
- * @version 0.6.3
+ * @version 0.8.6
  * @license MIT
  * @see https://z-query.com/docs
  */
 
 // ---------------------------------------------------------------------------
-// ZQueryCollection
-// ---------------------------------------------------------------------------
-
-/**
- * Chainable wrapper around an array of DOM elements, similar to a jQuery object.
- * Returned by `$.all()` and many traversal / filtering methods.
- */
-export class ZQueryCollection {
-  /** Number of elements in the collection. */
-  readonly length: number;
-
-  /** Access element by numeric index. */
-  readonly [index: number]: Element;
-
-  constructor(elements: Element | Element[]);
-
-  // -- Iteration -----------------------------------------------------------
-  /**
-   * Iterate over each element. `this` inside the callback is the element.
-   * @returns The collection (for chaining).
-   */
-  each(fn: (this: Element, index: number, element: Element) => void): this;
-
-  /**
-   * Map over elements and return a plain array.
-   */
-  map<T>(fn: (this: Element, index: number, element: Element) => T): T[];
-
-  /**
-   * Iterate elements with Array-style `forEach`. Returns `this` for chaining.
-   */
-  forEach(fn: (element: Element, index: number, elements: Element[]) => void): this;
-
-  /** First raw element, or `null`. */
-  first(): Element | null;
-
-  /** Last raw element, or `null`. */
-  last(): Element | null;
-
-  /** New collection containing only the element at `index`. */
-  eq(index: number): ZQueryCollection;
-
-  /** Convert to a plain `Element[]`. */
-  toArray(): Element[];
-
-  /** Iterable protocol — works with `for...of` and spread. */
-  [Symbol.iterator](): IterableIterator<Element>;
-
-  // -- Traversal -----------------------------------------------------------
-  /** Descendants matching `selector`. */
-  find(selector: string): ZQueryCollection;
-
-  /** Unique parent elements. */
-  parent(): ZQueryCollection;
-
-  /** Nearest ancestor matching `selector`. */
-  closest(selector: string): ZQueryCollection;
-
-  /** Direct children, optionally filtered by `selector`. */
-  children(selector?: string): ZQueryCollection;
-
-  /** All sibling elements. */
-  siblings(): ZQueryCollection;
-
-  /** Next sibling of each element. */
-  next(): ZQueryCollection;
-
-  /** Previous sibling of each element. */
-  prev(): ZQueryCollection;
-
-  // -- Filtering -----------------------------------------------------------
-  /** Keep elements matching a CSS selector or predicate. */
-  filter(selector: string): ZQueryCollection;
-  filter(fn: (element: Element, index: number) => boolean): ZQueryCollection;
-
-  /** Remove elements matching a CSS selector or predicate. */
-  not(selector: string): ZQueryCollection;
-  not(fn: (this: Element, index: number, element: Element) => boolean): ZQueryCollection;
-
-  /** Keep elements that have a descendant matching `selector`. */
-  has(selector: string): ZQueryCollection;
-
-  // -- Classes -------------------------------------------------------------
-  /** Add one or more classes (space-separated strings accepted). */
-  addClass(...names: string[]): this;
-
-  /** Remove one or more classes. */
-  removeClass(...names: string[]): this;
-
-  /** Toggle a class. Optional `force` boolean. */
-  toggleClass(name: string, force?: boolean): this;
-
-  /** Check whether the first element has the given class. */
-  hasClass(name: string): boolean;
-
-  // -- Attributes & Properties ---------------------------------------------
-  /** Get attribute value of the first element. */
-  attr(name: string): string | null;
-  /** Set attribute on all elements. */
-  attr(name: string, value: string): this;
-
-  /** Remove attribute from all elements. */
-  removeAttr(name: string): this;
-
-  /** Get JS property of the first element. */
-  prop(name: string): any;
-  /** Set JS property on all elements. */
-  prop(name: string, value: any): this;
-
-  /** Get data attribute value (JSON auto-parsed). No key → full dataset. */
-  data(): DOMStringMap;
-  data(key: string): any;
-  /** Set data attribute on all elements. Objects are JSON-stringified. */
-  data(key: string, value: any): this;
-
-  // -- CSS & Dimensions ----------------------------------------------------
-  /** Get computed style property of the first element, or `undefined` if empty. */
-  css(property: string): string | undefined;
-  /** Set inline styles on all elements. */
-  css(props: Partial<CSSStyleDeclaration>): this;
-
-  /** First element's width (from `getBoundingClientRect`). */
-  width(): number | undefined;
-
-  /** First element's height. */
-  height(): number | undefined;
-
-  /** Position relative to the document. */
-  offset(): { top: number; left: number; width: number; height: number } | null;
-
-  /** Position relative to the offset parent. */
-  position(): { top: number; left: number } | null;
-
-  // -- Content -------------------------------------------------------------
-  /** Get `innerHTML` of the first element, or `undefined` if empty. */
-  html(): string | undefined;
-  /** Set `innerHTML` on all elements. */
-  html(content: string): this;
-
-  /** Get `textContent` of the first element, or `undefined` if empty. */
-  text(): string | undefined;
-  /** Set `textContent` on all elements. */
-  text(content: string): this;
-
-  /** Get value of the first input/select/textarea, or `undefined` if empty. */
-  val(): string | undefined;
-  /** Set value on all inputs. */
-  val(value: string): this;
-
-  // -- DOM Manipulation ----------------------------------------------------
-  /** Insert content at the end of each element. */
-  append(content: string | Node | ZQueryCollection): this;
-
-  /** Insert content at the beginning of each element. */
-  prepend(content: string | Node): this;
-
-  /** Insert content after each element. */
-  after(content: string | Node): this;
-
-  /** Insert content before each element. */
-  before(content: string | Node): this;
-
-  /** Wrap each element with the given HTML string or Node. */
-  wrap(wrapper: string | Node): this;
-
-  /** Remove all elements from the DOM. */
-  remove(): this;
-
-  /** Clear `innerHTML` of all elements. */
-  empty(): this;
-
-  /** Clone elements (default: deep clone). */
-  clone(deep?: boolean): ZQueryCollection;
-
-  /** Replace elements with new content. */
-  replaceWith(content: string | Node): this;
-
-  // -- Visibility ----------------------------------------------------------
-  /** Show elements. Optional display value (default: `''`). */
-  show(display?: string): this;
-
-  /** Set `display: none` on all elements. */
-  hide(): this;
-
-  /** Toggle visibility. */
-  toggle(display?: string): this;
-
-  // -- Events --------------------------------------------------------------
-  /** Attach event handler. Space-separated events accepted. */
-  on(events: string, handler: (event: Event) => void): this;
-  /** Delegated event handler. */
-  on(events: string, selector: string, handler: (this: Element, event: Event) => void): this;
-
-  /** Remove event handler. */
-  off(events: string, handler: (event: Event) => void): this;
-
-  /** One-time event handler. */
-  one(event: string, handler: (event: Event) => void): this;
-
-  /**
-   * Dispatch a `CustomEvent` with optional detail payload.
-   * Bubbles by default.
-   */
-  trigger(event: string, detail?: any): this;
-
-  /** Attach click handler, or trigger a click when called with no arguments. */
-  click(fn?: (event: Event) => void): this;
-
-  /** Attach submit handler, or trigger submit when called with no arguments. */
-  submit(fn?: (event: Event) => void): this;
-
-  /** Focus the first element. */
-  focus(): this;
-
-  /** Blur the first element. */
-  blur(): this;
-
-  // -- Animation -----------------------------------------------------------
-  /**
-   * CSS transition animation.
-   * @param props   CSS properties to animate to.
-   * @param duration Duration in ms (default 300).
-   * @param easing  CSS easing function (default `'ease'`).
-   */
-  animate(
-    props: Partial<CSSStyleDeclaration>,
-    duration?: number,
-    easing?: string,
-  ): Promise<ZQueryCollection>;
-
-  /** Fade in (opacity 0→1). Default 300 ms. */
-  fadeIn(duration?: number): Promise<ZQueryCollection>;
-
-  /** Fade out (opacity 1→0) then hide. Default 300 ms. */
-  fadeOut(duration?: number): Promise<ZQueryCollection>;
-
-  /** Toggle height with a slide animation. Default 300 ms. */
-  slideToggle(duration?: number): this;
-
-  // -- Form Helpers --------------------------------------------------------
-  /** URL-encoded form data string. */
-  serialize(): string;
-
-  /** Form data as key/value object. Duplicate keys become arrays. */
-  serializeObject(): Record<string, string | string[]>;
-}
-
-
-// ---------------------------------------------------------------------------
-// Reactive
-// ---------------------------------------------------------------------------
-
-/** Marker properties added to every reactive proxy. */
-interface ReactiveProxy<T extends object = object> {
-  /** Always `true` — indicates this object is wrapped in a reactive Proxy. */
-  readonly __isReactive: true;
-  /** The original un-proxied object. */
-  readonly __raw: T;
-}
-
-/**
- * Wrap an object in a deep Proxy that fires `onChange` on every set / delete.
- */
-export function reactive<T extends object>(
-  target: T,
-  onChange: (key: string, value: any, oldValue: any) => void,
-): T & ReactiveProxy<T>;
-
-/** A lightweight reactive primitive (inspired by Solid / Preact signals). */
-export class Signal<T = any> {
-  constructor(value: T);
-
-  /** Get/set the current value. The getter auto-tracks inside `effect()`. */
-  value: T;
-
-  /** Read the value without creating a subscription. */
-  peek(): T;
-
-  /**
-   * Manually subscribe to changes.
-   * @returns An unsubscribe function.
-   */
-  subscribe(fn: () => void): () => void;
-
-  toString(): string;
-}
-
-/** Create a new `Signal`. */
-export function signal<T>(initial: T): Signal<T>;
-
-/**
- * Create a derived signal that recomputes when its dependencies change.
- * The returned signal is effectively read-only.
- */
-export function computed<T>(fn: () => T): Signal<T>;
-
-/**
- * Run a side-effect that auto-subscribes to signals read during execution.
- * @returns A dispose function that stops tracking.
- */
-export function effect(fn: () => void): () => void;
-
-
-// ---------------------------------------------------------------------------
-// Component System
-// ---------------------------------------------------------------------------
-
-/** Item in a `pages` config — either a string id or an `{ id, label }` object. */
-type PageItem = string | { id: string; label?: string };
-
-/**
- * Declarative multi-page configuration for a component.
- *
- * Pages are **lazy-loaded**: only the active page is fetched on first render.
- * Remaining pages are prefetched in the background for instant navigation.
- */
-interface PagesConfig {
-  /** Directory containing the page HTML files (resolved relative to `base`). */
-  dir?: string;
-  /** Route parameter name to read (e.g. `'section'` for `/docs/:section`). */
-  param?: string;
-  /** Default page id when the param is absent. */
-  default?: string;
-  /** File extension appended to each page id (default `'.html'`). */
-  ext?: string;
-  /** List of page ids and/or `{ id, label }` objects. */
-  items?: PageItem[];
-}
-
-/** The object passed to `$.component()` to define a component. */
-interface ComponentDefinition {
-  /**
-   * Initial reactive state.
-   * A function form is recommended so each instance gets its own copy.
-   */
-  state?: Record<string, any> | (() => Record<string, any>);
-
-  /**
-   * Returns an HTML string. Called on every state change.
-   * `this` is the component instance.
-   */
-  render?(this: ComponentInstance): string;
-
-  /** CSS string — scoped to the component root on first render. */
-  styles?: string;
-
-  /**
-   * URL (or array / object map of URLs) to external HTML template file(s).
-   * If `render()` is also defined, `render()` takes priority.
-   */
-  templateUrl?: string | string[] | Record<string, string>;
-
-  /**
-   * URL (or array of URLs) to external CSS file(s).
-   * Fetched and auto-scoped on first mount; merged with `styles` if both present.
-   */
-  styleUrl?: string | string[];
-
-  /** High-level multi-page configuration shorthand. */
-  pages?: PagesConfig;
-
-  /**
-   * Override the base path for resolving relative `templateUrl`, `styleUrl`,
-   * and `pages.dir` paths. Normally auto-detected from the calling file.
-   */
-  base?: string;
-
-  /** Called before first render (during construction). */
-  init?(this: ComponentInstance): void;
-
-  /** Called once after first render and DOM insertion. */
-  mounted?(this: ComponentInstance): void;
-
-  /** Called after every subsequent re-render. */
-  updated?(this: ComponentInstance): void;
-
-  /** Called when the component is destroyed. Clean up subscriptions here. */
-  destroyed?(this: ComponentInstance): void;
-
-  /**
-   * Computed properties — lazy getters derived from state.
-   * Each function receives the raw state as its argument.
-   * Access via `this.computed.name` in methods and templates.
-   */
-  computed?: Record<string, (state: Record<string, any>) => any>;
-
-  /**
-   * Watch state keys for changes.
-   * Keys support dot-path notation (e.g. `'user.name'`).
-   * Handler receives `(newValue, oldValue)`.
-   */
-  watch?: Record<string, ((this: ComponentInstance, newVal: any, oldVal: any) => void) | { handler: (this: ComponentInstance, newVal: any, oldVal: any) => void }>;
-
-  /** Additional keys become instance methods (bound to the instance). */
-  [method: string]: any;
-}
-
-/** The runtime instance of a mounted component. */
-interface ComponentInstance {
-  /** Reactive state proxy. Mutating triggers re-render. */
-  state: Record<string, any> & ReactiveProxy;
-
-  /** Frozen props passed from parent / router.
-   * When mounted by the router, includes `$route` (NavigationContext), `$query`, and `$params`.
-   */
-  readonly props: Readonly<Record<string, any> & {
-    $route?: NavigationContext;
-    $query?: Record<string, string>;
-    $params?: Record<string, string>;
-  }>;
-
-  /** Map of `z-ref` name → DOM element. Populated after each render. */
-  refs: Record<string, Element>;
-
-  /** Keyed template map (when using multi-`templateUrl` or `pages`). */
-  templates: Record<string, string>;
-
-  /** Normalized page metadata (when using `pages` config). */
-  pages: Array<{ id: string; label: string }>;
-
-  /** Active page id derived from route param (when using `pages` config). */
-  activePage: string;
-
-  /**
-   * Computed properties — lazy getters derived from state.
-   * Defined via `computed` in the component definition.
-   */
-  readonly computed: Record<string, any>;
-
-  /** Merge partial state (triggers re-render). */
-  setState(partial: Record<string, any>): void;
-
-  /** Dispatch a bubbling `CustomEvent` from the component root. */
-  emit(name: string, detail?: any): void;
-
-  /** Teardown: removes listeners, scoped styles, clears DOM. */
-  destroy(): void;
-
-  /** Manually queue a re-render (microtask-batched). Safe to call from anywhere — state mutations during render are coalesced (no infinite loop risk). */
-  _scheduleUpdate(): void;
-
-  /** Any user-defined methods from the component definition. */
-  [method: string]: any;
-}
-
-/**
- * Register a new component.
- * @param name Must contain a hyphen (Web Component convention).
- * @param definition Component definition object.
- */
-export function component(name: string, definition: ComponentDefinition): void;
-
-/**
- * Mount a registered component into a target element.
- * @returns The component instance.
- */
-export function mount(
-  target: string | Element,
-  componentName: string,
-  props?: Record<string, any>,
-): ComponentInstance;
-
-/**
- * Scan `root` for elements whose tag matches a registered component and mount them.
- * @param root Defaults to `document.body`.
- */
-export function mountAll(root?: Element): void;
-
-/**
- * Get the component instance mounted on `target`.
- */
-export function getInstance(target: string | Element): ComponentInstance | null;
-
-/**
- * Destroy the component at the given target.
- */
-export function destroy(target: string | Element): void;
-
-/**
- * Returns an object of all registered component definitions (for debugging).
- */
-export function getRegistry(): Record<string, ComponentDefinition>;
-
-/** Handle returned by `$.style()`. */
-interface StyleHandle {
-  /** Remove all injected `<link>` elements. */
-  remove(): void;
-  /** Resolves when all stylesheets have loaded. */
-  ready: Promise<void>;
-}
-
-/** Options for `$.style()`. */
-interface StyleOptions {
-  /** Hide page until loaded to prevent FOUC (default `true`). */
-  critical?: boolean;
-  /** Background color while hidden during critical load (default `'#0d1117'`). */
-  bg?: string;
-}
-
-/**
- * Dynamically load global (unscoped) stylesheet file(s) into `<head>`.
- * Relative paths resolve relative to the calling file.
- */
-export function style(urls: string | string[], opts?: StyleOptions): StyleHandle;
-
-
-// ---------------------------------------------------------------------------
-// DOM Diffing (Morphing)
-// ---------------------------------------------------------------------------
-
-/**
- * Morph an existing DOM element's children to match new HTML.
- * Only touches nodes that actually differ — preserves focus, scroll
- * positions, video playback, and other live DOM state.
- *
- * Use `z-key="uniqueId"` attributes on list items for keyed reconciliation.
- *
- * @param rootEl The live DOM container to patch.
- * @param newHTML The desired HTML string.
- */
-export function morph(rootEl: Element, newHTML: string): void;
-
-
-// ---------------------------------------------------------------------------
-// Safe Expression Evaluator
-// ---------------------------------------------------------------------------
-
-/**
- * CSP-safe expression evaluator. Parses and evaluates JS expressions
- * without `eval()` or `new Function()`. Used internally by directives.
- *
- * @param expr Expression string.
- * @param scope Array of scope objects checked in order for identifier resolution.
- * @returns Evaluation result, or `undefined` on error.
- */
-export function safeEval(expr: string, scope: object[]): any;
-
-
-// ---------------------------------------------------------------------------
-// SSR (Server-Side Rendering)
-// ---------------------------------------------------------------------------
-
-/** SSR application instance for server-side component rendering. */
-interface SSRApp {
-  /** Register a component for SSR. */
-  component(name: string, definition: ComponentDefinition): SSRApp;
-
-  /**
-   * 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 },
-  ): Promise<string>;
-
-  /**
-   * Render a full HTML page with a component mounted in a shell.
-   */
-  renderPage(options: {
-    component?: string;
-    props?: Record<string, any>;
-    title?: string;
-    styles?: string[];
-    scripts?: string[];
-    lang?: string;
-    meta?: string;
-    bodyAttrs?: string;
-  }): 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;
-
-
-// ---------------------------------------------------------------------------
-// Directive System
-// ---------------------------------------------------------------------------
-//
-// Directives are special attributes processed by zQuery's component renderer.
-// They work in both `render()` template literals and external `templateUrl`
-// HTML files. All expressions evaluate in the component's state context
-// (bare names resolve to `this.state.*`; `props` and `refs` also available).
-//
-// ─── Structural Directives ──────────────────────────────────────────────
-//
-//   z-if="expression"          Conditional rendering — element removed when falsy.
-//   z-else-if="expression"     Else-if branch (must be immediate sibling of z-if).
-//   z-else                     Default branch (must follow z-if or z-else-if).
-//
-//   z-for="item in items"      List rendering — repeats the element per item.
-//     {{item.prop}}              Use double-brace interpolation for item data.
-//     (item, index) in items     Destructured index support.
-//     n in 5                     Number range → [1, 2, 3, 4, 5].
-//     (val, key) in object       Object iteration → {key, value} entries.
-//
-//   z-key="uniqueId"           Keyed reconciliation for list items.
-//                              Preserves DOM nodes across reorders. Use inside
-//                              z-for to give each item a stable identity.
-//                              Example: <li z-for="item in items" z-key="{{item.id}}">
-//
-//   z-show="expression"        Toggle `display: none` (element stays in DOM).
-//
-// ─── Attribute Directives ───────────────────────────────────────────────
-//
-//   z-bind:attr="expression"   Dynamic attribute binding.
-//   :attr="expression"         Shorthand for z-bind:attr.
-//                              false/null/undefined → removes the attribute.
-//                              true → sets empty attribute (e.g. disabled="").
-//
-//   z-class="expression"       Dynamic class binding.
-//                              String: space-separated class names.
-//                              Array: list of class names (falsy filtered).
-//                              Object: { className: condition } map.
-//
-//   z-style="expression"       Dynamic inline styles.
-//                              String: appended to existing cssText.
-//                              Object: { property: value } map (camelCase keys).
-//
-//   z-html="expression"        Set innerHTML from expression (use trusted content only).
-//   z-text="expression"        Set textContent from expression (safe, no HTML).
-//
-// ─── Form & Reference Directives ────────────────────────────────────────
-//
-//   z-model="stateKey"         Two-way binding for form elements.
-//     Supports: input, textarea, select, select[multiple], contenteditable.
-//     Nested keys: z-model="user.name" → this.state.user.name.
-//     Modifiers (boolean attributes on same element):
-//       z-lazy    — update on 'change' instead of 'input' (update on blur).
-//       z-trim    — auto .trim() whitespace before writing to state.
-//       z-number  — force Number() conversion regardless of input type.
-//
-//   z-ref="name"               Element reference → this.refs.name.
-//
-// ─── Event Directives ───────────────────────────────────────────────────
-//
-//   @event="method"            Event binding with delegation (shorthand).
-//   z-on:event="method"        Event binding with delegation (full syntax).
-//   @event="method(args)"      Pass arguments: strings, numbers, booleans,
-//                              null, $event, state.key references.
-//
-//   Event Modifiers (chainable with dots):
-//     .prevent                 event.preventDefault()
-//     .stop                    event.stopPropagation()
-//     .self                    Only fire if event.target === element itself.
-//     .once                    Handler fires at most once per element.
-//     .capture                 addEventListener with { capture: true }.
-//     .passive                 addEventListener with { passive: true }.
-//     .debounce.{ms}           Debounce: delay until {ms}ms idle (default 250).
-//     .throttle.{ms}           Throttle: invoke at most once per {ms}ms (default 250).
-//
-// ─── Special Directives ─────────────────────────────────────────────────
-//
-//   z-cloak                    Hidden until rendered (auto-removed after mount).
-//                              Global CSS: [z-cloak] { display: none !important }.
-//                              Also injects: *, *::before, *::after { -webkit-tap-highlight-color: transparent }.
-//
-//   z-pre                      Skip all directive processing for this element
-//                              and its descendants.
-//
-// ─── Slot System ────────────────────────────────────────────────────────
-//
-//   <slot>                     Default slot — replaced with child content
-//                              passed by the parent component.
-//   <slot name="header">       Named slot — replaced with child content that
-//                              has a matching slot="header" attribute.
-//   <slot>fallback</slot>      Fallback content shown when no slot content provided.
-//
-//   Parent usage:
-//     <my-component>
-//       <h1 slot="header">Title</h1>   (→ named slot "header")
-//       <p>Body text</p>               (→ default slot)
-//     </my-component>
-//
-// ─── Processing Order ───────────────────────────────────────────────────
-//
-//   1. z-for        (pre-innerHTML expansion)
-//   2. z-if chain   (DOM removal)
-//   3. z-show       (display toggle)
-//   4. z-bind / :   (dynamic attributes)
-//   5. z-class      (dynamic classes)
-//   6. z-style      (dynamic styles)
-//   7. z-html/text  (content injection)
-//   8. @/z-on       (event binding)
-//   9. z-ref        (element references)
-//  10. z-model      (two-way binding)
-//  11. z-cloak      (attribute removal)
-//
-// ---------------------------------------------------------------------------
-
-/**
- * Supported event modifier strings for `@event` and `z-on:event` bindings.
- * Modifiers are appended to the event name with dots, e.g. `@click.prevent.stop`.
- */
-type EventModifier =
-  | 'prevent'
-  | 'stop'
-  | 'self'
-  | 'once'
-  | 'capture'
-  | 'passive'
-  | `debounce`
-  | `debounce.${number}`
-  | `throttle`
-  | `throttle.${number}`;
-
-export { EventModifier };
-
-
-// ---------------------------------------------------------------------------
-// Router
-// ---------------------------------------------------------------------------
-
-/** A single route definition. */
-interface RouteDefinition {
-  /**
-   * URL pattern. Supports `:param` segments and `*` wildcard.
-   * @example '/user/:id'
-   */
-  path: string;
-
-  /**
-   * Registered component name (auto-mounted), or a render function.
-   */
-  component: string | ((route: NavigationContext) => string);
-
-  /** Async function called before mounting (for lazy-loading modules). */
-  load?: () => Promise<any>;
-
-  /**
-   * An additional path that also matches this route.
-   * Missing `:param` values will be `undefined`.
-   */
-  fallback?: string;
-}
-
-/** Navigation context passed to guards and `onChange` listeners. */
-interface NavigationContext {
-  /** The matched route definition. */
-  route: RouteDefinition;
-  /** Parsed `:param` values. */
-  params: Record<string, string>;
-  /** Parsed query-string values. */
-  query: Record<string, string>;
-  /** Matched path (base-stripped in history mode). */
-  path: string;
-}
-
-/** Router configuration. */
-interface RouterConfig {
-  /** Outlet element where route components are rendered. */
-  el?: string | Element;
-  /** Routing mode (default: `'history'`; `'hash'` for file:// or hash routing). */
-  mode?: 'history' | 'hash';
-  /**
-   * Base path prefix (e.g. `'/my-app'`).
-   * Auto-detected from `<base href>` or `window.__ZQ_BASE` if not set.
-   */
-  base?: string;
-  /** Route definitions. */
-  routes?: RouteDefinition[];
-  /** Component name to render when no route matches (404). */
-  fallback?: string;
-}
-
-/** The SPA router instance. */
-interface RouterInstance {
-  /** Push a new state and resolve the route. */
-  navigate(path: string, options?: { state?: any }): RouterInstance;
-  /** Replace the current state (no new history entry). */
-  replace(path: string, options?: { state?: any }): RouterInstance;
-  /** `history.back()` */
-  back(): RouterInstance;
-  /** `history.forward()` */
-  forward(): RouterInstance;
-  /** `history.go(n)` */
-  go(n: number): RouterInstance;
-
-  /** Add a route dynamically. Chainable. */
-  add(route: RouteDefinition): RouterInstance;
-  /** Remove a route by path. */
-  remove(path: string): RouterInstance;
-
-  /**
-   * Navigation guard — runs before each route change.
-   * Return `false` to cancel, or a `string` to redirect.
-   */
-  beforeEach(
-    fn: (to: NavigationContext, from: NavigationContext | null) => boolean | string | void | Promise<boolean | string | void>,
-  ): RouterInstance;
-
-  /** Post-navigation hook. */
-  afterEach(
-    fn: (to: NavigationContext, from: NavigationContext | null) => void | Promise<void>,
-  ): RouterInstance;
-
-  /**
-   * Subscribe to route changes.
-   * @returns An unsubscribe function.
-   */
-  onChange(
-    fn: (to: NavigationContext, from: NavigationContext | null) => void,
-  ): () => void;
-
-  /** Teardown the router and mounted component. */
-  destroy(): void;
-
-  /** Resolve a path applying the base prefix. */
-  resolve(path: string): string;
-
-  // -- Properties ----------------------------------------------------------
-  /** Current navigation context. */
-  readonly current: NavigationContext | null;
-  /** Current path (base-stripped in history mode). */
-  readonly path: string;
-  /** Parsed query-string object. */
-  readonly query: Record<string, string>;
-  /** Configured base path. */
-  readonly base: string;
-}
-
-/** Create and activate a client-side SPA router. */
-export function createRouter(config: RouterConfig): RouterInstance;
-
-/** Get the currently active router instance. */
-export function getRouter(): RouterInstance | null;
-
-
-// ---------------------------------------------------------------------------
-// Store
-// ---------------------------------------------------------------------------
-
-/** Store configuration. */
-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;
-}
-
-/** A store action history entry. */
-interface StoreHistoryEntry {
-  action: string;
-  args: any[];
-  timestamp: number;
-}
-
-/** The reactive store instance. */
-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.
-   * @returns An unsubscribe function.
-   */
-  subscribe(key: string, fn: (value: any, oldValue: any, key: string) => void): () => void;
-  /** Subscribe to all state changes (wildcard). */
-  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. */
-  reset(initialState: Partial<S>): void;
-}
-
-/** 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;
-
-
-// ---------------------------------------------------------------------------
-// HTTP Client
-// ---------------------------------------------------------------------------
-
-/** The response object resolved by all HTTP request methods (except `raw`). */
-interface HttpResponse<T = any> {
-  /** `true` if status 200-299. */
-  ok: boolean;
-  /** HTTP status code. */
-  status: number;
-  /** HTTP status text. */
-  statusText: string;
-  /** Response headers as a plain object. */
-  headers: Record<string, string>;
-  /** Auto-parsed body (JSON, text, or Blob depending on content type). */
-  data: T;
-  /** Raw `fetch` Response object. */
-  response: Response;
-}
-
-/** Per-request options passed to HTTP methods. */
-interface HttpRequestOptions extends Omit<RequestInit, 'body' | 'method'> {
-  /** Additional headers (merged with defaults). */
-  headers?: Record<string, string>;
-  /** Override default timeout (ms). */
-  timeout?: number;
-  /** Abort signal for cancellation. */
-  signal?: AbortSignal;
-}
-
-/** Global HTTP configuration options. */
-interface HttpConfigureOptions {
-  /** Prepended to non-absolute URLs. */
-  baseURL?: string;
-  /** Default headers (merged, not replaced). */
-  headers?: Record<string, string>;
-  /** Default timeout in ms (default 30 000). Set `0` to disable. */
-  timeout?: number;
-}
-
-/** Request interceptor function. */
-type HttpRequestInterceptor = (
-  fetchOpts: RequestInit & { headers: Record<string, string> },
-  url: string,
-) => void | false | { url?: string; options?: RequestInit } | Promise<void | false | { url?: string; options?: RequestInit }>;
-
-/** Response interceptor function. */
-type HttpResponseInterceptor = (result: HttpResponse) => void | Promise<void>;
-
-/** The `$.http` namespace. */
-interface HttpClient {
-  /** GET request. `params` appended as query string. */
-  get<T = any>(url: string, params?: Record<string, any> | null, opts?: HttpRequestOptions): Promise<HttpResponse<T>>;
-  /** POST request. `data` sent as JSON body (or FormData). */
-  post<T = any>(url: string, data?: any, opts?: HttpRequestOptions): Promise<HttpResponse<T>>;
-  /** PUT request. */
-  put<T = any>(url: string, data?: any, opts?: HttpRequestOptions): Promise<HttpResponse<T>>;
-  /** PATCH request. */
-  patch<T = any>(url: string, data?: any, opts?: HttpRequestOptions): Promise<HttpResponse<T>>;
-  /** DELETE request. */
-  delete<T = any>(url: string, data?: any, opts?: HttpRequestOptions): Promise<HttpResponse<T>>;
-
-  /** Update default configuration for all subsequent requests. */
-  configure(options: HttpConfigureOptions): void;
-
-  /** Add a request interceptor (called before every request). */
-  onRequest(fn: HttpRequestInterceptor): void;
-
-  /** Add a response interceptor (called after every response, before error check). */
-  onResponse(fn: HttpResponseInterceptor): void;
-
-  /** Create a new `AbortController` for manual request cancellation. */
-  createAbort(): AbortController;
-
-  /** Direct passthrough to native `fetch()` — no JSON handling, no interceptors. */
-  raw(url: string, opts?: RequestInit): Promise<Response>;
-}
-
-export const http: HttpClient;
-
-
-// ---------------------------------------------------------------------------
-// Utilities — Functions
-// ---------------------------------------------------------------------------
-
-/** Debounced function with a `.cancel()` helper. */
-interface DebouncedFunction<T extends (...args: any[]) => any> {
-  (...args: Parameters<T>): void;
-  /** Cancel the pending invocation. */
-  cancel(): void;
-}
-
-/**
- * Returns a debounced function that delays execution until `ms` ms of inactivity.
- * @param ms Default `250`.
- */
-export function debounce<T extends (...args: any[]) => any>(fn: T, ms?: number): DebouncedFunction<T>;
-
-/**
- * Returns a throttled function that executes at most once per `ms` ms.
- * @param ms Default `250`.
- */
-export function throttle<T extends (...args: any[]) => any>(fn: T, ms?: number): (...args: Parameters<T>) => void;
-
-/** Left-to-right function composition. */
-export function pipe<A, B>(f1: (a: A) => B): (input: A) => B;
-export function pipe<A, B, C>(f1: (a: A) => B, f2: (b: B) => C): (input: A) => C;
-export function pipe<A, B, C, D>(f1: (a: A) => B, f2: (b: B) => C, f3: (c: C) => D): (input: A) => D;
-export function pipe<A, B, C, D, E>(f1: (a: A) => B, f2: (b: B) => C, f3: (c: C) => D, f4: (d: D) => E): (input: A) => E;
-export function pipe<T>(...fns: Array<(value: any) => any>): (input: T) => any;
-
-/**
- * Returns a function that only executes once, caching the result.
- */
-export function once<T extends (...args: any[]) => any>(fn: T): (...args: Parameters<T>) => ReturnType<T>;
-
-/** Returns a `Promise` that resolves after `ms` milliseconds. */
-export function sleep(ms: number): Promise<void>;
-
-
-// ---------------------------------------------------------------------------
-// Utilities — Strings
-// ---------------------------------------------------------------------------
-
-/** Escape HTML entities: `&`, `<`, `>`, `"`, `'`. */
-export function escapeHtml(str: string): string;
-
-/**
- * Tagged template literal that auto-escapes interpolated values.
- * Use `$.trust()` to mark values as safe.
- */
-export function html(strings: TemplateStringsArray, ...values: any[]): string;
-
-/** Wrapper that marks an HTML string as trusted (not escaped by `$.html`). */
-interface TrustedHTML {
-  toString(): string;
-}
-
-/** Mark an HTML string as trusted so it won't be escaped in `$.html`. */
-export function trust(htmlStr: string): TrustedHTML;
-
-/** Generate a UUID v4 string. */
-export function uuid(): string;
-
-/** Convert kebab-case to camelCase. */
-export function camelCase(str: string): string;
-
-/** Convert camelCase to kebab-case. */
-export function kebabCase(str: string): string;
-
-
-// ---------------------------------------------------------------------------
-// Utilities — Objects
-// ---------------------------------------------------------------------------
-
-/** Deep clone using `structuredClone` (JSON fallback). */
-export function deepClone<T>(obj: T): T;
-
-/** Recursively merge objects. Arrays are replaced, not merged. */
-export function deepMerge<T extends object>(target: T, ...sources: Partial<T>[]): T;
-
-/** Deep equality comparison. */
-export function isEqual(a: any, b: any): boolean;
-
-
-// ---------------------------------------------------------------------------
-// Utilities — URL
-// ---------------------------------------------------------------------------
-
-/** Serialize an object to a URL query string. */
-export function param(obj: Record<string, any>): string;
-
-/** Parse a URL query string into an object. */
-export function parseQuery(str: string): Record<string, string>;
-
-
-// ---------------------------------------------------------------------------
-// Utilities — Storage
-// ---------------------------------------------------------------------------
-
-/** JSON-aware `localStorage` wrapper. */
-interface StorageWrapper {
-  /** Get and JSON-parse a value. Returns `fallback` on missing / error. */
-  get<T = any>(key: string, fallback?: T): T;
-  /** JSON-stringify and store. */
-  set(key: string, value: any): void;
-  /** Remove a key. */
-  remove(key: string): void;
-  /** Clear all entries. */
-  clear(): void;
-}
-
-/** `localStorage` wrapper. */
-export const storage: StorageWrapper;
-
-/** `sessionStorage` wrapper (same API as `storage`). */
-export const session: StorageWrapper;
-
-
-// ---------------------------------------------------------------------------
-// Utilities — Event Bus
-// ---------------------------------------------------------------------------
-
-/** Singleton pub/sub event bus for cross-component communication. */
-interface EventBus {
-  /** Subscribe. Returns an unsubscribe function. */
-  on(event: string, fn: (...args: any[]) => void): () => void;
-  /** Unsubscribe a specific handler. */
-  off(event: string, fn: (...args: any[]) => void): void;
-  /** Emit an event with arguments. */
-  emit(event: string, ...args: any[]): void;
-  /** Subscribe for a single invocation. Returns an unsubscribe function. */
-  once(event: string, fn: (...args: any[]) => void): () => void;
-  /** Remove all listeners. */
-  clear(): void;
-}
-
-export const bus: EventBus;
-
-
-// ---------------------------------------------------------------------------
-// Error Handling
-// ---------------------------------------------------------------------------
-
-/** All structured error codes used by zQuery. */
-export const ErrorCode: {
-  // Reactive
-  readonly REACTIVE_CALLBACK: 'ZQ_REACTIVE_CALLBACK';
-  readonly SIGNAL_CALLBACK: 'ZQ_SIGNAL_CALLBACK';
-  readonly EFFECT_EXEC: 'ZQ_EFFECT_EXEC';
-
-  // Expression parser
-  readonly EXPR_PARSE: 'ZQ_EXPR_PARSE';
-  readonly EXPR_EVAL: 'ZQ_EXPR_EVAL';
-  readonly EXPR_UNSAFE_ACCESS: 'ZQ_EXPR_UNSAFE_ACCESS';
-
-  // Component
-  readonly COMP_INVALID_NAME: 'ZQ_COMP_INVALID_NAME';
-  readonly COMP_NOT_FOUND: 'ZQ_COMP_NOT_FOUND';
-  readonly COMP_MOUNT_TARGET: 'ZQ_COMP_MOUNT_TARGET';
-  readonly COMP_RENDER: 'ZQ_COMP_RENDER';
-  readonly COMP_LIFECYCLE: 'ZQ_COMP_LIFECYCLE';
-  readonly COMP_RESOURCE: 'ZQ_COMP_RESOURCE';
-  readonly COMP_DIRECTIVE: 'ZQ_COMP_DIRECTIVE';
-
-  // Router
-  readonly ROUTER_LOAD: 'ZQ_ROUTER_LOAD';
-  readonly ROUTER_GUARD: 'ZQ_ROUTER_GUARD';
-  readonly ROUTER_RESOLVE: 'ZQ_ROUTER_RESOLVE';
-
-  // Store
-  readonly STORE_ACTION: 'ZQ_STORE_ACTION';
-  readonly STORE_MIDDLEWARE: 'ZQ_STORE_MIDDLEWARE';
-  readonly STORE_SUBSCRIBE: 'ZQ_STORE_SUBSCRIBE';
-
-  // HTTP
-  readonly HTTP_REQUEST: 'ZQ_HTTP_REQUEST';
-  readonly HTTP_TIMEOUT: 'ZQ_HTTP_TIMEOUT';
-  readonly HTTP_INTERCEPTOR: 'ZQ_HTTP_INTERCEPTOR';
-  readonly HTTP_PARSE: 'ZQ_HTTP_PARSE';
-
-  // General
-  readonly INVALID_ARGUMENT: 'ZQ_INVALID_ARGUMENT';
-};
-
-/** Union of all error code string values. */
-export type ErrorCodeValue = typeof ErrorCode[keyof typeof ErrorCode];
-
-/** Structured error class used throughout zQuery. */
-export class ZQueryError extends Error {
-  readonly name: 'ZQueryError';
-  /** Machine-readable error code (e.g. `'ZQ_COMP_RENDER'`). */
-  readonly code: ErrorCodeValue;
-  /** Extra contextual data (component name, expression string, etc.). */
-  readonly context: Record<string, any>;
-  /** Original error that caused this one, if any. */
-  readonly cause?: Error;
-
-  constructor(
-    code: ErrorCodeValue,
-    message: string,
-    context?: Record<string, any>,
-    cause?: Error,
-  );
-}
-
-/** Error handler callback type. */
-export type ZQueryErrorHandler = (error: ZQueryError) => void;
-
-/**
- * Register a global error handler. Called whenever zQuery catches an
- * error internally. Pass `null` to remove.
- */
-export function onError(handler: ZQueryErrorHandler | null): void;
-
-/**
- * Report an error through the global handler and console.
- * Non-throwing — used for recoverable errors in callbacks, lifecycle hooks, etc.
- */
-export function reportError(
-  code: ErrorCodeValue,
-  message: string,
-  context?: Record<string, any>,
-  cause?: Error,
-): void;
-
-/**
- * Wrap a callback so that thrown errors are caught, reported via `reportError`,
- * and don't crash the current execution context.
- */
-export function guardCallback<T extends (...args: any[]) => any>(
-  fn: T,
-  code: ErrorCodeValue,
-  context?: Record<string, any>,
-): (...args: Parameters<T>) => ReturnType<T> | undefined;
-
-/**
- * Validate a required value is defined and of the expected type.
- * Throws `ZQueryError` with `INVALID_ARGUMENT` on failure.
- */
-export function validate(value: any, name: string, expectedType?: string): void;
-
+// Re-export every public type from the modular type files
+// ---------------------------------------------------------------------------
+
+export { ZQueryCollection } from './types/collection';
+
+export {
+  ReactiveProxy,
+  reactive,
+  Signal,
+  signal,
+  computed,
+  effect,
+} from './types/reactive';
+
+export {
+  PageItem,
+  PagesConfig,
+  ComponentDefinition,
+  ComponentInstance,
+  component,
+  mount,
+  mountAll,
+  getInstance,
+  destroy,
+  getRegistry,
+  prefetch,
+  StyleHandle,
+  StyleOptions,
+  style,
+} from './types/component';
+
+export {
+  RouteDefinition,
+  NavigationContext,
+  RouterConfig,
+  RouterInstance,
+  createRouter,
+  getRouter,
+} from './types/router';
+
+export {
+  StoreConfig,
+  StoreHistoryEntry,
+  StoreInstance,
+  createStore,
+  getStore,
+} from './types/store';
+
+export {
+  HttpResponse,
+  HttpRequestOptions,
+  HttpConfigureOptions,
+  HttpRequestInterceptor,
+  HttpResponseInterceptor,
+  HttpClient,
+  http,
+} from './types/http';
+
+export {
+  DebouncedFunction,
+  debounce,
+  throttle,
+  pipe,
+  once,
+  sleep,
+  escapeHtml,
+  html,
+  TrustedHTML,
+  trust,
+  uuid,
+  camelCase,
+  kebabCase,
+  deepClone,
+  deepMerge,
+  isEqual,
+  param,
+  parseQuery,
+  StorageWrapper,
+  storage,
+  session,
+  EventBus,
+  bus,
+} from './types/utils';
+
+export {
+  ErrorCode,
+  ErrorCodeValue,
+  ZQueryError,
+  ZQueryErrorHandler,
+  onError,
+  reportError,
+  guardCallback,
+  validate,
+} from './types/errors';
+
+export {
+  morph,
+  morphElement,
+  safeEval,
+  EventModifier,
+} from './types/misc';
 
 // ---------------------------------------------------------------------------
 // $ — Main function & namespace
 // ---------------------------------------------------------------------------
 
+import type { ZQueryCollection } from './types/collection';
+import type { reactive, Signal, signal, computed, effect } from './types/reactive';
+import type { component, mount, mountAll, getInstance, destroy, getRegistry, prefetch, style } from './types/component';
+import type { createRouter, getRouter } from './types/router';
+import type { createStore, getStore } from './types/store';
+import type { HttpClient } from './types/http';
+import type {
+  debounce, throttle, pipe, once, sleep,
+  escapeHtml, html, trust, uuid, camelCase, kebabCase,
+  deepClone, deepMerge, isEqual, param, parseQuery,
+  StorageWrapper, EventBus,
+} from './types/utils';
+import type { onError, ZQueryError, ErrorCode } from './types/errors';
+import type { morph, morphElement, safeEval } from './types/misc';
+
 /**
  * Main selector / DOM-ready function — always returns a `ZQueryCollection` (like jQuery).
  *
@@ -1286,7 +141,7 @@ export function validate(value: any, name: string, expectedType?: string): void;
  */
 interface ZQueryStatic {
   (selector: string, context?: string | Element): ZQueryCollection;
-  (element: Element): ZQueryCollection;
+  (element: Element | Window): ZQueryCollection;
   (nodeList: NodeList | HTMLCollection | Element[]): ZQueryCollection;
   (fn: () => void): void;
 
@@ -1300,7 +155,7 @@ interface ZQueryStatic {
    * - `$.all(nodeList)` → wrap NodeList
    */
   all(selector: string, context?: string | Element): ZQueryCollection;
-  all(element: Element): ZQueryCollection;
+  all(element: Element | Window): ZQueryCollection;
   all(nodeList: NodeList | HTMLCollection | Element[]): ZQueryCollection;
 
   // -- Quick-ref shortcuts -------------------------------------------------
@@ -1326,7 +181,7 @@ interface ZQueryStatic {
     tag: string,
     attrs?: Record<string, any>,
     ...children: Array<string | Node>
-  ): HTMLElement;
+  ): ZQueryCollection;
 
   /** Register a DOMContentLoaded callback (fires immediately if already loaded). */
   ready(fn: () => void): void;
@@ -1334,6 +189,9 @@ interface ZQueryStatic {
   /** Global event delegation on `document`. */
   on(event: string, selector: string, handler: (this: Element, e: Event) => void): void;
 
+  /** Direct event listener on a specific target (e.g. `window`). */
+  on(event: string, target: EventTarget, handler: (e: Event) => void): void;
+
   /** Direct event listener on `document` (for keydown, resize, etc.). */
   on(event: string, handler: (e: Event) => void): void;
 
@@ -1358,8 +216,12 @@ interface ZQueryStatic {
   destroy: typeof destroy;
   /** Returns all registered component definitions. */
   components: typeof getRegistry;
+  /** Pre-load external templates and styles for a component. */
+  prefetch: typeof prefetch;
   style: typeof style;
   morph: typeof morph;
+  /** Morph a single element in place — preserves identity when tag name matches. */
+  morphElement: typeof morphElement;
   safeEval: typeof safeEval;
 
   // -- Router --------------------------------------------------------------
@@ -1414,6 +276,8 @@ interface ZQueryStatic {
   // -- Meta ----------------------------------------------------------------
   /** Library version string. */
   version: string;
+  /** Minified library size string (e.g. `"~85.5 KB"`), injected at build time. */
+  libSize: string;
   /** Populated at build time by the CLI bundler. */
   meta: Record<string, any>;
   /** Remove `$` from `window` and return the library object. */
@@ -1428,28 +292,3 @@ export { $ as zQuery };
 export function queryAll(selector: string, context?: string | Element): ZQueryCollection;
 export function queryAll(element: Element): ZQueryCollection;
 export function queryAll(nodeList: NodeList | HTMLCollection | Element[]): ZQueryCollection;
-
-export default $;
-
-
-// ---------------------------------------------------------------------------
-// Global augmentation (browser)
-// ---------------------------------------------------------------------------
-
-declare global {
-  interface Window {
-    /** zQuery main function & namespace. */
-    $: ZQueryStatic;
-    /** Alias for `$`. */
-    zQuery: ZQueryStatic;
-    /** Optional base path override read by the router. */
-    __ZQ_BASE?: string;
-    /** Inline template / style cache populated by the CLI bundler. */
-    __zqInline?: Record<string, string>;
-  }
-
-  /** Global `$` — available when loaded via `<script>` tag. */
-  const $: ZQueryStatic;
-  /** Global alias for `$`. */
-  const zQuery: ZQueryStatic;
-}