@workerdeck/ui 2.7.1 → 2.8.0

package/src/components/agent/TaskList.tsx

@@ -7,7 +7,7 @@ import { cn } from '../../lib/utils.ts'
 export interface TaskListProps {
   tasks: readonly SessionTask[]
   showCompleted: boolean
-  // Absent where the toggle lives outside this list — VS Code puts it in the view's title bar.
+  // Absent where the toggle lives outside this list - VS Code puts it in the view's title bar.
   onShowCompletedChange?: (showCompleted: boolean) => void
   onSelectTask?: (task: SessionTask) => void
   className?: string
@@ -36,7 +36,7 @@ export function TaskList({ tasks, showCompleted, onShowCompletedChange, onSelect
       </div>
       {shown.length === 0 ? (
         <p className="py-6 text-center text-body-sm text-fg-4">
-          {tasks.length === 0 ? 'No tasks yet — a checklist appears once the agent plans one.' : `${hidden} completed, all hidden.`}
+          {tasks.length === 0 ? 'No tasks yet - a checklist appears once the agent plans one.' : `${hidden} completed, all hidden.`}
         </p>
       ) : (
         <div className="flex flex-col">

package/src/components/agent/TranscriptRows.tsx

@@ -91,7 +91,7 @@ function StickyPromptLane({
 }
 
 // The virtualized row lane and its scroll-ownership regime. Two things want to write
-// `scrollTop` — the follow spring and the virtualizer's size-change corrections — and they are
+// `scrollTop` - the follow spring and the virtualizer's size-change corrections - and they are
 // split by regime here: pinned, corrections are suppressed outright; escaped, the virtualizer
 // corrects so the scrollback holds still (GOTCHAS "The transcript is virtualized").
 export function TranscriptRows({

package/src/components/agent/UsageDialog.tsx

@@ -44,7 +44,7 @@ export function UsageDialog({
           {rateLimits.length === 0 ? (
             <p className="py-6 text-center text-body-sm text-fg-4">
               {engine === 'claude'
-                ? 'This session reports no plan windows — API-key sessions have none, and a subscription session reports them once a turn has run.'
+                ? 'This session reports no plan windows - API-key sessions have none, and a subscription session reports them once a turn has run.'
                 : `Plan windows are a claude.ai subscription thing; this session runs on the ${engine} engine.`}
             </p>
           ) : (

package/src/components/agent/use-subagent-frame.ts

@@ -6,7 +6,7 @@ import { subagentItems, type ToolCallItem } from '../terminal/blocks.ts'
 // The sub-agent frame machine: which agent frame is on screen, how it is entered (a host
 // `openSubagent` request or a Task row in the transcript), how it is left (Escape, the strip's
 // Back, or the host withdrawing), and what the transcript reveals on the way out. The frame
-// round-trips through the host's URL — the anti-loop rules live in GOTCHAS ("The sub-agent
+// round-trips through the host's URL - the anti-loop rules live in GOTCHAS ("The sub-agent
 // frame round-trips through the URL"); here they mean: entry keys on the nonce alone, and the
 // report is deduped through a ref, so an echo of our own report is inert on arrival.
 export function useSubagentFrame(options: {
@@ -51,7 +51,7 @@ export function useSubagentFrame(options: {
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [openSubagentNonce])
 
-  // A reveal targets the root transcript, so it closes whatever frame is open — without the
+  // A reveal targets the root transcript, so it closes whatever frame is open - without the
   // return reveal, which would fight the requested one.
   const revealNonce = reveal?.nonce
   useEffect(() => {

package/src/components/agent/use-transcript-jumps.ts

@@ -7,12 +7,12 @@ import { gapBefore, type TranscriptRow } from './transcript-rows.ts'
 const AIM_PASSES = 4
 const AIM_SETTLE_MS = 50
 
-// How long a send's re-pin outlasts the click — long enough to eat a trackpad's momentum tail.
+// How long a send's re-pin outlasts the click - long enough to eat a trackpad's momentum tail.
 export const REPIN_HOLD_MS = 750
 
 type RepinTarget = Pick<ReturnType<typeof useStickToBottomContext>, 'scrollToBottom' | 'state'>
 
-// The send re-pin: a held, escape-proof pin, not one `scrollToBottom('instant')` — a trackpad's
+// The send re-pin: a held, escape-proof pin, not one `scrollToBottom('instant')` - a trackpad's
 // trailing momentum tick reads as escape intent and aborts the one-shot before its first frame
 // (GOTCHAS "The send re-pin is a held pin"). Every line is load-bearing: clear the stale escape
 // flag, hold through the momentum tail, seed the `ignoreEscapes` record the library only

package/src/components/prompt-area/clipboard-helpers.ts

@@ -19,7 +19,7 @@ function isRecord(value: unknown): value is Record<string, unknown> {
  * corresponding node kind encountered during a depth-first walk.
  */
 type FragmentVisitor = {
-  /** A text node — receives its text content (may be empty). */
+  /** A text node - receives its text content (may be empty). */
   onText: (text: string) => void
   /** A chip element (has `data-chip-trigger`). */
   onChip: (node: HTMLElement) => void
@@ -191,7 +191,7 @@ export function insertSegmentsAtCursor(currentSegments: Segment[], pastedSegment
       insertOnce()
       result.push(seg)
     } else {
-      // Cursor falls inside this text segment — split it.
+      // Cursor falls inside this text segment - split it.
       const splitAt = cursorOffset - offset
       const before = seg.text.slice(0, splitAt)
       const after = seg.text.slice(splitAt)

package/src/components/prompt-area/cursor-helpers.ts

@@ -3,12 +3,12 @@
  *
  * Invariants:
  * - All functions are synchronous. Never return a promise or cross a microtask
- *   boundary after a DOM mutation — that can cause the browser to fire
+ *   boundary after a DOM mutation - that can cause the browser to fire
  *   `selectionchange` and reset the caret.
  * - Never cache a `Selection` or `Range` across calls. Ranges become detached
  *   after DOM mutations. Each function calls `window.getSelection()` or
  *   `getSelectionRange()` fresh.
- * - Chip nodes are treated atomically via `isChipElement` — we never descend
+ * - Chip nodes are treated atomically via `isChipElement` - we never descend
  *   into a contentEditable=false subtree when mapping offsets.
  */
 import {
@@ -120,11 +120,11 @@ export function createRangeAtOffset(editor: HTMLElement, targetOffset: number):
  * Where the caret is on screen, in viewport coordinates.
  *
  * A collapsed range usually measures fine, but not when it sits *between* child
- * nodes of an element — which is exactly where a freshly inserted newline puts
+ * nodes of an element - which is exactly where a freshly inserted newline puts
  * it, because this editor's content is a flat run of text nodes and `<br>`s
  * directly under the editor element. There `getBoundingClientRect()` is all
  * zeros, and the obvious fallback (measure `startContainer`'s element) resolves
- * to the editor itself, whose rect is the viewport box — so it reports the
+ * to the editor itself, whose rect is the viewport box - so it reports the
  * caret as trivially visible and scrolls nothing.
  *
  * So measure the neighbour instead: the child the caret sits before, or failing
@@ -163,14 +163,14 @@ function caretRect(range: Range): DOMRect | null {
  * The editor is its own scroll container once it hits `maxHeight`
  * (`prompt-area.tsx` sets `overflowY: auto` there). Typing scrolls the caret
  * into view for free, because that is the browser's own behaviour for a native
- * edit — but every path that calls `preventDefault()` and rebuilds the DOM
+ * edit - but every path that calls `preventDefault()` and rebuilds the DOM
  * itself (Shift+Enter, list continuation, undo/redo, the bold/italic wrap,
  * paste) places the caret with a Range instead, and setting a selection does
  * not scroll anything. The symptom is a prompt that has grown past its cap and
  * stops following what you are writing: type and it scrolls, press Shift+Enter
  * and the new line appears below the fold.
  *
- * A no-op when the caret is already visible, so it is safe on every call — it
+ * A no-op when the caret is already visible, so it is safe on every call - it
  * corrects an off-screen caret rather than scrolling to one.
  */
 export function scrollCaretIntoView(editor: HTMLElement): void {
@@ -334,7 +334,7 @@ export function findDOMPosition(container: HTMLElement, targetOffset: number): {
       }
       remaining -= 1
     } else if (isHTMLElement(child)) {
-      // Decoration element (markdown span, URL anchor) — recurse
+      // Decoration element (markdown span, URL anchor) - recurse
       const textLen = (child.textContent ?? '').length
       if (remaining <= textLen) {
         const result = findDOMPosition(child, remaining)

package/src/components/prompt-area/dom-helpers.ts

@@ -73,7 +73,7 @@ export function isLinkElement(node: Node): node is HTMLAnchorElement {
 export function safeJsonParse(json: string): unknown {
   try {
     // JSON.parse returns `any` by default. We narrow it to `unknown`
-    // which is the safest pattern — callers must validate before use.
+    // which is the safest pattern - callers must validate before use.
     const parsed: unknown = JSON.parse(json)
     return parsed
   } catch {
@@ -208,11 +208,11 @@ export function indexOfChildNode(parent: HTMLElement, child: Node): number {
  * `readSegmentsFromDOM` in use-prompt-area.ts. This is the single predicate
  * shared with `domChildIndexToSegmentIndex` below, so a DOM child index can
  * never map to a different segment index than the one the reader actually
- * produces — decoration elements (the URL `<a>` from `decorateURLsInEditor`,
+ * produces - decoration elements (the URL `<a>` from `decorateURLsInEditor`,
  * the markdown `<span data-md>` from `decorateMarkdownInEditor`) fall through
  * to the reader's "unknown element" branch and DO produce a text segment, so
  * they must count here too, not just chips/text/`<br>`. A chip element only
- * counts if `chipNodeToSegment` would actually accept it — the reader skips a
+ * counts if `chipNodeToSegment` would actually accept it - the reader skips a
  * chip missing a required attribute (trigger/value/display), so this must too.
  */
 export function childProducesSegment(child: Node): boolean {
@@ -348,7 +348,7 @@ export function normalizeEditorDOM(editor: HTMLElement): boolean {
  * Walks direct-child text nodes in the editor and wraps URL text in
  * `<a>` elements for visual styling and clickability.
  *
- * This is a DOM-only decoration — it does NOT modify the segment model.
+ * This is a DOM-only decoration - it does NOT modify the segment model.
  * The `<a>` elements are stripped by `normalizeEditorDOM` on every input cycle,
  * so they are re-applied fresh each time.
  *
@@ -393,7 +393,7 @@ export function decorateURLsInEditor(editor: HTMLElement): boolean {
       continue
     }
 
-    // Validate URLs upfront – only keep those with safe protocols (CWE-79)
+    // Validate URLs upfront - only keep those with safe protocols (CWE-79)
     const safeMatches: Array<{ url: string; href: string; index: number }> = []
     for (const { url, index } of matches) {
       try {
@@ -447,7 +447,7 @@ export function decorateURLsInEditor(editor: HTMLElement): boolean {
  * Walks direct-child text nodes in the editor and wraps markdown-formatted
  * text (`**bold**`, `*italic*`, `***bold-italic***`) in styled `<span>` elements.
  *
- * This is a DOM-only decoration — it does NOT modify the segment model.
+ * This is a DOM-only decoration - it does NOT modify the segment model.
  * The `<span>` elements are stripped by `normalizeEditorDOM` on every input cycle,
  * so they are re-applied fresh each time.
  *
@@ -529,7 +529,7 @@ export function decorateMarkdownInEditor(editor: HTMLElement): boolean {
         fragment.appendChild(document.createTextNode(text.slice(lastIndex, index)))
       }
 
-      // Parent span — textContent still returns full match (e.g. "**world**")
+      // Parent span - textContent still returns full match (e.g. "**world**")
       const span = document.createElement('span')
       span.dataset.md = 'true'
 
@@ -642,7 +642,7 @@ export function decorateBulletsInEditor(editor: HTMLElement): boolean {
  * unchanged) and is stripped by {@link normalizeEditorDOM} each input cycle.
  * Must run BEFORE the node-splitting passes ({@link decorateURLsInEditor},
  * {@link decorateMarkdownInEditor}, {@link decorateBulletsInEditor}) so every
- * direct-child text node is still a whole line — otherwise a mid-line split
+ * direct-child text node is still a whole line - otherwise a mid-line split
  * fragment beginning with whitespace would let the `^` anchor false-match
  * non-line-leading whitespace.
  *

package/src/components/prompt-area/html-to-markdown.ts

@@ -240,7 +240,7 @@ function serializeNode(node: Node, depth: number): string {
       return `\n\n${serializeList(node, depth)}\n\n`
     }
     case 'LI': {
-      // A stray <li> outside a list wrapper — emit its content as a line.
+      // A stray <li> outside a list wrapper - emit its content as a line.
       return `${serializeChildren(node, depth).trim()}\n`
     }
     case 'PRE': {
@@ -284,7 +284,7 @@ function normalizeOutput(markdown: string): string {
 /**
  * Converts an HTML string to markdown source text. Returns '' for empty or
  * body-less input. Block markdown (headings, lists, quotes, fences, tables,
- * links) is emitted as literal markdown text — that is the editor's intended
+ * links) is emitted as literal markdown text - that is the editor's intended
  * display; only `*`/`**`/`***` and bare URLs get visually decorated inline.
  */
 export function htmlToMarkdown(html: string): string {

package/src/components/prompt-area/prompt-area-engine.ts

@@ -77,7 +77,7 @@ export function truncateSegmentsToLength(segments: Segment[], maxLength: number)
  * in the editor model: a space, newline, or tab.
  *
  * Trigger detection, paste auto-resolution, and position validation all rely
- * on the *same* notion of a boundary — keeping it here prevents the three
+ * on the *same* notion of a boundary - keeping it here prevents the three
  * call sites from silently drifting apart (e.g. one handling tabs and the
  * others not).
  */
@@ -284,7 +284,7 @@ export function resolveChip(
  * The sibling of {@link resolveChip}, for suggestions that are a typing aid
  * rather than a token: what lands in the document is ordinary editable text the
  * user is expected to finish and change, and it must not look or behave like a
- * resolved chip — no immutability, no trigger character, nothing for a consumer
+ * resolved chip - no immutability, no trigger character, nothing for a consumer
  * to parse back out. The caret is left at the end of the inserted text so typing
  * continues from there.
  */
@@ -303,7 +303,7 @@ export function resolveText(
   for (const seg of segments) {
     if (seg.type === 'chip') {
       const chipEnd = offset + `${seg.trigger}${seg.displayText}`.length
-      // A trigger range can never overlap a chip — chips are atomic — so a chip
+      // A trigger range can never overlap a chip - chips are atomic - so a chip
       // is either wholly before or wholly after, and is kept either way.
       if (chipEnd <= triggerStart || offset >= triggerEnd) {
         newSegments.push(seg)
@@ -444,7 +444,7 @@ function splitTextByTriggerPatterns(text: string, triggerByChar: Map<string, Tri
           const query = text.slice(i + 1, end)
           if (query.length > 0) {
             // Treat both undefined and '' from onSelect as "no custom label"
-            // and fall back to the query — an empty displayText would render
+            // and fall back to the query - an empty displayText would render
             // a blank chip.
             const displayText = trigger.onSelect?.({ value: query, label: query }) || query
             segments.push({

package/src/components/prompt-area/prompt-area-list-ops.ts

@@ -1,6 +1,6 @@
 /**
  * List auto-formatting logic for the PromptArea component.
- * Pure — no DOM dependencies, fully testable in Node.
+ * Pure - no DOM dependencies, fully testable in Node.
  */
 import type { Segment } from './types.ts'
 import { replaceTextRange, segmentsToPlainText } from './prompt-area-engine.ts'
@@ -26,7 +26,7 @@ export type ListContext = {
 }
 
 /**
- * Parsed shape of a single list line — the SINGLE source of truth for what
+ * Parsed shape of a single list line - the SINGLE source of truth for what
  * counts as a list line (both `getListContext` and the renumber engine derive
  * from this, so the bullet/number regexes live in exactly one place).
  *
@@ -127,7 +127,7 @@ export function autoFormatListPrefix(segments: Segment[], cursorPos: number): {
 }
 
 /**
- * Handles Enter key in a list line — continues the list or exits.
+ * Handles Enter key in a list line - continues the list or exits.
  */
 export function insertListContinuation(segments: Segment[], cursorPos: number): { segments: Segment[]; cursorOffset: number } | null {
   const plainText = segmentsToPlainText(segments)
@@ -186,8 +186,8 @@ function getPrevListLineLevel(text: string, lineStart: number): number | null {
 /**
  * Indents a list item by one level (adds 2 spaces before the prefix), capped at
  * one level deeper than the line above. An item can only nest under a preceding
- * sibling, so the first item of a list — or an item already one level below its
- * parent — cannot indent further (returns null). This keeps sub-items visually
+ * sibling, so the first item of a list - or an item already one level below its
+ * parent - cannot indent further (returns null). This keeps sub-items visually
  * connected to a parent instead of drifting arbitrarily deep.
  */
 export function indentListItem(segments: Segment[], cursorPos: number): { segments: Segment[]; cursorOffset: number } | null {
@@ -259,8 +259,8 @@ function swapListPrefixLine(line: string, markdownEnabled: boolean): string {
 /**
  * Returns the set of line indices that sit inside a *balanced* fenced code
  * block (a ```…``` pair), so their leading "- "/"• " markers are preserved
- * verbatim. An unterminated (unpaired) fence marker is NOT protective — its
- * following lines still normalize — so a stray "```" in prose does not silently
+ * verbatim. An unterminated (unpaired) fence marker is NOT protective - its
+ * following lines still normalize - so a stray "```" in prose does not silently
  * suppress bullet normalization for the rest of the text.
  */
 function fenceProtectedLineIndices(lines: string[]): Set<number> {
@@ -351,12 +351,12 @@ export function normalizeListPrefixes(segments: Segment[], markdownEnabled: bool
 export type NumberEdit = { oldStart: number; oldEnd: number; newText: string }
 
 /**
- * Whether the text holds a genuine ordered-list run worth renumbering — a run
+ * Whether the text holds a genuine ordered-list run worth renumbering - a run
  * of 2+ consecutive same-level numbered lines that either starts at 1 or is
  * already a contiguous `n, n+1, …` sequence. Used to gate the paste path so a
  * copied list fragment (`3. 4. 5.` → renumber, or a broken `1. 1. 1.`) is
  * rebuilt, while incidental numeric-leading prose that `parseListLine` would
- * otherwise treat as a list — `1985. Born / 2020. Died`, `5. / 10. / 15.` — is
+ * otherwise treat as a list - `1985. Born / 2020. Died`, `5. / 10. / 15.` - is
  * left untouched.
  */
 export function hasOrderedListRun(text: string): boolean {
@@ -395,7 +395,7 @@ export function hasOrderedListRun(text: string): boolean {
  * Recomputes ordered-list numbering across the whole text. Returns the new text
  * plus the list of changed digit runs (ascending by `oldStart`) for cursor
  * remapping. When nothing changes, returns the SAME text reference and an empty
- * `edits` array — the no-op guard that keeps this off the typing hot path.
+ * `edits` array - the no-op guard that keeps this off the typing hot path.
  */
 export function renumberOrderedListLines(text: string): { text: string; edits: NumberEdit[] } {
   // Cheap pre-gate: with no ordered-list line there is nothing to renumber, so

package/src/components/prompt-area/prompt-area.tsx

@@ -277,7 +277,7 @@ export function PromptArea({
     ) : null
 
   // Typography (font-size/line-height) lives on the container, not the editor, so
-  // it cascades to the editor AND the placeholder overlays — and a consumer can
+  // it cascades to the editor AND the placeholder overlays - and a consumer can
   // override all three at once via `className` (e.g. `text-base leading-6`).
   return (
     <div className={cn('prompt-area-container relative text-sm leading-relaxed', className)}>
@@ -316,7 +316,7 @@ export function PromptArea({
           onBlur={handleBlurCombined}
         />
 
-        {/* Overflow gradient indicator – visible when auto-grow is collapsed and content is clipped */}
+        {/* Overflow gradient indicator - visible when auto-grow is collapsed and content is clipped */}
         {autoGrow && hasOverflow && !isFocused && (
           <div
             aria-hidden="true"

package/src/components/prompt-area/trigger-presets.ts

@@ -18,12 +18,12 @@
 
 import type { TriggerConfig, TriggerPosition } from './types.ts'
 
-// Shared option type — everything in TriggerConfig except the keys each
+// Shared option type - everything in TriggerConfig except the keys each
 // factory sets by default.
 
 type TriggerPresetOptions = Omit<Partial<TriggerConfig>, 'char' | 'position' | 'mode'>
 
-// @mention — dropdown at any position
+// @mention - dropdown at any position
 
 export type MentionTriggerOptions = TriggerPresetOptions & {
   /** Override the trigger character. Defaults to `'@'`. */
@@ -48,14 +48,14 @@ export function mentionTrigger(opts: MentionTriggerOptions = {}): TriggerConfig
   }
 }
 
-// /command — dropdown anywhere (opt into line-start-only with `position`)
+// /command - dropdown anywhere (opt into line-start-only with `position`)
 
 export type CommandTriggerOptions = TriggerPresetOptions & {
   /** Override the trigger character. Defaults to `'/'`. */
   char?: string
   /**
    * Where the command trigger is valid. Defaults to `'any'`, so commands fire
-   * anywhere a `/` follows whitespace — not just at the start of a line.
+   * anywhere a `/` follows whitespace - not just at the start of a line.
    * Set to `'start'` to restrict the dropdown to the very start of the input
    * or immediately after a newline (the classic slash-command behavior).
    */
@@ -83,7 +83,7 @@ export function commandTrigger(opts: CommandTriggerOptions = {}): TriggerConfig
   }
 }
 
-// #hashtag — dropdown at any position, auto-resolve on space
+// #hashtag - dropdown at any position, auto-resolve on space
 
 export type HashtagTriggerOptions = TriggerPresetOptions & {
   /** Override the trigger character. Defaults to `'#'`. */
@@ -132,7 +132,7 @@ export function callbackTrigger(opts: CallbackTriggerOptions): TriggerConfig {
   }
 }
 
-// Launch trigger — fires onActivate and swallows the character
+// Launch trigger - fires onActivate and swallows the character
 
 export type LaunchTriggerOptions = Omit<Partial<TriggerConfig>, 'mode'> & {
   /** The trigger character. Required. */

package/src/components/prompt-area/types.ts

@@ -46,7 +46,7 @@ export type TriggerPosition = 'start' | 'any'
  * - 'dropdown': Shows a popover with suggestions from `onSearch`
  * - 'callback': Inserts the char, then fires `onActivate` with the typed query
  * - 'launch': Fires `onActivate` on keydown and SUPPRESSES the char (it never
- *   enters the editor) — for opening an external surface (dialog, palette) where
+ *   enters the editor) - for opening an external surface (dialog, palette) where
  *   no in-editor text should appear. Honors `position` like the other modes.
  */
 export type TriggerMode = 'dropdown' | 'callback' | 'launch'
@@ -102,7 +102,7 @@ export type TriggerConfig = {
    * For 'dropdown' mode: opt a suggestion out of becoming a chip.
    *
    * Return a string and the trigger's range is replaced with that **plain,
-   * editable text** — the trigger character included — with the caret left at
+   * editable text** - the trigger character included - with the caret left at
    * its end. Return undefined and the suggestion resolves to a chip as usual,
    * so one dropdown can mix both kinds.
    *
@@ -239,7 +239,7 @@ export type PromptAreaProps = {
   /**
    * When markdown is on, the editor rewrites typed list markers (`- ` / `* `)
    * to a `•` bullet glyph in the model. Set to `false` to keep the original
-   * marker in the value/`onChange` text — needed when a host renders the output
+   * marker in the value/`onChange` text - needed when a host renders the output
    * as real markdown, where `•` is not a valid list marker. Default `true`.
    */
   normalizeBullets?: boolean
@@ -271,8 +271,8 @@ export type PromptAreaProps = {
    * the caret kept where the edit happened. Chips count as their
    * `trigger + displayText` length.
    *
-   * The cap applies to typing only. Paste is not capped — divert it via
-   * `onRawPaste` if needed — and the imperative `setText` / `appendText` also
+   * The cap applies to typing only. Paste is not capped - divert it via
+   * `onRawPaste` if needed - and the imperative `setText` / `appendText` also
    * bypass it, so a programmatic write can exceed the cap until the next
    * keystroke truncates.
    */
@@ -316,7 +316,7 @@ export type PromptAreaProps = {
   onBlur?: (e: React.FocusEvent<HTMLDivElement>) => void
   /**
    * Called at the start of a paste, before PromptArea reads the clipboard. Call
-   * `preventDefault()` to take over the paste completely — e.g. to divert large
+   * `preventDefault()` to take over the paste completely - e.g. to divert large
    * text or non-image files to an upload pipeline. The built-in segment/image
    * paste handling is skipped when the event's default is prevented.
    */

package/src/components/prompt-area/use-chip-editing.ts

@@ -80,7 +80,7 @@ export function useChipEditing({
 
   // The chip node currently edited via `reopenOnChipClick`, kept in lockstep with
   // `editingChip`/`activeTrigger`. Answers "is THIS exact element the open one" by
-  // reference identity — trigger+value cannot distinguish two chips sharing a value.
+  // reference identity - trigger+value cannot distinguish two chips sharing a value.
   const openChipNode = useRef<HTMLElement | null>(null)
 
   // Set by `handleMouseDown` when the mousedown landed on `openChipNode.current`;
@@ -88,7 +88,7 @@ export function useChipEditing({
   // "toggle closed". A real mousedown on the editor root rather than a
   // `dismissTrigger` flag: bubbling reaches the root before `document`, where
   // TriggerPopover's outside-click dismiss listens and would clear `openChipNode`
-  // first — and it stays scoped to this node, so an unrelated dismiss cannot poison
+  // first - and it stays scoped to this node, so an unrelated dismiss cannot poison
   // a later click on the same chip.
   const suppressReopenChip = useRef<HTMLElement | null>(null)
 
@@ -106,7 +106,7 @@ export function useChipEditing({
 
       let node: Node | null = target
       while (node && node !== editor) {
-        // Check for URL link click — only navigate on Cmd/Ctrl+Click;
+        // Check for URL link click - only navigate on Cmd/Ctrl+Click;
         // plain click just positions the cursor for editing.
         if (isLinkElement(node)) {
           if (e.metaKey || e.ctrlKey) {
@@ -137,12 +137,12 @@ export function useChipEditing({
           if (chip) {
             // Native chip-click dropdown: reopen this trigger's suggestions
             // anchored to the chip so the selection can replace it in place.
-            // Gated on `!disabled` — a disabled composer must not accept edits
+            // Gated on `!disabled` - a disabled composer must not accept edits
             // through any path, including this one.
             const config = triggers.find((t) => t.char === chip.trigger)
             // A click on THIS exact chip element while its own dropdown was
             // open just closed it (see `suppressReopenChip` and
-            // `handleMouseDown`) — treat that as a toggle-close, not a reopen.
+            // `handleMouseDown`) - treat that as a toggle-close, not a reopen.
             const wasOpenForThisChip = suppressReopenChip.current === node
             suppressReopenChip.current = null
             if (!disabled && !wasOpenForThisChip && config?.reopenOnChipClick && config.mode === 'dropdown' && config.onSearch) {
@@ -212,7 +212,7 @@ export function useChipEditing({
       }
       const editor = editorRef.current
       if (editor && !disabled) {
-        // Re-verify the click-time index still holds the same chip — the
+        // Re-verify the click-time index still holds the same chip - the
         // model may have shifted (external value update, undo/redo) while
         // the dropdown was open. If it moved, recover ONLY when exactly one
         // chip in the document now matches trigger+value: with duplicates,
@@ -258,7 +258,7 @@ export function useChipEditing({
           renderSegmentsToDOM(newSegments)
 
           // Same value + display text + data: treat as a no-op confirmation
-          // rather than a destructive delete+add — onChipDelete is
+          // rather than a destructive delete+add - onChipDelete is
           // documented as firing on backspace/forward-delete, not on
           // re-confirming the already-selected suggestion.
           const unchanged =
@@ -271,7 +271,7 @@ export function useChipEditing({
           }
 
           // +1 when a space was inserted, matching resolveChip's own
-          // "+1 accounts for the trailing space after the chip" placement —
+          // "+1 accounts for the trailing space after the chip" placement -
           // landing exactly at the chip's end would put the caret at the
           // same bare element boundary the inserted space exists to avoid.
           const caretOffset = segmentsToPlainText(newSegments.slice(0, segIdx + 1)).length + (insertedSpace ? 1 : 0)

package/src/components/prompt-area/use-markdown-mode.ts

@@ -37,7 +37,7 @@ import { useCallback, useMemo, useState } from 'react'
  */
 export type PromptAreaMode = 'markdown' | 'plain'
 
-/** Returns the other mode. Pure — handy for building custom toggles. */
+/** Returns the other mode. Pure - handy for building custom toggles. */
 export function oppositeMode(mode: PromptAreaMode): PromptAreaMode {
   return mode === 'markdown' ? 'plain' : 'markdown'
 }
@@ -47,7 +47,7 @@ export type UseMarkdownModeOptions = {
   initialMode?: PromptAreaMode
   /**
    * Controlled mode. When provided, the hook mirrors this value and never owns
-   * its own state — drive changes through `onModeChange`.
+   * its own state - drive changes through `onModeChange`.
    */
   mode?: PromptAreaMode
   /** Called with the next mode whenever `toggle`/`setMode` change it. */
@@ -57,7 +57,7 @@ export type UseMarkdownModeOptions = {
 export type MarkdownModeState = {
   /** The active mode. */
   mode: PromptAreaMode
-  /** `true` in markdown mode — spread onto `<PromptArea markdown={markdown} />`. */
+  /** `true` in markdown mode - spread onto `<PromptArea markdown={markdown} />`. */
   markdown: boolean
   /** `true` in plain-text mode (the inverse of `markdown`). */
   isPlainText: boolean

package/src/components/prompt-area/use-prompt-area-events.ts

@@ -165,9 +165,9 @@ export function usePromptAreaEvents(deps: EventHandlerDeps): PromptAreaEventHand
       }
 
       // When markdown mode is on, prefer the richest clipboard flavor:
-      //   1. text/markdown — some apps (e.g. Slack) hand out markdown directly,
+      //   1. text/markdown - some apps (e.g. Slack) hand out markdown directly,
       //      preserving nested lists that their text/plain flattens.
-      //   2. text/html     — convert web/Notion/Docs/GitHub HTML to markdown.
+      //   2. text/html     - convert web/Notion/Docs/GitHub HTML to markdown.
       // Otherwise (markdown off, or neither present) fall back to plain text.
       let text = ''
       if (markdownEnabled) {
@@ -180,7 +180,7 @@ export function usePromptAreaEvents(deps: EventHandlerDeps): PromptAreaEventHand
         } else {
           const html = e.clipboardData.getData('text/html')
           // A converter failure (e.g. stack overflow on pathologically deep
-          // nesting) must not drop the paste — leave text empty so the
+          // nesting) must not drop the paste - leave text empty so the
           // text/plain fallback below still runs.
           if (html) {
             try {

package/src/components/prompt-area/use-prompt-area-keydown.ts

@@ -373,7 +373,7 @@ export function usePromptAreaKeydown({
       }
 
       // 1.75 Launch triggers: a trigger with mode 'launch' fires onActivate on
-      // keydown and suppresses the char so it never enters the editor — for
+      // keydown and suppresses the char so it never enters the editor - for
       // opening an external surface (dialog, palette). The DOM read is gated on
       // the typed key actually matching a launch char, so it stays off the hot
       // path. insertChip still inserts a chip at the cursor if the consumer
@@ -406,7 +406,7 @@ export function usePromptAreaKeydown({
       // 2. Trigger dropdown navigation. Gated on the dropdown actually being
       // ON SCREEN, which matches TriggerPopover's own render condition
       // (non-empty suggestions, OR loading/error/emptyMessage) rather than
-      // just `suggestions.length > 0` — otherwise a popover left open in a
+      // just `suggestions.length > 0` - otherwise a popover left open in a
       // loading/empty state (e.g. right after a chip-click reopen, before its
       // empty-query search resolves) lets Enter fall through to onSubmit and
       // Escape fall through to onEscape while still visibly on screen.
@@ -499,7 +499,7 @@ export function usePromptAreaKeydown({
       }
 
       // 3. Enter without Shift (skipping IME): under `submitOnEnter` it submits
-      // *unconditionally* — the send key must not turn into "another bullet" because
+      // *unconditionally* - the send key must not turn into "another bullet" because
       // of what the line above starts with; list continuation lives on Shift+Enter
       // (branch 2.8). Without `submitOnEnter`, Enter is the newline key and continues.
       if (e.key === 'Enter' && !e.shiftKey && !e.nativeEvent.isComposing) {

package/src/components/prompt-area/use-prompt-area-state.ts

@@ -35,11 +35,11 @@ export type UsePromptAreaStateOptions = {
 }
 
 export type PromptAreaBind = {
-  /** Ref to attach to PromptArea — gives access to imperative methods. */
+  /** Ref to attach to PromptArea - gives access to imperative methods. */
   ref: React.RefObject<PromptAreaHandle | null>
-  /** Current segment array — pass as `value` prop. */
+  /** Current segment array - pass as `value` prop. */
   value: Segment[]
-  /** Setter — pass as `onChange` prop. */
+  /** Setter - pass as `onChange` prop. */
   onChange: (segments: Segment[]) => void
 }
 
@@ -83,7 +83,7 @@ export function usePromptAreaState(options: UsePromptAreaStateOptions = {}): Pro
 
   const chips = useMemo(() => value.filter((seg): seg is ChipSegment => seg.type === 'chip'), [value])
 
-  // Bind object — safe to spread onto <PromptArea>
+  // Bind object - safe to spread onto <PromptArea>
   const bind = useMemo<PromptAreaBind>(() => ({ ref, value, onChange: setValue }), [value])
 
   const clear = useCallback(() => {