cursedbelt 0.0.0

package/dist/react/media/maskRaster.js

@@ -0,0 +1,126 @@
+// Pure software rasterizer + binarizer for the mask. The mask is an alpha plane at the
+// source's NATURAL dimensions, built by folding the model's ORDERED op stack: brush strokes
+// stamp filled discs (paint = 255, erase = 0) along each segment, and regions (auto-select /
+// loaded masks) drop in a whole binary plane (replace / add / subtract). Owning the raster —
+// instead of reading back a display canvas — guarantees:
+//   • the export is EXACTLY width×height (by construction, not by hoping a canvas didn't resize),
+//   • a crisp BINARY result (white = change, black = keep) — softening is the server's job
+//     (task-47 mask_expand/blend), so the mask stays predictable,
+//   • the whole pipeline is testable with no canvas (happy-dom has no 2D context).
+/** Stamp a filled disc of `value` into the alpha plane (clipped to bounds). */
+export function paintDisc(alpha, width, height, cx, cy, radius, value) {
+    if (radius <= 0 || width <= 0 || height <= 0)
+        return;
+    const r2 = radius * radius;
+    const minX = Math.max(0, Math.floor(cx - radius));
+    const maxX = Math.min(width - 1, Math.ceil(cx + radius));
+    const minY = Math.max(0, Math.floor(cy - radius));
+    const maxY = Math.min(height - 1, Math.ceil(cy + radius));
+    for (let y = minY; y <= maxY; y++) {
+        const dy = y - cy;
+        const rowStart = y * width;
+        for (let x = minX; x <= maxX; x++) {
+            const dx = x - cx;
+            if (dx * dx + dy * dy <= r2)
+                alpha[rowStart + x] = value;
+        }
+    }
+}
+/** Stamp discs along a segment so a fast drag leaves a continuous, round-capped stroke. */
+function paintSegment(alpha, width, height, a, b, radius, value) {
+    const steps = Math.max(1, Math.ceil(Math.hypot(b.x - a.x, b.y - a.y))); // ~1px spacing → no gaps
+    for (let i = 0; i <= steps; i++) {
+        const t = i / steps;
+        paintDisc(alpha, width, height, a.x + (b.x - a.x) * t, a.y + (b.y - a.y) * t, radius, value);
+    }
+}
+/** Apply one op onto the running alpha plane (in place). Regions whose dims don't match the
+ *  target are skipped defensively (the painter always produces natural-dim regions). */
+function applyOp(alpha, width, height, op) {
+    if (op.kind === 'stroke') {
+        const value = op.mode === 'erase' ? 0 : 255;
+        const radius = op.size / 2;
+        const pts = op.points;
+        if (pts.length === 1) {
+            paintDisc(alpha, width, height, pts[0].x, pts[0].y, radius, value);
+        }
+        else {
+            for (let i = 1; i < pts.length; i++) {
+                paintSegment(alpha, width, height, pts[i - 1], pts[i], radius, value);
+            }
+        }
+        return;
+    }
+    // region — a whole binary plane merged by mode.
+    if (op.width !== width || op.height !== height || op.mask.length !== width * height)
+        return;
+    const m = op.mask;
+    if (op.mode === 'replace') {
+        for (let i = 0; i < m.length; i++)
+            alpha[i] = m[i] ? 255 : 0;
+    }
+    else if (op.mode === 'add') {
+        for (let i = 0; i < m.length; i++)
+            if (m[i])
+                alpha[i] = 255;
+    }
+    else {
+        for (let i = 0; i < m.length; i++)
+            if (m[i])
+                alpha[i] = 0;
+    }
+}
+/**
+ * Fold the ordered op stack into the natural-dimension alpha plane. Order matters: an erase
+ * stroke only clears what was painted before it, a `replace` region resets the plane, etc. —
+ * exactly mirroring how the painter's overlay is composited, so what you see is what exports.
+ */
+export function rasterizeOps(ops, width, height) {
+    const alpha = new Uint8ClampedArray(width * height);
+    for (const op of ops)
+        applyOp(alpha, width, height, op);
+    return alpha;
+}
+/** Threshold an alpha plane to pure 0/255. Anti-aliased input ≥ threshold becomes 255. */
+export function binarizeAlpha(alpha, threshold = 1) {
+    const out = new Uint8ClampedArray(alpha.length);
+    for (let i = 0; i < alpha.length; i++)
+        out[i] = alpha[i] >= threshold ? 255 : 0;
+    return out;
+}
+/**
+ * Reduce a loaded mask image's RGBA pixels to an alpha plane: a pixel counts as painted
+ * (change) when it is opaque and bright (white = change, per the contract). Lets the
+ * component seed a region from an `initialMask` PNG — or a describe-path mask returned by the
+ * compute host — so it resumes as an editable layer.
+ */
+export function rgbaToAlpha(rgba, threshold = 128) {
+    const out = new Uint8ClampedArray(rgba.length >> 2);
+    for (let i = 0; i < out.length; i++) {
+        const o = i << 2;
+        out[i] = rgba[o + 3] > 0 && rgba[o] >= threshold ? 255 : 0; // mask is grayscale: r === g === b
+    }
+    return out;
+}
+/**
+ * The export pipeline as PURE data: fold ops → binarize → (optional) invert → opaque
+ * black/white RGBA at natural dims. WHITE (255,255,255,255) = change, BLACK (0,0,0,255) =
+ * keep — the exact input task 47's `mask_binary_id` expects. The component wraps this in
+ * `new ImageData(...) → putImageData → toBlob('image/png')`; tests assert on it directly,
+ * so "exported PNG is exactly W×H, white only where selected" is verified without a canvas.
+ */
+export function buildMaskImageData({ ops, width, height, inverted = false, threshold = 1, }) {
+    const binary = binarizeAlpha(rasterizeOps(ops, width, height), threshold);
+    const data = new Uint8ClampedArray(width * height * 4);
+    for (let i = 0; i < binary.length; i++) {
+        const painted = binary[i] === 255;
+        const v = (inverted ? !painted : painted) ? 255 : 0;
+        const o = i << 2;
+        data[o] = v;
+        data[o + 1] = v;
+        data[o + 2] = v;
+        data[o + 3] = 255;
+    }
+    return { data, width, height };
+}
+//# sourceMappingURL=maskRaster.js.map

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

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

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

@@ -0,0 +1,35 @@
+import type { Photo } from 'react-photo-album';
+import type { Slide } from 'yet-another-react-lightbox';
+import { type MediaItem } from '../../core/media';
+/** A photo-album photo carrying its source MediaItem (read back in render + onClick). */
+export interface MediaPhoto extends Photo {
+    item: MediaItem;
+}
+/** YARL video slide (also used for audio) rendered by Vidstack via `render.slide`. */
+export interface MediaVideoSlide {
+    type: 'video';
+    src: string;
+    poster?: string;
+    title?: string;
+    description?: string;
+    item: MediaItem;
+}
+declare module 'yet-another-react-lightbox' {
+    interface SlideTypes {
+        video: MediaVideoSlide;
+    }
+}
+/**
+ * Map an item to a grid photo. Uses the THUMBNAIL url for the grid (cheap to load) and
+ * resolved dimensions (real or per-kind fallback) so the justified/masonry layout has
+ * a valid aspect ratio for every item.
+ */
+export declare function mediaItemToPhoto(item: MediaItem): MediaPhoto;
+export declare function mediaItemsToPhotos(items: readonly MediaItem[]): MediaPhoto[];
+/**
+ * Map an item to a lightbox slide. Images become image slides (full `url`, for zoom);
+ * video AND audio become video slides played by Vidstack, with the thumbnail as poster.
+ */
+export declare function mediaItemToSlide(item: MediaItem): Slide;
+export declare function mediaItemsToSlides(items: readonly MediaItem[]): Slide[];
+//# sourceMappingURL=mediaPhoto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mediaPhoto.d.ts","sourceRoot":"","sources":["../../../src/react/media/mediaPhoto.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,KAAK,SAAS,EAAuB,MAAM,kBAAkB,CAAC;AAEvE,yFAAyF;AACzF,MAAM,WAAW,UAAW,SAAQ,KAAK;IACvC,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,sFAAsF;AACtF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,SAAS,CAAC;CACjB;AAID,OAAO,QAAQ,4BAA4B,CAAC;IAC1C,UAAU,UAAU;QAClB,KAAK,EAAE,eAAe,CAAC;KACxB;CACF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,CAW5D;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,UAAU,EAAE,CAE5E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,KAAK,CAmBvD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,KAAK,EAAE,CAEvE"}

package/dist/react/media/mediaPhoto.js

@@ -0,0 +1,53 @@
+// Pure mappers: MediaItem → react-photo-album `Photo` (grid) and → YARL `Slide`
+// (lightbox). Kept dependency-light (type-only imports of the layout libs, erased at
+// runtime) so the mapping — the part that must stay correct as MediaItem evolves — is
+// unit-tested without rendering anything.
+import { mediaItemDimensions } from '../../core/media';
+/**
+ * Map an item to a grid photo. Uses the THUMBNAIL url for the grid (cheap to load) and
+ * resolved dimensions (real or per-kind fallback) so the justified/masonry layout has
+ * a valid aspect ratio for every item.
+ */
+export function mediaItemToPhoto(item) {
+    const { width, height } = mediaItemDimensions(item);
+    return {
+        key: item.id,
+        src: item.thumbnailUrl ?? item.url,
+        width,
+        height,
+        alt: item.name,
+        title: item.name,
+        item,
+    };
+}
+export function mediaItemsToPhotos(items) {
+    return items.map(mediaItemToPhoto);
+}
+/**
+ * Map an item to a lightbox slide. Images become image slides (full `url`, for zoom);
+ * video AND audio become video slides played by Vidstack, with the thumbnail as poster.
+ */
+export function mediaItemToSlide(item) {
+    if (item.type === 'image') {
+        const { width, height } = mediaItemDimensions(item);
+        return {
+            type: 'image',
+            src: item.url,
+            alt: item.name,
+            title: item.name,
+            width: item.width ?? width,
+            height: item.height ?? height,
+        };
+    }
+    return {
+        type: 'video',
+        src: item.url,
+        poster: item.thumbnailUrl,
+        title: item.name,
+        item,
+    };
+}
+export function mediaItemsToSlides(items) {
+    return items.map(mediaItemToSlide);
+}
+//# sourceMappingURL=mediaPhoto.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mediaPhoto.js","sourceRoot":"","sources":["../../../src/react/media/mediaPhoto.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,qFAAqF;AACrF,sFAAsF;AACtF,0CAA0C;AAI1C,OAAO,EAAkB,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAyBvE;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAe;IAC9C,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACpD,OAAO;QACL,GAAG,EAAE,IAAI,CAAC,EAAE;QACZ,GAAG,EAAE,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,GAAG;QAClC,KAAK;QACL,MAAM;QACN,GAAG,EAAE,IAAI,CAAC,IAAI;QACd,KAAK,EAAE,IAAI,CAAC,IAAI;QAChB,IAAI;KACL,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAA2B;IAC5D,OAAO,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAe;IAC9C,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC1B,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACpD,OAAO;YACL,IAAI,EAAE,OAAO;YACb,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,GAAG,EAAE,IAAI,CAAC,IAAI;YACd,KAAK,EAAE,IAAI,CAAC,IAAI;YAChB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,KAAK;YAC1B,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,MAAM;SAC9B,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,OAAO;QACb,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,MAAM,EAAE,IAAI,CAAC,YAAY;QACzB,KAAK,EAAE,IAAI,CAAC,IAAI;QAChB,IAAI;KACL,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAA2B;IAC5D,OAAO,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACrC,CAAC"}

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

@@ -0,0 +1,146 @@
+import type { ReactNode } from 'react';
+import type { ImageOutputFormat, ImagePipelineSpec, ImageSegmenter, MediaItem, VideoTrimSpec } from '../../core/media';
+/** The toolbar capabilities `<ImageEditor>` exposes; filters the filerobot tabs. */
+export type ImageEditorOperation = 'crop' | 'resize' | 'rotate' | 'flip' | 'filters' | 'remove-bg';
+/**
+ * What a save produces. `client` = the editor's finished canvas as a Blob (the common
+ * path — the app uploads the bytes). `server` = a declarative {@link ImagePipelineSpec}
+ * the app POSTs to its own endpoint so the server re-renders (large images / server
+ * remove-bg). `mask` = a binary mask PNG at the source's natural dimensions (from
+ * `mode='mask'`, which delegates to the {@link MaskPainter}). The mode is chosen by
+ * `mode` + whether `serverPipelineEndpoint` is set.
+ */
+export type ImageEditorResult = {
+    mode: 'client';
+    blob: Blob;
+    format: string;
+} | {
+    mode: 'server';
+    spec: ImagePipelineSpec;
+} | {
+    mode: 'mask';
+    blob: Blob;
+};
+/** The job the editor opens for: `edit` = full filerobot editor; `mask` = the mask painter. */
+export type ImageEditorMode = 'edit' | 'mask';
+export interface ImageEditorProps {
+    /** Image URL to edit. Must be same-origin (or CORS-enabled) or the canvas taints. */
+    src: string;
+    /** Called when the user saves. The app performs the actual upload (auth/ctgr stay app-side). */
+    onSave: (result: ImageEditorResult) => Promise<void> | void;
+    onClose: () => void;
+    /** Controlled open state (default `true` — the app typically mounts on demand). */
+    open?: boolean;
+    /**
+     * The unified "open this image to work on it" mode (default `edit`). `mask` renders the
+     * {@link MaskPainter} instead of the filerobot editor and a save yields a `mask` result
+     * (a natural-dimension binary mask PNG). The painter logic lives in its own component.
+     */
+    mode?: ImageEditorMode;
+    /** Existing mask PNG (same-origin) to resume editing — only used in `mode='mask'`. */
+    initialMask?: string;
+    /**
+     * When set, a save yields a `server` result (an {@link ImagePipelineSpec}) for the app
+     * to POST to this endpoint, instead of a client Blob. The POST + auth are the app's job.
+     */
+    serverPipelineEndpoint?: string;
+    /** Restrict the toolbar to these capabilities (default: all). */
+    allowedOperations?: ImageEditorOperation[];
+    /** Output format for the client blob / server spec (default `png`). */
+    defaultFormat?: ImageOutputFormat;
+    /** Suggested file name (sans extension) for the saved image. */
+    fileName?: string;
+}
+/**
+ * What an `onDescribe` handler hands back so the painter can land a worded-region mask as an
+ * editable layer. Either a same-origin/`data:` mask-PNG URL (loaded + reduced to a plane) or
+ * a ready alpha plane (0/255) at the given dims. `null` = "no match / unavailable" (the
+ * painter degrades to a hint, keeping click/box/hand-paint available).
+ */
+export type MaskRegionResult = {
+    maskUrl: string;
+} | {
+    alpha: Uint8ClampedArray;
+    width: number;
+    height: number;
+};
+export interface MaskPainterProps {
+    /**
+     * Same-origin image URL (`/downloads/:id`). MUST be same-origin — a cross-origin source
+     * taints the canvas and `toBlob()` throws. Never pass a ctgr URL (it base64-mangles bytes).
+     */
+    src: string;
+    /** Optional existing mask PNG (same-origin) to resume editing — seeds the painted region. */
+    initialMask?: string;
+    /**
+     * Receives the exported mask as a PNG `Blob` at the source's NATURAL width×height, binarized
+     * to white (= change) on black (= keep) — the exact input task-47's `mask_binary_id` expects.
+     * The app uploads the bytes via its own binary path (auth/ctgr stay app-side).
+     */
+    onSave: (mask: Blob) => Promise<void> | void;
+    onClose: () => void;
+    /** Controlled open state (default `true` — the app typically mounts on demand). */
+    open?: boolean;
+    /** Brush diameter config, in NATURAL source pixels. */
+    brush?: {
+        defaultSize?: number;
+        minSize?: number;
+        maxSize?: number;
+    };
+    /**
+     * Enables in-browser AUTO-SELECT (task 52): when set, the painter exposes click + box tools
+     * that run this {@link ImageSegmenter} on the source's pixels and land the result as an
+     * EDITABLE mask region (never final — the owner refines or discards). The default
+     * `createRegionSegmenter()` needs no model download; a heavier engine (SAM/MobileSAM) can
+     * implement the same interface. Omit to keep the painter hand-paint-only.
+     */
+    segmenter?: ImageSegmenter;
+    /**
+     * Enables the "describe" auto-select tool (task 52): given the typed phrase, the app returns
+     * a source-dim mask to land as an editable region (server-assisted, e.g. Florence2/SAM on the
+     * compute host). The app owns the network call (auth, compute host); the painter owns the
+     * editable-layer UX. Omit to hide the describe tool.
+     */
+    onDescribe?: (text: string) => Promise<MaskRegionResult | null>;
+}
+export interface VideoTrimmerProps {
+    /** Video URL for in-browser preview/scrubbing. */
+    src: string;
+    name: string;
+    /** Called with the chosen range; the app routes it to its server trim endpoint. */
+    onTrim: (spec: Pick<VideoTrimSpec, 'startSeconds' | 'endSeconds' | 'format' | 'quality'>) => Promise<void> | void;
+    onClose: () => void;
+    open?: boolean;
+    /** Cap the trim selection length. */
+    maxDurationSeconds?: number;
+}
+export type MediaCatalogueLayout = 'masonry' | 'rows' | 'columns';
+export interface MediaCatalogueViewerProps {
+    /** URL-only items — the app pre-resolves/signs `url`/`thumbnailUrl`. */
+    items: MediaItem[];
+    /** Layout algorithm (default `rows`, which is virtualized for large collections). */
+    layout?: MediaCatalogueLayout;
+    onItemSelect?: (item: MediaItem) => void;
+    onItemDelete?: (item: MediaItem) => void;
+    /** Edit affordance — the app opens `<ImageEditor>` / `<VideoTrimmer>`. */
+    onItemEdit?: (item: MediaItem) => void;
+    loading?: boolean;
+    /** Called once when the viewport nears the last item (infinite scroll). */
+    loadMore?: () => void;
+    /** Total available count (drives the "showing N of M" hint + load-more arming). */
+    totalCount?: number;
+    /** Target row height for the `rows` layout (px). */
+    targetRowHeight?: number;
+    /** Column count for `masonry` / `columns` layouts. */
+    columns?: number;
+    /**
+     * Scroll container for the virtualized `rows` layout. Omit for window/page scroll
+     * (the default); pass the app's `ScrollArea` viewport element when the catalogue
+     * lives inside a bounded scroll region so only visible rows mount.
+     */
+    scrollRoot?: HTMLElement | null;
+    className?: string;
+    /** Replacement empty state when there are no items. */
+    emptyState?: ReactNode;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/react/media/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/react/media/types.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,18 @@
+export interface UseIntersectionObserverOptions {
+    /** Called when the target enters view (armed → fires once per (re-)entry). */
+    onIntersect: () => void;
+    /** Only observe while enabled (e.g. there is more to load and not already loading). */
+    enabled?: boolean;
+    /** Root margin — `'200px'` pre-fetches before the sentinel is on screen. */
+    rootMargin?: string;
+    /** Optional explicit scroll root (defaults to the viewport). */
+    root?: Element | null;
+}
+/**
+ * Minimal IntersectionObserver hook for infinite-load sentinels. Returns a ref to put
+ * on a 1px sentinel element after the last item; `onIntersect` fires when it becomes
+ * visible. The observer is torn down + rebuilt when `enabled`/options change, so a
+ * disabled viewer never fires and re-enabling re-arms it.
+ */
+export declare function useIntersectionObserver({ onIntersect, enabled, rootMargin, root, }: UseIntersectionObserverOptions): import("react").RefObject<HTMLDivElement | null>;
+//# sourceMappingURL=useIntersectionObserver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useIntersectionObserver.d.ts","sourceRoot":"","sources":["../../../src/react/media/useIntersectionObserver.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,8BAA8B;IAC7C,8EAA8E;IAC9E,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,uFAAuF;IACvF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,WAAW,EACX,OAAc,EACd,UAAoB,EACpB,IAAW,GACZ,EAAE,8BAA8B,oDAsBhC"}

package/dist/react/media/useIntersectionObserver.js

@@ -0,0 +1,28 @@
+import { useEffect, useRef } from 'react';
+/**
+ * Minimal IntersectionObserver hook for infinite-load sentinels. Returns a ref to put
+ * on a 1px sentinel element after the last item; `onIntersect` fires when it becomes
+ * visible. The observer is torn down + rebuilt when `enabled`/options change, so a
+ * disabled viewer never fires and re-enabling re-arms it.
+ */
+export function useIntersectionObserver({ onIntersect, enabled = true, rootMargin = '200px', root = null, }) {
+    const targetRef = useRef(null);
+    // Keep the latest callback without re-creating the observer each render.
+    const cb = useRef(onIntersect);
+    cb.current = onIntersect;
+    useEffect(() => {
+        const el = targetRef.current;
+        if (!el || !enabled || typeof IntersectionObserver === 'undefined')
+            return;
+        const observer = new IntersectionObserver((entries) => {
+            for (const entry of entries) {
+                if (entry.isIntersecting)
+                    cb.current();
+            }
+        }, { root, rootMargin });
+        observer.observe(el);
+        return () => observer.disconnect();
+    }, [enabled, rootMargin, root]);
+    return targetRef;
+}
+//# sourceMappingURL=useIntersectionObserver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useIntersectionObserver.js","sourceRoot":"","sources":["../../../src/react/media/useIntersectionObserver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAa1C;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,EACtC,WAAW,EACX,OAAO,GAAG,IAAI,EACd,UAAU,GAAG,OAAO,EACpB,IAAI,GAAG,IAAI,GACoB;IAC/B,MAAM,SAAS,GAAG,MAAM,CAAwB,IAAI,CAAC,CAAC;IACtD,yEAAyE;IACzE,MAAM,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IAC/B,EAAE,CAAC,OAAO,GAAG,WAAW,CAAC;IAEzB,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,EAAE,IAAI,CAAC,OAAO,IAAI,OAAO,oBAAoB,KAAK,WAAW;YAAE,OAAO;QAC3E,MAAM,QAAQ,GAAG,IAAI,oBAAoB,CACvC,CAAC,OAAO,EAAE,EAAE;YACV,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,KAAK,CAAC,cAAc;oBAAE,EAAE,CAAC,OAAO,EAAE,CAAC;YACzC,CAAC;QACH,CAAC,EACD,EAAE,IAAI,EAAE,UAAU,EAAE,CACrB,CAAC;QACF,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACrB,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IACrC,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;IAEhC,OAAO,SAAS,CAAC;AACnB,CAAC"}

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

@@ -0,0 +1,14 @@
+export interface VideoThumbnailer {
+    /** A thumbnail data/object URL at `seconds`, or null if unavailable. */
+    thumbnailAt(seconds: number): Promise<string | null>;
+    dispose(): void;
+}
+/**
+ * Build the best available thumbnailer for `src`. Never throws — returns a no-op
+ * thumbnailer if neither path works, so the caller can render a filmstrip when it can
+ * and silently skip it otherwise.
+ */
+export declare function createVideoThumbnailer(src: string, opts?: {
+    width?: number;
+}): Promise<VideoThumbnailer>;
+//# sourceMappingURL=videoThumbnailer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"videoThumbnailer.d.ts","sourceRoot":"","sources":["../../../src/react/media/videoThumbnailer.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACrD,OAAO,IAAI,IAAI,CAAC;CACjB;AA6FD;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAc3B"}

package/dist/react/media/videoThumbnailer.js

@@ -0,0 +1,111 @@
+// Client-side video frame extraction for the trimmer filmstrip. Prefers mediabunny
+// (WebCodecs — frame-accurate, decoupled from a <video>'s seek quirks) and gracefully
+// degrades to a hidden <video> + canvas seek-snapshot when WebCodecs/mediabunny is
+// unavailable (older browsers). Browser-only and best-effort: any failure yields a
+// no-op thumbnailer so the trimmer still works without a filmstrip.
+const NOOP = {
+    thumbnailAt: async () => null,
+    dispose: () => { },
+};
+const hasWebCodecs = () => typeof globalThis !== 'undefined' && 'VideoDecoder' in globalThis;
+async function canvasToUrl(canvas) {
+    if ('toDataURL' in canvas)
+        return canvas.toDataURL('image/jpeg', 0.7);
+    try {
+        const blob = await canvas.convertToBlob({ type: 'image/jpeg', quality: 0.7 });
+        return URL.createObjectURL(blob);
+    }
+    catch {
+        return null;
+    }
+}
+/** mediabunny-backed thumbnailer (WebCodecs). Throws if the source can't be decoded. */
+async function createMediabunnyThumbnailer(src, width) {
+    const { Input, ALL_FORMATS, UrlSource, CanvasSink } = await import('mediabunny');
+    const input = new Input({ source: new UrlSource(src), formats: ALL_FORMATS });
+    const track = await input.getPrimaryVideoTrack();
+    if (!track)
+        throw new Error('no video track');
+    const sink = new CanvasSink(track, { width });
+    const urls = [];
+    return {
+        async thumbnailAt(seconds) {
+            const wrapped = await sink.getCanvas(Math.max(0, seconds));
+            if (!wrapped)
+                return null;
+            const url = await canvasToUrl(wrapped.canvas);
+            if (url?.startsWith('blob:'))
+                urls.push(url);
+            return url;
+        },
+        dispose() {
+            for (const u of urls)
+                URL.revokeObjectURL(u);
+            input.dispose?.();
+        },
+    };
+}
+/** Hidden-<video> fallback: seek then draw the current frame to a canvas. */
+async function createVideoElementThumbnailer(src, width) {
+    const video = document.createElement('video');
+    video.src = src;
+    video.crossOrigin = 'anonymous';
+    video.muted = true;
+    video.preload = 'metadata';
+    video.playsInline = true;
+    await new Promise((resolve, reject) => {
+        video.onloadedmetadata = () => resolve();
+        video.onerror = () => reject(new Error('video metadata failed to load'));
+    });
+    const ratio = video.videoWidth > 0 ? video.videoHeight / video.videoWidth : 9 / 16;
+    const canvas = document.createElement('canvas');
+    canvas.width = width;
+    canvas.height = Math.round(width * ratio);
+    const ctx = canvas.getContext('2d');
+    let chain = Promise.resolve();
+    return {
+        thumbnailAt(seconds) {
+            // Serialize seeks — a <video> handles one seek at a time.
+            const next = chain.then(() => new Promise((resolve) => {
+                if (!ctx)
+                    return resolve(null);
+                const onSeeked = () => {
+                    video.removeEventListener('seeked', onSeeked);
+                    ctx.drawImage(video, 0, 0, canvas.width, canvas.height);
+                    resolve(canvas.toDataURL('image/jpeg', 0.7));
+                };
+                video.addEventListener('seeked', onSeeked);
+                video.currentTime = Math.max(0, seconds);
+            }));
+            chain = next.catch(() => null);
+            return next;
+        },
+        dispose() {
+            video.removeAttribute('src');
+            video.load();
+        },
+    };
+}
+/**
+ * Build the best available thumbnailer for `src`. Never throws — returns a no-op
+ * thumbnailer if neither path works, so the caller can render a filmstrip when it can
+ * and silently skip it otherwise.
+ */
+export async function createVideoThumbnailer(src, opts) {
+    const width = opts?.width ?? 160;
+    if (hasWebCodecs()) {
+        try {
+            return await createMediabunnyThumbnailer(src, width);
+        }
+        catch {
+            // fall through to the <video> path
+        }
+    }
+    try {
+        return await createVideoElementThumbnailer(src, width);
+    }
+    catch {
+        return NOOP;
+    }
+}
+//# sourceMappingURL=videoThumbnailer.js.map

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

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

package/dist/react/nav/Breadcrumbs.d.ts

@@ -0,0 +1,44 @@
+import { type ReactNode } from 'react';
+import { type BreadcrumbItem, type GateFn, type NavCrumb, type NavigationModel } from '../../core/navigation';
+import { type NavNavigationProps } from './navShared';
+export interface BreadcrumbsProps extends NavNavigationProps {
+    /** The navigation model — the ancestor chain is derived from it. */
+    model: NavigationModel;
+    /** Current route path (may carry a `#tab=…` target). */
+    path: string;
+    /** Visibility gate. Default: everything visible. */
+    gate?: GateFn;
+    /** Optional leading crumb (e.g. a Home/root link) prepended to the trail. */
+    homeCrumb?: NavCrumb;
+    /** Separator between crumbs. Default: a chevron. */
+    separator?: ReactNode;
+    className?: string;
+}
+export interface ItemBreadcrumbsProps extends NavNavigationProps {
+    /**
+     * Pre-built crumb list (e.g. from `buildBreadcrumbTrail`). The last item is the
+     * current page (non-interactive); earlier items are clickable ancestor links.
+     */
+    items: BreadcrumbItem[];
+    /** Separator between crumbs. Default: a chevron. */
+    separator?: ReactNode;
+    className?: string;
+}
+/**
+ * A breadcrumb trail built from a flat {@link BreadcrumbItem} array — for consumers
+ * that compute the trail independently (e.g. with a `PARENT_OF` map) rather than
+ * deriving it from a full {@link NavigationModel}. Use {@link Breadcrumbs} instead
+ * when you have a navigation model available; it keeps the trail in sync with the
+ * model automatically. Renders nothing when `items` is empty.
+ */
+export declare function ItemBreadcrumbs({ items, separator, linkComponent, onNavigate, onAfterNavigate, className, }: ItemBreadcrumbsProps): import("react").JSX.Element | null;
+/**
+ * An accessible breadcrumb trail derived from the {@link NavigationModel} (never a
+ * separately-maintained `routeMeta` list): `deriveBreadcrumbTrail(model, path)`. The
+ * last crumb is the current page (`aria-current="page"`, non-link); ancestors are
+ * navigable. On narrow screens, ancestor *labels* collapse to their icons so the
+ * trail stays on one line; the current page keeps its label. Renders nothing when
+ * the path matches no registered destination.
+ */
+export declare function Breadcrumbs({ model, path, gate, homeCrumb, separator, linkComponent, onNavigate, onAfterNavigate, resolveIcon, className, }: BreadcrumbsProps): import("react").JSX.Element | null;
+//# sourceMappingURL=Breadcrumbs.d.ts.map

package/dist/react/nav/Breadcrumbs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Breadcrumbs.d.ts","sourceRoot":"","sources":["../../../src/react/nav/Breadcrumbs.tsx"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EAEL,KAAK,cAAc,EAEnB,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAW,KAAK,kBAAkB,EAAc,MAAM,aAAa,CAAC;AAE3E,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,oEAAoE;IACpE,KAAK,EAAE,eAAe,CAAC;IACvB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,oDAAoD;IACpD,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D;;;OAGG;IACH,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,oDAAoD;IACpD,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,SAAS,EACT,aAAa,EACb,UAAU,EACV,eAAe,EACf,SAAS,GACV,EAAE,oBAAoB,sCAuCtB;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,IAAI,EACJ,IAAmB,EACnB,SAAS,EACT,SAAS,EACT,aAAa,EACb,UAAU,EACV,eAAe,EACf,WAAW,EACX,SAAS,GACV,EAAE,gBAAgB,sCA8DlB"}