@aiquants/markdown 2.0.3 → 4.0.0

package/README.md

@@ -6,7 +6,7 @@ Advanced Markdown renderer for React with support for various extensions and cus
 
 - **Rich Markdown Support**: Full support for CommonMark, GitHub Flavored Markdown (GFM), and LaTeX Math expressions.
 - **Offloaded Parser**: CPU-heavy Markdown parsing and AST transformation are offloaded to a high-performance Go API server running `goldmark` and `ConnectRPC`.
-- **Custom Extensions & Plugins**: Pluggable support for subscript, superscript, mark highlights, table cell merges, embeds (YouTube, Twitter), and Zenn-style directives.
+- **Custom Extensions & Plugins**: GitHub alerts, Zenn-style directives (`:::message` / `:::details`), single-line display math, and pluggable subscript, superscript, mark highlights, table cell merges and embeds (YouTube, Twitter).
 - **Dynamic Configuration**: Easily enable or disable custom extensions dynamically using parse options.
 - **Syntax Highlighting**: Code blocks with Shiki syntax highlighting.
 - **TypeScript**: Full TypeScript support with comprehensive type definitions.
@@ -59,6 +59,11 @@ export MARKDOWN_API_BINARY=/path/to/markdown-api
 | `MARKDOWN_SOCKET_PATH` | `/tmp/markdown.sock` | サービスと通信する UNIX ドメインソケットのパス |
 | `MARKDOWN_API_BINARY` | (なし) | 自前ビルドしたバイナリの明示指定 |
 | `MARKDOWN_API_STARTUP_TIMEOUT_MS` | `10000` | 自動起動したサービスが待ち受け開始するまでの猶予 |
+| `MARKDOWN_MAX_SOURCE_BYTES` | `8388608` (8 MiB) | サービスが受け付ける Markdown の本文の最大 (`@import` で取り込んだ分を含む) |
+| `MARKDOWN_MAX_HTML_BYTES` | `33554432` (32 MiB) | サービスが作る HTML の最大 (呼び出しの `maxHtmlBytes` はこれを下げることだけができる) |
+| `MARKDOWN_CONVERT_TIMEOUT` | `30s` | 変換 1 回の最長の時間 (Go の時間の書式。呼び出しの `timeoutMs` はこれを短くすることだけができる) |
+
+後の 3 つはサービス (`markdown-api`) が読む。自動起動したサービスは呼び出し元のプロセスの環境を受け継ぐ。正の数 (時間は正の時間) 以外の値ではサービスが起動しない。
 
 ## Usage
 
@@ -83,7 +88,12 @@ console.log("Hello, World!")
   const parseResult = await parseMarkdown(
     markdownText,
     "/srv/docs/notes/my-file.md",
-    "/srv/docs"
+    "/srv/docs",
+    undefined, // the reader's OAuth token for cloud documents
+    {
+      deniedPathSegments: [".env*", "secrets", "*.pem"], // the host's deny rules ([] denies nothing)
+      maxHtmlBytes: 4 * 1024 * 1024
+    }
   )
 
   // parseResult: ParseResult
@@ -99,36 +109,257 @@ console.log("Hello, World!")
 }
 ```
 
-### Pluggable Parser Options
+`htmlContent` can go to `MarkdownRenderer` as `parseMarkdown` returns it: the converter renders raw HTML as written, and the renderer passes every element through its own allow list (see [Raw HTML](#raw-html)), under server rendering and in the browser alike. A host may sanitize the HTML before as well.
+
+### Parse Options
 
-You can dynamically enable or disable custom extensions using `ParseOptions` (exported from `@aiquants/markdown/server`):
+The fifth argument of `parseMarkdown` is `ParseOptions` (exported from `@aiquants/markdown/server`). `deniedPathSegments` and `maxHtmlBytes` are required.
 
 ```tsx
+const controller = new AbortController()
 const parseResult = await parseMarkdown(
   markdownText,
   "/srv/docs/notes/my-file.md",
   "/srv/docs",
   undefined, // OAuth Token if needed
   {
-    validateExistence: true,
-    enableSubscript: false,      // Disable subscript (leaves ~2~ as plain text)
-    enableSuperscript: true,     // Enable superscript
-    enableMark: false,           // Disable highlight mark
-    enableTableMerge: true,      // Enable table merges (> and ^)
-    enableEmbeds: true,          // Enable YouTube / Twitter embeds
-    enableZennDirectives: true   // Enable :::message / :::details
+    deniedPathSegments: hostDenyRules, // required; [] denies nothing
+    maxHtmlBytes: 4 * 1024 * 1024,     // required; the largest HTML in bytes
+    resolveImports: false,             // expand <!-- @import "path" --> (default false)
+    validateExistence: true,           // mark missing local images and doc links (default true)
+    signal: controller.signal,         // cancels the conversion in the service too
+    timeoutMs: 10_000,                 // the conversion's deadline
+    enableSubscript: false,            // Disable subscript (leaves ~2~ as plain text)
+    enableSuperscript: true,           // Enable superscript
+    enableMark: false,                 // Disable highlight mark
+    enableTableMerge: true,            // Enable table merges (> and ^)
+    enableEmbeds: true,                // Enable YouTube / Twitter embeds
+    enableZennDirectives: true         // Enable :::message / :::details
   }
 )
 ```
 
+| Option | Required | Meaning |
+| --- | --- | --- |
+| `deniedPathSegments` | ✅ | Deny rules applied to every target the conversion resolves: `@import` targets, images and links. A pattern matches one whole path segment (`*` matches any run of characters within it), compared after NFKC normalization and case folding at every percent-decoding level (the semantics of `@aiquants/markdown-explorer`'s deny rules). Local targets must also stay inside `workspaceRoot`, also once symbolic links are resolved. A refused image renders without `src`, a refused link without a destination (with `validateExistence`, both are marked like a missing target, whether or not the target exists), and a refused import rejects the call. |
+| `maxHtmlBytes` | ✅ | The largest HTML in bytes, a positive integer up to `MAX_HTML_BYTES_LIMIT`. The service stops while it renders and the call rejects with `MarkdownResourceExhaustedError`; the response the call accepts is bounded by twice this plus 64 KiB. |
+| `resolveImports` | | Expand `<!-- @import "path" -->` directives (default `false`: a directive stays an HTML comment and nothing is read). Only Markdown (`.md`) targets the deny rules admit are read, nested imports included; a refused target rejects the call with `permission_denied`. |
+| `validateExistence` | | Mark missing local images (`data-asset-exists="false"`, `data-asset-src`) and doc links (`data-doc-exists`) (default `true`). |
+| `signal` | | Cancels the call; the service stops converting. |
+| `timeoutMs` | | The conversion's deadline in milliseconds (a positive integer); the service stops at it or at `MARKDOWN_CONVERT_TIMEOUT`, whichever comes first. |
+| `enable*` | | Switch the syntax extensions and HTML plugins (each enabled unless `false`). The text plugins leave `summary` text (a `:::details` title included) as written. |
+
+Invalid options throw `TypeError` / `RangeError` before any request. A conversion stopped at a size limit (the HTML limit, the service's source limit or a message limit) rejects with `MarkdownResourceExhaustedError` (its `cause` is the connect error); every other failure rejects with the `ConnectError` of the service (`invalid_argument`, `permission_denied`, `canceled`, `deadline_exceeded`, `internal`).
+
+### Local image URLs
+
+An image destination is a URL decoded once: `![](a%2541.png)` names the file `a%41.png`, while `![](a%41.png)` names `aA.png` (a `%` not followed by two hexadecimal digits, as in `100%.png`, may be written as it is).
+A local image's `src` is `/assets/` followed by its path from `workspaceRoot`, written as `@aiquants/markdown-explorer`'s README asks of an asset URL ("Serving images and media"): each path segment percent-encoded after every `%` is written as `%25`, and a final `.data` written as `%2Edata` (`資料/進捗100%.png` becomes `/assets/%E8%B3%87%E6%96%99/%E9%80%B2%E6%8D%97100%2525.png`, `x.data` becomes `/assets/x%2Edata`).
+Serve `/assets/*` from a route that decodes the path once and then turns only `%25` back into `%` (in a React Router splat route, replace `%25` with `%` in the splat React Router has decoded); every file name then arrives unchanged.
+
+## Viewer, embeds and links
+
+### Stylesheets
+
+| Import | Content |
+| --- | --- |
+| `@aiquants/markdown/styles/markdown.css` | The components' own styles (Tailwind build) |
+| `@aiquants/markdown/styles/github-markdown.css` | GitHub document style (`markdown-body`) |
+| `@aiquants/markdown/styles/zenn-content.css` | Zenn document style (`znc`) |
+| `@aiquants/markdown/styles/katex.min.css` | KaTeX's own stylesheet, shipped with the fonts it references (`fonts/` next to it) at the version of the bundled `katex` |
+| `@aiquants/markdown/styles/details.css` / `message.css` | `<details>` and message blocks |
+
+The document stylesheets size their text in `rem`, so the document follows text-only zoom (the browser's default font size, the root `font-size`) together with the viewer's controls; at the default 16 px root they look exactly as GitHub's and Zenn's own stylesheets.
+
+### Raw HTML
+
+Every renderer of the package — `MarkdownRenderer` (and so `MarkdownViewer`) for the converter's HTML, and `NodesRenderer`'s raw HTML nodes and HTML containers for an mdast tree — renders raw HTML through one allow list. It runs on the tree html-react-parser builds, right where the tree is rendered, so it needs no DOM and holds the same under server rendering and in the browser; nothing is serialized and parsed again.
+
+- **Removed with their content**: `script`, `style`, `template`, `noscript`, `noembed`, `noframes`, `plaintext`, `xmp`, `title`, `head`, `meta`, `link`, `base`, `object`, `embed`, `applet`, `param`, `frame`, `frameset`, `select`, `datalist`, `track`, `math`, `foreignObject`, every iframe that is not an allowed embed (see [Embeds](#embeds)), and every `input` except a disabled checkbox (a task-list item).
+- **Kept**: the elements Markdown produces and common text and structure elements (`a`, `img`, `p`, `div`, `span`, headings, lists, tables, `blockquote`, `pre`, `code`, `details`, `summary`, `aside`, `section`, `figure`, `sup`, `sub`, `mark`, `video`, `audio`, `source` …) and, for icons, an `svg` with `g` and `path` inside it (anything else inside an `svg` is removed).
+- **Unwrapped** (the element is dropped, its children render): every other element — `form`, `button`, `textarea`, `label`, `font`, `center`, custom elements and the like — so its text survives.
+- **Attributes**: `title`, `lang`, `dir`, `role`, `hidden`, `translate`, `aria-*`, a reduced `class`, `id` and `style`, and each element's own (`href`, `src`, `alt`, `width`, `height`, `colspan`, `rowspan`, `align`, `open`, `start` …; a link keeps `name`, the fragment target of older documents).
+  The `data-*` attributes the renderers read survive on their element only: `data-link-kind`, `data-doc-path`, `data-doc-exists`, `data-footnote-ref` and `data-footnote-backref` on links, `data-asset-src` and `data-asset-exists` on images, `data-footnotes` on sections, and the embed placeholders' `data-plugin-type`, `data-video-id`, `data-tweet-id` and `data-url` on `div`. Event handlers, `target`, `rel`, `name` (except on links), `srcset`, `usemap`, `ping`, `formaction`, `xlink:href`, `tabindex` and every other attribute are dropped.
+- **Attribute names** are read as an HTML parser stores them: in lower case, and of names that differ only in case the first one written. Kept attributes carry lower-case names, so `<p STYLE="text-align:center">` or `<a HREF="https://…">` renders the same on the server (where html-react-parser keeps the author's case) and in the browser, and hydrates without a mismatch.
+- **`class`** keeps only the package's own tokens: the converter's markup (`markdown-alert`, `markdown-alert-{note,tip,important,warning,caution}`, `markdown-alert-title`, `octicon`, `octicon-{info,light-bulb,report,alert,stop}`, `mr-2`, `message`, `alert`, `info`, `warning`, `message-symbol`, `message-content`, `markdown-details`, `markdown-details-content`, `footnotes`, `footnote-ref`, `footnote-backref`, `math`, `inline`, `display`) and a code block's language (`language-*`).
+  An author's tokens and utility classes (`fixed inset-0 z-50` …) are dropped, so a document can neither restyle the page nor lay an element over it; a link's `className` (also the one `linkComponent` receives) holds only the kept tokens and the package's link classes. Tables carry their alignment in `align` and `style`, not in classes.
+- **`id`** survives only on a heading (the table of contents, in-document links and a host's fragment navigation name headings by it), on the converter's footnotes (`fnref:N` / `fnrefK:N` on a reference's `sup`, `fn:N` on a note's `li`) and in the user-content namespace (`user-content-…`, the prefix GitHub-style footnotes use; write raw HTML fragment targets with it, or as `<a name="…">`).
+  Every other element loses its id, so a document cannot take a name the page or a script looks up (`getElementById`, the named properties of `window`). A heading keeps whatever id the document gives it: a host should not look up its own elements by an id a document could also give a heading (prefer refs), and the package's own lookups check what they find (see [Embeds](#embeds)).
+- **Host sanitizers**: a host that sanitizes the HTML before the renderer (as `@aiquants/markdown-explorer` does with DOMPurify) gets the intersection of both allow lists; DOMPurify keeps `class` and `id` by default, so on the page the rules above are the ones that apply.
+- **URLs** (`href`, `src`, `cite`, `poster`, `data-url`): `http:`, `https:`, `mailto:` and `tel:` in any letter case, and references without a scheme. `javascript:`, `data:` and every other scheme are dropped, however they are spelled (entities, spaces, tabs, control characters). The mdast `LinkNode` and `ImageNode`, the block link card `RichLinkCard` (its `href`, and the `url` and `image` of the site metadata it shows) and the table of contents' entries follow the same rule.
+- **`style`** keeps only its last valid `text-align` declaration (the alignment of table cells); positioning, `url()` and every other declaration are dropped. An SVG `fill` that references anything (`url(…)`) is dropped.
+
+### Embeds
+
+- `iFrameAllowedDomains` lists the hostnames an iframe may load from: the `src` must be `https:`, without a user name, a password or an explicit port, and its hostname must match an entry exactly. Every other iframe is removed (fail closed), including an iframe without `src` (`srcdoc`). An allowed iframe is rendered from validated values and keeps only `title`, `width`, `height`, `allow`, `allowfullscreen`, `sandbox`, `referrerpolicy`, `loading`, `frameborder` and `scrolling` (no `id` or `class`: the package's markup gives an iframe neither).
+  `allow` keeps each feature's name without its allowlist, so a feature applies to the embedded origin only (`camera *; microphone 'self' https://x.example` becomes `camera; microphone`); `referrerpolicy` is kept only as `no-referrer`, `origin`, `same-origin`, `strict-origin` or `strict-origin-when-cross-origin`.
+- An iframe plugin (`data-plugin-type="dify"`) receives the validated iframe as structured props, never as an HTML string. The Dify plugin acts only on messages its own frame's window posts from an allowed origin, and ignores a message that is not an object with a string `type`.
+- A YouTube embed loads the player only when `www.youtube.com` is in `iFrameAllowedDomains`; otherwise it renders a link to the video's watch page.
+- A tweet renders as a link to its address unless the host sets `allowTwitterWidgetScript` (on `MarkdownRenderer` and `MarkdownViewer`), which lets the page load and run `https://platform.twitter.com/widgets.js`. The widgets are taken from that script only: an existing copy is found as a `script` element with that `src` (never by the `twitter-wjs` id), and `window.twttr.widgets` is used only when its `createTweet` is a function, so an element a document names `twitter-wjs` or `twttr` cannot block or impersonate it.
+
+```tsx
+<MarkdownViewer {...props} iFrameAllowedDomains={["www.youtube.com"]} allowTwitterWidgetScript={false} />
+```
+
+### Links
+
+- A link is external when its `href` names a scheme in any case (`https:`, `HTTPS:`, `mailto:`) or another host (`//host/…`, `/\host/…`), whatever its `data-link-kind` says (only `asset` links, the converter's storage objects, may carry an absolute URL and stay with `linkComponent`), and when `data-link-kind` is `external`. An external link opens in a new tab with `rel="noreferrer"` and is never handed to `linkComponent`. The author's `target` and `rel` never survive.
+- `linkComponent` receives `href`, `kind`, `docPath`, `docExists`, `className`, `children` and `attributes`: the link's `id`, `title`, `lang`, `dir`, `role`, `aria-*` and `data-footnote-*` (event handlers, `style` and `href`-like attributes never pass). Spread `attributes` onto the anchor you render so footnote references keep their `id` and `aria-describedby` and back-references keep their `aria-label`:
+
+```tsx
+const AppLink = ({ href, className, attributes, children }: MarkdownLinkProps) => (
+  <Link to={href} className={className} {...attributes}>
+    {children}
+  </Link>
+)
+```
+
+- Only a link that wraps an image or block content is laid out as a box (`inline-block`); a link around text stays inline, so a footnote reference inside `<sup>` keeps the height of its glyphs and shows its focus ring.
+
+### Content column and alignment
+
+`MarkdownViewer` lays the document out in one column, `[data-aqmd-content]`, inside the scroll container's padding:
+
+| Prop | Effect |
+| --- | --- |
+| `width` | The column's CSS `width`. Unset, the column is `100%` wide: the full width of the scroll container's track, whatever the content, so a short document and a diagram drawn at the column's width get the whole width |
+| `maxWidth` | The column's CSS `max-width` (`"1200px"`, `"min(1200px, 100%)"` …). Unset, nothing caps the column beyond `width` |
+| `align` | Places a column narrower than the track: `left` (`margin-inline: 0 auto`), `center` (`auto`) or `right` (`auto 0`). It shows only when `width` or `maxWidth` makes the column narrower than the track |
+
+The alignment button needs `onAlignChange`, `showAlign` (on by default) and a `width` or `maxWidth`. Without either of the two, the column fills the track and no alignment can move it, so the viewer does not render the button, whatever `showAlign` says.
+
+With the `GitHub` and `Zenn` styles of `DEFAULT_MARKDOWN_STYLES`, a wide table or a long code line scrolls inside its own box. Content with a fixed width wider than the column, such as an embedded `<iframe>` whose `width` attribute exceeds it, overflows the column, and so does any wide content under the `None` style, which loads no stylesheet; the scroll container then scrolls sideways.
+
+### Mermaid diagrams
+
+A fenced code block in the `mermaid` language renders as `MermaidDiagram`, a block that takes its containing block's width (its slot). The slot's first child is a hidden measuring element, `[data-aqmd-mermaid-measure]` (no height, clipped, `visibility: hidden`, `aria-hidden`), present while the diagram loads, shows or fails; the component measures the slot's width with it.
+Each drawing gets its own drawing host, `[data-aqmd-mermaid-host]`: a hidden element (`visibility: hidden`, `aria-hidden`, absolutely positioned just outside the start edge, `contain: strict`) appended to the main document's `<body>`, with its width set to the measured width in px.
+Mermaid draws in that element and the component shows the result in the slot, so a gantt chart, whose width Mermaid takes from where it is drawn, is exactly as wide as the slot. Because Mermaid looks its drawing up through the main document, the host lives in the main document's light DOM, and a diagram in a slot inside a shadow root is drawn the same way.
+
+- The component removes a drawing host when its drawing settles (shown, failed, or discarded as stale) and when the component unmounts or its text changes, so none is left behind, not even the error drawing Mermaid leaves for a text it cannot parse.
+- Nothing is drawn while the slot has no width (inside a closed `<details>` the browser does not lay out, or a hidden panel): the loading text stays until the slot gets a width. A drawing already under way when the slot loses its width finishes at the width it was given.
+- When the width of a slot showing a gantt chart changes (a splitter drag, a window resize), the chart is drawn again at the new width 200 ms after the last change, unless the slot then has no width or the width of the latest drawing. The shown chart stays until the new one replaces it, and the new one starts at the initial zoom and pan. Other diagram types take their size from their text and are never drawn again for a width change.
+- A drawing that finishes after a newer one started, after the diagram's text changed or after the component unmounted is discarded.
+
+### Viewer toolbar
+
+`MarkdownViewer` shows its alignment, style and table-of-contents buttons as one fixed row, in that visual and tab order, spaced in `rem` so they never overlap at large text sizes. Place the row with two package-scoped custom properties, both `0px` unless set:
+
+| Property | Effect |
+| --- | --- |
+| `--aqmd-toolbar-inset-block-start` | Offset from the top of the toolbar's containing block |
+| `--aqmd-toolbar-inset-inline-end` | Offset from the inline end of the containing block (added to the scrollbar clearance) |
+
+The viewer reads no other package's variable. Where the toolbar is fixed to the viewport and must clear something of the host's own (a pinned side menu, for example), bind the property to that width in the host's layout, on an ancestor of the viewer:
+
+```css
+.my-layout {
+  --aqmd-toolbar-inset-inline-end: var(--my-side-menu-width, 0px);
+}
+```
+
+A viewer inside a containing block of its own (an element with `contain: layout paint`, a transform) needs no binding: the row sits at that block's edge.
+
+The scroll container (`[data-aqmd-scroll-container]`) publishes `--aqmd-toolbar-block-overlap`: the depth of its top band that the floating toolbar covers, `0px` at widths where the toolbar covers none of the content. The viewer already reserves it as top padding and `scroll-padding-block-start`, so the first line and fragment targets stay clear of the buttons; read it when you place your own content at the start of the container.
+The value is measured again whenever the container, the content or the toolbar resizes, the window resizes, the alignment changes (the content moves sideways), anything scrolls (a toolbar fixed to the viewport stays put while the container moves; at most once per frame), and the two inset properties change (an invisible box inside the toolbar, `[data-aqmd-toolbar-inset-probe]`, takes its size from them).
+
+Each menu's popover opens below the toolbar at its inline end, whichever button opened it, and is never wider than the scroll container less the toolbar's distance from its inline end, so the popover stays inside the container at any width and text size. The scroll container is an inline-size query container (`container-type: inline-size`) for that measure; the menu activated last stacks on top.
+
+An open, unpinned popover closes on Escape while the focus is inside its menu, returns the focus to its button and calls `preventDefault()` on that keydown, so an outer Escape handler can skip a key the viewer consumed. Escape is not consumed while no popover is open.
+
+### Table of contents
+
+Activating an entry closes an unpinned table of contents, reveals the heading if it is hidden, scrolls to it (instantly under `prefers-reduced-motion: reduce`) and moves the focus to it (adding `tabindex="-1"` when the heading has none), so the next Tab continues from that section. Pass `onHeadingSelect(heading, event)` to take part: return `false` to let the viewer reveal, scroll and focus after your own work (writing the URL hash, say), or `true` when you have handled the navigation yourself.
+
+An entry links to `#` followed by the heading's id. Where the page's URL does not address the document (several documents side by side, a document chosen by state), pass `headingHref(heading)` (`MarkdownHeadingHrefResolver`) to give each entry the heading's own address, so copying the entry's address or opening it in a new tab with a middle click reaches the heading; pass a stable function, since the table of contents is built again when it changes.
+The href goes through the package's URL rule (an entry with a refused href has none), and activating an entry still runs `onHeadingSelect` and the viewer's navigation. A Ctrl-, Cmd- or Shift-click is an activation, so return `true` from `onHeadingSelect` when a modifier key is down to let the browser open the address instead.
+
+The viewer stops the link's own navigation, so it reveals the heading the way a browser reveals the fragment it navigates to:
+
+- Every closed `<details>` around the heading opens, except one whose own summary (its first `<summary>` child, which shows while the `<details>` is closed) holds the heading. A heading in a second `<summary>` belongs to the hidden content, so its `<details>` opens.
+- Each element from the heading upward that has `hidden="until-found"` (in any letter case) receives a bubbling `beforematch` event, innermost first, and then loses `hidden`.
+- An open `<details>` and a plain `hidden` are left as they are.
+
+```tsx
+<MarkdownViewer
+  {...props}
+  onHeadingSelect={(heading) => {
+    history.replaceState(null, "", `#${heading.id}`)
+    return false
+  }}
+/>
+```
+
+```tsx
+// Module level, so the function stays the same between renders
+const headingHref: MarkdownHeadingHrefResolver = (heading) => `/docs/guide.md#${encodeURIComponent(heading.id)}`
+
+<MarkdownViewer
+  {...props}
+  headingHref={headingHref}
+  onHeadingSelect={(_heading, event) => event.ctrlKey || event.metaKey || event.shiftKey}
+/>
+```
+
+### Labels and languages
+
+Every name and text the viewer draws comes from `labels` (`MarkdownViewerLabels`), including the table-of-contents and alignment controls and, through the `mermaid*` keys, the controls of each Mermaid diagram (`MermaidDiagram` takes `MermaidDiagramLabels` as `labels`).
+A label you pass carries no language of its own and is read in your page's language.
+A built-in label marks the element that bears it with its own language: the status texts and style controls are English (`lang="en"`), the table-of-contents, alignment and Mermaid menu controls are Japanese (`lang="ja"`), and the Mermaid zoom buttons are English. `DEFAULT_MARKDOWN_VIEWER_LABELS` and `DEFAULT_MERMAID_DIAGRAM_LABELS` hold the built-in texts.
+
+### Settings without React
+
+`@aiquants/markdown/viewer-settings` exports the built-in document styles and the alignments without loading React, for modules that also run on the server (configuration, validation): `DEFAULT_MARKDOWN_STYLES`, `MarkdownStyleOption`, `ContentAlign`, `CONTENT_ALIGNS`, `DEFAULT_CONTENT_ALIGN` and `toContentAlign`. `@aiquants/markdown` re-exports the same values.
+
+```ts
+import { DEFAULT_MARKDOWN_STYLES, toContentAlign } from "@aiquants/markdown/viewer-settings"
+```
+
 ## Extended Syntax
 
 The parser supports the following extended markdown syntax in addition to CommonMark and GFM.
 
 ### LaTeX Math Expressions
 
-- Inline math: `$y=x^2$`
-- Display math: `$$ e^{i\theta} = \cos\theta + i\sin\theta $$` (or multiline block)
+- Inline math: `$y=x^2$`. A single `$` follows the `tex_math_dollars` rule of Pandoc 3.12: the opening `$` must be followed by a character that is not white space, and the formula ends at the first `$` after it that is not escaped by `\` and not inside a `\text{…}` group whose braces close; that `$` must follow a character that is not white space (a character escaped by `\`, such as the space in `$a\ $`, is not) and must not be followed by an ASCII digit; otherwise the `$` stays text.
+  Stricter than Pandoc, white space is Unicode's (the ideographic space included) and a `$` at the start of a line never closes. So `$20,000 and $30,000`, `$100〜$200`, `$HOME and $PATH` and `$ x $` are text, while `$x$`, `$a\$b$`, `$a\ $` and `$\text{for all $x$}$` are formulas; write a literal dollar as `\$` or inside a code span.
+- Within a line of text, `$$ … $$` is inline math too (`Cost $$ x $$ here` is the formula `x`): it ends at the next run of as many `$`, with white space allowed inside its ends. An inline formula may continue on the paragraph's next line.
+- Display math: a multi-line block, or a whole line `$$ e^{i\theta} = \cos\theta + i\sin\theta $$` (at most three spaces of indentation; it can follow a paragraph line directly). Both forms render the same. Inside code blocks the lines stay code.
+- A multi-line block opens on a line of two or more `$` whose rest holds no `$` (that rest is not part of the formula) and closes on a line of two or more `$` alone. Any other `$$ … $$` — within a line of text, or followed by more text on its line (`$$E=mc^2$$.`) — is inline math in its paragraph.
+- A formula reaches KaTeX exactly as written: `0<x<1`, `a & b`, quotes and `x^2 + y^2` included (the converter escapes the formula's text once, the viewer reads the text back once, and the subscript, superscript and highlight syntax never applies inside a formula).
+
+```markdown
+$$
+e^{i\theta} = \cos\theta + i\sin\theta
+$$
+```
+
+Every renderer (`MarkdownRenderer`, `MarkdownViewer`, `NodesRenderer`) renders a formula with the same KaTeX options: `throwOnError: false` (an invalid formula shows its source in red) and display math in display mode.
+Nothing KaTeX says about a formula reaches the console, in the browser or on the server: its reports about LaTeX-incompatible input that still renders (a text-mode accent such as `\r` in math mode, an unknown symbol, `\\` in display math), its warning about a character its fonts have no metrics for (※, ①, ★, €, an emoji: code `noCharacterMetrics`), and the TeX console commands `\message`, `\errmessage` and `\show`, which render nothing (code `consoleCommand`).
+`MarkdownRenderer` and `MarkdownViewer` hand them to `onMathDiagnostics` as `MarkdownMathDiagnostic` objects (`{ code, message, formula, displayMode }`): after the commit, once per document, and only when there is one; the viewer's function may change on any render without the document being parsed again.
+Japanese or other non-Latin letters inside a formula (`\frac{売上}{原価}`) are not reported, since KaTeX renders them as written; `\text{…}` is the LaTeX way to write words inside a formula.
+
+```tsx
+<MarkdownViewer
+  {...props}
+  onMathDiagnostics={(diagnostics) => {
+    for (const { code, message, formula } of diagnostics) logger.debug(`[math] ${code}: ${message} — ${formula}`)
+  }}
+/>
+```
+
+### GitHub Alerts
+
+```markdown
+> [!NOTE]
+> Useful information that users should know.
+```
+
+`NOTE`, `TIP`, `IMPORTANT`, `WARNING` and `CAUTION` (any letter case) render GitHub's own alert markup (`div.markdown-alert.markdown-alert-{type}` with a `p.markdown-alert-title` holding the type's octicon and title). As on GitHub:
+
+- only a blockquote directly at the document root becomes an alert — inside a list item, another blockquote or a Zenn directive it stays a blockquote;
+- the marker must be alone on the first line (`> [!NOTE] text` stays a blockquote);
+- something must follow the marker line (`> [!NOTE]` alone stays a blockquote).
 
 ### Table cell merge markers
 
@@ -165,7 +396,7 @@ This is ==important== text.
 
 ### Zenn-style Directives
 
-Supports Zenn-style message box and details box with support for recursive nesting:
+Message boxes and collapsible details, enabled unless `enableZennDirectives` is `false`:
 
 ```markdown
 :::message info
@@ -179,6 +410,27 @@ This is a nested warning message inside details.
 :::
 ```
 
+- **Opening line**: three or more `:`, then `message` or `details` and an optional argument. No blank lines are needed around fence lines.
+- **Message types**: `:::message alert`, `:::message info` and `:::message warning`; any other argument gives a plain message.
+- **Details title**: the rest of the line, shown as plain text (HTML-escaped, no Markdown, and left as written by the subscript, superscript and mark plugins, as on Zenn); it may be empty.
+- **Nesting**: at most eight directives are open around a line; an opening line inside eight is ordinary text (as markdown-it caps its nesting, without dropping what follows).
+- **Closing line**: three or more `:` alone. It closes the innermost open directive it reaches whose opening fence is not longer than it, so nested directives work with equal fences (as above) and with Zenn's longer outer fence (`::::details` … `::::`). It reaches a directive only through the containers around it (a blockquote's `>`, a list item's indentation) and nothing inside a container it does not continue.
+  A closing line inside a fenced code block or a `$$` math block belongs to that block, and so does one inside a multi-line `<pre>`, `<script>`, `<style>`, `<textarea>` or comment; after any other HTML block (`<div>`, `<img>`, `<br>`, a one-line comment …) it closes the directive, as on Zenn.
+- **Unclosed** directives extend to the end of their parent (the document, a blockquote, a list item or an enclosing directive). The content is ordinary Markdown.
+
+The markup is the one the `ZennMessageNode` / `ZennDetailsNode` components render: `aside.message` (plus `alert` / `info` / `warning`) with `span.message-symbol` and `div.message-content`, and `details.markdown-details` with its `summary` and `div.markdown-details-content`.
+
+### Stylesheets for the extended syntax
+
+| Stylesheet | Styles |
+| --- | --- |
+| `@aiquants/markdown/styles/markdown.css` | Package core sheet. Includes a theme-independent baseline for GitHub alerts (GitHub's light and dark palette, dark via `.dark` or `[data-theme="dark"]`), written with zero-specificity `:where()` selectors so any display style overrides it. |
+| `@aiquants/markdown/styles/github-markdown.css` | The GitHub display style (`.markdown-body`), including GitHub's own alert rules, which win over the baseline. |
+| `@aiquants/markdown/styles/message.css` | `:::message` boxes (`aside.message`), in every display style. The `!` symbol (`.message-symbol`) is not selectable, so copying a message copies its text only. |
+| `@aiquants/markdown/styles/details.css` | `:::details` boxes (`.markdown-details`), in every display style. A summary focused from the keyboard (`:focus-visible`) shows the GitHub style's focus ring, `2px solid` drawn `2px` inside its edge, in `#0969da` (`#1f6feb` under `[data-theme="dark"]`); a mouse press shows none. |
+| `@aiquants/markdown/styles/zenn-content.css` | The Zenn display style (`.znc`). |
+| `@aiquants/markdown/styles/katex.min.css` | KaTeX output for inline and display math. |
+
 ### Notes
 
 - goldmark's GFM strikethrough only recognizes double tildes (`~~text~~`), so single-tilde `~text~` is reserved for subscript.

package/dist/{abnfDiagram-VRR7QNED-BBmog1I4.cjs → abnfDiagram-VRR7QNED-DL9JJfMF.cjs}

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("./chunk-MOJQB5TN-Bs5Jj3Zh.cjs"),u=require("./chunk-JWPE2WC7-CNFRDah7.cjs"),n=require("./extractHeadings-BrLI2qQF.cjs"),i=require("./cynefin-VYW2F7L2-MpAliYy9.cjs");var p=i.createRailroadAbnfServices().RailroadAbnf.parser.LangiumParser,o=n.__name(e=>{const r=e.alternatives.map(c);return r.length===1?r[0]:{type:"choice",alternatives:r}},"transformAlternation"),c=n.__name(e=>{const r=e.elements.map(d);return r.length===1?r[0]:{type:"sequence",elements:r}},"transformConcatenation"),f=n.__name(e=>{if(e.includes("*")){const[t,s]=e.split("*"),l=t?parseInt(t,10):0,m=s?parseInt(s,10):1/0;return{min:l,max:m}}const r=parseInt(e,10);return{min:r,max:r}},"parseRepeat"),d=n.__name(e=>{const r=b(e.primary);if(!e.repeat)return r;const{min:t,max:s}=f(e.repeat);return t===0&&s===1?{type:"optional",element:r}:{type:"repetition",element:r,min:t,max:s}},"transformElement"),b=n.__name(e=>{switch(e.$type){case"AbnfStringLiteral":return{type:"terminal",value:e.value};case"AbnfNumVal":return{type:"terminal",value:e.value};case"AbnfRuleName":return{type:"nonterminal",name:e.name};case"AbnfGroup":return o(e.element);case"AbnfOptionalGroup":return{type:"optional",element:o(e.element)};default:throw new Error(`Unsupported ABNF primary node: ${e.$type}`)}},"transformPrimary"),g=n.__name(e=>({name:e.name,definition:o(e.definition)}),"transformRule"),v=n.__name(e=>{u.populateCommonDb(e,a.db),e.title&&a.db.setTitle(e.title),e.rules.map(r=>a.db.addRule(g(r)))},"populateDb"),y={parse:n.__name(e=>{a.db.clear(),n.log.debug("[ABNF Parser] Starting Langium parse");const r=p.parse(e);if(r.lexerErrors.length>0||r.parserErrors.length>0)throw new i.MermaidParseError(r);const t=r.value;n.log.debug("[ABNF Parser] Parsed rules:",t.rules.length),v(t),n.log.debug("[ABNF Parser] Parse complete")},"parse"),parser:{yy:a.db}},_={parser:y,db:a.db,renderer:a.renderer,styles:a.getStyles};exports.diagram=_;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("./chunk-MOJQB5TN-Dh_1HfSC.cjs"),u=require("./chunk-JWPE2WC7-CNZBI1Pb.cjs"),n=require("./extractHeadings-R7NxLZJP.cjs"),i=require("./cynefin-VYW2F7L2-MpAliYy9.cjs");var p=i.createRailroadAbnfServices().RailroadAbnf.parser.LangiumParser,o=n.__name(e=>{const r=e.alternatives.map(c);return r.length===1?r[0]:{type:"choice",alternatives:r}},"transformAlternation"),c=n.__name(e=>{const r=e.elements.map(d);return r.length===1?r[0]:{type:"sequence",elements:r}},"transformConcatenation"),f=n.__name(e=>{if(e.includes("*")){const[t,s]=e.split("*"),l=t?parseInt(t,10):0,m=s?parseInt(s,10):1/0;return{min:l,max:m}}const r=parseInt(e,10);return{min:r,max:r}},"parseRepeat"),d=n.__name(e=>{const r=b(e.primary);if(!e.repeat)return r;const{min:t,max:s}=f(e.repeat);return t===0&&s===1?{type:"optional",element:r}:{type:"repetition",element:r,min:t,max:s}},"transformElement"),b=n.__name(e=>{switch(e.$type){case"AbnfStringLiteral":return{type:"terminal",value:e.value};case"AbnfNumVal":return{type:"terminal",value:e.value};case"AbnfRuleName":return{type:"nonterminal",name:e.name};case"AbnfGroup":return o(e.element);case"AbnfOptionalGroup":return{type:"optional",element:o(e.element)};default:throw new Error(`Unsupported ABNF primary node: ${e.$type}`)}},"transformPrimary"),g=n.__name(e=>({name:e.name,definition:o(e.definition)}),"transformRule"),v=n.__name(e=>{u.populateCommonDb(e,a.db),e.title&&a.db.setTitle(e.title),e.rules.map(r=>a.db.addRule(g(r)))},"populateDb"),y={parse:n.__name(e=>{a.db.clear(),n.log.debug("[ABNF Parser] Starting Langium parse");const r=p.parse(e);if(r.lexerErrors.length>0||r.parserErrors.length>0)throw new i.MermaidParseError(r);const t=r.value;n.log.debug("[ABNF Parser] Parsed rules:",t.rules.length),v(t),n.log.debug("[ABNF Parser] Parse complete")},"parse"),parser:{yy:a.db}},_={parser:y,db:a.db,renderer:a.renderer,styles:a.getStyles};exports.diagram=_;

package/dist/{abnfDiagram-VRR7QNED-IjPsliMa.js → abnfDiagram-VRR7QNED-utxwo7Ri.js}

@@ -1,27 +1,27 @@
-import { g as p, r as u, d as n } from "./chunk-MOJQB5TN-DwJ5ntgS.js";
-import { p as f } from "./chunk-JWPE2WC7-DtFuVO4n.js";
-import { _ as a, a0 as o } from "./extractHeadings-BUHj1PcO.js";
+import { g as p, r as u, d as a } from "./chunk-MOJQB5TN-D1oF99aM.js";
+import { p as f } from "./chunk-JWPE2WC7-B-nuuS4b.js";
+import { _ as n, $ as o } from "./extractHeadings-B2I83li5.js";
 import { M as c, b as d } from "./cynefin-VYW2F7L2-Bkk-F_Js.js";
-var v = d().RailroadAbnf.parser.LangiumParser, i = /* @__PURE__ */ a((e) => {
+var v = d().RailroadAbnf.parser.LangiumParser, i = /* @__PURE__ */ n((e) => {
   const r = e.alternatives.map(g);
   return r.length === 1 ? r[0] : {
     type: "choice",
     alternatives: r
   };
-}, "transformAlternation"), g = /* @__PURE__ */ a((e) => {
+}, "transformAlternation"), g = /* @__PURE__ */ n((e) => {
   const r = e.elements.map(y);
   return r.length === 1 ? r[0] : {
     type: "sequence",
     elements: r
   };
-}, "transformConcatenation"), b = /* @__PURE__ */ a((e) => {
+}, "transformConcatenation"), b = /* @__PURE__ */ n((e) => {
   if (e.includes("*")) {
     const [t, s] = e.split("*"), l = t ? parseInt(t, 10) : 0, m = s ? parseInt(s, 10) : 1 / 0;
     return { min: l, max: m };
   }
   const r = parseInt(e, 10);
   return { min: r, max: r };
-}, "parseRepeat"), y = /* @__PURE__ */ a((e) => {
+}, "parseRepeat"), y = /* @__PURE__ */ n((e) => {
   const r = A(e.primary);
   if (!e.repeat)
     return r;
@@ -32,7 +32,7 @@ var v = d().RailroadAbnf.parser.LangiumParser, i = /* @__PURE__ */ a((e) => {
     min: t,
     max: s
   };
-}, "transformElement"), A = /* @__PURE__ */ a((e) => {
+}, "transformElement"), A = /* @__PURE__ */ n((e) => {
   switch (e.$type) {
     case "AbnfStringLiteral":
       return {
@@ -59,14 +59,14 @@ var v = d().RailroadAbnf.parser.LangiumParser, i = /* @__PURE__ */ a((e) => {
     default:
       throw new Error(`Unsupported ABNF primary node: ${e.$type}`);
   }
-}, "transformPrimary"), P = /* @__PURE__ */ a((e) => ({
+}, "transformPrimary"), P = /* @__PURE__ */ n((e) => ({
   name: e.name,
   definition: i(e.definition)
-}), "transformRule"), h = /* @__PURE__ */ a((e) => {
-  f(e, n), e.title && n.setTitle(e.title), e.rules.map((r) => n.addRule(P(r)));
+}), "transformRule"), h = /* @__PURE__ */ n((e) => {
+  f(e, a), e.title && a.setTitle(e.title), e.rules.map((r) => a.addRule(P(r)));
 }, "populateDb"), R = {
-  parse: /* @__PURE__ */ a((e) => {
-    n.clear(), o.debug("[ABNF Parser] Starting Langium parse");
+  parse: /* @__PURE__ */ n((e) => {
+    a.clear(), o.debug("[ABNF Parser] Starting Langium parse");
     const r = v.parse(e);
     if (r.lexerErrors.length > 0 || r.parserErrors.length > 0)
       throw new c(r);
@@ -74,11 +74,11 @@ var v = d().RailroadAbnf.parser.LangiumParser, i = /* @__PURE__ */ a((e) => {
     o.debug("[ABNF Parser] Parsed rules:", t.rules.length), h(t), o.debug("[ABNF Parser] Parse complete");
   }, "parse"),
   parser: {
-    yy: n
+    yy: a
   }
 }, w = {
   parser: R,
-  db: n,
+  db: a,
   renderer: u,
   styles: p
 };

package/dist/{arc-DKsAswGe.cjs → arc-BY7loL0l.cjs}

@@ -1 +1 @@
-"use strict";const n=require("./extractHeadings-BrLI2qQF.cjs");function $(o){return o.innerRadius}function b(o){return o.outerRadius}function k(o){return o.startAngle}function _(o){return o.endAngle}function nn(o){return o&&o.padAngle}function en(o,x,D,P,h,v,S,s){var E=D-o,r=P-x,e=S-h,p=s-v,i=p*E-e*r;if(!(i*i<n.epsilon))return i=(e*(x-v)-p*(o-h))/i,[o+i*E,x+i*r]}function M(o,x,D,P,h,v,S){var s=o-D,E=x-P,r=(S?v:-v)/n.sqrt(s*s+E*E),e=r*E,p=-r*s,i=o+e,u=x+p,c=D+e,f=P+p,j=(i+c)/2,l=(u+f)/2,y=c-i,g=f-u,A=y*y+g*g,R=h-v,T=i*f-c*u,H=(g<0?-1:1)*n.sqrt(n.max(0,R*R*A-T*T)),I=(T*g-y*H)/A,O=(-T*y-g*H)/A,q=(T*g+y*H)/A,d=(-T*y+g*H)/A,m=I-j,a=O-l,t=q-j,z=d-l;return m*m+a*a>t*t+z*z&&(I=q,O=d),{cx:I,cy:O,x01:-e,y01:-p,x11:I*(h/R-1),y11:O*(h/R-1)}}function an(){var o=$,x=b,D=n.constant(0),P=null,h=k,v=_,S=nn,s=null,E=n.withPath(r);function r(){var e,p,i=+o.apply(this,arguments),u=+x.apply(this,arguments),c=h.apply(this,arguments)-n.halfPi,f=v.apply(this,arguments)-n.halfPi,j=n.abs(f-c),l=f>c;if(s||(s=e=E()),u<i&&(p=u,u=i,i=p),!(u>n.epsilon))s.moveTo(0,0);else if(j>n.tau-n.epsilon)s.moveTo(u*n.cos(c),u*n.sin(c)),s.arc(0,0,u,c,f,!l),i>n.epsilon&&(s.moveTo(i*n.cos(f),i*n.sin(f)),s.arc(0,0,i,f,c,l));else{var y=c,g=f,A=c,R=f,T=j,H=j,I=S.apply(this,arguments)/2,O=I>n.epsilon&&(P?+P.apply(this,arguments):n.sqrt(i*i+u*u)),q=n.min(n.abs(u-i)/2,+D.apply(this,arguments)),d=q,m=q,a,t;if(O>n.epsilon){var z=n.asin(O/i*n.sin(I)),F=n.asin(O/u*n.sin(I));(T-=z*2)>n.epsilon?(z*=l?1:-1,A+=z,R-=z):(T=0,A=R=(c+f)/2),(H-=F*2)>n.epsilon?(F*=l?1:-1,y+=F,g-=F):(H=0,y=g=(c+f)/2)}var B=u*n.cos(y),C=u*n.sin(y),G=i*n.cos(R),J=i*n.sin(R);if(q>n.epsilon){var K=u*n.cos(g),L=u*n.sin(g),N=i*n.cos(A),Q=i*n.sin(A),w;if(j<n.pi)if(w=en(B,C,N,Q,K,L,G,J)){var U=B-w[0],V=C-w[1],W=K-w[0],X=L-w[1],Y=1/n.sin(n.acos((U*W+V*X)/(n.sqrt(U*U+V*V)*n.sqrt(W*W+X*X)))/2),Z=n.sqrt(w[0]*w[0]+w[1]*w[1]);d=n.min(q,(i-Z)/(Y-1)),m=n.min(q,(u-Z)/(Y+1))}else d=m=0}H>n.epsilon?m>n.epsilon?(a=M(N,Q,B,C,u,m,l),t=M(K,L,G,J,u,m,l),s.moveTo(a.cx+a.x01,a.cy+a.y01),m<q?s.arc(a.cx,a.cy,m,n.atan2(a.y01,a.x01),n.atan2(t.y01,t.x01),!l):(s.arc(a.cx,a.cy,m,n.atan2(a.y01,a.x01),n.atan2(a.y11,a.x11),!l),s.arc(0,0,u,n.atan2(a.cy+a.y11,a.cx+a.x11),n.atan2(t.cy+t.y11,t.cx+t.x11),!l),s.arc(t.cx,t.cy,m,n.atan2(t.y11,t.x11),n.atan2(t.y01,t.x01),!l))):(s.moveTo(B,C),s.arc(0,0,u,y,g,!l)):s.moveTo(B,C),!(i>n.epsilon)||!(T>n.epsilon)?s.lineTo(G,J):d>n.epsilon?(a=M(G,J,K,L,i,-d,l),t=M(B,C,N,Q,i,-d,l),s.lineTo(a.cx+a.x01,a.cy+a.y01),d<q?s.arc(a.cx,a.cy,d,n.atan2(a.y01,a.x01),n.atan2(t.y01,t.x01),!l):(s.arc(a.cx,a.cy,d,n.atan2(a.y01,a.x01),n.atan2(a.y11,a.x11),!l),s.arc(0,0,i,n.atan2(a.cy+a.y11,a.cx+a.x11),n.atan2(t.cy+t.y11,t.cx+t.x11),l),s.arc(t.cx,t.cy,d,n.atan2(t.y11,t.x11),n.atan2(t.y01,t.x01),!l))):s.arc(0,0,i,R,A,l)}if(s.closePath(),e)return s=null,e+""||null}return r.centroid=function(){var e=(+o.apply(this,arguments)+ +x.apply(this,arguments))/2,p=(+h.apply(this,arguments)+ +v.apply(this,arguments))/2-n.pi/2;return[n.cos(p)*e,n.sin(p)*e]},r.innerRadius=function(e){return arguments.length?(o=typeof e=="function"?e:n.constant(+e),r):o},r.outerRadius=function(e){return arguments.length?(x=typeof e=="function"?e:n.constant(+e),r):x},r.cornerRadius=function(e){return arguments.length?(D=typeof e=="function"?e:n.constant(+e),r):D},r.padRadius=function(e){return arguments.length?(P=e==null?null:typeof e=="function"?e:n.constant(+e),r):P},r.startAngle=function(e){return arguments.length?(h=typeof e=="function"?e:n.constant(+e),r):h},r.endAngle=function(e){return arguments.length?(v=typeof e=="function"?e:n.constant(+e),r):v},r.padAngle=function(e){return arguments.length?(S=typeof e=="function"?e:n.constant(+e),r):S},r.context=function(e){return arguments.length?(s=e??null,r):s},r}exports.d3arc=an;
+"use strict";const n=require("./extractHeadings-R7NxLZJP.cjs");function $(o){return o.innerRadius}function b(o){return o.outerRadius}function k(o){return o.startAngle}function _(o){return o.endAngle}function nn(o){return o&&o.padAngle}function en(o,x,D,P,h,v,S,s){var E=D-o,r=P-x,e=S-h,p=s-v,i=p*E-e*r;if(!(i*i<n.epsilon))return i=(e*(x-v)-p*(o-h))/i,[o+i*E,x+i*r]}function M(o,x,D,P,h,v,S){var s=o-D,E=x-P,r=(S?v:-v)/n.sqrt(s*s+E*E),e=r*E,p=-r*s,i=o+e,u=x+p,c=D+e,f=P+p,j=(i+c)/2,l=(u+f)/2,y=c-i,g=f-u,A=y*y+g*g,R=h-v,T=i*f-c*u,H=(g<0?-1:1)*n.sqrt(n.max(0,R*R*A-T*T)),I=(T*g-y*H)/A,O=(-T*y-g*H)/A,q=(T*g+y*H)/A,d=(-T*y+g*H)/A,m=I-j,a=O-l,t=q-j,z=d-l;return m*m+a*a>t*t+z*z&&(I=q,O=d),{cx:I,cy:O,x01:-e,y01:-p,x11:I*(h/R-1),y11:O*(h/R-1)}}function an(){var o=$,x=b,D=n.constant(0),P=null,h=k,v=_,S=nn,s=null,E=n.withPath(r);function r(){var e,p,i=+o.apply(this,arguments),u=+x.apply(this,arguments),c=h.apply(this,arguments)-n.halfPi,f=v.apply(this,arguments)-n.halfPi,j=n.abs(f-c),l=f>c;if(s||(s=e=E()),u<i&&(p=u,u=i,i=p),!(u>n.epsilon))s.moveTo(0,0);else if(j>n.tau-n.epsilon)s.moveTo(u*n.cos(c),u*n.sin(c)),s.arc(0,0,u,c,f,!l),i>n.epsilon&&(s.moveTo(i*n.cos(f),i*n.sin(f)),s.arc(0,0,i,f,c,l));else{var y=c,g=f,A=c,R=f,T=j,H=j,I=S.apply(this,arguments)/2,O=I>n.epsilon&&(P?+P.apply(this,arguments):n.sqrt(i*i+u*u)),q=n.min(n.abs(u-i)/2,+D.apply(this,arguments)),d=q,m=q,a,t;if(O>n.epsilon){var z=n.asin(O/i*n.sin(I)),F=n.asin(O/u*n.sin(I));(T-=z*2)>n.epsilon?(z*=l?1:-1,A+=z,R-=z):(T=0,A=R=(c+f)/2),(H-=F*2)>n.epsilon?(F*=l?1:-1,y+=F,g-=F):(H=0,y=g=(c+f)/2)}var B=u*n.cos(y),C=u*n.sin(y),G=i*n.cos(R),J=i*n.sin(R);if(q>n.epsilon){var K=u*n.cos(g),L=u*n.sin(g),N=i*n.cos(A),Q=i*n.sin(A),w;if(j<n.pi)if(w=en(B,C,N,Q,K,L,G,J)){var U=B-w[0],V=C-w[1],W=K-w[0],X=L-w[1],Y=1/n.sin(n.acos((U*W+V*X)/(n.sqrt(U*U+V*V)*n.sqrt(W*W+X*X)))/2),Z=n.sqrt(w[0]*w[0]+w[1]*w[1]);d=n.min(q,(i-Z)/(Y-1)),m=n.min(q,(u-Z)/(Y+1))}else d=m=0}H>n.epsilon?m>n.epsilon?(a=M(N,Q,B,C,u,m,l),t=M(K,L,G,J,u,m,l),s.moveTo(a.cx+a.x01,a.cy+a.y01),m<q?s.arc(a.cx,a.cy,m,n.atan2(a.y01,a.x01),n.atan2(t.y01,t.x01),!l):(s.arc(a.cx,a.cy,m,n.atan2(a.y01,a.x01),n.atan2(a.y11,a.x11),!l),s.arc(0,0,u,n.atan2(a.cy+a.y11,a.cx+a.x11),n.atan2(t.cy+t.y11,t.cx+t.x11),!l),s.arc(t.cx,t.cy,m,n.atan2(t.y11,t.x11),n.atan2(t.y01,t.x01),!l))):(s.moveTo(B,C),s.arc(0,0,u,y,g,!l)):s.moveTo(B,C),!(i>n.epsilon)||!(T>n.epsilon)?s.lineTo(G,J):d>n.epsilon?(a=M(G,J,K,L,i,-d,l),t=M(B,C,N,Q,i,-d,l),s.lineTo(a.cx+a.x01,a.cy+a.y01),d<q?s.arc(a.cx,a.cy,d,n.atan2(a.y01,a.x01),n.atan2(t.y01,t.x01),!l):(s.arc(a.cx,a.cy,d,n.atan2(a.y01,a.x01),n.atan2(a.y11,a.x11),!l),s.arc(0,0,i,n.atan2(a.cy+a.y11,a.cx+a.x11),n.atan2(t.cy+t.y11,t.cx+t.x11),l),s.arc(t.cx,t.cy,d,n.atan2(t.y11,t.x11),n.atan2(t.y01,t.x01),!l))):s.arc(0,0,i,R,A,l)}if(s.closePath(),e)return s=null,e+""||null}return r.centroid=function(){var e=(+o.apply(this,arguments)+ +x.apply(this,arguments))/2,p=(+h.apply(this,arguments)+ +v.apply(this,arguments))/2-n.pi/2;return[n.cos(p)*e,n.sin(p)*e]},r.innerRadius=function(e){return arguments.length?(o=typeof e=="function"?e:n.constant(+e),r):o},r.outerRadius=function(e){return arguments.length?(x=typeof e=="function"?e:n.constant(+e),r):x},r.cornerRadius=function(e){return arguments.length?(D=typeof e=="function"?e:n.constant(+e),r):D},r.padRadius=function(e){return arguments.length?(P=e==null?null:typeof e=="function"?e:n.constant(+e),r):P},r.startAngle=function(e){return arguments.length?(h=typeof e=="function"?e:n.constant(+e),r):h},r.endAngle=function(e){return arguments.length?(v=typeof e=="function"?e:n.constant(+e),r):v},r.padAngle=function(e){return arguments.length?(S=typeof e=="function"?e:n.constant(+e),r):S},r.context=function(e){return arguments.length?(s=e??null,r):s},r}exports.d3arc=an;

package/dist/{arc-E1KzF_uD.js → arc-Byq9kr_0.js}

@@ -1,4 +1,4 @@
-import { aL as ln, aM as an, aN as y, aO as tn, aP as W, aQ as O, aR as _, aS as un, aT as rn, aU as Z, aV as o, aW as N, aX as sn, aY as on, aZ as fn } from "./extractHeadings-BUHj1PcO.js";
+import { aK as ln, aL as an, aM as y, aN as tn, aO as V, aP as O, aQ as _, aR as un, aS as rn, aT as Y, aU as o, aV as M, aW as sn, aX as on, aY as fn } from "./extractHeadings-B2I83li5.js";
 function cn(l) {
   return l.innerRadius;
 }
@@ -14,66 +14,66 @@ function dn(l) {
 function mn(l) {
   return l && l.padAngle;
 }
-function pn(l, h, D, S, v, R, Q, a) {
-  var E = D - l, i = S - h, n = Q - v, d = a - R, u = d * E - n * i;
+function pn(l, h, D, S, v, R, N, a) {
+  var E = D - l, i = S - h, n = N - v, d = a - R, u = d * E - n * i;
   if (!(u * u < y))
     return u = (n * (h - R) - d * (l - v)) / u, [l + u * E, h + u * i];
 }
-function G(l, h, D, S, v, R, Q) {
-  var a = l - D, E = h - S, i = (Q ? R : -R) / Z(a * a + E * E), n = i * E, d = -i * a, u = l + n, s = h + d, f = D + n, c = S + d, U = (u + f) / 2, t = (s + c) / 2, m = f - u, g = c - s, A = m * m + g * g, T = v - R, P = u * c - f * s, I = (g < 0 ? -1 : 1) * Z(fn(0, T * T * A - P * P)), L = (P * g - m * I) / A, M = (-P * m - g * I) / A, w = (P * g + m * I) / A, p = (-P * m + g * I) / A, x = L - U, e = M - t, r = w - U, V = p - t;
-  return x * x + e * e > r * r + V * V && (L = w, M = p), {
-    cx: L,
-    cy: M,
+function G(l, h, D, S, v, R, N) {
+  var a = l - D, E = h - S, i = (N ? R : -R) / Y(a * a + E * E), n = i * E, d = -i * a, u = l + n, s = h + d, f = D + n, c = S + d, Q = (u + f) / 2, t = (s + c) / 2, m = f - u, g = c - s, A = m * m + g * g, T = v - R, P = u * c - f * s, I = (g < 0 ? -1 : 1) * Y(fn(0, T * T * A - P * P)), K = (P * g - m * I) / A, L = (-P * m - g * I) / A, w = (P * g + m * I) / A, p = (-P * m + g * I) / A, x = K - Q, e = L - t, r = w - Q, U = p - t;
+  return x * x + e * e > r * r + U * U && (K = w, L = p), {
+    cx: K,
+    cy: L,
     x01: -n,
     y01: -d,
-    x11: L * (v / T - 1),
-    y11: M * (v / T - 1)
+    x11: K * (v / T - 1),
+    y11: L * (v / T - 1)
   };
 }
 function hn() {
-  var l = cn, h = yn, D = N(0), S = null, v = gn, R = dn, Q = mn, a = null, E = ln(i);
+  var l = cn, h = yn, D = M(0), S = null, v = gn, R = dn, N = mn, a = null, E = ln(i);
   function i() {
-    var n, d, u = +l.apply(this, arguments), s = +h.apply(this, arguments), f = v.apply(this, arguments) - an, c = R.apply(this, arguments) - an, U = un(c - f), t = c > f;
+    var n, d, u = +l.apply(this, arguments), s = +h.apply(this, arguments), f = v.apply(this, arguments) - an, c = R.apply(this, arguments) - an, Q = un(c - f), t = c > f;
     if (a || (a = n = E()), s < u && (d = s, s = u, u = d), !(s > y)) a.moveTo(0, 0);
-    else if (U > tn - y)
-      a.moveTo(s * W(f), s * O(f)), a.arc(0, 0, s, f, c, !t), u > y && (a.moveTo(u * W(c), u * O(c)), a.arc(0, 0, u, c, f, t));
+    else if (Q > tn - y)
+      a.moveTo(s * V(f), s * O(f)), a.arc(0, 0, s, f, c, !t), u > y && (a.moveTo(u * V(c), u * O(c)), a.arc(0, 0, u, c, f, t));
     else {
-      var m = f, g = c, A = f, T = c, P = U, I = U, L = Q.apply(this, arguments) / 2, M = L > y && (S ? +S.apply(this, arguments) : Z(u * u + s * s)), w = _(un(s - u) / 2, +D.apply(this, arguments)), p = w, x = w, e, r;
-      if (M > y) {
-        var V = sn(M / u * O(L)), j = sn(M / s * O(L));
-        (P -= V * 2) > y ? (V *= t ? 1 : -1, A += V, T -= V) : (P = 0, A = T = (f + c) / 2), (I -= j * 2) > y ? (j *= t ? 1 : -1, m += j, g -= j) : (I = 0, m = g = (f + c) / 2);
+      var m = f, g = c, A = f, T = c, P = Q, I = Q, K = N.apply(this, arguments) / 2, L = K > y && (S ? +S.apply(this, arguments) : Y(u * u + s * s)), w = _(un(s - u) / 2, +D.apply(this, arguments)), p = w, x = w, e, r;
+      if (L > y) {
+        var U = sn(L / u * O(K)), j = sn(L / s * O(K));
+        (P -= U * 2) > y ? (U *= t ? 1 : -1, A += U, T -= U) : (P = 0, A = T = (f + c) / 2), (I -= j * 2) > y ? (j *= t ? 1 : -1, m += j, g -= j) : (I = 0, m = g = (f + c) / 2);
       }
-      var X = s * W(m), Y = s * O(m), z = u * W(T), B = u * O(T);
+      var W = s * V(m), X = s * O(m), z = u * V(T), B = u * O(T);
       if (w > y) {
-        var C = s * W(g), F = s * O(g), H = u * W(A), J = u * O(A), q;
-        if (U < rn)
-          if (q = pn(X, Y, H, J, C, F, z, B)) {
-            var K = X - q[0], $ = Y - q[1], k = C - q[0], b = F - q[1], nn = 1 / O(on((K * k + $ * b) / (Z(K * K + $ * $) * Z(k * k + b * b))) / 2), en = Z(q[0] * q[0] + q[1] * q[1]);
+        var C = s * V(g), F = s * O(g), H = u * V(A), J = u * O(A), q;
+        if (Q < rn)
+          if (q = pn(W, X, H, J, C, F, z, B)) {
+            var Z = W - q[0], $ = X - q[1], k = C - q[0], b = F - q[1], nn = 1 / O(on((Z * k + $ * b) / (Y(Z * Z + $ * $) * Y(k * k + b * b))) / 2), en = Y(q[0] * q[0] + q[1] * q[1]);
             p = _(w, (u - en) / (nn - 1)), x = _(w, (s - en) / (nn + 1));
           } else
             p = x = 0;
       }
-      I > y ? x > y ? (e = G(H, J, X, Y, s, x, t), r = G(C, F, z, B, s, x, t), a.moveTo(e.cx + e.x01, e.cy + e.y01), x < w ? a.arc(e.cx, e.cy, x, o(e.y01, e.x01), o(r.y01, r.x01), !t) : (a.arc(e.cx, e.cy, x, o(e.y01, e.x01), o(e.y11, e.x11), !t), a.arc(0, 0, s, o(e.cy + e.y11, e.cx + e.x11), o(r.cy + r.y11, r.cx + r.x11), !t), a.arc(r.cx, r.cy, x, o(r.y11, r.x11), o(r.y01, r.x01), !t))) : (a.moveTo(X, Y), a.arc(0, 0, s, m, g, !t)) : a.moveTo(X, Y), !(u > y) || !(P > y) ? a.lineTo(z, B) : p > y ? (e = G(z, B, C, F, u, -p, t), r = G(X, Y, H, J, u, -p, t), a.lineTo(e.cx + e.x01, e.cy + e.y01), p < w ? a.arc(e.cx, e.cy, p, o(e.y01, e.x01), o(r.y01, r.x01), !t) : (a.arc(e.cx, e.cy, p, o(e.y01, e.x01), o(e.y11, e.x11), !t), a.arc(0, 0, u, o(e.cy + e.y11, e.cx + e.x11), o(r.cy + r.y11, r.cx + r.x11), t), a.arc(r.cx, r.cy, p, o(r.y11, r.x11), o(r.y01, r.x01), !t))) : a.arc(0, 0, u, T, A, t);
+      I > y ? x > y ? (e = G(H, J, W, X, s, x, t), r = G(C, F, z, B, s, x, t), a.moveTo(e.cx + e.x01, e.cy + e.y01), x < w ? a.arc(e.cx, e.cy, x, o(e.y01, e.x01), o(r.y01, r.x01), !t) : (a.arc(e.cx, e.cy, x, o(e.y01, e.x01), o(e.y11, e.x11), !t), a.arc(0, 0, s, o(e.cy + e.y11, e.cx + e.x11), o(r.cy + r.y11, r.cx + r.x11), !t), a.arc(r.cx, r.cy, x, o(r.y11, r.x11), o(r.y01, r.x01), !t))) : (a.moveTo(W, X), a.arc(0, 0, s, m, g, !t)) : a.moveTo(W, X), !(u > y) || !(P > y) ? a.lineTo(z, B) : p > y ? (e = G(z, B, C, F, u, -p, t), r = G(W, X, H, J, u, -p, t), a.lineTo(e.cx + e.x01, e.cy + e.y01), p < w ? a.arc(e.cx, e.cy, p, o(e.y01, e.x01), o(r.y01, r.x01), !t) : (a.arc(e.cx, e.cy, p, o(e.y01, e.x01), o(e.y11, e.x11), !t), a.arc(0, 0, u, o(e.cy + e.y11, e.cx + e.x11), o(r.cy + r.y11, r.cx + r.x11), t), a.arc(r.cx, r.cy, p, o(r.y11, r.x11), o(r.y01, r.x01), !t))) : a.arc(0, 0, u, T, A, t);
     }
     if (a.closePath(), n) return a = null, n + "" || null;
   }
   return i.centroid = function() {
     var n = (+l.apply(this, arguments) + +h.apply(this, arguments)) / 2, d = (+v.apply(this, arguments) + +R.apply(this, arguments)) / 2 - rn / 2;
-    return [W(d) * n, O(d) * n];
+    return [V(d) * n, O(d) * n];
   }, i.innerRadius = function(n) {
-    return arguments.length ? (l = typeof n == "function" ? n : N(+n), i) : l;
+    return arguments.length ? (l = typeof n == "function" ? n : M(+n), i) : l;
   }, i.outerRadius = function(n) {
-    return arguments.length ? (h = typeof n == "function" ? n : N(+n), i) : h;
+    return arguments.length ? (h = typeof n == "function" ? n : M(+n), i) : h;
   }, i.cornerRadius = function(n) {
-    return arguments.length ? (D = typeof n == "function" ? n : N(+n), i) : D;
+    return arguments.length ? (D = typeof n == "function" ? n : M(+n), i) : D;
   }, i.padRadius = function(n) {
-    return arguments.length ? (S = n == null ? null : typeof n == "function" ? n : N(+n), i) : S;
+    return arguments.length ? (S = n == null ? null : typeof n == "function" ? n : M(+n), i) : S;
   }, i.startAngle = function(n) {
-    return arguments.length ? (v = typeof n == "function" ? n : N(+n), i) : v;
+    return arguments.length ? (v = typeof n == "function" ? n : M(+n), i) : v;
   }, i.endAngle = function(n) {
-    return arguments.length ? (R = typeof n == "function" ? n : N(+n), i) : R;
+    return arguments.length ? (R = typeof n == "function" ? n : M(+n), i) : R;
   }, i.padAngle = function(n) {
-    return arguments.length ? (Q = typeof n == "function" ? n : N(+n), i) : Q;
+    return arguments.length ? (N = typeof n == "function" ? n : M(+n), i) : N;
   }, i.context = function(n) {
     return arguments.length ? (a = n ?? null, i) : a;
   }, i;