zero-query 0.9.7 → 0.9.9

package/cli/scaffold/minimal/global.css

@@ -0,0 +1,291 @@
+/* global.css — minimal scaffold styles
+ *
+ * Dark theme by default, light theme via [data-theme="light"].
+ * Modify the CSS variables below to customise the look and feel.
+ */
+
+/* -- Theme Variables -- */
+:root {
+  --bg:          #0d1117;
+  --bg-surface:  #161b22;
+  --bg-card:     rgba(22, 27, 34, 0.55);
+  --bg-hover:    #21262d;
+  --border:      rgba(48, 54, 61, 0.45);
+  --text:        #e6edf3;
+  --text-muted:  #7d8590;
+  --accent:      #58a6ff;
+  --accent-hover:#79c0ff;
+  --accent-soft: rgba(88, 166, 255, 0.10);
+  --accent-glow: rgba(88, 166, 255, 0.06);
+  --success:     #3fb950;
+  --danger:      #f85149;
+  --radius:      8px;
+  --radius-lg:   12px;
+  --sidebar-w:   220px;
+  --topbar-h:    56px;
+  --font:        'Inter', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif;
+  --ease-out:    cubic-bezier(0.22, 1, 0.36, 1);
+}
+
+[data-theme="light"] {
+  --bg:          #f6f8fa;
+  --bg-surface:  #ffffff;
+  --bg-card:     rgba(255, 255, 255, 0.8);
+  --bg-hover:    #eaeef2;
+  --border:      rgba(208, 215, 222, 0.65);
+  --text:        #1f2328;
+  --text-muted:  #656d76;
+  --accent:      #0969da;
+  --accent-hover:#0550ae;
+  --accent-soft: rgba(9,105,218,0.08);
+  --accent-glow: rgba(9,105,218,0.04);
+  --success:     #1a7f37;
+  --danger:      #cf222e;
+}
+
+/* -- Reset -- */
+*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+
+body {
+  font-family: var(--font);
+  font-size: 15px;
+  line-height: 1.6;
+  color: var(--text);
+  background: var(--bg);
+  overflow-x: hidden;
+}
+
+a { color: var(--accent); text-decoration: none; transition: color .15s; }
+a:hover { color: var(--accent-hover); }
+code { background: var(--bg-hover); padding: 2px 6px; border-radius: 4px; font-size: 0.85em; }
+
+/* -- Sidebar -- */
+.sidebar {
+  position: fixed;
+  top: 0; left: 0; bottom: 0;
+  width: var(--sidebar-w);
+  background: var(--bg-surface);
+  border-right: 1px solid var(--border);
+  display: flex;
+  flex-direction: column;
+  z-index: 100;
+  transition: transform 0.3s var(--ease-out);
+}
+
+.sidebar-header {
+  padding: 1.25rem 1.25rem 1rem;
+  border-bottom: 1px solid var(--border);
+}
+
+.brand {
+  font-size: 1.15rem;
+  font-weight: 700;
+  color: var(--text);
+  letter-spacing: -0.02em;
+}
+
+.sidebar-nav {
+  flex: 1;
+  padding: 0.75rem 0;
+  overflow-y: auto;
+}
+
+.nav-link {
+  display: block;
+  padding: 0.6rem 1.25rem;
+  color: var(--text-muted);
+  font-size: 0.9rem;
+  font-weight: 500;
+  transition: all 0.15s ease;
+  border-left: 3px solid transparent;
+}
+
+.nav-link:hover {
+  color: var(--text);
+  background: var(--bg-hover);
+}
+
+.nav-link.active {
+  color: var(--accent);
+  background: var(--accent-soft);
+  border-left-color: var(--accent);
+}
+
+.sidebar-footer {
+  padding: 0.75rem 1.25rem;
+  border-top: 1px solid var(--border);
+  color: var(--text-muted);
+  font-size: 0.8rem;
+}
+
+/* -- Mobile Top Bar -- */
+.topbar {
+  display: none;
+  position: fixed;
+  top: 0; left: 0; right: 0;
+  height: var(--topbar-h);
+  background: var(--bg-surface);
+  border-bottom: 1px solid var(--border);
+  align-items: center;
+  padding: 0 1rem;
+  z-index: 101;
+}
+
+.topbar-brand {
+  font-weight: 700;
+  font-size: 1.05rem;
+  margin-left: 0.75rem;
+}
+
+/* Hamburger */
+.hamburger {
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+  gap: 5px;
+  width: 32px;
+  height: 32px;
+  background: none;
+  border: none;
+  cursor: pointer;
+  padding: 4px;
+}
+
+.hamburger span {
+  display: block;
+  height: 2px;
+  background: var(--text);
+  border-radius: 2px;
+  transition: all 0.25s var(--ease-out);
+}
+
+.hamburger.active span:nth-child(1) { transform: translateY(7px) rotate(45deg); }
+.hamburger.active span:nth-child(2) { opacity: 0; }
+.hamburger.active span:nth-child(3) { transform: translateY(-7px) rotate(-45deg); }
+
+/* Overlay */
+.overlay {
+  display: none;
+  position: fixed;
+  inset: 0;
+  background: rgba(0, 0, 0, 0.5);
+  z-index: 99;
+  opacity: 0;
+  transition: opacity 0.3s ease;
+}
+
+.overlay.visible { display: block; opacity: 1; }
+
+/* -- Main Content -- */
+.content {
+  margin-left: auto;
+  margin-right: auto;
+  padding: 2.5rem 3rem 2.5rem calc(var(--sidebar-w) + 3rem);
+  max-width: calc(1010px + var(--sidebar-w));
+  min-height: 100vh;
+}
+
+/* -- Page Header -- */
+.page-header { margin-bottom: 2rem; }
+.page-header h1 { font-size: 1.85rem; font-weight: 700; margin-bottom: 0.35rem; letter-spacing: -0.02em; }
+.subtitle { color: var(--text-muted); font-size: 0.95rem; }
+
+/* -- Cards -- */
+.card {
+  background: var(--bg-card);
+  border: 1px solid var(--border);
+  border-radius: var(--radius-lg);
+  padding: 1.5rem;
+  margin-bottom: 1.25rem;
+  backdrop-filter: blur(8px);
+  -webkit-backdrop-filter: blur(8px);
+  transition: border-color .2s ease, box-shadow .2s ease;
+}
+
+.card:hover {
+  border-color: rgba(88, 166, 255, 0.15);
+  box-shadow: 0 4px 24px rgba(0, 0, 0, 0.15), 0 0 0 1px rgba(88, 166, 255, 0.04);
+}
+
+.card h3 { font-size: 1.1rem; margin-bottom: 0.5rem; }
+.card p { color: var(--text-muted); font-size: 0.9rem; margin-bottom: 0.75rem; }
+
+/* -- Buttons -- */
+.btn {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.4rem;
+  padding: 0.5rem 1.1rem;
+  font-size: 0.9rem;
+  font-weight: 500;
+  border: none;
+  border-radius: var(--radius);
+  cursor: pointer;
+  transition: all 0.15s ease;
+  font-family: inherit;
+}
+
+.btn:active { transform: scale(0.97); }
+
+.btn-primary { background: var(--accent); color: #fff; }
+.btn-primary:hover { background: var(--accent-hover); color: #fff; }
+
+.btn-outline { background: transparent; border: 1px solid var(--border); color: var(--accent); }
+.btn-outline:hover { border-color: var(--accent); background: var(--accent-soft); }
+
+.btn-ghost { background: transparent; color: var(--text-muted); }
+.btn-ghost:hover { color: var(--text); background: var(--bg-hover); }
+
+.btn-sm { padding: 0.35rem 0.75rem; font-size: 0.82rem; }
+
+/* -- Inputs -- */
+.input {
+  width: 100%;
+  padding: 0.55rem 0.85rem;
+  background: var(--bg);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  color: var(--text);
+  font-size: 0.9rem;
+  font-family: inherit;
+  outline: none;
+  transition: border-color 0.2s ease, box-shadow 0.2s ease;
+}
+
+.input:hover { border-color: rgba(88,166,255,0.2); }
+.input:focus { border-color: var(--accent); box-shadow: 0 0 0 2px rgba(88,166,255,0.1); }
+.input-sm { width: auto; padding: 0.35rem 0.6rem; font-size: 0.82rem; }
+
+.muted { color: var(--text-muted); }
+
+/* -- Route Transition -- */
+#app { animation: fade-in 0.25s var(--ease-out); }
+@keyframes fade-in { from { opacity: 0; transform: translateY(6px); } to { opacity: 1; transform: translateY(0); } }
+
+/* -- Responsive: Mobile -- */
+@media (max-width: 768px) {
+  .sidebar {
+    transform: translateX(-100%);
+    width: 260px;
+  }
+  .sidebar.open { transform: translateX(0); }
+
+  .topbar { display: flex; }
+
+  .content {
+    margin-left: 0;
+    padding: 1.25rem;
+    padding-top: calc(var(--topbar-h) + 1.25rem);
+    max-width: 100%;
+  }
+
+  .card { padding: 1.15rem; }
+  .page-header h1 { font-size: 1.4rem; }
+}
+
+@media (max-width: 480px) {
+  .content { padding: 0.75rem; padding-top: calc(var(--topbar-h) + 0.75rem); }
+  .card { padding: 1rem; }
+  .page-header h1 { font-size: 1.25rem; }
+  .subtitle { font-size: 0.85rem; }
+}

package/cli/scaffold/minimal/index.html

@@ -0,0 +1,44 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>{{NAME}}</title>
+  <base href="/">
+  <link rel="stylesheet" href="global.css">
+  <script src="zquery.min.js"></script>
+  <script type="module" src="app/app.js"></script>
+</head>
+<body>
+
+  <!-- Sidebar Navigation -->
+  <aside class="sidebar" id="sidebar">
+    <div class="sidebar-header">
+      <span class="brand">⚡ {{NAME}}</span>
+    </div>
+    <nav class="sidebar-nav">
+      <a z-link="/" class="nav-link">Home</a>
+      <a z-link="/counter" class="nav-link">Counter</a>
+      <a z-link="/about" class="nav-link">About</a>
+    </nav>
+    <div class="sidebar-footer">
+      <small>zQuery <span id="nav-version"></span></small>
+    </div>
+  </aside>
+
+  <!-- Mobile Top Bar -->
+  <header class="topbar" id="topbar">
+    <button class="hamburger" id="menu-toggle" aria-label="Toggle menu">
+      <span></span><span></span><span></span>
+    </button>
+    <span class="topbar-brand">⚡ {{NAME}}</span>
+  </header>
+
+  <!-- Overlay for mobile menu -->
+  <div class="overlay" id="overlay"></div>
+
+  <!-- Router Outlet -->
+  <main class="content" id="app"></main>
+
+</body>
+</html>

package/cli/scaffold/ssr/app/app.js

@@ -0,0 +1,30 @@
+// app.js — Client entry point
+//
+// Imports shared component definitions and registers them with zQuery.
+// The SSR server imports the same definitions via createSSRApp().
+
+import { homePage }  from './components/home.js';
+import { aboutPage } from './components/about.js';
+import { notFound }  from './components/not-found.js';
+import { routes }    from './routes.js';
+
+// Register shared component definitions on the client
+$.component('home-page',  homePage);
+$.component('about-page', aboutPage);
+$.component('not-found',  notFound);
+
+// Client-side router
+const router = $.router({
+  el: '#app',
+  routes,
+  fallback: 'not-found',
+  mode: 'history'
+});
+
+// Active nav highlighting
+router.onChange((to) => {
+  $.qsa('.nav-link').forEach(link => {
+    const href = link.getAttribute('z-link') || link.getAttribute('href');
+    link.classList.toggle('active', href === to.path);
+  });
+});

package/cli/scaffold/ssr/app/components/about.js

@@ -0,0 +1,28 @@
+// about.js — About page component
+
+export const aboutPage = {
+  state: () => ({
+    features: [
+      'createSSRApp() — isolated component registry for Node.js',
+      'renderToString() — render a component to an HTML string',
+      'renderPage() — full HTML document with meta tags',
+      'renderBatch() — render multiple components in one call',
+      'Hydration markers (data-zq-ssr) for client takeover',
+      'SEO: description, canonical URL, Open Graph tags',
+    ]
+  }),
+
+  render() {
+    const list = this.state.features.map(f => `<li>${f}</li>`).join('');
+    return `
+      <div class="page-header">
+        <h1>About</h1>
+        <p class="subtitle">SSR capabilities in this scaffold.</p>
+      </div>
+      <div class="card">
+        <h3>SSR API</h3>
+        <ul style="padding-left:1.2rem; line-height:2;">${list}</ul>
+      </div>
+    `;
+  }
+};

package/cli/scaffold/ssr/app/components/home.js

@@ -0,0 +1,37 @@
+// home.js — Home page component
+//
+// Exports a plain definition object that works on both client and server.
+// The client registers it with $.component(), the server with app.component().
+
+export const homePage = {
+  state: () => ({
+    greeting: 'Hello',
+    timestamp: new Date().toLocaleTimeString(),
+  }),
+
+  // init() runs on both client and server — no DOM required
+  init() {
+    const hour = new Date().getHours();
+    this.state.greeting =
+      hour < 12 ? 'Good morning' :
+      hour < 18 ? 'Good afternoon' : 'Good evening';
+  },
+
+  render() {
+    return `
+      <div class="page-header">
+        <h1>${this.state.greeting} 👋</h1>
+        <p class="subtitle">Rendered with zQuery SSR</p>
+      </div>
+      <div class="card">
+        <h3>Server-Side Rendering</h3>
+        <p>
+          This page was rendered to HTML on the server and served as a complete
+          document. The same component definition powers both the SSR server and
+          the client-side SPA.
+        </p>
+        <p>Rendered at <strong>${this.state.timestamp}</strong></p>
+      </div>
+    `;
+  }
+};

package/cli/scaffold/ssr/app/components/not-found.js

@@ -0,0 +1,15 @@
+// not-found.js — 404 fallback component
+
+export const notFound = {
+  render() {
+    return `
+      <div class="page-header" style="text-align:center; margin-top:4rem;">
+        <h1>404</h1>
+        <p class="subtitle">Page not found.</p>
+        <p style="margin-top:1rem;">
+          <a href="/" style="color:var(--accent);">← Home</a>
+        </p>
+      </div>
+    `;
+  }
+};

package/cli/scaffold/ssr/app/routes.js

@@ -0,0 +1,6 @@
+// routes.js — Route definitions (shared between client and server)
+
+export const routes = [
+  { path: '/',     component: 'home-page'  },
+  { path: '/about', component: 'about-page' },
+];

package/cli/scaffold/ssr/global.css

@@ -0,0 +1,113 @@
+/* global.css — SSR Scaffold Styles */
+
+*, *::before, *::after {
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0;
+}
+
+:root {
+  --bg: #0f0f0f;
+  --surface: #1a1a2e;
+  --text: #e0e0e0;
+  --muted: #888;
+  --accent: #00d4ff;
+  --accent-hover: #00b8d9;
+  --radius: 8px;
+  --gap: 1.5rem;
+}
+
+body {
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+  background: var(--bg);
+  color: var(--text);
+  line-height: 1.6;
+  min-height: 100vh;
+}
+
+/* -- Navbar -- */
+.navbar {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 1rem 2rem;
+  background: var(--surface);
+  border-bottom: 1px solid rgba(255,255,255,0.06);
+}
+
+.brand {
+  font-weight: 700;
+  font-size: 1.2rem;
+  color: var(--accent);
+}
+
+.nav-links { display: flex; gap: 1rem; }
+
+.nav-link {
+  color: var(--muted);
+  text-decoration: none;
+  padding: 0.4rem 0.8rem;
+  border-radius: var(--radius);
+  transition: color 0.2s, background 0.2s;
+}
+.nav-link:hover, .nav-link.active {
+  color: var(--accent);
+  background: rgba(0, 212, 255, 0.08);
+}
+
+/* -- Main content -- */
+#app {
+  max-width: 800px;
+  margin: 2rem auto;
+  padding: 0 1.5rem;
+}
+
+[z-cloak] { display: none !important; }
+
+.page-header {
+  margin-bottom: var(--gap);
+}
+.page-header h1 {
+  font-size: 2rem;
+  margin-bottom: 0.5rem;
+}
+.page-header .subtitle {
+  color: var(--muted);
+}
+
+.card {
+  background: var(--surface);
+  border: 1px solid rgba(255,255,255,0.06);
+  border-radius: var(--radius);
+  padding: 1.5rem;
+  margin-bottom: var(--gap);
+}
+.card h3 {
+  margin-bottom: 0.75rem;
+  color: var(--accent);
+}
+.card code {
+  background: rgba(255,255,255,0.06);
+  padding: 0.15em 0.4em;
+  border-radius: 4px;
+  font-size: 0.9em;
+}
+
+.badge {
+  display: inline-block;
+  padding: 2px 8px;
+  border-radius: 4px;
+  font-size: 0.8em;
+  font-weight: 600;
+}
+.badge-ssr { background: rgba(0,212,255,0.15); color: var(--accent); }
+.badge-csr { background: rgba(255,165,0,0.15); color: #ffa500; }
+
+/* -- Footer -- */
+.footer {
+  text-align: center;
+  padding: 2rem;
+  color: var(--muted);
+  border-top: 1px solid rgba(255,255,255,0.06);
+  margin-top: 3rem;
+}

package/cli/scaffold/ssr/index.html

@@ -0,0 +1,31 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>{{NAME}}</title>
+  <base href="/">
+  <link rel="stylesheet" href="global.css">
+  <script src="zquery.min.js"></script>
+  <script type="module" src="app/app.js"></script>
+</head>
+<body>
+
+  <!-- Navigation -->
+  <nav class="navbar">
+    <span class="brand">⚡ {{NAME}}</span>
+    <div class="nav-links">
+      <a z-link="/" class="nav-link">Home</a>
+      <a z-link="/about" class="nav-link">About</a>
+    </div>
+  </nav>
+
+  <!-- Main content — SSR output is injected here by the server -->
+  <main id="app" z-cloak></main>
+
+  <footer class="footer">
+    <small>Built with zQuery · SSR Scaffold</small>
+  </footer>
+
+</body>
+</html>

package/cli/scaffold/ssr/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "{{NAME}}",
+  "private": true,
+  "type": "module",
+  "dependencies": {
+    "zero-query": "latest"
+  }
+}