quickwin 3.0.0 → 3.0.2

package/lib/http-server.d.ts

@@ -0,0 +1,59 @@
+import './polyfill.js';
+import * as sock from 'sock';
+import { RequestImpl } from './http-common.js';
+import { AbortController } from './abort.js';
+type SockHandle = import('sock').SockHandle;
+export type ServerHandler = (req: Request) => Promise<Response>;
+interface ParsedHeader {
+    method: string;
+    target: string;
+    version: string;
+    headers: Record<string, string>;
+    chunked: boolean;
+    contentLength: number;
+}
+interface PendingReq {
+    parsed: ParsedHeader;
+    bodyStart: number;
+}
+interface ActiveReq {
+    req: RequestImpl;
+}
+interface Conn {
+    sock: SockHandle;
+    parts: Uint8Array[];
+    /** Cached total length of `parts` — lets the pending-body wait check
+     *  "have we received enough yet" in O(1) instead of re-concatenating
+     *  every received byte on each read event (O(n²) for large bodies). */
+    partsLen: number;
+    pending: PendingReq | null;
+    current: ActiveReq | null;
+    outQueue: Uint8Array | null;
+    resumeRead: (() => void) | null;
+    closed: boolean;
+    closeAfterFlush: boolean;
+    keepAlive: boolean;
+    owner: HttpServer;
+    /** AbortController for the request currently served on this connection,
+     *  aborted when the client disconnects mid-response. */
+    ac: AbortController | null;
+}
+export declare class HttpServer {
+    readonly handler: ServerHandler;
+    private serverSock;
+    readonly conns: Map<sock.SockHandle, Conn>;
+    private closed;
+    constructor(handler: ServerHandler);
+    /** Actual bound address, or null if not listening. */
+    address(): {
+        addr: string;
+        port: number;
+    } | null;
+    /** Bind and start listening. Returns 0 on success, -1 on failure. */
+    listen(port: number, host?: string, backlog?: number): number;
+    close(): void;
+    private acceptLoop;
+    private onConnEvent;
+}
+export declare function createServer(handler: ServerHandler): HttpServer;
+export {};

package/lib/polyfill.d.ts

@@ -0,0 +1,22 @@
+import * as os from 'os';
+import './url.js';
+import './text-codec.js';
+declare global {
+    interface Console {
+        error: (...args: unknown[]) => void;
+    }
+    var window: typeof globalThis;
+    type TimerId = os.TimerId;
+    function setTimeout<P extends unknown[]>(fn: (...argsf: P) => void, ms?: number, ...argsr: P): TimerId;
+    function clearTimeout(id: TimerId): void;
+    function btoa(data: string): string;
+    function atob(data: string): string;
+    interface SubtleCrypto {
+        digest(algorithm: 'SHA-1', data: ArrayBuffer | Uint8Array): Promise<ArrayBuffer>;
+    }
+    interface Crypto {
+        getRandomValues<T extends ArrayBufferView>(array: T): T;
+        subtle: SubtleCrypto;
+    }
+    var crypto: Crypto;
+}

package/lib/react-qw/components/Button.d.ts

@@ -0,0 +1,9 @@
+import * as gui from 'gui';
+import type { WStyle } from '../jsx.d.ts';
+export interface ButtonProps {
+    children?: string | number | (string | number)[];
+    onClick?: () => void;
+    style?: WStyle;
+    disabled?: boolean;
+}
+export declare const Button: import("react").ForwardRefExoticComponent<ButtonProps & import("react").RefAttributes<gui.HWND>>;

package/lib/react-qw/components/CheckBox.d.ts

@@ -0,0 +1,11 @@
+import * as gui from 'gui';
+import type { WStyle } from '../jsx.d.ts';
+export interface CheckBoxProps {
+    checked?: boolean;
+    defaultChecked?: boolean;
+    onChange?: (checked: boolean) => void;
+    label?: string;
+    style?: WStyle;
+    disabled?: boolean;
+}
+export declare const CheckBox: import("react").ForwardRefExoticComponent<CheckBoxProps & import("react").RefAttributes<gui.HWND>>;

package/lib/react-qw/components/ComboBox.d.ts

@@ -0,0 +1,11 @@
+import * as gui from 'gui';
+import type { WStyle } from '../jsx.d.ts';
+export interface ComboBoxProps {
+    items: string[];
+    selectedIndex?: number;
+    defaultSelectedIndex?: number;
+    onChange?: (index: number) => void;
+    style?: WStyle;
+    disabled?: boolean;
+}
+export declare const ComboBox: import("react").ForwardRefExoticComponent<ComboBoxProps & import("react").RefAttributes<gui.HWND>>;

package/lib/react-qw/components/DateTimePicker.d.ts

@@ -0,0 +1,15 @@
+import * as gui from 'gui';
+import type { WStyle } from '../jsx.d.ts';
+export interface DateTimePickerProps {
+    value?: Date | null;
+    onChange?: (date: Date | null) => void;
+    defaultValue?: Date;
+    format?: 'short' | 'long' | 'time';
+    allowNone?: boolean;
+    updown?: boolean;
+    style?: WStyle;
+}
+declare const DateTimePicker: (props: DateTimePickerProps & {
+    ref?: React.Ref<gui.HWND>;
+}) => React.ReactElement;
+export { DateTimePicker };

package/lib/react-qw/components/Input.d.ts

@@ -0,0 +1,15 @@
+import * as gui from 'gui';
+import type { WStyle } from '../jsx.d.ts';
+export interface InputProps {
+    value?: string;
+    defaultValue?: string;
+    onChange?: (value: string) => void;
+    placeholder?: string;
+    password?: boolean;
+    multiline?: boolean;
+    readonly?: boolean;
+    number?: boolean;
+    disabled?: boolean;
+    style?: WStyle;
+}
+export declare const Input: import("react").ForwardRefExoticComponent<InputProps & import("react").RefAttributes<gui.HWND>>;

package/lib/react-qw/components/Link.d.ts

@@ -0,0 +1,12 @@
+import * as gui from 'gui';
+import type { WStyle } from '../jsx.d.ts';
+export interface LinkProps {
+    href?: string;
+    children?: string;
+    onClick?: (url: string) => void;
+    style?: WStyle;
+}
+declare const Link: (props: LinkProps & {
+    ref?: React.Ref<gui.HWND>;
+}) => React.ReactElement;
+export { Link };

package/lib/react-qw/components/ListBox.d.ts

@@ -0,0 +1,13 @@
+import * as gui from 'gui';
+import type { WStyle } from '../jsx.d.ts';
+export interface ListBoxProps {
+    items: string[];
+    selectedIndex?: number;
+    defaultSelectedIndex?: number;
+    onChange?: (index: number) => void;
+    style?: WStyle;
+    disabled?: boolean;
+    sort?: boolean;
+    scrollToBottom?: boolean;
+}
+export declare const ListBox: import("react").ForwardRefExoticComponent<ListBoxProps & import("react").RefAttributes<gui.HWND>>;

package/lib/react-qw/components/ListView.d.ts

@@ -0,0 +1,37 @@
+import * as gui from 'gui';
+import type { WStyle } from '../jsx.d.ts';
+import { StandardCursor } from '../../../constants';
+export declare function makeColorBlock(size: number, bgra: number): ArrayBuffer;
+export type Align = 'left' | 'center' | 'right';
+export interface CellStyle {
+    color?: number;
+    background?: number;
+    bold?: boolean;
+    underline?: boolean;
+    italic?: boolean;
+    cursor?: StandardCursor;
+}
+export interface Column<D> {
+    name: string;
+    dataIndex?: keyof D;
+    width?: number;
+    align?: Align;
+    render?: (record: D, index: number) => string;
+    cellStyle?: CellStyle | ((record: D, index: number) => CellStyle);
+    onCellClick?: (record: D, index: number) => void;
+}
+export interface ListViewProps<D extends object> {
+    columns: Column<D>[];
+    data: D[];
+    style?: WStyle;
+    /** 图标像素数据数组，每个元素为 iconSize*iconSize*4 的 BGRA 像素 ArrayBuffer（色块/程序生成） */
+    icons?: ArrayBuffer[];
+    /** 图标尺寸，默认 32 */
+    iconSize?: number;
+    /** 返回记录使用的图标在 icons 中的下标 */
+    getIcon?: (record: D, index: number) => number;
+}
+declare const ListView: <D extends object>(props: ListViewProps<D> & {
+    ref?: React.Ref<gui.HWND>;
+}) => React.ReactElement;
+export { ListView };

package/lib/react-qw/components/PathPicker.d.ts

@@ -0,0 +1,23 @@
+import * as gui from 'gui';
+import type { WStyle } from '../jsx.d.ts';
+interface PathPickerBase {
+    type?: 'file' | 'folder';
+    filter?: string;
+    title?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    style?: WStyle;
+}
+export type PathPickerProps = PathPickerBase & ({
+    multiple: true;
+    value?: string[];
+    defaultValue?: string[];
+    onChange?: (v: string[]) => void;
+} | {
+    multiple?: false;
+    value?: string;
+    defaultValue?: string;
+    onChange?: (v: string) => void;
+});
+export declare const PathPicker: import("react").ForwardRefExoticComponent<PathPickerProps & import("react").RefAttributes<gui.HWND>>;
+export {};

package/lib/react-qw/components/ProgressBar.d.ts

@@ -0,0 +1,9 @@
+import * as gui from 'gui';
+import type { WStyle } from '../jsx.d.ts';
+export interface ProgressBarProps {
+    value?: number;
+    max?: number;
+    style?: WStyle;
+    smooth?: boolean;
+}
+export declare const ProgressBar: import("react").ForwardRefExoticComponent<ProgressBarProps & import("react").RefAttributes<gui.HWND>>;

package/lib/react-qw/components/RadioButton.d.ts

@@ -0,0 +1,11 @@
+import * as gui from 'gui';
+import type { WStyle } from '../jsx.d.ts';
+export interface RadioButtonProps {
+    checked?: boolean;
+    defaultChecked?: boolean;
+    onChange?: (checked: boolean) => void;
+    label?: string;
+    style?: WStyle;
+    disabled?: boolean;
+}
+export declare const RadioButton: import("react").ForwardRefExoticComponent<RadioButtonProps & import("react").RefAttributes<gui.HWND>>;

package/lib/react-qw/components/ScrollView.d.ts

@@ -0,0 +1,9 @@
+import * as gui from 'gui';
+import type { WStyle } from '../jsx.d.ts';
+export interface ScrollViewProps {
+    children?: React.ReactNode;
+    style?: WStyle;
+    contentWidth?: number;
+    contentHeight?: number;
+}
+export declare const ScrollView: import("react").ForwardRefExoticComponent<ScrollViewProps & import("react").RefAttributes<gui.HWND>>;

package/lib/react-qw/components/Slider.d.ts

@@ -0,0 +1,12 @@
+import * as gui from 'gui';
+import type { WStyle } from '../jsx.d.ts';
+export interface SliderProps {
+    value: number;
+    onChange?: (value: number) => void;
+    min?: number;
+    max?: number;
+    vertical?: boolean;
+    disabled?: boolean;
+    style?: WStyle;
+}
+export declare const Slider: import("react").ForwardRefExoticComponent<SliderProps & import("react").RefAttributes<gui.HWND>>;

package/lib/react-qw/components/Tab.d.ts

@@ -0,0 +1,14 @@
+import { type ReactNode } from 'react';
+import * as gui from 'gui';
+import type { WStyle } from '../jsx.d.ts';
+export interface TabProps {
+    tabs: {
+        title: string;
+        content: ReactNode;
+    }[];
+    selectedIndex?: number;
+    defaultSelectedIndex?: number;
+    onChange?: (index: number) => void;
+    style?: WStyle;
+}
+export declare const Tab: import("react").ForwardRefExoticComponent<TabProps & import("react").RefAttributes<gui.HWND>>;

package/lib/react-qw/components/Tooltip.d.ts

@@ -0,0 +1,7 @@
+export interface TooltipProps {
+    text: string;
+    children: React.ReactElement;
+    balloon?: boolean;
+}
+declare function Tooltip({ text, children, balloon }: TooltipProps): import("react").ReactElement<Record<string, unknown>, string | import("react").JSXElementConstructor<any>>;
+export { Tooltip };

package/lib/react-qw/components/TreeView.d.ts

@@ -0,0 +1,18 @@
+import * as gui from 'gui';
+import type { WStyle } from '../jsx.d.ts';
+export interface TreeNode<D = unknown> {
+    key?: string;
+    label: string;
+    children?: TreeNode<D>[];
+}
+export interface TreeViewProps<D> {
+    data: TreeNode<D>[];
+    onSelect?: (node: TreeNode<D> | null) => void;
+    defaultSelectedKey?: string;
+    selectedKey?: string;
+    style?: WStyle;
+}
+declare const TreeView: <D = unknown>(props: TreeViewProps<D> & {
+    ref?: React.Ref<gui.HWND>;
+}) => React.ReactElement;
+export { TreeView };

package/lib/react-qw/components/index.d.ts

@@ -0,0 +1,16 @@
+export { Button, type ButtonProps } from './Button.js';
+export { CheckBox, type CheckBoxProps } from './CheckBox.js';
+export { ComboBox, type ComboBoxProps } from './ComboBox.js';
+export { DateTimePicker, type DateTimePickerProps } from './DateTimePicker.js';
+export { Input, type InputProps } from './Input.js';
+export { Link, type LinkProps } from './Link.js';
+export { ListBox, type ListBoxProps } from './ListBox.js';
+export { ListView, makeColorBlock, type ListViewProps, type Column, type CellStyle, type Align } from './ListView.js';
+export { ProgressBar, type ProgressBarProps } from './ProgressBar.js';
+export { RadioButton, type RadioButtonProps } from './RadioButton.js';
+export { ScrollView, type ScrollViewProps } from './ScrollView.js';
+export { Slider, type SliderProps } from './Slider.js';
+export { Tab, type TabProps } from './Tab.js';
+export { Tooltip, type TooltipProps } from './Tooltip.js';
+export { TreeView, type TreeViewProps, type TreeNode } from './TreeView.js';
+export { PathPicker, type PathPickerProps } from './PathPicker.js';

package/lib/react-qw/index.d.ts

@@ -0,0 +1,24 @@
+import * as gui from 'gui';
+import React from 'react';
+export interface RootWindowConfig {
+    text?: string;
+    ws?: number;
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+    noShowWindow?: boolean;
+    onEvent?: (e: {
+        hwnd: gui.HWND;
+        msg: number;
+        wParam: number;
+        lParam: number;
+    }) => number | void;
+}
+export declare function createRoot(container: gui.HWND | RootWindowConfig): {
+    hwnd: gui.HWND;
+    render(element: React.ReactNode): void;
+    unmount(): void;
+};
+export * from './components/index.js';
+export declare function render(element: React.ReactNode, containerOrConfig?: gui.HWND | RootWindowConfig | null, _callback?: () => void): void;

package/lib/react-qw/layout.d.ts

@@ -0,0 +1,29 @@
+export type JustifyContent = 'flex-start' | 'flex-end' | 'center' | 'space-between' | 'space-around' | 'space-evenly';
+export interface FlexStyle {
+    flexDirection?: 'row' | 'column';
+    justifyContent?: JustifyContent;
+    alignItems?: 'flex-start' | 'flex-end' | 'center' | 'stretch';
+    gap?: number;
+    padding?: number;
+    paddingTop?: number;
+    paddingRight?: number;
+    paddingBottom?: number;
+    paddingLeft?: number;
+}
+interface ChildStyle {
+    width?: number | 'auto';
+    height?: number | 'auto';
+    flexGrow?: number;
+    alignSelf?: 'auto' | 'flex-start' | 'flex-end' | 'center' | 'stretch';
+}
+interface ChildInfo {
+    style: ChildStyle;
+}
+export interface LayoutResult {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export declare function calculateFlexLayout(flex: FlexStyle, parentW: number, parentH: number, children: ChildInfo[]): LayoutResult[];
+export {};

package/lib/react-qw/nmhdr.d.ts

@@ -0,0 +1 @@
+export declare function nmCode(lParam: number): number;

package/lib/react-qw/props.d.ts

@@ -0,0 +1,2 @@
+import type { Instance, Props } from './reconciler.js';
+export declare function applyProps(instance: Instance, newProps: Props, _oldProps: Props): void;

package/lib/react-qw/reconciler.d.ts

@@ -0,0 +1,21 @@
+import ReactReconciler from 'react-reconciler';
+import * as gui from 'gui';
+import type { WIntrinsicProps } from './jsx.js';
+export declare const scaleFactor: number;
+export type Props = WIntrinsicProps;
+export interface Instance {
+    hwnd: gui.HWND | null;
+    type: string;
+    props: Props;
+    children: Instance[];
+    lastRect?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+}
+export declare const instancesByHwnd: Map<gui.HWND, Instance>;
+export declare function forceFlexLayout(hwnd: gui.HWND): void;
+declare const reconciler: ReactReconciler.Reconciler<gui.HWND, Instance, Instance, never, never, gui.HWND>;
+export default reconciler;

package/lib/stream.d.ts

@@ -0,0 +1,20 @@
+export {};
+import { ReadableStream as ReadableStreamImpl, ReadableStreamDefaultController as ReadableStreamDefaultControllerImpl, ReadableStreamDefaultReader as ReadableStreamDefaultReaderImpl } from './vendor/web-streams/ponyfill.mjs';
+declare global {
+    type ReadableStreamReadResult<R = any> = {
+        done: false;
+        value: R;
+    } | {
+        done: true;
+        value?: undefined;
+    };
+    interface ReadableStreamReader<R = any> extends ReadableStreamDefaultReaderImpl<R> {
+    }
+    interface ReadableStreamDefaultReader<R = any> extends ReadableStreamDefaultReaderImpl<R> {
+    }
+    interface ReadableStream<R = any> extends ReadableStreamImpl<R> {
+    }
+    interface ReadableStreamDefaultController<R = any> extends ReadableStreamDefaultControllerImpl<R> {
+    }
+    var ReadableStream: typeof ReadableStreamImpl;
+}

package/lib/text-codec.d.ts

@@ -0,0 +1,39 @@
+export {};
+declare global {
+    interface TextDecoder<T extends _Label | undefined = _Label | undefined> extends TextDecoderImpl<T> {
+    }
+    var TextDecoder: typeof TextDecoderImpl;
+    interface TextEncoder<T extends _Label | undefined = _Label | undefined> extends TextEncoderImpl<T> {
+    }
+    var TextEncoder: typeof TextEncoderImpl;
+}
+declare const _labelMap: {
+    readonly 'utf-8': 'utf-8';
+    readonly utf8: 'utf-8';
+    readonly 'unicode-1-1-utf-8': 'utf-8';
+    readonly 'utf-16': 'utf-16le';
+    readonly 'utf-16le': 'utf-16le';
+    readonly 'utf-16be': 'utf-16be';
+};
+type _Label = keyof typeof _labelMap;
+type _Encoding = typeof _labelMap[_Label];
+type _Result<T> = T extends _Label ? typeof _labelMap[T] : 'utf-8';
+declare class TextDecoderImpl<T extends _Label | undefined = _Label | undefined> {
+    _encoding: _Encoding;
+    _fatal: boolean;
+    _ignoreBOM: boolean;
+    constructor(label?: T, options?: {
+        fatal?: boolean;
+        ignoreBOM?: boolean;
+    });
+    get encoding(): _Result<T>;
+    get fatal(): boolean;
+    get ignoreBOM(): boolean;
+    decode(buffer?: ArrayBufferView | ArrayBuffer | null): string;
+}
+declare class TextEncoderImpl<T extends _Label | undefined = _Label | undefined> {
+    _encoding: _Encoding;
+    constructor(label?: T);
+    get encoding(): _Result<T>;
+    encode(input?: string): Uint8Array<ArrayBuffer>;
+}

package/lib/text-measure.d.ts

@@ -0,0 +1,14 @@
+import { type Ptr } from './ffi/ctype.js';
+import * as gui from 'gui';
+export declare function measureText(hdc: Ptr<'HDC'>, text: string, maxWidth: number): {
+    width: number;
+    height: number;
+};
+export declare function getButtonIdealSize(hwnd: gui.HWND): {
+    width: number;
+    height: number;
+};
+export declare function measureTextForHwnd(hwnd: gui.HWND, text: string): {
+    width: number;
+    height: number;
+};

package/lib/url.d.ts

@@ -0,0 +1,54 @@
+export {};
+declare global {
+    interface URLSearchParams extends URLSearchParamsImpl {
+    }
+    var URLSearchParams: typeof URLSearchParamsImpl;
+    interface URL extends URLImpl {
+    }
+    var URL: typeof URLImpl;
+}
+declare class URLSearchParamsImpl {
+    private _list;
+    constructor(init?: string | [string, string][] | Record<string, string>);
+    append(key: string, value: string): void;
+    delete(key: string): void;
+    get(key: string): string | null;
+    getAll(key: string): string[];
+    has(key: string): boolean;
+    set(key: string, value: string): void;
+    sort(): void;
+    forEach(fn: (v: string, k: string) => void): void;
+    keys(): IterableIterator<string>;
+    values(): IterableIterator<string>;
+    entries(): IterableIterator<[string, string]>;
+    [Symbol.iterator](): IterableIterator<[string, string]>;
+    toString(): string;
+    get size(): number;
+}
+declare class URLImpl {
+    private _scheme;
+    private _username;
+    private _password;
+    private _hostname;
+    private _port;
+    private _pathname;
+    private _query;
+    private _fragment;
+    private _searchParams;
+    constructor(url: string, base?: string);
+    private _apply;
+    get href(): string;
+    get protocol(): string;
+    get hostname(): string;
+    get port(): string;
+    get pathname(): string;
+    get search(): string;
+    get hash(): string;
+    get host(): string;
+    get origin(): string;
+    get username(): string;
+    get password(): string;
+    get searchParams(): URLSearchParams;
+    toString(): string;
+    toJSON(): string;
+}

package/lib/websocket.d.ts

@@ -0,0 +1,73 @@
+import '../lib/polyfill.js';
+declare enum State {
+    CONNECTING = 0,
+    OPEN = 1,
+    CLOSING = 2,
+    CLOSED = 3
+}
+interface WebSocketOptions {
+    headers?: Record<string, string>;
+    /** Non-standard: when false, TLS certificate verification is skipped
+     *  (mirrors Node's tls.connect rejectUnauthorized option). */
+    rejectUnauthorized?: boolean;
+}
+declare class WebSocketImpl {
+    readonly url: string;
+    readyState: State;
+    onopen: ((event: Event) => void) | null;
+    onclose: ((event: CloseEvent) => void) | null;
+    onerror: ((event: Event) => void) | null;
+    onmessage: ((event: MessageEvent) => void) | null;
+    private _options;
+    private _sock;
+    private _ssl;
+    private _ctx;
+    private _readBuffer;
+    private _state;
+    private _processingHandshake;
+    static readonly CONNECTING = State.CONNECTING;
+    static readonly OPEN = State.OPEN;
+    static readonly CLOSING = State.CLOSING;
+    static readonly CLOSED = State.CLOSED;
+    private _closeCode;
+    private _closeReason;
+    constructor(url: string, options?: WebSocketOptions);
+    send(data: string | ArrayBuffer | Uint8Array): void;
+    close(code?: number, reason?: string): void;
+    private _connect;
+    private _sendRaw;
+    private _sendRawStr;
+    private _onData;
+    private _setState;
+    private _dispatchEvent;
+    private _fireError;
+    private _cleanup;
+}
+declare class Event {
+    readonly type: string;
+    constructor(type: string, _init?: unknown);
+}
+declare class MessageEvent {
+    readonly type: string;
+    readonly data: unknown;
+    constructor(type: string, init: {
+        data: unknown;
+    });
+}
+declare class CloseEvent {
+    readonly type: string;
+    readonly code: number;
+    readonly reason: string;
+    readonly wasClean: boolean;
+    constructor(type: string, init: {
+        code?: number;
+        reason?: string;
+        wasClean?: boolean;
+    });
+}
+declare global {
+    interface WebSocket extends WebSocketImpl {
+    }
+    var WebSocket: typeof WebSocketImpl;
+}
+export {};