@oddkin/workbench 0.0.0-stage → 1.0.0-beta.1

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 (243) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +66 -2
  3. package/dist/app/card-previews.d.ts +14 -0
  4. package/dist/app/card-previews.d.ts.map +1 -0
  5. package/dist/app/card-previews.js +140 -0
  6. package/dist/app/card-previews.js.map +1 -0
  7. package/dist/app/copy.d.ts +48 -0
  8. package/dist/app/copy.d.ts.map +1 -0
  9. package/dist/app/copy.js +52 -0
  10. package/dist/app/copy.js.map +1 -0
  11. package/dist/app/define.d.ts +3 -0
  12. package/dist/app/define.d.ts.map +1 -0
  13. package/dist/app/define.js +10 -0
  14. package/dist/app/define.js.map +1 -0
  15. package/dist/app/details.d.ts +22 -0
  16. package/dist/app/details.d.ts.map +1 -0
  17. package/dist/app/details.js +17 -0
  18. package/dist/app/details.js.map +1 -0
  19. package/dist/app/index.d.ts +12 -0
  20. package/dist/app/index.d.ts.map +1 -0
  21. package/dist/app/index.js +9 -0
  22. package/dist/app/index.js.map +1 -0
  23. package/dist/app/routes.d.ts +26 -0
  24. package/dist/app/routes.d.ts.map +1 -0
  25. package/dist/app/routes.js +96 -0
  26. package/dist/app/routes.js.map +1 -0
  27. package/dist/app/search.d.ts +17 -0
  28. package/dist/app/search.d.ts.map +1 -0
  29. package/dist/app/search.js +52 -0
  30. package/dist/app/search.js.map +1 -0
  31. package/dist/app/shell.d.ts +29 -0
  32. package/dist/app/shell.d.ts.map +1 -0
  33. package/dist/app/shell.js +478 -0
  34. package/dist/app/shell.js.map +1 -0
  35. package/dist/app/styles.d.ts +2 -0
  36. package/dist/app/styles.d.ts.map +1 -0
  37. package/dist/app/styles.js +356 -0
  38. package/dist/app/styles.js.map +1 -0
  39. package/dist/app/theme-studio.d.ts +12 -0
  40. package/dist/app/theme-studio.d.ts.map +1 -0
  41. package/dist/app/theme-studio.js +14 -0
  42. package/dist/app/theme-studio.js.map +1 -0
  43. package/dist/app/views.d.ts +38 -0
  44. package/dist/app/views.d.ts.map +1 -0
  45. package/dist/app/views.js +252 -0
  46. package/dist/app/views.js.map +1 -0
  47. package/dist/config/index.d.ts +170 -0
  48. package/dist/config/index.d.ts.map +1 -0
  49. package/dist/config/index.js +148 -0
  50. package/dist/config/index.js.map +1 -0
  51. package/dist/conformance/button.d.ts +2 -0
  52. package/dist/conformance/button.d.ts.map +1 -0
  53. package/dist/conformance/button.js +233 -0
  54. package/dist/conformance/button.js.map +1 -0
  55. package/dist/conformance/index.d.ts +107 -0
  56. package/dist/conformance/index.d.ts.map +1 -0
  57. package/dist/conformance/index.js +60 -0
  58. package/dist/conformance/index.js.map +1 -0
  59. package/dist/data/build.d.ts +36 -0
  60. package/dist/data/build.d.ts.map +1 -0
  61. package/dist/data/build.js +260 -0
  62. package/dist/data/build.js.map +1 -0
  63. package/dist/data/import-map.d.ts +59 -0
  64. package/dist/data/import-map.d.ts.map +1 -0
  65. package/dist/data/import-map.js +195 -0
  66. package/dist/data/import-map.js.map +1 -0
  67. package/dist/data/index.d.ts +14 -0
  68. package/dist/data/index.d.ts.map +1 -0
  69. package/dist/data/index.js +10 -0
  70. package/dist/data/index.js.map +1 -0
  71. package/dist/data/theme-studio.d.ts +21 -0
  72. package/dist/data/theme-studio.d.ts.map +1 -0
  73. package/dist/data/theme-studio.js +112 -0
  74. package/dist/data/theme-studio.js.map +1 -0
  75. package/dist/data/types.d.ts +187 -0
  76. package/dist/data/types.d.ts.map +1 -0
  77. package/dist/data/types.js +4 -0
  78. package/dist/data/types.js.map +1 -0
  79. package/dist/examples/index.d.ts +101 -0
  80. package/dist/examples/index.d.ts.map +1 -0
  81. package/dist/examples/index.js +106 -0
  82. package/dist/examples/index.js.map +1 -0
  83. package/dist/frame/index.d.ts +9 -0
  84. package/dist/frame/index.d.ts.map +1 -0
  85. package/dist/frame/index.js +482 -0
  86. package/dist/frame/index.js.map +1 -0
  87. package/dist/internal/diagnostics.d.ts +17 -0
  88. package/dist/internal/diagnostics.d.ts.map +1 -0
  89. package/dist/internal/diagnostics.js +19 -0
  90. package/dist/internal/diagnostics.js.map +1 -0
  91. package/dist/node/bin.d.ts +3 -0
  92. package/dist/node/bin.d.ts.map +1 -0
  93. package/dist/node/bin.js +12 -0
  94. package/dist/node/bin.js.map +1 -0
  95. package/dist/node/cli.d.ts +17 -0
  96. package/dist/node/cli.d.ts.map +1 -0
  97. package/dist/node/cli.js +198 -0
  98. package/dist/node/cli.js.map +1 -0
  99. package/dist/node/config.d.ts +28 -0
  100. package/dist/node/config.d.ts.map +1 -0
  101. package/dist/node/config.js +80 -0
  102. package/dist/node/config.js.map +1 -0
  103. package/dist/node/example-modules.d.ts +8 -0
  104. package/dist/node/example-modules.d.ts.map +1 -0
  105. package/dist/node/example-modules.js +28 -0
  106. package/dist/node/example-modules.js.map +1 -0
  107. package/dist/node/generated.d.ts +19 -0
  108. package/dist/node/generated.d.ts.map +1 -0
  109. package/dist/node/generated.js +109 -0
  110. package/dist/node/generated.js.map +1 -0
  111. package/dist/node/html.d.ts +35 -0
  112. package/dist/node/html.d.ts.map +1 -0
  113. package/dist/node/html.js +51 -0
  114. package/dist/node/html.js.map +1 -0
  115. package/dist/node/index.d.ts +24 -0
  116. package/dist/node/index.d.ts.map +1 -0
  117. package/dist/node/index.js +15 -0
  118. package/dist/node/index.js.map +1 -0
  119. package/dist/node/inputs.d.ts +26 -0
  120. package/dist/node/inputs.d.ts.map +1 -0
  121. package/dist/node/inputs.js +282 -0
  122. package/dist/node/inputs.js.map +1 -0
  123. package/dist/node/packages.d.ts +35 -0
  124. package/dist/node/packages.d.ts.map +1 -0
  125. package/dist/node/packages.js +87 -0
  126. package/dist/node/packages.js.map +1 -0
  127. package/dist/node/preload.d.ts +10 -0
  128. package/dist/node/preload.d.ts.map +1 -0
  129. package/dist/node/preload.js +61 -0
  130. package/dist/node/preload.js.map +1 -0
  131. package/dist/node/server.d.ts +42 -0
  132. package/dist/node/server.d.ts.map +1 -0
  133. package/dist/node/server.js +410 -0
  134. package/dist/node/server.js.map +1 -0
  135. package/dist/node/static.d.ts +43 -0
  136. package/dist/node/static.d.ts.map +1 -0
  137. package/dist/node/static.js +157 -0
  138. package/dist/node/static.js.map +1 -0
  139. package/dist/node/workbench.d.ts +43 -0
  140. package/dist/node/workbench.d.ts.map +1 -0
  141. package/dist/node/workbench.js +204 -0
  142. package/dist/node/workbench.js.map +1 -0
  143. package/dist/pages/build.d.ts +22 -0
  144. package/dist/pages/build.d.ts.map +1 -0
  145. package/dist/pages/build.js +363 -0
  146. package/dist/pages/build.js.map +1 -0
  147. package/dist/pages/defaults.d.ts +16 -0
  148. package/dist/pages/defaults.d.ts.map +1 -0
  149. package/dist/pages/defaults.js +88 -0
  150. package/dist/pages/defaults.js.map +1 -0
  151. package/dist/pages/index.d.ts +14 -0
  152. package/dist/pages/index.d.ts.map +1 -0
  153. package/dist/pages/index.js +10 -0
  154. package/dist/pages/index.js.map +1 -0
  155. package/dist/pages/navigation.d.ts +48 -0
  156. package/dist/pages/navigation.d.ts.map +1 -0
  157. package/dist/pages/navigation.js +83 -0
  158. package/dist/pages/navigation.js.map +1 -0
  159. package/dist/pages/types.d.ts +148 -0
  160. package/dist/pages/types.d.ts.map +1 -0
  161. package/dist/pages/types.js +3 -0
  162. package/dist/pages/types.js.map +1 -0
  163. package/dist/panels/catalog-define.d.ts +3 -0
  164. package/dist/panels/catalog-define.d.ts.map +1 -0
  165. package/dist/panels/catalog-define.js +7 -0
  166. package/dist/panels/catalog-define.js.map +1 -0
  167. package/dist/panels/catalog-layout-styles.d.ts +2 -0
  168. package/dist/panels/catalog-layout-styles.d.ts.map +1 -0
  169. package/dist/panels/catalog-layout-styles.js +54 -0
  170. package/dist/panels/catalog-layout-styles.js.map +1 -0
  171. package/dist/panels/catalog-styles.d.ts +2 -0
  172. package/dist/panels/catalog-styles.d.ts.map +1 -0
  173. package/dist/panels/catalog-styles.js +106 -0
  174. package/dist/panels/catalog-styles.js.map +1 -0
  175. package/dist/panels/catalog.d.ts +37 -0
  176. package/dist/panels/catalog.d.ts.map +1 -0
  177. package/dist/panels/catalog.js +74 -0
  178. package/dist/panels/catalog.js.map +1 -0
  179. package/dist/panels/component-define.d.ts +3 -0
  180. package/dist/panels/component-define.d.ts.map +1 -0
  181. package/dist/panels/component-define.js +6 -0
  182. package/dist/panels/component-define.js.map +1 -0
  183. package/dist/panels/component-detail.d.ts +49 -0
  184. package/dist/panels/component-detail.d.ts.map +1 -0
  185. package/dist/panels/component-detail.js +1352 -0
  186. package/dist/panels/component-detail.js.map +1 -0
  187. package/dist/panels/component.d.ts +17 -0
  188. package/dist/panels/component.d.ts.map +1 -0
  189. package/dist/panels/component.js +10 -0
  190. package/dist/panels/component.js.map +1 -0
  191. package/dist/panels/example-styles.d.ts +2 -0
  192. package/dist/panels/example-styles.d.ts.map +1 -0
  193. package/dist/panels/example-styles.js +343 -0
  194. package/dist/panels/example-styles.js.map +1 -0
  195. package/dist/panels/foundation-define.d.ts +3 -0
  196. package/dist/panels/foundation-define.d.ts.map +1 -0
  197. package/dist/panels/foundation-define.js +6 -0
  198. package/dist/panels/foundation-define.js.map +1 -0
  199. package/dist/panels/foundation-detail.d.ts +23 -0
  200. package/dist/panels/foundation-detail.d.ts.map +1 -0
  201. package/dist/panels/foundation-detail.js +216 -0
  202. package/dist/panels/foundation-detail.js.map +1 -0
  203. package/dist/panels/foundation.d.ts +15 -0
  204. package/dist/panels/foundation.d.ts.map +1 -0
  205. package/dist/panels/foundation.js +9 -0
  206. package/dist/panels/foundation.js.map +1 -0
  207. package/dist/panels/model.d.ts +184 -0
  208. package/dist/panels/model.d.ts.map +1 -0
  209. package/dist/panels/model.js +488 -0
  210. package/dist/panels/model.js.map +1 -0
  211. package/dist/panels/styles.d.ts +3 -0
  212. package/dist/panels/styles.d.ts.map +1 -0
  213. package/dist/panels/styles.js +265 -0
  214. package/dist/panels/styles.js.map +1 -0
  215. package/dist/panels/theme-model.d.ts +69 -0
  216. package/dist/panels/theme-model.d.ts.map +1 -0
  217. package/dist/panels/theme-model.js +166 -0
  218. package/dist/panels/theme-model.js.map +1 -0
  219. package/dist/panels/theme-studio.d.ts +32 -0
  220. package/dist/panels/theme-studio.d.ts.map +1 -0
  221. package/dist/panels/theme-studio.js +375 -0
  222. package/dist/panels/theme-studio.js.map +1 -0
  223. package/dist/preview/frame.d.ts +44 -0
  224. package/dist/preview/frame.d.ts.map +1 -0
  225. package/dist/preview/frame.js +260 -0
  226. package/dist/preview/frame.js.map +1 -0
  227. package/dist/preview/index.d.ts +26 -0
  228. package/dist/preview/index.d.ts.map +1 -0
  229. package/dist/preview/index.js +58 -0
  230. package/dist/preview/index.js.map +1 -0
  231. package/dist/preview/theme-generation.d.ts +33 -0
  232. package/dist/preview/theme-generation.d.ts.map +1 -0
  233. package/dist/preview/theme-generation.js +48 -0
  234. package/dist/preview/theme-generation.js.map +1 -0
  235. package/dist/protocol/index.d.ts +222 -0
  236. package/dist/protocol/index.d.ts.map +1 -0
  237. package/dist/protocol/index.js +272 -0
  238. package/dist/protocol/index.js.map +1 -0
  239. package/dist/testing/index.d.ts +47 -0
  240. package/dist/testing/index.d.ts.map +1 -0
  241. package/dist/testing/index.js +145 -0
  242. package/dist/testing/index.js.map +1 -0
  243. package/package.json +118 -4
@@ -0,0 +1,375 @@
1
+ /**
2
+ * Theme Studio content (workbench.md §6, workbench-pages.md §8): one draft of the library's theme
3
+ * configuration, edited through a form and a JSON editor; generated in a Worker by the library's
4
+ * own generator; applied to light and dark specimen frames as a preview-owned stylesheet, so the
5
+ * real components update in place (no remount). An invalid draft keeps the last valid theme and
6
+ * lists the generator's diagnostics with their configuration paths.
7
+ */
8
+ import { OddkinElement, prop } from '@oddkin/core/element';
9
+ import { styleMap } from '@oddkin/core/helpers/style-map';
10
+ import { signal, untracked } from '@oddkin/core/reactive';
11
+ import { createScope } from '@oddkin/core/scope';
12
+ import { html, nothing, repeat } from '@oddkin/core/template';
13
+ import { createIsolatedPreview } from '../preview/frame.js';
14
+ import { createThemeGeneration, } from '../preview/theme-generation.js';
15
+ import { contentStyles, panelHostStyles } from './styles.js';
16
+ import { exportBlocked, exportNames, fieldValue, parseDraft, pathText, setPath, themeFields, } from './theme-model.js';
17
+ const MODES = ['light', 'dark'];
18
+ export class ThemeStudioElement extends OddkinElement.with({
19
+ page: prop.object({ description: 'The Theme Studio page data.' }),
20
+ frameUrl: prop.string({
21
+ default: '',
22
+ description: 'Same-origin URL of the generated preview frame document.',
23
+ }),
24
+ }) {
25
+ static styles = [panelHostStyles, contentStyles];
26
+ #draft = signal(undefined);
27
+ #json = signal('');
28
+ #jsonError = signal('');
29
+ #result = signal(undefined);
30
+ #status = signal({
31
+ text: '',
32
+ alert: false,
33
+ });
34
+ /** From a draft's request until its result: a delivered result is always the newest draft's. */
35
+ #pending = signal(false);
36
+ /** Why the generator cannot run, or ''. */
37
+ #unavailable = signal('');
38
+ #exported = signal('');
39
+ #hosts;
40
+ #previews = [];
41
+ #generation;
42
+ #studioScope;
43
+ #css;
44
+ #key;
45
+ constructor() {
46
+ super();
47
+ this.#hosts = [document.createElement('div'), document.createElement('div')];
48
+ }
49
+ /** The current draft (for tests and embedding); read-only snapshot. */
50
+ get draft() {
51
+ return this.#draft.peek();
52
+ }
53
+ /** Light and dark specimen frames, in that order. */
54
+ get previews() {
55
+ return this.#previews;
56
+ }
57
+ /** Generation counters: requests sent, superseded, and results applied. */
58
+ get generation() {
59
+ return this.#generation?.stats;
60
+ }
61
+ connected(scope) {
62
+ scope.effect(() => {
63
+ const page = this.page;
64
+ const frameUrl = this.frameUrl;
65
+ untracked(() => {
66
+ if (page === this.#key)
67
+ return;
68
+ this.#key = page;
69
+ this.#start(page, frameUrl);
70
+ });
71
+ });
72
+ scope.add(() => {
73
+ this.#key = undefined;
74
+ this.#stop();
75
+ });
76
+ }
77
+ #stop() {
78
+ this.#studioScope?.dispose();
79
+ this.#studioScope = undefined;
80
+ this.#previews = [];
81
+ this.#generation = undefined;
82
+ this.#css = undefined;
83
+ for (const host of this.#hosts)
84
+ host.replaceChildren();
85
+ }
86
+ #start(page, frameUrl) {
87
+ this.#stop();
88
+ const studio = page?.studio;
89
+ this.#draft.value = studio?.config;
90
+ this.#json.value = studio?.config ? JSON.stringify(studio.config, null, 2) : '';
91
+ this.#jsonError.value = '';
92
+ this.#result.value = undefined;
93
+ this.#status.value = { text: '', alert: false };
94
+ this.#pending.value = false;
95
+ this.#unavailable.value = '';
96
+ this.#exported.value = '';
97
+ if (!page || !studio?.config || !studio.worker)
98
+ return;
99
+ const scope = createScope({ name: 'workbench-theme-studio' });
100
+ this.#studioScope = scope;
101
+ this.#generation = createThemeGeneration(studio.worker, scope, (result) => this.#apply(result), (message) => {
102
+ this.#unavailable.value = message;
103
+ this.#status.value = { text: `Generation unavailable: ${message}`, alert: true };
104
+ });
105
+ if (frameUrl && studio.roles.length)
106
+ this.#specimens(scope, page, frameUrl);
107
+ this.#pending.value = true;
108
+ this.#generation.request(studio.config);
109
+ }
110
+ #specimens(scope, page, frameUrl) {
111
+ const items = page.studio.roles.map((role) => ({
112
+ role: role.role,
113
+ label: role.label,
114
+ tag: role.tag,
115
+ registration: role.registration,
116
+ example: role.example,
117
+ properties: role.properties,
118
+ attributes: role.attributes,
119
+ slots: role.slots,
120
+ }));
121
+ MODES.forEach((mode, i) => {
122
+ const preview = createIsolatedPreview({
123
+ document: this.ownerDocument,
124
+ container: this.#hosts[i],
125
+ frameUrl,
126
+ title: `Theme specimen (${mode})`,
127
+ });
128
+ preview.iframe.style.blockSize = '40rem';
129
+ scope.add(() => preview.dispose(), 'specimen frame');
130
+ this.#previews.push(preview);
131
+ void preview.ready
132
+ .then(() => preview.request('specimen', { items, settings: { mode } }))
133
+ .then(() => (this.#css === undefined ? undefined : this.#theme(preview, this.#css)))
134
+ .catch((error) => {
135
+ if (!scope.disposed)
136
+ this.#status.value = {
137
+ text: `Specimen unavailable: ${error instanceof Error ? error.message : String(error)}`,
138
+ alert: true,
139
+ };
140
+ });
141
+ });
142
+ }
143
+ #theme(preview, css) {
144
+ return preview.request('theme', { cssText: css });
145
+ }
146
+ /** A valid result replaces the specimens' theme sheet; an invalid one keeps the last valid. */
147
+ #apply(result) {
148
+ this.#pending.value = false;
149
+ this.#result.value = result;
150
+ if (!result.ok || result.css === undefined)
151
+ return;
152
+ this.#css = result.css;
153
+ for (const preview of this.#previews)
154
+ void this.#theme(preview, result.css).catch(() => {
155
+ // Not connected yet: the sheet is applied once its specimen has mounted.
156
+ });
157
+ }
158
+ #setDraft(draft, fromJson = false) {
159
+ this.#draft.value = draft;
160
+ if (!fromJson) {
161
+ this.#json.value = JSON.stringify(draft, null, 2);
162
+ this.#jsonError.value = '';
163
+ }
164
+ this.#exported.value = '';
165
+ if (this.#generation)
166
+ this.#pending.value = true;
167
+ this.#generation?.request(draft);
168
+ }
169
+ #blocked() {
170
+ return exportBlocked({
171
+ generator: !!this.page?.studio.worker,
172
+ jsonError: !!this.#jsonError.value,
173
+ unavailable: this.#unavailable.value,
174
+ pending: this.#pending.value,
175
+ ok: this.#result.value?.ok,
176
+ });
177
+ }
178
+ /** Download the draft shown: its configuration, or the CSS generated from it. */
179
+ #export(kind) {
180
+ const css = this.#result.peek()?.css;
181
+ if (this.#blocked() || css === undefined)
182
+ return;
183
+ const names = exportNames(this.page?.studio.source);
184
+ const [name, type, text] = kind === 'config'
185
+ ? [names.config, 'application/json', `${JSON.stringify(this.#draft.peek(), null, 2)}\n`]
186
+ : [names.css, 'text/css', css];
187
+ const doc = this.ownerDocument;
188
+ const link = doc.createElement('a');
189
+ link.href = URL.createObjectURL(new Blob([text], { type }));
190
+ link.download = name;
191
+ doc.body.append(link);
192
+ link.click();
193
+ link.remove();
194
+ setTimeout(() => URL.revokeObjectURL(link.href), 1000);
195
+ this.#exported.value = `Downloaded ${name}.`;
196
+ }
197
+ #exportSection(source) {
198
+ const blocked = this.#blocked();
199
+ const names = exportNames(source);
200
+ const button = (kind, name) => html `<button
201
+ type="button"
202
+ ?disabled=${!!blocked}
203
+ aria-describedby="ts-export-note"
204
+ @click=${() => this.#export(kind)}
205
+ >
206
+ Download ${name}
207
+ </button>`;
208
+ return html `<section id="export" aria-labelledby="export-title">
209
+ <h2 id="export-title">Export</h2>
210
+ <div class="wb-toolbar">${button('config', names.config)} ${button('css', names.css)}</div>
211
+ <p id="ts-export-note" class="wb-muted">
212
+ ${blocked || 'The draft shown: its configuration, and the CSS generated from it.'}
213
+ </p>
214
+ <p class="wb-status" role="status">${this.#exported.value}</p>
215
+ </section>`;
216
+ }
217
+ #field(field) {
218
+ const id = `ts-${field.path.join('-')}`;
219
+ const swatch = field.kind === 'color' &&
220
+ typeof field.value === 'string' &&
221
+ globalThis.CSS?.supports('color', field.value)
222
+ ? html `<span
223
+ class="wb-swatch"
224
+ aria-hidden="true"
225
+ style=${styleMap({ background: field.value })}
226
+ ></span>`
227
+ : nothing;
228
+ return html `<div class="wb-field">
229
+ <label for=${id}>${field.label}</label>
230
+ <span class="wb-cell-controls"
231
+ >${swatch}<input
232
+ id=${id}
233
+ type=${field.kind === 'number' || field.kind === 'integer' ? 'number' : 'text'}
234
+ step=${field.kind === 'integer' ? '1' : 'any'}
235
+ .value=${field.value === undefined ? '' : String(field.value)}
236
+ placeholder="Not set (generated)"
237
+ data-path=${pathText(field.path)}
238
+ aria-describedby=${`${id}-origin`}
239
+ @change=${(event) => this.#setDraft(setPath(this.#draft.peek(), field.path, fieldValue(field, event.target.value)))}
240
+ /></span>
241
+ <span id=${`${id}-origin`} class="wb-muted">${field.origin}</span>
242
+ </div>`;
243
+ }
244
+ render() {
245
+ const studio = this.page?.studio;
246
+ if (!studio)
247
+ return html `<div class="wb-content"></div>`;
248
+ const draft = this.#draft.value;
249
+ const result = this.#result.value;
250
+ const status = this.#status.value;
251
+ const groups = draft === undefined ? [] : themeFields(draft);
252
+ const problems = result?.diagnostics ?? [];
253
+ return html `<div class="wb-content">
254
+ <section id="generate" aria-labelledby="generate-title">
255
+ <h2 id="generate-title">Generate</h2>
256
+ ${studio.source
257
+ ? html `<p class="wb-muted">
258
+ Draft of <code>${studio.source}</code>. Edits stay in this page until exported.
259
+ </p>`
260
+ : nothing}
261
+ ${repeat(groups, (group) => group.id, (group) => html `<fieldset class="wb-group" data-group=${group.id}>
262
+ <legend>${group.title}</legend>
263
+ ${group.note ? html `<p class="wb-muted">${group.note}</p>` : nothing}
264
+ ${repeat(group.fields, (field) => pathText(field.path), (field) => this.#field(field))}
265
+ ${group.rows?.length
266
+ ? html `<div class="wb-table-wrap">
267
+ <table>
268
+ <caption class="wb-visually-hidden">
269
+ ${group.title}, one column per mode
270
+ </caption>
271
+ <thead>
272
+ <tr>
273
+ <th scope="col">Token</th>
274
+ ${(group.modes ?? []).map((mode) => html `<th scope="col">${mode}</th>`)}
275
+ </tr>
276
+ </thead>
277
+ <tbody>
278
+ ${repeat(group.rows, (row) => row.token, (row) => html `<tr>
279
+ <th scope="row"><code>${row.token}</code></th>
280
+ ${row.cells.map((cell) => html `<td>
281
+ <input
282
+ aria-label=${cell.label}
283
+ .value=${cell.value === undefined ? '' : String(cell.value)}
284
+ data-path=${pathText(cell.path)}
285
+ @change=${(event) => this.#setDraft(setPath(this.#draft.peek(), cell.path, fieldValue(cell, event.target.value)))}
286
+ />
287
+ </td>`)}
288
+ </tr>`)}
289
+ </tbody>
290
+ </table>
291
+ </div>`
292
+ : nothing}
293
+ </fieldset>`)}
294
+ ${draft === undefined
295
+ ? nothing
296
+ : html `<div class="wb-field wb-json">
297
+ <label for="ts-json">Configuration (JSON)</label>
298
+ <textarea
299
+ id="ts-json"
300
+ class="wb-code"
301
+ rows="16"
302
+ spellcheck="false"
303
+ aria-describedby="ts-json-error"
304
+ .value=${this.#json.value}
305
+ @input=${(event) => {
306
+ const text = event.target.value;
307
+ this.#json.value = text;
308
+ const parsed = parseDraft(text);
309
+ this.#jsonError.value = parsed.ok ? '' : (parsed.message ?? '');
310
+ if (parsed.ok)
311
+ this.#setDraft(parsed.value, true);
312
+ }}
313
+ ></textarea>
314
+ <p id="ts-json-error" class="wb-error" ?hidden=${!this.#jsonError.value}>
315
+ ${this.#jsonError.value
316
+ ? `Not applied: ${this.#jsonError.value} The preview keeps the last valid draft.`
317
+ : ''}
318
+ </p>
319
+ </div>`}
320
+ </section>
321
+ <section id="live-preview" aria-labelledby="live-preview-title">
322
+ <h2 id="live-preview-title">Live preview</h2>
323
+ <p class="wb-status" role=${status.alert || (result && !result.ok) ? 'alert' : 'status'}>
324
+ ${status.text ||
325
+ (result
326
+ ? result.ok
327
+ ? `Generated in ${Math.round(result.ms)} ms.`
328
+ : 'This draft is invalid: the preview keeps the last valid theme.'
329
+ : '')}
330
+ </p>
331
+ ${problems.length
332
+ ? html `<ul class="wb-list" aria-label="Generator diagnostics">
333
+ ${problems.map((d) => html `<li data-severity=${d.severity ?? 'error'}>
334
+ <code>${d.path || '/'}</code> ${d.message ?? d.code ?? ''}
335
+ </li>`)}
336
+ </ul>`
337
+ : nothing}
338
+ <div class="wb-previews wb-pair">
339
+ ${MODES.map((mode, i) => html `<div class="wb-preview">
340
+ <p>${mode === 'light' ? 'Light' : 'Dark'}</p>
341
+ ${this.#hosts[i]}
342
+ </div>`)}
343
+ </div>
344
+ ${studio.roles.length
345
+ ? html `<p class="wb-muted">
346
+ Roles:
347
+ ${studio.roles.map((r) => `${r.label} (<${r.tag}>, ${r.source === 'config' ? 'configured' : 'claimed by its example'})`).join(' · ')}.
348
+ </p>`
349
+ : nothing}
350
+ </section>
351
+ ${draft === undefined ? nothing : this.#exportSection(studio.source)}
352
+ <section id="method" aria-labelledby="method-title">
353
+ <h2 id="method-title">Method and limits</h2>
354
+ <p>
355
+ The draft is generated by the library's own theme generator in a Worker; the newest edit
356
+ wins and older results are discarded. Generated CSS replaces one stylesheet in each
357
+ specimen frame, so the components keep their state.
358
+ </p>
359
+ ${studio.missing.length
360
+ ? html `<ul class="wb-list" aria-label="Not available">
361
+ ${studio.missing.map((m) => html `<li class="wb-not-documented" data-missing=${m.item}>
362
+ ${m.item.startsWith('role:')
363
+ ? `No specimen for the ${m.item.slice(5)} role.`
364
+ : m.item === 'config'
365
+ ? 'No theme configuration to edit.'
366
+ : 'No theme generator.'}
367
+ Supplied by ${m.supply}.
368
+ </li>`)}
369
+ </ul>`
370
+ : nothing}
371
+ </section>
372
+ </div>`;
373
+ }
374
+ }
375
+ //# sourceMappingURL=theme-studio.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"theme-studio.js","sourceRoot":"","sources":["../../src/panels/theme-studio.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,44 @@
1
+ import { type FrameIdentity, type FrameNotification, type FrameRequest, type FrameRequestPayload, type JsonValue } from '../protocol/index.js';
2
+ declare const protocolStats: {
3
+ liveFrames: number;
4
+ rejectedMessages: number;
5
+ staleMessages: number;
6
+ disposedMessages: number;
7
+ };
8
+ /** Counts protocol rejections and live host frames; resource ownership is also measured by `scopeStats()`. */
9
+ export declare function previewProtocolStats(): Readonly<typeof protocolStats>;
10
+ export interface IsolatedPreviewOptions {
11
+ readonly document: Document;
12
+ readonly container: Element;
13
+ /** Same-origin URL of the generated frame document. */
14
+ readonly frameUrl: string;
15
+ readonly title: string;
16
+ readonly generation?: number;
17
+ /** How long the handshake and each request may wait for the frame (default 10 000 ms). */
18
+ readonly timeoutMs?: number;
19
+ /**
20
+ * How long a `mount` or `specimen` request may wait (default 60 000 ms). Both import component
21
+ * module graphs, which a cold, unbundled load can take seconds to fetch; a failed import is
22
+ * reported by the frame, so this only bounds a fetch that never settles.
23
+ */
24
+ readonly mountTimeoutMs?: number;
25
+ readonly onMessage?: (message: FrameNotification) => void;
26
+ }
27
+ export interface IsolatedPreview {
28
+ readonly iframe: HTMLIFrameElement;
29
+ readonly identity: FrameIdentity;
30
+ readonly ready: Promise<void>;
31
+ request(kind: FrameRequest['kind'], payload?: FrameRequestPayload): Promise<JsonValue | undefined>;
32
+ setViewport(width: number, height: number): void;
33
+ /** Replace the frame document and advance its generation. */
34
+ reload(): Promise<void>;
35
+ dispose(): void;
36
+ }
37
+ export declare class PreviewFrameError extends Error {
38
+ readonly code: string;
39
+ constructor(code: string, message: string);
40
+ }
41
+ /** Create one same-origin, independently registered preview frame. */
42
+ export declare function createIsolatedPreview(options: IsolatedPreviewOptions): IsolatedPreview;
43
+ export {};
44
+ //# sourceMappingURL=frame.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../../src/preview/frame.ts"],"names":[],"mappings":"AACA,OAAO,EAOL,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACf,MAAM,sBAAsB,CAAC;AAE9B,QAAA,MAAM,aAAa;IAAK,UAAU;IAAK,gBAAgB;IAAK,aAAa;IAAK,gBAAgB;CAAK,CAAC;AAOpG,8GAA8G;AAC9G,wBAAgB,oBAAoB,IAAI,QAAQ,CAAC,OAAO,aAAa,CAAC,CAErE;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,0FAA0F;IAC1F,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC3D;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,CACL,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,EAC1B,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IAClC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD,6DAA6D;IAC7D,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAExC,QAAQ,CAAC,IAAI,EAAE,MAAM;IADvB,YACW,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EAIhB;CACF;AAED,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAoRtF"}