cursedbelt 3.0.2 → 4.0.0

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

@@ -21,13 +21,38 @@
  * So the gesture is a hook and the affordances are components, and a third player gets both
  * by calling them rather than by copying eighty lines that drift.
  *
+ * ── 🔴 Both affordances live in a RAIL, below the picture ─────────────────────────────
+ * Owner, `ideas/collections-09-14.md`: *"Fix the drag to resize area to no longer overlap
+ * part of the horizontal play timeline area that shows what part of the video is playing. It
+ * should only be draggable when my mouse pointer is at the bottom right corner of the video
+ * player, just like mac windows for other apps work."*
+ *
+ * So every consumer renders exactly this, directly after the box that holds the picture:
+ *
+ *     <div className='cbmr-rail'>
+ *       <MediaResizeBar {...handle} label='…' />
+ *       <MediaResizeCorner {...handle} label='…' />
+ *     </div>
+ *
+ * and `MediaResize.spec.tsx` fails if a player stops doing so. The rail is a strip of chrome
+ * OUTSIDE the frame — a Mac window's grab zone is the window's own edge, not a patch of its
+ * content — which is what makes "nothing of it overlaps the control bar" a property of the
+ * layout rather than a gutter that has to be tuned against whatever the player draws. The
+ * geometry is proved in `e2e/resize-grip-rail.spec.ts`, in a real browser, at two viewports;
+ * happy-dom computes no layout, so nothing under `bun test` can see it.
+ *
  * ── What each affordance is for ───────────────────────────────────────────────────────
- * · {@link MediaResizeCorner} — the literal ask. Bottom-right of the picture, on top of it,
- *   the same overlay convention the gallery's ⟨ ⟩ step arrows already use inside the same
- *   clipped frame. Visible at rest, because that is the whole point of this pass.
- * · {@link MediaResizeBar} — a full-width edge under the frame. Kept because a corner is a
- *   small target on a phone and because a letterboxed picture's corner is black on a
- *   portrait clip; the bar is always exactly where the bottom edge is.
+ * · {@link MediaResizeCorner} — the literal ask. The rail's bottom-right corner, 64px of
+ *   reach, visible at rest, because that is the whole point of this pass.
+ * · {@link MediaResizeBar} — the rail's full-width edge. 🔴 **Coarse pointers only, and that
+ *   is this pass's second decision.** *"It should only be draggable when my mouse pointer is
+ *   at the bottom right corner"* is a verdict on the bar too: on a desktop there is now one
+ *   drag surface and it is the corner, exactly like a window. The one argument that was ever
+ *   made for keeping the bar beside the corner is about a THUMB — a corner is a small target
+ *   on a phone, and on a portrait clip the picture's corner is empty letterboxing while the
+ *   bottom edge is always where the picture ends — so it survives under `(pointer: coarse)`
+ *   and nowhere else. It is still rendered by both players at every size; `mediaResize.css`
+ *   decides where it is shown, because the input device is a media query and not a prop.
  *
  * Both drive the same {@link useMediaResize} state, so a viewer may render either or both
  * and they can never disagree about how tall it is.
@@ -81,24 +106,31 @@ export interface MediaResizeAffordanceProps extends MediaResizeHandleProps {
     style?: CSSProperties;
 }
 /**
- * The corner grip — *"dragging the corner"*, drawn ON the picture at its bottom-right.
+ * The corner grip — *"dragging the corner"*, at the bottom-right of the rail under the
+ * picture.
  *
- * 🔴 An overlay INSIDE the clipped frame, deliberately, and the earlier note in
- * `DenseGalleryShell` arguing a handle there would be "painted over by a full-bleed video"
- * is superseded by the frame's own ⟨ ⟩ step arrows, which are exactly this: absolutely
- * positioned children of the same box, over arbitrary media, that have always been
- * clickable. Being on the picture is what makes it a CORNER rather than a bar that happens
- * to sit near one.
+ * 🔴 OUTSIDE the clipped frame since 2026-09-16, and the reason is in `mediaResize.css`'s
+ * header: keeping an overlay in that corner clear of a control bar means shortening the
+ * control bar, which costs the timeline the width it was complained about for and works only
+ * on a player this package styles. *"just like mac windows for other apps work"* — a window's
+ * grab zone is its outside corner, not a patch of its content, and the rail is that corner.
  */
 export declare function MediaResizeCorner({ label, className, style, ...handle }: MediaResizeAffordanceProps): import("react").JSX.Element;
 /**
- * The bottom edge — a full-width bar under the frame.
+ * The bottom edge — the rail's full-width bar.
+ *
+ * 🔴 **Shown on coarse pointers only** (`mediaResize.css`), which is the decision this
+ * component's existence turns on and is argued in this file's header: on a desktop the owner
+ * asked for one drag surface, in the corner, and the bar's own stated reason — a corner is a
+ * small target for a thumb, and a letterboxed picture's corner is empty black on a portrait
+ * clip while the bottom edge is always where the picture ends — is entirely about touch. It
+ * is rendered unconditionally so the two players cannot disagree about the markup; where it
+ * is SHOWN is a media query, because the input device is not something a prop can know.
  *
- * Kept alongside the corner because the corner is a small target on a phone, and because a
- * letterboxed picture's corner is empty black on a portrait clip and off the edge of the
- * picture on a wide one; the bottom edge is the one part of the stage whose position does
- * not move with the file. `DESIGN.md` §5 wants a 44px target: the bar is 10px of ink with
- * the rest as invisible padding, so it reads as a hairline and is hit like a button.
+ * `DESIGN.md` §5 wants a 44px target: the bar is 4px of ink with the rest as invisible
+ * padding, so it reads as a hairline and is hit like a button. That padding stays INSIDE the
+ * rail — it used to be pulled back over the picture and the transport with `margin-block:
+ * -11px`, which is one of the overlaps the 2026-09-14 report is about.
  */
 export declare function MediaResizeBar({ label, className, style, ...handle }: MediaResizeAffordanceProps): import("react").JSX.Element;
 //# sourceMappingURL=MediaResize.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"MediaResize.d.ts","sourceRoot":"","sources":["../../../src/react/media/MediaResize.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,IAAI,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAG9E,OAAO,mBAAmB,CAAC;AAU3B,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,yFAAyF;IACzF,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,MAAM,EAAE,sBAAsB,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAC/D,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAC7D,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B;AAMD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAC7B,UAAU,EACV,WAAW,EACX,OAAO,GACR,EAAE,qBAAqB,GAAG,gBAAgB,CAgG1C;AAyBD,MAAM,WAAW,0BAA2B,SAAQ,sBAAsB;IACxE,uFAAuF;IACvF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,KAAuB,EACvB,SAAS,EACT,KAAK,EACL,GAAG,MAAM,EACV,EAAE,0BAA0B,+BAe5B;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,EAC7B,KAAuB,EACvB,SAAS,EACT,KAAK,EACL,GAAG,MAAM,EACV,EAAE,0BAA0B,+BAY5B"}
+{"version":3,"file":"MediaResize.d.ts","sourceRoot":"","sources":["../../../src/react/media/MediaResize.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,IAAI,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAG9E,OAAO,mBAAmB,CAAC;AAU3B,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,yFAAyF;IACzF,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,MAAM,EAAE,sBAAsB,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAC/D,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAC7D,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B;AAMD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAC7B,UAAU,EACV,WAAW,EACX,OAAO,GACR,EAAE,qBAAqB,GAAG,gBAAgB,CAgG1C;AAyBD,MAAM,WAAW,0BAA2B,SAAQ,sBAAsB;IACxE,uFAAuF;IACvF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,KAAuB,EACvB,SAAS,EACT,KAAK,EACL,GAAG,MAAM,EACV,EAAE,0BAA0B,+BAe5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,EAC7B,KAAuB,EACvB,SAAS,EACT,KAAK,EACL,GAAG,MAAM,EACV,EAAE,0BAA0B,+BAY5B"}

package/dist/react/media/MediaResize.js

@@ -116,26 +116,33 @@ function sliderAria(props, label) {
 }
 const TIP = 'Drag to resize the viewer · ↑↓ to nudge · double-click to fit automatically';
 /**
- * The corner grip — *"dragging the corner"*, drawn ON the picture at its bottom-right.
+ * The corner grip — *"dragging the corner"*, at the bottom-right of the rail under the
+ * picture.
  *
- * 🔴 An overlay INSIDE the clipped frame, deliberately, and the earlier note in
- * `DenseGalleryShell` arguing a handle there would be "painted over by a full-bleed video"
- * is superseded by the frame's own ⟨ ⟩ step arrows, which are exactly this: absolutely
- * positioned children of the same box, over arbitrary media, that have always been
- * clickable. Being on the picture is what makes it a CORNER rather than a bar that happens
- * to sit near one.
+ * 🔴 OUTSIDE the clipped frame since 2026-09-16, and the reason is in `mediaResize.css`'s
+ * header: keeping an overlay in that corner clear of a control bar means shortening the
+ * control bar, which costs the timeline the width it was complained about for and works only
+ * on a player this package styles. *"just like mac windows for other apps work"* — a window's
+ * grab zone is its outside corner, not a patch of its content, and the rail is that corner.
  */
 export function MediaResizeCorner({ label = 'Viewer height', className, style, ...handle }) {
     return (_jsx(Tooltip, { content: TIP, children: _jsx("div", { ...sliderAria(handle, label), className: `cbmr-corner${className ? ` ${className}` : ''}`, style: style, children: _jsxs("svg", { "aria-hidden": 'true', viewBox: '0 0 12 12', className: 'cbmr-corner-glyph', children: [_jsx("title", { children: "Resize" }), _jsx("path", { d: 'M11 3 L3 11 M11 7 L7 11' })] }) }) }));
 }
 /**
- * The bottom edge — a full-width bar under the frame.
+ * The bottom edge — the rail's full-width bar.
  *
- * Kept alongside the corner because the corner is a small target on a phone, and because a
- * letterboxed picture's corner is empty black on a portrait clip and off the edge of the
- * picture on a wide one; the bottom edge is the one part of the stage whose position does
- * not move with the file. `DESIGN.md` §5 wants a 44px target: the bar is 10px of ink with
- * the rest as invisible padding, so it reads as a hairline and is hit like a button.
+ * 🔴 **Shown on coarse pointers only** (`mediaResize.css`), which is the decision this
+ * component's existence turns on and is argued in this file's header: on a desktop the owner
+ * asked for one drag surface, in the corner, and the bar's own stated reason — a corner is a
+ * small target for a thumb, and a letterboxed picture's corner is empty black on a portrait
+ * clip while the bottom edge is always where the picture ends — is entirely about touch. It
+ * is rendered unconditionally so the two players cannot disagree about the markup; where it
+ * is SHOWN is a media query, because the input device is not something a prop can know.
+ *
+ * `DESIGN.md` §5 wants a 44px target: the bar is 4px of ink with the rest as invisible
+ * padding, so it reads as a hairline and is hit like a button. That padding stays INSIDE the
+ * rail — it used to be pulled back over the picture and the transport with `margin-block:
+ * -11px`, which is one of the overlaps the 2026-09-14 report is about.
  */
 export function MediaResizeBar({ label = 'Viewer height', className, style, ...handle }) {
     return (_jsx(Tooltip, { content: TIP, children: _jsx("div", { ...sliderAria(handle, label), className: `cbmr-bar${className ? ` ${className}` : ''}`, style: style, children: _jsx("span", { className: 'cbmr-bar-grip', "aria-hidden": 'true' }) }) }));

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

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

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

@@ -0,0 +1,67 @@
+import './videoChapterEditor.css';
+import React from 'react';
+import { type VideoChapter } from './videoChapters';
+/**
+ * Put markers on a video at points in time and NAME them — the dialog.
+ *
+ * ── The owner's ask, 2026-09-15, which is the whole scope ──────────────────────────────
+ * *"allow putting markers on videos at points in time and giving them a title for the section
+ * for knowing what that part of the video is about, like youtube chapters."*
+ *
+ * So this dialog never touches a byte and never queues anything. It produces a
+ * `VideoChapter[]`, hands it to `onSubmit`, and closes — everything about what makes a list
+ * valid is `videoChapters.ts`, shared with the player that draws the dividers, so the strip in
+ * here and the scrub bar out there cannot disagree about where a section starts.
+ *
+ * 🔴 The sibling of `VideoCutEditor`, and deliberately NOT part of it. The two gestures look
+ * identical on a timeline — click a point, do something to it — and have nothing else in
+ * common. A cut is a REQUEST that costs a full re-encode and comes back as a second file
+ * minutes or hours later; a chapter is metadata that applies the moment it is saved and is
+ * free to be wrong. One dialog holding both would mean naming a section and queueing an ffmpeg
+ * job through the same Send button.
+ *
+ * ── Why the name comes BEFORE the mark ────────────────────────────────────────────────
+ * The field is filled first and `◆ Mark here` is disabled until it holds something. The other
+ * order — mark now, name later — is how every list of "Chapter 3" ends up in a video nobody
+ * can navigate: the marker exists, it is already useful enough to leave alone, and the name is
+ * the part that gets skipped. Requiring it up front costs one keystroke's worth of order and
+ * makes an unnamed chapter unreachable rather than merely discouraged.
+ *
+ * ── Keeping it out of the way when it is not in use ───────────────────────────────────
+ * One `InfoHint` for the whole model, the fleet's standard ⓘ — a 16px glyph at rest that
+ * opens on hover, focus or tap. A line of instructions under the player is permanent rent paid
+ * by every visit after the first.
+ */
+export interface VideoChapterEditorProps {
+    /** The clip, as a URL a `<video>` can play. */
+    src: string;
+    /** Shown until the first frame decodes — a black box reads as a broken player. */
+    posterUrl?: string;
+    name?: string;
+    /**
+     * The clip's length, when the app already knows it. The element's own metadata still wins
+     * once it loads: a duration the catalog rounded to the second would put the last chapter's
+     * section a fraction out, and could refuse a mark near the end that is perfectly legal.
+     */
+    durationSeconds?: number | null;
+    /** The sections this video already has. Edited in place; nothing is saved until Save. */
+    chapters?: readonly VideoChapter[];
+    open?: boolean;
+    onClose: () => void;
+    /**
+     * Save the sections. Resolving CLOSES the dialog; rejecting leaves it open with the list
+     * intact, because the alternative is losing several minutes of careful naming to one failed
+     * request.
+     *
+     * An EMPTY list is a legitimate answer — it means "this video has no sections" and is how
+     * every chapter gets removed. Unlike a cut list, there is nothing expensive on the other
+     * side of it to refuse.
+     */
+    onSubmit: (chapters: VideoChapter[]) => void | Promise<void>;
+    /** Wording for the confirm button — apps store this differently. */
+    submitLabel?: string;
+    /** Shown under the list: anything the app wants to say about where these are kept. */
+    note?: React.ReactNode;
+}
+export declare function VideoChapterEditor({ src, posterUrl, name, durationSeconds, chapters: initialChapters, open, onClose, onSubmit, submitLabel, note, }: VideoChapterEditorProps): React.JSX.Element;
+//# sourceMappingURL=VideoChapterEditor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"VideoChapterEditor.d.ts","sourceRoot":"","sources":["../../../src/react/media/VideoChapterEditor.tsx"],"names":[],"mappings":"AAAA,OAAO,0BAA0B,CAAC;AAClC,OAAO,KAAK,MAAM,OAAO,CAAC;AAQ1B,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,uBAAuB;IACtC,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,yFAAyF;IACzF,QAAQ,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IACnC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB;;;;;;;;OAQG;IACH,QAAQ,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sFAAsF;IACtF,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CACxB;AAED,wBAAgB,kBAAkB,CAAC,EACjC,GAAG,EACH,SAAS,EACT,IAAI,EACJ,eAAe,EACf,QAAQ,EAAE,eAAe,EACzB,IAAW,EACX,OAAO,EACP,QAAQ,EACR,WAA6B,EAC7B,IAAI,GACL,EAAE,uBAAuB,qBAiVzB"}

package/dist/react/media/VideoChapterEditor.js

@@ -0,0 +1,148 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import './videoChapterEditor.css';
+import React from 'react';
+import { Bookmark, Trash2 } from 'lucide-react';
+import { cutTimecode } from 'cursedbelt-core/media/video-cuts';
+import { ActionBar } from '../components/ActionBar';
+import { Button } from '../components/Button';
+import { InfoHint } from '../components/InfoHint';
+import { Input } from '../components/Input';
+import { Modal } from '../components/Modal';
+import { chapterProblem, chapterSpans, normalizeChapters, } from './videoChapters';
+export function VideoChapterEditor({ src, posterUrl, name, durationSeconds, chapters: initialChapters, open = true, onClose, onSubmit, submitLabel = 'Save sections', note, }) {
+    const videoRef = React.useRef(null);
+    const [duration, setDuration] = React.useState(durationSeconds && Number.isFinite(durationSeconds) ? durationSeconds : 0);
+    const [playhead, setPlayhead] = React.useState(0);
+    /*
+     * 🔴 Seeded from the prop SORTED but not normalized, and this is the bug that shape avoids:
+     * `normalizeChapters` needs a duration, the duration is frequently unknown at mount (the
+     * element has not read its metadata yet), and with `duration === 0` it returns an empty
+     * list. Normalizing here would therefore wipe every existing chapter of every video whose
+     * length the app did not already know — and since this is initial state, they would never
+     * come back. Normalization happens where a duration is real: on the strip, and on save.
+     */
+    const [chapters, setChapters] = React.useState(() => [...(initialChapters ?? [])].sort((a, b) => a.startSeconds - b.startSeconds));
+    const [draftTitle, setDraftTitle] = React.useState('');
+    const [submitting, setSubmitting] = React.useState(false);
+    const [error, setError] = React.useState(null);
+    const spans = React.useMemo(() => chapterSpans(chapters, duration), [chapters, duration]);
+    /** What Save would send. Also what `isDirty` compares, so the two can never disagree. */
+    const saved = React.useMemo(() => normalizeChapters(chapters, duration), [chapters, duration]);
+    const baseline = React.useMemo(() => JSON.stringify(normalizeChapters(initialChapters ?? [], duration)), [initialChapters, duration]);
+    const isDirty = JSON.stringify(saved) !== baseline;
+    /**
+     * A row whose name has been cleared. It is REPORTED rather than dropped: `normalizeChapters`
+     * would quietly discard it on save, so somebody who emptied a field to retype it and then
+     * pressed Save would be told the save succeeded and lose the marker.
+     */
+    const unnamed = chapters.filter((chapter) => chapter.title.trim().length === 0).length;
+    const pct = React.useCallback((seconds) => (duration > 0 ? Math.min(100, Math.max(0, (seconds / duration) * 100)) : 0), [duration]);
+    const seek = React.useCallback((seconds) => {
+        const video = videoRef.current;
+        if (!video || !Number.isFinite(seconds))
+            return;
+        video.currentTime = Math.max(0, seconds);
+        setPlayhead(Math.max(0, seconds));
+    }, []);
+    /** ◆ — name the section that starts at the playhead. */
+    const markHere = React.useCallback(() => {
+        const draft = { startSeconds: playhead, title: draftTitle };
+        const problem = chapterProblem(draft, chapters, duration);
+        if (problem) {
+            setError(problem);
+            return;
+        }
+        setError(null);
+        setChapters((current) => [...current, { startSeconds: playhead, title: draftTitle.trim() }].sort((a, b) => a.startSeconds - b.startSeconds));
+        setDraftTitle('');
+    }, [playhead, draftTitle, chapters, duration]);
+    /** Rename in place. Keyed by the START, which is unique and does not move when a name does. */
+    const rename = React.useCallback((startSeconds, title) => {
+        setError(null);
+        setChapters((current) => current.map((chapter) => chapter.startSeconds === startSeconds ? { ...chapter, title } : chapter));
+    }, []);
+    const remove = React.useCallback((startSeconds) => {
+        setError(null);
+        setChapters((current) => current.filter((chapter) => chapter.startSeconds !== startSeconds));
+    }, []);
+    /*
+     * `Space` plays, and nothing else is bound — deliberately.
+     *
+     * 🔴 There is no key for "mark here". This dialog's primary control is a TEXT FIELD, which
+     * owns the keyboard the whole time somebody is using it: any letter bound on the container
+     * is a letter that either cannot be typed or fires twice depending on where focus happens to
+     * be. Enter in the field marks, which is the one shortcut that needs no arbitration.
+     *
+     * Bound on the DIALOG, not the window: the gallery has its own ⇧←/⇧→ and Space handling, and
+     * a global listener would keep firing after this closed. `Modal` traps focus, so the dialog
+     * really does have the keystrokes while it is open.
+     */
+    const onKeyDown = (event) => {
+        const target = event.target;
+        if (target && (target.tagName === 'INPUT' || target.tagName === 'TEXTAREA'))
+            return;
+        if (event.key !== ' ')
+            return;
+        event.preventDefault();
+        const video = videoRef.current;
+        if (!video)
+            return;
+        if (video.paused)
+            void video.play().catch(() => undefined);
+        else
+            video.pause();
+    };
+    const submit = async () => {
+        if (unnamed > 0) {
+            setError(unnamed === 1
+                ? 'One section has no name. Name it, or remove it.'
+                : `${unnamed} sections have no name. Name them, or remove them.`);
+            return;
+        }
+        setSubmitting(true);
+        setError(null);
+        try {
+            await onSubmit(saved);
+            onClose();
+        }
+        catch (err) {
+            // 🔴 Left open, with the list intact. A failed request must not cost somebody the
+            // several minutes of scrubbing and naming that produced it.
+            setError(err instanceof Error ? err.message : 'That could not be saved. Nothing was changed.');
+        }
+        finally {
+            setSubmitting(false);
+        }
+    };
+    /** Why `◆ Mark here` is unavailable, as the sentence its tooltip shows. */
+    const markProblem = chapterProblem({ startSeconds: playhead, title: draftTitle }, chapters, duration);
+    const leadPct = spans.length > 0 ? pct(spans[0]?.startSeconds ?? 0) : 0;
+    return (_jsx(Modal, { open: open, onClose: onClose, title: name ? `Sections of ${name}` : 'Video sections', subtitle: 'Mark a point, name the part that starts there \u2014 the player shows them on the scrub bar.', size: 'lg', 
+        // 🔴 The discard guard. This body holds text fields, so a backdrop click without it
+        // throws away every name typed since the dialog opened, with no prompt.
+        isDirty: isDirty, ...(error ? { problem: error } : {}), footer: _jsx(ActionBar, { primary: _jsxs(_Fragment, { children: [_jsx(Button, { variant: 'secondary', onClick: onClose, tooltip: 'Close without saving anything', children: "Cancel" }), _jsx(Button, { onClick: () => void submit(), disabled: submitting || unnamed > 0, tooltip: unnamed > 0
+                            ? 'Every section needs a name before this can be saved'
+                            : 'Save these sections — nothing about the video itself is changed', children: submitting ? 'Saving…' : submitLabel })] }) }), children: _jsxs("fieldset", { className: 'cbch', onKeyDown: onKeyDown, "aria-label": 'Name the sections of this video. Type a name, then mark the point it starts at. Space plays and pauses.', children: [_jsx("video", { ref: videoRef, className: 'cbch-video', src: src, poster: posterUrl, controls: true, playsInline: true, preload: 'metadata', onLoadedMetadata: (event) => {
+                        const seen = event.currentTarget.duration;
+                        // The element's own metadata wins over anything the catalog rounded.
+                        if (Number.isFinite(seen) && seen > 0)
+                            setDuration(seen);
+                    }, onTimeUpdate: (event) => setPlayhead(event.currentTarget.currentTime), onSeeked: (event) => setPlayhead(event.currentTarget.currentTime) }), _jsxs("div", { className: 'cbch-add', children: [_jsx("div", { className: 'cbch-add-field', children: _jsx(Input, { value: draftTitle, onChange: (event) => {
+                                    setDraftTitle(event.currentTarget.value);
+                                    setError(null);
+                                }, onEnter: markHere, "aria-label": 'What this part of the video is about', placeholder: 'What is this part about?' }) }), _jsx(Button, { size: 'sm', variant: 'secondary', onClick: markHere, disabled: markProblem !== null, leftIcon: _jsx(Bookmark, { "aria-hidden": 'true', size: 14 }), tooltip: markProblem ?? `Start a section called "${draftTitle.trim()}" here`, children: "Mark here" }), _jsx("span", { className: 'cbch-playhead', children: cutTimecode(playhead) }), _jsxs(InfoHint, { title: 'Naming the parts of a video', align: 'right', children: [_jsxs("p", { children: ["Play or scrub to where a part begins, type what it is about, and press", ' ', _jsx("strong", { children: "Mark here" }), " (or ", _jsx("kbd", { children: "Enter" }), " in the box)."] }), _jsxs("p", { children: ["Each section runs until the next one starts. Click a section's time to jump there, edit a name in place, and ", _jsx("kbd", { children: "Space" }), " plays and pauses."] }), _jsx("p", { children: "Nothing here changes your video \u2014 these are names the player shows on the scrub bar and in its chapters menu." })] })] }), _jsxs("ul", { className: 'cbch-strip', "aria-label": spans.length === 0
+                        ? 'No sections yet — the whole clip is one unnamed part'
+                        : `${spans.length} section${spans.length === 1 ? '' : 's'}`, children: [leadPct > 0 ? (_jsx("li", { className: 'cbch-lead', style: { width: `${leadPct}%` }, "aria-label": 'The opening, which has no section yet' })) : null, spans.map((span) => (_jsx("li", { className: 'cbch-span-item', style: { width: `${pct(span.endSeconds) - pct(span.startSeconds)}%` }, children: _jsx("button", { 
+                                // guardrails-ignore no-raw-action-button: a section of the timeline, sized to
+                                // its own duration — a `Button` carries padding and a min-width, which is
+                                // exactly wrong for a control whose WIDTH is the information.
+                                type: 'button', className: 'cbch-span', "aria-label": `Jump to "${span.title}" at ${cutTimecode(span.startSeconds)}`, onClick: () => seek(span.startSeconds), children: _jsx("span", { className: 'cbch-span-label', children: span.title }) }) }, span.key))), _jsx("span", { className: 'cbch-strip-head', style: { left: `${pct(playhead)}%` } })] }), _jsx("p", { className: 'cbch-summary', children: duration > 0
+                        ? spans.length === 0
+                            ? `${cutTimecode(duration)} of video, in one unnamed part`
+                            : `${spans.length} section${spans.length === 1 ? '' : 's'} across ${cutTimecode(duration)}`
+                        : 'Reading the clip…' }), chapters.length === 0 ? (_jsx("p", { className: 'cbch-empty', children: "No sections yet. Scrub to where a part begins, name it, and mark it." })) : (_jsx("ul", { className: 'cbch-list', children: chapters.map((chapter) => (_jsxs("li", { className: 'cbch-row', children: [_jsxs("button", { 
+                                // guardrails-ignore no-raw-action-button: a plain-CSS row inside a lazily
+                                // imported, deliberately Tailwind-free editor — see `videoCutEditor.css`.
+                                type: 'button', className: 'cbch-row-goto', "aria-label": `Jump to ${cutTimecode(chapter.startSeconds)}`, onClick: () => seek(chapter.startSeconds), children: [_jsx(Bookmark, { "aria-hidden": 'true', size: 12 }), " ", cutTimecode(chapter.startSeconds)] }), _jsx("div", { className: 'cbch-row-title', children: _jsx(Input, { size: 'sm', value: chapter.title, onChange: (event) => rename(chapter.startSeconds, event.currentTarget.value), "aria-label": `Name of the section at ${cutTimecode(chapter.startSeconds)}`, "aria-invalid": chapter.title.trim().length === 0, placeholder: 'Name this section' }) }), _jsx(Button, { size: 'sm', variant: 'ghost', tooltip: 'Remove this section \u2014 the video keeps playing straight through', "aria-label": `Remove the section at ${cutTimecode(chapter.startSeconds)}`, onClick: () => remove(chapter.startSeconds), children: _jsx(Trash2, { "aria-hidden": 'true', size: 14 }) })] }, chapter.startSeconds.toFixed(3)))) })), note ? _jsx("div", { className: 'cbch-note', children: note }) : null] }) }));
+}
+//# sourceMappingURL=VideoChapterEditor.js.map

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

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

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

@@ -5,6 +5,8 @@ import { type MediaPlayerInstance, type MediaProviderAdapter } from '@vidstack/r
 import { type DefaultVideoLayoutSlots } from '@vidstack/react/player/layouts/default';
 import { type RefObject } from 'react';
 import type { PlayableVideo } from 'cursedbelt-core/media';
+import { type SessionVolume } from '../media-gallery/playbackPreferences';
+import { type ChapteredVideo } from './videoChapters';
 /**
  * The reusable video player primitive. Consumes a {@link PlayableVideo} (URLs already
  * resolved by a `cursedbelt-server/storage` source) and renders Vidstack's default layout —
@@ -19,16 +21,36 @@ import type { PlayableVideo } from 'cursedbelt-core/media';
  * `<video>` element safe here — no canvas workaround. Scrub-preview thumbnails come from the
  * source's WebVTT track (`vttUrl`); while derivatives are still being built, a thin progress
  * bar rides the bottom edge of the surface (the original bytes stay playable behind it).
+ *
+ * Named sections (`chapters`) become a real `kind='chapters'` text track, which is what turns
+ * Vidstack's default layout from a bare bar into a YouTube-shaped one — dividers on the time
+ * slider, the current section's name above it, and a chapters menu. See {@link ChaptersTrack}.
  */
 export interface VideoPlayerProps {
-    video: PlayableVideo;
+    /**
+     * The clip, with every URL already resolved — and its named sections, when the app carries
+     * any. {@link ChapteredVideo} is `PlayableVideo` plus `chapters`, so every existing source
+     * still satisfies this unchanged.
+     */
+    video: ChapteredVideo;
     /**
      * Start playing on mount. **Defaults to `true`** — see {@link usePrefersReducedMotion} and
      * the block on {@link AUTOPLAY_DEFAULT}.
      */
     autoPlay?: boolean;
-    /** Start silent. **Defaults to `true` whenever autoplay is in effect** (see below). */
+    /**
+     * Start silent. **Defaults to `true` whenever autoplay is in effect** (see below) — unless
+     * the person has already set a volume on this surface THIS SESSION, which wins over both.
+     */
     muted?: boolean;
+    /**
+     * Where this surface's session volume is kept. Defaults to {@link PLAYER_VOLUME_KEY}.
+     *
+     * 🔴 Pass a different key for a player that is a DIFFERENT surface — the gallery stage
+     * passes `STAGE_VOLUME_KEY` — for the reason `media/stageResize.ts` keys the remembered
+     * height: one shared key makes two viewers on one page fight over a single number.
+     */
+    volumeKey?: string;
     className?: string;
     /**
      * Intrinsic aspect ratio (a CSS `aspect-ratio` value, e.g. `'16/9'` or `'4/3'`). Gives the
@@ -233,21 +255,41 @@ export declare const AUTOPLAY_DEFAULT = true;
  * preference", which is the behavior everything had before this existed.
  */
 /**
- * The autoplay decision, as a pure function so it can be asserted without a browser.
+ * The autoplay decision — and, since 2026-09-16, how loud the clip opens.
  *
  * 🔴 It is extracted rather than inlined because nothing below a real browser can see the
  * difference: `autoPlay` and `muted` are two props on one JSX element, and swapping them,
  * dropping the reduced-motion term, or letting `muted` default independently all typecheck
  * and render identically under happy-dom. The same reasoning `posterFraming.ts` and
  * `mediaGalleryModel.ts` already apply to their own decisions.
+ *
+ * ── 🔴 Where `session` sits in the precedence, and why ──────────────────────────────────
+ * Owner, `ideas/collections-09-14.md`: *"Keep the media player volume where I set it after
+ * changing it during a session except if I refresh or first log in then continue starting it
+ * at mute. Then if I unmute it, keep that value as I change to other videos."*
+ *
+ *   · an explicit `muted` prop still wins — an app that says "silent" means silent
+ *   · then what he set THIS SESSION ({@link readSessionVolume}, `null` until he touches it)
+ *   · then the old rule: muted follows autoPlay, because an unmuted autoplay is refused
+ *
+ * A `null` session is therefore byte-for-byte the behavior every consumer had before this
+ * existed, which is what makes "a refresh starts at mute" true rather than merely intended:
+ * a fresh tab has no session entry, so a fresh tab takes the third line.
+ *
+ * `volume` is returned separately from `muted` on purpose — see {@link SessionVolume}. A mute
+ * stored as `volume: 0` would make the control bar's unmute button return to silence, and
+ * *"if I unmute it, keep that value"* is the sentence that forbids it.
  */
 export declare function resolveAutoplay(opts: {
     autoPlay?: boolean;
     muted?: boolean;
     reducedMotion: boolean;
+    /** What he set this session on this surface, or `null`/absent for "he has not". */
+    session?: SessionVolume | null;
 }): {
     autoPlay: boolean;
     muted: boolean;
+    volume: number;
 };
 /**
  * 🔴 Make the picture follow the scrub bar WHILE it is dragged, not only on release.
@@ -325,7 +367,7 @@ export declare function useLiveScrub(hostRef: RefObject<HTMLElement | null>, pla
  */
 export declare function preferBundledHls(provider: MediaProviderAdapter | null): void;
 export declare function usePrefersReducedMotion(): boolean;
-export declare function VideoPlayer({ video, autoPlay, muted, className, aspectRatio, onEnded, loop, liveScrub, smallLayoutWhen, onStep, canStep, fullscreenOnDoubleClick, }: VideoPlayerProps): import("react").JSX.Element;
+export declare function VideoPlayer({ video, autoPlay, muted, volumeKey, className, aspectRatio, onEnded, loop, liveScrub, smallLayoutWhen, onStep, canStep, fullscreenOnDoubleClick, }: VideoPlayerProps): import("react").JSX.Element;
 /**
  * The processing state for a video surface: a thin progress bar pinned across the bottom edge
  * while derivatives build (indeterminate shimmer until real progress arrives), or a compact

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

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