claudecode-omc 5.9.1 → 5.11.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 (103) hide show
  1. package/.local/settings/settings.json +8 -0
  2. package/.omc-curation/governance.json +3 -0
  3. package/.omc-curation/sources.lock.json +5 -0
  4. package/README.md +10 -1
  5. package/bundled/manifest.json +2 -1
  6. package/bundled/upstream/impeccable/.omc-source/bundle.json +20 -0
  7. package/bundled/upstream/impeccable/.omc-source/provenance.json +105 -0
  8. package/bundled/upstream/impeccable/agents/impeccable-manual-edit-applier.md +97 -0
  9. package/bundled/upstream/impeccable/skills/impeccable/SKILL.md +168 -0
  10. package/bundled/upstream/impeccable/skills/impeccable/reference/adapt.md +311 -0
  11. package/bundled/upstream/impeccable/skills/impeccable/reference/animate.md +201 -0
  12. package/bundled/upstream/impeccable/skills/impeccable/reference/audit.md +133 -0
  13. package/bundled/upstream/impeccable/skills/impeccable/reference/bolder.md +113 -0
  14. package/bundled/upstream/impeccable/skills/impeccable/reference/brand.md +108 -0
  15. package/bundled/upstream/impeccable/skills/impeccable/reference/clarify.md +288 -0
  16. package/bundled/upstream/impeccable/skills/impeccable/reference/codex.md +105 -0
  17. package/bundled/upstream/impeccable/skills/impeccable/reference/colorize.md +257 -0
  18. package/bundled/upstream/impeccable/skills/impeccable/reference/craft.md +123 -0
  19. package/bundled/upstream/impeccable/skills/impeccable/reference/critique.md +767 -0
  20. package/bundled/upstream/impeccable/skills/impeccable/reference/delight.md +302 -0
  21. package/bundled/upstream/impeccable/skills/impeccable/reference/distill.md +111 -0
  22. package/bundled/upstream/impeccable/skills/impeccable/reference/document.md +429 -0
  23. package/bundled/upstream/impeccable/skills/impeccable/reference/extract.md +69 -0
  24. package/bundled/upstream/impeccable/skills/impeccable/reference/harden.md +347 -0
  25. package/bundled/upstream/impeccable/skills/impeccable/reference/hooks.md +88 -0
  26. package/bundled/upstream/impeccable/skills/impeccable/reference/init.md +172 -0
  27. package/bundled/upstream/impeccable/skills/impeccable/reference/interaction-design.md +189 -0
  28. package/bundled/upstream/impeccable/skills/impeccable/reference/layout.md +161 -0
  29. package/bundled/upstream/impeccable/skills/impeccable/reference/live.md +718 -0
  30. package/bundled/upstream/impeccable/skills/impeccable/reference/onboard.md +234 -0
  31. package/bundled/upstream/impeccable/skills/impeccable/reference/optimize.md +258 -0
  32. package/bundled/upstream/impeccable/skills/impeccable/reference/overdrive.md +130 -0
  33. package/bundled/upstream/impeccable/skills/impeccable/reference/polish.md +241 -0
  34. package/bundled/upstream/impeccable/skills/impeccable/reference/product.md +60 -0
  35. package/bundled/upstream/impeccable/skills/impeccable/reference/quieter.md +99 -0
  36. package/bundled/upstream/impeccable/skills/impeccable/reference/shape.md +165 -0
  37. package/bundled/upstream/impeccable/skills/impeccable/reference/typeset.md +279 -0
  38. package/bundled/upstream/impeccable/skills/impeccable/scripts/command-metadata.json +94 -0
  39. package/bundled/upstream/impeccable/skills/impeccable/scripts/context-signals.mjs +225 -0
  40. package/bundled/upstream/impeccable/skills/impeccable/scripts/context.mjs +280 -0
  41. package/bundled/upstream/impeccable/skills/impeccable/scripts/critique-storage.mjs +242 -0
  42. package/bundled/upstream/impeccable/skills/impeccable/scripts/detect-csp.mjs +198 -0
  43. package/bundled/upstream/impeccable/skills/impeccable/scripts/detect.mjs +21 -0
  44. package/bundled/upstream/impeccable/skills/impeccable/scripts/detector/browser/injected/index.mjs +1735 -0
  45. package/bundled/upstream/impeccable/skills/impeccable/scripts/detector/cli/main.mjs +244 -0
  46. package/bundled/upstream/impeccable/skills/impeccable/scripts/detector/detect-antipatterns-browser.js +4907 -0
  47. package/bundled/upstream/impeccable/skills/impeccable/scripts/detector/detect-antipatterns.mjs +43 -0
  48. package/bundled/upstream/impeccable/skills/impeccable/scripts/detector/engines/browser/detect-url.mjs +252 -0
  49. package/bundled/upstream/impeccable/skills/impeccable/scripts/detector/engines/regex/detect-text.mjs +552 -0
  50. package/bundled/upstream/impeccable/skills/impeccable/scripts/detector/engines/static-html/css-cascade.mjs +1013 -0
  51. package/bundled/upstream/impeccable/skills/impeccable/scripts/detector/engines/static-html/detect-html.mjs +208 -0
  52. package/bundled/upstream/impeccable/skills/impeccable/scripts/detector/engines/visual/screenshot-contrast.mjs +189 -0
  53. package/bundled/upstream/impeccable/skills/impeccable/scripts/detector/findings.mjs +12 -0
  54. package/bundled/upstream/impeccable/skills/impeccable/scripts/detector/node/file-system.mjs +198 -0
  55. package/bundled/upstream/impeccable/skills/impeccable/scripts/detector/profile/profiler.mjs +166 -0
  56. package/bundled/upstream/impeccable/skills/impeccable/scripts/detector/registry/antipatterns.mjs +419 -0
  57. package/bundled/upstream/impeccable/skills/impeccable/scripts/detector/rules/checks.mjs +2671 -0
  58. package/bundled/upstream/impeccable/skills/impeccable/scripts/detector/shared/color.mjs +124 -0
  59. package/bundled/upstream/impeccable/skills/impeccable/scripts/detector/shared/constants.mjs +101 -0
  60. package/bundled/upstream/impeccable/skills/impeccable/scripts/detector/shared/page.mjs +7 -0
  61. package/bundled/upstream/impeccable/skills/impeccable/scripts/hook-admin.mjs +574 -0
  62. package/bundled/upstream/impeccable/skills/impeccable/scripts/hook-before-edit.mjs +473 -0
  63. package/bundled/upstream/impeccable/skills/impeccable/scripts/hook-lib.mjs +1286 -0
  64. package/bundled/upstream/impeccable/skills/impeccable/scripts/hook.mjs +61 -0
  65. package/bundled/upstream/impeccable/skills/impeccable/scripts/lib/design-parser.mjs +835 -0
  66. package/bundled/upstream/impeccable/skills/impeccable/scripts/lib/impeccable-paths.mjs +126 -0
  67. package/bundled/upstream/impeccable/skills/impeccable/scripts/lib/is-generated.mjs +69 -0
  68. package/bundled/upstream/impeccable/skills/impeccable/scripts/live/browser-script-parts.mjs +49 -0
  69. package/bundled/upstream/impeccable/skills/impeccable/scripts/live/completion.mjs +19 -0
  70. package/bundled/upstream/impeccable/skills/impeccable/scripts/live/event-validation.mjs +137 -0
  71. package/bundled/upstream/impeccable/skills/impeccable/scripts/live/insert-ui.mjs +458 -0
  72. package/bundled/upstream/impeccable/skills/impeccable/scripts/live/manual-apply.mjs +939 -0
  73. package/bundled/upstream/impeccable/skills/impeccable/scripts/live/manual-edit-routes.mjs +357 -0
  74. package/bundled/upstream/impeccable/skills/impeccable/scripts/live/manual-edits-buffer.mjs +152 -0
  75. package/bundled/upstream/impeccable/skills/impeccable/scripts/live/session-store.mjs +289 -0
  76. package/bundled/upstream/impeccable/skills/impeccable/scripts/live/svelte-component.mjs +826 -0
  77. package/bundled/upstream/impeccable/skills/impeccable/scripts/live/sveltekit-adapter.mjs +274 -0
  78. package/bundled/upstream/impeccable/skills/impeccable/scripts/live/ui-core.mjs +180 -0
  79. package/bundled/upstream/impeccable/skills/impeccable/scripts/live/vocabulary.mjs +36 -0
  80. package/bundled/upstream/impeccable/skills/impeccable/scripts/live-accept.mjs +812 -0
  81. package/bundled/upstream/impeccable/skills/impeccable/scripts/live-browser-dom.js +146 -0
  82. package/bundled/upstream/impeccable/skills/impeccable/scripts/live-browser-session.js +123 -0
  83. package/bundled/upstream/impeccable/skills/impeccable/scripts/live-browser.js +11086 -0
  84. package/bundled/upstream/impeccable/skills/impeccable/scripts/live-commit-manual-edits.mjs +1241 -0
  85. package/bundled/upstream/impeccable/skills/impeccable/scripts/live-complete.mjs +75 -0
  86. package/bundled/upstream/impeccable/skills/impeccable/scripts/live-copy-edit-agent.mjs +683 -0
  87. package/bundled/upstream/impeccable/skills/impeccable/scripts/live-discard-manual-edits.mjs +51 -0
  88. package/bundled/upstream/impeccable/skills/impeccable/scripts/live-inject.mjs +583 -0
  89. package/bundled/upstream/impeccable/skills/impeccable/scripts/live-insert.mjs +272 -0
  90. package/bundled/upstream/impeccable/skills/impeccable/scripts/live-manual-edit-evidence.mjs +363 -0
  91. package/bundled/upstream/impeccable/skills/impeccable/scripts/live-poll.mjs +379 -0
  92. package/bundled/upstream/impeccable/skills/impeccable/scripts/live-resume.mjs +94 -0
  93. package/bundled/upstream/impeccable/skills/impeccable/scripts/live-server.mjs +1134 -0
  94. package/bundled/upstream/impeccable/skills/impeccable/scripts/live-status.mjs +61 -0
  95. package/bundled/upstream/impeccable/skills/impeccable/scripts/live-wrap.mjs +894 -0
  96. package/bundled/upstream/impeccable/skills/impeccable/scripts/live.mjs +246 -0
  97. package/bundled/upstream/impeccable/skills/impeccable/scripts/modern-screenshot.umd.js +14 -0
  98. package/bundled/upstream/impeccable/skills/impeccable/scripts/palette.mjs +633 -0
  99. package/bundled/upstream/impeccable/skills/impeccable/scripts/pin.mjs +214 -0
  100. package/package.json +1 -1
  101. package/src/cli/source.js +6 -0
  102. package/src/config/sources.js +15 -0
  103. package/src/merge/content-patch.js +4 -0
@@ -0,0 +1,274 @@
1
+ /**
2
+ * SvelteKit live-mode adapter.
3
+ *
4
+ * SvelteKit must not be patched through src/app.html. That file is a document
5
+ * template, not framework-owned component chrome. The adapter keeps SvelteKit
6
+ * work limited to mounting a dev-only shadow host from +layout.svelte; the
7
+ * actual live UI remains the shared plain-DOM browser chrome.
8
+ */
9
+
10
+ import fs from 'node:fs';
11
+ import path from 'node:path';
12
+
13
+ export const SVELTE_LIVE_ROOT_COMPONENT = 'src/lib/impeccable/ImpeccableLiveRoot.svelte';
14
+ export const SVELTE_LAYOUT_MARKER_OPEN = '<!-- impeccable-live-svelte-start -->';
15
+ export const SVELTE_LAYOUT_MARKER_CLOSE = '<!-- impeccable-live-svelte-end -->';
16
+ export const SVELTE_ROOT_IMPORT = "import ImpeccableLiveRoot from '$lib/impeccable/ImpeccableLiveRoot.svelte';";
17
+
18
+ export function detectSvelteKitProject(cwd = process.cwd(), config = null) {
19
+ const appHtml = findSvelteKitAppHtml(cwd, config);
20
+ if (!appHtml) return null;
21
+ const hasTemplateMarkers = fileIncludes(path.join(cwd, appHtml), '%sveltekit.body%')
22
+ && fileIncludes(path.join(cwd, appHtml), '%sveltekit.head%');
23
+ if (!hasTemplateMarkers) return null;
24
+
25
+ const hasSvelteConfig = fs.existsSync(path.join(cwd, 'svelte.config.js'))
26
+ || fs.existsSync(path.join(cwd, 'svelte.config.mjs'))
27
+ || fs.existsSync(path.join(cwd, 'svelte.config.cjs'))
28
+ || fs.existsSync(path.join(cwd, 'svelte.config.ts'));
29
+ const hasKitPackage = packageHasSvelteKit(cwd);
30
+ if (!hasSvelteConfig && !hasKitPackage) return null;
31
+
32
+ return {
33
+ appHtml,
34
+ layoutFile: findSvelteKitLayout(cwd),
35
+ rootComponent: SVELTE_LIVE_ROOT_COMPONENT,
36
+ };
37
+ }
38
+
39
+ export function applySvelteKitLiveAdapter({ cwd = process.cwd(), port, config = null } = {}) {
40
+ if (!Number.isFinite(Number(port))) {
41
+ throw new Error('SvelteKit live adapter requires a numeric port');
42
+ }
43
+ const detected = detectSvelteKitProject(cwd, config);
44
+ if (!detected) return null;
45
+
46
+ ensureSvelteLiveRootComponent(cwd, Number(port));
47
+
48
+ const layoutRel = detected.layoutFile;
49
+ const layoutAbs = path.join(cwd, layoutRel);
50
+ fs.mkdirSync(path.dirname(layoutAbs), { recursive: true });
51
+ const layoutExisted = fs.existsSync(layoutAbs);
52
+ const before = layoutExisted ? fs.readFileSync(layoutAbs, 'utf-8') : defaultSvelteLayout();
53
+ const after = patchSvelteLayout(before);
54
+ fs.writeFileSync(layoutAbs, after, 'utf-8');
55
+
56
+ return {
57
+ file: layoutRel,
58
+ adapter: 'sveltekit',
59
+ inserted: after !== before || !layoutExisted,
60
+ appHtmlUntouched: true,
61
+ rootComponent: SVELTE_LIVE_ROOT_COMPONENT,
62
+ };
63
+ }
64
+
65
+ export function removeSvelteKitLiveAdapter({ cwd = process.cwd(), config = null } = {}) {
66
+ const detected = detectSvelteKitProject(cwd, config);
67
+ if (!detected) return null;
68
+
69
+ const layoutAbs = path.join(cwd, detected.layoutFile);
70
+ let removed = false;
71
+ if (fs.existsSync(layoutAbs)) {
72
+ const before = fs.readFileSync(layoutAbs, 'utf-8');
73
+ const after = unpatchSvelteLayout(before);
74
+ if (after !== before) {
75
+ fs.writeFileSync(layoutAbs, after, 'utf-8');
76
+ removed = true;
77
+ }
78
+ }
79
+
80
+ const rootAbs = path.join(cwd, SVELTE_LIVE_ROOT_COMPONENT);
81
+ if (fs.existsSync(rootAbs)) {
82
+ fs.rmSync(rootAbs, { force: true });
83
+ removed = true;
84
+ }
85
+
86
+ pruneEmptyDir(path.dirname(rootAbs), path.join(cwd, 'src'));
87
+
88
+ return {
89
+ file: detected.layoutFile,
90
+ adapter: 'sveltekit',
91
+ removed,
92
+ appHtmlUntouched: true,
93
+ rootComponent: SVELTE_LIVE_ROOT_COMPONENT,
94
+ };
95
+ }
96
+
97
+ export function patchSvelteLayout(content) {
98
+ let out = String(content || '');
99
+ if (!out.includes(SVELTE_ROOT_IMPORT)) {
100
+ const scriptMatch = out.match(/<script(?:\s[^>]*)?>/i);
101
+ if (scriptMatch) {
102
+ const insertAt = scriptMatch.index + scriptMatch[0].length;
103
+ out = out.slice(0, insertAt) + '\n ' + SVELTE_ROOT_IMPORT + out.slice(insertAt);
104
+ } else {
105
+ out = `<script>\n ${SVELTE_ROOT_IMPORT}\n</script>\n\n` + out;
106
+ }
107
+ }
108
+
109
+ if (!out.includes(SVELTE_LAYOUT_MARKER_OPEN)) {
110
+ const block = `${SVELTE_LAYOUT_MARKER_OPEN}\n<ImpeccableLiveRoot />\n${SVELTE_LAYOUT_MARKER_CLOSE}\n`;
111
+ const renderMatch = out.match(/\{@render\s+children(?:\?\.)?\(\)\s*\}/);
112
+ const slotMatch = out.match(/<slot\s*\/?>/);
113
+ const match = renderMatch || slotMatch;
114
+ if (match) {
115
+ out = out.slice(0, match.index) + block + out.slice(match.index);
116
+ } else {
117
+ out = out.replace(/\s*$/, '\n\n' + block);
118
+ }
119
+ }
120
+
121
+ return out;
122
+ }
123
+
124
+ export function unpatchSvelteLayout(content) {
125
+ let out = String(content || '');
126
+ const blockRe = new RegExp(
127
+ '([ \\t]*)' + escapeRegExp(SVELTE_LAYOUT_MARKER_OPEN)
128
+ + '\\n<ImpeccableLiveRoot\\s*/>\\n'
129
+ + escapeRegExp(SVELTE_LAYOUT_MARKER_CLOSE)
130
+ + '\\n?',
131
+ 'g',
132
+ );
133
+ out = out.replace(blockRe, '$1');
134
+ out = out.replace(new RegExp('^\\s*' + escapeRegExp(SVELTE_ROOT_IMPORT) + '\\s*\\n?', 'gm'), '');
135
+ out = out.replace(/<script>\s*<\/script>\s*\n?/g, '');
136
+ return out.replace(/\n{3,}/g, '\n\n');
137
+ }
138
+
139
+ export function ensureSvelteLiveRootComponent(cwd, port) {
140
+ const file = path.join(cwd, SVELTE_LIVE_ROOT_COMPONENT);
141
+ fs.mkdirSync(path.dirname(file), { recursive: true });
142
+ fs.writeFileSync(file, buildSvelteLiveRootComponent(port), 'utf-8');
143
+ return file;
144
+ }
145
+
146
+ export function buildSvelteLiveRootComponent(port) {
147
+ return `<script>
148
+ import { onMount } from 'svelte';
149
+
150
+ const LIVE_URL = 'http://localhost:${Number(port)}/live.js';
151
+ const HOST_ID = 'impeccable-live-root';
152
+
153
+ onMount(() => {
154
+ let host = document.querySelector('impeccable-live-root#' + HOST_ID) || document.getElementById(HOST_ID);
155
+ if (!host) {
156
+ host = document.createElement('impeccable-live-root');
157
+ host.id = HOST_ID;
158
+ document.body.appendChild(host);
159
+ }
160
+
161
+ host.dataset.impeccableLiveAdapter = 'sveltekit';
162
+ host.style.setProperty('all', 'initial', 'important');
163
+ host.style.setProperty('display', 'block', 'important');
164
+ host.style.setProperty('position', 'fixed', 'important');
165
+ host.style.setProperty('top', '0', 'important');
166
+ host.style.setProperty('left', '0', 'important');
167
+ host.style.setProperty('width', '0', 'important');
168
+ host.style.setProperty('height', '0', 'important');
169
+ host.style.setProperty('overflow', 'visible', 'important');
170
+ host.style.setProperty('z-index', '2147483000', 'important');
171
+ host.style.setProperty('pointer-events', 'none', 'important');
172
+
173
+ const root = host.shadowRoot || host.attachShadow({ mode: 'open' });
174
+ if (!root.querySelector('style[data-impeccable-live-reset]')) {
175
+ const reset = document.createElement('style');
176
+ reset.dataset.impeccableLiveReset = 'true';
177
+ reset.textContent = ':host, :host *, * { box-sizing: border-box; }';
178
+ root.appendChild(reset);
179
+ }
180
+
181
+ window.__IMPECCABLE_LIVE_ADAPTER__ = 'sveltekit';
182
+ window.__IMPECCABLE_LIVE_UI_ROOT__ = root;
183
+ window.__IMPECCABLE_LIVE_CHROME_MOUNT__ = {
184
+ adapter: 'sveltekit',
185
+ version: 1,
186
+ host,
187
+ root,
188
+ };
189
+
190
+ const script = document.createElement('script');
191
+ script.src = LIVE_URL;
192
+ script.async = true;
193
+ script.dataset.impeccableLiveScript = 'true';
194
+ document.head.appendChild(script);
195
+
196
+ return () => {
197
+ script.remove();
198
+ if (window.__IMPECCABLE_LIVE_UI_ROOT__ === root) delete window.__IMPECCABLE_LIVE_UI_ROOT__;
199
+ if (window.__IMPECCABLE_LIVE_CHROME_MOUNT__?.root === root) delete window.__IMPECCABLE_LIVE_CHROME_MOUNT__;
200
+ if (window.__IMPECCABLE_LIVE_ADAPTER__ === 'sveltekit') delete window.__IMPECCABLE_LIVE_ADAPTER__;
201
+ };
202
+ });
203
+ </script>
204
+ `;
205
+ }
206
+
207
+ function findSvelteKitAppHtml(cwd, config) {
208
+ const files = Array.isArray(config?.files) ? config.files : ['src/app.html'];
209
+ for (const rel of files) {
210
+ if (rel.includes('*')) continue;
211
+ const normalized = rel.split(path.sep).join('/');
212
+ if (!normalized.endsWith('app.html')) continue;
213
+ const abs = path.join(cwd, normalized);
214
+ if (fs.existsSync(abs)) return normalized;
215
+ }
216
+ const fallback = 'src/app.html';
217
+ return fs.existsSync(path.join(cwd, fallback)) ? fallback : null;
218
+ }
219
+
220
+ function findSvelteKitLayout(cwd) {
221
+ const candidates = [
222
+ 'src/routes/+layout.svelte',
223
+ 'src/routes/(app)/+layout.svelte',
224
+ ];
225
+ for (const rel of candidates) {
226
+ if (fs.existsSync(path.join(cwd, rel))) return rel;
227
+ }
228
+ return 'src/routes/+layout.svelte';
229
+ }
230
+
231
+ function defaultSvelteLayout() {
232
+ return `<script>\n let { children } = $props();\n</script>\n\n{@render children?.()}\n`;
233
+ }
234
+
235
+ function packageHasSvelteKit(cwd) {
236
+ const file = path.join(cwd, 'package.json');
237
+ if (!fs.existsSync(file)) return false;
238
+ try {
239
+ const pkg = JSON.parse(fs.readFileSync(file, 'utf-8'));
240
+ const deps = {
241
+ ...(pkg.dependencies || {}),
242
+ ...(pkg.devDependencies || {}),
243
+ ...(pkg.peerDependencies || {}),
244
+ };
245
+ return Boolean(deps['@sveltejs/kit'] || deps['@sveltejs/vite-plugin-svelte'] || deps.svelte);
246
+ } catch {
247
+ return false;
248
+ }
249
+ }
250
+
251
+ function fileIncludes(file, text) {
252
+ try {
253
+ return fs.readFileSync(file, 'utf-8').includes(text);
254
+ } catch {
255
+ return false;
256
+ }
257
+ }
258
+
259
+ function pruneEmptyDir(dir, stopDir) {
260
+ let current = dir;
261
+ while (current.startsWith(stopDir) && current !== stopDir) {
262
+ try {
263
+ if (fs.readdirSync(current).length > 0) return;
264
+ fs.rmdirSync(current);
265
+ current = path.dirname(current);
266
+ } catch {
267
+ return;
268
+ }
269
+ }
270
+ }
271
+
272
+ function escapeRegExp(value) {
273
+ return String(value).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
274
+ }
@@ -0,0 +1,180 @@
1
+ /**
2
+ * Framework-neutral Impeccable live chrome contract.
3
+ *
4
+ * The production browser bundle is intentionally plain DOM so Svelte, React,
5
+ * Vue, and static adapters can all mount the same chrome. This module is the
6
+ * testable contract/inventory for that bundle; live-browser.js mirrors these
7
+ * values at runtime because it is served as a standalone script.
8
+ */
9
+
10
+ export const LIVE_CHROME_MOUNT_CONTRACT = Object.freeze([
11
+ 'root',
12
+ 'transport',
13
+ 'state',
14
+ 'actions',
15
+ ]);
16
+
17
+ export const LIVE_UI_SURFACES = Object.freeze([
18
+ {
19
+ key: 'global-bottom-bar',
20
+ ids: [
21
+ 'impeccable-live-global-bar',
22
+ 'impeccable-live-global-bar-brand',
23
+ 'impeccable-live-pick-toggle',
24
+ 'impeccable-live-insert-toggle',
25
+ 'impeccable-live-detect-toggle',
26
+ 'impeccable-live-detect-badge',
27
+ 'impeccable-live-design-toggle',
28
+ 'impeccable-live-page-chat',
29
+ 'impeccable-live-page-chat-input',
30
+ 'impeccable-live-page-chat-voice',
31
+ ],
32
+ states: ['rest', 'hover', 'focus-visible', 'pressed', 'active', 'tooltip'],
33
+ },
34
+ {
35
+ key: 'pending-copy-edit-dock',
36
+ ids: ['impeccable-live-pending-dock'],
37
+ states: ['closed', 'open', 'hover', 'pressed', 'loading', 'rollback', 'keep-fixing'],
38
+ },
39
+ {
40
+ key: 'element-selection-chrome',
41
+ ids: [
42
+ 'impeccable-live-highlight',
43
+ 'impeccable-live-tooltip',
44
+ 'impeccable-live-bar',
45
+ 'impeccable-live-selection-pill',
46
+ 'impeccable-live-input',
47
+ 'impeccable-live-configure-voice',
48
+ 'impeccable-live-configure-bar-tooltip',
49
+ ],
50
+ states: ['rest', 'hover', 'focus-visible', 'pressed', 'disabled'],
51
+ },
52
+ {
53
+ key: 'action-picker',
54
+ ids: ['impeccable-live-picker'],
55
+ states: ['closed', 'open', 'option-hover', 'option-focus'],
56
+ },
57
+ {
58
+ key: 'edit-chrome',
59
+ ids: ['impeccable-live-edit-badge'],
60
+ states: ['enabled', 'disabled', 'editing', 'cancel', 'save', 'edited-content'],
61
+ },
62
+ {
63
+ key: 'generating-row',
64
+ ids: ['impeccable-live-bar', 'impeccable-live-shader'],
65
+ states: ['action-label', 'animated-dots', 'generating', 'done'],
66
+ },
67
+ {
68
+ key: 'variant-cycling-row',
69
+ ids: ['impeccable-live-bar', 'impeccable-live-params-panel'],
70
+ states: ['variant-1', 'variant-2', 'variant-3', 'left-disabled', 'right-disabled', 'dot-click', 'accept', 'discard'],
71
+ },
72
+ {
73
+ key: 'variant-params-panel',
74
+ ids: ['impeccable-live-params-panel'],
75
+ states: ['closed', 'open-above', 'open-below', 'range', 'steps', 'toggle'],
76
+ },
77
+ {
78
+ key: 'saving-confirmed-rows',
79
+ ids: ['impeccable-live-bar'],
80
+ states: ['saving', 'applying-variant', 'confirmed'],
81
+ },
82
+ {
83
+ key: 'insert-mode-chrome',
84
+ ids: [
85
+ 'impeccable-live-insert-line',
86
+ 'impeccable-live-insert-placeholder',
87
+ 'impeccable-live-placeholder-resize',
88
+ 'impeccable-live-insert-input',
89
+ 'impeccable-live-insert-voice',
90
+ 'impeccable-live-insert-create',
91
+ 'impeccable-live-insert-create-tooltip',
92
+ ],
93
+ states: ['toggle-active', 'line', 'placeholder', 'resize', 'enabled', 'disabled', 'tooltip'],
94
+ },
95
+ {
96
+ key: 'annotation-chrome',
97
+ ids: [
98
+ 'impeccable-live-annot',
99
+ 'impeccable-live-annot-svg',
100
+ 'impeccable-live-annot-pins',
101
+ 'impeccable-live-annot-clear',
102
+ ],
103
+ states: ['overlay', 'drawing', 'pin', 'pin-edit', 'clear'],
104
+ },
105
+ {
106
+ key: 'design-system-panel',
107
+ ids: ['impeccable-live-design-host'],
108
+ states: ['closed', 'open', 'tabs', 'token-tiles', 'copy'],
109
+ },
110
+ {
111
+ key: 'toasts-and-errors',
112
+ ids: ['impeccable-live-toast'],
113
+ states: ['normal', 'error', 'no-variants-mounted'],
114
+ },
115
+ {
116
+ key: 'css-isolation-boundary',
117
+ ids: ['impeccable-live-root'],
118
+ states: ['shadow-root', 'style-tags', 'hostile-css'],
119
+ },
120
+ ]);
121
+
122
+ export const LIVE_UI_COMPONENT_IDS = Object.freeze([
123
+ ...new Set(LIVE_UI_SURFACES.flatMap((surface) => surface.ids)),
124
+ ]);
125
+
126
+ export function resolveLiveUiRoot(env = globalThis) {
127
+ const doc = env?.document;
128
+ const explicit = env?.__IMPECCABLE_LIVE_UI_ROOT__
129
+ || env?.window?.__IMPECCABLE_LIVE_UI_ROOT__;
130
+ if (explicit && typeof explicit.appendChild === 'function') return explicit;
131
+ return doc?.body || null;
132
+ }
133
+
134
+ export function getLiveUiElementById(id, env = globalThis) {
135
+ const doc = env?.document;
136
+ const root = resolveLiveUiRoot(env);
137
+ if (!id) return null;
138
+ if (root?.getElementById) {
139
+ const found = root.getElementById(id);
140
+ if (found) return found;
141
+ }
142
+ if (root?.querySelector) {
143
+ const found = root.querySelector('#' + escapeCssIdent(id));
144
+ if (found) return found;
145
+ }
146
+ return doc?.getElementById?.(id) || null;
147
+ }
148
+
149
+ export function appendToLiveUiRoot(el, env = globalThis) {
150
+ const root = resolveLiveUiRoot(env);
151
+ if (!root) throw new Error('Impeccable live UI root is not available');
152
+ root.appendChild(el);
153
+ return el;
154
+ }
155
+
156
+ export function appendStyleToLiveUiRoot(styleEl, env = globalThis) {
157
+ const doc = env?.document;
158
+ const root = resolveLiveUiRoot(env);
159
+ if (root && root !== doc?.body) {
160
+ root.appendChild(styleEl);
161
+ } else {
162
+ (doc?.head || doc?.body || root).appendChild(styleEl);
163
+ }
164
+ return styleEl;
165
+ }
166
+
167
+ export function activeElementDeep(doc = globalThis.document) {
168
+ let active = doc?.activeElement || null;
169
+ while (active?.shadowRoot?.activeElement) {
170
+ active = active.shadowRoot.activeElement;
171
+ }
172
+ return active;
173
+ }
174
+
175
+ function escapeCssIdent(value) {
176
+ if (typeof CSS !== 'undefined' && typeof CSS.escape === 'function') {
177
+ return CSS.escape(String(value));
178
+ }
179
+ return String(value).replace(/([ !"#$%&'()*+,./:;<=>?@[\\\]^`{|}~])/g, '\\$1');
180
+ }
@@ -0,0 +1,36 @@
1
+ /**
2
+ * Canonical design-command vocabulary for Live Mode: each command's value, human
3
+ * label, and SVG icon. Icons stack above the chip label; strokes use currentColor
4
+ * so the icon recolors when its chip is selected.
5
+ *
6
+ * Single source of truth, consumed by:
7
+ * - skill/scripts/live/event-validation.mjs — re-exports VISUAL_ACTIONS.
8
+ * - skill/scripts/live-browser.js — the real picker. It is served raw and
9
+ * injected as an IIFE, so it cannot import this at runtime; live-server.mjs
10
+ * serializes LIVE_COMMANDS into window.__IMPECCABLE_VOCAB__ alongside the
11
+ * token/port, and live-browser.js builds its ICONS + ACTIONS from that.
12
+ * - site/components/LiveDemoPalette.astro — the marketing demo palette (imported
13
+ * at build time).
14
+ *
15
+ * Add, rename, or reorder a verb here and all three follow.
16
+ */
17
+
18
+ const ICON_ATTRS = 'width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" style="display:block"';
19
+
20
+ export const LIVE_COMMANDS = [
21
+ { value: 'impeccable', label: 'Freeform', icon: `<svg ${ICON_ATTRS}><path d="M4 20l4-1L18 9l-3-3L5 16z"/><path d="M14 7l3 3"/></svg>` },
22
+ { value: 'bolder', label: 'Bolder', icon: `<svg ${ICON_ATTRS}><rect x="6" y="12" width="4" height="7" rx="0.5"/><rect x="14" y="5" width="4" height="14" rx="0.5"/></svg>` },
23
+ { value: 'quieter', label: 'Quieter', icon: `<svg ${ICON_ATTRS}><rect x="6" y="5" width="4" height="14" rx="0.5"/><rect x="14" y="12" width="4" height="7" rx="0.5"/></svg>` },
24
+ { value: 'distill', label: 'Distill', icon: `<svg ${ICON_ATTRS}><path d="M4 5h16l-6 8v7l-4-2v-5z"/></svg>` },
25
+ { value: 'polish', label: 'Polish', icon: `<svg ${ICON_ATTRS}><path d="M15 3l1 3 3 1-3 1-1 3-1-3-3-1 3-1z"/><path d="M7 13l0.6 1.8 1.8 0.6-1.8 0.6-0.6 1.8-0.6-1.8-1.8-0.6 1.8-0.6z"/></svg>` },
26
+ { value: 'typeset', label: 'Typeset', icon: `<svg ${ICON_ATTRS}><path d="M5 6h14" stroke-width="2.6"/><path d="M5 12h9" stroke-width="1.9"/><path d="M5 18h5" stroke-width="1.3"/></svg>` },
27
+ { value: 'colorize', label: 'Colorize', icon: `<svg ${ICON_ATTRS}><circle cx="9" cy="10" r="5"/><circle cx="15" cy="10" r="5"/><circle cx="12" cy="15" r="5"/></svg>` },
28
+ { value: 'layout', label: 'Layout', icon: `<svg ${ICON_ATTRS}><rect x="3" y="4" width="8" height="16" rx="0.5"/><rect x="13" y="4" width="8" height="7" rx="0.5"/><rect x="13" y="13" width="8" height="7" rx="0.5"/></svg>` },
29
+ { value: 'adapt', label: 'Adapt', icon: `<svg ${ICON_ATTRS}><rect x="2.5" y="5" width="12" height="11" rx="1"/><line x1="2.5" y1="19" x2="14.5" y2="19"/><rect x="16.5" y="8" width="5" height="11" rx="1"/></svg>` },
30
+ { value: 'animate', label: 'Animate', icon: `<svg ${ICON_ATTRS}><path d="M3 18c4-4 6-10 10-10"/><path d="M13 8c3 0 5 5 8 10"/><circle cx="13" cy="8" r="1.6" fill="currentColor" stroke="none"/></svg>` },
31
+ { value: 'delight', label: 'Delight', icon: `<svg ${ICON_ATTRS}><path d="M12 3l2 6 6 2-6 2-2 6-2-6-6-2 6-2z"/></svg>` },
32
+ { value: 'overdrive', label: 'Overdrive', icon: `<svg ${ICON_ATTRS}><path d="M13 3L5 13h5l-1 8 9-12h-6z"/></svg>` },
33
+ ];
34
+
35
+ // Action values accepted by the live event protocol, in palette order.
36
+ export const VISUAL_ACTIONS = LIVE_COMMANDS.map((c) => c.value);