@open-guji/markdown-pdf 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,112 @@
+# @open-guji/markdown-pdf
+
+古籍 Markdown 的 **PDF 生成器**。
+
+> **状态：预览。** 可打印 HTML 的生成已经稳定；Chromium 后端能出 PDF，
+> 但竖排的断行、双行夹注的精确排布仍在调。
+
+规范见仓库 [`spec/`](../../spec)，本包实现规范 **0.1.0**。
+
+## 分层
+
+```
+源文 ──[@open-guji/markdown-web]──> HTML 片段
+                                      │
+                     gujiToPrintHtml   │  + @page 规则 + 竖排样式 + 可选 Paged.js
+                                      ▼
+                              可打印 HTML  ──[Chromium]──> PDF
+```
+
+第一层是**纯函数**，没有外部依赖，浏览器里也能跑，输出可以交给任何排版引擎；
+第二层才需要 playwright。
+
+## 安装
+
+```bash
+npm i @open-guji/markdown-pdf
+
+# 要真的出 PDF
+npm i -D playwright && npx playwright install chromium
+
+# 想要更好的分页控制（页眉页脚、跨页避断），可选
+npm i pagedjs
+```
+
+## 用法
+
+```js
+import { gujiToPdf, gujiToPrintHtml } from '@open-guji/markdown-pdf'
+
+// 只要可打印 HTML
+const html = gujiToPrintHtml(source, { pageSize: 'A5', vertical: true })
+
+// 出 PDF
+const bytes = await gujiToPdf(source, { title: '明太祖實錄', banks: true })
+```
+
+### 命令行
+
+```bash
+guji-pdf 實錄.gmd                  # → 實錄.pdf
+guji-pdf 實錄.gmd --html           # → 實錄.html，不调用排版后端
+guji-pdf 實錄.gmd --size A4 --banks --title 明太祖實錄
+guji-pdf --check                   # 检查排版后端是否可用
+```
+
+## 选项
+
+```ts
+interface PdfOptions {
+  pageSize?: 'A4' | 'A5' | 'B5' | 'Letter' | string  // 默认 'A5'
+  pageMargin?: string                                 // CSS margin，默认 '20mm 18mm'
+  fontSize?: string                                   // 默认 '11pt'
+  lineHeight?: number                                 // 默认 1.85
+  vertical?: boolean                                  // 竖排，默认 true
+  banks?: boolean                                     // 版框与界行，默认 false
+  paged?: 'auto' | 'always' | 'never'                 // 是否内联 Paged.js，默认 'auto'
+  title?: string
+  extraCss?: string
+  executablePath?: string                             // 自带的 Chromium 路径
+  browserArgs?: string[]
+  timeout?: number                                    // 默认 30000
+}
+```
+
+外加 [web 包的全部选项](../web/README.md#选项)。
+
+## 为什么用浏览器排版
+
+竖排（`writing-mode: vertical-rl`）、专名线画在字的左侧
+（`text-underline-position: left`）、抬头的逻辑方向外移——
+这些正好都是 CSS 书写模式已经解决的问题，而 web 包已经把语义标好了。
+让 PDF 复用同一份 HTML 与 CSS，意味着**网页和印本天然一致**，
+不必维护两套排版规则。
+
+评估过的其他后端：
+
+| 方案 | 结论 |
+| --- | --- |
+| **Chromium + Paged.js**（当前） | 竖排与逻辑属性支持最好；分页控制靠 Paged.js 补齐 |
+| Typst | 排版质量高、无需浏览器，但竖排 CJK 支持尚不完整 |
+| XeLaTeX + xeCJK | 竖排成熟，但要另写一套从 mdast 到 TeX 的映射，且与网页样式两套维护 |
+| 纯 pdfkit / PDF 库 | 需要自己实现断行与避头尾，工作量最大 |
+
+如果将来 Typst 的竖排 CJK 成熟，会作为第二后端加入——
+`gujiToPrintHtml` 之前的那一段是共用的。
+
+## 已知限制
+
+* 竖排下**双行夹注**用 CSS 多列近似，注文很长时会溢出列高。
+* 没装 `pagedjs` 时由 Chromium 自行分页，页码与跨页避断的控制较弱。
+* 版框与界行（`banks`）是用渐变画的，行距变化时需要同步调 `--guji-print-line-height`。
+
+## 路线图
+
+- [ ] 双行夹注的精确断行（在 Paged.js 的 chunker 阶段做）
+- [ ] 书口、鱼尾、版心页码
+- [ ] Typst 后端
+- [ ] 字体子集化，减小产物体积
+
+## 许可证
+
+Apache-2.0

package/dist/cli.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+/** guji-pdf —— 把古籍 Markdown 转成 PDF 或可打印 HTML。 */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,iDAAiD"}

package/dist/cli.js

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+/** guji-pdf —— 把古籍 Markdown 转成 PDF 或可打印 HTML。 */
+import { readFile, writeFile } from 'node:fs/promises';
+import { basename, extname } from 'node:path';
+import { checkBackend, gujiToPdf, gujiToPrintHtml } from './index.js';
+const USAGE = `用法：guji-pdf <输入.gmd> [选项]
+
+选项：
+  -o, --out <文件>       输出路径（默认与输入同名，改扩展名）
+      --html             只生成可打印 HTML，不调用排版后端
+      --size <纸张>      A4 | A5 | B5 | Letter，默认 A5
+      --margin <边距>    CSS margin 语法，默认 "20mm 18mm"
+      --font-size <值>   正文字号，默认 11pt
+      --line-height <值> 正文行距倍数，默认 1.85
+      --horizontal       横排（默认竖排）
+      --banks            加版框与界行
+      --title <标题>     文档标题
+      --check            检查排版后端是否可用
+  -h, --help             显示本帮助
+`;
+function parseArgs(argv) {
+    const options = {};
+    let input;
+    let out;
+    let html = false;
+    let check = false;
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        const next = () => {
+            const value = argv[++i];
+            if (value === undefined)
+                throw new Error(`选项 ${arg} 缺少参数`);
+            return value;
+        };
+        switch (arg) {
+            case '-h':
+            case '--help':
+                process.stdout.write(USAGE);
+                process.exit(0);
+                break;
+            case '--check':
+                check = true;
+                break;
+            case '--html':
+                html = true;
+                break;
+            case '-o':
+            case '--out':
+                out = next();
+                break;
+            case '--size':
+                options.pageSize = next();
+                break;
+            case '--margin':
+                options.pageMargin = next();
+                break;
+            case '--font-size':
+                options.fontSize = next();
+                break;
+            case '--line-height':
+                options.lineHeight = Number(next());
+                break;
+            case '--horizontal':
+                options.vertical = false;
+                break;
+            case '--banks':
+                options.banks = true;
+                break;
+            case '--title':
+                options.title = next();
+                break;
+            default:
+                if (arg.startsWith('-'))
+                    throw new Error(`未知选项 ${arg}`);
+                input = arg;
+        }
+    }
+    return { input, out, html, check, options };
+}
+async function main() {
+    const { input, out, html, check, options } = parseArgs(process.argv.slice(2));
+    if (check) {
+        const backend = await checkBackend();
+        process.stdout.write(`playwright: ${backend.playwright ? '可用' : '未安装'}\n` +
+            `pagedjs:    ${backend.pagedjs ? '可用' : '未安装（将由 Chromium 自行分页）'}\n`);
+        return;
+    }
+    if (!input) {
+        process.stderr.write(USAGE);
+        process.exitCode = 1;
+        return;
+    }
+    const source = await readFile(input, 'utf8');
+    const stem = basename(input, extname(input));
+    options.title ??= stem;
+    if (html) {
+        const target = out ?? `${stem}.html`;
+        await writeFile(target, gujiToPrintHtml(source, options));
+        process.stdout.write(`${target}\n`);
+        return;
+    }
+    const target = out ?? `${stem}.pdf`;
+    await writeFile(target, await gujiToPdf(source, options));
+    process.stdout.write(`${target}\n`);
+}
+main().catch((error) => {
+    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `@open-guji/markdown-pdf`
+ *
+ * 古籍 Markdown 的 PDF 生成器。分两层：
+ *
+ * - {@link gujiToPrintHtml} —— 纯函数，源文 → 带 `@page` 规则的可打印 HTML；
+ * - {@link gujiToPdf} —— 把上面的 HTML 交给 Chromium 出 PDF（需要 playwright）。
+ *
+ * 规范见仓库 `spec/` 目录，排版决策见本包 README。
+ */
+export { gujiToPrintHtml, loadPagedPolyfill } from './print-html.js';
+export { gujiToPdf, checkBackend } from './pdf.js';
+export { DEFAULT_PRINT_OPTIONS, type PageSize, type PrintOptions, type PdfOptions } from './options.js';
+export { printCss } from './styles.generated.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;;;;;;;;;GASG;AAEH,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACpE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAClD,OAAO,EAAE,qBAAqB,EAAE,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAA;AACvG,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAEhD,iBAAiB;AACjB,eAAO,MAAM,YAAY,UAAU,CAAA"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * `@open-guji/markdown-pdf`
+ *
+ * 古籍 Markdown 的 PDF 生成器。分两层：
+ *
+ * - {@link gujiToPrintHtml} —— 纯函数，源文 → 带 `@page` 规则的可打印 HTML；
+ * - {@link gujiToPdf} —— 把上面的 HTML 交给 Chromium 出 PDF（需要 playwright）。
+ *
+ * 规范见仓库 `spec/` 目录，排版决策见本包 README。
+ */
+export { gujiToPrintHtml, loadPagedPolyfill } from './print-html.js';
+export { gujiToPdf, checkBackend } from './pdf.js';
+export { DEFAULT_PRINT_OPTIONS } from './options.js';
+export { printCss } from './styles.generated.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;;;;;;;;;GASG;AAEH,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACpE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAClD,OAAO,EAAE,qBAAqB,EAAqD,MAAM,cAAc,CAAA;AACvG,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAEhD,iBAAiB;AACjB,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAA"}

package/dist/options.d.ts

@@ -0,0 +1,60 @@
+import type { DocumentOptions } from '@open-guji/markdown-web';
+/** 纸张。字符串会原样写进 `@page { size: … }`。 */
+export type PageSize = 'A4' | 'A5' | 'B5' | 'Letter' | (string & {});
+export interface PrintOptions extends DocumentOptions {
+    /**
+     * 纸张尺寸。
+     * @default 'A5'
+     */
+    pageSize?: PageSize;
+    /**
+     * 页边距，CSS `margin` 语法。
+     * @default '20mm 18mm'
+     */
+    pageMargin?: string;
+    /**
+     * 正文字号。
+     * @default '11pt'
+     */
+    fontSize?: string;
+    /**
+     * 正文行距（无单位倍数）。
+     * @default 1.85
+     */
+    lineHeight?: number;
+    /**
+     * 加版框与界行（线装书版式）。
+     * @default false
+     */
+    banks?: boolean;
+    /**
+     * 是否内联 Paged.js。
+     * `auto` 表示能解析到 `pagedjs` 依赖时才内联，否则交给排版引擎自己分页。
+     * @default 'auto'
+     */
+    paged?: 'auto' | 'always' | 'never';
+}
+export interface PdfOptions extends PrintOptions {
+    /**
+     * 渲染超时（毫秒）。
+     * @default 30000
+     */
+    timeout?: number;
+    /**
+     * 浏览器可执行文件路径。留空则用 playwright 自带的 Chromium；
+     * CI 里常有一份预装的浏览器，指过去可以省掉一次下载。
+     */
+    executablePath?: string;
+    /** 传给 Chromium 的额外命令行参数。 */
+    browserArgs?: string[];
+}
+export declare const DEFAULT_PRINT_OPTIONS: {
+    readonly pageSize: "A5";
+    readonly pageMargin: "20mm 18mm";
+    readonly fontSize: "11pt";
+    readonly lineHeight: 1.85;
+    readonly banks: false;
+    readonly paged: "auto";
+    readonly vertical: true;
+};
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAE9D,uCAAuC;AACvC,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEpE,MAAM,WAAW,YAAa,SAAQ,eAAe;IACnD;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;CACpC;AAED,MAAM,WAAW,UAAW,SAAQ,YAAY;IAC9C;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB;AAED,eAAO,MAAM,qBAAqB;;;;;;;;CAQQ,CAAA"}

package/dist/options.js

@@ -0,0 +1,10 @@
+export const DEFAULT_PRINT_OPTIONS = {
+    pageSize: 'A5',
+    pageMargin: '20mm 18mm',
+    fontSize: '11pt',
+    lineHeight: 1.85,
+    banks: false,
+    paged: 'auto',
+    vertical: true
+};
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAsDA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,QAAQ,EAAE,IAAI;IACd,UAAU,EAAE,WAAW;IACvB,QAAQ,EAAE,MAAM;IAChB,UAAU,EAAE,IAAI;IAChB,KAAK,EAAE,KAAK;IACZ,KAAK,EAAE,MAAM;IACb,QAAQ,EAAE,IAAI;CAC0B,CAAA"}

package/dist/pdf.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Chromium 排版后端。
+ *
+ * PDF 复用网页渲染的结果，理由见 README「为什么用浏览器排版」。
+ * playwright 是可选依赖，只有真的要出 PDF 时才需要。
+ */
+import { type PdfOptions } from './options.js';
+/** 源文 → PDF 字节流。 */
+export declare function gujiToPdf(source: string, options?: PdfOptions): Promise<Uint8Array>;
+/** 当前环境是否具备出 PDF 的条件。 */
+export declare function checkBackend(): Promise<{
+    playwright: boolean;
+    pagedjs: boolean;
+}>;
+//# sourceMappingURL=pdf.d.ts.map

package/dist/pdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.d.ts","sourceRoot":"","sources":["../src/pdf.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAyB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAA;AAuCrE,oBAAoB;AACpB,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAwB7F;AAED,yBAAyB;AACzB,wBAAsB,YAAY,IAAI,OAAO,CAAC;IAC5C,UAAU,EAAE,OAAO,CAAA;IACnB,OAAO,EAAE,OAAO,CAAA;CACjB,CAAC,CASD"}

package/dist/pdf.js

@@ -0,0 +1,65 @@
+/**
+ * Chromium 排版后端。
+ *
+ * PDF 复用网页渲染的结果，理由见 README「为什么用浏览器排版」。
+ * playwright 是可选依赖，只有真的要出 PDF 时才需要。
+ */
+import { gujiToPrintHtml, loadPagedPolyfill } from './print-html.js';
+import { DEFAULT_PRINT_OPTIONS } from './options.js';
+async function loadChromium() {
+    try {
+        const mod = (await import('playwright'));
+        return mod.chromium;
+    }
+    catch {
+        throw new Error('生成 PDF 需要 playwright：\n' +
+            '  npm i -D playwright && npx playwright install chromium\n' +
+            '若只需要可打印的 HTML，请改用 gujiToPrintHtml()。');
+    }
+}
+/** 等待 Paged.js 完成分页；没有 Paged.js 时立即返回。 */
+const WAIT_FOR_PAGED = `new Promise((resolve) => {
+  if (!window.PagedPolyfill) return resolve('native')
+  if (window.PagedPolyfill.rendered) return resolve('paged')
+  window.addEventListener('pagedjs:rendered', () => resolve('paged'), { once: true })
+  setTimeout(() => resolve('timeout'), 20000)
+})`;
+/** 源文 → PDF 字节流。 */
+export async function gujiToPdf(source, options = {}) {
+    const o = { ...DEFAULT_PRINT_OPTIONS, timeout: 30_000, ...options };
+    const html = gujiToPrintHtml(source, o);
+    const chromium = await loadChromium();
+    const browser = await chromium.launch({
+        ...(o.executablePath ? { executablePath: o.executablePath } : {}),
+        ...(o.browserArgs ? { args: o.browserArgs } : {})
+    });
+    try {
+        const page = await browser.newPage();
+        await page.setContent(html, { waitUntil: 'load', timeout: o.timeout });
+        await page.evaluate(WAIT_FOR_PAGED);
+        await page.emulateMedia({ media: 'print' });
+        // Paged.js 已经把内容切成了固定尺寸的页盒，此时再让 Chromium 分页会重复分页；
+        // 没有 Paged.js 时则交给 Chromium 自己按 @page 规则分页。
+        return await page.pdf({
+            printBackground: true,
+            preferCSSPageSize: true,
+            displayHeaderFooter: false
+        });
+    }
+    finally {
+        await browser.close();
+    }
+}
+/** 当前环境是否具备出 PDF 的条件。 */
+export async function checkBackend() {
+    let playwright = false;
+    try {
+        await import('playwright');
+        playwright = true;
+    }
+    catch {
+        playwright = false;
+    }
+    return { playwright, pagedjs: loadPagedPolyfill() !== undefined };
+}
+//# sourceMappingURL=pdf.js.map

package/dist/pdf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.js","sourceRoot":"","sources":["../src/pdf.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACpE,OAAO,EAAE,qBAAqB,EAAmB,MAAM,cAAc,CAAA;AAkBrE,KAAK,UAAU,YAAY;IACzB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,CAA0C,CAAA;QACjF,OAAO,GAAG,CAAC,QAAQ,CAAA;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,yBAAyB;YACvB,4DAA4D;YAC5D,sCAAsC,CACzC,CAAA;IACH,CAAC;AACH,CAAC;AAED,0CAA0C;AAC1C,MAAM,cAAc,GAAG;;;;;GAKpB,CAAA;AAEH,oBAAoB;AACpB,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAc,EAAE,UAAsB,EAAE;IACtE,MAAM,CAAC,GAAG,EAAE,GAAG,qBAAqB,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAAA;IACnE,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IACvC,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAA;IACrC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;QACpC,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClD,CAAC,CAAA;IAEF,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAA;QACpC,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAA;QACtE,MAAM,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAA;QACnC,MAAM,IAAI,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;QAC3C,kDAAkD;QAClD,4CAA4C;QAC5C,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC;YACpB,eAAe,EAAE,IAAI;YACrB,iBAAiB,EAAE,IAAI;YACvB,mBAAmB,EAAE,KAAK;SAC3B,CAAC,CAAA;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAA;IACvB,CAAC;AACH,CAAC;AAED,yBAAyB;AACzB,MAAM,CAAC,KAAK,UAAU,YAAY;IAIhC,IAAI,UAAU,GAAG,KAAK,CAAA;IACtB,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,YAAY,CAAC,CAAA;QAC1B,UAAU,GAAG,IAAI,CAAA;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,UAAU,GAAG,KAAK,CAAA;IACpB,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,EAAE,KAAK,SAAS,EAAE,CAAA;AACnE,CAAC"}

package/dist/print-html.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 源文 → 可打印 HTML。
+ *
+ * 这一步是纯函数、无外部依赖，浏览器里也能跑；
+ * 真正生成 PDF 的排版后端只是把它喂给一个排版引擎。
+ */
+import { type PrintOptions } from './options.js';
+/** 解析 `pagedjs` 的 polyfill 脚本；没装则返回 undefined。 */
+export declare function loadPagedPolyfill(): string | undefined;
+/** 源文 → 一张带 `@page` 规则、可以直接打印的 HTML 页面。 */
+export declare function gujiToPrintHtml(source: string, options?: PrintOptions): string;
+//# sourceMappingURL=print-html.d.ts.map

package/dist/print-html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"print-html.d.ts","sourceRoot":"","sources":["../src/print-html.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAyB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAA;AAGvE,kDAAkD;AAClD,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAQtD;AAYD,2CAA2C;AAC3C,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,MAAM,CAiBlF"}

package/dist/print-html.js

@@ -0,0 +1,46 @@
+/**
+ * 源文 → 可打印 HTML。
+ *
+ * 这一步是纯函数、无外部依赖，浏览器里也能跑；
+ * 真正生成 PDF 的排版后端只是把它喂给一个排版引擎。
+ */
+import { gujiToHtml, renderDocument } from '@open-guji/markdown-web';
+import { createRequire } from 'node:module';
+import { readFileSync } from 'node:fs';
+import { DEFAULT_PRINT_OPTIONS } from './options.js';
+import { printCss } from './styles.generated.js';
+/** 解析 `pagedjs` 的 polyfill 脚本；没装则返回 undefined。 */
+export function loadPagedPolyfill() {
+    try {
+        const require = createRequire(import.meta.url);
+        const entry = require.resolve('pagedjs/dist/paged.polyfill.js');
+        return readFileSync(entry, 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+}
+function pageVariables(options) {
+    return `:root {
+  --guji-page-size: ${options.pageSize};
+  --guji-page-margin: ${options.pageMargin};
+  --guji-print-font-size: ${options.fontSize};
+  --guji-print-line-height: ${options.lineHeight};
+}`;
+}
+/** 源文 → 一张带 `@page` 规则、可以直接打印的 HTML 页面。 */
+export function gujiToPrintHtml(source, options = {}) {
+    const o = { ...DEFAULT_PRINT_OPTIONS, ...options };
+    const polyfill = o.paged === 'never' ? undefined : loadPagedPolyfill();
+    if (o.paged === 'always' && !polyfill) {
+        throw new Error("paged: 'always' 需要安装 pagedjs（npm i pagedjs），或改用 paged: 'auto'。");
+    }
+    return renderDocument(gujiToHtml(source, o), {
+        ...o,
+        className: [o.banks ? 'guji-banks' : '', o.className ?? ''].filter(Boolean).join(' '),
+        extraCss: [pageVariables(o), printCss, o.extraCss ?? ''].filter(Boolean).join('\n'),
+        extraHead: [o.extraHead ?? '', polyfill ? `<script>\n${polyfill}\n</script>` : ''].
+            filter(Boolean).join('\n')
+    });
+}
+//# sourceMappingURL=print-html.js.map

package/dist/print-html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"print-html.js","sourceRoot":"","sources":["../src/print-html.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,qBAAqB,EAAqB,MAAM,cAAc,CAAA;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAEhD,kDAAkD;AAClD,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,gCAAgC,CAAC,CAAA;QAC/D,OAAO,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,OACkC;IACvD,OAAO;sBACa,OAAO,CAAC,QAAQ;wBACd,OAAO,CAAC,UAAU;4BACd,OAAO,CAAC,QAAQ;8BACd,OAAO,CAAC,UAAU;EAC9C,CAAA;AACF,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,UAAwB,EAAE;IACxE,MAAM,CAAC,GAAG,EAAE,GAAG,qBAAqB,EAAE,GAAG,OAAO,EAAE,CAAA;IAElD,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAA;IACtE,IAAI,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAA;IACH,CAAC;IAED,OAAO,cAAc,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE;QAC3C,GAAG,CAAC;QACJ,SAAS,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QACrF,QAAQ,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACnF,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,aAAa,QAAQ,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;YAChF,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;KAC7B,CAAC,CAAA;AACJ,CAAC"}

package/dist/styles.generated.d.ts

@@ -0,0 +1,3 @@
+export declare const printCss = "/*!\n * print.css \u2014 \u53E4\u7C4D Markdown \u7684\u5206\u9875\u6392\u7248\u6837\u5F0F\n * @open-guji/markdown-pdf \u00B7 Apache-2.0\n *\n * \u4E0E guji.css / guji-vertical.css \u53E0\u52A0\u4F7F\u7528\u3002\u8FD9\u91CC\u53EA\u7BA1\"\u9875\"\u7684\u4E8B\uFF1A\n * \u9875\u9762\u5C3A\u5BF8\u3001\u9875\u8FB9\u8DDD\u3001\u7248\u5FC3\u3001\u4E66\u53E3\u4E0E\u5206\u9875\u63A7\u5236\u3002\n */\n\n@page {\n  size: var(--guji-page-size, A5);\n  margin: var(--guji-page-margin, 20mm 18mm);\n\n  @bottom-center {\n    content: counter(page);\n    font-family: var(--guji-font);\n    font-size: 9pt;\n    color: #666;\n  }\n}\n\n@page :first {\n  @bottom-center {\n    content: none;\n  }\n}\n\n.guji-doc {\n  /* \u6253\u5370\u65F6\u62AC\u5934\u7559\u767D\u6309\u5B9E\u9645\u5B57\u53F7\u6298\u7B97\uFF0C\u4E0D\u518D\u4F9D\u8D56\u89C6\u53E3 */\n  --guji-raise-unit: 1em;\n  font-size: var(--guji-print-font-size, 11pt);\n  line-height: var(--guji-print-line-height, 1.85);\n}\n\n/* \u6807\u9898\u4E0D\u843D\u5728\u9875\u672B */\n.guji-doc h1,\n.guji-doc h2,\n.guji-doc h3 {\n  break-after: avoid-page;\n  break-inside: avoid;\n}\n\n/* \u62AC\u5934\u884C\u4E0D\u88AB\u5207\u5F00 */\n.guji-tt,\n.guji-tt-block {\n  break-inside: avoid;\n}\n\n/* \u5939\u6CE8\u8DDF\u968F\u6B63\u6587\uFF0C\u4E0D\u5355\u72EC\u6210\u9875 */\n.guji-jz {\n  break-inside: avoid;\n}\n\n.guji-doc p {\n  orphans: 2;\n  widows: 2;\n}\n\n/* ------------------------------------------------------ \u7EBF\u88C5\u4E66\u7248\u5F0F */\n\n/*\n * \u53EF\u9009\uFF1A\u52A0\u8FB9\u6846\u4E0E\u754C\u884C\uFF0C\u63A5\u8FD1\u96D5\u7248\u7684\u7248\u6846\u3002\n * \u7528\u6CD5\uFF1A<article class=\"guji-doc guji-vertical guji-banks\">\n */\n.guji-banks {\n  --guji-frame-color: #3a3a3a;\n  --guji-frame-width: 0.6pt;\n  padding: 4mm;\n  border: calc(var(--guji-frame-width) * 3) double var(--guji-frame-color);\n}\n\n/* \u754C\u884C\uFF1A\u7528\u91CD\u590D\u7EBF\u6027\u6E10\u53D8\u753B\u51FA\u6BCF\u5217\u4E4B\u95F4\u7684\u7EC6\u7EBF */\n.guji-banks.guji-vertical {\n  background-image: repeating-linear-gradient(\n    to left,\n    transparent,\n    transparent calc(var(--guji-print-line-height, 1.85) * 1em - var(--guji-frame-width)),\n    var(--guji-frame-color) calc(var(--guji-print-line-height, 1.85) * 1em - var(--guji-frame-width)),\n    var(--guji-frame-color) calc(var(--guji-print-line-height, 1.85) * 1em)\n  );\n}\n";
+export declare const STYLE_FILES: readonly ["print.css"];
+//# sourceMappingURL=styles.generated.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"styles.generated.d.ts","sourceRoot":"","sources":["../src/styles.generated.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,QAAQ,u1EAA0qD,CAAA;AAE/rD,eAAO,MAAM,WAAW,wBAEd,CAAA"}

package/dist/styles.generated.js

@@ -0,0 +1,7 @@
+// 本文件由 scripts/build-styles.mjs 从 styles/*.css 生成，请勿手改。
+/* eslint-disable */
+export const printCss = "/*!\n * print.css — 古籍 Markdown 的分页排版样式\n * @open-guji/markdown-pdf · Apache-2.0\n *\n * 与 guji.css / guji-vertical.css 叠加使用。这里只管\"页\"的事：\n * 页面尺寸、页边距、版心、书口与分页控制。\n */\n\n@page {\n  size: var(--guji-page-size, A5);\n  margin: var(--guji-page-margin, 20mm 18mm);\n\n  @bottom-center {\n    content: counter(page);\n    font-family: var(--guji-font);\n    font-size: 9pt;\n    color: #666;\n  }\n}\n\n@page :first {\n  @bottom-center {\n    content: none;\n  }\n}\n\n.guji-doc {\n  /* 打印时抬头留白按实际字号折算，不再依赖视口 */\n  --guji-raise-unit: 1em;\n  font-size: var(--guji-print-font-size, 11pt);\n  line-height: var(--guji-print-line-height, 1.85);\n}\n\n/* 标题不落在页末 */\n.guji-doc h1,\n.guji-doc h2,\n.guji-doc h3 {\n  break-after: avoid-page;\n  break-inside: avoid;\n}\n\n/* 抬头行不被切开 */\n.guji-tt,\n.guji-tt-block {\n  break-inside: avoid;\n}\n\n/* 夹注跟随正文，不单独成页 */\n.guji-jz {\n  break-inside: avoid;\n}\n\n.guji-doc p {\n  orphans: 2;\n  widows: 2;\n}\n\n/* ------------------------------------------------------ 线装书版式 */\n\n/*\n * 可选：加边框与界行，接近雕版的版框。\n * 用法：<article class=\"guji-doc guji-vertical guji-banks\">\n */\n.guji-banks {\n  --guji-frame-color: #3a3a3a;\n  --guji-frame-width: 0.6pt;\n  padding: 4mm;\n  border: calc(var(--guji-frame-width) * 3) double var(--guji-frame-color);\n}\n\n/* 界行：用重复线性渐变画出每列之间的细线 */\n.guji-banks.guji-vertical {\n  background-image: repeating-linear-gradient(\n    to left,\n    transparent,\n    transparent calc(var(--guji-print-line-height, 1.85) * 1em - var(--guji-frame-width)),\n    var(--guji-frame-color) calc(var(--guji-print-line-height, 1.85) * 1em - var(--guji-frame-width)),\n    var(--guji-frame-color) calc(var(--guji-print-line-height, 1.85) * 1em)\n  );\n}\n";
+export const STYLE_FILES = [
+    "print.css"
+];
+//# sourceMappingURL=styles.generated.js.map

package/dist/styles.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.generated.js","sourceRoot":"","sources":["../src/styles.generated.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,oBAAoB;AAEpB,MAAM,CAAC,MAAM,QAAQ,GAAG,uqDAAuqD,CAAA;AAE/rD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,WAAW;CACH,CAAA"}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@open-guji/markdown-pdf",
+  "version": "0.1.0",
+  "description": "古籍 Markdown 的 PDF 生成器：可打印 HTML 与 Chromium 排版后端",
+  "keywords": [
+    "markdown",
+    "pdf",
+    "古籍",
+    "guji",
+    "chinese",
+    "classics",
+    "typesetting",
+    "pagedjs"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/open-guji/guji-markdown.git",
+    "directory": "packages/pdf"
+  },
+  "homepage": "https://github.com/open-guji/guji-markdown/tree/main/packages/pdf",
+  "bugs": "https://github.com/open-guji/guji-markdown/issues",
+  "type": "module",
+  "engines": {
+    "node": ">=18.18"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./styles/print.css": "./styles/print.css",
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "guji-pdf": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "styles",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@open-guji/markdown-core": "^0.1.0",
+    "@open-guji/markdown-web": "^0.1.0"
+  },
+  "peerDependencies": {
+    "pagedjs": "^0.4.3",
+    "playwright": "^1.49.0"
+  },
+  "peerDependenciesMeta": {
+    "playwright": {
+      "optional": true
+    },
+    "pagedjs": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4",
+    "@types/node": "^22.10.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build:styles": "node scripts/build-styles.mjs",
+    "build": "npm run build:styles && tsc -p tsconfig.json",
+    "typecheck": "npm run build:styles && tsc -p tsconfig.json --noEmit",
+    "test": "npm run build:styles && vitest run"
+  }
+}

package/styles/print.css

@@ -0,0 +1,80 @@
+/*!
+ * print.css — 古籍 Markdown 的分页排版样式
+ * @open-guji/markdown-pdf · Apache-2.0
+ *
+ * 与 guji.css / guji-vertical.css 叠加使用。这里只管"页"的事：
+ * 页面尺寸、页边距、版心、书口与分页控制。
+ */
+
+@page {
+  size: var(--guji-page-size, A5);
+  margin: var(--guji-page-margin, 20mm 18mm);
+
+  @bottom-center {
+    content: counter(page);
+    font-family: var(--guji-font);
+    font-size: 9pt;
+    color: #666;
+  }
+}
+
+@page :first {
+  @bottom-center {
+    content: none;
+  }
+}
+
+.guji-doc {
+  /* 打印时抬头留白按实际字号折算，不再依赖视口 */
+  --guji-raise-unit: 1em;
+  font-size: var(--guji-print-font-size, 11pt);
+  line-height: var(--guji-print-line-height, 1.85);
+}
+
+/* 标题不落在页末 */
+.guji-doc h1,
+.guji-doc h2,
+.guji-doc h3 {
+  break-after: avoid-page;
+  break-inside: avoid;
+}
+
+/* 抬头行不被切开 */
+.guji-tt,
+.guji-tt-block {
+  break-inside: avoid;
+}
+
+/* 夹注跟随正文，不单独成页 */
+.guji-jz {
+  break-inside: avoid;
+}
+
+.guji-doc p {
+  orphans: 2;
+  widows: 2;
+}
+
+/* ------------------------------------------------------ 线装书版式 */
+
+/*
+ * 可选：加边框与界行，接近雕版的版框。
+ * 用法：<article class="guji-doc guji-vertical guji-banks">
+ */
+.guji-banks {
+  --guji-frame-color: #3a3a3a;
+  --guji-frame-width: 0.6pt;
+  padding: 4mm;
+  border: calc(var(--guji-frame-width) * 3) double var(--guji-frame-color);
+}
+
+/* 界行：用重复线性渐变画出每列之间的细线 */
+.guji-banks.guji-vertical {
+  background-image: repeating-linear-gradient(
+    to left,
+    transparent,
+    transparent calc(var(--guji-print-line-height, 1.85) * 1em - var(--guji-frame-width)),
+    var(--guji-frame-color) calc(var(--guji-print-line-height, 1.85) * 1em - var(--guji-frame-width)),
+    var(--guji-frame-color) calc(var(--guji-print-line-height, 1.85) * 1em)
+  );
+}