lumiverse-spindle-types 0.4.62 → 0.4.64

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lumiverse-spindle-types",
-  "version": "0.4.62",
+  "version": "0.4.64",
   "types": "./src/index.ts",
   "keywords": [
     "lumiverse",

package/src/api.ts

@@ -290,6 +290,8 @@ export interface RequestInitDTO {
   /** When `"arraybuffer"`, the response body is returned as a base64-encoded string
    *  with `encoding: "base64"`. Used by the sandboxed-widget transparent proxy. */
   responseType?: "text" | "arraybuffer";
+  /** Restricts transparent binary proxy responses to a browser-renderable media class. */
+  mediaType?: "image" | "audio";
 }
 
 /**
@@ -689,7 +691,7 @@ export type WorldBookEntryUpdateDTO = WorldBookEntryCreateDTO;
 export type RegexPlacementDTO = "user_input" | "ai_output" | "world_info" | "reasoning";
 export type RegexScopeDTO = "global" | "character" | "chat";
 export type RegexTargetDTO = "prompt" | "response" | "display";
-export type RegexMacroModeDTO = "none" | "raw" | "escaped";
+export type RegexMacroModeDTO = "none" | "raw" | "escaped" | "after";
 
 export interface RegexScriptDTO {
   id: string;

package/src/dom.ts

@@ -190,6 +190,37 @@ export interface SpindleSandboxFrameHandle {
   destroy(): void;
 }
 
+export interface SpindleSandboxMediaResource {
+  /** Object URL that can be assigned to sandbox-local media elements. */
+  url: string;
+  /** Response media type without parameters, e.g. `audio/mpeg`. */
+  contentType: string;
+  /** Downloaded media size in bytes. */
+  sizeBytes: number;
+  /** Revoke the object URL when it is no longer needed. */
+  revoke(): void;
+}
+
+export interface SpindleSandboxAudioOptions {
+  /** Request options passed to the permission-gated CORS proxy. */
+  request?: RequestInitDTO;
+  controls?: boolean;
+  loop?: boolean;
+  muted?: boolean;
+  preload?: "none" | "metadata" | "auto";
+  /** Clamped to the browser audio range `[0, 1]`. */
+  volume?: number;
+}
+
+export interface SpindleSandboxAudioHandle extends SpindleSandboxMediaResource {
+  /** Sandbox-local audio element backed by the fetched blob URL. */
+  element: HTMLAudioElement;
+  play(): Promise<void>;
+  pause(): void;
+  /** Pause playback, detach the element, and revoke the object URL. */
+  destroy(): void;
+}
+
 /** API exposed inside the sandboxed iframe as `window.spindleSandbox`. */
 export interface SpindleSandboxAPI {
   postMessage(payload: unknown): void;
@@ -197,6 +228,10 @@ export interface SpindleSandboxAPI {
   requestResize(height?: number): void;
   /** Fetch a URL through the extension's CORS proxy. Requires the `cors_proxy` permission. */
   corsProxy(url: string, options?: RequestInitDTO): Promise<unknown>;
+  /** Fetch remote audio through the permission-gated proxy and expose it as a blob URL. */
+  fetchAudio(url: string, options?: RequestInitDTO): Promise<SpindleSandboxMediaResource>;
+  /** Fetch remote audio through the proxy and create a sandbox-local audio element. */
+  createAudio(url: string, options?: SpindleSandboxAudioOptions): Promise<SpindleSandboxAudioHandle>;
 }
 
 export interface SpindleUploadFile {

package/src/index.ts

@@ -162,9 +162,12 @@ export type {
   SpindleAppMountHandle,
    SpindleInputBarActionOptions,
    SpindleInputBarActionHandle,
-   SpindleSandboxFrameOptions,
-   SpindleSandboxFrameHandle,
-   SpindleSandboxAPI,
+    SpindleSandboxFrameOptions,
+    SpindleSandboxFrameHandle,
+    SpindleSandboxMediaResource,
+    SpindleSandboxAudioOptions,
+    SpindleSandboxAudioHandle,
+    SpindleSandboxAPI,
    SpindleContextMenuOptions,
    SpindleContextMenuItemDef,
    SpindleContextMenuResult,