@lingxia/rong 0.0.1

package/README.md

@@ -0,0 +1,59 @@
+# @lingxia/rong
+
+TypeScript type definitions for the Rong JavaScript runtime (globals injected by Rust).
+
+## Scope
+
+- Provides `.d.ts`/TS sources for the runtime surface so editors/TS can typecheck Rong scripts.
+- Not a runtime polyfill: it does not provide implementations, only types.
+
+## Runtime Export Map (high level)
+
+Rong injects a small set of globals:
+
+- `Rong` namespace: file system + storage
+- Globals: `process`, `child_process`, `path`, `fetch`, `timers`, `assert`, `atob`, `btoa`
+
+Rong also implements/extends a subset of Web APIs; the type package relies on TypeScript’s DOM libs for base types like `URL`, `ReadableStream`, `AbortController`, etc.
+
+## Installation
+
+```bash
+npm install @lingxia/rong
+```
+
+## Usage (typechecking only)
+
+Add to your `tsconfig.json`:
+
+```json
+{
+  "compilerOptions": {
+    "types": ["@lingxia/rong"]
+  }
+}
+```
+
+Notes:
+
+- This enables global typings; you should not `import` runtime modules like `'child_process'` or `'http'` (those are Rong globals, not Node modules).
+- Ensure your `tsconfig.json` `lib` includes `"DOM"` if you want DOM globals (e.g. `URL`, `ReadableStream`) to be typed.
+
+## Accuracy notes (common gotchas)
+
+- Storage is not `localStorage`-compatible. Use `await Rong.storage.open(path)` or `new Rong.Storage(path)`, then `set/get/delete/clear/list/info`.
+- Directory listing is `Rong.readDir(...)` (async iterator), not `Rong.readdir(...)`.
+- HTTP is the global `fetch(...)` API. There is no `http` namespace and no `download` JS API.
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Watch mode
+npm run watch
+```

package/dist/abort.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Abort module type definitions
+ * Corresponds to: modules/rong_abort
+ */
+import { EventTarget } from './event';
+export interface AbortSignal extends EventTarget {
+    /** Whether the signal has been aborted */
+    readonly aborted: boolean;
+    /** Reason for abort (if any) */
+    readonly reason: any;
+    /** Abort event handler */
+    onabort: ((event: Event) => void) | null;
+    /** If the signal has been aborted, throw the abort reason */
+    throwIfAborted(): void;
+}
+export interface AbortSignalConstructor {
+    prototype: AbortSignal;
+    /** Returns an AbortSignal that is aborted when any of the given signals are aborted */
+    any(signals: AbortSignal[]): AbortSignal;
+    /** Returns an AbortSignal that is already aborted */
+    abort(reason?: any): AbortSignal;
+    /** Returns an AbortSignal that will abort after the specified milliseconds */
+    timeout(milliseconds: number): AbortSignal;
+}
+export interface AbortController {
+    /** The AbortSignal associated with this controller */
+    readonly signal: AbortSignal;
+    /** Abort the associated signal */
+    abort(reason?: any): void;
+}
+export interface AbortControllerConstructor {
+    new (): AbortController;
+    prototype: AbortController;
+}
+export {};
+//# sourceMappingURL=abort.d.ts.map

package/dist/abort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.d.ts","sourceRoot":"","sources":["../src/abort.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC9C,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,gCAAgC;IAChC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IAErB,0BAA0B;IAC1B,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAEzC,6DAA6D;IAC7D,cAAc,IAAI,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,WAAW,CAAC;IAEvB,uFAAuF;IACvF,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,WAAW,CAAC;IAEzC,qDAAqD;IACrD,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,WAAW,CAAC;IAEjC,8EAA8E;IAC9E,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,CAAC;CAC5C;AAED,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B,kCAAkC;IAClC,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAO,eAAe,CAAC;IACvB,SAAS,EAAE,eAAe,CAAC;CAC5B;AAID,OAAO,EAAE,CAAC"}

package/dist/abort.js

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

package/dist/assert.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Assert module type definitions
+ * Corresponds to: modules/rong_assert
+ */
+export type AssertionErrorMessage = string | Error;
+export interface AssertFunction {
+    /**
+     * Assert that a value is truthy
+     * @param value - Value to check
+     * @param message - Optional error message
+     * @throws Error if value is falsy
+     */
+    (value: any, message?: AssertionErrorMessage): asserts value;
+    /**
+     * Assert that a value is truthy (alias)
+     * @param value - Value to check
+     * @param message - Optional error message
+     * @throws Error if value is falsy
+     */
+    ok(value: any, message?: AssertionErrorMessage): asserts value;
+    /**
+     * Assert that two values are equal
+     * @param left - Left value
+     * @param right - Right value
+     * @param message - Optional error message
+     * @throws Error if values are not equal
+     */
+    equal(left: any, right: any, message?: AssertionErrorMessage): void;
+    /**
+     * Force assertion failure
+     * @param message - Error message
+     * @throws Error always
+     */
+    fail(message?: AssertionErrorMessage): never;
+    /**
+     * Assert that a function does not throw
+     * @param fn - Function to execute
+     * @param message - Optional error message
+     * @throws Error if function throws
+     */
+    doesNotThrow(fn: () => void, message?: AssertionErrorMessage): void;
+}
+export {};
+//# sourceMappingURL=assert.d.ts.map

package/dist/assert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../src/assert.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,KAAK,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,KAAK,CAAC;IAE7D;;;;;OAKG;IACH,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,KAAK,CAAC;IAE/D;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAEpE;;;;OAIG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,KAAK,CAAC;IAE7C;;;;;OAKG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACrE;AAGD,OAAO,EAAE,CAAC"}

package/dist/assert.js

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

package/dist/buffer.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Buffer module type definitions (Blob and File)
+ * Corresponds to: modules/rong_buffer
+ */
+export type BlobPart = Blob | ArrayBuffer | ArrayBufferView | string;
+export interface BlobOptions {
+    /** MIME type of the blob */
+    type?: string;
+    /** Line ending normalization: "transparent" (default) or "native" */
+    endings?: 'transparent' | 'native';
+}
+export interface Blob {
+    /** Blob size in bytes */
+    readonly size: number;
+    /** MIME type of the blob */
+    readonly type: string;
+    /** Create a slice of the blob */
+    slice(start?: number, end?: number, contentType?: string): Blob;
+    /** Get blob contents as ArrayBuffer */
+    arrayBuffer(): Promise<ArrayBuffer>;
+    /** Get blob contents as text */
+    text(): Promise<string>;
+    /** Get blob contents as Uint8Array */
+    bytes(): Promise<Uint8Array>;
+}
+export interface BlobConstructor {
+    new (blobParts?: BlobPart[], options?: BlobOptions): Blob;
+    prototype: Blob;
+}
+export interface FileOptions extends BlobOptions {
+    /** Last modified timestamp (milliseconds since epoch) */
+    lastModified?: number;
+}
+export interface File extends Blob {
+    /** File name */
+    readonly name: string;
+    /** Last modified timestamp (milliseconds since epoch) */
+    readonly lastModified: number;
+}
+export interface FileConstructor {
+    new (fileBits: BlobPart[], fileName: string, options?: FileOptions): File;
+    prototype: File;
+}
+export {};
+//# sourceMappingURL=buffer.d.ts.map

package/dist/buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../src/buffer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,WAAW,GAAG,eAAe,GAAG,MAAM,CAAC;AAErE,MAAM,WAAW,WAAW;IAC1B,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,OAAO,CAAC,EAAE,aAAa,GAAG,QAAQ,CAAC;CACpC;AAED,MAAM,WAAW,IAAI;IACnB,yBAAyB;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,iCAAiC;IACjC,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhE,uCAAuC;IACvC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IAEpC,gCAAgC;IAChC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAExB,sCAAsC;IACtC,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,KAAI,SAAS,CAAC,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACzD,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC9C,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,IAAK,SAAQ,IAAI;IAChC,gBAAgB;IAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,yDAAyD;IACzD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,KAAI,QAAQ,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACzE,SAAS,EAAE,IAAI,CAAC;CACjB;AAID,OAAO,EAAE,CAAC"}

package/dist/buffer.js

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

package/dist/child_process.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Child Process module type definitions
+ * Corresponds to: modules/rong_child_process
+ */
+import type { EventEmitter } from './event';
+export interface SpawnOptions {
+    /** Current working directory */
+    cwd?: string;
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Use shell to execute command */
+    shell?: boolean;
+    /** Timeout in milliseconds */
+    timeout?: number;
+}
+export interface ExecOptions {
+    /** Current working directory */
+    cwd?: string;
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Timeout in milliseconds */
+    timeout?: number;
+}
+export interface ExecResult {
+    /** Exit code (null if not yet exited) */
+    code: number | null;
+    /** Standard output */
+    stdout: string;
+    /** Standard error */
+    stderr: string;
+}
+export interface ChildProcess extends EventEmitter {
+    /** Process ID (null if process failed to spawn) */
+    readonly pid: number | null;
+    /** Exit code (available after process exits) */
+    readonly exitCode: number | null;
+    /** Standard input stream (if configured as 'piped') */
+    readonly stdin: WritableStream<Uint8Array> | null;
+    /** Standard output stream (if configured as 'piped') */
+    readonly stdout: ReadableStream<Uint8Array> | null;
+    /** Standard error stream (if configured as 'piped') */
+    readonly stderr: ReadableStream<Uint8Array> | null;
+    /**
+     * Wait for process to exit
+     * @returns Exit code (null if terminated by signal)
+     */
+    wait(): Promise<number | null>;
+    /**
+     * Kill the process with a signal
+     * @param signal - Signal name (e.g., 'SIGTERM', 'SIGKILL') or number
+     * @returns true if signal was sent successfully
+     */
+    kill(signal?: string): boolean;
+    on(event: 'exit', listener: (code: number | null) => void): this;
+    once(event: 'exit', listener: (code: number | null) => void): this;
+    off(event: 'exit', listener: (code: number | null) => void): this;
+}
+export interface ChildProcessModule {
+    /**
+     * Spawn a child process
+     * @param command - Command to execute
+     * @param args - Command arguments (optional)
+     * @param options - Spawn options
+     *
+     * @example
+     * ```typescript
+     * const child = child_process.spawn('ls', ['-la'], { cwd: '/tmp' });
+     * const code = await child.wait();
+     * ```
+     */
+    spawn(command: string, args?: string[], options?: SpawnOptions): ChildProcess;
+    /**
+     * Execute a shell command and capture output
+     * @param command - Shell command to execute
+     * @param options - Execution options
+     *
+     * @example
+     * ```typescript
+     * const result = await child_process.exec('echo "Hello"', { timeout: 5000 });
+     * console.log(result.stdout);
+     * ```
+     */
+    exec(command: string, options?: ExecOptions): Promise<ExecResult>;
+    /**
+     * Execute a file directly without shell
+     * @param file - File path to execute
+     * @param args - Command arguments
+     * @param options - Execution options
+     *
+     * @example
+     * ```typescript
+     * const result = await child_process.execFile('/usr/bin/node', ['--version']);
+     * console.log(result.stdout);
+     * ```
+     */
+    execFile(file: string, args?: string[], options?: ExecOptions): Promise<ExecResult>;
+}
+export {};
+//# sourceMappingURL=child_process.d.ts.map

package/dist/child_process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"child_process.d.ts","sourceRoot":"","sources":["../src/child_process.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,mCAAmC;IACnC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,yCAAyC;IACzC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD,mDAAmD;IACnD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IAElD,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IAEnD,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IAEnD;;;OAGG;IACH,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE/B;;;;OAIG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAG/B,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI,CAAC;IACjE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI,CAAC;IACnE,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI,CAAC;CACnE;AAED,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,YAAY,CAAC;IAE9E;;;;;;;;;;OAUG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAElE;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACrF;AAGD,OAAO,EAAE,CAAC"}

package/dist/child_process.js

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

package/dist/console.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Console module type definitions
+ * Corresponds to: modules/rong_console
+ *
+ * Note: console is a global object provided by the runtime.
+ * This module extends the standard Web Console API.
+ */
+export interface Console {
+    /** Log messages to stdout */
+    log(...args: any[]): void;
+    /** Log error messages to stderr */
+    error(...args: any[]): void;
+    /** Log warning messages to stderr */
+    warn(...args: any[]): void;
+    /** Log informational messages to stdout */
+    info(...args: any[]): void;
+    /** Log debug messages to stdout */
+    debug(...args: any[]): void;
+    /** Clear the console */
+    clear(): void;
+}
+export interface ConsoleConstructor {
+    new (): Console;
+    prototype: Console;
+}
+/**
+ * Rong console supports format strings in console.log():
+ * - %s - String substitution
+ * - %d, %i - Integer substitution
+ * - %f - Float substitution
+ * - %o - Object inspection
+ *
+ * Example:
+ * console.log("Name: %s, Age: %d", "Alice", 30);
+ */
+declare global {
+    const Console: ConsoleConstructor;
+}
+export {};
+//# sourceMappingURL=console.d.ts.map

package/dist/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../src/console.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,OAAO;IACtB,6BAA6B;IAC7B,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAE1B,mCAAmC;IACnC,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAE5B,qCAAqC;IACrC,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAE3B,2CAA2C;IAC3C,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAE3B,mCAAmC;IACnC,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAE5B,wBAAwB;IACxB,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAO,OAAO,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;CACpB;AAMD;;;;;;;;;GASG;AAEH,OAAO,CAAC,MAAM,CAAC;IACb,MAAM,OAAO,EAAE,kBAAkB,CAAC;CACnC;AAED,OAAO,EAAE,CAAC"}

package/dist/console.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Console module type definitions
+ * Corresponds to: modules/rong_console
+ *
+ * Note: console is a global object provided by the runtime.
+ * This module extends the standard Web Console API.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/encoding.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Encoding module type definitions
+ * Corresponds to: modules/rong_encoding
+ *
+ * Note: TextEncoder and TextDecoder are provided by the global environment
+ * and match the Web API specification. No custom type definitions needed.
+ * These types are available globally when "DOM" is included in tsconfig.json lib.
+ */
+export {};
+//# sourceMappingURL=encoding.d.ts.map

package/dist/encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../src/encoding.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC"}

package/dist/encoding.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Encoding module type definitions
+ * Corresponds to: modules/rong_encoding
+ *
+ * Note: TextEncoder and TextDecoder are provided by the global environment
+ * and match the Web API specification. No custom type definitions needed.
+ * These types are available globally when "DOM" is included in tsconfig.json lib.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/error.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Error type definitions for Rong runtime
+ *
+ * Rong can throw:
+ * - standard JS `Error` objects (including `TypeError`, `RangeError`, etc.)
+ * - `DOMException` instances for Abort-related errors (e.g. `AbortError`)
+ *
+ * This module provides type guards and utilities for error handling.
+ */
+/**
+ * Common error names used throughout the Rong runtime (as `error.name`).
+ */
+export type RongErrorName = 'Error' | 'TypeError' | 'RangeError' | 'ReferenceError' | 'AbortError' | 'NetworkError';
+/**
+ * Base error interface for Rong runtime errors.
+ */
+export interface RongError extends Error {
+    /** Error name identifying the error type */
+    readonly name: RongErrorName;
+    /** Human-readable error message */
+    readonly message: string;
+    /** Stable Rong error code (e.g. "E_IO", "E_TIMEOUT", ...) when available */
+    readonly code?: string;
+    /** Optional structured error data when provided by the runtime */
+    readonly data?: unknown;
+    /** Stack trace (if available) */
+    readonly stack?: string;
+}
+/**
+ * Error thrown when an operation is aborted via AbortSignal.
+ *
+ * @example
+ * ```typescript
+ * const controller = new AbortController();
+ * setTimeout(() => controller.abort(), 1000);
+ *
+ * try {
+ *   await Rong.readTextFile('/large-file.txt', {
+ *     signal: controller.signal
+ *   });
+ * } catch (error) {
+ *   if (isAbortError(error)) {
+ *     console.log('Operation cancelled');
+ *   }
+ * }
+ * ```
+ */
+export interface AbortError extends RongError {
+    readonly name: 'AbortError';
+}
+export interface NetworkError extends RongError {
+    readonly name: 'NetworkError';
+}
+/**
+ * Type guard to check if an error is a Rong runtime error.
+ *
+ * @param error - The error to check
+ * @returns true if the error is a RongError
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await Rong.readTextFile('/file.txt');
+ * } catch (error) {
+ *   if (isRongError(error)) {
+ *     console.error(`Rong error [${error.name}]: ${error.message}`);
+ *   }
+ * }
+ * ```
+ */
+export declare function isRongError(error: unknown): error is RongError;
+/**
+ * Type guard to check if an error is an AbortError.
+ */
+export declare function isAbortError(error: unknown): error is AbortError;
+/**
+ * Type guard to check if an error is a NetworkError.
+ */
+export declare function isNetworkError(error: unknown): error is NetworkError;
+/**
+ * Get a human-readable error message from any error.
+ *
+ * @param error - The error to format
+ * @returns Formatted error message
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await someOperation();
+ * } catch (error) {
+ *   console.error(formatError(error));
+ * }
+ * ```
+ */
+export declare function formatError(error: unknown): string;
+/**
+ * Assert that a value is a RongError, throwing if not.
+ *
+ * @param error - The value to check
+ * @throws {TypeError} If the value is not a RongError
+ */
+export declare function assertRongError(error: unknown): asserts error is RongError;
+export {};
+//# sourceMappingURL=error.d.ts.map

package/dist/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,OAAO,GACP,WAAW,GACX,YAAY,GACZ,gBAAgB,GAChB,YAAY,GACZ,cAAc,CAAC;AAEnB;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,KAAK;IACtC,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAE7B,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB,kEAAkE;IAClE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAExB,iCAAiC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,UAAW,SAAQ,SAAS;IAC3C,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;CAC7B;AAED,MAAM,WAAW,YAAa,SAAQ,SAAS;IAC7C,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;CAC/B;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAG9D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAGhE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAGpE;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CASlD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,SAAS,CAI1E;AAED,OAAO,EAAE,CAAC"}

package/dist/error.js

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * Error type definitions for Rong runtime
+ *
+ * Rong can throw:
+ * - standard JS `Error` objects (including `TypeError`, `RangeError`, etc.)
+ * - `DOMException` instances for Abort-related errors (e.g. `AbortError`)
+ *
+ * This module provides type guards and utilities for error handling.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertRongError = exports.formatError = exports.isNetworkError = exports.isAbortError = exports.isRongError = void 0;
+// ==================== Type Guards ====================
+/**
+ * Type guard to check if an error is a Rong runtime error.
+ *
+ * @param error - The error to check
+ * @returns true if the error is a RongError
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await Rong.readTextFile('/file.txt');
+ * } catch (error) {
+ *   if (isRongError(error)) {
+ *     console.error(`Rong error [${error.name}]: ${error.message}`);
+ *   }
+ * }
+ * ```
+ */
+function isRongError(error) {
+    return (error instanceof Error || error instanceof DOMException) &&
+        typeof error.name === 'string';
+}
+exports.isRongError = isRongError;
+/**
+ * Type guard to check if an error is an AbortError.
+ */
+function isAbortError(error) {
+    return (error instanceof Error || error instanceof DOMException) &&
+        error.name === 'AbortError';
+}
+exports.isAbortError = isAbortError;
+/**
+ * Type guard to check if an error is a NetworkError.
+ */
+function isNetworkError(error) {
+    return (error instanceof Error || error instanceof DOMException) &&
+        error.name === 'NetworkError';
+}
+exports.isNetworkError = isNetworkError;
+// ==================== Utility Functions ====================
+/**
+ * Get a human-readable error message from any error.
+ *
+ * @param error - The error to format
+ * @returns Formatted error message
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await someOperation();
+ * } catch (error) {
+ *   console.error(formatError(error));
+ * }
+ * ```
+ */
+function formatError(error) {
+    if (isRongError(error)) {
+        const code = error.code ? ` ${error.code}` : '';
+        return `[${error.name}${code}] ${error.message}`;
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+exports.formatError = formatError;
+/**
+ * Assert that a value is a RongError, throwing if not.
+ *
+ * @param error - The value to check
+ * @throws {TypeError} If the value is not a RongError
+ */
+function assertRongError(error) {
+    if (!isRongError(error)) {
+        throw new TypeError('Expected RongError');
+    }
+}
+exports.assertRongError = assertRongError;