@ai-matrx/rich-content 0.0.0 → 0.2.2

package/dist/markdown-core/syntax/callout-types.d.ts

@@ -0,0 +1,9 @@
+export declare const CALLOUT_TYPES: readonly ["note", "tip", "important", "warning", "caution", "info", "success", "question", "quote"];
+export type CalloutType = (typeof CALLOUT_TYPES)[number];
+export declare function resolveCalloutType(name: string | undefined | null): CalloutType | null;
+export declare const CALLOUT_LABEL: Readonly<Record<CalloutType, string>>;
+/** Frame (border + wash) and title colour per type — light and dark. */
+export declare const CALLOUT_CLASSES: Readonly<Record<CalloutType, {
+    frame: string;
+    title: string;
+}>>;

package/dist/markdown-core/syntax/callout-types.js

@@ -0,0 +1,101 @@
+const CALLOUT_TYPES = [
+  "note",
+  "tip",
+  "important",
+  "warning",
+  "caution",
+  "info",
+  "success",
+  "question",
+  "quote"
+];
+const ALIASES = {
+  note: "note",
+  seealso: "note",
+  example: "note",
+  tip: "tip",
+  hint: "tip",
+  important: "important",
+  warning: "warning",
+  warn: "warning",
+  attention: "warning",
+  caution: "caution",
+  danger: "caution",
+  error: "caution",
+  failure: "caution",
+  fail: "caution",
+  missing: "caution",
+  bug: "caution",
+  info: "info",
+  abstract: "info",
+  summary: "info",
+  tldr: "info",
+  todo: "info",
+  success: "success",
+  check: "success",
+  done: "success",
+  question: "question",
+  help: "question",
+  faq: "question",
+  quote: "quote",
+  cite: "quote"
+};
+function resolveCalloutType(name) {
+  if (!name) return null;
+  return ALIASES[name.trim().toLowerCase()] ?? null;
+}
+const CALLOUT_LABEL = {
+  note: "Note",
+  tip: "Tip",
+  important: "Important",
+  warning: "Warning",
+  caution: "Caution",
+  info: "Info",
+  success: "Success",
+  question: "Question",
+  quote: "Quote"
+};
+const CALLOUT_CLASSES = {
+  note: {
+    frame: "border-blue-500/70 bg-blue-500/5 dark:border-blue-400/70 dark:bg-blue-400/10",
+    title: "text-blue-700 dark:text-blue-300"
+  },
+  tip: {
+    frame: "border-emerald-500/70 bg-emerald-500/5 dark:border-emerald-400/70 dark:bg-emerald-400/10",
+    title: "text-emerald-700 dark:text-emerald-300"
+  },
+  important: {
+    frame: "border-violet-500/70 bg-violet-500/5 dark:border-violet-400/70 dark:bg-violet-400/10",
+    title: "text-violet-700 dark:text-violet-300"
+  },
+  warning: {
+    frame: "border-amber-500/80 bg-amber-500/5 dark:border-amber-400/70 dark:bg-amber-400/10",
+    title: "text-amber-700 dark:text-amber-300"
+  },
+  caution: {
+    frame: "border-red-500/70 bg-red-500/5 dark:border-red-400/70 dark:bg-red-400/10",
+    title: "text-red-700 dark:text-red-300"
+  },
+  info: {
+    frame: "border-sky-500/70 bg-sky-500/5 dark:border-sky-400/70 dark:bg-sky-400/10",
+    title: "text-sky-700 dark:text-sky-300"
+  },
+  success: {
+    frame: "border-green-600/70 bg-green-600/5 dark:border-green-400/70 dark:bg-green-400/10",
+    title: "text-green-700 dark:text-green-300"
+  },
+  question: {
+    frame: "border-indigo-500/70 bg-indigo-500/5 dark:border-indigo-400/70 dark:bg-indigo-400/10",
+    title: "text-indigo-700 dark:text-indigo-300"
+  },
+  quote: {
+    frame: "border-zinc-400/80 bg-zinc-500/5 dark:border-zinc-500/80 dark:bg-zinc-400/10",
+    title: "text-zinc-600 dark:text-zinc-300"
+  }
+};
+export {
+  CALLOUT_CLASSES,
+  CALLOUT_LABEL,
+  CALLOUT_TYPES,
+  resolveCalloutType
+};

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

@@ -0,0 +1,17 @@
+import { type CalloutType } from "./callout-types.js";
+import { type MNode, type SyntaxFile } from "./mdast-helpers.js";
+type Fold = "none" | "closed" | "open";
+/** Build the one callout node. `title` null → the type's own label. */
+export declare function calloutNode(type: CalloutType, title: MNode[] | null, body: MNode[], fold: Fold): MNode;
+/** The default `==highlight==` / `:mark[…]` wash. */
+export declare const MARK_CLASS: string[];
+export declare const KBD_CLASS: string[];
+/** The table-of-contents placeholder; the rehype pass fills it from the headings. */
+export declare function tocNode(): MNode;
+/**
+ * Resolve every directive and GitHub/Obsidian callout in the tree, children
+ * first (so a callout inside a tab or a tab inside a column is already
+ * resolved when its parent is built).
+ */
+export declare function transformContainers(node: MNode, file: SyntaxFile | undefined): void;
+export {};

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

@@ -0,0 +1,353 @@
+import {
+  CALLOUT_CLASSES,
+  CALLOUT_LABEL,
+  resolveCalloutType
+} from "./callout-types.js";
+import { CONTAINER_DIRECTIVES, LEAF_DIRECTIVES, TEXT_DIRECTIVES } from "./names.js";
+import { el, mergeText, rawOf, text, toText } from "./mdast-helpers.js";
+function calloutNode(type, title, body, fold) {
+  const colors = CALLOUT_CLASSES[type];
+  const foldable = fold !== "none";
+  const titleChildren = [
+    el("matrx-callout-icon", { dataType: type }),
+    // A default title ("Note") is renderer text, not the source's: marked as content chrome.
+    title && title.length > 0 ? el("span", { className: ["min-w-0"] }, title) : el("span", { className: ["min-w-0"], dataContentChrome: true }, [text(CALLOUT_LABEL[type])])
+  ];
+  if (foldable) titleChildren.push(el("matrx-callout-icon", { dataType: "chevron" }));
+  const titleNode = el(
+    foldable ? "summary" : "div",
+    {
+      className: [
+        "matrx-callout-title",
+        "flex",
+        "items-center",
+        "gap-2",
+        "text-sm",
+        "font-semibold",
+        colors.title,
+        ...foldable ? ["cursor-pointer", "list-none", "select-none", "[&::-webkit-details-marker]:hidden"] : []
+      ]
+    },
+    titleChildren
+  );
+  const bodyNode = el(
+    "div",
+    {
+      className: [
+        "matrx-callout-body",
+        "mt-1.5",
+        "text-sm",
+        "text-foreground",
+        "[&>*:last-child]:mb-0",
+        "[&>*:first-child]:mt-0"
+      ]
+    },
+    body
+  );
+  return el(
+    foldable ? "details" : "div",
+    {
+      className: [
+        "matrx-callout",
+        "group/callout",
+        "my-3",
+        "rounded-md",
+        "border-l-4",
+        "px-3",
+        "py-2",
+        colors.frame
+      ],
+      dataCallout: type,
+      ...foldable ? {} : { role: "note" },
+      ...fold === "open" ? { open: true } : {}
+    },
+    body.length > 0 ? [titleNode, bodyNode] : [titleNode],
+    "matrxCallout"
+  );
+}
+const ALERT_MARKER = /^\[!([A-Za-z][\w-]*)\]([+-])?[ \t]*/;
+function blockquoteToCallout(node) {
+  const first = node.children?.[0];
+  if (!first || first.type !== "paragraph" || !first.children?.length) return null;
+  const lead = first.children[0];
+  if (!lead || lead.type !== "text") return null;
+  const match = ALERT_MARKER.exec(lead.value ?? "");
+  if (!match) return null;
+  const type = resolveCalloutType(match[1]);
+  if (!type) return null;
+  const fold = match[2] === "-" ? "closed" : match[2] === "+" ? "open" : "none";
+  const rest = [{ ...lead, value: (lead.value ?? "").slice(match[0].length) }, ...first.children.slice(1)];
+  const title = [];
+  const bodyInline = [];
+  let inBody = false;
+  for (const child of rest) {
+    if (inBody) {
+      bodyInline.push(child);
+      continue;
+    }
+    if (child.type === "break") {
+      inBody = true;
+      continue;
+    }
+    if (child.type === "text" && (child.value ?? "").includes("\n")) {
+      const value = child.value ?? "";
+      const cut = value.indexOf("\n");
+      if (cut > 0) title.push(text(value.slice(0, cut)));
+      const after = value.slice(cut + 1);
+      if (after) bodyInline.push(text(after));
+      inBody = true;
+      continue;
+    }
+    title.push(child);
+  }
+  const titleNodes = title.filter((n) => !(n.type === "text" && !(n.value ?? "").trim()));
+  const body = [];
+  if (bodyInline.some((n) => !(n.type === "text" && !(n.value ?? "").trim()))) {
+    body.push({ type: "paragraph", children: bodyInline });
+  }
+  body.push(...node.children?.slice(1) ?? []);
+  return calloutNode(type, titleNodes.length > 0 ? titleNodes : null, body, fold);
+}
+function splitLabel(node) {
+  const children = node.children ?? [];
+  const first = children[0];
+  if (first && first.data?.directiveLabel) {
+    return { label: first.children ?? [], body: children.slice(1) };
+  }
+  return { label: null, body: children };
+}
+function attr(node, key) {
+  const attrs = node.attributes;
+  if (!attrs || !(key in attrs)) return void 0;
+  return attrs[key] ?? null;
+}
+function foldOf(node) {
+  const value = attr(node, "fold") ?? attr(node, "collapse") ?? attr(node, "collapsed");
+  if (value === void 0) return "none";
+  if (value === "open" || value === "false") return "open";
+  return "closed";
+}
+const TEXT_COLORS = {
+  red: "text-red-600 dark:text-red-400",
+  orange: "text-orange-600 dark:text-orange-400",
+  amber: "text-amber-600 dark:text-amber-400",
+  yellow: "text-yellow-600 dark:text-yellow-300",
+  green: "text-green-600 dark:text-green-400",
+  teal: "text-teal-600 dark:text-teal-400",
+  blue: "text-blue-600 dark:text-blue-400",
+  indigo: "text-indigo-600 dark:text-indigo-400",
+  purple: "text-purple-600 dark:text-purple-400",
+  pink: "text-pink-600 dark:text-pink-400",
+  gray: "text-zinc-500 dark:text-zinc-400",
+  muted: "text-muted-foreground",
+  primary: "text-primary",
+  success: "text-green-600 dark:text-green-400",
+  warning: "text-amber-600 dark:text-amber-400",
+  danger: "text-red-600 dark:text-red-400",
+  info: "text-sky-600 dark:text-sky-400"
+};
+const HIGHLIGHT_COLORS = {
+  yellow: "bg-yellow-200/70 dark:bg-yellow-400/25",
+  green: "bg-green-200/70 dark:bg-green-400/25",
+  blue: "bg-blue-200/70 dark:bg-blue-400/25",
+  pink: "bg-pink-200/70 dark:bg-pink-400/25",
+  purple: "bg-purple-200/70 dark:bg-purple-400/25",
+  orange: "bg-orange-200/70 dark:bg-orange-400/25",
+  red: "bg-red-200/70 dark:bg-red-400/25",
+  gray: "bg-zinc-200/80 dark:bg-zinc-500/30",
+  success: "bg-green-200/70 dark:bg-green-400/25",
+  warning: "bg-amber-200/70 dark:bg-amber-400/25",
+  danger: "bg-red-200/70 dark:bg-red-400/25",
+  info: "bg-sky-200/70 dark:bg-sky-400/25"
+};
+const MARK_CLASS = ["rounded-sm", "px-0.5", "text-inherit", "bg-yellow-200/70", "dark:bg-yellow-400/25"];
+const KBD_CLASS = [
+  "rounded",
+  "border",
+  "border-border",
+  "border-b-2",
+  "bg-muted",
+  "px-1.5",
+  "py-px",
+  "font-mono",
+  "text-[0.8em]",
+  "text-foreground"
+];
+function colorClass(value, table) {
+  if (!value) return [];
+  const cls = table[value.trim().toLowerCase()];
+  return cls ? cls.split(" ") : [];
+}
+function textDirective(node, file) {
+  const name = (node.name ?? "").toLowerCase();
+  const children = node.children ?? [];
+  if (!TEXT_DIRECTIVES.has(name) || children.length === 0) {
+    return text(rawOf(node, file) ?? `:${node.name ?? ""}`);
+  }
+  const color = attr(node, "color") ?? attr(node, "fg");
+  const bg = attr(node, "bg") ?? attr(node, "background");
+  switch (name) {
+    case "span": {
+      const classes = [...colorClass(color, TEXT_COLORS), ...colorClass(bg, HIGHLIGHT_COLORS)];
+      if (bg && classes.length > 0) classes.push("rounded-sm", "px-0.5");
+      return el("span", classes.length > 0 ? { className: classes, dataColor: color ?? bg ?? void 0 } : {}, children);
+    }
+    case "mark": {
+      const wash = colorClass(bg ?? color, HIGHLIGHT_COLORS);
+      return el(
+        "mark",
+        { className: wash.length > 0 ? ["rounded-sm", "px-0.5", "text-inherit", ...wash] : MARK_CLASS },
+        children
+      );
+    }
+    case "kbd":
+      return el("kbd", { className: KBD_CLASS }, children);
+    case "abbr":
+      return el("abbr", { title: attr(node, "title") ?? void 0, className: ["cursor-help", "underline", "decoration-dotted"] }, children);
+    case "sup":
+    case "sub":
+      return el(name, {}, children);
+    default:
+      return text(rawOf(node, file) ?? `:${node.name ?? ""}`);
+  }
+}
+function tocNode() {
+  return el("matrx-toc", {}, [], "matrxToc");
+}
+function hasFence(nodes) {
+  return nodes.some((n) => n.type === "code" || n.type !== "matrxNested" && !!n.children && hasFence(n.children));
+}
+function nestBlockyBody(body, file) {
+  if (body.length === 0 || !hasFence(body)) return body;
+  const source = typeof file?.value === "string" ? file.value : null;
+  const start = body[0]?.position?.start.offset;
+  const end = body[body.length - 1]?.position?.end.offset;
+  if (source === null || start === void 0 || end === void 0) return body;
+  return [el("matrx-nested", { dataSource: source.slice(start, end) }, [], "matrxNested")];
+}
+function containerDirective(node, file) {
+  const name = (node.name ?? "").toLowerCase();
+  const split = splitLabel(node);
+  const label = split.label;
+  const body = nestBlockyBody(split.body, file);
+  const callout = resolveCalloutType(name);
+  if (callout && !CONTAINER_DIRECTIVES.has(name)) {
+    return calloutNode(callout, label, body, foldOf(node));
+  }
+  const id = attr(node, "id") ?? void 0;
+  switch (name) {
+    case "details": {
+      const open = attr(node, "open") !== void 0;
+      return el("details", { ...open ? { open: true } : {}, id }, [
+        el("summary", {}, label && label.length > 0 ? label : [text("Details")]),
+        el("div", { className: ["matrx-details-body"] }, body)
+      ]);
+    }
+    case "columns": {
+      const count = body.filter((c) => c.type === "matrxColumn").length;
+      const cols = count >= 3 ? "md:grid-cols-3" : "md:grid-cols-2";
+      return el("div", { className: ["matrx-columns", "my-3", "grid", "grid-cols-1", "gap-4", cols], id }, body);
+    }
+    case "column": {
+      const lead = label && label.length > 0 ? [{ type: "paragraph", children: label }] : [];
+      return el("div", { className: ["matrx-column", "min-w-0", "[&>*:first-child]:mt-0"] }, [...lead, ...body], "matrxColumn");
+    }
+    case "tabs": {
+      const tabs = body.filter((c) => c.type === "matrxTab");
+      const labels = tabs.map((t, i) => String(t.data?.hProperties?.dataLabel ?? `Tab ${i + 1}`));
+      return el("matrx-tabs", { dataLabels: JSON.stringify(labels), id }, tabs);
+    }
+    case "tab": {
+      const tabLabel = (label ?? []).map(toText).join("").trim() || attr(node, "title") || attr(node, "label") || "";
+      return el("matrx-tab", { dataLabel: tabLabel }, body, "matrxTab");
+    }
+    case "figure":
+    case "table": {
+      const figure = el(
+        "figure",
+        {
+          className: [name === "table" ? "matrx-table-figure" : "matrx-figure", "my-4"],
+          id
+        },
+        body,
+        "matrxFigure"
+      );
+      figure.matrxFigure = { kind: name === "table" ? "tbl" : "fig", caption: label ?? [], id: id ?? null };
+      return figure;
+    }
+    case "aside":
+      return el(
+        "aside",
+        {
+          className: ["matrx-aside", "my-3", "rounded-md", "border", "border-border", "bg-muted/40", "px-3", "py-2", "text-sm", "[&>*:last-child]:mb-0"],
+          id
+        },
+        label && label.length > 0 ? [el("p", { className: ["font-semibold"] }, label), ...body] : body
+      );
+    case "toc":
+      return tocNode();
+    default:
+      return el(
+        "div",
+        { className: ["matrx-directive"], dataDirective: name, id },
+        label && label.length > 0 ? [{ type: "paragraph", children: label }, ...body] : body
+      );
+  }
+}
+function leafDirective(node, file) {
+  const name = (node.name ?? "").toLowerCase();
+  if (LEAF_DIRECTIVES.has(name) && name === "toc") return tocNode();
+  return { type: "paragraph", children: [text(rawOf(node, file) ?? `::${node.name ?? ""}`)] };
+}
+const STRAY_CLOSER = /^:{3,}$/;
+function transformContainers(node, file) {
+  const children = node.children;
+  if (!children) return;
+  for (const child of children) transformContainers(child, file);
+  const next = [];
+  let changed = false;
+  for (const child of children) {
+    switch (child.type) {
+      case "textDirective":
+        next.push(textDirective(child, file));
+        changed = true;
+        continue;
+      case "leafDirective":
+        next.push(leafDirective(child, file));
+        changed = true;
+        continue;
+      case "containerDirective":
+        next.push({ ...containerDirective(child, file), position: child.position });
+        changed = true;
+        continue;
+      case "blockquote": {
+        const callout = blockquoteToCallout(child);
+        if (callout) {
+          next.push(callout);
+          changed = true;
+          continue;
+        }
+        break;
+      }
+      case "paragraph": {
+        const only = child.children?.length === 1 ? child.children[0] : null;
+        if (only?.type === "text" && STRAY_CLOSER.test((only.value ?? "").trim())) {
+          changed = true;
+          continue;
+        }
+        break;
+      }
+      default:
+        break;
+    }
+    next.push(child);
+  }
+  if (changed) node.children = mergeText(next);
+}
+export {
+  KBD_CLASS,
+  MARK_CLASS,
+  calloutNode,
+  tocNode,
+  transformContainers
+};

package/dist/markdown-core/syntax/document-numbering.d.ts

@@ -0,0 +1,52 @@
+export interface NumberedTarget {
+    kind: "fig" | "tbl" | "eq" | "sec";
+    /** "Figure 2", "Table 1", "(3)", or a section's heading text. */
+    display: string;
+}
+export interface DocumentNumbering {
+    /** Labelled targets by label. */
+    byLabel: Map<string, NumberedTarget>;
+    /** Unlabelled figures/tables by `kind|caption`, in document order (one entry per occurrence). */
+    byCaption: Map<string, string[]>;
+    /**
+     * Footnote identifier (lower-case) → its number, exactly as GFM numbers the
+     * whole document: defined labels only, body references in order of first
+     * reference, then references inside the notes. A label absent here is either
+     * undefined (the reference stays text) or never cited (the note is dropped).
+     */
+    footnotes: Map<string, number>;
+    /**
+     * The cited notes' definitions exactly as written (`[^x]: …` plus their
+     * continuation lines), in number order, "" when none. The document root
+     * renders them ONCE, after its last block (DocumentFootnotes), as GFM places
+     * notes after the whole document; a block never renders a definition itself.
+     */
+    footnoteMarkdown: string;
+    /**
+     * The document's link reference definitions as canonical definition lines
+     * (`[label]: <url> "title"`), "" when none — every block resolves its
+     * `[text][label]` references against them (prepareCoreSource), so a block
+     * split from them still shows the link GFM shows.
+     */
+    linkDefinitions: string;
+}
+export declare function captionKey(kind: "fig" | "tbl", caption: string): string;
+export declare function computeDocumentNumbering(source: string): DocumentNumbering;
+/**
+ * The first line of the document's footnote block: the root renders
+ * `documentFootnoteSource(numbering)` through its ordinary prose path after its
+ * last block, and the syntax pass (remarkMatrxSyntax) renders the notes' section
+ * ONLY in the tree that carries this line.
+ */
+export declare const DOCUMENT_FOOTNOTES_MARKER = "<!-- matrx:document-footnotes -->";
+/** The markdown of the document's one footnote section, or "" when nothing is cited. */
+export declare function documentFootnoteSource(numbering: DocumentNumbering | null | undefined): string;
+/**
+ * Same numbers? Two numberings that assign every label, caption and footnote
+ * the same display are interchangeable. The document root re-computes the
+ * numbering on every edit and every stream chunk; handing every MarkdownCore
+ * leaf a NEW object each time made every leaf of the document re-parse on
+ * every keystroke (the markdown-tester browser crash, 2026-09-26). The
+ * provider keeps the previous object whenever this says nothing changed.
+ */
+export declare function sameDocumentNumbering(a: DocumentNumbering, b: DocumentNumbering): boolean;