@nonstrict/recordkit 0.87.1 → 0.97.0

package/out/IpcRecordKit.js.map

@@ -1 +1 @@
-{"version":3,"file":"IpcRecordKit.js","sourceRoot":"","sources":["../src/IpcRecordKit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,MAAM,OAAO,YAAY;IACf,YAAY,CAAgB;IAC3B,KAAK,CAAQ;IAEtB;QACE,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,gBAAwB,EAAE,cAAuB,KAAK;QACrE,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YAAC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;QAAC,CAAC;QAEjG,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC;QACrC,IAAI,CAAC,YAAY,GAAG,MAAM,IAAI,OAAO,CAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACtE,MAAM,YAAY,GAAG,KAAK,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;YAC1G,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,qCAAqC,IAAI,eAAe,MAAM,EAAE,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;YAC/H,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;YACtD,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,qCAAqC,IAAI,eAAe,MAAM,EAAE,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;YAC9H,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;QAC3D,CAAC,CAAC,CAAA;QAEF,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,CAAA;QAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;YAAC,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAA;QAAC,CAAC;QAE1F,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAC9D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;QAEH,IAAI,MAAM,EAAE,CAAC;YACX,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;gBAC9D,OAAO,CAAC,GAAG,CAAC,wCAAwC,IAAI,EAAE,CAAC,CAAC;YAC9D,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,OAAe;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC;QACvC,IAAI,CAAC,KAAK,EAAE,CAAC;YAAC,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAA;QAAC,CAAC;QAC5E,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IAC7B,CAAC;CACF"}
+{"version":3,"file":"IpcRecordKit.js","sourceRoot":"","sources":["../src/IpcRecordKit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,MAAM,OAAO,YAAY;IACf,YAAY,CAAgB;IAC3B,KAAK,CAAQ;IAEtB;QACE,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,gBAAwB,EAAE,cAAuB,KAAK;QACrE,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YAAC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;QAAC,CAAC;QAEjG,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC;QACrC,IAAI,CAAC,YAAY,GAAG,MAAM,IAAI,OAAO,CAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACtE,MAAM,YAAY,GAAG,KAAK,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;YAC1G,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,qCAAqC,IAAI,eAAe,MAAM,EAAE,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;YAC/H,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;YACtD,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,qCAAqC,IAAI,eAAe,MAAM,EAAE,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;YAC9H,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;QAC3D,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YAC7C,4FAA4F;YAC5F,qBAAqB;YACrB,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,sDAAsD,IAAI,eAAe,MAAM,IAAI,CAAC,CAAC,CAAC;QACvH,CAAC,CAAC,CAAA;QACF,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC7C,uFAAuF;YACvF,iFAAiF;YACjF,OAAO,CAAC,KAAK,CAAC,uDAAuD,KAAK,EAAE,CAAC,CAAA;QAC/E,CAAC,CAAC,CAAA;QAEF,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,CAAA;QAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;YAAC,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAA;QAAC,CAAC;QAE1F,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAC9D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;QAEH,IAAI,MAAM,EAAE,CAAC;YACX,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;gBAC9D,OAAO,CAAC,GAAG,CAAC,wCAAwC,IAAI,EAAE,CAAC,CAAC;YAC9D,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,OAAe;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC;QACvC,IAAI,CAAC,KAAK,EAAE,CAAC;YAAC,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAA;QAAC,CAAC;QAC5E,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YAAC,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAA;QAAC,CAAC;QAC3G,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IAC7B,CAAC;CACF"}

package/out/NonstrictRPC.d.ts

@@ -11,7 +11,16 @@ export declare class NSRPC {
     private readonly send;
     private responseHandlers;
     private closureTargets;
+    private terminationError?;
     constructor(send: (data: string) => void);
+    /**
+     * Marks the RPC connection as permanently gone, e.g. because the external process exited.
+     *
+     * All in-flight requests are rejected with the given error and any future request fails
+     * immediately with the same error, instead of waiting forever for a response that can no
+     * longer arrive.
+     */
+    terminate(error: Error): void;
     receive(data: string): void;
     private sendMessage;
     private sendResponse;

package/out/NonstrictRPC.js

@@ -5,9 +5,25 @@ export class NSRPC {
     send;
     responseHandlers = new Map();
     closureTargets = new Map();
+    terminationError;
     constructor(send) {
         this.send = send;
     }
+    /**
+     * Marks the RPC connection as permanently gone, e.g. because the external process exited.
+     *
+     * All in-flight requests are rejected with the given error and any future request fails
+     * immediately with the same error, instead of waiting forever for a response that can no
+     * longer arrive.
+     */
+    terminate(error) {
+        this.terminationError = error;
+        const pendingHandlers = [...this.responseHandlers.values()];
+        this.responseHandlers.clear();
+        for (const handler of pendingHandlers) {
+            handler.reject(error);
+        }
+    }
     receive(data) {
         // TODO: For now we just assume the message is a valid NSRPC message, but we should:
         // - Check if the nsrpc property is set to a number in the range of 1..<2
@@ -63,6 +79,9 @@ export class NSRPC {
         this.sendMessage({ ...response, nsrpc: 1, id });
     }
     async sendRequest(request) {
+        if (this.terminationError !== undefined) {
+            throw this.terminationError;
+        }
         const id = "req_" + randomUUID();
         const response = new Promise((resolve, reject) => {
             this.responseHandlers.set(id, { resolve, reject });
@@ -137,16 +156,20 @@ export class NSRPC {
     }
     /* Perform remote procedures */
     async initialize(args) {
-        const target = args.target;
-        finalizationRegistry.register(args.lifecycle, async () => {
-            await this.release(target);
-        });
         await this.sendRequest({
             target: args.target,
             type: args.type,
             params: args.params,
             procedure: "init",
         });
+        // Register the GC release only after a successful init; registering earlier would later send a
+        // release for a target the external process never knew about.
+        const target = args.target;
+        finalizationRegistry.register(args.lifecycle, () => {
+            // Swallow rejections: the external process may already be gone, in which case there is
+            // nothing left to release.
+            this.release(target).catch(() => { });
+        });
     }
     async perform(body) {
         return await this.sendRequest({

package/out/NonstrictRPC.js.map

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

package/out/RecordKit.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="node" resolution-mode="require"/>
 import { Recorder, RecorderSchemaItem } from "./Recorder.js";
-import type { SystemAudioBackend } from "./Recorder.js";
+import type { SystemAudioBackend, RecorderSettings, Size } from "./Recorder.js";
 import { EventEmitter } from "events";
 /**
  * Entry point for the RecordKit SDK, an instance is available as `recordkit` that can be imported from the module. Do not instantiate this class directly.
@@ -13,6 +13,15 @@ import { EventEmitter } from "events";
  *
  * @groupDescription Logging
  * Log what's going on to the console for easy debugging and troubleshooting. See the [Logging and Error Handling guide](https://recordkit.dev/guides/logging-and-errors) for more information.
+ *
+ * @groupDescription Preferred Devices
+ * Read and update the user's preferred devices, so you can pre-select sensible defaults in your UI.
+ *
+ * @groupDescription Window Control
+ * Move, resize, center and maximize windows of other applications (requires Accessibility Control permission).
+ *
+ * @groupDescription Device Control
+ * Configure capture devices, such as selecting a camera's active format or fetching an application's icon.
  */
 export declare class RecordKit extends EventEmitter {
     private ipcRecordKit;
@@ -101,6 +110,158 @@ export declare class RecordKit extends EventEmitter {
      * @group Discovery
      */
     getRunningApplications(): Promise<RunningApplication[]>;
+    /**
+     * The user's preferred devices for each source type, ordered most-preferred first.
+     *
+     * RecordKit remembers which devices the user last recorded with (unless disabled via the recorder's
+     * `updatesUserPreferred` setting). Use this to pre-select a sensible default device in your UI.
+     *
+     * @group Preferred Devices
+     */
+    getUserPreferred(): Promise<UserPreferred>;
+    /**
+     * Records the given microphone as the user's most-preferred microphone.
+     *
+     * Call this whenever the user manually selects a microphone, so it can be pre-selected later via
+     * {@link getUserPreferred}. The selection moves to the front of {@link UserPreferred.microphoneIDs}.
+     *
+     * @param microphone - The microphone to prefer, either a {@link Microphone} or its {@link Microphone.id}.
+     * @group Preferred Devices
+     */
+    updatePreferredMicrophone(microphone: Microphone | string): Promise<void>;
+    /**
+     * Records the given camera as the user's most-preferred camera.
+     *
+     * Call this whenever the user manually selects a camera, so it can be pre-selected later via
+     * {@link getUserPreferred}. The selection moves to the front of {@link UserPreferred.cameraIDs}.
+     *
+     * @param camera - The camera to prefer, either a {@link Camera} or its {@link Camera.id}.
+     * @group Preferred Devices
+     */
+    updatePreferredCamera(camera: Camera | string): Promise<void>;
+    /**
+     * Records the given display as the user's most-preferred display.
+     *
+     * Call this whenever the user manually selects a display, so it can be pre-selected later via
+     * {@link getUserPreferred}. The selection moves to the front of {@link UserPreferred.displayIDs}.
+     *
+     * @param display - The display to prefer, either a {@link Display} or its {@link Display.id}.
+     * @group Preferred Devices
+     */
+    updatePreferredDisplay(display: Display | number): Promise<void>;
+    /**
+     * Records the given Apple device as the user's most-preferred Apple device.
+     *
+     * Call this whenever the user manually selects an Apple device, so it can be pre-selected later via
+     * {@link getUserPreferred}. The selection moves to the front of {@link UserPreferred.appleDeviceIDs}.
+     *
+     * @param device - The Apple device to prefer, either an {@link AppleDevice} or its {@link AppleDevice.id}.
+     * @group Preferred Devices
+     */
+    updatePreferredAppleDevice(device: AppleDevice | string): Promise<void>;
+    /**
+     * Maximizes the given window, resizing it to fill the display's visible area (excluding the menu bar and Dock)
+     * and centering it on that display.
+     *
+     * Requires Accessibility Control permission (see {@link getAccessibilityControlAccess}).
+     *
+     * @remarks
+     * Rejects if the window cannot be maximized — typically because Accessibility permission is missing,
+     * the target display cannot be found, or the window is minimized or closed.
+     *
+     * @param window - The window to maximize, either a {@link Window} or its {@link Window.id}.
+     * @param options.display - The display to maximize onto, either a {@link Display} or its {@link Display.id}. Defaults to the window's current display.
+     * @group Window Control
+     */
+    maximizeWindow(window: Window | number, options?: {
+        display?: Display | number;
+    }): Promise<void>;
+    /**
+     * Resizes the given window to the given size (in points), keeping it centered on its display.
+     *
+     * Requires Accessibility Control permission (see {@link getAccessibilityControlAccess}).
+     *
+     * @remarks
+     * The requested size is clipped to the display's visible frame if it would be larger. After resizing,
+     * the window is re-centered so that a window which could not shrink/grow to the requested size still
+     * ends up centered. Rejects if Accessibility permission is missing, the target display cannot be found,
+     * or the window is minimized, closed, or does not support resizing.
+     *
+     * @param window - The window to resize, either a {@link Window} or its {@link Window.id}.
+     * @param size - The new size in points.
+     * @param options.display - The display to center on, either a {@link Display} or its {@link Display.id}. Defaults to the window's current display.
+     * @group Window Control
+     */
+    resizeWindow(window: Window | number, size: Size, options?: {
+        display?: Display | number;
+    }): Promise<void>;
+    /**
+     * Centers the given window within the visible area (excluding the menu bar and Dock) of its display,
+     * keeping its current size.
+     *
+     * Requires Accessibility Control permission (see {@link getAccessibilityControlAccess}).
+     *
+     * @remarks
+     * Rejects if Accessibility permission is missing, the target display cannot be found, or the window is
+     * minimized, closed, or does not support moving.
+     *
+     * @param window - The window to center, either a {@link Window} or its {@link Window.id}.
+     * @param options.display - The display to center on, either a {@link Display} or its {@link Display.id}. Defaults to the window's current display.
+     * @group Window Control
+     */
+    centerWindow(window: Window | number, options?: {
+        display?: Display | number;
+    }): Promise<void>;
+    /**
+     * Moves the given window so its top-left corner is at the given position (in points, top-left origin).
+     *
+     * Requires Accessibility Control permission (see {@link getAccessibilityControlAccess}).
+     *
+     * @remarks
+     * Rejects if Accessibility permission is missing, or the window is minimized, closed, or does not
+     * support moving.
+     *
+     * @param window - The window to move, either a {@link Window} or its {@link Window.id}.
+     * @param position - The new top-left origin for the window, in points (top-left coordinate space).
+     * @group Window Control
+     */
+    moveWindow(window: Window | number, position: {
+        x: number;
+        y: number;
+    }): Promise<void>;
+    /**
+     * Selects the camera's active capture format that best matches the given dimensions (in pixels).
+     *
+     * Use this when you want the camera to deliver a specific resolution — typically before recording or
+     * before showing a live preview, so the preview renders at the intended resolution. The format stays
+     * in effect until something else changes it.
+     *
+     * The chosen format is the smallest format whose dimensions are ≥ the target, preferring biplanar YUV
+     * pixel formats, and falling back to the largest available format if nothing meets the target.
+     *
+     * @remarks
+     * Rejects if the camera is unavailable, has no usable video format, or its configuration is locked by
+     * another process.
+     *
+     * @param camera - The camera to configure, either a {@link Camera} or its {@link Camera.id}.
+     * @param dimensions - Target dimensions in pixels.
+     * @group Device Control
+     */
+    setCameraActiveFormat(camera: Camera | string, dimensions: Size): Promise<void>;
+    /**
+     * Returns the camera capture format that {@link setCameraActiveFormat} would select for the given
+     * dimensions (in pixels), without applying it. Returns `undefined` if the camera has no suitable format.
+     *
+     * @group Device Control
+     */
+    getCameraBestFormat(camera: Camera | string, dimensions: Size): Promise<CameraFormat | undefined>;
+    /**
+     * Returns the icon of the given running application as a `data:image/png;base64,...` URL,
+     * usable directly as the `src` of an HTML `<img>` tag.
+     *
+     * @group Device Control
+     */
+    getApplicationIcon(application: RunningApplication | number): Promise<string>;
     /**
      * Indicates if camera can be used.
      *
@@ -131,6 +292,19 @@ export declare class RecordKit extends EventEmitter {
     getSystemAudioRecordingAccess(options?: {
         backend?: SystemAudioPermissionBackend;
     }): Promise<boolean>;
+    /**
+     * Probes whether system audio can actually be recorded with the given backend by attempting a short silent capture.
+     *
+     * Unlike {@link getSystemAudioRecordingAccess}, which reads the recorded permission state, this verifies the
+     * permission is truly usable, immediately detecting cases where the OS reports a permission as granted but
+     * capture would still fail (e.g. after the user revokes it).
+     *
+     * @remarks If the permission state is still undetermined, this may trigger the system audio permission prompt.
+     * @group Permissions
+     */
+    probeSystemAudioRecordingAccess(options?: {
+        backend?: SystemAudioPermissionBackend;
+    }): Promise<boolean>;
     /**
      * Indicates if keystroke events of other apps can be recorded via Input Monitoring.
      *
@@ -177,7 +351,9 @@ export declare class RecordKit extends EventEmitter {
      * - `screenCaptureKit`: Screen Recording permission
      * - `_beta_coreAudio`: deprecated alias for `coreAudio`
      *
-     * Afterwards, the users needs to restart this app, for the permission to become active in the app.
+     * For the `screenCaptureKit` backend the user must restart the app before the granted permission
+     * becomes active. The `default` and `coreAudio` backends return the live granted/denied result
+     * with no restart required (macOS 14.2+).
      *
      * @returns Boolean value that indicates whether the user granted or denied access to your app.
      * @group Permissions
@@ -207,14 +383,38 @@ export declare class RecordKit extends EventEmitter {
      * @group Permissions
      */
     requestAccessibilityControlAccess(): Promise<void>;
+    /**
+     * Creates a {@link Recorder} for the given schema.
+     *
+     * The schema describes what to record (its `items`, e.g. a webcam, display, microphone or system audio),
+     * where to write the resulting RecordKit bundle (`output_directory`), and optional session-wide
+     * {@link RecorderSettings}. Call {@link Recorder.prepare} then {@link Recorder.start} on the returned recorder.
+     *
+     * @remarks The given `schema` is consumed: device/window objects in its `items` are replaced by their IDs and
+     * any callbacks are registered internally. Pass a fresh schema object per call rather than reusing one.
+     *
+     * @group Recording
+     */
     createRecorder(schema: {
         output_directory?: string;
         items: RecorderSchemaItem[];
-        settings?: {
-            allowFrameReordering?: boolean;
-        };
+        settings?: RecorderSettings;
     }): Promise<Recorder>;
 }
+/**
+ * Typed event overloads for {@link RecordKit}. Declaration-merges with the class so that
+ * `recordkit.on('log', message => …)` receives a typed {@link LogMessage} instead of `any`.
+ *
+ * @group Logging
+ */
+export interface RecordKit {
+    /** Fires for every log message emitted by RecordKit. See {@link LogMessage}. */
+    on(event: 'log', listener: (message: LogMessage) => void): this;
+    /** @see {@link RecordKit.on} */
+    once(event: 'log', listener: (message: LogMessage) => void): this;
+    /** @see {@link RecordKit.on} */
+    off(event: 'log', listener: (message: LogMessage) => void): this;
+}
 /** @ignore */
 export declare let recordkit: RecordKit;
 /**
@@ -286,6 +486,8 @@ export interface RunningApplication {
 export interface Camera {
     /** An identifier that uniquely identifies the camera. */
     id: string;
+    /** Indicates whether this is a virtual camera (e.g. provided by software rather than physical hardware). */
+    isVirtual: boolean;
     /** A localized camera name for display in the user interface. */
     name: string;
     /** The model ID of this camera. */
@@ -309,6 +511,19 @@ export interface Camera {
      */
     preview_url?: string;
 }
+/**
+ * A camera capture format, as returned by {@link RecordKit.getCameraBestFormat}.
+ *
+ * @group Discovery
+ */
+export interface CameraFormat {
+    /** Width of the format, in pixels. */
+    width: number;
+    /** Height of the format, in pixels. */
+    height: number;
+    /** Highest frame rate supported by this format, in frames per second. */
+    maxFrameRate: number;
+}
 /**
  * A microphone whose audio can be recorded.
  *
@@ -317,6 +532,8 @@ export interface Camera {
 export interface Microphone {
     /** An identifier that uniquely identifies the microphone. */
     id: string;
+    /** Indicates whether this is a virtual microphone (e.g. provided by software rather than physical hardware). */
+    isVirtual: boolean;
     /** A localized microphone name for display in the user interface. */
     name: string;
     /** The model ID of this microphone. */
@@ -343,8 +560,12 @@ export interface Display {
     id: number;
     /** Name of this display. */
     localizedName?: string;
+    /** SF Symbol name representing this display (e.g. `laptopcomputer`, `display`), suitable for use in the UI. */
+    symbolName: string;
     /** Frame of the display, relative to the main display. Uses top-left coordinate space. */
     frame: Bounds;
+    /** Visible frame of the display (excluding the menu bar and Dock), relative to the main display. Top-left coordinate space. */
+    visibleFrame?: Bounds;
     /** Indicates if this is the main display. */
     isMain: boolean;
     /**
@@ -386,7 +607,48 @@ export interface Bounds {
     width: number;
     height: number;
 }
+/**
+ * The user's preferred device IDs for each source type, ordered most-preferred first.
+ *
+ * @group Preferred Devices
+ */
+export interface UserPreferred {
+    /** Preferred microphone IDs (matching {@link Microphone.id}), most-preferred first. */
+    microphoneIDs: string[];
+    /** Preferred camera IDs (matching {@link Camera.id}), most-preferred first. */
+    cameraIDs: string[];
+    /** Preferred display IDs (matching {@link Display.id}), most-preferred first. */
+    displayIDs: number[];
+    /** Preferred Apple device IDs (matching {@link AppleDevice.id}), most-preferred first. */
+    appleDeviceIDs: string[];
+}
 /**
  * @group Logging
  */
 export type LogLevel = 'trace' | 'debug' | 'info' | 'warning' | 'error' | 'critical';
+/**
+ * A structured log message emitted by RecordKit, delivered as the payload of the `'log'` event.
+ *
+ * @example
+ * ```ts
+ * recordkit.on('log', (message) => {
+ *   if (message.level === 'error') myLogger.error(message.category, message.message, message.metadata)
+ * })
+ * ```
+ *
+ * @group Logging
+ */
+export interface LogMessage {
+    /** Time the message was logged, in milliseconds since the Unix epoch. Use `new Date(timestamp)` to get a `Date`. */
+    timestamp: number;
+    /** Severity level of the message. */
+    level: LogLevel;
+    /** Category the message belongs to (e.g. the subsystem that emitted it). */
+    category: string;
+    /** The log message text. */
+    message: string;
+    /** Additional structured key/value metadata attached to the message. */
+    metadata: Record<string, string>;
+    /** Pre-formatted, human-readable representation of the message (timestamp, level, category, message and metadata). */
+    formattedMessage: string;
+}