trace-avatar-render 0.1.0 → 0.1.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.
package/dist/cli.js CHANGED
@@ -5,10 +5,10 @@ import {
5
5
  render,
6
6
  suggestScript,
7
7
  voiceOf
8
- } from "./chunk-BM26YQ4L.js";
8
+ } from "./chunk-PE3MNBRB.js";
9
9
 
10
10
  // src/cli.ts
11
- import { readFileSync, writeFileSync } from "fs";
11
+ import { existsSync, readFileSync, writeFileSync } from "fs";
12
12
  import { apply as applySuggestions, suggest } from "trace-avatar/assist";
13
13
  import { parseArgs } from "util";
14
14
  var USAGE = `Usage: trace-avatar-render <trace.json> --url <page> --out <file.gif|file.mp4> [options]
@@ -29,6 +29,8 @@ var USAGE = `Usage: trace-avatar-render <trace.json> --url <page> --out <file.gi
29
29
  --player <file> the trace-perform.min.js to use (default: the installed trace-avatar)
30
30
  --timeline <file> write the timeline and the cuts as JSON
31
31
  --timeout <ms> give up after this long (default 120000)
32
+ --report <file> write what happened as JSON: { outcome: passed|stalled|failed, step, reason, message }
33
+ (for CI: one result per guide, whatever the exit code)
32
34
  --headed show the browser
33
35
 
34
36
  Polish (all off by default):
@@ -49,9 +51,10 @@ var USAGE = `Usage: trace-avatar-render <trace.json> --url <page> --out <file.gi
49
51
  --qa [strict] send a frame per step to the AI to look for errors, empty states, a stall, personal
50
52
  data; strict exits 1 when anything is flagged (needs a vision model)
51
53
  --alt write <out>.alt.txt; with --captions vtt, AI names the chapters
52
- --repair when a step can't find its element, propose a fix in <out>.repair.json (verified by
53
- playing again); still exits 1. With --ai, unsure cases are asked (DeepSeek first)
54
- --repair-vision with --repair and --ai: send a screenshot of the stalled page too
54
+ --repair when a step can't find its element, or a wait's text never shows, propose a fix in
55
+ <out>.repair.json (verified by playing again); still exits 1. With --ai, unsure
56
+ cases are asked (DeepSeek first)
57
+ --repair-vision with --repair and --ai: send a screenshot of the stalled page too (elements only)
55
58
 
56
59
  Narration (MP4 only; nothing speaks without --voice):
57
60
  --voice <voice> gateway (our AI gateway: Gemini speech, AI_GATEWAY_URL/KEY), gateway:gemini/<model>:<voice>,
@@ -121,7 +124,8 @@ function parse(argv) {
121
124
  "voice-strict": { type: "boolean" },
122
125
  "no-voice-cache": { type: "boolean" },
123
126
  repair: { type: "boolean" },
124
- "repair-vision": { type: "boolean" }
127
+ "repair-vision": { type: "boolean" },
128
+ report: { type: "string" }
125
129
  }
126
130
  });
127
131
  if (values.help) throw new UsageError("");
@@ -194,9 +198,29 @@ function parse(argv) {
194
198
  ...values["ai-vision"] ? { aiVision: values["ai-vision"] } : {},
195
199
  ...values.voice ? { voice: values.voice } : {},
196
200
  ...values["no-voice-cache"] ? { noVoiceCache: true } : {},
197
- ...extra.qa === "strict" ? { strict: true } : {}
201
+ ...extra.qa === "strict" ? { strict: true } : {},
202
+ ...values.report ? { report: values.report } : {}
198
203
  };
199
204
  }
205
+ function reportOf(err, traceFile, repairFile) {
206
+ if (!err) return { outcome: "passed", step: null, reason: null, message: null };
207
+ const stall = err instanceof RenderError ? err.stall : void 0;
208
+ if (stall && Number.isInteger(stall.index)) {
209
+ let say = null;
210
+ try {
211
+ say = JSON.parse(readFileSync(traceFile, "utf8")).steps?.[stall.index]?.say ?? null;
212
+ } catch {
213
+ }
214
+ return {
215
+ outcome: "stalled",
216
+ step: stall.index,
217
+ reason: stall.reason === "until-timeout" ? "until-timeout" : "not-found",
218
+ message: say ?? err.message,
219
+ ...repairFile && existsSync(repairFile) ? { repair: repairFile } : {}
220
+ };
221
+ }
222
+ return { outcome: "failed", step: null, reason: null, message: err?.message ?? String(err) };
223
+ }
200
224
  var UsageError = class extends Error {
201
225
  };
202
226
  async function main(argv, io = { log: console.log, error: console.error }) {
@@ -231,6 +255,8 @@ async function main(argv, io = { log: console.log, error: console.error }) {
231
255
  if (r.narration.wav) io.log(r.narration.wav);
232
256
  }
233
257
  for (const w of r.warnings ?? []) io.error(`warning: ${w}`);
258
+ if (p.report) writeFileSync(p.report, `${JSON.stringify(reportOf(null, p.trace), null, 2)}
259
+ `);
234
260
  if (r.qa) {
235
261
  if (!r.qa.length) io.log("qa: nothing flagged");
236
262
  for (const f of r.qa) io.log(`qa: ${(f.at / 1e3).toFixed(1)} s ${f.kind} ${f.note}`);
@@ -242,6 +268,12 @@ async function main(argv, io = { log: console.log, error: console.error }) {
242
268
  return 0;
243
269
  } catch (e) {
244
270
  io.error(`trace-avatar-render: ${e.message}`);
271
+ if (p.report) {
272
+ const first = p.options.out[0];
273
+ const base = (typeof first === "string" ? first : first.file).replace(/\.[^./]+$/, "");
274
+ writeFileSync(p.report, `${JSON.stringify(reportOf(e, p.trace, `${base}.repair.json`), null, 2)}
275
+ `);
276
+ }
245
277
  if (e instanceof RenderError && e.screenshot) {
246
278
  const first = p.options.out[0];
247
279
  const shot = `${(typeof first === "string" ? first : first.file).replace(/\.[^./]+$/, "")}.failure.png`;
@@ -319,6 +351,7 @@ export {
319
351
  USAGE,
320
352
  UsageError,
321
353
  main,
322
- parse
354
+ parse,
355
+ reportOf
323
356
  };
324
357
  //# sourceMappingURL=cli.js.map
package/dist/cli.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * trace-avatar-render invoice.trace.json --url http://localhost:3000/app --out invoice.gif --out invoice.mp4\n *\n * Exit codes: 0 rendered, 1 the render failed (a stalled guide, an error in the app), 2 wrong usage.\n */\n\nimport { readFileSync, writeFileSync } from 'node:fs';\nimport { apply as applySuggestions, suggest } from 'trace-avatar/assist';\nimport type { Suggestion } from 'trace-avatar/assist';\nimport { providerOf } from './ai';\nimport { suggestScript } from './narration';\nimport { voiceOf } from './voice';\nimport { parseArgs } from 'node:util';\nimport { RenderError } from './capture';\nimport { render } from './render';\n\nexport const USAGE = `Usage: trace-avatar-render <trace.json> --url <page> --out <file.gif|file.mp4> [options]\n\n --url <url> the page the guide starts on (required)\n --out <file> .gif or .mp4; repeat for several (required)\n --mode <overlay|perform> Show me (default) or Do it for me\n --allow-perform needed for perform: it clicks and types for real (use a sandbox account)\n --width <px> output width (GIF default 800, MP4 the capture's)\n --fps <n> frames per second (GIF default 12, MP4 30)\n --viewport <WxH> default: the trace's meta.viewport, else 1280x800\n --scale <n> device pixel ratio of the capture (2 for crisp video)\n --storage-state <file> a signed-in Playwright session\n --max-wait <ms> waits longer than this are cut to it (default 800, 0 keeps them)\n --hide <selector> hidden before capture; repeatable\n --blur <selector> blurred before capture (as well as [data-trace-blur]); repeatable\n --allow-stall render a stalled guide anyway instead of failing\n --player <file> the trace-perform.min.js to use (default: the installed trace-avatar)\n --timeline <file> write the timeline and the cuts as JSON\n --timeout <ms> give up after this long (default 120000)\n --headed show the browser\n\n Polish (all off by default):\n --frame <none|browser> a browser window around the app, on a background\n --background <css> the background behind the window and on the cards\n --camera zoom in on each action and pan between close ones\n --zoom <n> how far the camera goes in (default 1.6; implies --camera)\n --captions <burn|vtt|both> burn the steps' words in, write <out>.vtt + <out>.chapters.vtt, or both\n --poster [file] a PNG at the first click (default <out>.png)\n --title-card [title] a 1.5 s card first (default: the trace's title)\n --end-card [title] a 2 s card last (default: \"Done\")\n\n AI (nothing calls a model without --ai):\n --ai <provider> gateway: our AI gateway (AI_GATEWAY_URL, AI_GATEWAY_KEY), DeepSeek first, then Gemini,\n then OpenAI; or gateway:<provider>[/<model>][,<provider>…]; openai:<model> (OPENAI_API_KEY,\n OPENAI_BASE_URL for any OpenAI-compatible server); or ./provider.js\n --ai-vision <model> the model for --qa's frames (gateway's DeepSeek default: deepseek-flash)\n --qa [strict] send a frame per step to the AI to look for errors, empty states, a stall, personal\n data; strict exits 1 when anything is flagged (needs a vision model)\n --alt write <out>.alt.txt; with --captions vtt, AI names the chapters\n --repair when a step can't find its element, propose a fix in <out>.repair.json (verified by\n playing again); still exits 1. With --ai, unsure cases are asked (DeepSeek first)\n --repair-vision with --repair and --ai: send a screenshot of the stalled page too\n\n Narration (MP4 only; nothing speaks without --voice):\n --voice <voice> gateway (our AI gateway: Gemini speech, AI_GATEWAY_URL/KEY), gateway:gemini/<model>:<voice>,\n openai:<model>[:<voice>] (OPENAI_API_KEY / OPENAI_BASE_URL), say[:<voice>] (macOS, offline),\n or ./voice.js. Each step's caption is spoken; the video holds where a line runs long\n --script <file.json> the spoken lines instead: { \"lines\": [{ \"n\": 1, \"text\": \"…\" }] }\n --voice-out <file.wav> also write the narration track\n --voice-strict fail when a line needs a hold longer than 8 s\n --no-voice-cache don't keep spoken lines in .trace-avatar-cache/voice\n\nSuggestions for a person to accept (the renderer never changes a trace):\n trace-avatar-render suggest <trace.json> --task captions|title|waits|narration --ai <provider> [--tone friendly|terse|formal]\n [--hints hints.json] [--out suggestions.json]\n trace-avatar-render apply <trace.json> <suggestions.json> --accept 1,3|all --out <new.trace.json>\n`;\n\nexport interface Parsed { trace: string; options: Parameters<typeof render>[0]; /** --ai, made into a provider by main(). */ ai?: string; /** --ai-vision */ aiVision?: string; /** --voice, made into a Voice by main() */ voice?: string; /** --no-voice-cache */ noVoiceCache?: boolean; /** --qa strict */ strict?: boolean }\n\n/** Parse the command line. Throws a usage message (exit 2) on mistakes. Exported for tests. */\nexport function parse(argv: string[]): Parsed {\n // --poster, --title-card and --end-card take an optional value: take it here when one follows (a\n // following *.json is the trace, not the value).\n const extra: { poster?: string | true; title?: string | true; end?: string | true; qa?: string | true } = {};\n const flags: Record<string, 'poster' | 'title' | 'end' | 'qa'> = { '--poster': 'poster', '--title-card': 'title', '--end-card': 'end', '--qa': 'qa' };\n const rest: string[] = [];\n for (let k = 0; k < argv.length; k += 1) {\n const a = argv[k];\n const eq = a.indexOf('=');\n const name = eq > 0 ? a.slice(0, eq) : a;\n if (flags[name]) {\n if (eq > 0) extra[flags[name]] = a.slice(eq + 1);\n else if (argv[k + 1] !== undefined && !argv[k + 1].startsWith('-') && !/\\.json$/i.test(argv[k + 1]) && (flags[name] !== 'qa' || argv[k + 1] === 'strict')) { extra[flags[name]] = argv[k + 1]; k += 1; }\n else extra[flags[name]] = true;\n continue;\n }\n rest.push(a);\n }\n const { values, positionals } = parseArgs({\n args: rest,\n allowPositionals: true,\n options: {\n url: { type: 'string' }, out: { type: 'string', multiple: true }, mode: { type: 'string' },\n 'allow-perform': { type: 'boolean' }, width: { type: 'string' }, fps: { type: 'string' },\n viewport: { type: 'string' }, scale: { type: 'string' }, 'storage-state': { type: 'string' },\n 'max-wait': { type: 'string' }, hide: { type: 'string', multiple: true }, blur: { type: 'string', multiple: true },\n 'allow-stall': { type: 'boolean' }, player: { type: 'string' }, timeline: { type: 'string' },\n timeout: { type: 'string' }, headed: { type: 'boolean' }, help: { type: 'boolean', short: 'h' },\n frame: { type: 'string' }, background: { type: 'string' }, camera: { type: 'boolean' }, zoom: { type: 'string' },\n captions: { type: 'string' }, ai: { type: 'string' }, 'ai-vision': { type: 'string' }, alt: { type: 'boolean' },\n voice: { type: 'string' }, script: { type: 'string' }, 'voice-out': { type: 'string' }, 'voice-strict': { type: 'boolean' }, 'no-voice-cache': { type: 'boolean' },\n repair: { type: 'boolean' }, 'repair-vision': { type: 'boolean' },\n },\n });\n if (values.help) throw new UsageError('');\n const trace = positionals[0];\n if (!trace) throw new UsageError('a trace file is needed');\n if (positionals.length > 1) throw new UsageError(`one trace at a time (got ${positionals.join(', ')})`);\n if (!values.url) throw new UsageError('--url is needed');\n if (!values.out?.length) throw new UsageError('--out is needed');\n const num = (name: string, v: string | undefined, min = 0) => {\n if (v === undefined) return undefined;\n const n = Number(v);\n if (!Number.isFinite(n) || n < min) throw new UsageError(`--${name} must be a number ≥ ${min}`);\n return n;\n };\n const mode = values.mode ?? 'overlay';\n if (mode !== 'overlay' && mode !== 'perform') throw new UsageError('--mode is overlay or perform');\n let viewport: { w: number; h: number } | undefined;\n if (values.viewport) {\n const m = /^(\\d+)x(\\d+)$/i.exec(values.viewport);\n if (!m) throw new UsageError('--viewport is WIDTHxHEIGHT, e.g. 1280x800');\n viewport = { w: Number(m[1]), h: Number(m[2]) };\n }\n if (values.frame && values.frame !== 'none' && values.frame !== 'browser') throw new UsageError('--frame is none or browser');\n const captions = values.captions;\n if (captions !== undefined && captions !== 'burn' && captions !== 'vtt' && captions !== 'both') throw new UsageError('--captions is burn, vtt or both');\n const zoom = num('zoom', values.zoom, 1);\n if (extra.qa !== undefined && extra.qa !== true && extra.qa !== 'strict') throw new UsageError('--qa takes nothing or strict');\n if ((extra.qa !== undefined || values.alt || values['ai-vision']) && !values.ai) throw new UsageError('--qa, --alt and --ai-vision need --ai');\n if (values['repair-vision'] && !(values.repair && values.ai)) throw new UsageError('--repair-vision needs --repair and --ai');\n if ((values.script || values['voice-out'] || values['voice-strict'] || values['no-voice-cache']) && !values.voice) throw new UsageError('--script, --voice-out, --voice-strict and --no-voice-cache need --voice');\n if (values.voice && !values.out.some((f) => /\\.mp4$/i.test(f))) throw new UsageError('--voice needs an .mp4 output (a GIF has no sound)');\n const width = num('width', values.width, 16);\n const fps = num('fps', values.fps, 1);\n const maxWait = num('max-wait', values['max-wait']);\n return {\n trace,\n options: {\n trace,\n url: values.url,\n mode,\n allowPerform: !!values['allow-perform'],\n out: values.out.map((file) => ({ file, ...(width ? { width } : {}), ...(fps ? { fps } : {}) })),\n ...(viewport ? { viewport } : {}),\n ...(values.scale ? { scale: num('scale', values.scale, 1) } : {}),\n ...(values['storage-state'] ? { storageState: values['storage-state'] } : {}),\n ...(maxWait !== undefined ? { cuts: { maxWaitMs: maxWait } } : {}),\n ...(values.hide ? { hide: values.hide } : {}),\n ...(values.blur ? { blur: values.blur } : {}),\n allowStall: !!values['allow-stall'],\n ...(values.player ? { player: values.player } : {}),\n ...(values.timeline ? { timeline: values.timeline } : {}),\n ...(values.timeout ? { timeoutMs: num('timeout', values.timeout, 1) } : {}),\n headless: !values.headed,\n ...(values.frame ? { frame: values.frame as 'none' | 'browser' } : {}),\n ...(values.background ? { background: values.background } : {}),\n ...(zoom ? { camera: { zoom } } : values.camera ? { camera: true } : {}),\n ...(captions ? { captions } : {}),\n ...(extra.poster !== undefined ? { poster: extra.poster } : {}),\n ...(extra.title !== undefined ? { titleCard: extra.title } : {}),\n ...(extra.end !== undefined ? { endCard: extra.end } : {}),\n ...(extra.qa !== undefined ? { qa: true } : {}),\n ...(values.alt ? { alt: true } : {}),\n ...(values.script ? { script: values.script } : {}),\n ...(values['voice-out'] ? { voiceOut: values['voice-out'] } : {}),\n ...(values['voice-strict'] ? { voiceStrict: true } : {}),\n ...(values.repair ? { repair: true } : {}),\n ...(values['repair-vision'] ? { repairVision: true } : {}),\n },\n ...(values.ai ? { ai: values.ai } : {}),\n ...(values['ai-vision'] ? { aiVision: values['ai-vision'] } : {}),\n ...(values.voice ? { voice: values.voice } : {}),\n ...(values['no-voice-cache'] ? { noVoiceCache: true } : {}),\n ...(extra.qa === 'strict' ? { strict: true } : {}),\n };\n}\n\nexport class UsageError extends Error {}\n\nexport async function main(argv: string[], io = { log: console.log, error: console.error }): Promise<number> {\n if (argv[0] === 'suggest' || argv[0] === 'apply') {\n try { return await (argv[0] === 'suggest' ? suggestCmd(argv.slice(1), io) : applyCmd(argv.slice(1), io)); } catch (e) {\n io.error(`trace-avatar-render ${argv[0]}: ${(e as Error).message}`);\n if (e instanceof UsageError) io.error(USAGE);\n return e instanceof UsageError ? 2 : 1;\n }\n }\n let p: Parsed;\n try { p = parse(argv); } catch (e) {\n const msg = (e as Error).message;\n if (msg) io.error(`trace-avatar-render: ${msg}\\n`);\n io.error(USAGE);\n return e instanceof UsageError && !msg ? 0 : 2;\n }\n try {\n if (p.ai) p.options.ai = await providerOf(p.ai, process.env, p.aiVision ? { vision: p.aiVision } : {});\n if (p.voice) p.options.voice = await voiceOf(p.voice, process.env, p.noVoiceCache ? { cacheDir: null } : {});\n const r = await render(p.options);\n for (const o of r.outputs) io.log(`${o.file} ${o.width}×${o.height} ${o.fps} fps ${(r.durationMs / 1000).toFixed(1)} s ${(o.bytes / 1024).toFixed(0)} KB`);\n if (r.rawMs > r.durationMs + 50) io.log(`cut ${((r.rawMs - r.durationMs) / 1000).toFixed(1)} s of waiting`);\n for (const f of [r.poster, r.vtt, r.chapters, r.alt]) if (f) io.log(f);\n if (r.narration) {\n io.log(`narration: ${r.narration.lines.length} line${r.narration.lines.length === 1 ? '' : 's'}${r.narration.holdMs ? `, the video holds ${(r.narration.holdMs / 1000).toFixed(1)} s for them` : ''} ${r.narration.text}`);\n if (r.narration.wav) io.log(r.narration.wav);\n }\n for (const w of r.warnings ?? []) io.error(`warning: ${w}`);\n if (r.qa) {\n if (!r.qa.length) io.log('qa: nothing flagged');\n for (const f of r.qa) io.log(`qa: ${(f.at / 1000).toFixed(1)} s ${f.kind} ${f.note}`);\n if (p.strict && r.qa.length) { io.error(`trace-avatar-render: qa flagged ${r.qa.length} problem${r.qa.length > 1 ? 's' : ''} (--qa strict)`); return 1; }\n }\n return 0;\n } catch (e) {\n io.error(`trace-avatar-render: ${(e as Error).message}`);\n if (e instanceof RenderError && e.screenshot) {\n const first = p.options.out[0];\n const shot = `${(typeof first === 'string' ? first : first.file).replace(/\\.[^./]+$/, '')}.failure.png`;\n writeFileSync(shot, e.screenshot);\n io.error(`the page at that moment: ${shot}`);\n }\n return 1;\n }\n}\n\nconst readJson = (file: string): unknown => {\n try { return JSON.parse(readFileSync(file, 'utf8')); } catch (e) { throw new Error(`could not read ${file}: ${(e as Error).message}`); }\n};\n\n/** suggest <trace.json> --task … --ai …: suggestions, numbered, as JSON (stdout or --out). */\nasync function suggestCmd(argv: string[], io: { log: (m: string) => void }): Promise<number> {\n const { values, positionals } = parseArgs({ args: argv, allowPositionals: true, options: {\n task: { type: 'string' }, ai: { type: 'string' }, tone: { type: 'string' }, hints: { type: 'string' }, out: { type: 'string' }, 'send-typed': { type: 'boolean' },\n } });\n const [file] = positionals;\n if (!file) throw new UsageError('suggest needs a trace file');\n const task = values.task;\n if (task !== 'captions' && task !== 'title' && task !== 'waits' && task !== 'narration') throw new UsageError('--task is captions, title, waits or narration');\n if (!values.ai) throw new UsageError('suggest needs --ai');\n if (task === 'narration') {\n // A script file for --script: a person edits it before rendering.\n const r = await suggestScript(await providerOf(values.ai), readJson(file) as Parameters<typeof suggestScript>[1]);\n const out = JSON.stringify({ ...r.script, ...(r.dropped.length ? { dropped: r.dropped } : {}) }, null, 2);\n if (values.out) { writeFileSync(values.out, `${out}\\n`); io.log(`${r.script.lines.length} line${r.script.lines.length === 1 ? '' : 's'} in ${values.out}: edit them, then --script ${values.out}`); } else io.log(out);\n return 0;\n }\n const tone = values.tone;\n if (tone !== undefined && tone !== 'friendly' && tone !== 'terse' && tone !== 'formal') throw new UsageError('--tone is friendly, terse or formal');\n const trace = readJson(file) as Parameters<typeof suggest>[1];\n const hints = values.hints ? (readJson(values.hints) as Parameters<typeof suggest>[2]['hints']) : undefined;\n const r = await suggest(task, trace, { ai: await providerOf(values.ai), ...(hints ? { hints } : {}), ...(tone ? { tone } : {}), ...(values['send-typed'] ? { sendTyped: true } : {}) });\n const out = JSON.stringify({ task, suggestions: r.suggestions.map((sg, k) => ({ id: k + 1, ...sg })), dropped: r.dropped }, null, 2);\n if (values.out) { writeFileSync(values.out, `${out}\\n`); io.log(`${r.suggestions.length} suggestion${r.suggestions.length === 1 ? '' : 's'} in ${values.out}`); } else io.log(out);\n return 0;\n}\n\n/** apply <trace.json> <suggestions.json> --accept 1,3|all --out new.trace.json */\nasync function applyCmd(argv: string[], io: { log: (m: string) => void }): Promise<number> {\n const { values, positionals } = parseArgs({ args: argv, allowPositionals: true, options: { accept: { type: 'string' }, out: { type: 'string' } } });\n const [file, sugFile] = positionals;\n if (!file || !sugFile) throw new UsageError('apply needs a trace file and a suggestions file');\n if (!values.accept) throw new UsageError('apply needs --accept 1,3 (or all): a person picks what goes in');\n if (!values.out) throw new UsageError('apply needs --out for the new trace');\n const all = (readJson(sugFile) as { suggestions?: Array<Suggestion & { id: number }> }).suggestions ?? [];\n const ids = values.accept === 'all' ? all.map((x) => x.id) : values.accept.split(',').map((x) => Number(x.trim()));\n const missing = ids.filter((id) => !all.some((x) => x.id === id));\n if (missing.length) throw new UsageError(`no suggestion ${missing.join(', ')} in ${sugFile}`);\n const next = applySuggestions(readJson(file) as Parameters<typeof applySuggestions>[0], all.filter((x) => ids.includes(x.id)));\n writeFileSync(values.out, `${JSON.stringify(next, null, 2)}\\n`);\n io.log(`applied ${ids.length} of ${all.length} to ${values.out}`);\n return 0;\n}\n\nconst isMain = import.meta.url === `file://${process.argv[1]}` || process.argv[1]?.endsWith('/trace-avatar-render') || process.argv[1]?.endsWith('/cli.js');\nif (isMain) void main(process.argv.slice(2)).then((code) => { process.exitCode = code; });\n"],"mappings":";;;;;;;;;;AAOA,SAAS,cAAc,qBAAqB;AAC5C,SAAS,SAAS,kBAAkB,eAAe;AAKnD,SAAS,iBAAiB;AAInB,IAAM,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA4Dd,SAAS,MAAM,MAAwB;AAG5C,QAAM,QAAoG,CAAC;AAC3G,QAAM,QAA2D,EAAE,YAAY,UAAU,gBAAgB,SAAS,cAAc,OAAO,QAAQ,KAAK;AACpJ,QAAM,OAAiB,CAAC;AACxB,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK,GAAG;AACvC,UAAM,IAAI,KAAK,CAAC;AAChB,UAAM,KAAK,EAAE,QAAQ,GAAG;AACxB,UAAM,OAAO,KAAK,IAAI,EAAE,MAAM,GAAG,EAAE,IAAI;AACvC,QAAI,MAAM,IAAI,GAAG;AACf,UAAI,KAAK,EAAG,OAAM,MAAM,IAAI,CAAC,IAAI,EAAE,MAAM,KAAK,CAAC;AAAA,eACtC,KAAK,IAAI,CAAC,MAAM,UAAa,CAAC,KAAK,IAAI,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC,WAAW,KAAK,KAAK,IAAI,CAAC,CAAC,MAAM,MAAM,IAAI,MAAM,QAAQ,KAAK,IAAI,CAAC,MAAM,WAAW;AAAE,cAAM,MAAM,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC;AAAG,aAAK;AAAA,MAAG,MAClM,OAAM,MAAM,IAAI,CAAC,IAAI;AAC1B;AAAA,IACF;AACA,SAAK,KAAK,CAAC;AAAA,EACb;AACA,QAAM,EAAE,QAAQ,YAAY,IAAI,UAAU;AAAA,IACxC,MAAM;AAAA,IACN,kBAAkB;AAAA,IAClB,SAAS;AAAA,MACP,KAAK,EAAE,MAAM,SAAS;AAAA,MAAG,KAAK,EAAE,MAAM,UAAU,UAAU,KAAK;AAAA,MAAG,MAAM,EAAE,MAAM,SAAS;AAAA,MACzF,iBAAiB,EAAE,MAAM,UAAU;AAAA,MAAG,OAAO,EAAE,MAAM,SAAS;AAAA,MAAG,KAAK,EAAE,MAAM,SAAS;AAAA,MACvF,UAAU,EAAE,MAAM,SAAS;AAAA,MAAG,OAAO,EAAE,MAAM,SAAS;AAAA,MAAG,iBAAiB,EAAE,MAAM,SAAS;AAAA,MAC3F,YAAY,EAAE,MAAM,SAAS;AAAA,MAAG,MAAM,EAAE,MAAM,UAAU,UAAU,KAAK;AAAA,MAAG,MAAM,EAAE,MAAM,UAAU,UAAU,KAAK;AAAA,MACjH,eAAe,EAAE,MAAM,UAAU;AAAA,MAAG,QAAQ,EAAE,MAAM,SAAS;AAAA,MAAG,UAAU,EAAE,MAAM,SAAS;AAAA,MAC3F,SAAS,EAAE,MAAM,SAAS;AAAA,MAAG,QAAQ,EAAE,MAAM,UAAU;AAAA,MAAG,MAAM,EAAE,MAAM,WAAW,OAAO,IAAI;AAAA,MAC9F,OAAO,EAAE,MAAM,SAAS;AAAA,MAAG,YAAY,EAAE,MAAM,SAAS;AAAA,MAAG,QAAQ,EAAE,MAAM,UAAU;AAAA,MAAG,MAAM,EAAE,MAAM,SAAS;AAAA,MAC/G,UAAU,EAAE,MAAM,SAAS;AAAA,MAAG,IAAI,EAAE,MAAM,SAAS;AAAA,MAAG,aAAa,EAAE,MAAM,SAAS;AAAA,MAAG,KAAK,EAAE,MAAM,UAAU;AAAA,MAC9G,OAAO,EAAE,MAAM,SAAS;AAAA,MAAG,QAAQ,EAAE,MAAM,SAAS;AAAA,MAAG,aAAa,EAAE,MAAM,SAAS;AAAA,MAAG,gBAAgB,EAAE,MAAM,UAAU;AAAA,MAAG,kBAAkB,EAAE,MAAM,UAAU;AAAA,MACjK,QAAQ,EAAE,MAAM,UAAU;AAAA,MAAG,iBAAiB,EAAE,MAAM,UAAU;AAAA,IAClE;AAAA,EACF,CAAC;AACD,MAAI,OAAO,KAAM,OAAM,IAAI,WAAW,EAAE;AACxC,QAAM,QAAQ,YAAY,CAAC;AAC3B,MAAI,CAAC,MAAO,OAAM,IAAI,WAAW,wBAAwB;AACzD,MAAI,YAAY,SAAS,EAAG,OAAM,IAAI,WAAW,4BAA4B,YAAY,KAAK,IAAI,CAAC,GAAG;AACtG,MAAI,CAAC,OAAO,IAAK,OAAM,IAAI,WAAW,iBAAiB;AACvD,MAAI,CAAC,OAAO,KAAK,OAAQ,OAAM,IAAI,WAAW,iBAAiB;AAC/D,QAAM,MAAM,CAAC,MAAc,GAAuB,MAAM,MAAM;AAC5D,QAAI,MAAM,OAAW,QAAO;AAC5B,UAAM,IAAI,OAAO,CAAC;AAClB,QAAI,CAAC,OAAO,SAAS,CAAC,KAAK,IAAI,IAAK,OAAM,IAAI,WAAW,KAAK,IAAI,4BAAuB,GAAG,EAAE;AAC9F,WAAO;AAAA,EACT;AACA,QAAM,OAAO,OAAO,QAAQ;AAC5B,MAAI,SAAS,aAAa,SAAS,UAAW,OAAM,IAAI,WAAW,8BAA8B;AACjG,MAAI;AACJ,MAAI,OAAO,UAAU;AACnB,UAAM,IAAI,iBAAiB,KAAK,OAAO,QAAQ;AAC/C,QAAI,CAAC,EAAG,OAAM,IAAI,WAAW,2CAA2C;AACxE,eAAW,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,GAAG,GAAG,OAAO,EAAE,CAAC,CAAC,EAAE;AAAA,EAChD;AACA,MAAI,OAAO,SAAS,OAAO,UAAU,UAAU,OAAO,UAAU,UAAW,OAAM,IAAI,WAAW,4BAA4B;AAC5H,QAAM,WAAW,OAAO;AACxB,MAAI,aAAa,UAAa,aAAa,UAAU,aAAa,SAAS,aAAa,OAAQ,OAAM,IAAI,WAAW,iCAAiC;AACtJ,QAAM,OAAO,IAAI,QAAQ,OAAO,MAAM,CAAC;AACvC,MAAI,MAAM,OAAO,UAAa,MAAM,OAAO,QAAQ,MAAM,OAAO,SAAU,OAAM,IAAI,WAAW,8BAA8B;AAC7H,OAAK,MAAM,OAAO,UAAa,OAAO,OAAO,OAAO,WAAW,MAAM,CAAC,OAAO,GAAI,OAAM,IAAI,WAAW,uCAAuC;AAC7I,MAAI,OAAO,eAAe,KAAK,EAAE,OAAO,UAAU,OAAO,IAAK,OAAM,IAAI,WAAW,yCAAyC;AAC5H,OAAK,OAAO,UAAU,OAAO,WAAW,KAAK,OAAO,cAAc,KAAK,OAAO,gBAAgB,MAAM,CAAC,OAAO,MAAO,OAAM,IAAI,WAAW,yEAAyE;AACjN,MAAI,OAAO,SAAS,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,UAAU,KAAK,CAAC,CAAC,EAAG,OAAM,IAAI,WAAW,mDAAmD;AACxI,QAAM,QAAQ,IAAI,SAAS,OAAO,OAAO,EAAE;AAC3C,QAAM,MAAM,IAAI,OAAO,OAAO,KAAK,CAAC;AACpC,QAAM,UAAU,IAAI,YAAY,OAAO,UAAU,CAAC;AAClD,SAAO;AAAA,IACL;AAAA,IACA,SAAS;AAAA,MACP;AAAA,MACA,KAAK,OAAO;AAAA,MACZ;AAAA,MACA,cAAc,CAAC,CAAC,OAAO,eAAe;AAAA,MACtC,KAAK,OAAO,IAAI,IAAI,CAAC,UAAU,EAAE,MAAM,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC,GAAI,GAAI,MAAM,EAAE,IAAI,IAAI,CAAC,EAAG,EAAE;AAAA,MAC9F,GAAI,WAAW,EAAE,SAAS,IAAI,CAAC;AAAA,MAC/B,GAAI,OAAO,QAAQ,EAAE,OAAO,IAAI,SAAS,OAAO,OAAO,CAAC,EAAE,IAAI,CAAC;AAAA,MAC/D,GAAI,OAAO,eAAe,IAAI,EAAE,cAAc,OAAO,eAAe,EAAE,IAAI,CAAC;AAAA,MAC3E,GAAI,YAAY,SAAY,EAAE,MAAM,EAAE,WAAW,QAAQ,EAAE,IAAI,CAAC;AAAA,MAChE,GAAI,OAAO,OAAO,EAAE,MAAM,OAAO,KAAK,IAAI,CAAC;AAAA,MAC3C,GAAI,OAAO,OAAO,EAAE,MAAM,OAAO,KAAK,IAAI,CAAC;AAAA,MAC3C,YAAY,CAAC,CAAC,OAAO,aAAa;AAAA,MAClC,GAAI,OAAO,SAAS,EAAE,QAAQ,OAAO,OAAO,IAAI,CAAC;AAAA,MACjD,GAAI,OAAO,WAAW,EAAE,UAAU,OAAO,SAAS,IAAI,CAAC;AAAA,MACvD,GAAI,OAAO,UAAU,EAAE,WAAW,IAAI,WAAW,OAAO,SAAS,CAAC,EAAE,IAAI,CAAC;AAAA,MACzE,UAAU,CAAC,OAAO;AAAA,MAClB,GAAI,OAAO,QAAQ,EAAE,OAAO,OAAO,MAA4B,IAAI,CAAC;AAAA,MACpE,GAAI,OAAO,aAAa,EAAE,YAAY,OAAO,WAAW,IAAI,CAAC;AAAA,MAC7D,GAAI,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,OAAO,SAAS,EAAE,QAAQ,KAAK,IAAI,CAAC;AAAA,MACtE,GAAI,WAAW,EAAE,SAAS,IAAI,CAAC;AAAA,MAC/B,GAAI,MAAM,WAAW,SAAY,EAAE,QAAQ,MAAM,OAAO,IAAI,CAAC;AAAA,MAC7D,GAAI,MAAM,UAAU,SAAY,EAAE,WAAW,MAAM,MAAM,IAAI,CAAC;AAAA,MAC9D,GAAI,MAAM,QAAQ,SAAY,EAAE,SAAS,MAAM,IAAI,IAAI,CAAC;AAAA,MACxD,GAAI,MAAM,OAAO,SAAY,EAAE,IAAI,KAAK,IAAI,CAAC;AAAA,MAC7C,GAAI,OAAO,MAAM,EAAE,KAAK,KAAK,IAAI,CAAC;AAAA,MAClC,GAAI,OAAO,SAAS,EAAE,QAAQ,OAAO,OAAO,IAAI,CAAC;AAAA,MACjD,GAAI,OAAO,WAAW,IAAI,EAAE,UAAU,OAAO,WAAW,EAAE,IAAI,CAAC;AAAA,MAC/D,GAAI,OAAO,cAAc,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;AAAA,MACtD,GAAI,OAAO,SAAS,EAAE,QAAQ,KAAK,IAAI,CAAC;AAAA,MACxC,GAAI,OAAO,eAAe,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;AAAA,IAC1D;AAAA,IACA,GAAI,OAAO,KAAK,EAAE,IAAI,OAAO,GAAG,IAAI,CAAC;AAAA,IACrC,GAAI,OAAO,WAAW,IAAI,EAAE,UAAU,OAAO,WAAW,EAAE,IAAI,CAAC;AAAA,IAC/D,GAAI,OAAO,QAAQ,EAAE,OAAO,OAAO,MAAM,IAAI,CAAC;AAAA,IAC9C,GAAI,OAAO,gBAAgB,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;AAAA,IACzD,GAAI,MAAM,OAAO,WAAW,EAAE,QAAQ,KAAK,IAAI,CAAC;AAAA,EAClD;AACF;AAEO,IAAM,aAAN,cAAyB,MAAM;AAAC;AAEvC,eAAsB,KAAK,MAAgB,KAAK,EAAE,KAAK,QAAQ,KAAK,OAAO,QAAQ,MAAM,GAAoB;AAC3G,MAAI,KAAK,CAAC,MAAM,aAAa,KAAK,CAAC,MAAM,SAAS;AAChD,QAAI;AAAE,aAAO,OAAO,KAAK,CAAC,MAAM,YAAY,WAAW,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,SAAS,KAAK,MAAM,CAAC,GAAG,EAAE;AAAA,IAAI,SAAS,GAAG;AACpH,SAAG,MAAM,uBAAuB,KAAK,CAAC,CAAC,KAAM,EAAY,OAAO,EAAE;AAClE,UAAI,aAAa,WAAY,IAAG,MAAM,KAAK;AAC3C,aAAO,aAAa,aAAa,IAAI;AAAA,IACvC;AAAA,EACF;AACA,MAAI;AACJ,MAAI;AAAE,QAAI,MAAM,IAAI;AAAA,EAAG,SAAS,GAAG;AACjC,UAAM,MAAO,EAAY;AACzB,QAAI,IAAK,IAAG,MAAM,wBAAwB,GAAG;AAAA,CAAI;AACjD,OAAG,MAAM,KAAK;AACd,WAAO,aAAa,cAAc,CAAC,MAAM,IAAI;AAAA,EAC/C;AACA,MAAI;AACF,QAAI,EAAE,GAAI,GAAE,QAAQ,KAAK,MAAM,WAAW,EAAE,IAAI,QAAQ,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,IAAI,CAAC,CAAC;AACrG,QAAI,EAAE,MAAO,GAAE,QAAQ,QAAQ,MAAM,QAAQ,EAAE,OAAO,QAAQ,KAAK,EAAE,eAAe,EAAE,UAAU,KAAK,IAAI,CAAC,CAAC;AAC3G,UAAM,IAAI,MAAM,OAAO,EAAE,OAAO;AAChC,eAAW,KAAK,EAAE,QAAS,IAAG,IAAI,GAAG,EAAE,IAAI,KAAK,EAAE,KAAK,OAAI,EAAE,MAAM,KAAK,EAAE,GAAG,UAAU,EAAE,aAAa,KAAM,QAAQ,CAAC,CAAC,QAAQ,EAAE,QAAQ,MAAM,QAAQ,CAAC,CAAC,KAAK;AAC7J,QAAI,EAAE,QAAQ,EAAE,aAAa,GAAI,IAAG,IAAI,SAAS,EAAE,QAAQ,EAAE,cAAc,KAAM,QAAQ,CAAC,CAAC,eAAe;AAC1G,eAAW,KAAK,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,EAAG,KAAI,EAAG,IAAG,IAAI,CAAC;AACrE,QAAI,EAAE,WAAW;AACf,SAAG,IAAI,cAAc,EAAE,UAAU,MAAM,MAAM,QAAQ,EAAE,UAAU,MAAM,WAAW,IAAI,KAAK,GAAG,GAAG,EAAE,UAAU,SAAS,sBAAsB,EAAE,UAAU,SAAS,KAAM,QAAQ,CAAC,CAAC,gBAAgB,EAAE,KAAK,EAAE,UAAU,IAAI,EAAE;AAC1N,UAAI,EAAE,UAAU,IAAK,IAAG,IAAI,EAAE,UAAU,GAAG;AAAA,IAC7C;AACA,eAAW,KAAK,EAAE,YAAY,CAAC,EAAG,IAAG,MAAM,YAAY,CAAC,EAAE;AAC1D,QAAI,EAAE,IAAI;AACR,UAAI,CAAC,EAAE,GAAG,OAAQ,IAAG,IAAI,qBAAqB;AAC9C,iBAAW,KAAK,EAAE,GAAI,IAAG,IAAI,QAAQ,EAAE,KAAK,KAAM,QAAQ,CAAC,CAAC,OAAO,EAAE,IAAI,KAAK,EAAE,IAAI,EAAE;AACtF,UAAI,EAAE,UAAU,EAAE,GAAG,QAAQ;AAAE,WAAG,MAAM,mCAAmC,EAAE,GAAG,MAAM,WAAW,EAAE,GAAG,SAAS,IAAI,MAAM,EAAE,gBAAgB;AAAG,eAAO;AAAA,MAAG;AAAA,IAC1J;AACA,WAAO;AAAA,EACT,SAAS,GAAG;AACV,OAAG,MAAM,wBAAyB,EAAY,OAAO,EAAE;AACvD,QAAI,aAAa,eAAe,EAAE,YAAY;AAC5C,YAAM,QAAQ,EAAE,QAAQ,IAAI,CAAC;AAC7B,YAAM,OAAO,IAAI,OAAO,UAAU,WAAW,QAAQ,MAAM,MAAM,QAAQ,aAAa,EAAE,CAAC;AACzF,oBAAc,MAAM,EAAE,UAAU;AAChC,SAAG,MAAM,4BAA4B,IAAI,EAAE;AAAA,IAC7C;AACA,WAAO;AAAA,EACT;AACF;AAEA,IAAM,WAAW,CAAC,SAA0B;AAC1C,MAAI;AAAE,WAAO,KAAK,MAAM,aAAa,MAAM,MAAM,CAAC;AAAA,EAAG,SAAS,GAAG;AAAE,UAAM,IAAI,MAAM,kBAAkB,IAAI,KAAM,EAAY,OAAO,EAAE;AAAA,EAAG;AACzI;AAGA,eAAe,WAAW,MAAgB,IAAmD;AAC3F,QAAM,EAAE,QAAQ,YAAY,IAAI,UAAU,EAAE,MAAM,MAAM,kBAAkB,MAAM,SAAS;AAAA,IACvF,MAAM,EAAE,MAAM,SAAS;AAAA,IAAG,IAAI,EAAE,MAAM,SAAS;AAAA,IAAG,MAAM,EAAE,MAAM,SAAS;AAAA,IAAG,OAAO,EAAE,MAAM,SAAS;AAAA,IAAG,KAAK,EAAE,MAAM,SAAS;AAAA,IAAG,cAAc,EAAE,MAAM,UAAU;AAAA,EAClK,EAAE,CAAC;AACH,QAAM,CAAC,IAAI,IAAI;AACf,MAAI,CAAC,KAAM,OAAM,IAAI,WAAW,4BAA4B;AAC5D,QAAM,OAAO,OAAO;AACpB,MAAI,SAAS,cAAc,SAAS,WAAW,SAAS,WAAW,SAAS,YAAa,OAAM,IAAI,WAAW,+CAA+C;AAC7J,MAAI,CAAC,OAAO,GAAI,OAAM,IAAI,WAAW,oBAAoB;AACzD,MAAI,SAAS,aAAa;AAExB,UAAMA,KAAI,MAAM,cAAc,MAAM,WAAW,OAAO,EAAE,GAAG,SAAS,IAAI,CAAwC;AAChH,UAAMC,OAAM,KAAK,UAAU,EAAE,GAAGD,GAAE,QAAQ,GAAIA,GAAE,QAAQ,SAAS,EAAE,SAASA,GAAE,QAAQ,IAAI,CAAC,EAAG,GAAG,MAAM,CAAC;AACxG,QAAI,OAAO,KAAK;AAAE,oBAAc,OAAO,KAAK,GAAGC,IAAG;AAAA,CAAI;AAAG,SAAG,IAAI,GAAGD,GAAE,OAAO,MAAM,MAAM,QAAQA,GAAE,OAAO,MAAM,WAAW,IAAI,KAAK,GAAG,OAAO,OAAO,GAAG,8BAA8B,OAAO,GAAG,EAAE;AAAA,IAAG,MAAO,IAAG,IAAIC,IAAG;AACrN,WAAO;AAAA,EACT;AACA,QAAM,OAAO,OAAO;AACpB,MAAI,SAAS,UAAa,SAAS,cAAc,SAAS,WAAW,SAAS,SAAU,OAAM,IAAI,WAAW,qCAAqC;AAClJ,QAAM,QAAQ,SAAS,IAAI;AAC3B,QAAM,QAAQ,OAAO,QAAS,SAAS,OAAO,KAAK,IAA+C;AAClG,QAAM,IAAI,MAAM,QAAQ,MAAM,OAAO,EAAE,IAAI,MAAM,WAAW,OAAO,EAAE,GAAG,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC,GAAI,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC,GAAI,GAAI,OAAO,YAAY,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC,EAAG,CAAC;AACtL,QAAM,MAAM,KAAK,UAAU,EAAE,MAAM,aAAa,EAAE,YAAY,IAAI,CAAC,IAAI,OAAO,EAAE,IAAI,IAAI,GAAG,GAAG,GAAG,EAAE,GAAG,SAAS,EAAE,QAAQ,GAAG,MAAM,CAAC;AACnI,MAAI,OAAO,KAAK;AAAE,kBAAc,OAAO,KAAK,GAAG,GAAG;AAAA,CAAI;AAAG,OAAG,IAAI,GAAG,EAAE,YAAY,MAAM,cAAc,EAAE,YAAY,WAAW,IAAI,KAAK,GAAG,OAAO,OAAO,GAAG,EAAE;AAAA,EAAG,MAAO,IAAG,IAAI,GAAG;AACjL,SAAO;AACT;AAGA,eAAe,SAAS,MAAgB,IAAmD;AACzF,QAAM,EAAE,QAAQ,YAAY,IAAI,UAAU,EAAE,MAAM,MAAM,kBAAkB,MAAM,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,GAAG,KAAK,EAAE,MAAM,SAAS,EAAE,EAAE,CAAC;AAClJ,QAAM,CAAC,MAAM,OAAO,IAAI;AACxB,MAAI,CAAC,QAAQ,CAAC,QAAS,OAAM,IAAI,WAAW,iDAAiD;AAC7F,MAAI,CAAC,OAAO,OAAQ,OAAM,IAAI,WAAW,gEAAgE;AACzG,MAAI,CAAC,OAAO,IAAK,OAAM,IAAI,WAAW,qCAAqC;AAC3E,QAAM,MAAO,SAAS,OAAO,EAA2D,eAAe,CAAC;AACxG,QAAM,MAAM,OAAO,WAAW,QAAQ,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,OAAO,OAAO,MAAM,GAAG,EAAE,IAAI,CAAC,MAAM,OAAO,EAAE,KAAK,CAAC,CAAC;AACjH,QAAM,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;AAChE,MAAI,QAAQ,OAAQ,OAAM,IAAI,WAAW,iBAAiB,QAAQ,KAAK,IAAI,CAAC,OAAO,OAAO,EAAE;AAC5F,QAAM,OAAO,iBAAiB,SAAS,IAAI,GAA6C,IAAI,OAAO,CAAC,MAAM,IAAI,SAAS,EAAE,EAAE,CAAC,CAAC;AAC7H,gBAAc,OAAO,KAAK,GAAG,KAAK,UAAU,MAAM,MAAM,CAAC,CAAC;AAAA,CAAI;AAC9D,KAAG,IAAI,WAAW,IAAI,MAAM,OAAO,IAAI,MAAM,OAAO,OAAO,GAAG,EAAE;AAChE,SAAO;AACT;AAEA,IAAM,SAAS,YAAY,QAAQ,UAAU,QAAQ,KAAK,CAAC,CAAC,MAAM,QAAQ,KAAK,CAAC,GAAG,SAAS,sBAAsB,KAAK,QAAQ,KAAK,CAAC,GAAG,SAAS,SAAS;AAC1J,IAAI,OAAQ,MAAK,KAAK,QAAQ,KAAK,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,SAAS;AAAE,UAAQ,WAAW;AAAM,CAAC;","names":["r","out"]}
1
+ {"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * trace-avatar-render invoice.trace.json --url http://localhost:3000/app --out invoice.gif --out invoice.mp4\n *\n * Exit codes: 0 rendered, 1 the render failed (a stalled guide, an error in the app), 2 wrong usage.\n */\n\nimport { existsSync, readFileSync, writeFileSync } from 'node:fs';\nimport { apply as applySuggestions, suggest } from 'trace-avatar/assist';\nimport type { Suggestion } from 'trace-avatar/assist';\nimport { providerOf } from './ai';\nimport { suggestScript } from './narration';\nimport { voiceOf } from './voice';\nimport { parseArgs } from 'node:util';\nimport { RenderError } from './capture';\nimport { render } from './render';\n\nexport const USAGE = `Usage: trace-avatar-render <trace.json> --url <page> --out <file.gif|file.mp4> [options]\n\n --url <url> the page the guide starts on (required)\n --out <file> .gif or .mp4; repeat for several (required)\n --mode <overlay|perform> Show me (default) or Do it for me\n --allow-perform needed for perform: it clicks and types for real (use a sandbox account)\n --width <px> output width (GIF default 800, MP4 the capture's)\n --fps <n> frames per second (GIF default 12, MP4 30)\n --viewport <WxH> default: the trace's meta.viewport, else 1280x800\n --scale <n> device pixel ratio of the capture (2 for crisp video)\n --storage-state <file> a signed-in Playwright session\n --max-wait <ms> waits longer than this are cut to it (default 800, 0 keeps them)\n --hide <selector> hidden before capture; repeatable\n --blur <selector> blurred before capture (as well as [data-trace-blur]); repeatable\n --allow-stall render a stalled guide anyway instead of failing\n --player <file> the trace-perform.min.js to use (default: the installed trace-avatar)\n --timeline <file> write the timeline and the cuts as JSON\n --timeout <ms> give up after this long (default 120000)\n --report <file> write what happened as JSON: { outcome: passed|stalled|failed, step, reason, message }\n (for CI: one result per guide, whatever the exit code)\n --headed show the browser\n\n Polish (all off by default):\n --frame <none|browser> a browser window around the app, on a background\n --background <css> the background behind the window and on the cards\n --camera zoom in on each action and pan between close ones\n --zoom <n> how far the camera goes in (default 1.6; implies --camera)\n --captions <burn|vtt|both> burn the steps' words in, write <out>.vtt + <out>.chapters.vtt, or both\n --poster [file] a PNG at the first click (default <out>.png)\n --title-card [title] a 1.5 s card first (default: the trace's title)\n --end-card [title] a 2 s card last (default: \"Done\")\n\n AI (nothing calls a model without --ai):\n --ai <provider> gateway: our AI gateway (AI_GATEWAY_URL, AI_GATEWAY_KEY), DeepSeek first, then Gemini,\n then OpenAI; or gateway:<provider>[/<model>][,<provider>…]; openai:<model> (OPENAI_API_KEY,\n OPENAI_BASE_URL for any OpenAI-compatible server); or ./provider.js\n --ai-vision <model> the model for --qa's frames (gateway's DeepSeek default: deepseek-flash)\n --qa [strict] send a frame per step to the AI to look for errors, empty states, a stall, personal\n data; strict exits 1 when anything is flagged (needs a vision model)\n --alt write <out>.alt.txt; with --captions vtt, AI names the chapters\n --repair when a step can't find its element, or a wait's text never shows, propose a fix in\n <out>.repair.json (verified by playing again); still exits 1. With --ai, unsure\n cases are asked (DeepSeek first)\n --repair-vision with --repair and --ai: send a screenshot of the stalled page too (elements only)\n\n Narration (MP4 only; nothing speaks without --voice):\n --voice <voice> gateway (our AI gateway: Gemini speech, AI_GATEWAY_URL/KEY), gateway:gemini/<model>:<voice>,\n openai:<model>[:<voice>] (OPENAI_API_KEY / OPENAI_BASE_URL), say[:<voice>] (macOS, offline),\n or ./voice.js. Each step's caption is spoken; the video holds where a line runs long\n --script <file.json> the spoken lines instead: { \"lines\": [{ \"n\": 1, \"text\": \"…\" }] }\n --voice-out <file.wav> also write the narration track\n --voice-strict fail when a line needs a hold longer than 8 s\n --no-voice-cache don't keep spoken lines in .trace-avatar-cache/voice\n\nSuggestions for a person to accept (the renderer never changes a trace):\n trace-avatar-render suggest <trace.json> --task captions|title|waits|narration --ai <provider> [--tone friendly|terse|formal]\n [--hints hints.json] [--out suggestions.json]\n trace-avatar-render apply <trace.json> <suggestions.json> --accept 1,3|all --out <new.trace.json>\n`;\n\nexport interface Parsed { /** --report */ report?: string; trace: string; options: Parameters<typeof render>[0]; /** --ai, made into a provider by main(). */ ai?: string; /** --ai-vision */ aiVision?: string; /** --voice, made into a Voice by main() */ voice?: string; /** --no-voice-cache */ noVoiceCache?: boolean; /** --qa strict */ strict?: boolean }\n\n/** Parse the command line. Throws a usage message (exit 2) on mistakes. Exported for tests. */\nexport function parse(argv: string[]): Parsed {\n // --poster, --title-card and --end-card take an optional value: take it here when one follows (a\n // following *.json is the trace, not the value).\n const extra: { poster?: string | true; title?: string | true; end?: string | true; qa?: string | true } = {};\n const flags: Record<string, 'poster' | 'title' | 'end' | 'qa'> = { '--poster': 'poster', '--title-card': 'title', '--end-card': 'end', '--qa': 'qa' };\n const rest: string[] = [];\n for (let k = 0; k < argv.length; k += 1) {\n const a = argv[k];\n const eq = a.indexOf('=');\n const name = eq > 0 ? a.slice(0, eq) : a;\n if (flags[name]) {\n if (eq > 0) extra[flags[name]] = a.slice(eq + 1);\n else if (argv[k + 1] !== undefined && !argv[k + 1].startsWith('-') && !/\\.json$/i.test(argv[k + 1]) && (flags[name] !== 'qa' || argv[k + 1] === 'strict')) { extra[flags[name]] = argv[k + 1]; k += 1; }\n else extra[flags[name]] = true;\n continue;\n }\n rest.push(a);\n }\n const { values, positionals } = parseArgs({\n args: rest,\n allowPositionals: true,\n options: {\n url: { type: 'string' }, out: { type: 'string', multiple: true }, mode: { type: 'string' },\n 'allow-perform': { type: 'boolean' }, width: { type: 'string' }, fps: { type: 'string' },\n viewport: { type: 'string' }, scale: { type: 'string' }, 'storage-state': { type: 'string' },\n 'max-wait': { type: 'string' }, hide: { type: 'string', multiple: true }, blur: { type: 'string', multiple: true },\n 'allow-stall': { type: 'boolean' }, player: { type: 'string' }, timeline: { type: 'string' },\n timeout: { type: 'string' }, headed: { type: 'boolean' }, help: { type: 'boolean', short: 'h' },\n frame: { type: 'string' }, background: { type: 'string' }, camera: { type: 'boolean' }, zoom: { type: 'string' },\n captions: { type: 'string' }, ai: { type: 'string' }, 'ai-vision': { type: 'string' }, alt: { type: 'boolean' },\n voice: { type: 'string' }, script: { type: 'string' }, 'voice-out': { type: 'string' }, 'voice-strict': { type: 'boolean' }, 'no-voice-cache': { type: 'boolean' },\n repair: { type: 'boolean' }, 'repair-vision': { type: 'boolean' }, report: { type: 'string' },\n },\n });\n if (values.help) throw new UsageError('');\n const trace = positionals[0];\n if (!trace) throw new UsageError('a trace file is needed');\n if (positionals.length > 1) throw new UsageError(`one trace at a time (got ${positionals.join(', ')})`);\n if (!values.url) throw new UsageError('--url is needed');\n if (!values.out?.length) throw new UsageError('--out is needed');\n const num = (name: string, v: string | undefined, min = 0) => {\n if (v === undefined) return undefined;\n const n = Number(v);\n if (!Number.isFinite(n) || n < min) throw new UsageError(`--${name} must be a number ≥ ${min}`);\n return n;\n };\n const mode = values.mode ?? 'overlay';\n if (mode !== 'overlay' && mode !== 'perform') throw new UsageError('--mode is overlay or perform');\n let viewport: { w: number; h: number } | undefined;\n if (values.viewport) {\n const m = /^(\\d+)x(\\d+)$/i.exec(values.viewport);\n if (!m) throw new UsageError('--viewport is WIDTHxHEIGHT, e.g. 1280x800');\n viewport = { w: Number(m[1]), h: Number(m[2]) };\n }\n if (values.frame && values.frame !== 'none' && values.frame !== 'browser') throw new UsageError('--frame is none or browser');\n const captions = values.captions;\n if (captions !== undefined && captions !== 'burn' && captions !== 'vtt' && captions !== 'both') throw new UsageError('--captions is burn, vtt or both');\n const zoom = num('zoom', values.zoom, 1);\n if (extra.qa !== undefined && extra.qa !== true && extra.qa !== 'strict') throw new UsageError('--qa takes nothing or strict');\n if ((extra.qa !== undefined || values.alt || values['ai-vision']) && !values.ai) throw new UsageError('--qa, --alt and --ai-vision need --ai');\n if (values['repair-vision'] && !(values.repair && values.ai)) throw new UsageError('--repair-vision needs --repair and --ai');\n if ((values.script || values['voice-out'] || values['voice-strict'] || values['no-voice-cache']) && !values.voice) throw new UsageError('--script, --voice-out, --voice-strict and --no-voice-cache need --voice');\n if (values.voice && !values.out.some((f) => /\\.mp4$/i.test(f))) throw new UsageError('--voice needs an .mp4 output (a GIF has no sound)');\n const width = num('width', values.width, 16);\n const fps = num('fps', values.fps, 1);\n const maxWait = num('max-wait', values['max-wait']);\n return {\n trace,\n options: {\n trace,\n url: values.url,\n mode,\n allowPerform: !!values['allow-perform'],\n out: values.out.map((file) => ({ file, ...(width ? { width } : {}), ...(fps ? { fps } : {}) })),\n ...(viewport ? { viewport } : {}),\n ...(values.scale ? { scale: num('scale', values.scale, 1) } : {}),\n ...(values['storage-state'] ? { storageState: values['storage-state'] } : {}),\n ...(maxWait !== undefined ? { cuts: { maxWaitMs: maxWait } } : {}),\n ...(values.hide ? { hide: values.hide } : {}),\n ...(values.blur ? { blur: values.blur } : {}),\n allowStall: !!values['allow-stall'],\n ...(values.player ? { player: values.player } : {}),\n ...(values.timeline ? { timeline: values.timeline } : {}),\n ...(values.timeout ? { timeoutMs: num('timeout', values.timeout, 1) } : {}),\n headless: !values.headed,\n ...(values.frame ? { frame: values.frame as 'none' | 'browser' } : {}),\n ...(values.background ? { background: values.background } : {}),\n ...(zoom ? { camera: { zoom } } : values.camera ? { camera: true } : {}),\n ...(captions ? { captions } : {}),\n ...(extra.poster !== undefined ? { poster: extra.poster } : {}),\n ...(extra.title !== undefined ? { titleCard: extra.title } : {}),\n ...(extra.end !== undefined ? { endCard: extra.end } : {}),\n ...(extra.qa !== undefined ? { qa: true } : {}),\n ...(values.alt ? { alt: true } : {}),\n ...(values.script ? { script: values.script } : {}),\n ...(values['voice-out'] ? { voiceOut: values['voice-out'] } : {}),\n ...(values['voice-strict'] ? { voiceStrict: true } : {}),\n ...(values.repair ? { repair: true } : {}),\n ...(values['repair-vision'] ? { repairVision: true } : {}),\n },\n ...(values.ai ? { ai: values.ai } : {}),\n ...(values['ai-vision'] ? { aiVision: values['ai-vision'] } : {}),\n ...(values.voice ? { voice: values.voice } : {}),\n ...(values['no-voice-cache'] ? { noVoiceCache: true } : {}),\n ...(extra.qa === 'strict' ? { strict: true } : {}),\n ...(values.report ? { report: values.report } : {}),\n };\n}\n\n/** What --report writes: one guide's outcome, for CI. */\nexport interface Report {\n outcome: 'passed' | 'stalled' | 'failed';\n /** The stalled step (from 0); null otherwise. */\n step: number | null;\n reason: 'not-found' | 'until-timeout' | null;\n /** The stalled step's caption, or the error. */\n message: string | null;\n /** The repair file, when --repair wrote one. */\n repair?: string;\n}\n\n/** The report for a render's outcome (exported for tests). */\nexport function reportOf(err: unknown, traceFile: string, repairFile?: string): Report {\n if (!err) return { outcome: 'passed', step: null, reason: null, message: null };\n const stall = err instanceof RenderError ? err.stall : undefined;\n if (stall && Number.isInteger(stall.index)) {\n let say: string | null = null;\n try { say = ((JSON.parse(readFileSync(traceFile, 'utf8')) as { steps?: Array<{ say?: string }> }).steps?.[stall.index]?.say) ?? null; } catch { /* the error is enough */ }\n return {\n outcome: 'stalled', step: stall.index, reason: stall.reason === 'until-timeout' ? 'until-timeout' : 'not-found',\n message: say ?? (err as Error).message, ...(repairFile && existsSync(repairFile) ? { repair: repairFile } : {}),\n };\n }\n return { outcome: 'failed', step: null, reason: null, message: (err as Error)?.message ?? String(err) };\n}\n\nexport class UsageError extends Error {}\n\nexport async function main(argv: string[], io = { log: console.log, error: console.error }): Promise<number> {\n if (argv[0] === 'suggest' || argv[0] === 'apply') {\n try { return await (argv[0] === 'suggest' ? suggestCmd(argv.slice(1), io) : applyCmd(argv.slice(1), io)); } catch (e) {\n io.error(`trace-avatar-render ${argv[0]}: ${(e as Error).message}`);\n if (e instanceof UsageError) io.error(USAGE);\n return e instanceof UsageError ? 2 : 1;\n }\n }\n let p: Parsed;\n try { p = parse(argv); } catch (e) {\n const msg = (e as Error).message;\n if (msg) io.error(`trace-avatar-render: ${msg}\\n`);\n io.error(USAGE);\n return e instanceof UsageError && !msg ? 0 : 2;\n }\n try {\n if (p.ai) p.options.ai = await providerOf(p.ai, process.env, p.aiVision ? { vision: p.aiVision } : {});\n if (p.voice) p.options.voice = await voiceOf(p.voice, process.env, p.noVoiceCache ? { cacheDir: null } : {});\n const r = await render(p.options);\n for (const o of r.outputs) io.log(`${o.file} ${o.width}×${o.height} ${o.fps} fps ${(r.durationMs / 1000).toFixed(1)} s ${(o.bytes / 1024).toFixed(0)} KB`);\n if (r.rawMs > r.durationMs + 50) io.log(`cut ${((r.rawMs - r.durationMs) / 1000).toFixed(1)} s of waiting`);\n for (const f of [r.poster, r.vtt, r.chapters, r.alt]) if (f) io.log(f);\n if (r.narration) {\n io.log(`narration: ${r.narration.lines.length} line${r.narration.lines.length === 1 ? '' : 's'}${r.narration.holdMs ? `, the video holds ${(r.narration.holdMs / 1000).toFixed(1)} s for them` : ''} ${r.narration.text}`);\n if (r.narration.wav) io.log(r.narration.wav);\n }\n for (const w of r.warnings ?? []) io.error(`warning: ${w}`);\n if (p.report) writeFileSync(p.report, `${JSON.stringify(reportOf(null, p.trace), null, 2)}\\n`);\n if (r.qa) {\n if (!r.qa.length) io.log('qa: nothing flagged');\n for (const f of r.qa) io.log(`qa: ${(f.at / 1000).toFixed(1)} s ${f.kind} ${f.note}`);\n if (p.strict && r.qa.length) { io.error(`trace-avatar-render: qa flagged ${r.qa.length} problem${r.qa.length > 1 ? 's' : ''} (--qa strict)`); return 1; }\n }\n return 0;\n } catch (e) {\n io.error(`trace-avatar-render: ${(e as Error).message}`);\n if (p.report) {\n const first = p.options.out[0];\n const base = (typeof first === 'string' ? first : first.file).replace(/\\.[^./]+$/, '');\n writeFileSync(p.report, `${JSON.stringify(reportOf(e, p.trace, `${base}.repair.json`), null, 2)}\\n`);\n }\n if (e instanceof RenderError && e.screenshot) {\n const first = p.options.out[0];\n const shot = `${(typeof first === 'string' ? first : first.file).replace(/\\.[^./]+$/, '')}.failure.png`;\n writeFileSync(shot, e.screenshot);\n io.error(`the page at that moment: ${shot}`);\n }\n return 1;\n }\n}\n\nconst readJson = (file: string): unknown => {\n try { return JSON.parse(readFileSync(file, 'utf8')); } catch (e) { throw new Error(`could not read ${file}: ${(e as Error).message}`); }\n};\n\n/** suggest <trace.json> --task … --ai …: suggestions, numbered, as JSON (stdout or --out). */\nasync function suggestCmd(argv: string[], io: { log: (m: string) => void }): Promise<number> {\n const { values, positionals } = parseArgs({ args: argv, allowPositionals: true, options: {\n task: { type: 'string' }, ai: { type: 'string' }, tone: { type: 'string' }, hints: { type: 'string' }, out: { type: 'string' }, 'send-typed': { type: 'boolean' },\n } });\n const [file] = positionals;\n if (!file) throw new UsageError('suggest needs a trace file');\n const task = values.task;\n if (task !== 'captions' && task !== 'title' && task !== 'waits' && task !== 'narration') throw new UsageError('--task is captions, title, waits or narration');\n if (!values.ai) throw new UsageError('suggest needs --ai');\n if (task === 'narration') {\n // A script file for --script: a person edits it before rendering.\n const r = await suggestScript(await providerOf(values.ai), readJson(file) as Parameters<typeof suggestScript>[1]);\n const out = JSON.stringify({ ...r.script, ...(r.dropped.length ? { dropped: r.dropped } : {}) }, null, 2);\n if (values.out) { writeFileSync(values.out, `${out}\\n`); io.log(`${r.script.lines.length} line${r.script.lines.length === 1 ? '' : 's'} in ${values.out}: edit them, then --script ${values.out}`); } else io.log(out);\n return 0;\n }\n const tone = values.tone;\n if (tone !== undefined && tone !== 'friendly' && tone !== 'terse' && tone !== 'formal') throw new UsageError('--tone is friendly, terse or formal');\n const trace = readJson(file) as Parameters<typeof suggest>[1];\n const hints = values.hints ? (readJson(values.hints) as Parameters<typeof suggest>[2]['hints']) : undefined;\n const r = await suggest(task, trace, { ai: await providerOf(values.ai), ...(hints ? { hints } : {}), ...(tone ? { tone } : {}), ...(values['send-typed'] ? { sendTyped: true } : {}) });\n const out = JSON.stringify({ task, suggestions: r.suggestions.map((sg, k) => ({ id: k + 1, ...sg })), dropped: r.dropped }, null, 2);\n if (values.out) { writeFileSync(values.out, `${out}\\n`); io.log(`${r.suggestions.length} suggestion${r.suggestions.length === 1 ? '' : 's'} in ${values.out}`); } else io.log(out);\n return 0;\n}\n\n/** apply <trace.json> <suggestions.json> --accept 1,3|all --out new.trace.json */\nasync function applyCmd(argv: string[], io: { log: (m: string) => void }): Promise<number> {\n const { values, positionals } = parseArgs({ args: argv, allowPositionals: true, options: { accept: { type: 'string' }, out: { type: 'string' } } });\n const [file, sugFile] = positionals;\n if (!file || !sugFile) throw new UsageError('apply needs a trace file and a suggestions file');\n if (!values.accept) throw new UsageError('apply needs --accept 1,3 (or all): a person picks what goes in');\n if (!values.out) throw new UsageError('apply needs --out for the new trace');\n const all = (readJson(sugFile) as { suggestions?: Array<Suggestion & { id: number }> }).suggestions ?? [];\n const ids = values.accept === 'all' ? all.map((x) => x.id) : values.accept.split(',').map((x) => Number(x.trim()));\n const missing = ids.filter((id) => !all.some((x) => x.id === id));\n if (missing.length) throw new UsageError(`no suggestion ${missing.join(', ')} in ${sugFile}`);\n const next = applySuggestions(readJson(file) as Parameters<typeof applySuggestions>[0], all.filter((x) => ids.includes(x.id)));\n writeFileSync(values.out, `${JSON.stringify(next, null, 2)}\\n`);\n io.log(`applied ${ids.length} of ${all.length} to ${values.out}`);\n return 0;\n}\n\nconst isMain = import.meta.url === `file://${process.argv[1]}` || process.argv[1]?.endsWith('/trace-avatar-render') || process.argv[1]?.endsWith('/cli.js');\nif (isMain) void main(process.argv.slice(2)).then((code) => { process.exitCode = code; });\n"],"mappings":"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","names":["r","out"]}
package/dist/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  import { Page, Browser } from 'playwright';
2
- import { Ai, preview, Suggestion, Candidate, applyRaw } from 'trace-avatar/assist';
2
+ import { Ai, preview, Suggestion, Candidate, TextCandidate, applyRaw } from 'trace-avatar/assist';
3
3
 
4
4
  /**
5
5
  * The guide's own timeline, and the edit list made from it. PURE: plain numbers in, plain numbers out.
@@ -571,8 +571,9 @@ interface RenderOptions {
571
571
  voiceStrict?: boolean;
572
572
  /** Also write the narration track here (WAV). */
573
573
  voiceOut?: string;
574
- /** When a step can't find its element: propose a fix (<out>.repair.json, for `apply`), verified by playing
575
- * the guide again with it. The render still fails: a person accepts the fix. With `ai`, unsure cases are asked. */
574
+ /** When a step can't find its element, or a wait's text never shows: propose a fix (<out>.repair.json, for
575
+ * `apply`), verified by playing the guide again with it. The render still fails: a person accepts the fix.
576
+ * With `ai`, unsure cases are asked; a wait with no clear text is offered as a guess (`by: 'guess'`). */
576
577
  repair?: boolean;
577
578
  /** With repair and ai: send a screenshot of the stalled page too. */
578
579
  repairVision?: boolean;
@@ -764,23 +765,26 @@ declare function cueAt(cues: readonly Cue[], t: number, fadeMs?: number): {
764
765
  /**
765
766
  * --repair: when a step can't find its element, look at the page as it is now, choose what the step means
766
767
  * (code first, the AI only when unsure), re-record that element as the step's target, and play the guide
767
- * again with the fix (in memory) to see that it gets past the step. Up to `maxStalls` stalls in one run.
768
+ * again with the fix (in memory) to see that it gets past the step. A wait whose text never showed is fixed
769
+ * the same way: the texts on the page (and those that showed while it waited) are scored, and the chosen one
770
+ * becomes what the step waits for. Up to `maxStalls` stalls in one run.
768
771
  *
769
772
  * Nothing is written to the trace: the fixes are suggestions in a file that `apply` takes once a person agrees.
770
773
  */
771
774
 
772
775
  type Trace = Parameters<typeof applyRaw>[0];
776
+ /** `by: 'guess'`: a wait's text that was not a clear winner (the best that scored well, or what showed after the action), kept only when the replay passes. */
773
777
  interface RepairSuggestion extends Suggestion {
774
778
  id: number;
775
- by: 'score' | 'ai';
779
+ by: 'score' | 'ai' | 'guess';
776
780
  score?: number;
777
781
  }
778
782
  interface Unresolved {
779
783
  index: number;
780
784
  reason: string;
781
785
  why: string;
782
- /** The best candidates by score, for a person to pick from. */
783
- top: Array<Omit<Candidate, 'key'> & {
786
+ /** The best candidates by score, for a person to pick from: elements, or (for a wait) texts. */
787
+ top: Array<(Omit<Candidate, 'key'> | Omit<TextCandidate, 'id'>) & {
784
788
  score: number;
785
789
  }>;
786
790
  }
@@ -797,6 +801,13 @@ interface Found {
797
801
  score?: number;
798
802
  why?: string;
799
803
  };
804
+ /** For a wait: the text to wait for now. */
805
+ text?: {
806
+ value: string;
807
+ by: 'score' | 'ai' | 'guess';
808
+ score?: number;
809
+ why?: string;
810
+ };
800
811
  why?: string;
801
812
  top: Unresolved['top'];
802
813
  }
package/dist/index.js CHANGED
@@ -66,7 +66,7 @@ import {
66
66
  trimSilence,
67
67
  voiceOf,
68
68
  withHolds
69
- } from "./chunk-BM26YQ4L.js";
69
+ } from "./chunk-PE3MNBRB.js";
70
70
  export {
71
71
  DEFAULT_BACKGROUND,
72
72
  DEFAULT_MAX_WAIT_MS,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "trace-avatar-render",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "Render a trace-avatar guide to a GIF or MP4 by playing it on your real app in headless Chromium.",
5
5
  "type": "module",
6
6
  "bin": {
@@ -60,7 +60,7 @@
60
60
  "gifenc": "^1.0.3",
61
61
  "playwright": "^1.65.0",
62
62
  "pngjs": "^7.0.0",
63
- "trace-avatar": "^0.1.7"
63
+ "trace-avatar": "^0.1.9"
64
64
  },
65
65
  "devDependencies": {
66
66
  "@types/node": "^22.0.0",