@flanksource/clicky-ui 0.3.15 → 0.3.17

package/dist/data/examples/markdown-syntax.js

@@ -0,0 +1,36 @@
+import source from "./markdown-syntax.md.js";
+const SECTION_MARKER = /^<!--section:(.+?)-->$/m;
+function slug(title) {
+  return title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+}
+function splitSections(text) {
+  var _a, _b;
+  const parts = text.split(SECTION_MARKER);
+  const sections = [];
+  for (let index = 1; index < parts.length; index += 2) {
+    const title = (_a = parts[index]) == null ? void 0 : _a.trim();
+    const markdown = (_b = parts[index + 1]) == null ? void 0 : _b.trim();
+    if (!title || !markdown) {
+      throw new Error(`markdown-syntax.md: empty section at marker ${index}`);
+    }
+    sections.push({ id: slug(title), title, markdown });
+  }
+  if (sections.length === 0) {
+    throw new Error("markdown-syntax.md: no <!--section:...--> markers found");
+  }
+  return sections;
+}
+const MARKDOWN_SYNTAX_SECTIONS = splitSections(source);
+const MARKDOWN_SYNTAX_DOCUMENT = [
+  "# Markdown syntax reference",
+  ...MARKDOWN_SYNTAX_SECTIONS.map(
+    (section) => `## ${section.title}
+
+${section.markdown}`
+  )
+].join("\n\n");
+export {
+  MARKDOWN_SYNTAX_DOCUMENT,
+  MARKDOWN_SYNTAX_SECTIONS
+};
+//# sourceMappingURL=markdown-syntax.js.map

package/dist/data/examples/markdown-syntax.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-syntax.js","sources":["../../../src/data/examples/markdown-syntax.ts"],"sourcesContent":["import source from \"./markdown-syntax.md?raw\";\n\nexport type MarkdownSyntaxSection = {\n  /** Slug of the title; used for demo anchors and test lookups. */\n  id: string;\n  title: string;\n  /** The section snippet, renderable on its own. */\n  markdown: string;\n};\n\n// The reference is authored as real markdown so the snippets stay readable and\n// escape-free. `<!--section:Title-->` markers split it into per-feature blocks;\n// they are HTML comments, so they render as nothing when the whole file is fed\n// to Markdown in one piece.\nconst SECTION_MARKER = /^<!--section:(.+?)-->$/m;\n\nfunction slug(title: string) {\n  return title\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-|-$/g, \"\");\n}\n\nfunction splitSections(text: string): MarkdownSyntaxSection[] {\n  // String.split with a capturing group interleaves [preamble, title, body, ...].\n  const parts = text.split(SECTION_MARKER);\n  const sections: MarkdownSyntaxSection[] = [];\n  for (let index = 1; index < parts.length; index += 2) {\n    const title = parts[index]?.trim();\n    const markdown = parts[index + 1]?.trim();\n    if (!title || !markdown) {\n      throw new Error(`markdown-syntax.md: empty section at marker ${index}`);\n    }\n    sections.push({ id: slug(title), title, markdown });\n  }\n  if (sections.length === 0) {\n    throw new Error(\"markdown-syntax.md: no <!--section:...--> markers found\");\n  }\n  return sections;\n}\n\n/** Every supported (and explicitly unsupported) construct, one entry per feature. */\nexport const MARKDOWN_SYNTAX_SECTIONS: readonly MarkdownSyntaxSection[] =\n  splitSections(source);\n\n/** The same sections as one navigable document, each under its own `##` heading. */\nexport const MARKDOWN_SYNTAX_DOCUMENT = [\n  \"# Markdown syntax reference\",\n  ...MARKDOWN_SYNTAX_SECTIONS.map(\n    (section) => `## ${section.title}\\n\\n${section.markdown}`,\n  ),\n].join(\"\\n\\n\");\n"],"names":[],"mappings":";AAcA,MAAM,iBAAiB;AAEvB,SAAS,KAAK,OAAe;AAC3B,SAAO,MACJ,cACA,QAAQ,eAAe,GAAG,EAC1B,QAAQ,UAAU,EAAE;AACzB;AAEA,SAAS,cAAc,MAAuC;;AAE5D,QAAM,QAAQ,KAAK,MAAM,cAAc;AACvC,QAAM,WAAoC,CAAA;AAC1C,WAAS,QAAQ,GAAG,QAAQ,MAAM,QAAQ,SAAS,GAAG;AACpD,UAAM,SAAQ,WAAM,KAAK,MAAX,mBAAc;AAC5B,UAAM,YAAW,WAAM,QAAQ,CAAC,MAAf,mBAAkB;AACnC,QAAI,CAAC,SAAS,CAAC,UAAU;AACvB,YAAM,IAAI,MAAM,+CAA+C,KAAK,EAAE;AAAA,IACxE;AACA,aAAS,KAAK,EAAE,IAAI,KAAK,KAAK,GAAG,OAAO,UAAU;AAAA,EACpD;AACA,MAAI,SAAS,WAAW,GAAG;AACzB,UAAM,IAAI,MAAM,yDAAyD;AAAA,EAC3E;AACA,SAAO;AACT;AAGO,MAAM,2BACX,cAAc,MAAM;AAGf,MAAM,2BAA2B;AAAA,EACtC;AAAA,EACA,GAAG,yBAAyB;AAAA,IAC1B,CAAC,YAAY,MAAM,QAAQ,KAAK;AAAA;AAAA,EAAO,QAAQ,QAAQ;AAAA,EAAA;AAE3D,EAAE,KAAK,MAAM;"}

package/dist/data/examples/markdown-syntax.md.cjs

@@ -0,0 +1,4 @@
+"use strict";
+const source = '<!--section:Headings-->\n# Heading level 1\n\n## Heading level 2\n\n### Heading level 3\n\n#### Heading level 4\n\n##### Heading level 5\n\n###### Heading level 6\n\nSetext level 1\n==============\n\nSetext level 2\n--------------\n\n<!--section:Paragraphs and line breaks-->\nA paragraph is one or more lines of text. Source lines that are merely wrapped\njoin back into a single line when rendered.\n\nTwo trailing spaces force a hard break,  \nso this continues on its own line. A trailing backslash does the same,\\\nand so does this one.\n\n<!--section:Emphasis and inline styles-->\n*Single asterisks* and _single underscores_ mark emphasis. **Double asterisks**\nand __double underscores__ mark strong text, and ***the two together*** combine\nthem. GFM adds ~~strikethrough~~.\n\nInline `code` uses single backticks. ``A span containing a ` backtick`` doubles\nthe fence.\n\n<!--section:Escapes and entities-->\nBackslash escapes keep markdown punctuation literal: \\*not emphasis\\*,\n\\_not emphasis\\_, \\`not code\\`, and \\# not a heading.\n\nNamed and numeric HTML entities resolve: &copy; 2026, A &amp; B, an em dash\n&mdash; an ellipsis &hellip; and a non-breaking&nbsp;space.\n\n<!--section:Lists-->\n- A bullet item\n- Another bullet item\n  - Nested one level\n    - Nested two levels\n- Back to the top level\n\nThe `-`, `*`, and `+` markers are interchangeable.\n\n1. An ordered item\n2. Another ordered item\n   1. Nested one level\n   2. Still nested\n3. Back to the top level\n\nOnly the first number matters; the rest are renumbered on render.\n\n1. A list item holds any block content while its continuation stays indented.\n\n   ```bash\n   pnpm --filter @flanksource/clicky-ui build\n   ```\n\n2. Blank lines between items make the list loose, so every item is wrapped in a\n   paragraph of its own.\n\n<!--section:Task lists-->\n- [x] A completed task\n- [ ] An outstanding task\n- [ ] A task with **emphasis**, `code`, and a [link](https://example.com)\n\n<!--section:Links-->\nAn [inline link](https://example.com), one\n[with a title](https://example.com "Shown on hover"), and one pointing at\n[a page fragment](#tables).\n\nAngle autolinks render their target: <https://example.com>.\n\nGFM literal autolinks need no markup at all — https://example.com,\nwww.example.com, and hello@example.com all become links.\n\n<!--section:Images-->\n![A blue swatch](/samples/markdown/swatch.svg "Images take an optional title")\n\nRelative and `http(s)` sources render. Inline `data:` sources are refused by the\nsanitizer, which substitutes a placeholder:\n\n![A blocked inline image](data:image/svg+xml;base64,PHN2Zy8+)\n\n<!--section:Blockquotes-->\n> A single-level quote.\n\n> A quote carries any block content:\n>\n> - a list,\n> - **inline formatting**,\n>\n> > and a nested quote.\n\n<!--section:Code-->\nA fence with a language hint renders through the library `CodeBlock`, which adds\ncopy, download, and per-block theme controls:\n\n```ts\nexport function greet(name: string): string {\n  return `Hello, ${name}`;\n}\n```\n\nA fence with no language falls back to plain text:\n\n```\nNo language hint here.\n```\n\nFour-space indentation also opens a code block:\n\n    indented code block\n    second line\n\n<!--section:Tables-->\nThe delimiter row sets column alignment — `:--` left, `:-:` center, `--:` right.\n\n| Feature   | Supported |  Since |\n| :-------- | :-------: | -----: |\n| Tables    |    yes    |    GFM |\n| Alignment |    yes    |    GFM |\n| Footnotes |    yes    |    GFM |\n\nCells take inline formatting, escape a literal pipe as `\\|`, and may be empty.\n\n| Cell        | Renders                      |\n| ----------- | ---------------------------- |\n| formatting  | **bold**, `code`, ~~struck~~ |\n| escaped bar | a \\| b                       |\n| empty       |                              |\n\n<!--section:Footnotes-->\nFootnotes are a GFM extension[^1]; labels may be words[^label], and the\ndefinitions collect at the end of the rendered block wherever they are written.\n\n[^1]: A numbered footnote definition.\n[^label]: Definitions are ordered by first reference, not by label.\n\n<!--section:Thematic breaks-->\nThree or more hyphens, asterisks, or underscores alone on a line draw a rule.\n\n---\n\n***\n\n___\n\n<!--section:Inline HTML-->\nRaw HTML inside the allow list passes through: press <kbd>Ctrl</kbd>+<kbd>C</kbd>,\nwrite H<sub>2</sub>O and E=mc<sup>2</sup>, mark text <ins>inserted</ins> or\n<del>deleted</del>, and break a line<br />like this.\n\n<details>\n<summary>A collapsible section</summary>\n\nMarkdown keeps working inside, including **emphasis** and lists:\n\n- one\n- two\n\n</details>\n\n<dl>\n  <dt>Definition list</dt>\n  <dd>Rendered from raw <code>dl</code>, <code>dt</code> and <code>dd</code> tags.</dd>\n</dl>\n\n<div align="center">A centered block.</div>\n\n<!--section:Sanitized HTML-->\nMarkup outside the allow list is removed. A script tag is dropped whole —\n<script>alert(\'xss\')<\/script>leaving nothing behind.\n\nUnlisted tags are unwrapped to their text, so <mark>mark</mark> and\n<abbr title="HyperText Markup Language">abbr</abbr> keep the words but lose the\nelement. HTML comments never reach the DOM:\n\n<!-- this comment is not rendered -->\n\n<!--section:Unsupported syntax-->\n### Reference links\n\nA link reference definition is a block of its own, which the streaming parser\nnever joins back up, so [reference links][ref] and ![reference images][ref] stay\nliteral.\n\n[ref]: https://example.com\n\n### Math\n\nKaTeX arrives with the optional `@streamdown/math` plugin, which this build does\nnot install, so $E = mc^2$ and $$a^2 + b^2 = c^2$$ render as plain text.\n\n### Mermaid\n\nDiagrams need the optional `@streamdown/mermaid` plugin. Without it a `mermaid`\nfence is just another code block:\n\n```mermaid\ngraph TD;\n  A[Start] --> B[Finish];\n```\n\n### Front matter\n\nYAML front matter is not stripped: the `---` delimiters parse as a thematic\nbreak followed by a setext heading.\n';
+module.exports = source;
+//# sourceMappingURL=markdown-syntax.md.cjs.map

package/dist/data/examples/markdown-syntax.md.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-syntax.md.cjs","sources":["../../../src/data/examples/markdown-syntax.md?raw"],"sourcesContent":["export default \"<!--section:Headings-->\\n# Heading level 1\\n\\n## Heading level 2\\n\\n### Heading level 3\\n\\n#### Heading level 4\\n\\n##### Heading level 5\\n\\n###### Heading level 6\\n\\nSetext level 1\\n==============\\n\\nSetext level 2\\n--------------\\n\\n<!--section:Paragraphs and line breaks-->\\nA paragraph is one or more lines of text. Source lines that are merely wrapped\\njoin back into a single line when rendered.\\n\\nTwo trailing spaces force a hard break,  \\nso this continues on its own line. A trailing backslash does the same,\\\\\\nand so does this one.\\n\\n<!--section:Emphasis and inline styles-->\\n*Single asterisks* and _single underscores_ mark emphasis. **Double asterisks**\\nand __double underscores__ mark strong text, and ***the two together*** combine\\nthem. GFM adds ~~strikethrough~~.\\n\\nInline `code` uses single backticks. ``A span containing a ` backtick`` doubles\\nthe fence.\\n\\n<!--section:Escapes and entities-->\\nBackslash escapes keep markdown punctuation literal: \\\\*not emphasis\\\\*,\\n\\\\_not emphasis\\\\_, \\\\`not code\\\\`, and \\\\# not a heading.\\n\\nNamed and numeric HTML entities resolve: &copy; 2026, A &amp; B, an em dash\\n&mdash; an ellipsis &hellip; and a non-breaking&nbsp;space.\\n\\n<!--section:Lists-->\\n- A bullet item\\n- Another bullet item\\n  - Nested one level\\n    - Nested two levels\\n- Back to the top level\\n\\nThe `-`, `*`, and `+` markers are interchangeable.\\n\\n1. An ordered item\\n2. Another ordered item\\n   1. Nested one level\\n   2. Still nested\\n3. Back to the top level\\n\\nOnly the first number matters; the rest are renumbered on render.\\n\\n1. A list item holds any block content while its continuation stays indented.\\n\\n   ```bash\\n   pnpm --filter @flanksource/clicky-ui build\\n   ```\\n\\n2. Blank lines between items make the list loose, so every item is wrapped in a\\n   paragraph of its own.\\n\\n<!--section:Task lists-->\\n- [x] A completed task\\n- [ ] An outstanding task\\n- [ ] A task with **emphasis**, `code`, and a [link](https://example.com)\\n\\n<!--section:Links-->\\nAn [inline link](https://example.com), one\\n[with a title](https://example.com \\\"Shown on hover\\\"), and one pointing at\\n[a page fragment](#tables).\\n\\nAngle autolinks render their target: <https://example.com>.\\n\\nGFM literal autolinks need no markup at all — https://example.com,\\nwww.example.com, and hello@example.com all become links.\\n\\n<!--section:Images-->\\n![A blue swatch](/samples/markdown/swatch.svg \\\"Images take an optional title\\\")\\n\\nRelative and `http(s)` sources render. Inline `data:` sources are refused by the\\nsanitizer, which substitutes a placeholder:\\n\\n![A blocked inline image](data:image/svg+xml;base64,PHN2Zy8+)\\n\\n<!--section:Blockquotes-->\\n> A single-level quote.\\n\\n> A quote carries any block content:\\n>\\n> - a list,\\n> - **inline formatting**,\\n>\\n> > and a nested quote.\\n\\n<!--section:Code-->\\nA fence with a language hint renders through the library `CodeBlock`, which adds\\ncopy, download, and per-block theme controls:\\n\\n```ts\\nexport function greet(name: string): string {\\n  return `Hello, ${name}`;\\n}\\n```\\n\\nA fence with no language falls back to plain text:\\n\\n```\\nNo language hint here.\\n```\\n\\nFour-space indentation also opens a code block:\\n\\n    indented code block\\n    second line\\n\\n<!--section:Tables-->\\nThe delimiter row sets column alignment — `:--` left, `:-:` center, `--:` right.\\n\\n| Feature   | Supported |  Since |\\n| :-------- | :-------: | -----: |\\n| Tables    |    yes    |    GFM |\\n| Alignment |    yes    |    GFM |\\n| Footnotes |    yes    |    GFM |\\n\\nCells take inline formatting, escape a literal pipe as `\\\\|`, and may be empty.\\n\\n| Cell        | Renders                      |\\n| ----------- | ---------------------------- |\\n| formatting  | **bold**, `code`, ~~struck~~ |\\n| escaped bar | a \\\\| b                       |\\n| empty       |                              |\\n\\n<!--section:Footnotes-->\\nFootnotes are a GFM extension[^1]; labels may be words[^label], and the\\ndefinitions collect at the end of the rendered block wherever they are written.\\n\\n[^1]: A numbered footnote definition.\\n[^label]: Definitions are ordered by first reference, not by label.\\n\\n<!--section:Thematic breaks-->\\nThree or more hyphens, asterisks, or underscores alone on a line draw a rule.\\n\\n---\\n\\n***\\n\\n___\\n\\n<!--section:Inline HTML-->\\nRaw HTML inside the allow list passes through: press <kbd>Ctrl</kbd>+<kbd>C</kbd>,\\nwrite H<sub>2</sub>O and E=mc<sup>2</sup>, mark text <ins>inserted</ins> or\\n<del>deleted</del>, and break a line<br />like this.\\n\\n<details>\\n<summary>A collapsible section</summary>\\n\\nMarkdown keeps working inside, including **emphasis** and lists:\\n\\n- one\\n- two\\n\\n</details>\\n\\n<dl>\\n  <dt>Definition list</dt>\\n  <dd>Rendered from raw <code>dl</code>, <code>dt</code> and <code>dd</code> tags.</dd>\\n</dl>\\n\\n<div align=\\\"center\\\">A centered block.</div>\\n\\n<!--section:Sanitized HTML-->\\nMarkup outside the allow list is removed. A script tag is dropped whole —\\n<script>alert('xss')</script>leaving nothing behind.\\n\\nUnlisted tags are unwrapped to their text, so <mark>mark</mark> and\\n<abbr title=\\\"HyperText Markup Language\\\">abbr</abbr> keep the words but lose the\\nelement. HTML comments never reach the DOM:\\n\\n<!-- this comment is not rendered -->\\n\\n<!--section:Unsupported syntax-->\\n### Reference links\\n\\nA link reference definition is a block of its own, which the streaming parser\\nnever joins back up, so [reference links][ref] and ![reference images][ref] stay\\nliteral.\\n\\n[ref]: https://example.com\\n\\n### Math\\n\\nKaTeX arrives with the optional `@streamdown/math` plugin, which this build does\\nnot install, so $E = mc^2$ and $$a^2 + b^2 = c^2$$ render as plain text.\\n\\n### Mermaid\\n\\nDiagrams need the optional `@streamdown/mermaid` plugin. Without it a `mermaid`\\nfence is just another code block:\\n\\n```mermaid\\ngraph TD;\\n  A[Start] --> B[Finish];\\n```\\n\\n### Front matter\\n\\nYAML front matter is not stripped: the `---` delimiters parse as a thematic\\nbreak followed by a setext heading.\\n\""],"names":[],"mappings":";AAAA,MAAA,SAAe;;"}

package/dist/data/examples/markdown-syntax.md.js

@@ -0,0 +1,5 @@
+const source = '<!--section:Headings-->\n# Heading level 1\n\n## Heading level 2\n\n### Heading level 3\n\n#### Heading level 4\n\n##### Heading level 5\n\n###### Heading level 6\n\nSetext level 1\n==============\n\nSetext level 2\n--------------\n\n<!--section:Paragraphs and line breaks-->\nA paragraph is one or more lines of text. Source lines that are merely wrapped\njoin back into a single line when rendered.\n\nTwo trailing spaces force a hard break,  \nso this continues on its own line. A trailing backslash does the same,\\\nand so does this one.\n\n<!--section:Emphasis and inline styles-->\n*Single asterisks* and _single underscores_ mark emphasis. **Double asterisks**\nand __double underscores__ mark strong text, and ***the two together*** combine\nthem. GFM adds ~~strikethrough~~.\n\nInline `code` uses single backticks. ``A span containing a ` backtick`` doubles\nthe fence.\n\n<!--section:Escapes and entities-->\nBackslash escapes keep markdown punctuation literal: \\*not emphasis\\*,\n\\_not emphasis\\_, \\`not code\\`, and \\# not a heading.\n\nNamed and numeric HTML entities resolve: &copy; 2026, A &amp; B, an em dash\n&mdash; an ellipsis &hellip; and a non-breaking&nbsp;space.\n\n<!--section:Lists-->\n- A bullet item\n- Another bullet item\n  - Nested one level\n    - Nested two levels\n- Back to the top level\n\nThe `-`, `*`, and `+` markers are interchangeable.\n\n1. An ordered item\n2. Another ordered item\n   1. Nested one level\n   2. Still nested\n3. Back to the top level\n\nOnly the first number matters; the rest are renumbered on render.\n\n1. A list item holds any block content while its continuation stays indented.\n\n   ```bash\n   pnpm --filter @flanksource/clicky-ui build\n   ```\n\n2. Blank lines between items make the list loose, so every item is wrapped in a\n   paragraph of its own.\n\n<!--section:Task lists-->\n- [x] A completed task\n- [ ] An outstanding task\n- [ ] A task with **emphasis**, `code`, and a [link](https://example.com)\n\n<!--section:Links-->\nAn [inline link](https://example.com), one\n[with a title](https://example.com "Shown on hover"), and one pointing at\n[a page fragment](#tables).\n\nAngle autolinks render their target: <https://example.com>.\n\nGFM literal autolinks need no markup at all — https://example.com,\nwww.example.com, and hello@example.com all become links.\n\n<!--section:Images-->\n![A blue swatch](/samples/markdown/swatch.svg "Images take an optional title")\n\nRelative and `http(s)` sources render. Inline `data:` sources are refused by the\nsanitizer, which substitutes a placeholder:\n\n![A blocked inline image](data:image/svg+xml;base64,PHN2Zy8+)\n\n<!--section:Blockquotes-->\n> A single-level quote.\n\n> A quote carries any block content:\n>\n> - a list,\n> - **inline formatting**,\n>\n> > and a nested quote.\n\n<!--section:Code-->\nA fence with a language hint renders through the library `CodeBlock`, which adds\ncopy, download, and per-block theme controls:\n\n```ts\nexport function greet(name: string): string {\n  return `Hello, ${name}`;\n}\n```\n\nA fence with no language falls back to plain text:\n\n```\nNo language hint here.\n```\n\nFour-space indentation also opens a code block:\n\n    indented code block\n    second line\n\n<!--section:Tables-->\nThe delimiter row sets column alignment — `:--` left, `:-:` center, `--:` right.\n\n| Feature   | Supported |  Since |\n| :-------- | :-------: | -----: |\n| Tables    |    yes    |    GFM |\n| Alignment |    yes    |    GFM |\n| Footnotes |    yes    |    GFM |\n\nCells take inline formatting, escape a literal pipe as `\\|`, and may be empty.\n\n| Cell        | Renders                      |\n| ----------- | ---------------------------- |\n| formatting  | **bold**, `code`, ~~struck~~ |\n| escaped bar | a \\| b                       |\n| empty       |                              |\n\n<!--section:Footnotes-->\nFootnotes are a GFM extension[^1]; labels may be words[^label], and the\ndefinitions collect at the end of the rendered block wherever they are written.\n\n[^1]: A numbered footnote definition.\n[^label]: Definitions are ordered by first reference, not by label.\n\n<!--section:Thematic breaks-->\nThree or more hyphens, asterisks, or underscores alone on a line draw a rule.\n\n---\n\n***\n\n___\n\n<!--section:Inline HTML-->\nRaw HTML inside the allow list passes through: press <kbd>Ctrl</kbd>+<kbd>C</kbd>,\nwrite H<sub>2</sub>O and E=mc<sup>2</sup>, mark text <ins>inserted</ins> or\n<del>deleted</del>, and break a line<br />like this.\n\n<details>\n<summary>A collapsible section</summary>\n\nMarkdown keeps working inside, including **emphasis** and lists:\n\n- one\n- two\n\n</details>\n\n<dl>\n  <dt>Definition list</dt>\n  <dd>Rendered from raw <code>dl</code>, <code>dt</code> and <code>dd</code> tags.</dd>\n</dl>\n\n<div align="center">A centered block.</div>\n\n<!--section:Sanitized HTML-->\nMarkup outside the allow list is removed. A script tag is dropped whole —\n<script>alert(\'xss\')<\/script>leaving nothing behind.\n\nUnlisted tags are unwrapped to their text, so <mark>mark</mark> and\n<abbr title="HyperText Markup Language">abbr</abbr> keep the words but lose the\nelement. HTML comments never reach the DOM:\n\n<!-- this comment is not rendered -->\n\n<!--section:Unsupported syntax-->\n### Reference links\n\nA link reference definition is a block of its own, which the streaming parser\nnever joins back up, so [reference links][ref] and ![reference images][ref] stay\nliteral.\n\n[ref]: https://example.com\n\n### Math\n\nKaTeX arrives with the optional `@streamdown/math` plugin, which this build does\nnot install, so $E = mc^2$ and $$a^2 + b^2 = c^2$$ render as plain text.\n\n### Mermaid\n\nDiagrams need the optional `@streamdown/mermaid` plugin. Without it a `mermaid`\nfence is just another code block:\n\n```mermaid\ngraph TD;\n  A[Start] --> B[Finish];\n```\n\n### Front matter\n\nYAML front matter is not stripped: the `---` delimiters parse as a thematic\nbreak followed by a setext heading.\n';
+export {
+  source as default
+};
+//# sourceMappingURL=markdown-syntax.md.js.map

package/dist/data/examples/markdown-syntax.md.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-syntax.md.js","sources":["../../../src/data/examples/markdown-syntax.md?raw"],"sourcesContent":["export default \"<!--section:Headings-->\\n# Heading level 1\\n\\n## Heading level 2\\n\\n### Heading level 3\\n\\n#### Heading level 4\\n\\n##### Heading level 5\\n\\n###### Heading level 6\\n\\nSetext level 1\\n==============\\n\\nSetext level 2\\n--------------\\n\\n<!--section:Paragraphs and line breaks-->\\nA paragraph is one or more lines of text. Source lines that are merely wrapped\\njoin back into a single line when rendered.\\n\\nTwo trailing spaces force a hard break,  \\nso this continues on its own line. A trailing backslash does the same,\\\\\\nand so does this one.\\n\\n<!--section:Emphasis and inline styles-->\\n*Single asterisks* and _single underscores_ mark emphasis. **Double asterisks**\\nand __double underscores__ mark strong text, and ***the two together*** combine\\nthem. GFM adds ~~strikethrough~~.\\n\\nInline `code` uses single backticks. ``A span containing a ` backtick`` doubles\\nthe fence.\\n\\n<!--section:Escapes and entities-->\\nBackslash escapes keep markdown punctuation literal: \\\\*not emphasis\\\\*,\\n\\\\_not emphasis\\\\_, \\\\`not code\\\\`, and \\\\# not a heading.\\n\\nNamed and numeric HTML entities resolve: &copy; 2026, A &amp; B, an em dash\\n&mdash; an ellipsis &hellip; and a non-breaking&nbsp;space.\\n\\n<!--section:Lists-->\\n- A bullet item\\n- Another bullet item\\n  - Nested one level\\n    - Nested two levels\\n- Back to the top level\\n\\nThe `-`, `*`, and `+` markers are interchangeable.\\n\\n1. An ordered item\\n2. Another ordered item\\n   1. Nested one level\\n   2. Still nested\\n3. Back to the top level\\n\\nOnly the first number matters; the rest are renumbered on render.\\n\\n1. A list item holds any block content while its continuation stays indented.\\n\\n   ```bash\\n   pnpm --filter @flanksource/clicky-ui build\\n   ```\\n\\n2. Blank lines between items make the list loose, so every item is wrapped in a\\n   paragraph of its own.\\n\\n<!--section:Task lists-->\\n- [x] A completed task\\n- [ ] An outstanding task\\n- [ ] A task with **emphasis**, `code`, and a [link](https://example.com)\\n\\n<!--section:Links-->\\nAn [inline link](https://example.com), one\\n[with a title](https://example.com \\\"Shown on hover\\\"), and one pointing at\\n[a page fragment](#tables).\\n\\nAngle autolinks render their target: <https://example.com>.\\n\\nGFM literal autolinks need no markup at all — https://example.com,\\nwww.example.com, and hello@example.com all become links.\\n\\n<!--section:Images-->\\n![A blue swatch](/samples/markdown/swatch.svg \\\"Images take an optional title\\\")\\n\\nRelative and `http(s)` sources render. Inline `data:` sources are refused by the\\nsanitizer, which substitutes a placeholder:\\n\\n![A blocked inline image](data:image/svg+xml;base64,PHN2Zy8+)\\n\\n<!--section:Blockquotes-->\\n> A single-level quote.\\n\\n> A quote carries any block content:\\n>\\n> - a list,\\n> - **inline formatting**,\\n>\\n> > and a nested quote.\\n\\n<!--section:Code-->\\nA fence with a language hint renders through the library `CodeBlock`, which adds\\ncopy, download, and per-block theme controls:\\n\\n```ts\\nexport function greet(name: string): string {\\n  return `Hello, ${name}`;\\n}\\n```\\n\\nA fence with no language falls back to plain text:\\n\\n```\\nNo language hint here.\\n```\\n\\nFour-space indentation also opens a code block:\\n\\n    indented code block\\n    second line\\n\\n<!--section:Tables-->\\nThe delimiter row sets column alignment — `:--` left, `:-:` center, `--:` right.\\n\\n| Feature   | Supported |  Since |\\n| :-------- | :-------: | -----: |\\n| Tables    |    yes    |    GFM |\\n| Alignment |    yes    |    GFM |\\n| Footnotes |    yes    |    GFM |\\n\\nCells take inline formatting, escape a literal pipe as `\\\\|`, and may be empty.\\n\\n| Cell        | Renders                      |\\n| ----------- | ---------------------------- |\\n| formatting  | **bold**, `code`, ~~struck~~ |\\n| escaped bar | a \\\\| b                       |\\n| empty       |                              |\\n\\n<!--section:Footnotes-->\\nFootnotes are a GFM extension[^1]; labels may be words[^label], and the\\ndefinitions collect at the end of the rendered block wherever they are written.\\n\\n[^1]: A numbered footnote definition.\\n[^label]: Definitions are ordered by first reference, not by label.\\n\\n<!--section:Thematic breaks-->\\nThree or more hyphens, asterisks, or underscores alone on a line draw a rule.\\n\\n---\\n\\n***\\n\\n___\\n\\n<!--section:Inline HTML-->\\nRaw HTML inside the allow list passes through: press <kbd>Ctrl</kbd>+<kbd>C</kbd>,\\nwrite H<sub>2</sub>O and E=mc<sup>2</sup>, mark text <ins>inserted</ins> or\\n<del>deleted</del>, and break a line<br />like this.\\n\\n<details>\\n<summary>A collapsible section</summary>\\n\\nMarkdown keeps working inside, including **emphasis** and lists:\\n\\n- one\\n- two\\n\\n</details>\\n\\n<dl>\\n  <dt>Definition list</dt>\\n  <dd>Rendered from raw <code>dl</code>, <code>dt</code> and <code>dd</code> tags.</dd>\\n</dl>\\n\\n<div align=\\\"center\\\">A centered block.</div>\\n\\n<!--section:Sanitized HTML-->\\nMarkup outside the allow list is removed. A script tag is dropped whole —\\n<script>alert('xss')</script>leaving nothing behind.\\n\\nUnlisted tags are unwrapped to their text, so <mark>mark</mark> and\\n<abbr title=\\\"HyperText Markup Language\\\">abbr</abbr> keep the words but lose the\\nelement. HTML comments never reach the DOM:\\n\\n<!-- this comment is not rendered -->\\n\\n<!--section:Unsupported syntax-->\\n### Reference links\\n\\nA link reference definition is a block of its own, which the streaming parser\\nnever joins back up, so [reference links][ref] and ![reference images][ref] stay\\nliteral.\\n\\n[ref]: https://example.com\\n\\n### Math\\n\\nKaTeX arrives with the optional `@streamdown/math` plugin, which this build does\\nnot install, so $E = mc^2$ and $$a^2 + b^2 = c^2$$ render as plain text.\\n\\n### Mermaid\\n\\nDiagrams need the optional `@streamdown/mermaid` plugin. Without it a `mermaid`\\nfence is just another code block:\\n\\n```mermaid\\ngraph TD;\\n  A[Start] --> B[Finish];\\n```\\n\\n### Front matter\\n\\nYAML front matter is not stripped: the `---` delimiters parse as a thematic\\nbreak followed by a setext heading.\\n\""],"names":[],"mappings":"AAAA,MAAA,SAAe;"}

package/dist/data/server-timing.cjs

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const METRIC_LABELS = {
+  total: "Total",
+  command: "Command",
+  format: "Format response",
+  sql: "SQL",
+  redis: "Redis"
+};
+const COUNTER_LABELS = {
+  queries: ["query", "queries"],
+  rows_returned: ["row returned", "rows returned"],
+  rows_scanned: ["row scanned", "rows scanned"],
+  ops: ["operation", "operations"],
+  hits: ["hit", "hits"],
+  misses: ["miss", "misses"],
+  errors: ["error", "errors"]
+};
+function splitOutsideQuotes(value, delimiter) {
+  const parts = [];
+  let start = 0;
+  let quoted = false;
+  let escaped = false;
+  for (let index = 0; index < value.length; index += 1) {
+    const character = value[index];
+    if (escaped) {
+      escaped = false;
+      continue;
+    }
+    if (quoted && character === "\\") {
+      escaped = true;
+      continue;
+    }
+    if (character === '"') {
+      quoted = !quoted;
+      continue;
+    }
+    if (!quoted && character === delimiter) {
+      parts.push(value.slice(start, index).trim());
+      start = index + 1;
+    }
+  }
+  parts.push(value.slice(start).trim());
+  return parts.filter(Boolean);
+}
+function decodeParameterValue(value) {
+  if (!value.startsWith('"') || !value.endsWith('"')) return value;
+  return value.slice(1, -1).replace(/\\(["\\])/g, "$1");
+}
+function parseCounters(description) {
+  if (!description) return {};
+  const counters = {};
+  const pattern = /(?:^|\s)([A-Za-z][A-Za-z0-9_.-]*)=(-?\d+(?:\.\d+)?)(?=\s|$)/g;
+  for (const match of description.matchAll(pattern)) {
+    const name = match[1];
+    const rawValue = match[2];
+    if (!name || !rawValue) continue;
+    const value = Number(rawValue);
+    if (Number.isFinite(value)) counters[name] = value;
+  }
+  return counters;
+}
+function humanize(value) {
+  const words = value.replace(/[_-]+/g, " ").trim();
+  return words ? words[0].toUpperCase() + words.slice(1) : value;
+}
+function parseServerTiming(header) {
+  if (!(header == null ? void 0 : header.trim())) return [];
+  return splitOutsideQuotes(header, ",").flatMap((entry) => {
+    const tokens = splitOutsideQuotes(entry, ";");
+    const name = tokens[0];
+    if (!name) return [];
+    let duration = 0;
+    let description;
+    let durationSeen = false;
+    for (const token of tokens.slice(1)) {
+      const separator = token.indexOf("=");
+      if (separator < 0) continue;
+      const key = token.slice(0, separator).trim().toLowerCase();
+      const value = decodeParameterValue(token.slice(separator + 1).trim());
+      if (key === "desc" && description === void 0) description = value;
+      if (key === "dur" && !durationSeen) {
+        durationSeen = true;
+        const parsed = Number(value);
+        if (Number.isFinite(parsed) && parsed >= 0) duration = parsed;
+      }
+    }
+    return [{
+      name,
+      duration,
+      counters: parseCounters(description),
+      ...description !== void 0 ? { description } : {}
+    }];
+  });
+}
+function formatServerTimingDuration(milliseconds) {
+  if (milliseconds >= 1e3) return `${(milliseconds / 1e3).toFixed(1)} s`;
+  if (milliseconds < 10) return `${milliseconds.toFixed(1)} ms`;
+  return `${Math.round(milliseconds)} ms`;
+}
+function serverTimingMetricLabel(metric) {
+  if (metric.description && Object.keys(metric.counters).length === 0) {
+    return metric.description;
+  }
+  return METRIC_LABELS[metric.name] ?? humanize(metric.name);
+}
+function serverTimingCounterSummary(metric) {
+  const counters = Object.entries(metric.counters);
+  if (counters.length === 0) return void 0;
+  return counters.map(([name, value]) => {
+    const labels = COUNTER_LABELS[name];
+    const label = (labels == null ? void 0 : labels[Math.abs(value) === 1 ? 0 : 1]) ?? humanize(name).toLowerCase();
+    return `${value.toLocaleString("en-US")} ${label}`;
+  }).join(" · ");
+}
+exports.formatServerTimingDuration = formatServerTimingDuration;
+exports.parseServerTiming = parseServerTiming;
+exports.serverTimingCounterSummary = serverTimingCounterSummary;
+exports.serverTimingMetricLabel = serverTimingMetricLabel;
+//# sourceMappingURL=server-timing.cjs.map

package/dist/data/server-timing.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-timing.cjs","sources":["../../src/data/server-timing.ts"],"sourcesContent":["export interface ServerTimingMetric {\n  name: string;\n  duration: number;\n  description?: string;\n  counters: Record<string, number>;\n}\n\nconst METRIC_LABELS: Record<string, string> = {\n  total: \"Total\",\n  command: \"Command\",\n  format: \"Format response\",\n  sql: \"SQL\",\n  redis: \"Redis\",\n};\n\nconst COUNTER_LABELS: Record<string, readonly [singular: string, plural: string]> = {\n  queries: [\"query\", \"queries\"],\n  rows_returned: [\"row returned\", \"rows returned\"],\n  rows_scanned: [\"row scanned\", \"rows scanned\"],\n  ops: [\"operation\", \"operations\"],\n  hits: [\"hit\", \"hits\"],\n  misses: [\"miss\", \"misses\"],\n  errors: [\"error\", \"errors\"],\n};\n\nfunction splitOutsideQuotes(value: string, delimiter: \",\" | \";\"): string[] {\n  const parts: string[] = [];\n  let start = 0;\n  let quoted = false;\n  let escaped = false;\n\n  for (let index = 0; index < value.length; index += 1) {\n    const character = value[index];\n    if (escaped) {\n      escaped = false;\n      continue;\n    }\n    if (quoted && character === \"\\\\\") {\n      escaped = true;\n      continue;\n    }\n    if (character === '\"') {\n      quoted = !quoted;\n      continue;\n    }\n    if (!quoted && character === delimiter) {\n      parts.push(value.slice(start, index).trim());\n      start = index + 1;\n    }\n  }\n  parts.push(value.slice(start).trim());\n  return parts.filter(Boolean);\n}\n\nfunction decodeParameterValue(value: string): string {\n  if (!value.startsWith('\"') || !value.endsWith('\"')) return value;\n  return value.slice(1, -1).replace(/\\\\([\"\\\\])/g, \"$1\");\n}\n\nfunction parseCounters(description: string | undefined): Record<string, number> {\n  if (!description) return {};\n  const counters: Record<string, number> = {};\n  const pattern = /(?:^|\\s)([A-Za-z][A-Za-z0-9_.-]*)=(-?\\d+(?:\\.\\d+)?)(?=\\s|$)/g;\n  for (const match of description.matchAll(pattern)) {\n    const name = match[1];\n    const rawValue = match[2];\n    if (!name || !rawValue) continue;\n    const value = Number(rawValue);\n    if (Number.isFinite(value)) counters[name] = value;\n  }\n  return counters;\n}\n\nfunction humanize(value: string): string {\n  const words = value.replace(/[_-]+/g, \" \").trim();\n  return words ? words[0]!.toUpperCase() + words.slice(1) : value;\n}\n\nexport function parseServerTiming(\n  header: string | null | undefined,\n): ServerTimingMetric[] {\n  if (!header?.trim()) return [];\n  return splitOutsideQuotes(header, \",\").flatMap((entry) => {\n    const tokens = splitOutsideQuotes(entry, \";\");\n    const name = tokens[0];\n    if (!name) return [];\n    let duration = 0;\n    let description: string | undefined;\n    let durationSeen = false;\n    for (const token of tokens.slice(1)) {\n      const separator = token.indexOf(\"=\");\n      if (separator < 0) continue;\n      const key = token.slice(0, separator).trim().toLowerCase();\n      const value = decodeParameterValue(token.slice(separator + 1).trim());\n      // Server-Timing keeps the first instance of a duplicated parameter name\n      // within one metric and ignores the rest.\n      if (key === \"desc\" && description === undefined) description = value;\n      if (key === \"dur\" && !durationSeen) {\n        durationSeen = true;\n        const parsed = Number(value);\n        if (Number.isFinite(parsed) && parsed >= 0) duration = parsed;\n      }\n    }\n    return [{\n      name,\n      duration,\n      counters: parseCounters(description),\n      ...(description !== undefined ? { description } : {}),\n    }];\n  });\n}\n\nexport function formatServerTimingDuration(milliseconds: number): string {\n  if (milliseconds >= 1000) return `${(milliseconds / 1000).toFixed(1)} s`;\n  if (milliseconds < 10) return `${milliseconds.toFixed(1)} ms`;\n  return `${Math.round(milliseconds)} ms`;\n}\n\nexport function serverTimingMetricLabel(metric: ServerTimingMetric): string {\n  if (metric.description && Object.keys(metric.counters).length === 0) {\n    return metric.description;\n  }\n  return METRIC_LABELS[metric.name] ?? humanize(metric.name);\n}\n\nexport function serverTimingCounterSummary(metric: ServerTimingMetric): string | undefined {\n  const counters = Object.entries(metric.counters);\n  if (counters.length === 0) return undefined;\n  return counters\n    .map(([name, value]) => {\n      const labels = COUNTER_LABELS[name];\n      const label = labels?.[Math.abs(value) === 1 ? 0 : 1] ?? humanize(name).toLowerCase();\n      return `${value.toLocaleString(\"en-US\")} ${label}`;\n    })\n    .join(\" · \");\n}\n"],"names":[],"mappings":";;AAOA,MAAM,gBAAwC;AAAA,EAC5C,OAAO;AAAA,EACP,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,KAAK;AAAA,EACL,OAAO;AACT;AAEA,MAAM,iBAA8E;AAAA,EAClF,SAAS,CAAC,SAAS,SAAS;AAAA,EAC5B,eAAe,CAAC,gBAAgB,eAAe;AAAA,EAC/C,cAAc,CAAC,eAAe,cAAc;AAAA,EAC5C,KAAK,CAAC,aAAa,YAAY;AAAA,EAC/B,MAAM,CAAC,OAAO,MAAM;AAAA,EACpB,QAAQ,CAAC,QAAQ,QAAQ;AAAA,EACzB,QAAQ,CAAC,SAAS,QAAQ;AAC5B;AAEA,SAAS,mBAAmB,OAAe,WAAgC;AACzE,QAAM,QAAkB,CAAA;AACxB,MAAI,QAAQ;AACZ,MAAI,SAAS;AACb,MAAI,UAAU;AAEd,WAAS,QAAQ,GAAG,QAAQ,MAAM,QAAQ,SAAS,GAAG;AACpD,UAAM,YAAY,MAAM,KAAK;AAC7B,QAAI,SAAS;AACX,gBAAU;AACV;AAAA,IACF;AACA,QAAI,UAAU,cAAc,MAAM;AAChC,gBAAU;AACV;AAAA,IACF;AACA,QAAI,cAAc,KAAK;AACrB,eAAS,CAAC;AACV;AAAA,IACF;AACA,QAAI,CAAC,UAAU,cAAc,WAAW;AACtC,YAAM,KAAK,MAAM,MAAM,OAAO,KAAK,EAAE,MAAM;AAC3C,cAAQ,QAAQ;AAAA,IAClB;AAAA,EACF;AACA,QAAM,KAAK,MAAM,MAAM,KAAK,EAAE,MAAM;AACpC,SAAO,MAAM,OAAO,OAAO;AAC7B;AAEA,SAAS,qBAAqB,OAAuB;AACnD,MAAI,CAAC,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,SAAS,GAAG,EAAG,QAAO;AAC3D,SAAO,MAAM,MAAM,GAAG,EAAE,EAAE,QAAQ,cAAc,IAAI;AACtD;AAEA,SAAS,cAAc,aAAyD;AAC9E,MAAI,CAAC,YAAa,QAAO,CAAA;AACzB,QAAM,WAAmC,CAAA;AACzC,QAAM,UAAU;AAChB,aAAW,SAAS,YAAY,SAAS,OAAO,GAAG;AACjD,UAAM,OAAO,MAAM,CAAC;AACpB,UAAM,WAAW,MAAM,CAAC;AACxB,QAAI,CAAC,QAAQ,CAAC,SAAU;AACxB,UAAM,QAAQ,OAAO,QAAQ;AAC7B,QAAI,OAAO,SAAS,KAAK,EAAG,UAAS,IAAI,IAAI;AAAA,EAC/C;AACA,SAAO;AACT;AAEA,SAAS,SAAS,OAAuB;AACvC,QAAM,QAAQ,MAAM,QAAQ,UAAU,GAAG,EAAE,KAAA;AAC3C,SAAO,QAAQ,MAAM,CAAC,EAAG,gBAAgB,MAAM,MAAM,CAAC,IAAI;AAC5D;AAEO,SAAS,kBACd,QACsB;AACtB,MAAI,EAAC,iCAAQ,gBAAe,CAAA;AAC5B,SAAO,mBAAmB,QAAQ,GAAG,EAAE,QAAQ,CAAC,UAAU;AACxD,UAAM,SAAS,mBAAmB,OAAO,GAAG;AAC5C,UAAM,OAAO,OAAO,CAAC;AACrB,QAAI,CAAC,KAAM,QAAO,CAAA;AAClB,QAAI,WAAW;AACf,QAAI;AACJ,QAAI,eAAe;AACnB,eAAW,SAAS,OAAO,MAAM,CAAC,GAAG;AACnC,YAAM,YAAY,MAAM,QAAQ,GAAG;AACnC,UAAI,YAAY,EAAG;AACnB,YAAM,MAAM,MAAM,MAAM,GAAG,SAAS,EAAE,KAAA,EAAO,YAAA;AAC7C,YAAM,QAAQ,qBAAqB,MAAM,MAAM,YAAY,CAAC,EAAE,MAAM;AAGpE,UAAI,QAAQ,UAAU,gBAAgB,OAAW,eAAc;AAC/D,UAAI,QAAQ,SAAS,CAAC,cAAc;AAClC,uBAAe;AACf,cAAM,SAAS,OAAO,KAAK;AAC3B,YAAI,OAAO,SAAS,MAAM,KAAK,UAAU,EAAG,YAAW;AAAA,MACzD;AAAA,IACF;AACA,WAAO,CAAC;AAAA,MACN;AAAA,MACA;AAAA,MACA,UAAU,cAAc,WAAW;AAAA,MACnC,GAAI,gBAAgB,SAAY,EAAE,gBAAgB,CAAA;AAAA,IAAC,CACpD;AAAA,EACH,CAAC;AACH;AAEO,SAAS,2BAA2B,cAA8B;AACvE,MAAI,gBAAgB,IAAM,QAAO,IAAI,eAAe,KAAM,QAAQ,CAAC,CAAC;AACpE,MAAI,eAAe,GAAI,QAAO,GAAG,aAAa,QAAQ,CAAC,CAAC;AACxD,SAAO,GAAG,KAAK,MAAM,YAAY,CAAC;AACpC;AAEO,SAAS,wBAAwB,QAAoC;AAC1E,MAAI,OAAO,eAAe,OAAO,KAAK,OAAO,QAAQ,EAAE,WAAW,GAAG;AACnE,WAAO,OAAO;AAAA,EAChB;AACA,SAAO,cAAc,OAAO,IAAI,KAAK,SAAS,OAAO,IAAI;AAC3D;AAEO,SAAS,2BAA2B,QAAgD;AACzF,QAAM,WAAW,OAAO,QAAQ,OAAO,QAAQ;AAC/C,MAAI,SAAS,WAAW,EAAG,QAAO;AAClC,SAAO,SACJ,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM;AACtB,UAAM,SAAS,eAAe,IAAI;AAClC,UAAM,SAAQ,iCAAS,KAAK,IAAI,KAAK,MAAM,IAAI,IAAI,OAAM,SAAS,IAAI,EAAE,YAAA;AACxE,WAAO,GAAG,MAAM,eAAe,OAAO,CAAC,IAAI,KAAK;AAAA,EAClD,CAAC,EACA,KAAK,KAAK;AACf;;;;;"}

package/dist/data/server-timing.d.ts

@@ -0,0 +1,11 @@
+export interface ServerTimingMetric {
+    name: string;
+    duration: number;
+    description?: string;
+    counters: Record<string, number>;
+}
+export declare function parseServerTiming(header: string | null | undefined): ServerTimingMetric[];
+export declare function formatServerTimingDuration(milliseconds: number): string;
+export declare function serverTimingMetricLabel(metric: ServerTimingMetric): string;
+export declare function serverTimingCounterSummary(metric: ServerTimingMetric): string | undefined;
+//# sourceMappingURL=server-timing.d.ts.map

package/dist/data/server-timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-timing.d.ts","sourceRoot":"","sources":["../../src/data/server-timing.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAyED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAChC,kBAAkB,EAAE,CA8BtB;AAED,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAIvE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAK1E;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,GAAG,SAAS,CAUzF"}

package/dist/data/server-timing.js

@@ -0,0 +1,120 @@
+const METRIC_LABELS = {
+  total: "Total",
+  command: "Command",
+  format: "Format response",
+  sql: "SQL",
+  redis: "Redis"
+};
+const COUNTER_LABELS = {
+  queries: ["query", "queries"],
+  rows_returned: ["row returned", "rows returned"],
+  rows_scanned: ["row scanned", "rows scanned"],
+  ops: ["operation", "operations"],
+  hits: ["hit", "hits"],
+  misses: ["miss", "misses"],
+  errors: ["error", "errors"]
+};
+function splitOutsideQuotes(value, delimiter) {
+  const parts = [];
+  let start = 0;
+  let quoted = false;
+  let escaped = false;
+  for (let index = 0; index < value.length; index += 1) {
+    const character = value[index];
+    if (escaped) {
+      escaped = false;
+      continue;
+    }
+    if (quoted && character === "\\") {
+      escaped = true;
+      continue;
+    }
+    if (character === '"') {
+      quoted = !quoted;
+      continue;
+    }
+    if (!quoted && character === delimiter) {
+      parts.push(value.slice(start, index).trim());
+      start = index + 1;
+    }
+  }
+  parts.push(value.slice(start).trim());
+  return parts.filter(Boolean);
+}
+function decodeParameterValue(value) {
+  if (!value.startsWith('"') || !value.endsWith('"')) return value;
+  return value.slice(1, -1).replace(/\\(["\\])/g, "$1");
+}
+function parseCounters(description) {
+  if (!description) return {};
+  const counters = {};
+  const pattern = /(?:^|\s)([A-Za-z][A-Za-z0-9_.-]*)=(-?\d+(?:\.\d+)?)(?=\s|$)/g;
+  for (const match of description.matchAll(pattern)) {
+    const name = match[1];
+    const rawValue = match[2];
+    if (!name || !rawValue) continue;
+    const value = Number(rawValue);
+    if (Number.isFinite(value)) counters[name] = value;
+  }
+  return counters;
+}
+function humanize(value) {
+  const words = value.replace(/[_-]+/g, " ").trim();
+  return words ? words[0].toUpperCase() + words.slice(1) : value;
+}
+function parseServerTiming(header) {
+  if (!(header == null ? void 0 : header.trim())) return [];
+  return splitOutsideQuotes(header, ",").flatMap((entry) => {
+    const tokens = splitOutsideQuotes(entry, ";");
+    const name = tokens[0];
+    if (!name) return [];
+    let duration = 0;
+    let description;
+    let durationSeen = false;
+    for (const token of tokens.slice(1)) {
+      const separator = token.indexOf("=");
+      if (separator < 0) continue;
+      const key = token.slice(0, separator).trim().toLowerCase();
+      const value = decodeParameterValue(token.slice(separator + 1).trim());
+      if (key === "desc" && description === void 0) description = value;
+      if (key === "dur" && !durationSeen) {
+        durationSeen = true;
+        const parsed = Number(value);
+        if (Number.isFinite(parsed) && parsed >= 0) duration = parsed;
+      }
+    }
+    return [{
+      name,
+      duration,
+      counters: parseCounters(description),
+      ...description !== void 0 ? { description } : {}
+    }];
+  });
+}
+function formatServerTimingDuration(milliseconds) {
+  if (milliseconds >= 1e3) return `${(milliseconds / 1e3).toFixed(1)} s`;
+  if (milliseconds < 10) return `${milliseconds.toFixed(1)} ms`;
+  return `${Math.round(milliseconds)} ms`;
+}
+function serverTimingMetricLabel(metric) {
+  if (metric.description && Object.keys(metric.counters).length === 0) {
+    return metric.description;
+  }
+  return METRIC_LABELS[metric.name] ?? humanize(metric.name);
+}
+function serverTimingCounterSummary(metric) {
+  const counters = Object.entries(metric.counters);
+  if (counters.length === 0) return void 0;
+  return counters.map(([name, value]) => {
+    const labels = COUNTER_LABELS[name];
+    const label = (labels == null ? void 0 : labels[Math.abs(value) === 1 ? 0 : 1]) ?? humanize(name).toLowerCase();
+    return `${value.toLocaleString("en-US")} ${label}`;
+  }).join(" · ");
+}
+export {
+  formatServerTimingDuration,
+  parseServerTiming,
+  serverTimingCounterSummary,
+  serverTimingMetricLabel
+};
+//# sourceMappingURL=server-timing.js.map

package/dist/data/server-timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-timing.js","sources":["../../src/data/server-timing.ts"],"sourcesContent":["export interface ServerTimingMetric {\n  name: string;\n  duration: number;\n  description?: string;\n  counters: Record<string, number>;\n}\n\nconst METRIC_LABELS: Record<string, string> = {\n  total: \"Total\",\n  command: \"Command\",\n  format: \"Format response\",\n  sql: \"SQL\",\n  redis: \"Redis\",\n};\n\nconst COUNTER_LABELS: Record<string, readonly [singular: string, plural: string]> = {\n  queries: [\"query\", \"queries\"],\n  rows_returned: [\"row returned\", \"rows returned\"],\n  rows_scanned: [\"row scanned\", \"rows scanned\"],\n  ops: [\"operation\", \"operations\"],\n  hits: [\"hit\", \"hits\"],\n  misses: [\"miss\", \"misses\"],\n  errors: [\"error\", \"errors\"],\n};\n\nfunction splitOutsideQuotes(value: string, delimiter: \",\" | \";\"): string[] {\n  const parts: string[] = [];\n  let start = 0;\n  let quoted = false;\n  let escaped = false;\n\n  for (let index = 0; index < value.length; index += 1) {\n    const character = value[index];\n    if (escaped) {\n      escaped = false;\n      continue;\n    }\n    if (quoted && character === \"\\\\\") {\n      escaped = true;\n      continue;\n    }\n    if (character === '\"') {\n      quoted = !quoted;\n      continue;\n    }\n    if (!quoted && character === delimiter) {\n      parts.push(value.slice(start, index).trim());\n      start = index + 1;\n    }\n  }\n  parts.push(value.slice(start).trim());\n  return parts.filter(Boolean);\n}\n\nfunction decodeParameterValue(value: string): string {\n  if (!value.startsWith('\"') || !value.endsWith('\"')) return value;\n  return value.slice(1, -1).replace(/\\\\([\"\\\\])/g, \"$1\");\n}\n\nfunction parseCounters(description: string | undefined): Record<string, number> {\n  if (!description) return {};\n  const counters: Record<string, number> = {};\n  const pattern = /(?:^|\\s)([A-Za-z][A-Za-z0-9_.-]*)=(-?\\d+(?:\\.\\d+)?)(?=\\s|$)/g;\n  for (const match of description.matchAll(pattern)) {\n    const name = match[1];\n    const rawValue = match[2];\n    if (!name || !rawValue) continue;\n    const value = Number(rawValue);\n    if (Number.isFinite(value)) counters[name] = value;\n  }\n  return counters;\n}\n\nfunction humanize(value: string): string {\n  const words = value.replace(/[_-]+/g, \" \").trim();\n  return words ? words[0]!.toUpperCase() + words.slice(1) : value;\n}\n\nexport function parseServerTiming(\n  header: string | null | undefined,\n): ServerTimingMetric[] {\n  if (!header?.trim()) return [];\n  return splitOutsideQuotes(header, \",\").flatMap((entry) => {\n    const tokens = splitOutsideQuotes(entry, \";\");\n    const name = tokens[0];\n    if (!name) return [];\n    let duration = 0;\n    let description: string | undefined;\n    let durationSeen = false;\n    for (const token of tokens.slice(1)) {\n      const separator = token.indexOf(\"=\");\n      if (separator < 0) continue;\n      const key = token.slice(0, separator).trim().toLowerCase();\n      const value = decodeParameterValue(token.slice(separator + 1).trim());\n      // Server-Timing keeps the first instance of a duplicated parameter name\n      // within one metric and ignores the rest.\n      if (key === \"desc\" && description === undefined) description = value;\n      if (key === \"dur\" && !durationSeen) {\n        durationSeen = true;\n        const parsed = Number(value);\n        if (Number.isFinite(parsed) && parsed >= 0) duration = parsed;\n      }\n    }\n    return [{\n      name,\n      duration,\n      counters: parseCounters(description),\n      ...(description !== undefined ? { description } : {}),\n    }];\n  });\n}\n\nexport function formatServerTimingDuration(milliseconds: number): string {\n  if (milliseconds >= 1000) return `${(milliseconds / 1000).toFixed(1)} s`;\n  if (milliseconds < 10) return `${milliseconds.toFixed(1)} ms`;\n  return `${Math.round(milliseconds)} ms`;\n}\n\nexport function serverTimingMetricLabel(metric: ServerTimingMetric): string {\n  if (metric.description && Object.keys(metric.counters).length === 0) {\n    return metric.description;\n  }\n  return METRIC_LABELS[metric.name] ?? humanize(metric.name);\n}\n\nexport function serverTimingCounterSummary(metric: ServerTimingMetric): string | undefined {\n  const counters = Object.entries(metric.counters);\n  if (counters.length === 0) return undefined;\n  return counters\n    .map(([name, value]) => {\n      const labels = COUNTER_LABELS[name];\n      const label = labels?.[Math.abs(value) === 1 ? 0 : 1] ?? humanize(name).toLowerCase();\n      return `${value.toLocaleString(\"en-US\")} ${label}`;\n    })\n    .join(\" · \");\n}\n"],"names":[],"mappings":"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"}

package/dist/data/task-process-details.cjs

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function isTaskProcessDetails(value) {
+  if (!value || typeof value !== "object") return false;
+  const candidate = value;
+  return typeof candidate.command === "string" && typeof candidate.status === "string" && typeof candidate.restarts === "number" && !!candidate.latest && !!candidate.peak && !!candidate.metrics;
+}
+function processNode(sample) {
+  return {
+    pid: sample.pid,
+    ppid: sample.ppid,
+    command: sample.command,
+    ...sample.status ? { status: sample.status } : {},
+    cpu_percent: sample.cpuPercent,
+    rss: sample.rssBytes,
+    vms: sample.vmsBytes,
+    open_files: sample.openFiles,
+    is_root: sample.isRoot ?? false,
+    children: []
+  };
+}
+function buildTaskProcessForest(samples) {
+  const byPid = /* @__PURE__ */ new Map();
+  const children = /* @__PURE__ */ new Map();
+  for (const sample of samples) {
+    if (byPid.has(sample.pid)) throw new Error(`duplicate process pid ${sample.pid}`);
+    byPid.set(sample.pid, sample);
+    children.set(sample.ppid, [...children.get(sample.ppid) ?? [], sample]);
+  }
+  const visited = /* @__PURE__ */ new Set();
+  const visit = (sample) => {
+    if (visited.has(sample.pid)) return null;
+    visited.add(sample.pid);
+    const node = processNode(sample);
+    node.children = (children.get(sample.pid) ?? []).map(visit).filter((child) => child !== null);
+    return node;
+  };
+  const roots = samples.filter((sample) => sample.isRoot || !byPid.has(sample.ppid));
+  const forest = roots.map(visit).filter((node) => node !== null);
+  for (const sample of samples) {
+    const orphan = visit(sample);
+    if (orphan) forest.push(orphan);
+  }
+  return forest;
+}
+exports.buildTaskProcessForest = buildTaskProcessForest;
+exports.isTaskProcessDetails = isTaskProcessDetails;
+//# sourceMappingURL=task-process-details.cjs.map

package/dist/data/task-process-details.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-process-details.cjs","sources":["../../src/data/task-process-details.ts"],"sourcesContent":["import type { ProcessNode } from \"./diagnostics/types\";\nimport type { TaskProcessDetails, TaskProcessSample } from \"./TaskSnapshot\";\n\nexport function isTaskProcessDetails(value: unknown): value is TaskProcessDetails {\n  if (!value || typeof value !== \"object\") return false;\n  const candidate = value as Partial<TaskProcessDetails>;\n  return (\n    typeof candidate.command === \"string\" &&\n    typeof candidate.status === \"string\" &&\n    typeof candidate.restarts === \"number\" &&\n    !!candidate.latest &&\n    !!candidate.peak &&\n    !!candidate.metrics\n  );\n}\n\nfunction processNode(sample: TaskProcessSample): ProcessNode {\n  return {\n    pid: sample.pid,\n    ppid: sample.ppid,\n    command: sample.command,\n    ...(sample.status ? { status: sample.status } : {}),\n    cpu_percent: sample.cpuPercent,\n    rss: sample.rssBytes,\n    vms: sample.vmsBytes,\n    open_files: sample.openFiles,\n    is_root: sample.isRoot ?? false,\n    children: [],\n  };\n}\n\n// buildTaskProcessForest deterministically projects Clicky's flat PID/PPID\n// samples into diagnostics trees. Missing parents remain roots and cycles are\n// cut at the first previously-visited PID so malformed OS snapshots stay usable.\nexport function buildTaskProcessForest(samples: TaskProcessSample[]): ProcessNode[] {\n  const byPid = new Map<number, TaskProcessSample>();\n  const children = new Map<number, TaskProcessSample[]>();\n  for (const sample of samples) {\n    if (byPid.has(sample.pid)) throw new Error(`duplicate process pid ${sample.pid}`);\n    byPid.set(sample.pid, sample);\n    children.set(sample.ppid, [...(children.get(sample.ppid) ?? []), sample]);\n  }\n\n  const visited = new Set<number>();\n  const visit = (sample: TaskProcessSample): ProcessNode | null => {\n    if (visited.has(sample.pid)) return null;\n    visited.add(sample.pid);\n    const node = processNode(sample);\n    node.children = (children.get(sample.pid) ?? [])\n      .map(visit)\n      .filter((child): child is ProcessNode => child !== null);\n    return node;\n  };\n\n  const roots = samples.filter((sample) => sample.isRoot || !byPid.has(sample.ppid));\n  const forest = roots.map(visit).filter((node): node is ProcessNode => node !== null);\n  for (const sample of samples) {\n    const orphan = visit(sample);\n    if (orphan) forest.push(orphan);\n  }\n  return forest;\n}\n"],"names":[],"mappings":";;AAGO,SAAS,qBAAqB,OAA6C;AAChF,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,YAAY;AAClB,SACE,OAAO,UAAU,YAAY,YAC7B,OAAO,UAAU,WAAW,YAC5B,OAAO,UAAU,aAAa,YAC9B,CAAC,CAAC,UAAU,UACZ,CAAC,CAAC,UAAU,QACZ,CAAC,CAAC,UAAU;AAEhB;AAEA,SAAS,YAAY,QAAwC;AAC3D,SAAO;AAAA,IACL,KAAK,OAAO;AAAA,IACZ,MAAM,OAAO;AAAA,IACb,SAAS,OAAO;AAAA,IAChB,GAAI,OAAO,SAAS,EAAE,QAAQ,OAAO,OAAA,IAAW,CAAA;AAAA,IAChD,aAAa,OAAO;AAAA,IACpB,KAAK,OAAO;AAAA,IACZ,KAAK,OAAO;AAAA,IACZ,YAAY,OAAO;AAAA,IACnB,SAAS,OAAO,UAAU;AAAA,IAC1B,UAAU,CAAA;AAAA,EAAC;AAEf;AAKO,SAAS,uBAAuB,SAA6C;AAClF,QAAM,4BAAY,IAAA;AAClB,QAAM,+BAAe,IAAA;AACrB,aAAW,UAAU,SAAS;AAC5B,QAAI,MAAM,IAAI,OAAO,GAAG,EAAG,OAAM,IAAI,MAAM,yBAAyB,OAAO,GAAG,EAAE;AAChF,UAAM,IAAI,OAAO,KAAK,MAAM;AAC5B,aAAS,IAAI,OAAO,MAAM,CAAC,GAAI,SAAS,IAAI,OAAO,IAAI,KAAK,CAAA,GAAK,MAAM,CAAC;AAAA,EAC1E;AAEA,QAAM,8BAAc,IAAA;AACpB,QAAM,QAAQ,CAAC,WAAkD;AAC/D,QAAI,QAAQ,IAAI,OAAO,GAAG,EAAG,QAAO;AACpC,YAAQ,IAAI,OAAO,GAAG;AACtB,UAAM,OAAO,YAAY,MAAM;AAC/B,SAAK,YAAY,SAAS,IAAI,OAAO,GAAG,KAAK,CAAA,GAC1C,IAAI,KAAK,EACT,OAAO,CAAC,UAAgC,UAAU,IAAI;AACzD,WAAO;AAAA,EACT;AAEA,QAAM,QAAQ,QAAQ,OAAO,CAAC,WAAW,OAAO,UAAU,CAAC,MAAM,IAAI,OAAO,IAAI,CAAC;AACjF,QAAM,SAAS,MAAM,IAAI,KAAK,EAAE,OAAO,CAAC,SAA8B,SAAS,IAAI;AACnF,aAAW,UAAU,SAAS;AAC5B,UAAM,SAAS,MAAM,MAAM;AAC3B,QAAI,OAAQ,QAAO,KAAK,MAAM;AAAA,EAChC;AACA,SAAO;AACT;;;"}

package/dist/data/task-process-details.d.ts

@@ -0,0 +1,5 @@
+import { ProcessNode } from './diagnostics/types';
+import { TaskProcessDetails, TaskProcessSample } from './TaskSnapshot';
+export declare function isTaskProcessDetails(value: unknown): value is TaskProcessDetails;
+export declare function buildTaskProcessForest(samples: TaskProcessSample[]): ProcessNode[];
+//# sourceMappingURL=task-process-details.d.ts.map

package/dist/data/task-process-details.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-process-details.d.ts","sourceRoot":"","sources":["../../src/data/task-process-details.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAE5E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAWhF;AAoBD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,WAAW,EAAE,CA2BlF"}

package/dist/data/task-process-details.js

@@ -0,0 +1,48 @@
+function isTaskProcessDetails(value) {
+  if (!value || typeof value !== "object") return false;
+  const candidate = value;
+  return typeof candidate.command === "string" && typeof candidate.status === "string" && typeof candidate.restarts === "number" && !!candidate.latest && !!candidate.peak && !!candidate.metrics;
+}
+function processNode(sample) {
+  return {
+    pid: sample.pid,
+    ppid: sample.ppid,
+    command: sample.command,
+    ...sample.status ? { status: sample.status } : {},
+    cpu_percent: sample.cpuPercent,
+    rss: sample.rssBytes,
+    vms: sample.vmsBytes,
+    open_files: sample.openFiles,
+    is_root: sample.isRoot ?? false,
+    children: []
+  };
+}
+function buildTaskProcessForest(samples) {
+  const byPid = /* @__PURE__ */ new Map();
+  const children = /* @__PURE__ */ new Map();
+  for (const sample of samples) {
+    if (byPid.has(sample.pid)) throw new Error(`duplicate process pid ${sample.pid}`);
+    byPid.set(sample.pid, sample);
+    children.set(sample.ppid, [...children.get(sample.ppid) ?? [], sample]);
+  }
+  const visited = /* @__PURE__ */ new Set();
+  const visit = (sample) => {
+    if (visited.has(sample.pid)) return null;
+    visited.add(sample.pid);
+    const node = processNode(sample);
+    node.children = (children.get(sample.pid) ?? []).map(visit).filter((child) => child !== null);
+    return node;
+  };
+  const roots = samples.filter((sample) => sample.isRoot || !byPid.has(sample.ppid));
+  const forest = roots.map(visit).filter((node) => node !== null);
+  for (const sample of samples) {
+    const orphan = visit(sample);
+    if (orphan) forest.push(orphan);
+  }
+  return forest;
+}
+export {
+  buildTaskProcessForest,
+  isTaskProcessDetails
+};
+//# sourceMappingURL=task-process-details.js.map

package/dist/data/task-process-details.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-process-details.js","sources":["../../src/data/task-process-details.ts"],"sourcesContent":["import type { ProcessNode } from \"./diagnostics/types\";\nimport type { TaskProcessDetails, TaskProcessSample } from \"./TaskSnapshot\";\n\nexport function isTaskProcessDetails(value: unknown): value is TaskProcessDetails {\n  if (!value || typeof value !== \"object\") return false;\n  const candidate = value as Partial<TaskProcessDetails>;\n  return (\n    typeof candidate.command === \"string\" &&\n    typeof candidate.status === \"string\" &&\n    typeof candidate.restarts === \"number\" &&\n    !!candidate.latest &&\n    !!candidate.peak &&\n    !!candidate.metrics\n  );\n}\n\nfunction processNode(sample: TaskProcessSample): ProcessNode {\n  return {\n    pid: sample.pid,\n    ppid: sample.ppid,\n    command: sample.command,\n    ...(sample.status ? { status: sample.status } : {}),\n    cpu_percent: sample.cpuPercent,\n    rss: sample.rssBytes,\n    vms: sample.vmsBytes,\n    open_files: sample.openFiles,\n    is_root: sample.isRoot ?? false,\n    children: [],\n  };\n}\n\n// buildTaskProcessForest deterministically projects Clicky's flat PID/PPID\n// samples into diagnostics trees. Missing parents remain roots and cycles are\n// cut at the first previously-visited PID so malformed OS snapshots stay usable.\nexport function buildTaskProcessForest(samples: TaskProcessSample[]): ProcessNode[] {\n  const byPid = new Map<number, TaskProcessSample>();\n  const children = new Map<number, TaskProcessSample[]>();\n  for (const sample of samples) {\n    if (byPid.has(sample.pid)) throw new Error(`duplicate process pid ${sample.pid}`);\n    byPid.set(sample.pid, sample);\n    children.set(sample.ppid, [...(children.get(sample.ppid) ?? []), sample]);\n  }\n\n  const visited = new Set<number>();\n  const visit = (sample: TaskProcessSample): ProcessNode | null => {\n    if (visited.has(sample.pid)) return null;\n    visited.add(sample.pid);\n    const node = processNode(sample);\n    node.children = (children.get(sample.pid) ?? [])\n      .map(visit)\n      .filter((child): child is ProcessNode => child !== null);\n    return node;\n  };\n\n  const roots = samples.filter((sample) => sample.isRoot || !byPid.has(sample.ppid));\n  const forest = roots.map(visit).filter((node): node is ProcessNode => node !== null);\n  for (const sample of samples) {\n    const orphan = visit(sample);\n    if (orphan) forest.push(orphan);\n  }\n  return forest;\n}\n"],"names":[],"mappings":"AAGO,SAAS,qBAAqB,OAA6C;AAChF,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,YAAY;AAClB,SACE,OAAO,UAAU,YAAY,YAC7B,OAAO,UAAU,WAAW,YAC5B,OAAO,UAAU,aAAa,YAC9B,CAAC,CAAC,UAAU,UACZ,CAAC,CAAC,UAAU,QACZ,CAAC,CAAC,UAAU;AAEhB;AAEA,SAAS,YAAY,QAAwC;AAC3D,SAAO;AAAA,IACL,KAAK,OAAO;AAAA,IACZ,MAAM,OAAO;AAAA,IACb,SAAS,OAAO;AAAA,IAChB,GAAI,OAAO,SAAS,EAAE,QAAQ,OAAO,OAAA,IAAW,CAAA;AAAA,IAChD,aAAa,OAAO;AAAA,IACpB,KAAK,OAAO;AAAA,IACZ,KAAK,OAAO;AAAA,IACZ,YAAY,OAAO;AAAA,IACnB,SAAS,OAAO,UAAU;AAAA,IAC1B,UAAU,CAAA;AAAA,EAAC;AAEf;AAKO,SAAS,uBAAuB,SAA6C;AAClF,QAAM,4BAAY,IAAA;AAClB,QAAM,+BAAe,IAAA;AACrB,aAAW,UAAU,SAAS;AAC5B,QAAI,MAAM,IAAI,OAAO,GAAG,EAAG,OAAM,IAAI,MAAM,yBAAyB,OAAO,GAAG,EAAE;AAChF,UAAM,IAAI,OAAO,KAAK,MAAM;AAC5B,aAAS,IAAI,OAAO,MAAM,CAAC,GAAI,SAAS,IAAI,OAAO,IAAI,KAAK,CAAA,GAAK,MAAM,CAAC;AAAA,EAC1E;AAEA,QAAM,8BAAc,IAAA;AACpB,QAAM,QAAQ,CAAC,WAAkD;AAC/D,QAAI,QAAQ,IAAI,OAAO,GAAG,EAAG,QAAO;AACpC,YAAQ,IAAI,OAAO,GAAG;AACtB,UAAM,OAAO,YAAY,MAAM;AAC/B,SAAK,YAAY,SAAS,IAAI,OAAO,GAAG,KAAK,CAAA,GAC1C,IAAI,KAAK,EACT,OAAO,CAAC,UAAgC,UAAU,IAAI;AACzD,WAAO;AAAA,EACT;AAEA,QAAM,QAAQ,QAAQ,OAAO,CAAC,WAAW,OAAO,UAAU,CAAC,MAAM,IAAI,OAAO,IAAI,CAAC;AACjF,QAAM,SAAS,MAAM,IAAI,KAAK,EAAE,OAAO,CAAC,SAA8B,SAAS,IAAI;AACnF,aAAW,UAAU,SAAS;AAC5B,UAAM,SAAS,MAAM,MAAM;AAC3B,QAAI,OAAQ,QAAO,KAAK,MAAM;AAAA,EAChC;AACA,SAAO;AACT;"}

package/dist/data/version-info.cjs

@@ -15,9 +15,9 @@ function detectMode() {
 }
 function getVersionInfo() {
   return {
-    commit: read(() => "df3338f6", ""),
-    tag: read(() => "clicky-ui@0.3.14", ""),
-    date: read(() => "2026-07-22T13:34:38.142Z", ""),
+    commit: read(() => "98f0a684", ""),
+    tag: read(() => "clicky-ui@0.3.16", ""),
+    date: read(() => "2026-07-31T11:11:36.897Z", ""),
     dirty: read(() => true, false),
     mode: detectMode()
   };

package/dist/data/version-info.js

@@ -13,9 +13,9 @@ function detectMode() {
 }
 function getVersionInfo() {
   return {
-    commit: read(() => "df3338f6", ""),
-    tag: read(() => "clicky-ui@0.3.14", ""),
-    date: read(() => "2026-07-22T13:34:19.117Z", ""),
+    commit: read(() => "98f0a684", ""),
+    tag: read(() => "clicky-ui@0.3.16", ""),
+    date: read(() => "2026-07-31T11:11:17.917Z", ""),
     dirty: read(() => true, false),
     mode: detectMode()
   };