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
  1. package/LICENSE +21 -21
  2. package/README.md +2 -0
  3. package/cli/args.js +33 -33
  4. package/cli/commands/build-api.js +443 -442
  5. package/cli/commands/build.js +254 -247
  6. package/cli/commands/bundle.js +1228 -1224
  7. package/cli/commands/create.js +137 -121
  8. package/cli/commands/dev/devtools/index.js +56 -56
  9. package/cli/commands/dev/devtools/js/components.js +49 -49
  10. package/cli/commands/dev/devtools/js/core.js +423 -423
  11. package/cli/commands/dev/devtools/js/elements.js +421 -421
  12. package/cli/commands/dev/devtools/js/network.js +166 -166
  13. package/cli/commands/dev/devtools/js/performance.js +73 -73
  14. package/cli/commands/dev/devtools/js/router.js +105 -105
  15. package/cli/commands/dev/devtools/js/source.js +132 -132
  16. package/cli/commands/dev/devtools/js/stats.js +35 -35
  17. package/cli/commands/dev/devtools/js/tabs.js +79 -79
  18. package/cli/commands/dev/devtools/panel.html +95 -95
  19. package/cli/commands/dev/devtools/styles.css +244 -244
  20. package/cli/commands/dev/index.js +107 -107
  21. package/cli/commands/dev/logger.js +75 -75
  22. package/cli/commands/dev/overlay.js +858 -858
  23. package/cli/commands/dev/server.js +220 -220
  24. package/cli/commands/dev/validator.js +94 -94
  25. package/cli/commands/dev/watcher.js +172 -172
  26. package/cli/help.js +114 -112
  27. package/cli/index.js +52 -52
  28. package/cli/scaffold/default/LICENSE +21 -21
  29. package/cli/scaffold/default/app/app.js +207 -207
  30. package/cli/scaffold/default/app/components/about.js +201 -201
  31. package/cli/scaffold/default/app/components/api-demo.js +143 -143
  32. package/cli/scaffold/default/app/components/contact-card.js +231 -231
  33. package/cli/scaffold/default/app/components/contacts/contacts.css +706 -706
  34. package/cli/scaffold/default/app/components/contacts/contacts.html +200 -200
  35. package/cli/scaffold/default/app/components/contacts/contacts.js +196 -196
  36. package/cli/scaffold/default/app/components/counter.js +127 -127
  37. package/cli/scaffold/default/app/components/home.js +249 -249
  38. package/cli/scaffold/default/app/components/not-found.js +16 -16
  39. package/cli/scaffold/default/app/components/playground/playground.css +115 -115
  40. package/cli/scaffold/default/app/components/playground/playground.html +161 -161
  41. package/cli/scaffold/default/app/components/playground/playground.js +116 -116
  42. package/cli/scaffold/default/app/components/todos.js +225 -225
  43. package/cli/scaffold/default/app/components/toolkit/toolkit.css +97 -97
  44. package/cli/scaffold/default/app/components/toolkit/toolkit.html +146 -146
  45. package/cli/scaffold/default/app/components/toolkit/toolkit.js +280 -280
  46. package/cli/scaffold/default/app/routes.js +15 -15
  47. package/cli/scaffold/default/app/store.js +101 -101
  48. package/cli/scaffold/default/global.css +552 -552
  49. package/cli/scaffold/default/index.html +99 -99
  50. package/cli/scaffold/minimal/app/app.js +85 -85
  51. package/cli/scaffold/minimal/app/components/about.js +68 -68
  52. package/cli/scaffold/minimal/app/components/counter.js +122 -122
  53. package/cli/scaffold/minimal/app/components/home.js +68 -68
  54. package/cli/scaffold/minimal/app/components/not-found.js +16 -16
  55. package/cli/scaffold/minimal/app/routes.js +9 -9
  56. package/cli/scaffold/minimal/app/store.js +36 -36
  57. package/cli/scaffold/minimal/global.css +300 -300
  58. package/cli/scaffold/minimal/index.html +44 -44
  59. package/cli/scaffold/ssr/app/app.js +41 -41
  60. package/cli/scaffold/ssr/app/components/about.js +55 -55
  61. package/cli/scaffold/ssr/app/components/blog/index.js +65 -65
  62. package/cli/scaffold/ssr/app/components/blog/post.js +86 -86
  63. package/cli/scaffold/ssr/app/components/home.js +37 -37
  64. package/cli/scaffold/ssr/app/components/not-found.js +15 -15
  65. package/cli/scaffold/ssr/app/routes.js +8 -8
  66. package/cli/scaffold/ssr/global.css +228 -228
  67. package/cli/scaffold/ssr/index.html +37 -37
  68. package/cli/scaffold/ssr/package.json +8 -8
  69. package/cli/scaffold/ssr/server/data/posts.js +144 -144
  70. package/cli/scaffold/ssr/server/index.js +213 -213
  71. package/cli/scaffold/webrtc/app/app.js +11 -0
  72. package/cli/scaffold/webrtc/app/components/video-room.js +295 -0
  73. package/cli/scaffold/webrtc/app/lib/room.js +252 -0
  74. package/cli/scaffold/webrtc/assets/.gitkeep +0 -0
  75. package/cli/scaffold/webrtc/global.css +250 -0
  76. package/cli/scaffold/webrtc/index.html +21 -0
  77. package/cli/utils.js +305 -287
  78. package/dist/API.md +661 -0
  79. package/dist/zquery.dist.zip +0 -0
  80. package/dist/zquery.js +10313 -6614
  81. package/dist/zquery.min.js +8 -631
  82. package/index.d.ts +570 -371
  83. package/index.js +311 -240
  84. package/package.json +76 -70
  85. package/src/component.js +1709 -1691
  86. package/src/core.js +921 -921
  87. package/src/diff.js +497 -497
  88. package/src/errors.js +209 -209
  89. package/src/expression.js +922 -922
  90. package/src/http.js +242 -242
  91. package/src/package.json +1 -1
  92. package/src/reactive.js +255 -255
  93. package/src/router.js +843 -843
  94. package/src/ssr.js +418 -418
  95. package/src/store.js +318 -318
  96. package/src/utils.js +515 -515
  97. package/src/webrtc/e2ee.js +351 -0
  98. package/src/webrtc/errors.js +116 -0
  99. package/src/webrtc/ice.js +301 -0
  100. package/src/webrtc/index.js +131 -0
  101. package/src/webrtc/joinToken.js +119 -0
  102. package/src/webrtc/observe.js +172 -0
  103. package/src/webrtc/peer.js +351 -0
  104. package/src/webrtc/reactive.js +268 -0
  105. package/src/webrtc/room.js +625 -0
  106. package/src/webrtc/sdp.js +302 -0
  107. package/src/webrtc/sfu/index.js +43 -0
  108. package/src/webrtc/sfu/livekit.js +131 -0
  109. package/src/webrtc/sfu/mediasoup.js +150 -0
  110. package/src/webrtc/signaling.js +373 -0
  111. package/src/webrtc/turn.js +237 -0
  112. package/tests/_helpers/webrtcFakes.js +289 -0
  113. package/tests/audit.test.js +4158 -4158
  114. package/tests/cli.test.js +1136 -1103
  115. package/tests/compare.test.js +497 -486
  116. package/tests/component.test.js +3969 -3938
  117. package/tests/core.test.js +1910 -1910
  118. package/tests/dev-server.test.js +489 -489
  119. package/tests/diff.test.js +1416 -1416
  120. package/tests/docs.test.js +1664 -1650
  121. package/tests/electron-features.test.js +864 -864
  122. package/tests/errors.test.js +619 -619
  123. package/tests/expression.test.js +1056 -1056
  124. package/tests/http.test.js +648 -648
  125. package/tests/reactive.test.js +819 -819
  126. package/tests/router.test.js +2327 -2327
  127. package/tests/ssr.test.js +870 -870
  128. package/tests/store.test.js +830 -830
  129. package/tests/test-minifier.js +153 -153
  130. package/tests/test-ssr.js +27 -27
  131. package/tests/utils.test.js +1377 -1377
  132. package/tests/webrtc/e2ee.test.js +283 -0
  133. package/tests/webrtc/ice.test.js +202 -0
  134. package/tests/webrtc/joinToken.test.js +89 -0
  135. package/tests/webrtc/observe.test.js +111 -0
  136. package/tests/webrtc/peer.test.js +373 -0
  137. package/tests/webrtc/reactive.test.js +235 -0
  138. package/tests/webrtc/room.test.js +406 -0
  139. package/tests/webrtc/sdp.test.js +151 -0
  140. package/tests/webrtc/sfu-livekit.test.js +119 -0
  141. package/tests/webrtc/sfu.test.js +160 -0
  142. package/tests/webrtc/signaling.test.js +251 -0
  143. package/tests/webrtc/turn.test.js +256 -0
  144. package/types/collection.d.ts +383 -383
  145. package/types/component.d.ts +186 -186
  146. package/types/errors.d.ts +135 -135
  147. package/types/http.d.ts +92 -92
  148. package/types/misc.d.ts +201 -201
  149. package/types/reactive.d.ts +98 -98
  150. package/types/router.d.ts +190 -190
  151. package/types/ssr.d.ts +102 -102
  152. package/types/store.d.ts +146 -146
  153. package/types/utils.d.ts +245 -245
  154. package/types/webrtc.d.ts +653 -0
@@ -1,249 +1,249 @@
1
- // home.js - Landing page / dashboard
2
- //
3
- // Features used:
4
- // $.component - define a component with state + render
5
- // $.signal - reactive value container
6
- // $.computed - derived reactive value
7
- // $.effect - side-effect that auto-tracks signals
8
- // $.getStore - access the global store
9
-
10
- $.component('home-page', {
11
- styles: `
12
- .sig-lab { padding: 1.5rem 2rem; border-radius: var(--radius-lg);
13
- background: var(--bg-hover); border: 1px solid var(--border); }
14
- .sig-row { display: flex; gap: 1.25rem; align-items: center; flex-wrap: wrap;
15
- margin-bottom: 1rem; }
16
- .sig-val { display: inline-flex; align-items: center; gap: .4rem;
17
- padding: .4rem .85rem; border-radius: var(--radius);
18
- background: rgba(88,166,255,.08); border: 1px solid rgba(88,166,255,.15);
19
- font-family: monospace; font-size: 1rem; font-weight: 600; }
20
- .sig-val span { color: var(--accent); }
21
- .sig-val small { color: var(--text-muted); font-weight: 400; font-size: .85rem; }
22
- .sig-op { display: flex; align-items: center; gap: .5rem; flex-wrap: wrap; }
23
- .sig-graph { display: flex; gap: 3px; align-items: flex-end; height: 56px;
24
- margin-top: .75rem; }
25
- .sig-bar { flex: 1; min-width: 4px; max-width: 24px;
26
- background: var(--accent); border-radius: 3px 3px 0 0;
27
- opacity: .65; transition: height .15s ease; }
28
-
29
- /* Custom dropdown for operation picker */
30
- .sig-select { position: relative; z-index: 2; }
31
- .sig-select-trigger {
32
- display: inline-flex; align-items: center; gap: .4rem;
33
- padding: .4rem .85rem; border-radius: var(--radius);
34
- background: var(--bg-surface); border: 1px solid var(--border);
35
- color: var(--text); font-size: .9rem; font-family: inherit;
36
- cursor: pointer; transition: all .15s ease; user-select: none; }
37
- .sig-select-trigger:hover { border-color: var(--accent); background: var(--accent-soft); }
38
- .sig-select-trigger.open { border-color: var(--accent); box-shadow: 0 0 0 2px rgba(88,166,255,.1); }
39
- .sig-select-trigger .sig-select-arrow {
40
- font-size: .65rem; color: var(--text-muted); transition: transform .15s ease;
41
- margin-left: .15rem; }
42
- .sig-select-trigger.open .sig-select-arrow { transform: rotate(180deg); }
43
- .sig-select-menu {
44
- position: absolute; top: calc(100% + 4px); left: 0; min-width: 160px;
45
- background: var(--bg-surface); border: 1px solid var(--border);
46
- border-radius: var(--radius); padding: .3rem;
47
- box-shadow: 0 8px 24px rgba(0,0,0,.25); z-index: 50; }
48
- .sig-select-item {
49
- display: flex; align-items: center; gap: .5rem;
50
- padding: .4rem .65rem; border-radius: calc(var(--radius) - 2px);
51
- font-size: .84rem; cursor: pointer; color: var(--text);
52
- transition: all .1s ease; }
53
- .sig-select-item:hover { background: var(--bg-hover); }
54
- .sig-select-item.active { background: var(--accent-soft); color: var(--accent); font-weight: 600; }
55
- .sig-select-item .sig-select-symbol {
56
- width: 1.4rem; text-align: center; font-weight: 600; font-size: .9rem; }
57
-
58
- .sig-how { display: grid; grid-template-columns: repeat(3, 1fr);
59
- gap: 1rem; margin-top: 1.25rem; }
60
- .sig-concept { padding: 1rem 1.1rem; border-radius: var(--radius);
61
- border: 1px solid var(--border); background: var(--bg-surface); }
62
- .sig-concept h4 { font-size: .85rem; margin: 0 0 .4rem; color: var(--accent);
63
- text-transform: uppercase; letter-spacing: .04em; font-weight: 600; }
64
- .sig-concept p { font-size: .84rem; color: var(--text-muted); margin: 0; line-height: 1.5; }
65
- .sig-concept code { font-size: .8rem; color: var(--text); }
66
-
67
- @media (max-width: 768px) {
68
- .sig-lab { padding: 1rem; }
69
- .sig-row { gap: .5rem; }
70
- .sig-how { grid-template-columns: 1fr; }
71
- .sig-select-menu { left: auto; right: 0; }
72
- }
73
- @media (max-width: 480px) {
74
- .sig-lab { padding: .75rem; }
75
- .sig-op { gap: .3rem; }
76
- .sig-val { padding: .25rem .5rem; font-size: .82rem; }
77
- }
78
- `,
79
-
80
- state: () => ({
81
- greeting: '',
82
- sigA: 0,
83
- sigB: 0,
84
- sigOp: 'add',
85
- sigResult: 0,
86
- sigHistory: [],
87
- opOpen: false,
88
- }),
89
-
90
- mounted() {
91
- // $.signal() + $.computed() + $.effect() wired together
92
- this._sigA = $.signal(3);
93
- this._sigB = $.signal(5);
94
- this._op = $.signal('add');
95
-
96
- this._result = $.computed(() => {
97
- const a = this._sigA.value, b = this._sigB.value;
98
- switch (this._op.value) {
99
- case 'add': return a + b;
100
- case 'subtract': return a - b;
101
- case 'multiply': return a * b;
102
- case 'divide': return b !== 0 ? +(a / b).toFixed(4) : 'Infinity';
103
- case 'power': return Math.pow(a, b);
104
- case 'modulo': return b !== 0 ? a % b : 'NaN';
105
- default: return 0;
106
- }
107
- });
108
-
109
- $.effect(() => {
110
- const val = typeof this._result.value === 'number' ? this._result.value : 0;
111
- this.state.sigA = this._sigA.value;
112
- this.state.sigB = this._sigB.value;
113
- this.state.sigOp = this._op.value;
114
- this.state.sigResult = this._result.value;
115
- const raw = this.state.sigHistory.__raw || this.state.sigHistory;
116
- this.state.sigHistory = [...raw, Math.abs(val)].slice(-20);
117
- });
118
-
119
- const hour = new Date().getHours();
120
- this.state.greeting = hour < 12 ? 'Good morning'
121
- : hour < 18 ? 'Good afternoon'
122
- : 'Good evening';
123
-
124
- // Visits are tracked globally via router.afterEach in app.js
125
- },
126
-
127
- updateA(e) { this._sigA.value = Number(e.target.value) || 0; },
128
- updateB(e) { this._sigB.value = Number(e.target.value) || 0; },
129
- updateOp(e) { this._op.value = e.target.value; },
130
- bumpA(d) { this._sigA.value += d; },
131
- bumpB(d) { this._sigB.value += d; },
132
- toggleOp() { this.state.opOpen = !this.state.opOpen; },
133
- closeOp() { this.state.opOpen = false; },
134
- pickOp(op) { this._op.value = op; this.state.opOpen = false; },
135
-
136
- render() {
137
- const store = $.getStore('main');
138
- const s = this.state;
139
- const opLabels = { add: '+', subtract: '-', multiply: '×', divide: '÷', power: '^', modulo: '%' };
140
- const maxH = Math.max(1, ...s.sigHistory.map(v => Math.sqrt(Math.abs(v) + 1)));
141
- return `
142
- <div class="page-header">
143
- <h1>${s.greeting}</h1>
144
- <p class="subtitle">Welcome to your new <strong>zQuery</strong> app. Explore the pages to see different features in action.</p>
145
- </div>
146
-
147
- <div class="card card-accent">
148
- <h3><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="var(--accent)" style="width:20px;height:20px;vertical-align:-4px;margin-right:0.25rem;"><path stroke-linecap="round" stroke-linejoin="round" d="m3.75 13.5 10.5-11.25L12 10.5h8.25L9.75 21.75 12 13.5H3.75Z"/></svg> Reactive Signals Lab</h3>
149
- <p style="margin-bottom:.65rem;">Signals are <strong>reactive primitives</strong> - values that automatically notify dependents when they change.
150
- Adjust <strong>A</strong> and <strong>B</strong> below and watch the computed result update instantly, with no manual DOM wiring.</p>
151
-
152
- <div class="sig-lab">
153
- <div class="sig-row">
154
- <div class="sig-op">
155
- <button class="btn btn-sm btn-ghost" @click="bumpA(-1)">-</button>
156
- <div class="sig-val"><small>A</small> <span>${s.sigA}</span></div>
157
- <button class="btn btn-sm btn-ghost" @click="bumpA(1)">+</button>
158
- </div>
159
- <div class="sig-select" @click.outside="closeOp">
160
- <button class="sig-select-trigger ${s.opOpen ? 'open' : ''}" @click="toggleOp">
161
- <span class="sig-select-symbol">${opLabels[s.sigOp] || '+'}</span> ${s.sigOp.charAt(0).toUpperCase() + s.sigOp.slice(1)}
162
- <span class="sig-select-arrow">▼</span>
163
- </button>
164
- <div class="sig-select-menu" z-show="opOpen">
165
- ${Object.entries(opLabels).map(([key, sym]) => `
166
- <div class="sig-select-item ${s.sigOp === key ? 'active' : ''}" @click="pickOp('${key}')">
167
- <span class="sig-select-symbol">${sym}</span> ${key.charAt(0).toUpperCase() + key.slice(1)}
168
- </div>
169
- `).join('')}
170
- </div>
171
- </div>
172
- <div class="sig-op">
173
- <button class="btn btn-sm btn-ghost" @click="bumpB(-1)">-</button>
174
- <div class="sig-val"><small>B</small> <span>${s.sigB}</span></div>
175
- <button class="btn btn-sm btn-ghost" @click="bumpB(1)">+</button>
176
- </div>
177
- <span style="font-size:1.1rem;color:var(--text-muted);">=</span>
178
- <div class="sig-val" style="background:rgba(88,166,255,.14);"><span style="font-size:1.05rem;">${s.sigResult}</span></div>
179
- </div>
180
-
181
- <div style="font-size:.82rem;color:var(--text-muted);margin-bottom:.4rem;">
182
- <code>$.computed(() => ${s.sigA} ${opLabels[s.sigOp] || '+'} ${s.sigB})</code> → <strong style="color:var(--accent);">${s.sigResult}</strong>
183
- </div>
184
-
185
- ${s.sigHistory.length > 1 ? `
186
- <div class="sig-graph">
187
- ${s.sigHistory.map(v => `<div class="sig-bar" style="height:${Math.max(6, (Math.sqrt(Math.abs(v) + 1) / maxH) * 56)}px;"></div>`).join('')}
188
- </div>
189
- <div style="font-size:.75rem;color:var(--text-muted);margin-top:.35rem;">Result history - ${s.sigHistory.length} values tracked by <code>effect()</code></div>
190
- ` : ''}
191
- </div>
192
-
193
- <div class="sig-how">
194
- <div class="sig-concept">
195
- <h4>Signal</h4>
196
- <p>A reactive value container. When you write <code>$.signal(3)</code> you get an object whose <code>.value</code> automatically triggers updates when changed.</p>
197
- </div>
198
- <div class="sig-concept">
199
- <h4>Computed</h4>
200
- <p>A derived value that re-evaluates when its dependencies change. <code>$.computed(() => A + B)</code> recalculates whenever A or B updates - no manual calls.</p>
201
- </div>
202
- <div class="sig-concept">
203
- <h4>Effect</h4>
204
- <p>A side-effect that runs automatically when tracked signals change. The bar chart above is powered by <code>$.effect()</code> - it records every new result.</p>
205
- </div>
206
- </div>
207
- </div>
208
-
209
- <div class="card-grid">
210
- <div class="card">
211
- <h3><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="var(--accent)" style="width:20px;height:20px;vertical-align:-4px;margin-right:0.25rem;"><path stroke-linecap="round" stroke-linejoin="round" d="M5.25 8.25h15m-16.5 7.5h15m-1.8-13.5-3.9 19.5m-2.1-19.5-3.9 19.5"/></svg> Counter</h3>
212
- <p><code>computed</code> properties, <code>watch</code> callbacks, and <code>z-for</code> with <code>z-key</code> diffing.</p>
213
- <a z-link="/counter" class="btn btn-outline">Try It →</a>
214
- </div>
215
-
216
- <div class="card">
217
- <h3><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="var(--accent)" style="width:20px;height:20px;vertical-align:-4px;margin-right:0.25rem;"><path stroke-linecap="round" stroke-linejoin="round" d="M9 12.75 11.25 15 15 9.75M21 12a9 9 0 1 1-18 0 9 9 0 0 1 18 0Z"/></svg> Todos</h3>
218
- <p>Global store, <code>z-key</code> keyed lists, DOM diffing. <strong>${store.getters.todoCount}</strong> items, <strong>${store.getters.doneCount}</strong> done.</p>
219
- <a z-link="/todos" class="btn btn-outline">Try It →</a>
220
- </div>
221
-
222
- <div class="card">
223
- <h3><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="var(--accent)" style="width:20px;height:20px;vertical-align:-4px;margin-right:0.25rem;"><path stroke-linecap="round" stroke-linejoin="round" d="M15 9h3.75M15 12h3.75M15 15h3.75M4.5 19.5h15a2.25 2.25 0 0 0 2.25-2.25V6.75A2.25 2.25 0 0 0 19.5 4.5h-15a2.25 2.25 0 0 0-2.25 2.25v10.5A2.25 2.25 0 0 0 4.5 19.5Zm6-10.125a1.875 1.875 0 1 1-3.75 0 1.875 1.875 0 0 1 3.75 0Zm1.294 6.336a6.721 6.721 0 0 1-3.17.789 6.721 6.721 0 0 1-3.168-.789 3.376 3.376 0 0 1 6.338 0Z"/></svg> Contacts</h3>
224
- <p>External templates, scoped styles, and <code>z-key</code> keyed lists. <strong>${store.getters.contactCount}</strong> contacts, <strong>${store.getters.favoriteCount}</strong> ★ favorited.</p>
225
- <a z-link="/contacts" class="btn btn-outline">Try It →</a>
226
- </div>
227
-
228
- <div class="card">
229
- <h3><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="var(--accent)" style="width:20px;height:20px;vertical-align:-4px;margin-right:0.25rem;"><path stroke-linecap="round" stroke-linejoin="round" d="M12 21a9.004 9.004 0 0 0 8.716-6.747M12 21a9.004 9.004 0 0 1-8.716-6.747M12 21c2.485 0 4.5-4.03 4.5-9S14.485 3 12 3m0 18c-2.485 0-4.5-4.03-4.5-9S9.515 3 12 3m0 0a8.997 8.997 0 0 1 7.843 4.582M12 3a8.997 8.997 0 0 0-7.843 4.582m15.686 0A11.953 11.953 0 0 1 12 10.5c-2.998 0-5.74-1.1-7.843-2.918m15.686 0A8.959 8.959 0 0 1 21 12c0 .778-.099 1.533-.284 2.253m0 0A17.919 17.919 0 0 1 12 16.5c-3.162 0-6.133-.815-8.716-2.247m0 0A9.015 9.015 0 0 1 3 12c0-1.605.42-3.113 1.157-4.418"/></svg> API Demo</h3>
230
- <p>Fetch data with <code>$.get()</code>, loading states, and <code>$.escapeHtml()</code>.</p>
231
- <a z-link="/api" class="btn btn-outline">Try It →</a>
232
- </div>
233
-
234
- <div class="card">
235
- <h3><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="var(--accent)" style="width:20px;height:20px;vertical-align:-4px;margin-right:0.25rem;"><path stroke-linecap="round" stroke-linejoin="round" d="m21 7.5-9-5.25L3 7.5m18 0-9 5.25m9-5.25v9l-9 5.25M3 7.5l9 5.25M3 7.5v9l9 5.25m0-9v9"/></svg> Playground</h3>
236
- <p><code>@click.outside</code> dropdowns, <code>fadeIn/fadeOut</code> modals, <code>slideToggle</code>, <code>z-style</code>, and <code>$.fn</code> plugins.</p>
237
- <a z-link="/playground" class="btn btn-outline">Try It →</a>
238
- </div>
239
-
240
- <div class="card">
241
- <h3><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="var(--accent)" style="width:20px;height:20px;vertical-align:-4px;margin-right:0.25rem;"><path stroke-linecap="round" stroke-linejoin="round" d="M21.75 6.75a4.5 4.5 0 0 1-4.884 4.484c-1.076-.091-2.264.071-2.95.904l-7.152 8.684a2.548 2.548 0 1 1-3.586-3.586l8.684-7.152c.833-.686.995-1.874.904-2.95a4.5 4.5 0 0 1 6.336-4.486l-3.276 3.276a3.004 3.004 0 0 0 2.25 2.25l3.276-3.276c.256.565.398 1.192.398 1.852Z"/></svg> Toolkit</h3>
242
- <p>HTTP interceptors &amp; CRUD, <code>$.pipe</code>, <code>$.memoize</code>, <code>$.retry</code>, store middleware, and snapshots.</p>
243
- <a z-link="/toolkit" class="btn btn-outline">Try It →</a>
244
- </div>
245
- </div>
246
-
247
- `;
248
- }
249
- });
1
+ // home.js - Landing page / dashboard
2
+ //
3
+ // Features used:
4
+ // $.component - define a component with state + render
5
+ // $.signal - reactive value container
6
+ // $.computed - derived reactive value
7
+ // $.effect - side-effect that auto-tracks signals
8
+ // $.getStore - access the global store
9
+
10
+ $.component('home-page', {
11
+ styles: `
12
+ .sig-lab { padding: 1.5rem 2rem; border-radius: var(--radius-lg);
13
+ background: var(--bg-hover); border: 1px solid var(--border); }
14
+ .sig-row { display: flex; gap: 1.25rem; align-items: center; flex-wrap: wrap;
15
+ margin-bottom: 1rem; }
16
+ .sig-val { display: inline-flex; align-items: center; gap: .4rem;
17
+ padding: .4rem .85rem; border-radius: var(--radius);
18
+ background: rgba(88,166,255,.08); border: 1px solid rgba(88,166,255,.15);
19
+ font-family: monospace; font-size: 1rem; font-weight: 600; }
20
+ .sig-val span { color: var(--accent); }
21
+ .sig-val small { color: var(--text-muted); font-weight: 400; font-size: .85rem; }
22
+ .sig-op { display: flex; align-items: center; gap: .5rem; flex-wrap: wrap; }
23
+ .sig-graph { display: flex; gap: 3px; align-items: flex-end; height: 56px;
24
+ margin-top: .75rem; }
25
+ .sig-bar { flex: 1; min-width: 4px; max-width: 24px;
26
+ background: var(--accent); border-radius: 3px 3px 0 0;
27
+ opacity: .65; transition: height .15s ease; }
28
+
29
+ /* Custom dropdown for operation picker */
30
+ .sig-select { position: relative; z-index: 2; }
31
+ .sig-select-trigger {
32
+ display: inline-flex; align-items: center; gap: .4rem;
33
+ padding: .4rem .85rem; border-radius: var(--radius);
34
+ background: var(--bg-surface); border: 1px solid var(--border);
35
+ color: var(--text); font-size: .9rem; font-family: inherit;
36
+ cursor: pointer; transition: all .15s ease; user-select: none; }
37
+ .sig-select-trigger:hover { border-color: var(--accent); background: var(--accent-soft); }
38
+ .sig-select-trigger.open { border-color: var(--accent); box-shadow: 0 0 0 2px rgba(88,166,255,.1); }
39
+ .sig-select-trigger .sig-select-arrow {
40
+ font-size: .65rem; color: var(--text-muted); transition: transform .15s ease;
41
+ margin-left: .15rem; }
42
+ .sig-select-trigger.open .sig-select-arrow { transform: rotate(180deg); }
43
+ .sig-select-menu {
44
+ position: absolute; top: calc(100% + 4px); left: 0; min-width: 160px;
45
+ background: var(--bg-surface); border: 1px solid var(--border);
46
+ border-radius: var(--radius); padding: .3rem;
47
+ box-shadow: 0 8px 24px rgba(0,0,0,.25); z-index: 50; }
48
+ .sig-select-item {
49
+ display: flex; align-items: center; gap: .5rem;
50
+ padding: .4rem .65rem; border-radius: calc(var(--radius) - 2px);
51
+ font-size: .84rem; cursor: pointer; color: var(--text);
52
+ transition: all .1s ease; }
53
+ .sig-select-item:hover { background: var(--bg-hover); }
54
+ .sig-select-item.active { background: var(--accent-soft); color: var(--accent); font-weight: 600; }
55
+ .sig-select-item .sig-select-symbol {
56
+ width: 1.4rem; text-align: center; font-weight: 600; font-size: .9rem; }
57
+
58
+ .sig-how { display: grid; grid-template-columns: repeat(3, 1fr);
59
+ gap: 1rem; margin-top: 1.25rem; }
60
+ .sig-concept { padding: 1rem 1.1rem; border-radius: var(--radius);
61
+ border: 1px solid var(--border); background: var(--bg-surface); }
62
+ .sig-concept h4 { font-size: .85rem; margin: 0 0 .4rem; color: var(--accent);
63
+ text-transform: uppercase; letter-spacing: .04em; font-weight: 600; }
64
+ .sig-concept p { font-size: .84rem; color: var(--text-muted); margin: 0; line-height: 1.5; }
65
+ .sig-concept code { font-size: .8rem; color: var(--text); }
66
+
67
+ @media (max-width: 768px) {
68
+ .sig-lab { padding: 1rem; }
69
+ .sig-row { gap: .5rem; }
70
+ .sig-how { grid-template-columns: 1fr; }
71
+ .sig-select-menu { left: auto; right: 0; }
72
+ }
73
+ @media (max-width: 480px) {
74
+ .sig-lab { padding: .75rem; }
75
+ .sig-op { gap: .3rem; }
76
+ .sig-val { padding: .25rem .5rem; font-size: .82rem; }
77
+ }
78
+ `,
79
+
80
+ state: () => ({
81
+ greeting: '',
82
+ sigA: 0,
83
+ sigB: 0,
84
+ sigOp: 'add',
85
+ sigResult: 0,
86
+ sigHistory: [],
87
+ opOpen: false,
88
+ }),
89
+
90
+ mounted() {
91
+ // $.signal() + $.computed() + $.effect() wired together
92
+ this._sigA = $.signal(3);
93
+ this._sigB = $.signal(5);
94
+ this._op = $.signal('add');
95
+
96
+ this._result = $.computed(() => {
97
+ const a = this._sigA.value, b = this._sigB.value;
98
+ switch (this._op.value) {
99
+ case 'add': return a + b;
100
+ case 'subtract': return a - b;
101
+ case 'multiply': return a * b;
102
+ case 'divide': return b !== 0 ? +(a / b).toFixed(4) : 'Infinity';
103
+ case 'power': return Math.pow(a, b);
104
+ case 'modulo': return b !== 0 ? a % b : 'NaN';
105
+ default: return 0;
106
+ }
107
+ });
108
+
109
+ $.effect(() => {
110
+ const val = typeof this._result.value === 'number' ? this._result.value : 0;
111
+ this.state.sigA = this._sigA.value;
112
+ this.state.sigB = this._sigB.value;
113
+ this.state.sigOp = this._op.value;
114
+ this.state.sigResult = this._result.value;
115
+ const raw = this.state.sigHistory.__raw || this.state.sigHistory;
116
+ this.state.sigHistory = [...raw, Math.abs(val)].slice(-20);
117
+ });
118
+
119
+ const hour = new Date().getHours();
120
+ this.state.greeting = hour < 12 ? 'Good morning'
121
+ : hour < 18 ? 'Good afternoon'
122
+ : 'Good evening';
123
+
124
+ // Visits are tracked globally via router.afterEach in app.js
125
+ },
126
+
127
+ updateA(e) { this._sigA.value = Number(e.target.value) || 0; },
128
+ updateB(e) { this._sigB.value = Number(e.target.value) || 0; },
129
+ updateOp(e) { this._op.value = e.target.value; },
130
+ bumpA(d) { this._sigA.value += d; },
131
+ bumpB(d) { this._sigB.value += d; },
132
+ toggleOp() { this.state.opOpen = !this.state.opOpen; },
133
+ closeOp() { this.state.opOpen = false; },
134
+ pickOp(op) { this._op.value = op; this.state.opOpen = false; },
135
+
136
+ render() {
137
+ const store = $.getStore('main');
138
+ const s = this.state;
139
+ const opLabels = { add: '+', subtract: '-', multiply: '×', divide: '÷', power: '^', modulo: '%' };
140
+ const maxH = Math.max(1, ...s.sigHistory.map(v => Math.sqrt(Math.abs(v) + 1)));
141
+ return `
142
+ <div class="page-header">
143
+ <h1>${s.greeting}</h1>
144
+ <p class="subtitle">Welcome to your new <strong>zQuery</strong> app. Explore the pages to see different features in action.</p>
145
+ </div>
146
+
147
+ <div class="card card-accent">
148
+ <h3><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="var(--accent)" style="width:20px;height:20px;vertical-align:-4px;margin-right:0.25rem;"><path stroke-linecap="round" stroke-linejoin="round" d="m3.75 13.5 10.5-11.25L12 10.5h8.25L9.75 21.75 12 13.5H3.75Z"/></svg> Reactive Signals Lab</h3>
149
+ <p style="margin-bottom:.65rem;">Signals are <strong>reactive primitives</strong> - values that automatically notify dependents when they change.
150
+ Adjust <strong>A</strong> and <strong>B</strong> below and watch the computed result update instantly, with no manual DOM wiring.</p>
151
+
152
+ <div class="sig-lab">
153
+ <div class="sig-row">
154
+ <div class="sig-op">
155
+ <button class="btn btn-sm btn-ghost" @click="bumpA(-1)">-</button>
156
+ <div class="sig-val"><small>A</small> <span>${s.sigA}</span></div>
157
+ <button class="btn btn-sm btn-ghost" @click="bumpA(1)">+</button>
158
+ </div>
159
+ <div class="sig-select" @click.outside="closeOp">
160
+ <button class="sig-select-trigger ${s.opOpen ? 'open' : ''}" @click="toggleOp">
161
+ <span class="sig-select-symbol">${opLabels[s.sigOp] || '+'}</span> ${s.sigOp.charAt(0).toUpperCase() + s.sigOp.slice(1)}
162
+ <span class="sig-select-arrow">▼</span>
163
+ </button>
164
+ <div class="sig-select-menu" z-show="opOpen">
165
+ ${Object.entries(opLabels).map(([key, sym]) => `
166
+ <div class="sig-select-item ${s.sigOp === key ? 'active' : ''}" @click="pickOp('${key}')">
167
+ <span class="sig-select-symbol">${sym}</span> ${key.charAt(0).toUpperCase() + key.slice(1)}
168
+ </div>
169
+ `).join('')}
170
+ </div>
171
+ </div>
172
+ <div class="sig-op">
173
+ <button class="btn btn-sm btn-ghost" @click="bumpB(-1)">-</button>
174
+ <div class="sig-val"><small>B</small> <span>${s.sigB}</span></div>
175
+ <button class="btn btn-sm btn-ghost" @click="bumpB(1)">+</button>
176
+ </div>
177
+ <span style="font-size:1.1rem;color:var(--text-muted);">=</span>
178
+ <div class="sig-val" style="background:rgba(88,166,255,.14);"><span style="font-size:1.05rem;">${s.sigResult}</span></div>
179
+ </div>
180
+
181
+ <div style="font-size:.82rem;color:var(--text-muted);margin-bottom:.4rem;">
182
+ <code>$.computed(() => ${s.sigA} ${opLabels[s.sigOp] || '+'} ${s.sigB})</code> → <strong style="color:var(--accent);">${s.sigResult}</strong>
183
+ </div>
184
+
185
+ ${s.sigHistory.length > 1 ? `
186
+ <div class="sig-graph">
187
+ ${s.sigHistory.map(v => `<div class="sig-bar" style="height:${Math.max(6, (Math.sqrt(Math.abs(v) + 1) / maxH) * 56)}px;"></div>`).join('')}
188
+ </div>
189
+ <div style="font-size:.75rem;color:var(--text-muted);margin-top:.35rem;">Result history - ${s.sigHistory.length} values tracked by <code>effect()</code></div>
190
+ ` : ''}
191
+ </div>
192
+
193
+ <div class="sig-how">
194
+ <div class="sig-concept">
195
+ <h4>Signal</h4>
196
+ <p>A reactive value container. When you write <code>$.signal(3)</code> you get an object whose <code>.value</code> automatically triggers updates when changed.</p>
197
+ </div>
198
+ <div class="sig-concept">
199
+ <h4>Computed</h4>
200
+ <p>A derived value that re-evaluates when its dependencies change. <code>$.computed(() => A + B)</code> recalculates whenever A or B updates - no manual calls.</p>
201
+ </div>
202
+ <div class="sig-concept">
203
+ <h4>Effect</h4>
204
+ <p>A side-effect that runs automatically when tracked signals change. The bar chart above is powered by <code>$.effect()</code> - it records every new result.</p>
205
+ </div>
206
+ </div>
207
+ </div>
208
+
209
+ <div class="card-grid">
210
+ <div class="card">
211
+ <h3><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="var(--accent)" style="width:20px;height:20px;vertical-align:-4px;margin-right:0.25rem;"><path stroke-linecap="round" stroke-linejoin="round" d="M5.25 8.25h15m-16.5 7.5h15m-1.8-13.5-3.9 19.5m-2.1-19.5-3.9 19.5"/></svg> Counter</h3>
212
+ <p><code>computed</code> properties, <code>watch</code> callbacks, and <code>z-for</code> with <code>z-key</code> diffing.</p>
213
+ <a z-link="/counter" class="btn btn-outline">Try It →</a>
214
+ </div>
215
+
216
+ <div class="card">
217
+ <h3><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="var(--accent)" style="width:20px;height:20px;vertical-align:-4px;margin-right:0.25rem;"><path stroke-linecap="round" stroke-linejoin="round" d="M9 12.75 11.25 15 15 9.75M21 12a9 9 0 1 1-18 0 9 9 0 0 1 18 0Z"/></svg> Todos</h3>
218
+ <p>Global store, <code>z-key</code> keyed lists, DOM diffing. <strong>${store.getters.todoCount}</strong> items, <strong>${store.getters.doneCount}</strong> done.</p>
219
+ <a z-link="/todos" class="btn btn-outline">Try It →</a>
220
+ </div>
221
+
222
+ <div class="card">
223
+ <h3><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="var(--accent)" style="width:20px;height:20px;vertical-align:-4px;margin-right:0.25rem;"><path stroke-linecap="round" stroke-linejoin="round" d="M15 9h3.75M15 12h3.75M15 15h3.75M4.5 19.5h15a2.25 2.25 0 0 0 2.25-2.25V6.75A2.25 2.25 0 0 0 19.5 4.5h-15a2.25 2.25 0 0 0-2.25 2.25v10.5A2.25 2.25 0 0 0 4.5 19.5Zm6-10.125a1.875 1.875 0 1 1-3.75 0 1.875 1.875 0 0 1 3.75 0Zm1.294 6.336a6.721 6.721 0 0 1-3.17.789 6.721 6.721 0 0 1-3.168-.789 3.376 3.376 0 0 1 6.338 0Z"/></svg> Contacts</h3>
224
+ <p>External templates, scoped styles, and <code>z-key</code> keyed lists. <strong>${store.getters.contactCount}</strong> contacts, <strong>${store.getters.favoriteCount}</strong> ★ favorited.</p>
225
+ <a z-link="/contacts" class="btn btn-outline">Try It →</a>
226
+ </div>
227
+
228
+ <div class="card">
229
+ <h3><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="var(--accent)" style="width:20px;height:20px;vertical-align:-4px;margin-right:0.25rem;"><path stroke-linecap="round" stroke-linejoin="round" d="M12 21a9.004 9.004 0 0 0 8.716-6.747M12 21a9.004 9.004 0 0 1-8.716-6.747M12 21c2.485 0 4.5-4.03 4.5-9S14.485 3 12 3m0 18c-2.485 0-4.5-4.03-4.5-9S9.515 3 12 3m0 0a8.997 8.997 0 0 1 7.843 4.582M12 3a8.997 8.997 0 0 0-7.843 4.582m15.686 0A11.953 11.953 0 0 1 12 10.5c-2.998 0-5.74-1.1-7.843-2.918m15.686 0A8.959 8.959 0 0 1 21 12c0 .778-.099 1.533-.284 2.253m0 0A17.919 17.919 0 0 1 12 16.5c-3.162 0-6.133-.815-8.716-2.247m0 0A9.015 9.015 0 0 1 3 12c0-1.605.42-3.113 1.157-4.418"/></svg> API Demo</h3>
230
+ <p>Fetch data with <code>$.get()</code>, loading states, and <code>$.escapeHtml()</code>.</p>
231
+ <a z-link="/api" class="btn btn-outline">Try It →</a>
232
+ </div>
233
+
234
+ <div class="card">
235
+ <h3><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="var(--accent)" style="width:20px;height:20px;vertical-align:-4px;margin-right:0.25rem;"><path stroke-linecap="round" stroke-linejoin="round" d="m21 7.5-9-5.25L3 7.5m18 0-9 5.25m9-5.25v9l-9 5.25M3 7.5l9 5.25M3 7.5v9l9 5.25m0-9v9"/></svg> Playground</h3>
236
+ <p><code>@click.outside</code> dropdowns, <code>fadeIn/fadeOut</code> modals, <code>slideToggle</code>, <code>z-style</code>, and <code>$.fn</code> plugins.</p>
237
+ <a z-link="/playground" class="btn btn-outline">Try It →</a>
238
+ </div>
239
+
240
+ <div class="card">
241
+ <h3><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="var(--accent)" style="width:20px;height:20px;vertical-align:-4px;margin-right:0.25rem;"><path stroke-linecap="round" stroke-linejoin="round" d="M21.75 6.75a4.5 4.5 0 0 1-4.884 4.484c-1.076-.091-2.264.071-2.95.904l-7.152 8.684a2.548 2.548 0 1 1-3.586-3.586l8.684-7.152c.833-.686.995-1.874.904-2.95a4.5 4.5 0 0 1 6.336-4.486l-3.276 3.276a3.004 3.004 0 0 0 2.25 2.25l3.276-3.276c.256.565.398 1.192.398 1.852Z"/></svg> Toolkit</h3>
242
+ <p>HTTP interceptors &amp; CRUD, <code>$.pipe</code>, <code>$.memoize</code>, <code>$.retry</code>, store middleware, and snapshots.</p>
243
+ <a z-link="/toolkit" class="btn btn-outline">Try It →</a>
244
+ </div>
245
+ </div>
246
+
247
+ `;
248
+ }
249
+ });
@@ -1,16 +1,16 @@
1
- // not-found.js - 404 fallback page
2
- //
3
- // Uses $.getRouter() to display the unmatched path.
4
-
5
- $.component('not-found', {
6
- render() {
7
- const router = $.getRouter();
8
- return `
9
- <div class="page-header center">
10
- <h1>404</h1>
11
- <p class="subtitle">The page <code>${$.escapeHtml(router.current?.path || '')}</code> was not found.</p>
12
- <a z-link="/" class="btn btn-primary">← Go Home</a>
13
- </div>
14
- `;
15
- }
16
- });
1
+ // not-found.js - 404 fallback page
2
+ //
3
+ // Uses $.getRouter() to display the unmatched path.
4
+
5
+ $.component('not-found', {
6
+ render() {
7
+ const router = $.getRouter();
8
+ return `
9
+ <div class="page-header center">
10
+ <h1>404</h1>
11
+ <p class="subtitle">The page <code>${$.escapeHtml(router.current?.path || '')}</code> was not found.</p>
12
+ <a z-link="/" class="btn btn-primary">← Go Home</a>
13
+ </div>
14
+ `;
15
+ }
16
+ });