@elmethis/core 0.15.0 → 0.17.0

package/dist/a2ui/v0_9/block_catalog.json

@@ -483,6 +483,103 @@
       ],
       "unevaluatedProperties": false
     },
+    "NotionCallout": {
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "component": {
+              "const": "NotionCallout"
+            },
+            "icon": {
+              "anyOf": [
+                {
+                  "type": "object",
+                  "properties": {
+                    "kind": {
+                      "type": "string",
+                      "const": "emoji"
+                    },
+                    "emoji": {
+                      "type": "string",
+                      "description": "A single emoji character."
+                    }
+                  },
+                  "required": [
+                    "kind",
+                    "emoji"
+                  ],
+                  "additionalProperties": false
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "kind": {
+                      "type": "string",
+                      "const": "image"
+                    },
+                    "src": {
+                      "type": "string",
+                      "description": "The source URL of the icon image."
+                    },
+                    "alt": {
+                      "type": "string",
+                      "description": "Accessible alt text for the icon."
+                    }
+                  },
+                  "required": [
+                    "kind",
+                    "src"
+                  ],
+                  "additionalProperties": false
+                }
+              ],
+              "description": "Icon shown before the content: an emoji or an image."
+            },
+            "color": {
+              "type": "string",
+              "enum": [
+                "default",
+                "gray",
+                "red",
+                "orange",
+                "yellow",
+                "green",
+                "cyan",
+                "blue",
+                "purple",
+                "magenta"
+              ],
+              "description": "Accent hue for the callout."
+            },
+            "variant": {
+              "type": "string",
+              "enum": [
+                "filled",
+                "outlined"
+              ],
+              "description": "Tinted background ('filled') or transparent with a colored border ('outlined')."
+            },
+            "children": {
+              "$ref": "#/$defs/ChildList",
+              "description": "Ordered list of child component IDs that make up the callout body."
+            }
+          },
+          "required": [
+            "component",
+            "children"
+          ]
+        }
+      ],
+      "unevaluatedProperties": false
+    },
     "Divider": {
       "type": "object",
       "allOf": [
@@ -775,6 +872,38 @@
       ],
       "unevaluatedProperties": false
     },
+    "Html": {
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "component": {
+              "const": "Html"
+            },
+            "html": {
+              "type": "string",
+              "description": "Raw HTML markup to render inside a sandboxed iframe."
+            },
+            "autoHeight": {
+              "type": "boolean",
+              "description": "Stretch the iframe to fit its content height. Defaults to true."
+            }
+          },
+          "required": [
+            "component",
+            "html"
+          ]
+        }
+      ],
+      "unevaluatedProperties": false
+    },
     "CodeBlock": {
       "type": "object",
       "allOf": [

package/dist/index.cjs

@@ -146,6 +146,39 @@ const CalloutApi = {
 		children: childrenSchema.describe("Ordered list of child component IDs that make up the callout body.")
 	}).strict()
 };
+/**
+* Notion-style callout: an icon (emoji or image) plus a colored, filled or
+* outlined block. Unlike {@link CalloutApi}, it carries no severity/flavor
+* text — the color and icon alone convey meaning.
+*/
+const NotionCalloutApi = {
+	name: "NotionCallout",
+	schema: zod.z.object({
+		...CommonProps,
+		icon: zod.z.discriminatedUnion("kind", [zod.z.object({
+			kind: zod.z.literal("emoji"),
+			emoji: zod.z.string().describe("A single emoji character.")
+		}).strict(), zod.z.object({
+			kind: zod.z.literal("image"),
+			src: zod.z.string().describe("The source URL of the icon image."),
+			alt: zod.z.string().describe("Accessible alt text for the icon.").optional()
+		}).strict()]).describe("Icon shown before the content: an emoji or an image.").optional(),
+		color: zod.z.enum([
+			"default",
+			"gray",
+			"red",
+			"orange",
+			"yellow",
+			"green",
+			"cyan",
+			"blue",
+			"purple",
+			"magenta"
+		]).describe("Accent hue for the callout.").optional(),
+		variant: zod.z.enum(["filled", "outlined"]).describe("Tinted background ('filled') or transparent with a colored border ('outlined').").optional(),
+		children: childrenSchema.describe("Ordered list of child component IDs that make up the callout body.")
+	}).strict()
+};
 /** Horizontal rule / section separator. Has no configurable properties. */
 const DividerApi = {
 	name: "Divider",
@@ -233,6 +266,18 @@ const BlockImageApi = {
 		caption: zod.z.string().describe("Optional caption shown below the image.").optional()
 	}).strict()
 };
+/**
+* Sandboxed raw-HTML embed. Renders `html` inside an iframe (e.g. a
+* Claude-authored artifact or a Notion page export).
+*/
+const HtmlApi = {
+	name: "Html",
+	schema: zod.z.object({
+		...CommonProps,
+		html: zod.z.string().describe("Raw HTML markup to render inside a sandboxed iframe."),
+		autoHeight: zod.z.boolean().describe("Stretch the iframe to fit its content height. Defaults to true.").optional()
+	}).strict()
+};
 const CodeBlockApi = {
 	name: "CodeBlock",
 	schema: zod.z.object({
@@ -622,6 +667,7 @@ const BLOCK_CATALOG_COMPONENTS = [
 	ListItemApi,
 	BlockQuoteApi,
 	CalloutApi,
+	NotionCalloutApi,
 	DividerApi,
 	ToggleApi,
 	BookmarkApi,
@@ -629,6 +675,7 @@ const BLOCK_CATALOG_COMPONENTS = [
 	AudioApi,
 	VideoApi,
 	BlockImageApi,
+	HtmlApi,
 	CodeBlockApi,
 	KatexApi,
 	MermaidApi,
@@ -1248,6 +1295,7 @@ exports.ContentTabsApi = ContentTabsApi;
 exports.DividerApi = DividerApi;
 exports.FileApi = FileApi;
 exports.HeadingApi = HeadingApi;
+exports.HtmlApi = HtmlApi;
 exports.IconApi = IconApi;
 exports.KatexApi = KatexApi;
 exports.LANGUAGES = LANGUAGES;
@@ -1255,6 +1303,7 @@ exports.LinkTextApi = LinkTextApi;
 exports.ListApi = ListApi;
 exports.ListItemApi = ListItemApi;
 exports.MermaidApi = MermaidApi;
+exports.NotionCalloutApi = NotionCalloutApi;
 exports.ParagraphApi = ParagraphApi;
 exports.RichTextApi = RichTextApi;
 exports.RowApi = _a2ui_web_core_v0_9_basic_catalog.RowApi;

package/dist/index.d.cts

@@ -1,7 +1,6 @@
 import { z } from "zod";
 import { RowApi } from "@a2ui/web_core/v0_9/basic_catalog";
 import { ComponentApi } from "@a2ui/web_core/v0_9";
-
 //#region src/a2ui/v0_9/block-catalog.d.ts
 declare const RichTextApi: {
   name: string;
@@ -1454,6 +1453,185 @@ declare const CalloutApi: {
     weight?: number | undefined;
   }>;
 };
+/**
+ * Notion-style callout: an icon (emoji or image) plus a colored, filled or
+ * outlined block. Unlike {@link CalloutApi}, it carries no severity/flavor
+ * text — the color and icon alone convey meaning.
+ */
+declare const NotionCalloutApi: {
+  name: string;
+  schema: z.ZodObject<{
+    icon: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+      kind: z.ZodLiteral<"emoji">;
+      emoji: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+      kind: "emoji";
+      emoji: string;
+    }, {
+      kind: "emoji";
+      emoji: string;
+    }>, z.ZodObject<{
+      kind: z.ZodLiteral<"image">;
+      src: z.ZodString;
+      alt: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+      src: string;
+      kind: "image";
+      alt?: string | undefined;
+    }, {
+      src: string;
+      kind: "image";
+      alt?: string | undefined;
+    }>]>>;
+    color: z.ZodOptional<z.ZodEnum<["default", "gray", "red", "orange", "yellow", "green", "cyan", "blue", "purple", "magenta"]>>;
+    variant: z.ZodOptional<z.ZodEnum<["filled", "outlined"]>>;
+    children: z.ZodUnion<[z.ZodArray<z.ZodString, "many">, z.ZodObject<{
+      componentId: z.ZodString;
+      path: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+      componentId: string;
+      path: string;
+    }, {
+      componentId: string;
+      path: string;
+    }>]>;
+    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, {
+    children: {
+      componentId: string;
+      path: string;
+    } | string[];
+    color?: "default" | "gray" | "red" | "orange" | "yellow" | "green" | "cyan" | "blue" | "purple" | "magenta" | undefined;
+    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;
+    icon?: {
+      kind: "emoji";
+      emoji: string;
+    } | {
+      src: string;
+      kind: "image";
+      alt?: string | undefined;
+    } | undefined;
+    variant?: "filled" | "outlined" | undefined;
+  }, {
+    children: {
+      componentId: string;
+      path: string;
+    } | string[];
+    color?: "default" | "gray" | "red" | "orange" | "yellow" | "green" | "cyan" | "blue" | "purple" | "magenta" | undefined;
+    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;
+    icon?: {
+      kind: "emoji";
+      emoji: string;
+    } | {
+      src: string;
+      kind: "image";
+      alt?: string | undefined;
+    } | undefined;
+    variant?: "filled" | "outlined" | undefined;
+  }>;
+};
 /** Horizontal rule / section separator. Has no configurable properties. */
 declare const DividerApi: {
   name: string;
@@ -1814,9 +1992,9 @@ declare const BookmarkApi: {
       } | undefined;
     } | undefined;
     weight?: number | undefined;
+    image?: string | undefined;
     title?: string | undefined;
     description?: string | undefined;
-    image?: string | undefined;
   }, {
     url: string;
     accessibility?: {
@@ -1836,9 +2014,9 @@ declare const BookmarkApi: {
       } | undefined;
     } | undefined;
     weight?: number | undefined;
+    image?: string | undefined;
     title?: string | undefined;
     description?: string | undefined;
-    image?: string | undefined;
   }>;
 };
 /** Downloadable file attachment widget. */
@@ -2377,6 +2555,128 @@ declare const BlockImageApi: {
     sizes?: string | undefined;
   }>;
 };
+/**
+ * Sandboxed raw-HTML embed. Renders `html` inside an iframe (e.g. a
+ * Claude-authored artifact or a Notion page export).
+ */
+declare const HtmlApi: {
+  name: string;
+  schema: z.ZodObject<{
+    html: z.ZodString;
+    autoHeight: 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, {
+    html: 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;
+    autoHeight?: boolean | undefined;
+  }, {
+    html: 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;
+    autoHeight?: boolean | undefined;
+  }>;
+};
 declare const CodeBlockApi: {
   name: string;
   schema: z.ZodObject<{
@@ -3641,4 +3941,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, 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 };
+export { type AssembledCatalog, AudioApi, BLOCK_CATALOG_ID, BlockImageApi, BlockQuoteApi, BookmarkApi, CalloutApi, type CatalogEnvelope, CodeBlockApi, ColumnApi, ColumnListApi, ContentTabApi, ContentTabsApi, DividerApi, FileApi, type GlyphLanguage, HeadingApi, HtmlApi, IconApi, KatexApi, LANGUAGES, type Language, type LanguageIcon, LinkTextApi, ListApi, ListItemApi, MermaidApi, NotionCalloutApi, ParagraphApi, RichTextApi, RowApi, type SvgNode, TableApi, TableCellApi, TableRowApi, ToggleApi, UnsupportedApi, VideoApi, assembleCatalog, blockCatalogJson, languageIcons, normalizeLanguage };

package/dist/index.d.mts

@@ -1,7 +1,6 @@
 import { z } from "zod";
 import { ComponentApi } from "@a2ui/web_core/v0_9";
 import { RowApi } from "@a2ui/web_core/v0_9/basic_catalog";
-
 //#region src/a2ui/v0_9/block-catalog.d.ts
 declare const RichTextApi: {
   name: string;
@@ -1454,6 +1453,185 @@ declare const CalloutApi: {
     weight?: number | undefined;
   }>;
 };
+/**
+ * Notion-style callout: an icon (emoji or image) plus a colored, filled or
+ * outlined block. Unlike {@link CalloutApi}, it carries no severity/flavor
+ * text — the color and icon alone convey meaning.
+ */
+declare const NotionCalloutApi: {
+  name: string;
+  schema: z.ZodObject<{
+    icon: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+      kind: z.ZodLiteral<"emoji">;
+      emoji: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+      kind: "emoji";
+      emoji: string;
+    }, {
+      kind: "emoji";
+      emoji: string;
+    }>, z.ZodObject<{
+      kind: z.ZodLiteral<"image">;
+      src: z.ZodString;
+      alt: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+      src: string;
+      kind: "image";
+      alt?: string | undefined;
+    }, {
+      src: string;
+      kind: "image";
+      alt?: string | undefined;
+    }>]>>;
+    color: z.ZodOptional<z.ZodEnum<["default", "gray", "red", "orange", "yellow", "green", "cyan", "blue", "purple", "magenta"]>>;
+    variant: z.ZodOptional<z.ZodEnum<["filled", "outlined"]>>;
+    children: z.ZodUnion<[z.ZodArray<z.ZodString, "many">, z.ZodObject<{
+      componentId: z.ZodString;
+      path: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+      componentId: string;
+      path: string;
+    }, {
+      componentId: string;
+      path: string;
+    }>]>;
+    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, {
+    children: {
+      componentId: string;
+      path: string;
+    } | string[];
+    color?: "default" | "gray" | "red" | "orange" | "yellow" | "green" | "cyan" | "blue" | "purple" | "magenta" | undefined;
+    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;
+    icon?: {
+      kind: "emoji";
+      emoji: string;
+    } | {
+      src: string;
+      kind: "image";
+      alt?: string | undefined;
+    } | undefined;
+    variant?: "filled" | "outlined" | undefined;
+  }, {
+    children: {
+      componentId: string;
+      path: string;
+    } | string[];
+    color?: "default" | "gray" | "red" | "orange" | "yellow" | "green" | "cyan" | "blue" | "purple" | "magenta" | undefined;
+    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;
+    icon?: {
+      kind: "emoji";
+      emoji: string;
+    } | {
+      src: string;
+      kind: "image";
+      alt?: string | undefined;
+    } | undefined;
+    variant?: "filled" | "outlined" | undefined;
+  }>;
+};
 /** Horizontal rule / section separator. Has no configurable properties. */
 declare const DividerApi: {
   name: string;
@@ -1814,9 +1992,9 @@ declare const BookmarkApi: {
       } | undefined;
     } | undefined;
     weight?: number | undefined;
+    image?: string | undefined;
     title?: string | undefined;
     description?: string | undefined;
-    image?: string | undefined;
   }, {
     url: string;
     accessibility?: {
@@ -1836,9 +2014,9 @@ declare const BookmarkApi: {
       } | undefined;
     } | undefined;
     weight?: number | undefined;
+    image?: string | undefined;
     title?: string | undefined;
     description?: string | undefined;
-    image?: string | undefined;
   }>;
 };
 /** Downloadable file attachment widget. */
@@ -2377,6 +2555,128 @@ declare const BlockImageApi: {
     sizes?: string | undefined;
   }>;
 };
+/**
+ * Sandboxed raw-HTML embed. Renders `html` inside an iframe (e.g. a
+ * Claude-authored artifact or a Notion page export).
+ */
+declare const HtmlApi: {
+  name: string;
+  schema: z.ZodObject<{
+    html: z.ZodString;
+    autoHeight: 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, {
+    html: 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;
+    autoHeight?: boolean | undefined;
+  }, {
+    html: 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;
+    autoHeight?: boolean | undefined;
+  }>;
+};
 declare const CodeBlockApi: {
   name: string;
   schema: z.ZodObject<{
@@ -3641,4 +3941,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, 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 };
+export { type AssembledCatalog, AudioApi, BLOCK_CATALOG_ID, BlockImageApi, BlockQuoteApi, BookmarkApi, CalloutApi, type CatalogEnvelope, CodeBlockApi, ColumnApi, ColumnListApi, ContentTabApi, ContentTabsApi, DividerApi, FileApi, type GlyphLanguage, HeadingApi, HtmlApi, IconApi, KatexApi, LANGUAGES, type Language, type LanguageIcon, LinkTextApi, ListApi, ListItemApi, MermaidApi, NotionCalloutApi, ParagraphApi, RichTextApi, RowApi, type SvgNode, TableApi, TableCellApi, TableRowApi, ToggleApi, UnsupportedApi, VideoApi, assembleCatalog, blockCatalogJson, languageIcons, normalizeLanguage };

package/dist/index.mjs

@@ -145,6 +145,39 @@ const CalloutApi = {
 		children: childrenSchema.describe("Ordered list of child component IDs that make up the callout body.")
 	}).strict()
 };
+/**
+* Notion-style callout: an icon (emoji or image) plus a colored, filled or
+* outlined block. Unlike {@link CalloutApi}, it carries no severity/flavor
+* text — the color and icon alone convey meaning.
+*/
+const NotionCalloutApi = {
+	name: "NotionCallout",
+	schema: z.object({
+		...CommonProps,
+		icon: z.discriminatedUnion("kind", [z.object({
+			kind: z.literal("emoji"),
+			emoji: z.string().describe("A single emoji character.")
+		}).strict(), z.object({
+			kind: z.literal("image"),
+			src: z.string().describe("The source URL of the icon image."),
+			alt: z.string().describe("Accessible alt text for the icon.").optional()
+		}).strict()]).describe("Icon shown before the content: an emoji or an image.").optional(),
+		color: z.enum([
+			"default",
+			"gray",
+			"red",
+			"orange",
+			"yellow",
+			"green",
+			"cyan",
+			"blue",
+			"purple",
+			"magenta"
+		]).describe("Accent hue for the callout.").optional(),
+		variant: z.enum(["filled", "outlined"]).describe("Tinted background ('filled') or transparent with a colored border ('outlined').").optional(),
+		children: childrenSchema.describe("Ordered list of child component IDs that make up the callout body.")
+	}).strict()
+};
 /** Horizontal rule / section separator. Has no configurable properties. */
 const DividerApi = {
 	name: "Divider",
@@ -232,6 +265,18 @@ const BlockImageApi = {
 		caption: z.string().describe("Optional caption shown below the image.").optional()
 	}).strict()
 };
+/**
+* Sandboxed raw-HTML embed. Renders `html` inside an iframe (e.g. a
+* Claude-authored artifact or a Notion page export).
+*/
+const HtmlApi = {
+	name: "Html",
+	schema: z.object({
+		...CommonProps,
+		html: z.string().describe("Raw HTML markup to render inside a sandboxed iframe."),
+		autoHeight: z.boolean().describe("Stretch the iframe to fit its content height. Defaults to true.").optional()
+	}).strict()
+};
 const CodeBlockApi = {
 	name: "CodeBlock",
 	schema: z.object({
@@ -625,6 +670,7 @@ const blockCatalogJson = assembleCatalog({
 	ListItemApi,
 	BlockQuoteApi,
 	CalloutApi,
+	NotionCalloutApi,
 	DividerApi,
 	ToggleApi,
 	BookmarkApi,
@@ -632,6 +678,7 @@ const blockCatalogJson = assembleCatalog({
 	AudioApi,
 	VideoApi,
 	BlockImageApi,
+	HtmlApi,
 	CodeBlockApi,
 	KatexApi,
 	MermaidApi,
@@ -1232,4 +1279,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 { 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 };
+export { AudioApi, BLOCK_CATALOG_ID, BlockImageApi, BlockQuoteApi, BookmarkApi, CalloutApi, CodeBlockApi, ColumnApi, ColumnListApi, ContentTabApi, ContentTabsApi, DividerApi, FileApi, HeadingApi, HtmlApi, IconApi, KatexApi, LANGUAGES, LinkTextApi, ListApi, ListItemApi, MermaidApi, NotionCalloutApi, ParagraphApi, RichTextApi, RowApi, TableApi, TableCellApi, TableRowApi, ToggleApi, UnsupportedApi, VideoApi, assembleCatalog, blockCatalogJson, languageIcons, normalizeLanguage };

package/dist/tokens.css

@@ -47,7 +47,7 @@
   --elmethis-primitive-font-family-monospace:
     "DM Mono", "Source Code Pro", Menlo, Consolas, "DejaVu Sans Mono",
     "Zen Kaku Gothic New", monospace;
-  --elmethis-margin-block-start: 2rem;
+  --elmethis-stack-gap: 2rem;
   --elmethis-font-family-sans: var(--elmethis-primitive-font-family-sans);
   --elmethis-font-family-monospace: var(
     --elmethis-primitive-font-family-monospace

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elmethis/core",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "author": {
     "name": "Ikuma Yamashita",
     "url": "https://www.ikuma.cloud/"
@@ -45,21 +45,21 @@
   "devDependencies": {
     "@a2ui/web_core": "^0.10.0",
     "@eslint/js": "latest",
-    "@types/node": "25.7.0",
-    "@vanilla-extract/css": "^1.20.1",
+    "@types/node": "26.1.0",
+    "@vanilla-extract/css": "^1.21.1",
     "@vanilla-extract/esbuild-plugin": "^2.3.22",
-    "@vitest/coverage-v8": "^4.1.9",
+    "@vitest/coverage-v8": "^4.1.10",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "concurrently": "^10.0.3",
     "esbuild": "^0.28.1",
-    "eslint": "^10.5.0",
-    "globals": "^17.6.0",
-    "prettier": "3.8.4",
-    "tsdown": "^0.22.3",
-    "tsx": "^4.22.4",
+    "eslint": "^10.6.0",
+    "globals": "^17.7.0",
+    "prettier": "3.9.4",
+    "tsdown": "^0.22.4",
+    "tsx": "^4.23.0",
     "typescript": "5.9.3",
-    "typescript-eslint": "^8.61.1",
+    "typescript-eslint": "^8.63.0",
     "vitest": "^4.1.8",
     "zod": "^3"
   },