@icen.ai/ui 0.9.0 → 0.10.0

package/dist/behaviors/code-block.d.mts

@@ -0,0 +1,36 @@
+interface CodeBlockOptions {
+    /** 纯文本源码（安全路径，逐行 textContent） */
+    code?: string;
+    /** 已高亮 HTML（shiki 等可信输出，勿拼用户输入）；完整 <pre> 或裸行片段均可 */
+    html?: string;
+    /** 语言徽标；diff/patch 进 diff 模式，shell 族换终端图标 */
+    lang?: string;
+    /** 文件名徽标（展示优先于 lang 徽标） */
+    file?: string;
+    /** 说明标题 */
+    title?: string;
+    /** 高亮行（1 基） */
+    lines?: number[];
+    /** 初始显示行号（缺省：diff 模式开，其余关） */
+    num?: boolean;
+    /** 初始自动换行 */
+    wrap?: boolean;
+    /** true 强制折叠 / false 永不 / 数字 = 超过 N 行折叠（缺省 30） */
+    fold?: boolean | number;
+}
+/**
+ * 渲染多行代码块（DOM API + 可信 HTML 槽位），返回挂载元素 el（render* 约定）。
+ * 重复调用替换 el 内容；SSR 原样返回。交互由 initCodeBlock() 提供（页面级一次）。
+ */
+declare function renderCodeBlock(target: HTMLElement, opts: CodeBlockOptions): HTMLElement;
+/**
+ * code-block 的 SSR 字符串渲染器——与 renderCodeBlock 输出同构的 figure 标记，
+ * 供 Astro/JSX 构建期直出（无 DOM 依赖，纯字符串；交互仍由 initCodeBlock() 提供）。
+ * html 槽位不做 diff 行分类（高亮片段的 diff 请走 code 路径，或消费方自行注入行修饰类）。
+ */
+declare function codeBlockHTML(opts: CodeBlockOptions): string;
+/** Shared event delegation, real repeated disposer, no nested-scope double action.
+ * Every animation/async feedback belongs to the scope that started it. */
+declare function initCodeBlock(root?: ParentNode): () => void;
+
+export { type CodeBlockOptions, codeBlockHTML, initCodeBlock, renderCodeBlock };