@simple-mark/model 0.2.0 → 0.3.0

package/index.d.ts

@@ -6,6 +6,46 @@ export declare const markdownExtensions: MarkdownExtension[];
 /** A Lezer parser for that flavor, for hosts without CodeMirror (e.g. a canvas renderer). */
 export declare const markdownParser: import("@lezer/markdown").MarkdownParser;
 //#endregion
+//#region packages/model/src/links.d.ts
+interface LinkAt {
+  /** An image (`![alt](src)`) or anything else that links (links, autolinks, bare URLs). */
+  kind: 'link' | 'image';
+  /** The target as written; null when a reference (`[text][label]`) has no definition. */
+  target: string | null;
+  /** Where the link is in the text. */
+  from: number;
+  to: number;
+}
+/**
+ * The link at `pos`: a link, image, autolink, bare URL, or the URL of a definition
+ * (`[label]: url`). `text` must use one character per line break, so offsets match the tree.
+ */
+export declare function linkAt(tree: Tree, text: string, pos: number): LinkAt | null;
+/**
+ * What a link target is:
+ * - `web`: http(s), mailto, or a bare `www.` address (given back as a full URL)
+ * - `anchor`: `#heading` in the same document
+ * - `file`: a relative or absolute path (an image, another Markdown file, …)
+ * - `unsafe`: any other scheme (javascript:, data:, file:, …), which should not be opened
+ */
+export declare function linkKind(target: string): {
+  kind: 'web' | 'anchor' | 'file' | 'unsafe';
+  url: string;
+};
+/**
+ * The anchor of a heading, as GitHub makes it: lower case, punctuation removed, spaces as
+ * hyphens ("Next Steps!" → "next-steps", "다음 단계" → "다음-단계").
+ */
+export declare function headingSlug(heading: string): string;
+/**
+ * The headings of a document with their anchors; repeated anchors get -1, -2, … like GitHub.
+ * `from` is where each heading starts.
+ */
+export declare function headingAnchors(tree: Tree, text: string): {
+  anchor: string;
+  from: number;
+}[];
+//#endregion
 //#region packages/model/src/previews.d.ts
 /** An image as written in the document. */
 interface ImageSource {
@@ -142,4 +182,4 @@ export declare function resolveLineLook(blocks: Iterable<BlockStyle>, theme?: Th
 /** The look of text with these block and inline styles (any order). */
 export declare function resolveLook(blocks: Iterable<BlockStyle>, inline: Iterable<InlineStyle>, theme?: Theme): Look;
 //#endregion
-export type { BlockRange, BlockStyle, ColumnAlign, ImageSource, InlineStyle, LineLook, Look, MarkdownStyles, PreviewBlock, RenderedTable, RowCell, Span, Table, Theme };
+export type { BlockRange, BlockStyle, ColumnAlign, ImageSource, InlineStyle, LineLook, LinkAt, Look, MarkdownStyles, PreviewBlock, RenderedTable, RowCell, Span, Table, Theme };

package/index.js

@@ -104,6 +104,7 @@ const markdownExtensions = [GFM, {
 const markdownParser = parser.configure(markdownExtensions);
 //#endregion
 //#region packages/model/src/previews.ts
+/** A reference label (`[Logo]`) as definitions are looked up: case and spacing ignored. */
 const normalizeLabel = (label) => label.slice(1, -1).trim().replace(/\s+/g, " ").toLowerCase();
 /** A link destination as written, without the optional angle brackets (`<a b.png>`). */
 const destination = (text, url) => text.slice(url.from, url.to).replace(/^<(.*)>$/, "$1");
@@ -195,6 +196,122 @@ function previewBlocks(tree, text) {
 	return blocks;
 }
 //#endregion
+//#region packages/model/src/links.ts
+/** Where a URL node is a link's target rather than a bare URL of its own. */
+const LINK_PARENTS = /* @__PURE__ */ new Set([
+	"Link",
+	"Image",
+	"Autolink",
+	"LinkReference"
+]);
+function targetOf(node, text, definitions) {
+	const url = node.name === "URL" ? node : node.getChild("URL");
+	if (url) return destination(text, url);
+	const marks = node.getChildren("LinkMark");
+	const content = marks.length >= 2 ? text.slice(marks[0].to, marks[1].from) : "";
+	const label = node.getChild("LinkLabel");
+	const labelText = label && label.to - label.from > 2 ? text.slice(label.from, label.to) : `[${content}]`;
+	return definitions().get(normalizeLabel(labelText)) ?? null;
+}
+/**
+* The link at `pos`: a link, image, autolink, bare URL, or the URL of a definition
+* (`[label]: url`). `text` must use one character per line break, so offsets match the tree.
+*/
+function linkAt(tree, text, pos) {
+	let definitions;
+	const lazyDefinitions = () => definitions ??= linkDefinitions(tree, text);
+	for (const side of [1, -1]) for (let node = tree.resolveInner(pos, side); node; node = node.parent) {
+		if (node.from > pos || node.to < pos) continue;
+		if (node.name === "Link" || node.name === "Image" || node.name === "Autolink") return {
+			kind: node.name === "Image" ? "image" : "link",
+			target: targetOf(node, text, lazyDefinitions),
+			from: node.from,
+			to: node.to
+		};
+		if (node.name === "URL" && !LINK_PARENTS.has(node.parent?.name ?? "")) return {
+			kind: "link",
+			target: destination(text, node),
+			from: node.from,
+			to: node.to
+		};
+		if (node.name === "URL" && node.parent?.name === "LinkReference") return {
+			kind: "link",
+			target: destination(text, node),
+			from: node.from,
+			to: node.to
+		};
+	}
+	return null;
+}
+/**
+* What a link target is:
+* - `web`: http(s), mailto, or a bare `www.` address (given back as a full URL)
+* - `anchor`: `#heading` in the same document
+* - `file`: a relative or absolute path (an image, another Markdown file, …)
+* - `unsafe`: any other scheme (javascript:, data:, file:, …), which should not be opened
+*/
+function linkKind(target) {
+	const url = target.trim();
+	if (/^(https?:\/\/|mailto:)/i.test(url)) return {
+		kind: "web",
+		url
+	};
+	if (/^www\./i.test(url)) return {
+		kind: "web",
+		url: `https://${url}`
+	};
+	if (/^[^\s/:@]+@[^\s/:@]+\.[^\s/:@]+$/.test(url)) return {
+		kind: "web",
+		url: `mailto:${url}`
+	};
+	if (url.startsWith("#")) return {
+		kind: "anchor",
+		url
+	};
+	if (/^[a-z][a-z0-9+.-]+:/i.test(url)) return {
+		kind: "unsafe",
+		url
+	};
+	return {
+		kind: "file",
+		url
+	};
+}
+/**
+* The anchor of a heading, as GitHub makes it: lower case, punctuation removed, spaces as
+* hyphens ("Next Steps!" → "next-steps", "다음 단계" → "다음-단계").
+*/
+function headingSlug(heading) {
+	return heading.trim().toLowerCase().replace(/[^\p{L}\p{N}\p{M}\s_-]/gu, "").replace(/\s/g, "-");
+}
+const HEADINGS = /^(ATXHeading[1-6]|SetextHeading[12])$/;
+/**
+* The headings of a document with their anchors; repeated anchors get -1, -2, … like GitHub.
+* `from` is where each heading starts.
+*/
+function headingAnchors(tree, text) {
+	const out = [];
+	const seen = /* @__PURE__ */ new Map();
+	for (let node = tree.topNode.firstChild; node; node = node.nextSibling) {
+		if (!HEADINGS.test(node.name)) continue;
+		let title = "";
+		let pos = node.from;
+		for (const mark of node.getChildren("HeaderMark")) {
+			title += text.slice(pos, mark.from);
+			pos = mark.to;
+		}
+		title += text.slice(pos, node.to);
+		const base = headingSlug(title.split("\n")[0]);
+		const count = seen.get(base) ?? 0;
+		seen.set(base, count + 1);
+		out.push({
+			anchor: count ? `${base}-${count}` : base,
+			from: node.from
+		});
+	}
+	return out;
+}
+//#endregion
 //#region packages/model/src/styles.ts
 /** Styles of whole lines, in precedence order (later wins when two set the same property). */
 const BLOCK_STYLES = [
@@ -597,4 +714,4 @@ function resolveLook(blocks, inline, theme = defaultTheme) {
 	return look;
 }
 //#endregion
-export { BLOCK_STYLES, INLINE_STYLES, cellAt, charWidth, defaultTheme, displayWidth, flattenSpans, markdownExtensions, markdownParser, markdownStyles, mathSource, parseTable, previewBlocks, renderTable, resolveLineLook, resolveLook, rowLine, splitRow };
+export { BLOCK_STYLES, INLINE_STYLES, cellAt, charWidth, defaultTheme, displayWidth, flattenSpans, headingAnchors, headingSlug, linkAt, linkKind, markdownExtensions, markdownParser, markdownStyles, mathSource, parseTable, previewBlocks, renderTable, resolveLineLook, resolveLook, rowLine, splitRow };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simple-mark/model",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Markdown parsing and styling model shared by every renderer. Pure TypeScript, no DOM.",
   "license": "MIT",
   "type": "module",