@open-guji/markdown-core 0.1.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,104 @@
+# @open-guji/markdown-core
+
+古籍 Markdown 扩展的**平台无关内核**：把源文里的短记号规范化为
+[Directive](https://talk.commonmark.org/t/generic-directives-plugins-syntax/444)
+中间表示，并提供解析成 mdast 的 remark 插件。
+
+渲染器（[web](../web)、[pdf](../pdf)）都建在它之上；写新平台的渲染器时，
+只要能消费指令，就不必重写词法分析。
+
+规范见仓库 [`spec/`](../../spec)，本包实现规范 **0.1.0**。
+
+## 安装
+
+```bash
+npm i @open-guji/markdown-core
+```
+
+## 用法
+
+### 只要中间表示
+
+```js
+import { gujiToDirective } from '@open-guji/markdown-core'
+
+gujiToDirective('^惟我\n.皇上<聖躬>，本作[甲]{{乙}}')
+// ':tt{n=1}惟我\n:kg{n=1}皇上:jz[聖躬]，本作:gz[甲]:sz[乙]'
+```
+
+纯字符串到字符串，无副作用，**逐行处理且不改变行数**——
+渲染期报出的行号可以直接映射回源文。
+
+### 解析成 mdast
+
+```js
+import { parseGuji } from '@open-guji/markdown-core'
+
+parseGuji('子曰<孔子也>。')
+// root > paragraph > [ text('子曰'), textDirective{ name:'jz', children:[text('孔子也')] }, text('。') ]
+```
+
+### 作为 remark 插件
+
+```js
+import { unified } from 'unified'
+import remarkParse from 'remark-parse'
+import remarkGuji from '@open-guji/markdown-core'
+import remarkRehype from 'remark-rehype'
+
+unified().use(remarkParse).use(remarkGuji).use(remarkRehype)
+```
+
+插件会自己注册 directive 的 micromark / mdast 扩展，**不需要再 use `remark-directive`**。
+它必须排在 `remark-parse` 之后（要包裹 parser 才能在解析前完成规范化）。
+
+## API
+
+| 导出 | 说明 |
+| --- | --- |
+| `remarkGuji`（默认导出） | remark 插件 |
+| `gujiToDirective(source, options?)` | 源文 → Directive Markdown |
+| `transformInline(text, options?)` | 只做行内记号转换（单行） |
+| `parseGuji(source, options?)` | 源文 → mdast |
+| `gujiProcessor(options?)` | 返回配好的 unified processor |
+| `formatDirective(tree, options?)` | mdast → Directive Markdown |
+| `applyLineScope(tree)` | 抬头的行作用域归并 |
+| `normalizeDirectiveNames(tree)` | 指令别名归一 |
+| `DIRECTIVES` / `lookupDirective` / `resolveDirectiveName` / `parseLevel` | 指令注册表 |
+| `buildMask` / `escapeDirectiveLabel` | 规范化用到的底层工具，写别的实现时可参考 |
+
+## 选项
+
+```ts
+interface GujiOptions {
+  // 各记号开关，默认全开
+  jz?: boolean; bz?: boolean; sz?: boolean; gz?: boolean
+  tt?: boolean; kg?: boolean; zm?: boolean; sm?: boolean
+
+  maxSpanLength?: number   // 行内记号内容上限，默认 64
+  maxLevel?: number        // n 属性上限，默认 9
+  gzRequireCjk?: boolean   // 改字内容须含 CJK，默认 true
+  zmRequireCjk?: boolean   // 专名号内容须含 CJK，默认 true
+  indentedCode?: boolean   // 识别缩进代码块，默认 true
+
+  shorthand?: boolean      // 解析前先规范化短记号，默认 true
+  lineScope?: boolean      // 抬头的行作用域归并，默认 true
+  normalizeNames?: boolean // 指令别名归一，默认 true
+}
+```
+
+各项的语义与边界条件见 [`spec/syntax.md`](../../spec/syntax.md)。
+
+## 已知限制
+
+* **列号不精确**。规范化会在行内插入 `:jz[` 等文本，因此 mdast 节点的
+  `column` 指向的是规范化之后的文本。行号是准的。
+  路线图里有一版基于 micromark 词法扩展的实现，会解决这一点。
+* **记号不跨行内结构**。像 `/孔**子/**` 这种跨越强调边界的写法属未定义行为。
+* **简写式引用链接与改字冲突**。`[說文]`（配合别处的 `[說文]: url` 定义）会被
+  识别为改字；行内链接 `[說文](url)` 不受影响。见
+  [`spec/syntax.md` §4](../../spec/syntax.md#4-改字-)。
+
+## 许可证
+
+Apache-2.0

package/dist/directives.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 指令注册表。规范见 spec/directives.md。
+ */
+export type DirectiveShape = 'text' | 'marker' | 'leaf' | 'container';
+export interface DirectiveSpec {
+    /** 规范名，两字拼音首字母 */
+    name: string;
+    /** 中文名 */
+    cn: string;
+    /** 可接受的别名，解析时归一到 name */
+    aliases: readonly string[];
+    /** 允许的形态 */
+    shapes: readonly DirectiveShape[];
+    /** 已定义的属性名 */
+    attributes: readonly string[];
+    /** 默认 HTML 元素（行内形态） */
+    tagName: string;
+    /** 容器形态的 HTML 元素，未定义则不支持容器形态 */
+    blockTagName?: string;
+    /** 对应的源文短记号，供文档与反向规范化使用 */
+    shorthand?: {
+        open: string;
+        close: string;
+    } | {
+        linePrefix: string;
+    };
+}
+export declare const DIRECTIVES: readonly DirectiveSpec[];
+/** 取指令定义；名字可以是规范名或别名。 */
+export declare function lookupDirective(name: string): DirectiveSpec | undefined;
+/** 把别名归一到规范名；未注册的名字原样返回。 */
+export declare function resolveDirectiveName(name: string): string;
+/** 是否为古籍扩展定义的指令。 */
+export declare function isGujiDirective(name: string): boolean;
+/**
+ * 解析 `n` 属性：非数字、小于 1 时取 1，超过上限时钳制。
+ */
+export declare function parseLevel(value: unknown, maxLevel?: number): number;
+//# sourceMappingURL=directives.d.ts.map

package/dist/directives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directives.d.ts","sourceRoot":"","sources":["../src/directives.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAA;AAErE,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU;IACV,EAAE,EAAE,MAAM,CAAA;IACV,yBAAyB;IACzB,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1B,YAAY;IACZ,MAAM,EAAE,SAAS,cAAc,EAAE,CAAA;IACjC,cAAc;IACd,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;IAC7B,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,2BAA2B;IAC3B,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;CACrE;AAED,eAAO,MAAM,UAAU,EAAE,SAAS,aAAa,EA0E9C,CAAA;AAQD,yBAAyB;AACzB,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEvE;AAED,4BAA4B;AAC5B,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,oBAAoB;AACpB,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAI,GAAG,MAAM,CAI/D"}

package/dist/directives.js

@@ -0,0 +1,106 @@
+/**
+ * 指令注册表。规范见 spec/directives.md。
+ */
+export const DIRECTIVES = [
+    {
+        name: 'jz',
+        cn: '夹注',
+        aliases: ['note', 'jiazhu', 'xiaozhu'],
+        shapes: ['text'],
+        attributes: ['type'],
+        tagName: 'span',
+        shorthand: { open: '<', close: '>' }
+    },
+    {
+        name: 'bz',
+        cn: '补字',
+        aliases: ['add', 'ins', 'buzi'],
+        shapes: ['text'],
+        attributes: ['src'],
+        tagName: 'ins',
+        shorthand: { open: '((', close: '))' }
+    },
+    {
+        name: 'sz',
+        cn: '删字',
+        aliases: ['del', 'shanzi'],
+        shapes: ['text'],
+        attributes: ['src'],
+        tagName: 'del',
+        shorthand: { open: '{{', close: '}}' }
+    },
+    {
+        name: 'gz',
+        cn: '改字',
+        aliases: ['sub', 'amend', 'gaizi'],
+        shapes: ['text'],
+        attributes: ['src'],
+        tagName: 'ins',
+        shorthand: { open: '[', close: ']' }
+    },
+    {
+        name: 'tt',
+        cn: '抬头',
+        aliases: ['raise', 'taitou'],
+        shapes: ['marker', 'text', 'container'],
+        attributes: ['n'],
+        tagName: 'span',
+        blockTagName: 'div',
+        shorthand: { linePrefix: '^' }
+    },
+    {
+        name: 'kg',
+        cn: '空格',
+        aliases: ['space', 'kongge'],
+        shapes: ['marker'],
+        attributes: ['n'],
+        tagName: 'span',
+        shorthand: { linePrefix: '.' }
+    },
+    {
+        name: 'zm',
+        cn: '专名号',
+        aliases: ['name', 'zhuanming'],
+        shapes: ['text'],
+        attributes: ['type'],
+        tagName: 'span',
+        shorthand: { open: '/', close: '/' }
+    },
+    {
+        name: 'sm',
+        cn: '书名号',
+        aliases: ['book', 'shuming'],
+        shapes: ['text'],
+        attributes: ['part'],
+        tagName: 'span',
+        shorthand: { open: '《', close: '》' }
+    }
+];
+const BY_NAME = new Map();
+for (const spec of DIRECTIVES) {
+    BY_NAME.set(spec.name, spec);
+    for (const alias of spec.aliases)
+        BY_NAME.set(alias, spec);
+}
+/** 取指令定义；名字可以是规范名或别名。 */
+export function lookupDirective(name) {
+    return BY_NAME.get(name);
+}
+/** 把别名归一到规范名；未注册的名字原样返回。 */
+export function resolveDirectiveName(name) {
+    return BY_NAME.get(name)?.name ?? name;
+}
+/** 是否为古籍扩展定义的指令。 */
+export function isGujiDirective(name) {
+    return BY_NAME.has(name);
+}
+/**
+ * 解析 `n` 属性：非数字、小于 1 时取 1，超过上限时钳制。
+ */
+export function parseLevel(value, maxLevel = 9) {
+    const n = typeof value === 'number' ? value : Number.parseInt(String(value ?? ''), 10);
+    if (!Number.isFinite(n) || n < 1)
+        return 1;
+    return Math.min(Math.trunc(n), maxLevel);
+}
+//# sourceMappingURL=directives.js.map

package/dist/directives.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `@open-guji/markdown-core`
+ *
+ * 古籍 Markdown 扩展的平台无关内核：
+ * 短记号 → Directive 的规范化器、指令注册表、remark 插件与 mdast 变换。
+ *
+ * 规范见仓库 `spec/` 目录。
+ */
+export { default as remarkGuji, default } from './plugin.js';
+export { gujiToDirective, transformInline, buildMask, escapeDirectiveLabel } from './normalize.js';
+export { gujiProcessor, parseGuji, formatDirective } from './parse.js';
+export { applyLineScope, normalizeDirectiveNames } from './transform.js';
+export { DIRECTIVES, lookupDirective, resolveDirectiveName, isGujiDirective, parseLevel, type DirectiveSpec, type DirectiveShape } from './directives.js';
+export { DEFAULT_SYNTAX_OPTIONS, resolveSyntaxOptions, resolveOptions, type GujiToggles, type GujiSyntaxOptions, type ResolvedSyntaxOptions, type GujiOptions, type ResolvedGujiOptions } from './options.js';
+/** 本包实现的规范版本。 */
+export declare const SPEC_VERSION = "0.1.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAE5D,OAAO,EACL,eAAe,EACf,eAAe,EACf,SAAS,EACT,oBAAoB,EACrB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEtE,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AAExE,OAAO,EACL,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,UAAU,EACV,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACzB,MAAM,cAAc,CAAA;AAErB,iBAAiB;AACjB,eAAO,MAAM,YAAY,UAAU,CAAA"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * `@open-guji/markdown-core`
+ *
+ * 古籍 Markdown 扩展的平台无关内核：
+ * 短记号 → Directive 的规范化器、指令注册表、remark 插件与 mdast 变换。
+ *
+ * 规范见仓库 `spec/` 目录。
+ */
+export { default as remarkGuji, default } from './plugin.js';
+export { gujiToDirective, transformInline, buildMask, escapeDirectiveLabel } from './normalize.js';
+export { gujiProcessor, parseGuji, formatDirective } from './parse.js';
+export { applyLineScope, normalizeDirectiveNames } from './transform.js';
+export { DIRECTIVES, lookupDirective, resolveDirectiveName, isGujiDirective, parseLevel } from './directives.js';
+export { DEFAULT_SYNTAX_OPTIONS, resolveSyntaxOptions, resolveOptions } from './options.js';
+/** 本包实现的规范版本。 */
+export const SPEC_VERSION = '0.1.0';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAE5D,OAAO,EACL,eAAe,EACf,eAAe,EACf,SAAS,EACT,oBAAoB,EACrB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEtE,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AAExE,OAAO,EACL,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,UAAU,EAGX,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EAMf,MAAM,cAAc,CAAA;AAErB,iBAAiB;AACjB,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAA"}

package/dist/normalize.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 规范化器：古籍 Markdown 短记号 → Directive Markdown。
+ *
+ * 规范见 spec/syntax.md 与 spec/directives.md。三条硬性保证：
+ *
+ * 1. 逐行处理，输出行数与行序不变；
+ * 2. 幂等：`normalize(normalize(x)) === normalize(x)`；
+ * 3. 不生效区（代码块、代码片段、链接目标、HTML、转义）逐字保留。
+ */
+import { type GujiSyntaxOptions } from './options.js';
+/**
+ * 构造与 `s` 等长的掩码串：不生效区的字符置为 NUL。
+ * 之后所有记号匹配都在掩码串上做、输出时取原串，索引天然对齐。
+ */
+export declare function buildMask(s: string): string;
+/**
+ * 转义 label 中不配对的方括号，否则指令会被提前截断。
+ * 配对的方括号（例如 label 内含链接）保持原样。
+ */
+export declare function escapeDirectiveLabel(s: string): string;
+/** 只做行内记号的转换，供测试与其他实现参考。 */
+export declare function transformInline(text: string, options?: GujiSyntaxOptions): string;
+/**
+ * 古籍 Markdown → Directive Markdown。
+ *
+ * @example
+ * gujiToDirective('^惟我\n.皇上<聖躬>')
+ * // ':tt{n=1}惟我\n:kg{n=1}皇上:jz[聖躬]'
+ */
+export declare function gujiToDirective(source: string, options?: GujiSyntaxOptions): string;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAEL,KAAK,iBAAiB,EAEvB,MAAM,cAAc,CAAA;AAwDrB;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CA8E3C;AAkJD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAuBtD;AAyFD,4BAA4B;AAC5B,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAIjF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAkFnF"}