@elmethis/core 0.12.0 → 0.13.0

package/dist/a2ui/v0_9/block_catalog.json

@@ -611,6 +611,118 @@
       ],
       "unevaluatedProperties": false
     },
+    "Audio": {
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "component": {
+              "const": "Audio"
+            },
+            "src": {
+              "type": "string",
+              "description": "The source URL of the audio to play."
+            },
+            "title": {
+              "type": "string",
+              "description": "Display title of the track. Falls back to the src filename when omitted."
+            },
+            "artist": {
+              "type": "string",
+              "description": "Artist or author name shown beneath the title."
+            },
+            "seekStep": {
+              "type": "number",
+              "description": "Number of seconds the skip-back/skip-forward controls jump. Defaults to 10."
+            },
+            "loop": {
+              "type": "boolean",
+              "description": "When true, the audio restarts when it reaches the end."
+            },
+            "autoPlay": {
+              "type": "boolean",
+              "description": "When true, playback starts automatically once enough data has loaded (subject to the browser's autoplay policy)."
+            }
+          },
+          "required": [
+            "component",
+            "src"
+          ]
+        }
+      ],
+      "unevaluatedProperties": false
+    },
+    "Video": {
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "component": {
+              "const": "Video"
+            },
+            "src": {
+              "type": "string",
+              "description": "The source URL of the video to play."
+            },
+            "title": {
+              "type": "string",
+              "description": "Display title of the video. Falls back to the src filename when omitted."
+            },
+            "poster": {
+              "type": "string",
+              "description": "URL of an image shown before the video begins playing."
+            },
+            "width": {
+              "type": "number",
+              "description": "Intrinsic video width in pixels."
+            },
+            "height": {
+              "type": "number",
+              "description": "Intrinsic video height in pixels."
+            },
+            "seekStep": {
+              "type": "number",
+              "description": "Number of seconds the skip-back/skip-forward controls jump. Defaults to 10."
+            },
+            "loop": {
+              "type": "boolean",
+              "description": "When true, the video restarts when it reaches the end."
+            },
+            "autoPlay": {
+              "type": "boolean",
+              "description": "When true, playback starts automatically once enough data has loaded (subject to the browser's autoplay policy)."
+            },
+            "muted": {
+              "type": "boolean",
+              "description": "When true, the video starts muted."
+            },
+            "caption": {
+              "type": "string",
+              "description": "Optional caption shown below the video."
+            }
+          },
+          "required": [
+            "component",
+            "src"
+          ]
+        }
+      ],
+      "unevaluatedProperties": false
+    },
     "BlockImage": {
       "type": "object",
       "allOf": [

package/dist/index.cjs

@@ -181,6 +181,42 @@ const FileApi = {
 	}).strict()
 };
 /**
+* Audio player with a custom transport (play/pause, skip, seek line, volume)
+* wrapping a native `<audio>` element.
+*/
+const AudioApi = {
+	name: "Audio",
+	schema: zod.z.object({
+		...CommonProps,
+		src: zod.z.string().describe("The source URL of the audio to play."),
+		title: zod.z.string().describe("Display title of the track. Falls back to the src filename when omitted.").optional(),
+		artist: zod.z.string().describe("Artist or author name shown beneath the title.").optional(),
+		seekStep: zod.z.number().describe("Number of seconds the skip-back/skip-forward controls jump. Defaults to 10.").optional(),
+		loop: zod.z.boolean().describe("When true, the audio restarts when it reaches the end.").optional(),
+		autoPlay: zod.z.boolean().describe("When true, playback starts automatically once enough data has loaded (subject to the browser's autoplay policy).").optional()
+	}).strict()
+};
+/**
+* Video player wrapping a native `<video>` element with an optional poster
+* frame and caption.
+*/
+const VideoApi = {
+	name: "Video",
+	schema: zod.z.object({
+		...CommonProps,
+		src: zod.z.string().describe("The source URL of the video to play."),
+		title: zod.z.string().describe("Display title of the video. Falls back to the src filename when omitted.").optional(),
+		poster: zod.z.string().describe("URL of an image shown before the video begins playing.").optional(),
+		width: zod.z.number().describe("Intrinsic video width in pixels.").optional(),
+		height: zod.z.number().describe("Intrinsic video height in pixels.").optional(),
+		seekStep: zod.z.number().describe("Number of seconds the skip-back/skip-forward controls jump. Defaults to 10.").optional(),
+		loop: zod.z.boolean().describe("When true, the video restarts when it reaches the end.").optional(),
+		autoPlay: zod.z.boolean().describe("When true, playback starts automatically once enough data has loaded (subject to the browser's autoplay policy).").optional(),
+		muted: zod.z.boolean().describe("When true, the video starts muted.").optional(),
+		caption: zod.z.string().describe("Optional caption shown below the video.").optional()
+	}).strict()
+};
+/**
 * Block-level image with optional caption and modal zoom.
 * Uses `src` (not `url`) to distinguish it from the basic catalog Image.
 */
@@ -590,6 +626,8 @@ const BLOCK_CATALOG_COMPONENTS = [
 	ToggleApi,
 	BookmarkApi,
 	FileApi,
+	AudioApi,
+	VideoApi,
 	BlockImageApi,
 	CodeBlockApi,
 	KatexApi,
@@ -1253,6 +1291,7 @@ const normalizeLanguage = (language) => ALIAS_TO_LANGUAGE.get(language) ?? "file
 /** The authored glyph artwork for every {@link GlyphLanguage}. */
 const languageIcons = Object.fromEntries(LANGUAGE_REGISTRY.flatMap((e) => e.icon ? [[e.key, e.icon]] : []));
 //#endregion
+exports.AudioApi = AudioApi;
 exports.BLOCK_CATALOG_ID = BLOCK_CATALOG_ID;
 exports.BlockImageApi = BlockImageApi;
 exports.BlockQuoteApi = BlockQuoteApi;
@@ -1281,6 +1320,7 @@ exports.TableCellApi = TableCellApi;
 exports.TableRowApi = TableRowApi;
 exports.ToggleApi = ToggleApi;
 exports.UnsupportedApi = UnsupportedApi;
+exports.VideoApi = VideoApi;
 exports.assembleCatalog = assembleCatalog;
 exports.blockCatalogJson = blockCatalogJson;
 exports.languageIcons = languageIcons;

package/dist/index.d.cts

@@ -1960,6 +1960,286 @@ declare const FileApi: {
     name?: string | undefined;
   }>;
 };
+/**
+ * Audio player with a custom transport (play/pause, skip, seek line, volume)
+ * wrapping a native `<audio>` element.
+ */
+declare const AudioApi: {
+  name: string;
+  schema: z.ZodObject<{
+    src: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    artist: z.ZodOptional<z.ZodString>;
+    seekStep: z.ZodOptional<z.ZodNumber>;
+    loop: z.ZodOptional<z.ZodBoolean>;
+    autoPlay: z.ZodOptional<z.ZodBoolean>;
+    accessibility: z.ZodOptional<z.ZodObject<{
+      label: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        path: z.ZodString;
+      }, "strip", z.ZodTypeAny, {
+        path: string;
+      }, {
+        path: string;
+      }>, z.ZodObject<{
+        call: z.ZodString;
+        args: z.ZodRecord<z.ZodString, z.ZodAny>;
+        returnType: z.ZodDefault<z.ZodEnum<["string", "number", "boolean", "array", "object", "any", "void"]>>;
+      }, "strip", z.ZodTypeAny, {
+        call: string;
+        args: Record<string, any>;
+        returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+      }, {
+        call: string;
+        args: Record<string, any>;
+        returnType?: "string" | "number" | "boolean" | "object" | "array" | "void" | "any" | undefined;
+      }>]>>;
+      description: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        path: z.ZodString;
+      }, "strip", z.ZodTypeAny, {
+        path: string;
+      }, {
+        path: string;
+      }>, z.ZodObject<{
+        call: z.ZodString;
+        args: z.ZodRecord<z.ZodString, z.ZodAny>;
+        returnType: z.ZodDefault<z.ZodEnum<["string", "number", "boolean", "array", "object", "any", "void"]>>;
+      }, "strip", z.ZodTypeAny, {
+        call: string;
+        args: Record<string, any>;
+        returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+      }, {
+        call: string;
+        args: Record<string, any>;
+        returnType?: "string" | "number" | "boolean" | "object" | "array" | "void" | "any" | undefined;
+      }>]>>;
+    }, "strip", z.ZodTypeAny, {
+      description?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+      } | undefined;
+      label?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+      } | undefined;
+    }, {
+      description?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType?: "string" | "number" | "boolean" | "object" | "array" | "void" | "any" | undefined;
+      } | undefined;
+      label?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType?: "string" | "number" | "boolean" | "object" | "array" | "void" | "any" | undefined;
+      } | undefined;
+    }>>;
+    weight: z.ZodOptional<z.ZodNumber>;
+  }, "strict", z.ZodTypeAny, {
+    src: string;
+    accessibility?: {
+      description?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+      } | undefined;
+      label?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+      } | undefined;
+    } | undefined;
+    weight?: number | undefined;
+    title?: string | undefined;
+    artist?: string | undefined;
+    seekStep?: number | undefined;
+    loop?: boolean | undefined;
+    autoPlay?: boolean | undefined;
+  }, {
+    src: string;
+    accessibility?: {
+      description?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType?: "string" | "number" | "boolean" | "object" | "array" | "void" | "any" | undefined;
+      } | undefined;
+      label?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType?: "string" | "number" | "boolean" | "object" | "array" | "void" | "any" | undefined;
+      } | undefined;
+    } | undefined;
+    weight?: number | undefined;
+    title?: string | undefined;
+    artist?: string | undefined;
+    seekStep?: number | undefined;
+    loop?: boolean | undefined;
+    autoPlay?: boolean | undefined;
+  }>;
+};
+/**
+ * Video player wrapping a native `<video>` element with an optional poster
+ * frame and caption.
+ */
+declare const VideoApi: {
+  name: string;
+  schema: z.ZodObject<{
+    src: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    poster: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    seekStep: z.ZodOptional<z.ZodNumber>;
+    loop: z.ZodOptional<z.ZodBoolean>;
+    autoPlay: z.ZodOptional<z.ZodBoolean>;
+    muted: z.ZodOptional<z.ZodBoolean>;
+    caption: z.ZodOptional<z.ZodString>;
+    accessibility: z.ZodOptional<z.ZodObject<{
+      label: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        path: z.ZodString;
+      }, "strip", z.ZodTypeAny, {
+        path: string;
+      }, {
+        path: string;
+      }>, z.ZodObject<{
+        call: z.ZodString;
+        args: z.ZodRecord<z.ZodString, z.ZodAny>;
+        returnType: z.ZodDefault<z.ZodEnum<["string", "number", "boolean", "array", "object", "any", "void"]>>;
+      }, "strip", z.ZodTypeAny, {
+        call: string;
+        args: Record<string, any>;
+        returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+      }, {
+        call: string;
+        args: Record<string, any>;
+        returnType?: "string" | "number" | "boolean" | "object" | "array" | "void" | "any" | undefined;
+      }>]>>;
+      description: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        path: z.ZodString;
+      }, "strip", z.ZodTypeAny, {
+        path: string;
+      }, {
+        path: string;
+      }>, z.ZodObject<{
+        call: z.ZodString;
+        args: z.ZodRecord<z.ZodString, z.ZodAny>;
+        returnType: z.ZodDefault<z.ZodEnum<["string", "number", "boolean", "array", "object", "any", "void"]>>;
+      }, "strip", z.ZodTypeAny, {
+        call: string;
+        args: Record<string, any>;
+        returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+      }, {
+        call: string;
+        args: Record<string, any>;
+        returnType?: "string" | "number" | "boolean" | "object" | "array" | "void" | "any" | undefined;
+      }>]>>;
+    }, "strip", z.ZodTypeAny, {
+      description?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+      } | undefined;
+      label?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+      } | undefined;
+    }, {
+      description?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType?: "string" | "number" | "boolean" | "object" | "array" | "void" | "any" | undefined;
+      } | undefined;
+      label?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType?: "string" | "number" | "boolean" | "object" | "array" | "void" | "any" | undefined;
+      } | undefined;
+    }>>;
+    weight: z.ZodOptional<z.ZodNumber>;
+  }, "strict", z.ZodTypeAny, {
+    src: string;
+    accessibility?: {
+      description?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+      } | undefined;
+      label?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+      } | undefined;
+    } | undefined;
+    weight?: number | undefined;
+    title?: string | undefined;
+    seekStep?: number | undefined;
+    loop?: boolean | undefined;
+    autoPlay?: boolean | undefined;
+    poster?: string | undefined;
+    width?: number | undefined;
+    height?: number | undefined;
+    muted?: boolean | undefined;
+    caption?: string | undefined;
+  }, {
+    src: string;
+    accessibility?: {
+      description?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType?: "string" | "number" | "boolean" | "object" | "array" | "void" | "any" | undefined;
+      } | undefined;
+      label?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType?: "string" | "number" | "boolean" | "object" | "array" | "void" | "any" | undefined;
+      } | undefined;
+    } | undefined;
+    weight?: number | undefined;
+    title?: string | undefined;
+    seekStep?: number | undefined;
+    loop?: boolean | undefined;
+    autoPlay?: boolean | undefined;
+    poster?: string | undefined;
+    width?: number | undefined;
+    height?: number | undefined;
+    muted?: boolean | undefined;
+    caption?: string | undefined;
+  }>;
+};
 /**
  * Block-level image with optional caption and modal zoom.
  * Uses `src` (not `url`) to distinguish it from the basic catalog Image.
@@ -2067,9 +2347,9 @@ declare const BlockImageApi: {
     alt?: string | undefined;
     width?: number | undefined;
     height?: number | undefined;
+    caption?: string | undefined;
     srcset?: string | undefined;
     sizes?: string | undefined;
-    caption?: string | undefined;
   }, {
     src: string;
     accessibility?: {
@@ -2092,9 +2372,9 @@ declare const BlockImageApi: {
     alt?: string | undefined;
     width?: number | undefined;
     height?: number | undefined;
+    caption?: string | undefined;
     srcset?: string | undefined;
     sizes?: string | undefined;
-    caption?: string | undefined;
   }>;
 };
 declare const CodeBlockApi: {
@@ -3361,4 +3641,4 @@ declare const normalizeLanguage: (language: string) => Language;
 /** The authored glyph artwork for every {@link GlyphLanguage}. */
 declare const languageIcons: Record<GlyphLanguage, LanguageIcon>;
 //#endregion
-export { type AssembledCatalog, BLOCK_CATALOG_ID, BlockImageApi, BlockQuoteApi, BookmarkApi, CalloutApi, type CatalogEnvelope, CodeBlockApi, ColumnApi, ColumnListApi, ContentTabApi, ContentTabsApi, DividerApi, FileApi, type GlyphLanguage, HeadingApi, IconApi, KatexApi, LANGUAGES, type Language, type LanguageIcon, LinkTextApi, ListApi, ListItemApi, MermaidApi, ParagraphApi, RichTextApi, RowApi, type SvgNode, TableApi, TableCellApi, TableRowApi, ToggleApi, UnsupportedApi, assembleCatalog, blockCatalogJson, languageIcons, normalizeLanguage };
+export { type AssembledCatalog, AudioApi, BLOCK_CATALOG_ID, BlockImageApi, BlockQuoteApi, BookmarkApi, CalloutApi, type CatalogEnvelope, CodeBlockApi, ColumnApi, ColumnListApi, ContentTabApi, ContentTabsApi, DividerApi, FileApi, type GlyphLanguage, HeadingApi, IconApi, KatexApi, LANGUAGES, type Language, type LanguageIcon, LinkTextApi, ListApi, ListItemApi, MermaidApi, ParagraphApi, RichTextApi, RowApi, type SvgNode, TableApi, TableCellApi, TableRowApi, ToggleApi, UnsupportedApi, VideoApi, assembleCatalog, blockCatalogJson, languageIcons, normalizeLanguage };

package/dist/index.d.mts

@@ -1960,6 +1960,286 @@ declare const FileApi: {
     name?: string | undefined;
   }>;
 };
+/**
+ * Audio player with a custom transport (play/pause, skip, seek line, volume)
+ * wrapping a native `<audio>` element.
+ */
+declare const AudioApi: {
+  name: string;
+  schema: z.ZodObject<{
+    src: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    artist: z.ZodOptional<z.ZodString>;
+    seekStep: z.ZodOptional<z.ZodNumber>;
+    loop: z.ZodOptional<z.ZodBoolean>;
+    autoPlay: z.ZodOptional<z.ZodBoolean>;
+    accessibility: z.ZodOptional<z.ZodObject<{
+      label: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        path: z.ZodString;
+      }, "strip", z.ZodTypeAny, {
+        path: string;
+      }, {
+        path: string;
+      }>, z.ZodObject<{
+        call: z.ZodString;
+        args: z.ZodRecord<z.ZodString, z.ZodAny>;
+        returnType: z.ZodDefault<z.ZodEnum<["string", "number", "boolean", "array", "object", "any", "void"]>>;
+      }, "strip", z.ZodTypeAny, {
+        call: string;
+        args: Record<string, any>;
+        returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+      }, {
+        call: string;
+        args: Record<string, any>;
+        returnType?: "string" | "number" | "boolean" | "object" | "array" | "void" | "any" | undefined;
+      }>]>>;
+      description: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        path: z.ZodString;
+      }, "strip", z.ZodTypeAny, {
+        path: string;
+      }, {
+        path: string;
+      }>, z.ZodObject<{
+        call: z.ZodString;
+        args: z.ZodRecord<z.ZodString, z.ZodAny>;
+        returnType: z.ZodDefault<z.ZodEnum<["string", "number", "boolean", "array", "object", "any", "void"]>>;
+      }, "strip", z.ZodTypeAny, {
+        call: string;
+        args: Record<string, any>;
+        returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+      }, {
+        call: string;
+        args: Record<string, any>;
+        returnType?: "string" | "number" | "boolean" | "object" | "array" | "void" | "any" | undefined;
+      }>]>>;
+    }, "strip", z.ZodTypeAny, {
+      description?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+      } | undefined;
+      label?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+      } | undefined;
+    }, {
+      description?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType?: "string" | "number" | "boolean" | "object" | "array" | "void" | "any" | undefined;
+      } | undefined;
+      label?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType?: "string" | "number" | "boolean" | "object" | "array" | "void" | "any" | undefined;
+      } | undefined;
+    }>>;
+    weight: z.ZodOptional<z.ZodNumber>;
+  }, "strict", z.ZodTypeAny, {
+    src: string;
+    accessibility?: {
+      description?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+      } | undefined;
+      label?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+      } | undefined;
+    } | undefined;
+    weight?: number | undefined;
+    title?: string | undefined;
+    artist?: string | undefined;
+    seekStep?: number | undefined;
+    loop?: boolean | undefined;
+    autoPlay?: boolean | undefined;
+  }, {
+    src: string;
+    accessibility?: {
+      description?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType?: "string" | "number" | "boolean" | "object" | "array" | "void" | "any" | undefined;
+      } | undefined;
+      label?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType?: "string" | "number" | "boolean" | "object" | "array" | "void" | "any" | undefined;
+      } | undefined;
+    } | undefined;
+    weight?: number | undefined;
+    title?: string | undefined;
+    artist?: string | undefined;
+    seekStep?: number | undefined;
+    loop?: boolean | undefined;
+    autoPlay?: boolean | undefined;
+  }>;
+};
+/**
+ * Video player wrapping a native `<video>` element with an optional poster
+ * frame and caption.
+ */
+declare const VideoApi: {
+  name: string;
+  schema: z.ZodObject<{
+    src: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    poster: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    seekStep: z.ZodOptional<z.ZodNumber>;
+    loop: z.ZodOptional<z.ZodBoolean>;
+    autoPlay: z.ZodOptional<z.ZodBoolean>;
+    muted: z.ZodOptional<z.ZodBoolean>;
+    caption: z.ZodOptional<z.ZodString>;
+    accessibility: z.ZodOptional<z.ZodObject<{
+      label: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        path: z.ZodString;
+      }, "strip", z.ZodTypeAny, {
+        path: string;
+      }, {
+        path: string;
+      }>, z.ZodObject<{
+        call: z.ZodString;
+        args: z.ZodRecord<z.ZodString, z.ZodAny>;
+        returnType: z.ZodDefault<z.ZodEnum<["string", "number", "boolean", "array", "object", "any", "void"]>>;
+      }, "strip", z.ZodTypeAny, {
+        call: string;
+        args: Record<string, any>;
+        returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+      }, {
+        call: string;
+        args: Record<string, any>;
+        returnType?: "string" | "number" | "boolean" | "object" | "array" | "void" | "any" | undefined;
+      }>]>>;
+      description: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        path: z.ZodString;
+      }, "strip", z.ZodTypeAny, {
+        path: string;
+      }, {
+        path: string;
+      }>, z.ZodObject<{
+        call: z.ZodString;
+        args: z.ZodRecord<z.ZodString, z.ZodAny>;
+        returnType: z.ZodDefault<z.ZodEnum<["string", "number", "boolean", "array", "object", "any", "void"]>>;
+      }, "strip", z.ZodTypeAny, {
+        call: string;
+        args: Record<string, any>;
+        returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+      }, {
+        call: string;
+        args: Record<string, any>;
+        returnType?: "string" | "number" | "boolean" | "object" | "array" | "void" | "any" | undefined;
+      }>]>>;
+    }, "strip", z.ZodTypeAny, {
+      description?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+      } | undefined;
+      label?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+      } | undefined;
+    }, {
+      description?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType?: "string" | "number" | "boolean" | "object" | "array" | "void" | "any" | undefined;
+      } | undefined;
+      label?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType?: "string" | "number" | "boolean" | "object" | "array" | "void" | "any" | undefined;
+      } | undefined;
+    }>>;
+    weight: z.ZodOptional<z.ZodNumber>;
+  }, "strict", z.ZodTypeAny, {
+    src: string;
+    accessibility?: {
+      description?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+      } | undefined;
+      label?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+      } | undefined;
+    } | undefined;
+    weight?: number | undefined;
+    title?: string | undefined;
+    seekStep?: number | undefined;
+    loop?: boolean | undefined;
+    autoPlay?: boolean | undefined;
+    poster?: string | undefined;
+    width?: number | undefined;
+    height?: number | undefined;
+    muted?: boolean | undefined;
+    caption?: string | undefined;
+  }, {
+    src: string;
+    accessibility?: {
+      description?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType?: "string" | "number" | "boolean" | "object" | "array" | "void" | "any" | undefined;
+      } | undefined;
+      label?: string | {
+        path: string;
+      } | {
+        call: string;
+        args: Record<string, any>;
+        returnType?: "string" | "number" | "boolean" | "object" | "array" | "void" | "any" | undefined;
+      } | undefined;
+    } | undefined;
+    weight?: number | undefined;
+    title?: string | undefined;
+    seekStep?: number | undefined;
+    loop?: boolean | undefined;
+    autoPlay?: boolean | undefined;
+    poster?: string | undefined;
+    width?: number | undefined;
+    height?: number | undefined;
+    muted?: boolean | undefined;
+    caption?: string | undefined;
+  }>;
+};
 /**
  * Block-level image with optional caption and modal zoom.
  * Uses `src` (not `url`) to distinguish it from the basic catalog Image.
@@ -2067,9 +2347,9 @@ declare const BlockImageApi: {
     alt?: string | undefined;
     width?: number | undefined;
     height?: number | undefined;
+    caption?: string | undefined;
     srcset?: string | undefined;
     sizes?: string | undefined;
-    caption?: string | undefined;
   }, {
     src: string;
     accessibility?: {
@@ -2092,9 +2372,9 @@ declare const BlockImageApi: {
     alt?: string | undefined;
     width?: number | undefined;
     height?: number | undefined;
+    caption?: string | undefined;
     srcset?: string | undefined;
     sizes?: string | undefined;
-    caption?: string | undefined;
   }>;
 };
 declare const CodeBlockApi: {
@@ -3361,4 +3641,4 @@ declare const normalizeLanguage: (language: string) => Language;
 /** The authored glyph artwork for every {@link GlyphLanguage}. */
 declare const languageIcons: Record<GlyphLanguage, LanguageIcon>;
 //#endregion
-export { type AssembledCatalog, BLOCK_CATALOG_ID, BlockImageApi, BlockQuoteApi, BookmarkApi, CalloutApi, type CatalogEnvelope, CodeBlockApi, ColumnApi, ColumnListApi, ContentTabApi, ContentTabsApi, DividerApi, FileApi, type GlyphLanguage, HeadingApi, IconApi, KatexApi, LANGUAGES, type Language, type LanguageIcon, LinkTextApi, ListApi, ListItemApi, MermaidApi, ParagraphApi, RichTextApi, RowApi, type SvgNode, TableApi, TableCellApi, TableRowApi, ToggleApi, UnsupportedApi, assembleCatalog, blockCatalogJson, languageIcons, normalizeLanguage };
+export { type AssembledCatalog, AudioApi, BLOCK_CATALOG_ID, BlockImageApi, BlockQuoteApi, BookmarkApi, CalloutApi, type CatalogEnvelope, CodeBlockApi, ColumnApi, ColumnListApi, ContentTabApi, ContentTabsApi, DividerApi, FileApi, type GlyphLanguage, HeadingApi, IconApi, KatexApi, LANGUAGES, type Language, type LanguageIcon, LinkTextApi, ListApi, ListItemApi, MermaidApi, ParagraphApi, RichTextApi, RowApi, type SvgNode, TableApi, TableCellApi, TableRowApi, ToggleApi, UnsupportedApi, VideoApi, assembleCatalog, blockCatalogJson, languageIcons, normalizeLanguage };

package/dist/index.mjs

@@ -180,6 +180,42 @@ const FileApi = {
 	}).strict()
 };
 /**
+* Audio player with a custom transport (play/pause, skip, seek line, volume)
+* wrapping a native `<audio>` element.
+*/
+const AudioApi = {
+	name: "Audio",
+	schema: z.object({
+		...CommonProps,
+		src: z.string().describe("The source URL of the audio to play."),
+		title: z.string().describe("Display title of the track. Falls back to the src filename when omitted.").optional(),
+		artist: z.string().describe("Artist or author name shown beneath the title.").optional(),
+		seekStep: z.number().describe("Number of seconds the skip-back/skip-forward controls jump. Defaults to 10.").optional(),
+		loop: z.boolean().describe("When true, the audio restarts when it reaches the end.").optional(),
+		autoPlay: z.boolean().describe("When true, playback starts automatically once enough data has loaded (subject to the browser's autoplay policy).").optional()
+	}).strict()
+};
+/**
+* Video player wrapping a native `<video>` element with an optional poster
+* frame and caption.
+*/
+const VideoApi = {
+	name: "Video",
+	schema: z.object({
+		...CommonProps,
+		src: z.string().describe("The source URL of the video to play."),
+		title: z.string().describe("Display title of the video. Falls back to the src filename when omitted.").optional(),
+		poster: z.string().describe("URL of an image shown before the video begins playing.").optional(),
+		width: z.number().describe("Intrinsic video width in pixels.").optional(),
+		height: z.number().describe("Intrinsic video height in pixels.").optional(),
+		seekStep: z.number().describe("Number of seconds the skip-back/skip-forward controls jump. Defaults to 10.").optional(),
+		loop: z.boolean().describe("When true, the video restarts when it reaches the end.").optional(),
+		autoPlay: z.boolean().describe("When true, playback starts automatically once enough data has loaded (subject to the browser's autoplay policy).").optional(),
+		muted: z.boolean().describe("When true, the video starts muted.").optional(),
+		caption: z.string().describe("Optional caption shown below the video.").optional()
+	}).strict()
+};
+/**
 * Block-level image with optional caption and modal zoom.
 * Uses `src` (not `url`) to distinguish it from the basic catalog Image.
 */
@@ -593,6 +629,8 @@ const blockCatalogJson = assembleCatalog({
 	ToggleApi,
 	BookmarkApi,
 	FileApi,
+	AudioApi,
+	VideoApi,
 	BlockImageApi,
 	CodeBlockApi,
 	KatexApi,
@@ -1251,4 +1289,4 @@ const normalizeLanguage = (language) => ALIAS_TO_LANGUAGE.get(language) ?? "file
 /** The authored glyph artwork for every {@link GlyphLanguage}. */
 const languageIcons = Object.fromEntries(LANGUAGE_REGISTRY.flatMap((e) => e.icon ? [[e.key, e.icon]] : []));
 //#endregion
-export { BLOCK_CATALOG_ID, BlockImageApi, BlockQuoteApi, BookmarkApi, CalloutApi, CodeBlockApi, ColumnApi, ColumnListApi, ContentTabApi, ContentTabsApi, DividerApi, FileApi, HeadingApi, IconApi, KatexApi, LANGUAGES, LinkTextApi, ListApi, ListItemApi, MermaidApi, ParagraphApi, RichTextApi, RowApi, TableApi, TableCellApi, TableRowApi, ToggleApi, UnsupportedApi, assembleCatalog, blockCatalogJson, languageIcons, normalizeLanguage };
+export { AudioApi, BLOCK_CATALOG_ID, BlockImageApi, BlockQuoteApi, BookmarkApi, CalloutApi, CodeBlockApi, ColumnApi, ColumnListApi, ContentTabApi, ContentTabsApi, DividerApi, FileApi, HeadingApi, IconApi, KatexApi, LANGUAGES, LinkTextApi, ListApi, ListItemApi, MermaidApi, ParagraphApi, RichTextApi, RowApi, TableApi, TableCellApi, TableRowApi, ToggleApi, UnsupportedApi, VideoApi, assembleCatalog, blockCatalogJson, languageIcons, normalizeLanguage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elmethis/core",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "author": {
     "name": "Ikuma Yamashita",
     "url": "https://www.ikuma.cloud/"