zero-query 0.9.1 → 0.9.6

package/README.md

@@ -21,14 +21,14 @@
 
 | Module | Highlights |
 | --- | --- |
-| **Components** | Reactive state, template literals, `@event` delegation (8 modifiers), `z-model` two-way binding, computed properties, watch callbacks, slot-based content projection, directives (`z-if`/`z-else-if`/`z-else`, `z-for`, `z-show`, `z-bind`/`:attr`, `z-class`, `z-style`, `z-text`, `z-html`, `z-ref`, `z-cloak`, `z-pre`, `z-key`, `z-skip`), DOM morphing engine with LIS-based keyed reconciliation (no innerHTML rebuild), CSP-safe expression evaluation with AST caching, scoped styles, external templates (`templateUrl` / `styleUrl`), lifecycle hooks, auto-injected base styles |
+| **Components** | Reactive state, template literals, `@event` delegation (22 modifiers — key filters, system keys, `.outside`, timing, and more), `z-model` two-way binding (with `z-trim`, `z-number`, `z-lazy`, `z-debounce`, `z-uppercase`, `z-lowercase`), computed properties, watch callbacks, slot-based content projection, directives (`z-if`/`z-else-if`/`z-else`, `z-for`, `z-show`, `z-bind`/`:attr`, `z-class`, `z-style`, `z-text`, `z-html`, `z-ref`, `z-cloak`, `z-pre`, `z-key`, `z-skip`), DOM morphing engine with LIS-based keyed reconciliation (no innerHTML rebuild), CSP-safe expression evaluation with AST caching, scoped styles, external templates (`templateUrl` / `styleUrl`), lifecycle hooks, auto-injected base styles |
 | **Router** | History & hash mode, route params (`:id`), wildcards, guards (`beforeEach`/`afterEach`), lazy loading, `z-link` navigation, `z-to-top` scroll modifier (`instant`/`smooth`), sub-route history substates (`pushSubstate`/`onSubstate`) |
 | **Directives** | `z-if`, `z-for`, `z-model`, `z-show`, `z-bind`, `z-class`, `z-style`, `z-text`, `z-html`, `z-ref`, `z-cloak`, `z-pre`, `z-key`, `z-skip` — 17 built-in template directives |
 | **Reactive** | Deep proxy reactivity, Signals (`.value`, `.peek()`), computed values, effects (auto-tracked with dispose) |
-| **Store** | Reactive global state, named actions, computed getters, middleware, subscriptions, time-travel (undo/redo/history) |
+| **Store** | Reactive global state, named actions, computed getters, middleware, subscriptions, action history, snapshots |
 | **Selectors & DOM** | jQuery-like chainable selectors, traversal, DOM manipulation, events, animation |
 | **HTTP** | Fetch wrapper with auto-JSON, interceptors, timeout/abort, base URL |
-| **Utils** | debounce, throttle, pipe, once, sleep, escapeHtml, uuid, deepClone, deepMerge, storage/session wrappers, event bus |
+| **Utils** | debounce, throttle, pipe, once, sleep, memoize, escapeHtml, stripHtml, uuid, capitalize, truncate, range, chunk, groupBy, unique, pick, omit, getPath/setPath, isEmpty, clamp, retry, timeout, deepClone, deepMerge, storage/session wrappers, event bus |
 | **Dev Tools** | CLI dev server with live-reload, CSS hot-swap, full-screen error overlay, floating toolbar, dark-themed inspector panel (Router view, DOM tree, network log, component viewer, performance dashboard), fetch interceptor, render instrumentation, CLI bundler for single-file production builds |
 
 ---
@@ -251,7 +251,7 @@ location / {
 | --- | --- |
 | `$()` | Chainable selector → `ZQueryCollection` (CSS selectors, elements, NodeLists, HTML strings) |
 | `$.all()` | Alias for `$()` — identical behavior |
-| `$.id` `$.class` `$.classes` `$.tag` `$.name` `$.children` | Quick DOM refs |
+| `$.id` `$.class` `$.classes` `$.tag` `$.name` `$.children` `$.qs` `$.qsa` | Quick DOM refs |
 | `$.create` | Element factory |
 | `$.ready` `$.on` `$.off` | DOM ready, global event delegation & direct listeners |
 | `$.fn` | Collection prototype (extend it) |
@@ -263,12 +263,15 @@ location / {
 | `$.store` `$.getStore` | State management |
 | `$.http` `$.get` `$.post` `$.put` `$.patch` `$.delete` | HTTP client |
 | `$.reactive` `$.Signal` `$.signal` `$.computed` `$.effect` | Reactive primitives |
-| `$.debounce` `$.throttle` `$.pipe` `$.once` `$.sleep` | Function utils |
-| `$.escapeHtml` `$.html` `$.trust` `$.uuid` `$.camelCase` `$.kebabCase` | String utils |
-| `$.deepClone` `$.deepMerge` `$.isEqual` | Object utils |
+| `$.debounce` `$.throttle` `$.pipe` `$.once` `$.sleep` `$.memoize` | Function utils |
+| `$.escapeHtml` `$.stripHtml` `$.html` `$.trust` `$.TrustedHTML` `$.uuid` `$.camelCase` `$.kebabCase` `$.capitalize` `$.truncate` | String utils |
+| `$.deepClone` `$.deepMerge` `$.isEqual` `$.pick` `$.omit` `$.getPath` `$.setPath` `$.isEmpty` | Object utils |
+| `$.range` `$.unique` `$.chunk` `$.groupBy` | Array utils |
+| `$.clamp` | Number utils |
+| `$.retry` `$.timeout` | Async utils |
 | `$.param` `$.parseQuery` | URL utils |
 | `$.storage` `$.session` | Storage wrappers |
-| `$.bus` | Event bus || `$.onError` `$.ZQueryError` `$.ErrorCode` `$.guardCallback` `$.validate` | Error handling || `$.version` | Library version |\n| `$.libSize` | Minified bundle size string (e.g. `\"~91 KB\"`) |
+| `$.EventBus` `$.bus` | Event bus || `$.onError` `$.ZQueryError` `$.ErrorCode` `$.guardCallback` `$.validate` | Error handling || `$.version` | Library version |\n| `$.libSize` | Minified bundle size string (e.g. `\"~91 KB\"`) |
 | `$.meta` | Build metadata (populated by CLI bundler) |
 | `$.noConflict` | Release `$` global |
 

package/cli/commands/dev/devtools/js/elements.js

@@ -220,12 +220,17 @@ function buildNode(node, depth) {
       if (level >= maxDepth) return;
       var children = container.children;
       for (var j = 0; j < children.length; j++) {
+        var rowEl = children[j].querySelector(':scope > .tree-row');
         var nested = children[j].querySelector(':scope > .tree-children');
         if (nested) {
           if (opening) nested.classList.add('open');
           else nested.classList.remove('open');
           var arrow = nested.previousElementSibling ? nested.previousElementSibling.querySelector('.tree-toggle') : null;
           if (arrow) { if (opening) arrow.classList.add('open'); else arrow.classList.remove('open'); }
+          // Persist state so it survives tree rebuilds from live DOM mutations
+          if (rowEl && rowEl.__targetNode) {
+            expandedPaths[getNodePath(rowEl.__targetNode)] = opening;
+          }
           toggleNested(nested, level + 1);
         }
       }

package/cli/scaffold/app/app.js

@@ -18,7 +18,7 @@ import { routes } from './routes.js';
 // Router — SPA navigation with history mode
 // ---------------------------------------------------------------------------
 const router = $.router({
-  el: '#app',
+  el: '#app',   //@ Mount point (Set in index.html)
   routes,
   fallback: 'not-found',
   mode: 'history'

package/cli/scaffold/global.css

@@ -1,8 +1,7 @@
 /* global.css — responsive scaffold styles
  *
- * Uses CSS custom properties for easy theming.
+ * Uses CSS custom properties for easy theming. Feel free to modify.
  * Dark theme by default, light theme via [data-theme="light"].
- * Mobile-first: sidebar collapses to a hamburger nav below 768px.
  */
 
 /* -- Theme Variables -- */

package/cli/scaffold/index.html

@@ -53,8 +53,9 @@
   <!-- Overlay for mobile menu -->
   <div class="overlay" id="overlay"></div>
 
-  <!-- Main Content -->
+  <!-- @ Router Outlet  @ -->
   <main class="content" id="app"></main>
+  <!-- @  Mount point is set in app/app.js  @ -->
 
   <!-- Toast container for notifications -->
   <div class="toast-container" id="toasts"></div>