ablok-components 0.3.128 → 0.3.131

package/dist/index.js

@@ -24,37 +24,37 @@ import S from "./components/molecules/input-color/input-color.js";
 import C from "./components/molecules/color-palette/color-palette.js";
 import w from "./components/molecules/input-dropdown/input-dropdown.js";
 import T from "./components/molecules/auto-suggest/auto-suggest.js";
-import { useCameraFilter as E } from "./composables/useCameraFilter.js";
-import D from "./components/molecules/base-camera/base-camera.js";
-import O from "./components/molecules/base-map/base-map.js";
-import k from "./components/molecules/location-list/location-list.js";
-import A from "./components/molecules/file-upload/file-upload.js";
-import j from "./components/molecules/bulk-upload/bulk-upload.js";
-import M from "./components/templates/sortable-list/sortable-list.js";
-import N from "./components/molecules/image-resize/image-resize.js";
-import P from "./components/molecules/image-crop/image-crop.js";
-import F from "./components/molecules/image-crop-resize/image-crop-resize.js";
-import I from "./components/templates/modal-dialog/modal-dialog.js";
-import L from "./components/molecules/image-upload/image-upload.js";
-import R from "./components/molecules/upload-group/upload-group.js";
-import z from "./components/organisms/asset-uploader/asset-uploader.js";
-import B from "./components/templates/popover-dialog/popover-dialog.js";
-import V from "./components/organisms/preset-uploader/preset-uploader.js";
-import { useDirections as H } from "./composables/useDirections.js";
-import { useGeocoding as U } from "./composables/useGeocoding.js";
-import { useGeolocation as W } from "./composables/useGeolocation.js";
-import G from "./components/organisms/location-finder/location-finder.js";
-import K from "./components/templates/base-carousel/base-carousel.js";
-import q from "./components/molecules/media-thumbnails/media-thumbnails.js";
-import J from "./components/molecules/progress-steps/progress-steps.js";
-import Y from "./components/molecules/hint-system/hint-system.js";
-import X from "./components/molecules/popover-tooltip/popover-tooltip.js";
-import Z from "./components/molecules/popover-notifications/popover-notifications.js";
-import Q from "./components/molecules/dom-renderer/dom-renderer.js";
-import $ from "./components/molecules/qr-code/qr-code.js";
-import ee from "./components/molecules/link-sharing/link-sharing.js";
-import te from "./components/templates/base-form/base-form.js";
-import ne from "./components/templates/touch-wrapper/touch-wrapper.js";
-import re from "./components/atoms/canvas-confetti/canvas-confetti.js";
-import ie from "./components/molecules/image-zoom/image-zoom.js";
-export { o as Accordion, a as AccordionItem, z as AssetUploader, T as AutoSuggest, s as BaseButton, D as BaseCamera, K as BaseCarousel, te as BaseForm, r as BaseHeadline, n as BaseImage, c as BaseInput, O as BaseMap, i as BaseParagraph, j as BulkUpload, re as CanvasConfetti, h as CheckGroup, C as ColorPalette, y as CustomHtml, Q as DomRenderer, A as FileUpload, Y as HintSystem, P as ImageCrop, F as ImageCropResize, N as ImageResize, L as ImageUpload, ie as ImageZoom, u as InputCheckbox, S as InputColor, f as InputDatepicker, d as InputDatetime, w as InputDropdown, v as InputFile, m as InputPasscode, p as InputPassword, l as InputTextarea, ee as LinkSharing, t as LoadingSpinner, G as LocationFinder, k as LocationList, q as MediaThumbnails, I as ModalDialog, B as PopoverDialog, Z as PopoverNotifications, X as PopoverTooltip, V as PresetUploader, J as ProgressSteps, $ as QrCode, _ as RadioButtons, g as RadioGroup, x as RteEditor, b as SelectMedia, M as SortableList, e as SvgIcon, ne as TouchWrapper, R as UploadGroup, E as useCameraFilter, H as useDirections, U as useGeocoding, W as useGeolocation };
+import E from "./components/molecules/base-camera/base-camera.js";
+import D from "./components/molecules/base-map/base-map.js";
+import O from "./components/molecules/location-list/location-list.js";
+import k from "./components/molecules/file-upload/file-upload.js";
+import A from "./components/molecules/bulk-upload/bulk-upload.js";
+import j from "./components/templates/sortable-list/sortable-list.js";
+import M from "./components/molecules/image-resize/image-resize.js";
+import N from "./components/molecules/image-crop/image-crop.js";
+import P from "./components/molecules/image-crop-resize/image-crop-resize.js";
+import F from "./components/templates/modal-dialog/modal-dialog.js";
+import I from "./components/molecules/image-upload/image-upload.js";
+import L from "./components/molecules/upload-group/upload-group.js";
+import R from "./components/organisms/asset-uploader/asset-uploader.js";
+import z from "./components/templates/popover-dialog/popover-dialog.js";
+import B from "./components/organisms/preset-uploader/preset-uploader.js";
+import { useDirections as V } from "./composables/useDirections.js";
+import { useGeocoding as H } from "./composables/useGeocoding.js";
+import { useGeolocation as U } from "./composables/useGeolocation.js";
+import W from "./components/organisms/location-finder/location-finder.js";
+import G from "./components/templates/base-carousel/base-carousel.js";
+import K from "./components/molecules/media-thumbnails/media-thumbnails.js";
+import q from "./components/molecules/progress-steps/progress-steps.js";
+import J from "./components/molecules/hint-system/hint-system.js";
+import Y from "./components/molecules/popover-tooltip/popover-tooltip.js";
+import X from "./components/molecules/popover-notifications/popover-notifications.js";
+import Z from "./components/molecules/dom-renderer/dom-renderer.js";
+import Q from "./components/molecules/qr-code/qr-code.js";
+import $ from "./components/molecules/link-sharing/link-sharing.js";
+import ee from "./components/templates/base-form/base-form.js";
+import te from "./components/templates/touch-wrapper/touch-wrapper.js";
+import ne from "./components/atoms/canvas-confetti/canvas-confetti.js";
+import re from "./components/molecules/image-zoom/image-zoom.js";
+import { useCameraFilter as ie } from "./composables/useCameraFilter.js";
+export { o as Accordion, a as AccordionItem, R as AssetUploader, T as AutoSuggest, s as BaseButton, E as BaseCamera, G as BaseCarousel, ee as BaseForm, r as BaseHeadline, n as BaseImage, c as BaseInput, D as BaseMap, i as BaseParagraph, A as BulkUpload, ne as CanvasConfetti, h as CheckGroup, C as ColorPalette, y as CustomHtml, Z as DomRenderer, k as FileUpload, J as HintSystem, N as ImageCrop, P as ImageCropResize, M as ImageResize, I as ImageUpload, re as ImageZoom, u as InputCheckbox, S as InputColor, f as InputDatepicker, d as InputDatetime, w as InputDropdown, v as InputFile, m as InputPasscode, p as InputPassword, l as InputTextarea, $ as LinkSharing, t as LoadingSpinner, W as LocationFinder, O as LocationList, K as MediaThumbnails, F as ModalDialog, z as PopoverDialog, X as PopoverNotifications, Y as PopoverTooltip, B as PresetUploader, q as ProgressSteps, Q as QrCode, _ as RadioButtons, g as RadioGroup, x as RteEditor, b as SelectMedia, j as SortableList, e as SvgIcon, te as TouchWrapper, L as UploadGroup, ie as useCameraFilter, V as useDirections, H as useGeocoding, U as useGeolocation };

package/dist/symbol-defs.svg

@@ -885,5 +885,11 @@
 <symbol id="icon-crop" viewBox="0 0 32 32">
 <path d="M7.593 1.409c-0.305 0.096-0.585 0.323-0.756 0.612l-0.144 0.245-0.016 2.2-0.015 2.2h-2.069c-2.249 0-2.383 0.015-2.751 0.295-0.107 0.081-0.26 0.259-0.339 0.393-0.121 0.208-0.144 0.307-0.144 0.645 0 0.341 0.021 0.437 0.148 0.652 0.081 0.137 0.231 0.315 0.333 0.392 0.364 0.277 0.425 0.284 2.704 0.287l2.119 0.003 0.029 12.773 0.125 0.373c0.439 1.307 1.395 2.263 2.701 2.701l0.373 0.125 12.769 0.029 0.015 2.203 0.016 2.203 0.161 0.263c0.091 0.147 0.273 0.337 0.415 0.433 0.628 0.421 1.469 0.228 1.876-0.433l0.161-0.263 0.016-2.204 0.015-2.204 2.119-0.003c2.277-0.003 2.339-0.009 2.703-0.287 0.103-0.077 0.252-0.255 0.333-0.392 0.127-0.215 0.148-0.311 0.148-0.652 0-0.339-0.023-0.437-0.144-0.645-0.079-0.135-0.232-0.312-0.339-0.393-0.368-0.28-0.501-0.295-2.751-0.295h-2.071l-0.029-12.773-0.125-0.373c-0.44-1.309-1.42-2.287-2.7-2.692l-0.428-0.135-12.716-0.029-0.015-2.199-0.016-2.199-0.144-0.245c-0.325-0.553-0.963-0.801-1.569-0.612zM21.747 9.415c0.372 0.111 0.728 0.467 0.839 0.839 0.071 0.237 0.081 1.064 0.081 6.344v6.071l-12.4-0.028-0.245-0.144c-0.135-0.079-0.309-0.229-0.388-0.332-0.315-0.412-0.3-0.088-0.3-6.731v-6.1h6.071c5.279 0 6.105 0.011 6.343 0.081z"></path>
 </symbol>
+<symbol id="icon-zap-off" viewBox="0 0 32 32">
+<path d="M2.227 1.415c-0.296 0.108-0.56 0.331-0.723 0.607-0.123 0.208-0.144 0.305-0.143 0.645 0 0.283 0.029 0.455 0.099 0.587 0.053 0.103 1.643 1.735 3.531 3.627l3.435 3.44-2.565 2.64c-1.409 1.452-2.647 2.763-2.747 2.912-0.265 0.391-0.396 0.779-0.431 1.276-0.091 1.284 0.747 2.436 2.017 2.775 0.239 0.063 1.103 0.076 5.132 0.077 3.975 0 4.841 0.012 4.819 0.069-0.015 0.039-0.611 1.893-1.324 4.12-1.273 3.976-1.297 4.059-1.297 4.504-0.001 0.396 0.020 0.497 0.165 0.805 0.552 1.173 2.092 1.539 3.043 0.723 0.141-0.121 1.503-1.505 3.024-3.075s2.92-3.009 3.105-3.2l0.34-0.345 3.427 3.42c1.884 1.881 3.511 3.465 3.613 3.519 0.132 0.069 0.304 0.099 0.587 0.099 0.344 0.001 0.436-0.020 0.656-0.149 0.635-0.373 0.863-1.2 0.497-1.812-0.073-0.123-6.2-6.287-13.616-13.697-12.471-12.461-13.504-13.48-13.747-13.56-0.315-0.104-0.625-0.105-0.897-0.005zM17.533 1.388c-0.473 0.119-0.707 0.301-1.807 1.421-2.268 2.309-2.807 2.876-2.896 3.051-0.128 0.247-0.167 0.7-0.084 0.992 0.084 0.301 0.431 0.704 0.717 0.835 0.247 0.112 0.685 0.129 1.009 0.039 0.181-0.049 0.38-0.223 1.121-0.973 0.495-0.501 0.885-0.864 0.867-0.805s-0.252 0.791-0.519 1.627c-0.424 1.327-0.483 1.555-0.459 1.793 0.077 0.783 0.829 1.36 1.56 1.197 0.339-0.076 0.728-0.324 0.869-0.555 0.057-0.093 0.544-1.537 1.081-3.209 0.951-2.96 0.976-3.052 0.976-3.493 0.001-0.396-0.020-0.497-0.165-0.805-0.316-0.671-0.972-1.117-1.687-1.147-0.212-0.009-0.476 0.005-0.585 0.033zM20.533 12.049c-0.405 0.124-0.789 0.476-0.909 0.837-0.096 0.288-0.088 0.653 0.021 0.941 0.099 0.256 0.459 0.632 0.715 0.747 0.108 0.048 0.963 0.072 3.213 0.092l3.067 0.027-1.168 1.2c-1.272 1.307-1.376 1.456-1.376 1.967 0 0.412 0.133 0.711 0.44 0.987 0.412 0.369 0.965 0.453 1.453 0.221 0.232-0.109 2.663-2.577 2.919-2.961 0.357-0.536 0.515-1.371 0.373-1.979-0.241-1.040-1.103-1.888-2.104-2.071-0.365-0.067-6.428-0.073-6.644-0.008zM15.552 17.479c-0.009 0.009-0.087-0.013-0.171-0.051-0.12-0.053-1.247-0.073-5.088-0.095l-4.933-0.027 4.953-5.099 2.628 2.627c1.445 1.445 2.62 2.635 2.611 2.644zM19.787 21.716c0 0.039-4.232 4.415-4.252 4.396-0.007-0.007 0.387-1.257 0.875-2.781 0.979-3.060 1.025-3.28 0.852-3.941l-0.084-0.317 1.305 1.304c0.717 0.716 1.304 1.32 1.304 1.34z"></path>
+</symbol>
+<symbol id="icon-zap" viewBox="0 0 32 32">
+<path d="M17.533 1.388c-0.467 0.117-0.712 0.307-1.707 1.316-3.275 3.323-12.561 12.94-12.715 13.168-0.1 0.149-0.231 0.399-0.291 0.555-0.14 0.371-0.189 1.068-0.103 1.445 0.24 1.029 1.071 1.86 2.071 2.069 0.195 0.040 1.785 0.059 5.085 0.059 3.939 0 4.799 0.012 4.776 0.069-0.015 0.039-0.611 1.893-1.324 4.12-1.273 3.976-1.297 4.059-1.297 4.504-0.001 0.396 0.020 0.497 0.165 0.805 0.552 1.173 2.089 1.537 3.044 0.723 0.472-0.404 13.463-13.816 13.649-14.093 0.1-0.149 0.231-0.399 0.291-0.555 0.14-0.371 0.189-1.068 0.103-1.445-0.241-1.040-1.103-1.888-2.104-2.071-0.212-0.039-1.901-0.057-5.087-0.057-3.856 0-4.764-0.013-4.743-0.068 0.015-0.037 0.611-1.892 1.324-4.12 1.275-3.977 1.299-4.060 1.299-4.505 0-0.397-0.020-0.497-0.165-0.805-0.316-0.671-0.972-1.117-1.687-1.147-0.212-0.009-0.476 0.005-0.585 0.033zM15.591 8.669c-0.955 2.988-1.008 3.228-0.873 3.877 0.181 0.872 0.861 1.641 1.744 1.976 0.312 0.117 0.317 0.117 5.245 0.144l4.933 0.027-5.547 5.715c-3.051 3.143-5.552 5.709-5.559 5.704-0.007-0.007 0.387-1.257 0.873-2.781 0.737-2.304 0.891-2.84 0.912-3.18 0.076-1.175-0.629-2.233-1.777-2.671l-0.316-0.12-9.867-0.053 5.547-5.715c3.051-3.143 5.552-5.709 5.559-5.704 0.005 0.005-0.388 1.257-0.875 2.781z"></path>
+</symbol>
 </defs>
 </svg>

package/dist/utilities/camera/CameraManager.d.ts

@@ -0,0 +1,91 @@
+import { CameraError, CameraDevice, CameraIntent, CameraPermission, CameraState, Facing, Resolution, StartOptions, ZoomCapability } from './types';
+export interface CameraSnapshot {
+    state: CameraState;
+    intent: CameraIntent;
+    stream: MediaStream | null;
+    devices: CameraDevice[];
+    activeDeviceId: string | null;
+    activeFacing: Facing | null;
+    error: CameraError | null;
+    permission: CameraPermission;
+    zoom: number;
+    zoomCapability: ZoomCapability | null;
+}
+export interface CameraManagerOptions {
+    preferredFacing?: Facing;
+    resolution?: Resolution;
+    /** Non-fatal problems (e.g. first frame never painted) are reported here without changing state. */
+    onWarning?: (err: CameraError) => void;
+}
+export declare class CameraManager {
+    private readonly listeners;
+    private readonly opts;
+    private state;
+    private intent;
+    private stream;
+    private devices;
+    private activeDeviceId;
+    private activeFacing;
+    private error;
+    private permission;
+    private zoom;
+    private zoomCapability;
+    private desiredZoom;
+    private video;
+    private seq;
+    private tearingDown;
+    private lastGood;
+    private autoCorrected;
+    private disposed;
+    /** facing confirmed by a real getUserMedia on that id (Android probe or the active stream). */
+    private readonly probeCache;
+    private refreshing;
+    private recoveryAttempts;
+    private recoveryTimer;
+    private stableTimer;
+    private healthTimer;
+    private deviceChangeTimer;
+    private watchdogCleanup;
+    private permissionStatus;
+    constructor(opts?: CameraManagerOptions);
+    subscribe(listener: (s: CameraSnapshot) => void): () => void;
+    snapshot(): CameraSnapshot;
+    static isSupported(): boolean;
+    attachVideo(el: HTMLVideoElement | null): void;
+    /** Resolves true when a stream is live; errors are surfaced through the snapshot. */
+    start(options?: StartOptions & {
+        strictDevice?: boolean;
+    }): Promise<boolean>;
+    stop(): void;
+    /** Freeze-frame: keep the camera open, stop rendering. */
+    pause(): void;
+    resume(): Promise<boolean>;
+    toggle(): Promise<boolean>;
+    switchCamera(): Promise<boolean>;
+    selectDevice(deviceId: string): Promise<boolean>;
+    /** Restart at a new resolution, keeping the active device. */
+    setResolution(resolution: Resolution): Promise<boolean>;
+    setZoom(value: number): Promise<boolean>;
+    refreshDevices(): Promise<void>;
+    dispose(): void;
+    private teardown;
+    private fail;
+    private setState;
+    private emit;
+    private bindStream;
+    private clearWatchdog;
+    private readonly onTrackEnded;
+    private readonly onVisibilityChange;
+    private readonly onPageShow;
+    private scheduleHealthCheck;
+    private healthCheck;
+    private scheduleRecovery;
+    private cancelRecovery;
+    /** Only a stream that survived a while proves the recovery loop has converged. */
+    private armStableTimer;
+    private readonly onDeviceChange;
+    private doRefreshDevices;
+    private probeDevice;
+    private initPermission;
+    private readZoomCapability;
+}

package/dist/utilities/camera/CameraManager.js

@@ -0,0 +1,345 @@
+import { isAndroid as e, isIOS as t, supportsRVFC as n } from "./platform.js";
+import { buildFallbackChain as r, classifyFacingFromLabel as i, dedupeByFacing as a, isFatalGumError as o, isTransientGumError as s, normalizeFacing as c, pickSwitchTarget as l, toErrorCode as u } from "./constraints.js";
+import { CameraError as d } from "./types.js";
+//#region src/utilities/camera/CameraManager.ts
+var f = 1500, p = 2, m = 300, h = [
+	300,
+	1e3,
+	3e3
+], g = 5e3, _ = 800, v = 500, y = {
+	width: { ideal: 160 },
+	height: { ideal: 120 }
+}, b = () => void 0, x = (e) => new Promise((t) => setTimeout(t, e)), S = class S {
+	listeners = /* @__PURE__ */ new Set();
+	opts;
+	state = "idle";
+	intent = "stopped";
+	stream = null;
+	devices = [];
+	activeDeviceId = null;
+	activeFacing = null;
+	error = null;
+	permission = "unknown";
+	zoom = 1;
+	zoomCapability = null;
+	desiredZoom = null;
+	video = null;
+	seq = 0;
+	tearingDown = !1;
+	lastGood = null;
+	autoCorrected = !1;
+	disposed = !1;
+	probeCache = /* @__PURE__ */ new Map();
+	refreshing = null;
+	recoveryAttempts = 0;
+	recoveryTimer = null;
+	stableTimer = null;
+	healthTimer = null;
+	deviceChangeTimer = null;
+	watchdogCleanup = null;
+	permissionStatus = null;
+	constructor(e = {}) {
+		this.opts = e, typeof document < "u" && (document.addEventListener("visibilitychange", this.onVisibilityChange), window.addEventListener("pageshow", this.onPageShow)), typeof navigator < "u" && navigator.mediaDevices && (navigator.mediaDevices.addEventListener?.("devicechange", this.onDeviceChange), this.initPermission());
+	}
+	subscribe(e) {
+		return this.listeners.add(e), e(this.snapshot()), () => this.listeners.delete(e);
+	}
+	snapshot() {
+		return {
+			state: this.state,
+			intent: this.intent,
+			stream: this.stream,
+			devices: this.devices,
+			activeDeviceId: this.activeDeviceId,
+			activeFacing: this.activeFacing,
+			error: this.error,
+			permission: this.permission,
+			zoom: this.zoom,
+			zoomCapability: this.zoomCapability
+		};
+	}
+	static isSupported() {
+		return typeof navigator < "u" && !!navigator.mediaDevices?.getUserMedia;
+	}
+	attachVideo(e) {
+		this.video !== e && (this.clearWatchdog(), this.video && (this.video.srcObject = null), this.video = e, e && this.stream && this.state !== "paused" && this.bindStream());
+	}
+	async start(e = {}) {
+		if (this.disposed) return !1;
+		if (!S.isSupported()) return this.fail(new d("unsupported", "getUserMedia is not available in this browser")), !1;
+		let t = ++this.seq;
+		this.cancelRecovery(), this.intent = "live", this.teardown(), this.error = null, this.setState("starting");
+		let n = e.resolution ?? this.lastGood?.resolution ?? this.opts.resolution, a = !!(e.strictDevice && e.deviceId), l = a ? void 0 : e.facing ?? (e.deviceId ? void 0 : this.opts.preferredFacing), f = r({
+			deviceId: e.deviceId,
+			facing: l,
+			resolution: n,
+			strictDevice: a
+		}), p = null, h = null;
+		for (let e of f) {
+			if (t !== this.seq) return !1;
+			try {
+				p = await navigator.mediaDevices.getUserMedia(e.constraints);
+				break;
+			} catch (n) {
+				if (h = n, o(n)) break;
+				if (s(n)) {
+					if (await x(m), t !== this.seq) return !1;
+					try {
+						p = await navigator.mediaDevices.getUserMedia(e.constraints);
+						break;
+					} catch (e) {
+						if (h = e, o(e)) break;
+					}
+				}
+			}
+		}
+		if (t !== this.seq) return p?.getTracks().forEach((e) => e.stop()), !1;
+		if (!p) {
+			let e = u(h);
+			return e === "not-allowed" && (this.permission = "denied"), this.fail(new d(e, C(h), h)), !1;
+		}
+		let g = p.getVideoTracks()[0];
+		if (!g) return p.getTracks().forEach((e) => e.stop()), this.fail(new d("not-found", "Stream has no video track")), !1;
+		let _ = g.getSettings(), v = _.deviceId ?? e.deviceId ?? null, y = v ? this.probeCache.get(v) : void 0, b = c(_.facingMode) ?? y ?? i(g.label);
+		if (v && this.probeCache.set(v, b), this.stream = p, this.activeDeviceId = v, this.activeFacing = b, this.lastGood = {
+			deviceId: v,
+			resolution: n
+		}, this.permission !== "granted" && (this.permission = "granted"), g.onended = this.onTrackEnded, this.readZoomCapability(g), this.setState("live"), this.armStableTimer(), this.bindStream(), this.desiredZoom !== null && this.setZoom(this.desiredZoom), await this.refreshDevices(), t !== this.seq) return !1;
+		if (!e.deviceId && !this.autoCorrected && this.opts.preferredFacing && b && (this.autoCorrected = !0, b !== this.opts.preferredFacing)) {
+			let e = this.devices.find((e) => e.facing === this.opts.preferredFacing && e.deviceId !== v);
+			if (e) return this.start({
+				deviceId: e.deviceId,
+				resolution: n,
+				strictDevice: !0
+			});
+		}
+		return !0;
+	}
+	stop() {
+		this.seq++, this.intent = "stopped", this.cancelRecovery(), this.teardown(), this.error = null, this.setState("idle");
+	}
+	pause() {
+		if (!(this.state !== "live" || !this.stream)) {
+			this.intent = "paused", this.clearWatchdog(), this.video?.pause();
+			for (let e of this.stream.getVideoTracks()) e.enabled = !1;
+			this.setState("paused");
+		}
+	}
+	async resume() {
+		if (this.state !== "paused") return this.state === "live";
+		this.intent = "live";
+		let e = this.stream?.getVideoTracks()[0];
+		return !e || e.readyState === "ended" ? this.start({ deviceId: this.lastGood?.deviceId ?? void 0 }) : (e.enabled = !0, this.setState("live"), this.bindStream(), !0);
+	}
+	async toggle() {
+		return this.state === "live" ? (this.pause(), !0) : this.state === "paused" ? this.resume() : this.start();
+	}
+	async switchCamera() {
+		if (this.state === "starting") return !1;
+		this.devices.length === 0 && await this.refreshDevices();
+		let e = l(this.devices, this.activeDeviceId, this.activeFacing);
+		return e ? this.selectDevice(e.deviceId) : !1;
+	}
+	async selectDevice(e) {
+		if (e === this.activeDeviceId && this.state === "live") return !0;
+		let t = this.lastGood, n = await this.start({
+			deviceId: e,
+			strictDevice: !0
+		});
+		if (n || !t?.deviceId || this.error?.code === "not-allowed") return n;
+		let r = this.error;
+		return await this.start({
+			deviceId: t.deviceId,
+			resolution: t.resolution,
+			strictDevice: !0
+		}) && r && this.opts.onWarning?.(r), !1;
+	}
+	async setResolution(e) {
+		let t = this.lastGood?.resolution?.width === e.width && this.lastGood?.resolution?.height === e.height;
+		return this.lastGood && (this.lastGood.resolution = e), t || this.state !== "live" && this.state !== "paused" ? this.state === "live" : this.start({
+			deviceId: this.activeDeviceId ?? void 0,
+			resolution: e
+		});
+	}
+	async setZoom(e) {
+		this.desiredZoom = e;
+		let t = this.stream?.getVideoTracks()[0], n = this.zoomCapability;
+		if (!t || !n) return !1;
+		let r = Math.min(n.max, Math.max(n.min, e));
+		try {
+			await t.applyConstraints({ advanced: [{ zoom: r }] });
+		} catch {
+			try {
+				await t.applyConstraints({ zoom: r });
+			} catch {
+				return !1;
+			}
+		}
+		return this.zoom = t.getSettings().zoom ?? r, this.emit(), !0;
+	}
+	async refreshDevices() {
+		return this.refreshing ||= this.doRefreshDevices().finally(() => {
+			this.refreshing = null;
+		}), this.refreshing;
+	}
+	dispose() {
+		this.disposed || (this.disposed = !0, this.stop(), this.listeners.clear(), typeof document < "u" && (document.removeEventListener("visibilitychange", this.onVisibilityChange), window.removeEventListener("pageshow", this.onPageShow)), navigator.mediaDevices?.removeEventListener?.("devicechange", this.onDeviceChange), this.permissionStatus && (this.permissionStatus.onchange = null), this.deviceChangeTimer && clearTimeout(this.deviceChangeTimer), this.healthTimer && clearTimeout(this.healthTimer), this.video = null);
+	}
+	teardown() {
+		this.tearingDown = !0, this.clearWatchdog(), this.stableTimer && clearTimeout(this.stableTimer), this.stableTimer = null;
+		let e = this.stream;
+		if (this.stream = null, e) for (let t of e.getTracks()) t.onended = null, t.onmute = null, t.onunmute = null, t.stop();
+		this.video && (this.video.pause(), this.video.srcObject = null), this.zoomCapability = null, this.tearingDown = !1;
+	}
+	fail(e) {
+		this.teardown(), this.error = e, this.setState("error");
+	}
+	setState(e) {
+		this.state = e, this.emit();
+	}
+	emit() {
+		let e = this.snapshot();
+		for (let t of this.listeners) t(e);
+	}
+	bindStream(e = 0) {
+		let t = this.video, r = this.stream;
+		if (!t || !r) return;
+		this.clearWatchdog(), t.muted = !0, t.playsInline = !0, t.setAttribute("playsinline", ""), t.autoplay = !0, t.srcObject = r, t.load(), t.play().catch(b);
+		let i = !1, a = setTimeout(() => {
+			if (!i && (s(), this.stream === r && this.state === "live")) {
+				if (e < p) {
+					t.srcObject = null, t.offsetHeight, this.bindStream(e + 1);
+					return;
+				}
+				t.readyState >= 2 && t.videoWidth > 0 || this.opts.onWarning?.(new d("first-frame", "Video did not render its first frame"));
+			}
+		}, f), o = () => {
+			i || (i = !0, s());
+		}, s = () => {
+			clearTimeout(a), t.removeEventListener("loadeddata", o), t.removeEventListener("playing", o), this.watchdogCleanup = null;
+		};
+		this.watchdogCleanup = s, n(t) ? t.requestVideoFrameCallback(() => o()) : (t.addEventListener("loadeddata", o), t.addEventListener("playing", o));
+	}
+	clearWatchdog() {
+		this.watchdogCleanup?.(), this.watchdogCleanup = null;
+	}
+	onTrackEnded = () => {
+		this.tearingDown || this.intent !== "live" || this.scheduleRecovery();
+	};
+	onVisibilityChange = () => {
+		document.visibilityState === "visible" && this.scheduleHealthCheck(_);
+	};
+	onPageShow = (e) => {
+		e.persisted && this.scheduleHealthCheck(0);
+	};
+	scheduleHealthCheck(e) {
+		this.healthTimer && clearTimeout(this.healthTimer), this.healthTimer = setTimeout(() => {
+			this.healthTimer = null, this.healthCheck();
+		}, e);
+	}
+	healthCheck() {
+		if (this.disposed || this.intent !== "live" || this.state === "starting") return;
+		let e = this.stream?.getVideoTracks()[0];
+		if (!e || e.readyState === "ended" || e.muted) {
+			this.scheduleRecovery();
+			return;
+		}
+		this.video && this.video.paused && this.video.play().catch(b);
+	}
+	scheduleRecovery() {
+		if (this.disposed || this.intent !== "live" || this.recoveryTimer) return;
+		if (this.recoveryAttempts >= h.length) {
+			this.fail(new d("not-readable", "Camera stopped and could not be re-acquired"));
+			return;
+		}
+		let e = h[this.recoveryAttempts] ?? 3e3;
+		this.recoveryAttempts++, this.recoveryTimer = setTimeout(() => {
+			this.recoveryTimer = null, this.intent === "live" && this.start({
+				deviceId: this.lastGood?.deviceId ?? void 0,
+				facing: this.activeFacing ?? this.opts.preferredFacing,
+				resolution: this.lastGood?.resolution
+			});
+		}, e);
+	}
+	cancelRecovery() {
+		this.recoveryTimer && clearTimeout(this.recoveryTimer), this.recoveryTimer = null;
+	}
+	armStableTimer() {
+		this.stableTimer && clearTimeout(this.stableTimer), this.stableTimer = setTimeout(() => {
+			this.stableTimer = null, this.recoveryAttempts = 0;
+		}, g);
+	}
+	onDeviceChange = () => {
+		this.deviceChangeTimer && clearTimeout(this.deviceChangeTimer), this.deviceChangeTimer = setTimeout(() => {
+			this.deviceChangeTimer = null, this.refreshDevices();
+		}, v);
+	};
+	async doRefreshDevices() {
+		if (this.disposed || !navigator.mediaDevices?.enumerateDevices || this.state === "starting") return;
+		let n;
+		try {
+			n = await navigator.mediaDevices.enumerateDevices();
+		} catch {
+			return;
+		}
+		let r = n.filter((e) => e.kind === "videoinput" && e.deviceId), o = new Set(r.map((e) => e.deviceId));
+		for (let e of [...this.probeCache.keys()]) o.has(e) || this.probeCache.delete(e);
+		let s = e() && !t() && this.permission !== "denied", c = [];
+		for (let e of r) {
+			if (this.disposed) return;
+			let t = this.probeCache.get(e.deviceId), n = t !== void 0;
+			if (!n && s) {
+				let r = await this.probeDevice(e.deviceId);
+				if (r === void 0) continue;
+				t = r, n = !0, this.probeCache.set(e.deviceId, r);
+			}
+			c.push({
+				deviceId: e.deviceId,
+				label: e.label,
+				facing: t ?? i(e.label),
+				probed: n
+			});
+		}
+		let l = s ? a(c, this.activeDeviceId) : c;
+		this.devices = l, this.emit();
+	}
+	async probeDevice(e) {
+		if (e === this.activeDeviceId && this.stream) return this.probeCache.get(e) ?? this.activeFacing;
+		let t = null;
+		try {
+			t = await navigator.mediaDevices.getUserMedia({ video: {
+				deviceId: { exact: e },
+				...y
+			} });
+			let n = t.getVideoTracks()[0];
+			return c(n?.getSettings().facingMode) ?? null;
+		} catch {
+			return;
+		} finally {
+			if (t) for (let e of t.getTracks()) e.onended = null, e.stop();
+		}
+	}
+	async initPermission() {
+		try {
+			let e = await navigator.permissions.query({ name: "camera" });
+			this.permissionStatus = e, this.permission = e.state, e.onchange = () => {
+				this.permission = e.state, e.state === "denied" ? this.fail(new d("not-allowed", "Camera permission was revoked")) : (this.emit(), e.state === "granted" && this.refreshDevices());
+			}, this.emit();
+		} catch {
+			this.permission = "unknown";
+		}
+	}
+	readZoomCapability(e) {
+		let t = e.getCapabilities?.()?.zoom;
+		t && typeof t.min == "number" && typeof t.max == "number" && t.max > t.min ? (this.zoomCapability = {
+			min: t.min,
+			max: t.max,
+			step: t.step && t.step > 0 ? t.step : .1
+		}, this.zoom = e.getSettings().zoom ?? t.min) : (this.zoomCapability = null, this.zoom = 1);
+	}
+};
+function C(e) {
+	return e instanceof Error ? e.message || e.name : "Camera could not be started";
+}
+//#endregion
+export { S as CameraManager };

package/dist/utilities/camera/capture.d.ts

@@ -0,0 +1,35 @@
+import { Filter } from './types';
+export interface CropRect {
+    sx: number;
+    sy: number;
+    sw: number;
+    sh: number;
+}
+/** Source rect that fills dst (object-fit: cover), centered. */
+export declare function coverCrop(srcW: number, srcH: number, dstW: number, dstH: number): CropRect;
+export interface CaptureOptions {
+    width: number;
+    height: number;
+    mirror?: boolean;
+    filter?: Filter;
+    tintColor?: string;
+    tintIntensity?: number;
+}
+export interface TintPaint {
+    color: string;
+    opacity: number;
+}
+export declare function resolveTintPaint(color: string, intensity: number): TintPaint;
+/** Rotation the frame needs so that "up" in the image matches "up" on screen. */
+export declare function orientationAngle(): number;
+export declare function captureFrame(video: HTMLVideoElement, opts: CaptureOptions): HTMLCanvasElement;
+export declare function cssFilter(filter: Filter): string;
+/** Fallback for engines without ctx.filter (older Safari); matches CSS filter matrices. */
+export declare function applyPixelFilter(ctx: CanvasRenderingContext2D, filter: Filter): void;
+export declare function filterPixels(data: Uint8ClampedArray, filter: Filter): void;
+export interface ExportOptions {
+    asBlob?: boolean;
+    type?: string;
+    quality?: number;
+}
+export declare function exportCanvas(canvas: HTMLCanvasElement, opts?: ExportOptions): Promise<Blob | string>;

package/dist/utilities/camera/capture.js

@@ -0,0 +1,82 @@
+import { isIOS as e } from "./platform.js";
+//#region src/utilities/camera/capture.ts
+function t(e, t, n, r) {
+	let i = Math.max(n / e, r / t), a = n / i, o = r / i;
+	return {
+		sx: (e - a) / 2,
+		sy: (t - o) / 2,
+		sw: a,
+		sh: o
+	};
+}
+function n(e, t) {
+	let n = Math.min(1, Math.max(0, t)), r = e.match(/^#([\da-f]{3,4}|[\da-f]{6}|[\da-f]{8})$/i)?.[1];
+	if (!r) return {
+		color: e,
+		opacity: n
+	};
+	let i = r.length <= 4 ? [...r].map((e) => e + e).join("") : r;
+	return {
+		color: `rgba(${Number.parseInt(i.slice(0, 2), 16)}, ${Number.parseInt(i.slice(2, 4), 16)}, ${Number.parseInt(i.slice(4, 6), 16)}, ${(i.length === 8 ? Number.parseInt(i.slice(6, 8), 16) / 255 : 1) * n})`,
+		opacity: 1
+	};
+}
+function r() {
+	if (typeof window > "u") return 0;
+	let e = window.screen?.orientation?.angle;
+	if (typeof e == "number") return i(e);
+	let t = window.orientation;
+	return typeof t == "number" ? i(t) : 0;
+}
+function i(e) {
+	return (Math.round(e / 90) * 90 % 360 + 360) % 360;
+}
+function a(i, a) {
+	let c = i.videoWidth, l = i.videoHeight;
+	if (!c || !l) throw Error("Video has no frame to capture yet");
+	let u = document.createElement("canvas");
+	u.width = a.width, u.height = a.height;
+	let d = u.getContext("2d");
+	if (!d) throw Error("2D canvas context unavailable");
+	let f = e() ? r() : 0, p = f === 90 || f === 270, m = "filter" in d;
+	if (d.save(), a.mirror && (d.translate(a.width, 0), d.scale(-1, 1)), m && a.filter && a.filter !== "none" && (d.filter = o(a.filter)), p) {
+		d.translate(a.width / 2, a.height / 2), d.rotate(-f * Math.PI / 180);
+		let e = a.height, n = a.width, r = t(c, l, e, n);
+		d.drawImage(i, r.sx, r.sy, r.sw, r.sh, -e / 2, -n / 2, e, n);
+	} else {
+		let e = t(c, l, a.width, a.height);
+		d.drawImage(i, e.sx, e.sy, e.sw, e.sh, 0, 0, a.width, a.height);
+	}
+	d.restore(), !m && a.filter && a.filter !== "none" && s(d, a.filter);
+	let h = a.tintColor ? n(a.tintColor, a.tintIntensity ?? 0) : null;
+	return h && h.opacity > 0 && (d.save(), d.globalAlpha = h.opacity, d.fillStyle = h.color, d.fillRect(0, 0, a.width, a.height), d.restore()), u;
+}
+function o(e) {
+	switch (e) {
+		case "grayscale": return "grayscale(1)";
+		case "sepia": return "sepia(1)";
+		default: return "none";
+	}
+}
+function s(e, t) {
+	if (t === "none") return;
+	let { width: n, height: r } = e.canvas, i = e.getImageData(0, 0, n, r);
+	c(i.data, t), e.putImageData(i, 0, 0);
+}
+function c(e, t) {
+	for (let n = 0; n < e.length; n += 4) {
+		let r = e[n] ?? 0, i = e[n + 1] ?? 0, a = e[n + 2] ?? 0;
+		if (t === "grayscale") {
+			let t = .2126 * r + .7152 * i + .0722 * a;
+			e[n] = e[n + 1] = e[n + 2] = t;
+		} else t === "sepia" && (e[n] = Math.min(255, .393 * r + .769 * i + .189 * a), e[n + 1] = Math.min(255, .349 * r + .686 * i + .168 * a), e[n + 2] = Math.min(255, .272 * r + .534 * i + .131 * a));
+	}
+}
+function l(e, t = {}) {
+	let n = t.type ?? "image/jpeg", r = t.quality ?? .92;
+	return t.asBlob ? new Promise((t, i) => {
+		e.toBlob((e) => e ? t(e) : i(/* @__PURE__ */ Error("canvas.toBlob returned null")), n, r);
+	}) : Promise.resolve(e.toDataURL(n, r));
+}
+//#endregion
+export { s as applyPixelFilter, a as captureFrame, t as coverCrop, o as cssFilter, l as exportCanvas, c as filterPixels, r as orientationAngle, n as resolveTintPaint };