@angular-helpers/browser-web-apis 21.11.0 → 21.12.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular-helpers/browser-web-apis",
-  "version": "21.11.0",
+  "version": "21.12.1",
   "description": "Sistema de servicios Angular para acceso formalizado a Browser Web APIs (cámara, permisos, geolocalización, etc.)",
   "homepage": "https://gaspar1992.github.io/angular-helpers/docs/browser-web-apis",
   "repository": {
@@ -49,7 +49,8 @@
       "default": "./fesm2022/angular-helpers-browser-web-apis-experimental.mjs"
     }
   },
+  "type": "module",
   "dependencies": {
     "tslib": "^2.3.0"
   }
-}
+}

package/types/angular-helpers-browser-web-apis.d.ts

@@ -890,6 +890,7 @@ interface WakeLockStatus {
 }
 declare class ScreenWakeLockService extends BrowserApiBaseService {
     private sentinel;
+    private releaseRegistered;
     protected getApiName(): string;
     protected getCapabilityId(): BrowserCapabilityId;
     get isActive(): boolean;
@@ -1118,6 +1119,7 @@ interface AudioAnalyserData {
 declare class WebAudioService extends BrowserApiBaseService {
     protected getApiName(): string;
     private context;
+    private destroyRegistered;
     protected getCapabilityId(): BrowserCapabilityId;
     getContext(): AudioContext;
     resume(): Promise<void>;
@@ -1159,6 +1161,59 @@ declare class GamepadService extends BrowserApiBaseService {
     static ɵprov: i0.ɵɵInjectableDeclaration<GamepadService>;
 }
 
+interface EyeDropperResult {
+    sRGBHex: string;
+}
+declare class EyeDropperService extends BrowserApiBaseService {
+    protected getApiName(): string;
+    protected getCapabilityId(): BrowserCapabilityId;
+    /** Override to also assert secure context (required by the spec). */
+    isSupported(): boolean;
+    protected ensureSupported(): void;
+    /**
+     * Opens the system eye dropper tool and returns the selected color.
+     *
+     * @param options Optional configuration including an AbortSignal to cancel the dropper.
+     * @returns A promise that resolves with the selected color in sRGB Hex format (e.g., "#000000").
+     * @throws DOMException if the user cancels the selection (AbortError).
+     */
+    open(options?: {
+        signal?: AbortSignal;
+    }): Promise<EyeDropperResult>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EyeDropperService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<EyeDropperService>;
+}
+
+type UserIdleState = 'active' | 'idle';
+type ScreenIdleState = 'locked' | 'unlocked';
+interface IdleState {
+    userState: UserIdleState | null;
+    screenState: ScreenIdleState | null;
+}
+interface IdleDetectorOptions {
+    /** The minimum number of milliseconds of inactivity before the user is considered idle. Must be at least 60000. */
+    threshold: number;
+    /** An AbortSignal to abort the idle detection. */
+    signal?: AbortSignal;
+}
+declare class IdleDetectorService extends BrowserApiBaseService {
+    protected getApiName(): string;
+    protected getCapabilityId(): BrowserCapabilityId;
+    isSupported(): boolean;
+    protected ensureSupported(): void;
+    requestPermission(): Promise<PermissionState>;
+    /**
+     * Starts tracking idle state. Emits the current state and subsequent changes.
+     * Note: You must call requestPermission() and be granted access before starting.
+     *
+     * @param options Configuration for the idle detector, including the threshold (minimum 60000ms).
+     * @returns An Observable of the IdleState.
+     */
+    watch(options: IdleDetectorOptions): Observable<IdleState>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<IdleDetectorService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<IdleDetectorService>;
+}
+
 interface LockOptionsLike {
     mode?: 'exclusive' | 'shared';
     ifAvailable?: boolean;
@@ -1486,6 +1541,29 @@ interface WakeLockRef {
 }
 declare function injectWakeLock(): WakeLockRef;
 
+interface EyeDropperRef {
+    readonly isSupported: Signal<boolean>;
+    readonly color: Signal<string | null>;
+    readonly error: Signal<Error | null>;
+    readonly isOpening: Signal<boolean>;
+    open(options?: {
+        signal?: AbortSignal;
+    }): Promise<EyeDropperResult | null>;
+}
+declare function injectEyeDropper(): EyeDropperRef;
+
+interface IdleDetectorRef {
+    readonly isSupported: Signal<boolean>;
+    readonly state: Signal<IdleState | null>;
+    readonly error: Signal<Error | null>;
+    readonly isTracking: Signal<boolean>;
+    readonly isIdle: Signal<boolean>;
+    start(options: IdleDetectorOptions): Promise<void>;
+    stop(): void;
+    requestPermission(): Promise<PermissionState>;
+}
+declare function injectIdleDetector(): IdleDetectorRef;
+
 declare class BrowserSupportUtil {
     static isSupported(feature: string): boolean;
     static getUnsupportedFeatures(): string[];
@@ -1573,6 +1651,10 @@ declare function provideStorageManager(): EnvironmentProviders;
 
 declare function provideCompression(): EnvironmentProviders;
 
+declare function provideEyeDropper(): EnvironmentProviders;
+
+declare function provideIdleDetector(): EnvironmentProviders;
+
 declare function provideMediaApis(): EnvironmentProviders;
 declare function provideLocationApis(): EnvironmentProviders;
 declare function provideStorageApis(): EnvironmentProviders;
@@ -1619,11 +1701,13 @@ interface BrowserWebApisConfig extends BrowserWebApisCompositionConfig {
     enablePerformanceObserver?: boolean;
     enableWebAudio?: boolean;
     enableGamepad?: boolean;
+    enableEyeDropper?: boolean;
+    enableIdleDetector?: boolean;
 }
 declare const defaultBrowserWebApisConfig: BrowserWebApisConfig;
 declare function provideBrowserWebApis(config?: BrowserWebApisConfig): EnvironmentProviders;
 
 declare const version = "0.1.0";
 
-export { BROWSER_API_EXPERIMENTAL_SILENT, BROWSER_API_LOGGER, BROWSER_API_LOG_LEVEL, BatteryService, BroadcastChannelService, BrowserApiBaseService, BrowserCapabilityService, BrowserSupportUtil, CameraService, ClipboardService, CompressionService, ConnectionRegistryBaseService, FileSystemAccessService, FullscreenService, GamepadService, GeolocationService, IntersectionObserverService, MediaDevicesService, MediaRecorderService, MutationObserverService, NetworkInformationService, NotificationService, PageVisibilityService, PerformanceObserverService, PermissionsService, ResizeObserverService, ScreenOrientationService, ScreenWakeLockService, ServerSentEventsService, SpeechSynthesisService, StorageManagerService, VibrationService, WebAudioService, WebLocksService, WebShareService, WebSocketClient, WebSocketService, WebStorageService, WebWorkerService, permissionGuard as createPermissionGuard, defaultBrowserWebApisConfig, injectBattery, injectClipboard, injectGamepad, injectGeolocation, injectIntersectionObserver, injectMutationObserver, injectNetworkInformation, injectPageVisibility, injectPerformanceObserver, injectResizeObserver, injectScreenOrientation, injectWakeLock, permissionGuard, provideBattery, provideBroadcastChannel, provideBrowserApiLogLevel, provideBrowserWebApis, provideCamera, provideClipboard, provideCommunicationApis, provideCompression, provideFileSystemAccess, provideFullscreen, provideGamepad, provideGeolocation, provideIntersectionObserver, provideLocationApis, provideMediaApis, provideMediaDevices, provideMediaRecorder, provideMutationObserver, provideNetworkInformation, provideNotifications, providePageVisibility, providePerformanceObserver, providePermissions, provideResizeObserver, provideScreenOrientation, provideScreenWakeLock, provideServerSentEvents, provideSpeechSynthesis, provideStorageApis, provideStorageManager, provideVibration, provideWebAudio, provideWebLocks, provideWebShare, provideWebSocket, provideWebStorage, provideWebWorker, version, warnExperimental };
-export type { AudioAnalyserData, AudioContextState, BatteryInfo, BatteryManager, BatteryRef, BrowserApiLogLevel, BrowserApiLogger, BrowserCapabilityId, BrowserError, BrowserPermissions, BrowserWebApisCompositionConfig, BrowserWebApisConfig, CameraCapabilities, CameraInfo, ClipboardRef, CompressionFormat, ConnectionType, EffectiveConnectionType, ElementInput, ElementSize, ErrorCallback, EventHandler, ExperimentalWarnContext, FileOpenOptions, FileSaveOptions, GamepadRef, GamepadState, GeolocationCoordinates, GeolocationError, GeolocationOptions, GeolocationPosition$1 as GeolocationPosition, GeolocationRef, GeolocationWatchOptions, IntersectionObserverOptions, IntersectionRef, MediaDevice, MediaDeviceKind, MediaDevicesInfo, MediaStreamConstraints$1 as MediaStreamConstraints, MediaTrackConstraints$1 as MediaTrackConstraints, MutationObserverOptions, MutationRef, NetworkInformation, NetworkInformationRef, OrientationInfo, OrientationLockType, OrientationType, PageVisibilityRef, PerformanceEntryType, PerformanceObserverConfig, PerformanceObserverRef, PermissionNameExt, PermissionRequest, RecordingOptions, RecordingResult, RecordingState, ResizeObserverOptions, ResizeRef, SSEConfig, SSEConnectionState, SSEMessage, ScreenOrientationRef, SpeechOptions, SpeechState, StorageEvent, StorageNamespace, StorageOptions, StorageQuotaEstimate, StorageValue, VibrationPattern, VibrationPreset, VisibilityState, WakeLockRef, WakeLockStatus, WakeLockType, WebSocketClientConfig, WebSocketConfig, WebSocketMessage, WebSocketRequestOptions, WebSocketState, WebSocketStatus, WebSocketStatusV2, WorkerMessage, WorkerRequestOptions, WorkerStatus, WorkerTask };
+export { BROWSER_API_EXPERIMENTAL_SILENT, BROWSER_API_LOGGER, BROWSER_API_LOG_LEVEL, BatteryService, BroadcastChannelService, BrowserApiBaseService, BrowserCapabilityService, BrowserSupportUtil, CameraService, ClipboardService, CompressionService, ConnectionRegistryBaseService, EyeDropperService, FileSystemAccessService, FullscreenService, GamepadService, GeolocationService, IdleDetectorService, IntersectionObserverService, MediaDevicesService, MediaRecorderService, MutationObserverService, NetworkInformationService, NotificationService, PageVisibilityService, PerformanceObserverService, PermissionsService, ResizeObserverService, ScreenOrientationService, ScreenWakeLockService, ServerSentEventsService, SpeechSynthesisService, StorageManagerService, VibrationService, WebAudioService, WebLocksService, WebShareService, WebSocketClient, WebSocketService, WebStorageService, WebWorkerService, permissionGuard as createPermissionGuard, defaultBrowserWebApisConfig, injectBattery, injectClipboard, injectEyeDropper, injectGamepad, injectGeolocation, injectIdleDetector, injectIntersectionObserver, injectMutationObserver, injectNetworkInformation, injectPageVisibility, injectPerformanceObserver, injectResizeObserver, injectScreenOrientation, injectWakeLock, permissionGuard, provideBattery, provideBroadcastChannel, provideBrowserApiLogLevel, provideBrowserWebApis, provideCamera, provideClipboard, provideCommunicationApis, provideCompression, provideEyeDropper, provideFileSystemAccess, provideFullscreen, provideGamepad, provideGeolocation, provideIdleDetector, provideIntersectionObserver, provideLocationApis, provideMediaApis, provideMediaDevices, provideMediaRecorder, provideMutationObserver, provideNetworkInformation, provideNotifications, providePageVisibility, providePerformanceObserver, providePermissions, provideResizeObserver, provideScreenOrientation, provideScreenWakeLock, provideServerSentEvents, provideSpeechSynthesis, provideStorageApis, provideStorageManager, provideVibration, provideWebAudio, provideWebLocks, provideWebShare, provideWebSocket, provideWebStorage, provideWebWorker, version, warnExperimental };
+export type { AudioAnalyserData, AudioContextState, BatteryInfo, BatteryManager, BatteryRef, BrowserApiLogLevel, BrowserApiLogger, BrowserCapabilityId, BrowserError, BrowserPermissions, BrowserWebApisCompositionConfig, BrowserWebApisConfig, CameraCapabilities, CameraInfo, ClipboardRef, CompressionFormat, ConnectionType, EffectiveConnectionType, ElementInput, ElementSize, ErrorCallback, EventHandler, ExperimentalWarnContext, EyeDropperRef, EyeDropperResult, FileOpenOptions, FileSaveOptions, GamepadRef, GamepadState, GeolocationCoordinates, GeolocationError, GeolocationOptions, GeolocationPosition$1 as GeolocationPosition, GeolocationRef, GeolocationWatchOptions, IdleDetectorOptions, IdleDetectorRef, IdleState, IntersectionObserverOptions, IntersectionRef, MediaDevice, MediaDeviceKind, MediaDevicesInfo, MediaStreamConstraints$1 as MediaStreamConstraints, MediaTrackConstraints$1 as MediaTrackConstraints, MutationObserverOptions, MutationRef, NetworkInformation, NetworkInformationRef, OrientationInfo, OrientationLockType, OrientationType, PageVisibilityRef, PerformanceEntryType, PerformanceObserverConfig, PerformanceObserverRef, PermissionNameExt, PermissionRequest, RecordingOptions, RecordingResult, RecordingState, ResizeObserverOptions, ResizeRef, SSEConfig, SSEConnectionState, SSEMessage, ScreenIdleState, ScreenOrientationRef, SpeechOptions, SpeechState, StorageEvent, StorageNamespace, StorageOptions, StorageQuotaEstimate, StorageValue, UserIdleState, VibrationPattern, VibrationPreset, VisibilityState, WakeLockRef, WakeLockStatus, WakeLockType, WebSocketClientConfig, WebSocketConfig, WebSocketMessage, WebSocketRequestOptions, WebSocketState, WebSocketStatus, WebSocketStatusV2, WorkerMessage, WorkerRequestOptions, WorkerStatus, WorkerTask };