1import fs from 'node:fs';
2import path from 'node:path';
3 
4export const LIVE_BROWSER_SCRIPT_PARTS = Object.freeze([
5  Object.freeze({ name: 'session-state', file: 'live-browser-session.js' }),
6  Object.freeze({ name: 'dom-helpers', file: 'live-browser-dom.js' }),
7  Object.freeze({ name: 'browser-ui', file: 'live-browser.js' }),
8]);
9 
10export function resolveLiveBrowserScriptParts(scriptsDir, parts = LIVE_BROWSER_SCRIPT_PARTS) {
11  if (!scriptsDir) throw new Error('scriptsDir is required');
12  return parts.map((part, index) => ({
13    ...part,
14    index,
15    path: path.join(scriptsDir, part.file),
16  }));
17}
18 
19export function assertLiveBrowserScriptParts(parts, exists = fs.existsSync) {
20  for (const part of parts) {
21    if (!exists(part.path)) {
22      throw new Error(`Live browser script part missing: ${part.name} (${part.path})`);
23    }
24  }
25  return parts;
26}
27 
28export function readLiveBrowserScriptParts(parts, readFile = (filePath) => fs.readFileSync(filePath, 'utf-8')) {
29  return parts.map((part) => ({
30    ...part,
31    source: readFile(part.path),
32  }));
33}
34 
35export function assembleLiveBrowserScript({ token, port, vocabulary, parts }) {
36  const prelude =
37    `window.__IMPECCABLE_TOKEN__ = '${token}';\n` +
38    `window.__IMPECCABLE_PORT__ = ${port};\n` +
39    // Canonical command vocabulary (values + labels + icons). live-browser.js
40    // builds its action picker from this instead of an inline copy.
41    `window.__IMPECCABLE_VOCAB__ = ${JSON.stringify(vocabulary)};\n`;
42 
43  const body = parts.map((part) => {
44    const file = part.file || path.basename(part.path || '');
45    return `// --- impeccable live script part: ${part.name} (${file}) ---\n${part.source}`;
46  }).join('\n');
47 
48  return prelude + body;
49}
50