@elmethis/core 0.19.0 → 0.20.0

package/dist/a2ui/v0_9/{block_catalog.json → notion_block_catalog.json}

@@ -1,9 +1,9 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://46ki75.github.io/elmethis/a2ui/v0_9/block_catalog.json",
-  "catalogId": "https://46ki75.github.io/elmethis/a2ui/v0_9/block_catalog.json",
-  "title": "Elmethis Block Catalog",
-  "description": "Block-level A2UI components used by the @elmethis renderers (typography, media, code, math, table, tabs). Extends — does not replace — the A2UI Basic Catalog.",
+  "$id": "https://46ki75.github.io/elmethis/a2ui/v0_9/notion_block_catalog.json",
+  "catalogId": "https://46ki75.github.io/elmethis/a2ui/v0_9/notion_block_catalog.json",
+  "title": "Elmethis Notion Block Catalog",
+  "description": "Notion block-level A2UI components used by the @elmethis renderers (typography, media, code, math, table, tabs). Extends — does not replace — the A2UI Basic Catalog.",
   "components": {
     "RichText": {
       "type": "object",
@@ -893,15 +893,19 @@
             },
             "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."
+              "description": "URL of a remote document to render inside the iframe instead of inline `html` (e.g. a presigned, time-limited link, or a same-origin asset). Mutually exclusive with `html` — provide exactly one of the two. `autoHeight` can still measure a same-origin `src`, but not a genuinely cross-origin one, 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."
+              "description": "Stretch the iframe to fit its content height. Defaults to true. Has no effect on genuinely cross-origin `src` content, or on any content once `allowScripts` is on (measuring requires DOM access the sandbox never grants alongside script execution) — `height` is the fallback size for those cases."
             },
             "allowScripts": {
               "type": "boolean",
-              "description": "Allow the embedded content to run JavaScript (adds the iframe sandbox's `allow-scripts` token). Defaults to false — script execution is disabled by default. `allow-same-origin` is never granted together with this, in `html` or `src` mode, so the embedded document can never escape the sandbox even with scripts enabled."
+              "description": "Allow the embedded content to run JavaScript (adds the iframe sandbox's `allow-scripts` token). Defaults to true when rendered through the Notion block catalog — pass `false` explicitly to disable script execution. (The underlying `ElmHtml` component still defaults to `false` when used directly, outside the A2UI catalog.) `allow-same-origin` is never granted together with this, in `html` or `src` mode, so the embedded document can never escape the sandbox even with scripts enabled."
+            },
+            "height": {
+              "type": "number",
+              "description": "Fallback pixel height for the iframe, used whenever `autoHeight` can't measure the actual content (e.g. `allowScripts` content, or a genuinely cross-origin `src`). Defaults to 400 when omitted. Ignored once `autoHeight` successfully measures real content — it only ever applies as a starting/fallback size, never a hard cap."
             }
           },
           "required": [

package/dist/index.cjs

@@ -3,7 +3,7 @@ let zod = require("zod");
 let _a2ui_web_core_v0_9 = require("@a2ui/web_core/v0_9");
 let _a2ui_web_core_v0_9_basic_catalog = require("@a2ui/web_core/v0_9/basic_catalog");
 let zod_to_json_schema = require("zod-to-json-schema");
-//#region src/a2ui/v0_9/block-catalog.ts
+//#region src/a2ui/v0_9/notion-block-catalog.ts
 const CommonProps = {
 	accessibility: _a2ui_web_core_v0_9.AccessibilityAttributesSchema.optional(),
 	weight: zod.z.number().describe("The relative weight of this component within a Row or Column. This is similar to the CSS 'flex-grow' property. Note: this may ONLY be set when the component is a direct descendant of a Row or Column.").optional()
@@ -277,9 +277,10 @@ const HtmlApi = {
 	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(),
-		allowScripts: zod.z.boolean().describe("Allow the embedded content to run JavaScript (adds the iframe sandbox's `allow-scripts` token). Defaults to false — script execution is disabled by default. `allow-same-origin` is never granted together with this, in `html` or `src` mode, so the embedded document can never escape the sandbox even with scripts enabled.").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, or a same-origin asset). Mutually exclusive with `html` — provide exactly one of the two. `autoHeight` can still measure a same-origin `src`, but not a genuinely cross-origin one, 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. Has no effect on genuinely cross-origin `src` content, or on any content once `allowScripts` is on (measuring requires DOM access the sandbox never grants alongside script execution) — `height` is the fallback size for those cases.").optional(),
+		allowScripts: zod.z.boolean().describe("Allow the embedded content to run JavaScript (adds the iframe sandbox's `allow-scripts` token). Defaults to true when rendered through the Notion block catalog — pass `false` explicitly to disable script execution. (The underlying `ElmHtml` component still defaults to `false` when used directly, outside the A2UI catalog.) `allow-same-origin` is never granted together with this, in `html` or `src` mode, so the embedded document can never escape the sandbox even with scripts enabled.").optional(),
+		height: zod.z.number().describe("Fallback pixel height for the iframe, used whenever `autoHeight` can't measure the actual content (e.g. `allowScripts` content, or a genuinely cross-origin `src`). Defaults to 400 when omitted. Ignored once `autoHeight` successfully measures real content — it only ever applies as a starting/fallback size, never a hard cap.").optional()
 	}).strict()
 };
 const CodeBlockApi = {
@@ -639,26 +640,27 @@ function assembleCatalog(envelope, components) {
 	};
 }
 //#endregion
-//#region src/a2ui/v0_9/block-catalog-json.ts
+//#region src/a2ui/v0_9/notion-block-catalog-json.ts
 /**
 * Method A — runtime catalog constant.
 *
-* Assembles the block catalog from the `*Api` Zod definitions into a
+* Assembles the Notion block catalog from the `*Api` Zod definitions into a
 * freestanding A2UI v0.9 catalog JSON Schema document. Consumers that want
 * the catalog at runtime (e.g. to feed into an LLM system prompt or to
-* validate an inbound A2UI message) import `blockCatalogJson` directly.
+* validate an inbound A2UI message) import `notionBlockCatalogJson` directly.
 *
 * Consumers that want the document as a hostable artifact use Method B:
-* `dist/a2ui/block_catalog.json` is emitted at build time from this same
-* constant and is served at the URL identified by `BLOCK_CATALOG_ID`.
+* `dist/a2ui/notion_block_catalog.json` is emitted at build time from this
+* same constant and is served at the URL identified by
+* `NOTION_BLOCK_CATALOG_ID`.
 */
 /**
-* Stable URI identifying the block catalog. Lives under the `elmethis`
-* GitHub Pages site so the JSON Schema is fetchable by third-party agents
-* and validators that look up `catalogId`.
+* Stable URI identifying the Notion block catalog. Lives under the
+* `elmethis` GitHub Pages site so the JSON Schema is fetchable by
+* third-party agents and validators that look up `catalogId`.
 */
-const BLOCK_CATALOG_ID = "https://46ki75.github.io/elmethis/a2ui/v0_9/block_catalog.json";
-const BLOCK_CATALOG_COMPONENTS = [
+const NOTION_BLOCK_CATALOG_ID = "https://46ki75.github.io/elmethis/a2ui/v0_9/notion_block_catalog.json";
+const NOTION_BLOCK_CATALOG_COMPONENTS = [
 	RichTextApi,
 	LinkTextApi,
 	IconApi,
@@ -690,11 +692,11 @@ const BLOCK_CATALOG_COMPONENTS = [
 	TableCellApi,
 	UnsupportedApi
 ];
-const blockCatalogJson = assembleCatalog({
-	id: BLOCK_CATALOG_ID,
-	title: "Elmethis Block Catalog",
-	description: "Block-level A2UI components used by the @elmethis renderers (typography, media, code, math, table, tabs). Extends — does not replace — the A2UI Basic Catalog."
-}, BLOCK_CATALOG_COMPONENTS);
+const notionBlockCatalogJson = assembleCatalog({
+	id: NOTION_BLOCK_CATALOG_ID,
+	title: "Elmethis Notion Block Catalog",
+	description: "Notion block-level A2UI components used by the @elmethis renderers (typography, media, code, math, table, tabs). Extends — does not replace — the A2UI Basic Catalog."
+}, NOTION_BLOCK_CATALOG_COMPONENTS);
 //#endregion
 //#region src/icon/languages/registry.ts
 /**
@@ -1286,7 +1288,6 @@ const normalizeLanguage = (language) => ALIAS_TO_LANGUAGE.get(language) ?? "file
 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;
 exports.BookmarkApi = BookmarkApi;
@@ -1307,6 +1308,7 @@ exports.LinkTextApi = LinkTextApi;
 exports.ListApi = ListApi;
 exports.ListItemApi = ListItemApi;
 exports.MermaidApi = MermaidApi;
+exports.NOTION_BLOCK_CATALOG_ID = NOTION_BLOCK_CATALOG_ID;
 exports.NotionCalloutApi = NotionCalloutApi;
 exports.ParagraphApi = ParagraphApi;
 exports.RichTextApi = RichTextApi;
@@ -1318,6 +1320,6 @@ exports.ToggleApi = ToggleApi;
 exports.UnsupportedApi = UnsupportedApi;
 exports.VideoApi = VideoApi;
 exports.assembleCatalog = assembleCatalog;
-exports.blockCatalogJson = blockCatalogJson;
 exports.languageIcons = languageIcons;
 exports.normalizeLanguage = normalizeLanguage;
+exports.notionBlockCatalogJson = notionBlockCatalogJson;

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 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
+//#region src/a2ui/v0_9/notion-block-catalog.d.ts
 declare const RichTextApi: {
   name: string;
   schema: z.ZodObject<{
@@ -2568,6 +2568,7 @@ declare const HtmlApi: {
     src: z.ZodOptional<z.ZodString>;
     autoHeight: z.ZodOptional<z.ZodBoolean>;
     allowScripts: z.ZodOptional<z.ZodBoolean>;
+    height: z.ZodOptional<z.ZodNumber>;
     accessibility: z.ZodOptional<z.ZodObject<{
       label: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
         path: z.ZodString;
@@ -2658,6 +2659,7 @@ declare const HtmlApi: {
     } | undefined;
     weight?: number | undefined;
     src?: string | undefined;
+    height?: number | undefined;
     html?: string | undefined;
     autoHeight?: boolean | undefined;
     allowScripts?: boolean | undefined;
@@ -2680,6 +2682,7 @@ declare const HtmlApi: {
     } | undefined;
     weight?: number | undefined;
     src?: string | undefined;
+    height?: number | undefined;
     html?: string | undefined;
     autoHeight?: boolean | undefined;
     allowScripts?: boolean | undefined;
@@ -3813,14 +3816,14 @@ interface AssembledCatalog {
  */
 declare function assembleCatalog(envelope: CatalogEnvelope, components: readonly ComponentApi[]): AssembledCatalog;
 //#endregion
-//#region src/a2ui/v0_9/block-catalog-json.d.ts
+//#region src/a2ui/v0_9/notion-block-catalog-json.d.ts
 /**
- * Stable URI identifying the block catalog. Lives under the `elmethis`
- * GitHub Pages site so the JSON Schema is fetchable by third-party agents
- * and validators that look up `catalogId`.
+ * Stable URI identifying the Notion block catalog. Lives under the
+ * `elmethis` GitHub Pages site so the JSON Schema is fetchable by
+ * third-party agents and validators that look up `catalogId`.
  */
-declare const BLOCK_CATALOG_ID = "https://46ki75.github.io/elmethis/a2ui/v0_9/block_catalog.json";
-declare const blockCatalogJson: AssembledCatalog;
+declare const NOTION_BLOCK_CATALOG_ID = "https://46ki75.github.io/elmethis/a2ui/v0_9/notion_block_catalog.json";
+declare const notionBlockCatalogJson: AssembledCatalog;
 //#endregion
 //#region src/icon/languages/types.d.ts
 /**
@@ -3949,4 +3952,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, 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 };
+export { type AssembledCatalog, AudioApi, 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, NOTION_BLOCK_CATALOG_ID, NotionCalloutApi, ParagraphApi, RichTextApi, RowApi, type SvgNode, TableApi, TableCellApi, TableRowApi, ToggleApi, UnsupportedApi, VideoApi, assembleCatalog, languageIcons, normalizeLanguage, notionBlockCatalogJson };

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 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
+//#region src/a2ui/v0_9/notion-block-catalog.d.ts
 declare const RichTextApi: {
   name: string;
   schema: z.ZodObject<{
@@ -2568,6 +2568,7 @@ declare const HtmlApi: {
     src: z.ZodOptional<z.ZodString>;
     autoHeight: z.ZodOptional<z.ZodBoolean>;
     allowScripts: z.ZodOptional<z.ZodBoolean>;
+    height: z.ZodOptional<z.ZodNumber>;
     accessibility: z.ZodOptional<z.ZodObject<{
       label: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
         path: z.ZodString;
@@ -2658,6 +2659,7 @@ declare const HtmlApi: {
     } | undefined;
     weight?: number | undefined;
     src?: string | undefined;
+    height?: number | undefined;
     html?: string | undefined;
     autoHeight?: boolean | undefined;
     allowScripts?: boolean | undefined;
@@ -2680,6 +2682,7 @@ declare const HtmlApi: {
     } | undefined;
     weight?: number | undefined;
     src?: string | undefined;
+    height?: number | undefined;
     html?: string | undefined;
     autoHeight?: boolean | undefined;
     allowScripts?: boolean | undefined;
@@ -3813,14 +3816,14 @@ interface AssembledCatalog {
  */
 declare function assembleCatalog(envelope: CatalogEnvelope, components: readonly ComponentApi[]): AssembledCatalog;
 //#endregion
-//#region src/a2ui/v0_9/block-catalog-json.d.ts
+//#region src/a2ui/v0_9/notion-block-catalog-json.d.ts
 /**
- * Stable URI identifying the block catalog. Lives under the `elmethis`
- * GitHub Pages site so the JSON Schema is fetchable by third-party agents
- * and validators that look up `catalogId`.
+ * Stable URI identifying the Notion block catalog. Lives under the
+ * `elmethis` GitHub Pages site so the JSON Schema is fetchable by
+ * third-party agents and validators that look up `catalogId`.
  */
-declare const BLOCK_CATALOG_ID = "https://46ki75.github.io/elmethis/a2ui/v0_9/block_catalog.json";
-declare const blockCatalogJson: AssembledCatalog;
+declare const NOTION_BLOCK_CATALOG_ID = "https://46ki75.github.io/elmethis/a2ui/v0_9/notion_block_catalog.json";
+declare const notionBlockCatalogJson: AssembledCatalog;
 //#endregion
 //#region src/icon/languages/types.d.ts
 /**
@@ -3949,4 +3952,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, 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 };
+export { type AssembledCatalog, AudioApi, 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, NOTION_BLOCK_CATALOG_ID, NotionCalloutApi, ParagraphApi, RichTextApi, RowApi, type SvgNode, TableApi, TableCellApi, TableRowApi, ToggleApi, UnsupportedApi, VideoApi, assembleCatalog, languageIcons, normalizeLanguage, notionBlockCatalogJson };

package/dist/index.mjs

@@ -2,7 +2,7 @@ import { z } from "zod";
 import { AccessibilityAttributesSchema, ChildListSchema, DataBindingSchema, DynamicBooleanSchema, DynamicNumberSchema, DynamicStringListSchema, DynamicStringSchema, DynamicValueSchema, FunctionCallSchema } from "@a2ui/web_core/v0_9";
 import { RowApi } from "@a2ui/web_core/v0_9/basic_catalog";
 import { zodToJsonSchema } from "zod-to-json-schema";
-//#region src/a2ui/v0_9/block-catalog.ts
+//#region src/a2ui/v0_9/notion-block-catalog.ts
 const CommonProps = {
 	accessibility: AccessibilityAttributesSchema.optional(),
 	weight: z.number().describe("The relative weight of this component within a Row or Column. This is similar to the CSS 'flex-grow' property. Note: this may ONLY be set when the component is a direct descendant of a Row or Column.").optional()
@@ -276,9 +276,10 @@ const HtmlApi = {
 	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(),
-		allowScripts: z.boolean().describe("Allow the embedded content to run JavaScript (adds the iframe sandbox's `allow-scripts` token). Defaults to false — script execution is disabled by default. `allow-same-origin` is never granted together with this, in `html` or `src` mode, so the embedded document can never escape the sandbox even with scripts enabled.").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, or a same-origin asset). Mutually exclusive with `html` — provide exactly one of the two. `autoHeight` can still measure a same-origin `src`, but not a genuinely cross-origin one, 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. Has no effect on genuinely cross-origin `src` content, or on any content once `allowScripts` is on (measuring requires DOM access the sandbox never grants alongside script execution) — `height` is the fallback size for those cases.").optional(),
+		allowScripts: z.boolean().describe("Allow the embedded content to run JavaScript (adds the iframe sandbox's `allow-scripts` token). Defaults to true when rendered through the Notion block catalog — pass `false` explicitly to disable script execution. (The underlying `ElmHtml` component still defaults to `false` when used directly, outside the A2UI catalog.) `allow-same-origin` is never granted together with this, in `html` or `src` mode, so the embedded document can never escape the sandbox even with scripts enabled.").optional(),
+		height: z.number().describe("Fallback pixel height for the iframe, used whenever `autoHeight` can't measure the actual content (e.g. `allowScripts` content, or a genuinely cross-origin `src`). Defaults to 400 when omitted. Ignored once `autoHeight` successfully measures real content — it only ever applies as a starting/fallback size, never a hard cap.").optional()
 	}).strict()
 };
 const CodeBlockApi = {
@@ -638,29 +639,30 @@ function assembleCatalog(envelope, components) {
 	};
 }
 //#endregion
-//#region src/a2ui/v0_9/block-catalog-json.ts
+//#region src/a2ui/v0_9/notion-block-catalog-json.ts
 /**
 * Method A — runtime catalog constant.
 *
-* Assembles the block catalog from the `*Api` Zod definitions into a
+* Assembles the Notion block catalog from the `*Api` Zod definitions into a
 * freestanding A2UI v0.9 catalog JSON Schema document. Consumers that want
 * the catalog at runtime (e.g. to feed into an LLM system prompt or to
-* validate an inbound A2UI message) import `blockCatalogJson` directly.
+* validate an inbound A2UI message) import `notionBlockCatalogJson` directly.
 *
 * Consumers that want the document as a hostable artifact use Method B:
-* `dist/a2ui/block_catalog.json` is emitted at build time from this same
-* constant and is served at the URL identified by `BLOCK_CATALOG_ID`.
+* `dist/a2ui/notion_block_catalog.json` is emitted at build time from this
+* same constant and is served at the URL identified by
+* `NOTION_BLOCK_CATALOG_ID`.
 */
 /**
-* Stable URI identifying the block catalog. Lives under the `elmethis`
-* GitHub Pages site so the JSON Schema is fetchable by third-party agents
-* and validators that look up `catalogId`.
+* Stable URI identifying the Notion block catalog. Lives under the
+* `elmethis` GitHub Pages site so the JSON Schema is fetchable by
+* third-party agents and validators that look up `catalogId`.
 */
-const BLOCK_CATALOG_ID = "https://46ki75.github.io/elmethis/a2ui/v0_9/block_catalog.json";
-const blockCatalogJson = assembleCatalog({
-	id: BLOCK_CATALOG_ID,
-	title: "Elmethis Block Catalog",
-	description: "Block-level A2UI components used by the @elmethis renderers (typography, media, code, math, table, tabs). Extends — does not replace — the A2UI Basic Catalog."
+const NOTION_BLOCK_CATALOG_ID = "https://46ki75.github.io/elmethis/a2ui/v0_9/notion_block_catalog.json";
+const notionBlockCatalogJson = assembleCatalog({
+	id: NOTION_BLOCK_CATALOG_ID,
+	title: "Elmethis Notion Block Catalog",
+	description: "Notion block-level A2UI components used by the @elmethis renderers (typography, media, code, math, table, tabs). Extends — does not replace — the A2UI Basic Catalog."
 }, [
 	RichTextApi,
 	LinkTextApi,
@@ -1283,4 +1285,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, HtmlApi, IconApi, KatexApi, LANGUAGES, LinkTextApi, ListApi, ListItemApi, MermaidApi, NotionCalloutApi, ParagraphApi, RichTextApi, RowApi, TableApi, TableCellApi, TableRowApi, ToggleApi, UnsupportedApi, VideoApi, assembleCatalog, blockCatalogJson, languageIcons, normalizeLanguage };
+export { AudioApi, BlockImageApi, BlockQuoteApi, BookmarkApi, CalloutApi, CodeBlockApi, ColumnApi, ColumnListApi, ContentTabApi, ContentTabsApi, DividerApi, FileApi, HeadingApi, HtmlApi, IconApi, KatexApi, LANGUAGES, LinkTextApi, ListApi, ListItemApi, MermaidApi, NOTION_BLOCK_CATALOG_ID, NotionCalloutApi, ParagraphApi, RichTextApi, RowApi, TableApi, TableCellApi, TableRowApi, ToggleApi, UnsupportedApi, VideoApi, assembleCatalog, languageIcons, normalizeLanguage, notionBlockCatalogJson };

package/package.json

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