@nx.js/runtime 0.0.65 → 0.0.67

package/dist/index.d.ts

@@ -587,6 +587,24 @@ declare class Path2D {
     rect(x: number, y: number, width: number, height: number): void;
     roundRect(x: number, y: number, width: number, height: number, radii?: number | number[]): void;
 }
+declare class CanvasGradient {
+    /**
+     * @ignore
+     */
+    constructor();
+    /**
+     * Adds a new color stop, defined by an offset and a color, to a given canvas gradient.
+     *
+     * @param offset A number between `0` and `1`, inclusive, representing the position of the color stop. `0` represents the start of the gradient and `1` represents the end.
+     * @param color A CSS color string representing the color of the stop.
+     * @see https://developer.mozilla.org/docs/Web/API/CanvasGradient/addColorStop
+     */
+    addColorStop(offset: number, color: string): void;
+    /**
+     * @internal
+     */
+    get _opaque(): any;
+}
 declare class CanvasRenderingContext2D {
     /**
      * @ignore
@@ -632,16 +650,16 @@ declare class CanvasRenderingContext2D {
      * @default "#000" (black)
      * @see https://developer.mozilla.org/docs/Web/API/CanvasRenderingContext2D/fillStyle
      */
-    get fillStyle(): string;
-    set fillStyle(v: string);
+    get fillStyle(): string | CanvasGradient;
+    set fillStyle(v: string | CanvasGradient);
     /**
      * Specifies the color, gradient, or pattern to use for the strokes (outlines) around shapes.
      *
      * @default "#000" (black)
      * @see https://developer.mozilla.org/docs/Web/API/CanvasRenderingContext2D/strokeStyle
      */
-    get strokeStyle(): string;
-    set strokeStyle(v: string);
+    get strokeStyle(): string | CanvasGradient;
+    set strokeStyle(v: string | CanvasGradient);
     /**
      * Specifies the alpha (transparency) value that is applied to shapes and images
      * before they are drawn onto the canvas.
@@ -1234,16 +1252,16 @@ declare class OffscreenCanvasRenderingContext2D {
      * @default "#000" (black)
      * @see https://developer.mozilla.org/docs/Web/API/CanvasRenderingContext2D/fillStyle
      */
-    get fillStyle(): string;
-    set fillStyle(v: string);
+    get fillStyle(): string | CanvasGradient;
+    set fillStyle(v: string | CanvasGradient);
     /**
      * Specifies the color, gradient, or pattern to use for the strokes (outlines) around shapes.
      *
      * @default "#000" (black)
      * @see https://developer.mozilla.org/docs/Web/API/CanvasRenderingContext2D/strokeStyle
      */
-    get strokeStyle(): string;
-    set strokeStyle(v: string);
+    get strokeStyle(): string | CanvasGradient;
+    set strokeStyle(v: string | CanvasGradient);
     /**
      * Specifies the alpha (transparency) value that is applied to shapes and images
      * before they are drawn onto the canvas.
@@ -2797,7 +2815,7 @@ declare class SubtleCrypto {
     exportKey(format: "pkcs8" | "raw" | "spki", key: CryptoKey<never>): Promise<ArrayBuffer>;
     generateKey(algorithm: "Ed25519", extractable: boolean, keyUsages: readonly ("sign" | "verify")[]): Promise<CryptoKeyPair<never>>;
     generateKey(algorithm: RsaHashedKeyGenParams | EcKeyGenParams, extractable: boolean, keyUsages: readonly KeyUsage[]): Promise<CryptoKeyPair<never>>;
-    generateKey(algorithm: AesKeyGenParams, extractable: boolean, keyUsages: readonly KeyUsage[]): Promise<CryptoKey<never>>;
+    generateKey(algorithm: AesKeyGenParams | HmacKeyGenParams, extractable: boolean, keyUsages: readonly KeyUsage[]): Promise<CryptoKey<never>>;
     /**
      * Takes as input a key in an external, portable format and returns a
      * {@link CryptoKey | `CryptoKey`} instance which can be used in the Web Crypto API.
@@ -2806,6 +2824,7 @@ declare class SubtleCrypto {
      */
     importKey<Cipher extends KeyAlgorithmIdentifier>(format: "jwk", keyData: JsonWebKey, algorithm: Cipher | KeyImportParams<Cipher>, extractable: boolean, keyUsages: KeyUsage[]): Promise<CryptoKey<Cipher>>;
     importKey<Cipher extends KeyAlgorithmIdentifier>(format: "pkcs8" | "raw" | "spki", keyData: BufferSource, algorithm: Cipher | KeyImportParams<Cipher>, extractable: boolean, keyUsages: KeyUsage[]): Promise<CryptoKey<Cipher>>;
+    importKey(format: KeyFormat, keyData: BufferSource | JsonWebKey, algorithm: Algorithm, extractable: boolean, keyUsages: KeyUsage[]): Promise<CryptoKey<never>>;
     sign(algorithm: AlgorithmIdentifier | RsaPssParams | EcdsaParams, key: CryptoKey<never>, data: BufferSource): Promise<ArrayBuffer>;
     unwrapKey(format: KeyFormat, wrappedKey: BufferSource, unwrappingKey: CryptoKey<never>, unwrapAlgorithm: AlgorithmIdentifier | RsaOaepParams | AesCtrParams | AesCbcParams | AesGcmParams, unwrappedKeyAlgorithm: AlgorithmIdentifier | HmacImportParams | RsaHashedImportParams | EcKeyImportParams, extractable: boolean, keyUsages: KeyUsage[]): Promise<CryptoKey<never>>;
     verify(algorithm: AlgorithmIdentifier | RsaPssParams | EcdsaParams, key: CryptoKey<never>, signature: BufferSource, data: BufferSource): Promise<boolean>;
@@ -2819,14 +2838,14 @@ declare class Console {
     constructor(opts?: ConsoleOptions);
     /**
      * Prints string `s` to the console on the screen, without any formatting applied.
-     * Newline is _not_ appending to the end of the string.
+     * A newline is _not_ appended to the end of the string.
      *
      * @param s The text to print to the console.
      */
     print: (s: string) => void;
     /**
      * Prints string `s` to the debug log file, without any formatting applied.
-     * Newline is _not_ appending to the end of the string.
+     * A newline is _not_ appended to the end of the string.
      *
      * > TIP: This function **does not** invoke _text rendering mode_, so it can safely be used when rendering with the Canvas API.
      *
@@ -3380,6 +3399,61 @@ declare class Storage {
  * @see https://developer.mozilla.org/docs/Web/API/Window/localStorage
  */
 declare var localStorage: Storage | undefined;
+/**
+ * The `Audio` class provides audio playback functionality similar to the
+ * [`HTMLAudioElement`](https://developer.mozilla.org/docs/Web/API/HTMLAudioElement)
+ * in web browsers.
+ *
+ * ### Supported Audio Formats
+ *
+ * - `mp3` — MP3 audio using [dr_mp3](https://github.com/mackron/dr_libs)
+ * - `wav` — WAV audio using [dr_wav](https://github.com/mackron/dr_libs)
+ * - `ogg` — OGG Vorbis audio using [stb_vorbis](https://github.com/nothings/stb)
+ *
+ * @example
+ *
+ * ```typescript
+ * const audio = new Audio('romfs:/music.mp3');
+ * audio.addEventListener('canplaythrough', () => {
+ *   audio.play();
+ * });
+ * ```
+ */
+declare class Audio extends EventTarget {
+    #private;
+    onplay: ((this: Audio, ev: Event) => any) | null;
+    onpause: ((this: Audio, ev: Event) => any) | null;
+    onended: ((this: Audio, ev: Event) => any) | null;
+    onerror: ((this: Audio, ev: ErrorEvent) => any) | null;
+    oncanplaythrough: ((this: Audio, ev: Event) => any) | null;
+    onloadedmetadata: ((this: Audio, ev: Event) => any) | null;
+    ontimeupdate: ((this: Audio, ev: Event) => any) | null;
+    constructor(src?: string);
+    get src(): string;
+    set src(val: string);
+    get currentSrc(): string;
+    get volume(): number;
+    set volume(val: number);
+    get loop(): boolean;
+    set loop(val: boolean);
+    get paused(): boolean;
+    get ended(): boolean;
+    get currentTime(): number;
+    set currentTime(val: number);
+    get duration(): number;
+    get playbackRate(): number;
+    set playbackRate(val: number);
+    get readyState(): number;
+    static get HAVE_NOTHING(): number;
+    static get HAVE_METADATA(): number;
+    static get HAVE_CURRENT_DATA(): number;
+    static get HAVE_FUTURE_DATA(): number;
+    static get HAVE_ENOUGH_DATA(): number;
+    load(): void;
+    play(): Promise<void>;
+    pause(): void;
+    dispatchEvent(event: Event): boolean;
+}
 /**
  * The `Window` class represents the global scope within the application.
  *
@@ -3619,21 +3693,6 @@ declare function queueMicrotask(callback: () => void): void;
  * The `Switch` global object contains native interfaces to interact with the Switch hardware.
  */
 declare namespace Switch {
-	/**
-	 * A Map-like object providing methods to interact with the environment variables of the process.
-	 *
-	 * Use {@link env | `Switch.env`} to access the singleton instance of this class.
-	 */
-	declare class Env {
-	    /**
-	     * @private
-	     */
-	    constructor();
-	    get(name: string): string | undefined;
-	    set(name: string, value: string): void;
-	    delete(name: string): void;
-	    toObject(): Record<string, string>;
-	}
 	/**
 	 * The `Socket` class represents a TCP connection, from which you can
 	 * read and write data. A socket begins in a _connected_ state (if the
@@ -3681,15 +3740,20 @@ declare namespace Switch {
 	    close(): void;
 	}
 	/**
-	 * Performs a DNS lookup to resolve a hostname to an array of IP addresses.
-	 *
-	 * @example
+	 * A Map-like object providing methods to interact with the environment variables of the process.
 	 *
-	 * ```typescript
-	 * const ipAddresses = await Switch.resolveDns('example.com');
-	 * ```
+	 * Use {@link env | `Switch.env`} to access the singleton instance of this class.
 	 */
-	declare function resolveDns(hostname: string): Promise<string[]>;
+	declare class Env {
+	    /**
+	     * @private
+	     */
+	    constructor();
+	    get(name: string): string | undefined;
+	    set(name: string, value: string): void;
+	    delete(name: string): void;
+	    toObject(): Record<string, string>;
+	}
 	interface ReadFileOptions {
 	    /**
 	     * Byte offset to start reading the file from.
@@ -3857,126 +3921,102 @@ declare namespace Switch {
 	    stream(opts?: FsFileStreamOptions): ReadableStream<Uint8Array>;
 	    get writable(): WritableStream<string | BufferSource>;
 	}
-	interface InspectOptions {
-	    depth?: number;
-	    refs?: Map<{}, number>;
-	}
 	/**
-	 * Inspects a given value and returns a string representation of it.
-	 * The function uses ANSI color codes to highlight different parts of the output.
-	 * It can handle and correctly output different types of values including primitives, functions, arrays, and objects.
+	 * The `Switch.Album` class allows for interacting with the Switch's photo gallery,
+	 * providing access to the screenshots / video recordings that the user has saved.
 	 *
-	 * @param v The value to inspect.
-	 * @param opts Options which may modify the generated string representation of the value.
-	 * @returns A string representation of `v` with ANSI color codes.
+	 * It is a `Set` subclass, which contains entries of
+	 * {@link AlbumFile | `Switch.AlbumFile`} instances.
+	 *
+	 * @example
+	 *
+	 * ```typescript
+	 * import { CapsAlbumStorage } from '@nx.js/constants';
+	 *
+	 * const album = new Switch.Album(CapsAlbumStorage.Sd);
+	 * for (const file of album) {
+	 *   console.log(file);
+	 * }
+	 * ```
 	 */
-	declare const inspect: {
-	    (v: unknown, opts?: InspectOptions): string;
-	    custom: symbol;
-	    keys: symbol;
-	    values: symbol;
-	    entries: symbol;
-	};
-	type ProfileUid = [
-	    bigint,
-	    bigint
-	];
+	declare class Album extends Set<AlbumFile> {
+	    readonly storage: number;
+	    constructor(storage: number);
+	    values(): SetIterator<AlbumFile>;
+	    keys(): SetIterator<AlbumFile>;
+	    entries(): SetIterator<[
+	        AlbumFile,
+	        AlbumFile
+	    ]>;
+	    [Symbol.iterator](): SetIterator<AlbumFile>;
+	}
 	/**
-	 * Represents a user profile that exists on the system.
+	 * Represents a file within a {@link Album | `Switch.Album`} content store,
+	 * which is either a screenshot (JPEG image) or a screen recording (MP4 movie).
+	 *
+	 * It is a subclass of `File`, so you can use familiar features like `name`,
+	 * `lastModified` and `arrayBuffer()`. It also has additional metadata like
+	 * `applicationId` to determine which application generated the contents.
+	 *
+	 * @example
+	 *
+	 * ```typescript
+	 * const ctx = screen.getContext('2d');
+	 * const buf = await file.arrayBuffer();
+	 * const img = await createImageBitmap(new Blob([buf]));
+	 * ctx.drawImage(img, 0, 0);
+	 * ```
 	 */
-	declare class Profile {
-	    /**
-	     * The unique ID of the profile, represented as an array of two `bigint` values.
-	     */
-	    readonly uid: ProfileUid;
-	    /**
-	     * The human readable nickname of the profile.
-	     */
-	    readonly nickname: string;
+	declare class AlbumFile extends File {
 	    /**
-	     * The raw JPEG data for the profile image. Can be decoded with the `Image` class.
+	     * The ID of the application which generated the album file.
 	     */
-	    readonly image: ArrayBuffer;
+	    applicationId: bigint;
 	    /**
-	     * Creates a new `Profile` instance from the given profile UID.
-	     *
-	     * @example
-	     *
-	     * ```typescript
-	     * const profile = new Switch.Profile([
-	     *   0x10005d4864d166b7n,
-	     *   0x965b8cb028cd8a81n,
-	     * ]);
-	     * console.log(profile.nickname);
-	     * ```
+	     * The type of content which the album file contains. The value
+	     * corresponds with the `CapsAlbumFileContents` enum from `@nx.js/constants`.
 	     */
-	    constructor(uid: ProfileUid);
+	    content: number;
 	    /**
-	     * Gets or sets the "current" user profile.
-	     *
-	     * Initially, this value will correspond to the user profile that was selected
-	     * via the user selection interface when the application was launched.
-	     *
-	     * Will be `null` if no user profile is currently selected.
-	     *
-	     * @example
-	     *
-	     * ```typescript
-	     * const profile = Switch.Profile.current;
-	     * if (profile) {
-	     *   console.log(`Current user: ${profile.nickname}`);
-	     * } else {
-	     *   console.log('No user is currently selected');
-	     * }
-	     * ```
+	     * The storage device which contains the album file. The value
+	     * corresponds with the `CapsAlbumStorage` enum from `@nx.js/constants`.
 	     */
-	    static set current(v: Profile | null);
-	    static get current(): Profile | null;
+	    storage: number;
 	    /**
-	     * Shows the user selection interface and returns a {@link Profile}
-	     * instance representing the user that was selected.
+	     * Unique ID for when there's multiple album files with the same timestamp.
 	     *
-	     * @note This function blocks the event loop until the user has made their selection.
+	     * @note The value is usually `0`.
 	     */
-	    static select(): Profile | null;
+	    id: number;
+	    constructor(storage: number, id: string);
+	    text(): Promise<string>;
+	    slice(start?: number, end?: number, type?: string): Blob;
+	    stream(): ReadableStream<Uint8Array>;
 	    /**
-	     * Can be used as an iterator to retrieve the list of user profiles.
+	     * Loads the thumbnail JPEG image for the album file.
 	     *
 	     * @example
 	     *
 	     * ```typescript
-	     * for (const profile of Switch.Profile) {
-	     *   console.log(profile.nickname);
-	     * }
+	     * const ctx = screen.getContext('2d');
+	     * const buf = await file.thumbnail();
+	     * const img = await createImageBitmap(new Blob([buf]));
+	     * ctx.drawImage(img, 0, 0);
 	     * ```
 	     */
-	    static [Symbol.iterator](): Generator<Profile, void, unknown>;
-	}
-	interface SaveDataCreationInfoBase {
-	    spaceId: number;
-	    type: number;
-	    size: bigint;
-	    journalSize: bigint;
-	    uid?: ProfileUid;
-	    systemId?: bigint;
-	    applicationId?: bigint;
-	    index?: number;
-	    rank?: number;
-	}
-	interface SaveDataCreationInfoWithNacp {
-	    spaceId: number;
-	    type: number;
-	    size?: bigint;
-	    journalSize?: bigint;
-	    uid?: ProfileUid;
-	    index?: number;
-	    rank?: number;
+	    thumbnail(): Promise<ArrayBuffer>;
 	}
-	type SaveDataCreationInfo = SaveDataCreationInfoBase | SaveDataCreationInfoWithNacp;
 	/**
-	 * Represents a "save data store".
+	 * Performs a DNS lookup to resolve a hostname to an array of IP addresses.
+	 *
+	 * @example
+	 *
+	 * ```typescript
+	 * const ipAddresses = await Switch.resolveDns('example.com');
+	 * ```
 	 */
-	declare class SaveData {
+	declare function resolveDns(hostname: string): Promise<string[]>;
+	declare class FileSystem {
 	    /**
 	     * A `URL` instance that points to the root of the filesystem mount.
 	     * You should use this to create file path references within
@@ -3985,33 +4025,295 @@ declare namespace Switch {
 	     * @example
 	     *
 	     * ```typescript
-	     * const dataUrl = new URL('data.json', saveData.url);
+	     * const dataUrl = new URL('data.json', fileSystem.url);
 	     * ```
 	     */
 	    url: URL | null;
-	    readonly id: bigint;
-	    readonly spaceId: number;
-	    readonly type: number;
-	    readonly uid: ProfileUid;
-	    readonly systemId: bigint;
-	    readonly applicationId: bigint;
-	    readonly size: bigint;
-	    readonly index: number;
-	    readonly rank: number;
 	    /**
 	     * @private
 	     */
 	    constructor();
 	    /**
-	     * Commits to the disk any write operations that have occurred on this filesystem mount since the previous commit.
+	     * The amount of free space available on the filesystem, in bytes.
+	     */
+	    freeSpace(): bigint;
+	    /**
+	     * The total amount of space available on the filesystem, in bytes.
+	     */
+	    totalSpace(): bigint;
+	    /**
+	     * Mounts the `FileSystem` such that filesystem operations may be used.
 	     *
-	     * > WARNING: Failure to call this function after writes will cause the data to be lost after the application exits.
+	     * @param name The name of the mount for filesystem paths. By default, a random name is generated. Should not exceed 31 characters, and should not have a trailing colon.
+	     */
+	    mount(name?: string): URL;
+	    /**
+	     * Opens a file system partition specified by its `BisPartitionId`.
 	     *
 	     * @example
 	     *
 	     * ```typescript
-	     * const saveStateUrl = new URL('state', saveData.url);
-	     * Switch.writeFileSync(saveStateUrl, 'my application state...');
+	     * import { BisPartitionId } from '@nx.js/constants';
+	     *
+	     * // Open and mount the "User" partition
+	     * const fs = Switch.FileSystem.openBis(BisPartitionId.User);
+	     * const url = fs.mount();
+	     *
+	     * // Read the file entries at the root of the partition
+	     * console.log(Switch.readDirSync(url));
+	     * ```
+	     *
+	     * @param id The `BisPartitionId` of the partition to open.
+	     */
+	    static openBis(id: number): FileSystem;
+	    /**
+	     * Opens a file system partition for the SD card.
+	     *
+	     * Note that the SD card is automatically mounted under the `sdmc:` protocol,
+	     * so your application will not need to call this function under most circumstances.
+	     * However, it is useful for querying metatdata about the SD card, such as
+	     * the amount of free space available.
+	     *
+	     * @example
+	     *
+	     * ```typescript
+	     * const fs = Switch.FileSystem.openSdmc();
+	     * console.log(fs.freeSpace());
+	     * console.log(fs.totalSpace());
+	     * ```
+	     */
+	    static openSdmc(): FileSystem;
+	    /**
+	     * Opens a file system partition for the application with the specified title ID.
+	     * The file system type is specified by the `FsFileSystemType` parameter.
+	     *
+	     * @example
+	     *
+	     * ```typescript
+	     * import { FsFileSystemType } from '@nx.js/constants';
+	     *
+	     * // Open and mount the "User" partition
+	     * const fs = Switch.FileSystem.openWithId(
+	     *   0x0100000000001000n,
+	     *   FsFileSystemType.ContentMeta,
+	     * );
+	     * const url = fs.mount();
+	     *
+	     * // Read the file entries at the root of the file system
+	     * console.log(Switch.readDirSync(url));
+	     * ```
+	     *
+	     * @param titleId The title ID of the file system to open.
+	     * @param type The `FsFileSystemType` of the file system to open.
+	     * @param path The base path of the file system to open. Defaults to `/`.
+	     */
+	    static openWithId(titleId: bigint, type: number, path?: string): FileSystem;
+	}
+	interface InspectOptions {
+	    depth?: number;
+	    refs?: Map<{}, number>;
+	}
+	/**
+	 * Inspects a given value and returns a string representation of it.
+	 * The function uses ANSI color codes to highlight different parts of the output.
+	 * It can handle and correctly output different types of values including primitives, functions, arrays, and objects.
+	 *
+	 * @param v The value to inspect.
+	 * @param opts Options which may modify the generated string representation of the value.
+	 * @returns A string representation of `v` with ANSI color codes.
+	 */
+	declare const inspect: {
+	    (v: unknown, opts?: InspectOptions): string;
+	    custom: symbol;
+	    keys: symbol;
+	    values: symbol;
+	    entries: symbol;
+	};
+	interface IRSensorInit {
+	    /**
+	     * The desired number of times per second a sample should be taken,
+	     * meaning the number of times per second that the `reading` event
+	     * will be called. A whole number or decimal may be used, the latter
+	     * for frequencies less than a second.
+	     *
+	     * @default 2
+	     */
+	    frequency?: number;
+	    /**
+	     * CSS color that will be used when rendering the image produced by
+	     * the IR sensor.
+	     *
+	     * @default "green"
+	     */
+	    color?: string;
+	}
+	/**
+	 * The `IRSensor` class reads the controller's IR (infrared) camera,
+	 * allowing the application to get the image data for each frame of
+	 * the camera.
+	 *
+	 * @example
+	 *
+	 * ```typescript
+	 * const ctx = screen.getContext('2d');
+	 *
+	 * const sensor = new Switch.IRSensor();
+	 * sensor.addEventListener('reading', () => {
+	 * 	ctx.drawImage(sensor.image, 0, 0);
+	 * });
+	 * sensor.start();
+	 * ```
+	 */
+	declare class IRSensor extends Sensor {
+	    constructor(opts?: IRSensorInit);
+	    /**
+	     * The underlying `ImageBitmap` instance containing the contents
+	     * of the IR sensor. Can be used with `ctx.drawImage()` or any
+	     * other functions that work with `ImageBitmap` instances.
+	     */
+	    get image(): ImageBitmap;
+	    get activated(): boolean;
+	    get hasReading(): boolean;
+	    get timestamp(): number | null;
+	    start(): void;
+	    stop(): void;
+	}
+	declare function networkInfo(): NetworkInfo;
+	type ProfileUid = [
+	    bigint,
+	    bigint
+	];
+	/**
+	 * Represents a user profile that exists on the system.
+	 */
+	declare class Profile {
+	    /**
+	     * The unique ID of the profile, represented as an array of two `bigint` values.
+	     */
+	    readonly uid: ProfileUid;
+	    /**
+	     * The human readable nickname of the profile.
+	     */
+	    readonly nickname: string;
+	    /**
+	     * The raw JPEG data for the profile image. Can be decoded with the `Image` class.
+	     */
+	    readonly image: ArrayBuffer;
+	    /**
+	     * Creates a new `Profile` instance from the given profile UID.
+	     *
+	     * @example
+	     *
+	     * ```typescript
+	     * const profile = new Switch.Profile([
+	     *   0x10005d4864d166b7n,
+	     *   0x965b8cb028cd8a81n,
+	     * ]);
+	     * console.log(profile.nickname);
+	     * ```
+	     */
+	    constructor(uid: ProfileUid);
+	    /**
+	     * Gets or sets the "current" user profile.
+	     *
+	     * Initially, this value will correspond to the user profile that was selected
+	     * via the user selection interface when the application was launched.
+	     *
+	     * Will be `null` if no user profile is currently selected.
+	     *
+	     * @example
+	     *
+	     * ```typescript
+	     * const profile = Switch.Profile.current;
+	     * if (profile) {
+	     *   console.log(`Current user: ${profile.nickname}`);
+	     * } else {
+	     *   console.log('No user is currently selected');
+	     * }
+	     * ```
+	     */
+	    static set current(v: Profile | null);
+	    static get current(): Profile | null;
+	    /**
+	     * Shows the user selection interface and returns a {@link Profile}
+	     * instance representing the user that was selected.
+	     *
+	     * @note This function blocks the event loop until the user has made their selection.
+	     */
+	    static select(): Profile | null;
+	    /**
+	     * Can be used as an iterator to retrieve the list of user profiles.
+	     *
+	     * @example
+	     *
+	     * ```typescript
+	     * for (const profile of Switch.Profile) {
+	     *   console.log(profile.nickname);
+	     * }
+	     * ```
+	     */
+	    static [Symbol.iterator](): Generator<Profile, void, unknown>;
+	}
+	interface SaveDataCreationInfoBase {
+	    spaceId: number;
+	    type: number;
+	    size: bigint;
+	    journalSize: bigint;
+	    uid?: ProfileUid;
+	    systemId?: bigint;
+	    applicationId?: bigint;
+	    index?: number;
+	    rank?: number;
+	}
+	interface SaveDataCreationInfoWithNacp {
+	    spaceId: number;
+	    type: number;
+	    size?: bigint;
+	    journalSize?: bigint;
+	    uid?: ProfileUid;
+	    index?: number;
+	    rank?: number;
+	}
+	type SaveDataCreationInfo = SaveDataCreationInfoBase | SaveDataCreationInfoWithNacp;
+	/**
+	 * Represents a "save data store".
+	 */
+	declare class SaveData {
+	    /**
+	     * A `URL` instance that points to the root of the filesystem mount.
+	     * You should use this to create file path references within
+	     * the filesystem mount.
+	     *
+	     * @example
+	     *
+	     * ```typescript
+	     * const dataUrl = new URL('data.json', saveData.url);
+	     * ```
+	     */
+	    url: URL | null;
+	    readonly id: bigint;
+	    readonly spaceId: number;
+	    readonly type: number;
+	    readonly uid: ProfileUid;
+	    readonly systemId: bigint;
+	    readonly applicationId: bigint;
+	    readonly size: bigint;
+	    readonly index: number;
+	    readonly rank: number;
+	    /**
+	     * @private
+	     */
+	    constructor();
+	    /**
+	     * Commits to the disk any write operations that have occurred on this filesystem mount since the previous commit.
+	     *
+	     * > WARNING: Failure to call this function after writes will cause the data to be lost after the application exits.
+	     *
+	     * @example
+	     *
+	     * ```typescript
+	     * const saveStateUrl = new URL('state', saveData.url);
+	     * Switch.writeFileSync(saveStateUrl, 'my application state...');
 	     *
 	     * saveData.commit(); // Write operation is persisted to the disk
 	     * ```
@@ -4058,7 +4360,6 @@ declare namespace Switch {
 	    static createSync(init: SaveDataCreationInfoWithNacp, nacp: ArrayBuffer): SaveData;
 	    static [Symbol.iterator](): Generator<SaveData, void, unknown>;
 	}
-	declare function networkInfo(): NetworkInfo;
 	/**
 	 * Represents an installed application (game) on the console,
 	 * or a homebrew application (`.nro` file).
@@ -4174,254 +4475,136 @@ declare namespace Switch {
 	    static get self(): Application;
 	    static [Symbol.iterator](): Generator<Application, void, unknown>;
 	}
-	interface IRSensorInit {
-	    /**
-	     * The desired number of times per second a sample should be taken,
-	     * meaning the number of times per second that the `reading` event
-	     * will be called. A whole number or decimal may be used, the latter
-	     * for frequencies less than a second.
-	     *
-	     * @default 2
-	     */
-	    frequency?: number;
-	    /**
-	     * CSS color that will be used when rendering the image produced by
-	     * the IR sensor.
-	     *
-	     * @default "green"
-	     */
-	    color?: string;
+	interface ServiceDispatchParams {
+	    targetSession?: number;
+	    context?: number;
+	    bufferAttrs?: number[];
+	    buffers?: BufferSource[];
+	    inSendPid?: boolean;
+	    inObjects?: Service[];
+	    inHandles?: number[];
+	    outObjects?: Service[];
+	    outHandleAttrs?: number[];
+	    outHandles?: number[];
+	}
+	declare class Service {
+	    constructor(name?: string);
+	    isActive(): void;
+	    isDomain(): void;
+	    isOverride(): void;
+	    dispatch(rid: number, params?: ServiceDispatchParams): void;
+	    dispatchIn(rid: number, inData: BufferSource, parmas?: ServiceDispatchParams): void;
+	    dispatchOut(rid: number, outData: BufferSource, params?: ServiceDispatchParams): void;
+	    dispatchInOut(rid: number, inData?: BufferSource, outData?: BufferSource, params?: ServiceDispatchParams): void;
 	}
 	/**
-	 * The `IRSensor` class reads the controller's IR (infrared) camera,
-	 * allowing the application to get the image data for each frame of
-	 * the camera.
-	 *
-	 * @example
-	 *
-	 * ```typescript
-	 * const ctx = screen.getContext('2d');
-	 *
-	 * const sensor = new Switch.IRSensor();
-	 * sensor.addEventListener('reading', () => {
-	 * 	ctx.drawImage(sensor.image, 0, 0);
-	 * });
-	 * sensor.start();
-	 * ```
+	 * Configuration options for {@link WebApplet.start | `WebApplet.start()`}.
+	 * All values are optional and only take effect at launch time.
 	 */
-	declare class IRSensor extends Sensor {
-	    constructor(opts?: IRSensorInit);
-	    /**
-	     * The underlying `ImageBitmap` instance containing the contents
-	     * of the IR sensor. Can be used with `ctx.drawImage()` or any
-	     * other functions that work with `ImageBitmap` instances.
-	     */
-	    get image(): ImageBitmap;
-	    get activated(): boolean;
-	    get hasReading(): boolean;
-	    get timestamp(): number | null;
-	    start(): void;
-	    stop(): void;
+	interface WebAppletOptions {
+	    /** Enable the `window.nx` JavaScript API in the browser for bidirectional messaging. */
+	    jsExtension?: boolean;
+	    /** Start the browser hidden (can be shown later with {@link WebApplet.appear | `appear()`}). */
+	    bootHidden?: boolean;
+	    /** Whether to show the footer (address bar). */
+	    footer?: boolean;
+	    /** Whether to show a pointer cursor. */
+	    pointer?: boolean;
+	    /** Left stick behavior: `'pointer'` (move pointer) or `'cursor'` (scroll). */
+	    leftStickMode?: "pointer" | "cursor";
+	    /** Boot display screen color. */
+	    bootDisplayKind?: "default" | "white" | "black";
+	    /** Background kind. */
+	    backgroundKind?: "default";
+	    /** Footer fixed display kind. */
+	    footerFixedKind?: "default" | "always" | "hidden";
+	    /** Boot as a media player applet. */
+	    bootAsMediaPlayer?: boolean;
+	    /** Enable/disable screenshot capture (Web mode only). */
+	    screenShot?: boolean;
+	    /** Enable/disable the page cache. */
+	    pageCache?: boolean;
+	    /** Enable/disable Web Audio API. */
+	    webAudio?: boolean;
+	    /** Enable/disable page fade transition. */
+	    pageFade?: boolean;
+	    /** Show/hide the boot loading icon (Offline mode only). */
+	    bootLoadingIcon?: boolean;
+	    /** Show/hide the page scroll indicator. */
+	    pageScrollIndicator?: boolean;
+	    /** Enable/disable media player speed controls. */
+	    mediaPlayerSpeedControl?: boolean;
+	    /** Enable/disable media autoplay. */
+	    mediaAutoPlay?: boolean;
+	    /** Override web audio volume (0.0 to 1.0). */
+	    overrideWebAudioVolume?: number;
+	    /** Override media audio volume (0.0 to 1.0). */
+	    overrideMediaAudioVolume?: number;
+	    /** Enable/disable media player auto-close on end. */
+	    mediaPlayerAutoClose?: boolean;
+	    /** Show/hide media player UI (Offline mode only). */
+	    mediaPlayerUi?: boolean;
+	    /** Additional string appended to the user agent (Web mode only). */
+	    userAgentAdditionalString?: string;
 	}
 	/**
-	 * The `Switch.Album` class allows for interacting with the Switch's photo gallery,
-	 * providing access to the screenshots / video recordings that the user has saved.
-	 *
-	 * It is a `Set` subclass, which contains entries of
-	 * {@link AlbumFile | `Switch.AlbumFile`} instances.
-	 *
-	 * @example
+	 * Opens the Switch's built-in web browser as a Library Applet.
+	 * Requires Application mode (NSP install or hbmenu via title override).
 	 *
+	 * @example Non-blocking with messaging
 	 * ```typescript
-	 * import { CapsAlbumStorage } from '@nx.js/constants';
-	 *
-	 * const album = new Switch.Album(CapsAlbumStorage.Sd);
-	 * for (const file of album) {
-	 *   console.log(file);
-	 * }
-	 * ```
-	 */
-	declare class Album extends Set<AlbumFile> {
-	    readonly storage: number;
-	    constructor(storage: number);
-	    values(): SetIterator<AlbumFile>;
-	    keys(): SetIterator<AlbumFile>;
-	    entries(): SetIterator<[
-	        AlbumFile,
-	        AlbumFile
-	    ]>;
-	    [Symbol.iterator](): SetIterator<AlbumFile>;
-	}
-	/**
-	 * Represents a file within a {@link Album | `Switch.Album`} content store,
-	 * which is either a screenshot (JPEG image) or a screen recording (MP4 movie).
+	 * const applet = new Switch.WebApplet('https://myapp.example.com');
 	 *
-	 * It is a subclass of `File`, so you can use familiar features like `name`,
-	 * `lastModified` and `arrayBuffer()`. It also has additional metadata like
-	 * `applicationId` to determine which application generated the contents.
+	 * applet.addEventListener('message', (e) => {
+	 *   console.log('From browser:', e.data);
+	 *   applet.sendMessage('response');
+	 * });
 	 *
-	 * @example
+	 * applet.addEventListener('exit', () => {
+	 *   console.log('Browser closed');
+	 * });
 	 *
-	 * ```typescript
-	 * const ctx = screen.getContext('2d');
-	 * const buf = await file.arrayBuffer();
-	 * const img = await createImageBitmap(new Blob([buf]));
-	 * ctx.drawImage(img, 0, 0);
+	 * await applet.start({ jsExtension: true });
 	 * ```
 	 */
-	declare class AlbumFile extends File {
+	declare class WebApplet extends EventTarget {
+	    #private;
+	    constructor(url: string);
 	    /**
-	     * The ID of the application which generated the album file.
+	     * Whether the browser applet is currently running.
 	     */
-	    applicationId: bigint;
+	    get running(): boolean;
 	    /**
-	     * The type of content which the album file contains. The value
-	     * corresponds with the `CapsAlbumFileContents` enum from `@nx.js/constants`.
+	     * The current operating mode:
+	     * - `'web-session'` — HTTP/HTTPS URL with WebSession (supports `window.nx` messaging)
+	     * - `'htmldoc'` — HtmlDocument applet loading HTML from app's html-document NCA (supports `window.nx` messaging)
+	     * - `'none'` — not started
 	     */
-	    content: number;
+	    get mode(): string;
 	    /**
-	     * The storage device which contains the album file. The value
-	     * corresponds with the `CapsAlbumStorage` enum from `@nx.js/constants`.
+	     * Opens the browser. The nx.js event loop continues running.
+	     * Pass an options object to configure the applet before launch.
+	     * Listen for `'message'` and `'exit'` events.
 	     */
-	    storage: number;
+	    start(options?: WebAppletOptions): Promise<void>;
 	    /**
-	     * Unique ID for when there's multiple album files with the same timestamp.
-	     *
-	     * @note The value is usually `0`.
+	     * Make the browser visible if it was started hidden.
 	     */
-	    id: number;
-	    constructor(storage: number, id: string);
-	    text(): Promise<string>;
-	    slice(start?: number, end?: number, type?: string): Blob;
-	    stream(): ReadableStream<Uint8Array>;
+	    appear(): void;
 	    /**
-	     * Loads the thumbnail JPEG image for the album file.
-	     *
-	     * @example
-	     *
-	     * ```typescript
-	     * const ctx = screen.getContext('2d');
-	     * const buf = await file.thumbnail();
-	     * const img = await createImageBitmap(new Blob([buf]));
-	     * ctx.drawImage(img, 0, 0);
-	     * ```
-	     */
-	    thumbnail(): Promise<ArrayBuffer>;
-	}
-	declare class FileSystem {
-	    /**
-	     * A `URL` instance that points to the root of the filesystem mount.
-	     * You should use this to create file path references within
-	     * the filesystem mount.
-	     *
-	     * @example
-	     *
-	     * ```typescript
-	     * const dataUrl = new URL('data.json', fileSystem.url);
-	     * ```
-	     */
-	    url: URL | null;
-	    /**
-	     * @private
-	     */
-	    constructor();
-	    /**
-	     * The amount of free space available on the filesystem, in bytes.
+	     * Send a string message to the browser page.
+	     * The page receives it via `window.nx.onMessage`.
+	     * Requires `jsExtension: true` in the start options.
 	     */
-	    freeSpace(): bigint;
-	    /**
-	     * The total amount of space available on the filesystem, in bytes.
-	     */
-	    totalSpace(): bigint;
+	    sendMessage(msg: string): boolean;
 	    /**
-	     * Mounts the `FileSystem` such that filesystem operations may be used.
-	     *
-	     * @param name The name of the mount for filesystem paths. By default, a random name is generated. Should not exceed 31 characters, and should not have a trailing colon.
+	     * Request the browser to close gracefully.
 	     */
-	    mount(name?: string): URL;
+	    requestExit(): void;
 	    /**
-	     * Opens a file system partition specified by its `BisPartitionId`.
-	     *
-	     * @example
-	     *
-	     * ```typescript
-	     * import { BisPartitionId } from '@nx.js/constants';
-	     *
-	     * // Open and mount the "User" partition
-	     * const fs = Switch.FileSystem.openBis(BisPartitionId.User);
-	     * const url = fs.mount();
-	     *
-	     * // Read the file entries at the root of the partition
-	     * console.log(Switch.readDirSync(url));
-	     * ```
-	     *
-	     * @param id The `BisPartitionId` of the partition to open.
+	     * Force close the browser and clean up.
 	     */
-	    static openBis(id: number): FileSystem;
-	    /**
-	     * Opens a file system partition for the SD card.
-	     *
-	     * Note that the SD card is automatically mounted under the `sdmc:` protocol,
-	     * so your application will not need to call this function under most circumstances.
-	     * However, it is useful for querying metatdata about the SD card, such as
-	     * the amount of free space available.
-	     *
-	     * @example
-	     *
-	     * ```typescript
-	     * const fs = Switch.FileSystem.openSdmc();
-	     * console.log(fs.freeSpace());
-	     * console.log(fs.totalSpace());
-	     * ```
-	     */
-	    static openSdmc(): FileSystem;
-	    /**
-	     * Opens a file system partition for the application with the specified title ID.
-	     * The file system type is specified by the `FsFileSystemType` parameter.
-	     *
-	     * @example
-	     *
-	     * ```typescript
-	     * import { FsFileSystemType } from '@nx.js/constants';
-	     *
-	     * // Open and mount the "User" partition
-	     * const fs = Switch.FileSystem.openWithId(
-	     *   0x0100000000001000n,
-	     *   FsFileSystemType.ContentMeta,
-	     * );
-	     * const url = fs.mount();
-	     *
-	     * // Read the file entries at the root of the file system
-	     * console.log(Switch.readDirSync(url));
-	     * ```
-	     *
-	     * @param titleId The title ID of the file system to open.
-	     * @param type The `FsFileSystemType` of the file system to open.
-	     * @param path The base path of the file system to open. Defaults to `/`.
-	     */
-	    static openWithId(titleId: bigint, type: number, path?: string): FileSystem;
-	}
-	interface ServiceDispatchParams {
-	    targetSession?: number;
-	    context?: number;
-	    bufferAttrs?: number[];
-	    buffers?: BufferSource[];
-	    inSendPid?: boolean;
-	    inObjects?: Service[];
-	    inHandles?: number[];
-	    outObjects?: Service[];
-	    outHandleAttrs?: number[];
-	    outHandles?: number[];
-	}
-	declare class Service {
-	    constructor(name?: string);
-	    isActive(): void;
-	    isDomain(): void;
-	    isOverride(): void;
-	    dispatch(rid: number, params?: ServiceDispatchParams): void;
-	    dispatchIn(rid: number, inData: BufferSource, parmas?: ServiceDispatchParams): void;
-	    dispatchOut(rid: number, outData: BufferSource, params?: ServiceDispatchParams): void;
-	    dispatchInOut(rid: number, inData?: BufferSource, outData?: BufferSource, params?: ServiceDispatchParams): void;
+	    close(): void;
 	}
 	type PathLike = string | URL;
 	interface Versions {
@@ -4441,6 +4624,8 @@ declare namespace Switch {
 	    readonly freetype2: string;
 	    readonly harfbuzz: string;
 	    readonly hos: string;
+	    readonly libnx: string;
+	    readonly mbedtls: string;
 	    readonly nxjs: string;
 	    readonly png: string;
 	    readonly quickjs: string;
@@ -4542,6 +4727,17 @@ declare namespace Switch {
 	     * This option is similar to that offered by the Node.js net module and allows interoperability with code which utilizes it.
 	     */
 	    allowHalfOpen?: boolean;
+	    /**
+	     * When `true` (default), the TLS handshake will verify the server's
+	     * certificate against the system CA certificate store. Set to `false`
+	     * to disable certificate verification (e.g. for development/testing
+	     * with self-signed certificates).
+	     *
+	     * Only applicable when `secureTransport` is `'on'` or `'starttls'`.
+	     *
+	     * @default true
+	     */
+	    rejectUnauthorized?: boolean;
 	}
 	interface SocketInfo {
 	    remoteAddress: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nx.js/runtime",
-  "version": "0.0.65",
+  "version": "0.0.67",
   "description": "nx.js runtime",
   "repository": {
     "type": "git",