berry-agent 0.1.0-alpha.1

package/dist/channels/tui/markdown/inline.js

@@ -0,0 +1,75 @@
+/**
+ * Markdown 行内解析件（07 §4.1 引擎节件 6 Markdown 件——批 10d-4）。
+ *
+ * 手写扫描器四标记（v1 平面——嵌套标记不递归）：
+ * `**bold**` / `*italic*` / `` `code` `` / `[label](url)`（呈现取 label +
+ * underline——TUI 中性形，URL 不外显）。未闭合标记按普通文本回退（坏输入
+ * 不丢字）；空标记体（`****`）不产空 span。
+ */
+/**
+ * 行内解析：文本 → 样式段序列。
+ *
+ * 优先序：`**` 先于 `*`（前缀撞车时 bold 赢）；`[` 用 `](` 连续判据（label
+ * 内含 `]` 的罕见形不支撑——v1 已知边界）。
+ */
+export function parseInline(text) {
+    const spans = [];
+    let plain = ''; // 普通文本累积（相邻同形合并——flush 才成段）
+    let i = 0;
+    const flush = () => {
+        if (plain !== '') {
+            spans.push({ text: plain });
+            plain = '';
+        }
+    };
+    while (i < text.length) {
+        const ch = text[i];
+        // **bold**（** 先试——命中即吞两字符，* 不会误抢）
+        if (ch === '*' && text[i + 1] === '*') {
+            const end = text.indexOf('**', i + 2);
+            if (end > i + 2) {
+                flush();
+                spans.push({ text: text.slice(i + 2, end), bold: true });
+                i = end + 2;
+                continue;
+            }
+        }
+        // *italic*
+        if (ch === '*') {
+            const end = text.indexOf('*', i + 1);
+            if (end > i + 1) {
+                flush();
+                spans.push({ text: text.slice(i + 1, end), italic: true });
+                i = end + 1;
+                continue;
+            }
+        }
+        // `code`
+        if (ch === '`') {
+            const end = text.indexOf('`', i + 1);
+            if (end > i + 1) {
+                flush();
+                spans.push({ text: text.slice(i + 1, end), code: true });
+                i = end + 1;
+                continue;
+            }
+        }
+        // [label](url) → label + underline
+        if (ch === '[') {
+            const close = text.indexOf('](', i + 1);
+            if (close > i) {
+                const urlEnd = text.indexOf(')', close + 2);
+                if (urlEnd > close + 1) {
+                    flush();
+                    spans.push({ text: text.slice(i + 1, close), underline: true });
+                    i = urlEnd + 1;
+                    continue;
+                }
+            }
+        }
+        plain += ch;
+        i++;
+    }
+    flush();
+    return spans;
+}

package/dist/channels/tui/markdown/markdown.js

@@ -0,0 +1,182 @@
+/**
+ * Markdown 渲染件（07 §4.1 引擎节件 6 + 呈现面件 1——批 10d-4）。
+ *
+ * - 两段语义的「定稿」腿：流式期纯文本直推（装配策略，批 10e 接）、
+ *   message_end 定稿换装本件（流式槽原位差分的换入对象）；
+ * - 内置中性 ANSI 配色、不接语法高亮库：行内代码 ANSI 2（绿）、引用
+ *   dim、标题 bold、链接 underline——**不触 accent**（引擎节件 3 着色纪律：
+ *   accent 只用于焦点指示面，正文不混用）；
+ * - 滚动帽语义 = 块数（呈现面件 1）——`blockCount` 即帽额度计数面；
+ * - 折行按显示宽字素硬折（复用 width 件三规则——宽字不产半字、不悬挂）；
+ *   折点后的行首空格游程跳过（软换行折叠的呈现收口）。
+ */
+import { ansiColor, graphemeWidth, splitGraphemes, } from '../../engine/index.js';
+import { parseMarkdown } from './blocks.js';
+/** 行内代码配色（ANSI 2 绿——终端代码传统色；与 accent〔cyan 6〕分立，正文不触 accent 家族） */
+const CODE_COLOR = ansiColor(2);
+/** 引用块基础样式（dim——存在感弱于正文） */
+const DIM_STYLE = Object.freeze({ dim: true });
+/** span 样式解析（与块基础样式合并——行内位覆盖 base 的同名位） */
+function spanStyle(span, base) {
+    const style = base !== undefined ? { ...base } : {};
+    if (span.code === true)
+        style.fg = CODE_COLOR;
+    if (span.bold === true)
+        style.bold = true;
+    if (span.italic === true)
+        style.italic = true;
+    if (span.underline === true)
+        style.underline = true;
+    return Object.keys(style).length > 0 ? Object.freeze(style) : undefined;
+}
+/** spans 按显示宽折行（行满开新行；折点后行首空格游程跳过） */
+function layoutSpans(spans, width, base) {
+    const rows = [];
+    let current = [];
+    let used = 0;
+    const openRow = () => {
+        current = [];
+        used = 0;
+    };
+    for (const span of spans) {
+        const style = spanStyle(span, base);
+        for (const g of splitGraphemes(span.text)) {
+            if (g === ' ' && used === 0 && rows.length > 0)
+                continue; // 折点后行首空格跳过
+            const w = graphemeWidth(g);
+            if (w > width)
+                continue; // 防御位：比行宽还宽的字素丢弃（width 件三规则外的不可能格）
+            if (used + w > width) {
+                rows.push(current);
+                openRow();
+                if (g === ' ')
+                    continue; // 恰在折点上的空格不进新行
+            }
+            current.push({ grapheme: g, style });
+            used += w;
+        }
+    }
+    if (current.length > 0 || rows.length === 0)
+        rows.push(current); // 尾行收口（空段落落一行空行）
+    return rows;
+}
+/** 纯文本行折行（代码块体——无行内解析，样式恒定整体替换） */
+function layoutPlain(text, width, style) {
+    return layoutSpans([{ text }], width).map((row) => row.map((cell) => ({ grapheme: cell.grapheme, style })));
+}
+/** 前缀串 → 字素列（列表标记/引用竖线等固定前缀） */
+function prefixCells(prefix, style) {
+    return splitGraphemes(prefix).map((grapheme) => ({ grapheme, style }));
+}
+/** 单块布局 → 渲染行集（块型分派；行首前缀 + 折行 + 层级缩进） */
+function blockRows(block, width) {
+    switch (block.type) {
+        case 'heading': {
+            // 标题：整行强制 bold（行内样式位叠加保留——code 色不丢）；H1/H2 尾随分隔线
+            const rows = layoutSpans(block.spans, width, { bold: true });
+            if (block.level <= 2) {
+                rows.push(splitGraphemes('─'.repeat(width)).map((grapheme) => ({ grapheme, style: DIM_STYLE })));
+            }
+            return rows;
+        }
+        case 'paragraph':
+            return layoutSpans(block.spans, width);
+        case 'list-item': {
+            // 前缀 = 嵌套缩进 + 标记 + 空格；续行对齐前缀宽（视觉续挂）
+            const prefix = `${'  '.repeat(block.indent)}${block.marker} `;
+            const prefixWidth = splitGraphemes(prefix).reduce((sum, g) => sum + graphemeWidth(g), 0);
+            const body = layoutSpans(block.spans, Math.max(1, width - prefixWidth));
+            return body.map((row, index) => [
+                ...(index === 0 ? prefixCells(prefix) : prefixCells(' '.repeat(prefixWidth))),
+                ...row,
+            ]);
+        }
+        case 'code': {
+            // 代码块：竖线前缀贯通（含折行续行）+ 原样文本（无行内解析）
+            const bodyWidth = Math.max(1, width - 2);
+            const rows = [];
+            for (const line of block.lines)
+                rows.push(...layoutPlain(line, bodyWidth));
+            return rows.map((row) => [...prefixCells('│ '), ...row]);
+        }
+        case 'quote': {
+            // 引用：首列竖线 + dim 基础样式（行内样式位叠加）
+            const rows = [];
+            for (const line of block.lines)
+                rows.push(...layoutSpans(line, Math.max(1, width - 2), DIM_STYLE));
+            return rows.map((row) => [...prefixCells('┆ ', DIM_STYLE), ...row]);
+        }
+        case 'hr':
+            return [splitGraphemes('─'.repeat(width)).map((grapheme) => ({ grapheme, style: DIM_STYLE }))];
+    }
+}
+/** Markdown 渲染件：构造后静态不可变（文本件纪律——状态归持有方自管） */
+export class MarkdownDoc {
+    parsed;
+    /** 布局缓存（width 单槽——文本不可变，换宽整体重算） */
+    cacheWidth = -1;
+    cacheRows = [];
+    constructor(text) {
+        this.parsed = parseMarkdown(text);
+    }
+    /** 便捷构造（换装装配点直呼） */
+    static of(text) {
+        return new MarkdownDoc(text);
+    }
+    /** 块序列（只读观测面） */
+    get blocks() {
+        return this.parsed;
+    }
+    /** 块计数——主屏滚动帽的额度单位（呈现面件 1：一个 Markdown 块一子行） */
+    get blockCount() {
+        return this.parsed.length;
+    }
+    /** 量高：全块行数 + 块间空行（n-1 段间距——量高即分配承诺） */
+    measure(width) {
+        const rows = this.layout(width);
+        return rows.length;
+    }
+    /** 落位渲染：缓存行集逐行写（相邻同样式游程合并 writeText——省格级调用） */
+    render(buffer, region) {
+        const rows = this.layout(region.width);
+        const max = Math.min(rows.length, region.height);
+        for (let r = 0; r < max; r++) {
+            let col = region.col;
+            let run = '';
+            let runStyle;
+            // 游程起点显式跟踪（宽字素占两格——run 码位数算不出格位）
+            let runStart = region.col;
+            const flush = () => {
+                if (run !== '')
+                    buffer.writeText(region.row + r, runStart, run, runStyle);
+            };
+            for (const cell of rows[r]) {
+                if (cell.style !== runStyle) {
+                    flush();
+                    run = cell.grapheme;
+                    runStyle = cell.style;
+                    runStart = col;
+                }
+                else {
+                    run += cell.grapheme;
+                }
+                col += graphemeWidth(cell.grapheme); // 按显示宽推进（宽字素两格）
+            }
+            flush();
+        }
+    }
+    /** 布局（width 键缓存——块间空行并入行集，render 与 measure 同源） */
+    layout(width) {
+        if (this.cacheWidth === width)
+            return this.cacheRows;
+        const rows = [];
+        for (const block of this.parsed) {
+            if (rows.length > 0)
+                rows.push([]); // 块间空行
+            rows.push(...blockRows(block, Math.max(1, width)));
+        }
+        this.cacheWidth = width;
+        this.cacheRows = rows;
+        return rows;
+    }
+}