@ng-native/components 0.14.0 → 0.15.0

package/dist/markdown-stream.js

@@ -0,0 +1,282 @@
+/**
+ * A Markdown source that grows as it streams in, lexed a chunk at a time: the blocks before the
+ * last one are kept, only the last is lexed again, and syntax still open at its end is held back
+ * until it closes, so a half-written code span, emphasis, link, image, table row or code fence
+ * line never shows as the characters it is written with.
+ *
+ * Plain functions and a class with no Angular in them, beside `markdown-blocks.ts`.
+ */
+import { Lexer } from 'marked';
+/** Where the last token in `tokens` that is not blank space is, or -1. */
+function lastIndexOfBlock(tokens) {
+    let at = tokens.length - 1;
+    while (at >= 0 && tokens[at].type === 'space')
+        at--;
+    return at;
+}
+/** The last block in `tokens` that is not blank space, inside the last quote or list item. */
+function lastBlock(tokens) {
+    const last = tokens[lastIndexOfBlock(tokens)];
+    if (last?.type === 'list') {
+        const item = last.items.at(-1);
+        return (item && lastBlock(item.tokens)) ?? last;
+    }
+    if (last?.type === 'blockquote')
+        return lastBlock(last.tokens) ?? last;
+    return last;
+}
+const WHITESPACE = /\s/;
+const WORD = /[\p{L}\p{N}]/u;
+const PUNCTUATION = /[\p{P}\p{S}]/u;
+const DELIMITERS = /`+|\*+|_+|~+/g;
+/**
+ * The text tokens in `inline`, in order, each found in `tail` after the one before it, starting
+ * from `from`. A link or an image is passed over whole, as it closed.
+ */
+function leavesOf(inline, tail, from, leaves = []) {
+    let cursor = from;
+    for (const token of inline) {
+        const at = tail.indexOf(token.raw, cursor);
+        const children = token.tokens;
+        if (token.type === 'text' && !children?.length)
+            leaves.push({ raw: token.raw, at });
+        else if (children && token.type !== 'link' && token.type !== 'image') {
+            leavesOf(children, tail, at < 0 ? cursor : at, leaves);
+        }
+        if (at >= 0)
+            cursor = at + token.raw.length;
+    }
+    return leaves;
+}
+/**
+ * Where the first delimiter in a text token at `at` in `tail` is that could still open a code span
+ * or an emphasis. A backtick left as text always could. An asterisk, underscore or tilde could
+ * when what follows is not a space, or has not arrived yet, and is not punctuation straight after
+ * a letter or digit; an underscore inside a word cannot. What is before and after the delimiter
+ * is read from `tail`, since a text token can end where another token starts.
+ */
+function openerIn(raw, at, tail) {
+    for (const match of raw.matchAll(DELIMITERS)) {
+        const from = at + match.index;
+        const next = tail[from + match[0].length];
+        if (canOpen(match[0], tail[from - 1], next))
+            return from;
+    }
+    return null;
+}
+/** Whether a delimiter run, between `before` and `next`, could open a code span or an emphasis. */
+function canOpen(run, before, next) {
+    if (run[0] === '`')
+        return true;
+    if (next !== undefined && WHITESPACE.test(next))
+        return false;
+    const afterWord = before !== undefined && WORD.test(before);
+    if (afterWord && next !== undefined && PUNCTUATION.test(next))
+        return false;
+    if (run[0] === '_' && afterWord)
+        return false;
+    return !(run[0] === '~' && run.length > 2);
+}
+/** Where a fenced code block's half-written fence line starts, or null when it has none. */
+function heldFence(block, tail) {
+    const fence = /^ {0,3}(`{3,}|~{3,})/.exec(block.raw);
+    if (!fence)
+        return null;
+    const lineStart = tail.lastIndexOf('\n') + 1;
+    // An opening fence whose info string is still arriving.
+    if (!block.raw.includes('\n'))
+        return lineStart;
+    // A closing fence, or a line of the fence's own marker that may yet grow into one: a run too
+    // short to close it can grow only while nothing follows it. The block's own last line, since in
+    // a quote or a list item the source line starts with their markers.
+    const closing = fence[1][0] === '`' ? /^ {0,3}(`+)(\s*)$/ : /^ {0,3}(~+)(\s*)$/;
+    const last = closing.exec(block.raw.slice(block.raw.lastIndexOf('\n') + 1));
+    const grows = last && (!last[2] || last[1].length >= fence[1].length);
+    return grows && !tail.endsWith('\n') ? lineStart : null;
+}
+/**
+ * Where a paragraph that starts like a table row starts, while it is a header row whose delimiter
+ * row has not arrived, or is arriving, and so a table once it does.
+ */
+function heldHeaderRow(block, tail) {
+    const lines = block.raw.trimEnd().split('\n');
+    // A header row has a pipe, leading or not, as in marked's table syntax.
+    if (!lines[0].includes('|'))
+        return null;
+    if (lines.length > 2)
+        return null;
+    // A second line that has ended, or that can no longer be a delimiter row, made no table.
+    if (lines.length === 2 && (tail.endsWith('\n') || !/^[\s|:-]*$/.test(lines[1])))
+        return null;
+    const first = tail.lastIndexOf(lines[0].trim());
+    return first < 0 ? null : tail.lastIndexOf('\n', first - 1) + 1;
+}
+/**
+ * From where in `tail` a bracket starts an unfinished link: a label still open, a label that a
+ * target may yet follow, or a target still open. Each has at most one closing bracket after its
+ * opening one, so the two last closing brackets in `tail` bound where it can start.
+ */
+function unfinishedLinksFrom(tail) {
+    const close = tail.lastIndexOf(']');
+    if (close < 0)
+        return 0;
+    const after = tail.slice(close + 1);
+    const open = after === '' || after[0] === '[' || (after[0] === '(' && !after.includes(')'));
+    return open ? tail.lastIndexOf(']', close - 1) + 1 : close + 1;
+}
+/**
+ * Where the first unfinished link, code span or emphasis in `inline` starts in `tail`, found in
+ * one pass over its text tokens. Cutting at the first, rather than the last, means the source is
+ * lexed again only when the cut opens a span that closed after it, not once for each delimiter
+ * that never closes.
+ */
+function heldInline(inline, tail, start) {
+    const leaves = leavesOf(inline, tail, start);
+    const links = unfinishedLinksFrom(tail);
+    for (const { raw, at } of leaves) {
+        if (at < 0)
+            continue;
+        const opener = openerIn(raw, at, tail);
+        for (let bracket = raw.indexOf('['); bracket >= 0; bracket = raw.indexOf('[', bracket + 1)) {
+            const from = at + bracket;
+            if (opener !== null && from > opener)
+                break;
+            if (from >= links)
+                return tail[from - 1] === '!' ? from - 1 : from;
+        }
+        if (opener !== null)
+            return opener;
+    }
+    return null;
+}
+/** Where `tail` is cut so its last block shows nothing half written, or null to show all of it. */
+function holdBackAt(tail, tokens) {
+    const block = lastBlock(tokens);
+    if (!block)
+        return null;
+    if (block.type === 'code')
+        return heldFence(block, tail);
+    if (block.type === 'table')
+        return tail.endsWith('\n') ? null : tail.lastIndexOf('\n') + 1;
+    const header = block.type === 'paragraph' ? heldHeaderRow(block, tail) : null;
+    if (header !== null)
+        return header;
+    const inline = block.tokens;
+    return inline ? heldInline(inline, tail, floorOf(tail, tokens)) : null;
+}
+/**
+ * Where the last block starts in `tail`, inside a quote or a list item too, found by its first
+ * line since there each source line starts with their markers.
+ */
+function floorOf(tail, tokens) {
+    const block = lastBlock(tokens);
+    if (!block)
+        return tail.length;
+    // Its whole source when that is in the tail as it is, since its first line can come again.
+    const whole = tail.lastIndexOf(block.raw.trimEnd());
+    return Math.max(0, whole >= 0 ? whole : tail.lastIndexOf(block.raw.split('\n')[0]));
+}
+/** A line's quote and list item markers, up to where the block they hold starts. */
+const MARKERS = /^(?:[ \t]*(?:>|[-+*](?=[ \t])|\d{1,9}[.)](?=[ \t])))*[ \t]*$/;
+/**
+ * Where the markers before `at` on its line start, when only markers are before it, or `at`. A
+ * block held back whole takes its markers with it, or a list item marker left behind would join
+ * the paragraph before it.
+ */
+function markersStart(tail, at) {
+    const line = tail.lastIndexOf('\n', at - 1) + 1;
+    return MARKERS.test(tail.slice(line, at)) ? line : at;
+}
+/**
+ * `tail` lexed, cut back until nothing at its end is half written. Only its last block is cut:
+ * once a cut reaches where that block starts, the blocks before it, in its quote or list item
+ * too, are drawn as they are.
+ */
+function lexHeldBack(tail, links) {
+    let floor;
+    for (;;) {
+        const lexer = new Lexer();
+        Object.assign(lexer.tokens.links, links);
+        const tokens = lexer.lex(tail);
+        floor ??= floorOf(tail, tokens);
+        const cut = floor < tail.length ? holdBackAt(tail, tokens) : null;
+        if (cut === null || cut >= tail.length)
+            return { tokens, links: tokens.links };
+        tail = tail.slice(0, cut > floor ? cut : markersStart(tail, floor));
+    }
+}
+/** Adds the link references `token` defines, in a quote or a list item too, as marked does. */
+function addDefinitions(token, links) {
+    if (token.type === 'def') {
+        const def = token;
+        links[def.tag] ??= { href: def.href, title: def.title };
+    }
+    const inner = token.type === 'list'
+        ? token.items
+        : token.type === 'blockquote' || token.type === 'list_item'
+            ? token.tokens
+            : undefined;
+    for (const child of inner ?? [])
+        addDefinitions(child, links);
+}
+function sameLinks(next, previous) {
+    const names = Object.keys(next);
+    if (names.length !== Object.keys(previous).length)
+        return false;
+    return names.every((name) => previous[name]?.href === next[name].href && previous[name]?.title === next[name].title);
+}
+/**
+ * Lexes a source that grows, keeping the blocks before the last one from the lex before. A source
+ * that does not start with the one before is lexed whole, as is one whose new tail defines a link
+ * reference or changes one, since that can change a block already kept.
+ */
+export class MarkdownStream {
+    source = '';
+    /** The blocks before the last one, whose raw text is the start of the source exactly. */
+    settled = [];
+    /** How much of the source the settled blocks are. */
+    settledLength = 0;
+    /** The link references the settled blocks define. */
+    settledLinks = {};
+    /** The link references the whole source defines. */
+    links = {};
+    lex(text) {
+        const source = text.replace(/\r\n?/g, '\n');
+        const grown = source.startsWith(this.source);
+        let settled = grown ? this.settled : [];
+        let offset = grown ? this.settledLength : 0;
+        let links = grown ? this.settledLinks : {};
+        let tail = lexHeldBack(source.slice(offset), links);
+        if (settled.length && !sameLinks(tail.links, this.links)) {
+            settled = [];
+            offset = 0;
+            links = {};
+            tail = lexHeldBack(source, links);
+        }
+        this.settle(source, settled, offset, links, tail.tokens);
+        this.source = source;
+        this.links = tail.links;
+        return [...settled, ...tail.tokens];
+    }
+    /**
+     * Keeps the tail's blocks before its last one as settled, as far as their raw text is the
+     * source's: marked trims some blocks' raw text, and the lex after starts again from there.
+     */
+    settle(source, settled, offset, links, tail) {
+        const last = lastIndexOfBlock(tail);
+        const kept = [...settled];
+        const keptLinks = { ...links };
+        for (let i = 0; i < last; i++) {
+            const token = tail[i];
+            if (!source.startsWith(token.raw, offset))
+                break;
+            kept.push(token);
+            offset += token.raw.length;
+            addDefinitions(token, keptLinks);
+        }
+        this.settled = kept;
+        this.settledLength = offset;
+        this.settledLinks = keptLinks;
+    }
+}
+//# sourceMappingURL=markdown-stream.js.map

package/dist/markdown-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-stream.js","sourceRoot":"","sources":["../src/markdown-stream.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * A Markdown source that grows as it streams in, lexed a chunk at a time: the blocks before the\n * last one are kept, only the last is lexed again, and syntax still open at its end is held back\n * until it closes, so a half-written code span, emphasis, link, image, table row or code fence\n * line never shows as the characters it is written with.\n *\n * Plain functions and a class with no Angular in them, beside `markdown-blocks.ts`.\n */\nimport { Lexer, type Token, type Tokens, type TokensList } from 'marked';\n\ntype Links = TokensList['links'];\n\n/** Where the last token in `tokens` that is not blank space is, or -1. */\nfunction lastIndexOfBlock(tokens: readonly Token[]): number {\n  let at = tokens.length - 1;\n  while (at >= 0 && tokens[at]!.type === 'space') at--;\n  return at;\n}\n\n/** The last block in `tokens` that is not blank space, inside the last quote or list item. */\nfunction lastBlock(tokens: readonly Token[]): Token | undefined {\n  const last = tokens[lastIndexOfBlock(tokens)];\n  if (last?.type === 'list') {\n    const item = (last as Tokens.List).items.at(-1);\n    return (item && lastBlock(item.tokens)) ?? last;\n  }\n  if (last?.type === 'blockquote') return lastBlock((last as Tokens.Blockquote).tokens) ?? last;\n  return last;\n}\n\nconst WHITESPACE = /\\s/;\nconst WORD = /[\\p{L}\\p{N}]/u;\nconst PUNCTUATION = /[\\p{P}\\p{S}]/u;\nconst DELIMITERS = /`+|\\*+|_+|~+/g;\n\n/** A text token marked left as text, and where it is in the tail, or -1 when it was not found. */\ninterface Leaf {\n  readonly raw: string;\n  readonly at: number;\n}\n\n/**\n * The text tokens in `inline`, in order, each found in `tail` after the one before it, starting\n * from `from`. A link or an image is passed over whole, as it closed.\n */\nfunction leavesOf(inline: readonly Token[], tail: string, from: number, leaves: Leaf[] = []) {\n  let cursor = from;\n  for (const token of inline) {\n    const at = tail.indexOf(token.raw, cursor);\n    const children = (token as Tokens.Generic).tokens;\n    if (token.type === 'text' && !children?.length) leaves.push({ raw: token.raw, at });\n    else if (children && token.type !== 'link' && token.type !== 'image') {\n      leavesOf(children, tail, at < 0 ? cursor : at, leaves);\n    }\n    if (at >= 0) cursor = at + token.raw.length;\n  }\n  return leaves;\n}\n\n/**\n * Where the first delimiter in a text token at `at` in `tail` is that could still open a code span\n * or an emphasis. A backtick left as text always could. An asterisk, underscore or tilde could\n * when what follows is not a space, or has not arrived yet, and is not punctuation straight after\n * a letter or digit; an underscore inside a word cannot. What is before and after the delimiter\n * is read from `tail`, since a text token can end where another token starts.\n */\nfunction openerIn(raw: string, at: number, tail: string): number | null {\n  for (const match of raw.matchAll(DELIMITERS)) {\n    const from = at + match.index;\n    const next = tail[from + match[0].length];\n    if (canOpen(match[0], tail[from - 1], next)) return from;\n  }\n  return null;\n}\n\n/** Whether a delimiter run, between `before` and `next`, could open a code span or an emphasis. */\nfunction canOpen(run: string, before: string | undefined, next: string | undefined) {\n  if (run[0] === '`') return true;\n  if (next !== undefined && WHITESPACE.test(next)) return false;\n  const afterWord = before !== undefined && WORD.test(before);\n  if (afterWord && next !== undefined && PUNCTUATION.test(next)) return false;\n  if (run[0] === '_' && afterWord) return false;\n  return !(run[0] === '~' && run.length > 2);\n}\n\n/** Where a fenced code block's half-written fence line starts, or null when it has none. */\nfunction heldFence(block: Token, tail: string): number | null {\n  const fence = /^ {0,3}(`{3,}|~{3,})/.exec(block.raw);\n  if (!fence) return null;\n  const lineStart = tail.lastIndexOf('\\n') + 1;\n  // An opening fence whose info string is still arriving.\n  if (!block.raw.includes('\\n')) return lineStart;\n  // A closing fence, or a line of the fence's own marker that may yet grow into one: a run too\n  // short to close it can grow only while nothing follows it. The block's own last line, since in\n  // a quote or a list item the source line starts with their markers.\n  const closing = fence[1]![0] === '`' ? /^ {0,3}(`+)(\\s*)$/ : /^ {0,3}(~+)(\\s*)$/;\n  const last = closing.exec(block.raw.slice(block.raw.lastIndexOf('\\n') + 1));\n  const grows = last && (!last[2] || last[1]!.length >= fence[1]!.length);\n  return grows && !tail.endsWith('\\n') ? lineStart : null;\n}\n\n/**\n * Where a paragraph that starts like a table row starts, while it is a header row whose delimiter\n * row has not arrived, or is arriving, and so a table once it does.\n */\nfunction heldHeaderRow(block: Token, tail: string): number | null {\n  const lines = block.raw.trimEnd().split('\\n');\n  // A header row has a pipe, leading or not, as in marked's table syntax.\n  if (!lines[0]!.includes('|')) return null;\n  if (lines.length > 2) return null;\n  // A second line that has ended, or that can no longer be a delimiter row, made no table.\n  if (lines.length === 2 && (tail.endsWith('\\n') || !/^[\\s|:-]*$/.test(lines[1]!))) return null;\n  const first = tail.lastIndexOf(lines[0]!.trim());\n  return first < 0 ? null : tail.lastIndexOf('\\n', first - 1) + 1;\n}\n\n/**\n * From where in `tail` a bracket starts an unfinished link: a label still open, a label that a\n * target may yet follow, or a target still open. Each has at most one closing bracket after its\n * opening one, so the two last closing brackets in `tail` bound where it can start.\n */\nfunction unfinishedLinksFrom(tail: string): number {\n  const close = tail.lastIndexOf(']');\n  if (close < 0) return 0;\n  const after = tail.slice(close + 1);\n  const open = after === '' || after[0] === '[' || (after[0] === '(' && !after.includes(')'));\n  return open ? tail.lastIndexOf(']', close - 1) + 1 : close + 1;\n}\n\n/**\n * Where the first unfinished link, code span or emphasis in `inline` starts in `tail`, found in\n * one pass over its text tokens. Cutting at the first, rather than the last, means the source is\n * lexed again only when the cut opens a span that closed after it, not once for each delimiter\n * that never closes.\n */\nfunction heldInline(inline: readonly Token[], tail: string, start: number): number | null {\n  const leaves = leavesOf(inline, tail, start);\n  const links = unfinishedLinksFrom(tail);\n  for (const { raw, at } of leaves) {\n    if (at < 0) continue;\n    const opener = openerIn(raw, at, tail);\n    for (let bracket = raw.indexOf('['); bracket >= 0; bracket = raw.indexOf('[', bracket + 1)) {\n      const from = at + bracket;\n      if (opener !== null && from > opener) break;\n      if (from >= links) return tail[from - 1] === '!' ? from - 1 : from;\n    }\n    if (opener !== null) return opener;\n  }\n  return null;\n}\n\n/** Where `tail` is cut so its last block shows nothing half written, or null to show all of it. */\nfunction holdBackAt(tail: string, tokens: readonly Token[]): number | null {\n  const block = lastBlock(tokens);\n  if (!block) return null;\n  if (block.type === 'code') return heldFence(block, tail);\n  if (block.type === 'table') return tail.endsWith('\\n') ? null : tail.lastIndexOf('\\n') + 1;\n  const header = block.type === 'paragraph' ? heldHeaderRow(block, tail) : null;\n  if (header !== null) return header;\n  const inline = (block as Tokens.Generic).tokens;\n  return inline ? heldInline(inline, tail, floorOf(tail, tokens)) : null;\n}\n\n/**\n * Where the last block starts in `tail`, inside a quote or a list item too, found by its first\n * line since there each source line starts with their markers.\n */\nfunction floorOf(tail: string, tokens: readonly Token[]): number {\n  const block = lastBlock(tokens);\n  if (!block) return tail.length;\n  // Its whole source when that is in the tail as it is, since its first line can come again.\n  const whole = tail.lastIndexOf(block.raw.trimEnd());\n  return Math.max(0, whole >= 0 ? whole : tail.lastIndexOf(block.raw.split('\\n')[0]!));\n}\n\n/** A line's quote and list item markers, up to where the block they hold starts. */\nconst MARKERS = /^(?:[ \\t]*(?:>|[-+*](?=[ \\t])|\\d{1,9}[.)](?=[ \\t])))*[ \\t]*$/;\n\n/**\n * Where the markers before `at` on its line start, when only markers are before it, or `at`. A\n * block held back whole takes its markers with it, or a list item marker left behind would join\n * the paragraph before it.\n */\nfunction markersStart(tail: string, at: number): number {\n  const line = tail.lastIndexOf('\\n', at - 1) + 1;\n  return MARKERS.test(tail.slice(line, at)) ? line : at;\n}\n\n/**\n * `tail` lexed, cut back until nothing at its end is half written. Only its last block is cut:\n * once a cut reaches where that block starts, the blocks before it, in its quote or list item\n * too, are drawn as they are.\n */\nfunction lexHeldBack(tail: string, links: Links): { tokens: Token[]; links: Links } {\n  let floor: number | undefined;\n  for (;;) {\n    const lexer = new Lexer();\n    Object.assign(lexer.tokens.links, links);\n    const tokens = lexer.lex(tail);\n    floor ??= floorOf(tail, tokens);\n    const cut = floor < tail.length ? holdBackAt(tail, tokens) : null;\n    if (cut === null || cut >= tail.length) return { tokens, links: tokens.links };\n    tail = tail.slice(0, cut > floor ? cut : markersStart(tail, floor));\n  }\n}\n\n/** Adds the link references `token` defines, in a quote or a list item too, as marked does. */\nfunction addDefinitions(token: Token, links: Links) {\n  if (token.type === 'def') {\n    const def = token as Tokens.Def;\n    links[def.tag] ??= { href: def.href, title: def.title };\n  }\n  const inner =\n    token.type === 'list'\n      ? (token as Tokens.List).items\n      : token.type === 'blockquote' || token.type === 'list_item'\n        ? (token as Tokens.Generic).tokens\n        : undefined;\n  for (const child of inner ?? []) addDefinitions(child, links);\n}\n\nfunction sameLinks(next: Links, previous: Links): boolean {\n  const names = Object.keys(next);\n  if (names.length !== Object.keys(previous).length) return false;\n  return names.every(\n    (name) =>\n      previous[name]?.href === next[name]!.href && previous[name]?.title === next[name]!.title,\n  );\n}\n\n/**\n * Lexes a source that grows, keeping the blocks before the last one from the lex before. A source\n * that does not start with the one before is lexed whole, as is one whose new tail defines a link\n * reference or changes one, since that can change a block already kept.\n */\nexport class MarkdownStream {\n  private source = '';\n  /** The blocks before the last one, whose raw text is the start of the source exactly. */\n  private settled: Token[] = [];\n  /** How much of the source the settled blocks are. */\n  private settledLength = 0;\n  /** The link references the settled blocks define. */\n  private settledLinks: Links = {};\n  /** The link references the whole source defines. */\n  private links: Links = {};\n\n  lex(text: string): Token[] {\n    const source = text.replace(/\\r\\n?/g, '\\n');\n    const grown = source.startsWith(this.source);\n    let settled = grown ? this.settled : [];\n    let offset = grown ? this.settledLength : 0;\n    let links = grown ? this.settledLinks : {};\n    let tail = lexHeldBack(source.slice(offset), links);\n    if (settled.length && !sameLinks(tail.links, this.links)) {\n      settled = [];\n      offset = 0;\n      links = {};\n      tail = lexHeldBack(source, links);\n    }\n    this.settle(source, settled, offset, links, tail.tokens);\n    this.source = source;\n    this.links = tail.links;\n    return [...settled, ...tail.tokens];\n  }\n\n  /**\n   * Keeps the tail's blocks before its last one as settled, as far as their raw text is the\n   * source's: marked trims some blocks' raw text, and the lex after starts again from there.\n   */\n  private settle(source: string, settled: Token[], offset: number, links: Links, tail: Token[]) {\n    const last = lastIndexOfBlock(tail);\n    const kept = [...settled];\n    const keptLinks = { ...links };\n    for (let i = 0; i < last; i++) {\n      const token = tail[i]!;\n      if (!source.startsWith(token.raw, offset)) break;\n      kept.push(token);\n      offset += token.raw.length;\n      addDefinitions(token, keptLinks);\n    }\n    this.settled = kept;\n    this.settledLength = offset;\n    this.settledLinks = keptLinks;\n  }\n}\n"]}

package/dist/markdown.d.ts

@@ -1,6 +1,6 @@
 import { type Token } from 'marked';
 import type { ImageLoadEvent } from './events.ts';
-import { type MarkdownBlock, type MarkdownElement, type MarkdownInline } from './markdown-blocks.ts';
+import { blockKey, type MarkdownBlock, type MarkdownElement, type MarkdownInline } from './markdown-blocks.ts';
 import * as i0 from "@angular/core";
 export type { MarkdownElement } from './markdown-blocks.ts';
 /** Classes for the elements a document is drawn with, each one in place of the default. */
@@ -33,6 +33,15 @@ type MarkdownLink = Extract<MarkdownInline, {
  * dark. `classes` replaces one by its element's name, so a global stylesheet or Tailwind styles it
  * instead: `{ h1: 'text-3xl font-bold' }`. Put the default back beside your own to keep both.
  *
+ * For a source that grows as it streams in, an answer arriving a few words at a time, set
+ * `streaming` until it is complete. The blocks before the last one are then kept as they are and
+ * only the last is lexed and converted again, unless a chunk defines or changes a link reference,
+ * which can change a block already kept, and the whole source is lexed again. Syntax still open at its end, a code span, an emphasis, a link,
+ * an image or a table row, is held back until it closes. Of a code fence only an unfinished
+ * opening line is held back, and its code then streams as it arrives. Clearing `streaming` draws
+ * the whole source as written, and `tokens` are always drawn as given. A block that did not
+ * change keeps its views, streaming or not.
+ *
  * A pressed link is `(linkPress)`. An absolute target is then opened with `DeepLinks.open` unless
  * a handler calls `preventDefault()`; a relative one is only reported, for the app to route.
  */
@@ -44,20 +53,38 @@ export declare class Markdown {
     readonly source: import("@angular/core").InputSignal<string | undefined>;
     /** Tokens `marked.lexer` made already, drawn in place of `source`. */
     readonly tokens: import("@angular/core").InputSignal<readonly Token[] | undefined>;
+    /**
+     * Whether `source` is still arriving, a chunk at a time. While it is, only its last block is
+     * lexed again, unless a link reference changes, and syntax still open at its end is held back.
+     * See the class note.
+     */
+    readonly streaming: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
     /** A class for an element, in place of its default. See the class note. */
     readonly classes: import("@angular/core").InputSignal<Partial<Readonly<Record<MarkdownElement, string>>>>;
     /** A link was pressed. See the class note. */
     readonly linkPress: import("@angular/core").OutputEmitterRef<MarkdownLinkPress>;
-    protected readonly blocks: import("@angular/core").Signal<MarkdownBlock[]>;
+    private readonly stream;
+    protected readonly blockKey: typeof blockKey;
+    /**
+     * The blocks each token the stream kept was drawn as. A kept token is the same object from one
+     * chunk to the next, so its blocks are not converted or compared again; a source lexed whole
+     * makes new tokens, and so new blocks.
+     */
+    private readonly streamed;
+    /** The document's blocks, with each one that did not change kept, so it is not drawn again. */
+    protected readonly blocks: import("@angular/core").WritableSignal<readonly MarkdownBlock[]>;
     private readonly classOf;
     /**
      * Each image's width over its height, once it has loaded, so it is drawn at the page's width and
      * its own shape. An image the document no longer has is forgotten when the document changes.
      */
     protected readonly ratios: import("@angular/core").WritableSignal<ReadonlyMap<string, number>>;
+    private lex;
+    /** `tokens`' blocks, converting and sharing only those of tokens the stream had not kept. */
+    private streamedBlocks;
     protected classFor(element: MarkdownElement): string;
     protected sizeImage(src: string, event: Partial<ImageLoadEvent>): void;
     protected followLink(link: MarkdownLink): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<Markdown, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<Markdown, "markdown", never, { "source": { "alias": "source"; "required": false; "isSignal": true; }; "tokens": { "alias": "tokens"; "required": false; "isSignal": true; }; "classes": { "alias": "classes"; "required": false; "isSignal": true; }; }, { "linkPress": "linkPress"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<Markdown, "markdown", never, { "source": { "alias": "source"; "required": false; "isSignal": true; }; "tokens": { "alias": "tokens"; "required": false; "isSignal": true; }; "streaming": { "alias": "streaming"; "required": false; "isSignal": true; }; "classes": { "alias": "classes"; "required": false; "isSignal": true; }; }, { "linkPress": "linkPress"; }, never, never, true, never>;
 }