zero-query 1.1.1 → 1.2.0

package/index.js

@@ -1,240 +1,311 @@
-/**
- * ┌---------------------------------------------------------┐
- * │  zQuery (zeroQuery) - Lightweight Frontend Library     │
- * │                                                         │
- * │  jQuery-like selectors · Reactive components            │
- * │  SPA router · State management · Zero dependencies      │
- * │                                                         │
- * │  https://github.com/tonywied17/zero-query              │
- * └---------------------------------------------------------┘
- */
-
-import { query, queryAll, ZQueryCollection } from './src/core.js';
-import { reactive, Signal, signal, computed, effect, batch, untracked } from './src/reactive.js';
-import { component, mount, mountAll, getInstance, destroy, getRegistry, prefetch, style } from './src/component.js';
-import { createRouter, getRouter, matchRoute } from './src/router.js';
-import { createStore, getStore, connectStore } from './src/store.js';
-import { http } from './src/http.js';
-import { morph, morphElement } from './src/diff.js';
-import { safeEval } from './src/expression.js';
-import {
-  debounce, throttle, pipe, once, sleep,
-  escapeHtml, stripHtml, html, trust, TrustedHTML, uuid, camelCase, kebabCase,
-  deepClone, deepMerge, isEqual, param, parseQuery,
-  storage, session, EventBus, bus,
-  range, unique, chunk, groupBy,
-  pick, omit, getPath, setPath, isEmpty,
-  capitalize, truncate, clamp,
-  memoize, retry, timeout,
-} from './src/utils.js';
-import { ZQueryError, ErrorCode, onError, reportError, guardCallback, guardAsync, validate, formatError } from './src/errors.js';
-
-
-// ---------------------------------------------------------------------------
-// $ - The main function & namespace
-// ---------------------------------------------------------------------------
-
-/**
- * Main selector function - always returns a ZQueryCollection (like jQuery).
- * 
- *   $('selector')         → ZQueryCollection (querySelectorAll)
- *   $('<div>hello</div>') → ZQueryCollection from created elements
- *   $(element)            → ZQueryCollection wrapping the element
- *   $(fn)                 → DOMContentLoaded shorthand
- * 
- * @param {string|Element|NodeList|Function} selector
- * @param {string|Element} [context]
- * @returns {ZQueryCollection}
- */
-function $(selector, context) {
-  // $(fn) → DOM ready shorthand
-  if (typeof selector === 'function') {
-    query.ready(selector);
-    return;
-  }
-  return query(selector, context);
-}
-
-
-// --- Quick refs (DOM selectors) --------------------------------------------
-$.id       = query.id;
-$.class    = query.class;
-$.classes  = query.classes;
-$.tag      = query.tag;
-Object.defineProperty($, 'name', {
-  value: query.name, writable: true, configurable: true
-});
-$.children = query.children;
-$.qs       = query.qs;
-$.qsa      = query.qsa;
-
-// --- Collection selector ---------------------------------------------------
-/**
- * Collection selector (like jQuery's $)
- * 
- *   $.all('selector')         → ZQueryCollection (querySelectorAll)
- *   $.all('<div>hello</div>') → create elements as collection
- *   $.all(element)            → wrap element in collection
- *   $.all(nodeList)           → wrap NodeList in collection
- * 
- * @param {string|Element|NodeList|Array} selector
- * @param {string|Element} [context]
- * @returns {ZQueryCollection}
- */
-$.all = function(selector, context) {
-  return queryAll(selector, context);
-};
-
-// --- DOM helpers -----------------------------------------------------------
-$.create   = query.create;
-$.ready    = query.ready;
-$.on       = query.on;
-$.off      = query.off;
-$.fn       = query.fn;
-
-// --- Reactive primitives ---------------------------------------------------
-$.reactive = reactive;
-$.Signal   = Signal;
-$.signal   = signal;
-$.computed = computed;
-$.effect   = effect;
-$.batch    = batch;
-$.untracked = untracked;
-
-// --- Components ------------------------------------------------------------
-$.component   = component;
-$.mount       = mount;
-$.mountAll    = mountAll;
-$.getInstance = getInstance;
-$.destroy     = destroy;
-$.components  = getRegistry;
-$.prefetch    = prefetch;
-$.style       = style;
-$.morph        = morph;
-$.morphElement = morphElement;
-$.safeEval    = safeEval;
-
-// --- Router ----------------------------------------------------------------
-$.router     = createRouter;
-$.getRouter  = getRouter;
-$.matchRoute = matchRoute;
-
-// --- Store -----------------------------------------------------------------
-$.store    = createStore;
-$.getStore = getStore;
-$.connectStore = connectStore;
-
-// --- HTTP ------------------------------------------------------------------
-$.http   = http;
-$.get    = http.get;
-$.post   = http.post;
-$.put    = http.put;
-$.patch  = http.patch;
-$.delete = http.delete;
-$.head   = http.head;
-
-// --- Utilities -------------------------------------------------------------
-$.debounce   = debounce;
-$.throttle   = throttle;
-$.pipe       = pipe;
-$.once       = once;
-$.sleep      = sleep;
-$.escapeHtml = escapeHtml;
-$.stripHtml  = stripHtml;
-$.html       = html;
-$.trust      = trust;
-$.TrustedHTML = TrustedHTML;
-$.uuid       = uuid;
-$.camelCase  = camelCase;
-$.kebabCase  = kebabCase;
-$.deepClone  = deepClone;
-$.deepMerge  = deepMerge;
-$.isEqual    = isEqual;
-$.param      = param;
-$.parseQuery = parseQuery;
-$.storage    = storage;
-$.session    = session;
-$.EventBus   = EventBus;
-$.bus        = bus;
-$.range      = range;
-$.unique     = unique;
-$.chunk      = chunk;
-$.groupBy    = groupBy;
-$.pick       = pick;
-$.omit       = omit;
-$.getPath    = getPath;
-$.setPath    = setPath;
-$.isEmpty    = isEmpty;
-$.capitalize = capitalize;
-$.truncate   = truncate;
-$.clamp      = clamp;
-$.memoize    = memoize;
-$.retry      = retry;
-$.timeout    = timeout;
-
-// --- Error handling --------------------------------------------------------
-$.onError        = onError;
-$.ZQueryError    = ZQueryError;
-$.ErrorCode      = ErrorCode;
-$.guardCallback  = guardCallback;
-$.guardAsync     = guardAsync;
-$.validate       = validate;
-$.formatError    = formatError;
-
-// --- Meta ------------------------------------------------------------------
-$.version   = '__VERSION__';
-$.libSize   = '__LIB_SIZE__';
-$.unitTests = '__UNIT_TESTS__';
-$.meta      = {};              // populated at build time by CLI bundler
-
-// --- Environment detection -------------------------------------------------
-$.isElectron = typeof navigator !== 'undefined' && /Electron/i.test(navigator.userAgent)
-  || typeof process !== 'undefined' && process.versions != null && !!process.versions.electron;
-$.platform = $.isElectron ? 'electron'
-  : typeof window !== 'undefined' ? 'browser'
-  : 'node';
-
-$.noConflict = () => {
-  if (typeof window !== 'undefined' && window.$ === $) {
-    delete window.$;
-  }
-  return $;
-};
-
-
-// ---------------------------------------------------------------------------
-// Global exposure (browser)
-// ---------------------------------------------------------------------------
-if (typeof window !== 'undefined') {
-  window.$ = $;
-  window.zQuery = $;
-}
-
-
-// ---------------------------------------------------------------------------
-// Named exports (ES modules)
-// ---------------------------------------------------------------------------
-export {
-  $,
-  $ as zQuery,
-  ZQueryCollection,
-  queryAll,
-  reactive, Signal, signal, computed, effect, batch, untracked,
-  component, mount, mountAll, getInstance, destroy, getRegistry, prefetch, style,
-  morph, morphElement,
-  safeEval,
-  createRouter, getRouter, matchRoute,
-  createStore, getStore, connectStore,
-  http,
-  ZQueryError, ErrorCode, onError, reportError, guardCallback, guardAsync, validate, formatError,
-  debounce, throttle, pipe, once, sleep,
-  escapeHtml, stripHtml, html, trust, TrustedHTML, uuid, camelCase, kebabCase,
-  deepClone, deepMerge, isEqual, param, parseQuery,
-  storage, session, EventBus, bus,
-  range, unique, chunk, groupBy,
-  pick, omit, getPath, setPath, isEmpty,
-  capitalize, truncate, clamp,
-  memoize, retry, timeout,
-};
-
-export default $;
+/**
+ * ┌---------------------------------------------------------┐
+ * │  zQuery (zeroQuery) - Lightweight Frontend Library     │
+ * │                                                         │
+ * │  jQuery-like selectors · Reactive components            │
+ * │  SPA router · State management · Zero dependencies      │
+ * │                                                         │
+ * │  https://github.com/tonywied17/zero-query              │
+ * └---------------------------------------------------------┘
+ */
+
+import { query, queryAll, ZQueryCollection } from './src/core.js';
+import { reactive, Signal, signal, computed, effect, batch, untracked } from './src/reactive.js';
+import { component, mount, mountAll, getInstance, destroy, getRegistry, prefetch, style } from './src/component.js';
+import { createRouter, getRouter, matchRoute } from './src/router.js';
+import { createStore, getStore, connectStore } from './src/store.js';
+import { http } from './src/http.js';
+import { morph, morphElement } from './src/diff.js';
+import { safeEval } from './src/expression.js';
+import {
+  debounce, throttle, pipe, once, sleep,
+  escapeHtml, stripHtml, html, trust, TrustedHTML, uuid, camelCase, kebabCase,
+  deepClone, deepMerge, isEqual, param, parseQuery,
+  storage, session, EventBus, bus,
+  range, unique, chunk, groupBy,
+  pick, omit, getPath, setPath, isEmpty,
+  capitalize, truncate, clamp,
+  memoize, retry, timeout,
+} from './src/utils.js';
+import { ZQueryError, ErrorCode, onError, reportError, guardCallback, guardAsync, validate, formatError } from './src/errors.js';
+import {
+  webrtc,
+  SignalingClient,
+  Peer,
+  Room, join as webrtcJoin,
+  useRoom, usePeer, useTracks, useDataChannel, useConnectionQuality,
+  fetchTurnCredentials, mergeIceServers, createTurnRefresher,
+  deriveSFrameKey, generateSFrameKey, SFrameContext,
+  encryptFrame, decryptFrame, attachE2ee,
+  loadSfuAdapter,
+  decodeJoinToken, isJoinTokenExpired,
+  samplePeerStats, createStatsSampler, classifyStats,
+  parseSdp, validateSdp,
+  parseCandidate, stringifyCandidate, filterCandidates,
+  isPrivateIp, isLoopbackIp, isLinkLocalIp, isMdnsHostname,
+  WebRtcError, SignalingError, IceError, SdpError, TurnError, E2eeError, SfuError,
+} from './src/webrtc/index.js';
+
+
+// ---------------------------------------------------------------------------
+// $ - The main function & namespace
+// ---------------------------------------------------------------------------
+
+/**
+ * Main selector function - always returns a ZQueryCollection (like jQuery).
+ * 
+ *   $('selector')         → ZQueryCollection (querySelectorAll)
+ *   $('<div>hello</div>') → ZQueryCollection from created elements
+ *   $(element)            → ZQueryCollection wrapping the element
+ *   $(fn)                 → DOMContentLoaded shorthand
+ * 
+ * @param {string|Element|NodeList|Function} selector
+ * @param {string|Element} [context]
+ * @returns {ZQueryCollection}
+ */
+function $(selector, context) {
+  // $(fn) → DOM ready shorthand
+  if (typeof selector === 'function') {
+    query.ready(selector);
+    return;
+  }
+  return query(selector, context);
+}
+
+
+// --- Quick refs (DOM selectors) --------------------------------------------
+$.id       = query.id;
+$.class    = query.class;
+$.classes  = query.classes;
+$.tag      = query.tag;
+Object.defineProperty($, 'name', {
+  value: query.name, writable: true, configurable: true
+});
+$.children = query.children;
+$.qs       = query.qs;
+$.qsa      = query.qsa;
+
+// --- Collection selector ---------------------------------------------------
+/**
+ * Collection selector (like jQuery's $)
+ * 
+ *   $.all('selector')         → ZQueryCollection (querySelectorAll)
+ *   $.all('<div>hello</div>') → create elements as collection
+ *   $.all(element)            → wrap element in collection
+ *   $.all(nodeList)           → wrap NodeList in collection
+ * 
+ * @param {string|Element|NodeList|Array} selector
+ * @param {string|Element} [context]
+ * @returns {ZQueryCollection}
+ */
+$.all = function(selector, context) {
+  return queryAll(selector, context);
+};
+
+// --- DOM helpers -----------------------------------------------------------
+$.create   = query.create;
+$.ready    = query.ready;
+$.on       = query.on;
+$.off      = query.off;
+$.fn       = query.fn;
+
+// --- Reactive primitives ---------------------------------------------------
+$.reactive = reactive;
+$.Signal   = Signal;
+$.signal   = signal;
+$.computed = computed;
+$.effect   = effect;
+$.batch    = batch;
+$.untracked = untracked;
+
+// --- Components ------------------------------------------------------------
+$.component   = component;
+$.mount       = mount;
+$.mountAll    = mountAll;
+$.getInstance = getInstance;
+$.destroy     = destroy;
+$.components  = getRegistry;
+$.prefetch    = prefetch;
+$.style       = style;
+$.morph        = morph;
+$.morphElement = morphElement;
+$.safeEval    = safeEval;
+
+// --- Router ----------------------------------------------------------------
+$.router     = createRouter;
+$.getRouter  = getRouter;
+$.matchRoute = matchRoute;
+
+// --- Store -----------------------------------------------------------------
+$.store    = createStore;
+$.getStore = getStore;
+$.connectStore = connectStore;
+
+// --- HTTP ------------------------------------------------------------------
+$.http   = http;
+$.get    = http.get;
+$.post   = http.post;
+$.put    = http.put;
+$.patch  = http.patch;
+$.delete = http.delete;
+$.head   = http.head;
+
+// --- Utilities -------------------------------------------------------------
+$.debounce   = debounce;
+$.throttle   = throttle;
+$.pipe       = pipe;
+$.once       = once;
+$.sleep      = sleep;
+$.escapeHtml = escapeHtml;
+$.stripHtml  = stripHtml;
+$.html       = html;
+$.trust      = trust;
+$.TrustedHTML = TrustedHTML;
+$.uuid       = uuid;
+$.camelCase  = camelCase;
+$.kebabCase  = kebabCase;
+$.deepClone  = deepClone;
+$.deepMerge  = deepMerge;
+$.isEqual    = isEqual;
+$.param      = param;
+$.parseQuery = parseQuery;
+$.storage    = storage;
+$.session    = session;
+$.EventBus   = EventBus;
+$.bus        = bus;
+$.range      = range;
+$.unique     = unique;
+$.chunk      = chunk;
+$.groupBy    = groupBy;
+$.pick       = pick;
+$.omit       = omit;
+$.getPath    = getPath;
+$.setPath    = setPath;
+$.isEmpty    = isEmpty;
+$.capitalize = capitalize;
+$.truncate   = truncate;
+$.clamp      = clamp;
+$.memoize    = memoize;
+$.retry      = retry;
+$.timeout    = timeout;
+
+// --- Error handling --------------------------------------------------------
+$.onError        = onError;
+$.ZQueryError    = ZQueryError;
+$.ErrorCode      = ErrorCode;
+$.guardCallback  = guardCallback;
+$.guardAsync     = guardAsync;
+$.validate       = validate;
+$.formatError    = formatError;
+
+// --- WebRTC ----------------------------------------------------------------
+$.webrtc             = webrtc;
+$.SignalingClient    = SignalingClient;
+$.Peer               = Peer;
+$.Room               = Room;
+$.useRoom            = useRoom;
+$.usePeer            = usePeer;
+$.useTracks          = useTracks;
+$.useDataChannel     = useDataChannel;
+$.useConnectionQuality = useConnectionQuality;
+$.fetchTurnCredentials = fetchTurnCredentials;
+$.mergeIceServers    = mergeIceServers;
+$.createTurnRefresher = createTurnRefresher;
+$.deriveSFrameKey    = deriveSFrameKey;
+$.generateSFrameKey  = generateSFrameKey;
+$.SFrameContext      = SFrameContext;
+$.encryptFrame       = encryptFrame;
+$.decryptFrame       = decryptFrame;
+$.attachE2ee         = attachE2ee;
+$.loadSfuAdapter     = loadSfuAdapter;
+$.SfuError           = SfuError;
+$.decodeJoinToken    = decodeJoinToken;
+$.isJoinTokenExpired = isJoinTokenExpired;
+$.samplePeerStats    = samplePeerStats;
+$.createStatsSampler = createStatsSampler;
+$.classifyStats      = classifyStats;
+$.parseSdp           = parseSdp;
+$.validateSdp        = validateSdp;
+$.parseCandidate     = parseCandidate;
+$.stringifyCandidate = stringifyCandidate;
+$.filterCandidates   = filterCandidates;
+$.isPrivateIp        = isPrivateIp;
+$.isLoopbackIp       = isLoopbackIp;
+$.isLinkLocalIp      = isLinkLocalIp;
+$.isMdnsHostname     = isMdnsHostname;
+$.WebRtcError        = WebRtcError;
+$.SignalingError     = SignalingError;
+$.IceError           = IceError;
+$.SdpError           = SdpError;
+$.TurnError          = TurnError;
+$.E2eeError          = E2eeError;
+
+// --- Meta ------------------------------------------------------------------
+$.version   = '__VERSION__';
+$.libSize   = '__LIB_SIZE__';
+$.unitTests = '__UNIT_TESTS__';
+$.meta      = {};              // populated at build time by CLI bundler
+
+// --- Environment detection -------------------------------------------------
+$.isElectron = typeof navigator !== 'undefined' && /Electron/i.test(navigator.userAgent)
+  || typeof process !== 'undefined' && process.versions != null && !!process.versions.electron;
+$.platform = $.isElectron ? 'electron'
+  : typeof window !== 'undefined' ? 'browser'
+  : 'node';
+
+$.noConflict = () => {
+  if (typeof window !== 'undefined' && window.$ === $) {
+    delete window.$;
+  }
+  return $;
+};
+
+
+// ---------------------------------------------------------------------------
+// Global exposure (browser)
+// ---------------------------------------------------------------------------
+if (typeof window !== 'undefined') {
+  window.$ = $;
+  window.zQuery = $;
+}
+
+
+// ---------------------------------------------------------------------------
+// Named exports (ES modules)
+// ---------------------------------------------------------------------------
+export {
+  $,
+  $ as zQuery,
+  ZQueryCollection,
+  queryAll,
+  reactive, Signal, signal, computed, effect, batch, untracked,
+  component, mount, mountAll, getInstance, destroy, getRegistry, prefetch, style,
+  morph, morphElement,
+  safeEval,
+  createRouter, getRouter, matchRoute,
+  createStore, getStore, connectStore,
+  http,
+  ZQueryError, ErrorCode, onError, reportError, guardCallback, guardAsync, validate, formatError,
+  webrtc, SignalingClient, Peer, Room, webrtcJoin,
+  useRoom, usePeer, useTracks, useDataChannel, useConnectionQuality,
+  fetchTurnCredentials, mergeIceServers, createTurnRefresher,
+  deriveSFrameKey, generateSFrameKey, SFrameContext,
+  encryptFrame, decryptFrame, attachE2ee,
+  loadSfuAdapter, SfuError,
+  decodeJoinToken, isJoinTokenExpired,
+  samplePeerStats, createStatsSampler, classifyStats,
+  parseSdp, validateSdp,
+  parseCandidate, stringifyCandidate, filterCandidates,
+  isPrivateIp, isLoopbackIp, isLinkLocalIp, isMdnsHostname,
+  WebRtcError, SignalingError, IceError, SdpError, TurnError, E2eeError,
+  debounce, throttle, pipe, once, sleep,
+  escapeHtml, stripHtml, html, trust, TrustedHTML, uuid, camelCase, kebabCase,
+  deepClone, deepMerge, isEqual, param, parseQuery,
+  storage, session, EventBus, bus,
+  range, unique, chunk, groupBy,
+  pick, omit, getPath, setPath, isEmpty,
+  capitalize, truncate, clamp,
+  memoize, retry, timeout,
+};
+
+export default $;