@wener/common 2.0.1 → 2.0.3

package/lib/utils/resolveFeatureOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/resolveFeatureOptions.ts"],"sourcesContent":["import { maybeFunction, type MaybeFunction } from '@wener/utils';\n\nexport function resolveFeatureOptions<T>(\n\tvalue: boolean | T | undefined | null,\n\tdefaultValue: MaybeFunction<T>,\n): T | undefined {\n\tif (value === false) {\n\t\treturn undefined;\n\t}\n\tif (value === true || value === undefined || value === null) {\n\t\treturn maybeFunction(defaultValue);\n\t}\n\treturn value;\n}\n"],"names":["maybeFunction","resolveFeatureOptions","value","defaultValue","undefined"],"mappings":"AAAA,SAASA,aAAa,QAA4B,eAAe;AAEjE,OAAO,SAASC,sBACfC,KAAqC,EACrCC,YAA8B;IAE9B,IAAID,UAAU,OAAO;QACpB,OAAOE;IACR;IACA,IAAIF,UAAU,QAAQA,UAAUE,aAAaF,UAAU,MAAM;QAC5D,OAAOF,cAAcG;IACtB;IACA,OAAOD;AACR"}

package/package.json

@@ -1,9 +1,15 @@
 {
   "name": "@wener/common",
-  "version": "2.0.1",
+  "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": {
     ".": {
@@ -22,6 +28,34 @@
       "types": "./src/data/index.ts",
       "default": "./lib/data/index.js"
     },
+    "./dayjs": {
+      "types": "./src/dayjs/index.ts",
+      "default": "./lib/dayjs/index.js"
+    },
+    "./decimal": {
+      "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"
@@ -30,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"
@@ -38,13 +76,21 @@
       "types": "./src/resource/index.ts",
       "default": "./lib/resource/index.js"
     },
+    "./resource/schema": {
+      "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"
     },
-    "./search": {
-      "types": "./src/search/index.ts",
-      "default": "./lib/search/index.js"
+    "./utils": {
+      "types": "./src/utils/index.ts",
+      "default": "./lib/utils/index.js"
     },
     "./package.json": "./package.json"
   },
@@ -56,33 +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.37.2",
-    "std-env": "^3.9.0",
-    "ts-pattern": "^5.7.0"
+    "es-toolkit": "^1.43.0",
+    "std-env": "^3.10.0",
+    "ts-pattern": "^5.9.0"
   },
   "devDependencies": {
-    "@sinclair/typebox": "^0.34.33",
+    "@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": "^5.0.2",
-    "ajv": "^8.17.1",
+    "@types/bcrypt": "^6.0.0",
+    "@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.43.0",
+    "argon2": "^0.44.0",
     "argon2-browser": "^1.18.0",
-    "bcrypt": "^5.1.1",
-    "bcryptjs": "^3.0.2",
-    "chalk": "^5.4.1",
+    "bcrypt": "^6.0.0",
+    "bcryptjs": "^3.0.3",
+    "chalk": "^5.6.2",
     "consola": "^3.4.2",
-    "dayjs": "^1.11.13",
-    "zod": "^3.25.63"
+    "dayjs": "^1.11.19",
+    "decimal.js": "^10.6.0",
+    "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

@@ -0,0 +1,18 @@
+import { describe, expect, it } from 'vitest';
+import { ChineseResidentIdNo } from './index';
+
+describe('ChineseResidentIdNo', () => {
+	it('should parse', () => {
+		for (const a of ['11010519491231002X']) {
+			let out = ChineseResidentIdNo.parse(a);
+			expect(out).toBeTruthy();
+			expect(ChineseResidentIdNo.format(out!)).toBe(a);
+			expect(out).toMatchSnapshot();
+		}
+	});
+	it('should format with partial', () => {
+		expect(ChineseResidentIdNo.format({ addressCode: '110105', birthDate: new Date('1949-12-31'), sequence: 2 })).toBe(
+			'11010519491231002X',
+		);
+	});
+});

package/src/cn/ChineseResidentIdNo.ts

@@ -0,0 +1,74 @@
+import { z } from 'zod/v4';
+import { SexType, SexTypeSchema } from '../foundation/schema';
+import { Mod11 } from './Mod11';
+
+export const ChineseResidentIdNoRegex =
+	/^(?<division>[1-9]\d{5})(?<year>(18|19|20)\d{2})(?<month>0[1-9]|1[0-2])(?<day>0[1-9]|[12]\d|3[01])(?<sequence>\d{3})(?<checkDigit>[0-9Xx])$/;
+
+export type ParsedChineseResidentIdNo = z.infer<typeof ParsedChineseResidentIdNoSchema>;
+export const ParsedChineseResidentIdNoSchema = z
+	.object({
+		raw: z.string().regex(ChineseResidentIdNoRegex, '无效的18位身份证号码格式').describe('身份证号码'),
+		addressCode: z.string().length(6).describe('地址码 '),
+		birthDate: z.iso.date().describe('出生日期'),
+		sequence: z.int().max(999).min(0).describe('顺序码'),
+		checkDigit: z.int().min(0).max(10).describe('校验码'),
+		sex: SexTypeSchema.describe('性别'),
+		age: z.number().optional(),
+		valid: z.boolean().optional().describe('是否有效'),
+	})
+	.describe('居民身份证号码解析内容');
+
+export function parseChineseResidentIdNo(idNo: string): ParsedChineseResidentIdNo | undefined {
+	const reg = ChineseResidentIdNoRegex;
+	const match = idNo.match(reg);
+	if (!match || !match.groups) {
+		return undefined;
+	}
+	const { division, year, month, day, sequence, checkDigit } = match.groups;
+	let seq = parseInt(sequence, 10);
+	return {
+		raw: idNo,
+		addressCode: division,
+		birthDate: `${year}-${month}-${day}`,
+		sequence: seq,
+		checkDigit: checkDigit.toUpperCase() === 'X' ? 10 : parseInt(checkDigit),
+		sex: seq % 2 === 0 ? SexType.Male : SexType.Female,
+		age: new Date().getFullYear() - parseInt(year, 10),
+		valid: Mod11.validate(idNo),
+	};
+}
+
+export function formatChineseResidentIdNo({
+	addressCode,
+	birthDate,
+	sequence,
+	checkDigit,
+}: {
+	addressCode: string;
+	birthDate: string | Date;
+	sequence: number | string;
+	checkDigit?: string | number;
+}): string {
+	const date =
+		typeof birthDate === 'string'
+			? birthDate.replace(/-/g, '')
+			: `${birthDate.getFullYear()}${String(birthDate.getMonth() + 1).padStart(2, '0')}${String(birthDate.getDate()).padStart(2, '0')}`;
+	const seq = String(sequence).padStart(3, '0');
+	const major = `${addressCode}${date}${seq}`;
+	const check =
+		typeof checkDigit === 'number'
+			? checkDigit === 10
+				? 'X'
+				: String(checkDigit)
+			: 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 './DivisionCode';
+import { DivisionCode } from './index';
 
 describe('DivisionCode', () => {
 	it('should parse', () => {
@@ -7,27 +7,17 @@ describe('DivisionCode', () => {
 			[
 				'441900003001',
 				{
-					province: '44',
-					city: '19',
-					county: '00',
-					town: '003',
-					village: '001',
 					codes: ['44', '19', '00', '003', '001'],
 				},
 			],
 			[
 				441900003001,
 				{
-					province: '44',
-					city: '19',
-					county: '00',
-					town: '003',
-					village: '001',
 					codes: ['44', '19', '00', '003', '001'],
 				},
 			],
-			[441900, { province: '44', city: '19', county: '00' }],
-			['31', { province: '31' }],
+			[441900, { codes: ['44', '19', '00'] }],
+			['31', { codes: ['31'] }],
 			['4', undefined],
 			['', undefined],
 			[null, undefined],