cursedbelt 5.97.0 → 5.99.0

package/dist/react/media/videoQuality.js

@@ -0,0 +1,185 @@
+/**
+ * A video's quality choice — YouTube's menu: Auto · Max · each rung — remembered per viewer.
+ *
+ * ── Why the choice exists (forge task 3868, the owner's ruling of 2026-10-28) ─────────────
+ * A ladder's top rung is now the ORIGINAL's own stream wherever the browser can play it
+ * (binary-server's `planLadder`: an `o<height>` rung is a stream copy, no loss). hls.js was
+ * capped to the player's size (`capLevelToPlayerSize`, task 3219 — *"lower bandwidth usage"*),
+ * so a windowed player played 480/720 on any connection, which is the blur the owner kept
+ * seeing. Both wishes stand, so they became two choices instead of one setting:
+ *
+ * | choice | what hls.js does |
+ * |---|---|
+ * | `auto` | adapts to bandwidth, never above what the player can show (the cap ON) |
+ * | `max`  | adapts to bandwidth, up to the original, whatever the player's size (the cap OFF) |
+ * | a height | that rung, fixed — the nearest rung at or below it on a film without it |
+ *
+ * ── 🔴 Remembered as a HEIGHT, never as a level index ──────────────────────────────────
+ * Every film has its own ladder: index 3 is 1080p on one and the 2160 original on the next.
+ * A height means the same thing on every film, and a film whose ladder has no such rung takes
+ * the nearest one below it (`levelIndexFor`) — "1080p" on a 720p film is its 720p, not
+ * nothing.
+ *
+ * ── 🔴 Per VIEWER, so `localStorage` ───────────────────────────────────────────────────
+ * A phone on cellular and the TV want different answers, and a viewer's device is where the
+ * answer belongs; a server-side preference would hand the TV's "Max" to the phone. Every
+ * surface reads the one key, so a choice made in the gallery stage carries into the focus
+ * viewer and the next film.
+ *
+ * ── Native HLS cannot choose ────────────────────────────────────────────────────────────
+ * Safari and every iPhone play the ladder with no library, and a page has no API to pick a
+ * rung there — the browser adapts by itself. The control stays VISIBLE and disabled, with the
+ * reason (`NATIVE_HLS_REASON`), per the fleet's one-UI rule.
+ */
+/** The one key every player reads and writes. */
+export const VIDEO_QUALITY_KEY = 'cb.video-quality';
+export const NATIVE_HLS_REASON = 'This browser plays the stream itself and picks the quality on its own — Safari and iPhone let a page choose nothing';
+export const NO_LADDER_REASON = 'This video has one quality: it is playing the file itself, not a ladder';
+/** The stored string back into a choice. Anything unreadable is `auto`, the safe default. */
+export function parseVideoQuality(raw) {
+    if (raw === 'max')
+        return 'max';
+    const height = Number(raw);
+    return Number.isInteger(height) && height > 0 ? height : 'auto';
+}
+export function serializeVideoQuality(choice) {
+    return typeof choice === 'number' ? String(choice) : choice;
+}
+/** Guarded: storage throws in a private window, and is absent in a worker or on the server. */
+function store() {
+    try {
+        return globalThis.localStorage ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export function readVideoQuality() {
+    try {
+        return parseVideoQuality(store()?.getItem(VIDEO_QUALITY_KEY));
+    }
+    catch {
+        return 'auto';
+    }
+}
+export function writeVideoQuality(choice) {
+    try {
+        store()?.setItem(VIDEO_QUALITY_KEY, serializeVideoQuality(choice));
+    }
+    catch {
+        /* a full or refused store only means the choice lasts this film */
+    }
+}
+/** A rung playlist under an `o<height>/` directory is the original's stream copy. */
+const ORIGINAL_RUNG = /(^|\/)o\d+\/[^/]*$/;
+/** The ladder's rungs, tallest first, one per height. */
+export function rungLevels(levels) {
+    const byHeight = new Map();
+    for (const level of levels) {
+        const height = level.height ?? 0;
+        if (height <= 0)
+            continue;
+        const uri = (level.uri ?? level.url?.[0] ?? '').split('?')[0] ?? '';
+        const original = ORIGINAL_RUNG.test(uri);
+        const had = byHeight.get(height);
+        byHeight.set(height, { height, original: original || (had?.original ?? false) });
+    }
+    return [...byHeight.values()].sort((a, b) => b.height - a.height);
+}
+/**
+ * The hls.js level a choice plays: `-1` (adaptive) for `auto` and `max`, else the rung of that
+ * height — or the tallest below it, or the shortest when every rung is taller.
+ */
+export function levelIndexFor(levels, choice) {
+    if (typeof choice !== 'number' || levels.length === 0)
+        return -1;
+    let best = -1;
+    let shortest = -1;
+    levels.forEach((level, index) => {
+        const height = level.height ?? 0;
+        if (shortest === -1 || height < (levels[shortest]?.height ?? 0))
+            shortest = index;
+        if (height <= choice && (best === -1 || height > (levels[best]?.height ?? 0)))
+            best = index;
+    });
+    return best === -1 ? shortest : best;
+}
+/** A control that can choose nothing, with the reason. */
+export function unavailableQuality(reason) {
+    return { levels: [], choice: readVideoQuality(), playingHeight: null, unavailable: reason, select: writeVideoQuality };
+}
+/** hls.js's event names, as strings, so this module never imports the library. */
+const MANIFEST_PARSED = 'hlsManifestParsed';
+const LEVEL_SWITCHED = 'hlsLevelSwitched';
+/**
+ * Drive `hls` by the viewer's remembered choice, and report it.
+ *
+ * The cap is set before the first fragment (a `max` viewer never loads a capped first rung),
+ * and a fixed rung is applied when the manifest is parsed — the first moment the levels exist.
+ * A later choice switches with `nextLevel`: the next fragment plays the new rung, and what is
+ * already buffered still plays, so changing quality never stalls the picture.
+ *
+ * Returns the unbind. `engine.destroy()` drops the listeners too; the unbind is for a surface
+ * that keeps the engine.
+ */
+export function bindHlsQuality(hls, onChange) {
+    let choice = readVideoQuality();
+    let playingHeight = null;
+    // Read through this: an engine that has not parsed a manifest (or a spec's fake) has none.
+    const levels = () => hls.levels ?? [];
+    hls.capLevelToPlayerSize = choice === 'auto';
+    const emit = () => onChange({
+        levels: rungLevels(levels()),
+        choice,
+        playingHeight,
+        unavailable: levels().length > 1 ? null : NO_LADDER_REASON,
+        select,
+    });
+    const select = (next) => {
+        choice = next;
+        writeVideoQuality(next);
+        hls.capLevelToPlayerSize = next === 'auto';
+        hls.nextLevel = levelIndexFor(levels(), next);
+        emit();
+    };
+    const onParsed = () => {
+        const index = levelIndexFor(levels(), choice);
+        if (index !== -1)
+            hls.currentLevel = index;
+        emit();
+    };
+    const onSwitched = (_event, data) => {
+        const level = typeof data?.level === 'number' ? levels()[data.level] : undefined;
+        playingHeight = level?.height ?? null;
+        emit();
+    };
+    hls.on(MANIFEST_PARSED, onParsed);
+    hls.on(LEVEL_SWITCHED, onSwitched);
+    if (levels().length > 0)
+        emit();
+    return () => {
+        hls.off(MANIFEST_PARSED, onParsed);
+        hls.off(LEVEL_SWITCHED, onSwitched);
+    };
+}
+/** A rung's menu label: `2160p · Original`, `720p`. */
+export function rungLabel(level) {
+    return level.original ? `${level.height}p · Original` : `${level.height}p`;
+}
+export function createVideoQualityStore() {
+    let current = null;
+    const listeners = new Set();
+    return {
+        get: () => current,
+        set: (control) => {
+            current = control;
+            for (const listener of listeners)
+                listener();
+        },
+        subscribe: (listener) => {
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+    };
+}
+//# sourceMappingURL=videoQuality.js.map

package/dist/react/media/videoQuality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"videoQuality.js","sourceRoot":"","sources":["../../../src/react/media/videoQuality.ts"],"names":[],"mappings":"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"}

package/dist/react/media/vidstackQuality.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The quality menu on cursedbelt's Vidstack player (forge task 3868) — kept out of
+ * `VideoPlayer.tsx` so the `./react/media/video-player` subpath exports what it always did.
+ */
+import { type MediaProviderAdapter } from '@vidstack/react';
+import type { DefaultVideoLayoutSlots } from '@vidstack/react/player/layouts/default';
+import { type VideoQualityStore } from './videoQuality.js';
+/**
+ * The viewer's quality choice on Vidstack's hls.js (forge task 3868) — the same choice, read from
+ * the same key, as every `hlsSource.ts` surface (`videoQuality.ts` has what each one means).
+ *
+ * 🔴 Auto is capped at the player's size HERE TOO. Vidstack's hls.js ran with the library's
+ * defaults, so this stage alone fetched the top rung into any size of player; with that rung now
+ * the ORIGINAL (a 4K film's is ~20 Mbps), Auto means the same thing on every surface, and Max is
+ * the one remembered choice that lifts the cap.
+ *
+ * Safari's own HLS (Vidstack's plain `VideoProvider` playing a ladder) and the progressive copy
+ * can choose nothing, and say why.
+ */
+export declare function bindVidstackQuality(provider: MediaProviderAdapter | null, store: VideoQualityStore, ladder: boolean): void;
+/**
+ * Quality beside the settings cog, where YouTube keeps it. It REPLACES Vidstack's own quality
+ * submenu (hidden in `videoPlayer.css`): that one has no Max, remembers nothing, and two menus
+ * choosing one thing would disagree.
+ */
+export declare function qualitySlots(store: VideoQualityStore): DefaultVideoLayoutSlots;
+//# sourceMappingURL=vidstackQuality.d.ts.map

package/dist/react/media/vidstackQuality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vidstackQuality.d.ts","sourceRoot":"","sources":["../../../src/react/media/vidstackQuality.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAiB,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAEtF,OAAO,EAOL,KAAK,iBAAiB,EACvB,MAAM,mBAAmB,CAAC;AAG3B;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,EACrC,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,OAAO,GACd,IAAI,CAcN;AAQD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,uBAAuB,CAG9E"}

package/dist/react/media/vidstackQuality.js

@@ -0,0 +1,51 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * The quality menu on cursedbelt's Vidstack player (forge task 3868) — kept out of
+ * `VideoPlayer.tsx` so the `./react/media/video-player` subpath exports what it always did.
+ */
+import { isHLSProvider } from '@vidstack/react';
+import { useSyncExternalStore } from 'react';
+import { bindHlsQuality, NATIVE_HLS_REASON, NO_LADDER_REASON, readVideoQuality, unavailableQuality, } from './videoQuality.js';
+import { VideoQualitySelect } from './VideoQualitySelect.js';
+/**
+ * The viewer's quality choice on Vidstack's hls.js (forge task 3868) — the same choice, read from
+ * the same key, as every `hlsSource.ts` surface (`videoQuality.ts` has what each one means).
+ *
+ * 🔴 Auto is capped at the player's size HERE TOO. Vidstack's hls.js ran with the library's
+ * defaults, so this stage alone fetched the top rung into any size of player; with that rung now
+ * the ORIGINAL (a 4K film's is ~20 Mbps), Auto means the same thing on every surface, and Max is
+ * the one remembered choice that lifts the cap.
+ *
+ * Safari's own HLS (Vidstack's plain `VideoProvider` playing a ladder) and the progressive copy
+ * can choose nothing, and say why.
+ */
+export function bindVidstackQuality(provider, store, ladder) {
+    if (!provider) {
+        store.set(null);
+        return;
+    }
+    if (isHLSProvider(provider)) {
+        store.set(null);
+        provider.config = { ...provider.config, capLevelToPlayerSize: readVideoQuality() === 'auto' };
+        provider.onInstance((hls) => {
+            bindHlsQuality(hls, store.set);
+        });
+        return;
+    }
+    store.set(unavailableQuality(ladder ? NATIVE_HLS_REASON : NO_LADDER_REASON));
+}
+/** The quality menu in the bar, re-rendered by the store alone — see `VideoQualityStore`. */
+function QualitySlot({ store }) {
+    const control = useSyncExternalStore(store.subscribe, store.get, store.get);
+    return _jsx(VideoQualitySelect, { className: 'cbvp-quality', control: control, fieldStyle: false });
+}
+/**
+ * Quality beside the settings cog, where YouTube keeps it. It REPLACES Vidstack's own quality
+ * submenu (hidden in `videoPlayer.css`): that one has no Max, remembers nothing, and two menus
+ * choosing one thing would disagree.
+ */
+export function qualitySlots(store) {
+    const pair = { beforeSettingsMenu: _jsx(QualitySlot, { store: store }) };
+    return { ...pair, smallLayout: { ...pair }, largeLayout: { ...pair } };
+}
+//# sourceMappingURL=vidstackQuality.js.map

package/dist/react/media/vidstackQuality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vidstackQuality.js","sourceRoot":"","sources":["../../../src/react/media/vidstackQuality.tsx"],"names":[],"mappings":";AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAA6B,MAAM,iBAAiB,CAAC;AAE3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EACL,cAAc,EAEd,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,GAEnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAqC,EACrC,KAAwB,EACxB,MAAe;IAEf,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChB,OAAO;IACT,CAAC;IACD,IAAI,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChB,QAAQ,CAAC,MAAM,GAAG,EAAE,GAAG,QAAQ,CAAC,MAAM,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,KAAK,MAAM,EAAE,CAAC;QAC9F,QAAQ,CAAC,UAAU,CAAC,CAAC,GAAG,EAAE,EAAE;YAC1B,cAAc,CAAC,GAAkC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,6FAA6F;AAC7F,SAAS,WAAW,CAAC,EAAE,KAAK,EAAgC;IAC1D,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5E,OAAO,KAAC,kBAAkB,IAAC,SAAS,EAAC,cAAc,EAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,GAAI,CAAC;AAC9F,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,MAAM,IAAI,GAAG,EAAE,kBAAkB,EAAE,KAAC,WAAW,IAAC,KAAK,EAAE,KAAK,GAAI,EAAE,CAAC;IACnE,OAAO,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,WAAW,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC;AACzE,CAAC"}

package/dist/react/media-gallery/MediaGallery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MediaGallery.d.ts","sourceRoot":"","sources":["../../../src/react/media-gallery/MediaGallery.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"MediaGallery.d.ts","sourceRoot":"","sources":["../../../src/react/media-gallery/MediaGallery.tsx"],"names":[],"mappings":"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"}

package/dist/react/media-gallery/MediaGallery.js

@@ -43,6 +43,9 @@ import { DenseGalleryDetail, DenseGalleryShell } from '../media/DenseGalleryShel
 import { CBGD_BARE_TILE_HEIGHT } from '../media/VirtualMediaGrid.js';
 import { useGalleryReturn } from './galleryReturn.js';
 import { useHlsSource } from '../media/hlsSource.js';
+import { VideoQualitySelect } from '../media/VideoQualitySelect.js';
+import { ImageOriginalToggle } from '../media/ImageOriginalToggle.js';
+import { useImageOriginal } from '../media/useImageOriginal.js';
 import { isRecoverableFault, probeSourceFault, sourceFaultMessage, } from '../media/sourceFault.js';
 import { HoverScrubVideoThumb, useCanHover } from '../media/HoverScrubVideoThumb.js';
 import { isPlayPauseSpace } from '../media/playerSpaceKey.js';
@@ -605,12 +608,12 @@ function useStageVolume(ref) {
  */
 function NativeVideoStage({ hlsUrl, streamUrl, poster, repeat, onEnded, onFault, }) {
     const ref = React.useRef(null);
-    useHlsSource(ref, { hlsUrl, streamUrl }, { ...(onFault ? { onFault } : {}) });
+    const quality = useHlsSource(ref, { hlsUrl, streamUrl }, { ...(onFault ? { onFault } : {}) });
     useStageVolume(ref);
-    return (_jsx("video", { ref: ref, className: 'cbmg-stage-video', poster: poster, controls: true, autoPlay: true, playsInline: true, loop: repeat, 
-        // A looping element never fires `ended`, so passing both would silently disable
-        // auto-advance rather than combining the two. See `VideoPlayerProps.loop`.
-        onEnded: repeat ? undefined : onEnded }));
+    return (_jsxs("div", { className: 'cbmg-stage-native', children: [_jsx("video", { ref: ref, className: 'cbmg-stage-video', poster: poster, controls: true, autoPlay: true, playsInline: true, loop: repeat, 
+                // A looping element never fires `ended`, so passing both would silently disable
+                // auto-advance rather than combining the two. See `VideoPlayerProps.loop`.
+                onEnded: repeat ? undefined : onEnded }), _jsx(VideoQualitySelect, { className: 'cbmg-stage-quality', control: quality })] }));
 }
 /**
  * The stage for a source that ANSWERED — `404`, `410`, a spent `403`, anything that is not
@@ -674,14 +677,43 @@ function NativeVideoSurface({ item, media, streamUrl, repeat, onEnded, reAsk, })
  * title — which reads as the archive being broken. {@link probeSourceFault} is the only way
  * to tell them apart and it runs solely on this path, after the browser has already given up.
  */
-function ImageSurface({ item, url, reAsk, }) {
+function ImageSurface({ item, url, originalUrl, reAsk, }) {
     const { fault, report } = useSourceFault(reAsk);
+    // How wide the picture is DRAWN, and how wide the web copy is — the two numbers that decide
+    // whether the original is needed (`useImageOriginal`). The `<img>` is `contain`ed with max
+    // sizes, so its own box IS the drawn picture.
+    const [drawnWidth, setDrawnWidth] = useState(0);
+    const [webWidth, setWebWidth] = useState(0);
+    const observer = useRef(null);
+    const measure = useCallback((img) => {
+        observer.current?.disconnect();
+        observer.current = null;
+        if (!img || typeof ResizeObserver === 'undefined')
+            return;
+        observer.current = new ResizeObserver(() => setDrawnWidth(img.clientWidth));
+        observer.current.observe(img);
+    }, []);
+    const original = useImageOriginal({
+        src: url,
+        originalSrc: originalUrl,
+        mime: item.mime,
+        name: item.name,
+        drawnWidth,
+        webWidth,
+    });
     if (fault) {
         return _jsx(StageSourceFault, { item: item, category: 'image', fault: fault, subject: 'This picture' });
     }
-    return (_jsx("div", { className: 'cbgd-stage-img', "data-turned": isTurned(item) ? 'true' : undefined, children: _jsx("img", { src: url, alt: item.name, style: orientationStyle(item), onError: () => {
-                void probeSourceFault(url).then(report);
-            } }) }));
+    return (_jsxs("div", { className: 'cbgd-stage-img', "data-turned": isTurned(item) ? 'true' : undefined, children: [_jsx("img", { ref: measure, src: original.src, alt: item.name, style: orientationStyle(item), onLoad: (event) => {
+                    // Only the WEB copy's size is the threshold — the original's is what it is past.
+                    if (original.src === url)
+                        setWebWidth(event.currentTarget.naturalWidth);
+                    setDrawnWidth(event.currentTarget.clientWidth);
+                }, onError: () => {
+                    // The original failing is `useImageOriginal`'s own case (it decodes before the swap);
+                    // a fault here is the web copy's.
+                    void probeSourceFault(original.src).then(report);
+                } }), _jsx(ImageOriginalToggle, { className: 'cbgd-stage-original', control: original.control })] }));
 }
 /** The big stage — the right viewer per category. */
 function GalleryStage({ item, mediaCache, bytesCache, loadBytes, nativeVideoStage, repeat, onEnded, onStep, canStep, fullscreenOnDoubleClick, fillWindow, onFillWindowChange, }) {
@@ -735,7 +767,7 @@ function GalleryStage({ item, mediaCache, bytesCache, loadBytes, nativeVideoStag
             return _jsx(StageLoading, { label: resolving ? 'Loading…' : 'Image unavailable.' });
         // `key`ed on the URL for the reason the video stage is: a new URL — including the one a
         // re-ask mints — is a new attempt and must not inherit the previous one's fault.
-        return _jsx(ImageSurface, { item: item, url: media.url, reAsk: refresh }, media.url);
+        return _jsx(ImageSurface, { item: item, url: media.url, originalUrl: media.originalUrl, reAsk: refresh }, media.url);
     }
     if (category === 'audio') {
         if (!media.url)