cursedbelt 5.7.3 → 5.9.0

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

@@ -1 +1 @@
-{"version":3,"file":"playbackPreferences.d.ts","sourceRoot":"","sources":["../../../src/react/media-gallery/playbackPreferences.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,wDAAwD;AACxD,MAAM,MAAM,mBAAmB;AAC7B,8EAA8E;AAC5E,MAAM;AACR,oCAAoC;GAClC,QAAQ;AACV,sFAAsF;GACpF,MAAM;AACR,wFAAwF;GACtF,KAAK;AACP,2FAA2F;GACzF,SAAS,CAAC;AAEd,eAAO,MAAM,sBAAsB,EAAE,mBAAmB,EAMvD,CAAC;AAEF,oEAAoE;AACpE,eAAO,MAAM,mBAAmB,EAAE,MAAM,CACtC,mBAAmB,EACnB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAmB/C,CAAC;AAIF;;;;;;GAMG;AACH,wBAAgB,eAAe,IAAI,mBAAmB,CASrD;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAMpE;AAID;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,uCAAwC,CAAC;AAEzE,4FAA4F;AAC5F,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAIrC;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAQvC;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAMrD;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAMtC;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAMnD;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAM3C;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAMpD;AAED,uEAAuE;AACvE,eAAO,MAAM,eAAe,GAAI,SAAS,mBAAmB,KAAG,mBAGlD,CAAC;AAEd;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,CAAC;AAI/C,wBAAgB,YAAY,IAAI,eAAe,CAM9C;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAMzD;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAA0C,CAAC;AAEhF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAE/C,2FAA2F;AAC3F,eAAO,MAAM,gBAAgB,sBAAsB,CAAC;AAKpD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAKnE;AAED,uFAAuF;AACvF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAO1E"}
+{"version":3,"file":"playbackPreferences.d.ts","sourceRoot":"","sources":["../../../src/react/media-gallery/playbackPreferences.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAIH,wDAAwD;AACxD,MAAM,MAAM,mBAAmB;AAC7B,8EAA8E;AAC5E,MAAM;AACR,oCAAoC;GAClC,QAAQ;AACV,sFAAsF;GACpF,MAAM;AACR,wFAAwF;GACtF,KAAK;AACP,2FAA2F;GACzF,SAAS,CAAC;AAEd,eAAO,MAAM,sBAAsB,EAAE,mBAAmB,EAMvD,CAAC;AAEF,oEAAoE;AACpE,eAAO,MAAM,mBAAmB,EAAE,MAAM,CACtC,mBAAmB,EACnB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAmB/C,CAAC;AAIF;;;;;;GAMG;AACH,wBAAgB,eAAe,IAAI,mBAAmB,CASrD;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAOpE;AAID;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,uCAAwC,CAAC;AAEzE,4FAA4F;AAC5F,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAIrC;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAQvC;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAOrD;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAMtC;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAOnD;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAM3C;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAOpD;AAED,uEAAuE;AACvE,eAAO,MAAM,eAAe,GAAI,SAAS,mBAAmB,KAAG,mBAGlD,CAAC;AAEd;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,CAAC;AAI/C,wBAAgB,YAAY,IAAI,eAAe,CAM9C;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAOzD;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAA0C,CAAC;AAEhF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAE/C,2FAA2F;AAC3F,eAAO,MAAM,gBAAgB,sBAAsB,CAAC;AAKpD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAKnE;AAED,uFAAuF;AACvF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAK1E;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,aAAa,CAS3F;AAED,6FAA6F;AAC7F,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,KAAG,OACM,CAAC"}

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

@@ -28,6 +28,7 @@
  * The advancing rules live in {@link ./playbackRun}, which is pure and tested; this module
  * is only the value, its labels and its storage.
  */
+import { announcePreference } from './preferenceBus.js';
 export const PLAYBACK_END_BEHAVIORS = [
     'stop',
     'repeat',
@@ -77,6 +78,7 @@ export function readPlaybackEnd() {
 export function writePlaybackEnd(behavior) {
     try {
         globalThis.localStorage?.setItem(STORAGE_KEY, behavior);
+        announcePreference(STORAGE_KEY, behavior);
     }
     catch {
         // A preference that cannot be remembered is still a preference that works this session.
@@ -121,6 +123,7 @@ export function readImageDwell() {
 export function writeImageDwell(seconds) {
     try {
         globalThis.localStorage?.setItem(DWELL_KEY, String(seconds));
+        announcePreference(DWELL_KEY, String(seconds));
     }
     catch {
         // Unremembered is still usable this session.
@@ -150,6 +153,7 @@ export function readPinStage() {
 export function writePinStage(pinned) {
     try {
         globalThis.localStorage?.setItem(PIN_KEY, pinned ? '1' : '0');
+        announcePreference(PIN_KEY, pinned ? '1' : '0');
     }
     catch {
         // Unremembered is still usable this session.
@@ -186,6 +190,7 @@ export function readThumbAutoplay() {
 export function writeThumbAutoplay(on) {
     try {
         globalThis.localStorage?.setItem(THUMB_AUTOPLAY_KEY, on ? '1' : '0');
+        announcePreference(THUMB_AUTOPLAY_KEY, on ? '1' : '0');
     }
     catch {
         // Unremembered is still usable this session.
@@ -205,6 +210,7 @@ export function readViewMode() {
 export function writeViewMode(mode) {
     try {
         globalThis.localStorage?.setItem(VIEW_MODE_KEY, mode);
+        announcePreference(VIEW_MODE_KEY, mode);
     }
     catch {
         // Unremembered is still usable this session.
@@ -245,11 +251,25 @@ export function readSessionVolume(key) {
 }
 /** Remember it for the rest of this PAGE. Never longer — see {@link SessionVolume}. */
 export function writeSessionVolume(key, value) {
-    sessionVolumes.set(key, {
+    const held = writeSessionVolumeSilently(key, value);
+    // Announced for an app that keeps it longer than the page — see `preferenceSync.ts`. This
+    // module still never does; the owner's 09-14 rule holds for every app that does not opt in.
+    announcePreference(key, JSON.stringify(held));
+}
+/**
+ * The same write without the announcement — what `seedPreferences` uses to put a stored level
+ * back, so restoring it is never reported as the person changing it.
+ */
+export function writeSessionVolumeSilently(key, value) {
+    const held = {
         // Clamped here rather than at every call site: this lands on `HTMLMediaElement.volume`,
         // which throws `IndexSizeError` outside 0–1.
         volume: Math.min(1, Math.max(0, value.volume)),
         muted: value.muted,
-    });
+    };
+    sessionVolumes.set(key, held);
+    return { ...held };
 }
+/** Is `key` one of the in-memory session volumes rather than a `localStorage` preference? */
+export const isSessionVolumeKey = (key) => key === STAGE_VOLUME_KEY || key === PLAYER_VOLUME_KEY;
 //# sourceMappingURL=playbackPreferences.js.map

package/dist/react/media-gallery/playbackPreferences.js.map

@@ -1 +1 @@
-{"version":3,"file":"playbackPreferences.js","sourceRoot":"","sources":["../../../src/react/media-gallery/playbackPreferences.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAeH,MAAM,CAAC,MAAM,sBAAsB,GAA0B;IAC3D,MAAM;IACN,QAAQ;IACR,MAAM;IACN,KAAK;IACL,SAAS;CACV,CAAC;AAEF,oEAAoE;AACpE,MAAM,CAAC,MAAM,mBAAmB,GAG5B;IACF,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,oBAAoB,EAAE;IAC3E,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,8BAA8B,EAAE;IACjF,IAAI,EAAE;QACJ,KAAK,EAAE,GAAG;QACV,KAAK,EAAE,WAAW;QAClB,IAAI,EAAE,+DAA+D;KACtE;IACD,GAAG,EAAE;QACH,KAAK,EAAE,GAAG;QACV,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,2DAA2D;KAClE;IACD,OAAO,EAAE;QACP,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,yEAAyE;KAChF;CACF,CAAC;AAEF,MAAM,WAAW,GAAG,mBAAmB,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,UAAU,CAAC,YAAY,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAC7D,OAAO,sBAAsB,CAAC,QAAQ,CAAC,MAA6B,CAAC;YACnE,CAAC,CAAE,MAA8B;YACjC,CAAC,CAAC,MAAM,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC;IAChB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAA6B;IAC5D,IAAI,CAAC;QACH,UAAU,CAAC,YAAY,EAAE,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,wFAAwF;IAC1F,CAAC;AACH,CAAC;AAED,6FAA6F;AAE7F;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAU,CAAC;AAEzE,4FAA4F;AAC5F,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAErC,MAAM,SAAS,GAAG,kBAAkB,CAAC;AAErC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,YAAY,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;QACnE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC;YAAE,OAAO,mBAAmB,CAAC;QACxE,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,mBAAmB,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,IAAI,CAAC;QACH,UAAU,CAAC,YAAY,EAAE,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,6CAA6C;IAC/C,CAAC;AACH,CAAC;AAED,6FAA6F;AAE7F,MAAM,OAAO,GAAG,gBAAgB,CAAC;AAEjC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY;IAC1B,IAAI,CAAC;QACH,OAAO,UAAU,CAAC,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,GAAG,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAe;IAC3C,IAAI,CAAC;QACH,UAAU,CAAC,YAAY,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,6CAA6C;IAC/C,CAAC;AACH,CAAC;AAED,6FAA6F;AAE7F,MAAM,kBAAkB,GAAG,qBAAqB,CAAC;AAEjD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC;QACH,OAAO,UAAU,CAAC,YAAY,EAAE,OAAO,CAAC,kBAAkB,CAAC,KAAK,GAAG,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EAAW;IAC5C,IAAI,CAAC;QACH,UAAU,CAAC,YAAY,EAAE,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,6CAA6C;IAC/C,CAAC;AACH,CAAC;AAED,uEAAuE;AACvE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAA4B,EAAuB,EAAE,CACnF,sBAAsB,CACpB,CAAC,sBAAsB,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,sBAAsB,CAAC,MAAM,CAC9E,IAAI,MAAM,CAAC;AAkBd,MAAM,aAAa,GAAG,gBAAgB,CAAC;AAEvC,MAAM,UAAU,YAAY;IAC1B,IAAI,CAAC;QACH,OAAO,UAAU,CAAC,YAAY,EAAE,OAAO,CAAC,aAAa,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IACxF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC;IAChB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAqB;IACjD,IAAI,CAAC;QACH,UAAU,CAAC,YAAY,EAAE,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,6CAA6C;IAC/C,CAAC;AACH,CAAC;AAsDD;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAkB,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAEhF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC;AAE/C,2FAA2F;AAC3F,MAAM,CAAC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AAEpD,gGAAgG;AAChG,MAAM,cAAc,GAAG,IAAI,GAAG,EAAyB,CAAC;AAExD;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACrC,sFAAsF;IACtF,qFAAqF;IACrF,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACnC,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,KAAoB;IAClE,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE;QACtB,wFAAwF;QACxF,6CAA6C;QAC7C,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAC9C,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"playbackPreferences.js","sourceRoot":"","sources":["../../../src/react/media-gallery/playbackPreferences.ts"],"names":[],"mappings":"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"}

package/dist/react/media-gallery/preferenceBus.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The listener set behind `preferenceSync.ts`, in a module of its own so that the writers
+ * (`playbackPreferences.ts`, `media/stageResize.ts`) and the seeder can both import it
+ * without importing each other. See `preferenceSync.ts` for what it is for.
+ */
+export type PreferenceListener = (key: string, value: string | null) => void;
+/** Hear every preference this package remembers. Returns the unsubscribe. */
+export declare function onPreferenceWrite(listener: PreferenceListener): () => void;
+/** Called by each writer in this package — not part of the public surface. */
+export declare function announcePreference(key: string, value: string | null): void;
+//# sourceMappingURL=preferenceBus.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preferenceBus.d.ts","sourceRoot":"","sources":["../../../src/react/media-gallery/preferenceBus.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;AAI7E,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,IAAI,CAK1E;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAQ1E"}

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

@@ -0,0 +1,20 @@
+const listeners = new Set();
+/** Hear every preference this package remembers. Returns the unsubscribe. */
+export function onPreferenceWrite(listener) {
+    listeners.add(listener);
+    return () => {
+        listeners.delete(listener);
+    };
+}
+/** Called by each writer in this package — not part of the public surface. */
+export function announcePreference(key, value) {
+    for (const listener of listeners) {
+        try {
+            listener(key, value);
+        }
+        catch {
+            // A listener that throws must not take a volume slider down with it.
+        }
+    }
+}
+//# sourceMappingURL=preferenceBus.js.map

package/dist/react/media-gallery/preferenceBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferenceBus.js","sourceRoot":"","sources":["../../../src/react/media-gallery/preferenceBus.ts"],"names":[],"mappings":"AAOA,MAAM,SAAS,GAAG,IAAI,GAAG,EAAsB,CAAC;AAEhD,6EAA6E;AAC7E,MAAM,UAAU,iBAAiB,CAAC,QAA4B;IAC5D,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxB,OAAO,GAAG,EAAE;QACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,KAAoB;IAClE,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,qEAAqE;QACvE,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/react/media-gallery/preferenceSync.d.ts

@@ -0,0 +1,11 @@
+export { onPreferenceWrite, type PreferenceListener } from './preferenceBus.js';
+/**
+ * Put stored values back where this package reads them from, without announcing them.
+ *
+ * A session-volume key goes into page memory (where every player reads its opening level);
+ * everything else goes into `localStorage` under the same key its reader uses. `null`
+ * forgets. Wrapped for the reason every storage access here is — `localStorage` throws in a
+ * sandboxed iframe and Safari's private mode.
+ */
+export declare function seedPreferences(values: Readonly<Record<string, string | null>>): void;
+//# sourceMappingURL=preferenceSync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preferenceSync.d.ts","sourceRoot":"","sources":["../../../src/react/media-gallery/preferenceSync.ts"],"names":[],"mappings":"AA6BA,OAAO,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAEhF;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAoBrF"}

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

@@ -0,0 +1,64 @@
+/**
+ * A viewer preference that follows the PERSON, not the browser — the seam an app opts into.
+ *
+ * Every preference in this package is remembered on one device: `localStorage` for ways of
+ * working (the stage height, preview-all, the end behaviour), page memory for loudness
+ * (`playbackPreferences.ts` → `SessionVolume`). That is the right default for a shared
+ * component, because only the APP knows who is signed in and where it could keep a value.
+ *
+ * Owner, collections, 2026-09-21: *"remember my settings in the db and utilize them when I
+ * sign back in on any device … It should use debouncing for settings that may change a lot."*
+ *
+ * So this module is two verbs and nothing else:
+ *
+ *   · {@link onPreferenceWrite} — every writer in this package announces what it just
+ *     remembered, as `(key, value)`. An app that wants server-side memory listens, filters
+ *     the keys it cares about, and debounces its own writes (a volume slider announces on
+ *     every tick; the debounce is the app's, because the app owns the request).
+ *   · {@link seedPreferences} — the app hands back what it stored, once it knows who is
+ *     signed in, and each value lands in the SAME place the package reads it from. Seeding
+ *     announces nothing, so a restore never echoes back to the server as a change.
+ *
+ * 🔴 An app that never calls either behaves exactly as before — nothing here writes on its
+ * own, and a listener set with no listeners is a loop over nothing.
+ *
+ * Values are strings (or `null` for "forget it"), because that is what the underlying stores
+ * hold; a session volume travels as its JSON, `{"volume":0.4,"muted":false}`.
+ */
+import { isSessionVolumeKey, writeSessionVolumeSilently } from './playbackPreferences.js';
+export { onPreferenceWrite } from './preferenceBus.js';
+/**
+ * Put stored values back where this package reads them from, without announcing them.
+ *
+ * A session-volume key goes into page memory (where every player reads its opening level);
+ * everything else goes into `localStorage` under the same key its reader uses. `null`
+ * forgets. Wrapped for the reason every storage access here is — `localStorage` throws in a
+ * sandboxed iframe and Safari's private mode.
+ */
+export function seedPreferences(values) {
+    for (const [key, value] of Object.entries(values)) {
+        if (isSessionVolumeKey(key)) {
+            if (value === null)
+                continue;
+            try {
+                const parsed = JSON.parse(value);
+                if (typeof parsed.volume === 'number' && typeof parsed.muted === 'boolean')
+                    writeSessionVolumeSilently(key, { volume: parsed.volume, muted: parsed.muted });
+            }
+            catch {
+                // A malformed stored volume is no stored volume.
+            }
+            continue;
+        }
+        try {
+            if (value === null)
+                globalThis.localStorage?.removeItem(key);
+            else
+                globalThis.localStorage?.setItem(key, value);
+        }
+        catch {
+            // Unremembered is still usable this session.
+        }
+    }
+}
+//# sourceMappingURL=preferenceSync.js.map

package/dist/react/media-gallery/preferenceSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferenceSync.js","sourceRoot":"","sources":["../../../src/react/media-gallery/preferenceSync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAE1F,OAAO,EAAE,iBAAiB,EAA2B,MAAM,oBAAoB,CAAC;AAEhF;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,MAA+C;IAC7E,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,IAAI,KAAK,KAAK,IAAI;gBAAE,SAAS;YAC7B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAA0C,CAAC;gBAC1E,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,SAAS;oBACxE,0BAA0B,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YACpF,CAAC;YAAC,MAAM,CAAC;gBACP,iDAAiD;YACnD,CAAC;YACD,SAAS;QACX,CAAC;QACD,IAAI,CAAC;YACH,IAAI,KAAK,KAAK,IAAI;gBAAE,UAAU,CAAC,YAAY,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC;;gBACxD,UAAU,CAAC,YAAY,EAAE,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,6CAA6C;QAC/C,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/styles-areas/filter-rail.css

@@ -18,7 +18,7 @@
  * after an app's responsive variant (task 2124). An app that imports every area gets exactly
  * what `cursedbelt/styles-utilities.css` emits — proved rule by rule in
  * src/stylesAreas.spec.ts, which is also what fails when this file is stale.
- * 32 candidate(s).
+ * 33 candidate(s).
  *
  * Written by scripts/generateAreaStyles.ts (`bun run styles:areas`), which
  * `bun run build` runs. The map of what is in which area, and why the areas are
@@ -30,4 +30,4 @@
 @source inline("opacity-100 outline-2 outline-accent outline-dashed outline-offset-[-2px] pb-1");
 @source inline("place-items-center pointer-coarse:[&_button]:min-h-11 pointer-coarse:[&_button]:min-w-11");
 @source inline("pointer-coarse:[&_button]:size-11 pt-1 self-stretch shadow-[inset_3px_0_0_0_var(--accent)] w-14");
-@source inline("w-56");
+@source inline("w-3 w-56");

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "cursedbelt",
-	"version": "5.7.3",
+	"version": "5.9.0",
 	"license": "ISC",
 	"type": "module",
 	"description": "The React design system of the cursedbelt split — components, styles, theme. cursedbelt-core below it; server tier in cursedbelt-server.",

package/src/react/file-tree/FileTree.spec.tsx

@@ -106,6 +106,25 @@ describe('drawing', () => {
     expect(img.getAttribute('alt')).toBe('');
   });
 
+  test('a turned picture is drawn turned — `thumbnailTransform`', () => {
+    // Owner, collections, 2026-09-21: a video rotated and saved should show that rotation on
+    // its thumbnail too. Absent for every other row, so nothing else changes.
+    const { container } = render(
+      <FileTree
+        nodes={[
+          { id: 'v', name: 'sideways.mov', kind: 'file', thumbnailUrl: '/t/v.jpg' },
+          { id: 'p', name: 'upright.jpg', kind: 'file', thumbnailUrl: '/t/p.jpg' },
+        ]}
+        selectedId={null}
+        onSelect={() => undefined}
+        thumbnailTransform={(node) => (node.id === 'v' ? 'rotate(90deg)' : undefined)}
+      />,
+    );
+    const [turned, plain] = [...container.querySelectorAll('img.cbft-thumb')] as HTMLImageElement[];
+    expect(turned?.style.transform).toBe('rotate(90deg)');
+    expect(plain?.getAttribute('style')).toBeNull();
+  });
+
   test('🔴 a thumbnail that 404s falls back to the type icon, ONCE, and never retries', () => {
     // A derived thumbnail's absence is the normal "not rendered yet" state, not an error —
     // so the honest picture is the type icon, never a broken-image glyph. Re-pointing `src`

package/src/react/file-tree/FileTree.tsx

@@ -543,6 +543,16 @@ export interface FileTreeProps {
   renderTools?: (node: FileTreeNode) => ReactNode;
   /** Leading glyph. Defaults to a folder/file mark. */
   renderIcon?: (node: FileTreeNode) => ReactNode;
+  /**
+   * A CSS transform for a row's thumbnail — how the app says a picture is stored turned.
+   *
+   * Owner, collections, 2026-09-21: *"when I rotate and save a video it should use the same
+   * rotation choice for the thumbnail"*. The grid tile already turns by `orientation`; a row's
+   * glyph showing the same film sideways beside it is one file drawn two ways. A prop rather
+   * than a node field because the node shape is `cursedbelt-core`'s and a turn is a rendering
+   * fact. The glyph is square and `object-fit: cover`, so a turn needs no rescale.
+   */
+  thumbnailTransform?: (node: FileTreeNode) => string | undefined;
   /** Extra content after the name — a lock glyph, a chip. */
   renderAccessory?: (node: FileTreeNode) => ReactNode;
 
@@ -660,10 +670,12 @@ function RowGlyph({
   node,
   open,
   renderIcon,
+  transform,
 }: {
   node: FileTreeNode;
   open: boolean;
   renderIcon?: (node: FileTreeNode) => ReactNode;
+  transform?: string | undefined;
 }): ReactNode {
   const [failed, setFailed] = useState<string | null>(null);
   const icon = renderIcon ? renderIcon(node) : <DefaultIcon node={node} open={open} />;
@@ -687,6 +699,7 @@ function RowGlyph({
       decoding='async'
       draggable={false}
       onError={() => setFailed(src)}
+      {...(transform ? { style: { transform } } : {})}
     />
   );
 }
@@ -729,6 +742,7 @@ export function FileTree({
   onRowMenu,
   renderTools,
   renderIcon,
+  thumbnailTransform,
   renderAccessory,
   onDropExternal,
   acceptsExternalDrag,
@@ -2333,7 +2347,12 @@ export function FileTree({
             twisty with `expandable: false`, which every PINNED copy does.
           */
           <span className='cbft-slot' aria-hidden='true'>
-            <RowGlyph node={node} open={row.expanded} {...(renderIcon ? { renderIcon } : {})} />
+            <RowGlyph
+              node={node}
+              open={row.expanded}
+              {...(renderIcon ? { renderIcon } : {})}
+              transform={thumbnailTransform?.(node)}
+            />
           </span>
         )}
 

package/src/react/filter-rail/FilterRail.spec.tsx

@@ -547,3 +547,48 @@ describe('FilterRail — tree rows', () => {
     expect(container.querySelector('[data-cb-rail-row-depth]')).toBeNull();
   });
 });
+
+/**
+ * 🔴 Owner, 2026-09-24: *"the cb filetree sidebars should allow grabbing their right edge and
+ * dragging to resize them like in vscode."* The drag itself needs layout happy-dom does not
+ * have; the keyboard path runs the same clamp and the same write, so it is what proves the
+ * width moves, is remembered, and resets.
+ */
+describe('FilterRail — resizeKey', () => {
+  afterEach(() => globalThis.localStorage?.clear());
+  const props = { sections: SECTIONS, selected: null, onSelect: () => {}, label: 'Folders' };
+
+  test('absent by default — no handle, the fixed width class', () => {
+    const { container } = render(<FilterRail {...props} />);
+    expect(container.querySelector('[data-cb-rail-resize]')).toBeNull();
+    expect(container.querySelector('nav')?.className).toContain('w-56');
+  });
+
+  test('→ widens it and remembers the width; a double-click puts it back', () => {
+    globalThis.localStorage?.setItem('test:rail', '300');
+    const { container } = render(<FilterRail {...props} resizeKey='test:rail' />);
+    const nav = container.querySelector('nav') as HTMLElement;
+    expect(nav.style.width).toBe('300px');
+    const handle = container.querySelector('[data-cb-rail-resize]') as HTMLElement;
+    fireEvent.keyDown(handle, { key: 'ArrowRight' });
+    expect(nav.style.width).toBe('316px');
+    expect(globalThis.localStorage?.getItem('test:rail')).toBe('316');
+    fireEvent.doubleClick(handle);
+    expect(nav.style.width).toBe('');
+    expect(nav.className).toContain('w-56');
+    expect(globalThis.localStorage?.getItem('test:rail')).toBeNull();
+  });
+
+  test('the width is clamped — it cannot be dragged into a sliver', () => {
+    globalThis.localStorage?.setItem('test:rail', '20');
+    const { container } = render(<FilterRail {...props} resizeKey='test:rail' />);
+    expect((container.querySelector('nav') as HTMLElement).style.width).toBe('160px');
+  });
+
+  test('no handle while collapsed', () => {
+    const { container } = render(
+      <FilterRail {...props} resizeKey='test:rail' collapsed onCollapsedChange={() => {}} />,
+    );
+    expect(container.querySelector('[data-cb-rail-resize]')).toBeNull();
+  });
+});

package/src/react/filter-rail/FilterRail.tsx

@@ -4,6 +4,7 @@ import { ScrollArea } from '../components/ScrollArea.js';
 import { cn } from '../lib/cn.js';
 import { Tooltip } from '../components/Tooltip.js';
 import { TAP_TARGET, TAP_TARGET_ALWAYS, TAP_TARGET_HEIGHT } from '../lib/tapTarget.js';
+import { RailResizeHandle, useRailResize } from './railResize.js';
 
 export interface FilterRailItem {
   /** Stable key, and the value handed to `onSelect`. */
@@ -180,6 +181,12 @@ export interface FilterRailProps {
   footer?: ReactNode;
   /** Expanded width. Default `w-56` (14rem). */
   width?: string;
+  /**
+   * Let the person drag the rail's right edge to resize it, like VS Code's side bar, and
+   * remember the width under this key. Absent: a fixed `width`, exactly as before.
+   * ←/→ nudge it from the keyboard; a double-click puts it back to `width`. See `railWidth.ts`.
+   */
+  resizeKey?: string;
   className?: string;
 }
 
@@ -238,18 +245,26 @@ export function FilterRail({
   header,
   footer,
   width = 'w-56',
+  resizeKey,
   className,
 }: FilterRailProps) {
+  // The drag, the keys, the clamp, the storage and the reset are `railResize.tsx`, shared with
+  // every sidebar that is not a FilterRail (music's LibraryRail).
+  const rail = useRailResize({ resizeKey, label, enabled: !collapsed });
   return (
     <nav
+      ref={rail.railRef}
       aria-label={label}
       data-cb-filter-rail={collapsed ? 'collapsed' : 'expanded'}
       className={cn(
         'flex h-full min-h-0 shrink-0 flex-col border-r border-border bg-surface',
-        collapsed ? 'w-14' : width,
+        collapsed ? 'w-14' : rail.width !== null ? undefined : width,
+        rail.active && 'relative',
         className,
       )}
+      {...(rail.style ? { style: rail.style } : {})}
     >
+      <RailResizeHandle rail={rail} />
       {onCollapsedChange ? (
         <div className={cn('flex flex-none items-center px-2 pt-2', collapsed && 'justify-center')}>
           {!collapsed && <span className='flex-1' />}

package/src/react/filter-rail/index.ts

@@ -4,3 +4,4 @@ export {
   type FilterRailProps,
   type FilterRailSection,
 } from './FilterRail.js';
+export { RailResizeHandle, type RailResize, type UseRailResizeOptions, useRailResize } from './railResize.js';

package/src/react/filter-rail/railResize.spec.tsx

@@ -0,0 +1,92 @@
+import { afterEach, describe, expect, test } from 'bun:test';
+import { cleanup, fireEvent, render } from '@testing-library/react';
+import { RailResizeHandle, useRailResize } from './railResize.js';
+
+afterEach(() => {
+  cleanup();
+  globalThis.localStorage?.clear();
+});
+
+/**
+ * A sidebar that is NOT a FilterRail — music's `LibraryRail` shape: its own element, its own
+ * default width in CSS, the shared handle inside. This is the seam every such rail passes
+ * through, so it is where the gesture is proved.
+ */
+function Sidebar({ resizeKey, enabled }: { resizeKey?: string; enabled?: boolean }) {
+  const rail = useRailResize<HTMLElement>({ resizeKey, label: 'Library', enabled });
+  return (
+    <aside ref={rail.railRef} data-width={rail.width ?? 'default'} style={rail.style} className='relative'>
+      <RailResizeHandle rail={rail} />
+    </aside>
+  );
+}
+
+const parts = (container: HTMLElement) => ({
+  aside: container.querySelector('aside') as HTMLElement,
+  handle: container.querySelector('[data-cb-rail-resize]') as HTMLElement | null,
+});
+
+describe('useRailResize + RailResizeHandle', () => {
+  test('no key — no handle, no width', () => {
+    const { aside, handle } = parts(render(<Sidebar />).container);
+    expect(handle).toBeNull();
+    expect(aside.style.width).toBe('');
+  });
+
+  test('a pointer drag widens by the distance moved and is remembered on release, not before', () => {
+    globalThis.localStorage?.setItem('t:rail', '300');
+    const { aside, handle } = parts(render(<Sidebar resizeKey='t:rail' />).container);
+    expect(aside.style.width).toBe('300px');
+    // happy-dom lays nothing out, so the drag starts from a measured 0 — the delta is the point.
+    fireEvent.pointerDown(handle as HTMLElement, { button: 0, clientX: 100, pointerId: 1 });
+    fireEvent.pointerMove(handle as HTMLElement, { clientX: 350, pointerId: 1 });
+    expect(aside.style.width).toBe('250px');
+    expect(globalThis.localStorage?.getItem('t:rail')).toBe('300');
+    fireEvent.pointerUp(handle as HTMLElement, { clientX: 350, pointerId: 1 });
+    expect(globalThis.localStorage?.getItem('t:rail')).toBe('250');
+    // Released: further moves do nothing.
+    fireEvent.pointerMove(handle as HTMLElement, { clientX: 600, pointerId: 1 });
+    expect(aside.style.width).toBe('250px');
+  });
+
+  test('a drag past either bound stops at it', () => {
+    const { aside, handle } = parts(render(<Sidebar resizeKey='t:rail' />).container);
+    fireEvent.pointerDown(handle as HTMLElement, { button: 0, clientX: 0, pointerId: 1 });
+    fireEvent.pointerMove(handle as HTMLElement, { clientX: 5000, pointerId: 1 });
+    expect(aside.style.width).toBe('640px');
+    fireEvent.pointerMove(handle as HTMLElement, { clientX: 10, pointerId: 1 });
+    expect(aside.style.width).toBe('160px');
+  });
+
+  test('a right-button press is not a drag', () => {
+    const { aside, handle } = parts(render(<Sidebar resizeKey='t:rail' />).container);
+    fireEvent.pointerDown(handle as HTMLElement, { button: 2, clientX: 0, pointerId: 1 });
+    fireEvent.pointerMove(handle as HTMLElement, { clientX: 400, pointerId: 1 });
+    expect(aside.style.width).toBe('');
+  });
+
+  test('←/→ step it (Shift for more), announce it, and a double-click forgets it', () => {
+    globalThis.localStorage?.setItem('t:rail', '300');
+    const { aside, handle } = parts(render(<Sidebar resizeKey='t:rail' />).container);
+    const h = handle as HTMLElement;
+    expect(h.getAttribute('role')).toBe('separator');
+    expect(h.getAttribute('aria-label')).toBe('Resize Library');
+    fireEvent.keyDown(h, { key: 'ArrowLeft' });
+    expect(aside.style.width).toBe('284px');
+    fireEvent.keyDown(h, { key: 'ArrowRight', shiftKey: true });
+    expect(aside.style.width).toBe('348px');
+    expect(h.getAttribute('aria-valuenow')).toBe('348');
+    expect(globalThis.localStorage?.getItem('t:rail')).toBe('348');
+    fireEvent.doubleClick(h);
+    expect(aside.style.width).toBe('');
+    expect(aside.dataset.width).toBe('default');
+    expect(globalThis.localStorage?.getItem('t:rail')).toBeNull();
+  });
+
+  test('disabled (a collapsed rail) — no handle, and the stored width is not applied', () => {
+    globalThis.localStorage?.setItem('t:rail', '300');
+    const { aside, handle } = parts(render(<Sidebar resizeKey='t:rail' enabled={false} />).container);
+    expect(handle).toBeNull();
+    expect(aside.style.width).toBe('');
+  });
+});