@streamscloud/kit 0.0.1 → 0.1.0

package/dist/ui/time-ago/cmp.time-ago.svelte

@@ -66,3 +66,15 @@ const disableTimeout = () => {
     {timeSpan}
   {/if}
 </span>
+
+<!--
+@component
+Displays a human-readable relative time string (e.g. "5 minutes ago") that auto-updates.
+Falls back to an absolute date after the threshold is exceeded.
+
+### Props
+| Prop | Type | Default | Description |
+|---|---|---|---|
+| `date` | `Date \| string \| null` | `null` | The date to display relative to now |
+| `thresholdMinutes` | `number` | `2880` (2 days) | Minutes after which absolute date is shown instead |
+-->

package/dist/ui/time-ago/cmp.time-ago.svelte.d.ts

@@ -2,6 +2,16 @@ type Props = {
     date: Date | string | null;
     thresholdMinutes?: number;
 };
+/**
+ * Displays a human-readable relative time string (e.g. "5 minutes ago") that auto-updates.
+ * Falls back to an absolute date after the threshold is exceeded.
+ *
+ * ### Props
+ * | Prop | Type | Default | Description |
+ * |---|---|---|---|
+ * | `date` | `Date \| string \| null` | `null` | The date to display relative to now |
+ * | `thresholdMinutes` | `number` | `2880` (2 days) | Minutes after which absolute date is shown instead |
+ */
 declare const Cmp: import("svelte").Component<Props, {}, "">;
 type Cmp = ReturnType<typeof Cmp>;
 export default Cmp;

package/dist/ui/video/cmp.video.svelte

@@ -290,6 +290,19 @@ const handleSeek = (percent) => {
   {/if}
 </div>
 
+<!--
+@component
+A full-featured video player with custom overlay controls, play/pause, mute, seek bar, poster image, autoplay-on-scroll, and global playback management.
+
+### CSS Custom Properties
+| Property | Description | Default |
+|---|---|---|
+| `--sc-kit--video--background-color` | Player background | `black` |
+| `--sc-kit--video--border-radius` | Corner rounding | `0` |
+| `--sc-kit--video--media-fit` | Video object-fit mode | `contain` |
+| `--sc-kit--video--poster--media-fit` | Poster image object-fit mode | `cover` |
+-->
+
 <style>.video {
   --_video--background-color: var(--sc-kit--video--background-color, #000000);
   --_video--border-radius: var(--sc-kit--video--border-radius, 0);

package/dist/ui/video/cmp.video.svelte.d.ts

@@ -1,16 +1,27 @@
 import type { ScrubberPosition } from './types';
 type Props = {
+    /** Video source URL */
     src: string;
+    /** Poster image shown before playback starts */
     poster: string | null | undefined;
+    /** Unique player ID for the global PlaybackManager @default nanoid() */
     id?: string;
+    /** Show native browser controls once playback starts */
     controls?: boolean;
+    /** Autoplay strategy: `true` plays immediately, `'on-appearance'` plays when scrolled into view */
     autoplay?: true | false | 'on-appearance';
     loop?: boolean;
+    /** Scroll ancestor for the IntersectionObserver */
     intersectionContainer?: HTMLElement;
+    /** Make the video non-interactive */
     inert?: boolean;
+    /** Begin loading the video source before it scrolls into view */
     allowPreloading?: boolean;
+    /** Hide the mute/unmute speaker button */
     hideSpeaker?: boolean;
+    /** Hide the play/pause overlay button */
     hidePlayButton?: boolean;
+    /** Position the seek bar at the top or bottom of the overlay @default 'bottom' */
     scrubberPosition?: ScrubberPosition;
     on?: {
         started?: (data: {
@@ -21,6 +32,7 @@ type Props = {
             id: string;
             src: string;
         }) => void;
+        /** Fires on timeupdate with the completion ratio (0-1) */
         progress?: (value: number) => void;
         ended?: (data: {
             id: string;
@@ -28,6 +40,17 @@ type Props = {
         }) => void;
     };
 };
+/**
+ * A full-featured video player with custom overlay controls, play/pause, mute, seek bar, poster image, autoplay-on-scroll, and global playback management.
+ *
+ * ### CSS Custom Properties
+ * | Property | Description | Default |
+ * |---|---|---|
+ * | `--sc-kit--video--background-color` | Player background | `black` |
+ * | `--sc-kit--video--border-radius` | Corner rounding | `0` |
+ * | `--sc-kit--video--media-fit` | Video object-fit mode | `contain` |
+ * | `--sc-kit--video--poster--media-fit` | Poster image object-fit mode | `cover` |
+ */
 declare const Cmp: import("svelte").Component<Props, {}, "">;
 type Cmp = ReturnType<typeof Cmp>;
 export default Cmp;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@streamscloud/kit",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "author": "StreamsCloud",
   "repository": {
     "type": "git",