npm - @jianwen-lang/parser - Versions diffs - 0.1.1 - Mend

@jianwen-lang/parser 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (89) hide show

package/LICENSE +21 -0
package/README.md +95 -0
package/dist/cli/render.d.ts +1 -0
package/dist/cli/render.js +300 -0
package/dist/core/ast.d.ts +286 -0
package/dist/core/ast.js +2 -0
package/dist/core/block/rules/heading.d.ts +9 -0
package/dist/core/block/rules/heading.js +75 -0
package/dist/core/block/rules/horizontal-rule.d.ts +9 -0
package/dist/core/block/rules/horizontal-rule.js +87 -0
package/dist/core/block/rules/include.d.ts +9 -0
package/dist/core/block/rules/include.js +64 -0
package/dist/core/block/rules/index.d.ts +2 -0
package/dist/core/block/rules/index.js +16 -0
package/dist/core/block/rules/types.d.ts +21 -0
package/dist/core/block/rules/types.js +2 -0
package/dist/core/block/types.d.ts +10 -0
package/dist/core/block/types.js +2 -0
package/dist/core/block-parser.d.ts +3 -0
package/dist/core/block-parser.js +1385 -0
package/dist/core/clone.d.ts +9 -0
package/dist/core/clone.js +32 -0
package/dist/core/diagnostics.d.ts +12 -0
package/dist/core/diagnostics.js +24 -0
package/dist/core/errors.d.ts +12 -0
package/dist/core/errors.js +2 -0
package/dist/core/inline/rules/backtick.d.ts +4 -0
package/dist/core/inline/rules/backtick.js +90 -0
package/dist/core/inline/rules/bracket.d.ts +4 -0
package/dist/core/inline/rules/bracket.js +721 -0
package/dist/core/inline/rules/disabled.d.ts +2 -0
package/dist/core/inline/rules/disabled.js +34 -0
package/dist/core/inline/rules/escape.d.ts +2 -0
package/dist/core/inline/rules/escape.js +11 -0
package/dist/core/inline/rules/index.d.ts +2 -0
package/dist/core/inline/rules/index.js +25 -0
package/dist/core/inline/rules/marker-highlight.d.ts +4 -0
package/dist/core/inline/rules/marker-highlight.js +56 -0
package/dist/core/inline/rules/style.d.ts +4 -0
package/dist/core/inline/rules/style.js +120 -0
package/dist/core/inline/rules/types.d.ts +22 -0
package/dist/core/inline/rules/types.js +2 -0
package/dist/core/inline/types.d.ts +1 -0
package/dist/core/inline/types.js +2 -0
package/dist/core/inline-parser.d.ts +3 -0
package/dist/core/inline-parser.js +52 -0
package/dist/core/location.d.ts +9 -0
package/dist/core/location.js +30 -0
package/dist/core/parser.d.ts +9 -0
package/dist/core/parser.js +423 -0
package/dist/core/traverse.d.ts +7 -0
package/dist/core/traverse.js +71 -0
package/dist/html/convert.d.ts +29 -0
package/dist/html/convert.js +61 -0
package/dist/html/format.d.ts +1 -0
package/dist/html/format.js +17 -0
package/dist/html/render/blocks.d.ts +4 -0
package/dist/html/render/blocks.js +433 -0
package/dist/html/render/html.d.ts +8 -0
package/dist/html/render/html.js +89 -0
package/dist/html/render/inlines.d.ts +4 -0
package/dist/html/render/inlines.js +110 -0
package/dist/html/render/meta.d.ts +3 -0
package/dist/html/render/meta.js +51 -0
package/dist/html/render/utils.d.ts +31 -0
package/dist/html/render/utils.js +213 -0
package/dist/html/theme/base/css.d.ts +2 -0
package/dist/html/theme/base/css.js +383 -0
package/dist/html/theme/dark/css.d.ts +2 -0
package/dist/html/theme/dark/css.js +108 -0
package/dist/html/theme/default/colors.d.ts +13 -0
package/dist/html/theme/default/colors.js +2 -0
package/dist/html/theme/default/css.d.ts +2 -0
package/dist/html/theme/default/css.js +6 -0
package/dist/html/theme/default/runtime.d.ts +0 -0
package/dist/html/theme/default/runtime.js +31 -0
package/dist/html/theme/light/css.d.ts +2 -0
package/dist/html/theme/light/css.js +55 -0
package/dist/html/theme/preset/colors.d.ts +10 -0
package/dist/html/theme/preset/colors.js +14 -0
package/dist/html/theme/runtime.d.ts +0 -0
package/dist/html/theme/runtime.js +31 -0
package/dist/html/theme/theme.d.ts +9 -0
package/dist/html/theme/theme.js +21 -0
package/dist/lexer/lexer.d.ts +17 -0
package/dist/lexer/lexer.js +47 -0
package/dist/parser.d.ts +6 -0
package/dist/parser.js +22 -0
package/package.json +50 -0

package/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2025 Jianwen-lang
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md ADDED Viewed

@@ -0,0 +1,95 @@
+# @jianwen-lang/parser `0.1.0`
+Jianwen（简文）是一种类似 Markdown 的轻量级标记语言，针对网页博客、公众号等内容发布场景的排版能力进行优化。本包提供 Jianwen 的 **TypeScript 核心解析器**（输出结构化 AST）以及 **HTML 渲染器**，用于在编辑器、渲染服务、静态站点生成等场景复用同一套解析语义。
+- **环境无关**：核心解析不依赖 DOM，可在 Node.js 与浏览器（经打包）运行
+- **错误容忍**：解析会尽可能继续，并返回诊断信息
+- **可扩展**：通过 AST 节点与规则扩展语法
+## 安装
+```bash
+npm i @jianwen-lang/parser
+```
+## 快速开始：解析为 AST
+```ts
+import { parseJianwenWithErrors } from '@jianwen-lang/parser';
+const source = `
+# 标题
+这里是 *简文* 内容
+`.trim();
+const { ast, errors } = parseJianwenWithErrors(source);
+if (errors.length > 0) {
+  console.warn(errors);
+}
+console.log(ast.type); // "document"
+```
+常用类型：
+- `JianwenDocument`：文档 AST 根节点
+- `ParseError`：诊断信息结构
+## 渲染：AST -> HTML
+```ts
+import { parseJianwenWithErrors, renderDocumentToHtml } from '@jianwen-lang/parser';
+const { ast, errors } = parseJianwenWithErrors(source);
+const html = renderDocumentToHtml(ast, { includeMeta: true, format: true });
+```
+如果你希望直接得到完整 HTML 文档（含 `<html>`/`<head>`/`<body>` 与默认 CSS）：
+```ts
+import { renderJianwenToHtmlDocument } from '@jianwen-lang/parser';
+const { html, ast, errors } = renderJianwenToHtmlDocument(source, {
+  document: { format: true },
+});
+```
+## Include：文件/标签展开（可选）
+解析阶段支持将 `[@](path)`（文件 include）或 `[@=tag]`（标签 include）按需展开。开启方式：
+```ts
+import { parseJianwenWithErrors } from '@jianwen-lang/parser';
+import * as fs from 'node:fs';
+const { ast, errors } = parseJianwenWithErrors(source, {
+  expandInclude: true,
+  includeMaxDepth: 8,
+  loadFile: (path) => fs.readFileSync(path, 'utf8'),
+});
+```
+说明：
+- 若启用 `expandInclude` 但未提供 `loadFile`，文件 include 会保留为 AST 节点并产生 warning。
+- include 解析内置缓存，并带有最大深度与循环检测。
+## API 概览
+- 解析
+  - `parseJianwen(source, options?) => JianwenDocument`
+  - `parseJianwenWithErrors(source, options?) => { ast: JianwenDocument; errors: ParseError[] }`
+  - `ParseOptions`：`expandInclude` / `includeMaxDepth` / `loadFile`
+- 渲染
+  - `renderDocumentToHtml(doc, options?) => string`
+  - `renderJianwenToHtmlDocument(source, options?) => { html; ast; errors }`
+  - `buildHtmlDocument(bodyHtml, options?) => string`
+## 规范与扩展
+语法与 AST 设计约定请参考项目仓库内的规范文档（例如 `docs/standards.md` 与语言语法文档）。
+## License
+MIT（见 `LICENSE`）。

package/dist/cli/render.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export declare function runRenderCli(argv: string[]): void;

package/dist/cli/render.js ADDED Viewed

@@ -0,0 +1,300 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runRenderCli = runRenderCli;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const convert_1 = require("../html/convert");
+const TAB_WIDTH = 4;
+function isCombiningCodePoint(code) {
+    return ((code >= 0x0300 && code <= 0x036f) ||
+        (code >= 0x1ab0 && code <= 0x1aff) ||
+        (code >= 0x1dc0 && code <= 0x1dff) ||
+        (code >= 0x20d0 && code <= 0x20ff) ||
+        (code >= 0xfe20 && code <= 0xfe2f));
+}
+function isFullWidthCodePoint(code) {
+    return (code >= 0x1100 &&
+        (code <= 0x115f ||
+            code === 0x2329 ||
+            code === 0x232a ||
+            (code >= 0x2e80 && code <= 0xa4cf && code !== 0x303f) ||
+            (code >= 0xac00 && code <= 0xd7a3) ||
+            (code >= 0xf900 && code <= 0xfaff) ||
+            (code >= 0xfe10 && code <= 0xfe19) ||
+            (code >= 0xfe30 && code <= 0xfe6f) ||
+            (code >= 0xff00 && code <= 0xff60) ||
+            (code >= 0xffe0 && code <= 0xffe6) ||
+            (code >= 0x20000 && code <= 0x3fffd)));
+}
+function getDisplayWidth(value) {
+    let width = 0;
+    for (const ch of value) {
+        if (ch === '\t') {
+            const nextStop = TAB_WIDTH - (width % TAB_WIDTH);
+            width += nextStop;
+            continue;
+        }
+        const code = ch.codePointAt(0);
+        if (code === undefined) {
+            continue;
+        }
+        if (isCombiningCodePoint(code)) {
+            continue;
+        }
+        width += isFullWidthCodePoint(code) ? 2 : 1;
+    }
+    return width;
+}
+function parseCliArgs(argv) {
+    const args = [...argv];
+    const inputFilePath = args.shift();
+    if (!inputFilePath) {
+        throw new Error('Missing input file path');
+    }
+    let outputFilePath = 'out.html';
+    let theme;
+    let format = false;
+    let includeCss = true;
+    let cssHref;
+    let includeRuntime = false;
+    let runtimeSrc;
+    let includeComments = false;
+    let includeMeta = true;
+    while (args.length > 0) {
+        const arg = args.shift();
+        if (!arg)
+            break;
+        if (arg === '-o' || arg === '--out') {
+            const value = args.shift();
+            if (!value)
+                throw new Error('Missing value for --out');
+            outputFilePath = value;
+            continue;
+        }
+        if (arg === '--theme') {
+            const value = args.shift();
+            if (value !== 'light' && value !== 'dark' && value !== 'auto') {
+                throw new Error('Invalid --theme value (expected light|dark|auto)');
+            }
+            theme = value;
+            continue;
+        }
+        if (arg === '--format') {
+            format = true;
+            continue;
+        }
+        if (arg === '--no-css') {
+            includeCss = false;
+            continue;
+        }
+        if (arg === '--css-href') {
+            const value = args.shift();
+            if (!value)
+                throw new Error('Missing value for --css-href');
+            cssHref = value;
+            includeCss = true;
+            continue;
+        }
+        if (arg === '--runtime') {
+            includeRuntime = true;
+            continue;
+        }
+        if (arg === '--runtime-src') {
+            const value = args.shift();
+            if (!value)
+                throw new Error('Missing value for --runtime-src');
+            runtimeSrc = value;
+            includeRuntime = true;
+            continue;
+        }
+        if (arg === '--comments') {
+            includeComments = true;
+            continue;
+        }
+        if (arg === '--no-meta') {
+            includeMeta = false;
+            continue;
+        }
+        if (arg === '-h' || arg === '--help') {
+            console.log(`Usage: jw-render <input.jw> [options]
+Options:
+  -o, --out <file>         Output HTML path (default: out.html)
+  --theme <light|dark|auto> Set document theme via data-jw-theme
+  --format                 Beautify output HTML
+  --no-css                 Do not inline CSS
+  --css-href <href>        Link CSS instead of inlining
+  --runtime                Append runtime <script> tag (default src: ${convert_1.DEFAULT_RUNTIME_SRC})
+  --runtime-src <src>      Override runtime <script src=...>
+  --comments               Include comment nodes
+  --no-meta                Do not render meta header
+`);
+            process.exit(0);
+        }
+        throw new Error(`Unknown argument: ${arg}`);
+    }
+    return {
+        inputFilePath,
+        outputFilePath,
+        theme,
+        format,
+        includeCss,
+        cssHref,
+        includeRuntime,
+        runtimeSrc,
+        includeComments,
+        includeMeta,
+    };
+}
+function runRenderCli(argv) {
+    const options = parseCliArgs(argv);
+    const absoluteInput = path.resolve(process.cwd(), options.inputFilePath);
+    const absoluteOutput = path.resolve(process.cwd(), options.outputFilePath);
+    if (!fs.existsSync(absoluteInput)) {
+        throw new Error(`Input file not found: ${absoluteInput}`);
+    }
+    const baseDir = path.dirname(absoluteInput);
+    const source = fs.readFileSync(absoluteInput, 'utf-8');
+    const sourceLines = source.split(/\r?\n/);
+    const includeLineCache = new Map();
+    const getIncludeLines = (target) => {
+        if (includeLineCache.has(target)) {
+            return includeLineCache.get(target);
+        }
+        try {
+            const includePath = path.resolve(baseDir, target);
+            if (!fs.existsSync(includePath)) {
+                includeLineCache.set(target, []);
+                return undefined;
+            }
+            const includeSource = fs.readFileSync(includePath, 'utf-8');
+            const lines = includeSource.split(/\r?\n/);
+            includeLineCache.set(target, lines);
+            return lines;
+        }
+        catch {
+            includeLineCache.set(target, []);
+            return undefined;
+        }
+    };
+    const loadFile = (target) => {
+        try {
+            const includePath = path.resolve(baseDir, target);
+            if (!fs.existsSync(includePath)) {
+                return undefined;
+            }
+            return fs.readFileSync(includePath, 'utf-8');
+        }
+        catch {
+            return undefined;
+        }
+    };
+    const resolveInclude = (mode, target) => {
+        if (mode !== 'file' || !target.endsWith('.html')) {
+            return undefined;
+        }
+        try {
+            const includePath = path.resolve(baseDir, target);
+            if (!fs.existsSync(includePath)) {
+                return undefined;
+            }
+            return fs.readFileSync(includePath, 'utf-8');
+        }
+        catch {
+            return undefined;
+        }
+    };
+    const renderOptions = {
+        includeMeta: options.includeMeta,
+        includeComments: options.includeComments,
+        format: options.format,
+        documentTheme: options.theme,
+        sourceFilePath: absoluteInput,
+        outputFilePath: absoluteOutput,
+        resolveInclude,
+    };
+    const documentOptions = {
+        includeCss: options.includeCss,
+        cssHref: options.cssHref,
+        includeRuntime: options.includeRuntime,
+        runtimeSrc: options.runtimeSrc,
+        format: options.format,
+    };
+    const result = (0, convert_1.renderJianwenToHtmlDocument)(source, {
+        parse: {
+            expandInclude: true,
+            includeMaxDepth: 10,
+            loadFile,
+        },
+        render: renderOptions,
+        document: documentOptions,
+    });
+    if (result.errors.length > 0) {
+        console.error(`Parser reported ${result.errors.length} warning(s)/error(s).`);
+        for (const error of result.errors) {
+            const includeMatch = /^\[include:([^\]]+)\]\s*/.exec(error.message);
+            const includeTarget = includeMatch?.[1];
+            const lines = includeTarget ? (getIncludeLines(includeTarget) ?? []) : sourceLines;
+            const lineText = lines[error.line - 1];
+            const rawColumn = Math.max(1, error.column ?? 1);
+            const safeColumn = lineText ? Math.min(rawColumn, lineText.length + 1) : rawColumn;
+            const location = `${error.line}:${rawColumn}`;
+            console.error(`${error.severity.toUpperCase()} ${location} ${error.message}`);
+            if (includeTarget) {
+                console.error(`  (from include: ${includeTarget})`);
+            }
+            if (lineText !== undefined) {
+                const prefixText = lineText.slice(0, safeColumn - 1);
+                const caretPos = getDisplayWidth(prefixText);
+                console.error(`  ${lineText}`);
+                console.error(`  ${' '.repeat(caretPos)}^`);
+            }
+            else {
+                console.error('  (source line unavailable)');
+            }
+        }
+        const hasError = result.errors.some((error) => error.severity === 'error');
+        if (hasError) {
+            console.error('Render aborted due to parser errors.');
+            process.exit(1);
+        }
+    }
+    fs.writeFileSync(absoluteOutput, result.html, { encoding: 'utf8' });
+    console.log(`Rendered ${options.inputFilePath} -> ${options.outputFilePath}`);
+}
+if (require.main === module) {
+    runRenderCli(process.argv.slice(2));
+}

package/dist/core/ast.d.ts ADDED Viewed

@@ -0,0 +1,286 @@
+export interface JianwenDocument {
+    type: 'document';
+    /** Original input text, optional, for debugging */
+    source?: string;
+    /** Document metadata parsed from initialization template (optional) */
+    meta?: JianwenMeta;
+    /** Top-level block list in document order */
+    children: BlockNode[];
+}
+export interface JianwenMeta {
+    /** [title]= */
+    title?: string;
+    /** [author]= */
+    author?: string;
+    /** [author_url]= */
+    authorUrl?: string;
+    /** [time]= */
+    time?: string;
+    /** [add_info]= */
+    addInfo?: string;
+    /** [tag(s)]=, parsed as comma-separated tag array */
+    tags?: string[];
+    /** [global_font]= font style applied to the entire document */
+    globalFont?: ('italic' | 'bold' | 'heavy' | 'slim' | 'serif' | 'mono')[];
+}
+export type ListKind = 'bullet' | 'ordered' | 'task' | 'foldable';
+export type TaskStatus = 'unknown' | 'todo' | 'in_progress' | 'not_done' | 'done';
+export interface ColorAttribute {
+    kind: 'preset' | 'hex';
+    /** Preset name like 'red' or Hex '#A14A00' */
+    value: string;
+}
+export interface InlineAttributes {
+    color?: ColorAttribute;
+    /** [!color] - used for highlight fill color or link underline color */
+    secondaryColor?: ColorAttribute;
+    /** [square] / [rounded] / [rounded=num] */
+    shape?: 'square' | 'rounded';
+    /** [rounded=num] rounded corner radius, default 1.0 */
+    roundedRadius?: number;
+    /** Font size 1~5, [1]=1em, [2]=1.375em, [3]=1.75em, [4]=2.125em, [5]=2.5em (H1 level) */
+    fontSize?: number;
+    fontStyle?: ('italic' | 'bold' | 'heavy' | 'slim' | 'serif' | 'mono')[];
+}
+export interface BlockAttributes extends InlineAttributes {
+    /** Block content alignment within its own boundary */
+    align?: 'left' | 'right' | 'center';
+    /** Block starting column position L/C/R */
+    position?: 'L' | 'C' | 'R';
+    /** Whether to truncate on the left side of current column */
+    truncateLeft?: boolean;
+    /** Whether to truncate on the right side of current column */
+    truncateRight?: boolean;
+    /** Whether the current block is collapsed by [fold] */
+    fold?: boolean;
+    /** Whether the current block displays on the same line as the block above (triggered by [->]) */
+    sameLine?: boolean;
+}
+export type BlockNode = ParagraphBlock | HeadingBlock | ContentTitleBlock | QuoteBlock | ListBlock | ListItemBlock | CodeBlock | TableBlock | HorizontalRuleBlock | ImageBlock | HtmlBlock | FootnoteDefBlock | FootnotesBlock | CommentBlock | DisabledBlock | IncludeBlock | TaggedBlock | RawBlock;
+export interface ParagraphBlock {
+    type: 'paragraph';
+    children: InlineNode[];
+    blockAttrs?: BlockAttributes;
+}
+export interface HeadingBlock {
+    type: 'heading';
+    level: 1 | 2 | 3 | 4 | 5;
+    /** Whether it's a foldable heading in `#+` form */
+    foldable?: boolean;
+    children: InlineNode[];
+    blockAttrs?: BlockAttributes;
+}
+export interface ContentTitleBlock {
+    type: 'contentTitle';
+    children: InlineNode[];
+}
+export interface QuoteBlock {
+    type: 'quote';
+    /** @ / @@ / @@@ ... nesting level */
+    level: number;
+    /** Quote content can contain paragraphs, lists, etc. */
+    children: BlockNode[];
+    blockAttrs?: BlockAttributes;
+}
+export interface ListBlock {
+    type: 'list';
+    kind: ListKind;
+    /** Ordered list number style, reserved for extension */
+    orderedStyle?: 'decimal';
+    children: ListItemBlock[];
+    blockAttrs?: BlockAttributes;
+}
+export interface ListItemBlock {
+    type: 'listItem';
+    kind: ListKind;
+    /** Only valid for ordered/foldable, e.g., "1", "1.1", "1.1.1" */
+    ordinal?: string;
+    /** Task status: -[] / -[o] / -[x] / -[v] */
+    taskStatus?: TaskStatus;
+    /** Indent level, based on syntax level (- / -- / + / ++ etc.) */
+    indent: number;
+    /** List item content can be paragraphs, sublists, etc. */
+    children: BlockNode[];
+    blockAttrs?: BlockAttributes;
+}
+export interface CodeBlock {
+    type: 'code';
+    /** Language identifier in ```C */
+    language?: string;
+    /** Raw code content */
+    value: string;
+    /** True when preceded by [html] */
+    htmlLike?: boolean;
+    blockAttrs?: BlockAttributes;
+}
+export interface TableBlock {
+    type: 'table';
+    rows: TableRow[];
+    /** Column alignment */
+    align?: ('left' | 'right' | 'center')[];
+    /** Attributes like alignment in [sheet,r] */
+    blockAttrs?: BlockAttributes;
+}
+export interface TableRow {
+    type: 'tableRow';
+    cells: TableCell[];
+}
+export interface TableCell {
+    type: 'tableCell';
+    children: InlineNode[];
+    align?: 'left' | 'right' | 'center';
+}
+export interface HorizontalRuleBlock {
+    type: 'hr';
+    /** Corresponds to ----- / ***** / ===== / ~~~~~ */
+    style: 'solid' | 'dashed' | 'bold' | 'wavy';
+    /** Supports [color] for advanced line styling */
+    colorAttr?: ColorAttribute;
+    blockAttrs?: BlockAttributes;
+}
+export interface ImageBlock {
+    type: 'image';
+    url: string;
+    /** Can be represented by content title block */
+    title?: string;
+    /** [shape] or [rounded,img] */
+    shape?: 'square' | 'rounded';
+    /** [rounded=num] rounded corner radius, default 1.0 */
+    roundedRadius?: number;
+    blockAttrs?: BlockAttributes;
+}
+export interface HtmlBlock {
+    type: 'html';
+    /** If from [html](url), this is the reference path */
+    source?: string;
+    /** If from [html] + code block, this is the inline HTML text */
+    value?: string;
+    blockAttrs?: BlockAttributes;
+}
+export interface FootnotesBlock {
+    type: 'footnotes';
+    children: FootnoteDefBlock[];
+    blockAttrs?: BlockAttributes;
+}
+export interface FootnoteDefBlock {
+    type: 'footnoteDef';
+    /** Corresponds to [fn:id] / [fn=id] */
+    id: string;
+    /** Footnote content can contain simple blocks */
+    children: BlockNode[];
+    blockAttrs?: BlockAttributes;
+}
+export interface CommentBlock {
+    type: 'commentBlock';
+    /** Comment content */
+    children: BlockNode[];
+    blockAttrs?: BlockAttributes;
+}
+export interface DisabledBlock {
+    type: 'disabledBlock';
+    /** Raw text, no inline parsing */
+    raw: string;
+    blockAttrs?: BlockAttributes;
+}
+export interface IncludeBlock {
+    type: 'include';
+    /**
+     * mode: 'file' 对应语法 `[@](path)`，target 为相对路径；
+     * mode: 'tag' 对应语法 `[@=name]`，target 为区块标签名称。
+     */
+    mode: 'file' | 'tag';
+    target: string;
+    blockAttrs?: BlockAttributes;
+}
+export interface TaggedBlock {
+    type: 'taggedBlock';
+    /** Block tag name, e.g., name in [tag=name] / [t=name] / [f=name] */
+    name: string;
+    /** The tagged block */
+    child: BlockNode;
+    blockAttrs?: BlockAttributes;
+}
+export interface RawBlock {
+    type: 'raw';
+    /** Raw text content, fallback for unsupported or reserved syntax */
+    value: string;
+    blockAttrs?: BlockAttributes;
+}
+export type InlineNode = TextNode | EmphasisNode | StrongNode | UnderlineNode | StrikeNode | WaveNode | SuperscriptNode | SubscriptNode | HighlightNode | LinkNode | FootnoteRefNode | InlineCommentNode | InlineAttrsNode | CodeSpanNode;
+export interface TextNode {
+    type: 'text';
+    value: string;
+}
+export interface CodeSpanNode {
+    type: 'codeSpan';
+    value: string;
+}
+export interface EmphasisNode {
+    type: 'em';
+    children: InlineNode[];
+}
+export interface StrongNode {
+    type: 'strong';
+    children: InlineNode[];
+}
+export interface UnderlineNode {
+    type: 'underline';
+    children: InlineNode[];
+}
+export interface StrikeNode {
+    type: 'strike';
+    children: InlineNode[];
+}
+export interface WaveNode {
+    type: 'wave';
+    children: InlineNode[];
+}
+export interface SuperscriptNode {
+    type: 'sup';
+    children: InlineNode[];
+}
+export interface SubscriptNode {
+    type: 'sub';
+    children: InlineNode[];
+}
+export interface HighlightNode {
+    type: 'highlight';
+    /**
+     * mode: 'frame'  对应语法文档中的成对反引号 ``...`` 框选效果；
+     * mode: 'marker' 对应语法文档中的 =...= 荧光笔高亮。
+     */
+    mode: 'frame' | 'marker';
+    children: InlineNode[];
+    /** [color] */
+    colorAttr?: ColorAttribute;
+    /** [!color] */
+    fillColorAttr?: ColorAttribute;
+    /** [square] / [rounded] */
+    shape?: 'square' | 'rounded';
+    /** [rounded=num] */
+    roundedRadius?: number;
+}
+export interface LinkNode {
+    type: 'link';
+    /** url / heading / block tag */
+    href: string;
+    /** Text content */
+    children: InlineNode[];
+    colorAttr?: ColorAttribute;
+    /** [!color] */
+    underlineColorAttr?: ColorAttribute;
+}
+export interface FootnoteRefNode {
+    type: 'footnoteRef';
+    /** [fn:id] */
+    id: string;
+}
+export interface InlineCommentNode {
+    type: 'commentInline';
+    children: InlineNode[];
+}
+export interface InlineAttrsNode {
+    type: 'inlineAttrs';
+    attrs: InlineAttributes;
+    children: InlineNode[];
+}