@aithe/aithe-ui 26.2.2 → 26.2.3

package/dist/core/logger/types.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Log severity levels. 日志严重级别。
+ */
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    FATAL = 4
+}
+/**
+ * Human-readable label for each log level. 每个日志级别对应的可读标签。
+ */
+export declare const LOG_LEVEL_LABEL: Record<LogLevel, string>;
+/**
+ * A single recorded log entry. 单条日志记录实体。
+ */
+export interface LogEntry {
+    /** Unique identifier. 唯一标识。 */
+    readonly id: string;
+    /** Epoch timestamp in ms. 毫秒级时间戳。 */
+    readonly timestamp: number;
+    /** Severity level. 严重级别。 */
+    readonly level: LogLevel;
+    /** Human-readable level string. 可读级别字符串。 */
+    readonly levelLabel: string;
+    /** Formatted log message. 格式化后的日志消息。 */
+    readonly message: string;
+    /** Raw arguments passed to the log call. 原始日志参数。 */
+    readonly data: unknown[];
+    /** Current page URL at the time of logging. 记录时的当前页面 URL。 */
+    readonly url: string;
+    /** User-agent string. 浏览器 UA 字符串。 */
+    readonly ua: string;
+    /** Call stack (available for ERROR and above). 调用栈（ERROR 及以上级别可用）。 */
+    readonly stack?: string;
+    /** Optional context tags for filtering. 用于过滤的可选上下文标签。 */
+    readonly tags?: string[];
+}
+/**
+ * Callback invoked when a new log entry is recorded.
+ * 新日志记录时触发的回调。
+ *
+ * @param entry  - The newly added entry. 新增的日志条目。
+ * @param entries - All entries collected so far. 目前为止收集的所有条目。
+ */
+export type LogListener = (entry: LogEntry, entries: readonly LogEntry[]) => void;
+/**
+ * Callback invoked when entries are cleared.
+ * 条目被清空时触发的回调。
+ */
+export type LogClearListener = (allEntriesBeforeClear: readonly LogEntry[]) => void;
+/**
+ * Configuration for remote log reporting. 远程日志上报配置。
+ */
+export interface LogReporterConfig {
+    /** Endpoint URL accepting JSON payload. 接收 JSON 载荷的端点 URL。 */
+    url: string;
+    /** Only entries at or above this level are reported. 仅上报等于或高于此级别的日志。 */
+    levelThreshold: LogLevel;
+    /** Debounce delay in ms before sending a batch (default: 3000). 发送批次前的防抖延迟（默认 3000）。 */
+    debounceMs?: number;
+    /** Max entries per batch (default: 10). 每批次最大条目数（默认 10）。 */
+    batchSize?: number;
+    /** Additional HTTP headers. 额外的 HTTP 头。 */
+    headers?: Record<string, string>;
+    /**
+     * Pre-transform payload before sending. Return `false` to cancel.
+     * 发送前转换载荷。返回 `false` 放弃上报。
+     */
+    beforeSend?: (payload: unknown[]) => unknown[] | false;
+}
+/**
+ * Overall logger configuration. 日志器的全局配置。
+ */
+export interface LogConfig {
+    /** Whether logging is active. When disabled, `addEntry()` returns early — console output is unaffected. 是否激活日志记录。禁用后 `addEntry()` 直接返回，console 输出不受影响。 */
+    enabled: boolean;
+    /** Maximum number of entries kept in memory (default: 500). 内存中保留的最大条目数（默认 500）。 */
+    maxEntries: number;
+    /** Minimum level to record; entries below this are discarded (default: DEBUG). 最低记录级别，低于此级别的条目将被丢弃（默认 DEBUG）。 */
+    minLevel: LogLevel;
+    /** Optional remote reporter configuration. 可选的远程上报配置。 */
+    reporter?: LogReporterConfig;
+}
+/**
+ * Default log configuration. 默认日志配置。
+ */
+export declare const DEFAULT_LOG_CONFIG: LogConfig;
+/**
+ * Sentry-compatible serialization helper for LogEntry data.
+ * StructuredClone-like safe representation of log payload.
+ * 用于 LogEntry 数据的 Sentry 兼容序列化助手。
+ */
+export interface LogSerializedPayload {
+    id: string;
+    timestamp: number;
+    level: string;
+    message: string;
+    url: string;
+    ua: string;
+    stack?: string;
+    data: unknown;
+    tags?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/logger/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/logger/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;IACT,KAAK,IAAI;CACV;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAMpD,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,4CAA4C;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,wCAAwC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;IACzB,6DAA6D;IAC7D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,QAAQ,EAAE,KAAK,IAAI,CAAC;AAElF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,qBAAqB,EAAE,SAAS,QAAQ,EAAE,KAAK,IAAI,CAAC;AAEpF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,8DAA8D;IAC9D,GAAG,EAAE,MAAM,CAAC;IACZ,wEAAwE;IACxE,cAAc,EAAE,QAAQ,CAAC;IACzB,wFAAwF;IACxF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,GAAG,KAAK,CAAC;CACxD;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,0JAA0J;IAC1J,OAAO,EAAE,OAAO,CAAC;IACjB,oFAAoF;IACpF,UAAU,EAAE,MAAM,CAAC;IACnB,iHAAiH;IACjH,QAAQ,EAAE,QAAQ,CAAC;IACnB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAIhC,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB"}

package/dist/core/markdown/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Markdown 解析模块
+ *
+ * 提供基于插件架构的 Markdown → HTML 转换能力。
+ *
+ * 使用方式：
+ * ```ts
+ * import { SimpleMarkdownParser, FullMarkdownParser, plugins } from '../markdown';
+ *
+ * const simple = new SimpleMarkdownParser();
+ * simple.parse('**bold**'); // '<strong>bold</strong>'
+ *
+ * const full = new FullMarkdownParser();
+ * full.parse('# Hello\n\n> quote'); // '<h1>Hello</h1><blockquote>quote</blockquote>'
+ * ```
+ *
+ * @module
+ */
+export { type AstNode, type AstPlugin, type MarkdownLinkHook } from './types';
+export { MarkdownParser, SimpleMarkdownParser, FullMarkdownParser } from './parser';
+export * as plugins from './plugins';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/markdown/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/markdown/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACpF,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC"}

package/dist/core/markdown/parser.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Markdown AST 解析器
+ *
+ * 两阶段解析：
+ * 1. 块级解析：将行数组解析为块级 AST 节点（标题、代码块、表格、引用、列表等）
+ * 2. 行内解析：将文本内容解析为行内 AST 节点（加粗、斜体、链接、代码等）
+ *
+ * 相比旧版正则替换方案，AST 方案的优势：
+ * - 单次遍历即可构建完整语法树，无需 placeholder/escape/restore 循环
+ * - 支持嵌套结构（如引用块内的列表、列表内的段落）
+ * - 渲染器可独立优化（缓存、增量渲染）
+ */
+import type { AstNode, AstPlugin, DocumentNode, MarkdownLinkHook } from './types';
+/**
+ * Markdown AST 解析器基类
+ */
+export declare class MarkdownParser {
+    protected blockParsers: AstPlugin[];
+    protected inlineParsers: AstPlugin[];
+    private readonly _linkHooks;
+    use(plugin: AstPlugin): this;
+    addLinkHook(hook: MarkdownLinkHook): this;
+    removeLinkHook(hook: MarkdownLinkHook): this;
+    protected applyLinkHooks(url: string, text: string): string;
+    /**
+     * 将 Markdown 文本解析为 AST 文档树
+     */
+    parseToAst(markdown: string): DocumentNode;
+    /**
+     * 将 Markdown 文本直接解析为 HTML（便捷方法）
+     */
+    parse(markdown: string): string;
+    /**
+     * 块级解析：从 lines[start..end) 解析块级节点
+     */
+    protected parseBlocks(lines: string[], start: number, end: number): AstNode[];
+    private _matchBlockPlugin;
+    private _collectParagraph;
+    private _isBlockStart;
+    /**
+     * 行内解析：将文本解析为行内 AST 节点
+     */
+    parseInlines(text: string): AstNode[];
+    private _parseInlines;
+    private _matchInlinePlugin;
+    private _collectPlainText;
+    /** HTML 转义 */
+    private static esc;
+    /**
+     * 将 AST 节点树渲染为 HTML 字符串
+     */
+    static renderAst(node: AstNode, linkHook?: (url: string, text: string) => string): string;
+    private static renderCodeBlock;
+    private static renderListItem;
+    private static renderTable;
+    private static renderChildren;
+}
+export declare class SimpleMarkdownParser extends MarkdownParser {
+    constructor();
+}
+/**
+ * 完整解析器 —— 支持 GFM 全语法
+ */
+export declare class FullMarkdownParser extends MarkdownParser {
+    constructor();
+}
+//# sourceMappingURL=parser.d.ts.map

package/dist/core/markdown/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/core/markdown/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AA0BlF;;GAEG;AACH,qBAAa,cAAc;IACzB,SAAS,CAAC,YAAY,EAAE,SAAS,EAAE,CAAM;IACzC,SAAS,CAAC,aAAa,EAAE,SAAS,EAAE,CAAM;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0B;IAErD,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAM5B,WAAW,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAKzC,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAM5C,SAAS,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAQ3D;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;IAM1C;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAM/B;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,EAAE;IAkB7E,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,iBAAiB;IAwBzB,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE;IAMrC,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,iBAAiB;IAWzB,cAAc;IACd,OAAO,CAAC,MAAM,CAAC,GAAG;IAQlB;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM;IAyFzF,OAAO,CAAC,MAAM,CAAC,eAAe;IAgB9B,OAAO,CAAC,MAAM,CAAC,cAAc;IAS7B,OAAO,CAAC,MAAM,CAAC,WAAW;IAc1B,OAAO,CAAC,MAAM,CAAC,cAAc;CAI9B;AACD,qBAAa,oBAAqB,SAAQ,cAAc;;CAUvD;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;;CAwBrD"}

package/dist/core/markdown/plugins.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Markdown AST 插件集
+ *
+ * 每个插件对应一种 Markdown 语法规则，提供块级解析器（BlockParser）和/或行内解析器（InlineParser）。
+ * 所有正则均添加了长度限制（如 `{1,200}`）以防止 ReDoS 攻击。
+ *
+ * 分类：
+ * - Leaf blocks（叶子块）：heading, setextHeading, thematicBreak, codeFence, table
+ * - Container blocks（容器块）：blockquote, list, taskList
+ * - Inlines（行内）：bold, italic, code, del, link, image
+ * - Extensions（扩展）：emoji, icon
+ */
+import type { AstPlugin } from './types';
+/**
+ * ATX 标题
+ *
+ * 匹配 `# ` `## ` `### ` … `###### ` 六级标题。
+ * 标题层级由 `#` 的数量决定。
+ */
+export declare const headingPlugin: AstPlugin;
+/**
+ * Setext 标题
+ *
+ * 匹配下方带 `===`（一级）或 `---`（二级）的标题行。
+ */
+export declare const setextHeadingPlugin: AstPlugin;
+/**
+ * 分隔线
+ *
+ * 匹配三个或以上的 `-` `*` `_`（可含空格）。
+ */
+export declare const thematicBreakPlugin: AstPlugin;
+/**
+ * 围栏代码块
+ *
+ * 匹配由 ``` 或 ~~~ 包裹的代码块，支持语言标识。
+ */
+export declare const codeFencePlugin: AstPlugin;
+/**
+ * 表格（GFM 扩展）
+ *
+ * 匹配 GFM 风格的管道表格。
+ */
+export declare const tablePlugin: AstPlugin;
+/**
+ * 引用块
+ *
+ * 匹配 `> ` 开头的行。
+ */
+export declare const blockquotePlugin: AstPlugin;
+/**
+ * 无序 / 有序列表
+ *
+ * 匹配 `- ` `* ` `+ ` 开头的无序列表，以及 `1. ` 等有序列表。
+ */
+export declare const listPlugin: AstPlugin;
+/**
+ * 任务列表（GFM 扩展）
+ *
+ * 匹配 `- [ ]`（未完成）和 `- [x]`（已完成）格式。
+ */
+export declare const taskListPlugin: AstPlugin;
+/**
+ * 加粗
+ *
+ * 匹配 `**text**` 语法，支持内部嵌套行内元素（如链接）。
+ */
+export declare const boldPlugin: AstPlugin;
+/**
+ * 斜体
+ *
+ * 匹配 `*text*` 或 `_text_` 语法。
+ */
+export declare const italicPlugin: AstPlugin;
+/**
+ * 行内代码
+ *
+ * 匹配 `` `code` `` 语法。
+ */
+export declare const codePlugin: AstPlugin;
+/**
+ * 删除线（GFM 扩展）
+ *
+ * 匹配 `~~text~~` 语法。
+ */
+export declare const delPlugin: AstPlugin;
+/**
+ * 链接
+ *
+ * 匹配 `[text](url)` 语法。
+ */
+export declare function createLinkPlugin(): AstPlugin;
+/** 向后兼容的 linkPlugin 实例 */
+export declare const linkPlugin: AstPlugin;
+/**
+ * 图片
+ *
+ * 匹配 `![alt](url)` 语法。
+ */
+export declare const imagePlugin: AstPlugin;
+/**
+ * 图标（Aithe UI 扩展）
+ *
+ * 匹配 `:iconName:` 语法（驼峰或字母开头）。
+ */
+export declare const iconPlugin: AstPlugin;
+/**
+ * Emoji 短代码（Aithe UI 扩展）
+ *
+ * 匹配 `:emoji_name:` 语法（小写字母 + 下划线），将短代码映射为 Unicode Emoji。
+ */
+export declare const emojiPlugin: AstPlugin;
+//# sourceMappingURL=plugins.d.ts.map

package/dist/core/markdown/plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../../src/core/markdown/plugins.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAW,SAAS,EAAE,MAAM,SAAS,CAAC;AA8DlD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,SAc3B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAejC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAQjC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,SAkC7B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,SAqDzB,CAAC;AAYF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,SA8B9B,CAAC;AAiBF;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,SA4CxB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,SAiC5B,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,SA+BxB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,SAU1B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,SAUxB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,SAUvB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,SAAS,CAqB5C;AAED,0BAA0B;AAC1B,eAAO,MAAM,UAAU,EAAE,SAA8B,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,SAUzB,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,SAUxB,CAAC;AAwEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,SAYzB,CAAC"}

package/dist/core/markdown/types.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Markdown AST 节点类型定义
+ *
+ * 基于 AST（抽象语法树）的 Markdown 解析类型系统。
+ * 所有 Markdown 语法元素统一表示为树形节点，渲染器遍历 AST 输出 HTML。
+ */
+/** AST 节点基类 */
+export interface AstNode {
+    type: string;
+    children?: AstNode[];
+    [key: string]: unknown;
+}
+/** 文档根节点 */
+export interface DocumentNode extends AstNode {
+    type: 'document';
+    children: AstNode[];
+}
+/** 文本节点 */
+export interface TextNode extends AstNode {
+    type: 'text';
+    value: string;
+}
+/** 段落 */
+export interface ParagraphNode extends AstNode {
+    type: 'paragraph';
+    children: AstNode[];
+}
+/** 标题 */
+export interface HeadingNode extends AstNode {
+    type: 'heading';
+    level: number;
+    children: AstNode[];
+}
+/** 分隔线 */
+export interface ThematicBreakNode extends AstNode {
+    type: 'thematic-break';
+}
+/** 代码块 */
+export interface CodeBlockNode extends AstNode {
+    type: 'code-block';
+    lang: string;
+    value: string;
+}
+/** 行内代码 */
+export interface InlineCodeNode extends AstNode {
+    type: 'inline-code';
+    value: string;
+}
+/** 引用块 */
+export interface BlockquoteNode extends AstNode {
+    type: 'blockquote';
+    children: AstNode[];
+}
+/** 列表项 */
+export interface ListItemNode extends AstNode {
+    type: 'list-item';
+    checked: boolean | null;
+    children: AstNode[];
+}
+/** 列表 */
+export interface ListNode extends AstNode {
+    type: 'list';
+    ordered: boolean;
+    start: number;
+    children: ListItemNode[];
+}
+/** 表格 */
+export interface TableNode extends AstNode {
+    type: 'table';
+    header: TableRowNode;
+    align: string[];
+    body: TableRowNode[];
+}
+/** 表格行 */
+export interface TableRowNode extends AstNode {
+    type: 'table-row';
+    children: AstNode[];
+}
+/** 表格单元格 */
+export interface TableCellNode extends AstNode {
+    type: 'table-cell';
+    children: AstNode[];
+}
+/** 加粗 */
+export interface BoldNode extends AstNode {
+    type: 'bold';
+    children: AstNode[];
+}
+/** 斜体 */
+export interface ItalicNode extends AstNode {
+    type: 'italic';
+    children: AstNode[];
+}
+/** 删除线 */
+export interface StrikethroughNode extends AstNode {
+    type: 'strikethrough';
+    children: AstNode[];
+}
+/** 链接 */
+export interface LinkNode extends AstNode {
+    type: 'link';
+    url: string;
+    text: string;
+    children: AstNode[];
+}
+/** 图片 */
+export interface ImageNode extends AstNode {
+    type: 'image';
+    url: string;
+    alt: string;
+}
+/** Emoji */
+export interface EmojiNode extends AstNode {
+    type: 'emoji';
+    name: string;
+    unicode: string;
+}
+/** 图标 */
+export interface IconNode extends AstNode {
+    type: 'icon';
+    name: string;
+}
+/** 换行 */
+export interface LineBreakNode extends AstNode {
+    type: 'line-break';
+}
+/** 原始 HTML（安全白名单） */
+export interface RawHtmlNode extends AstNode {
+    type: 'raw-html';
+    value: string;
+}
+/** 链接处理 hook */
+export type MarkdownLinkHook = (url: string, text: string) => string | undefined | null;
+/** 块级解析器：接收行数组，返回块级节点列表 */
+export type BlockParser = (lines: string[]) => {
+    nodes: AstNode[];
+    consumed: number;
+} | null;
+/** 行内解析器：接收文本，返回行内节点列表 */
+export type InlineParser = (text: string) => {
+    nodes: AstNode[];
+    consumed: number;
+} | null;
+/** AST 插件 */
+export interface AstPlugin {
+    name: string;
+    block?: BlockParser;
+    inline?: InlineParser;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/markdown/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/markdown/types.ts"],"names":[],"mappings":"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"}

package/dist/core/router/index.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Aithe UI 路由核心模块
+ * Core routing module for Aithe UI.
+ *
+ * 提供轻量、无第三方依赖的前端路由，适配 Lit 组件模型与响应式更新机制。
+ * Provides a lightweight, zero-dependency frontend router compatible with Lit's reactive model.
+ *
+ * 支持 hash 模式和 history 模式，静态路由、动态路由、通配符、查询参数解析、路由守卫。
+ * Supports hash and history modes, static routes, dynamic routes, wildcards, query parsing, and route guards.
+ *
+ * @module router
+ */
+/** 路由模式 / Routing mode */
+export type RouterMode = 'hash' | 'history';
+/** 路由守卫函数，返回 false 阻止导航 / Route guard function; return false to block navigation */
+export type RouteGuard = (to: RouteLocation, from: RouteLocation | null) => boolean | Promise<boolean>;
+/** 路由变更监听器 / Route change listener */
+export type RouteChangeListener = (location: RouteLocation) => void;
+/** 解析后的路由位置信息 / Resolved route location */
+export interface RouteLocation {
+    /** 完整路径（不含查询参数和 hash）/ Full path without query string and hash */
+    path: string;
+    /** 路径参数 / Path parameters (e.g. { id: '42' } for /user/:id) */
+    params: Record<string, string>;
+    /** 查询参数 / Query parameters (e.g. { a: '1', b: '2' } for ?a=1&b=2) */
+    query: Record<string, string>;
+    /** 匹配到的路由配置 / Matched route config */
+    route: RouteConfig | null;
+    /** 完整 URL（含查询参数）/ Full URL including query string */
+    fullPath: string;
+}
+/** 路由配置 / Route configuration */
+export interface RouteConfig {
+    /** 路径模式，支持静态 /home、动态 /user/:id、通配符 * / Path pattern: static /home, dynamic /user/:id, wildcard * */
+    path: string;
+    /** 匹配时渲染的组件标签名 / Component tag name to render when matched */
+    component: string;
+    /** 路由元数据，可存放 title、auth 等自定义字段 / Route metadata for custom fields like title, auth */
+    meta?: Record<string, unknown>;
+    /** 子路由（嵌套路由）/ Child routes for nested routing */
+    children?: RouteConfig[];
+}
+/**
+ * 路由核心类，管理路由注册、匹配、导航和监听。
+ * Core Router class that manages route registration, matching, navigation, and listeners.
+ *
+ * @example
+ * ```ts
+ * const router = new Router({
+ *   mode: 'history',
+ *   routes: [
+ *     { path: '/', component: 'home-page' },
+ *     { path: '/user/:id', component: 'user-page' },
+ *     { path: '*', component: 'not-found-page' },
+ *   ],
+ * });
+ * router.start();
+ * ```
+ */
+export declare class Router {
+    private readonly mode;
+    private readonly routes;
+    private compiled;
+    private readonly listeners;
+    private readonly guards;
+    private _currentLocation;
+    private _started;
+    constructor(options: {
+        mode?: RouterMode;
+        routes: RouteConfig[];
+    });
+    /** 当前路由位置 / Current route location */
+    get currentLocation(): RouteLocation | null;
+    /** 路由是否已启动 / Whether the router has been started */
+    get started(): boolean;
+    /** 添加路由配置 / Add route configurations */
+    addRoutes(routes: RouteConfig[]): void;
+    /** 注册路由守卫 / Register a route guard */
+    addGuard(guard: RouteGuard): () => void;
+    /** 订阅路由变更 / Subscribe to route changes */
+    onChange(listener: RouteChangeListener): () => void;
+    /**
+     * 启动路由监听 / Start listening for route changes.
+     * 在 hash 模式下监听 hashchange，在 history 模式下监听 popstate。
+     */
+    start(): void;
+    /** 停止路由监听 / Stop listening for route changes */
+    stop(): void;
+    /**
+     * 编程式导航 / Programmatic navigation.
+     * 在 history 模式下使用 pushState，在 hash 模式下修改 location.hash。
+     */
+    navigate(path: string): Promise<void>;
+    /** 替换当前历史记录并导航 / Replace current history entry and navigate */
+    replace(path: string): Promise<void>;
+    /** 后退 / Go back in history */
+    back(): void;
+    /** 前进 / Go forward in history */
+    forward(): void;
+    /**
+     * 匹配路径，返回 RouteLocation（不触发导航）
+     * Match a path and return RouteLocation without triggering navigation.
+     */
+    match(path: string): RouteLocation;
+    /** 获取当前浏览器路径 / Get current browser path */
+    getCurrentBrowserPath(): string;
+    private compileRoutes;
+    private readonly handleRouteChange;
+    private resolve;
+    private runGuards;
+    private splitPathQuery;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/core/router/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/router/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,0BAA0B;AAC1B,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;AAE5C,oFAAoF;AACpF,MAAM,MAAM,UAAU,GAAG,CACvB,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,aAAa,GAAG,IAAI,KACvB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEhC,sCAAsC;AACtC,MAAM,MAAM,mBAAmB,GAAG,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;AAEpE,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,sCAAsC;IACtC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,iCAAiC;AACjC,MAAM,WAAW,WAAW;IAC1B,qGAAqG;IACrG,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,iDAAiD;IACjD,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CAC1B;AA2CD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,gBAAgB,CAA8B;IACtD,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE;QAAE,IAAI,CAAC,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,WAAW,EAAE,CAAA;KAAE;IAMjE,sCAAsC;IACtC,IAAI,eAAe,IAAI,aAAa,GAAG,IAAI,CAE1C;IAED,oDAAoD;IACpD,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,wCAAwC;IACxC,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI;IAKtC,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,IAAI;IAQvC,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,IAAI;IAQnD;;;OAGG;IACH,KAAK,IAAI,IAAI;IAab,gDAAgD;IAChD,IAAI,IAAI,IAAI;IAWZ;;;OAGG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB3C,+DAA+D;IACzD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe1C,8BAA8B;IAC9B,IAAI,IAAI,IAAI;IAIZ,iCAAiC;IACjC,OAAO,IAAI,IAAI;IAIf;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;IA6BlC,2CAA2C;IAC3C,qBAAqB,IAAI,MAAM;IAQ/B,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAEhC;IAEF,OAAO,CAAC,OAAO;YASD,SAAS;IAQvB,OAAO,CAAC,cAAc;CAKvB"}

package/dist/core/styles.d.ts

@@ -1,8 +1,17 @@
-import { aitheGlobalCssText } from '../styles/global.css';
+/** Base styles shared by every Aithe component (reset + primitive tokens). 所有 Aithe 组件共享的基础样式（重置 + 基础令牌）。 */
 export declare const aitheBaseStyles: import("lit").CSSResult[];
+/**
+ * Generate panel surface styles for a given CSS selector.
+ * 为给定 CSS 选择器生成面板表面样式。
+ *
+ * @param selector - CSS selector to target. Defaults to `.panel`. 目标 CSS 选择器，默认为 `.panel`。
+ * @returns A Lit `CSSResult` with surface background and border styles. 包含表面背景和边框样式的 Lit `CSSResult`。
+ */
 export declare const aithePanelStyles: (selector?: string) => import("lit").CSSResult;
+/** Reusable control (input-like) base styles. 可复用的控件（输入类）基础样式。 */
 export declare const aitheControlStyleBlock: import("lit").CSSResult;
+/** Focus ring styles for controls. 控件的聚焦环样式。 */
 export declare const aitheControlFocusStyleBlock: import("lit").CSSResult;
+/** Cross-browser thin scrollbar styles. 跨浏览器细滚动条样式。 */
 export declare const aitheScrollbarStyles: import("lit").CSSResult;
-export { aitheGlobalCssText };
 //# sourceMappingURL=styles.d.ts.map

package/dist/core/styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../src/core/styles.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0B,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGlF,eAAO,MAAM,eAAe,2BAAiD,CAAC;AAE9E,eAAO,MAAM,gBAAgB,GAAI,iBAAmB,4BAInD,CAAC;AAEF,eAAO,MAAM,sBAAsB,yBAElC,CAAC;AAEF,eAAO,MAAM,2BAA2B,yBAEvC,CAAC;AAEF,eAAO,MAAM,oBAAoB,yBAiBhC,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../src/core/styles.ts"],"names":[],"mappings":"AAUA,6GAA6G;AAC7G,eAAO,MAAM,eAAe,2BAAiD,CAAC;AAE9E;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,iBAAmB,4BAInD,CAAC;AAEF,kEAAkE;AAClE,eAAO,MAAM,sBAAsB,yBAElC,CAAC;AAEF,gDAAgD;AAChD,eAAO,MAAM,2BAA2B,yBAEvC,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,oBAAoB,yBAiBhC,CAAC"}