@singapore-editor/plugin-ui 0.1.0

package/dist/markdownTooltip.js

@@ -0,0 +1,282 @@
+import { paintCodeTokens } from "./codeTokens.js";
+import { applyEditorTheme } from "@singapore-editor/core/rendering";
+import remarkGfm from "remark-gfm";
+import remarkParse from "remark-parse";
+import remarkStringify from "remark-stringify";
+import { unified } from "unified";
+//#region src/markdownTooltip.ts
+var createMarkdownParser = () => unified().use(remarkParse).use(remarkGfm);
+var createMarkdownStringifier = () => unified().use(remarkParse).use(remarkGfm).use(remarkStringify);
+var parseProcessor = null;
+var stringifyProcessor = null;
+function markdownParser() {
+	parseProcessor ??= createMarkdownParser();
+	return parseProcessor;
+}
+function markdownStringifier() {
+	stringifyProcessor ??= createMarkdownStringifier();
+	return stringifyProcessor;
+}
+function normalizeTooltipMarkdown(markdown) {
+	return String(markdownStringifier().processSync(markdown));
+}
+/** The fenced blocks a render of this Markdown would ask tokens for. */
+function tooltipCodeBlocks(markdown) {
+	const blocks = [];
+	collectCodeBlocks(markdownParser().parse(markdown), blocks);
+	return blocks;
+}
+function collectCodeBlocks(node, blocks) {
+	const languageId = codeLanguage(node.lang);
+	if (node.type === "code" && languageId) blocks.push({
+		text: stringValue(node.value),
+		languageId
+	});
+	for (const child of node.children ?? []) collectCodeBlocks(child, blocks);
+}
+function codeLanguage(lang) {
+	return typeof lang === "string" ? lang.toLowerCase() : "";
+}
+function renderTooltipMarkdown(document, markdown, theme, options = {}) {
+	const context = tooltipMarkdownRenderContext(options);
+	const root = document.createElement("div");
+	root.className = tooltipClassName(context.classNamespace, "markdown");
+	applyEditorTheme(root, theme);
+	applyCodeBackgroundVariables(root, options, context);
+	applyStyles(root, { display: "block" });
+	appendChildren(root, document, markdownParser().parse(markdown).children ?? [], context);
+	return root;
+}
+function tooltipMarkdownRenderContext(options) {
+	const classNamespace = options.classNamespace ?? "plugin";
+	return {
+		classNamespace,
+		codeTokenizer: options.codeTokenizer ?? null,
+		inlineCodeBackgroundVariable: `--editor-${classNamespace}-hover-inline-code-background`,
+		codeBlockBackgroundVariable: `--editor-${classNamespace}-hover-code-block-background`
+	};
+}
+function tooltipClassName(classNamespace, part) {
+	return `editor-${classNamespace}-hover-${part}`;
+}
+function appendChildren(parent, document, children, context) {
+	for (const child of children) appendNode(parent, document, child, context);
+}
+function appendNode(parent, document, node, context) {
+	const rendered = renderNode(document, node, context);
+	if (rendered) {
+		parent.appendChild(rendered);
+		return;
+	}
+	appendChildren(parent, document, node.children ?? [], context);
+}
+function renderNode(document, node, context) {
+	if (node.type === "text") return document.createTextNode(stringValue(node.value));
+	if (node.type === "paragraph") return parentElement(document, "p", node, context);
+	if (node.type === "inlineCode") return inlineCodeElement(document, stringValue(node.value), context);
+	if (node.type === "code") return codeBlockElement(document, stringValue(node.value), node.lang, context);
+	if (node.type === "break") return document.createElement("br");
+	if (node.type === "emphasis") return parentElement(document, "em", node, context);
+	if (node.type === "strong") return parentElement(document, "strong", node, context);
+	if (node.type === "delete") return parentElement(document, "del", node, context);
+	if (node.type === "link") return linkElement(document, node, context);
+	if (node.type === "list") return listElement(document, node, context);
+	if (node.type === "listItem") return listItemElement(document, node, context);
+	if (node.type === "table") return tableElement(document, node, context);
+	if (node.type === "heading") return headingElement(document, node, context);
+	if (node.type === "blockquote") return blockquoteElement(document, node, context);
+	if (node.type === "thematicBreak") return document.createElement("hr");
+	if (node.type === "html") return document.createTextNode(stringValue(node.value));
+	return fallbackNode(document, node, context);
+}
+function parentElement(document, tagName, node, context) {
+	const element = document.createElement(tagName);
+	appendChildren(element, document, node.children ?? [], context);
+	return element;
+}
+function inlineCodeElement(document, value, context) {
+	const element = document.createElement("code");
+	element.textContent = value;
+	applyStyles(element, {
+		padding: "1px 4px",
+		borderRadius: "4px",
+		background: `var(${context.inlineCodeBackgroundVariable}, transparent)`,
+		color: "var(--editor-foreground, #f4f4f5)",
+		font: "12px/1.4 ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace"
+	});
+	return element;
+}
+function codeBlockElement(document, value, lang, context) {
+	const pre = document.createElement("pre");
+	const code = document.createElement("code");
+	const language = codeLanguage(lang);
+	renderCodeContent(document, code, value, language, context);
+	if (language) code.dataset.language = language;
+	applyStyles(pre, {
+		margin: "0",
+		padding: "0",
+		borderRadius: "5px",
+		background: `var(${context.codeBlockBackgroundVariable}, transparent)`,
+		color: "var(--editor-foreground, #f4f4f5)",
+		boxSizing: "border-box",
+		maxWidth: "100%",
+		overflow: "hidden"
+	});
+	applyStyles(code, {
+		display: "block",
+		font: "12px/1.45 ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace",
+		whiteSpace: "pre-wrap",
+		overflowWrap: "break-word"
+	});
+	pre.append(code);
+	return pre;
+}
+function applyCodeBackgroundVariables(element, options, context) {
+	if (!options.codeBackground) return;
+	element.style.setProperty(context.inlineCodeBackgroundVariable, "color-mix(in srgb, var(--editor-foreground, #a1a1aa) 16%, transparent)");
+	element.style.setProperty(context.codeBlockBackgroundVariable, "color-mix(in srgb, var(--editor-background, #09090b) 88%, var(--editor-foreground, #f4f4f5) 12%)");
+}
+function renderCodeContent(document, code, value, language, context) {
+	code.textContent = value;
+	const tokenizer = context.codeTokenizer;
+	if (!tokenizer || !language) return;
+	const cached = tokenizer.cached(value, language);
+	if (cached) return paintCodeTokens(document, code, value, cached);
+	tokenizer.tokenize(value, language).then((tokens) => paintCodeTokens(document, code, value, tokens));
+}
+function linkElement(document, node, context) {
+	const href = safeLinkHref(node.url);
+	if (!href) return parentElement(document, "span", node, context);
+	const element = document.createElement("a");
+	element.href = href;
+	element.target = "_blank";
+	element.rel = "noreferrer";
+	applyStyles(element, {
+		color: "var(--editor-caret-color, #93c5fd)",
+		textDecoration: "underline"
+	});
+	appendChildren(element, document, node.children ?? [], context);
+	return element;
+}
+function listElement(document, node, context) {
+	const element = document.createElement(node.ordered === true ? "ol" : "ul");
+	applyStyles(element, {
+		margin: "0",
+		paddingLeft: "18px"
+	});
+	appendChildren(element, document, node.children ?? [], context);
+	return element;
+}
+function listItemElement(document, node, context) {
+	const element = document.createElement("li");
+	if (typeof node.checked === "boolean") element.append(taskCheckbox(document, node.checked));
+	appendChildren(element, document, node.children ?? [], context);
+	return element;
+}
+function taskCheckbox(document, checked) {
+	const input = document.createElement("input");
+	input.type = "checkbox";
+	input.checked = checked;
+	input.disabled = true;
+	input.tabIndex = -1;
+	applyStyles(input, {
+		margin: "0 6px 0 0",
+		verticalAlign: "-1px"
+	});
+	return input;
+}
+function tableElement(document, node, context) {
+	const table = document.createElement("table");
+	const rows = node.children ?? [];
+	applyStyles(table, {
+		borderCollapse: "collapse",
+		fontSize: "12px"
+	});
+	appendTableHead(table, document, rows[0] ?? null, node.align ?? [], context);
+	appendTableBody(table, document, rows.slice(1), node.align ?? [], context);
+	return table;
+}
+function appendTableHead(table, document, row, align, context) {
+	if (!row) return;
+	const head = document.createElement("thead");
+	head.append(tableRowElement(document, row, "th", align, context));
+	table.append(head);
+}
+function appendTableBody(table, document, rows, align, context) {
+	if (rows.length === 0) return;
+	const body = document.createElement("tbody");
+	for (const row of rows) body.append(tableRowElement(document, row, "td", align, context));
+	table.append(body);
+}
+function tableRowElement(document, row, cellTagName, align, context) {
+	const element = document.createElement("tr");
+	const cells = row.children ?? [];
+	for (let index = 0; index < cells.length; index += 1) element.append(tableCellElement(document, cells[index], cellTagName, align[index], context));
+	return element;
+}
+function tableCellElement(document, node, tagName, align, context) {
+	const element = document.createElement(tagName);
+	applyStyles(element, {
+		padding: "3px 7px",
+		border: "1px solid color-mix(in srgb, var(--editor-foreground, #a1a1aa) 22%, transparent)",
+		textAlign: tableTextAlign(align)
+	});
+	appendChildren(element, document, node.children ?? [], context);
+	return element;
+}
+function headingElement(document, node, context) {
+	const element = parentElement(document, "div", node, context);
+	element.setAttribute("role", "heading");
+	element.setAttribute("aria-level", String(headingDepth(node.depth)));
+	applyStyles(element, { fontWeight: "650" });
+	return element;
+}
+function blockquoteElement(document, node, context) {
+	const element = parentElement(document, "blockquote", node, context);
+	applyStyles(element, {
+		margin: "0",
+		paddingLeft: "10px",
+		borderLeft: "2px solid color-mix(in srgb, var(--editor-foreground, #a1a1aa) 46%, transparent)",
+		color: "color-mix(in srgb, var(--editor-foreground, #d4d4d8) 86%, transparent)"
+	});
+	return element;
+}
+function fallbackNode(document, node, context) {
+	if (typeof node.value === "string") return document.createTextNode(node.value);
+	if (!node.children || node.children.length === 0) return null;
+	const element = document.createElement("span");
+	appendChildren(element, document, node.children, context);
+	return element;
+}
+function safeLinkHref(url) {
+	if (typeof url !== "string") return null;
+	try {
+		const parsed = new URL(url);
+		if (parsed.protocol === "http:" || parsed.protocol === "https:") return parsed.href;
+		if (parsed.protocol === "mailto:") return parsed.href;
+		return null;
+	} catch {
+		return null;
+	}
+}
+function tableTextAlign(align) {
+	if (align === "left" || align === "right" || align === "center") return align;
+	return "left";
+}
+function headingDepth(depth) {
+	if (typeof depth !== "number") return 2;
+	return Math.min(6, Math.max(1, Math.trunc(depth)));
+}
+function stringValue(value) {
+	return typeof value === "string" ? value : "";
+}
+function applyStyles(element, styles) {
+	for (const [property, value] of Object.entries(styles)) element.style.setProperty(cssPropertyName(property), value);
+}
+function cssPropertyName(property) {
+	return property.replace(/[A-Z]/g, (character) => `-${character.toLowerCase()}`);
+}
+//#endregion
+export { normalizeTooltipMarkdown, renderTooltipMarkdown, tooltipCodeBlocks };
+
+//# sourceMappingURL=markdownTooltip.js.map

package/dist/markdownTooltip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdownTooltip.js","names":[],"sources":["../src/markdownTooltip.ts"],"sourcesContent":["import { applyEditorTheme, type EditorTheme } from '@singapore-editor/core/rendering'\nimport remarkGfm from 'remark-gfm'\nimport remarkParse from 'remark-parse'\nimport remarkStringify from 'remark-stringify'\nimport { unified } from 'unified'\n\nimport { paintCodeTokens, type TooltipCodeBlock, type TooltipCodeTokenizer } from './codeTokens'\n\ntype MarkdownNode = {\n  readonly type: string\n  readonly value?: unknown\n  readonly children?: readonly MarkdownNode[]\n  readonly lang?: unknown\n  readonly url?: unknown\n  readonly ordered?: unknown\n  readonly checked?: unknown\n  readonly depth?: unknown\n  readonly align?: readonly (string | null | undefined)[]\n}\n\nexport type TooltipMarkdownRenderOptions = {\n  readonly codeBackground?: boolean\n  readonly classNamespace?: string\n  readonly codeTokenizer?: TooltipCodeTokenizer | null\n}\n\ntype TooltipMarkdownRenderContext = {\n  readonly classNamespace: string\n  readonly codeTokenizer: TooltipCodeTokenizer | null\n  readonly inlineCodeBackgroundVariable: string\n  readonly codeBlockBackgroundVariable: string\n}\n\n// Built on first use, not at import: a host that never shows a markdown hover\n// should not pay for two unified pipelines while it boots.\nconst createMarkdownParser = () => unified().use(remarkParse).use(remarkGfm)\nconst createMarkdownStringifier = () =>\n  unified().use(remarkParse).use(remarkGfm).use(remarkStringify)\n\nlet parseProcessor: ReturnType<typeof createMarkdownParser> | null = null\nlet stringifyProcessor: ReturnType<typeof createMarkdownStringifier> | null = null\n\nfunction markdownParser() {\n  parseProcessor ??= createMarkdownParser()\n  return parseProcessor\n}\n\nfunction markdownStringifier() {\n  stringifyProcessor ??= createMarkdownStringifier()\n  return stringifyProcessor\n}\n\nexport function normalizeTooltipMarkdown(markdown: string): string {\n  return String(markdownStringifier().processSync(markdown))\n}\n\n/** The fenced blocks a render of this Markdown would ask tokens for. */\nexport function tooltipCodeBlocks(markdown: string): readonly TooltipCodeBlock[] {\n  const blocks: TooltipCodeBlock[] = []\n  collectCodeBlocks(markdownParser().parse(markdown) as MarkdownNode, blocks)\n  return blocks\n}\n\nfunction collectCodeBlocks(node: MarkdownNode, blocks: TooltipCodeBlock[]): void {\n  const languageId = codeLanguage(node.lang)\n  if (node.type === 'code' && languageId) blocks.push({ text: stringValue(node.value), languageId })\n  for (const child of node.children ?? []) collectCodeBlocks(child, blocks)\n}\n\nfunction codeLanguage(lang: unknown): string {\n  return typeof lang === 'string' ? lang.toLowerCase() : ''\n}\n\nexport function renderTooltipMarkdown(\n  document: Document,\n  markdown: string,\n  theme?: EditorTheme | null,\n  options: TooltipMarkdownRenderOptions = {},\n): HTMLElement {\n  const context = tooltipMarkdownRenderContext(options)\n  const root = document.createElement('div')\n  root.className = tooltipClassName(context.classNamespace, 'markdown')\n  applyEditorTheme(root, theme)\n  applyCodeBackgroundVariables(root, options, context)\n  applyStyles(root, {\n    display: 'block',\n  })\n\n  const tree = markdownParser().parse(markdown) as MarkdownNode\n  appendChildren(root, document, tree.children ?? [], context)\n  return root\n}\n\nfunction tooltipMarkdownRenderContext(\n  options: TooltipMarkdownRenderOptions,\n): TooltipMarkdownRenderContext {\n  const classNamespace = options.classNamespace ?? 'plugin'\n  return {\n    classNamespace,\n    codeTokenizer: options.codeTokenizer ?? null,\n    inlineCodeBackgroundVariable: `--editor-${classNamespace}-hover-inline-code-background`,\n    codeBlockBackgroundVariable: `--editor-${classNamespace}-hover-code-block-background`,\n  }\n}\n\nfunction tooltipClassName(classNamespace: string, part: string): string {\n  return `editor-${classNamespace}-hover-${part}`\n}\n\nfunction appendChildren(\n  parent: Node,\n  document: Document,\n  children: readonly MarkdownNode[],\n  context: TooltipMarkdownRenderContext,\n): void {\n  for (const child of children) appendNode(parent, document, child, context)\n}\n\nfunction appendNode(\n  parent: Node,\n  document: Document,\n  node: MarkdownNode,\n  context: TooltipMarkdownRenderContext,\n): void {\n  const rendered = renderNode(document, node, context)\n  if (rendered) {\n    parent.appendChild(rendered)\n    return\n  }\n\n  appendChildren(parent, document, node.children ?? [], context)\n}\n\nfunction renderNode(\n  document: Document,\n  node: MarkdownNode,\n  context: TooltipMarkdownRenderContext,\n): Node | null {\n  if (node.type === 'text') return document.createTextNode(stringValue(node.value))\n  if (node.type === 'paragraph') return parentElement(document, 'p', node, context)\n  if (node.type === 'inlineCode')\n    return inlineCodeElement(document, stringValue(node.value), context)\n  if (node.type === 'code')\n    return codeBlockElement(document, stringValue(node.value), node.lang, context)\n  if (node.type === 'break') return document.createElement('br')\n  if (node.type === 'emphasis') return parentElement(document, 'em', node, context)\n  if (node.type === 'strong') return parentElement(document, 'strong', node, context)\n  if (node.type === 'delete') return parentElement(document, 'del', node, context)\n  if (node.type === 'link') return linkElement(document, node, context)\n  if (node.type === 'list') return listElement(document, node, context)\n  if (node.type === 'listItem') return listItemElement(document, node, context)\n  if (node.type === 'table') return tableElement(document, node, context)\n  if (node.type === 'heading') return headingElement(document, node, context)\n  if (node.type === 'blockquote') return blockquoteElement(document, node, context)\n  if (node.type === 'thematicBreak') return document.createElement('hr')\n  if (node.type === 'html') return document.createTextNode(stringValue(node.value))\n  return fallbackNode(document, node, context)\n}\n\nfunction parentElement<K extends keyof HTMLElementTagNameMap>(\n  document: Document,\n  tagName: K,\n  node: MarkdownNode,\n  context: TooltipMarkdownRenderContext,\n): HTMLElementTagNameMap[K] {\n  const element = document.createElement(tagName)\n  appendChildren(element, document, node.children ?? [], context)\n  return element\n}\n\nfunction inlineCodeElement(\n  document: Document,\n  value: string,\n  context: TooltipMarkdownRenderContext,\n): HTMLElement {\n  const element = document.createElement('code')\n  element.textContent = value\n  applyStyles(element, {\n    padding: '1px 4px',\n    borderRadius: '4px',\n    background: `var(${context.inlineCodeBackgroundVariable}, transparent)`,\n    color: 'var(--editor-foreground, #f4f4f5)',\n    font: '12px/1.4 ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace',\n  })\n  return element\n}\n\nfunction codeBlockElement(\n  document: Document,\n  value: string,\n  lang: unknown,\n  context: TooltipMarkdownRenderContext,\n): HTMLElement {\n  const pre = document.createElement('pre')\n  const code = document.createElement('code')\n  const language = codeLanguage(lang)\n  renderCodeContent(document, code, value, language, context)\n  if (language) code.dataset.language = language\n\n  applyStyles(pre, {\n    margin: '0',\n    padding: '0',\n    borderRadius: '5px',\n    background: `var(${context.codeBlockBackgroundVariable}, transparent)`,\n    color: 'var(--editor-foreground, #f4f4f5)',\n    boxSizing: 'border-box',\n    maxWidth: '100%',\n    overflow: 'hidden',\n  })\n  applyStyles(code, {\n    display: 'block',\n    font: '12px/1.45 ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace',\n    whiteSpace: 'pre-wrap',\n    overflowWrap: 'break-word',\n  })\n\n  pre.append(code)\n  return pre\n}\n\nfunction applyCodeBackgroundVariables(\n  element: HTMLElement,\n  options: TooltipMarkdownRenderOptions,\n  context: TooltipMarkdownRenderContext,\n): void {\n  if (!options.codeBackground) return\n\n  element.style.setProperty(\n    context.inlineCodeBackgroundVariable,\n    'color-mix(in srgb, var(--editor-foreground, #a1a1aa) 16%, transparent)',\n  )\n  element.style.setProperty(\n    context.codeBlockBackgroundVariable,\n    'color-mix(in srgb, var(--editor-background, #09090b) 88%, var(--editor-foreground, #f4f4f5) 12%)',\n  )\n}\n\nfunction renderCodeContent(\n  document: Document,\n  code: HTMLElement,\n  value: string,\n  language: string,\n  context: TooltipMarkdownRenderContext,\n): void {\n  code.textContent = value\n  const tokenizer = context.codeTokenizer\n  if (!tokenizer || !language) return\n\n  const cached = tokenizer.cached(value, language)\n  if (cached) return paintCodeTokens(document, code, value, cached)\n\n  // Reached only when the hold ran out. Colour only, so the block keeps its size.\n  void tokenizer\n    .tokenize(value, language)\n    .then((tokens) => paintCodeTokens(document, code, value, tokens))\n}\n\nfunction linkElement(\n  document: Document,\n  node: MarkdownNode,\n  context: TooltipMarkdownRenderContext,\n): HTMLElement {\n  const href = safeLinkHref(node.url)\n  if (!href) return parentElement(document, 'span', node, context)\n\n  const element = document.createElement('a')\n  element.href = href\n  element.target = '_blank'\n  element.rel = 'noreferrer'\n  applyStyles(element, {\n    color: 'var(--editor-caret-color, #93c5fd)',\n    textDecoration: 'underline',\n  })\n  appendChildren(element, document, node.children ?? [], context)\n  return element\n}\n\nfunction listElement(\n  document: Document,\n  node: MarkdownNode,\n  context: TooltipMarkdownRenderContext,\n): HTMLElement {\n  const element = document.createElement(node.ordered === true ? 'ol' : 'ul')\n  applyStyles(element, {\n    margin: '0',\n    paddingLeft: '18px',\n  })\n  appendChildren(element, document, node.children ?? [], context)\n  return element\n}\n\nfunction listItemElement(\n  document: Document,\n  node: MarkdownNode,\n  context: TooltipMarkdownRenderContext,\n): HTMLElement {\n  const element = document.createElement('li')\n  if (typeof node.checked === 'boolean') element.append(taskCheckbox(document, node.checked))\n  appendChildren(element, document, node.children ?? [], context)\n  return element\n}\n\nfunction taskCheckbox(document: Document, checked: boolean): HTMLInputElement {\n  const input = document.createElement('input')\n  input.type = 'checkbox'\n  input.checked = checked\n  input.disabled = true\n  input.tabIndex = -1\n  applyStyles(input, {\n    margin: '0 6px 0 0',\n    verticalAlign: '-1px',\n  })\n  return input\n}\n\nfunction tableElement(\n  document: Document,\n  node: MarkdownNode,\n  context: TooltipMarkdownRenderContext,\n): HTMLElement {\n  const table = document.createElement('table')\n  const rows = node.children ?? []\n  applyStyles(table, {\n    borderCollapse: 'collapse',\n    fontSize: '12px',\n  })\n  appendTableHead(table, document, rows[0] ?? null, node.align ?? [], context)\n  appendTableBody(table, document, rows.slice(1), node.align ?? [], context)\n  return table\n}\n\nfunction appendTableHead(\n  table: HTMLTableElement,\n  document: Document,\n  row: MarkdownNode | null,\n  align: readonly (string | null | undefined)[],\n  context: TooltipMarkdownRenderContext,\n): void {\n  if (!row) return\n\n  const head = document.createElement('thead')\n  head.append(tableRowElement(document, row, 'th', align, context))\n  table.append(head)\n}\n\nfunction appendTableBody(\n  table: HTMLTableElement,\n  document: Document,\n  rows: readonly MarkdownNode[],\n  align: readonly (string | null | undefined)[],\n  context: TooltipMarkdownRenderContext,\n): void {\n  if (rows.length === 0) return\n\n  const body = document.createElement('tbody')\n  for (const row of rows) body.append(tableRowElement(document, row, 'td', align, context))\n  table.append(body)\n}\n\nfunction tableRowElement(\n  document: Document,\n  row: MarkdownNode,\n  cellTagName: 'td' | 'th',\n  align: readonly (string | null | undefined)[],\n  context: TooltipMarkdownRenderContext,\n): HTMLTableRowElement {\n  const element = document.createElement('tr')\n  const cells = row.children ?? []\n  for (let index = 0; index < cells.length; index += 1) {\n    element.append(tableCellElement(document, cells[index]!, cellTagName, align[index], context))\n  }\n  return element\n}\n\nfunction tableCellElement(\n  document: Document,\n  node: MarkdownNode,\n  tagName: 'td' | 'th',\n  align: string | null | undefined,\n  context: TooltipMarkdownRenderContext,\n): HTMLTableCellElement {\n  const element = document.createElement(tagName)\n  applyStyles(element, {\n    padding: '3px 7px',\n    border: '1px solid color-mix(in srgb, var(--editor-foreground, #a1a1aa) 22%, transparent)',\n    textAlign: tableTextAlign(align),\n  })\n  appendChildren(element, document, node.children ?? [], context)\n  return element\n}\n\nfunction headingElement(\n  document: Document,\n  node: MarkdownNode,\n  context: TooltipMarkdownRenderContext,\n): HTMLElement {\n  const element = parentElement(document, 'div', node, context)\n  element.setAttribute('role', 'heading')\n  element.setAttribute('aria-level', String(headingDepth(node.depth)))\n  applyStyles(element, {\n    fontWeight: '650',\n  })\n  return element\n}\n\nfunction blockquoteElement(\n  document: Document,\n  node: MarkdownNode,\n  context: TooltipMarkdownRenderContext,\n): HTMLElement {\n  const element = parentElement(document, 'blockquote', node, context)\n  applyStyles(element, {\n    margin: '0',\n    paddingLeft: '10px',\n    borderLeft: '2px solid color-mix(in srgb, var(--editor-foreground, #a1a1aa) 46%, transparent)',\n    color: 'color-mix(in srgb, var(--editor-foreground, #d4d4d8) 86%, transparent)',\n  })\n  return element\n}\n\nfunction fallbackNode(\n  document: Document,\n  node: MarkdownNode,\n  context: TooltipMarkdownRenderContext,\n): Node | null {\n  if (typeof node.value === 'string') return document.createTextNode(node.value)\n  if (!node.children || node.children.length === 0) return null\n\n  const element = document.createElement('span')\n  appendChildren(element, document, node.children, context)\n  return element\n}\n\nfunction safeLinkHref(url: unknown): string | null {\n  if (typeof url !== 'string') return null\n\n  try {\n    const parsed = new URL(url)\n    if (parsed.protocol === 'http:' || parsed.protocol === 'https:') return parsed.href\n    if (parsed.protocol === 'mailto:') return parsed.href\n    return null\n  } catch {\n    return null\n  }\n}\n\nfunction tableTextAlign(align: string | null | undefined): string {\n  if (align === 'left' || align === 'right' || align === 'center') return align\n  return 'left'\n}\n\nfunction headingDepth(depth: unknown): number {\n  if (typeof depth !== 'number') return 2\n  return Math.min(6, Math.max(1, Math.trunc(depth)))\n}\n\nfunction stringValue(value: unknown): string {\n  return typeof value === 'string' ? value : ''\n}\n\nfunction applyStyles(element: HTMLElement, styles: Readonly<Record<string, string>>): void {\n  for (const [property, value] of Object.entries(styles)) {\n    element.style.setProperty(cssPropertyName(property), value)\n  }\n}\n\nfunction cssPropertyName(property: string): string {\n  return property.replace(/[A-Z]/g, (character) => `-${character.toLowerCase()}`)\n}\n"],"mappings":"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"}

package/dist/offsetRange.d.ts

@@ -0,0 +1,24 @@
+import type { TextReadSnapshot } from '@singapore-editor/core/document';
+/** Half-open `[start, end)` offset range into the editor text buffer. */
+export type OffsetRange = {
+    readonly start: number;
+    readonly end: number;
+};
+export declare function sameOffsetRange(left: OffsetRange | null, right: OffsetRange): boolean;
+/** The smallest range covering every range given, or null for none. */
+export declare function unionOffsetRange(ranges: readonly OffsetRange[]): OffsetRange | null;
+/**
+ * The identifier under `offset`, or null when the offset does not sit on an identifier character.
+ * An identifier character is `[A-Za-z0-9_$]`, the set TypeScript's language service treats as part
+ * of a name; an offset one past the last character still counts, so a caret right after a name
+ * asks about that name.
+ */
+export declare function identifierRangeAtOffset(text: string, offset: number): OffsetRange | null;
+/** The identifier at `offset`, else the single visible character there. */
+export declare function hoverTargetRange(text: string, offset: number): OffsetRange;
+/**
+ * `hoverTargetRange` over a document source, reading a window of the offset's line rather than the
+ * document. The window widens only while an identifier runs into its edge.
+ */
+export declare function hoverTargetRangeInSource(source: TextReadSnapshot, offset: number): OffsetRange;
+//# sourceMappingURL=offsetRange.d.ts.map

package/dist/offsetRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offsetRange.d.ts","sourceRoot":"","sources":["../src/offsetRange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAEvE,yEAAyE;AACzE,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAErF;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,WAAW,GAAG,IAAI,CAUnF;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAaxF;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAM1E;AAID;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAa9F"}

package/dist/offsetRange.js

@@ -0,0 +1,81 @@
+//#region src/offsetRange.ts
+function sameOffsetRange(left, right) {
+	return left?.start === right.start && left.end === right.end;
+}
+/** The smallest range covering every range given, or null for none. */
+function unionOffsetRange(ranges) {
+	let union = null;
+	for (const range of ranges) {
+		if (!union) {
+			union = range;
+			continue;
+		}
+		union = {
+			start: Math.min(union.start, range.start),
+			end: Math.max(union.end, range.end)
+		};
+	}
+	return union;
+}
+/**
+* The identifier under `offset`, or null when the offset does not sit on an identifier character.
+* An identifier character is `[A-Za-z0-9_$]`, the set TypeScript's language service treats as part
+* of a name; an offset one past the last character still counts, so a caret right after a name
+* asks about that name.
+*/
+function identifierRangeAtOffset(text, offset) {
+	const index = identifierIndexAtOffset(text, Math.max(0, Math.min(offset, text.length)));
+	if (index === null) return null;
+	let start = index;
+	while (start > 0 && isIdentifierCharacter(text[start - 1] ?? "")) start -= 1;
+	let end = index + 1;
+	while (end < text.length && isIdentifierCharacter(text[end] ?? "")) end += 1;
+	if (end <= start) return null;
+	return {
+		start,
+		end
+	};
+}
+/** The identifier at `offset`, else the single visible character there. */
+function hoverTargetRange(text, offset) {
+	const identifier = identifierRangeAtOffset(text, offset);
+	if (identifier) return identifier;
+	const start = Math.max(0, Math.min(offset, Math.max(0, text.length - 1)));
+	return {
+		start,
+		end: Math.min(text.length, start + 1)
+	};
+}
+var HOVER_WINDOW_RADIUS = 256;
+/**
+* `hoverTargetRange` over a document source, reading a window of the offset's line rather than the
+* document. The window widens only while an identifier runs into its edge.
+*/
+function hoverTargetRangeInSource(source, offset) {
+	const line = source.lineRange(source.lineAt(Math.min(offset, Math.max(0, source.length - 1))));
+	const lineEnd = Math.min(source.length, line.end + 1);
+	for (let radius = HOVER_WINDOW_RADIUS;; radius *= 2) {
+		const from = Math.max(line.start, offset - radius);
+		const to = Math.min(lineEnd, Math.max(from, offset + radius));
+		const local = hoverTargetRange(source.readRange(from, to), offset - from);
+		const range = {
+			start: from + local.start,
+			end: from + local.end
+		};
+		const clippedLeft = range.start === from && from > line.start;
+		const clippedRight = range.end === to && to < lineEnd;
+		if (!clippedLeft && !clippedRight) return range;
+	}
+}
+function identifierIndexAtOffset(text, offset) {
+	if (isIdentifierCharacter(text[offset] ?? "")) return offset;
+	if (offset > 0 && isIdentifierCharacter(text[offset - 1] ?? "")) return offset - 1;
+	return null;
+}
+function isIdentifierCharacter(character) {
+	return /^[A-Za-z0-9_$]$/.test(character);
+}
+//#endregion
+export { hoverTargetRange, hoverTargetRangeInSource, identifierRangeAtOffset, sameOffsetRange, unionOffsetRange };
+
+//# sourceMappingURL=offsetRange.js.map

package/dist/offsetRange.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offsetRange.js","names":[],"sources":["../src/offsetRange.ts"],"sourcesContent":["import type { TextReadSnapshot } from '@singapore-editor/core/document'\n\n/** Half-open `[start, end)` offset range into the editor text buffer. */\nexport type OffsetRange = {\n  readonly start: number\n  readonly end: number\n}\n\nexport function sameOffsetRange(left: OffsetRange | null, right: OffsetRange): boolean {\n  return left?.start === right.start && left.end === right.end\n}\n\n/** The smallest range covering every range given, or null for none. */\nexport function unionOffsetRange(ranges: readonly OffsetRange[]): OffsetRange | null {\n  let union: OffsetRange | null = null\n  for (const range of ranges) {\n    if (!union) {\n      union = range\n      continue\n    }\n    union = { start: Math.min(union.start, range.start), end: Math.max(union.end, range.end) }\n  }\n  return union\n}\n\n/**\n * The identifier under `offset`, or null when the offset does not sit on an identifier character.\n * An identifier character is `[A-Za-z0-9_$]`, the set TypeScript's language service treats as part\n * of a name; an offset one past the last character still counts, so a caret right after a name\n * asks about that name.\n */\nexport function identifierRangeAtOffset(text: string, offset: number): OffsetRange | null {\n  const clamped = Math.max(0, Math.min(offset, text.length))\n  const index = identifierIndexAtOffset(text, clamped)\n  if (index === null) return null\n\n  let start = index\n  while (start > 0 && isIdentifierCharacter(text[start - 1] ?? '')) start -= 1\n\n  let end = index + 1\n  while (end < text.length && isIdentifierCharacter(text[end] ?? '')) end += 1\n\n  if (end <= start) return null\n  return { start, end }\n}\n\n/** The identifier at `offset`, else the single visible character there. */\nexport function hoverTargetRange(text: string, offset: number): OffsetRange {\n  const identifier = identifierRangeAtOffset(text, offset)\n  if (identifier) return identifier\n\n  const start = Math.max(0, Math.min(offset, Math.max(0, text.length - 1)))\n  return { start, end: Math.min(text.length, start + 1) }\n}\n\nconst HOVER_WINDOW_RADIUS = 256\n\n/**\n * `hoverTargetRange` over a document source, reading a window of the offset's line rather than the\n * document. The window widens only while an identifier runs into its edge.\n */\nexport function hoverTargetRangeInSource(source: TextReadSnapshot, offset: number): OffsetRange {\n  const line = source.lineRange(source.lineAt(Math.min(offset, Math.max(0, source.length - 1))))\n  // One past the break, so a caret on the line break targets it as the string search did.\n  const lineEnd = Math.min(source.length, line.end + 1)\n  for (let radius = HOVER_WINDOW_RADIUS; ; radius *= 2) {\n    const from = Math.max(line.start, offset - radius)\n    const to = Math.min(lineEnd, Math.max(from, offset + radius))\n    const local = hoverTargetRange(source.readRange(from, to), offset - from)\n    const range = { start: from + local.start, end: from + local.end }\n    const clippedLeft = range.start === from && from > line.start\n    const clippedRight = range.end === to && to < lineEnd\n    if (!clippedLeft && !clippedRight) return range\n  }\n}\n\nfunction identifierIndexAtOffset(text: string, offset: number): number | null {\n  if (isIdentifierCharacter(text[offset] ?? '')) return offset\n  if (offset > 0 && isIdentifierCharacter(text[offset - 1] ?? '')) return offset - 1\n  return null\n}\n\nfunction isIdentifierCharacter(character: string): boolean {\n  return /^[A-Za-z0-9_$]$/.test(character)\n}\n"],"mappings":";AAQA,SAAgB,gBAAgB,MAA0B,OAA6B;CACrF,OAAO,MAAM,UAAU,MAAM,SAAS,KAAK,QAAQ,MAAM;AAC3D;;AAGA,SAAgB,iBAAiB,QAAoD;CACnF,IAAI,QAA4B;CAChC,KAAK,MAAM,SAAS,QAAQ;EAC1B,IAAI,CAAC,OAAO;GACV,QAAQ;GACR;EACF;EACA,QAAQ;GAAE,OAAO,KAAK,IAAI,MAAM,OAAO,MAAM,KAAK;GAAG,KAAK,KAAK,IAAI,MAAM,KAAK,MAAM,GAAG;EAAE;CAC3F;CACA,OAAO;AACT;;;;;;;AAQA,SAAgB,wBAAwB,MAAc,QAAoC;CAExF,MAAM,QAAQ,wBAAwB,MADtB,KAAK,IAAI,GAAG,KAAK,IAAI,QAAQ,KAAK,MAAM,CACZ,CAAO;CACnD,IAAI,UAAU,MAAM,OAAO;CAE3B,IAAI,QAAQ;CACZ,OAAO,QAAQ,KAAK,sBAAsB,KAAK,QAAQ,MAAM,EAAE,GAAG,SAAS;CAE3E,IAAI,MAAM,QAAQ;CAClB,OAAO,MAAM,KAAK,UAAU,sBAAsB,KAAK,QAAQ,EAAE,GAAG,OAAO;CAE3E,IAAI,OAAO,OAAO,OAAO;CACzB,OAAO;EAAE;EAAO;CAAI;AACtB;;AAGA,SAAgB,iBAAiB,MAAc,QAA6B;CAC1E,MAAM,aAAa,wBAAwB,MAAM,MAAM;CACvD,IAAI,YAAY,OAAO;CAEvB,MAAM,QAAQ,KAAK,IAAI,GAAG,KAAK,IAAI,QAAQ,KAAK,IAAI,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC;CACxE,OAAO;EAAE;EAAO,KAAK,KAAK,IAAI,KAAK,QAAQ,QAAQ,CAAC;CAAE;AACxD;AAEA,IAAM,sBAAsB;;;;;AAM5B,SAAgB,yBAAyB,QAA0B,QAA6B;CAC9F,MAAM,OAAO,OAAO,UAAU,OAAO,OAAO,KAAK,IAAI,QAAQ,KAAK,IAAI,GAAG,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;CAE7F,MAAM,UAAU,KAAK,IAAI,OAAO,QAAQ,KAAK,MAAM,CAAC;CACpD,KAAK,IAAI,SAAS,sBAAuB,UAAU,GAAG;EACpD,MAAM,OAAO,KAAK,IAAI,KAAK,OAAO,SAAS,MAAM;EACjD,MAAM,KAAK,KAAK,IAAI,SAAS,KAAK,IAAI,MAAM,SAAS,MAAM,CAAC;EAC5D,MAAM,QAAQ,iBAAiB,OAAO,UAAU,MAAM,EAAE,GAAG,SAAS,IAAI;EACxE,MAAM,QAAQ;GAAE,OAAO,OAAO,MAAM;GAAO,KAAK,OAAO,MAAM;EAAI;EACjE,MAAM,cAAc,MAAM,UAAU,QAAQ,OAAO,KAAK;EACxD,MAAM,eAAe,MAAM,QAAQ,MAAM,KAAK;EAC9C,IAAI,CAAC,eAAe,CAAC,cAAc,OAAO;CAC5C;AACF;AAEA,SAAS,wBAAwB,MAAc,QAA+B;CAC5E,IAAI,sBAAsB,KAAK,WAAW,EAAE,GAAG,OAAO;CACtD,IAAI,SAAS,KAAK,sBAAsB,KAAK,SAAS,MAAM,EAAE,GAAG,OAAO,SAAS;CACjF,OAAO;AACT;AAEA,SAAS,sBAAsB,WAA4B;CACzD,OAAO,kBAAkB,KAAK,SAAS;AACzC"}

package/dist/styles.d.ts

@@ -0,0 +1,13 @@
+export declare const HOVER_COLORS: {
+    readonly background: string;
+    readonly foreground: string;
+    readonly border: string;
+    readonly shadow: string;
+    readonly separator: string;
+    readonly secondaryForeground: string;
+    readonly actionSuccess: string;
+    readonly actionFailure: string;
+};
+/** The variables the hover reads, for a surface mounted outside the editor's cascade. */
+export declare const HOVER_THEME_VARIABLES: readonly ["--editor-hover-background", "--editor-hover-foreground", "--editor-hover-border", "--editor-hover-shadow", "--editor-hover-separator", "--editor-hover-secondary-foreground", "--editor-hover-action-success", "--editor-hover-action-failure"];
+//# sourceMappingURL=styles.d.ts.map

package/dist/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../src/styles.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,YAAY;;;;;;;;;CA8Bf,CAAA;AAEV,yFAAyF;AACzF,eAAO,MAAM,qBAAqB,4PASxB,CAAA"}

package/dist/styles.js

@@ -0,0 +1,39 @@
+import { editorColorReference, registerEditorColor, transparentEditorColor } from "@singapore-editor/core/rendering";
+//#region src/styles.ts
+var HOVER_COLORS = {
+	background: registerEditorColor("hover.background", {
+		dark: "#252526",
+		light: "#f3f3f3"
+	}),
+	foreground: registerEditorColor("hover.foreground", editorColorReference("foreground")),
+	border: registerEditorColor("hover.border", transparentEditorColor(editorColorReference("foreground"), .28)),
+	shadow: registerEditorColor("hover.shadow", {
+		dark: "#0000005c",
+		light: "#00000029"
+	}),
+	separator: registerEditorColor("hover.separator", transparentEditorColor(editorColorReference("foreground"), .18)),
+	secondaryForeground: registerEditorColor("hover.secondaryForeground", transparentEditorColor(editorColorReference("foreground"), .72)),
+	actionSuccess: registerEditorColor("hover.actionSuccess", {
+		dark: "#86efac",
+		light: "#15803d"
+	}),
+	actionFailure: registerEditorColor("hover.actionFailure", {
+		dark: "#ef4444",
+		light: "#dc2626"
+	})
+};
+/** The variables the hover reads, for a surface mounted outside the editor's cascade. */
+var HOVER_THEME_VARIABLES = [
+	"--editor-hover-background",
+	"--editor-hover-foreground",
+	"--editor-hover-border",
+	"--editor-hover-shadow",
+	"--editor-hover-separator",
+	"--editor-hover-secondary-foreground",
+	"--editor-hover-action-success",
+	"--editor-hover-action-failure"
+];
+//#endregion
+export { HOVER_COLORS, HOVER_THEME_VARIABLES };
+
+//# sourceMappingURL=styles.js.map

package/dist/styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.js","names":[],"sources":["../src/styles.ts"],"sourcesContent":["import {\n  editorColorReference,\n  registerEditorColor,\n  transparentEditorColor,\n} from '@singapore-editor/core/rendering'\n\n/*\n * Every colour a shared surface paints with is a registered id, so a host restyles the hover\n * through the editor theme instead of forking this package.\n */\nexport const HOVER_COLORS = {\n  background: registerEditorColor('hover.background', {\n    dark: '#252526',\n    light: '#f3f3f3',\n  }),\n  foreground: registerEditorColor('hover.foreground', editorColorReference('foreground')),\n  border: registerEditorColor(\n    'hover.border',\n    transparentEditorColor(editorColorReference('foreground'), 0.28),\n  ),\n  shadow: registerEditorColor('hover.shadow', {\n    dark: '#0000005c',\n    light: '#00000029',\n  }),\n  separator: registerEditorColor(\n    'hover.separator',\n    transparentEditorColor(editorColorReference('foreground'), 0.18),\n  ),\n  secondaryForeground: registerEditorColor(\n    'hover.secondaryForeground',\n    transparentEditorColor(editorColorReference('foreground'), 0.72),\n  ),\n  actionSuccess: registerEditorColor('hover.actionSuccess', {\n    dark: '#86efac',\n    light: '#15803d',\n  }),\n  actionFailure: registerEditorColor('hover.actionFailure', {\n    dark: '#ef4444',\n    light: '#dc2626',\n  }),\n} as const\n\n/** The variables the hover reads, for a surface mounted outside the editor's cascade. */\nexport const HOVER_THEME_VARIABLES = [\n  '--editor-hover-background',\n  '--editor-hover-foreground',\n  '--editor-hover-border',\n  '--editor-hover-shadow',\n  '--editor-hover-separator',\n  '--editor-hover-secondary-foreground',\n  '--editor-hover-action-success',\n  '--editor-hover-action-failure',\n] as const\n"],"mappings":";;AAUA,IAAa,eAAe;CAC1B,YAAY,oBAAoB,oBAAoB;EAClD,MAAM;EACN,OAAO;CACT,CAAC;CACD,YAAY,oBAAoB,oBAAoB,qBAAqB,YAAY,CAAC;CACtF,QAAQ,oBACN,gBACA,uBAAuB,qBAAqB,YAAY,GAAG,GAAI,CACjE;CACA,QAAQ,oBAAoB,gBAAgB;EAC1C,MAAM;EACN,OAAO;CACT,CAAC;CACD,WAAW,oBACT,mBACA,uBAAuB,qBAAqB,YAAY,GAAG,GAAI,CACjE;CACA,qBAAqB,oBACnB,6BACA,uBAAuB,qBAAqB,YAAY,GAAG,GAAI,CACjE;CACA,eAAe,oBAAoB,uBAAuB;EACxD,MAAM;EACN,OAAO;CACT,CAAC;CACD,eAAe,oBAAoB,uBAAuB;EACxD,MAAM;EACN,OAAO;CACT,CAAC;AACH;;AAGA,IAAa,wBAAwB;CACnC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF"}

package/dist/tooltip.d.ts

@@ -0,0 +1,71 @@
+import type { EditorTheme } from '@singapore-editor/core/rendering';
+import { type AnchoredSurfacePlacement } from './anchoredSurface';
+import type { TooltipCodeTokenizer } from './codeTokens';
+/** The full pointer-settle delay. Semantic requests begin halfway through it. */
+export declare const HOVER_REQUEST_DEBOUNCE_MS = 300;
+export declare const HOVER_ASYNC_DISPATCH_DELAY_MS: number;
+export declare const HOVER_LOADING_DELAY_MS: number;
+export declare const TOOLTIP_HIDE_DELAY_MS = 300;
+export declare const COPY_BUTTON_RESET_DELAY_MS = 1200;
+export type TooltipAction = {
+    readonly label: string;
+    readonly run: () => void | Promise<void>;
+};
+/** A place a note points at, opened by the host: the other half of a duplicate, a related site. */
+export type TooltipNoteLink = {
+    /** What is clicked, such as `file.ts(12, 3): `. */
+    readonly label: string;
+    readonly text: string;
+    open(): void;
+};
+/** One line under the hover text, laid out as a VS Code marker: a diagnostic, a warning. */
+export type TooltipNote = {
+    /** Shown as written, so a multi-line message keeps its lines. */
+    readonly text: string;
+    /** Who raised it, and its code, shown muted after the message as VS Code does. */
+    readonly source?: string;
+    readonly code?: string;
+    /** Makes the code a link to its documentation. */
+    readonly codeHref?: string;
+    readonly related?: readonly TooltipNoteLink[];
+    readonly actions?: readonly TooltipAction[];
+};
+/** One row group of the tooltip; shown in the order given. */
+export type TooltipPart = {
+    readonly markdown?: string;
+    readonly notes?: readonly TooltipNote[];
+    readonly actions?: readonly TooltipAction[];
+};
+export type TooltipShowOptions = {
+    readonly anchor: DOMRect;
+    /** A single Markdown body, for a surface with one thing to say. */
+    readonly hoverText: string | null;
+    readonly parts?: readonly TooltipPart[];
+    readonly theme: EditorTheme | null;
+    readonly loading?: boolean;
+    readonly focus?: boolean;
+    readonly preferredPlacement?: AnchoredSurfacePlacement;
+};
+export type TooltipOptions = {
+    readonly document: Document;
+    readonly themeSource: HTMLElement;
+    readonly reentryElement: HTMLElement;
+    readonly markdownCodeBackground?: boolean;
+    readonly classNamespace?: string;
+    readonly codeTokenizer?: TooltipCodeTokenizer | null;
+    onDidHide?(): void;
+    onRequestEditorFocus?(): void;
+};
+export type TooltipController = {
+    show(options: TooltipShowOptions): void;
+    reanchor(anchor: DOMRect): void;
+    hide(): void;
+    scheduleHide(): void;
+    cancelHide(): void;
+    containsTarget(target: EventTarget | null): boolean;
+    /** Keeps a sticky hover only while the pointer is inside it or is still moving closer to it. */
+    shouldKeepForPointer(clientX: number, clientY: number): boolean;
+    dispose(): void;
+};
+export declare function createTooltipController(options: TooltipOptions): TooltipController;
+//# sourceMappingURL=tooltip.d.ts.map

package/dist/tooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooltip.d.ts","sourceRoot":"","sources":["../src/tooltip.ts"],"names":[],"mappings":"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"}