opencode-extended-sidebar 0.2.90 → 0.2.91

package/src/pware.oc.core/pware.oc.core.events.ts

@@ -1,79 +1,79 @@
-/** Host event type + kind. Never reads request or response bodies. */
-import {
-  EVENT_FILE_EDITED,
-  EVENT_MESSAGE_PART_UPDATED,
-  EVENT_PART_DELTA,
-  EVENT_REASONING_DELTA,
-  EVENT_REASONING_STARTED,
-  EVENT_SESSION_CREATED,
-  EVENT_SESSION_DIFF,
-  EVENT_SESSION_IDLE,
-  EVENT_SESSION_STATUS,
-  EVENT_SESSION_UPDATED,
-  EVENT_STEP_ENDED,
-  EVENT_STEP_FAILED,
-  EVENT_STEP_STARTED,
-  EVENT_TEXT_DELTA,
-  EVENT_TOOL_CALLED,
-  EVENT_TOOL_ENDED,
-  EVENT_TOOL_FAILED,
-  EVENT_TOOL_SUCCESS,
-} from "./constants/pware.oc.core.constants.eventType.js"
-
-import {
-  EVENT_KIND_DB_REFRESH,
-  EVENT_KIND_FILE,
-  EVENT_KIND_FLOW,
-  EVENT_KIND_TOOL,
-  type EventKind,
-} from "./constants/pware.oc.core.constants.eventKind.js"
-
-export type { EventKind }
-
-export function eventType(evt: unknown): string {
-  if (!evt || typeof evt !== "object") return ""
-  return String((evt as Record<string, unknown>).type ?? "").toLowerCase()
-}
-
-export function eventKind(type: string): EventKind | null {
-  const t = (type || "").toLowerCase()
-  if (!t) return null
-  if (t.includes(EVENT_FILE_EDITED) || t.includes(EVENT_SESSION_DIFF)) return EVENT_KIND_FILE
-  if (
-    t.includes(EVENT_TOOL_CALLED) ||
-    t.includes(EVENT_TOOL_SUCCESS) ||
-    t.includes(EVENT_TOOL_FAILED) ||
-    t.includes(EVENT_TOOL_ENDED)
-  ) {
-    return EVENT_KIND_TOOL
-  }
-  if (
-    t.includes(EVENT_SESSION_STATUS) ||
-    t.includes(EVENT_SESSION_IDLE) ||
-    t.includes(EVENT_SESSION_CREATED) ||
-    t.includes(EVENT_SESSION_UPDATED) ||
-    t.includes(EVENT_MESSAGE_PART_UPDATED) ||
-    t.includes(EVENT_STEP_STARTED) ||
-    t.includes(EVENT_STEP_ENDED) ||
-    t.includes(EVENT_STEP_FAILED)
-  ) {
-    return EVENT_KIND_DB_REFRESH
-  }
-  if (
-    t.includes(EVENT_TEXT_DELTA) ||
-    t.includes(EVENT_REASONING_DELTA) ||
-    t.includes(EVENT_REASONING_STARTED) ||
-    t.includes(EVENT_PART_DELTA) ||
-    t.endsWith(".delta")
-  ) {
-    return EVENT_KIND_FLOW
-  }
-  return null
-}
-
-export function shouldRefreshDb(type: string): boolean {
-  const t = (type || "").toLowerCase()
-  if (!t || t.includes(".delta")) return false
-  const kind = eventKind(t)
-  return kind === EVENT_KIND_TOOL || kind === EVENT_KIND_FILE || kind === EVENT_KIND_DB_REFRESH
-}
+/** Host event type + kind. Never reads request or response bodies. */
+import {
+  EVENT_FILE_EDITED,
+  EVENT_MESSAGE_PART_UPDATED,
+  EVENT_PART_DELTA,
+  EVENT_REASONING_DELTA,
+  EVENT_REASONING_STARTED,
+  EVENT_SESSION_CREATED,
+  EVENT_SESSION_DIFF,
+  EVENT_SESSION_IDLE,
+  EVENT_SESSION_STATUS,
+  EVENT_SESSION_UPDATED,
+  EVENT_STEP_ENDED,
+  EVENT_STEP_FAILED,
+  EVENT_STEP_STARTED,
+  EVENT_TEXT_DELTA,
+  EVENT_TOOL_CALLED,
+  EVENT_TOOL_ENDED,
+  EVENT_TOOL_FAILED,
+  EVENT_TOOL_SUCCESS,
+} from "./constants/pware.oc.core.constants.eventType.js"
+
+import {
+  EVENT_KIND_DB_REFRESH,
+  EVENT_KIND_FILE,
+  EVENT_KIND_FLOW,
+  EVENT_KIND_TOOL,
+  type EventKind,
+} from "./constants/pware.oc.core.constants.eventKind.js"
+
+export type { EventKind }
+
+export function eventType(evt: unknown): string {
+  if (!evt || typeof evt !== "object") return ""
+  return String((evt as Record<string, unknown>).type ?? "").toLowerCase()
+}
+
+export function eventKind(type: string): EventKind | null {
+  const t = (type || "").toLowerCase()
+  if (!t) return null
+  if (t.includes(EVENT_FILE_EDITED) || t.includes(EVENT_SESSION_DIFF)) return EVENT_KIND_FILE
+  if (
+    t.includes(EVENT_TOOL_CALLED) ||
+    t.includes(EVENT_TOOL_SUCCESS) ||
+    t.includes(EVENT_TOOL_FAILED) ||
+    t.includes(EVENT_TOOL_ENDED)
+  ) {
+    return EVENT_KIND_TOOL
+  }
+  if (
+    t.includes(EVENT_SESSION_STATUS) ||
+    t.includes(EVENT_SESSION_IDLE) ||
+    t.includes(EVENT_SESSION_CREATED) ||
+    t.includes(EVENT_SESSION_UPDATED) ||
+    t.includes(EVENT_MESSAGE_PART_UPDATED) ||
+    t.includes(EVENT_STEP_STARTED) ||
+    t.includes(EVENT_STEP_ENDED) ||
+    t.includes(EVENT_STEP_FAILED)
+  ) {
+    return EVENT_KIND_DB_REFRESH
+  }
+  if (
+    t.includes(EVENT_TEXT_DELTA) ||
+    t.includes(EVENT_REASONING_DELTA) ||
+    t.includes(EVENT_REASONING_STARTED) ||
+    t.includes(EVENT_PART_DELTA) ||
+    t.endsWith(".delta")
+  ) {
+    return EVENT_KIND_FLOW
+  }
+  return null
+}
+
+export function shouldRefreshDb(type: string): boolean {
+  const t = (type || "").toLowerCase()
+  if (!t || t.includes(".delta")) return false
+  const kind = eventKind(t)
+  return kind === EVENT_KIND_TOOL || kind === EVENT_KIND_FILE || kind === EVENT_KIND_DB_REFRESH
+}

package/src/pware.oc.core/pware.oc.core.glyph.ts

@@ -1,135 +1,135 @@
-/**
- * pware.oc.core.glyph
- *
- * Every visual glyph as one complete definition: a character plus a semantic
- * tone (and an optional blink flag). A glyph's char and colour can never drift
- * apart because they come from the same switch. `markTone` / `stateGlyph` /
- * `directionGlyph` are pure and theme-independent — the ui layer resolves a
- * `ToneKey` to an actual RGBA through `toneColor` in
- * `pware.oc.ui/pware.oc.ui.chrome.tsx`.
- */
-import { BLINK_TICKS } from "./pware.oc.core.timing.js"
-import {
-  FLOW_RECV,
-  FLOW_TOOL,
-  FLOW_WAIT,
-  MARK_QUEUED,
-  PULSE_LIVE,
-  PULSE_STALE,
-  type AgentMark,
-  type FlowDir,
-} from "./constants/pware.oc.core.constants.pulse.js"
-import { STATUS_ERROR } from "./constants/pware.oc.core.constants.status.js"
-import {
-  ROW_KIND_FILE,
-  ROW_KIND_GROUP,
-  type RowKind,
-} from "./constants/pware.oc.core.constants.rowKind.js"
-
-/** Semantic colour of a glyph or body — no theme values, just meaning. */
-export type ToneKey = "text" | "textMuted" | "success" | "primary" | "warning" | "error"
-
-/** One glyph as a complete definition: the character, its tone, and blink. */
-export type GlyphSpec = {
-  char: string
-  tone: ToneKey
-  blink?: boolean
-}
-
-/** Same braille set as OpenCode TUI thinking spinner (`opentui-spinner`). */
-export const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"] as const
-
-/** Queued — waiting for a slot: the hourglass (the wait flow owns ◷). */
-export const QUEUED_GLYPH = "⧗"
-
-export function spinnerFrame(frame: number): string {
-  const i = ((frame % SPINNER_FRAMES.length) + SPINNER_FRAMES.length) % SPINNER_FRAMES.length
-  return SPINNER_FRAMES[i] ?? "⠋"
-}
-
-/** Cold-start "engage" bar length in glyph frames (GLYPH_TICK_MS × 12 ≈ 1s). */
-export const ENGAGE_MIN_FRAMES = 12
-/** Hard ceiling so the boot bar can never strand (GLYPH_TICK_MS × 50 = 4s). */
-export const ENGAGE_MAX_FRAMES = 50
-
-/** Fill ratio of the cold-start engage bar: linear to 1 at `ENGAGE_MIN_FRAMES`. */
-export function engageFill(frame: number): number {
-  return Math.min(1, Math.max(0, frame) / ENGAGE_MIN_FRAMES)
-}
-
-/**
- * The cold-start engage bar ends once the first real snapshot has landed
- * (`ready`) after its minimum show time — or on the hard ceiling (no DB / no
- * snapshot ever) so the row can never strand. Negative frames count as 0.
- */
-export function engageDone(frame: number, ready: boolean): boolean {
-  const n = Math.max(0, frame)
-  return (ready && n >= ENGAGE_MIN_FRAMES) || n >= ENGAGE_MAX_FRAMES
-}
-
-/** Options for {@link sinPulseAlpha} — one full fade cycle spans `periodFrames` tick frames. */
-export type SinPulseAlphaOpts = {
-  periodFrames?: number
-  min?: number
-  max?: number
-}
-
-/**
- * Sinusoidal fade pulse for glyph opacity: alpha eases `min → max → min` over one
- * period. Defaults to `BLINK_TICKS * 2` frames (same wall-clock span as
- * {@link flowBlinkOn}). Pure — inject the UI tick frame; the ui layer maps the
- * result to OpenTUI `opacity` or a colour lerp.
- */
-export function sinPulseAlpha(frame: number, opts: SinPulseAlphaOpts = {}): number {
-  const period = Math.max(1, Math.round(opts.periodFrames ?? BLINK_TICKS * 2))
-  const lo = Math.min(opts.min ?? 0.25, opts.max ?? 1)
-  const hi = Math.max(opts.min ?? 0.25, opts.max ?? 1)
-  const phase = (Math.abs(frame) % period) / period
-  const wave = Math.sin(phase * Math.PI)
-  return lo + wave * (hi - lo)
-}
-
-/** ↑/↓ blink half-period in ticks (TICK_MS × BLINK_TICKS = 100ms). */
-export function flowBlinkOn(frame: number): boolean {
-  return Math.floor(Math.abs(frame) / BLINK_TICKS) % 2 === 0
-}
-
-/** The tone a state mark carries: error red, queued/stale warning, live success, else muted. */
-export function markTone(mark: AgentMark): ToneKey {
-  if (mark === STATUS_ERROR) return "error"
-  if (mark === MARK_QUEUED || mark === PULSE_STALE) return "warning"
-  if (mark === PULSE_LIVE) return "success"
-  return "textMuted"
-}
-
-/** The state glyph for an agent mark — spinner, cross, hourglass or dot, in one spec. */
-export function stateGlyph(mark: AgentMark, frame = 0): GlyphSpec {
-  const char =
-    mark === STATUS_ERROR
-      ? "×"
-      : mark === MARK_QUEUED
-        ? QUEUED_GLYPH
-        : mark === PULSE_LIVE || mark === PULSE_STALE
-          ? spinnerFrame(frame)
-          : "•"
-  return { char, tone: markTone(mark) }
-}
-
-/** The direction glyph for a flow — ◷ waiting, ← receiving, → tool; null when quiet. */
-export function directionGlyph(flow: FlowDir | null): GlyphSpec | null {
-  if (!flow) return null
-  if (flow === FLOW_WAIT) return { char: "◷", tone: "warning", blink: true }
-  if (flow === FLOW_RECV) return { char: "←", tone: "success", blink: true }
-  return { char: "→", tone: "primary", blink: true }
-}
-
-/** Body text tone for a row kind: quiet for files/groups, otherwise the mark tone. */
-export function defaultBodyTone(
-  kind: RowKind,
-  mark: AgentMark | undefined,
-  current: boolean,
-): ToneKey {
-  if (kind === ROW_KIND_FILE || kind === ROW_KIND_GROUP) return "textMuted"
-  const tone = mark ? markTone(mark) : "textMuted"
-  return current && tone === "textMuted" ? "primary" : tone
-}
+/**
+ * pware.oc.core.glyph
+ *
+ * Every visual glyph as one complete definition: a character plus a semantic
+ * tone (and an optional blink flag). A glyph's char and colour can never drift
+ * apart because they come from the same switch. `markTone` / `stateGlyph` /
+ * `directionGlyph` are pure and theme-independent — the ui layer resolves a
+ * `ToneKey` to an actual RGBA through `toneColor` in
+ * `pware.oc.ui/pware.oc.ui.chrome.tsx`.
+ */
+import { BLINK_TICKS } from "./pware.oc.core.timing.js"
+import {
+  FLOW_RECV,
+  FLOW_TOOL,
+  FLOW_WAIT,
+  MARK_QUEUED,
+  PULSE_LIVE,
+  PULSE_STALE,
+  type AgentMark,
+  type FlowDir,
+} from "./constants/pware.oc.core.constants.pulse.js"
+import { STATUS_ERROR } from "./constants/pware.oc.core.constants.status.js"
+import {
+  ROW_KIND_FILE,
+  ROW_KIND_GROUP,
+  type RowKind,
+} from "./constants/pware.oc.core.constants.rowKind.js"
+
+/** Semantic colour of a glyph or body — no theme values, just meaning. */
+export type ToneKey = "text" | "textMuted" | "success" | "primary" | "warning" | "error"
+
+/** One glyph as a complete definition: the character, its tone, and blink. */
+export type GlyphSpec = {
+  char: string
+  tone: ToneKey
+  blink?: boolean
+}
+
+/** Same braille set as OpenCode TUI thinking spinner (`opentui-spinner`). */
+export const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"] as const
+
+/** Queued — waiting for a slot: the hourglass (the wait flow owns ◷). */
+export const QUEUED_GLYPH = "⧗"
+
+export function spinnerFrame(frame: number): string {
+  const i = ((frame % SPINNER_FRAMES.length) + SPINNER_FRAMES.length) % SPINNER_FRAMES.length
+  return SPINNER_FRAMES[i] ?? "⠋"
+}
+
+/** Cold-start "engage" bar length in glyph frames (GLYPH_TICK_MS × 12 ≈ 1s). */
+export const ENGAGE_MIN_FRAMES = 12
+/** Hard ceiling so the boot bar can never strand (GLYPH_TICK_MS × 50 = 4s). */
+export const ENGAGE_MAX_FRAMES = 50
+
+/** Fill ratio of the cold-start engage bar: linear to 1 at `ENGAGE_MIN_FRAMES`. */
+export function engageFill(frame: number): number {
+  return Math.min(1, Math.max(0, frame) / ENGAGE_MIN_FRAMES)
+}
+
+/**
+ * The cold-start engage bar ends once the first real snapshot has landed
+ * (`ready`) after its minimum show time — or on the hard ceiling (no DB / no
+ * snapshot ever) so the row can never strand. Negative frames count as 0.
+ */
+export function engageDone(frame: number, ready: boolean): boolean {
+  const n = Math.max(0, frame)
+  return (ready && n >= ENGAGE_MIN_FRAMES) || n >= ENGAGE_MAX_FRAMES
+}
+
+/** Options for {@link sinPulseAlpha} — one full fade cycle spans `periodFrames` tick frames. */
+export type SinPulseAlphaOpts = {
+  periodFrames?: number
+  min?: number
+  max?: number
+}
+
+/**
+ * Sinusoidal fade pulse for glyph opacity: alpha eases `min → max → min` over one
+ * period. Defaults to `BLINK_TICKS * 2` frames (same wall-clock span as
+ * {@link flowBlinkOn}). Pure — inject the UI tick frame; the ui layer maps the
+ * result to OpenTUI `opacity` or a colour lerp.
+ */
+export function sinPulseAlpha(frame: number, opts: SinPulseAlphaOpts = {}): number {
+  const period = Math.max(1, Math.round(opts.periodFrames ?? BLINK_TICKS * 2))
+  const lo = Math.min(opts.min ?? 0.25, opts.max ?? 1)
+  const hi = Math.max(opts.min ?? 0.25, opts.max ?? 1)
+  const phase = (Math.abs(frame) % period) / period
+  const wave = Math.sin(phase * Math.PI)
+  return lo + wave * (hi - lo)
+}
+
+/** ↑/↓ blink half-period in ticks (TICK_MS × BLINK_TICKS = 100ms). */
+export function flowBlinkOn(frame: number): boolean {
+  return Math.floor(Math.abs(frame) / BLINK_TICKS) % 2 === 0
+}
+
+/** The tone a state mark carries: error red, queued/stale warning, live success, else muted. */
+export function markTone(mark: AgentMark): ToneKey {
+  if (mark === STATUS_ERROR) return "error"
+  if (mark === MARK_QUEUED || mark === PULSE_STALE) return "warning"
+  if (mark === PULSE_LIVE) return "success"
+  return "textMuted"
+}
+
+/** The state glyph for an agent mark — spinner, cross, hourglass or dot, in one spec. */
+export function stateGlyph(mark: AgentMark, frame = 0): GlyphSpec {
+  const char =
+    mark === STATUS_ERROR
+      ? "×"
+      : mark === MARK_QUEUED
+        ? QUEUED_GLYPH
+        : mark === PULSE_LIVE || mark === PULSE_STALE
+          ? spinnerFrame(frame)
+          : "•"
+  return { char, tone: markTone(mark) }
+}
+
+/** The direction glyph for a flow — ◷ waiting, ← receiving, → tool; null when quiet. */
+export function directionGlyph(flow: FlowDir | null): GlyphSpec | null {
+  if (!flow) return null
+  if (flow === FLOW_WAIT) return { char: "◷", tone: "warning", blink: true }
+  if (flow === FLOW_RECV) return { char: "←", tone: "success", blink: true }
+  return { char: "→", tone: "primary", blink: true }
+}
+
+/** Body text tone for a row kind: quiet for files/groups, otherwise the mark tone. */
+export function defaultBodyTone(
+  kind: RowKind,
+  mark: AgentMark | undefined,
+  current: boolean,
+): ToneKey {
+  if (kind === ROW_KIND_FILE || kind === ROW_KIND_GROUP) return "textMuted"
+  const tone = mark ? markTone(mark) : "textMuted"
+  return current && tone === "textMuted" ? "primary" : tone
+}