vg-print 1.0.232 → 1.0.302

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2021 CcSimple
+Copyright (c) 2021 gmcSimple
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -155,7 +155,7 @@ const onSave = ({ template, data, templateId }) => {
 
 本库导出 `hiprint`，可直接创建与操作模板对象（`hiprint.PrintTemplate`）：
 
-```js
+```
 import { hiprint, defaultElementTypeProvider } from 'vg-print'
 // 全局配置
 hiprint.setConfig({ showAdsorbLine: true, showPosition: true, showSizeBox: true })
@@ -177,6 +177,90 @@ tpl.toPdf({ name: '示例' }, '打印预览pdf', { paperWidth: 210, paperHeight:
 tpl.toImage({ name: '示例' }, { isDownload: true, name: '图片', limit: 1, type: 'image/jpeg', pixelRatio: 2 })
 ```
 
+在任何场景（完整设计器、轻量 API、直接 `new`）只要在应用初始化阶段先调用这行注册，默认水印就会自动移除。
+
+### 授权密钥（authKey）与默认水印
+
+- 行为说明：
+  - 未配置`authKey`时，库会为每个模板默认注入水印：`{ content: 'vg-print', timestamp: true }`。
+  - 配置了`authKey`时，库不再注入默认水印；如需自定义，可自行传入`watermarkOptions`。
+  - 适用于所有入口：完整设计器组件、直接`new hiprint.PrintTemplate(...)`、以及轻量运行时 API（`createTemplate`）。
+
+- 全局注册授权密钥：
+
+```js
+import { hiprint } from 'vg-print'
+
+// 注册授权 key（建议在应用启动时调用）
+hiprint.register({ authKey: 'YOUR_AUTH_KEY' })
+
+// 有授权 key → 默认水印移除
+const tpl = new hiprint.PrintTemplate({ template: {} })
+```
+
+- 加密用法（可选）：
+
+  - Base64 轻度加密（无需 AES 参数；库端自动 Base64 解码）：
+
+  ```js
+  import { hiprint } from 'vg-print'
+
+  await hiprint.register({ authKey: '你的key' })
+  // 解密成功 → 默认水印移除
+  ```
+
+- 轻量运行时 API 使用授权：
+
+```js
+import { hiprint, createTemplate, printBrowser } from 'vg-print'
+
+hiprint.register({ authKey: 'YOUR_AUTH_KEY' })
+const tpl = createTemplate(tmplJson) // 不再自动注入默认水印
+printBrowser(tpl, data)
+```
+
+- 自定义或显式控制水印：
+
+```js
+// 无授权时，库会注入默认水印；如需自定义水印样式/内容
+const tpl = new hiprint.PrintTemplate({
+  template: {},
+  watermarkOptions: { content: 'your-brand', timestamp: true, rotate: 20 }
+})
+
+// 有授权时，库不会注入默认水印；若仍需水印，请显式传入
+const tpl2 = createTemplate(tmplJson, {
+  watermarkOptions: { content: 'your-brand', timestamp: true }
+})
+
+// 注意：若想在无授权时也不显示默认水印，可显式传入空对象
+const tpl3 = new hiprint.PrintTemplate({ template: {}, watermarkOptions: {} })
+```
+
+- 插件注册（可选）：
+
+```js
+import { hiprint } from 'vg-print'
+
+// 两种形式的插件均支持
+function pluginFn(h) { /* 扩展逻辑 */ }
+const pluginObj = { install(h) { /* 扩展逻辑 */ } }
+
+hiprint.register({
+  authKey: 'YOUR_AUTH_KEY',
+  plugins: [pluginFn, pluginObj]
+})
+```
+
+默认水印参数参考：
+
+```js
+{ content: 'vg-print', timestamp: true }
+}
+
+ 
+
+
 ## 轻量运行时 API（无需设计器 UI）
 
 当你只想“拿模板 + 数据”直接做预览、浏览器打印、导出 PDF/图片或进行客户端直连打印，而不引入页面设计器时，使用以下 API：