@wener/common 2.0.2 → 2.0.3

package/package.json

@@ -1,9 +1,15 @@
 {
   "name": "@wener/common",
-  "version": "2.0.2",
+  "version": "2.0.3",
   "type": "module",
-  "description": "",
-  "author": "",
+  "description": "Common utils for console & server",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wenerme/wener.git",
+    "directory": "packages/wener-common"
+  },
+  "homepage": "https://github.com/wenerme/wener/tree/main/packages/wener-common",
+  "author": "wener",
   "license": "MIT",
   "exports": {
     ".": {
@@ -30,6 +36,26 @@
       "types": "./src/decimal/index.ts",
       "default": "./lib/decimal/index.js"
     },
+    "./fs": {
+      "types": "./src/fs/index.ts",
+      "default": "./lib/fs/index.js"
+    },
+    "./fs/orpc": {
+      "types": "./src/fs/orpc/index.ts",
+      "default": "./lib/fs/orpc/index.js"
+    },
+    "./fs/orpc/server": {
+      "types": "./src/fs/orpc/server/index.ts",
+      "default": "./lib/fs/orpc/server/index.js"
+    },
+    "./fs/s3": {
+      "types": "./src/fs/s3/index.ts",
+      "default": "./lib/fs/s3/index.js"
+    },
+    "./fs/server": {
+      "types": "./src/fs/server/index.ts",
+      "default": "./lib/fs/server/index.js"
+    },
     "./jsonschema": {
       "types": "./src/jsonschema/index.ts",
       "default": "./lib/jsonschema/index.js"
@@ -38,6 +64,10 @@
       "types": "./src/meta/index.ts",
       "default": "./lib/meta/index.js"
     },
+    "./orpc": {
+      "types": "./src/orpc/index.ts",
+      "default": "./lib/orpc/index.js"
+    },
     "./password": {
       "types": "./src/password/index.ts",
       "default": "./lib/password/index.js"
@@ -50,10 +80,18 @@
       "types": "./src/resource/schema/index.ts",
       "default": "./lib/resource/schema/index.js"
     },
+    "./s3": {
+      "types": "./src/s3/index.ts",
+      "default": "./lib/s3/index.js"
+    },
     "./schema": {
       "types": "./src/schema/index.ts",
       "default": "./lib/schema/index.js"
     },
+    "./utils": {
+      "types": "./src/utils/index.ts",
+      "default": "./lib/utils/index.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -64,34 +102,44 @@
   ],
   "keywords": [],
   "peerDependencies": {
+    "ajv": "*",
     "zod": "*"
   },
   "dependencies": {
-    "@standard-schema/spec": "^1.0.0",
-    "@wener/utils": "^1.1.51",
+    "@standard-schema/spec": "^1.1.0",
+    "@wener/utils": "^1.1.58",
     "date-fns": "^4.1.0",
-    "es-toolkit": "^1.39.10",
-    "std-env": "^3.9.0",
-    "ts-pattern": "^5.8.0"
+    "es-toolkit": "^1.43.0",
+    "std-env": "^3.10.0",
+    "ts-pattern": "^5.9.0"
   },
   "devDependencies": {
-    "@sinclair/typebox": "^0.34.41",
+    "@orpc/client": "^1.13.4",
+    "@orpc/contract": "^1.13.4",
+    "@orpc/openapi-client": "^1.13.4",
+    "@sinclair/typebox": "^0.34.47",
     "@sinclair/typebox-codegen": "^0.11.1",
     "@types/argon2-browser": "^1.18.4",
     "@types/bcrypt": "^6.0.0",
-    "ajv": "^8.17.1",
+    "@types/micromatch": "^4.0.10",
+    "@types/mime-types": "^3.0.1",
     "ajv-formats": "^3.0.1",
     "ajv-i18n": "^4.2.0",
     "ajv-keywords": "^5.1.0",
     "argon2": "^0.44.0",
     "argon2-browser": "^1.18.0",
     "bcrypt": "^6.0.0",
-    "bcryptjs": "^3.0.2",
+    "bcryptjs": "^3.0.3",
     "chalk": "^5.6.2",
     "consola": "^3.4.2",
-    "dayjs": "^1.11.18",
+    "dayjs": "^1.11.19",
     "decimal.js": "^10.6.0",
-    "zod": "^4.1.8"
+    "emittery": "^1.2.0",
+    "micromatch": "^4.0.8",
+    "mime-types": "^3.0.2",
+    "pathe": "^2.0.3",
+    "s3mini": "^0.8.1",
+    "zod": "^4.3.5"
   },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"

package/src/ai/qwen3vl/index.ts

@@ -0,0 +1 @@
+export { fromQwen3VlBbox2d, toQwen3VlBbox2d } from './utils';

package/src/ai/qwen3vl/utils.ts

@@ -0,0 +1,36 @@
+// xyxy
+type Bbox2d = [number, number, number, number];
+type Dimensions = { width: number; height: number };
+// x_center, y_center, z_center, x_size, y_size, z_size, roll, pitch, yaw
+type Bbox3d = [number, number, number, number, number, number, number, number, number];
+/**
+ * Convert Qwen3V format bbox (0-1000 range) to absolute pixel coordinates
+ * @param dimensions Image dimensions {width, height}
+ * @param bbox Bbox in Qwen3V format [x1, y1, x2, y2] where each value is 0-1000
+ * @returns Absolute pixel coordinates [x1, y1, x2, y2]
+ */
+export function fromQwen3VlBbox2d({ width, height }: Dimensions, bbox: Bbox2d): Bbox2d {
+	const [x1, y1, x2, y2] = bbox;
+	return [
+		Math.floor((x1 / 1000) * width),
+		Math.floor((y1 / 1000) * height),
+		Math.floor((x2 / 1000) * width),
+		Math.floor((y2 / 1000) * height),
+	];
+}
+
+/**
+ * Convert absolute pixel coordinates to Qwen3V format bbox (0-1000 range)
+ * @param dimensions Image dimensions {width, height}
+ * @param bbox Absolute pixel coordinates [x1, y1, x2, y2]
+ * @returns Bbox in Qwen3V format [x1, y1, x2, y2] where each value is 0-1000
+ */
+export function toQwen3VlBbox2d({ width, height }: Dimensions, bbox: Bbox2d): Bbox2d {
+	const [x1, y1, x2, y2] = bbox;
+	return [
+		Math.round((x1 / width) * 1000),
+		Math.round((y1 / height) * 1000),
+		Math.round((x2 / width) * 1000),
+		Math.round((y2 / height) * 1000),
+	];
+}

package/src/ai/vision/DocLayoutElementTypeSchema.ts

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+
+// based on DocLayout-YOLO
+
+export const DocLayoutElementType = Object.freeze({
+	Title: 'Title',
+	PlainText: 'PlainText',
+	Abandon: 'Abandon',
+	Figure: 'Figure',
+	FigureCaption: 'FigureCaption',
+	Table: 'Table',
+	TableCaption: 'TableCaption',
+	TableFootnote: 'TableFootnote',
+	IsolateFormula: 'IsolateFormula',
+	FormulaCaption: 'FormulaCaption',
+});
+export type DocLayoutElementType = (typeof DocLayoutElementType)[keyof typeof DocLayoutElementType];
+
+export const DocLayoutElementTypeSchema = z.union([
+	z.literal(DocLayoutElementType.Title).describe('标题'),
+	z.literal(DocLayoutElementType.PlainText).describe('纯文本'),
+	z.literal(DocLayoutElementType.Abandon).describe('废弃'),
+	z.literal(DocLayoutElementType.Figure).describe('图片'),
+	z.literal(DocLayoutElementType.FigureCaption).describe('图片说明'),
+	z.literal(DocLayoutElementType.Table).describe('表格'),
+	z.literal(DocLayoutElementType.TableCaption).describe('表格标题'),
+	z.literal(DocLayoutElementType.TableFootnote).describe('表格脚注'),
+	z.literal(DocLayoutElementType.IsolateFormula).describe('独立公式'),
+	z.literal(DocLayoutElementType.FormulaCaption).describe('公式说明'),
+]);

package/src/ai/vision/ImageAnnotationSchema.ts

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+
+export type ImageAnnotation = z.infer<typeof ImageAnnotationSchema>;
+export const ImageAnnotationSchema = z.looseObject({
+	id: z.string().optional(),
+	title: z.string().trim().optional().describe('标题'),
+	description: z.string().trim().optional().describe('描述'),
+	type: z.string().trim().optional().describe('类型'),
+
+	// 内容字段
+	text: z.string().optional().describe('文本内容'),
+	markdown: z.string().optional().describe('Markdown 内容'),
+	csv: z.string().optional().describe('CSV 内容'),
+	html: z.string().optional().describe('HTML 内容'),
+	data: z.any().optional().describe('任意数据'),
+
+	// 定位信息
+	field: z.string().trim().optional().describe('目标字段'),
+	file: z.string().trim().optional().describe('源文件'),
+	page: z.coerce.number().int().nonnegative().optional().describe('页码'),
+
+	// 几何/边界框信息
+	bbox: z.array(z.number()).optional().describe('边界框'),
+	xywh: z
+		.array(z.number())
+		.length(4, { error: 'xywh 必须包含4个数字 [x, y, width, height]' })
+		.optional()
+		.describe('XYWH'),
+	xyxy: z.array(z.number()).length(4, { error: 'xyxy 必须包含4个数字 [x1, y1, x2, y2]' }).optional().describe('XYXY'),
+	polygon: z.array(z.number().array()).optional().describe('Polygon'),
+	x: z.coerce.number().optional().describe('X 坐标'),
+	y: z.coerce.number().optional().describe('Y 坐标'),
+	w: z.coerce.number().nonnegative().optional().describe('宽度'),
+	h: z.coerce.number().nonnegative().optional().describe('高度'),
+
+	label: z.string().trim().optional().describe('标签'),
+	confidence: z.coerce.number().min(0).max(1).optional().describe('置信度'),
+	score: z.coerce.number().optional().describe('原始分数'),
+
+	classes: z
+		.array(
+			z.object({
+				label: z.string().nonempty({ error: '分类标签不能为空' }).describe('分类标签'),
+				confidence: z.coerce.number().min(0).max(1).optional().describe('分类置信度 (0-1)'),
+				score: z.coerce.number().optional().describe('分类原始分数'),
+			}),
+		)
+		.optional()
+		.describe('多分类结果'),
+
+	// 元数据和标签
+	tags: z.array(z.string()).optional().describe('标签'),
+	metadata: z.record(z.string(), z.any()).optional().describe('元数据'),
+	attributes: z.record(z.string(), z.any()).optional().describe('属性'),
+	properties: z.record(z.string(), z.any()).optional().describe('属性'),
+
+	get annotations(): z.ZodOptional<z.ZodArray<typeof ImageAnnotationSchema>> {
+		return z.array(ImageAnnotationSchema).optional().describe('子注释');
+	},
+});

package/src/ai/vision/index.ts

@@ -0,0 +1,2 @@
+export { ImageAnnotationSchema, type ImageAnnotation } from './ImageAnnotationSchema';
+export { resolveImageAnnotation, type ResolvedImageAnnotation } from './resolveImageAnnotation';

package/src/ai/vision/resolveImageAnnotation.ts

@@ -0,0 +1,135 @@
+import type { ImageAnnotation } from './ImageAnnotationSchema';
+
+export { resolveImageAnnotation };
+
+export type ResolvedImageAnnotation = Omit<ImageAnnotation, 'id' | 'annotations' | 'attributes' | 'metadata'> & {
+	id: string;
+	annotations: ResolvedImageAnnotation[];
+	attributes: Record<string, any>;
+	metadata: Record<string, any>;
+};
+
+function resolveImageAnnotation(input: Partial<ImageAnnotation>): ResolvedImageAnnotation {
+	const normalize = (
+		input: ImageAnnotation,
+		{
+			path = [],
+			level = 0,
+		}: {
+			path?: number[];
+			level?: number;
+		} = {},
+	) => {
+		input.id ||= path.join('.') || 'ROOT';
+		input.annotations ||= [];
+		input.tags ||= [];
+		input.attributes ||= {};
+		input.metadata ||= {};
+
+		if (!input.csv && input.html?.includes('<table') && globalThis.DOMParser) {
+			const parser = new DOMParser();
+			const doc = parser.parseFromString(input.html, 'text/html');
+			const table = doc.querySelector('table');
+
+			if (table) {
+				const rows = Array.from(table.querySelectorAll('tr'));
+				input.data = rows.map((row) =>
+					Array.from(row.querySelectorAll('td')).map((td) => td.textContent?.trim() || ''),
+				);
+			}
+		}
+		input.annotations.forEach((v, i) => normalize(v, { path: [...path, i], level: level + 1 }));
+
+		resolveBBox(input);
+
+		// can get bbox from annotations
+		let first = input.annotations.find((v) => v.xyxy)?.xyxy;
+		if (!input.xyxy && first) {
+			const xyxy = input.annotations.reduce((acc, v) => {
+				if (!v.xyxy) return acc;
+				return [
+					Math.min(acc[0], v.xyxy[0]),
+					Math.min(acc[1], v.xyxy[1]),
+					Math.max(acc[2], v.xyxy[2]),
+					Math.max(acc[3], v.xyxy[3]),
+				];
+			}, first);
+			input.xyxy = xyxy;
+			input.xywh = xyxy2xywh(xyxy);
+		}
+	};
+
+	const out = input as ResolvedImageAnnotation;
+	normalize(out);
+	// out.annotations.forEach((v) => norm(v));
+
+	// only merge for root node
+
+	if (!out.markdown) {
+		out.markdown = out.annotations.map((v) => v.markdown).join('\n');
+		out.markdown ||= undefined;
+	}
+	if (!out.text) {
+		out.text = out.annotations.map((v) => v.text).join('\n');
+		out.text ||= undefined;
+	}
+	// fallback
+	out.text ||= out.markdown;
+	out.markdown ||= out.text;
+	return out;
+}
+
+function xywh2xyxy(input?: number[]) {
+	if (!input) return;
+	const [x, y, w, h] = input;
+	return [x, y, x + w, y + h];
+}
+
+function xyxy2xywh(input?: number[]) {
+	if (!input) return;
+	const [x1, y1, x2, y2] = input;
+	return [x1, y1, x2 - x1, y2 - y1];
+}
+
+type BBoxObject = {
+	xywh: number[];
+	xyxy: number[];
+	x: number;
+	y: number;
+	w: number;
+	h: number;
+};
+
+function resolveBBox(input: {
+	xywh?: number[];
+	xyxy?: number[];
+	x?: number;
+	y?: number;
+	w?: number;
+	h?: number;
+}): BBoxObject | undefined {
+	let { x, y, w, h } = input as {
+		x: number;
+		y: number;
+		w: number;
+		h: number;
+	};
+	let isNil = (v: any) => v === undefined || v === null;
+	if (isNil(x) && input.xywh?.length) {
+		[x, y, w, h] = input.xywh;
+	}
+	if (isNil(x) && input.xyxy?.length) {
+		[x, y, w, h] = xyxy2xywh(input.xyxy)!;
+	}
+	if (!isNil(x)) {
+		input.xywh ||= [x, y, w, h];
+		input.xyxy ||= xywh2xyxy(input.xywh);
+		input.x = x;
+		input.y = y;
+		input.w = w;
+		input.h = h;
+
+		return input as BBoxObject;
+	}
+	return;
+}

package/src/cn/ChineseResidentIdNo.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { ChineseResidentIdNo } from './mod';
+import { ChineseResidentIdNo } from './index';
 
 describe('ChineseResidentIdNo', () => {
 	it('should parse', () => {

package/src/cn/ChineseResidentIdNo.ts

@@ -64,3 +64,11 @@ export function formatChineseResidentIdNo({
 			: checkDigit?.toUpperCase() || Mod11.compute(major);
 	return `${major}${check}`;
 }
+
+export namespace ChineseResidentIdNo {
+	export const regex = ChineseResidentIdNoRegex;
+	export const parse = parseChineseResidentIdNo;
+	export const format = formatChineseResidentIdNo;
+	export type Result = ParsedChineseResidentIdNo;
+	export const ResultSchema = ParsedChineseResidentIdNoSchema;
+}

package/src/cn/DivisionCode.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { DivisionCode } from './mod';
+import { DivisionCode } from './index';
 
 describe('DivisionCode', () => {
 	it('should parse', () => {

package/src/cn/DivisionCode.ts

@@ -144,3 +144,11 @@ export function formatDivisionCode({
 
 	return codes.join('');
 }
+
+export namespace DivisionCode {
+	export const regex = DivisionCodeRegex;
+	export const parse = parseDivisionCode;
+	export const format = formatDivisionCode;
+	export type Result = ParsedDivisionCode;
+	export const ResultSchema = ParsedDivisionCodeSchema;
+}

package/src/cn/UnifiedSocialCreditCode.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { UnifiedSocialCreditCode } from './mod';
+import { UnifiedSocialCreditCode } from './index';
 
 describe('UnifiedSocialCreditCode', () => {
 	it('should parse', () => {

package/src/cn/UnifiedSocialCreditCode.ts

@@ -121,3 +121,18 @@ export function next(s: string, delta: number = 1) {
 	}
 	return sp.map((v) => Mod31.chars[v]).join('');
 }
+
+export namespace UnifiedSocialCreditCode {
+	export const regex = UnifiedSocialCreditCodeRegex;
+	export const parse = parseUnifiedSocialCreditCode;
+	export const format = formatUnifiedSocialCreditCode;
+	export type Result = ParsedUnifiedSocialCreditCode;
+	export const ResultSchema = ParsedUnifiedSocialCreditCodeSchema;
+	export function test(s: string | undefined | null) {
+		if (!s) {
+			return false;
+		}
+		// fast check
+		return regex.test(s) && Mod31.validate(s);
+	}
+}

package/src/cn/__snapshots__/UnifiedSocialCreditCode.test.ts.snap

@@ -45,3 +45,26 @@ exports[`UnifiedSocialCreditCode > should parse 2`] = `
   "valid": true,
 }
 `;
+
+exports[`UnifiedSocialCreditCode > should parse 3`] = `
+{
+  "adminDivisionCode": "310120",
+  "checkDigit": "0",
+  "codes": [
+    "9",
+    "1",
+    "310120",
+    "MAEXK9GG9",
+    "0",
+  ],
+  "entityCategoryCode": "1",
+  "names": [
+    "工商",
+    "企业",
+  ],
+  "organizationCode": "MAEXK9GG9",
+  "raw": "91310120MAEXK9GG90",
+  "registrationAuthorityCode": "9",
+  "valid": false,
+}
+`;

package/src/cn/formatChineseAmount.ts

@@ -0,0 +1,61 @@
+/**
+ * @see https://gist.github.com/tonyc726/00c829a54a40cf80409f
+ * @see https://github.com/Siykt/javascript-algorithms/blob/master/src/algorithms/string/getChinesePrice.ts 人民币金额转中文大写
+ */
+export function formatChineseAmount(price: number) {
+	if (price === 0) return '零元整';
+	if (price >= 1e12) return '整数位已超过最大值';
+
+	const CHINESE_NUMBER_MAP = ['零', '壹', '贰', '叁', '肆', '伍', '陆', '柒', '捌', '玖'];
+	const CHINESE_UNIT_MAP = ['', '拾', '佰', '仟'];
+	const CHINESE_BIG_UNIT_MAP = ['', '万', '亿'];
+	const CHINESE_SMALL_UNIT_MAP = ['角', '分', '厘', '毫'];
+
+	const priceStr = price.toString();
+	const priceArr = priceStr.split('.');
+	const integer = priceArr[0];
+	const decimal = priceArr[1];
+
+	let chineseIntegerPrice = '';
+	let zeroCount = 0;
+
+	for (let i = 0; i < integer.length; i++) {
+		const num = +integer[i];
+		const unit = integer.length - i - 1; // 当前数字的单位
+		const quotient = Math.floor(unit / 4); // 1w为进位单位, 除 4 即为 万 亿
+		const remainder = unit % 4; // 1w为进位单位, 取模 4 即为 个 十 百 千
+
+		if (num === 0) {
+			zeroCount++;
+		} else {
+			// 处理前置的零
+			if (zeroCount > 0) chineseIntegerPrice += CHINESE_NUMBER_MAP[0];
+			zeroCount = 0;
+			chineseIntegerPrice += CHINESE_NUMBER_MAP[num] + CHINESE_UNIT_MAP[remainder];
+		}
+		if (remainder === 0 && zeroCount < 4) {
+			chineseIntegerPrice += CHINESE_BIG_UNIT_MAP[quotient];
+		}
+	}
+
+	// 价格为小数时，整数部分不显示
+	if (price < 1) chineseIntegerPrice = '';
+	else chineseIntegerPrice += '元';
+
+	let chineseDecimalPrice = '';
+
+	if (!decimal) {
+		chineseDecimalPrice = '整';
+	} else {
+		let hasZero = false;
+		for (let i = 0; i < decimal.length; i++) {
+			const num = +decimal[i];
+			if (num) chineseDecimalPrice += CHINESE_NUMBER_MAP[num] + CHINESE_SMALL_UNIT_MAP[i];
+			else hasZero = true;
+		}
+
+		if (chineseIntegerPrice && hasZero) chineseIntegerPrice += '零';
+	}
+
+	return chineseIntegerPrice + chineseDecimalPrice;
+}

package/src/cn/index.ts

@@ -1 +1,7 @@
-export { ChineseResidentIdNo, UnifiedSocialCreditCode, DivisionCode } from './mod';
+export { ChineseResidentIdNo } from './ChineseResidentIdNo';
+export { UnifiedSocialCreditCode } from './UnifiedSocialCreditCode';
+export { DivisionCode } from './DivisionCode';
+
+export * from './formatChineseAmount';
+export * from './parseChineseNumber';
+export * from './pinyin/toPinyinPure';