quickwin 3.0.0 → 3.0.2

package/lib/windows/version.d.ts

@@ -0,0 +1,27 @@
+/** 取文件版本资源大小
+ *  @returns 字节数（0 = 文件无版本资源）
+ *  @param args_0 lptstrFilename 文件路径（禁空）
+ *  @param args_1 lpdwHandle 出参槽（Info 步的入参句柄，MSDN 恒 0 但仍须传），
+ *                PtrArrayBuffer(4) + Uint32Array 读回 */
+export declare const GetFileVersionInfoSize: (args_0: string | (number & {
+    readonly ptrBrand: "WCHAR";
+}), args_1: import("../ffi/ctype.js").PtrArrayBuffer<any> | import("../ffi/ctype.js").MaybePtr<"BYTE">) => number;
+/** 读版本资源进缓冲
+ *  @returns 成功 → 非 0
+ *  @param args_0 lptstrFilename 文件路径（禁空）
+ *  @param args_1 dwHandle Size 步读回的句柄（恒 0）
+ *  @param args_2 dwLen 缓冲字节数（= Size 返回值）
+ *  @param args_3 lpData 接收缓冲（PtrArrayBuffer(dwLen)） */
+export declare const GetFileVersionInfo: (args_0: string | (number & {
+    readonly ptrBrand: "WCHAR";
+}), args_1: number, args_2: number, args_3: import("../ffi/ctype.js").PtrArrayBuffer<any> | import("../ffi/ctype.js").MaybePtr<"BYTE">) => number;
+/** 在版本资源缓冲内查询子块
+ *  @returns 成功 → 非 0
+ *  @param args_0 pBlock Info 步的资源缓冲（PtrArrayBuffer 直传）
+ *  @param args_1 lpszSubBlock 子块路径（禁空）：'\\' = 根块 VS_FIXEDFILEINFO、
+ *                '\\StringFileInfo\\040904B0\\FileVersion' 等字符串表项
+ *  @param args_2 lplpBuffer 出参槽（块内偏移指针写回），PtrArrayBuffer(8)
+ *  @param args_3 puLen 出参槽（块字节数，VS_FIXEDFILEINFO = 52），PtrArrayBuffer(4) */
+export declare const VerQueryValue: (args_0: import("../ffi/ctype.js").PtrArrayBuffer<any> | import("../ffi/ctype.js").MaybePtr<"BYTE">, args_1: string | (number & {
+    readonly ptrBrand: "WCHAR";
+}), args_2: import("../ffi/ctype.js").PtrArrayBuffer<any> | import("../ffi/ctype.js").MaybePtr<"BYTE">, args_3: import("../ffi/ctype.js").PtrArrayBuffer<any> | import("../ffi/ctype.js").MaybePtr<"BYTE">) => number;

package/lib/windows/{winspool.ts → winspool.d.ts}

@@ -1,19 +1,3 @@
-// winspool.drv 绑定（打印后台处理：枚举 / 能力查询 / 原始作业链；品牌约定见
-// lib/windows/user32.ts 头注释）：
-//   - 打印机句柄（OpenPrinter 的 HPRINTER* 出参槽写回）位宽无关：出参槽 = <BYTE>ptr
-//     收 PtrArrayBuffer(8) + readPtr 读回 number，作业链句柄位 <>ptr 收宽（批 5 HKey 同型）
-//   - 结构位按方向分流（结构定义见 ./structs.ts）：DOC_INFO_1W 纯入参位注册 encoder →
-//     对象直传；PRINTER_INFO_2W 出参数组不注册 → structArray(PRINTER_INFO_2W).decode
-//     (buf, count) 读回（缓冲尾部含字符串，须显式 count），指针字段跟进读字符串
-//   - 枚举标注：DeviceCap 是单选查询位标枚举；PrinterEnum 是 LOCAL|CONNECTIONS 可组合
-//     flags → 裸 u32 + JSDoc（组合 OR 结果不是枚举成员，位标枚举反而传不进）
-import { bind, type CodecMap } from '../ffi/bind.js'
-import { DOC_INFO_1W } from './structs.js'
-
-// dll 名部分应用（工厂转调保泛型 infer，见 lib/windows/user32.ts 头注释）
-const b = <const S extends string, const LE extends CodecMap = {}>(name: string, sig: S, encoders?: LE) =>
-    bind('winspool.drv', name, sig, encoders)
-
 /** 枚举打印队列（Level=2 → PRINTER_INFO_2W 数组）；两段式：先
  *  NULL+cbBuf 0 拿 pcbNeeded，再按需分配缓冲重调
  *  @returns 成功 → 非 0
@@ -25,15 +9,12 @@ const b = <const S extends string, const LE extends CodecMap = {}>(name: string,
  *  @param args_4 cbBuf 缓冲字节数
  *  @param args_5 pcbNeeded 出参槽（需求字节数）PtrArrayBuffer(4)
  *  @param args_6 pcReturned 出参槽（返回条数）PtrArrayBuffer(4) */
-export const EnumPrinters = /*@__PURE__*/ b('EnumPrintersW',
-    'u32 <WCHAR>ptr u32 <BYTE>ptr u32 <BYTE>ptr <BYTE>ptr -> i32')
-
+export declare const EnumPrinters: (args_0: number, args_1: string | import("../ffi/ctype.js").MaybePtr<"WCHAR">, args_2: number, args_3: import("../ffi/ctype.js").PtrArrayBuffer<any> | import("../ffi/ctype.js").MaybePtr<"BYTE">, args_4: number, args_5: import("../ffi/ctype.js").PtrArrayBuffer<any> | import("../ffi/ctype.js").MaybePtr<"BYTE">, args_6: import("../ffi/ctype.js").PtrArrayBuffer<any> | import("../ffi/ctype.js").MaybePtr<"BYTE">) => number;
 /** 取默认打印机名
  *  @returns 成功 → 非 0，0 = 失败（缓冲不足时 pcchBuffer 带回所需长度）
  *  @param args_0 pszBuffer 出参缓冲，WCHAR.alloc(n)、WCHAR.decode 读回
  *  @param args_1 pcchBuffer 出入长度槽（入 = 缓冲 WCHAR 容量，出 = 实际长度），PtrArrayBuffer(4) */
-export const GetDefaultPrinter = /*@__PURE__*/ b('GetDefaultPrinterW', '<BYTE>ptr <BYTE>ptr -> i32')
-
+export declare const GetDefaultPrinter: (args_0: import("../ffi/ctype.js").PtrArrayBuffer<any> | import("../ffi/ctype.js").MaybePtr<"BYTE">, args_1: import("../ffi/ctype.js").PtrArrayBuffer<any> | import("../ffi/ctype.js").MaybePtr<"BYTE">) => number;
 /** 查设备能力；nCapability 单选 DeviceCap.*
  *  @returns 返回值随能力（数值能力 = 数值，
  *  -1 = 失败）
@@ -42,39 +23,44 @@ export const GetDefaultPrinter = /*@__PURE__*/ b('GetDefaultPrinterW', '<BYTE>pt
  *  @param args_2 nCapability 能力码（DeviceCap.HORZRES 等单选）
  *  @param args_3 pOutput 字符串列表型能力的缓冲；数值型查询传 NULL
  *  @param args_4 pDevmode DEVMODE，传 NULL */
-export const DeviceCapabilities = /*@__PURE__*/ b('DeviceCapabilitiesW',
-    '<WCHAR>ptr! <WCHAR>ptr u32@DeviceCap <BYTE>ptr <>ptr -> i32')
-
+export declare const DeviceCapabilities: (args_0: string | (number & {
+    readonly ptrBrand: "WCHAR";
+}), args_1: string | import("../ffi/ctype.js").MaybePtr<"WCHAR">, args_2: import("../../constants.js").DeviceCap, args_3: import("../ffi/ctype.js").PtrArrayBuffer<any> | import("../ffi/ctype.js").MaybePtr<"BYTE">, args_4: import("../ffi/ctype.js").MaybePtr<"">) => number;
 /** 打开打印机对象（不产生打印作业）
  *  @returns 成功 → 非 0，hPrinter 写回
  *  @param args_0 pPrinterName 打印机名（禁空）
  *  @param args_1 phPrinter 出参槽（句柄写回），PtrArrayBuffer(8) + readPtr 读回
  *  @param args_2 pDefault 默认值（Datatype/DevMode/DesiredAccess），传 NULL 全默认 */
-export const OpenPrinter = /*@__PURE__*/ b('OpenPrinterW', '<WCHAR>ptr! <BYTE>ptr <>ptr -> i32')
+export declare const OpenPrinter: (args_0: string | (number & {
+    readonly ptrBrand: "WCHAR";
+}), args_1: import("../ffi/ctype.js").PtrArrayBuffer<any> | import("../ffi/ctype.js").MaybePtr<"BYTE">, args_2: import("../ffi/ctype.js").MaybePtr<"">) => number;
 /** 关闭打印机句柄
  *  @returns 成功 → 非 0 */
-export const ClosePrinter = /*@__PURE__*/ b('ClosePrinter', '<>ptr -> i32')
+export declare const ClosePrinter: (args_0: import("../ffi/ctype.js").MaybePtr<"">) => number;
 /** 起打印作业
  *  @returns 作业 id（0 = 失败）
  *  @param args_0 hPrinter 打印机句柄
  *  @param args_1 dwLevel 固定 1（DOC_INFO_1W）
  *  @param args_2 pDocInfo DOC_INFO_1W 对象（指针字段收裸地址 number：WCHAR.encode(s).ptr，
  *                PAB 须在调用返回前保持引用） */
-export const StartDocPrinter = /*@__PURE__*/ b('StartDocPrinterW', '<>ptr u32 <DOC_INFO_1W>ptr -> u32',
-    { DOC_INFO_1W })
+export declare const StartDocPrinter: (args_0: import("../ffi/ctype.js").MaybePtr<"">, args_1: number, args_2: {
+    pDatatype?: import("../ffi/ctype.js").MaybePtr<""> | undefined;
+    pDocName?: import("../ffi/ctype.js").MaybePtr<""> | undefined;
+    pOutputFile?: import("../ffi/ctype.js").MaybePtr<""> | undefined;
+} | import("../ffi/ctype.js").MaybePtr<"DOC_INFO_1W">) => number;
 /** 结束打印作业（提交）
  *  @returns 成功 → 非 0 */
-export const EndDocPrinter = /*@__PURE__*/ b('EndDocPrinter', '<>ptr -> i32')
+export declare const EndDocPrinter: (args_0: import("../ffi/ctype.js").MaybePtr<"">) => number;
 /** 起页
  *  @returns 成功 → 非 0 */
-export const StartPagePrinter = /*@__PURE__*/ b('StartPagePrinter', '<>ptr -> i32')
+export declare const StartPagePrinter: (args_0: import("../ffi/ctype.js").MaybePtr<"">) => number;
 /** 结束页
  *  @returns 成功 → 非 0 */
-export const EndPagePrinter = /*@__PURE__*/ b('EndPagePrinter', '<>ptr -> i32')
+export declare const EndPagePrinter: (args_0: import("../ffi/ctype.js").MaybePtr<"">) => number;
 /** 写作业数据（RAW 直写 spooler）
  *  @returns 成功 → 非 0
  *  @param args_0 hPrinter 打印机句柄
  *  @param args_1 lpBuffer 数据缓冲（<BYTE>ptr，PtrArrayBuffer）
  *  @param args_2 nNumberOfBytesToWrite 写入字节数
  *  @param args_3 lpNumberOfBytesWritten 出参槽，PtrArrayBuffer(4) 读实际写入字节数 */
-export const WritePrinter = /*@__PURE__*/ b('WritePrinter', '<>ptr <BYTE>ptr u32 <BYTE>ptr -> i32')
+export declare const WritePrinter: (args_0: import("../ffi/ctype.js").MaybePtr<"">, args_1: import("../ffi/ctype.js").PtrArrayBuffer<any> | import("../ffi/ctype.js").MaybePtr<"BYTE">, args_2: number, args_3: import("../ffi/ctype.js").PtrArrayBuffer<any> | import("../ffi/ctype.js").MaybePtr<"BYTE">) => number;

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "quickwin",
-  "version": "3.0.0",
+  "version": "3.0.2",
   "description": "QuickJS Win32 runtime — GUI, networking, WASM, FFI, and more",
   "bin": {
     "quickwin": "qwin.exe",
@@ -20,8 +20,6 @@
     "qwin-nowasm-x86.exe",
     "main.js",
     "lib/",
-    "test/",
-    "examples/",
     "quickwin.d.ts",
     "constants.ts",
     "enum_map.d.ts",
@@ -34,18 +32,27 @@
     "type": "git",
     "url": "git+https://github.com/quickwinlabs/quickwin.git"
   },
+  "dependencies": {
+    "@types/react-reconciler": "^0.33.0",
+    "react-reconciler": "^0.33.0"
+  },
+  "peerDependencies": {
+    "@types/react": "^19.2.17",
+    "react": "^19.2.7"
+  },
+  "peerDependenciesMeta": {
+    "@types/react": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@quickwinlabs/mupdf-wasm": "^1.28.0",
     "@types/node": "^24.13.2",
     "@types/react": "^19.2.17",
-    "@types/react-reconciler": "^0.33.0",
     "@types/ws": "^8.18.1",
     "esbuild": "^0.28.0",
-    "typescript": "^7.0.2"
-  },
-  "dependencies": {
     "react": "^19.2.7",
-    "react-reconciler": "^0.33.0",
+    "typescript": "^7.0.2",
     "web-streams-polyfill": "^4.3.0",
     "ws": "^8.21.0"
   }

package/examples/PdfCanvas.js

@@ -1,38 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { forwardRef, useRef } from 'react';
-import { GetDC, ReleaseDC } from '../lib/windows/user32.js';
-import { SetDIBitsToDevice } from '../lib/windows/gdi32.js';
-import { BITMAPINFOHEADER } from '../lib/windows/structs.js';
-function makeBitmapInfo(w, h) {
-    // biHeight 负 = 自顶向下（DIB 原点左上）；biCompression 缺省 0 = BI_RGB 无压缩
-    return BITMAPINFOHEADER.encode({ biSize: BITMAPINFOHEADER.size, biWidth: w, biHeight: -h, biPlanes: 1, biBitCount: 24 });
-}
-export const PdfCanvas = forwardRef(({ pixmap, style }, ref) => {
-    const canvasRef = useRef(null);
-    const pixmapRef = useRef(pixmap);
-    pixmapRef.current = pixmap;
-    return (_jsx("w", { type: "STATIC", ws: 268435456 /* WindowStyle.VISIBLE */ | 33554432 /* WindowStyle.CLIPCHILDREN */, style: style, ref: (h) => {
-            canvasRef.current = h;
-            if (typeof ref === 'function')
-                ref(h);
-            else if (ref)
-                ref.current = h;
-        }, onEvent: (e) => {
-            const hwnd = e.hwnd;
-            if (e.msg === 0x14)
-                return 1;
-            if (e.msg === 15 /* WmMsg.PAINT */) {
-                const pm = pixmapRef.current;
-                if (!pm)
-                    return 0;
-                const hdc = GetDC(hwnd);
-                if (hdc) {
-                    const bmi = makeBitmapInfo(pm.w, pm.h);
-                    SetDIBitsToDevice(hdc, 0, 0, pm.w, pm.h, 0, 0, 0, pm.h, pm.data, bmi, 0 /* ColorUse.RGB_COLORS */);
-                    ReleaseDC(hwnd, hdc);
-                }
-                return 0;
-            }
-            return;
-        } }));
-});

package/examples/PdfCanvas.tsx

@@ -1,54 +0,0 @@
-import { PtrArrayBuffer } from '../lib/ffi/ctype.js'
-import { forwardRef, useRef } from 'react'
-import * as gui from 'gui'
-import { GetDC, ReleaseDC } from '../lib/windows/user32.js'
-import { SetDIBitsToDevice } from '../lib/windows/gdi32.js'
-import { BITMAPINFOHEADER } from '../lib/windows/structs.js'
-import type { WStyle } from '../lib/react-qw/jsx.d.ts'
-import { ColorUse, WindowStyle, WmMsg } from '../constants'
-
-function makeBitmapInfo(w: number, h: number) {
-  // biHeight 负 = 自顶向下（DIB 原点左上）；biCompression 缺省 0 = BI_RGB 无压缩
-  return BITMAPINFOHEADER.encode({ biSize: BITMAPINFOHEADER.size, biWidth: w, biHeight: -h, biPlanes: 1, biBitCount: 24 })
-}
-
-export interface PdfCanvasProps {
-  pixmap?: { data: PtrArrayBuffer<string>; w: number; h: number }
-  style?: WStyle
-}
-
-export const PdfCanvas = forwardRef<gui.HWND, PdfCanvasProps>(
-  ({ pixmap, style }, ref) => {
-    const canvasRef = useRef<gui.HWND>(null)
-    const pixmapRef = useRef(pixmap)
-    pixmapRef.current = pixmap
-
-    return (
-      <w type="STATIC"
-        ws={WindowStyle.VISIBLE | WindowStyle.CLIPCHILDREN}
-        style={style}
-        ref={(h: gui.HWND) => {
-          canvasRef.current = h
-          if (typeof ref === 'function') ref(h)
-          else if (ref) (ref as React.RefObject<gui.HWND | null>).current = h
-        }}
-        onEvent={(e) => {
-          const hwnd = e.hwnd
-          if (e.msg === 0x14) return 1
-          if (e.msg === WmMsg.PAINT) {
-            const pm = pixmapRef.current
-            if (!pm) return 0
-            const hdc = GetDC(hwnd)
-            if (hdc) {
-              const bmi = makeBitmapInfo(pm.w, pm.h)
-              SetDIBitsToDevice(hdc, 0, 0, pm.w, pm.h, 0, 0, 0, pm.h, pm.data, bmi, ColorUse.RGB_COLORS)
-              ReleaseDC(hwnd, hdc)
-            }
-            return 0
-          }
-          return
-        }}
-      />
-    )
-  }
-)