@hanifhan1f/vidstack 1.12.13

package/types/utils/error.d.ts

@@ -0,0 +1,2 @@
+export declare function coerceToError(error: unknown): Error;
+export declare function assert(condition: any, message?: string | false): asserts condition;

package/types/utils/language.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Gets the language name corresponding to the provided language code.
+ *
+ * @param {string} langCode - The language code (e.g.,"en", "en-us", "es-es", "fr-fr").
+ * @returns {string} The localized language name based on the user's preferred languages,
+ *                   or `null` if the language code is not recognized.
+ */
+export declare function getLangName(langCode: string): string | null;

package/types/utils/manifest.d.ts

@@ -0,0 +1,3 @@
+import type { MediaStreamType } from '../core/api/types';
+export declare function resolveStreamTypeFromDASHManifest(manifestSrc: string, requestInit?: RequestInit): Promise<MediaStreamType>;
+export declare function resolveStreamTypeFromHLSManifest(manifestSrc: string, requestInit?: RequestInit): Promise<MediaStreamType>;

package/types/utils/mime.d.ts

@@ -0,0 +1,15 @@
+import type { Src } from '../core/api/src-types';
+export declare const AUDIO_EXTENSIONS: RegExp;
+export declare const AUDIO_TYPES: Set<string>;
+export declare const VIDEO_EXTENSIONS: RegExp;
+export declare const VIDEO_TYPES: Set<string>;
+export declare const HLS_VIDEO_EXTENSIONS: RegExp;
+export declare const DASH_VIDEO_EXTENSIONS: RegExp;
+export declare const HLS_VIDEO_TYPES: Set<string>;
+export declare const DASH_VIDEO_TYPES: Set<string>;
+export declare function isAudioSrc({ src, type }: Src): boolean;
+export declare function isVideoSrc(src: Src): boolean;
+export declare function isHLSSrc({ src, type }: Src): boolean;
+export declare function isDASHSrc({ src, type }: Src): boolean;
+export declare function canGoogleCastSrc(src: Src): boolean;
+export declare function isMediaStream(src: unknown): src is MediaStream;

package/types/utils/network.d.ts

@@ -0,0 +1,17 @@
+import type { Src } from '../core/api/src-types';
+export declare function appendParamsToURL(baseUrl: string, params: Record<string, any>): string;
+export declare function preconnect(url: string, rel?: 'preconnect' | 'prefetch' | 'preload'): boolean;
+export declare function loadScript(src: string): Promise<void>;
+export declare function getRequestCredentials(crossOrigin?: string | null): RequestCredentials | undefined;
+export type FileDownloadInfo = boolean | string | {
+    url: string;
+    filename: string;
+} | null;
+export declare function getDownloadFile({ title, src, download, }: {
+    src: Src;
+    title: string;
+    download?: FileDownloadInfo;
+}): {
+    url: unknown;
+    name: string;
+} | null;

package/types/utils/number.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Round a number to the given number of `decimalPlaces`.
+ */
+export declare function round(num: number, decimalPlaces?: number): number;
+/**
+ * Get the number of decimal places in the given `num`.
+ *
+ * @example `1 -> 0`
+ * @example `1.0 -> 0`
+ * @example `1.1 -> 1`
+ * @example `1.12 -> 2`
+ */
+export declare function getNumberOfDecimalPlaces(num: number): number;
+/**
+ * Clamp a given `value` between a minimum and maximum value.
+ */
+export declare function clampNumber(min: number, value: number, max: number): number;

package/types/utils/promise.d.ts

@@ -0,0 +1 @@
+export declare function timedPromise<Resolved, Rejected>(callback: () => Rejected | void, ms?: number): import("maverick.js/std").DeferredPromise<Resolved, Rejected>;

package/types/utils/scroll.d.ts

@@ -0,0 +1,5 @@
+import { type Options as ComputeScrollOptions } from 'compute-scroll-into-view';
+export interface ScrollIntoViewOptions extends ComputeScrollOptions, ScrollOptions {
+}
+export declare function scrollIntoView(el: HTMLElement, options: ScrollIntoViewOptions): void;
+export declare function scrollIntoCenter(el: HTMLElement, options?: ScrollIntoViewOptions): void;

package/types/utils/support.d.ts

@@ -0,0 +1,72 @@
+export declare const UA: string;
+export declare const IS_IOS: boolean;
+export declare const IS_IPHONE: boolean;
+export declare const IS_CHROME: boolean;
+export declare const IS_IOS_CHROME: boolean;
+export declare const IS_SAFARI: boolean;
+/**
+ * Returns the current Android OS version. Defaults to `0` if unknown.
+ */
+export declare function getAndroidVersion(): number;
+/**
+ * Checks whether the `IntersectionObserver` API is available.
+ */
+export declare function canObserveIntersection(): boolean;
+/**
+ * Checks if the ScreenOrientation API is available.
+ *
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Screen/orientation}
+ */
+export declare function canOrientScreen(): boolean;
+/**
+ * Checks if the screen orientation can be changed.
+ *
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Screen/orientation}
+ */
+export declare function canRotateScreen(): boolean;
+/**
+ * Reduced motion iOS & MacOS setting.
+ *
+ * @see {@link https://webkit.org/blog/7551/responsive-design-for-motion/}
+ */
+export declare function isReducedMotionPreferred(): boolean;
+export declare function canPlayAudioType(audio: HTMLAudioElement | null, type: string): boolean;
+export declare function canPlayVideoType(video: HTMLVideoElement | null, type: string): boolean;
+/**
+ * Checks if the native HTML5 video player can play HLS.
+ */
+export declare function canPlayHLSNatively(video?: HTMLVideoElement | null): boolean;
+/**
+ * Checks if the native HTML5 video player can enter picture-in-picture (PIP) mode when using
+ * the Chrome browser.
+ *
+ * @see {@link https://developers.google.com/web/updates/2018/10/watch-video-using-picture-in-picture}
+ */
+export declare function canUsePictureInPicture(video: HTMLVideoElement | null): boolean;
+/**
+ * Checks if the native HTML5 video player can use the presentation API in Safari.
+ *
+ * @see {@link https://developer.apple.com/documentation/webkitjs/htmlvideoelement/1631913-webkitpresentationmode}
+ */
+export declare function canUseVideoPresentation(video: HTMLVideoElement | null): boolean;
+export declare function canChangeVolume(): Promise<boolean>;
+/**
+ * @see {@link https://github.com/video-dev/hls.js/blob/master/src/is-supported.ts}
+ */
+export declare function getMediaSource(): typeof MediaSource | undefined;
+/**
+ * @see {@link https://github.com/video-dev/hls.js/blob/master/src/is-supported.ts}
+ */
+export declare function getSourceBuffer(): typeof SourceBuffer | undefined;
+/**
+ * Whether `hls.js` is supported in this environment. Checks whether `MediaSource` or
+ * `ManagedMediaSource` and a valid `SourceBuffer` API are available.
+ *
+ * @see {@link https://github.com/video-dev/hls.js/blob/master/src/is-supported.ts}
+ */
+export declare function isHLSSupported(): boolean;
+/**
+ * Whether `dashjs` is supported in this environment. Checks whether `MediaSource` or
+ * `ManagedMediaSource` and a valid `SourceBuffer` API are available.
+ */
+export declare function isDASHSupported(): boolean;

package/types/utils/time.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 🤖 This section was generously ~stolen from~... err... donated by Furf. Cheers!
+ *
+ * @see https://github.snooguts.net/david-furfero/reddit-media-player/blob/main/src/lib/formatTime/index.ts
+ */
+/**
+ * Casts a number to a string and pads it to match the given `expectedLength`.
+ *
+ * @param num - A number to pad.
+ * @param expectedLength - The expected length of the numbers as a string.
+ */
+export declare function padNumberWithZeroes(num: number, expectedLength: number): string;
+export type TimeUnit = 'hours' | 'minutes' | 'seconds' | 'fraction';
+export type ParsedTime = {
+    [P in TimeUnit]: number;
+};
+/**
+ * Parses the given `duration` into the following units of time: hours, minutes,
+ * seconds, fraction (fraction of a second).
+ *
+ * @param duration - The length of time to parse in seconds.
+ */
+export declare function parseTime(duration: number): ParsedTime;
+export interface FormatTimeOptions {
+    padHrs?: boolean | null;
+    padMins?: boolean | null;
+    showHrs?: boolean;
+    showMs?: boolean;
+}
+/**
+ * Formats the given `duration` into a human readable form that can be displayed to the user.
+ *
+ * @param duration - The length of time to parse in seconds.
+ * @param shouldPadHours - Whether to pad the hours to be length of 2.
+ * @param shouldPadMinutes - Whether to pad the minutes to be length of 2.
+ * @param shouldAlwaysShowHours - Whether to always show the hours unit.
+ * @example `01:20 -> minutes:seconds`
+ * @example `3:01:20 -> hours:minutes:seconds`
+ * @example If `shouldPadHours` is `true` - `03:01:20`
+ * @example If `shouldAlwaysShowHours` is `true` - `0:01:20`
+ */
+export declare function formatTime(duration: number, { padHrs, padMins, showHrs, showMs }?: FormatTimeOptions): string;
+/**
+ * Formats the given `duration` into human spoken form.
+ *
+ * @param duration - The length of time to parse in seconds.
+ * @example `2 hour 3 min 4 sec`
+ */
+export declare function formatSpokenTime(duration: number): string;
+/**
+ * Formats the given `duration` into a valid HTML5 duration as specified in the linked
+ * spec below.
+ *
+ * @param duration - The length of time to parse in seconds.
+ * @see {@link https://www.w3.org/TR/2014/REC-html5-20141028/infrastructure.html#valid-duration-string}
+ */
+export declare function formatHtml5Duration(duration: number): string;

package/vite.config.ts

@@ -0,0 +1,61 @@
+/// <reference types="vitest" />
+
+import { transform } from 'esbuild';
+import { defineConfig } from 'vite';
+
+const SERVER = !!process.env.SERVER;
+
+export default defineConfig({
+  define: {
+    __DEV__: 'true',
+    __TEST__: 'true',
+    __SERVER__: SERVER ? 'true' : 'false',
+    __CDN__: 'true',
+  },
+  build: {
+    target: 'es2019',
+  },
+  publicDir: 'sandbox/public',
+  resolve: {
+    alias: {
+      '$test-utils': '/src/test-utils',
+      'vidstack/elements': '/src/elements',
+      'vidstack/player': '/src/player',
+    },
+  },
+  optimizeDeps: {
+    noDiscovery: true,
+    include: [],
+  },
+  // https://vitest.dev/config
+  test: {
+    include: ['src/**/*.test.ts'],
+    globals: true,
+    environment: 'jsdom',
+    setupFiles: ['src/test-utils/setup.ts'],
+    testTimeout: 2500,
+  },
+  plugins: [legacyPlugin()],
+});
+
+function legacyPlugin() {
+  return {
+    name: 'legacy',
+    enforce: 'pre',
+    async transform(code, id) {
+      if (/\.(j|t)s/.test(id)) {
+        return (
+          await transform(code, {
+            loader: 'ts',
+            target: 'es2019',
+            tsconfigRaw: {
+              compilerOptions: {
+                experimentalDecorators: true,
+              },
+            },
+          })
+        ).code;
+      }
+    },
+  };
+}