page2pdf_server 1.1.2 → 2.0.0

package/README.md

@@ -8,7 +8,7 @@
 
 # Overview
 
-**page2pdf_server** is a `Typescript` + `Express` + `Node` starter kit to develop `REST API` server apps.
+**page2pdf_server** 文书打印转换器的引用类型定义; "repository": "https://gitee.com/heerzhang/page2pdf-server",
 Nothing new under the sun, just a straight forward combo to make server development a little bit faster. And of course, this make my freelancing days more enjoyable 😎
 Comes with:
 
@@ -47,12 +47,10 @@ chrome-remote-interface不会为您启动Chrome。本来想用chrome-remote-inte
 - [Node.js](https://nodejs.org) (`>= 20.0.0`)
 - [Yarn](https://yarnpkg.com/en/docs/install) or [NPM](https://docs.npmjs.com/getting-started/installing-node)
 - 客户电脑必须有Chrome浏览器；
-- 要点击谷歌浏览器的链接，要配置端口号，启动命令设置：目标修改： C:\Users\herzhang\AppData\Local\Google\Chrome\Application\chrome.exe --remote-debugging-port=9872
- 比如： "C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9872
 - 之后服务期间，需要首先就该点击该链接开启Chrome浏览器。
 - 特别注意：windows用户若非管理员账户的：桌面上的Chrome快捷方式右键点属性在“兼容性”设置中：必须勾选“管理员身份运行”；
  注意浏览器的管理员和普通身份运行的效果进入显示都不同的。目标URL网站需要登陆处理的，登陆点击后浏览器没有反馈，需直接关闭该TAB页面。
--报错Error: connect ECONNREFUSED 127.0.0.1:9872 【解决】先在windows任务管理器把chrome.exe的进程全部关闭后重来。
+
 ## Install
 
 - Fork or Use [this](https://github.com/filoscoder/tenstack-starter/generate) template repository.
@@ -76,7 +74,7 @@ chrome-remote-interface不会为您启动Chrome。本来想用chrome-remote-inte
 <br>
 
 ## Config
-
+  具体API用法， 参考见../server 也即page2pdf_server_run服务器的包。
 - Copy `.env.example` a file at the root of the application.
 - Add or modify specific variables and update it according to your need.
 
@@ -273,3 +271,6 @@ If you have any question or suggestion, don't hesitate to contact me:
   如上代码会有严重毛病：打印输出实际上只有一次机会render；useMeasure(ref还是空的)div宽度=0导致实际只有输出一列的布局，打印没机会修正了，屏幕情况可以不限次数render，
   可是打印就不行了，上面这情况太特殊了。
 
+# 发布更新
+  工具包需要发布，工程目录：page2pdf-server/packages/types 执行 npm publish 发布到npm
+  

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "page2pdf_server",
-  "version": "1.1.2",
-  "description": "文书打印转换器",
+  "version": "2.0.0",
+  "description": "文书打印转换器的引用类型",
   "private": false,
   "authors": "herzhang",
   "repository": "https://gitee.com/heerzhang/page2pdf-server",
@@ -9,34 +9,7 @@
   "main": "./dist/index.js",
   "types": "./dist/types.d.ts",
   "scripts": {
-    "yarn": "yarn",
-    "yarn命令行": "yarn add nodemon -D",
-    "注意2": "运行prettify来修复代码，免去到处是标记红色的，太严格了",
-    "prettify": "prettier --write \"src/**/*.{ts,js,json}\" \"src/__tests__/**/*.{ts,js,json}\"",
-    "start": "NODE_ENV=development run-s prettify lint & nodemon",
-    "build": "rimraf dist && tsc && rimraf dist/types && ncp src/types.d.ts dist/types",
-    "手动管理 .d.ts 文件的完整流程": "确保以下路径存源文件：src/types.d.ts 目标目录：dist/types/",
-    "build3": "rimraf dist && tsc --emitDeclarationOnly && dts-bundle --name 'types' --main dist/types/index.d.ts --out 'dist/types.d.ts'",
-    "build2": "rimraf dist && tsc --emitDeclarationOnly && ncp src/types.d.ts dist/types",
-    "build1": "cross-env NODE_ENV=production run-s prettify clean transpile",
-    "lint": "eslint 'src/**/*.{ts,js}' 'src/__tests__/**/*.{ts,js}'",
-    "lint:fix": "eslint --fix 'src/**/*.{ts,js}' 'src/__tests__/**/*.{ts,js}' --quiet",
-    "有些隐藏错误": "需要运行watch才发现",
-    "watch": "tsc --watch",
-    "clean": "rimraf dist",
-    "test": "cross-env NODE_ENV=test jest --coverage --runInBand --detectOpenHandles",
-    "单步调试": "不必运行test，直接到__test__目录文件直接挑选修改测试项并调试",
-    "test:watchAll": "cross-env NODE_ENV=test jest --watchAll --runInBand --detectOpenHandles",
-    "transpile": "tsc",
-    "service:start": "pm2 start ecosystem.config.js",
-    "service:reload": "pm2 reload ecosystem.config.js",
-    "service:startup": "pm2 startup",
-    "service:stop": "pm2 stop ecosystem.config.js",
-    "service:list": "pm2 list ecosystem.config.js",
-    "service:delete": "pm2 delete ecosystem.config.js",
-    "service:logs": "pm2 logs",
-    "hook主动运行": "操作系统缘故，将单引号改成双引号，加转义符，提交代码会自动执行;git提交给它勾掉吧,yarn会自动运行prepare",
-    "安装生产依赖在服务器上执行": "工程npm prune --production 然后目标机npm ci --only=production"
+    "build": "rimraf dist && tsc && rimraf dist/types && ncp src/types.d.ts dist/types"
   },
   "keywords": [
     "dynamic page pdf generator",
@@ -49,62 +22,24 @@
     "server"
   ],
   "dependencies": {
-    "@types/bcrypt": "^5.0.0",
-    "@types/cors": "^2.8.13",
-    "@types/express-pino-logger": "^4.0.3",
-    "@types/jsonwebtoken": "^9.0.2",
-    "chrome-remote-interface": "^0.33.3",
-    "config": "^3.3.9",
-    "connect-timeout": "^1.9.0",
-    "cors": "^2.8.5",
-    "cross-env": "^7.0.3",
-    "dotenv": "^16.3.1",
-    "express": "^4.18.2",
-    "express-pino-logger": "^7.0.0",
-    "express-validator": "^7.0.1",
-    "helmet": "^7.0.0",
-    "http-status": "^1.6.2",
-    "jsonwebtoken": "^9.0.0",
-    "lodash-es": "^4.17.21",
-    "morgan": "^1.10.0",
-    "pdf-lib": "^1.17.1",
-    "pino-http": "^8.3.3",
-    "pino-pretty": "^10.0.0",
-    "rimraf": "^6.0.1",
-    "save-dev": "^0.0.1-security"
   },
   "devDependencies": {
     "@babel/preset-env": "^7.22.5",
     "@babel/preset-typescript": "^7.22.5",
-    "@types/connect-timeout": "^0.0.37",
-    "@types/express": "^4.17.22",
-    "@types/jest": "^29.5.2",
     "@types/lodash-es": "^4.17.7",
-    "@types/morgan": "^1.9.4",
     "@types/node": "^22.15.21",
     "@types/supertest": "^2.0.12",
     "@typescript-eslint/eslint-plugin": "^5.59.11",
     "@typescript-eslint/parser": "^5.59.11",
-    "dts-bundle": "^0.7.3",
     "eslint": "^8.43.0",
     "eslint-config-prettier": "^8.8.0",
     "eslint-plugin-import": "^2.27.5",
     "eslint-plugin-prettier": "^4.2.1",
-    "husky": "^8.0.3",
-    "jest": "^29.5.0",
-    "jest-watch-typeahead": "^2.2.2",
-    "ncp": "^2.0.0",
-    "nodemon": "^3.0.1",
-    "npm-run-all": "^4.1.5",
-    "pm2": "^5.3.0",
-    "prettier": "^2.8.8",
-    "supertest": "^6.3.3",
-    "ts-jest": "^29.1.0",
     "ts-node": "^10.9.1",
-    "tsconfig-paths": "^4.2.0",
+    "ncp": "^2.0.0",
     "typescript": "^5.8.3"
   },
   "engines": {
-    "node": ">= 20.0.0"
+    "node": ">= 24.0.0"
   }
 }

package/src/index.ts

@@ -1,18 +1,10 @@
-// ! Don't convert require into import
-// eslint-disable-next-line @typescript-eslint/no-var-requires
-//去掉这个了    离开开发环境无法 独立运行服务端，报错module-alias找不到
-//去掉这个了   require("module-alias").addAlias("@", __dirname);
-//去掉这个了
-
-import { createApp } from "./app";
-import { startServer } from "./server";
-
-if (process.env.NODE_ENV !== "test") {
-  const app = createApp();
-  startServer(app);
-}
-
-//关键文档Chrome DevTools Protocol资料， https://chromedevtools.github.io/devtools-protocol/tot/Page
-export * from "./types/request/config";
-export { FileTransform } from "./types";
-export { ConfigRoot } from "./types";
+// ! Don't convert require into import
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+//去掉这个了    离开开发环境无法 独立运行服务端，报错module-alias找不到
+//去掉这个了   require("module-alias").addAlias("@", __dirname);
+
+
+export * from "./types";
+// export { FileTransform } from "./types";
+// export { ConfigRoot } from "./types";
+// export { MyPaperSize } from "./types/request/config";

package/src/types.d.ts

@@ -1,97 +1,161 @@
-import { HeadFooter, PartHeadFooter } from "@/types/request/config";
-
-/**一次作业的模型配置；
- * 若本对象为空{}的话：默认是按照修改时间的顺序简易模式地合并当前工作目录的所有pdf文件。
- * 若某个URL不正常的，很可能无法触发页面加载完成，导致作业一致无法继续下去，大大超出预期执行时间。URL对应网页若不是一次性加载完成还会陆陆续续修改内容的就是这种情况造成死等长时间没结果。
- * */
-export interface ConfigRoot<T> {
-  //是否生成合并的pdf：正常情况下， 默认=true进行files输出pdf全部做合并的。 除非files[]也是空的情形。
-  //但若需对任一个URL叠加新页眉页脚的，merge就不能=false的。
-  merge?: boolean;
-  //重定义 合并的pdf文件名, 否则默认名。不需要加 .pdf结尾的
-  name: string;
-  //双面打印的合并输出pdf， 默认=true, 表示合并输出的pdf考虑到双面打印的页眉页脚的布局差异化情况了。
-  doubleSide?: boolean;
-  //统一一整份应该用的页眉页脚
-  //假如files[]里面有些url自己也定义了lay{localSumNo=false}的页眉页脚输出配置，只能忽略掉它们，页码总数不算他们的，页码连续编号也不算它们的占坑:最好都挪到最后面。
-  lay?: HeadFooter;
-  //每一个独立的pdf生成：
-  files: [T];
-
-  //共用一个浏览器窗口 默认=true
-  singleTab?: boolean;
-  //自动关闭浏览器窗口 默认=false
-  closeTab?: boolean;
-
-  //下面这5个参数不是前端配置发送过来的，而是lay{}对象预先进行转换后保存的汇总页眉页脚，只能内部使用，并非外部接口参数！Page.printToPDF需要的。
-  headerTemplate?: string;
-  footerTemplate?: string;
-  headerTemplateL?: string;
-  footerTemplateL?: string;
-  //第二阶段页眉页脚生成的浏览器执行窗口的targetId,不可配置。
-  CDPtab?: string;
-}
-
-// types.d.ts
-/**等待输出的每个独立文件:URL，这些文件可能要合并。
- * @前提条件 是：每个url独立文件生成的PDF，它的纸张大小必须保证同一个大小尺寸， size: 必须唯一，但是纸张方向在某些约束条件中可以横屏竖屏混合的。
- * 物理打印机：纸张适配，横竖方向还好能自动调节，size 真实打印纸张尺寸就不好自动处理, 不一样的尺寸?最好拆解pdf。
- * 标准纸张大小的：静态html内CSS定义横竖纸张方向混合的：用reverseRanges参数设置部分纸张反转纸张方向，pageRanges=''的前提下：配置比如'1-5, 8, 11-13'和landscape参数设置相反方向。
- * */
-export interface FileTransform {
-  //[必须配置的] 特殊的前缀是 http:// https:// 没有这俩个的都是本地工作目录的文件全名(含文件类型后缀 *.pdf *.*)。
-  //任意的本地文件类型，只要可以被Chrome装载并能够支持打印预览的都可以。http打头的网页必须确保已经登录了，也就是遗留cockies token,不能要求交互登录。本地文件不能要求输入口令。
-  //不支持*.xls *.doc文件；不支持的格式实际在浏览器拖拽窗口后会蜕变成了下载形式的。被加密的文件必须提前解密,网站登录需提前解决。
-  //【特殊问题】若URL网页动态化太离谱，周期性地不间断地更新页面,没法触发加载结束事件的，只能手动在浏览器查看打印另存pdf，然后把手动生成pdf合并进来。Tab切换会主动刷新的也不触发。
-  url: string;
-  //输出本地工作目录的文件名， 不需要加 .pdf结尾的 【注意】如果out为空表示url是pdf的没必要转换的要直接进入合并步骤。
-  //【特别】必须配置唯一性 的本地 工作目录的文件名，同名的被直接覆盖了。
-  out: string;
-
-  //是否汇总合并阶段省略本url，不合并进去，那就是单独独立的pdf输出了。默认=true是合并进去。 和是否打印页眉页脚或页眉统计页数没有绝对关系的。
-  merge?: boolean;
-
-  //默认取值都是=true; 第一阶段不会生成页眉页脚的，汇总第二阶段这个参数才会生效！
-  //这里配置displayHeaderFooter优先级最高。
-  //页眉页脚如何分开控制是否打印的： 可以把lay{head，foot}其中一个配置串给设置为null,null就代表不输出。例如head=null就不输出页眉，但是页脚照旧打印的。本url的配置优先于汇总pdf配置。
-  //若ConfigRoot<T>.merge=false那么必然导致FileTransform.merge强制=false，每个独立pdf页码独立的独立都从1开始编号吗还需要打印吗，页眉页脚需要打印吗？这个情况页眉页脚打印的默认值改成false;
-  displayHeaderFooter: boolean;
-
-  //【特别注意】frNo 可能和 headFrom 配置矛盾。
-  //本url打印：从第几页才开始页眉页脚的打印，#页码同样也是在这之后才可能计数和编号!。默认值headFrom=1：就是第一页就开始打印页眉页脚的。
-  //书本封面页情况的。这个参数有最高优先级。 【注意】和frNo设置相互影响, 没有页眉页脚就失去页码意义了。若真的违反了可能页码不能连续输出的，被隐藏了页码缘故。
-  headFrom?: number;
-  //本url打印后，从本URL输出的第几页开始才进行的页码序号的顺序输出的，前面几页不打印页码(但是页眉页脚要打印)。默认值=1全部都打页码。若frNo=0全部不打页码的。
-  //假如displayHeaderFooter=false也即页码无法显示出来的情况：请申明frNo=0; 不然默认是连续页码的，不打印的也有占用页码的隐藏的连续数字啊。
-  //注意若有配置 headFrom 的要协调好。
-  frNo?: number;
-
-  //是否对页码支持连续编号：  Continuous numbering 是跟随汇总合并的页码 基数合计。【注意】本配置单个url范围，单个url不能混合本地页码和全局页面两种！
-  //统计页数是否本URL独立自己范围之内进行的汇总计数。比如书本目录有多页的可以独立统计页码序号以及总页数的。默认=false;
-  localSumNo?: boolean;
-  //本url对应的部分应该用的页眉页脚，覆盖掉合并pdf的相对应设置。页面上只能支持输出一次页眉页脚，不重叠做输出。
-  //若lay{localSumNo=false}只能固定支持本url自己内部的页码统计顺序编号，不考虑合并pdf总页数带来的影响的。 还是？预设其它部分的页数统计总数之后？再做偏移页码编写？
-  lay: PartHeadFooter;
-  //前端声明本url在第一阶段打印输出后，生成的pdf应该有几页。 count没有设置的救不会做异常检查的。不是第二阶段的计数：双面情况可能增加空白页
-  count?: number;
-  //双面打印的 默认=true, 表示独立分开输出的pdf文件的：考虑到双面打印的页眉页脚的布局差异化情况了。
-  //合并输出merge=true的情况：该参数无效，要看汇总配置的哪一个 # ConfigRoot<T>{ doubleSide： }字段。
-  doubleSide: boolean;
-  //双面打印的情形：必须确保本URL的第一个页是正好右手边(书本翻页的奇数号页码)开始的位置页。正常第一个URL首页面就是双面打印的右手边位置页；默认值=false不必确保.
-  rightHand: boolean;
-
-  //页码是罗马数字；论文目录需要的；默认=false阿拉伯数字。"I","II","III","IV","V","VI","VII","VIII","IX" "X"XI"XII"表盘符号
-  //roman只能针对本URL启用；数字转换范围最大支持1到12，超过了便改阿拉伯数字，且只针对pageNumber有效, totalPages不会采用。
-  roman?: boolean;
-
-  //下面这5个参数不是前端配置发送过来的，而是lay{}对象预先进行转换后保存的汇总页眉页脚，只能内部使用，并非外部接口参数！Page.printToPDF需要的。
-  headerTemplate?: string;
-  footerTemplate?: string;
-  headerTemplateL?: string;
-  footerTemplateL?: string;
-  //这针对：可能由于动态布局导致的浏览器打印预览和实际URL纯粹js网页动态布局的真实内容页数不一致的毛病。
-  //开启的浏览器窗口宽度。默认最大化的。
-  brwidth?: number;
-  //第一阶段Url转pdf的浏览器执行窗口的targetId,不可配置。
-  CDPtab?: string;
-}
+/**一次作业的模型配置；
+ * 若本对象为空{}的话：默认是按照修改时间的顺序简易模式地合并当前工作目录的所有pdf文件。
+ * 若某个URL不正常的，很可能无法触发页面加载完成，导致作业一致无法继续下去，大大超出预期执行时间。URL对应网页若不是一次性加载完成还会陆陆续续修改内容的就是这种情况造成死等长时间没结果。
+ * */
+export interface ConfigRoot<T> {
+  //是否生成合并的pdf：正常情况下， 默认=true进行files输出pdf全部做合并的。
+  //若merge=false的 页码只能跟读单独编号。
+  merge?: boolean;
+  //重定义 合并的pdf文件名, 否则默认名。不需要加 .pdf结尾的
+  //若merge=false的,name没用到。
+  name: string;
+  //双面打印的合并输出pdf， 默认都=true, 表示合并输出的pdf考虑到双面打印的页眉页脚的布局差异化情况了。
+  doubleSide?: boolean;
+  //统一一整份应该用的页眉页脚
+  //假如files[]里面有些url自己也定义了lay{localSumNo=false}的页眉页脚输出配置，只能忽略掉它们，页码总数不算他们的，页码连续编号也不算它们的占坑:最好都挪到最后面。
+  lay?: HeadFooter;
+  //每一个独立的pdf生成：
+  files: T[];
+
+  //下面这5个参数不是前端配置发送过来的，而是lay{}对象预先进行转换后保存的汇总页眉页脚，只能内部使用，并非外部接口参数！Page.printToPDF需要的。
+  headerTemplate?: string;
+  footerTemplate?: string;
+  //最后来个压缩 默认=true
+  compress?: boolean;
+  hHeight?: number; //清空页眉页脚 页眉高度 (points, 30mm ≈ 85 points)默认10mm
+  fHeight?: number; //默认==hHeight 清空页脚高度
+  //页码区域的模板关联名字 默认=default
+  tmpl?: string;
+  //页码区域的字体大小
+  fontsz?: number;
+  //web加载完毕的标志性选择子 默认=".print-section"
+  selector?: string;
+}
+
+/**等待输出的每个独立文件:URL，这些文件可能要合并。
+ * @前提条件 是：每个url独立文件生成的PDF，它的纸张大小必须保证同一个大小尺寸， size: 必须唯一，但是纸张方向在某些约束条件中可以横屏竖屏混合的。
+ * 物理打印机：纸张适配，横竖方向还好能自动调节，size 真实打印纸张尺寸就不好自动处理, 不一样的尺寸?最好拆解pdf。
+ * 标准纸张大小的：静态html内CSS定义横竖纸张方向混合的：用reverseRanges参数设置部分纸张反转纸张方向，pageRanges=''的前提下：配置比如'1-5, 8, 11-13'和landscape参数设置相反方向。
+ * */
+export interface FileTransform {
+  //[必须配置的] 特殊的前缀是 http:// https:// 没有这俩个的都是本地工作目录的文件全名(含文件类型后缀 *.pdf *.*)。
+  //任意的本地文件类型，只要可以被Chrome装载并能够支持打印预览的都可以。http打头的网页必须确保已经登录了，也就是遗留cockies token,不能要求交互登录。本地文件不能要求输入口令。
+  //不支持*.xls *.doc文件；不支持的格式实际在浏览器拖拽窗口后会蜕变成了下载形式的。被加密的文件必须提前解密,网站登录需提前解决。
+  //【特殊问题】若URL网页动态化太离谱，周期性地不间断地更新页面,没法触发加载结束事件的，只能手动在浏览器查看打印另存pdf，然后把手动生成pdf合并进来。Tab切换会主动刷新的也不触发。
+  url: string;
+  //源url的类型： 默认=web网页的, | pdf本地文件 | linkPdf 链接pdf文件。第一阶段的页眉页脚生成仅仅针对web资源才能生效的。
+  type?: "web" |"pdf" |"linkPdf";
+  //输出本地工作目录的文件名， 不需要加 .pdf结尾的 【注意】如果out为空意味着url字段的文件原本已经是pdf的情况所以没必要转换的要直接进入合并步骤。
+  //【特别】必须配置唯一性 的本地 工作目录的文件名，同名的被直接覆盖了。
+  out?: string;
+  //抽取原始的页码范围；"1-2,5,8-end" 格式示例
+  range?: string;
+  //默认取值都是=true; 第一阶段不会生成页眉页脚的，汇总第二阶段这个参数才会生效！
+  //这里配置displayHeaderFooter优先级最高。
+  //页眉页脚如何分开控制是否打印的： 可以把lay{head，foot}其中一个配置串给设置为null,null就代表不输出。例如head=null就不输出页眉，但是页脚照旧打印的。本url的配置优先于汇总pdf配置。
+  //若ConfigRoot<T>.merge=false那么必然导致FileTransform.merge强制=false，每个独立pdf页码独立的独立都从1开始编号吗还需要打印吗，页眉页脚需要打印吗？这个情况页眉页脚打印的默认值改成false;
+  displayHeaderFooter: boolean;
+  //是否对页码支持连续编号：  Continuous numbering 是跟随汇总合并的页码 基数合计。【注意】本配置单个url范围，单个url不能混合本地页码和全局页面两种！
+  //【特例】统计页数是否本URL独立自己范围之内进行的汇总计数。比如书本目录有多页的可以独立统计序言部分的页码总数以及后面书本正文的页数统计的。默认=false;
+  localSumNo?: boolean;
+  //本url页抽取完成以后，清除掉页眉页脚的页范围；"1-2,5,8-end"，#页码同样也是在这之后才可能计数和编号!。
+  //默认值headFrom=1：就是第一页就开始打印页眉页脚的。【特别注意】frNo 可能和 headFrom 配置矛盾。
+  //书本封面页情况的。这个参数有最高优先级。 【注意】和frNo设置相互影响, 没有页眉页脚就失去页码意义了。若真的违反了可能页码不能连续输出的，被隐藏了页码缘故。
+  cRange?: string;
+  //默认值=undefined:=全部都打页码。
+  //若frNo=0全部不打页码的。若displayHeaderFooter=false也即页码无法显示出来的情况：请申明frNo=0; 不然默认是连续页码的，不打印的也有占用页码的隐藏的连续数字啊。
+  //注意若有配置 headRange 的要协调好。
+  frNo?: number;
+
+  //是否汇总合并阶段省略本url，不合并进去，那就是单独独立的pdf输出了。默认=true是合并进去。 和是否打印页眉页脚或页眉统计页数没有绝对关系的。
+  merge?: boolean;
+
+  //本url对应的部分应该用的页眉页脚，覆盖掉合并pdf的相对应设置。页面上只能支持输出一次页眉页脚，不重叠做输出。
+  //若lay{localSumNo=false}只能固定支持本url自己内部的页码统计顺序编号，不考虑合并pdf总页数带来的影响的。 还是？预设其它部分的页数统计总数之后？再做偏移页码编写？
+  lay?: PartHeadFooter;
+
+  //双面打印的 默认=false, 表示独立分开输出的pdf文件的：考虑到双面打印的页眉页脚的# 章节的空白页，可能的需求开始位置必须在右手边位置。
+  //合并输出merge=true的情况：该参数无效，要看汇总配置的哪一个 # ConfigRoot<T>{ doubleSide： }字段的取值。
+  doubleSide: boolean;
+  //双面打印的情形：指明必须确保本URL的第一个页是正好右手边(书本翻页的奇数号页码)开始的位置页。正常第一个URL首页面就是双面打印的右手边位置页；默认值=false不必确保.
+  rightHand: boolean;
+
+  //页码是罗马数字；论文目录需要的；默认=false阿拉伯数字。"I","II","III","IV","V","VI","VII","VIII","IX" "X"XI"XII"表盘符号
+  //roman只能针对本URL启用；数字转换范围最大支持1到12，超过了便改阿拉伯数字，且只针对pageNumber有效, totalPages不会采用。
+  roman?: boolean;
+  //下面这5个参数不是前端配置发送过来的，而是lay{}对象预先进行转换后保存的汇总页眉页脚，只能内部使用，并非外部接口参数！Page.printToPDF需要的。
+  headerTemplate?: string;
+  footerTemplate?: string;
+  hHeight?: number; //清空页眉页脚 页眉高度 (points, 30mm ≈ 85 points)默认10mm
+  fHeight?: number; //默认==hHeight 清空页脚高度
+  tmpl?: string;
+  fontsz?: number;
+  //web情况的，加载完毕的标志性选择子 默认=".print-section"
+  selector?: string;
+  //有些情况需要清除掉旧的页码内容
+  clearNum?: boolean;
+  clearWidth?: number;    //覆盖页码区域的空间宽度
+}
+
+/**页眉页脚声明；前提条件是页眉页脚htm描述里面： 上一个版本保留字 ${pageNumber} ${totalPages}
+ * 不应该把 -NOT_DISPLAY-  ~pageNumber~  ~totalPages~  这三个 保留字字符串当作普通文字输出的。
+ * 前端发送数据包时刻，页眉页脚的脚本需要在 HTML转JSON 工具网站 进行转换处理后的；网站地址  https://uutool.cn/html2json/ 转换htm模板后是数组[string]
+ * 实际上也就进行拆分多行字符串拼接数组，还有把html语法中的 ""引号 进行转义 style="position: 变成 style=\\\"position: 处置的。
+ * */
+export interface HeadFooter {
+  //每一个URL独立设置的 页眉 的 : 若是配置值=null  表示不要打印本页眉: 针对本url。
+  head?: string | string[] | null;
+  //每一个页 页脚的
+  //每一个URL独立设置的 页脚的 : 若是配置值=null  表示不要打印本页脚的， 针对本url。
+  foot?: string | string[] | null; //实际前端发过来却是[string]的也可以啊。
+  //双面打印：不再区分页眉页脚样式了
+}
+
+//来自pupeeter用的浏览器接口：
+export declare interface PDFMargin {
+  top?: string | number;
+  bottom?: string | number;
+  left?: string | number;
+  right?: string | number;
+}
+/**实际在第二步骤也即汇总阶段：页眉页脚的生成底下的参数size，landscape，reverseRanges,marginLeft,marginRight几个都不会涉及到了。
+ * */
+export interface PartHeadFooter extends HeadFooter {
+  //背景， 默认 =false
+  printBackground?: boolean;
+  margin?: PDFMargin;
+  //默认全部打印的，#可自定义部分页面输出的。 Paper ranges to print, one based, e.g., '1-5, 8, 11-13'.
+  pageRanges?: string;
+}
+
+/**配置自定义的页脚内页码区域使用的字体子集化的文件。 母字体是系统固定的文件名。
+ * */
+export interface MyFontSubset {
+  //唯一标识名称；  默认都配一个:"default"
+  name: string;
+  //所有的文字，数字也要的
+  text?: string;
+  //字体需存储于那一个文件中。
+  file?: string;
+}
+
+//测试
+export interface SizeMinimize {
+  name: string;
+  range?: string;
+  file?: string;
+}
+
+/**配置页码区域 打印模样。
+ * pagenum 页码  pagesums 总的页数
+ * */
+export interface PageNoTempl {
+  //标识名称
+  name: string;
+  //模板：必须有 pagenum 页码, 但是 pagesums 可省略的。
+  tmpl: string;
+  //使用字体的名字。
+  font: string;
+  //偏移 正负的
+  ofswd: number;
+}

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,28 +0,0 @@
----
-name: Bug report
-about: Create a report to help us improve
-title: ""
-labels: "bug"
-assignees: ""
----
-
-# Description
-
-_A clear and concise description of what the bug is._
-
-# Reproduction
-
-_Steps to reproduce the behavior:_
-
-_1. Go to '...'_
-_2. Click on '....'_
-_3. Scroll down to '....'_
-_4. See error_
-
-# Expected
-
-_A clear and concise description of what you expected to happen._
-
-# Screenshots
-
-_If applicable, add screenshots to help explain your problem._

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,15 +0,0 @@
----
-name: Feature request
-about: Suggest an idea for this project
-title: ""
-labels: "implementation"
-assignees: ""
----
-
-# Request
-
-_A clear and concise description of what the problem is._
-
-# Suggestion
-
-_A clear and concise description of what you want to happen._

package/.github/ISSUE_TEMPLATE/refactoring.md

@@ -1,15 +0,0 @@
----
-name: Refactoring
-about: Add content to be refactored
-title: ""
-labels: "refactoring"
-assignees: ""
----
-
-# Refactor description
-
-_A clear and concise description of the related Content._
-
-# Refactor suggestion
-
-_A clear and concise description of any alternative solutions or features you've considered._

package/.github/PULL_REQUEST_TEMPLATE.md

@@ -1,18 +0,0 @@
-# Description
-
-_Explain briefly about the purpose & context of this PR_
-
-# Screenshots
-
-_If possible add a screenshot and/or gif_
-
-# Example | Usage
-
-_Please share examples and how to reproduce_
-
----
-
-# Related Issues | Pr
-
-_`close`|`resolve` <ISSUE> (ex. `resolve #20`)_
-_link issues to close automatically_

package/.github/stale.yml

@@ -1,17 +0,0 @@
-# Number of days of inactivity before an issue becomes stale
-daysUntilStale: 100
-# Number of days of inactivity before a stale issue is closed
-daysUntilClose: 7
-# Issues with these labels will never be considered stale
-exemptLabels:
-  - pinned
-  - security
-# Label to use when marking an issue as stale
-staleLabel: wontfix
-# Comment to post when marking an issue as stale. Set to `false` to disable
-markComment: >
-  This issue has been automatically marked as stale because it has not had
-  recent activity. It will be closed if no further activity occurs. Thank you
-  for your contributions.
-# Comment to post when closing a stale issue. Set to `false` to disable
-closeComment: false

package/.github/workflows/cd.yml

@@ -1,75 +0,0 @@
-name: CD
-
-on: 
-  push:
-    branches: [ main, develop ]
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v2.3.4
-
-      - name: Set up Node.js
-        uses: actions/setup-node@v2.4.1
-        with:
-          node-version: 16
-
-      - name: Install Dependencies
-        run: yarn
-
-      - name: Run Lint
-        run: yarn lint
-      
-      - name: Build module
-        run: yarn build
-
-      - name: Run Test code
-        run: yarn test
-
-# ↓↓↓↓ Please edit below according your environment ↓↓↓↓
-  # deploy:
-  #   runs-on: ubuntu-latest
-  #   needs: test
-  #   steps:
-  #     - name: Checkout repository
-  #       uses: actions/checkout@v2.3.4
-
-  #     - name: Deploy DEVELOPMENT
-  #       uses: appleboy/ssh-action@v0.1.4
-  #       if: github.ref == 'refs/heads/develop'
-  #       with:
-  #         key: ${{ secrets.DEV_PEM_KEY }}
-  #         host: ${{ secrets.DEV_HOST }}
-  #         username: ubuntu
-  #         script: |
-  #           cd /home/ubuntu/source
-  #           git checkout develop
-  #           git fetch --all
-  #           git reset --hard origin/develop
-  #           git pull origin develop
-  #           yarn
-  #           yarn build
-  #           export NODE_ENV=development && pm2 startOrReload ecosystem.config.js
-  #           pm2 set pm2:autodump true
-  #           pm2 save
-
-  #     - name: Deploy PRODUCTION
-  #       uses: appleboy/ssh-action@v0.1.4
-  #       if: github.ref == 'refs/heads/main'
-  #       with:
-  #         key: ${{ secrets.PROD_PEM_KEY }}
-  #         host: ${{ secrets.PROD_HOST }}
-  #         username: ubuntu
-  #         script: |
-  #           cd /home/ubuntu/source
-  #           git checkout main
-  #           git fetch --all
-  #           git reset --hard origin/main
-  #           git pull origin main
-  #           yarn
-  #           yarn build
-  #           export NODE_ENV=production && pm2 startOrReload ecosystem.config.js
-  #           pm2 set pm2:autodump true
-  #           pm2 save