@dashforge/tw 1.2.0 → 1.4.0

package/dist/src/components/Image/Image.d.ts

@@ -0,0 +1,27 @@
+import type { ImageProps } from './image.types.js';
+/**
+ * Dashforge TW `<Image>` — a declarative, robust wrapper over the
+ * native `<img>`. Zero eval, no data fetching: it renders a URL you
+ * give it, and adds the three things a bare `<img>` lacks.
+ *
+ *   1. **No layout shift** — pass `aspectRatio` (or `width` + `height`)
+ *      and the box is reserved before the image loads (CSS
+ *      `aspect-ratio`, no JS measurement).
+ *   2. **Loading skeleton** — a `<Skeleton>` fills the reserved box
+ *      while the image loads, and is skipped for already-cached images
+ *      so there is no flash.
+ *   3. **Graceful error** — on load failure a muted fallback replaces
+ *      the broken-image glyph (`fallback` to customise).
+ *
+ * Lazy by default (`loading="lazy"`). Any native `<img>` attribute not
+ * named here (`srcSet`, `sizes`, `decoding`, …) is forwarded to the
+ * underlying element. The ref points at the `<img>`.
+ *
+ * @example
+ * ```tsx
+ * <Image src="/hero.jpg" alt="Team at work" aspectRatio={16 / 9} rounded="lg" />
+ * <Image src={avatarUrl} alt="Jane Doe" width={48} height={48} rounded="full" />
+ * ```
+ */
+export declare const Image: import("react").ForwardRefExoticComponent<ImageProps & import("react").RefAttributes<HTMLImageElement>>;
+//# sourceMappingURL=Image.d.ts.map

package/dist/src/components/Image/Image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Image.d.ts","sourceRoot":"","sources":["../../../../src/components/Image/Image.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AA8BnD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,KAAK,yGAiJjB,CAAC"}

package/dist/src/components/Image/image.types.d.ts

@@ -0,0 +1,126 @@
+import type { ImgHTMLAttributes, ReactNode } from 'react';
+import type { AccessRequirement } from '@dashforge/rbac';
+import type { Engine } from '@dashforge/ui-core';
+import type { ImageVariants } from './image.variants.js';
+/**
+ * Subset of `<Image>` props theme-configurable via
+ * `theme.components.Image.defaults` (Option C).
+ */
+export type ImageVariantProps = Pick<ImageVariants, 'fit' | 'rounded'>;
+declare module '@dashforge/tw-tokens' {
+    interface TWComponentDefaults {
+        Image?: {
+            defaults?: Partial<ImageVariantProps>;
+            slotProps?: ImageSlotProps;
+        };
+    }
+}
+export interface ImageSlotProps {
+    /** Wrapper element override. */
+    root?: {
+        className?: string;
+    };
+    /** `<img>` element override. */
+    img?: {
+        className?: string;
+    };
+    /** Loading-skeleton overlay override. */
+    skeleton?: {
+        className?: string;
+    };
+    /** Error-fallback overlay override. */
+    fallback?: {
+        className?: string;
+    };
+}
+/**
+ * Props for `<Image>`.
+ *
+ * A thin, declarative wrapper over the native `<img>` — zero eval, no
+ * data fetching — with the robustness a native `<img>` lacks:
+ *
+ *  1. **No layout shift.** Give `aspectRatio` (or `width` + `height`)
+ *     and the box is reserved before the image loads (CSS
+ *     `aspect-ratio`, no JS measurement).
+ *  2. **Loading skeleton.** While the image loads, a `<Skeleton>` fills
+ *     the reserved box. It is skipped automatically for already-cached
+ *     images (no flash).
+ *  3. **Graceful error.** On load failure a muted fallback replaces the
+ *     broken-image glyph — pass your own via `fallback`.
+ *  4. **Lazy by default** (`loading="lazy"`).
+ *
+ * Any native `<img>` attribute not listed here (`srcSet`, `sizes`,
+ * `crossOrigin`, `referrerPolicy`, `decoding`, …) is forwarded to the
+ * underlying element.
+ *
+ * Note on privacy: an external `src` is fetched by the browser from
+ * that host (egress). Self-host the asset (same-origin / your CDN) to
+ * keep it inside your boundary.
+ *
+ * @example
+ * ```tsx
+ * <Image src="/hero.jpg" alt="Team at work" aspectRatio={16 / 9} rounded="lg" />
+ * <Image src={avatarUrl} alt="Jane Doe" width={48} height={48} rounded="full" />
+ * <Image src={maybeBroken} alt="Product" aspectRatio={1} fallback={<MyPlaceholder />} />
+ * ```
+ */
+export interface ImageProps extends Omit<ImgHTMLAttributes<HTMLImageElement>, 'src' | 'alt' | 'className'> {
+    /** Image source URL. Same-origin / data: keeps it inside your boundary; an external host is egress. */
+    src: string;
+    /**
+     * Alternative text (accessibility). Describe what the image conveys;
+     * use `alt=""` for purely decorative images so assistive tech skips it.
+     */
+    alt: string;
+    /**
+     * Locks the box shape before load to prevent layout shift — a number
+     * (`16 / 9`, `1`) or a CSS `aspect-ratio` string (`'16 / 9'`). When
+     * set, the image fills the box via `object-fit`.
+     */
+    aspectRatio?: number | string;
+    /**
+     * How the image fills its box — CSS `object-fit`.
+     * @default 'cover'
+     */
+    fit?: ImageVariants['fit'];
+    /**
+     * Corner radius token, clipped via `overflow-hidden`.
+     * @default 'none'
+     */
+    rounded?: ImageVariants['rounded'];
+    /**
+     * Native lazy/eager loading. Lazy defers off-screen images.
+     * @default 'lazy'
+     */
+    loading?: 'lazy' | 'eager';
+    /**
+     * Show a `<Skeleton>` while the image loads. Requires a reserved box
+     * (`aspectRatio`, or both `width` and `height`) — without one there
+     * is no space to paint it, so it is skipped.
+     * @default true
+     */
+    showSkeleton?: boolean;
+    /**
+     * Content shown when the image fails to load. Defaults to a muted
+     * surface with a broken-image glyph.
+     */
+    fallback?: ReactNode;
+    /**
+     * RBAC access requirement. When the current user is unauthorized:
+     * `onUnauthorized: 'hide'` → the image does not render; `'disable'` /
+     * `'readonly'` → it renders dimmed and non-interactive (an image has no
+     * true disabled state). Resolved against the nearest `RbacProvider`.
+     */
+    access?: AccessRequirement;
+    /**
+     * Reactive visibility predicate evaluated against the form engine — the
+     * image renders only when it returns `true` (e.g. show a preview once a
+     * file field has a value). No-op outside a `<DashForm>`.
+     */
+    visibleWhen?: (engine: Engine) => boolean;
+    /** Root-level Tailwind override (wins via `tailwind-merge`). */
+    sx?: string;
+    /** Per-slot overrides. */
+    slotProps?: ImageSlotProps;
+}
+//# sourceMappingURL=image.types.d.ts.map

package/dist/src/components/Image/image.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.types.d.ts","sourceRoot":"","sources":["../../../../src/components/Image/image.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,SAAS,CAAC,CAAC;AAEvE,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,mBAAmB;QAC3B,KAAK,CAAC,EAAE;YACN,QAAQ,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;YACtC,SAAS,CAAC,EAAE,cAAc,CAAC;SAC5B,CAAC;KACH;CACF;AAED,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,gCAAgC;IAChC,GAAG,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7B,yCAAyC;IACzC,QAAQ,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,uCAAuC;IACvC,QAAQ,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,UACf,SAAQ,IAAI,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,WAAW,CAAC;IAC9E,uGAAuG;IACvG,GAAG,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAE9B;;;OAGG;IACH,GAAG,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IAE3B;;;OAGG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAEnC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAE3B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAE3B;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAE1C,gEAAgE;IAChE,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,0BAA0B;IAC1B,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B"}

package/dist/src/components/Image/image.variants.d.ts

@@ -0,0 +1,149 @@
+import { type VariantProps } from 'tailwind-variants';
+/**
+ * `<Image>` variant recipe.
+ *
+ * Slots:
+ *  - `root`     — positioned wrapper. Holds the `<img>` plus the
+ *                 loading skeleton / error-fallback overlays, and owns
+ *                 the corner radius + overflow clipping. `relative` so
+ *                 the overlays can be `absolute inset-0`.
+ *  - `img`      — the `<img>` element. `object-*` (the `fit` axis)
+ *                 lives here; `block w-full h-full` so it fills the
+ *                 reserved box when an aspect ratio / dimensions are
+ *                 given.
+ *  - `skeleton` — the loading placeholder overlay (a `<Skeleton>`
+ *                 stretched over the reserved box).
+ *  - `fallback` — the broken-image overlay shown after `onError`.
+ *
+ * Variant axes:
+ *  - `fit`     — CSS `object-fit`. `cover` (default) crops to fill,
+ *                `contain` letterboxes, etc.
+ *  - `rounded` — corner radius token, applied to `root` (which clips
+ *                the image via `overflow-hidden`).
+ *
+ * Neutral fallback surface auto-inverts through the dashforge preset's
+ * CSS-variable layer (no explicit `dark:`).
+ */
+export declare const imageVariants: import("tailwind-variants").TVReturnType<{
+    fit: {
+        cover: {
+            img: string;
+        };
+        contain: {
+            img: string;
+        };
+        fill: {
+            img: string;
+        };
+        none: {
+            img: string;
+        };
+        'scale-down': {
+            img: string;
+        };
+    };
+    rounded: {
+        none: {
+            root: string;
+        };
+        sm: {
+            root: string;
+        };
+        md: {
+            root: string;
+        };
+        lg: {
+            root: string;
+        };
+        full: {
+            root: string;
+        };
+    };
+}, {
+    root: string[];
+    img: string[];
+    skeleton: string[];
+    fallback: string[];
+}, undefined, {
+    fit: {
+        cover: {
+            img: string;
+        };
+        contain: {
+            img: string;
+        };
+        fill: {
+            img: string;
+        };
+        none: {
+            img: string;
+        };
+        'scale-down': {
+            img: string;
+        };
+    };
+    rounded: {
+        none: {
+            root: string;
+        };
+        sm: {
+            root: string;
+        };
+        md: {
+            root: string;
+        };
+        lg: {
+            root: string;
+        };
+        full: {
+            root: string;
+        };
+    };
+}, {
+    root: string[];
+    img: string[];
+    skeleton: string[];
+    fallback: string[];
+}, import("tailwind-variants").TVReturnType<{
+    fit: {
+        cover: {
+            img: string;
+        };
+        contain: {
+            img: string;
+        };
+        fill: {
+            img: string;
+        };
+        none: {
+            img: string;
+        };
+        'scale-down': {
+            img: string;
+        };
+    };
+    rounded: {
+        none: {
+            root: string;
+        };
+        sm: {
+            root: string;
+        };
+        md: {
+            root: string;
+        };
+        lg: {
+            root: string;
+        };
+        full: {
+            root: string;
+        };
+    };
+}, {
+    root: string[];
+    img: string[];
+    skeleton: string[];
+    fallback: string[];
+}, undefined, unknown, unknown, undefined>>;
+export type ImageVariants = VariantProps<typeof imageVariants>;
+//# sourceMappingURL=image.variants.d.ts.map

package/dist/src/components/Image/image.variants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.variants.d.ts","sourceRoot":"","sources":["../../../../src/components/Image/image.variants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CAoCxB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,YAAY,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/src/components/Slider/slider.types.d.ts

@@ -191,6 +191,11 @@ interface SliderCommonProps {
  * `defaultValue` are `number`; `onChange` / `onCommit` receive `number`.
  */
 export interface SliderSingleProps extends SliderCommonProps {
+    /**
+     * Discriminator — omit or set `false` for single-value mode. Selects
+     * the `number` value/callback shapes over the range tuple.
+     * @default false
+     */
     range?: false;
     /** Controlled value. */
     value?: number;
@@ -206,6 +211,7 @@ export interface SliderSingleProps extends SliderCommonProps {
      * what writes to the form bridge — matches MUI / Ant defaults.
      */
     onCommit?: (value: number) => void;
+    /** Fires when the thumb loses focus (after a commit). */
     onBlur?: () => void;
 }
 /**
@@ -213,6 +219,10 @@ export interface SliderSingleProps extends SliderCommonProps {
  * `[number, number]`; `onChange` / `onCommit` receive the tuple.
  */
 export interface SliderRangeProps extends SliderCommonProps {
+    /**
+     * Discriminator — set `true` for range mode. Selects the
+     * `[number, number]` tuple value/callback shapes over the single number.
+     */
     range: true;
     /** Controlled `[min, max]` tuple. */
     value?: readonly [number, number];
@@ -222,6 +232,7 @@ export interface SliderRangeProps extends SliderCommonProps {
     onChange?: (value: readonly [number, number]) => void;
     /** Drag-end / keyboard-step callback. Writes to the bridge. */
     onCommit?: (value: readonly [number, number]) => void;
+    /** Fires when a thumb loses focus (after a commit). */
     onBlur?: () => void;
 }
 /**

package/dist/src/components/Slider/slider.types.d.ts.map

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

package/dist/src/components/Video/Video.d.ts

@@ -0,0 +1,28 @@
+import type { VideoProps } from './video.types.js';
+/**
+ * Dashforge TW `<Video>` — the moving-image twin of `<Image>`. A
+ * declarative, robust wrapper over the native `<video>`. Zero eval, no
+ * data fetching: it renders a URL you give it and adds what a bare
+ * `<video>` lacks.
+ *
+ *   1. **No layout shift** — pass `aspectRatio` (or `width` + `height`)
+ *      and the box is reserved before the video loads.
+ *   2. **Loading skeleton** — a `<Skeleton>` fills the reserved box
+ *      while the first frame loads; skipped when a `poster` is given
+ *      and for already-buffered video (no flash).
+ *   3. **Graceful error** — on load failure a muted fallback replaces
+ *      the player (`fallback` to customise).
+ *
+ * Controls on by default. Any native `<video>` attribute not named here
+ * (`autoPlay`, `loop`, `muted`, `playsInline`, `crossOrigin`, …) is
+ * forwarded; pass `<source>` children for multi-format delivery. The
+ * ref points at the `<video>`.
+ *
+ * @example
+ * ```tsx
+ * <Video src="/demo.mp4" poster="/demo.jpg" aspectRatio={16 / 9} rounded="lg" />
+ * <Video src="/loop.webm" aspectRatio={1} autoPlay loop muted playsInline controls={false} />
+ * ```
+ */
+export declare const Video: import("react").ForwardRefExoticComponent<VideoProps & import("react").RefAttributes<HTMLVideoElement>>;
+//# sourceMappingURL=Video.d.ts.map

package/dist/src/components/Video/Video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Video.d.ts","sourceRoot":"","sources":["../../../../src/components/Video/Video.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AA6BnD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,KAAK,yGAoJjB,CAAC"}

package/dist/src/components/Video/video.types.d.ts

@@ -0,0 +1,132 @@
+import type { VideoHTMLAttributes, ReactNode } from 'react';
+import type { AccessRequirement } from '@dashforge/rbac';
+import type { Engine } from '@dashforge/ui-core';
+import type { VideoVariants } from './video.variants.js';
+/**
+ * Subset of `<Video>` props theme-configurable via
+ * `theme.components.Video.defaults` (Option C).
+ */
+export type VideoVariantProps = Pick<VideoVariants, 'fit' | 'rounded'>;
+declare module '@dashforge/tw-tokens' {
+    interface TWComponentDefaults {
+        Video?: {
+            defaults?: Partial<VideoVariantProps>;
+            slotProps?: VideoSlotProps;
+        };
+    }
+}
+export interface VideoSlotProps {
+    /** Wrapper element override. */
+    root?: {
+        className?: string;
+    };
+    /** `<video>` element override. */
+    video?: {
+        className?: string;
+    };
+    /** Loading-skeleton overlay override. */
+    skeleton?: {
+        className?: string;
+    };
+    /** Error-fallback overlay override. */
+    fallback?: {
+        className?: string;
+    };
+}
+/**
+ * Props for `<Video>` — the moving-image twin of `<Image>`.
+ *
+ * A thin, declarative wrapper over the native `<video>` — zero eval, no
+ * data fetching — with the robustness a bare `<video>` lacks:
+ *
+ *  1. **No layout shift.** Give `aspectRatio` (or `width` + `height`)
+ *     and the box is reserved before the video loads (CSS
+ *     `aspect-ratio`, no JS measurement).
+ *  2. **Loading skeleton.** While the first frame loads, a `<Skeleton>`
+ *     fills the reserved box. Skipped when a `poster` is given (the
+ *     poster is its own loading visual) and for already-buffered video.
+ *  3. **Graceful error.** On load failure a muted fallback replaces the
+ *     player — pass your own via `fallback`.
+ *  4. **Controls on by default** (`controls`).
+ *
+ * Any native `<video>` attribute not listed here (`crossOrigin`,
+ * `disablePictureInPicture`, `controlsList`, …) is forwarded to the
+ * underlying element. For multi-format delivery, pass `<source>`
+ * elements as `children` instead of `src`.
+ *
+ * Note on privacy: an external `src` is fetched by the browser from
+ * that host (egress). Self-host the asset (same-origin / your CDN) to
+ * keep it inside your boundary. Autoplay requires `muted` in most
+ * browsers.
+ *
+ * @example
+ * ```tsx
+ * <Video src="/demo.mp4" poster="/demo.jpg" aspectRatio={16 / 9} rounded="lg" />
+ * <Video src="/loop.webm" aspectRatio={1} autoPlay loop muted playsInline controls={false} />
+ * ```
+ */
+export interface VideoProps extends Omit<VideoHTMLAttributes<HTMLVideoElement>, 'src' | 'className' | 'poster'> {
+    /** Video source URL. Same-origin / data: keeps it inside your boundary; an external host is egress. Omit and pass `<source>` children for multi-format delivery. */
+    src?: string;
+    /**
+     * Poster image URL shown before playback / while the first frame
+     * loads. Doubles as the anti-layout-shift and loading visual.
+     */
+    poster?: string;
+    /**
+     * Locks the box shape before load to prevent layout shift — a number
+     * (`16 / 9`, `1`) or a CSS `aspect-ratio` string (`'16 / 9'`). When
+     * set, the video fills the box via `object-fit`.
+     */
+    aspectRatio?: number | string;
+    /**
+     * How the video fills its box — CSS `object-fit`.
+     * @default 'cover'
+     */
+    fit?: VideoVariants['fit'];
+    /**
+     * Corner radius token, clipped via `overflow-hidden`.
+     * @default 'none'
+     */
+    rounded?: VideoVariants['rounded'];
+    /**
+     * Show the native player controls.
+     * @default true
+     */
+    controls?: boolean;
+    /**
+     * How much to preload. `'metadata'` fetches dimensions/duration only.
+     * @default 'metadata'
+     */
+    preload?: 'none' | 'metadata' | 'auto';
+    /**
+     * Show a `<Skeleton>` while the first frame loads. Requires a reserved
+     * box (`aspectRatio`, or both `width` and `height`) and no `poster`
+     * (the poster is its own loading visual), else it is skipped.
+     * @default true
+     */
+    showSkeleton?: boolean;
+    /**
+     * Content shown when the video fails to load. Defaults to a muted
+     * surface with a broken-media glyph.
+     */
+    fallback?: ReactNode;
+    /**
+     * RBAC access requirement. When the current user is unauthorized:
+     * `onUnauthorized: 'hide'` → the video does not render; `'disable'` /
+     * `'readonly'` → it renders dimmed and non-interactive (a video has no
+     * true disabled state). Resolved against the nearest `RbacProvider`.
+     */
+    access?: AccessRequirement;
+    /**
+     * Reactive visibility predicate evaluated against the form engine — the
+     * video renders only when it returns `true`. No-op outside a
+     * `<DashForm>`.
+     */
+    visibleWhen?: (engine: Engine) => boolean;
+    /** Root-level Tailwind override (wins via `tailwind-merge`). */
+    sx?: string;
+    /** Per-slot overrides. */
+    slotProps?: VideoSlotProps;
+}
+//# sourceMappingURL=video.types.d.ts.map

package/dist/src/components/Video/video.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.types.d.ts","sourceRoot":"","sources":["../../../../src/components/Video/video.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,SAAS,CAAC,CAAC;AAEvE,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,mBAAmB;QAC3B,KAAK,CAAC,EAAE;YACN,QAAQ,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;YACtC,SAAS,CAAC,EAAE,cAAc,CAAC;SAC5B,CAAC;KACH;CACF;AAED,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,kCAAkC;IAClC,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,yCAAyC;IACzC,QAAQ,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,uCAAuC;IACvC,QAAQ,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,WAAW,UACf,SAAQ,IAAI,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,KAAK,GAAG,WAAW,GAAG,QAAQ,CAAC;IACnF,oKAAoK;IACpK,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAE9B;;;OAGG;IACH,GAAG,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IAE3B;;;OAGG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAEnC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;IAEvC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAE3B;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAE1C,gEAAgE;IAChE,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,0BAA0B;IAC1B,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B"}