npm - zero-query - Versions diffs - 1.1.1 → 1.2.0 - Mend

zero-query 1.1.1 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (154) hide show

package/LICENSE +21 -21
package/README.md +2 -0
package/cli/args.js +33 -33
package/cli/commands/build-api.js +443 -442
package/cli/commands/build.js +254 -247
package/cli/commands/bundle.js +1228 -1224
package/cli/commands/create.js +137 -121
package/cli/commands/dev/devtools/index.js +56 -56
package/cli/commands/dev/devtools/js/components.js +49 -49
package/cli/commands/dev/devtools/js/core.js +423 -423
package/cli/commands/dev/devtools/js/elements.js +421 -421
package/cli/commands/dev/devtools/js/network.js +166 -166
package/cli/commands/dev/devtools/js/performance.js +73 -73
package/cli/commands/dev/devtools/js/router.js +105 -105
package/cli/commands/dev/devtools/js/source.js +132 -132
package/cli/commands/dev/devtools/js/stats.js +35 -35
package/cli/commands/dev/devtools/js/tabs.js +79 -79
package/cli/commands/dev/devtools/panel.html +95 -95
package/cli/commands/dev/devtools/styles.css +244 -244
package/cli/commands/dev/index.js +107 -107
package/cli/commands/dev/logger.js +75 -75
package/cli/commands/dev/overlay.js +858 -858
package/cli/commands/dev/server.js +220 -220
package/cli/commands/dev/validator.js +94 -94
package/cli/commands/dev/watcher.js +172 -172
package/cli/help.js +114 -112
package/cli/index.js +52 -52
package/cli/scaffold/default/LICENSE +21 -21
package/cli/scaffold/default/app/app.js +207 -207
package/cli/scaffold/default/app/components/about.js +201 -201
package/cli/scaffold/default/app/components/api-demo.js +143 -143
package/cli/scaffold/default/app/components/contact-card.js +231 -231
package/cli/scaffold/default/app/components/contacts/contacts.css +706 -706
package/cli/scaffold/default/app/components/contacts/contacts.html +200 -200
package/cli/scaffold/default/app/components/contacts/contacts.js +196 -196
package/cli/scaffold/default/app/components/counter.js +127 -127
package/cli/scaffold/default/app/components/home.js +249 -249
package/cli/scaffold/default/app/components/not-found.js +16 -16
package/cli/scaffold/default/app/components/playground/playground.css +115 -115
package/cli/scaffold/default/app/components/playground/playground.html +161 -161
package/cli/scaffold/default/app/components/playground/playground.js +116 -116
package/cli/scaffold/default/app/components/todos.js +225 -225
package/cli/scaffold/default/app/components/toolkit/toolkit.css +97 -97
package/cli/scaffold/default/app/components/toolkit/toolkit.html +146 -146
package/cli/scaffold/default/app/components/toolkit/toolkit.js +280 -280
package/cli/scaffold/default/app/routes.js +15 -15
package/cli/scaffold/default/app/store.js +101 -101
package/cli/scaffold/default/global.css +552 -552
package/cli/scaffold/default/index.html +99 -99
package/cli/scaffold/minimal/app/app.js +85 -85
package/cli/scaffold/minimal/app/components/about.js +68 -68
package/cli/scaffold/minimal/app/components/counter.js +122 -122
package/cli/scaffold/minimal/app/components/home.js +68 -68
package/cli/scaffold/minimal/app/components/not-found.js +16 -16
package/cli/scaffold/minimal/app/routes.js +9 -9
package/cli/scaffold/minimal/app/store.js +36 -36
package/cli/scaffold/minimal/global.css +300 -300
package/cli/scaffold/minimal/index.html +44 -44
package/cli/scaffold/ssr/app/app.js +41 -41
package/cli/scaffold/ssr/app/components/about.js +55 -55
package/cli/scaffold/ssr/app/components/blog/index.js +65 -65
package/cli/scaffold/ssr/app/components/blog/post.js +86 -86
package/cli/scaffold/ssr/app/components/home.js +37 -37
package/cli/scaffold/ssr/app/components/not-found.js +15 -15
package/cli/scaffold/ssr/app/routes.js +8 -8
package/cli/scaffold/ssr/global.css +228 -228
package/cli/scaffold/ssr/index.html +37 -37
package/cli/scaffold/ssr/package.json +8 -8
package/cli/scaffold/ssr/server/data/posts.js +144 -144
package/cli/scaffold/ssr/server/index.js +213 -213
package/cli/scaffold/webrtc/app/app.js +11 -0
package/cli/scaffold/webrtc/app/components/video-room.js +295 -0
package/cli/scaffold/webrtc/app/lib/room.js +252 -0
package/cli/scaffold/webrtc/assets/.gitkeep +0 -0
package/cli/scaffold/webrtc/global.css +250 -0
package/cli/scaffold/webrtc/index.html +21 -0
package/cli/utils.js +305 -287
package/dist/API.md +661 -0
package/dist/zquery.dist.zip +0 -0
package/dist/zquery.js +10313 -6614
package/dist/zquery.min.js +8 -631
package/index.d.ts +570 -371
package/index.js +311 -240
package/package.json +76 -70
package/src/component.js +1709 -1691
package/src/core.js +921 -921
package/src/diff.js +497 -497
package/src/errors.js +209 -209
package/src/expression.js +922 -922
package/src/http.js +242 -242
package/src/package.json +1 -1
package/src/reactive.js +255 -255
package/src/router.js +843 -843
package/src/ssr.js +418 -418
package/src/store.js +318 -318
package/src/utils.js +515 -515
package/src/webrtc/e2ee.js +351 -0
package/src/webrtc/errors.js +116 -0
package/src/webrtc/ice.js +301 -0
package/src/webrtc/index.js +131 -0
package/src/webrtc/joinToken.js +119 -0
package/src/webrtc/observe.js +172 -0
package/src/webrtc/peer.js +351 -0
package/src/webrtc/reactive.js +268 -0
package/src/webrtc/room.js +625 -0
package/src/webrtc/sdp.js +302 -0
package/src/webrtc/sfu/index.js +43 -0
package/src/webrtc/sfu/livekit.js +131 -0
package/src/webrtc/sfu/mediasoup.js +150 -0
package/src/webrtc/signaling.js +373 -0
package/src/webrtc/turn.js +237 -0
package/tests/_helpers/webrtcFakes.js +289 -0
package/tests/audit.test.js +4158 -4158
package/tests/cli.test.js +1136 -1103
package/tests/compare.test.js +497 -486
package/tests/component.test.js +3969 -3938
package/tests/core.test.js +1910 -1910
package/tests/dev-server.test.js +489 -489
package/tests/diff.test.js +1416 -1416
package/tests/docs.test.js +1664 -1650
package/tests/electron-features.test.js +864 -864
package/tests/errors.test.js +619 -619
package/tests/expression.test.js +1056 -1056
package/tests/http.test.js +648 -648
package/tests/reactive.test.js +819 -819
package/tests/router.test.js +2327 -2327
package/tests/ssr.test.js +870 -870
package/tests/store.test.js +830 -830
package/tests/test-minifier.js +153 -153
package/tests/test-ssr.js +27 -27
package/tests/utils.test.js +1377 -1377
package/tests/webrtc/e2ee.test.js +283 -0
package/tests/webrtc/ice.test.js +202 -0
package/tests/webrtc/joinToken.test.js +89 -0
package/tests/webrtc/observe.test.js +111 -0
package/tests/webrtc/peer.test.js +373 -0
package/tests/webrtc/reactive.test.js +235 -0
package/tests/webrtc/room.test.js +406 -0
package/tests/webrtc/sdp.test.js +151 -0
package/tests/webrtc/sfu-livekit.test.js +119 -0
package/tests/webrtc/sfu.test.js +160 -0
package/tests/webrtc/signaling.test.js +251 -0
package/tests/webrtc/turn.test.js +256 -0
package/types/collection.d.ts +383 -383
package/types/component.d.ts +186 -186
package/types/errors.d.ts +135 -135
package/types/http.d.ts +92 -92
package/types/misc.d.ts +201 -201
package/types/reactive.d.ts +98 -98
package/types/router.d.ts +190 -190
package/types/ssr.d.ts +102 -102
package/types/store.d.ts +146 -146
package/types/utils.d.ts +245 -245
package/types/webrtc.d.ts +653 -0

package/cli/scaffold/ssr/server/index.js CHANGED Viewed

@@ -1,213 +1,213 @@
-// server/index.js - SSR HTTP server
-//
-// Renders routes to HTML with zQuery SSR and serves them over HTTP.
-// Components are imported from app/components/ - the same definitions
-// the client uses.
-//
-// Usage:
-//   node server/index.js
-//   PORT=8080 node server/index.js
-import { createServer } from 'node:http';
-import { readFile } from 'node:fs/promises';
-import { join, extname, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { createSSRApp, matchRoute } from 'zero-query/ssr';
-// Shared component definitions - same ones the client registers
-import { homePage }  from '../app/components/home.js';
-import { aboutPage } from '../app/components/about.js';
-import { blogList }  from '../app/components/blog/index.js';
-import { blogPost }  from '../app/components/blog/post.js';
-import { notFound }  from '../app/components/not-found.js';
-import { routes }    from '../app/routes.js';
-// Server-side data — simulates a database or CMS
-import { getAllPosts, getPostBySlug } from './data/posts.js';
-const __dirname = fileURLToPath(new URL('.', import.meta.url));
-const ROOT = join(__dirname, '..');
-const PORT = parseInt(process.env.PORT || '3000', 10);
-// --- SSR app ----------------------------------------------------------------
-const app = createSSRApp();
-app.component('home-page',  homePage);
-app.component('about-page', aboutPage);
-app.component('blog-list',  blogList);
-app.component('blog-post',  blogPost);
-app.component('not-found',  notFound);
-// --- Server-side data fetching ----------------------------------------------
-/**
- * Fetch data for a matched route. This is where you'd query a database,
- * call an API, or read from the filesystem in a real application.
- * The returned object is passed as props to the component during SSR.
- */
-function getPropsForRoute(component, params) {
-  switch (component) {
-    case 'blog-list':
-      return { posts: getAllPosts() };
-    case 'blog-post':
-      return { post: getPostBySlug(params.slug) || null };
-    default:
-      return {};
-  }
-}
-// --- SEO metadata per route -------------------------------------------------
-/**
- * Return page-specific metadata for SEO, social sharing, and browser tabs.
- * The server injects these into the HTML shell's <head> before sending.
- *
- * In a real app you'd pull this from a CMS or database alongside the content.
- * Open Graph tags ensure rich link previews on social media.
- */
-function getMetaForRoute(component, params, props) {
-  const base = {
-    title: '{{NAME}}',
-    description: 'A zQuery SSR application.',
-    ogType: 'website',
-  };
-  switch (component) {
-    case 'home-page':
-      return {
-        ...base,
-        title: '{{NAME}} — Home',
-        description: 'A server-rendered application built with zQuery. Fast first paint, SEO-friendly, zero dependencies.',
-      };
-    case 'blog-list':
-      return {
-        ...base,
-        title: 'Blog — {{NAME}}',
-        description: 'Articles on server-side rendering, hydration, shared components, and modern web architecture.',
-      };
-    case 'blog-post': {
-      const post = props.post;
-      if (!post) return { ...base, title: 'Post Not Found — {{NAME}}' };
-      return {
-        ...base,
-        title: `${post.title} — {{NAME}}`,
-        description: post.summary,
-        ogType: 'article',
-      };
-    }
-    case 'about-page':
-      return {
-        ...base,
-        title: 'About — {{NAME}}',
-        description: 'Learn about zQuery — a zero-dependency frontend micro-library for reactive components, routing, SSR, and state management.',
-      };
-    default:
-      return {
-        ...base,
-        title: 'Page Not Found — {{NAME}}',
-        description: 'The page you\'re looking for doesn\'t exist.',
-      };
-  }
-}
-// --- Render a full HTML page ------------------------------------------------
-// Read the index.html shell once at startup — it already has z-link nav,
-// client scripts (zquery.min.js + app/app.js), and the <z-outlet> tag.
-// On each request we render the matched component into the shell.
-let shellCache = null;
-async function getShell() {
-  if (!shellCache) shellCache = await readFile(join(ROOT, 'index.html'), 'utf-8');
-  return shellCache;
-}
-async function render(pathname) {
-  const { component, params } = matchRoute(routes, pathname);
-  const props = getPropsForRoute(component, params);
-  const meta = getMetaForRoute(component, params, props);
-  return app.renderShell(await getShell(), {
-    component,
-    props,
-    title: meta.title,
-    description: meta.description,
-    og: {
-      title: meta.title,
-      description: meta.description,
-      type: meta.ogType,
-    },
-    ssrData: { component, params, props, meta },
-  });
-}
-// --- Static files -----------------------------------------------------------
-const MIME = {
-  '.css': 'text/css', '.js': 'text/javascript', '.json': 'application/json',
-  '.png': 'image/png', '.jpg': 'image/jpeg', '.svg': 'image/svg+xml',
-  '.ico': 'image/x-icon', '.woff2': 'font/woff2',
-};
-async function serveStatic(res, pathname) {
-  const ext = extname(pathname);
-  if (!MIME[ext]) return false;
-  const filePath = join(ROOT, pathname);
-  if (!resolve(filePath).startsWith(resolve(ROOT))) return false;
-  try {
-    const data = await readFile(filePath);
-    res.writeHead(200, { 'Content-Type': MIME[ext] });
-    res.end(data);
-    return true;
-  } catch { return false; }
-}
-// --- HTTP server ------------------------------------------------------------
-createServer(async (req, res) => {
-  const { pathname } = new URL(req.url, `http://localhost:${PORT}`);
-  // Static assets (CSS, images, etc.)
-  if (pathname !== '/' && await serveStatic(res, pathname)) return;
-  // --- JSON API for client-side navigation ----------------------------------
-  // The client fetches data here when navigating via SPA (after initial SSR).
-  // In a real app, these would query a database or external API.
-  if (pathname === '/api/posts') {
-    const json = JSON.stringify(getAllPosts());
-    res.writeHead(200, { 'Content-Type': 'application/json' });
-    res.end(json);
-    return;
-  }
-  const postMatch = /^\/api\/posts\/([^/]+)$/.exec(pathname);
-  if (postMatch) {
-    const post = getPostBySlug(postMatch[1]) || null;
-    res.writeHead(post ? 200 : 404, { 'Content-Type': 'application/json' });
-    res.end(JSON.stringify(post));
-    return;
-  }
-  // SSR route
-  try {
-    const html = await render(pathname);
-    res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
-    res.end(html);
-  } catch (err) {
-    console.error('SSR error:', err);
-    if (!res.headersSent) {
-      res.writeHead(500, { 'Content-Type': 'text/plain' });
-    }
-    res.end('Internal Server Error');
-  }
-}).listen(PORT, () => {
-  console.log(`\n  ⚡ SSR server → http://localhost:${PORT}\n`);
-  routes.forEach(r => console.log(`    ${r.path.padEnd(10)} → ${r.component}`));
-  console.log(`    *         → not-found\n`);
-});
+// server/index.js - SSR HTTP server
+//
+// Renders routes to HTML with zQuery SSR and serves them over HTTP.
+// Components are imported from app/components/ - the same definitions
+// the client uses.
+//
+// Usage:
+//   node server/index.js
+//   PORT=8080 node server/index.js
+import { createServer } from 'node:http';
+import { readFile } from 'node:fs/promises';
+import { join, extname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createSSRApp, matchRoute } from 'zero-query/ssr';
+// Shared component definitions - same ones the client registers
+import { homePage }  from '../app/components/home.js';
+import { aboutPage } from '../app/components/about.js';
+import { blogList }  from '../app/components/blog/index.js';
+import { blogPost }  from '../app/components/blog/post.js';
+import { notFound }  from '../app/components/not-found.js';
+import { routes }    from '../app/routes.js';
+// Server-side data — simulates a database or CMS
+import { getAllPosts, getPostBySlug } from './data/posts.js';
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+const ROOT = join(__dirname, '..');
+const PORT = parseInt(process.env.PORT || '3000', 10);
+// --- SSR app ----------------------------------------------------------------
+const app = createSSRApp();
+app.component('home-page',  homePage);
+app.component('about-page', aboutPage);
+app.component('blog-list',  blogList);
+app.component('blog-post',  blogPost);
+app.component('not-found',  notFound);
+// --- Server-side data fetching ----------------------------------------------
+/**
+ * Fetch data for a matched route. This is where you'd query a database,
+ * call an API, or read from the filesystem in a real application.
+ * The returned object is passed as props to the component during SSR.
+ */
+function getPropsForRoute(component, params) {
+  switch (component) {
+    case 'blog-list':
+      return { posts: getAllPosts() };
+    case 'blog-post':
+      return { post: getPostBySlug(params.slug) || null };
+    default:
+      return {};
+  }
+}
+// --- SEO metadata per route -------------------------------------------------
+/**
+ * Return page-specific metadata for SEO, social sharing, and browser tabs.
+ * The server injects these into the HTML shell's <head> before sending.
+ *
+ * In a real app you'd pull this from a CMS or database alongside the content.
+ * Open Graph tags ensure rich link previews on social media.
+ */
+function getMetaForRoute(component, params, props) {
+  const base = {
+    title: '{{NAME}}',
+    description: 'A zQuery SSR application.',
+    ogType: 'website',
+  };
+  switch (component) {
+    case 'home-page':
+      return {
+        ...base,
+        title: '{{NAME}} — Home',
+        description: 'A server-rendered application built with zQuery. Fast first paint, SEO-friendly, zero dependencies.',
+      };
+    case 'blog-list':
+      return {
+        ...base,
+        title: 'Blog — {{NAME}}',
+        description: 'Articles on server-side rendering, hydration, shared components, and modern web architecture.',
+      };
+    case 'blog-post': {
+      const post = props.post;
+      if (!post) return { ...base, title: 'Post Not Found — {{NAME}}' };
+      return {
+        ...base,
+        title: `${post.title} — {{NAME}}`,
+        description: post.summary,
+        ogType: 'article',
+      };
+    }
+    case 'about-page':
+      return {
+        ...base,
+        title: 'About — {{NAME}}',
+        description: 'Learn about zQuery — a zero-dependency frontend micro-library for reactive components, routing, SSR, and state management.',
+      };
+    default:
+      return {
+        ...base,
+        title: 'Page Not Found — {{NAME}}',
+        description: 'The page you\'re looking for doesn\'t exist.',
+      };
+  }
+}
+// --- Render a full HTML page ------------------------------------------------
+// Read the index.html shell once at startup — it already has z-link nav,
+// client scripts (zquery.min.js + app/app.js), and the <z-outlet> tag.
+// On each request we render the matched component into the shell.
+let shellCache = null;
+async function getShell() {
+  if (!shellCache) shellCache = await readFile(join(ROOT, 'index.html'), 'utf-8');
+  return shellCache;
+}
+async function render(pathname) {
+  const { component, params } = matchRoute(routes, pathname);
+  const props = getPropsForRoute(component, params);
+  const meta = getMetaForRoute(component, params, props);
+  return app.renderShell(await getShell(), {
+    component,
+    props,
+    title: meta.title,
+    description: meta.description,
+    og: {
+      title: meta.title,
+      description: meta.description,
+      type: meta.ogType,
+    },
+    ssrData: { component, params, props, meta },
+  });
+}
+// --- Static files -----------------------------------------------------------
+const MIME = {
+  '.css': 'text/css', '.js': 'text/javascript', '.json': 'application/json',
+  '.png': 'image/png', '.jpg': 'image/jpeg', '.svg': 'image/svg+xml',
+  '.ico': 'image/x-icon', '.woff2': 'font/woff2',
+};
+async function serveStatic(res, pathname) {
+  const ext = extname(pathname);
+  if (!MIME[ext]) return false;
+  const filePath = join(ROOT, pathname);
+  if (!resolve(filePath).startsWith(resolve(ROOT))) return false;
+  try {
+    const data = await readFile(filePath);
+    res.writeHead(200, { 'Content-Type': MIME[ext] });
+    res.end(data);
+    return true;
+  } catch { return false; }
+}
+// --- HTTP server ------------------------------------------------------------
+createServer(async (req, res) => {
+  const { pathname } = new URL(req.url, `http://localhost:${PORT}`);
+  // Static assets (CSS, images, etc.)
+  if (pathname !== '/' && await serveStatic(res, pathname)) return;
+  // --- JSON API for client-side navigation ----------------------------------
+  // The client fetches data here when navigating via SPA (after initial SSR).
+  // In a real app, these would query a database or external API.
+  if (pathname === '/api/posts') {
+    const json = JSON.stringify(getAllPosts());
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(json);
+    return;
+  }
+  const postMatch = /^\/api\/posts\/([^/]+)$/.exec(pathname);
+  if (postMatch) {
+    const post = getPostBySlug(postMatch[1]) || null;
+    res.writeHead(post ? 200 : 404, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify(post));
+    return;
+  }
+  // SSR route
+  try {
+    const html = await render(pathname);
+    res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+    res.end(html);
+  } catch (err) {
+    console.error('SSR error:', err);
+    if (!res.headersSent) {
+      res.writeHead(500, { 'Content-Type': 'text/plain' });
+    }
+    res.end('Internal Server Error');
+  }
+}).listen(PORT, () => {
+  console.log(`\n  ⚡ SSR server → http://localhost:${PORT}\n`);
+  routes.forEach(r => console.log(`    ${r.path.padEnd(10)} → ${r.component}`));
+  console.log(`    *         → not-found\n`);
+});

package/cli/scaffold/webrtc/app/app.js ADDED Viewed

@@ -0,0 +1,11 @@
+// app.js - {{NAME}} WebRTC demo entry point.
+import './components/video-room.js';
+$.ready(() => {
+    $('#nav-version').text('v' + $.version);
+    // Instantiate every registered <component-tag> already in the DOM.
+    // (No $.router() is wiring it up for us in this single-page scaffold.)
+    $.mountAll();
+    console.log('⚡ {{NAME}} - zQuery v' + $.version + ' WebRTC demo');
+});