reviewflow 3.27.0 → 3.29.0

package/dist/dashboard/modules/setupWizard.js

@@ -0,0 +1,261 @@
+/**
+ * Dashboard module — Setup Wizard HUD view model (SPEC-184, Iteration A).
+ * Humble object: pure functions, no global state, no direct DOM access.
+ * Maps the SPEC-183 wizard stream events into the 10-step boot sequence rows
+ * and the banner model. Animation choreography lives in styles.css; the stream
+ * client wiring lives in setupWizardStream.js.
+ *
+ * Visual DNA: "Agentic OS" — see project_agentic_os_design_dna.md.
+ */
+
+import { escapeHtml } from './html.js';
+
+/**
+ * @typedef {'dependencies' | 'claude-login' | 'daemon' | 'secrets' | 'add-project'
+ *        | 'pipeline' | 'generate-files' | 'register-project' | 'validate' | 'next-actions'} StepId
+ */
+
+/**
+ * @typedef {'pending' | 'in_progress' | 'succeeded' | 'skipped' | 'blocked'
+ *        | 'warning' | 'awaiting_input'} StepRowStatus
+ */
+
+/**
+ * @typedef {Object} StepRowViewModel
+ * @property {StepId} id
+ * @property {string} label
+ * @property {StepRowStatus} status
+ * @property {string | null} message
+ * @property {string | null} remediation
+ * @property {number} position
+ * @property {number} total
+ */
+
+/**
+ * @typedef {Object} BannerViewModel
+ * @property {'instructions' | 'warning' | 'resume' | 'done'} kind
+ * @property {string | null} message
+ * @property {string[]} lines
+ * @property {string | null} resumeAt
+ * @property {number | null} position
+ * @property {number | null} total
+ */
+
+/**
+ * The 10 SPEC-183 step ids, in execution order. Kept in sync with
+ * entities/stepId/stepId.schema.ts (the backend source of truth).
+ * @type {StepId[]}
+ */
+export const STEP_ROW_IDS = [
+  'dependencies',
+  'claude-login',
+  'daemon',
+  'secrets',
+  'add-project',
+  'pipeline',
+  'generate-files',
+  'register-project',
+  'validate',
+  'next-actions',
+];
+
+/** @type {Record<StepId, string>} */
+const STEP_LABELS = {
+  dependencies: 'Dependencies',
+  'claude-login': 'Claude login',
+  daemon: 'Daemon',
+  secrets: 'Secrets',
+  'add-project': 'Add project',
+  pipeline: 'Pipeline',
+  'generate-files': 'Generate files',
+  'register-project': 'Register project',
+  validate: 'Validate',
+  'next-actions': 'Next actions',
+};
+
+const BANNER_STEPS = new Set(['instructions', 'warning', 'resume', 'done']);
+
+/**
+ * @param {string} step
+ * @returns {boolean}
+ */
+function isStepRowId(step) {
+  return STEP_ROW_IDS.includes(step);
+}
+
+const ROW_STATUSES = new Set([
+  'pending',
+  'in_progress',
+  'succeeded',
+  'skipped',
+  'blocked',
+  'warning',
+  'awaiting_input',
+]);
+
+/**
+ * @param {Record<string, unknown>} event
+ * @returns {StepRowStatus}
+ */
+function statusFromEvent(event) {
+  const status = event.status;
+  if (typeof status === 'string' && ROW_STATUSES.has(status)) {
+    return status;
+  }
+  return 'pending';
+}
+
+/**
+ * @param {Record<string, unknown>} event
+ * @returns {string | null}
+ */
+function messageFromEvent(event) {
+  if (event.status === 'awaiting_input') {
+    return typeof event.prompt === 'string' ? event.prompt : null;
+  }
+  return typeof event.message === 'string' ? event.message : null;
+}
+
+/**
+ * Folds the ordered event stream into the 10 step rows. Banner events are
+ * never folded into rows (they drive buildBannerModel instead).
+ *
+ * @param {Array<Record<string, unknown>>} events
+ * @returns {StepRowViewModel[]}
+ */
+export function buildStepRowsModel(events) {
+  const total = STEP_ROW_IDS.length;
+  /** @type {StepRowViewModel[]} */
+  const rows = STEP_ROW_IDS.map((id, index) => ({
+    id,
+    label: STEP_LABELS[id],
+    status: 'pending',
+    message: null,
+    remediation: null,
+    position: index + 1,
+    total,
+  }));
+
+  const indexById = new Map(rows.map((row, index) => [row.id, index]));
+
+  for (const event of events) {
+    const step = typeof event.step === 'string' ? event.step : '';
+    if (!isStepRowId(step)) {
+      continue;
+    }
+    const rowIndex = indexById.get(step);
+    if (rowIndex === undefined) {
+      continue;
+    }
+    const row = rows[rowIndex];
+    row.status = statusFromEvent(event);
+    row.message = messageFromEvent(event);
+    row.remediation = typeof event.remediation === 'string' ? event.remediation : null;
+  }
+
+  return rows;
+}
+
+/**
+ * Extracts the banner events (instructions / warning / resume / done) in order.
+ *
+ * @param {Array<Record<string, unknown>>} events
+ * @returns {BannerViewModel[]}
+ */
+export function buildBannerModel(events) {
+  /** @type {BannerViewModel[]} */
+  const banners = [];
+  for (const event of events) {
+    const step = typeof event.step === 'string' ? event.step : '';
+    if (!BANNER_STEPS.has(step)) {
+      continue;
+    }
+    banners.push({
+      kind: step,
+      message: typeof event.message === 'string' ? event.message : null,
+      lines: Array.isArray(event.lines) ? event.lines.map((line) => String(line)) : [],
+      resumeAt: typeof event.resumeAt === 'string' ? event.resumeAt : null,
+      position: typeof event.position === 'number' ? event.position : null,
+      total: typeof event.total === 'number' ? event.total : null,
+    });
+  }
+  return banners;
+}
+
+/**
+ * @param {StepRowStatus} status
+ * @returns {string}
+ */
+export function statusToDotClass(status) {
+  const suffix = status.replace(/_/g, '-');
+  return `setup-step-dot setup-step-dot--${suffix}`;
+}
+
+/**
+ * @param {StepRowStatus} status
+ * @returns {string}
+ */
+export function statusToLabel(status) {
+  return status.replace(/_/g, ' ').toUpperCase();
+}
+
+/**
+ * @param {StepRowViewModel} row
+ * @returns {string}
+ */
+export function buildAriaAnnouncement(row) {
+  const statusLabel = statusToLabel(row.status).toLowerCase();
+  return `Step ${row.position} of ${row.total}, ${statusLabel}: ${row.label}`;
+}
+
+/**
+ * @param {StepRowViewModel} row
+ * @returns {string}
+ */
+export function renderStepRow(row) {
+  const dotClass = statusToDotClass(row.status);
+  const labelPrefix = `// ${row.label.toUpperCase()}`;
+  const messageMarkup = row.message
+    ? `<div class="setup-step-message">${escapeHtml(row.message)}</div>`
+    : '';
+  const remediationMarkup = row.remediation
+    ? `<div class="setup-step-remediation">${escapeHtml(row.remediation)}</div>`
+    : '';
+  return `
+    <li class="setup-step setup-step--${row.status.replace(/_/g, '-')}" data-step-id="${escapeHtml(row.id)}" data-status="${escapeHtml(row.status)}">
+      <span class="setup-corner setup-corner--tl" aria-hidden="true"></span>
+      <span class="setup-corner setup-corner--tr" aria-hidden="true"></span>
+      <span class="setup-corner setup-corner--bl" aria-hidden="true"></span>
+      <span class="setup-corner setup-corner--br" aria-hidden="true"></span>
+      <span class="${dotClass}" aria-hidden="true"></span>
+      <div class="setup-step-body">
+        <div class="setup-step-header">
+          <span class="setup-step-label">${escapeHtml(labelPrefix)}</span>
+          <span class="setup-step-status" data-status="${escapeHtml(row.status)}">${escapeHtml(statusToLabel(row.status))}</span>
+        </div>
+        ${messageMarkup}
+        ${remediationMarkup}
+      </div>
+    </li>
+  `;
+}
+
+/**
+ * @param {BannerViewModel} banner
+ * @returns {string}
+ */
+export function renderBanner(banner) {
+  if (banner.kind === 'resume') {
+    const position = banner.position ?? 0;
+    const total = banner.total ?? STEP_ROW_IDS.length;
+    return `<div class="setup-banner setup-banner--resume" role="status">// REPRISE — Étape ${position}/${total}</div>`;
+  }
+  if (banner.kind === 'done') {
+    return `<div class="setup-banner setup-banner--done" role="status">// SETUP TERMINÉ</div>`;
+  }
+  if (banner.kind === 'instructions') {
+    const items = banner.lines.map((line) => `<li>${escapeHtml(line)}</li>`).join('');
+    return `<div class="setup-banner setup-banner--instructions" role="status"><div class="setup-banner-title">// INSTRUCTIONS</div><ul>${items}</ul></div>`;
+  }
+  return `<div class="setup-banner setup-banner--warning" role="status"><span class="setup-banner-title">// ATTENTION</span> ${escapeHtml(banner.message)}</div>`;
+}

package/dist/dashboard/modules/setupWizard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupWizard.js","sourceRoot":"","sources":["../../../src/dashboard/modules/setupWizard.js"],"names":[],"mappings":"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"}

package/dist/dashboard/modules/setupWizardAvatar.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Folds the ordered event list to the avatar state of the latest relevant event.
+ * Nothing relevant yet → idle.
+ *
+ * @param {Array<Record<string, unknown>>} events
+ * @returns {AvatarState}
+ */
+export function avatarStateFromEvents(events: Array<Record<string, unknown>>): AvatarState;
+/**
+ * Decides whether the animated wireframe avatar applies. Phase 1 renders on a
+ * plain 2D canvas (no WebGL), so the capability gate is "can we get a 2D
+ * context"; reduced motion always routes to the static 2D fallback.
+ *
+ * @param {{ canvasSupported: boolean; reducedMotion: boolean }} capabilities
+ * @returns {boolean}
+ */
+export function shouldUseAvatar(capabilities: {
+    canvasSupported: boolean;
+    reducedMotion: boolean;
+}): boolean;
+/**
+ * Maps an avatar state to its stroke/animation parameters. Keeps the renderer
+ * humble: every per-state visual decision lives here, not in the canvas loop.
+ *
+ * @param {AvatarState} state
+ * @returns {AvatarVisual}
+ */
+export function avatarStateToVisual(state: AvatarState): AvatarVisual;
+/**
+ * @typedef {Object} Projection
+ * @property {number} tilt Fixed X-axis tilt in radians.
+ * @property {number} distance Camera distance for the perspective divide.
+ * @property {number} scale Pixels per unit at the projection plane.
+ * @property {number} centerX Canvas-space x offset.
+ * @property {number} centerY Canvas-space y offset.
+ */
+/**
+ * Projects a 3D vertex to a 2D canvas point: rotates around Y by
+ * `rotationRadians`, applies the fixed X tilt, then a trivial perspective
+ * divide and scale. Pure and deterministic.
+ *
+ * @param {Vertex} vertex
+ * @param {number} rotationRadians
+ * @param {Projection} projection
+ * @returns {{ x: number; y: number }}
+ */
+export function projectVertex(vertex: Vertex, rotationRadians: number, projection: Projection): {
+    x: number;
+    y: number;
+};
+/**
+ * Dashboard module — Setup Wizard wireframe avatar (SPEC-188, Phase 1).
+ * Humble object: pure functions, no global state, no direct DOM access.
+ * Holds ALL the avatar logic: maps the SPEC-183/187 wizard stream into one of
+ * six avatar states, decides whether the avatar or the 2D fallback applies, and
+ * projects the procedural wireframe geometry. The requestAnimationFrame canvas
+ * loop lives in setupWizardAvatarRenderer.js and delegates every decision here.
+ *
+ * Visual DNA: "Agentic OS" — see project_agentic_os_design_dna.md.
+ */
+/**
+ * @typedef {'idle' | 'working' | 'success' | 'error' | 'listening' | 'celebrating'} AvatarState
+ */
+/**
+ * The six avatar states a wireframe core can be in, in narrative order.
+ * @type {AvatarState[]}
+ */
+export const AVATAR_STATES: AvatarState[];
+/**
+ * @typedef {[number, number, number]} Vertex
+ */
+/**
+ * The 12 vertices of a unit icosahedron (golden-ratio rectangles). A fixed,
+ * abstract wireframe core — the six avatar states reuse this same geometry and
+ * differ only by colour/line-width/rotation-speed/pulse.
+ * @type {Vertex[]}
+ */
+export const WIREFRAME_VERTICES: Vertex[];
+/**
+ * The 30 edges of the icosahedron, as index pairs into WIREFRAME_VERTICES.
+ * @type {Array<[number, number]>}
+ */
+export const WIREFRAME_EDGES: Array<[number, number]>;
+export type Projection = {
+    /**
+     * Fixed X-axis tilt in radians.
+     */
+    tilt: number;
+    /**
+     * Camera distance for the perspective divide.
+     */
+    distance: number;
+    /**
+     * Pixels per unit at the projection plane.
+     */
+    scale: number;
+    /**
+     * Canvas-space x offset.
+     */
+    centerX: number;
+    /**
+     * Canvas-space y offset.
+     */
+    centerY: number;
+};
+export type AvatarState = "idle" | "working" | "success" | "error" | "listening" | "celebrating";
+export type AvatarVisual = {
+    /**
+     * CSS custom-property name driving the stroke colour.
+     */
+    color: string;
+    /**
+     * Stroke width in device pixels.
+     */
+    lineWidth: number;
+    /**
+     * Radians per second of the Y rotation.
+     */
+    rotationSpeed: number;
+    /**
+     * Amplitude of the radius/opacity breathing envelope.
+     */
+    pulse: number;
+};
+export type Vertex = [number, number, number];
+//# sourceMappingURL=setupWizardAvatar.d.ts.map

package/dist/dashboard/modules/setupWizardAvatar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupWizardAvatar.d.ts","sourceRoot":"","sources":["../../../src/dashboard/modules/setupWizardAvatar.js"],"names":[],"mappings":"AAyDA;;;;;;GAMG;AACH,8CAHW,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC5B,WAAW,CAUvB;AAED;;;;;;;GAOG;AACH,8CAHW;IAAE,eAAe,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,OAAO,CAAA;CAAE,GAClD,OAAO,CAInB;AAoBD;;;;;;GAMG;AACH,2CAHW,WAAW,GACT,YAAY,CAIxB;AAkED;;;;;;;GAOG;AAEH;;;;;;;;;GASG;AACH,sCALW,MAAM,mBACN,MAAM,cACN,UAAU,GACR;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAoBpC;AAxND;;;;;;;;;GASG;AAEH;;GAEG;AAEH;;;GAGG;AACH,4BAFU,WAAW,EAAE,CAE0E;AAkGjG;;GAEG;AAEH;;;;;GAKG;AACH,iCAFU,MAAM,EAAE,CAehB;AAEF;;;GAGG;AACH,8BAFU,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAiC/B;;;;;UAIY,MAAM;;;;cACN,MAAM;;;;WACN,MAAM;;;;aACN,MAAM;;;;aACN,MAAM;;0BA7KP,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,aAAa;;;;;WA4ErE,MAAM;;;;eACN,MAAM;;;;mBACN,MAAM;;;;WACN,MAAM;;qBA2BP,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC"}

package/dist/dashboard/modules/setupWizardAvatar.js

@@ -0,0 +1,217 @@
+/**
+ * Dashboard module — Setup Wizard wireframe avatar (SPEC-188, Phase 1).
+ * Humble object: pure functions, no global state, no direct DOM access.
+ * Holds ALL the avatar logic: maps the SPEC-183/187 wizard stream into one of
+ * six avatar states, decides whether the avatar or the 2D fallback applies, and
+ * projects the procedural wireframe geometry. The requestAnimationFrame canvas
+ * loop lives in setupWizardAvatarRenderer.js and delegates every decision here.
+ *
+ * Visual DNA: "Agentic OS" — see project_agentic_os_design_dna.md.
+ */
+
+/**
+ * @typedef {'idle' | 'working' | 'success' | 'error' | 'listening' | 'celebrating'} AvatarState
+ */
+
+/**
+ * The six avatar states a wireframe core can be in, in narrative order.
+ * @type {AvatarState[]}
+ */
+export const AVATAR_STATES = ['idle', 'working', 'success', 'error', 'listening', 'celebrating'];
+
+/**
+ * @param {unknown} value
+ * @returns {string}
+ */
+function statusOf(value) {
+  return value && typeof value === 'object' && typeof (/** @type {Record<string, unknown>} */ (value).status) === 'string'
+    ? /** @type {string} */ (/** @type {Record<string, unknown>} */ (value).status)
+    : '';
+}
+
+/**
+ * Maps a single event status to the avatar state it drives. Returns null for a
+ * status the avatar does not react to (so the fold can keep the previous state).
+ *
+ * @param {string} status
+ * @returns {AvatarState | null}
+ */
+function avatarStateForStatus(status) {
+  if (status === 'in_progress' || status === 'warning') {
+    return 'working';
+  }
+  if (status === 'succeeded' || status === 'skipped') {
+    return 'success';
+  }
+  if (status === 'blocked') {
+    return 'error';
+  }
+  if (status === 'awaiting_input') {
+    return 'listening';
+  }
+  if (status === 'completed') {
+    return 'celebrating';
+  }
+  return null;
+}
+
+/**
+ * Folds the ordered event list to the avatar state of the latest relevant event.
+ * Nothing relevant yet → idle.
+ *
+ * @param {Array<Record<string, unknown>>} events
+ * @returns {AvatarState}
+ */
+export function avatarStateFromEvents(events) {
+  for (let index = events.length - 1; index >= 0; index -= 1) {
+    const state = avatarStateForStatus(statusOf(events[index]));
+    if (state !== null) {
+      return state;
+    }
+  }
+  return 'idle';
+}
+
+/**
+ * Decides whether the animated wireframe avatar applies. Phase 1 renders on a
+ * plain 2D canvas (no WebGL), so the capability gate is "can we get a 2D
+ * context"; reduced motion always routes to the static 2D fallback.
+ *
+ * @param {{ canvasSupported: boolean; reducedMotion: boolean }} capabilities
+ * @returns {boolean}
+ */
+export function shouldUseAvatar(capabilities) {
+  return capabilities.canvasSupported === true && capabilities.reducedMotion === false;
+}
+
+/**
+ * @typedef {Object} AvatarVisual
+ * @property {string} color CSS custom-property name driving the stroke colour.
+ * @property {number} lineWidth Stroke width in device pixels.
+ * @property {number} rotationSpeed Radians per second of the Y rotation.
+ * @property {number} pulse Amplitude of the radius/opacity breathing envelope.
+ */
+
+/** @type {Record<AvatarState, AvatarVisual>} */
+const AVATAR_VISUALS = {
+  idle: { color: '--accent', lineWidth: 1, rotationSpeed: 0.3, pulse: 0.15 },
+  working: { color: '--accent', lineWidth: 1.5, rotationSpeed: 1.2, pulse: 0.25 },
+  success: { color: '--success', lineWidth: 1.5, rotationSpeed: 0.6, pulse: 0.4 },
+  error: { color: '--danger', lineWidth: 2, rotationSpeed: 0.2, pulse: 0.5 },
+  listening: { color: '--accent', lineWidth: 1.5, rotationSpeed: 0.45, pulse: 0.3 },
+  celebrating: { color: '--success', lineWidth: 2, rotationSpeed: 1.6, pulse: 0.6 },
+};
+
+/**
+ * Maps an avatar state to its stroke/animation parameters. Keeps the renderer
+ * humble: every per-state visual decision lives here, not in the canvas loop.
+ *
+ * @param {AvatarState} state
+ * @returns {AvatarVisual}
+ */
+export function avatarStateToVisual(state) {
+  return AVATAR_VISUALS[state];
+}
+
+const GOLDEN_RATIO = (1 + Math.sqrt(5)) / 2;
+
+/**
+ * @typedef {[number, number, number]} Vertex
+ */
+
+/**
+ * The 12 vertices of a unit icosahedron (golden-ratio rectangles). A fixed,
+ * abstract wireframe core — the six avatar states reuse this same geometry and
+ * differ only by colour/line-width/rotation-speed/pulse.
+ * @type {Vertex[]}
+ */
+export const WIREFRAME_VERTICES = [
+  [-1, GOLDEN_RATIO, 0],
+  [1, GOLDEN_RATIO, 0],
+  [-1, -GOLDEN_RATIO, 0],
+  [1, -GOLDEN_RATIO, 0],
+  [0, -1, GOLDEN_RATIO],
+  [0, 1, GOLDEN_RATIO],
+  [0, -1, -GOLDEN_RATIO],
+  [0, 1, -GOLDEN_RATIO],
+  [GOLDEN_RATIO, 0, -1],
+  [GOLDEN_RATIO, 0, 1],
+  [-GOLDEN_RATIO, 0, -1],
+  [-GOLDEN_RATIO, 0, 1],
+];
+
+/**
+ * The 30 edges of the icosahedron, as index pairs into WIREFRAME_VERTICES.
+ * @type {Array<[number, number]>}
+ */
+export const WIREFRAME_EDGES = [
+  [0, 11],
+  [0, 5],
+  [0, 1],
+  [0, 7],
+  [0, 10],
+  [1, 5],
+  [5, 11],
+  [11, 10],
+  [10, 7],
+  [7, 1],
+  [3, 9],
+  [3, 4],
+  [3, 2],
+  [3, 6],
+  [3, 8],
+  [4, 9],
+  [9, 8],
+  [8, 6],
+  [6, 2],
+  [2, 4],
+  [5, 9],
+  [11, 4],
+  [10, 2],
+  [7, 6],
+  [1, 8],
+  [4, 5],
+  [9, 1],
+  [8, 7],
+  [6, 10],
+  [2, 11],
+];
+
+/**
+ * @typedef {Object} Projection
+ * @property {number} tilt Fixed X-axis tilt in radians.
+ * @property {number} distance Camera distance for the perspective divide.
+ * @property {number} scale Pixels per unit at the projection plane.
+ * @property {number} centerX Canvas-space x offset.
+ * @property {number} centerY Canvas-space y offset.
+ */
+
+/**
+ * Projects a 3D vertex to a 2D canvas point: rotates around Y by
+ * `rotationRadians`, applies the fixed X tilt, then a trivial perspective
+ * divide and scale. Pure and deterministic.
+ *
+ * @param {Vertex} vertex
+ * @param {number} rotationRadians
+ * @param {Projection} projection
+ * @returns {{ x: number; y: number }}
+ */
+export function projectVertex(vertex, rotationRadians, projection) {
+  const [x, y, z] = vertex;
+
+  const cosY = Math.cos(rotationRadians);
+  const sinY = Math.sin(rotationRadians);
+  const rotatedX = x * cosY + z * sinY;
+  const rotatedZ = -x * sinY + z * cosY;
+
+  const cosTilt = Math.cos(projection.tilt);
+  const sinTilt = Math.sin(projection.tilt);
+  const tiltedY = y * cosTilt - rotatedZ * sinTilt;
+  const tiltedZ = y * sinTilt + rotatedZ * cosTilt;
+
+  const perspective = projection.scale / (tiltedZ + projection.distance);
+  return {
+    x: projection.centerX + rotatedX * perspective,
+    y: projection.centerY + tiltedY * perspective,
+  };
+}

package/dist/dashboard/modules/setupWizardAvatar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupWizardAvatar.js","sourceRoot":"","sources":["../../../src/dashboard/modules/setupWizardAvatar.js"],"names":[],"mappings":"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"}

package/dist/dashboard/modules/setupWizardAvatarRenderer.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The structural slice of a canvas the renderer actually depends on. A real
+ * HTMLCanvasElement satisfies it; tests can pass a lightweight fake without casts.
+ *
+ * @typedef {Object} AvatarCanvas
+ * @property {number} width
+ * @property {number} height
+ * @property {(contextId: '2d') => CanvasRenderingContext2D | null} getContext
+ */
+/**
+ * Mounts the animated wireframe avatar on a 2D canvas and returns its controls.
+ * The page calls setState() on each stream event and destroy() before any
+ * redirect or fallback switch so the rAF loop never leaks.
+ *
+ * @param {Object} options
+ * @param {AvatarCanvas} options.canvas
+ * @param {import('./setupWizardAvatar.js').AvatarState} [options.initialState]
+ * @param {(callback: FrameRequestCallback) => number} [options.requestFrame]
+ * @param {(handle: number) => void} [options.cancelFrame]
+ * @param {() => number} [options.now]
+ * @returns {{ setState: (state: import('./setupWizardAvatar.js').AvatarState) => void; destroy: () => void }}
+ */
+export function mountSetupWizardAvatar(options: {
+    canvas: AvatarCanvas;
+    initialState?: import("./setupWizardAvatar.js").AvatarState | undefined;
+    requestFrame?: ((callback: FrameRequestCallback) => number) | undefined;
+    cancelFrame?: ((handle: number) => void) | undefined;
+    now?: (() => number) | undefined;
+}): {
+    setState: (state: import("./setupWizardAvatar.js").AvatarState) => void;
+    destroy: () => void;
+};
+/**
+ * The structural slice of a canvas the renderer actually depends on. A real
+ * HTMLCanvasElement satisfies it; tests can pass a lightweight fake without casts.
+ */
+export type AvatarCanvas = {
+    width: number;
+    height: number;
+    getContext: (contextId: "2d") => CanvasRenderingContext2D | null;
+};
+//# sourceMappingURL=setupWizardAvatarRenderer.d.ts.map

package/dist/dashboard/modules/setupWizardAvatarRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupWizardAvatarRenderer.d.ts","sourceRoot":"","sources":["../../../src/dashboard/modules/setupWizardAvatarRenderer.js"],"names":[],"mappings":"AA6BA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;GAYG;AACH,gDAPG;IAA8B,MAAM,EAA5B,YAAY;IAC2C,YAAY;IACd,YAAY,eAAtD,oBAAoB,KAAK,MAAM;IACP,WAAW,aAArC,MAAM,KAAK,IAAI;IACD,GAAG,UAApB,MAAM;CACpB,GAAU;IAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,wBAAwB,EAAE,WAAW,KAAK,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAkE5G;;;;;;WAlFa,MAAM;YACN,MAAM;gBACN,CAAC,SAAS,EAAE,IAAI,KAAK,wBAAwB,GAAG,IAAI"}