@lingxia/rong 0.0.1

package/dist/event.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Event module type definitions
+ * Corresponds to: modules/rong_event
+ */
+export interface EventOptions {
+    /** Whether the event bubbles */
+    bubbles?: boolean;
+    /** Whether the event can be cancelled */
+    cancelable?: boolean;
+    /** Whether the event can cross shadow DOM boundaries */
+    composed?: boolean;
+}
+export interface Event {
+    /** Event type name */
+    readonly type: string;
+    /** Whether the event bubbles */
+    readonly bubbles: boolean;
+    /** Whether the event can be cancelled */
+    readonly cancelable: boolean;
+    /** Whether the event can cross shadow DOM boundaries */
+    readonly composed: boolean;
+}
+export interface EventConstructor {
+    new (type: string, options?: EventOptions): Event;
+    prototype: Event;
+}
+export interface CustomEventOptions extends EventOptions {
+    /** Custom data associated with the event */
+    detail?: any;
+}
+export interface CustomEvent extends Event {
+    /** Custom data associated with the event */
+    readonly detail: any;
+}
+export interface CustomEventConstructor {
+    new (type: string, options?: CustomEventOptions): CustomEvent;
+    prototype: CustomEvent;
+}
+export type EventListener = (event: Event) => void;
+export interface AddEventListenerOptions {
+    /** Remove listener after first invocation */
+    once?: boolean;
+    /** Use capture phase */
+    capture?: boolean;
+    /** Listener is passive (won't call preventDefault) */
+    passive?: boolean;
+}
+export interface EventTarget {
+    /** Add event listener (Web standard) */
+    addEventListener(type: string, listener: EventListener, options?: boolean | AddEventListenerOptions): void;
+    /** Remove event listener (Web standard) */
+    removeEventListener(type: string, listener: EventListener, options?: boolean | AddEventListenerOptions): void;
+    /** Dispatch event (Web standard) */
+    dispatchEvent(event: Event): boolean;
+}
+export interface EventTargetConstructor {
+    new (): EventTarget;
+    prototype: EventTarget;
+}
+export type EventName = string | symbol;
+export type EventEmitterListener = (...args: any[]) => void;
+export interface EventEmitter extends EventTarget {
+    /** Add event listener (Node.js style) */
+    on(eventName: EventName, listener: EventEmitterListener): this;
+    /** Add one-time event listener */
+    once(eventName: EventName, listener: EventEmitterListener): this;
+    /** Remove event listener */
+    off(eventName: EventName, listener: EventEmitterListener): this;
+    /** Remove event listener (alias for off) */
+    removeListener(eventName: EventName, listener: EventEmitterListener): this;
+    /** Remove all listeners for an event */
+    removeAllListeners(eventName?: EventName): this;
+    /** Add listener at the beginning of the listeners array */
+    prependListener(eventName: EventName, listener: EventEmitterListener): this;
+    /** Add one-time listener at the beginning of the listeners array */
+    prependOnceListener(eventName: EventName, listener: EventEmitterListener): this;
+    /** Emit an event */
+    emit(eventName: EventName, ...args: any[]): boolean;
+    /** Get array of registered event names */
+    eventNames(): EventName[];
+    /** Set maximum number of listeners per event (default: 10) */
+    setMaxListeners(n: number): this;
+    /** Get maximum number of listeners per event */
+    getMaxListeners(): number;
+    /** Get number of listeners for an event, optionally filtered by a specific listener */
+    listenerCount(eventName: EventName, listener?: EventEmitterListener): number;
+}
+export interface EventEmitterConstructor {
+    new (): EventEmitter;
+    prototype: EventEmitter;
+}
+declare global {
+    const EventEmitter: EventEmitterConstructor;
+}
+export {};
+//# sourceMappingURL=event.d.ts.map

package/dist/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../src/event.ts"],"names":[],"mappings":"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"}

package/dist/event.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Event module type definitions
+ * Corresponds to: modules/rong_event
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/exception.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Exception module type definitions
+ * Corresponds to: modules/rong_exception
+ */
+export type DOMExceptionName = 'IndexSizeError' | 'DOMStringSizeError' | 'HierarchyRequestError' | 'InvalidCharacterError' | 'NoDataAllowedError' | 'NoModificationAllowedError' | 'NotFoundError' | 'NotSupportedError' | 'InUseAttributeError' | 'InvalidStateError' | 'SyntaxError' | 'InvalidModificationError' | 'NamespaceError' | 'InvalidAccessError' | 'ValidationError' | 'TypeMismatchError' | 'SecurityError' | 'NetworkError' | 'AbortError' | 'URLMismatchError' | 'QuotaExceededError' | 'TimeoutError' | 'InvalidNodeTypeError' | 'DataCloneError' | 'Error' | 'INDEX_SIZE_ERR' | 'DOMSTRING_SIZE_ERR' | 'HIERARCHY_REQUEST_ERR' | 'INVALID_CHARACTER_ERR' | 'NO_DATA_ALLOWED_ERR' | 'NO_MODIFICATION_ALLOWED_ERR' | 'NOT_FOUND_ERR' | 'NOT_SUPPORTED_ERR' | 'INUSE_ATTRIBUTE_ERR' | 'INVALID_STATE_ERR' | 'SYNTAX_ERR' | 'INVALID_MODIFICATION_ERR' | 'NAMESPACE_ERR' | 'INVALID_ACCESS_ERR' | 'VALIDATION_ERR' | 'TYPE_MISMATCH_ERR' | 'SECURITY_ERR' | 'NETWORK_ERR' | 'ABORT_ERR' | 'URL_MISMATCH_ERR' | 'QUOTA_EXCEEDED_ERR' | 'TIMEOUT_ERR' | 'INVALID_NODE_TYPE_ERR' | 'DATA_CLONE_ERR' | 'ERROR';
+export interface DOMException extends Error {
+    /** Error name */
+    readonly name: string;
+    /** Error message */
+    readonly message: string;
+    /** Stack trace (currently returns "NotImplemented") */
+    readonly stack: string;
+}
+export interface DOMExceptionConstructor {
+    new (message?: string, name?: DOMExceptionName): DOMException;
+    prototype: DOMException;
+}
+export {};
+//# sourceMappingURL=exception.d.ts.map

package/dist/exception.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exception.d.ts","sourceRoot":"","sources":["../src/exception.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,gBAAgB,GACxB,gBAAgB,GAChB,oBAAoB,GACpB,uBAAuB,GACvB,uBAAuB,GACvB,oBAAoB,GACpB,4BAA4B,GAC5B,eAAe,GACf,mBAAmB,GACnB,qBAAqB,GACrB,mBAAmB,GACnB,aAAa,GACb,0BAA0B,GAC1B,gBAAgB,GAChB,oBAAoB,GACpB,iBAAiB,GACjB,mBAAmB,GACnB,eAAe,GACf,cAAc,GACd,YAAY,GACZ,kBAAkB,GAClB,oBAAoB,GACpB,cAAc,GACd,sBAAsB,GACtB,gBAAgB,GAChB,OAAO,GAEP,gBAAgB,GAChB,oBAAoB,GACpB,uBAAuB,GACvB,uBAAuB,GACvB,qBAAqB,GACrB,6BAA6B,GAC7B,eAAe,GACf,mBAAmB,GACnB,qBAAqB,GACrB,mBAAmB,GACnB,YAAY,GACZ,0BAA0B,GAC1B,eAAe,GACf,oBAAoB,GACpB,gBAAgB,GAChB,mBAAmB,GACnB,cAAc,GACd,aAAa,GACb,WAAW,GACX,kBAAkB,GAClB,oBAAoB,GACpB,aAAa,GACb,uBAAuB,GACvB,gBAAgB,GAChB,OAAO,CAAC;AAEZ,MAAM,WAAW,YAAa,SAAQ,KAAK;IACzC,iBAAiB;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,oBAAoB;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAI,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,YAAY,CAAC;IAC7D,SAAS,EAAE,YAAY,CAAC;CACzB;AAID,OAAO,EAAE,CAAC"}

package/dist/exception.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Exception module type definitions
+ * Corresponds to: modules/rong_exception
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/fs.d.ts

@@ -0,0 +1,450 @@
+/**
+ * File System module type definitions
+ * Corresponds to: modules/rong_fs
+ *
+ * Provides APIs for file system operations including reading, writing, and directory management.
+ * All file system APIs are mounted under the global `Rong` namespace.
+ */
+/**
+ * Options for reading files.
+ */
+export interface ReadFileOptions {
+    /**
+     * AbortSignal to cancel the read operation.
+     * When aborted, the operation will throw an AbortError.
+     *
+     * @see {@link AbortSignal}
+     * @example
+     * ```typescript
+     * const controller = new AbortController();
+     * const promise = Rong.readTextFile('/file.txt', {
+     *   signal: controller.signal
+     * });
+     * // Cancel after 1 second
+     * setTimeout(() => controller.abort(), 1000);
+     * ```
+     */
+    signal?: AbortSignal;
+}
+/**
+ * Options for writing files.
+ */
+export interface WriteFileOptions {
+    /**
+     * Append to file instead of overwriting.
+     * Cannot be used together with `createNew`.
+     *
+     * @default false
+     */
+    append?: boolean;
+    /**
+     * Create file only if it doesn't exist.
+     * Throws AlreadyExistsError if the file already exists.
+     * Cannot be used together with `append`.
+     *
+     * @default false
+     * @throws {AlreadyExistsError} If file already exists
+     */
+    createNew?: boolean;
+    /**
+     * File permissions mode (Unix-like systems only).
+     * Octal number (e.g., 0o644 for rw-r--r--).
+     * Ignored on Windows.
+     *
+     * @default 0o666 (modified by process umask)
+     * @platform unix
+     * @example
+     * ```typescript
+     * await Rong.writeTextFile('/script.sh', '#!/bin/bash\necho hello', {
+     *   mode: 0o755  // rwxr-xr-x
+     * });
+     * ```
+     */
+    mode?: number;
+    /**
+     * AbortSignal to cancel the write operation.
+     *
+     * @see {@link AbortSignal}
+     */
+    signal?: AbortSignal;
+}
+/**
+ * Options for opening files.
+ */
+export interface FileOpenOptions {
+    /**
+     * Open file for reading.
+     * @default false
+     */
+    read?: boolean;
+    /**
+     * Open file for writing.
+     * @default false
+     */
+    write?: boolean;
+    /**
+     * Open file for appending (writes go to end of file).
+     * @default false
+     */
+    append?: boolean;
+    /**
+     * Truncate file to 0 bytes when opening (if it exists).
+     * Only valid when `write` is true.
+     * @default false
+     */
+    truncate?: boolean;
+    /**
+     * Create file if it doesn't exist.
+     * Only valid when `write` is true.
+     * @default false
+     */
+    create?: boolean;
+    /**
+     * Create file only if it doesn't exist (exclusive creation).
+     * Throws AlreadyExistsError if file exists.
+     * Only valid when `write` is true.
+     *
+     * @default false
+     * @throws {AlreadyExistsError} If file already exists
+     */
+    createNew?: boolean;
+    /**
+     * File permissions mode (Unix-like systems only).
+     * @default 0o666 (modified by process umask)
+     * @platform unix
+     */
+    mode?: number;
+}
+/**
+ * Options for creating directories.
+ */
+export interface MkdirOptions {
+    /**
+     * Create parent directories as needed.
+     * If false and parent doesn't exist, throws NotFoundError.
+     *
+     * @default false
+     * @throws {NotFoundError} If parent doesn't exist and recursive is false
+     * @example
+     * ```typescript
+     * // Create nested directories
+     * await Rong.mkdir('/path/to/nested/dir', { recursive: true });
+     * ```
+     */
+    recursive?: boolean;
+    /**
+     * Directory permissions mode (Unix-like systems only).
+     * @default 0o777 (modified by process umask)
+     * @platform unix
+     */
+    mode?: number;
+}
+/**
+ * Options for removing files and directories.
+ */
+export interface RemoveOptions {
+    /**
+     * Remove directories and their contents recursively.
+     * If false and path is a non-empty directory, throws an error.
+     *
+     * @default false
+     * @example
+     * ```typescript
+     * // Remove directory and all its contents
+     * await Rong.remove('/path/to/dir', { recursive: true });
+     * ```
+     */
+    recursive?: boolean;
+}
+/**
+ * Options for setting file timestamps via {@link FsModule.utime}.
+ */
+export interface UTimeOptions {
+    /**
+     * Access time in milliseconds since Unix epoch.
+     * If omitted, defaults to "now" (runtime-dependent).
+     */
+    accessed?: number;
+    /**
+     * Modified time in milliseconds since Unix epoch.
+     * If omitted, defaults to "now" (runtime-dependent).
+     */
+    modified?: number;
+}
+/**
+ * File or directory metadata information.
+ * Returned by `stat()` and `lstat()` functions.
+ */
+export interface FileInfo {
+    /**
+     * Whether this is a regular file.
+     * Mutually exclusive with `isDirectory` and `isSymlink`.
+     */
+    readonly isFile: boolean;
+    /**
+     * Whether this is a directory.
+     * Mutually exclusive with `isFile` and `isSymlink`.
+     */
+    readonly isDirectory: boolean;
+    /**
+     * Whether this is a symbolic link.
+     * For symbolic links, use `lstat()` instead of `stat()`
+     * to get link information rather than target information.
+     */
+    readonly isSymlink: boolean;
+    /**
+     * File size in bytes.
+     * For directories, this is the size of the directory entry, not its contents.
+     */
+    readonly size: number;
+    /**
+     * Last modified time in milliseconds since Unix epoch.
+     * May be undefined if not supported by the file system.
+     */
+    readonly modified?: number;
+    /**
+     * Last accessed time in milliseconds since Unix epoch.
+     * May be undefined if not supported by the file system.
+     */
+    readonly accessed?: number;
+    /**
+     * Creation time in milliseconds since Unix epoch.
+     * May be undefined if not supported by the file system.
+     */
+    readonly created?: number;
+    /**
+     * File permissions mode (Unix-like systems only).
+     * Octal representation of file permissions.
+     * Undefined on Windows.
+     *
+     * @platform unix
+     */
+    readonly mode?: number;
+}
+/**
+ * Directory entry information.
+ * Returned by `readDir()` function.
+ */
+export interface DirEntry {
+    /**
+     * Entry name (without directory path).
+     * @example For `/path/to/file.txt`, name is `file.txt`
+     */
+    readonly name: string;
+    /** Whether this entry is a regular file */
+    readonly isFile: boolean;
+    /** Whether this entry is a directory */
+    readonly isDirectory: boolean;
+    /** Whether this entry is a symbolic link */
+    readonly isSymlink: boolean;
+}
+/**
+ * Seek modes for file positioning.
+ * Used with `FsFile.seek()` method.
+ */
+export declare enum SeekMode {
+    /** Seek from start of file (absolute position) */
+    Start = 0,
+    /** Seek from current position (relative) */
+    Current = 1,
+    /** Seek from end of file (usually negative offset) */
+    End = 2
+}
+/**
+ * File handle for advanced file operations.
+ * Obtained from `Rong.open()`.
+ *
+ * @example
+ * ```typescript
+ * const file = await Rong.open('/path/to/file.txt', {
+ *   read: true,
+ *   write: true
+ * });
+ *
+ * try {
+ *   const buffer = new ArrayBuffer(1024);
+ *   const bytesRead = await file.read(buffer);
+ *   console.log(`Read ${bytesRead} bytes`);
+ * } finally {
+ *   await file.close();
+ * }
+ * ```
+ */
+export interface FsFile {
+    /**
+     * Get file metadata.
+     *
+     * @returns Promise with file information
+     * @throws {IOError} If stat operation fails
+     * @example
+     * ```typescript
+     * const info = await file.stat();
+     * console.log(`File size: ${info.size} bytes`);
+     * ```
+     */
+    stat(): Promise<FileInfo>;
+    /**
+     * Read from file into buffer.
+     * Reads from current file position and advances the position.
+     *
+     * @param buffer - ArrayBuffer to read into
+     * @returns Promise with bytes read, or null on EOF
+     * @throws {IOError} If read operation fails
+     * @example
+     * ```typescript
+     * const buffer = new ArrayBuffer(4096);
+     * const bytesRead = await file.read(buffer);
+     * if (bytesRead === null) {
+     *   console.log('Reached end of file');
+     * } else {
+     *   console.log(`Read ${bytesRead} bytes`);
+     * }
+     * ```
+     */
+    read(buffer: ArrayBuffer): Promise<number | null>;
+    /**
+     * Write buffer to file.
+     * Writes at current file position and advances the position.
+     *
+     * @param buffer - ArrayBuffer to write
+     * @returns Promise with number of bytes written
+     * @throws {IOError} If write operation fails
+     * @example
+     * ```typescript
+     * const data = new TextEncoder().encode('Hello World');
+     * const bytesWritten = await file.write(data.buffer);
+     * console.log(`Wrote ${bytesWritten} bytes`);
+     * ```
+     */
+    write(buffer: ArrayBuffer): Promise<number>;
+    /**
+     * Sync file contents to disk.
+     * Ensures all buffered writes are flushed to storage.
+     *
+     * @returns Promise that resolves when sync is complete
+     * @throws {IOError} If sync operation fails
+     */
+    sync(): Promise<void>;
+    /**
+     * Truncate or extend file to specified length.
+     *
+     * @param len - Target length in bytes (default: 0)
+     * @returns Promise that resolves when truncate is complete
+     * @throws {IOError} If truncate operation fails
+     * @example
+     * ```typescript
+     * // Truncate to 100 bytes
+     * await file.truncate(100);
+     *
+     * // Truncate to 0 bytes (clear file)
+     * await file.truncate();
+     * ```
+     */
+    truncate(len?: number): Promise<void>;
+    /**
+     * Seek to position in file.
+     *
+     * @param offset - Byte offset
+     * @param whence - Seek mode (Start, Current, or End)
+     * @returns Promise with new absolute position
+     * @throws {IOError} If seek operation fails
+     * @example
+     * ```typescript
+     * // Seek to byte 100 from start
+     * await file.seek(100, Rong.SeekMode.Start);
+     *
+     * // Seek forward 50 bytes from current position
+     * await file.seek(50, Rong.SeekMode.Current);
+     *
+     * // Seek to 10 bytes before end
+     * await file.seek(-10, Rong.SeekMode.End);
+     * ```
+     */
+    seek(offset: number, whence?: SeekMode): Promise<number>;
+    /**
+     * Close file handle.
+     * After closing, no further operations can be performed.
+     * It's recommended to use try-finally to ensure files are closed.
+     *
+     * @returns Promise that resolves when file is closed
+     * @example
+     * ```typescript
+     * const file = await Rong.open('/file.txt', { read: true });
+     * try {
+     *   // Use file...
+     * } finally {
+     *   await file.close();
+     * }
+     * ```
+     */
+    close(): Promise<void>;
+    /**
+     * Get ReadableStream for reading file contents.
+     * The stream reads from the current file position.
+     * Cannot be used simultaneously with direct read operations.
+     *
+     * @example
+     * ```typescript
+     * const file = await Rong.open('/file.txt', { read: true });
+     * const readable = file.readable;
+     *
+     * for await (const chunk of readable) {
+     *   console.log('Received chunk:', chunk.length, 'bytes');
+     * }
+     * ```
+     */
+    readonly readable: ReadableStream<Uint8Array>;
+    /**
+     * Get WritableStream for writing file contents.
+     * The stream writes to the current file position.
+     * Cannot be used simultaneously with direct write operations.
+     *
+     * @example
+     * ```typescript
+     * const file = await Rong.open('/file.txt', { write: true, create: true });
+     * const writable = file.writable;
+     * const writer = writable.getWriter();
+     *
+     * await writer.write(new TextEncoder().encode('Hello'));
+     * await writer.close();
+     * ```
+     */
+    readonly writable: WritableStream<Uint8Array>;
+}
+/**
+ * File System module interface.
+ * All operations are available under the global `Rong` namespace.
+ */
+export interface FsModule {
+    readTextFile(path: string, options?: ReadFileOptions): Promise<string>;
+    readFile(path: string, options?: ReadFileOptions): Promise<ArrayBuffer>;
+    writeTextFile(path: string, text: string, options?: WriteFileOptions): Promise<void>;
+    writeFile(path: string, data: ArrayBufferView, options?: WriteFileOptions): Promise<void>;
+    copyFile(from: string, to: string): Promise<void>;
+    truncate(path: string, len?: number): Promise<void>;
+    open(path: string, options?: FileOpenOptions): Promise<FsFile>;
+    mkdir(path: string, options?: MkdirOptions): Promise<void>;
+    readDir(path: string): Promise<AsyncIterableIterator<DirEntry>>;
+    stat(path: string): Promise<FileInfo>;
+    lstat(path: string): Promise<FileInfo>;
+    remove(path: string, options?: RemoveOptions): Promise<void>;
+    chdir(path: string): Promise<void>;
+    symlink(target: string, path: string): Promise<void>;
+    readlink(path: string): Promise<string>;
+    /**
+     * Change file permissions (Unix only)
+     * @platform unix
+     */
+    chmod(path: string, mode: number): Promise<void>;
+    /**
+     * Change file ownership (Unix only)
+     * @platform unix
+     */
+    chown(path: string, uid: number, gid: number): Promise<void>;
+    utime(path: string, options: UTimeOptions): Promise<void>;
+    rename(oldPath: string, newPath: string): Promise<void>;
+    realPath(path: string): Promise<string>;
+    readonly SeekMode: typeof SeekMode;
+}
+export {};
+//# sourceMappingURL=fs.d.ts.map

package/dist/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":"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"}

package/dist/fs.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * File System module type definitions
+ * Corresponds to: modules/rong_fs
+ *
+ * Provides APIs for file system operations including reading, writing, and directory management.
+ * All file system APIs are mounted under the global `Rong` namespace.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SeekMode = void 0;
+/**
+ * Seek modes for file positioning.
+ * Used with `FsFile.seek()` method.
+ */
+var SeekMode;
+(function (SeekMode) {
+    /** Seek from start of file (absolute position) */
+    SeekMode[SeekMode["Start"] = 0] = "Start";
+    /** Seek from current position (relative) */
+    SeekMode[SeekMode["Current"] = 1] = "Current";
+    /** Seek from end of file (usually negative offset) */
+    SeekMode[SeekMode["End"] = 2] = "End";
+})(SeekMode = exports.SeekMode || (exports.SeekMode = {}));