@cueloop/client 0.1.0-alpha.102 → 0.1.0-alpha.104

package/src/keyboard/keymap.ts

@@ -121,9 +121,11 @@ export function reduceKey(state: KeyState, key: KeyInput, resolvedAction?: strin
   const overlayGrammar = overlayGrammars[state.overlay];
 
   if (overlayGrammar) return overlayGrammar(state, key);
+
   const action = resolvedAction ?? actionFor(state.keys, name, key.shift);
 
   if (action === "quit") return [{ type: "exit" }];
+
   // the ONE read-only rule: any mutating attempt answers instead of acting
   // (span-mode c, x, and a are hardwired keys, so they gate by name as well)
   const mutating =
@@ -140,8 +142,10 @@ export function reduceKey(state: KeyState, key: KeyInput, resolvedAction?: strin
   }
 
   if (state.view === "inbox") return inboxGrammar(state, name);
+
   // span mode owns its single-letter keys (b slides the span back)
   if (state.spanMode) return spanGrammar(state, name);
+
   if (state.view === "diff") return diffGrammar(state, action);
 
   return planGrammar(state, action, name);
@@ -164,6 +168,7 @@ function composeOverlayGrammar(state: KeyState, key: KeyInput): Intent[] {
   const name = key.name;
 
   if (name === "escape") return [{ type: "closeOverlay" }];
+
   if (name === "return" || name === "enter") {
     // In the composer, ⌥/Alt+⏎ (meta) and shift+⏎ insert a newline - the
     // focused textarea owns that; only a bare ⏎ saves. The submit overlay
@@ -180,6 +185,7 @@ function submitOverlayGrammar(state: KeyState, key: KeyInput): Intent[] {
   const name = key.name;
 
   if (name === "escape") return [{ type: "closeOverlay" }];
+
   if (name === "left" || name === "right") {
     return [{ type: "cycleMessage", direction: name === "left" ? -1 : 1 }];
   }
@@ -191,6 +197,7 @@ function confirmOverlayGrammar(state: KeyState, key: KeyInput): Intent[] {
   const name = key.name;
 
   if (name === "return" || name === "enter") return [{ type: "confirmDialog" }];
+
   if (name === "escape") return [{ type: "closeOverlay" }];
 
   return [];
@@ -200,6 +207,7 @@ function promptOverlayGrammar(state: KeyState, key: KeyInput): Intent[] {
   const name = key.name;
 
   if (name === "return" || name === "enter") return [{ type: "confirmDialog" }];
+
   if (name === "escape") return [{ type: "closeOverlay" }];
 
   return [];
@@ -209,8 +217,11 @@ function spanActionsOverlayGrammar(state: KeyState, key: KeyInput): Intent[] {
   const name = key.name;
 
   if (name === "j" || name === "down") return [{ type: "moveSpanAction", direction: 1 }];
+
   if (name === "k" || name === "up") return [{ type: "moveSpanAction", direction: -1 }];
+
   if (name === "return" || name === "enter") return [{ type: "pickSpanAction" }];
+
   if (name === "escape") return [{ type: "closeSpanActions" }];
 
   return [];
@@ -220,7 +231,9 @@ function completionOverlayGrammar(state: KeyState, key: KeyInput): Intent[] {
   const name = key.name;
 
   if (name === "return" || name === "enter" || name === "q") return [{ type: "finishReview" }];
+
   if (name === "a") return [{ type: "optInAutoClose" }];
+
   if (name === "escape") return [{ type: "dismissCompletion" }];
 
   return [];
@@ -230,11 +243,15 @@ function walkOverlayGrammar(state: KeyState, key: KeyInput): Intent[] {
   const name = key.name;
 
   if (name === "]") return [{ type: "walkForward" }];
+
   if (name === "[") return [{ type: "walkBack" }];
+
   if (name === "escape") return [{ type: "walkLeave" }];
+
   if ((name === "return" || name === "enter") && state.walkAtEnd) {
     return [{ type: "walkLeave" }, { type: "openSubmit" }];
   }
+
   if (name === "q") return [{ type: "exit" }];
 
   return [];
@@ -242,9 +259,13 @@ function walkOverlayGrammar(state: KeyState, key: KeyInput): Intent[] {
 
 function inboxGrammar(state: KeyState, name: string): Intent[] {
   if (!state.hasInboxItems) return [];
+
   if (name === "j" || name === "down") return [{ type: "inboxMove", to: "down" }];
+
   if (name === "k" || name === "up") return [{ type: "inboxMove", to: "up" }];
+
   if (name === "return" || name === "enter") return [{ type: "openSession" }];
+
   if (name === "d") return [{ type: "requestDeleteSession" }];
 
   return [];
@@ -254,39 +275,49 @@ function diffGrammar(state: KeyState, action: string | undefined): Intent[] {
   const navigation = navigationIntent(action);
 
   if (navigation) return navigation;
+
   if (action === "walk") {
     // marking viewed writes the session record, so a resolved review answers
     if (state.resolved) return status("review submitted - read-only");
 
     return [{ type: "walkStart" }];
   }
+
   if (action === "comment") {
     if (state.resolved) return status("review submitted - read-only");
+
     if (!state.cursorAnnotatable) return status("move to a code line to comment");
 
     return [{ type: "openCompose", kind: "comment", from: "cursor" }];
   }
+
   // cut rejects the change under the cursor, reject_hunk the whole hunk; both
   // write the working copy, so they gate on owner like a plan edit.
   if (action === "cut" || action === "reject_hunk") {
     if (state.resolved) return status("review submitted - read-only");
+
     if (state.canEditPlan === false) return status("only the diff owner can curate hunks");
 
     return [{ type: action === "reject_hunk" ? "rejectHunk" : "rejectChange" }];
   }
+
   const viewToggle = viewToggleIntent(action);
 
   if (viewToggle) return viewToggle;
+
   // restore un-does a curated-out rejection from the rail; same owner gate as reject
   if (action === "restore_curation") {
     if (state.resolved) return status("review submitted - read-only");
+
     if (state.canEditPlan === false) return status("only the diff owner can curate hunks");
 
     return [{ type: "restoreCuration" }];
   }
+
   const shared = annotationCluster(state, action);
 
   if (shared) return shared;
+
   if (action === "span" || action === "edit") {
     return status("plan-only primitive - diff review uses c on a line");
   }
@@ -296,13 +327,18 @@ function diffGrammar(state: KeyState, action: string | undefined): Intent[] {
 
 function spanGrammar(state: KeyState, name: string): Intent[] {
   if (name === "escape") return [{ type: "closeOverlay" }];
+
   if (SPAN_KEYS.has(name)) return [{ type: "spanKey", name }];
+
   // c comments, x cuts, a opens quick-actions - all mutate, so a resolved
   // review is read-only, like the plan grammar
   if (name === "c" || name === "x" || name === "a") {
     if (state.resolved) return status("review submitted - read-only");
+
     if (name === "c") return [{ type: "openCompose", kind: "comment", from: "span" }];
+
     if (name === "a") return [{ type: "openSpanActions" }];
+
     if (state.canEditPlan === false) return [];
 
     return [{ type: "spanCut" }];
@@ -315,28 +351,38 @@ function planGrammar(state: KeyState, action: string | undefined, name: string):
   const navigation = navigationIntent(action);
 
   if (navigation) return navigation;
+
   if (action === "walk") return status("the guided walk is a diff-review mode");
+
   if (name === "escape") return [{ type: "deselect" }];
+
   if (action === "span") return state.cursorAnnotatable ? [{ type: "startSpan" }] : [];
+
   if (action === "comment") {
     if (state.resolved) return status("review submitted - read-only");
+
     if (!state.cursorAnnotatable) return status("text is cut - restore it first");
 
     return [{ type: "openCompose", kind: "comment", from: "cursor" }];
   }
+
   // restore un-does a rail removal (a cut block); a plan edit, so owner-only
   if (action === "restore_curation") {
     if (state.resolved) return status("review submitted - read-only");
+
     if (state.canEditPlan === false) return [];
 
     return [{ type: "restoreCuration" }];
   }
+
   if (action === "cut" || action === "edit") {
     if (state.resolved) return status("review submitted - read-only");
+
     // the document selects, the rail edits: with a card selected, Cut deletes
     // the annotation and edit rewrites the card body in place
     if (state.hasFocusedAnnotation)
       return [action === "cut" ? { type: "removeAnnotation" } : { type: "editCard" }];
+
     // editing the plan itself is the owner's primitive; a share viewer only annotates,
     // and has no edit affordance, so the key is silent rather than a nag
     if (state.canEditPlan === false) return [];
@@ -360,7 +406,9 @@ function navigationIntent(action: string | undefined): Intent[] | null {
  *  split/stacked (split lays out only when the Changes pane is wide/zoomed). */
 function viewToggleIntent(action: string | undefined): Intent[] | null {
   if (action === "collapse_file") return [{ type: "foldFile" }];
+
   if (action === "expand_file") return [{ type: "unfoldFile" }];
+
   if (action === "split_diff") return [{ type: "toggleDiffView" }];
 
   return null;
@@ -373,16 +421,19 @@ function annotationCluster(state: KeyState, action: string | undefined): Intent[
 
     return [{ type: action === "next_annotation" ? "nextAnnotation" : "prevAnnotation" }];
   }
+
   if (action === "delete_annotation") {
     if (state.resolved || !state.hasFocusedAnnotation) return [];
 
     return [{ type: "removeAnnotation" }];
   }
+
   if (action === "rename") {
     if (!state.hasFocusedAnnotation) return status("select a collaborator's note to rename them");
 
     return [{ type: "openRename" }];
   }
+
   if (action === "submit") {
     // a collaborator's notes union back as they go; there is no message to submit
     if (state.canSubmitMessage === false)

package/src/keyboard/skills.ts

@@ -37,6 +37,7 @@ export function loadSkills(dir: string): SlashItem[] {
 
   for (const entry of entries) {
     if (!entry.isDirectory()) continue;
+
     let text;
 
     try {
@@ -47,6 +48,7 @@ export function loadSkills(dir: string): SlashItem[] {
     const frontmatter = /^---\n([\s\S]*?)\n---/.exec(text.replace(/\r\n/g, "\n"));
 
     if (!frontmatter) continue;
+
     const name = v.safeParse(
       SkillNameSchema,
       frontmatterValue(frontmatter[1]!, "name") ?? entry.name,

package/src/keyboard/slash-palette.ts

@@ -28,11 +28,14 @@ const WORD_BOUNDARY = /[\s\-_./:]/;
 /** Order-preserving subsequence score, or null when a query character is missing; higher is better. */
 export function scoreMatch(name: string, query: string): number | null {
   if (query.length === 0) return 0;
+
   const lowerName = name.toLowerCase();
   const lowerQuery = query.toLowerCase();
 
   if (lowerName === lowerQuery) return 1000;
+
   if (lowerName.startsWith(lowerQuery)) return 500 - name.length;
+
   let score = 0;
   let cursor = 0;
   let run = 0;
@@ -41,9 +44,12 @@ export function scoreMatch(name: string, query: string): number | null {
     const found = lowerName.indexOf(character, cursor);
 
     if (found === -1) return null;
+
     run = found === cursor ? run + 1 : 0;
     score += found === cursor ? 5 + run : 1;
+
     if (found === 0 || WORD_BOUNDARY.test(lowerName[found - 1]!)) score += 10;
+
     score -= found - cursor;
     cursor = found + 1;
   }
@@ -53,6 +59,7 @@ export function scoreMatch(name: string, query: string): number | null {
 
 export function slashFilter(items: SlashItem[], query: string): SlashItem[] {
   if (query.length === 0) return items;
+
   const scored: Array<{ item: SlashItem; score: number }> = [];
 
   for (const item of items) {
@@ -113,6 +120,7 @@ export function skillReferenceRanges(
     const token = match[1]!;
 
     if (!names.has(token.slice(1))) continue;
+
     const start = match.index + match[0].length - token.length;
 
     ranges.push({ start, end: start + token.length });

package/src/keyboard/thread-chords.ts

@@ -61,6 +61,7 @@ const RESOLVED: Intent = { type: "status", message: "review submitted - read-onl
 
 function mutating(intent: Intent, context: ThreadNavContext): Intent {
   if (!context.isOwner) return READ_ONLY;
+
   if (context.resolved) return RESOLVED;
 
   return intent;
@@ -134,13 +135,17 @@ export function resolveSessionChord(
 ): Intent | null {
   if (key.name === "return" || key.name === "enter") {
     if (!(key.ctrl || key.meta || key.super)) return null;
+
     if (!context.isOwner) return READ_ONLY;
 
     return context.resolved ? null : { type: "openSubmit" };
   }
+
   if (!key.ctrl) return null;
+
   if (key.name === "e")
     return context.resolved ? RESOLVED : context.isOwner ? { type: "edit" } : READ_ONLY;
+
   if (key.name === "s") return context.isOwner ? { type: "share" } : READ_ONLY;
 
   return null;

package/src/keyboard/use-shared-keyboard.ts

@@ -34,6 +34,7 @@ function subscribeToKeypress(input: KeyInput, handler: KeyHandler): () => void {
 
   return () => {
     handlers.delete(handler);
+
     if (handlers.size > 0) return;
 
     input.off("keypress", notify);

package/src/markdown/components/MarkdownThreadEditor.tsx

@@ -53,6 +53,7 @@ function newlinePrefixCounts(text: string): number[] {
 
   for (let index = 0; index < text.length; index++) {
     counts[index] = seen;
+
     if (text[index] === "\n") seen += 1;
   }
   counts[text.length] = seen;
@@ -96,6 +97,7 @@ export const MarkdownThreadEditor = forwardRef<MarkdownEditorHandle, MarkdownThr
       const editor = editorRef.current;
 
       if (!editor) return;
+
       editor.editBuffer.setSyntaxStyle(markdownEditorStyle(theme).style);
       paintMarkdown(editor);
       setPosition((prior) => ({ ...prior, lineCount: editor.editBuffer.getLineCount() }));
@@ -123,6 +125,7 @@ export const MarkdownThreadEditor = forwardRef<MarkdownEditorHandle, MarkdownThr
             const editor = editorRef.current;
 
             if (!editor) return;
+
             paintMarkdown(editor);
             setPosition((prior) => ({ ...prior, lineCount: editor.editBuffer.getLineCount() }));
           }}

package/src/markdown/components/ThreadView.selection.test.tsx

@@ -98,6 +98,7 @@ function highlightedByRow(): Map<number, string> {
 
       if (backdrop || (caretCell && underlined)) marked += span.text;
     }
+
     if (marked.length > 0) rows.set(rowIndex, marked);
   });
 
@@ -121,6 +122,7 @@ function caretCells(): Array<{ row: number; column: number; text: string }> {
       if (red === CARET_RGB[0] && green === CARET_RGB[1] && blue === CARET_RGB[2]) {
         cells.push({ row, column, text: span.text });
       }
+
       column += span.width;
     }
   });
@@ -158,6 +160,7 @@ async function framesUntilHighlight(expected: string, limit = 4): Promise<number
     // one scheduler turn (the input parser and React commit), then one frame
     await new Promise((resolve) => setTimeout(resolve, 0));
     await setup.renderOnce();
+
     if (highlightedText() === expected) return frame;
   }
 

package/src/markdown/components/ThreadView.tsx

@@ -103,7 +103,9 @@ function blockStyle(block: DisplayBlock, tokens: Theme): BlockStyle {
 /** The read-only color of an inline markdown role: links accent, code and removals dim, insertions green. */
 function roleForeground(role: RunRole, baseFg: string, tokens: Theme): string {
   if (role === "link") return tokens.blue;
+
   if (role === "ins") return tokens.green;
+
   if (role === "code" || role === "del") return tokens.textDim;
 
   return baseFg;
@@ -112,7 +114,9 @@ function roleForeground(role: RunRole, baseFg: string, tokens: Theme): string {
 /** The text attributes an inline role adds over a block's base attributes. */
 function roleAttributes(role: RunRole, baseAttributes: number): number {
   if (role === "strong") return baseAttributes | BOLD;
+
   if (role === "em") return baseAttributes | ITALIC;
+
   if (role === "strike" || role === "del") return baseAttributes | CUT;
 
   return baseAttributes;
@@ -288,6 +292,7 @@ export function ThreadView({
     const block = display[index];
 
     if (!block) return 1;
+
     const usable = viewWidth > 0 ? Math.max(1, viewWidth - 6) : 40;
     const lines = Math.max(1, Math.ceil(displayText(block).length / usable));
 
@@ -378,6 +383,7 @@ export function ThreadView({
   // measurement never adds a row and shifts the blocks below it out from under a pending click
   const headingRule = (block: DisplayBlock): React.ReactNode => {
     if (block.kind !== "h1" && block.kind !== "h2") return null;
+
     const width = Math.max(1, (viewWidth > 6 ? viewWidth : 46) - 6);
 
     return (
@@ -398,6 +404,7 @@ export function ThreadView({
           {custom}
         </box>
       );
+
     const block = display[blockIndex]!;
     const { baseFg, baseAttributes, marker } = blockStyle(block, tokens);
     // list items of one list stay tight; every other block sits a blank row below its neighbour
@@ -472,8 +479,11 @@ export function ThreadView({
           cards.length > 0,
         ),
       );
+
       if (isLastLine) lineRows.push(headingRule(block));
+
       lineRows.push(...cards);
+
       if (cards.length > 0 && !isLastLine) {
         lineRows.push(<box key={`gap-${lineIndex}`} style={{ height: 1 }} />);
       }
@@ -508,14 +518,17 @@ export function ThreadView({
       for (let index = 0; index < display.length; index++) {
         nodes.push(blockNodeFor(index));
         mountedRows += estimateBlockRows(index);
+
         if (mountedRows > terminalHeight + OVERSCAN_BLOCKS) break;
       }
 
       return nodes;
     }
+
     if (firstItem.start > 0) {
       nodes.push(<box key="spacer-above" style={{ height: firstItem.start }} />);
     }
+
     for (const item of virtual.items) nodes.push(blockNodeFor(item.index));
     const below = virtual.totalSize - lastItem.end;
 

package/src/markdown/mark-runs.ts

@@ -36,6 +36,7 @@ export function runsFor(text: string, ranges: MarkRange[]): Run[] {
     const end = edges[index + 1]!;
 
     if (end <= start) continue;
+
     const covering = ranges.filter((range) => range.start <= start && end <= range.end);
 
     // the caret cell shows through a mark, so the head of a selection is visible
@@ -84,6 +85,7 @@ export function wrapLines(text: string, width: number): VisualLine[] {
           lines.push({ start: lineStart, end: lineEnd });
           lineStart = wordStart;
         }
+
         // a token wider than the line (a long identifier, a URL) breaks at the cell edge, so
         // every visual line stays one terminal row and nothing is clipped away
         while (wordEnd - lineStart > width) {
@@ -94,6 +96,7 @@ export function wrapLines(text: string, width: number): VisualLine[] {
       }
       lines.push({ start: lineStart, end: Math.max(lineEnd, lineStart) });
     }
+
     segmentStart = segmentEnd + 1;
   }
 
@@ -114,6 +117,7 @@ export function lineMarkRanges(ranges: MarkRange[], line: VisualLine): MarkRange
 /** Printable input that should reach a composer: one key, or a whole pasted run in one event. */
 export function printableSequence(key: KeyEvent): string | null {
   if (!key.sequence || key.ctrl || key.meta) return null;
+
   // reject any run carrying a control byte, so escape sequences and \r\t\b never seed a draft
   for (const character of key.sequence) if (character < " ") return null;
 

package/src/markdown/markdown-editor-syntax-style.ts

@@ -32,6 +32,7 @@ export function markdownEditorStyle(theme: Theme): MarkdownEditorStyle {
   const cached = markdownEditorStyleCache.get(theme);
 
   if (cached) return cached;
+
   const groupStyles = markdownGroupStyles(theme);
   const style = SyntaxStyle.fromStyles(groupStyles);
   const styleIds = new Map<MarkdownHighlightGroup, number>();

package/src/markdown/markdown-grid.ts

@@ -52,7 +52,9 @@ function splitTableRow(line: string): string[] {
     }
   }
   parts.push(cell);
+
   if (parts.length > 1 && parts[0] === "") parts.shift();
+
   if (parts.length > 1 && parts[parts.length - 1] === "") parts.pop();
 
   return parts.map((part) => part.trim());
@@ -78,6 +80,7 @@ function pad(text: string, width: number, align: ColumnAlign): string {
   const slack = Math.max(0, width - text.length);
 
   if (align === "right") return " ".repeat(slack) + text;
+
   if (align === "center") {
     const left = Math.floor(slack / 2);
 
@@ -132,6 +135,7 @@ export function parseFrontmatterRows(text: string): FrontmatterRow[] {
 
   for (const line of text.split("\n")) {
     if (line.trim() === "") continue;
+
     const match = /^([^:\s][^:]*):\s?(.*)$/.exec(line);
 
     if (match) {
@@ -163,6 +167,7 @@ function wrapCell(value: string, width: number): string[] {
  */
 export function layoutFrontmatterGrid(rows: FrontmatterRow[], maxWidth: number): GridLine[] {
   if (rows.length === 0) return [];
+
   const keyWidth = Math.max(3, ...rows.map((row) => row.key.length));
   // size the value column to its content, capped at the width left after the key column and borders,
   // so a short frontmatter table stays compact and a long value wraps instead of overflowing
@@ -183,6 +188,7 @@ export function layoutFrontmatterGrid(rows: FrontmatterRow[], maxWidth: number):
 
   rows.forEach((row, rowIndex) => {
     if (rowIndex > 0) lines.push(rule("├", "┼", "┤"));
+
     const valueLines = wrapCell(row.value, valueWidth);
 
     valueLines.forEach((valueLine, valueIndex) => {

package/src/markdown/markdown-highlight.ts

@@ -50,6 +50,7 @@ function scanInlineTokens(text: string, base: number, into: MarkdownHighlightRan
       into.push({ start, end, group: "code" });
       continue;
     }
+
     // a link colors its brackets and href; the [] label stays plain unless it is an @-scope, matching how a
     // markdown source view paints links
     const closeBracket = token.indexOf("]");

package/src/markdown/thread-code-syntax.ts

@@ -14,6 +14,7 @@ export async function highlightThreadCodeBlocks(
 ): Promise<Map<number, SyntaxSpan[]>> {
   const jobs = display.flatMap((block, blockIndex) => {
     if (block.kind !== "code") return [];
+
     const filetype = filetypeFor(block.work?.lang ?? block.base?.lang);
 
     return filetype ? [{ blockIndex, filetype, source: renderedText(block) }] : [];
@@ -21,6 +22,7 @@ export async function highlightThreadCodeBlocks(
   const byBlock = new Map<number, SyntaxSpan[]>();
 
   if (jobs.length === 0) return byBlock;
+
   const client = getTreeSitterClient();
 
   await client.initialize();
@@ -28,6 +30,7 @@ export async function highlightThreadCodeBlocks(
     const result = await client.highlightOnce(job.source, job.filetype);
 
     if (!result.highlights) continue;
+
     const spans: SyntaxSpan[] = [];
     let offset = 0;
     const lines = job.source.split("\n");