@hearthscale/app-ui 0.1.0 → 0.2.0

package/dist/markdown.d.ts

@@ -0,0 +1,25 @@
+import * as react from 'react';
+
+/** What a reply's links reach. */
+interface MarkdownLinks {
+    /** A web address or a `hearthscale:` link the reply links to. */
+    open(href: string): void;
+    /** A file of the reply's turn named by its name: a picture's address
+     *  and what opening it does at the press that opened it, or null for no
+     *  such file. */
+    file(name: string): {
+        picture: string | Promise<string> | null;
+        open(at: HTMLElement): void;
+    } | null;
+}
+/** A reply's text as the transcript draws it. @category Chat */
+declare const Markdown: react.NamedExoticComponent<{
+    children: string;
+    links: MarkdownLinks;
+    /** How the reply shows while it is still arriving: its words as they
+     *  come, or a finished block at a time. */
+    streaming?: "tokens" | "blocks";
+}>;
+
+export { Markdown };
+export type { MarkdownLinks };

package/dist/markdown.js

@@ -0,0 +1,365 @@
+import {
+  CopyGlyph
+} from "./chunks/chunk-E3RFTBRS.js";
+
+// ../ui/dist/chat/markdown.js
+import { jsx as _jsx5, Fragment as _Fragment } from "react/jsx-runtime";
+import { Children, createContext as createContext2, isValidElement, memo, useContext as useContext2, useEffect as useEffect5, useMemo, useState as useState5 } from "react";
+import ReactMarkdown, { defaultUrlTransform } from "react-markdown";
+import remarkGfm from "remark-gfm";
+
+// ../ui/dist/Chart.js
+import { jsx as _jsx3 } from "react/jsx-runtime";
+import { useEffect as useEffect3, useRef as useRef3, useState as useState3 } from "react";
+
+// ../ui/dist/CodeBlock.js
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+
+// ../ui/dist/copy.js
+import { useEffect, useRef, useState } from "react";
+
+// ../ui/dist/motion/motion.js
+function tokenMs(el, token) {
+  const value = getComputedStyle(el).getPropertyValue(token).trim();
+  return value.endsWith("ms") ? parseFloat(value) : parseFloat(value) * 1e3;
+}
+
+// ../ui/dist/copy.js
+function useCopy() {
+  const [copied, setCopied] = useState(false);
+  const timer = useRef(void 0);
+  useEffect(() => () => clearTimeout(timer.current), []);
+  const copy = (what, press) => {
+    const hold = tokenMs(press, "--dur-copied");
+    const written = typeof what === "string" ? navigator.clipboard.writeText(what) : what();
+    void written.then(() => {
+      clearTimeout(timer.current);
+      setCopied(true);
+      timer.current = setTimeout(() => setCopied(false), hold);
+    }, () => {
+    });
+  };
+  return { copied, copy };
+}
+
+// ../ui/dist/CodeBlock.js
+function CodeBlock({ code, language, reason }) {
+  const { copied, copy } = useCopy();
+  return _jsxs("div", { className: "hs-code-block", children: [_jsxs("div", { className: "hs-code-head", children: [_jsx("span", { className: "hs-code-language", children: language ?? "code" }), reason && _jsx("span", { className: "hs-code-reason", children: reason }), _jsxs("button", { type: "button", onClick: (e) => copy(code.replace(/\n$/, ""), e.currentTarget), className: "hs-code-copy", children: [_jsx(CopyGlyph, { size: 11 }), copied ? "Copied" : "Copy"] })] }), _jsx("pre", { className: "hs-code-pre", children: code })] });
+}
+
+// ../ui/dist/ThemeRoot.js
+import { jsx as _jsx2, jsxs as _jsxs2 } from "react/jsx-runtime";
+import { createContext, useContext, useEffect as useEffect2, useRef as useRef2, useState as useState2 } from "react";
+var SchemeContext = createContext(null);
+var LookContext = createContext("");
+function useLook() {
+  return useContext(LookContext);
+}
+
+// ../ui/dist/Chart.js
+function chrome(element) {
+  const style = getComputedStyle(element);
+  const token = (name) => style.getPropertyValue(name).trim();
+  const ink = token("--mut");
+  const line = token("--cardb");
+  const font = token("--font-app");
+  return {
+    title: { color: token("--text"), subtitleColor: ink, font, subtitleFont: font },
+    axis: {
+      domainColor: line,
+      gridColor: token("--line"),
+      tickColor: line,
+      labelColor: ink,
+      titleColor: ink
+    },
+    legend: { labelColor: ink, titleColor: ink },
+    style: { "guide-label": { font }, "guide-title": { font } }
+  };
+}
+function Chart({ spec }) {
+  const host = useRef3(null);
+  const [reason, setReason] = useState3(null);
+  const look = useLook();
+  useEffect3(() => {
+    const element = host.current;
+    if (!element)
+      return;
+    let live = true;
+    let view = null;
+    setReason(null);
+    void (async () => {
+      try {
+        const [vega, vegaLite, { expressionInterpreter }] = await Promise.all([
+          import("vega"),
+          import("vega-lite"),
+          import("vega-interpreter")
+        ]);
+        const compiled = vegaLite.compile(JSON.parse(spec)).spec;
+        if (!live)
+          return;
+        const runtime = vega.parse(compiled, chrome(element), { ast: true });
+        const created = new vega.View(runtime, {
+          renderer: "svg",
+          container: element,
+          expr: expressionInterpreter
+        });
+        created.background("transparent");
+        await created.runAsync();
+        if (!live) {
+          created.finalize();
+          return;
+        }
+        view = created;
+      } catch (error) {
+        if (live)
+          setReason(error instanceof Error ? error.message : String(error));
+      }
+    })();
+    return () => {
+      live = false;
+      view?.finalize();
+      element.replaceChildren();
+    };
+  }, [spec, look]);
+  if (reason !== null)
+    return _jsx3(CodeBlock, { code: spec, language: "vega-lite", reason });
+  return _jsx3("div", { ref: host, className: "hs-chart" });
+}
+
+// ../ui/dist/Diagram.js
+import { jsx as _jsx4 } from "react/jsx-runtime";
+import { useEffect as useEffect4, useRef as useRef4, useState as useState4 } from "react";
+var counter = 0;
+function Diagram({ source }) {
+  const host = useRef4(null);
+  const [svg, setSvg] = useState4(null);
+  const [reason, setReason] = useState4(null);
+  const look = useLook();
+  useEffect4(() => {
+    const element = host.current;
+    if (!element)
+      return;
+    let live = true;
+    setSvg(null);
+    setReason(null);
+    const token = (name) => getComputedStyle(element).getPropertyValue(name).trim();
+    void (async () => {
+      try {
+        const [{ default: mermaid }, { default: DOMPurify }] = await Promise.all([
+          import("mermaid"),
+          import("dompurify")
+        ]);
+        mermaid.initialize({
+          startOnLoad: false,
+          securityLevel: "strict",
+          suppressErrorRendering: true,
+          // Labels are SVG text, not HTML in a `foreignObject`: the sanitiser
+          // allows the SVG vocabulary only, and drops HTML inside SVG whole.
+          htmlLabels: false,
+          theme: "base",
+          fontFamily: token("--font-app"),
+          themeVariables: {
+            background: token("--card"),
+            primaryColor: token("--win"),
+            primaryTextColor: token("--text"),
+            primaryBorderColor: token("--cardb"),
+            secondaryColor: token("--hov"),
+            tertiaryColor: token("--card"),
+            lineColor: token("--mut"),
+            textColor: token("--text")
+          }
+        });
+        counter += 1;
+        const rendered = await mermaid.render(`hs-diagram-${counter}`, source);
+        if (!live)
+          return;
+        setSvg(DOMPurify.sanitize(rendered.svg, {
+          USE_PROFILES: { svg: true, svgFilters: true },
+          ADD_ATTR: ["dominant-baseline"]
+        }));
+      } catch (error) {
+        if (live)
+          setReason(error instanceof Error ? error.message : String(error));
+      }
+    })();
+    return () => {
+      live = false;
+    };
+  }, [source, look]);
+  if (reason !== null)
+    return _jsx4(CodeBlock, { code: source, language: "mermaid", reason });
+  return _jsx4("div", { ref: host, className: "hs-diagram", dangerouslySetInnerHTML: svg === null ? void 0 : { __html: svg } });
+}
+
+// ../ui/dist/chat/markdown-incremental.js
+function hasDefinitions(node) {
+  return node.type === "definition" || node.type === "footnoteDefinition" || "children" in node && node.children.some((child) => hasDefinitions(child));
+}
+function shiftPositions(node, offset, lines) {
+  if (node.position) {
+    for (const point of [node.position.start, node.position.end]) {
+      if (point.offset !== void 0)
+        point.offset += offset;
+      point.line += lines;
+    }
+  }
+  if ("children" in node) {
+    for (const child of node.children)
+      shiftPositions(child, offset, lines);
+  }
+}
+function incrementalParser(parse) {
+  let cached;
+  return (source, file) => {
+    if (source.includes("\r") || source.includes("\uFEFF"))
+      return parse(source, file);
+    const prefix = cached && source.startsWith(cached.source) ? cached : void 0;
+    let root;
+    if (prefix) {
+      root = parse(source.slice(prefix.offset), file);
+      if (hasDefinitions(root))
+        return parse(source, file);
+      shiftPositions(root, prefix.offset, prefix.line - 1);
+      if (root.position)
+        root.position.start = { line: 1, column: 1, offset: 0 };
+      root.children.unshift(...structuredClone(prefix.children));
+    } else {
+      root = parse(source, file);
+      if (hasDefinitions(root))
+        return root;
+    }
+    for (let index = root.children.length - 1; index >= 0; index--) {
+      const node = root.children[index];
+      if (node?.type !== "code")
+        continue;
+      const start = node.position?.start.offset;
+      const end = node.position?.end.offset;
+      if (start === void 0 || end === void 0)
+        continue;
+      if (prefix && end < prefix.offset)
+        break;
+      const value = source.slice(start, end);
+      const opening = /^ {0,3}(`{3,}|~{3,})[^\n]*\n/.exec(value)?.[1];
+      if (!opening)
+        continue;
+      const lastLine = value.slice(value.lastIndexOf("\n") + 1);
+      const closing = new RegExp(`^ {0,3}${opening[0]}{${opening.length},}[ \\t]*$`);
+      const separator = /^\n[ \t]*\n/.exec(source.slice(end))?.[0];
+      if (!closing.test(lastLine) || !separator)
+        continue;
+      const offset = end + separator.length;
+      cached = {
+        source: source.slice(0, offset),
+        offset,
+        line: node.position.end.line + 2,
+        children: structuredClone(root.children.slice(0, index + 1))
+      };
+      break;
+    }
+    return root;
+  };
+}
+function incrementalMarkdown() {
+  let parser;
+  return function() {
+    const original = this.parser;
+    if (!original)
+      return;
+    parser ??= incrementalParser((source, file) => original(source, file));
+    const parseDocument = parser;
+    let documentParsed = false;
+    this.parser = (source, file) => {
+      if (documentParsed)
+        return original(source, file);
+      documentParsed = true;
+      return parseDocument(source, file);
+    };
+  };
+}
+
+// ../ui/dist/chat/markdown.js
+function fenceText(children) {
+  return Children.toArray(children).map((child) => typeof child === "string" ? child : "").join("").replace(/\n$/, "");
+}
+function nameOf(target) {
+  try {
+    return decodeURIComponent(target.replace(/^\.\//, ""));
+  } catch {
+    return target;
+  }
+}
+function FilePicture({ src, alt, onOpen }) {
+  const [known, setKnown] = useState5(typeof src === "string" ? src : null);
+  useEffect5(() => {
+    if (typeof src === "string")
+      return;
+    let live = true;
+    void src.then((url) => {
+      if (live)
+        setKnown(url);
+    }, () => void 0);
+    return () => {
+      live = false;
+    };
+  }, [src]);
+  return known ? _jsx5("button", { type: "button", className: "hs-md-picture", "aria-label": `Show ${alt}`, onClick: (e) => onOpen(e.currentTarget), children: _jsx5("img", { src: known, alt }) }) : null;
+}
+var APP_LINK = /^hearthscale:/i;
+var keptUrl = (url) => APP_LINK.test(url) ? url : defaultUrlTransform(url);
+var MarkdownState = createContext2(null);
+function useMarkdownState() {
+  const state = useContext2(MarkdownState);
+  if (!state)
+    throw new Error("a part of a reply is drawn outside its Markdown");
+  return state;
+}
+var PARTS = {
+  pre: function MarkdownFence({ children }) {
+    const { streaming } = useMarkdownState();
+    const code = Children.toArray(children).find(isValidElement);
+    if (!code)
+      return null;
+    const source = fenceText(code.props.children);
+    const language = /language-([\w-]+)/.exec(code.props.className ?? "")?.[1];
+    if (language === "mermaid" && !streaming)
+      return _jsx5(Diagram, { source });
+    if (language === "vega-lite" && !streaming)
+      return _jsx5(Chart, { spec: source });
+    return _jsx5(CodeBlock, { code: source, ...language && { language } });
+  },
+  a: function MarkdownLink({ href, children: words }) {
+    const { links } = useMarkdownState();
+    const target = href ?? "";
+    const file = /^[a-z][a-z0-9+.-]*:/i.test(target) ? null : links.file(nameOf(target));
+    const web = /^https?:\/\//i.test(target);
+    const linked = web || APP_LINK.test(target);
+    if (!file && !linked)
+      return _jsx5(_Fragment, { children: words });
+    return _jsx5("a", { href: web ? target : void 0, className: "hs-md-link", onClick: (event) => {
+      event.preventDefault();
+      if (file)
+        file.open(event.currentTarget);
+      else if (linked)
+        links.open(target);
+    }, children: words });
+  },
+  img: function MarkdownPicture({ src, alt }) {
+    const { links } = useMarkdownState();
+    const target = typeof src === "string" ? src : "";
+    const file = /^[a-z][a-z0-9+.-]*:/i.test(target) ? null : links.file(nameOf(target));
+    return file?.picture ? _jsx5(FilePicture, { src: file.picture, alt: alt ?? "", onOpen: file.open }) : _jsx5("span", { className: "hs-md-missing", children: alt || nameOf(target) });
+  }
+};
+var WHOLE = [remarkGfm];
+var FENCED = /(?:^|\n) {0,3}(?:`{3}|~{3})/;
+var Markdown = memo(function Markdown2({ children, links, streaming }) {
+  const arriving = streaming !== void 0;
+  const incremental = arriving && FENCED.test(children);
+  const plugins = useMemo(() => incremental ? [remarkGfm, incrementalMarkdown()] : WHOLE, [incremental]);
+  const state = useMemo(() => ({ links, streaming: arriving }), [links, arriving]);
+  return _jsx5("div", { className: "hs-md hs-assistant-text", "data-streaming": streaming, children: _jsx5(MarkdownState.Provider, { value: state, children: _jsx5(ReactMarkdown, { remarkPlugins: plugins, components: PARTS, urlTransform: keptUrl, children }) }) });
+});
+export {
+  Markdown
+};