@ai-matrx/rich-content 0.2.56 → 0.2.57

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 0.2.57
+### parse5 and the YAML parser leave the first screen
+
+- The raw-HTML tag allow-list lives alone in `./display/chat-markdown/raw-html-tags`
+  (`rehypeSafeRawHtml` re-exports it). The content splitter, table vectors and prose prep read only the
+  list, and importing it from `rehypeSafeRawHtml` dragged hast-util-from-html + parse5 into every chat.
+- Front matter: the YAML and TOML parsers load the first time a document has front matter.
+  `extractFrontmatter` returns `pending: true` (empty properties) until `loadFrontmatterParsers()`
+  resolves; `useDocumentProperties` re-reads by itself. `splitFrontmatter` / `hasUnclosedFrontmatter`
+  are unchanged. Chat's first screen: about −88 kB gzip with both.
+
+Consumer action: none (a direct caller of `extractFrontmatter` that needs the parsed properties at
+once awaits `loadFrontmatterParsers()` first).
+
+### tap-target comes from design-system
+
+- Imports `@ai-matrx/design-system/tap-target` (and `/tap-target/buttons`, `tap-target.css`) instead of the
+  retired `@ai-matrx/tap-target` (Arman, 2026-10-08: tap-target merges into design-system); the
+  `@ai-matrx/tap-target` dependency is dropped.
+
+Consumer action: none.
+
 ## 0.2.56 — the Alchemy palette loads on first use
 
 - THE PAY-ONLY-FOR-WHAT-YOU-USE LAW: `rich-document/variants/ActionBar` lazy-loads `AlchemyDocumentMenu`

package/dist/display/chat-markdown/raw-html-tags.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Tags a model may emit as raw HTML that we render. Kept in sync with the
+ * pre-escape gate in BasicMarkdownContent (`preprocessContent`) — a tag left
+ * un-escaped there must be allowed here, or it renders as literal text.
+ * Deliberately excludes `div` (layout container — Case 4) and any scripting or
+ * embedding tags (`script`, `style`, `iframe`, `object`, `embed`, `form`…).
+ */
+export declare const ALLOWED_RAW_HTML_TAGS: ReadonlySet<string>;

package/dist/display/chat-markdown/raw-html-tags.js

@@ -0,0 +1,57 @@
+const ALLOWED_RAW_HTML_TAGS = /* @__PURE__ */ new Set([
+  // media
+  "img",
+  // links + breaks + rules
+  "a",
+  "br",
+  "hr",
+  // inline text semantics
+  "span",
+  "p",
+  "strong",
+  "b",
+  "em",
+  "i",
+  "u",
+  "s",
+  "del",
+  "ins",
+  "sup",
+  "sub",
+  "mark",
+  "kbd",
+  "abbr",
+  "small",
+  "code",
+  "pre",
+  // lists + quotes + headings
+  "ul",
+  "ol",
+  "li",
+  "blockquote",
+  "h1",
+  "h2",
+  "h3",
+  "h4",
+  "h5",
+  "h6",
+  // tables
+  "table",
+  "thead",
+  "tbody",
+  "tfoot",
+  "tr",
+  "th",
+  "td",
+  "caption",
+  "colgroup",
+  "col",
+  "figure",
+  "figcaption",
+  // collapsible sections (styled by the core's details/summary elements)
+  "details",
+  "summary"
+]);
+export {
+  ALLOWED_RAW_HTML_TAGS
+};

package/dist/display/chat-markdown/rehypeSafeRawHtml.d.ts

@@ -28,6 +28,8 @@
  */
 import { type Schema } from "hast-util-sanitize";
 import type { Root } from "hast";
+import { ALLOWED_RAW_HTML_TAGS } from "./raw-html-tags.js";
+export { ALLOWED_RAW_HTML_TAGS };
 declare module "hast" {
     interface Data {
         /**
@@ -41,14 +43,6 @@ declare module "hast" {
         matrxRawHtmlTable?: boolean;
     }
 }
-/**
- * Tags a model may emit as raw HTML that we render. Kept in sync with the
- * pre-escape gate in BasicMarkdownContent (`preprocessContent`) — a tag left
- * un-escaped there must be allowed here, or it renders as literal text.
- * Deliberately excludes `div` (layout container — Case 4) and any scripting or
- * embedding tags (`script`, `style`, `iframe`, `object`, `embed`, `form`…).
- */
-export declare const ALLOWED_RAW_HTML_TAGS: ReadonlySet<string>;
 /**
  * Sanitization schema for raw-HTML subtrees. Any tag not listed is dropped, any
  * attribute not listed is stripped (so `onerror`, `onclick`, inline `style`,

package/dist/display/chat-markdown/rehypeSafeRawHtml.js

@@ -1,63 +1,10 @@
 import { visit } from "unist-util-visit";
 import { fromHtml } from "hast-util-from-html";
 import { sanitize } from "hast-util-sanitize";
+import { ALLOWED_RAW_HTML_TAGS } from "./raw-html-tags.js";
 function isRawNode(node) {
   return typeof node === "object" && node !== null && node.type === "raw" && typeof node.value === "string";
 }
-const ALLOWED_RAW_HTML_TAGS = /* @__PURE__ */ new Set([
-  // media
-  "img",
-  // links + breaks + rules
-  "a",
-  "br",
-  "hr",
-  // inline text semantics
-  "span",
-  "p",
-  "strong",
-  "b",
-  "em",
-  "i",
-  "u",
-  "s",
-  "del",
-  "ins",
-  "sup",
-  "sub",
-  "mark",
-  "kbd",
-  "abbr",
-  "small",
-  "code",
-  "pre",
-  // lists + quotes + headings
-  "ul",
-  "ol",
-  "li",
-  "blockquote",
-  "h1",
-  "h2",
-  "h3",
-  "h4",
-  "h5",
-  "h6",
-  // tables
-  "table",
-  "thead",
-  "tbody",
-  "tfoot",
-  "tr",
-  "th",
-  "td",
-  "caption",
-  "colgroup",
-  "col",
-  "figure",
-  "figcaption",
-  // collapsible sections (styled by the core's details/summary elements)
-  "details",
-  "summary"
-]);
 const RAW_HTML_SCHEMA = {
   tagNames: Array.from(ALLOWED_RAW_HTML_TAGS),
   attributes: {

package/dist/display/markdown-classification/processors/utils/content-splitter-core.js

@@ -32,7 +32,7 @@ import {
 } from "@ai-matrx/content-ir/surfaces";
 import { unwrapKindImageAlt } from "@ai-matrx/content-ir/surfaces";
 import { IR_ENVELOPE_KEY } from "@ai-matrx/content-ir";
-import { ALLOWED_RAW_HTML_TAGS } from "../../../chat-markdown/rehypeSafeRawHtml.js";
+import { ALLOWED_RAW_HTML_TAGS } from "../../../chat-markdown/raw-html-tags.js";
 import { isPageBreakLine } from "@ai-matrx/print/directives";
 import { readXmlTag } from "@ai-matrx/content-ir/source";
 import { FENCE_META_KEY, splitFenceInfo } from "@ai-matrx/content-ir/source";

package/dist/display/markdown-classification/processors/utils/gfm-table-vectors.js

@@ -4,7 +4,7 @@ import { parseMarkdownTable } from "../../../blocks/table/parseMarkdownTable.js"
 import { splitContentIntoBlocksV2 } from "./content-splitter-v2.js";
 import { findTableEnd, tableStartsAt } from "./gfm-table-lines.js";
 import { isHtmlBlockTagName } from "@ai-matrx/content-ir/source";
-import { ALLOWED_RAW_HTML_TAGS } from "../../../chat-markdown/rehypeSafeRawHtml.js";
+import { ALLOWED_RAW_HTML_TAGS } from "../../../chat-markdown/raw-html-tags.js";
 import { CELL_INPUTS, DOCUMENT_INPUTS, HTML_TAG_NAME_INPUTS, ROW_INPUTS, TABLE_END_INPUTS, TABLE_INPUTS, TABLE_OPEN_INPUTS, TABLE_START_INPUTS } from "./gfm-table-vector-inputs.js";
 function computeGfmTableVectors() {
   return {

package/dist/display/tables/MarkdownTableScrollArea.js

@@ -4,7 +4,7 @@ import { useEffect, useRef, useState } from "react";
 import {
   ChevronLeftTapButton,
   ChevronRightTapButton
-} from "@ai-matrx/tap-target/buttons";
+} from "@ai-matrx/design-system/tap-target/buttons";
 import { cn } from "@ai-matrx/design-system";
 const EDGE_TOLERANCE_PX = 2;
 function MarkdownTableScrollArea({

package/dist/levels/prose/prose-prepare.js

@@ -1,4 +1,4 @@
-import { ALLOWED_RAW_HTML_TAGS } from "../../display/chat-markdown/rehypeSafeRawHtml.js";
+import { ALLOWED_RAW_HTML_TAGS } from "../../display/chat-markdown/raw-html-tags.js";
 import { splitFrontmatter } from "../../markdown-core/syntax/frontmatter.js";
 import { fenceLineKinds, lineIndent, opensStrippedHtmlBlock } from "@ai-matrx/content-ir/source";
 import { fromMarkdown } from "mdast-util-from-markdown";

package/dist/markdown-core/syntax/frontmatter.d.ts

@@ -1,3 +1,9 @@
+type FrontmatterParsers = {
+    yaml: (text: string) => unknown;
+    toml: (text: string) => unknown;
+};
+/** Load the YAML + TOML parsers (once). `extractFrontmatter` answers fully after this resolves. */
+export declare function loadFrontmatterParsers(): Promise<FrontmatterParsers>;
 export type FrontmatterFormat = "yaml" | "toml";
 export interface FrontmatterSplit {
     format: FrontmatterFormat;
@@ -21,6 +27,12 @@ export interface DocumentPropertiesResult {
     raw: string | null;
     /** A sentence saying why the front matter could not be read, or null. */
     error: string | null;
+    /**
+     * True while the parsers are still loading (the first document with front matter): `properties`
+     * is `{}` until `loadFrontmatterParsers()` resolves; ask again then. `useDocumentProperties` does.
+     */
+    pending?: boolean;
 }
 /** Read a document's front matter as properties. Never throws. */
 export declare function extractFrontmatter(source: string): DocumentPropertiesResult;
+export {};

package/dist/markdown-core/syntax/frontmatter.js

@@ -1,5 +1,11 @@
-import { parse as parseYaml } from "yaml";
-import { parse as parseToml } from "smol-toml";
+let parsers = null;
+let parsersLoading = null;
+function loadFrontmatterParsers() {
+  return parsersLoading ??= Promise.all([import("yaml"), import("smol-toml")]).then(([yaml, toml]) => {
+    parsers = { yaml: yaml.parse, toml: toml.parse };
+    return parsers;
+  });
+}
 const OPEN = { "---": "yaml", "+++": "toml" };
 function splitFrontmatter(source) {
   if (!source) return null;
@@ -36,8 +42,12 @@ const EMPTY = { properties: {}, format: null, raw: null, error: null };
 function extractFrontmatter(source) {
   const split = splitFrontmatter(source);
   if (!split) return EMPTY;
+  if (!parsers) {
+    void loadFrontmatterParsers();
+    return { properties: {}, format: split.format, raw: split.raw, error: null, pending: true };
+  }
   try {
-    const parsed = split.format === "yaml" ? parseYaml(split.inner) : parseToml(split.inner);
+    const parsed = split.format === "yaml" ? parsers.yaml(split.inner) : parsers.toml(split.inner);
     if (parsed === null || parsed === void 0) {
       return { properties: {}, format: split.format, raw: split.raw, error: null };
     }
@@ -68,5 +78,6 @@ function extractFrontmatter(source) {
 export {
   extractFrontmatter,
   hasUnclosedFrontmatter,
+  loadFrontmatterParsers,
   splitFrontmatter
 };

package/dist/markdown-core/syntax/useDocumentProperties.d.ts

@@ -1,3 +1,3 @@
 import { type DocumentPropertiesResult } from "./frontmatter.js";
-/** The React Compiler memoizes this per `source`. */
+/** The React Compiler memoizes this per `source` (and parser readiness). */
 export declare function useDocumentProperties(source: string): DocumentPropertiesResult;

package/dist/markdown-core/syntax/useDocumentProperties.js

@@ -1,8 +1,23 @@
 "use client";
-import { extractFrontmatter } from "./frontmatter.js";
-function useDocumentProperties(source) {
+import { useEffect, useState } from "react";
+import { extractFrontmatter, loadFrontmatterParsers } from "./frontmatter.js";
+function readProperties(source, _parsersReady) {
   return extractFrontmatter(source);
 }
+function useDocumentProperties(source) {
+  const [parsersReady, setParsersReady] = useState(false);
+  const result = readProperties(source, parsersReady);
+  const pending = result.pending === true;
+  useEffect(() => {
+    if (!pending) return;
+    let live = true;
+    void loadFrontmatterParsers().then(() => live && setParsersReady(true));
+    return () => {
+      live = false;
+    };
+  }, [pending]);
+  return result;
+}
 export {
   useDocumentProperties
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/rich-content",
-  "version": "0.2.56",
+  "version": "0.2.57",
   "description": "The AI Matrx formatted-text engine: the one markdown renderer, streaming markdown, the block splitter and renderer, the generic blocks, <RichContent> levels, the rich-document action registry and menus, copy, and the selection toolbar — as portable React.",
   "type": "module",
   "license": "MIT",
@@ -130,21 +130,20 @@
     "unist-util-visit": "^5.1.0",
     "unist-util-visit-parents": "^6.0.2",
     "yaml": "^2.9.1",
-    "@ai-matrx/agents": "latest",
     "@ai-matrx/alchemy": "latest",
-    "@ai-matrx/canvas": "latest",
+    "@ai-matrx/agents": "latest",
     "@ai-matrx/content-ir": "latest",
     "@ai-matrx/content-ir-react": "latest",
     "@ai-matrx/data": "latest",
-    "@ai-matrx/design-system": "latest",
+    "@ai-matrx/canvas": "latest",
     "@ai-matrx/diff": "latest",
     "@ai-matrx/icons": "latest",
-    "@ai-matrx/kit": "latest",
-    "@ai-matrx/media": "latest",
     "@ai-matrx/print": "latest",
     "@ai-matrx/records": "latest",
     "@ai-matrx/records-ui": "latest",
-    "@ai-matrx/tap-target": "latest"
+    "@ai-matrx/design-system": "latest",
+    "@ai-matrx/kit": "latest",
+    "@ai-matrx/media": "latest"
   },
   "peerDependencies": {
     "react": ">=19.0.0",