@a4anthony/proctorkit-vue 0.1.4 → 0.2.0

package/dist/proctored-assessment/useResumeDisplayGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResumeDisplayGuard.d.ts","sourceRoot":"","sources":["../../src/proctored-assessment/useResumeDisplayGuard.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,cAAc,EACpB,MAAM,kCAAkC,CAAC;AAG1C,UAAU,OAAO;IACf,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,KAAK,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAChC,KAAK,EAAE,MAAM,OAAO,GAAG,QAAQ,CAAC;IAChC,gBAAgB,EAAE,MAAM,OAAO,CAAC;IAChC,IAAI,EAAE,MAAM,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,MAAM,EAAE,CACN,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,EAClD,KAAK,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,KACrC,IAAI,CAAC;IACV,MAAM,EAAE,yBAAyB,CAAC;IAClC,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,iFAAiF;AACjF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO;uBAW3B,cAAc,KAAoB,OAAO,CAAC,OAAO,CAAC;EA0J5E"}

package/dist/proctoring-client.d.ts

@@ -1,11 +1,15 @@
 import { type ComputedRef, type ShallowRef } from "vue";
 import type { ProctoringClient } from "@a4anthony/proctorkit-sdk";
+/** Which devices Device settings shows. Omit `kinds` to show every device the policy uses. */
+export interface OpenSettingsOptions {
+    kinds?: Array<"microphone" | "speaker" | "camera">;
+}
 export interface ProctoringVueClientControls {
-    openSettings?: () => boolean;
+    openSettings?: (options?: OpenSettingsOptions) => boolean;
 }
 /** The SDK client plus commands whose UI is owned by the Vue integration. */
 export type ProctoringVueClient = ProctoringClient & {
-    openSettings(): boolean;
+    openSettings(options?: OpenSettingsOptions): boolean;
 };
 export declare function setActiveProctoringClient(client: ProctoringClient | null, controls?: ProctoringVueClientControls): void;
 export declare function clearActiveProctoringClient(client?: ProctoringClient | null): void;

package/dist/proctoring-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proctoring-client.d.ts","sourceRoot":"","sources":["../src/proctoring-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,UAAU,EAChB,MAAM,KAAK,CAAC;AACb,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,MAAM,WAAW,2BAA2B;IAC1C,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC;CAC9B;AAED,6EAA6E;AAC7E,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,GAAG;IACnD,YAAY,IAAI,OAAO,CAAC;CACzB,CAAC;AAIF,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,gBAAgB,GAAG,IAAI,EAC/B,QAAQ,GAAE,2BAAgC,GACzC,IAAI,CAgBN;AAED,wBAAgB,2BAA2B,CACzC,MAAM,CAAC,EAAE,gBAAgB,GAAG,IAAI,GAC/B,IAAI,CAIN;AAED,wBAAgB,yBAAyB,IAAI,mBAAmB,GAAG,IAAI,CAEtE;AAED,wBAAgB,mBAAmB,IAAI;IACrC,MAAM,EAAE,UAAU,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;IAC/C,SAAS,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CACjC,CAKA"}
+{"version":3,"file":"proctoring-client.d.ts","sourceRoot":"","sources":["../src/proctoring-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,UAAU,EAChB,MAAM,KAAK,CAAC;AACb,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAMlE,8FAA8F;AAC9F,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,KAAK,CAAC,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,2BAA2B;IAC1C,YAAY,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,mBAAmB,KAAK,OAAO,CAAC;CAC3D;AAED,6EAA6E;AAC7E,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,GAAG;IACnD,YAAY,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC;CACtD,CAAC;AAsBF,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,gBAAgB,GAAG,IAAI,EAC/B,QAAQ,GAAE,2BAAgC,GACzC,IAAI,CAkBN;AAED,wBAAgB,2BAA2B,CACzC,MAAM,CAAC,EAAE,gBAAgB,GAAG,IAAI,GAC/B,IAAI,CAKN;AAED,wBAAgB,yBAAyB,IAAI,mBAAmB,GAAG,IAAI,CAEtE;AAED,wBAAgB,mBAAmB,IAAI;IACrC,MAAM,EAAE,UAAU,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;IAC/C,SAAS,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CACjC,CAKA"}

package/dist/proctoring-system-check-contract.d.ts

@@ -3,6 +3,7 @@ import type { LocaleCode } from "./i18n/index.js";
 import type { PreflightMessages } from "./messages.js";
 import type { CandidateIntakeConfig, CandidateIntakeSubmission, CandidateIntakeSubmitter } from "./candidate-intake.js";
 import type { SystemCheckMode, SystemCheckOptions } from "./usePreflightCheck.js";
+import type { PreparationFeedback } from "./proctored-assessment/preparation-feedback.js";
 /** Shared public contract implemented by both preflight renderers. */
 export interface ProctoringSystemCheckProps {
     mode?: SystemCheckMode;
@@ -14,6 +15,7 @@ export interface ProctoringSystemCheckProps {
     simulateResults?: SimulatedCheckResult[];
     autoResumeSeconds?: number;
     starting?: boolean;
+    preparationError?: PreparationFeedback;
     dark?: boolean;
     autoStart?: boolean;
     allowDevSkip?: boolean;

package/dist/proctoring-system-check-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proctoring-system-check-contract.d.ts","sourceRoot":"","sources":["../src/proctoring-system-check-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,QAAQ,EACR,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EACV,qBAAqB,EACrB,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAElF,sEAAsE;AACtE,MAAM,WAAW,0BAA0B;IACzC,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,aAAa,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACzC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE;QACV,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,uBAAuB,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IAClE,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE;QACV,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC;IACF,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,qBAAqB,CAAC,EAAE,wBAAwB,CAAC;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,EAAE,CAAC;IACT,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC7E,4BAA4B,EAAE,EAAE,CAAC;IACjC,4BAA4B,EAAE,CAAC,UAAU,EAAE,yBAAyB,CAAC,CAAC;IACtE,eAAe,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACvC"}
+{"version":3,"file":"proctoring-system-check-contract.d.ts","sourceRoot":"","sources":["../src/proctoring-system-check-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,QAAQ,EACR,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EACV,qBAAqB,EACrB,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAElF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AAE1F,sEAAsE;AACtE,MAAM,WAAW,0BAA0B;IACzC,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,aAAa,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACzC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,mBAAmB,CAAC;IACvC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE;QACV,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,uBAAuB,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IAClE,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE;QACV,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC;IACF,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,qBAAqB,CAAC,EAAE,wBAAwB,CAAC;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,EAAE,CAAC;IACT,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC7E,4BAA4B,EAAE,EAAE,CAAC;IACjC,4BAA4B,EAAE,CAAC,UAAU,EAAE,yBAAyB,CAAC,CAAC;IACtE,eAAe,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACvC"}

package/dist/runtime-devices/DevicePickerItem.vue.d.ts

@@ -0,0 +1,58 @@
+/**
+ * One device inside `<ProctoringDevicePicker>`. Internal: hosts use the
+ * parent, which decides which devices a question needs and owns the layout
+ * and the single status line. This item lists its devices, switches through
+ * the session, runs the quick test, and reports its status upward.
+ */
+import type { RuntimeDeviceSwitchResult } from "@a4anthony/proctorkit-sdk";
+import type { MediaDeviceOption } from "../wizard/media-device-list.js";
+import type { RuntimeDeviceSelectionKind } from "./runtime-device-selection.js";
+import { type RuntimeDevicePickerClient } from "./useRuntimeDevice.js";
+import { type ProctoringDevicePickerMessages } from "./device-picker-messages.js";
+export type DevicePickerItemTone = "neutral" | "success" | "warn" | "danger";
+export interface DevicePickerItemStatus {
+    text: string;
+    tone: DevicePickerItemTone;
+}
+/** What a device button needs to show without opening its panel. */
+export interface DevicePickerItemSummary {
+    /**
+     * Worth showing at all. False until the first device list is in, and for a
+     * speaker the browser can't switch (no output routing, or none listed):
+     * the picker hides it rather than offer a control that changes nothing.
+     */
+    available: boolean;
+    label: string | null;
+    locked: boolean;
+    switching: boolean;
+    attention: boolean;
+}
+type __VLS_Props = {
+    kind: RuntimeDeviceSelectionKind;
+    copy: ProctoringDevicePickerMessages;
+    /**
+     * "chip": compact, for an inline footer. "row": labelled, for the menu.
+     * "panel": a selectable list, for a device button's popover.
+     */
+    variant: "chip" | "row" | "panel";
+    client?: RuntimeDevicePickerClient | null;
+    locked: boolean;
+    disabled: boolean;
+    showTest: boolean;
+    allowVirtualDevices: boolean;
+    deviceList?: MediaDeviceOption[];
+    speakerRoutingSupported?: boolean;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    status: (kind: RuntimeDeviceSelectionKind, status: DevicePickerItemStatus | null) => any;
+    error: (error: Error) => any;
+    summary: (kind: RuntimeDeviceSelectionKind, summary: DevicePickerItemSummary) => any;
+    changed: (result: RuntimeDeviceSwitchResult) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onStatus?: ((kind: RuntimeDeviceSelectionKind, status: DevicePickerItemStatus | null) => any) | undefined;
+    onError?: ((error: Error) => any) | undefined;
+    onSummary?: ((kind: RuntimeDeviceSelectionKind, summary: DevicePickerItemSummary) => any) | undefined;
+    onChanged?: ((result: RuntimeDeviceSwitchResult) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;
+//# sourceMappingURL=DevicePickerItem.vue.d.ts.map

package/dist/runtime-devices/DevicePickerItem.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevicePickerItem.vue.d.ts","sourceRoot":"","sources":["../../src/runtime-devices/DevicePickerItem.vue"],"names":[],"mappings":"AAiiBA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAM3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAGxE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAIhF,OAAO,EAGL,KAAK,yBAAyB,EAC/B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAuB,KAAK,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAEvG,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAC7E,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,oBAAoB,CAAC;CAC5B;AACD,oEAAoE;AACpE,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,KAAK,WAAW,GAAG;IACjB,IAAI,EAAE,0BAA0B,CAAC;IACjC,IAAI,EAAE,8BAA8B,CAAC;IACrC;;;OAGG;IACH,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC;IAClC,MAAM,CAAC,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAC1C,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACjC,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC,CAAC;;;;;;;;;;;;AA4yBF,wBAOG"}

package/dist/runtime-devices/PickerMessage.vue.d.ts

@@ -0,0 +1,17 @@
+export type PickerMessageTone = "neutral" | "success" | "warn" | "danger";
+type __VLS_Props = {
+    tone: PickerMessageTone;
+    text: string;
+    /** "hint": standing guidance. "status": progress. "problem": needs action. */
+    kind?: "hint" | "status" | "problem";
+    /** Show a lock instead of the neutral icon (a recording holds the device). */
+    locked?: boolean;
+    reserve?: boolean;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    kind: "hint" | "status" | "problem";
+    locked: boolean;
+    reserve: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;
+//# sourceMappingURL=PickerMessage.vue.d.ts.map

package/dist/runtime-devices/PickerMessage.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PickerMessage.vue.d.ts","sourceRoot":"","sources":["../../src/runtime-devices/PickerMessage.vue"],"names":[],"mappings":"AAqEA,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE1E,KAAK,WAAW,GAAG;IACf,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IACrC,8EAA8E;IAC9E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;;UAJO,MAAM,GAAG,QAAQ,GAAG,SAAS;YAE3B,OAAO;aACN,OAAO;;AAyFrB,wBAOG"}

package/dist/runtime-devices/ProctoringDevicePicker.vue.d.ts

@@ -0,0 +1,89 @@
+/**
+ * In-question device picker. Place it anywhere (typically the question
+ * wrapper's footer) and pass the devices the current question uses —
+ *
+ *   <ProctoringDevicePicker :devices="['speaker']" />                 listening
+ *   <ProctoringDevicePicker :devices="['speaker', 'microphone']" />   speaking
+ *
+ * The camera is deliberately not offered. It is the proctoring camera, and a
+ * switch from here would skip the face check that pre-flight and Device
+ * settings run, letting a candidate move to a camera pointed elsewhere
+ * mid-exam. Camera changes go through Device settings, which re-verifies.
+ *
+ * It needs nothing else from the question. Devices come and go as `devices`
+ * changes between questions, and the chosen devices carry over because the
+ * selection is page-wide. Recorders and players anywhere on the page report
+ * what they are doing, so the microphone locks itself while a take is
+ * recording and the speaker test waits while question audio plays.
+ *
+ * Switching goes through the session client (the active `<ProctoredAssessment>`
+ * by default), so the SDK's rules hold: the speaker changes live without
+ * interrupting playback; the microphone is refused mid-recording.
+ */
+import type { RuntimeDeviceSwitchResult } from "@a4anthony/proctorkit-sdk";
+import type { MediaDeviceOption } from "../wizard/media-device-list.js";
+/** The devices the picker offers. The camera is excluded on purpose (see above). */
+export type ProctoringDevicePickerKind = "speaker" | "microphone";
+import type { RuntimeDevicePickerClient } from "./useRuntimeDevice.js";
+import { type ProctoringDevicePickerMessages } from "./device-picker-messages.js";
+type __VLS_Props = {
+    /** The devices the current question uses, in display order. Empty hides the picker. */
+    devices: ProctoringDevicePickerKind[];
+    /**
+     * "buttons": one round button per device, each opening its own device
+     * list (like a call's control bar). "inline": a row of compact dropdowns.
+     * "menu": one "Audio & video" button holding every device.
+     */
+    layout?: "buttons" | "inline" | "menu";
+    /** Where device lists open. "top" suits a footer; flips if it won't fit. */
+    menuPlacement?: "top" | "bottom";
+    /** Session client. Defaults to the active `<ProctoredAssessment>` client. */
+    client?: RuntimeDevicePickerClient | null;
+    /**
+     * Lock the microphone and camera yourself. Recorders on the page already
+     * lock them automatically while recording; use this for a host-owned
+     * recording the picker can't see.
+     */
+    locked?: boolean;
+    disabled?: boolean;
+    /** Offer a quick test (tone for speakers, level for microphones). */
+    showTest?: boolean;
+    /** Offer virtual devices. Pass the policy's resolved value. */
+    allowVirtualDevices?: boolean;
+    /** Fixed device lists for host tests and stories. Skips enumeration. */
+    deviceLists?: Partial<Record<ProctoringDevicePickerKind, MediaDeviceOption[]>>;
+    /** Override detection of speaker routing (tests and stories). */
+    speakerRoutingSupported?: boolean;
+    messages?: Partial<ProctoringDevicePickerMessages>;
+    /** Open a device's list (or the menu) when the picker mounts. */
+    initialOpen?: ProctoringDevicePickerKind | "menu";
+    /**
+     * When the microphone in `devices` is offered. "attention" (default) keeps
+     * it hidden until a recorder on the page reports a microphone problem, so
+     * a candidate can't switch away from a working microphone mid-exam.
+     * "always" shows it whenever `devices` lists it.
+     */
+    microphoneVisibility?: "attention" | "always";
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    error: (error: Error) => any;
+    changed: (result: RuntimeDeviceSwitchResult) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onError?: ((error: Error) => any) | undefined;
+    onChanged?: ((result: RuntimeDeviceSwitchResult) => any) | undefined;
+}>, {
+    layout: "buttons" | "inline" | "menu";
+    messages: Partial<ProctoringDevicePickerMessages>;
+    disabled: boolean;
+    allowVirtualDevices: boolean;
+    client: RuntimeDevicePickerClient | null;
+    locked: boolean;
+    showTest: boolean;
+    speakerRoutingSupported: boolean;
+    menuPlacement: "top" | "bottom";
+    deviceLists: Partial<Record<ProctoringDevicePickerKind, MediaDeviceOption[]>>;
+    initialOpen: ProctoringDevicePickerKind | "menu";
+    microphoneVisibility: "attention" | "always";
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;
+//# sourceMappingURL=ProctoringDevicePicker.vue.d.ts.map

package/dist/runtime-devices/ProctoringDevicePicker.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProctoringDevicePicker.vue.d.ts","sourceRoot":"","sources":["../../src/runtime-devices/ProctoringDevicePicker.vue"],"names":[],"mappings":"AA+dA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAW3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AASxE,oFAAoF;AACpF,MAAM,MAAM,0BAA0B,GAAG,SAAS,GAAG,YAAY,CAAC;AAGlE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,6BAA6B,CAAC;AAErC,KAAK,WAAW,GAAG;IACf,uFAAuF;IACvF,OAAO,EAAE,0BAA0B,EAAE,CAAC;IACtC;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;IACvC,4EAA4E;IAC5E,aAAa,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;IACjC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAC1C;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+DAA+D;IAC/D,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,wEAAwE;IACxE,WAAW,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,0BAA0B,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC;IAC/E,iEAAiE;IACjE,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC,8BAA8B,CAAC,CAAC;IACnD,iEAAiE;IACjE,WAAW,CAAC,EAAE,0BAA0B,GAAG,MAAM,CAAC;IAClD;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC;CAC/C,CAAC;;;;;;;;YA9BS,SAAS,GAAG,QAAQ,GAAG,MAAM;cAoB3B,OAAO,CAAC,8BAA8B,CAAC;cATvC,OAAO;yBAII,OAAO;YAXpB,yBAAyB,GAAG,IAAI;YAMhC,OAAO;cAGL,OAAO;6BAMQ,OAAO;mBAjBjB,KAAK,GAAG,QAAQ;iBAelB,OAAO,CAAC,MAAM,CAAC,0BAA0B,EAAE,iBAAiB,EAAE,CAAC,CAAC;iBAKhE,0BAA0B,GAAG,MAAM;0BAO1B,WAAW,GAAG,QAAQ;;AAqwBjD,wBAQG"}

package/dist/runtime-devices/device-picker-messages.d.ts

@@ -0,0 +1,42 @@
+import type { RuntimeDeviceSelectionKind } from "./runtime-device-selection.js";
+import type { RuntimeDeviceSwitchFailure } from "./useRuntimeDevice.js";
+/**
+ * Copy for `<ProctoringDevicePicker>`. `{device}` is the lower-case device
+ * noun ("microphone"), `{label}` the device's name.
+ */
+export interface ProctoringDevicePickerMessages {
+    /** The menu layout's button. */
+    menuLabel: string;
+    /** Appended to a device button's spoken name. */
+    lockedShort: string;
+    attentionShort: string;
+    kindLabel: Record<RuntimeDeviceSelectionKind, string>;
+    deviceNoun: Record<RuntimeDeviceSelectionKind, string>;
+    selectLabel: string;
+    noDevices: string;
+    locked: string;
+    /** The microphone is held because a finished take's upload is waiting for a retry. */
+    lockedUpload: string;
+    disconnected: string;
+    failed: Record<RuntimeDeviceSwitchFailure, string>;
+    /** Visible label of the compact test buttons; the full label is announced. */
+    testShort: string;
+    speakerTest: string;
+    /** Standing hint at the foot of each device's panel. */
+    hint: Record<RuntimeDeviceSelectionKind, string>;
+    speakerTestFailed: string;
+    microphoneTest: string;
+    microphoneTestStop: string;
+    microphoneListening: string;
+    microphoneHeard: string;
+    microphoneLow: string;
+    microphoneSilent: string;
+    microphoneUnavailable: string;
+    /** Opens Device settings with only the microphone (inside `<ProctoredAssessment>`). */
+    microphoneCheck: string;
+    /** A recorder on the page reported a microphone problem. */
+    microphoneAttention: string;
+}
+export declare const DEFAULT_DEVICE_PICKER_MESSAGES: ProctoringDevicePickerMessages;
+export declare function formatPickerMessage(template: string, values: Partial<Record<"device" | "label", string>>): string;
+//# sourceMappingURL=device-picker-messages.d.ts.map

package/dist/runtime-devices/device-picker-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-picker-messages.d.ts","sourceRoot":"","sources":["../../src/runtime-devices/device-picker-messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAExE;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC,0BAA0B,EAAE,MAAM,CAAC,CAAC;IACtD,UAAU,EAAE,MAAM,CAAC,0BAA0B,EAAE,MAAM,CAAC,CAAC;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,0BAA0B,EAAE,MAAM,CAAC,CAAC;IACnD,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC,0BAA0B,EAAE,MAAM,CAAC,CAAC;IACjD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uFAAuF;IACvF,eAAe,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,8BAA8B,EAAE,8BAuC5C,CAAC;AAEF,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,GAAG,OAAO,EAAE,MAAM,CAAC,CAAC,GAClD,MAAM,CAER"}

package/dist/runtime-devices/microphone-attention.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Page-wide "the microphone needs attention" flag, shared by recorders, the
+ * in-question picker, and the Device settings dialog.
+ *
+ * A recorder raises it when it has evidence the microphone is not working:
+ * it would not open, it disconnected mid-take, a finished take was silent, or
+ * (with the live check turned on) the input stayed digitally silent. The
+ * picker reads it to reveal its microphone control; Device settings clears it
+ * once a microphone passes its speech check. Choosing another microphone
+ * anywhere on the page clears it too, through the shared device selection.
+ *
+ * Only certain failures ever block: a microphone that will not open. Every
+ * other reason is a hint the candidate can dismiss, because silence alone is
+ * not proof a microphone is broken (noise-gated microphones, a suspended
+ * audio engine, and Bluetooth profile switches all read as true silence).
+ */
+import { type ComputedRef } from "vue";
+export type MicrophoneAttentionReason = 
+/** The microphone would not open when recording started. */
+"unavailable"
+/** The microphone disconnected during a take. */
+ | "device-lost"
+/** A finished take's volume analysis was `silent`. */
+ | "silent-take"
+/** The live check found no input for several seconds during a take. */
+ | "no-input";
+export interface MicrophoneAttention {
+    reason: MicrophoneAttentionReason;
+    /** The take it was raised for, when there is one. */
+    clipId: string | null;
+    /**
+     * The microphone the recorder recorded from (or, for `unavailable`, tried
+     * to open), so a check can start on that exact device. `null` when the
+     * browser didn't report one.
+     */
+    deviceId: string | null;
+}
+declare const state: import("vue").ShallowRef<MicrophoneAttention | null, MicrophoneAttention | null>;
+export declare function raiseMicrophoneAttention(attention: MicrophoneAttention): void;
+export declare function clearMicrophoneAttention(): void;
+export declare function useMicrophoneAttention(): {
+    attention: Readonly<typeof state>;
+    needsAttention: ComputedRef<boolean>;
+};
+/** For tests, stories, and a new session on the same page. */
+export declare function resetMicrophoneAttention(): void;
+export {};
+//# sourceMappingURL=microphone-attention.d.ts.map

package/dist/runtime-devices/microphone-attention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"microphone-attention.d.ts","sourceRoot":"","sources":["../../src/runtime-devices/microphone-attention.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAyC,KAAK,WAAW,EAAE,MAAM,KAAK,CAAC;AAG9E,MAAM,MAAM,yBAAyB;AACnC,4DAA4D;AAC1D,aAAa;AACf,iDAAiD;GAC/C,aAAa;AACf,sDAAsD;GACpD,aAAa;AACf,uEAAuE;GACrE,UAAU,CAAC;AAEf,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,yBAAyB,CAAC;IAClC,qDAAqD;IACrD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,QAAA,MAAM,KAAK,kFAA+C,CAAC;AAe3D,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,mBAAmB,GAAG,IAAI,CAG7E;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED,wBAAgB,sBAAsB,IAAI;IACxC,SAAS,EAAE,QAAQ,CAAC,OAAO,KAAK,CAAC,CAAC;IAClC,cAAc,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CACtC,CAMA;AAED,8DAA8D;AAC9D,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}

package/dist/runtime-devices/microphone-check-messages.d.ts

@@ -0,0 +1,13 @@
+import type { MicrophoneAttentionReason } from "./microphone-attention.js";
+/**
+ * Copy for the alert at the top of Device settings when it is opened to check
+ * only the microphone (a recorder's or the picker's **Check microphone**).
+ * The title says what went wrong; `instruction` says what to do. `{test}` is
+ * replaced with the microphone step's test button label.
+ */
+export interface MicrophoneCheckMessages {
+    title: Record<MicrophoneAttentionReason, string>;
+    instruction: string;
+}
+export declare const DEFAULT_MICROPHONE_CHECK_MESSAGES: MicrophoneCheckMessages;
+//# sourceMappingURL=microphone-check-messages.d.ts.map

package/dist/runtime-devices/microphone-check-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"microphone-check-messages.d.ts","sourceRoot":"","sources":["../../src/runtime-devices/microphone-check-messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAE3E;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC;IACjD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,iCAAiC,EAAE,uBAS/C,CAAC"}

package/dist/runtime-devices/runtime-device-activity.d.ts

@@ -0,0 +1,16 @@
+import type { RuntimeDeviceSelectionKind } from "./runtime-device-selection.js";
+export type DeviceActivityReason = "recording" | "upload";
+/** Mark devices as in use. Call the returned function exactly once to release. */
+export declare function beginDeviceActivity(kinds: RuntimeDeviceSelectionKind[], reason?: DeviceActivityReason): () => void;
+/** Reactive: whether any component is using this device right now. */
+export declare function isDeviceActive(kind: RuntimeDeviceSelectionKind): boolean;
+/** Reactive: why the device is held, preferring a live recording. */
+export declare function deviceActivityReason(kind: RuntimeDeviceSelectionKind): DeviceActivityReason | null;
+/** Clear all activity. For tests. */
+export declare function resetDeviceActivity(): void;
+/**
+ * Hold `kinds` as active whenever `isActive()` is true, for a component's
+ * lifetime. Released when it turns false, the kinds change, or on unmount.
+ */
+export declare function useDeviceActivity(kinds: () => RuntimeDeviceSelectionKind[], isActive: () => boolean, reason?: DeviceActivityReason): void;
+//# sourceMappingURL=runtime-device-activity.d.ts.map

package/dist/runtime-devices/runtime-device-activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-device-activity.d.ts","sourceRoot":"","sources":["../../src/runtime-devices/runtime-device-activity.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAEhF,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,QAAQ,CAAC;AAQ1D,kFAAkF;AAClF,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,0BAA0B,EAAE,EACnC,MAAM,GAAE,oBAAkC,GACzC,MAAM,IAAI,CAQZ;AAED,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAExE;AAED,qEAAqE;AACrE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,0BAA0B,GAAG,oBAAoB,GAAG,IAAI,CAIlG;AAED,qCAAqC;AACrC,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,0BAA0B,EAAE,EACzC,QAAQ,EAAE,MAAM,OAAO,EACvB,MAAM,GAAE,oBAAkC,GACzC,IAAI,CAcN"}

package/dist/runtime-devices/runtime-device-selection.d.ts

@@ -0,0 +1,11 @@
+export type RuntimeDeviceSelectionKind = "microphone" | "speaker" | "camera";
+/** Record a live choice and keep the wizard's saved selection in step. */
+export declare function setRuntimeDeviceSelection(kind: RuntimeDeviceSelectionKind, deviceId: string | null | undefined): void;
+/**
+ * The device a component should use. Reactive on the live choice, so a
+ * `computed` around it follows switches made anywhere on the page.
+ */
+export declare function resolveRuntimeDeviceId(kind: RuntimeDeviceSelectionKind, propValue?: string | null): string | undefined;
+/** Clear live choices. For tests, stories, and a new session on the same page. */
+export declare function resetRuntimeDeviceSelection(): void;
+//# sourceMappingURL=runtime-device-selection.d.ts.map

package/dist/runtime-devices/runtime-device-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-device-selection.d.ts","sourceRoot":"","sources":["../../src/runtime-devices/runtime-device-selection.ts"],"names":[],"mappings":"AAkBA,MAAM,MAAM,0BAA0B,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;AAgB7E,0EAA0E;AAC1E,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,0BAA0B,EAChC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAClC,IAAI,CAMN;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,0BAA0B,EAChC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GACxB,MAAM,GAAG,SAAS,CAKpB;AAED,kFAAkF;AAClF,wBAAgB,2BAA2B,IAAI,IAAI,CAIlD"}

package/dist/runtime-devices/useRuntimeDevice.d.ts

@@ -0,0 +1,72 @@
+import { type RuntimeDeviceSwitchErrorCode, type RuntimeDeviceSwitchResult } from "@a4anthony/proctorkit-sdk";
+import { type MaybeRefOrGetter } from "vue";
+import { type MediaDeviceOption } from "../wizard/media-device-list.js";
+import { type RuntimeDeviceSelectionKind } from "./runtime-device-selection.js";
+/**
+ * Whether question audio and video (HTML media elements) can be sent to a
+ * chosen speaker. This, not Web Audio support, decides if a speaker list is
+ * worth showing: it is what actually plays the question.
+ */
+export declare function supportsMediaOutputRouting(): boolean;
+/** Real outputs, without the browser's "default"/"communications" aliases. */
+export declare function distinctOutputs(devices: ReadonlyArray<MediaDeviceOption>): MediaDeviceOption[];
+/**
+ * The real device a browser alias entry ("Default - Built-in Speakers")
+ * stands for, when that device is also listed. Such an alias is shown once,
+ * as the real device, instead of twice.
+ */
+export declare function aliasTarget(device: MediaDeviceOption, list: ReadonlyArray<MediaDeviceOption>): MediaDeviceOption | undefined;
+/** The session methods an in-question picker needs. */
+export interface RuntimeDevicePickerClient {
+    switchMicrophone(deviceId?: string | null): Promise<RuntimeDeviceSwitchResult>;
+    switchSpeaker(deviceId?: string | null): Promise<RuntimeDeviceSwitchResult>;
+    switchCamera(deviceId?: string | null): Promise<RuntimeDeviceSwitchResult>;
+}
+/** Why a switch did not happen. `switch-failed` covers anything untyped. */
+export type RuntimeDeviceSwitchFailure = RuntimeDeviceSwitchErrorCode | "switch-failed";
+export interface UseRuntimeDeviceOptions {
+    /** Session client. Defaults to the active `<ProctoredAssessment>` client. */
+    client?: MaybeRefOrGetter<RuntimeDevicePickerClient | null | undefined>;
+    /** Fixed device list for host tests and stories. Skips enumeration. */
+    devices?: MaybeRefOrGetter<MediaDeviceOption[] | undefined>;
+    /** Offer virtual devices. Pass the policy's resolved value. */
+    allowVirtualDevices?: MaybeRefOrGetter<boolean | undefined>;
+    /** Override detection of media-element speaker routing (tests and stories). */
+    speakerRoutingSupported?: MaybeRefOrGetter<boolean | undefined>;
+}
+/**
+ * One device kind's live state for an in-question picker: the selectable
+ * devices (same virtual-device rule as preflight), the device in use, and a
+ * `switchTo` that goes through the session when there is one so the SDK's
+ * recording lock, rollback, and checkpoint rebase all apply. Without a session
+ * (standalone media components) the choice is stored for this page only.
+ */
+export declare function useRuntimeDevice(kind: MaybeRefOrGetter<RuntimeDeviceSelectionKind>, options?: UseRuntimeDeviceOptions): {
+    devices: import("vue").ComputedRef<MediaDeviceOption[]>;
+    currentId: import("vue").ComputedRef<string>;
+    currentDevice: import("vue").ComputedRef<MediaDeviceOption | null>;
+    currentMissing: import("vue").ComputedRef<boolean>;
+    routingSupported: import("vue").ComputedRef<boolean>;
+    toneRoutingSupported: import("vue").ComputedRef<boolean>;
+    loading: import("vue").Ref<boolean, boolean>;
+    loaded: import("vue").ComputedRef<boolean>;
+    switching: import("vue").Ref<boolean, boolean>;
+    failure: import("vue").Ref<RuntimeDeviceSwitchFailure | null, RuntimeDeviceSwitchFailure | null>;
+    lastSwitched: import("vue").Ref<{
+        deviceId: string | null;
+        label: string;
+        at: number;
+    } | null, {
+        deviceId: string | null;
+        label: string;
+        at: number;
+    } | {
+        deviceId: string | null;
+        label: string;
+        at: number;
+    } | null>;
+    refresh: () => Promise<void>;
+    switchTo: (deviceId: string) => Promise<RuntimeDeviceSwitchResult | null>;
+    clearFailure: () => void;
+};
+//# sourceMappingURL=useRuntimeDevice.d.ts.map

package/dist/runtime-devices/useRuntimeDevice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRuntimeDevice.d.ts","sourceRoot":"","sources":["../../src/runtime-devices/useRuntimeDevice.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,EAC/B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAsD,KAAK,gBAAgB,EAAE,MAAM,KAAK,CAAC;AAEhG,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAG1F,OAAO,EAGL,KAAK,0BAA0B,EAChC,MAAM,+BAA+B,CAAC;AAEvC;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,OAAO,CAMpD;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,CAAC,iBAAiB,CAAC,GAAG,iBAAiB,EAAE,CAE9F;AAID;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE,aAAa,CAAC,iBAAiB,CAAC,GACrC,iBAAiB,GAAG,SAAS,CAI/B;AAED,uDAAuD;AACvD,MAAM,WAAW,yBAAyB;IACxC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC/E,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC5E,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;CAC5E;AAED,4EAA4E;AAC5E,MAAM,MAAM,0BAA0B,GAAG,4BAA4B,GAAG,eAAe,CAAC;AAExF,MAAM,WAAW,uBAAuB;IACtC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,gBAAgB,CAAC,yBAAyB,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACxE,uEAAuE;IACvE,OAAO,CAAC,EAAE,gBAAgB,CAAC,iBAAiB,EAAE,GAAG,SAAS,CAAC,CAAC;IAC5D,+DAA+D;IAC/D,mBAAmB,CAAC,EAAE,gBAAgB,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IAC5D,+EAA+E;IAC/E,uBAAuB,CAAC,EAAE,gBAAgB,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;CACjE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,gBAAgB,CAAC,0BAA0B,CAAC,EAClD,OAAO,GAAE,uBAA4B;;;;;;;;;;;;kBAYA,MAAM,GAAG,IAAI;eAAS,MAAM;YAAM,MAAM;;kBAAxC,MAAM,GAAG,IAAI;eAAS,MAAM;YAAM,MAAM;;kBAAxC,MAAM,GAAG,IAAI;eAAS,MAAM;YAAM,MAAM;;mBA2CnD,OAAO,CAAC,IAAI,CAAC;yBAkBL,MAAM,KAAG,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC;;EAmErF"}

package/dist/runtime-devices/useTrackLoss.d.ts

@@ -0,0 +1,15 @@
+import { type Ref } from "vue";
+export type LostTrackKind = "microphone" | "camera";
+/**
+ * Calls `onLost` once when an audio or video track of `stream` ends while
+ * `active` is true (a device unplugged, or the OS revoked it mid-take).
+ * Recorders use it to stop the take cleanly instead of hot-swapping the
+ * device inside a running recording.
+ */
+export declare function useTrackLoss(options: {
+    stream: Ref<MediaStream | undefined>;
+    active: Ref<boolean>;
+    kinds: () => LostTrackKind[];
+    onLost: (kind: LostTrackKind) => void;
+}): void;
+//# sourceMappingURL=useTrackLoss.d.ts.map

package/dist/runtime-devices/useTrackLoss.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTrackLoss.d.ts","sourceRoot":"","sources":["../../src/runtime-devices/useTrackLoss.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAEvD,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,QAAQ,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE;IACpC,MAAM,EAAE,GAAG,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IACrC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACrB,KAAK,EAAE,MAAM,aAAa,EAAE,CAAC;IAC7B,MAAM,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;CACvC,GAAG,IAAI,CAmCP"}