zero-query 1.0.9 → 1.2.0

package/cli/index.js

@@ -1,53 +1,53 @@
 #!/usr/bin/env node
-
-/**
- * zQuery CLI - entry point
- *
- * Dispatches to the appropriate command module under cli/commands/.
- * Run `zquery --help` for full usage information.
- */
-
-const { join }  = require('path');
-const { watch } = require('fs');
-
-const { args, flag } = require('./args');
-const buildLibrary   = require('./commands/build');
-const bundleApp      = require('./commands/bundle');
-const devServer      = require('./commands/dev');
-const createProject  = require('./commands/create');
-const showHelp       = require('./help');
-
-const command = args[0];
-
-if (!command || command === '--help' || command === '-h' || command === 'help') {
-  showHelp();
-} else if (command === 'create') {
-  createProject(args);
-} else if (command === 'build') {
-  console.log('\n  zQuery Library Build\n');
-  buildLibrary();
-
-  if (flag('watch', 'w')) {
-    console.log('  Watching src/ for changes...\n');
-    const srcDir = join(process.cwd(), 'src');
-    let debounce;
-
-    function rebuild() {
-      clearTimeout(debounce);
-      debounce = setTimeout(() => {
-        console.log('  Rebuilding...\n');
-        try { buildLibrary(); } catch (e) { console.error(e.message); }
-      }, 200);
-    }
-
-    watch(srcDir, { recursive: true }, rebuild);
-    watch(join(process.cwd(), 'index.js'), rebuild);
-  }
-} else if (command === 'bundle') {
-  bundleApp();
-} else if (command === 'dev') {
-  devServer();
-} else {
-  console.error(`\n  Unknown command: ${command}\n  Run "zquery --help" for usage.\n`);
-  process.exit(1);
-}
+
+/**
+ * zQuery CLI - entry point
+ *
+ * Dispatches to the appropriate command module under cli/commands/.
+ * Run `zquery --help` for full usage information.
+ */
+
+const { join }  = require('path');
+const { watch } = require('fs');
+
+const { args, flag } = require('./args');
+const buildLibrary   = require('./commands/build');
+const bundleApp      = require('./commands/bundle');
+const devServer      = require('./commands/dev');
+const createProject  = require('./commands/create');
+const showHelp       = require('./help');
+
+const command = args[0];
+
+if (!command || command === '--help' || command === '-h' || command === 'help') {
+  showHelp();
+} else if (command === 'create') {
+  createProject(args);
+} else if (command === 'build') {
+  console.log('\n  zQuery Library Build\n');
+  buildLibrary();
+
+  if (flag('watch', 'w')) {
+    console.log('  Watching src/ for changes...\n');
+    const srcDir = join(process.cwd(), 'src');
+    let debounce;
+
+    function rebuild() {
+      clearTimeout(debounce);
+      debounce = setTimeout(() => {
+        console.log('  Rebuilding...\n');
+        try { buildLibrary(); } catch (e) { console.error(e.message); }
+      }, 200);
+    }
+
+    watch(srcDir, { recursive: true }, rebuild);
+    watch(join(process.cwd(), 'index.js'), rebuild);
+  }
+} else if (command === 'bundle') {
+  bundleApp();
+} else if (command === 'dev') {
+  devServer();
+} else {
+  console.error(`\n  Unknown command: ${command}\n  Run "zquery --help" for usage.\n`);
+  process.exit(1);
+}

package/cli/scaffold/default/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Tony Wiedman "molex"
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Tony Wiedman "molex"
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/cli/scaffold/default/app/app.js

@@ -1,207 +1,207 @@
-// app.js - Application entry point
-//
-// Bootstraps the app: imports components, sets up routing,
-// wires the responsive sidebar, and connects the store.
-//
-// Key APIs used:
-//   $.router     - SPA navigation (history mode)
-//   $.ready      - run after DOM is loaded
-//   $.bus        - event bus (toast notifications, contact card)
-//   $.on         - global delegated event listeners
-//   $.storage    - localStorage wrapper
-//   $.create     - create DOM elements
-
-import './store.js';
-import './components/home.js';
-import './components/counter.js';
-import './components/todos.js';
-import './components/api-demo.js';
-import './components/playground/playground.js';
-import './components/toolkit/toolkit.js';
-import './components/about.js';
-import './components/contact-card.js';
-import './components/contacts/contacts.js';
-import './components/not-found.js';
-import { routes } from './routes.js';
-
-// ---------------------------------------------------------------------------
-// Router - SPA navigation with history mode
-// ---------------------------------------------------------------------------
-const router = $.router({
-  routes,
-  fallback: 'not-found',
-  mode: 'history'
-});
-
-// Post-navigation hook - track page views on every navigation
-router.afterEach((to) => {
-  const store = $.getStore('main');
-  if (store) store.dispatch('incrementVisits');
-  console.log('📊 Navigated to:', to.path);
-});
-
-// Highlight the active nav link on every route change
-router.onChange((to) => {
-  // Close mobile menu on navigate
-  closeMobileMenu();
-});
-
-// ---------------------------------------------------------------------------
-// Responsive sidebar toggle
-// ---------------------------------------------------------------------------
-const $sidebar = $('#sidebar');
-const $overlay = $('#overlay');
-const $toggle  = $('#menu-toggle');
-
-function toggleMobileMenu(open) {
-  $sidebar.toggleClass('open', open);
-  $overlay.toggleClass('visible', open);
-  $toggle.toggleClass('active', open);
-}
-
-function closeMobileMenu() { toggleMobileMenu(false); }
-
-// $.on - global delegated event listeners
-$.on('click', '#menu-toggle', () => toggleMobileMenu(!$sidebar.hasClass('open')));
-$.on('click', '#overlay', closeMobileMenu);
-
-// Close sidebar on Escape key - using $.on direct (no selector needed)
-$.on('keydown', (e) => {
-  if (e.key === 'Escape') closeMobileMenu();
-});
-
-// ---------------------------------------------------------------------------
-// Sidebar stats panel - collapsible, live-updating from $.store
-// Starts expanded by default. Open/closed state saved via $.storage.
-// ---------------------------------------------------------------------------
-$.on('click', '#stats-toggle', () => {
-  const $body  = $('#stats-body');
-  const $arrow = $('#stats-arrow');
-  if (!$body.length) return;
-  const open = $body.css('display') !== 'none';
-  open ? $body.hide() : $body.show();
-  $arrow.toggleClass('open', !open);
-  $.storage.set('statsOpen', !open);
-});
-
-function updateSidebarStats() {
-  const store = $.getStore('main');
-  if (!store) return;
-  $('#ss-visits').text(store.state.visits);
-  $('#ss-todos').text(store.getters.todoCount);
-  $('#ss-pending').text(store.getters.pendingCount);
-  $('#ss-done').text(store.getters.doneCount);
-  $('#ss-contacts').text(store.getters.contactCount);
-  $('#ss-favorites').text(store.getters.favoriteCount);
-}
-
-// ---------------------------------------------------------------------------
-// Sidebar contacts - live status indicators from $.store
-// ---------------------------------------------------------------------------
-function updateSidebarContacts() {
-  const store = $.getStore('main');
-  if (!store) return;
-  const $list = $('#sc-list');
-  if (!$list.length) return;
-
-  const sorted = [...store.state.contacts].sort((a, b) => {
-    const order = { online: 0, away: 1, offline: 2 };
-    return (order[a.status] ?? 3) - (order[b.status] ?? 3);
-  });
-
-  const html = sorted.map(c => {
-    const hue = (c.name.charCodeAt(0) * 7) % 360;
-    const initial = $.escapeHtml(c.name.charAt(0).toUpperCase());
-    const name = $.escapeHtml(c.name);
-    return `<div class="sc-item" data-contact-id="${c.id}">
-      <span class="sc-avatar" style="background:hsl(${hue},55%,42%)">${initial}</span>
-      <span class="sc-dot sc-dot-${c.status}"></span>
-      <span class="sc-name">${name}</span>
-    </div>`;
-  }).join('');
-
-  $list.html(html);
-}
-
-// ---------------------------------------------------------------------------
-// Toast notification system via $.bus (event bus)
-// ---------------------------------------------------------------------------
-// Any component can emit: $.bus.emit('toast', { message, type })
-// Types: 'success', 'error', 'info'
-$.bus.on('toast', ({ message, type = 'info' }) => {
-  const toast = $.create('div')
-    .addClass('toast', `toast-${type}`)
-    .text(message)
-    .appendTo('#toasts');
-  // Auto-remove after 3 seconds
-  setTimeout(() => {
-    toast.addClass('toast-exit');
-    setTimeout(() => toast.remove(), 300);
-  }, 3000);
-});
-
-// ---------------------------------------------------------------------------
-// On DOM ready - final setup
-// ---------------------------------------------------------------------------
-$.ready(() => {
-  // Display version in the sidebar footer
-  $('#nav-version').text('v' + $.version);
-
-  // Theme: restore saved preference or auto-detect from system
-  const saved = $.storage.get('theme'); // 'dark' | 'light' | 'system' | null
-  const preference = saved || 'system';
-  applyTheme(preference);
-
-  // Listen for OS color-scheme changes (only applies when preference is 'system')
-  window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', () => {
-    const current = $.storage.get('theme') || 'system';
-    if (current === 'system') applyTheme('system');
-  });
-
-  // Highlight the active link on initial load is handled by z-active-route
-
-  console.log('⚡ {{NAME}} - powered by zQuery v' + $.version);
-
-  // Stats panel: restore open/closed from $.storage (defaults to open)
-  const statsOpen = $.storage.get('statsOpen');
-  if (statsOpen === false) {
-    $('#stats-body').hide();
-    $('#stats-arrow').removeClass('open');
-  }
-
-  // Sidebar contact click - open the global contact card overlay
-  $('#sc-list').on('click', '.sc-item', (e) => {
-    const item = e.target.closest('.sc-item');
-    if (!item) return;
-    const id = Number(item.dataset.contactId);
-    if (id) $.bus.emit('openContact', id);
-  });
-
-  // Initial sidebar stats + contacts + live subscription
-  updateSidebarStats();
-  updateSidebarContacts();
-  const store = $.getStore('main');
-  if (store) {
-    store.subscribe(updateSidebarStats);
-    store.subscribe(updateSidebarContacts);
-  }
-
-  // Mount any components outside the router outlet (e.g. <contact-card>)
-  $.mountAll();
-
-  console.log('⚡ {{NAME}} - powered by zQuery v' + $.version);
-});
-
-// ---------------------------------------------------------------------------
-// Theme helper - resolves 'system' to actual dark/light and applies it
-// ---------------------------------------------------------------------------
-function applyTheme(preference) {
-  let resolved = preference;
-  if (preference === 'system') {
-    resolved = window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
-  }
-  $('html').attr('data-theme', resolved);
-}
-
-// Expose globally so components can call it
-window.__applyTheme = applyTheme;
+// app.js - Application entry point
+//
+// Bootstraps the app: imports components, sets up routing,
+// wires the responsive sidebar, and connects the store.
+//
+// Key APIs used:
+//   $.router     - SPA navigation (history mode)
+//   $.ready      - run after DOM is loaded
+//   $.bus        - event bus (toast notifications, contact card)
+//   $.on         - global delegated event listeners
+//   $.storage    - localStorage wrapper
+//   $.create     - create DOM elements
+
+import './store.js';
+import './components/home.js';
+import './components/counter.js';
+import './components/todos.js';
+import './components/api-demo.js';
+import './components/playground/playground.js';
+import './components/toolkit/toolkit.js';
+import './components/about.js';
+import './components/contact-card.js';
+import './components/contacts/contacts.js';
+import './components/not-found.js';
+import { routes } from './routes.js';
+
+// ---------------------------------------------------------------------------
+// Router - SPA navigation with history mode
+// ---------------------------------------------------------------------------
+const router = $.router({
+  routes,
+  fallback: 'not-found',
+  mode: 'history'
+});
+
+// Post-navigation hook - track page views on every navigation
+router.afterEach((to) => {
+  const store = $.getStore('main');
+  if (store) store.dispatch('incrementVisits');
+  console.log('📊 Navigated to:', to.path);
+});
+
+// Highlight the active nav link on every route change
+router.onChange((to) => {
+  // Close mobile menu on navigate
+  closeMobileMenu();
+});
+
+// ---------------------------------------------------------------------------
+// Responsive sidebar toggle
+// ---------------------------------------------------------------------------
+const $sidebar = $('#sidebar');
+const $overlay = $('#overlay');
+const $toggle  = $('#menu-toggle');
+
+function toggleMobileMenu(open) {
+  $sidebar.toggleClass('open', open);
+  $overlay.toggleClass('visible', open);
+  $toggle.toggleClass('active', open);
+}
+
+function closeMobileMenu() { toggleMobileMenu(false); }
+
+// $.on - global delegated event listeners
+$.on('click', '#menu-toggle', () => toggleMobileMenu(!$sidebar.hasClass('open')));
+$.on('click', '#overlay', closeMobileMenu);
+
+// Close sidebar on Escape key - using $.on direct (no selector needed)
+$.on('keydown', (e) => {
+  if (e.key === 'Escape') closeMobileMenu();
+});
+
+// ---------------------------------------------------------------------------
+// Sidebar stats panel - collapsible, live-updating from $.store
+// Starts expanded by default. Open/closed state saved via $.storage.
+// ---------------------------------------------------------------------------
+$.on('click', '#stats-toggle', () => {
+  const $body  = $('#stats-body');
+  const $arrow = $('#stats-arrow');
+  if (!$body.length) return;
+  const open = $body.css('display') !== 'none';
+  open ? $body.hide() : $body.show();
+  $arrow.toggleClass('open', !open);
+  $.storage.set('statsOpen', !open);
+});
+
+function updateSidebarStats() {
+  const store = $.getStore('main');
+  if (!store) return;
+  $('#ss-visits').text(store.state.visits);
+  $('#ss-todos').text(store.getters.todoCount);
+  $('#ss-pending').text(store.getters.pendingCount);
+  $('#ss-done').text(store.getters.doneCount);
+  $('#ss-contacts').text(store.getters.contactCount);
+  $('#ss-favorites').text(store.getters.favoriteCount);
+}
+
+// ---------------------------------------------------------------------------
+// Sidebar contacts - live status indicators from $.store
+// ---------------------------------------------------------------------------
+function updateSidebarContacts() {
+  const store = $.getStore('main');
+  if (!store) return;
+  const $list = $('#sc-list');
+  if (!$list.length) return;
+
+  const sorted = [...store.state.contacts].sort((a, b) => {
+    const order = { online: 0, away: 1, offline: 2 };
+    return (order[a.status] ?? 3) - (order[b.status] ?? 3);
+  });
+
+  const html = sorted.map(c => {
+    const hue = (c.name.charCodeAt(0) * 7) % 360;
+    const initial = $.escapeHtml(c.name.charAt(0).toUpperCase());
+    const name = $.escapeHtml(c.name);
+    return `<div class="sc-item" data-contact-id="${c.id}">
+      <span class="sc-avatar" style="background:hsl(${hue},55%,42%)">${initial}</span>
+      <span class="sc-dot sc-dot-${c.status}"></span>
+      <span class="sc-name">${name}</span>
+    </div>`;
+  }).join('');
+
+  $list.html(html);
+}
+
+// ---------------------------------------------------------------------------
+// Toast notification system via $.bus (event bus)
+// ---------------------------------------------------------------------------
+// Any component can emit: $.bus.emit('toast', { message, type })
+// Types: 'success', 'error', 'info'
+$.bus.on('toast', ({ message, type = 'info' }) => {
+  const toast = $.create('div')
+    .addClass('toast', `toast-${type}`)
+    .text(message)
+    .appendTo('#toasts');
+  // Auto-remove after 3 seconds
+  setTimeout(() => {
+    toast.addClass('toast-exit');
+    setTimeout(() => toast.remove(), 300);
+  }, 3000);
+});
+
+// ---------------------------------------------------------------------------
+// On DOM ready - final setup
+// ---------------------------------------------------------------------------
+$.ready(() => {
+  // Display version in the sidebar footer
+  $('#nav-version').text('v' + $.version);
+
+  // Theme: restore saved preference or auto-detect from system
+  const saved = $.storage.get('theme'); // 'dark' | 'light' | 'system' | null
+  const preference = saved || 'system';
+  applyTheme(preference);
+
+  // Listen for OS color-scheme changes (only applies when preference is 'system')
+  window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', () => {
+    const current = $.storage.get('theme') || 'system';
+    if (current === 'system') applyTheme('system');
+  });
+
+  // Highlight the active link on initial load is handled by z-active-route
+
+  console.log('⚡ {{NAME}} - powered by zQuery v' + $.version);
+
+  // Stats panel: restore open/closed from $.storage (defaults to open)
+  const statsOpen = $.storage.get('statsOpen');
+  if (statsOpen === false) {
+    $('#stats-body').hide();
+    $('#stats-arrow').removeClass('open');
+  }
+
+  // Sidebar contact click - open the global contact card overlay
+  $('#sc-list').on('click', '.sc-item', (e) => {
+    const item = e.target.closest('.sc-item');
+    if (!item) return;
+    const id = Number(item.dataset.contactId);
+    if (id) $.bus.emit('openContact', id);
+  });
+
+  // Initial sidebar stats + contacts + live subscription
+  updateSidebarStats();
+  updateSidebarContacts();
+  const store = $.getStore('main');
+  if (store) {
+    store.subscribe(updateSidebarStats);
+    store.subscribe(updateSidebarContacts);
+  }
+
+  // Mount any components outside the router outlet (e.g. <contact-card>)
+  $.mountAll();
+
+  console.log('⚡ {{NAME}} - powered by zQuery v' + $.version);
+});
+
+// ---------------------------------------------------------------------------
+// Theme helper - resolves 'system' to actual dark/light and applies it
+// ---------------------------------------------------------------------------
+function applyTheme(preference) {
+  let resolved = preference;
+  if (preference === 'system') {
+    resolved = window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
+  }
+  $('html').attr('data-theme', resolved);
+}
+
+// Expose globally so components can call it
+window.__applyTheme = applyTheme;