@delightstack/components 0.1.0

package/dist/media/Video.svelte.d.ts

@@ -0,0 +1,58 @@
+export interface Source {
+    /** URL of the video source */
+    src: string;
+    /** MIME type of the source (e.g. `'video/mp4'`, `'application/x-mpegURL'`) */
+    type: string;
+    /** Vertical resolution of this source (e.g. 720, 1080) — used for the quality menu */
+    size?: number;
+}
+export interface Track {
+    /** The kind of text track */
+    kind: 'captions' | 'subtitles';
+    /** URL of the WebVTT track file */
+    src: string;
+    /** Language code of the track (e.g. `'en'`) */
+    srclang: string;
+    /** Display name of the track in the captions menu */
+    label: string;
+    /** Whether this track is enabled by default */
+    default?: boolean;
+}
+type $$ComponentProps = {
+    src: string | Source[];
+    poster?: string;
+    autoplay?: boolean;
+    muted?: boolean;
+    loop?: boolean;
+    controls?: boolean;
+    aspect_ratio?: string;
+    preload?: 'auto' | 'metadata' | 'none';
+    captions?: Track[];
+    thumbnails?: string;
+    skeleton?: boolean;
+    id?: string;
+    class?: string;
+    element?: HTMLElement | undefined;
+    player?: HTMLVideoElement | undefined;
+    onplay?: () => void;
+    onpause?: () => void;
+    onended?: () => void;
+    ontimeupdate?: (detail: {
+        currentTime: number;
+        duration: number;
+    }) => void;
+    onerror?: (detail: {
+        error: MediaError;
+    }) => void;
+    onenterfullscreen?: () => void;
+    onexitfullscreen?: () => void;
+    onenterpip?: () => void;
+    onexitpip?: () => void;
+    onready?: (detail: {
+        player: HTMLVideoElement;
+    }) => void;
+};
+declare const Video: import("svelte").Component<$$ComponentProps, {}, "element" | "muted" | "player">;
+type Video = ReturnType<typeof Video>;
+export default Video;
+//# sourceMappingURL=Video.svelte.d.ts.map

package/dist/media/Video.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Video.svelte.d.ts","sourceRoot":"","sources":["../../src/media/Video.svelte.ts"],"names":[],"mappings":"AAGC,MAAM,WAAW,MAAM;IACtB,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,KAAK;IACrB,6BAA6B;IAC7B,IAAI,EAAE,UAAU,GAAG,WAAW,CAAC;IAC/B,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAwFD,KAAK,gBAAgB,GAAI;IACxB,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;IACvC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAClC,MAAM,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC3E,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,UAAU,CAAA;KAAE,KAAK,IAAI,CAAC;IAClD,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,gBAAgB,CAAA;KAAE,KAAK,IAAI,CAAC;CACzD,CAAC;AA2wCH,QAAA,MAAM,KAAK,kFAAwC,CAAC;AACpD,KAAK,KAAK,GAAG,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC;AACtC,eAAe,KAAK,CAAC"}

package/dist/media/carousel.d.ts

@@ -0,0 +1,211 @@
+export interface Point {
+    x: number;
+    y: number;
+}
+export interface Pointer {
+    id: string;
+    x: number;
+    y: number;
+    dx: number;
+    dy: number;
+    dt: number;
+    vx: number;
+    vy: number;
+    primary: boolean;
+    time: number;
+}
+export interface Transform {
+    scale: number;
+    rotation: number;
+    translateX: number;
+    translateY: number;
+    originX: number;
+    originY: number;
+}
+/** The options used to fit an element inside the bounds */
+export interface FitParams {
+    /** The scale of the element @default 1 */
+    scale?: number;
+    /** The width of the viewport/container in pixels */
+    viewportW?: number;
+    /** The height of the viewport/container in pixels */
+    viewportH?: number;
+    /** The amount of pixels around the element to pad the bounds by */
+    padding?: number;
+    /** The aspect ratio of the image */
+    ratio?: number;
+}
+export interface ElementAnimationOptions {
+    transform?: string | DOMMatrix;
+    opacity?: number;
+    duration?: number;
+    easing?: 'back-out' | string;
+    id?: string;
+}
+/** The kind of media displayed by the carousel */
+export type CarouselItemType = 'image' | 'video' | 'pdf' | 'embed' | 'custom';
+/**
+ * A media item that can be rendered by the carousel.
+ * Strings are also accepted as a shorthand for an image URL.
+ */
+export interface CarouselItem {
+    /** A stable identifier for the item. If omitted, the src is used. */
+    id?: string;
+    /** The kind of media. @default 'image' */
+    type?: CarouselItemType;
+    /**
+     * The source for the media. For images, accepts either a single URL or
+     * a srcset string with width descriptors:
+     *   src: "https://.../photo.jpg"
+     *   src: "https://.../sm 400w, https://.../lg 1600w"
+     * For videos / pdfs / embeds, always a single URL.
+     */
+    src: string;
+    /** The intrinsic width of the image in pixels (used for aspect ratio before load) */
+    width?: number;
+    /** The intrinsic height of the image in pixels (used for aspect ratio before load) */
+    height?: number;
+    /** Short display label (e.g. file name). Used as the default alt text. */
+    name?: string;
+    /** Longer descriptive caption — shown in the carousel modal (preferred over name). */
+    caption?: string;
+    /** Explicit alt text override. If omitted, falls back to {@link name}. */
+    alt?: string;
+    /**
+     * A base64-encoded [ThumbHash](https://evanw.github.io/thumbhash/) used as
+     * a tiny blurred placeholder while the full image loads. The component
+     * decodes this internally.
+     */
+    thumbhash?: string;
+    /** Whether an image should be rendered as a 360° panorama */
+    panorama?: boolean;
+    /**
+     * URL of a poster/thumbnail image. Used by the Gallery thumbnail grid for
+     * non-image items (video, pdf, embed, custom) where `src` isn't directly
+     * renderable as an `<img>`. Falls back to `src` for images, and to a
+     * derived URL for known providers (YouTube/Vimeo embeds, Cloudinary mp4s)
+     * when omitted.
+     */
+    poster?: string;
+    /**
+     * Mark this item as above-the-fold for faster initial paint. When true,
+     * the image uses `loading="eager"` + `fetchpriority="high"` so the browser
+     * prioritises it. Defaults to lazy loading.
+     */
+    priority?: boolean;
+    /**
+     * Suppress the carousel's horizontal swipe-to-change-slide gesture for this
+     * item. The slide can still be changed via nav buttons, keyboard, or
+     * programmatic API. Useful for `custom` items that need horizontal pointer
+     * input themselves (e.g. a 3D tour, a chart with pan/zoom).
+     */
+    disable_swipe?: boolean;
+    /**
+     * Suppress the carousel's pinch-zoom / double-tap-zoom gesture for this
+     * item. Useful for `custom` items that handle their own zoom or shouldn't
+     * be zoomable at all.
+     */
+    disable_zoom?: boolean;
+}
+/**
+ * The gesture performed by the user on the gallery
+ * - 'pinch-zoom' - the user is panning/zooming the image with two fingers (or panning with one finger while zoomed in)
+ * - 'pan-x' - the user is panning the image horizontally to potentially change the image
+ * - 'pan-y-dismiss' - the user is panning the image vertically to close the gallery
+ * - 'pan-y-page' - the user is panning the pdf vertically to change to a different page
+ * - 'indeterminate' - the action (touch down) has started but we don't know what it is yet
+ * - 'none' - the user is not interacting
+ */
+export type GalleryGesture = 'pinch-zoom' | 'pan-x' | 'pan-y-dismiss' | 'pan-y-page' | 'pinch' | 'indeterminate' | 'none';
+/** Returns the centroid center point between all the given points */
+export declare function center(...points: Point[]): {
+    x: number;
+    y: number;
+};
+/** Returns the distance between two points. Always a positive number */
+export declare function distance(pointA: Point, pointB: Point): number;
+/** Calculates the angle between two points (in radians) */
+export declare function angle(pointA: Point, pointB: Point): number;
+/** Creates a new DOMMatrix based on the transform string. If force3d, it will ensure the matrix is 3d */
+export declare function createMatrix(transform?: string | DOMMatrix, force3d?: boolean): any;
+/** Extracts the x, y, and scale of the given matrix */
+export declare function extractMatrixTransform(matrix: DOMMatrix): {
+    scale: number;
+    x: number;
+    y: number;
+};
+/** Animates the target element to the given transform matrix. Returns a promise that resolves when complete */
+export declare function animateElement(element?: HTMLElement, options?: KeyframeAnimationOptions & ElementAnimationOptions): Promise<void>;
+/** Calculates the transform of the pointers based on their relationship to each other */
+export declare function calcTransform(pointer: Pointer, pointers: {
+    [id: string]: Pointer;
+}, midpoint: Point, prevPointers: {
+    [id: string]: Pointer;
+}, prevMidpoint?: Point): Transform;
+/** Returns the min/max of the x/y position that should be used to ensure the element fits in the bounds */
+export declare function calcBounds(options: FitParams): {
+    minX: number;
+    maxX: number;
+    minY: number;
+    maxY: number;
+};
+/** Calculates the transform matrix that would ensure the image stays in the bounds of the window */
+export declare function clampMatrix(matrix: DOMMatrix, options: FitParams): any;
+/** Returns the deltaX/deltaY of the given wheel event - normalized between devices */
+export declare function normalizeWheel(e: WheelEvent): number[];
+/** Returns whether the given item can be swiped left/right to change slides */
+export declare function isSwipeable(item: CarouselItem | undefined | null): boolean;
+/** Returns whether the given item can be pinched/zoomed */
+export declare function isScalable(item: CarouselItem | undefined | null): boolean;
+/**
+ * Normalizes an embed iframe URL: rewrites known providers (YouTube, Vimeo,
+ * iplayerhd, Matterport) so autoplay/play params reflect whether the iframe is
+ * eagerly loaded. Plain `vimeo.com/<id>` URLs are converted to the canonical
+ * `player.vimeo.com/video/<id>` embed form.
+ */
+export declare function normalizeEmbedSrc(src: string | undefined, eager: boolean): string;
+/**
+ * Returns true if the given URL points to an embed provider whose iframe
+ * renders video-like 16:9 content (YouTube, Vimeo). Used as a styling hint.
+ */
+export declare function isVideoEmbed(src: string | undefined): boolean;
+/**
+ * Returns the best thumbnail URL for an item, in this order:
+ *   1. The explicit `item.poster` field.
+ *   2. For images, the largest src URL.
+ *   3. For known providers, a derived poster (YouTube → img.youtube.com,
+ *      Vimeo → vumbnail.com, Cloudinary `.mp4` → `.jpg`).
+ *   4. Otherwise `undefined` — callers should fall back to a placeholder
+ *      (the Gallery shows a type icon overlay over a styled placeholder block).
+ */
+export declare function getItemThumbnailSrc(item: {
+    type?: CarouselItemType;
+    src?: string;
+    poster?: string;
+    panorama?: boolean;
+}): string | undefined;
+/**
+ * Normalizes any acceptable carousel input (string src, partial item, or a full item)
+ * into a guaranteed CarouselItem. Returns `undefined` for inputs that can't be coerced.
+ */
+export declare function normalizeCarouselItem(input: string | Partial<CarouselItem> | undefined | null): CarouselItem | undefined;
+/**
+ * Returns true if `src` is an actual srcset (multiple URLs with width descriptors),
+ * not just a single URL that happens to contain a comma in its path.
+ */
+export declare function isResponsiveSrcset(src: string | undefined): boolean;
+/**
+ * Returns the highest-width URL from a srcset-style string, or the URL as-is if it's
+ * already a single URL. Used to extract a single `src` for elements that don't accept
+ * srcset (video, iframe, pdf consumers, download links).
+ */
+export declare function pickLargestSrc(src: string | undefined): string;
+export declare function getLoadedResolutions(id: string): number[];
+export declare function addLoadedResolution(id: string, resolution: number): void;
+/**
+ * Decode a base64-encoded ThumbHash into a `data:image/png` URL suitable for
+ * use as an `<img src>` value. Decoded URLs are memoized so repeated renders
+ * of the same item don't pay the decode cost more than once.
+ */
+export declare function decodeThumbHash(base64: string): string;
+//# sourceMappingURL=carousel.d.ts.map

package/dist/media/carousel.d.ts.map

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