@elmethis/core 0.16.0 → 0.18.0

package/dist/a2ui/v0_9/block_catalog.json

@@ -872,6 +872,41 @@
       ],
       "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. Mutually exclusive with `src` — provide exactly one of the two."
+            },
+            "src": {
+              "type": "string",
+              "description": "URL of a remote document to render inside the iframe instead of inline `html` (e.g. a presigned, time-limited link). Mutually exclusive with `html` — provide exactly one of the two. `autoHeight` doesn't apply here since cross-origin content can't be measured, and a time-limited URL isn't refreshed automatically — the caller is responsible for keeping it current."
+            },
+            "autoHeight": {
+              "type": "boolean",
+              "description": "Stretch the iframe to fit its content height. Defaults to true. Only takes effect for `html`-rendered content."
+            }
+          },
+          "required": [
+            "component"
+          ]
+        }
+      ],
+      "unevaluatedProperties": false
+    },
     "CodeBlock": {
       "type": "object",
       "allOf": [

package/dist/index.cjs

@@ -266,6 +266,21 @@ const BlockImageApi = {
 		caption: zod.z.string().describe("Optional caption shown below the image.").optional()
 	}).strict()
 };
+/**
+* Sandboxed HTML embed, rendered inside an iframe. Provide exactly one of
+* `html` (inline markup, e.g. a Claude-authored artifact or a Notion page
+* export) or `src` (a remote document URL) — this catalog doesn't validate
+* cross-field constraints, so the contract is documentation-only.
+*/
+const HtmlApi = {
+	name: "Html",
+	schema: zod.z.object({
+		...CommonProps,
+		html: zod.z.string().describe("Raw HTML markup to render inside a sandboxed iframe. Mutually exclusive with `src` — provide exactly one of the two.").optional(),
+		src: zod.z.string().describe("URL of a remote document to render inside the iframe instead of inline `html` (e.g. a presigned, time-limited link). Mutually exclusive with `html` — provide exactly one of the two. `autoHeight` doesn't apply here since cross-origin content can't be measured, and a time-limited URL isn't refreshed automatically — the caller is responsible for keeping it current.").optional(),
+		autoHeight: zod.z.boolean().describe("Stretch the iframe to fit its content height. Defaults to true. Only takes effect for `html`-rendered content.").optional()
+	}).strict()
+};
 const CodeBlockApi = {
 	name: "CodeBlock",
 	schema: zod.z.object({
@@ -663,6 +678,7 @@ const BLOCK_CATALOG_COMPONENTS = [
 	AudioApi,
 	VideoApi,
 	BlockImageApi,
+	HtmlApi,
 	CodeBlockApi,
 	KatexApi,
 	MermaidApi,
@@ -1282,6 +1298,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;

package/dist/index.d.cts

@@ -2555,6 +2555,133 @@ declare const BlockImageApi: {
     sizes?: string | undefined;
   }>;
 };
+/**
+ * Sandboxed HTML embed, rendered inside an iframe. Provide exactly one of
+ * `html` (inline markup, e.g. a Claude-authored artifact or a Notion page
+ * export) or `src` (a remote document URL) — this catalog doesn't validate
+ * cross-field constraints, so the contract is documentation-only.
+ */
+declare const HtmlApi: {
+  name: string;
+  schema: z.ZodObject<{
+    html: z.ZodOptional<z.ZodString>;
+    src: z.ZodOptional<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, {
+    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;
+    src?: string | undefined;
+    html?: string | undefined;
+    autoHeight?: boolean | 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;
+    src?: string | undefined;
+    html?: string | undefined;
+    autoHeight?: boolean | undefined;
+  }>;
+};
 declare const CodeBlockApi: {
   name: string;
   schema: z.ZodObject<{
@@ -3819,4 +3946,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, NotionCalloutApi, 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

@@ -2555,6 +2555,133 @@ declare const BlockImageApi: {
     sizes?: string | undefined;
   }>;
 };
+/**
+ * Sandboxed HTML embed, rendered inside an iframe. Provide exactly one of
+ * `html` (inline markup, e.g. a Claude-authored artifact or a Notion page
+ * export) or `src` (a remote document URL) — this catalog doesn't validate
+ * cross-field constraints, so the contract is documentation-only.
+ */
+declare const HtmlApi: {
+  name: string;
+  schema: z.ZodObject<{
+    html: z.ZodOptional<z.ZodString>;
+    src: z.ZodOptional<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, {
+    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;
+    src?: string | undefined;
+    html?: string | undefined;
+    autoHeight?: boolean | 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;
+    src?: string | undefined;
+    html?: string | undefined;
+    autoHeight?: boolean | undefined;
+  }>;
+};
 declare const CodeBlockApi: {
   name: string;
   schema: z.ZodObject<{
@@ -3819,4 +3946,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, NotionCalloutApi, 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

@@ -265,6 +265,21 @@ const BlockImageApi = {
 		caption: z.string().describe("Optional caption shown below the image.").optional()
 	}).strict()
 };
+/**
+* Sandboxed HTML embed, rendered inside an iframe. Provide exactly one of
+* `html` (inline markup, e.g. a Claude-authored artifact or a Notion page
+* export) or `src` (a remote document URL) — this catalog doesn't validate
+* cross-field constraints, so the contract is documentation-only.
+*/
+const HtmlApi = {
+	name: "Html",
+	schema: z.object({
+		...CommonProps,
+		html: z.string().describe("Raw HTML markup to render inside a sandboxed iframe. Mutually exclusive with `src` — provide exactly one of the two.").optional(),
+		src: z.string().describe("URL of a remote document to render inside the iframe instead of inline `html` (e.g. a presigned, time-limited link). Mutually exclusive with `html` — provide exactly one of the two. `autoHeight` doesn't apply here since cross-origin content can't be measured, and a time-limited URL isn't refreshed automatically — the caller is responsible for keeping it current.").optional(),
+		autoHeight: z.boolean().describe("Stretch the iframe to fit its content height. Defaults to true. Only takes effect for `html`-rendered content.").optional()
+	}).strict()
+};
 const CodeBlockApi = {
 	name: "CodeBlock",
 	schema: z.object({
@@ -666,6 +681,7 @@ const blockCatalogJson = assembleCatalog({
 	AudioApi,
 	VideoApi,
 	BlockImageApi,
+	HtmlApi,
 	CodeBlockApi,
 	KatexApi,
 	MermaidApi,
@@ -1266,4 +1282,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, NotionCalloutApi, 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/package.json

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