quiver-cli 1.3.0 → 2.0.0

package/template/.agents/skills/design/impeccable/scripts/live/ui-core.mjs

@@ -1,180 +0,0 @@
-/**
- * Framework-neutral Impeccable live chrome contract.
- *
- * The production browser bundle is intentionally plain DOM so Svelte, React,
- * Vue, and static adapters can all mount the same chrome. This module is the
- * testable contract/inventory for that bundle; live-browser.js mirrors these
- * values at runtime because it is served as a standalone script.
- */
-
-export const LIVE_CHROME_MOUNT_CONTRACT = Object.freeze([
-  'root',
-  'transport',
-  'state',
-  'actions',
-]);
-
-export const LIVE_UI_SURFACES = Object.freeze([
-  {
-    key: 'global-bottom-bar',
-    ids: [
-      'impeccable-live-global-bar',
-      'impeccable-live-global-bar-brand',
-      'impeccable-live-pick-toggle',
-      'impeccable-live-insert-toggle',
-      'impeccable-live-detect-toggle',
-      'impeccable-live-detect-badge',
-      'impeccable-live-design-toggle',
-      'impeccable-live-page-chat',
-      'impeccable-live-page-chat-input',
-      'impeccable-live-page-chat-voice',
-    ],
-    states: ['rest', 'hover', 'focus-visible', 'pressed', 'active', 'tooltip'],
-  },
-  {
-    key: 'pending-copy-edit-dock',
-    ids: ['impeccable-live-pending-dock'],
-    states: ['closed', 'open', 'hover', 'pressed', 'loading', 'rollback', 'keep-fixing'],
-  },
-  {
-    key: 'element-selection-chrome',
-    ids: [
-      'impeccable-live-highlight',
-      'impeccable-live-tooltip',
-      'impeccable-live-bar',
-      'impeccable-live-selection-pill',
-      'impeccable-live-input',
-      'impeccable-live-configure-voice',
-      'impeccable-live-configure-bar-tooltip',
-    ],
-    states: ['rest', 'hover', 'focus-visible', 'pressed', 'disabled'],
-  },
-  {
-    key: 'action-picker',
-    ids: ['impeccable-live-picker'],
-    states: ['closed', 'open', 'option-hover', 'option-focus'],
-  },
-  {
-    key: 'edit-chrome',
-    ids: ['impeccable-live-edit-badge'],
-    states: ['enabled', 'disabled', 'editing', 'cancel', 'save', 'edited-content'],
-  },
-  {
-    key: 'generating-row',
-    ids: ['impeccable-live-bar', 'impeccable-live-shader'],
-    states: ['action-label', 'animated-dots', 'generating', 'done'],
-  },
-  {
-    key: 'variant-cycling-row',
-    ids: ['impeccable-live-bar', 'impeccable-live-params-panel'],
-    states: ['variant-1', 'variant-2', 'variant-3', 'left-disabled', 'right-disabled', 'dot-click', 'accept', 'discard'],
-  },
-  {
-    key: 'variant-params-panel',
-    ids: ['impeccable-live-params-panel'],
-    states: ['closed', 'open-above', 'open-below', 'range', 'steps', 'toggle'],
-  },
-  {
-    key: 'saving-confirmed-rows',
-    ids: ['impeccable-live-bar'],
-    states: ['saving', 'applying-variant', 'confirmed'],
-  },
-  {
-    key: 'insert-mode-chrome',
-    ids: [
-      'impeccable-live-insert-line',
-      'impeccable-live-insert-placeholder',
-      'impeccable-live-placeholder-resize',
-      'impeccable-live-insert-input',
-      'impeccable-live-insert-voice',
-      'impeccable-live-insert-create',
-      'impeccable-live-insert-create-tooltip',
-    ],
-    states: ['toggle-active', 'line', 'placeholder', 'resize', 'enabled', 'disabled', 'tooltip'],
-  },
-  {
-    key: 'annotation-chrome',
-    ids: [
-      'impeccable-live-annot',
-      'impeccable-live-annot-svg',
-      'impeccable-live-annot-pins',
-      'impeccable-live-annot-clear',
-    ],
-    states: ['overlay', 'drawing', 'pin', 'pin-edit', 'clear'],
-  },
-  {
-    key: 'design-system-panel',
-    ids: ['impeccable-live-design-host'],
-    states: ['closed', 'open', 'tabs', 'token-tiles', 'copy'],
-  },
-  {
-    key: 'toasts-and-errors',
-    ids: ['impeccable-live-toast'],
-    states: ['normal', 'error', 'no-variants-mounted'],
-  },
-  {
-    key: 'css-isolation-boundary',
-    ids: ['impeccable-live-root'],
-    states: ['shadow-root', 'style-tags', 'hostile-css'],
-  },
-]);
-
-export const LIVE_UI_COMPONENT_IDS = Object.freeze([
-  ...new Set(LIVE_UI_SURFACES.flatMap((surface) => surface.ids)),
-]);
-
-export function resolveLiveUiRoot(env = globalThis) {
-  const doc = env?.document;
-  const explicit = env?.__IMPECCABLE_LIVE_UI_ROOT__
-    || env?.window?.__IMPECCABLE_LIVE_UI_ROOT__;
-  if (explicit && typeof explicit.appendChild === 'function') return explicit;
-  return doc?.body || null;
-}
-
-export function getLiveUiElementById(id, env = globalThis) {
-  const doc = env?.document;
-  const root = resolveLiveUiRoot(env);
-  if (!id) return null;
-  if (root?.getElementById) {
-    const found = root.getElementById(id);
-    if (found) return found;
-  }
-  if (root?.querySelector) {
-    const found = root.querySelector('#' + escapeCssIdent(id));
-    if (found) return found;
-  }
-  return doc?.getElementById?.(id) || null;
-}
-
-export function appendToLiveUiRoot(el, env = globalThis) {
-  const root = resolveLiveUiRoot(env);
-  if (!root) throw new Error('Impeccable live UI root is not available');
-  root.appendChild(el);
-  return el;
-}
-
-export function appendStyleToLiveUiRoot(styleEl, env = globalThis) {
-  const doc = env?.document;
-  const root = resolveLiveUiRoot(env);
-  if (root && root !== doc?.body) {
-    root.appendChild(styleEl);
-  } else {
-    (doc?.head || doc?.body || root).appendChild(styleEl);
-  }
-  return styleEl;
-}
-
-export function activeElementDeep(doc = globalThis.document) {
-  let active = doc?.activeElement || null;
-  while (active?.shadowRoot?.activeElement) {
-    active = active.shadowRoot.activeElement;
-  }
-  return active;
-}
-
-function escapeCssIdent(value) {
-  if (typeof CSS !== 'undefined' && typeof CSS.escape === 'function') {
-    return CSS.escape(String(value));
-  }
-  return String(value).replace(/([ !"#$%&'()*+,./:;<=>?@[\\\]^`{|}~])/g, '\\$1');
-}

package/template/.agents/skills/design/impeccable/scripts/live/vocabulary.mjs

@@ -1,171 +0,0 @@
-/**
- * Canonical design-command vocabulary for Live Mode: each command's value, human
- * label, and SVG icon. Icons stack above the chip label; strokes use currentColor
- * so the icon recolors when its chip is selected.
- *
- * Single source of truth, consumed by:
- *   - skill/scripts/live/event-validation.mjs — re-exports VISUAL_ACTIONS.
- *   - skill/scripts/live-browser.js — the real picker. It is served raw and
- *     injected as an IIFE, so it cannot import this at runtime; live-server.mjs
- *     serializes LIVE_COMMANDS into window.__IMPECCABLE_VOCAB__ alongside the
- *     token/port, and live-browser.js builds its ICONS + ACTIONS from that.
- *   - site/components/LiveDemoPalette.astro — the marketing demo palette (imported
- *     at build time).
- *
- * Add, rename, or reorder a verb here and all three follow.
- */
-
-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"';
-
-export const LIVE_COMMANDS = [
-  { value: 'impeccable', label: 'Freeform',  icon: `<svg ${ICON_ATTRS}><path d="M4 20l4-1L18 9l-3-3L5 16z"/><path d="M14 7l3 3"/></svg>` },
-  { 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>` },
-  { 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>` },
-  { value: 'distill',    label: 'Distill',   icon: `<svg ${ICON_ATTRS}><path d="M4 5h16l-6 8v7l-4-2v-5z"/></svg>` },
-  { 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>` },
-  { 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>` },
-  { 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>` },
-  { 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>` },
-  { 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>` },
-  { 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>` },
-  { 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>` },
-  { value: 'overdrive',  label: 'Overdrive', icon: `<svg ${ICON_ATTRS}><path d="M13 3L5 13h5l-1 8 9-12h-6z"/></svg>` },
-];
-
-// Action values accepted by the live event protocol, in palette order.
-export const VISUAL_ACTIONS = LIVE_COMMANDS.map((c) => c.value);
-
-/*
- * ---------------------------------------------------------------------------
- * Protocol vocabulary
- * ---------------------------------------------------------------------------
- * The enums below are the wire contract between the browser overlay, the live
- * helper server, and the durable session journal. They live here rather than in
- * the modules that use them so a value cannot be added to the validator without
- * the store and the server seeing it too.
- *
- * live-browser.js still cannot import this file (it is served raw and injected
- * as an IIFE), so its local phase table repeats the agent-phase names. Anything
- * the server can broadcast must appear in AGENT_PHASES here first.
- */
-
-/**
- * Phases the live server broadcasts as `agent_phase`, in lifecycle order.
- * Every one of these is emitted by `recordAgentPhase()` in live-server.mjs;
- * the validator rejects anything else, so a typo in a phase name fails loudly
- * instead of quietly ranking as an unknown phase in the browser's progress bar.
- */
-export const AGENT_PHASES = Object.freeze([
-  'picked_up',
-  'scaffolding',
-  'source_ready',
-  'scaffold_fallback',
-  'generation_ready',
-  'first_reviewable',
-  'second_reviewable',
-  'all_variants_ready',
-]);
-
-/** Event types the helper server accepts from the browser over POST /events. */
-export const CLIENT_EVENT_TYPES = Object.freeze([
-  'generate',
-  'accept',
-  'discard',
-  'checkpoint',
-  'agent_phase',
-  'variant_mounted',
-  'variant_mount_failed',
-  'exit',
-  'prefetch',
-  'manual_edits',
-  'steer',
-  'carbonize_cleanup',
-]);
-
-/**
- * Event types the durable journal applies. A superset of CLIENT_EVENT_TYPES:
- * the agent-side helpers (live-poll, live-complete) and the server itself
- * append the rest. An event type missing here lands as `unknown_event_type`
- * in the snapshot diagnostics.
- */
-export const JOURNAL_EVENT_TYPES = Object.freeze([
-  'generate',
-  'variant_plan',
-  'detector_waivers',
-  'agent_phase',
-  'variants_ready',
-  'agent_done',
-  'variant_mounted',
-  'variant_mount_failed',
-  'checkpoint',
-  'accept',
-  'accept_intent',
-  'manual_edit_apply',
-  'steer',
-  'steer_done',
-  'carbonize_cleanup',
-  'discard',
-  'discarded',
-  'complete',
-  'agent_error',
-]);
-
-/** Phases the session store assigns to a snapshot. */
-export const SESSION_PHASES = Object.freeze([
-  'new',
-  'generate_requested',
-  'variants_ready',
-  'carbonize_required',
-  'carbonize_cleanup_requested',
-  'manual_edit_apply_requested',
-  'steer_requested',
-  'steer_done',
-  'accept_requested',
-  'discard_requested',
-  'discarded',
-  'completed',
-  'agent_error',
-]);
-
-/** Phases that retire a session from the active list. */
-export const COMPLETED_SESSION_PHASES = Object.freeze(['completed', 'discarded']);
-
-/**
- * Phases after which a late generation write is a ghost from a canceled cycle.
- * The store journals such an event as a diagnostic instead of applying it.
- */
-export const GENERATION_FENCED_SESSION_PHASES = Object.freeze([
-  'accept_requested',
-  'discard_requested',
-  'carbonize_required',
-  'completed',
-  'discarded',
-]);
-
-/**
- * `reason` values carried on checkpoint events. Not validated (an unknown
- * reason is journaled, never rejected) because the reason is diagnostic
- * breadcrumb, not control flow. Two exceptions drive behavior and are split
- * out below.
- */
-export const CHECKPOINT_REASONS = Object.freeze([
-  'generate_started',
-  'variants_progress',
-  'variants_ready',
-  'browser_resumed',
-  'browser_resumed_svelte_component',
-  'param_changed',
-  'variant_anchor_missing',
-  'component_preview_anchor_missing',
-  'steer_input_focused',
-  'steer_submitted',
-  'steer_send_failed',
-  'steer_done',
-  'steer_error',
-]);
-
-/** Checkpoint reasons the server reads as variant-publication progress. */
-export const VARIANT_PROGRESS_CHECKPOINT_REASONS = Object.freeze([
-  'variants_progress',
-  'variants_ready',
-]);