feat(all): 新增工具

This commit is contained in:
2026-05-28 11:30:35 +08:00
parent 5dbedcaf0f
commit 3a55edfafc
85 changed files with 2902 additions and 2591 deletions
+7
View File
@@ -0,0 +1,7 @@
# @r-utils/common
## 1.4.0
### Minor Changes
- 添加工具
+184
View File
@@ -0,0 +1,184 @@
# @r-utils/common
与框架无关的通用 JS/TS 工具库,适用于任意前端项目,也可在具备对应运行时 API 的环境中使用。
## 特性
- 不依赖 Vue、uni-app 或 uview-plus。
- 支持 ESM / CJS 双格式产物。
- 支持根入口导入和子路径按需导入。
- 标记 `sideEffects: false`,方便业务打包器进行 tree-shaking。
## 安装
```bash
pnpm add @r-utils/common
```
## 导入方式
### 推荐:根入口导入
大多数场景推荐从根入口导入,使用心智负担更低,现代打包器仍可结合 ESM 和 `sideEffects: false` 做 tree-shaking。
```ts
import {
Permission,
wait,
Countdown,
TimeoutTimer,
getValueOfRule,
} from "@r-utils/common";
```
### 兼容:子路径按需导入
如果你希望导入路径更精确,也可以使用子路径导入。两种方式都支持,按团队习惯选择即可。
```ts
import { Permission } from "@r-utils/common/permission";
import { wait } from "@r-utils/common/time";
import { Countdown, TimeoutTimer } from "@r-utils/common/timer";
import { getValueOfRule } from "@r-utils/common/input-rule";
```
## 导出模块
| 子路径 | 说明 |
| --- | --- |
| `@r-utils/common/permission` | 权限字符串格式校验 |
| `@r-utils/common/time` | 时间相关工具 |
| `@r-utils/common/timer` | 倒计时、超时计时器 |
| `@r-utils/common/input-rule` | 输入值规则处理 |
| `@r-utils/common/knock-test` | 连续敲击/点击触发器 |
| `@r-utils/common/ui` | 与框架无关的 UI 计算工具 |
| `@r-utils/common/printer` | ESC/TSC 打印相关工具 |
## 使用示例
### 权限字符串校验
```ts
import { Permission } from "@r-utils/common";
const permission = new Permission([], 3, ":");
permission.isValid("user:create:button"); // true
permission.isValid("user:create"); // false
```
### 等待指定时间
```ts
import { wait } from "@r-utils/common";
async function submit() {
await wait(300);
console.log("继续执行");
}
```
### 倒计时
```ts
import { Countdown } from "@r-utils/common";
const countdown = new Countdown(10 * 1000);
countdown.addStepEventListener((time) => {
console.log("剩余时间:", time);
});
countdown.addCountdownEventListener(() => {
console.log("倒计时结束");
});
countdown.start();
```
### 简单数值倒计时
```ts
import { TimeoutTimer } from "@r-utils/common";
const timer = new TimeoutTimer(5000, 0, 1000);
timer.addStepEventListener((time) => {
console.log("剩余毫秒:", time);
});
timer.addCountdownEventListener(() => {
console.log("完成");
});
timer.start();
```
### 输入值规则处理
```ts
import { getValueOfRule } from "@r-utils/common";
const value = getValueOfRule("12.345", {
min: 0,
max: 99999.99,
required: true,
digits: 2,
keepDecimal: true,
});
console.log(value); // "12.35"
```
### 禁止正负号并转成数字
```ts
import { getValueOfRule } from "@r-utils/common";
const value = getValueOfRule("-12", {
min: 0,
required: true,
noSign: true,
number: true,
});
console.log(value); // 0
```
### 连续敲击触发回调
```ts
import { KnockTest } from "@r-utils/common";
const knockTest = new KnockTest({
maxWaitTime: 5000,
operations: [
{ times: 3, duration: 1000, delay: 500 },
{ times: 2, duration: 1000, delay: 500 },
],
});
knockTest.addCallback(() => {
console.log("触发隐藏功能");
});
button.addEventListener("click", () => {
knockTest.knock();
});
```
### 缓动滚动计算
```ts
import { slowlyScroll } from "@r-utils/common";
await slowlyScroll(0, 300, 500, (value) => {
window.scrollTo(0, value);
});
```
## 注意事项
- `Countdown``TimeoutTimer``KnockTest` 内部使用 `window.setInterval` / `window.setTimeout`,更适合浏览器或类浏览器环境。
- 推荐优先使用根入口导入;如果需要更精确的模块边界,也可以使用子路径导入。
- 打印相关模块通常依赖具体设备和业务场景,建议在真实设备环境中验证。
+40 -3
View File
@@ -1,6 +1,6 @@
{
"name": "@r-utils/common",
"version": "1.3.0",
"version": "1.4.0",
"private": false,
"description": "js通用工具库",
"type": "module",
@@ -8,13 +8,50 @@
"module": "dist/index.mjs",
"types": "dist/index.d.ts",
"sideEffects": false,
"files": [
"dist"
],
"exports": {
".": {
"types": "./dist/index.d.ts",
"import": "./dist/index.mjs",
"require": "./dist/index.cjs"
},
"./*": "./*"
"./input-rule": {
"types": "./dist/input-rule/index.d.ts",
"import": "./dist/input-rule/index.mjs",
"require": "./dist/input-rule/index.cjs"
},
"./knock-test": {
"types": "./dist/knock-test/index.d.ts",
"import": "./dist/knock-test/index.mjs",
"require": "./dist/knock-test/index.cjs"
},
"./permission": {
"types": "./dist/permission/index.d.ts",
"import": "./dist/permission/index.mjs",
"require": "./dist/permission/index.cjs"
},
"./printer": {
"types": "./dist/printer/index.d.ts",
"import": "./dist/printer/index.mjs",
"require": "./dist/printer/index.cjs"
},
"./time": {
"types": "./dist/time/index.d.ts",
"import": "./dist/time/index.mjs",
"require": "./dist/time/index.cjs"
},
"./timer": {
"types": "./dist/timer/index.d.ts",
"import": "./dist/timer/index.mjs",
"require": "./dist/timer/index.cjs"
},
"./ui": {
"types": "./dist/ui/index.d.ts",
"import": "./dist/ui/index.mjs",
"require": "./dist/ui/index.cjs"
}
},
"keywords": [
"utils",
@@ -44,9 +81,9 @@
"scripts": {
"build": "vite build",
"watch": "vite build --watch",
"typecheck": "tsc -p tsconfig.json --noEmit",
"lint": "eslint --ext .js,ts --fix src",
"format": "prettier --write src",
"release": "standard-version",
"commit": "cz",
"lint-staged": "lint-staged",
"test": "vitest run"
@@ -59,7 +59,10 @@ export function getValueOfRule(
/**
* -
*/
function getTextTargetValue(innerValue: InputValue, options: InputOptions): InputValue {
function getTextTargetValue(
innerValue: InputValue,
options: InputOptions,
): InputValue {
const { required, init, pattern, number } = options;
innerValue ??= "";
@@ -143,7 +146,10 @@ function applyPrecision(num: number, options: InputOptions): number {
/**
* -
*/
function getNumberTargetValue(innerValue: InputValue, options: InputOptions): InputValue {
function getNumberTargetValue(
innerValue: InputValue,
options: InputOptions,
): InputValue {
const { number, keepDecimal, noSign, digits } = options;
const strValue = String(innerValue ?? "");
+14 -7
View File
@@ -127,7 +127,7 @@ export class JpPrinter {
addText(content) {
content = String(content);
let code = [];
let code;
if (isAndroidApp) {
code = plus.android.invoke(content, "getBytes", "gbk");
} else {
@@ -254,8 +254,8 @@ export class JpPrinter {
let code = new TextEncoder("gb18030", {
NONSTANDARD_allowLegacyEncoding: true,
}).encode(content);
const pL = parseInt((code.length + 3) % 256);
const pH = parseInt((code.length + 3) / 256);
// const pL = parseInt((code.length + 3) % 256);
// const pH = parseInt((code.length + 3) / 256);
this.data.push(29, 40, 107, 3, 0, 49, 69, ...code);
return this;
}
@@ -740,6 +740,7 @@ export class JpPrinter {
let ch = 0;
text.split("").forEach((c) => {
// 是否是汉字,汉字两倍宽
// eslint-disable-next-line no-control-regex
const isChinese = /[^\x00-\xff]/.test(c);
if (isChinese) {
ch += 2;
@@ -984,10 +985,12 @@ export class JpPrinter {
return this;
}
setBarcodeContent(t, content) {
setBarcodeContent(t) {
let ty = 73;
this.data.push(29);
this.data.push(107);
const bar = JpPrinter.bar;
switch (t) {
case bar[0]:
ty = 65;
@@ -1031,12 +1034,16 @@ export class JpPrinter {
}
export class Query {
constructor() {
this.queryStatus = new Query();
}
/**
* 查询打印机实时状态
* @param {*} n
* @param {*} device
*/
getRealtimeStatusTransmission(n, device) {
getRealtimeStatusTransmission(n) {
/*
n = 1:传送打印机状态
n = 2:传送脱机状态
@@ -1048,7 +1055,7 @@ export class Query {
dateView.setUint8(0, 16);
dateView.setUint8(1, 4);
dateView.setUint8(2, n);
queryStatus.query(buf);
this.queryStatus.query(buf);
}
addGeneratePlus(n, m, t, device) {
@@ -1059,7 +1066,7 @@ export class Query {
dateView.setUint8(2, n);
dateView.setUint8(3, m);
dateView.setUint8(4, t);
queryStatus.query(buf, device);
this.queryStatus.query(buf, device);
}
query(buf, device) {
+1
View File
@@ -195,6 +195,7 @@ export class TSCPlus extends TSC {
let ch = 0;
text.split("").forEach((c) => {
// 是否是汉字,汉字两倍宽
// eslint-disable-next-line no-control-regex
const isChinese = /[^\x00-\xff]/.test(c);
if (isChinese) {
ch += 2;
+1 -1
View File
@@ -417,7 +417,7 @@ export class TSC {
for (x = 0; x < w; x++) {
var color = bitmapData[(y * w + x) * 4 + 1];
if (color <= 128) {
bits[parseInt(y * pitch + x / 8)] |= 0x80 >> x % 8;
bits[parseInt(y * pitch + x / 8)] |= 0x80 >> (x % 8);
}
}
}
+40 -10
View File
@@ -13,7 +13,9 @@ describe("getValueOfRule - 文本模式 (text: true)", () => {
});
test("required + init:非数字文本回退到 init", () => {
expect(getValueOfRule("abc", { ...textOpts, required: true, init: "默认" })).toBe("默认");
expect(
getValueOfRule("abc", { ...textOpts, required: true, init: "默认" }),
).toBe("默认");
});
test("required 无 init:非数字文本保持原值", () => {
@@ -29,7 +31,9 @@ describe("getValueOfRule - 文本模式 (text: true)", () => {
});
test("pattern 匹配成功返回原值", () => {
expect(getValueOfRule("123", { ...textOpts, pattern: "^\\d+$" })).toBe("123");
expect(getValueOfRule("123", { ...textOpts, pattern: "^\\d+$" })).toBe(
"123",
);
});
});
@@ -107,7 +111,9 @@ describe("getValueOfRule - digits 小数位数", () => {
});
test("keepDecimal + number 返回数字类型", () => {
expect(getValueOfRule("3.10", { digits: 2, keepDecimal: true, number: true })).toBe(3.1);
expect(
getValueOfRule("3.10", { digits: 2, keepDecimal: true, number: true }),
).toBe(3.1);
});
});
@@ -127,11 +133,15 @@ describe("getValueOfRule - integer 整数模式", () => {
describe("getValueOfRule - noSign 不允许正负号", () => {
test("带正号的输入被视为非法", () => {
expect(getValueOfRule("+5", { noSign: true, required: true, init: 0 })).toBe("0");
expect(
getValueOfRule("+5", { noSign: true, required: true, init: 0 }),
).toBe("0");
});
test("带负号的输入被视为非法", () => {
expect(getValueOfRule("-5", { noSign: true, required: true, init: 0 })).toBe("0");
expect(
getValueOfRule("-5", { noSign: true, required: true, init: 0 }),
).toBe("0");
});
test("无符号数字正常通过", () => {
@@ -142,25 +152,45 @@ describe("getValueOfRule - noSign 不允许正负号", () => {
describe("getValueOfRule - callback", () => {
test("callback 接收最终处理后的值", () => {
let received: unknown;
getValueOfRule("42", { number: true }, (v) => { received = v; });
getValueOfRule("42", { number: true }, (v) => {
received = v;
});
expect(received).toBe(42);
});
});
describe("getValueOfRule - 综合场景", () => {
test("限制输入 min:0, max:99999.99, required, digits:2", () => {
expect(getValueOfRule("100.456", { min: 0, max: 99999.99, required: true, digits: 2 })).toBe("100.46");
expect(
getValueOfRule("100.456", {
min: 0,
max: 99999.99,
required: true,
digits: 2,
}),
).toBe("100.46");
});
test("超出 max 时截断到 max", () => {
expect(getValueOfRule("100000", { min: 0, max: 99999.99, required: true, digits: 2 })).toBe("99999.99");
expect(
getValueOfRule("100000", {
min: 0,
max: 99999.99,
required: true,
digits: 2,
}),
).toBe("99999.99");
});
test("空输入 required 回退到 min", () => {
expect(getValueOfRule("", { min: 0, max: 99999.99, required: true, digits: 2 })).toBe("0");
expect(
getValueOfRule("", { min: 0, max: 99999.99, required: true, digits: 2 }),
).toBe("0");
});
test("负数输入限制到 min:0", () => {
expect(getValueOfRule("-5", { min: 0, max: 100, required: true })).toBe("0");
expect(getValueOfRule("-5", { min: 0, max: 100, required: true })).toBe(
"0",
);
});
});
+2 -2
View File
@@ -1,11 +1,11 @@
{
"extends": "../../tsconfig.base.json",
"exclude": ["node_modules", "dist"],
"include": ["src/**/*.ts"],
"include": ["src/**/*.ts", "types/**/*.d.ts"],
"compilerOptions": {
"baseUrl": "./",
"paths": {
"@/*": ["src/*"]
},
}
}
}
+338
View File
@@ -0,0 +1,338 @@
export function row2col(arr: any): any;
/**
* NOTE 打印机普通文本最大宽度32个数字,16个汉字超出换行
*
*/
export class JpPrinter {
static bar: string[];
/**
* 获取文本宽度点数
* @param {string} text
* @returns {number}
*/
static getTextDots(text: string): number;
/**
* 根据最大点数获取文本
* @param {string} text
* @param {number} maxDots
* @return {string}
*/
static getMaxText(text?: string, maxDots?: number): string;
/**
* 分割字符
* "123456789" => ["1234", "5678", "9"]
* @param {string} str
* @param {number} maxDots
* @return {string[]}
*/
static splitString(str: string, maxDots: number): string[];
static createDefaultPrinter(): JpPrinter;
static getQuery(): Query;
constructor(width?: number, dpi?: number);
name: string;
data: any[];
align: string;
bold: boolean;
lineSpacing: number;
fontSize: number;
/** 有效打印宽度 */
width: number;
dpi: number;
_layout: null;
storeLayout(): this;
restoreLayout(): this;
getXDots(): number;
/** 初始化打印机 */
init(): this;
/**
* 添加文本内容
* @param {string} content
*/
addText(content: string): this;
/**
* GS ! 选择字符大小
* @param {number} n 放大倍数
* */
setFontSize(n?: number): this;
/**
* ESC E 选择/取消加粗模式
* @param {boolean} bold
* */
setBold(bold: boolean): this;
/**
* ESC – 选择/取消下划线模式
* 根据 n 的值选择或取消下划线模式:
* • 下划线可加在所有字符下(包括右间距),但不包括 HT 设置的空格。
* • 下划线不能作用在顺时针旋转 90°和反色的字符下。
* • 当取消下划线模式时,后面的字符不加下划线,下划线的宽度不改变。默认宽度是一点宽。
* • 改变字符大小不影响当前下划线宽度。
* • 下划线选择取消也可以由 ESC !来设置,最后执行的命令有效。
* • 该命令不影响汉字字符的设定。
* @param {number} n
* 0, 48 取消下划线模式
* 1, 49 选择下划线模式(1 点宽)
* 2, 50 选择下划线模式(2 点宽)
* @returns
*/
setUnderline(n?: number): this;
/**
* FS - 选择/取消汉字下划线模式
* 根据 n 的值,选择或取消汉字的下划线
* • 打印机能对所有字符加下划线,包括左右间距。但不能对由 HT 命令(横向跳格)引起的空格加下划线,也不对顺时针旋转 90 度的字符加下划线。
* • 消下划线模式后,不再执行下划线打印,但原先设置的下划线线宽不会改变。默认下划线线宽为 1 点。
* • 即使改变字符大小,设定的下划线线宽也不会改变。
* • 用 FS !也可选择或取消下划线模式,最后一条命令有效。
* @param {*} n
* 0, 48 取消汉字下划线
* 1, 49 选择汉字下划线(1 点宽)
* 2, 50 选择汉字下划线(2 点宽
* @returns
*/
setUnderlineChinese(n?: any): this;
/**
* 设置二维码大小
* @param {*} n
* @see {JpPrinter#setQRCodeSize}
*/
setSelectSizeOfModuleForQRCode(n: any): this;
/**
* 设置 QRCode 模块大小为 n dot
* @param {number} n
* @returns
*/
setQRCodeSize(n: number): this;
/**
* 选择 QRCode 纠错等级
* @see {JpPrinter#setQRCodeErrorCorrectionLevel}
*/
setSelectErrorCorrectionLevelForQRCode(n: any): this;
/**
* 选择 QRCode 纠错等级
* n 功能 纠错能力
* 48 选择纠错等级 L 7
* 49 选择纠错等级 M 15
* 50 选择纠错等级 Q 25
* 51 选择纠错等级 H 30
* @see
*/
setQRCodeErrorCorrectionLevel(n: any): this;
/** 设置二维码内容 */
setStoreQRCodeData(content: any): this;
/**
* 打印二维码
* @deprecated
* @see {JpPrinter#printQRCode}
* */
setPrintQRCode(): this;
/** 打印二维码 */
printQRCode(): this;
addQrCodeByUrl(url: any, width: any, height: any): this;
addImageByUrl(url: any, width: any, height: any): this;
addQrCodeByText(contents: any, width: any, height: any): this;
/**
* HT 水平定位
* 移动打印位置到下一个水平定位点的位置。
* @deprecated
* @see {JpPrinter#addHorTab}
*/
setHorTab(): this;
/**
* HT 水平定位
* 移动打印位置到下一个水平定位点的位置。
*/
addHorTab(): this;
/**
* ESC $ 设置绝对打印位置
* @param {number} where
* @returns
*/
setAbsolutePrintPosition(where: number): this;
/**
* ESC \ 设置相对横向打印位置
* 安卓无法传入超过127的数
*
* @param {number} where
* @returns
*/
setRelativePrintPosition(where: number): this;
/**
* ESC a 选择对齐方式
* @param {number} n
* 0, 48 左对齐
* 1, 49 中间对齐
* 2, 50 右对齐
*/
setSelectJustification(n: number): this;
/**
* 设置对齐方式
* @param {string} align
* "l" 左对齐
* "m" 中间对齐
* "r" 右对齐
* @returns
*/
setAlign(align: string): this;
/**
* ESC D 设置横向跳格位
* @param {number} n
* @deprecated
* @see {}
*/
space(...nk: any[]): this;
/**
* ESC D 设置横向跳格位
* @param {number} n
*/
addSpace(...nk: any[]): this;
/**
* GS L 设置左边距
* @param {number} n
* @returns
*/
setLeftMargin(n: number): this;
textMarginRight(n: any): this;
/**
* ESC 3 设置行间距
* @deprecated
* @see {JpPrinter#setLineSpacing}
* */
rowSpace(n: any): this;
/**
* ESC 3 设置行间距
* */
setLineSpacing(n: any): this;
/**
* GS W 设置打印区域宽度
* @param {number} width
* @returns
*/
setPrintingAreaWidth(width: number): this;
setSound(n: any, t: any): this;
setBitmap(res: any): this;
/**
* 添加位图 GS v 0
* */
addBitmap(m: any, xL: any, xH: any, yL: any, yH: any, ...data: any[]): this;
/**
* 添加位图
* @param {Uint8ClampedArray} imgData
* @param {number} width
* @param {number} height
*/
addBitmapHelper(imgData: Uint8ClampedArray, width: number, height: number): this;
/**
* 打印并换行
* */
addLF(): this;
/**
* ESC J 打印并走纸 n 个单位
* @param {number} n
* @see {JpPrinter#addPrintAndFeed}
*/
setPrintAndFeed(n: number): this;
/**
* ESC J 打印并走纸 n 个单位
* @param {number} n
*/
addPrintAndFeed(n: number): this;
/**
* ESC d 打印并走纸 n 行
* @param {number} n
* @see {JpPrinter#addPrintAndFeedRow}
*/
setPrintAndFeedRow(n: number): this;
/**
* ESC d 打印并走纸 n 行
* @param {number} n
* @returns
*/
addPrintAndFeedRow(n: number): this;
/**
* 添加 n 行
* @param {number} n
* @see {JpPrinter#addPrintAndFeedRow}
*/
addRow(n: number): this;
/**
* 添加打印指令数据
* @param {number[]} data
* @returns
*/
addData(...data: number[]): this;
/**
* 获取打印指令数据
*/
getData(): any[];
/*********************** 自增 ***********************/
/**
* 计算文字位置
* @param {*} value
* @param {*} width
* @deprecated
* @see {JpPrinter#getTextDots}
*/
siteText(value: any, width: any): number;
/**
* 计算数字位置
* @param {*} value
* @param {*} width
* @deprecated
* @see {JpPrinter#getTextDots}
*/
siteNumber(value: any, width: any): number;
/**
* 左对齐文字
* @deprecated
*/
alignLeft(name: any, text: any, arr: any): this;
/**
* @deprecated
* @see {JpPrinter.getTextDots}
*/
getTextDots(text: any): number;
/**
* @deprecated
* @see {JpPrinter.getMaxText}
*/
getMaxText(text?: string, maxDots?: number): string;
/**
* 添加两端对齐的文字
*/
addTextJustifyAlign(text1: any, text2: any): this;
/**
* 添加分割线
*/
addDivider(): this;
/**
* 添加表格
* @param {Object} table
* @param {Array} table.header
* @param {Array} table.data
* @param {number[]} [table.columns] 每列百分比
*/
addTable({ header, data, columns }: {
header: any[];
data: any[];
columns?: number[] | undefined;
}): this;
/**
* 分割符
* @deprecated
* @see {JpPrinter#addDivider}
*/
separator(width: any): this;
setBarcodeWidth(width: any): this;
setBarcodeHeight(height: any): this;
setBarcodeContent(t: any): this;
}
export class Query {
queryStatus: Query;
/**
* 查询打印机实时状态
* @param {*} n
* @param {*} device
*/
getRealtimeStatusTransmission(n: any): void;
addGeneratePlus(n: any, m: any, t: any, device: any): void;
query(buf: any, device: any): void;
}
+63
View File
@@ -0,0 +1,63 @@
export class TSCPlus extends TSC {
static MILLIMETERS_PER_INCH: number;
static getLetterWidthDot(font: any): number;
static getFontLineHeightDot(font: any, lineHeight: any): any;
/**
* 获取文本宽度点数
* @param {string} text
* @returns {number}
*/
static getTextDots(text: string, letterDots?: number): number;
/**
* 根据最大点数获取文本
* @param {string} text
* @param {number} maxDots
* @return {string}
*/
static getMaxText(text?: string, maxDots?: number): string;
/**
* 分割字符串
* "123456789" => ["1234", "5678", "9"]
* @param {string} str
* @param {number} maxDots
* @return {string[]}
*/
static splitString(str: string, maxDots: number): string[];
font: string;
lineHeight: string;
dpi: number;
nextX: number;
nextY: number;
widthDot: number;
heightDot: number;
paddingTopDot: number;
paddingLeftDot: number;
paddingRightDot: number;
paddingBottomDot: number;
/**
* 设置内边距
* @param {number} paddingTopDot
* @param {number} paddingRightDot
* @param {number} paddingBottomDot
* @param {number} paddingLeftDot
*/
setPadding(paddingTopDot: number, paddingRightDot: number, paddingBottomDot: number, paddingLeftDot: number): void;
mmToDot(mm: any): number;
setDpi(dpi: any): void;
setSize(w: any, h: any): TSC;
setSizeMM(w: any, h: any): TSC;
setSizeDot(w: any, h: any): TSC;
/**
* 设置字体
* @param {string} font
*/
setFont(font: string): void;
/**
* 设置行高
* @param {string|number} lineHeight
*/
setLineHeight(lineHeight: string | number): void;
addTextLn(text: any, options?: {}): this;
addAddBarCode(content: any, options?: {}): this;
}
import { TSC } from "./tsc.js";
+369
View File
@@ -0,0 +1,369 @@
export class TSC {
static LINE_BREAK: string;
constructor(data?: any[]);
data: any[];
addData(...data: any[]): void;
addDataArray(dataArray: any): void;
addCode(code: any): this;
getData: () => any;
/**
* 该指令用于设定卷标纸的宽度和长度
* @param {number|string} w 标签宽度 单位英寸inch
* @param {number|string} h 标签高度 单位英寸inch
* @returns {TSC}
*/
setSize(w: number | string, h: number | string): TSC;
/**
* 该指令用于设定卷标纸的宽度和长度
* @param {number|string} w 标签宽度 单位毫米mm
* @param {number|string} h 标签高度 单位毫米mm
* @returns {TSC}
*/
setSizeMM(w: number | string, h: number | string): TSC;
/**
* 该指令用于定义两张卷标纸间的垂直间距距离
* @param {number|string} m 两标签纸中间的垂直距离 单位英寸inch
* @param {number|string} n 垂直间距偏移 单位英寸inch
* @returns {TSC}
*/
setGap(m?: number | string, n?: number | string): TSC;
/**
* 该指令用于定义两张卷标纸间的垂直间距距离
* @param {number|string} m 两标签纸中间的垂直距离 单位毫米mm
* @param {number|string} n 垂直间距偏移 单位毫米mm
* @returns {TSC}
*/
setGapMM(m?: number | string, n?: number | string): TSC;
/**
* 该指令用于设定黑标高度及定义标签印完后标签额外送出的长度
* @param {number|string} m 黑标高度 单位英寸inch
* @param {number|string} n 额外送出纸张长度 单位英寸inch
* @returns {TSC}
*/
setBLine(m?: number | string, n?: number | string): TSC;
/**
* 该指令用于控制在剥离模式时(peel-off mode)每张卷标停止的位置,
* 在打印下一张时打印机会将原先多推出或少推出的部分以回拉方式补偿回来。
* 该指令仅适用于剥离模式。
* @param {number|string} m 纸张停止的距离 单位英寸inch
* @returns {TSC}
*/
setOffset(offset?: number): TSC;
/**
* 该指令用于控制打印速度
* @param {number|string} speed 打印速度
* @returns {TSC}
*/
setSpeed(speed?: number | string): TSC;
/**
* 该指令用于控制打印时的浓度
* @param {number|string} density 打印浓度
* @returns {TSC}
*/
setDensity(density?: number | string): TSC;
/**
* 该指令用于定义打印时出纸和打印字体的方向
* @param {number|string} direction
* @returns {TSC}
*/
setDirection(direction?: number | string): TSC;
/**
* 该指令用于定义卷标的参考坐标原点。坐标原点位置和打印方向有关
* @param {number|string} x 水平方向的坐标位置,单位dot
* @param {number|string} y 垂直方向的坐标位置,单位dot
* @returns {TSC}
*/
setReference(x?: number | string, y?: number | string): TSC;
/**
* 该指令表示标签打印偏移量多少设置
* @param {number|string} n 打印偏移量
* @returns {TSC}
*/
setShift(n?: number | string): TSC;
/**
* 该指令用于选择对应的国际字符集
* 001:USA
* 002:French
* 003:Latin America
* 034:Spanish
* 039:Italian
* 044:United Kingdom
* 046:Swedish
* 047:Norwegian
* 049:German
* @param {number|string} country 字符集
* @returns {TSC}
*/
setCountry(country?: number | string): TSC;
/**
* 该指令用于选择对应的国际代码页
* 8-bit codepage 字符集代表
* 437:United States
* 850:Multilingual
* 852:Slavic
* 860:Portuguese
* 863:Canadian/French
* 865:Nordic
*
* Windows code page
* 1250:Central Europe
* 1252:Latin I
* 1253:Greek
* 1254:Turkish
*
* 以下代码页仅限于12×24 dot 英数字体
* WestEurope:WestEurope
* Greek:Greek
* Hebrew:Hebrew
* EastEurope:EastEurope
* Iran:Iran
* IranII:IranII
* Latvian:Latvian
* Arabic:Arabic
* Vietnam:Vietnam
* Uygur:Uygur
* Thai:Thai
* 1252:Latin I
* 1257:WPC1257
* 1251:WPC1251
* 866:Cyrillic
* 858:PC858
* 747:PC747
* 864:PC864
* 1001:PC1001
* @param {number|string} n 代码页
* @returns {TSC}
*/
setCodepage(n?: number | string): TSC;
/**
* 该指令用于清除图像缓冲区(image buffer)的数据
* 注:此项指令必须置于 SIZE 指令之后
* @param {number|string} n 代码页
* @returns {TSC}
*/
setCls(): TSC;
/**
* 该指令用于将标签纸向前推送指定的长度
* 打印机分辨率200 DPI:1 mm = 8 dots
* 打印机分辨率300 DPI:1 mm = 12 dots
* @param {number|string} n 1≤n≤9999,单位dot
* @returns {TSC}
*/
setFeed(n: number | string): TSC;
/**
* 该指令用于将标签纸向前推送指定的长度
* 打印机分辨率200 DPI:1 mm = 8 dots
* 打印机分辨率300 DPI:1 mm = 12 dots
* @param {number|string} n 1≤n≤9999,单位dot
* @returns {TSC}
*/
setBackFeed(n: number | string): TSC;
/**
* 该指令用于将标签纸向前推送指定的长度
* 打印机分辨率200 DPI:1 mm = 8 dots
* 打印机分辨率300 DPI:1 mm = 12 dots
* @param {number|string} n 1≤n≤9999,单位dot
* @returns {TSC}
*/
setBackUp(n: number | string): TSC;
/**
* 该指令用于控制打印机进一张标签纸
* @returns {TSC}
*/
setFromFeed(): TSC;
/**
* 在使用含有间隙或黑标的标签纸时,
* 若不能确定第一张标签纸是否在正确打印位置时,
* 此指令可将标签纸向前推送至下一张标签纸的起点开始打印。
* 标签尺寸和间隙需要在本条指令前设置
* 注:使用该指令时,纸张高度大于或等于30 mm
* @returns {TSC}
*/
setHome(): TSC;
/**
* 该指令用于打印出存储于影像缓冲区内的数据
* @param {number|string} m 指定打印的份数(set
* @param {number|string} n 每张标签需重复打印的张数
* @returns {TSC}
*/
setPrint(m?: number | string, n?: number | string): TSC;
/**
* 该指令用于控制蜂鸣器的频率,可设定10阶的声音,
* 频率,可设定10阶的声音,每阶声音的长短由第二个参数控制
* @param {number|string} m 指定打印的份数(set
* @param {number|string} n 每张标签需重复打印的张数
* @returns {TSC}
*/
setSound(level?: number, interval?: number): TSC;
/**
* 该指令用于设定打印机进纸时,若经过所设定的长度仍无法侦测到垂直间距,
* 则打印机在连续纸模式工作。
* @param {number|string} limit 英制系统(inch
* @returns {TSC}
*/
setLimitFeed(limit?: number | string): TSC;
/**
* 不经自测动作,直接打印自检页信息。
* @returns {TSC}
*/
setSelfTest(): TSC;
/**
* 该指令用于在标签上画线
* @param {number|string} x 线条左上角X坐标,单位dot
* @param {number|string} y 线条左上角Y坐标,单位dot
* @param {number|string} width 线宽,单位dot
* @param {number|string} height 线高,单位dot
* @returns {TSC}
*/
setBar(x: number | string, y: number | string, width: number | string, height: number | string): TSC;
/**
* 该指令用于在标签上画线
* @param {number|string} x 线条左上角X坐标,单位dot
* @param {number|string} y 线条左上角Y坐标,单位dot
* @param {number|string} codeType 线宽,单位dot
* @param {number|string} height 条形码高度,以点(dot)表示
* @param {number|string} readable 0 表示人眼不可识,1表示人眼可识
* @param {number|string} rotation 条形码旋转角度,顺时针方向
* @param {number|string} narrow 窄bar宽度,以点(dot)表示
* @param {number|string} wide 宽bar宽度,以点(dot)表示
* @param {number|string} content 内容
* @returns {TSC}
*/
setBarCode(x: number | string, y: number | string, codeType: number | string | undefined, height: number | string | undefined, readable: number | string | undefined, rotation: number | string | undefined, narrow: number | string | undefined, wide: number | string | undefined, content: number | string): TSC;
/**
* 该指令用于在卷标上绘制矩形方框
* @param {number|string} x1 线条左上角X坐标,单位dot
* @param {number|string} y1 线条左上角Y坐标,单位dot
* @param {number|string} x2 方框右下角X坐标,单位dot
* @param {number|string} y2 方框右下角Y坐标,单位dot
* @param {number|string} thickness 方框线宽,单位dot
* @returns {TSC}
*/
setBox(x1: number | string, y1: number | string, x2: number | string, y2: number | string, thickness: number | string): TSC;
/**
* 该指令用于在卷标上绘制位图(非BMP格式图档)
* @param {number|string} x 线条左上角X坐标,单位dot
* @param {number|string} y 线条左上角Y坐标,单位dot
* @param {number|string} width 方框右下角X坐标,单位dot
* @param {number|string} height 方框右下角Y坐标,单位dot
* @param {number|string} mode 方框线宽,单位dot
* @param {number|string} bitmapData 方框线宽,单位dot
* @returns {TSC}
*/
setBitmap(x: number | string, y: number | string, width: number | string, height: number | string, mode: number | string, bitmapData: number | string): TSC;
/**
* 该指令用于清除影像缓冲区部分区域的数据
* @param {number|string} x 清除区域的左上角X座标,单位dot
* @param {number|string} y 清除区域的左上角Y座标,单位dot
* @param {number|string} width 清除区域宽度,单位dot
* @param {number|string} height 清除区域高度,单位dot
* @returns {TSC}
*/
setErase(x: number | string, y: number | string, width: number | string, height: number | string): TSC;
/**
* 将指定的区域反相打印
* @param {number|string} x 反相区域的左上角X座标,单位dot
* @param {number|string} y 反相区域的左上角Y座标,单位dot
* @param {number|string} width 反相区域宽度,单位dot
* @param {number|string} height 反相区域高度,单位dot
* @returns {TSC}
*/
setReverse(x: number | string, y: number | string, width: number | string, height: number | string): TSC;
/**
* 该指令用于打印字符串
* @param {number|string} x 文字X方向起始点坐标
* @param {number|string} y 文字Y方向起始点坐标
* @param {number|string} font 字体名称
* @param {number|string} sx X 方向放大倍率1-10
* @param {number|string} sy Y 方向放大倍率1-10
* @param {number|string} content 内容
* @returns {TSC}
*/
setText(x: number | string, y: number | string, font: number | string, rotation: any, sx: number | string, sy: number | string, content: number | string): TSC;
/**
* 该指令用来打印二维码
* @param {number|string} x 二维码水平方向起始点坐标
* @param {number|string} y 反相区域的左上角Y座标,单位dot
* @param {number|string} level 选择QRCODE纠错等级
* @param {number|string} width 二维码宽度1-10
* @param {number|string} mode 手动/自动编码
* @param {number|string} rotation 旋转角度(顺时针方向)
* @param {number|string} content 内容
* @returns {TSC}
*/
setQrcode(x: number | string, y: number | string, level: number | string, width: number | string, mode: number | string, rotation: number | string, content: number | string): TSC;
/**
* 该指令用来起动Key1 的预设功能
* 预设为进纸功能
* @param {"ON"|"OFF"} k 开启按键/关闭按键
* @returns {TSC}
*/
setKey1(k: "ON" | "OFF"): TSC;
/**
* 该指令用来起动Key2 的预设功能
* 预设为暂停功能
* @param {"ON"|"OFF"} k 开启按键/关闭按键
* @returns {TSC}
*/
setKey2(k: "ON" | "OFF"): TSC;
/**
* 该指令用来启动/关闭剥离模式,默认值为关闭
* @param {"ON"|"OFF"} k 开启按键/关闭按键
* @returns {TSC}
*/
setPeel(k: "ON" | "OFF"): TSC;
/**
* 此命令是用来启用/禁用撕纸位置走到撕纸处,此设置关掉电源后将保存在打印机内
* @param {"ON"|"OFF"} k 开启按键/关闭按键
* @returns {TSC}
*/
setTear(k: "ON" | "OFF"): TSC;
/**
* 此命令是用来启用/禁用撕纸位置走到撕纸处,此设置关掉电源后将保存在打印机内
* @param {"ON"|"OFF"} k 开启按键/关闭按键
* @returns {TSC}
*/
setStripper(k: "ON" | "OFF"): TSC;
/**
* 此设置用于启用/禁用打印头合盖传感器。如果禁用合盖传感器,打印机头被打开时,将不会传回错误信息。
* 此设置将保存在打印机内存。
* @param {"ON"|"OFF"} k 开启按键/关闭按键
* @returns {TSC}
*/
setHead(k: "ON" | "OFF"): TSC;
/**
* 此设置用于启用/禁用打印头合盖传感器。如果禁用合盖传感器,打印机头被打开时,将不会传回错误信息。
* 此设置将保存在打印机内存。
* @param {"ON"|"OFF"|"AUTO"|string|number} k 开启按键/关闭按键
* @returns {TSC}
*/
setHead2(k: "ON" | "OFF" | "AUTO" | string | number): TSC;
/**
* 此命令将禁用/启用标签机在无纸或开盖错误发生后,
* 上纸或合盖后重新打印一次标签内容
* @param {"ON"|"OFF"} k 开启按键/关闭按键
* @returns {TSC}
*/
setReprint(k: "ON" | "OFF"): TSC;
/**
* 设定开启/关闭碳带感应器,即切换热转式/热感印式打印。通常打印机于开启电源时,
* 碳带感应器即会自动检测打印机是否已装上碳带,并藉此决定使用热感式或热转式打印。
* 此项设定并不会存于打印机中。此方法仅适用于热转式机器。
* @param {"ON"|"OFF"} k 开启按键/关闭按键
* @returns {TSC}
*/
setRibbon(k: "ON" | "OFF"): TSC;
/**
* 此命令用于设置切刀状态,关闭打印机电源后,该设置将会被存储在打印机内存中。
* @param {"OFF"|"BATCH"|string|number} k 开启按键/关闭按键
* @returns {TSC}
*/
setCutter(k: "OFF" | "BATCH" | string | number): TSC;
/**
* 此指令用于设置打印机自动返回状态
* @param {"ON"|"OFF"|"BATCH"} k 开启按键/关闭按键
* @param {string} content
* @returns {TSC}
*/
setResponse(k: "ON" | "OFF" | "BATCH", content: string): TSC;
}
+33 -5
View File
@@ -5,15 +5,43 @@ import dts from "vite-plugin-dts";
const __dirname = fileURLToPath(new URL(".", import.meta.url));
const sharedOutput = {
preserveModules: true,
preserveModulesRoot: resolve(__dirname, "src"),
assetFileNames: "assets/[name]-[hash][extname]",
exports: "named",
} as const;
export default defineConfig({
build: {
lib: {
entry: resolve(__dirname, "src/index.ts"),
formats: ["es", "cjs"],
fileName: (format) => `index.${format === "es" ? "mjs" : "cjs"}`,
entry: {
index: resolve(__dirname, "src/index.ts"),
"input-rule/index": resolve(__dirname, "src/input-rule/index.ts"),
"knock-test/index": resolve(__dirname, "src/knock-test/index.ts"),
"permission/index": resolve(__dirname, "src/permission/index.ts"),
"printer/index": resolve(__dirname, "src/printer/index.ts"),
"time/index": resolve(__dirname, "src/time/index.ts"),
"timer/index": resolve(__dirname, "src/timer/index.ts"),
"ui/index": resolve(__dirname, "src/ui/index.ts"),
},
},
rollupOptions: {
rolldownOptions: {
external: ["dayjs", "lodash-es", "text-encoding", "tslib"],
output: [
{
...sharedOutput,
format: "es",
entryFileNames: "[name].mjs",
chunkFileNames: "chunks/[name]-[hash].mjs",
},
{
...sharedOutput,
format: "cjs",
entryFileNames: "[name].cjs",
chunkFileNames: "chunks/[name]-[hash].cjs",
},
],
},
sourcemap: true,
},
@@ -24,7 +52,7 @@ export default defineConfig({
},
plugins: [
dts({
include: ["src"],
include: ["src", "types"],
outDir: "dist",
}),
],