@openrails/contentkit-ui 0.0.0-placeholder → 0.68.0

package/dist/client/media/windows.js

@@ -0,0 +1,39 @@
+//#region src/client/media/windows.ts
+var e = 50;
+function t(e, t, n, r = 50) {
+	let i = [], a = n === void 0 ? t : Math.min(t, n);
+	if (e >= a) return i;
+	for (let t = Math.floor(Math.max(e, 0) / r) * r; t < a; t += r) i.push(t);
+	return i;
+}
+function n(e) {
+	let t = e.filter((e) => !!e);
+	if (t.length === 0) return null;
+	if (t.length === 1) return t[0];
+	let n = t.reduce((e, t) => t.expires >= e.expires ? t : e), r = /* @__PURE__ */ new Map();
+	for (let e of [...t].sort((e, t) => e.expires - t.expires)) for (let t of e.files) t.url && r.set(t.path, t);
+	let i = n.files.map((e) => {
+		if (e.url || e.locked) return e;
+		let t = r.get(e.path);
+		return t ? {
+			...e,
+			url: t.url,
+			...t.download ? { download: t.download } : {}
+		} : e;
+	}), a = Math.min(...t.map((e) => e.offset)), o = Math.max(...t.map((e) => e.offset + e.limit));
+	return {
+		...n,
+		files: i,
+		offset: a,
+		limit: o - a,
+		expires: Math.min(...t.map((e) => e.expires))
+	};
+}
+var r = (e) => !!e.upload && !e.failed && (!!e.staged || (e.pending?.length ?? 0) > 0);
+function i(e) {
+	return !e || e.full ? !1 : e.state === "processing" || e.files.some(r);
+}
+//#endregion
+export { e as READ_CHUNK, t as chunkOffsets, r as isProcessing, n as mergeReads, i as processing };
+
+//# sourceMappingURL=windows.js.map

package/dist/client/media/windows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows.js","names":[],"sources":["../../../src/client/media/windows.ts"],"sourcesContent":["import type { FileInfo, ReadResult } from \"../generated/wire.js\";\n\n/** Files per window when a read is split into windows. */\nexport const READ_CHUNK = 50;\n\n/** Offsets of chunk-sized windows covering files [start, end), clipped to total when known. */\nexport function chunkOffsets(start: number, end: number, total?: number, chunk = READ_CHUNK): number[] {\n  const out: number[] = [];\n  const stop = total === undefined ? end : Math.min(end, total);\n  if (start >= stop) return out;\n  for (let o = Math.floor(Math.max(start, 0) / chunk) * chunk; o < stop; o += chunk) out.push(o);\n  return out;\n}\n\n/**\n * One item's window reads as one read: the newest window's listing and\n * metadata, each file's URL from the newest window that signed it, and the\n * earliest expiry. Every window lists every file; only its range has URLs.\n */\nexport function mergeReads(reads: readonly (ReadResult | null | undefined)[]): ReadResult | null {\n  const present = reads.filter((r): r is ReadResult => !!r);\n  if (present.length === 0) return null;\n  if (present.length === 1) return present[0]!;\n  const newest = present.reduce((a, b) => (b.expires >= a.expires ? b : a));\n  const urls = new Map<string, FileInfo>();\n  for (const r of [...present].sort((a, b) => a.expires - b.expires)) for (const f of r.files) if (f.url) urls.set(f.path, f);\n  const files = newest.files.map((f) => {\n    if (f.url || f.locked) return f;\n    const signed = urls.get(f.path);\n    return signed ? { ...f, url: signed.url, ...(signed.download ? { download: signed.download } : {}) } : f;\n  });\n  const start = Math.min(...present.map((r) => r.offset));\n  const end = Math.max(...present.map((r) => r.offset + r.limit));\n  return { ...newest, files, offset: start, limit: end - start, expires: Math.min(...present.map((r) => r.expires)) };\n}\n\n/** An upload the worker has not finished: staged, or with work pending, and not failed. */\nexport const isProcessing = (f: FileInfo) => !!f.upload && !f.failed && (!!f.staged || (f.pending?.length ?? 0) > 0);\n\n/** An editor read with uploads still processing (not stalled because the item is full). */\nexport function processing(read: ReadResult | null | undefined): boolean {\n  if (!read || read.full) return false;\n  return read.state === \"processing\" || read.files.some(isProcessing);\n}\n"],"mappings":";AAGA,IAAa,IAAa;AAG1B,SAAgB,EAAa,GAAe,GAAa,GAAgB,IAAA,IAA8B;CACrG,IAAM,IAAgB,CAAC,GACjB,IAAO,MAAU,KAAA,IAAY,IAAM,KAAK,IAAI,GAAK,CAAK;CAC5D,IAAI,KAAS,GAAM,OAAO;CAC1B,KAAK,IAAI,IAAI,KAAK,MAAM,KAAK,IAAI,GAAO,CAAC,IAAI,CAAK,IAAI,GAAO,IAAI,GAAM,KAAK,GAAO,EAAI,KAAK,CAAC;CAC7F,OAAO;AACT;AAOA,SAAgB,EAAW,GAAsE;CAC/F,IAAM,IAAU,EAAM,QAAQ,MAAuB,CAAC,CAAC,CAAC;CACxD,IAAI,EAAQ,WAAW,GAAG,OAAO;CACjC,IAAI,EAAQ,WAAW,GAAG,OAAO,EAAQ;CACzC,IAAM,IAAS,EAAQ,QAAQ,GAAG,MAAO,EAAE,WAAW,EAAE,UAAU,IAAI,CAAE,GAClE,oBAAO,IAAI,IAAsB;CACvC,KAAK,IAAM,KAAK,CAAC,GAAG,CAAO,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,KAAK,IAAM,KAAK,EAAE,OAAO,AAAI,EAAE,OAAK,EAAK,IAAI,EAAE,MAAM,CAAC;CAC1H,IAAM,IAAQ,EAAO,MAAM,KAAK,MAAM;EACpC,IAAI,EAAE,OAAO,EAAE,QAAQ,OAAO;EAC9B,IAAM,IAAS,EAAK,IAAI,EAAE,IAAI;EAC9B,OAAO,IAAS;GAAE,GAAG;GAAG,KAAK,EAAO;GAAK,GAAI,EAAO,WAAW,EAAE,UAAU,EAAO,SAAS,IAAI,CAAC;EAAG,IAAI;CACzG,CAAC,GACK,IAAQ,KAAK,IAAI,GAAG,EAAQ,KAAK,MAAM,EAAE,MAAM,CAAC,GAChD,IAAM,KAAK,IAAI,GAAG,EAAQ,KAAK,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC;CAC9D,OAAO;EAAE,GAAG;EAAQ;EAAO,QAAQ;EAAO,OAAO,IAAM;EAAO,SAAS,KAAK,IAAI,GAAG,EAAQ,KAAK,MAAM,EAAE,OAAO,CAAC;CAAE;AACpH;AAGA,IAAa,KAAgB,MAAgB,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,WAAW,CAAC,CAAC,EAAE,WAAW,EAAE,SAAS,UAAU,KAAK;AAGlH,SAAgB,EAAW,GAA8C;CAEvE,OADI,CAAC,KAAQ,EAAK,OAAa,KACxB,EAAK,UAAU,gBAAgB,EAAK,MAAM,KAAK,CAAY;AACpE"}

package/dist/client/playback.d.ts

@@ -0,0 +1,200 @@
+/**
+ * Why a video cannot play. `network` covers CORS too: browsers report a blocked
+ * cross-origin response exactly like an unreachable server (status 0).
+ */
+export type PlaybackErrorKind = "network" | "access" | "not_found" | "rate_limited" | "unsupported" | "stalled" | "unknown";
+export interface PlaybackError {
+    kind: PlaybackErrorKind;
+    /** Short support code, e.g. "fragLoadError/0" or "media/4". */
+    code: string;
+    status?: number;
+}
+/** The fields of hls.js ErrorData this reads. */
+export interface HlsErrorLike {
+    type?: string;
+    details: string;
+    fatal?: boolean;
+    response?: {
+        code?: number;
+    } | null;
+    networkDetails?: unknown;
+}
+/** HTTP status → kind; 0 (or none) is a blocked or unreachable request. */
+export declare function statusKind(status: number | undefined): PlaybackErrorKind;
+/** Read again this long before the item token expires. */
+export declare const REFRESH_BEFORE_EXPIRY = 60000;
+/**
+ * Milliseconds until the read should be fetched again: shortly before
+ * `expires` (the read's, unix seconds), never sooner than 30 s; null when
+ * the read has no expiry. A read before the expiry answers the same token,
+ * so nothing is gained by reading earlier.
+ */
+export declare function expiryDelay(expires: number | undefined, now?: number): number | null;
+/**
+ * Worth one grant refresh and retry: 401/403, or a 404 — media-gateway answers a
+ * missing, expired or wrong token exactly like a missing object. A 429 (the
+ * ingress's rate limit) or a blocked request is not: it fails without a loop.
+ */
+export declare function refreshable(e: PlaybackError): boolean;
+export declare function classifyHlsError(d: HlsErrorLike): PlaybackError;
+/** A native `<video>` error (Safari's HLS): 2 network, 3 decode, 4 unsupported source. */
+export declare function classifyMediaError(e: {
+    code: number;
+} | null | undefined): PlaybackError;
+/** hls.js settings the player uses; spread under your own. */
+export declare const hlsConfig: {
+    manifestLoadPolicy: {
+        default: {
+            maxTimeToFirstByteMs: number;
+            maxLoadTimeMs: number;
+            timeoutRetry: {
+                maxNumRetry: number;
+                retryDelayMs: number;
+                maxRetryDelayMs: number;
+                shouldRetry: (_c: unknown, _n: number, _t: boolean, res: {
+                    code?: number;
+                } | undefined, fallback: boolean) => boolean;
+            };
+            errorRetry: {
+                maxNumRetry: number;
+                retryDelayMs: number;
+                maxRetryDelayMs: number;
+                shouldRetry: (_c: unknown, _n: number, _t: boolean, res: {
+                    code?: number;
+                } | undefined, fallback: boolean) => boolean;
+            };
+        };
+    };
+    playlistLoadPolicy: {
+        default: {
+            maxTimeToFirstByteMs: number;
+            maxLoadTimeMs: number;
+            timeoutRetry: {
+                maxNumRetry: number;
+                retryDelayMs: number;
+                maxRetryDelayMs: number;
+                shouldRetry: (_c: unknown, _n: number, _t: boolean, res: {
+                    code?: number;
+                } | undefined, fallback: boolean) => boolean;
+            };
+            errorRetry: {
+                maxNumRetry: number;
+                retryDelayMs: number;
+                maxRetryDelayMs: number;
+                shouldRetry: (_c: unknown, _n: number, _t: boolean, res: {
+                    code?: number;
+                } | undefined, fallback: boolean) => boolean;
+            };
+        };
+    };
+    fragLoadPolicy: {
+        default: {
+            maxTimeToFirstByteMs: number;
+            maxLoadTimeMs: number;
+            timeoutRetry: {
+                maxNumRetry: number;
+                retryDelayMs: number;
+                maxRetryDelayMs: number;
+                shouldRetry: (_c: unknown, _n: number, _t: boolean, res: {
+                    code?: number;
+                } | undefined, fallback: boolean) => boolean;
+            };
+            errorRetry: {
+                maxNumRetry: number;
+                retryDelayMs: number;
+                maxRetryDelayMs: number;
+                shouldRetry: (_c: unknown, _n: number, _t: boolean, res: {
+                    code?: number;
+                } | undefined, fallback: boolean) => boolean;
+            };
+        };
+    };
+    keyLoadPolicy: {
+        default: {
+            maxTimeToFirstByteMs: number;
+            maxLoadTimeMs: number;
+            timeoutRetry: {
+                maxNumRetry: number;
+                retryDelayMs: number;
+                maxRetryDelayMs: number;
+                shouldRetry: (_c: unknown, _n: number, _t: boolean, res: {
+                    code?: number;
+                } | undefined, fallback: boolean) => boolean;
+            };
+            errorRetry: {
+                maxNumRetry: number;
+                retryDelayMs: number;
+                maxRetryDelayMs: number;
+                shouldRetry: (_c: unknown, _n: number, _t: boolean, res: {
+                    code?: number;
+                } | undefined, fallback: boolean) => boolean;
+            };
+        };
+    };
+};
+/** Non-fatal network failures (hls.js also tries other renditions) before the player gives up. */
+export declare const NETWORK_FAILURES_BEFORE_ERROR = 3;
+/** Adaptive-bitrate policy for the player; every field is optional. */
+export interface AbrPolicy {
+    /** Start at, and never cap the display below, the rung of this short side (px) when bandwidth allows. Default 1080. */
+    minStartHeight?: number;
+    /** Never pick a rung with a larger short side (px). Default unlimited. */
+    maxHeight?: number;
+    /** false: stock hls.js start (500 kbps guess) and a strict display cap. Default true. */
+    preferHighRes?: boolean;
+    /** Bits/s assumed when neither a measurement nor `navigator.connection` is available. Default 8 Mbps. */
+    defaultEstimate?: number;
+}
+/** A rendition as hls.js levels describe it. */
+export interface Rung {
+    width: number;
+    height: number;
+    /** Peak bits/s (BANDWIDTH). */
+    bitrate: number;
+    /** AVERAGE-BANDWIDTH when known. */
+    averageBitrate?: number;
+}
+/** What the browser says about the connection (Network Information API). */
+export interface ConnectionHint {
+    downlink?: number;
+    saveData?: boolean;
+}
+export declare const ABR_DEFAULTS: {
+    readonly minStartHeight: 1080;
+    readonly maxHeight: number;
+    readonly preferHighRes: true;
+    readonly defaultEstimate: 8000000;
+};
+/**
+ * The highest rung index (rungs ascend by bitrate) worth loading for a display
+ * of width×height device pixels: the smallest rung covering the video's fitted
+ * box (to within 10%), never below the minStartHeight rung, never above maxHeight.
+ */
+export declare function capRung(rungs: readonly Rung[], width: number, height: number, policy?: AbrPolicy): number;
+/**
+ * Levels to remove (indices, descending) so one codec set remains: the set of
+ * the level hls.js lists first, which is the master playlist's first playable
+ * codec (AV1 or HEVC before H.264 when the browser decodes them). hls.js never
+ * switches codec sets for bandwidth, and the quality menu lists each rung once.
+ */
+export declare function otherCodecLevels(levels: readonly {
+    codecSet?: string;
+}[], first: number): number[];
+/** Bits/s to seed the estimator with: a measurement from this page, the browser's downlink, else the policy default. */
+export declare function initialEstimate(policy?: AbrPolicy, conn?: ConnectionHint | null, measured?: number): number;
+/** The first rung to load: the lowest under Save-Data, else the highest under cap the estimate sustains. */
+export declare function startRung(rungs: readonly Rung[], estimate: number, cap: number, conn?: ConnectionHint | null): number;
+/** hls.js ABR settings: climb after a couple of good segments, drop before the buffer runs dry. */
+export declare function abrHlsConfig(policy: AbrPolicy | undefined, estimate: number): {
+    abrEwmaDefaultEstimate: number;
+    abrEwmaDefaultEstimateMax: number;
+    abrEwmaFastVoD: number;
+    abrEwmaSlowVoD: number;
+    abrBandWidthUpFactor: number;
+    abrBandWidthFactor: number;
+    capLevelToPlayerSize: boolean;
+    ignoreDevicePixelRatio: boolean;
+    maxBufferLength: number;
+    maxMaxBufferLength: number;
+    backBufferLength: number;
+};

package/dist/client/playback.js

@@ -0,0 +1,142 @@
+//#region src/client/playback.ts
+var e = /* @__PURE__ */ new Set([
+	"manifestParsingError",
+	"manifestIncompatibleCodecsError",
+	"levelParsingError",
+	"levelEmptyError",
+	"fragParsingError",
+	"bufferAddCodecError",
+	"bufferIncompatibleCodecsError",
+	"bufferAppendError",
+	"attachMediaError"
+]);
+function t(e) {
+	return e === 401 || e === 403 ? "access" : e === 404 || e === 410 ? "not_found" : e === 429 ? "rate_limited" : "network";
+}
+var n = 6e4, r = 3e4;
+function i(e, t = Date.now()) {
+	return e ? Math.max(e * 1e3 - n - t, r) : null;
+}
+function a(e) {
+	return e.kind === "access" || e.status === 404;
+}
+function o(e) {
+	let t = e.response?.code;
+	if (typeof t == "number") return t;
+	let n = e.networkDetails?.status;
+	return typeof n == "number" ? n : void 0;
+}
+function s(n) {
+	if (e.has(n.details)) return {
+		kind: "unsupported",
+		code: n.details
+	};
+	if (n.type === "networkError" || /Load(Error|TimeOut)$/i.test(n.details)) {
+		let e = /TimeOut$/i.test(n.details) ? 0 : o(n) ?? 0;
+		return {
+			kind: t(e),
+			code: `${n.details}/${e}`,
+			status: e
+		};
+	}
+	return {
+		kind: n.type === "mediaError" && n.fatal ? "unsupported" : "unknown",
+		code: n.details
+	};
+}
+function c(e) {
+	let t = e?.code ?? 0;
+	return {
+		kind: t === 2 ? "network" : t === 3 || t === 4 ? "unsupported" : "unknown",
+		code: `media/${t}`
+	};
+}
+var l = /* @__PURE__ */ new Set([
+	401,
+	403,
+	404,
+	410,
+	429
+]), u = (e) => ({
+	maxNumRetry: e,
+	retryDelayMs: 500,
+	maxRetryDelayMs: 2e3,
+	shouldRetry: (e, t, n, r, i) => !l.has(r?.code ?? -1) && i
+}), d = (e, t) => ({ default: {
+	maxTimeToFirstByteMs: e,
+	maxLoadTimeMs: t,
+	timeoutRetry: u(1),
+	errorRetry: u(2)
+} }), f = {
+	manifestLoadPolicy: d(5e3, 1e4),
+	playlistLoadPolicy: d(5e3, 1e4),
+	fragLoadPolicy: d(6e3, 3e4),
+	keyLoadPolicy: d(5e3, 1e4)
+}, p = 3, m = {
+	minStartHeight: 1080,
+	maxHeight: Infinity,
+	preferHighRes: !0,
+	defaultEstimate: 8e6
+}, h = 5e5, g = .75, _ = 1.1, v = (e) => Math.min(e.width, e.height) || e.height || e.width;
+function y(e) {
+	return {
+		...m,
+		...Object.fromEntries(Object.entries(e ?? {}).filter(([, e]) => e !== void 0))
+	};
+}
+function b(e, t, n, r) {
+	let i = y(r), a = e.length;
+	if (!a) return -1;
+	let o = a - 1;
+	if (t > 0 && n > 0) for (let r = 0; r < a; r++) {
+		let i = e[r];
+		if ((i.width && i.height ? Math.min(t / i.width, n / i.height) : 1) <= _) {
+			o = r;
+			break;
+		}
+	}
+	if (i.preferHighRes) {
+		let t = e.findIndex((e) => v(e) >= i.minStartHeight);
+		o = Math.max(o, t === -1 ? a - 1 : t);
+	}
+	for (; o > 0 && v(e[o]) > i.maxHeight;) o--;
+	return o;
+}
+function x(e, t) {
+	let n = (e[t] ?? e[0])?.codecSet;
+	return e.flatMap((e, t) => e.codecSet === n ? [] : [t]).reverse();
+}
+function S(e, t, n) {
+	let r = y(e);
+	return t?.saveData ? h : n && n > 0 ? n : t?.downlink && t.downlink > 0 ? t.downlink * 1e6 : r.preferHighRes ? r.defaultEstimate : h;
+}
+function C(e, t, n, r) {
+	if (!e.length) return -1;
+	if (r?.saveData) return 0;
+	let i = 0;
+	for (let r = 0; r <= Math.min(n, e.length - 1); r++) {
+		let n = e[r];
+		(n.averageBitrate || n.bitrate) <= t * g && (i = r);
+	}
+	return i;
+}
+function w(e, t) {
+	let n = y(e);
+	return {
+		abrEwmaDefaultEstimate: t,
+		abrEwmaDefaultEstimateMax: Math.max(t, 5e6),
+		abrEwmaFastVoD: n.preferHighRes ? 2 : 3,
+		abrEwmaSlowVoD: n.preferHighRes ? 6 : 9,
+		abrBandWidthUpFactor: n.preferHighRes ? .8 : .7,
+		abrBandWidthFactor: .9,
+		capLevelToPlayerSize: !0,
+		ignoreDevicePixelRatio: !1,
+		maxBufferLength: 30,
+		maxMaxBufferLength: 120,
+		backBufferLength: 30
+	};
+}
+//#endregion
+export { m as ABR_DEFAULTS, p as NETWORK_FAILURES_BEFORE_ERROR, n as REFRESH_BEFORE_EXPIRY, w as abrHlsConfig, b as capRung, s as classifyHlsError, c as classifyMediaError, i as expiryDelay, f as hlsConfig, S as initialEstimate, x as otherCodecLevels, a as refreshable, C as startRung, t as statusKind };
+
+//# sourceMappingURL=playback.js.map

package/dist/client/playback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playback.js","names":[],"sources":["../../src/client/playback.ts"],"sourcesContent":["/**\n * Why a video cannot play. `network` covers CORS too: browsers report a blocked\n * cross-origin response exactly like an unreachable server (status 0).\n */\nexport type PlaybackErrorKind = \"network\" | \"access\" | \"not_found\" | \"rate_limited\" | \"unsupported\" | \"stalled\" | \"unknown\";\n\nexport interface PlaybackError {\n  kind: PlaybackErrorKind;\n  /** Short support code, e.g. \"fragLoadError/0\" or \"media/4\". */\n  code: string;\n  status?: number;\n}\n\n/** The fields of hls.js ErrorData this reads. */\nexport interface HlsErrorLike {\n  type?: string;\n  details: string;\n  fatal?: boolean;\n  response?: { code?: number } | null;\n  networkDetails?: unknown;\n}\n\nconst UNSUPPORTED = new Set([\n  \"manifestParsingError\",\n  \"manifestIncompatibleCodecsError\",\n  \"levelParsingError\",\n  \"levelEmptyError\",\n  \"fragParsingError\",\n  \"bufferAddCodecError\",\n  \"bufferIncompatibleCodecsError\",\n  \"bufferAppendError\",\n  \"attachMediaError\",\n]);\n\n/** HTTP status → kind; 0 (or none) is a blocked or unreachable request. */\nexport function statusKind(status: number | undefined): PlaybackErrorKind {\n  if (status === 401 || status === 403) return \"access\";\n  if (status === 404 || status === 410) return \"not_found\";\n  if (status === 429) return \"rate_limited\";\n  return \"network\";\n}\n\n/** Read again this long before the item token expires. */\nexport const REFRESH_BEFORE_EXPIRY = 60_000;\nconst MIN_REFRESH_DELAY = 30_000;\n\n/**\n * Milliseconds until the read should be fetched again: shortly before\n * `expires` (the read's, unix seconds), never sooner than 30 s; null when\n * the read has no expiry. A read before the expiry answers the same token,\n * so nothing is gained by reading earlier.\n */\nexport function expiryDelay(expires: number | undefined, now = Date.now()): number | null {\n  if (!expires) return null;\n  return Math.max(expires * 1000 - REFRESH_BEFORE_EXPIRY - now, MIN_REFRESH_DELAY);\n}\n\n/**\n * Worth one grant refresh and retry: 401/403, or a 404 — media-gateway answers a\n * missing, expired or wrong token exactly like a missing object. A 429 (the\n * ingress's rate limit) or a blocked request is not: it fails without a loop.\n */\nexport function refreshable(e: PlaybackError): boolean {\n  return e.kind === \"access\" || e.status === 404;\n}\n\nfunction hlsStatus(d: HlsErrorLike): number | undefined {\n  const code = d.response?.code;\n  if (typeof code === \"number\") return code;\n  const s = (d.networkDetails as { status?: unknown } | null | undefined)?.status;\n  return typeof s === \"number\" ? s : undefined;\n}\n\nexport function classifyHlsError(d: HlsErrorLike): PlaybackError {\n  if (UNSUPPORTED.has(d.details)) return { kind: \"unsupported\", code: d.details };\n  if (d.type === \"networkError\" || /Load(Error|TimeOut)$/i.test(d.details)) {\n    const status = /TimeOut$/i.test(d.details) ? 0 : (hlsStatus(d) ?? 0);\n    return { kind: statusKind(status), code: `${d.details}/${status}`, status };\n  }\n  return { kind: d.type === \"mediaError\" && d.fatal ? \"unsupported\" : \"unknown\", code: d.details };\n}\n\n/** A native `<video>` error (Safari's HLS): 2 network, 3 decode, 4 unsupported source. */\nexport function classifyMediaError(e: { code: number } | null | undefined): PlaybackError {\n  const code = e?.code ?? 0;\n  const kind: PlaybackErrorKind = code === 2 ? \"network\" : code === 3 || code === 4 ? \"unsupported\" : \"unknown\";\n  return { kind, code: `media/${code}` };\n}\n\n// Fail fast: a dead endpoint surfaces in seconds, a blip gets 1–2 quick retries.\nconst noRetryStatus = new Set([401, 403, 404, 410, 429]);\nconst retry = (maxNumRetry: number) => ({\n  maxNumRetry,\n  retryDelayMs: 500,\n  maxRetryDelayMs: 2000,\n  shouldRetry: (_c: unknown, _n: number, _t: boolean, res: { code?: number } | undefined, fallback: boolean) =>\n    !noRetryStatus.has(res?.code ?? -1) && fallback,\n});\nconst policy = (ttfb: number, load: number) => ({\n  default: { maxTimeToFirstByteMs: ttfb, maxLoadTimeMs: load, timeoutRetry: retry(1), errorRetry: retry(2) },\n});\n\n/** hls.js settings the player uses; spread under your own. */\nexport const hlsConfig = {\n  manifestLoadPolicy: policy(5_000, 10_000),\n  playlistLoadPolicy: policy(5_000, 10_000),\n  fragLoadPolicy: policy(6_000, 30_000),\n  keyLoadPolicy: policy(5_000, 10_000),\n};\n\n/** Non-fatal network failures (hls.js also tries other renditions) before the player gives up. */\nexport const NETWORK_FAILURES_BEFORE_ERROR = 3;\n\n/** Adaptive-bitrate policy for the player; every field is optional. */\nexport interface AbrPolicy {\n  /** Start at, and never cap the display below, the rung of this short side (px) when bandwidth allows. Default 1080. */\n  minStartHeight?: number;\n  /** Never pick a rung with a larger short side (px). Default unlimited. */\n  maxHeight?: number;\n  /** false: stock hls.js start (500 kbps guess) and a strict display cap. Default true. */\n  preferHighRes?: boolean;\n  /** Bits/s assumed when neither a measurement nor `navigator.connection` is available. Default 8 Mbps. */\n  defaultEstimate?: number;\n}\n\n/** A rendition as hls.js levels describe it. */\nexport interface Rung {\n  width: number;\n  height: number;\n  /** Peak bits/s (BANDWIDTH). */\n  bitrate: number;\n  /** AVERAGE-BANDWIDTH when known. */\n  averageBitrate?: number;\n}\n\n/** What the browser says about the connection (Network Information API). */\nexport interface ConnectionHint {\n  downlink?: number;\n  saveData?: boolean;\n}\n\nexport const ABR_DEFAULTS = { minStartHeight: 1080, maxHeight: Infinity, preferHighRes: true, defaultEstimate: 8_000_000 } as const;\nconst STOCK_ESTIMATE = 500_000;\n// Start below the estimate: the first segment also pays for TTFB and decoder startup.\nconst START_FACTOR = 0.75;\n\n// A rung within 10% of the display is sharp enough (a DPR-3 phone's 1170 px vs 1080p).\nconst UPSCALE = 1.1;\n\nconst short = (r: Rung) => Math.min(r.width, r.height) || r.height || r.width;\n\nfunction resolve(p: AbrPolicy | undefined) {\n  return { ...ABR_DEFAULTS, ...Object.fromEntries(Object.entries(p ?? {}).filter(([, v]) => v !== undefined)) } as Required<AbrPolicy>;\n}\n\n/**\n * The highest rung index (rungs ascend by bitrate) worth loading for a display\n * of width×height device pixels: the smallest rung covering the video's fitted\n * box (to within 10%), never below the minStartHeight rung, never above maxHeight.\n */\nexport function capRung(rungs: readonly Rung[], width: number, height: number, policy?: AbrPolicy): number {\n  const p = resolve(policy);\n  const n = rungs.length;\n  if (!n) return -1;\n  let cap = n - 1;\n  if (width > 0 && height > 0) {\n    for (let i = 0; i < n; i++) {\n      const r = rungs[i]!;\n      const scale = r.width && r.height ? Math.min(width / r.width, height / r.height) : 1;\n      if (scale <= UPSCALE) {\n        cap = i;\n        break;\n      }\n    }\n  }\n  if (p.preferHighRes) {\n    const floor = rungs.findIndex((r) => short(r) >= p.minStartHeight);\n    cap = Math.max(cap, floor === -1 ? n - 1 : floor);\n  }\n  while (cap > 0 && short(rungs[cap]!) > p.maxHeight) cap--;\n  return cap;\n}\n\n/**\n * Levels to remove (indices, descending) so one codec set remains: the set of\n * the level hls.js lists first, which is the master playlist's first playable\n * codec (AV1 or HEVC before H.264 when the browser decodes them). hls.js never\n * switches codec sets for bandwidth, and the quality menu lists each rung once.\n */\nexport function otherCodecLevels(levels: readonly { codecSet?: string }[], first: number): number[] {\n  const keep = (levels[first] ?? levels[0])?.codecSet;\n  return levels.flatMap((l, i) => (l.codecSet === keep ? [] : [i])).reverse();\n}\n\n/** Bits/s to seed the estimator with: a measurement from this page, the browser's downlink, else the policy default. */\nexport function initialEstimate(policy?: AbrPolicy, conn?: ConnectionHint | null, measured?: number): number {\n  const p = resolve(policy);\n  if (conn?.saveData) return STOCK_ESTIMATE;\n  if (measured && measured > 0) return measured;\n  if (conn?.downlink && conn.downlink > 0) return conn.downlink * 1_000_000;\n  return p.preferHighRes ? p.defaultEstimate : STOCK_ESTIMATE;\n}\n\n/** The first rung to load: the lowest under Save-Data, else the highest under cap the estimate sustains. */\nexport function startRung(rungs: readonly Rung[], estimate: number, cap: number, conn?: ConnectionHint | null): number {\n  if (!rungs.length) return -1;\n  if (conn?.saveData) return 0;\n  let start = 0;\n  for (let i = 0; i <= Math.min(cap, rungs.length - 1); i++) {\n    const r = rungs[i]!;\n    if ((r.averageBitrate || r.bitrate) <= estimate * START_FACTOR) start = i;\n  }\n  return start;\n}\n\n/** hls.js ABR settings: climb after a couple of good segments, drop before the buffer runs dry. */\nexport function abrHlsConfig(policy: AbrPolicy | undefined, estimate: number) {\n  const p = resolve(policy);\n  return {\n    abrEwmaDefaultEstimate: estimate,\n    abrEwmaDefaultEstimateMax: Math.max(estimate, 5_000_000),\n    abrEwmaFastVoD: p.preferHighRes ? 2 : 3,\n    abrEwmaSlowVoD: p.preferHighRes ? 6 : 9,\n    abrBandWidthUpFactor: p.preferHighRes ? 0.8 : 0.7,\n    abrBandWidthFactor: 0.9,\n    capLevelToPlayerSize: true,\n    ignoreDevicePixelRatio: false,\n    maxBufferLength: 30,\n    maxMaxBufferLength: 120,\n    backBufferLength: 30,\n  };\n}\n"],"mappings":"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"}

package/dist/client/player.d.ts

@@ -0,0 +1,102 @@
+/** What a key does to the player. */
+export type PlayerAction = {
+    type: "toggle";
+} | {
+    type: "seekBy";
+    seconds: number;
+}
+/** A fraction of the duration: Home 0, End 1, digit n n/10. */
+ | {
+    type: "seekTo";
+    fraction: number;
+} | {
+    type: "volumeBy";
+    delta: number;
+} | {
+    type: "mute";
+} | {
+    type: "captions";
+} | {
+    type: "fullscreen";
+} | {
+    type: "theater";
+} | {
+    type: "miniPlayer";
+} | {
+    type: "speed";
+    step: 1 | -1;
+};
+export interface KeyLike {
+    key: string;
+    altKey?: boolean;
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+}
+/** Seconds the arrow keys seek; J and L, and a double tap, seek twice as far. */
+export declare const ARROW_SEEK = 5;
+export declare const JUMP_SEEK = 10;
+export declare const VOLUME_STEP = 0.05;
+export declare const PLAYBACK_SPEEDS: readonly [0.25, 0.5, 0.75, 1, 1.25, 1.5, 1.75, 2];
+/**
+ * The shortcut for a key, as on YouTube: Space/K play, ←/→ 5 s, J/L 10 s,
+ * ↑/↓ volume, M mute, C subtitles, F fullscreen, T theater, I mini player,
+ * 0–9 a tenth of the way, Home/End, `<`/`>` (or `,`/`.`) speed. Keys with
+ * Alt, Ctrl or Meta belong to the browser.
+ */
+export declare function playerKeyAction(e: KeyLike): PlayerAction | null;
+/** The next playback speed up or down from rate (a rate off the list snaps to its nearest). */
+export declare function nextSpeed(rate: number, step: 1 | -1): number;
+/**
+ * Where playback starts for a resume point: 0 without one, or when it is in
+ * the last few seconds (the viewer finished; start over).
+ */
+export declare function resumeAt(startAt: number | undefined, duration?: number): number;
+/** One cue of a seek sprite: a tile of the sprite image for [start, end). */
+export interface SpriteCue {
+    start: number;
+    end: number;
+    url: string;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+/** The cues of a sprite.vtt; tile URLs resolve against the cue sheet's. */
+export declare function parseSpriteVtt(text: string, base: string): SpriteCue[];
+/** The cue showing at time t (cues ascend): the last that starts at or before it. */
+export declare function spriteCueAt(cues: readonly SpriteCue[], t: number): SpriteCue | undefined;
+/** A selectable audio or subtitle track. */
+export interface PlayerTrack {
+    index: number;
+    /** The playlist's NAME, else its language. */
+    label: string;
+    /** BCP 47. */
+    lang?: string;
+    forced?: boolean;
+}
+/** The track for a BCP 47 tag: an exact match, else the same primary language; -1 for none. */
+export declare function pickTrack(tracks: readonly {
+    lang?: string;
+}[], lang: string | null | undefined): number;
+/** A playhead sample: wall-clock ms and media seconds. */
+export interface PlaySample {
+    at: number;
+    pos: number;
+}
+/** Seconds actually played between two samples: time that both elapsed and advanced the playhead (a seek adds nothing). */
+export declare function playedBetween(a: PlaySample, b: PlaySample): number;
+export declare const PLAYER_VOLUME_KEY = "ckui.player.volume";
+export declare const PLAYER_TRACKS_KEY = "ckui.player.tracks";
+export interface VolumePrefs {
+    volume: number;
+    muted: boolean;
+}
+/** Audio and subtitle languages the viewer chose; subtitles "off" when they turned them off. */
+export interface TrackPrefs {
+    audio?: string;
+    subtitles?: string;
+}
+export declare function readVolume(key: string | null | undefined): VolumePrefs;
+export declare const writeVolume: (key: string | null | undefined, prefs: Partial<VolumePrefs>) => void;
+export declare function readTrackPrefs(key: string | null | undefined): TrackPrefs;
+export declare const writeTrackPrefs: (key: string | null | undefined, prefs: TrackPrefs) => void;

package/dist/client/player.js

@@ -0,0 +1,155 @@
+var e = .05, t = [
+	.25,
+	.5,
+	.75,
+	1,
+	1.25,
+	1.5,
+	1.75,
+	2
+];
+function n(t) {
+	if (t.altKey || t.ctrlKey || t.metaKey) return null;
+	let n = t.key.length === 1 ? t.key.toLowerCase() : t.key;
+	switch (n) {
+		case " ":
+		case "k": return { type: "toggle" };
+		case "ArrowLeft": return {
+			type: "seekBy",
+			seconds: -5
+		};
+		case "ArrowRight": return {
+			type: "seekBy",
+			seconds: 5
+		};
+		case "j": return {
+			type: "seekBy",
+			seconds: -10
+		};
+		case "l": return {
+			type: "seekBy",
+			seconds: 10
+		};
+		case "ArrowUp": return {
+			type: "volumeBy",
+			delta: e
+		};
+		case "ArrowDown": return {
+			type: "volumeBy",
+			delta: -.05
+		};
+		case "m": return { type: "mute" };
+		case "c": return { type: "captions" };
+		case "f": return { type: "fullscreen" };
+		case "t": return { type: "theater" };
+		case "i": return { type: "miniPlayer" };
+		case "Home": return {
+			type: "seekTo",
+			fraction: 0
+		};
+		case "End": return {
+			type: "seekTo",
+			fraction: 1
+		};
+		case "<":
+		case ",": return {
+			type: "speed",
+			step: -1
+		};
+		case ">":
+		case ".": return {
+			type: "speed",
+			step: 1
+		};
+	}
+	return /^[0-9]$/.test(n) ? {
+		type: "seekTo",
+		fraction: Number(n) / 10
+	} : null;
+}
+function r(e, n) {
+	let r = 0;
+	return t.forEach((n, i) => {
+		Math.abs(n - e) < Math.abs(t[r] - e) && (r = i);
+	}), t[Math.min(t.length - 1, Math.max(0, r + n))];
+}
+function i(e, t) {
+	return !e || !Number.isFinite(e) || e <= 0 || t && t > 0 && e >= t - Math.max(3, t * .02) ? 0 : e;
+}
+function a(e) {
+	return e.trim().split(":").map(Number).reduce((e, t) => e * 60 + t, 0);
+}
+function o(e, t) {
+	let n = [], r = e.split(/\r?\n/);
+	for (let e = 0; e < r.length - 1; e++) {
+		let i = r[e].match(/^\s*([\d:.]+)\s+-->\s+([\d:.]+)/), o = i && r[e + 1].trim().match(/^(\S+)#xywh=(\d+),(\d+),(\d+),(\d+)$/);
+		if (!i || !o) continue;
+		let [s, c, l, u] = o.slice(2).map(Number);
+		n.push({
+			start: a(i[1]),
+			end: a(i[2]),
+			url: new URL(o[1], t).href,
+			x: s,
+			y: c,
+			w: l,
+			h: u
+		});
+	}
+	return n;
+}
+function s(e, t) {
+	let n = 0, r = e.length - 1, i;
+	for (; n <= r;) {
+		let a = n + r >> 1;
+		e[a].start <= t ? (i = e[a], n = a + 1) : r = a - 1;
+	}
+	return i ?? e[0];
+}
+function c(e, t) {
+	if (!t) return -1;
+	let n = t.toLowerCase(), r = e.findIndex((e) => e.lang?.toLowerCase() === n);
+	if (r >= 0) return r;
+	let i = n.split("-")[0];
+	return e.findIndex((e) => e.lang?.toLowerCase().split("-")[0] === i);
+}
+function l(e, t) {
+	return Math.max(0, Math.min((t.at - e.at) / 1e3, t.pos - e.pos));
+}
+var u = "ckui.player.volume", d = "ckui.player.tracks";
+function f(e) {
+	if (!e) return {};
+	try {
+		let t = JSON.parse(globalThis.localStorage?.getItem(e) ?? "{}");
+		return t && typeof t == "object" ? t : {};
+	} catch {
+		return {};
+	}
+}
+function p(e, t) {
+	if (e) try {
+		globalThis.localStorage?.setItem(e, JSON.stringify({
+			...f(e),
+			...t
+		}));
+	} catch {}
+}
+function m(e) {
+	let t = f(e);
+	return {
+		volume: typeof t.volume == "number" && Number.isFinite(t.volume) ? Math.min(1, Math.max(0, t.volume)) : 1,
+		muted: t.muted === !0
+	};
+}
+var h = (e, t) => p(e, t);
+function g(e) {
+	let t = f(e);
+	return {
+		audio: typeof t.audio == "string" ? t.audio : void 0,
+		subtitles: typeof t.subtitles == "string" ? t.subtitles : void 0
+	};
+}
+var _ = (e, t) => p(e, t);
+//#endregion
+export { t as PLAYBACK_SPEEDS, d as PLAYER_TRACKS_KEY, u as PLAYER_VOLUME_KEY, e as VOLUME_STEP, r as nextSpeed, o as parseSpriteVtt, c as pickTrack, l as playedBetween, n as playerKeyAction, g as readTrackPrefs, m as readVolume, i as resumeAt, s as spriteCueAt, _ as writeTrackPrefs, h as writeVolume };
+
+//# sourceMappingURL=player.js.map