katanakit-js 4.0.4 → 5.2.0

package/dist/schemas/media.schema.d.ts

@@ -0,0 +1,51 @@
+import { z } from "zod";
+/** Where a media source comes from. `file` = direct mp4/webm (native `<video>`). */
+export declare const MediaProviderSchema: z.ZodEnum<{
+    unknown: "unknown";
+    file: "file";
+    youtube: "youtube";
+    vimeo: "vimeo";
+}>;
+/** Normalized media source: provider + stable id or direct src. */
+export declare const MediaSourceSchema: z.ZodObject<{
+    provider: z.ZodEnum<{
+        unknown: "unknown";
+        file: "file";
+        youtube: "youtube";
+        vimeo: "vimeo";
+    }>;
+    id: z.ZodString;
+    raw: z.ZodString;
+}, z.core.$strip>;
+/** Options for the YouTube nocookie embed URL. */
+export declare const YoutubeEmbedOptionsSchema: z.ZodObject<{
+    start: z.ZodOptional<z.ZodNumber>;
+    end: z.ZodOptional<z.ZodNumber>;
+    autoplay: z.ZodOptional<z.ZodBoolean>;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+}, z.core.$strip>;
+/** Thumbnail quality for `i.ytimg.com`. */
+export declare const YoutubeThumbnailQualitySchema: z.ZodEnum<{
+    default: "default";
+    mqdefault: "mqdefault";
+    hqdefault: "hqdefault";
+    sddefault: "sddefault";
+    maxresdefault: "maxresdefault";
+}>;
+/** Input for `useBuildVideoEmbed` (core) — one `src`, unified output. */
+export declare const SmartVideoOptionsSchema: z.ZodObject<{
+    src: z.ZodString;
+    title: z.ZodString;
+    caption: z.ZodOptional<z.ZodString>;
+    poster: z.ZodOptional<z.ZodString>;
+    className: z.ZodOptional<z.ZodString>;
+    aspect: z.ZodOptional<z.ZodString>;
+    facade: z.ZodOptional<z.ZodBoolean>;
+    youtube: z.ZodOptional<z.ZodObject<{
+        start: z.ZodOptional<z.ZodNumber>;
+        end: z.ZodOptional<z.ZodNumber>;
+        autoplay: z.ZodOptional<z.ZodBoolean>;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+//# sourceMappingURL=media.schema.d.ts.map

package/dist/schemas/media.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/media.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,oFAAoF;AACpF,eAAO,MAAM,mBAAmB;;;;;EAAkD,CAAC;AAEnF,mEAAmE;AACnE,eAAO,MAAM,iBAAiB;;;;;;;;;iBAM5B,CAAC;AAEH,kDAAkD;AAClD,eAAO,MAAM,yBAAyB;;;;;iBASpC,CAAC;AAEH,2CAA2C;AAC3C,eAAO,MAAM,6BAA6B;;;;;;EAMxC,CAAC;AAEH,yEAAyE;AACzE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;iBAiBlC,CAAC"}

package/dist/schemas/media.schema.js

@@ -0,0 +1,50 @@
+import { z } from "zod";
+/** Where a media source comes from. `file` = direct mp4/webm (native `<video>`). */
+export const MediaProviderSchema = z.enum(["youtube", "vimeo", "file", "unknown"]);
+/** Normalized media source: provider + stable id or direct src. */
+export const MediaSourceSchema = z.object({
+    provider: MediaProviderSchema,
+    /** Video id for youtube/vimeo, full URL for `file`. */
+    id: z.string().min(1),
+    /** Original input (URL or bare id). */
+    raw: z.string(),
+});
+/** Options for the YouTube nocookie embed URL. */
+export const YoutubeEmbedOptionsSchema = z.object({
+    /** Start time in seconds. */
+    start: z.number().nonnegative().optional(),
+    /** End time in seconds. */
+    end: z.number().nonnegative().optional(),
+    /** Autoplay on iframe creation (facade clicks pass `1`). */
+    autoplay: z.boolean().optional(),
+    /** Extra `playerVars` merged into the query string. */
+    params: z.record(z.string(), z.union([z.string(), z.number(), z.boolean()])).optional(),
+});
+/** Thumbnail quality for `i.ytimg.com`. */
+export const YoutubeThumbnailQualitySchema = z.enum([
+    "default",
+    "mqdefault",
+    "hqdefault",
+    "sddefault",
+    "maxresdefault",
+]);
+/** Input for `useBuildVideoEmbed` (core) — one `src`, unified output. */
+export const SmartVideoOptionsSchema = z.object({
+    /** YouTube URL/id, Vimeo URL/id, or direct `.mp4`/`.webm` URL. */
+    src: z.string().min(1),
+    /** Accessible title. Used as `<iframe title>` / `<video aria-label>`. */
+    title: z.string().min(1),
+    /** Optional `<figcaption>` text. */
+    caption: z.string().optional(),
+    /** Poster for native `<video>` or facade thumbnail override. */
+    poster: z.string().optional(),
+    /** Extra CSS class on the `<figure>` wrapper. */
+    className: z.string().optional(),
+    /** Aspect ratio box: `16/9` (default) or `4/3`, `1/1`, `9/16`. */
+    aspect: z.string().optional(),
+    /** Render the click-to-play facade for embeds (no heavy iframe on load). */
+    facade: z.boolean().optional(),
+    /** YouTube player options (only for `youtube` provider). */
+    youtube: YoutubeEmbedOptionsSchema.optional(),
+});
+//# sourceMappingURL=media.schema.js.map

package/dist/schemas/media.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.schema.js","sourceRoot":"","sources":["../../src/schemas/media.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,oFAAoF;AACpF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;AAEnF,mEAAmE;AACnE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,QAAQ,EAAE,mBAAmB;IAC7B,uDAAuD;IACvD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,uCAAuC;IACvC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;CACf,CAAC,CAAC;AAEH,kDAAkD;AAClD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,6BAA6B;IAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAC1C,2BAA2B;IAC3B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACxC,4DAA4D;IAC5D,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAChC,uDAAuD;IACvD,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACvF,CAAC,CAAC;AAEH,2CAA2C;AAC3C,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,IAAI,CAAC;IACnD,SAAS;IACT,WAAW;IACX,WAAW;IACX,WAAW;IACX,eAAe;CACf,CAAC,CAAC;AAEH,yEAAyE;AACzE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,kEAAkE;IAClE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtB,yEAAyE;IACzE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,oCAAoC;IACpC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,gEAAgE;IAChE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,iDAAiD;IACjD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,kEAAkE;IAClE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,4EAA4E;IAC5E,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,4DAA4D;IAC5D,OAAO,EAAE,yBAAyB,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAC"}