allyhub 0.7.0 → 0.8.0

package/dist/node_modules/@allyhub/doc/dist/html.js

@@ -0,0 +1,91 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{chartColor as z,chartFrame as j,docChartSvg as M}from"./chart.js";import{BACKGROUNDS as x,TEXT_COLORS as w}from"./color.js";import{columnWidths as A,COLUMN_GAP as N}from"./columns.js";import{COMPONENT_WIDTH as E,componentName as O}from"./component.js";import{DRAWN_CODE as v,mathHtml as P}from"./math.js";import{PAPER as s}from"./paper.js";import{COVER_HEIGHT_MM as T,everyBlock as H,noteNumbers as R}from"./model.js";export const PAGE_FACES={sans:'"Commissioner Variable", Commissioner, "Noto Sans SC", "PingFang SC", "Microsoft YaHei", system-ui, sans-serif',serif:'"Piazzolla Variable", Piazzolla, "Noto Serif SC", "Songti SC", Georgia, serif',mono:'"JetBrains Mono Variable", "JetBrains Mono", "SF Mono", Menlo, Consolas, "Noto Sans SC", monospace'};export function pageFaces(n={}){switch(n.font){case"serif":return{text:PAGE_FACES.serif,heading:PAGE_FACES.serif};case"mono":return{text:PAGE_FACES.mono,heading:PAGE_FACES.mono};default:return{text:PAGE_FACES.sans,heading:PAGE_FACES.serif}}}export const pageAccent=(n={})=>n.accent===void 0?void 0:z(n.accent);export{BACKGROUNDS,TEXT_COLORS}from"./color.js";const c=n=>n.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;"),$=(n,i)=>i[n]??(/^(#[0-9a-f]{3,8}|[a-z]+|(rgb|hsl)a?\([\d\s.,%/]+\))$/i.test(n)?n:void 0);function g(n,i){return n.map(t=>{if(t.note!==void 0){const a=i.notes.get(t.note.toLowerCase());return a===void 0?`<sup class="fn">[${c(t.note)}]</sup>`:`<sup class="fn"><a href="#note-${String(a)}">${String(a)}</a></sup>`}let o=c(t.text).replace(/\n/g,"<br>");const d=t.styles;d.code&&(o=`<code>${o}</code>`),d.strike&&(o=`<s>${o}</s>`),d.italic&&(o=`<em>${o}</em>`),d.bold&&(o=`<strong>${o}</strong>`),d.underline&&(o=`<u>${o}</u>`);const e=d.color===void 0?void 0:$(d.color,w),r=d.background===void 0?void 0:$(d.background,x);return(e!==void 0||r!==void 0)&&(o=`<span style="${e===void 0?"":`color:${e};`}${r===void 0?"":`background:${r};`}">${o}</span>`),t.href!==void 0&&/^(https?:|mailto:|#|\/|\.)/i.test(t.href)&&(o=`<a href="${c(t.href)}">${o}</a>`),o}).join("")}function f(n){if(!n)return"";const i=n.color===void 0?void 0:$(n.color,w),t=n.background===void 0?void 0:$(n.background,x),o=[n.align===void 0?"":`text-align:${n.align};`,i===void 0?"":`color:${i};`,t===void 0?"":`background:${t};padding:0.15em 0.4em;border-radius:3px;`].join("");return o===""?"":` style="${o}"`}const y=n=>n.type==="bullet"||n.type==="numbered"||n.type==="check";function h(n,i,t){const o=[];let d=0;for(;d<n.length;){const e=n[d];if(e===void 0)break;if(y(e)){const r=e.type==="numbered";let a=d;const m=[];for(;a<n.length;){const l=n[a];if(!l||!y(l)||l.type==="numbered"!==r)break;const p=l.type==="check"?`<span class="box${l.checked?" done":""}"></span>`:"";m.push(`<li${l.type==="check"?` class="task${l.checked?" done":""}"`:""}${f(l.look)}>${p}<span class="words">${g(l.content,t)}</span>${h(l.children??[],i,t)}</li>`),a++}const u=e.type==="numbered"&&e.start!==void 0?` start="${String(e.start)}"`:"";o.push(r?`<ol${u}>${m.join("")}</ol>`:`<ul>${m.join("")}</ul>`),d=a;continue}switch(d++,e.type){case"paragraph":o.push(`<p${f(e.look)}>${g(e.content,t)||"&nbsp;"}</p>${b(e.children,i,t)}`);break;case"heading":{const r=`h${String(e.level)}`;o.push(`<${r}${f(e.look)}>${g(e.content,t)}</${r}>${b(e.children,i,t)}`);break}case"toggle":o.push(`<p${f(e.look)}>${g(e.content,t)}</p>${b(e.children,i,t)}`);break;case"quote":o.push(`<blockquote${f(e.look)}><p>${g(e.content,t)}</p>${h(e.children??[],i,t)}</blockquote>`);break;case"callout":o.push(`<div class="callout"${f(e.look)}><span class="callout-icon">${c(e.icon??"💡")}</span><div><p>${g(e.content,t)}</p>${h(e.children??[],i,t)}</div></div>`);break;case"code":o.push(_(e,i));break;case"columns":{const r=e.columns.map(m=>`${String(m.width??1)}fr`).join(" "),a=A(e,i.room);o.push(`<div class="columns" style="grid-template-columns:${r}">${e.columns.map((m,u)=>`<div class="column">${h(m.blocks,{...i,room:a[u]??E},t)}</div>`).join("")}</div>`);break}case"chart":{const{svg:r,problems:a}=M(e,{...i,font:pageFaces(i.page).text}),{width:m}=j(e,i.room);o.push(r===void 0?`<div class="embed" data-chart>${c(e.title??"Chart")}<br><small>${c(a.join("; "))}</small></div>`:`<figure class="chart" style="max-width:${String(m)}px">${r}</figure>`);break}case"image":{const r=i.image?.(e.src)??e.src;o.push(`<figure${e.align===void 0?"":` style="text-align:${e.align}"`}><img src="${c(r)}" alt="${c(e.alt??"")}"${e.width===void 0?"":` width="${String(e.width)}"`}>${e.caption===void 0?"":`<figcaption>${c(e.caption)}</figcaption>`}</figure>`);break}case"table":{const r=e.head===void 0||e.head==="both",a=e.head==="column"||e.head==="both",m=(l,p)=>`<tr>${l.map((S,C)=>{const k=p||a&&C===0?"th":"td";return`<${k}>${g(S,t)}</${k}>`}).join("")}</tr>`,u=e.widths?.some(l=>l!==null)?`<colgroup>${e.widths.map(l=>l===null?"<col>":`<col style="width:${String(l)}px">`).join("")}</colgroup>`:"";o.push(`<table>${u}<tbody>${e.rows.map((l,p)=>m(l,r&&p===0)).join("")}</tbody></table>`);break}case"divider":o.push("<hr>");break;case"pagebreak":o.push('<div class="page-break"></div>');break;case"note":break;case"component":{const r=i.component?.(e),a=e.align===void 0?"":` style="text-align:${e.align}"`;o.push(r===void 0?`<div class="embed" data-component>${c(O(e))}</div>`:`<figure${a}><img src="${c(r)}" alt="${c(e.alt??"")}"${e.width===void 0?"":` width="${String(e.width)}"`}>${e.caption===void 0?"":`<figcaption>${c(e.caption)}</figcaption>`}</figure>`);break}case"embed":{const r=i.embed?.(e.source,t.embeds);t.embeds++;const a=/^<\s*([A-Za-z][\w.]*)/.exec(e.source.trim())?.[1];o.push(r??`<div class="embed" data-embed>${c(a??"")}</div>`);break}case"source":break}}return o.join(`
+`)}function _(n,i){if(n.language===v.math)return`<div class="math">${P(n.code).html}</div>`;if(n.language===v.mermaid){const t=i.diagram?.(n.code);if(t?.svg!==void 0)return`<figure class="diagram">${t.svg}</figure>`;if(t?.error!==void 0)return`<pre><code>${c(n.code)}</code></pre><p class="drawn-error">Mermaid: ${c(t.error)}</p>`}return`<pre><code>${c(n.code)}</code></pre>`}const b=(n,i,t)=>n?.length?`<div class="under">${h(n,i,t)}</div>`:"";export const DOC_CSS=`
+/* The page's side margins are the text column's own padding, so a cover
+   can reach the page's edges: the column stays 170 mm. */
+@page { size: A4; margin: 18mm 0; }
+* { box-sizing: border-box; }
+html { font-size: 11pt; }
+body { margin: 0; color: ${s.ink}; font-family: "Commissioner Variable", Commissioner, "Noto Sans SC", "PingFang SC", "Microsoft YaHei", system-ui, sans-serif; line-height: 1.6; font-variation-settings: "FLAR" 40; -webkit-print-color-adjust: exact; print-color-adjust: exact; }
+main { max-width: 210mm; margin: 0 auto; padding: 0 20mm; }
+h1, h2, h3, h4, h5, h6 { line-height: 1.25; margin: 1.4em 0 0.4em; break-after: avoid; }
+/* As the editor sets them: the title and the sections (levels 1 and 2) in the serif. */
+h1, h2 { font-family: "Piazzolla Variable", Piazzolla, "Noto Serif SC", "Songti SC", Georgia, serif; font-weight: 600; letter-spacing: -0.01em; }
+h1 { font-size: 1.75em; }
+/* The heading a doc opens with is its title. */
+body > h1:first-child, main > h1:first-child, article > h1:first-child, main > .cover + h1 { font-size: 2.3em; margin-top: 0; }
+h2 { font-size: 1.45em; }
+h3 { font-size: 1.15em; }
+h4, h5, h6 { font-size: 1em; }
+h5 { color: ${s.lead}; }
+h6 { color: ${s.leadSoft}; font-weight: 500; }
+p { margin: 0.5em 0; }
+ul, ol { margin: 0.5em 0; padding-left: 1.5em; }
+li { margin: 0.2em 0; }
+/* A task as the editor draws it: a box, ticked and the words struck when done. */
+li.task { list-style: none; margin-left: -1.5em; }
+li.task .box { display: inline-block; width: 0.95em; height: 0.95em; margin-right: 0.55em; border: 1.5px solid ${s.ruleStrong}; border-radius: 3px; vertical-align: -0.14em; }
+li.task .box.done { border-color: ${s.ink}; background: ${s.ink} url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 12 12'%3E%3Cpath d='M2.5 6.2l2.3 2.3 4.7-4.9' fill='none' stroke='white' stroke-width='1.8' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E") center / 85% no-repeat; }
+li.task.done > .words { color: ${s.leadSoft}; text-decoration: line-through; text-decoration-color: ${s.ruleStrong}; }
+.under { margin-left: 1.5em; }
+blockquote { margin: 0.8em 0; padding-left: 1em; border-left: 1px solid ${s.ruleStrong}; color: ${s.lead}; }
+code { font-family: "JetBrains Mono Variable", "JetBrains Mono", "SF Mono", Menlo, Consolas, monospace; font-size: 0.88em; background: ${s.stone2}; border-radius: 3px; padding: 0.12em 0.34em; }
+pre { background: ${s.stone}; border-radius: 6px; padding: 0.9em 1.1em; font-size: 0.9em; line-height: 1.6; overflow: hidden; white-space: pre-wrap; break-inside: avoid; }
+pre code { background: none; padding: 0; }
+/* Tables as the editor sets them (Notion's): rows apart by hairlines, no
+   lines between columns, a head over a stronger rule. */
+table { border-collapse: collapse; width: 100%; margin: 0.8em 0; font-size: 0.9em; break-inside: avoid; }
+th, td { border: 0; border-bottom: 1px solid ${s.rule}; padding: 0.45em 0.9em; text-align: left; vertical-align: top; }
+:is(th, td):first-child { padding-left: 0; }
+th { border-bottom-color: ${s.ruleStrong}; font-weight: 600; }
+figure { margin: 1em 0; break-inside: avoid; }
+img { max-width: 100%; }
+figcaption { color: ${s.leadSoft}; font-size: 0.9em; margin-top: 0.3em; }
+hr { border: 0; border-top: 1px solid ${s.rule}; margin: 1.5em 0; }
+a { color: inherit; text-decoration: underline; text-decoration-color: ${s.ruleStrong}; text-decoration-thickness: 1px; text-underline-offset: 0.2em; }
+.callout { display: flex; gap: 0.6em; margin: 0.8em 0; border-radius: 6px; background: ${s.stone}; padding: 0.7em 0.9em; break-inside: avoid; }
+.callout-icon { flex: none; }
+.callout p { margin: 0; }
+.embed { border: 1px dashed ${s.ruleMid}; border-radius: 6px; padding: 1.5em; text-align: center; color: ${s.leadSoft}; break-inside: avoid; }
+/* A cover: a band of a picture across the top of the first page, edge to
+   edge (Notion's). */
+.cover { height: ${String(T)}mm; margin: 0 -20mm 2.4em; overflow: hidden; break-inside: avoid; }
+.cover img { display: block; width: 100%; height: 100%; max-width: none; object-fit: cover; }
+/* A footnote's mark, and the notes at the end under a short rule. */
+sup.fn { font-size: 0.72em; line-height: 0; margin-left: 0.02em; font-variant-numeric: tabular-nums; }
+sup.fn a { text-decoration: none; color: ${s.lead}; }
+.notes { margin-top: 2.5em; padding-top: 0.8em; border-top: 1px solid ${s.rule}; width: 100%; font-size: 0.85em; color: ${s.lead}; }
+.notes ol { padding-left: 1.6em; margin: 0; }
+.notes li { margin: 0.25em 0; }
+.notes li p { margin: 0; }
+.page-break { break-after: page; height: 0; }
+.columns { display: grid; gap: 0 ${String(N)}px; margin: 0.4em 0; }
+.column { min-width: 0; }
+.column > :first-child { margin-top: 0; }
+.column > :last-child { margin-bottom: 0; }
+figure.chart { margin: 1.2em auto; }
+figure.chart svg, figure.diagram svg { display: block; max-width: 100%; height: auto; margin: 0 auto; }
+figure.diagram { text-align: center; }
+.drawn-error { color: #c4320a; font-size: 0.9em; margin-top: -0.3em; white-space: pre-wrap; }
+.math { margin: 1em 0; overflow: hidden; break-inside: avoid; }
+.math .katex-display { margin: 0; }
+tr, li, p { break-inside: avoid; }
+`;function B(n,i,t){const o=[...H(n)].filter(r=>r.type==="note");return o.length===0?"":`<section class="notes"><ol>${o.map(r=>({note:r,n:t.notes.get(r.label.toLowerCase())})).sort((r,a)=>(r.n??1/0)-(a.n??1/0)).map(({note:r,n:a})=>`<li${a===void 0?"":` id="note-${String(a)}" value="${String(a)}"`}><p>${g(r.content,t)}</p>${h(r.children??[],i,t)}</li>`).join("")}</ol></section>`}export function pageCss(n={}){const i=pageFaces(n),t=pageAccent(n),o=[];return(n.font==="serif"||n.font==="mono")&&o.push(`body { font-family: ${i.text}; }`,`h1, h2, h3, h4, h5, h6 { font-family: ${i.heading}; }`),n.font==="mono"&&o.push("html { font-size: 10pt; }"),t!==void 0&&o.push(`a { color: ${t}; text-decoration-color: color-mix(in oklab, ${t} 45%, transparent); }`,`blockquote { border-left: 2px solid ${t}; }`),o.join(`
+`)}export function docHtml(n,i={}){const t={embeds:0,notes:R(n)},o=i.page?.cover,d=o===void 0?void 0:i.image?.(o)??o,e=`${d===void 0?"":`<figure class="cover"><img src="${c(d)}" alt="" style="object-position:50% ${String(i.page?.coverY??50)}%"></figure>
+`}${h(n,i,t)}${B(n,i,t)}`,r=[pageCss(i.page),...d===void 0?[]:["@page :first { margin-top: 0; }"]].filter(a=>a!=="").join(`
+`);return`<!doctype html>
+<html>
+<head>
+<meta charset="utf-8">
+<title>${c(i.title??"")}</title>
+${i.fonts===void 0?"":`<style>${i.fonts}</style>
+`}<style>${DOC_CSS}${r===""?"":`
+${r}`}</style>
+</head>
+<body>
+<main>
+${e}
+</main>
+</body>
+</html>
+`}

package/dist/node_modules/@allyhub/doc/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { DOC_CSS, PAGE_FACES, docHtml, pageAccent, pageCss, pageFaces, type DocHtmlOptions, } from "./html.js";
+export { CHART_BARS, ROUND_FRAME, CHART_PALETTE, CHART_TEXT, chartColor, chartFrame, chartTheme, chartWords, docChart, docChartSvg, type DocChartOptions, type DocChartSvgOptions, } from "./chart.js";
+export { COMPONENT_ASPECT, COMPONENT_WIDTH, componentAt, componentDrawing, componentDrawingKey, componentName, type ComponentBlock, } from "./component.js";
+export { COLUMN_GAP, columnWidths } from "./columns.js";
+export { DRAWN_CODE, mathHtml } from "./math.js";
+export { PAPER, diagramConfig, tint } from "./paper.js";
+export { markdownOf, plainBlocks, type MarkdownOptions } from "./markdown.js";
+export * from "./model.js";
+export { BLOCK_TAG, CALLOUT_TAG, CHART_ATTRIBUTES, CHART_TAG, COLUMN_TAG, COLUMNS_TAG, PAGE_BREAK_TAG, COMPONENT_ATTRIBUTES, COMPONENT_TAG, TABLE_TAG, parseDoc, } from "./parse.js";
+export { patchDoc } from "./patch.js";
+export { isTitle, retitle, splitTitle, titleText, withTitle } from "./title.js";
+export { frontMatterOf, withPage, writeBlocks } from "./write.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/node_modules/@allyhub/doc/dist/index.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export{DOC_CSS,PAGE_FACES,docHtml,pageAccent,pageCss,pageFaces}from"./html.js";export{CHART_BARS,ROUND_FRAME,CHART_PALETTE,CHART_TEXT,chartColor,chartFrame,chartTheme,chartWords,docChart,docChartSvg}from"./chart.js";export{COMPONENT_ASPECT,COMPONENT_WIDTH,componentAt,componentDrawing,componentDrawingKey,componentName}from"./component.js";export{COLUMN_GAP,columnWidths}from"./columns.js";export{DRAWN_CODE,mathHtml}from"./math.js";export{PAPER,diagramConfig,tint}from"./paper.js";export{markdownOf,plainBlocks}from"./markdown.js";export*from"./model.js";export{BLOCK_TAG,CALLOUT_TAG,CHART_ATTRIBUTES,CHART_TAG,COLUMN_TAG,COLUMNS_TAG,PAGE_BREAK_TAG,COMPONENT_ATTRIBUTES,COMPONENT_TAG,TABLE_TAG,parseDoc}from"./parse.js";export{patchDoc}from"./patch.js";export{isTitle,retitle,splitTitle,titleText,withTitle}from"./title.js";export{frontMatterOf,withPage,writeBlocks}from"./write.js";

package/dist/node_modules/@allyhub/doc/dist/markdown.d.ts

@@ -0,0 +1,13 @@
+import { type DocChartOptions } from "./chart.js";
+import type { ComponentBlock } from "./component.js";
+import type { Block } from "./model.js";
+/** What a host gives Markdown of a doc that Markdown cannot draw; `data` and `base` give its charts their numbers, `page` its cover. */
+export interface MarkdownOptions extends DocChartOptions {
+    /** A component's still, as the picture's path the Markdown names; without it the component is left out. */
+    component?: (block: ComponentBlock) => string | undefined;
+}
+/** Blocks as what Markdown can say. */
+export declare function plainBlocks(blocks: readonly Block[], opts?: MarkdownOptions): Block[];
+/** A doc's blocks as plain Markdown. */
+export declare function markdownOf(blocks: readonly Block[], opts?: MarkdownOptions): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/node_modules/@allyhub/doc/dist/markdown.js

@@ -0,0 +1,3 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{docChart as l}from"./chart.js";import{writeBlocks as m}from"./write.js";function u(e){const t={};return e.bold&&(t.bold=!0),e.italic&&(t.italic=!0),e.strike&&(t.strike=!0),e.code&&(t.code=!0),t}const o=e=>e.map(t=>t.note!==void 0?{text:t.text,styles:{},note:t.note}:t.href===void 0?{text:t.text,styles:u(t.styles)}:{text:t.text,href:t.href,styles:u(t.styles)});function g(e,t){switch(e.type){case"embed":case"source":return[];case"component":{const n=t.component?.(e);return n===void 0?[]:[{type:"image",src:n,...e.alt===void 0?{}:{alt:e.alt},...e.caption===void 0?{}:{caption:e.caption}}]}case"code":case"divider":return[e];case"pagebreak":return[];case"columns":return e.columns.flatMap(n=>plainBlocks(n.blocks,t));case"chart":{const n=r=>r===""?[]:[{text:r,styles:{}}],s=e.table===void 0?l(e,t).chart:void 0,d=e.table??(s&&s.categories.length>0?[[e.categories??"",...s.series.map(r=>r.name)],...s.categories.map((r,p)=>[r,...s.series.map(f=>{const c=f.values[p];return c==null?"":String(c)})])]:void 0);return d===void 0?[]:[...e.title===void 0?[]:[{type:"paragraph",content:[{text:e.title,styles:{bold:!0}}]}],{type:"table",rows:d.map(r=>r.map(n))}]}case"image":return[{type:"image",src:e.src,...e.alt===void 0?{}:{alt:e.alt},...e.caption===void 0?{}:{caption:e.caption}}];case"table":return[{type:"table",rows:e.rows.map(n=>n.map(o))}];default:break}const a=o(e.content),i=plainBlocks(e.children??[],t);switch(e.type){case"bullet":case"numbered":case"check":case"note":case"quote":{const n={...e};return delete n.look,delete n.children,[{...n,content:a,...i.length?{children:i}:{}}]}case"callout":return[{type:"quote",content:[...e.icon===void 0?[]:[{text:`${e.icon} `,styles:{}}],...a],...i.length?{children:i}:{}}];case"heading":return[{type:"heading",level:e.level,content:a},...i];case"toggle":case"paragraph":return[{type:"paragraph",content:a},...i]}}export function plainBlocks(e,t={}){return e.flatMap(a=>g(a,t))}export function markdownOf(e,t={}){const a=t.page?.cover;return`${m([...a===void 0?[]:[{type:"image",src:a}],...plainBlocks(e,t)])}
+`}

package/dist/node_modules/@allyhub/doc/dist/math.d.ts

@@ -0,0 +1,11 @@
+/** An equation as HTML, set apart on its own line; `error` when its TeX cannot be read. */
+export declare function mathHtml(tex: string): {
+    html: string;
+    error?: string;
+};
+/** The languages of the code blocks a doc draws: an equation and a diagram. */
+export declare const DRAWN_CODE: {
+    readonly math: "math";
+    readonly mermaid: "mermaid";
+};
+//# sourceMappingURL=math.d.ts.map

package/dist/node_modules/@allyhub/doc/dist/math.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import e from"katex";export function mathHtml(t){try{return{html:e.renderToString(t,{displayMode:!0,throwOnError:!0,output:"htmlAndMathml",strict:"ignore"})}}catch(r){const o=r instanceof Error?r.message:String(r);return{html:e.renderToString(t,{displayMode:!0,throwOnError:!1,output:"htmlAndMathml",strict:"ignore"}),error:o}}}export const DRAWN_CODE={math:"math",mermaid:"mermaid"};

package/dist/node_modules/@allyhub/doc/dist/model.d.ts

@@ -0,0 +1,280 @@
+import type { ChartLegendPosition, SheetChartType } from "@allyhub/formats";
+/** How a run of text is marked. A key is absent when the mark is not on. */
+export interface Styles {
+    bold?: true;
+    italic?: true;
+    underline?: true;
+    strike?: true;
+    code?: true;
+    /** The text's colour, by name ("red") or as CSS writes one. */
+    color?: string;
+    /** The colour behind the text. */
+    background?: string;
+}
+/** A run of text with the same marks all through it; a link when it has `href`. */
+export interface TextRun {
+    text: string;
+    styles: Styles;
+    href?: string;
+    /**
+     * A footnote's mark (`[^label]`), where it is: `text` is its label, and
+     * `note` the same label. Shown as the note's number, in the order the
+     * doc first marks each one.
+     */
+    note?: string;
+}
+/** What a whole block looks like, beside its text's own marks. */
+export interface BlockLook {
+    align?: "center" | "right" | "justify";
+    color?: string;
+    background?: string;
+}
+interface Base {
+    /** Absent when the block looks as its kind does. */
+    look?: BlockLook;
+    /** The blocks under it (indented, or folded under a toggle); absent when none. */
+    children?: Block[];
+}
+export type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
+export type Block = (Base & {
+    type: "paragraph";
+    content: TextRun[];
+}) | (Base & {
+    type: "heading";
+    level: HeadingLevel;
+    /** Its children fold under it. */
+    toggle?: true;
+    content: TextRun[];
+}) | (Base & {
+    type: "bullet";
+    content: TextRun[];
+})
+/** `start`: the number of the first item of a list, when it is not 1. */
+ | (Base & {
+    type: "numbered";
+    start?: number;
+    content: TextRun[];
+}) | (Base & {
+    type: "check";
+    checked: boolean;
+    content: TextRun[];
+})
+/** A line whose children fold under it. */
+ | (Base & {
+    type: "toggle";
+    content: TextRun[];
+}) | (Base & {
+    type: "quote";
+    content: TextRun[];
+})
+/** A line set apart, with a sign before it. */
+ | (Base & {
+    type: "callout";
+    icon?: string;
+    content: TextRun[];
+}) | {
+    type: "code";
+    language?: string;
+    code: string;
+}
+/** `width`: how wide it is shown, px, when a person sized it. */
+ | {
+    type: "image";
+    src: string;
+    alt?: string;
+    caption?: string;
+    width?: number;
+    align?: "center" | "right";
+}
+/**
+ * Rows of cells. The first row is the head unless `head` says otherwise:
+ * no head, the first column, or both the first row and the first column.
+ * `widths`: each column's width, px, where a person sized it (null: its own).
+ */
+ | {
+    type: "table";
+    rows: TextRun[][][];
+    head?: "none" | "column" | "both";
+    widths?: (number | null)[];
+} | {
+    type: "divider";
+}
+/**
+ * A component drawn by code in a frame (docs/design/components-everywhere.md):
+ * `of` names it by its module from the doc's folder (`../ui.ts#Dialog`);
+ * `width` and `height` are its frame's pixels at 1× (default: its own
+ * size, or the column's width at its aspect); `at` the moment it is drawn
+ * at, seconds since it came on; `props` its props as written, read by the
+ * component's types where it is drawn.
+ */
+ | {
+    type: "component";
+    of: string;
+    width?: number;
+    height?: number;
+    at?: number;
+    alt?: string;
+    caption?: string;
+    align?: "center" | "right";
+    props: Record<string, string>;
+}
+/**
+ * A chart (`<Chart>`), drawn from its numbers: written in the doc as a
+ * table (`table`: its head row names the series, its first column the
+ * categories), or read from a project file (`data`, from the doc's
+ * folder: `<sheet>#<table>`, a CSV or a data file of rows, with the
+ * column of its `categories` and those of its `series`).
+ */
+ | ChartBlock
+/**
+ * Blocks side by side (`<Columns>` around two or more `<Column>`): each
+ * column its blocks, and its width as a share against the others'
+ * (default 1). A column holds no columns.
+ */
+ | ColumnsBlock
+/**
+ * A footnote (`[^label]: …`): its label, its words and the blocks under
+ * them. Drawn where the doc's notes are (the end of a page, Word's foot of
+ * a page), numbered in the order the doc first marks each.
+ */
+ | (Base & {
+    type: "note";
+    label: string;
+    content: TextRun[];
+})
+/** Where a page ends on paper and in Word (`<PageBreak />`). */
+ | {
+    type: "pagebreak";
+}
+/** A tag the doc's code draws (<Gauge … />), as written. */
+ | {
+    type: "embed";
+    source: string;
+}
+/** What is not shown: imports, exports, a definition. Kept as written. */
+ | {
+    type: "source";
+    source: string;
+};
+/** One column of blocks side by side. */
+export interface Column {
+    /** Its width as a share against the other columns' (`2` beside `1` is twice as wide); absent: 1. */
+    width?: number;
+    blocks: Block[];
+}
+export interface ColumnsBlock {
+    type: "columns";
+    columns: Column[];
+}
+/** What a chart's data labels show (`labels="value,percentage"`). */
+export declare const CHART_LABELS: readonly ["value", "percentage", "category", "series"];
+export type ChartLabel = (typeof CHART_LABELS)[number];
+export interface ChartBlock {
+    type: "chart";
+    /** What it is drawn as: a deck's and a sheet's kinds (`column-clustered`, `line`, `pie`…). */
+    kind: SheetChartType;
+    /** Its title, drawn over it. */
+    title?: string;
+    /** Its numbers as written: rows of cells, the first row its head. */
+    table?: string[][];
+    /** The project file its numbers are read from, from the doc's folder. */
+    data?: string;
+    /** With `data`: the column of its categories. */
+    categories?: string;
+    /** With `data`: the columns of its series. */
+    series?: string[];
+    /** Where its legend is; absent: below it when it has more than one series. */
+    legend?: ChartLegendPosition | "none";
+    /** What its data labels show; absent: none. */
+    labels?: ChartLabel[];
+    /** How its numbers are written (Excel's format: `#,##0`, `0%`). */
+    format?: string;
+    /** Its value axis's ends. */
+    min?: number;
+    max?: number;
+    /** A colour per series (per category for a pie), in order; absent: the doc's. */
+    colors?: string[];
+    /** Its frame's pixels at 1×: default the column's width, at 16:9. */
+    width?: number;
+    height?: number;
+    /** What it shows, in words, for a reader that reads aloud. */
+    alt?: string;
+}
+/** The faces a page is set in: Notion's three. */
+export declare const PAGE_FONTS: readonly ["sans", "serif", "mono"];
+export type PageFont = (typeof PAGE_FONTS)[number];
+/** How the whole page looks: its front matter. A key is absent when the page keeps the default. */
+export interface PageLook {
+    /** Its face: `sans` (the default), `serif` or `mono`. */
+    font?: PageFont;
+    /** Its colour: links, a quote's rule, a chart's first series. A colour a doc names, or a CSS colour. */
+    accent?: string;
+    /** A picture across the top of the page, as Notion's cover: its path from the doc's folder, or an address. */
+    cover?: string;
+    /** Which height of the cover shows, 0 (its top) to 100 (its bottom); absent: 50, its middle. */
+    coverY?: number;
+    /** false: no page numbers at the foot of its pages on paper and in Word; absent: numbered. */
+    pageNumbers?: false;
+}
+/** A cover on paper: a band across the top of the first page, edge to edge, this many mm high (A4 is 210 wide). */
+export declare const COVER_HEIGHT_MM = 64;
+/** That band's height over its width, as Word and a cut picture take it. */
+export declare const COVER_ASPECT: number;
+export type BlockType = Block["type"];
+/** The blocks that hold text. */
+export type TextBlock = Extract<Block, {
+    content: TextRun[];
+}>;
+export declare const hasText: (block: Block) => block is TextBlock;
+/** Something in the file that cannot be read as a doc, with where. */
+export interface DocProblem {
+    message: string;
+    /** 1-based, in the file. */
+    line?: number;
+    column?: number;
+}
+/** A stretch of the file and the blocks it holds: the unit a change rewrites. */
+export interface Segment {
+    /** Offsets into the source: [start, end). */
+    start: number;
+    end: number;
+    blocks: Block[];
+}
+export interface Doc {
+    source: string;
+    blocks: Block[];
+    segments: Segment[];
+    problems: DocProblem[];
+    /** How the page looks, as its front matter says; empty without one. */
+    page: PageLook;
+    /** Where its front matter is in the file: [start, end). */
+    frontMatter?: {
+        start: number;
+        end: number;
+    };
+}
+/**
+ * Runs with the spaces at the edge of bold, italic, underlined or struck
+ * words taken out of the mark (a selection that took the space after a
+ * word): they look the same, and Markdown can write **word** where
+ * "word " would need a tag. Code keeps its spaces, which show, and a link
+ * its words.
+ */
+export declare function plainEdges(runs: readonly TextRun[]): TextRun[];
+/** A block as one string: equal blocks give equal strings. */
+export declare const blockKey: (block: Block) => string;
+export declare const sameBlocks: (a: readonly Block[], b: readonly Block[]) => boolean;
+/** The blocks inside a block: those under it, or those of its columns, in order. */
+export declare const innerBlocks: (block: Block) => readonly Block[];
+/** Every block, those inside others too, each before what is inside it. */
+export declare function everyBlock(blocks: readonly Block[]): Generator<Block>;
+/**
+ * Each footnote's number by its label (lower case, as GFM matches them):
+ * 1, 2, 3 in the order the doc first marks them; a note it never marks,
+ * or a mark with no note, has none.
+ */
+export declare function noteNumbers(blocks: readonly Block[]): Map<string, number>;
+/** The blocks an editor shows: all but what is kept as written and not shown (imports, definitions). */
+export declare const shownBlocks: (blocks: readonly Block[]) => Block[];
+export {};
+//# sourceMappingURL=model.d.ts.map

package/dist/node_modules/@allyhub/doc/dist/model.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const CHART_LABELS=["value","percentage","category","series"],PAGE_FONTS=["sans","serif","mono"],COVER_HEIGHT_MM=64,COVER_ASPECT=.3047619047619048,hasText=e=>"content"in e;const h=["bold","italic","underline","strike"],E=(e,t)=>e.note===void 0&&t.note===void 0&&e.href===t.href&&JSON.stringify(l(e.styles))===JSON.stringify(l(t.styles));export function plainEdges(e){const t=[],c=(o,n,r)=>{if(o==="")return;const s={text:o,styles:n,...r===void 0?{}:{href:r}},f=t.at(-1);f&&E(f,s)?f.text+=o:t.push(s)};return e.forEach((o,n)=>{if(o.note!==void 0){t.push({...o});return}const{styles:r,href:s}=o,f=!r.code&&s===void 0&&h.some(x=>r[x])?/^(\s*)([\s\S]*?)(\s*)$/u.exec(o.text):null;if(!f){c(o.text,r,s);return}const[,p="",d="",u=""]=f,i={...r};delete i.bold,delete i.italic,delete i.underline,delete i.strike;const y=e[n-1]?.note!==void 0,a=e[n+1]?.note!==void 0;c(p,y?r:i,s),c(d,d===""?i:r,s),c(u,a?r:i,s)}),t}const g=e=>e.length>0&&e.every(t=>t!==null&&typeof t=="object"&&typeof t.text=="string"&&typeof t.styles=="object");function l(e){if(Array.isArray(e))return(g(e)?plainEdges(e):e).map(l);if(e!==null&&typeof e=="object"){const t={};for(const c of Object.keys(e).sort()){const o=e[c];o!==void 0&&(t[c]=l(o))}return t}return e}export const blockKey=e=>JSON.stringify(l(e)),sameBlocks=(e,t)=>e.length===t.length&&e.every((c,o)=>{const n=t[o];return n!==void 0&&blockKey(c)===blockKey(n)}),innerBlocks=e=>e.type==="columns"?e.columns.flatMap(t=>t.blocks):"children"in e?e.children??[]:[];export function*everyBlock(e){for(const t of e)yield t,yield*everyBlock(innerBlocks(t))}export function noteNumbers(e){const t=new Map,c=new Set([...everyBlock(e)].flatMap(n=>n.type==="note"?[n.label.toLowerCase()]:[])),o=n=>{for(const r of n){const s=r.note?.toLowerCase();s!==void 0&&c.has(s)&&!t.has(s)&&t.set(s,t.size+1)}};for(const n of everyBlock(e))if(n.type!=="note"&&("content"in n&&o(n.content),n.type==="table"))for(const r of n.rows)for(const s of r)o(s);return t}export const shownBlocks=e=>e.filter(t=>t.type!=="source");

package/dist/node_modules/@allyhub/doc/dist/paper.d.ts

@@ -0,0 +1,39 @@
+/** The colours a doc's charts take in turn: a palette checked for colour blindness on white. */
+export declare const CHART_PALETTE: readonly ["#2A78D6", "#EB6834", "#1BAF7A", "#EDA100", "#E87BA4", "#008300"];
+export declare const PAPER: {
+    /** Its words. */
+    readonly ink: "#1F1D1A";
+    /** What is said quietly: a quote, an axis, a caption. */
+    readonly lead: "#605B51";
+    readonly leadSoft: "#847F72";
+    /** Hairlines between rows, around a box. */
+    readonly rule: "#EAE6DE";
+    /** A rule that carries weight: under a table's head, beside a quote. */
+    readonly ruleStrong: "#959083";
+    /** A rule between the two: an axis, a diagram's box. */
+    readonly ruleMid: "#D6D1C6";
+    /** A well in the page: code, a callout. */
+    readonly stone: "#F8F6F1";
+    readonly stone2: "#EFECE5";
+    readonly sheet: "#FFFFFF";
+};
+/**
+ * The colours a doc's charts and diagrams take in turn, `#RRGGBB`: its
+ * accent first, and the palette's colour nearest it giving way, so no two
+ * take the same colour.
+ */
+export declare function accentPalette(accent?: string): string[];
+/** A colour as light as `share` of it over white: a tint. */
+export declare function tint(hex: string, share: number): string;
+/**
+ * How Mermaid draws a doc's diagrams: its base theme in the doc's colours
+ * (boxes on the page's stone, hairline edges, the charts' palette for
+ * sections and slices), in the page's face, a little tighter than its
+ * defaults. One setting for the editor and for paper, so a diagram is the
+ * same picture in both. `accent` is the page's, as CSS.
+ */
+export declare function diagramConfig(o: {
+    font: string;
+    accent?: string | undefined;
+}): Record<string, unknown>;
+//# sourceMappingURL=paper.d.ts.map

package/dist/node_modules/@allyhub/doc/dist/paper.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const CHART_PALETTE=["#2A78D6","#EB6834","#1BAF7A","#EDA100","#E87BA4","#008300"],PAPER={ink:"#1F1D1A",lead:"#605B51",leadSoft:"#847F72",rule:"#EAE6DE",ruleStrong:"#959083",ruleMid:"#D6D1C6",stone:"#F8F6F1",stone2:"#EFECE5",sheet:"#FFFFFF"};const c=o=>{const e=Number.parseInt(o.slice(1),16);return[e>>16&255,e>>8&255,e&255]};function u(o,e){const[n,l,r]=c(o);let i=0,t=1/0;return e.forEach((a,d)=>{const[k,C,g]=c(a),s=2*(n-k)**2+4*(l-C)**2+3*(r-g)**2;s<t&&(t=s,i=d)}),i}export function accentPalette(o){const e=[...CHART_PALETTE];if(o===void 0)return e;const n=u(o,e);return[o,...e.filter((l,r)=>r!==n)]}export function tint(o,e){const n=Number.parseInt(o.slice(1),16),l=r=>Math.round(255-(255-r)*e).toString(16).padStart(2,"0");return`#${l(n>>16&255)}${l(n>>8&255)}${l(n&255)}`.toUpperCase()}export function diagramConfig(o){const e=accentPalette(o.accent),n=Object.fromEntries(Array.from({length:12},(i,t)=>{const a=e[t%e.length]??PAPER.leadSoft;return[[`cScale${String(t)}`,tint(a,.22)],[`cScaleLabel${String(t)}`,PAPER.ink],[`cScalePeer${String(t)}`,tint(a,.6)],[`cScaleInv${String(t)}`,tint(a,.7)]]}).flat()),l=Object.fromEntries(e.map((i,t)=>[`pie${String(t+1)}`,i])),r=e[0]??CHART_PALETTE[0];return{startOnLoad:!1,securityLevel:"strict",htmlLabels:!1,fontFamily:o.font,theme:"base",themeCSS:`.grid .tick line { stroke: ${PAPER.rule}; } .grid .tick text { fill: ${PAPER.lead}; } .grid path { stroke-width: 0; } .lineWrapper line, line.lineWrapper { stroke: ${PAPER.leadSoft}; }`,look:"classic",flowchart:{htmlLabels:!1,nodeSpacing:36,rankSpacing:44,padding:10,curve:"basis"},sequence:{actorMargin:40,width:120,height:44,boxMargin:8,messageFontSize:14,mirrorActors:!1},gantt:{barHeight:22,barGap:6,fontSize:12,sectionFontSize:12},themeVariables:{fontFamily:o.font,fontSize:"14px",background:PAPER.sheet,primaryColor:PAPER.stone,primaryBorderColor:PAPER.ruleMid,primaryTextColor:PAPER.ink,secondaryColor:PAPER.stone2,secondaryBorderColor:PAPER.ruleMid,secondaryTextColor:PAPER.ink,tertiaryColor:PAPER.sheet,tertiaryBorderColor:PAPER.rule,tertiaryTextColor:PAPER.ink,mainBkg:PAPER.stone,nodeBorder:PAPER.ruleMid,clusterBkg:"#FCFBF8",clusterBorder:PAPER.rule,titleColor:PAPER.ink,textColor:PAPER.ink,lineColor:PAPER.leadSoft,edgeLabelBackground:PAPER.sheet,actorBkg:PAPER.stone,actorBorder:PAPER.ruleMid,actorTextColor:PAPER.ink,actorLineColor:PAPER.ruleMid,signalColor:PAPER.lead,signalTextColor:PAPER.ink,labelBoxBkgColor:PAPER.stone,labelBoxBorderColor:PAPER.ruleMid,noteBkgColor:"#FBF3DB",noteBorderColor:"#E9D9A6",noteTextColor:PAPER.ink,sectionBkgColor:PAPER.stone,altSectionBkgColor:PAPER.sheet,sectionBkgColor2:PAPER.stone,gridColor:PAPER.rule,taskBkgColor:tint(r,.35),taskBorderColor:tint(r,.8),taskTextColor:PAPER.ink,taskTextLightColor:PAPER.ink,taskTextOutsideColor:PAPER.ink,activeTaskBkgColor:tint(r,.18),activeTaskBorderColor:tint(r,.8),doneTaskBkgColor:PAPER.stone2,doneTaskBorderColor:PAPER.ruleMid,critBkgColor:tint("#D6403A",.3),critBorderColor:"#D6403A",...n,...l,pieStrokeColor:PAPER.sheet,pieOuterStrokeColor:PAPER.rule,pieTitleTextColor:PAPER.ink,pieSectionTextColor:PAPER.ink,pieLegendTextColor:PAPER.ink}}}

package/dist/node_modules/@allyhub/doc/dist/parse.d.ts

@@ -0,0 +1,24 @@
+import { type Doc } from "./model.js";
+/** The tag that holds one block with its look and the blocks under it. */
+export declare const BLOCK_TAG = "Block";
+/** The tag of a line set apart, with a sign before it. */
+export declare const CALLOUT_TAG = "Callout";
+/** The tag around a table that says how its columns and its head are. */
+export declare const TABLE_TAG = "Table";
+/** A component drawn by code in a frame: `<Component of="../ui.ts#Dialog" width="760" step="start" />`. */
+export declare const COMPONENT_TAG = "Component";
+/** A component block's own attributes; any other is one of its props. */
+export declare const COMPONENT_ATTRIBUTES: readonly ["of", "width", "height", "at", "alt", "title", "align"];
+/** Where a page ends on paper and in Word: `<PageBreak />`. */
+export declare const PAGE_BREAK_TAG = "PageBreak";
+/** Blocks side by side: `<Columns>` around two or more `<Column>`. */
+export declare const COLUMNS_TAG = "Columns";
+/** One column of `<Columns>`, its blocks inside it: `<Column width="2">`. */
+export declare const COLUMN_TAG = "Column";
+/** A chart drawn from its numbers: `<Chart type="line">` around a table, or `<Chart type="line" data="…" />`. */
+export declare const CHART_TAG = "Chart";
+/** A chart's attributes. */
+export declare const CHART_ATTRIBUTES: readonly ["type", "title", "data", "categories", "series", "legend", "labels", "format", "min", "max", "colors", "width", "height", "alt"];
+/** Reads doc.mdx: its blocks, where each stretch of them is, and what is wrong. */
+export declare function parseDoc(source: string): Doc;
+//# sourceMappingURL=parse.d.ts.map

package/dist/node_modules/@allyhub/doc/dist/parse.js

@@ -0,0 +1,5 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{CHART_LEGEND_POSITIONS as Y,SHEET_CHART_TYPES as L}from"@allyhub/formats";import{fromMarkdown as q}from"mdast-util-from-markdown";import{frontmatterFromMarkdown as K}from"mdast-util-frontmatter";import{gfmFootnoteFromMarkdown as W}from"mdast-util-gfm-footnote";import{gfmStrikethroughFromMarkdown as z}from"mdast-util-gfm-strikethrough";import{gfmTableFromMarkdown as X}from"mdast-util-gfm-table";import{gfmTaskListItemFromMarkdown as Q}from"mdast-util-gfm-task-list-item";import{mdxFromMarkdown as V}from"mdast-util-mdx";import{frontmatter as Z}from"micromark-extension-frontmatter";import{gfmFootnote as x}from"micromark-extension-gfm-footnote";import{gfmStrikethrough as ee}from"micromark-extension-gfm-strikethrough";import{gfmTable as te}from"micromark-extension-gfm-table";import{gfmTaskListItem as ne}from"micromark-extension-gfm-task-list-item";import{mdxjs as re}from"micromark-extension-mdxjs";import{parse as ie}from"yaml";import{CHART_LABELS as I,PAGE_FONTS as P}from"./model.js";export const BLOCK_TAG="Block",CALLOUT_TAG="Callout",TABLE_TAG="Table",COMPONENT_TAG="Component",COMPONENT_ATTRIBUTES=["of","width","height","at","alt","title","align"],PAGE_BREAK_TAG="PageBreak",COLUMNS_TAG="Columns",COLUMN_TAG="Column",CHART_TAG="Chart",CHART_ATTRIBUTES=["type","title","data","categories","series","legend","labels","format","min","max","colors","width","height","alt"];const A=t=>t.split(",").map(e=>e.trim()).filter(e=>e!==""),H=new Set(["center","right","justify"]),b=(t,e)=>{const n=e.position?.start.offset,r=e.position?.end.offset;return n===void 0||r===void 0?"":t.source.slice(n,r)};function a(t,e,n){const r=e.position?.start;t.problems.push({message:n,...r?{line:r.line,column:r.column}:{}})}const oe=(t,e)=>t.bold===e.bold&&t.italic===e.italic&&t.underline===e.underline&&t.strike===e.strike&&t.code===e.code&&t.color===e.color&&t.background===e.background;function $(t,e,n,r){if(e==="")return;const i=t.at(-1);if(i&&i.note===void 0&&i.href===r&&oe(i.styles,n)){i.text+=e;return}t.push({text:e,styles:{...n},...r===void 0?{}:{href:r}})}function k(t,e,n){const r=new Map;for(const i of e.attributes){if(i.type!=="mdxJsxAttribute"||!n.includes(i.name)){a(t,e,`<${e.name??""}> takes ${n.join(", ")}: ${i.type==="mdxJsxAttribute"?i.name:"{…}"} is not one of them`);continue}i.value===null||i.value===void 0?r.set(i.name,""):typeof i.value=="string"?r.set(i.name,i.value):a(t,e,`${i.name} of <${e.name??""}> is a plain string`)}return r}function se(t,e,n){switch(e.name){case"u":return{...n,underline:!0};case"strong":case"b":return{...n,bold:!0};case"em":case"i":return{...n,italic:!0};case"del":case"s":return{...n,strike:!0};case"code":return{...n,code:!0};case"span":{const r=k(t,e,["color","bg"]),i=r.get("color"),o=r.get("bg");return{...n,...i?{color:i}:{},...o?{background:o}:{}}}default:return}}function v(t,e,n,r,i){for(const o of e)switch(o.type){case"text":for(const[,s]of o.value.matchAll(/\[\^([^\]\s]+)\]/gu))a(t,o,`the footnote [^${s??""}] has no note: write [^${s??""}]: … on a line of its own`);$(i,o.value.replace(/\r?\n/g," "),n,r);break;case"strong":v(t,o.children,{...n,bold:!0},r,i);break;case"emphasis":v(t,o.children,{...n,italic:!0},r,i);break;case"delete":v(t,o.children,{...n,strike:!0},r,i);break;case"inlineCode":$(i,o.value,{...n,code:!0},r);break;case"break":$(i,`
+`,n,r);break;case"link":v(t,o.children,n,o.url,i);break;case"footnoteReference":{const s=o.label??o.identifier;i.push({text:s,styles:{...n},...r===void 0?{}:{href:r},note:s});break}case"mdxJsxTextElement":{if(o.name==="br"){$(i,`
+`,n,r);break}const s=se(t,o,n);if(s){v(t,o.children,s,r,i);break}a(t,o,`<${o.name??""}> inside a line is not drawn: a tag the doc's code draws goes on lines of its own`),$(i,b(t,o),n,r);break}case"mdxTextExpression":a(t,o,"{…} in a line is not drawn: write \\{ for a brace"),$(i,b(t,o),n,r);break;default:a(t,o,`${o.type} is not drawn in a doc`),$(i,b(t,o),n,r)}}function M(t,e){const n=[];return v(t,e,{},void 0,n),n}const U=t=>t?.type==="mdxJsxFlowElement"&&t.name==="br"&&t.children.length===0;function j(t,e){const[n,...r]=e;if(n?.type==="paragraph"){const i=M(t,n.children);return{content:i.length===1&&i[0]?.text===`
+`&&Object.keys(i[0].styles).length===0?[]:i,under:E(t,r)}}return U(n)?{content:[],under:E(t,r)}:{content:[],under:E(t,e)}}const N=(t,e)=>e.length>0?{...t,children:e}:t;function ae(t,e,n,r){const{content:i,under:o}=j(t,e.children);return typeof e.checked=="boolean"?N({type:"check",checked:e.checked,content:i},o):N(n?{type:"numbered",...r===void 0||r===1?{}:{start:r},content:i}:{type:"bullet",content:i},o)}function le(t,e){return e.children.map(n=>M(t,n.children))}function g(t,e){return e?{[t]:e}:{}}function ce(t,e){const n=k(t,e,["align","color","bg","toggle"]),r=E(t,e.children),[i,...o]=r;if(i===void 0)return a(t,e,`<${BLOCK_TAG}> holds a block: this one is empty`),[];if(i.type==="embed"||i.type==="source")return a(t,e,`<${BLOCK_TAG}> holds a block of the doc's own, not a tag or an import`),r;const s=n.get("align");s!==void 0&&!H.has(s)&&a(t,e,`align is center, right or justify, not "${s}"`);const d={...s!==void 0&&H.has(s)?{align:s}:{},...g("color",n.get("color")),...g("background",n.get("bg"))};let l=i;if(n.has("toggle")&&(l.type==="heading"?l={...l,toggle:!0}:l.type==="paragraph"?l={type:"toggle",content:l.content}:a(t,e,"toggle is for a heading or a line of text")),Object.keys(d).length>0&&("content"in l?l={...l,look:d}:a(t,e,`a ${l.type} has no look to set`)),o.length>0)if("content"in l)l={...l,children:[...l.children??[],...o]};else return a(t,e,`a ${l.type} holds no blocks under it`),[l,...o];return[l]}function ue(t,e){const n=k(t,e,["icon","color","bg"]),{content:r,under:i}=j(t,e.children),o={...g("color",n.get("color")),...g("background",n.get("bg"))};return[N({type:"callout",...g("icon",n.get("icon")),...Object.keys(o).length>0?{look:o}:{},content:r},i)]}function fe(t,e){const n=k(t,e,["src","alt","title","width","align"]),r=n.get("src");if(!r)return a(t,e,"<img> names its picture: src is missing"),[];const i=Number(n.get("width")),o=n.get("align");return o!==void 0&&o!=="center"&&o!=="right"&&a(t,e,`a picture's align is center or right, not "${o}"`),[{type:"image",src:r,...g("alt",n.get("alt")),...g("caption",n.get("title")),...Number.isFinite(i)&&i>0?{width:Math.round(i)}:{},...o==="center"||o==="right"?{align:o}:{}}]}function de(t,e){if(e.children.length>0)return a(t,e,`<${COMPONENT_TAG}> holds nothing: its props are its attributes`),[];const n=new Map,r={};for(const c of e.attributes){if(c.type!=="mdxJsxAttribute"){a(t,e,`<${COMPONENT_TAG}>'s attributes are plain strings, not {…}`);continue}const u=c.value===null||c.value===void 0?"":typeof c.value=="string"?c.value:void 0;if(u===void 0){a(t,e,`${c.name} of <${COMPONENT_TAG}> is a plain string`);continue}COMPONENT_ATTRIBUTES.includes(c.name)?n.set(c.name,u):r[c.name]=u}const i=n.get("of")??"";if(i.trim()==="")return a(t,e,`<${COMPONENT_TAG}> names its component: of is missing (of="../ui.ts#Dialog")`),[];const o=c=>{const u=n.get(c);if(u===void 0)return;const p=Number(u);if(Number.isFinite(p)&&p>0)return Math.round(p);a(t,e,`${c} of <${COMPONENT_TAG}> is a number of pixels, not "${u}"`)},s=o("width"),d=o("height"),l=n.get("at"),f=l===void 0?void 0:Number(l);f!==void 0&&!(Number.isFinite(f)&&f>=0)&&a(t,e,`at of <${COMPONENT_TAG}> is seconds, 0 or more, not "${l??""}"`);const m=n.get("align");return m!==void 0&&m!=="center"&&m!=="right"&&a(t,e,`a component's align is center or right, not "${m}"`),[{type:"component",of:i,...s===void 0?{}:{width:s},...d===void 0?{}:{height:d},...f!==void 0&&Number.isFinite(f)&&f>=0?{at:f}:{},...g("alt",n.get("alt")),...g("caption",n.get("title")),...m==="center"||m==="right"?{align:m}:{},props:r}]}function me(t,e){const n=k(t,e,CHART_ATTRIBUTES),r=h=>{a(t,e,h)},i=n.get("type");if(i===void 0||i==="")return r(`<${CHART_TAG}> says what it is drawn as: type is missing (${L.join(", ")})`),[];if(!L.includes(i))return r(`a chart's type is ${L.join(", ")}, not "${i}"`),[];const o=e.children,[s,...d]=o;if(d.length>0||s!==void 0&&s.type!=="table")return r(`<${CHART_TAG}> holds one table: its numbers`),[];const l=s?.type==="table"?s.children.map(h=>h.children.map(y=>M(t,y.children).map(T=>T.text).join("").trim())):void 0,f=n.get("data"),m=n.get("categories"),c=n.get("series");if(l!==void 0&&f!==void 0)return r("a chart's numbers are its table or the file data names, not both"),[];if(l===void 0&&(f===void 0||f===""))return r(`<${CHART_TAG}> has numbers: a table inside it, or data="…" naming a file of them`),[];if(l!==void 0){(m!==void 0||c!==void 0)&&r("categories and series name a file's columns: a chart's own table has its series in its head row and its categories in its first column");const h=Math.min(...l.map(y=>y.length));(l.length<2||h<2)&&r("a chart's table has a head row and a row of numbers, a column of categories and a column of numbers")}else(m===void 0||m==="")&&r("with data, categories names the column of the categories"),(c===void 0||A(c).length===0)&&r('with data, series names the columns of the numbers (series="revenue,cost")');const u=n.get("legend"),p=[...Y,"none"];u!==void 0&&!p.includes(u)&&r(`a chart's legend is ${p.join(", ")}, not "${u}"`);const w=n.get("labels"),C=w===void 0?void 0:w===""?["value"]:A(w),S=C?.filter(h=>!I.includes(h));S?.length&&r(`a chart's labels are ${I.join(", ")}, not ${S.map(h=>`"${h}"`).join(", ")}`);const O=(h,y)=>{const T=n.get(h);if(T===void 0)return;const F=Number(T);if(T.trim()!==""&&Number.isFinite(F)&&(!y||F>0))return y?Math.round(F):F;r(`${h} of <${CHART_TAG}> is ${y?"a number of pixels":"a number"}, not "${T}"`)},G=O("min",!1),B=O("max",!1),J=O("width",!0),R=O("height",!0),_=n.get("colors");return[{type:"chart",kind:i,...g("title",n.get("title")),...l===void 0?{}:{table:l},...f===void 0||f===""?{}:{data:f},...l===void 0?g("categories",m):{},...l===void 0&&c!==void 0&&A(c).length>0?{series:A(c)}:{},...u!==void 0&&p.includes(u)?{legend:u}:{},...C!==void 0&&!S?.length?{labels:C}:{},...g("format",n.get("format")),...G===void 0?{}:{min:G},...B===void 0?{}:{max:B},..._!==void 0&&A(_).length>0?{colors:A(_)}:{},...J===void 0?{}:{width:J},...R===void 0?{}:{height:R},...g("alt",n.get("alt"))}]}function ge(t,e){k(t,e,[]);const n=[];for(const r of e.children){if(r.type!=="mdxJsxFlowElement"||r.name!==COLUMN_TAG)return a(t,r,`<${COLUMNS_TAG}> holds <${COLUMN_TAG}>s, each around its blocks`),[];const o=k(t,r,["width"]).get("width"),s=o===void 0?void 0:Number(o);o!==void 0&&!(Number.isFinite(s)&&(s??0)>0)&&a(t,r,`a column's width is a share against the others' (1, 2, 0.5), not "${o}"`);const d=E(t,r.children);if(d.some(l=>l.type==="columns"))return a(t,r,`a <${COLUMN_TAG}> holds no <${COLUMNS_TAG}>`),[];n.push({...s!==void 0&&Number.isFinite(s)&&s>0&&s!==1?{width:s}:{},blocks:d})}return n.length<2?(a(t,e,`<${COLUMNS_TAG}> holds two or more <${COLUMN_TAG}>s`),[]):[{type:"columns",columns:n}]}function he(t,e){const n=k(t,e,["widths","head"]),r=E(t,e.children),[i,...o]=r;if(i?.type!=="table"||o.length>0)return a(t,e,`<${TABLE_TAG}> holds one table`),r;const s=n.get("head");s!==void 0&&!["none","column","both","row"].includes(s)&&a(t,e,`a table's head is none, row, column or both, not "${s}"`);const d=n.get("widths")?.split(",").map(l=>{const f=Number(l.trim());return l.trim()!==""&&Number.isFinite(f)&&f>0?Math.round(f):null});return[{...i,...s==="none"||s==="column"||s==="both"?{head:s}:{},...d?.some(l=>l!==null)?{widths:d}:{}}]}function pe(t,e){switch(e.type){case"paragraph":{const n=e.children.length===1?e.children[0]:void 0;if(n?.type==="image")return[{type:"image",src:n.url,...n.alt?{alt:n.alt}:{},...n.title?{caption:n.title}:{}}];const r=M(t,e.children),i=r.map(o=>o.text).join("").trim();return i.startsWith("$$")&&i.endsWith("$$")&&i.length>4&&a(t,e,"$$ is not drawn in a doc: an equation is a ```math code block"),[{type:"paragraph",content:r}]}case"heading":return[{type:"heading",level:e.depth,content:M(t,e.children)}];case"list":{const n=e.ordered===!0;return e.children.map((r,i)=>ae(t,r,n,i===0&&n?e.start??void 0:void 0))}case"blockquote":{const{content:n,under:r}=j(t,e.children);return[N({type:"quote",content:n},r)]}case"code":return[{type:"code",...e.lang?{language:e.lang}:{},code:e.value}];case"table":return[{type:"table",rows:e.children.map(n=>le(t,n))}];case"thematicBreak":return[{type:"divider"}];case"mdxJsxFlowElement":{const n=r=>r.length>0?r:[{type:"embed",source:b(t,e)}];return e.name===BLOCK_TAG?n(ce(t,e)):e.name===TABLE_TAG?he(t,e):e.name===CALLOUT_TAG?ue(t,e):e.name===COMPONENT_TAG?n(de(t,e)):e.name===CHART_TAG?n(me(t,e)):e.name===COLUMNS_TAG?n(ge(t,e)):e.name===PAGE_BREAK_TAG?e.attributes.length>0||e.children.length>0?(a(t,e,`<${PAGE_BREAK_TAG} /> takes nothing`),n([])):[{type:"pagebreak"}]:e.name===COLUMN_TAG?(a(t,e,`a <${COLUMN_TAG}> stands inside <${COLUMNS_TAG}>`),n([])):e.name==="img"&&e.children.length===0?n(fe(t,e)):U(e)?[{type:"paragraph",content:[]}]:[{type:"embed",source:b(t,e)}]}case"footnoteDefinition":{const{content:n,under:r}=j(t,e.children);return[N({type:"note",label:e.label??e.identifier,content:n},r)]}case"mdxjsEsm":case"definition":return[{type:"source",source:b(t,e)}];case"mdxFlowExpression":return a(t,e,"{…} on its own is not drawn in a doc"),[{type:"source",source:b(t,e)}];default:return a(t,e,`${e.type} is not drawn in a doc`),[{type:"source",source:b(t,e)}]}}function D(t,e){return e.map((n,r)=>{const i=pe(t,n),o=e[r-1],s=i[0];return n.type==="list"&&n.ordered===!0&&o?.type==="list"&&o.ordered===!0&&s?.type==="numbered"&&s.start===void 0&&(i[0]={...s,start:n.start??1}),i})}function E(t,e){return D(t,e).flat()}export function parseDoc(t){const e={source:t,problems:[]};let n;try{n=q(t,{extensions:[Z(),re(),x(),te(),ee(),ne()],mdastExtensions:[K(),V(),W(),X(),z(),Q()]})}catch(c){const u=c;return{source:t,blocks:[],segments:[],page:{},problems:[{message:u.reason??u.message??"The file is not MDX",...typeof u.line=="number"?{line:u.line}:{},...typeof u.column=="number"?{column:u.column}:{}}]}}const[r]=n.children,i=r?.type==="yaml"?r:void 0,o=i?n.children.slice(1):n.children,s=i?be(e,i):{},d=[],l=D(e,o);o.forEach((c,u)=>{const p=c.position?.start.offset,w=c.position?.end.offset;p===void 0||w===void 0||d.push({start:p,end:w,blocks:l[u]??[]})});const f=i?.position?.start.offset,m=i?.position?.end.offset;return{source:t,blocks:d.flatMap(c=>c.blocks),segments:d,problems:e.problems,page:s,...f===void 0||m===void 0?{}:{frontMatter:{start:f,end:m}}}}function be(t,e){let n;try{n=ie(e.value)}catch(i){return a(t,e,`the front matter is not YAML: ${i instanceof Error?i.message:String(i)}`),{}}if(n==null)return{};if(typeof n!="object"||Array.isArray(n))return a(t,e,"the front matter holds keys: font, accent, cover, cover-y, page-numbers"),{};const r={};for(const[i,o]of Object.entries(n))i==="font"?P.includes(o)?r.font=o:a(t,e,`a page's font is ${P.join(", ")}, not ${JSON.stringify(o)}`):i==="cover"?typeof o=="string"&&o.trim()!==""?r.cover=o.trim():a(t,e,"a page's cover is a picture's path"):i==="cover-y"?typeof o=="number"&&o>=0&&o<=100?r.coverY=o:a(t,e,`a cover's cover-y is 0 (its top) to 100 (its bottom), not ${JSON.stringify(o)}`):i==="page-numbers"?o===!1?r.pageNumbers=!1:o!==!0&&a(t,e,`a page's page-numbers is true or false, not ${JSON.stringify(o)}`):i==="accent"?typeof o=="string"&&o.trim()!==""?r.accent=o.trim():a(t,e,"a page's accent is a colour"):a(t,e,`the front matter holds font, accent, cover, cover-y and page-numbers: ${i} is not one of them`);return r}

package/dist/node_modules/@allyhub/doc/dist/patch.js

@@ -0,0 +1,11 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{blockKey as K}from"./model.js";import{continuesList as L,writeBlocks as F}from"./write.js";export function patchDoc(f,g){const w=g.map(K),c=f.segments.map(e=>({...e,keys:e.blocks.map(K)})),d=c.length,p=w.length,M=(e,t)=>{const n=c[e]?.keys??[];return n.length>0&&t+n.length<=p&&n.every((l,u)=>w[t+u]===l)},v=Array.from({length:d+1},()=>new Array(p+1).fill(0)),k=(e,t)=>v[e]?.[t]??0;for(let e=d-1;e>=0;e--)for(let t=p;t>=0;t--){const n=c[e]?.keys.length??0;let l=Math.max(k(e+1,t),t<p?k(e,t+1):0);M(e,t)&&(l=Math.max(l,n+k(e+1,t+n)));const u=v[e];u&&(u[t]=l)}const s=[];let o=0,i=0,b=[];const j=()=>{b.length>0&&s.push({blocks:b}),b=[]};for(;o<d||i<p;){const e=c[o]?.keys.length??0;if(o<d&&M(o,i)&&k(o,i)===e+k(o+1,i+e))j(),s.push({kept:o}),i+=e,o++;else if(o<d&&k(o,i)===k(o+1,i))o++;else{const t=g[i];t&&b.push(t),i++}}j();const r=f.source,q=e=>{const t=c[e];return t!==void 0&&!r.slice(t.start,t.end).includes(`
+
+`)};for(let e=0;e<s.length;e++){const t=s[e];if(!t||!("kept"in t))continue;const n=c[t.kept]?.blocks??[],l=n[0],u=n.at(-1),m=s[e-1],y=s[e+1],D=m&&"blocks"in m?m.blocks.at(-1):void 0,E=y&&"blocks"in y?y.blocks[0]:void 0,z=D!==void 0&&l!==void 0&&L(D,l),C=E!==void 0&&u!==void 0&&L(u,E);(z||C)&&q(t.kept)&&(s[e]={blocks:[...n]})}for(let e=s.length-1;e>0;e--){const t=s[e],n=s[e-1];t&&n&&"blocks"in t&&"blocks"in n&&(n.blocks.push(...t.blocks),s.splice(e,1))}const A=c[0],$=c.at(-1),x=A?r.slice(0,A.start):f.frontMatter?`${r.slice(0,f.frontMatter.end)}
+
+`:"",B=$?r.slice($.end):r===""?"":`
+`;let a=x,h;return s.forEach((e,t)=>{if(t>0){const n=s[t-1],l="kept"in e&&n&&"kept"in n&&h!==void 0&&e.kept===h+1?r.slice(c[h]?.end??0,c[e.kept]?.start??0):`
+
+`;a+=l}if("kept"in e){const n=c[e.kept];n&&(a+=r.slice(n.start,n.end)),h=e.kept}else a+=F(e.blocks),h=void 0}),s.length===0&&f.frontMatter!==void 0?`${r.slice(0,f.frontMatter.end)}
+`:(f.frontMatter===void 0&&g[0]?.type==="divider"&&(a=a.replace(/^---[ \t]*(?=\n|$)/u,"***")),a+(B===""&&a!==""?`
+`:B))}

package/dist/node_modules/@allyhub/doc/dist/write.d.ts

@@ -0,0 +1,18 @@
+import type { Block, Doc, PageLook } from "./model.js";
+/** A page's look as front matter, the lines between its `---`; empty for the default look. */
+export declare function frontMatterOf(look: PageLook): string;
+/**
+ * The file with the page's look as `look` says: its front matter written
+ * again, added first, or taken out for the default look. The rest of the
+ * file keeps its bytes.
+ */
+export declare function withPage(doc: Pick<Doc, "source" | "frontMatter">, look: PageLook): string;
+/**
+ * Whether `b`, written right after `a`, is an item of the same list:
+ * bullets and tasks share one, numbers make their own, and a number of its
+ * own starts another (as writeBlocks writes them).
+ */
+export declare function continuesList(a: Block, b: Block): boolean;
+/** Blocks as doc.mdx: one after the other, an empty line between them. */
+export declare function writeBlocks(blocks: readonly Block[]): string;
+//# sourceMappingURL=write.d.ts.map