@nx.js/runtime 0.0.64 → 0.0.66

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.
  *
@@ -4142,11 +4216,11 @@ declare namespace Switch {
 	     */
 	    constructor(nro: ArrayBuffer);
 	    /**
-	     * Launches the application.
+	     * Launches the installed title or homebrew application.
 	     *
-	     * @note This only works for installed applications (__not__ homebrew apps).
+	     * @param args The arguments to pass to the application (only for homebrew applications).
 	     */
-	    launch(): never;
+	    launch(...args: string[]): never;
 	    createSaveDataSync(info: SaveDataCreationInfoWithNacp): SaveData;
 	    /**
 	     * Creates the Save Data for this {@link Application} for the provided user profile.
@@ -4423,6 +4497,115 @@ declare namespace Switch {
 	    dispatchOut(rid: number, outData: BufferSource, params?: ServiceDispatchParams): void;
 	    dispatchInOut(rid: number, inData?: BufferSource, outData?: BufferSource, params?: ServiceDispatchParams): void;
 	}
+	/**
+	 * Configuration options for {@link WebApplet.start | `WebApplet.start()`}.
+	 * All values are optional and only take effect at launch time.
+	 */
+	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;
+	}
+	/**
+	 * 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
+	 * const applet = new Switch.WebApplet('https://myapp.example.com');
+	 *
+	 * applet.addEventListener('message', (e) => {
+	 *   console.log('From browser:', e.data);
+	 *   applet.sendMessage('response');
+	 * });
+	 *
+	 * applet.addEventListener('exit', () => {
+	 *   console.log('Browser closed');
+	 * });
+	 *
+	 * await applet.start({ jsExtension: true });
+	 * ```
+	 */
+	declare class WebApplet extends EventTarget {
+	    #private;
+	    constructor(url: string);
+	    /**
+	     * Whether the browser applet is currently running.
+	     */
+	    get running(): boolean;
+	    /**
+	     * 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
+	     */
+	    get mode(): string;
+	    /**
+	     * 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.
+	     */
+	    start(options?: WebAppletOptions): Promise<void>;
+	    /**
+	     * Make the browser visible if it was started hidden.
+	     */
+	    appear(): void;
+	    /**
+	     * Send a string message to the browser page.
+	     * The page receives it via `window.nx.onMessage`.
+	     * Requires `jsExtension: true` in the start options.
+	     */
+	    sendMessage(msg: string): boolean;
+	    /**
+	     * Request the browser to close gracefully.
+	     */
+	    requestExit(): void;
+	    /**
+	     * Force close the browser and clean up.
+	     */
+	    close(): void;
+	}
 	type PathLike = string | URL;
 	interface Versions {
 	    /**
@@ -4542,6 +4725,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.64",
+  "version": "0.0.66",
   "description": "nx.js runtime",
   "repository": {
     "type": "git",