@mdanai/sdk 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MDAN
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,126 @@
+# @mdanai/sdk
+
+`@mdanai/sdk` is the reference SDK for building apps with MDAN.
+
+It officially supports Node and Bun through a shared server runtime plus runtime-specific host adapters.
+
+MDAN is a Markdown-first page and interaction format. `@mdanai/sdk` gives you the parser, server runtime, browser runtime, and default UI for working with it.
+
+## Why MDAN
+
+Plain Markdown is good for content, but weak at expressing interaction.
+
+Once a page needs inputs, actions, partial updates, or navigation, that structure usually gets pushed into templates, frontend state, and custom API glue.
+
+MDAN makes that interaction layer explicit while keeping the page source readable for humans, AI agents, and agentic systems.
+
+In MDAN, page content is not only presentation. It is also shared prompt context for AI agents.
+
+The same Markdown source can carry:
+
+- content for humans to read
+- state and task context for AI agents to interpret
+- explicit interaction structure for both sides to continue from
+
+The default server runtime keeps Markdown canonical while also supporting explicit `auto` `GET` dependencies. Server hosts resolve `auto` before returning results, so agents and browsers observe the same final state. See the protocol/runtime docs for the full rules.
+
+## Use Cases
+
+- skills apps with guided inputs and step-by-step actions for non-technical users
+- agent apps that agents can read, enter, and continue over HTTP
+- interactive docs, runbooks, and internal tools with embedded actions
+- shared pages where humans and agents work from the same content and next-step actions
+- agentic workflows where the server returns both updated results and the next actions to take
+- custom hosted interfaces built with React, Vue, or your own server stack
+
+## Syntax
+
+The starter page keeps Markdown content and the interaction block in the same file:
+
+```text
+---
+title: "Agent App"
+---
+
+# Agent App
+
+Use this starter as the smallest end-to-end MDAN app.
+
+<!-- mdan:block main -->
+
+BLOCK main {
+  INPUT text required -> message
+  GET "/list" -> load_messages auto
+  GET "/list" -> refresh label:"Refresh"
+  POST "/post" (message) -> submit label:"Submit"
+}
+```
+
+## Quick Start
+
+Node starter:
+
+```bash
+npm create mdan@latest agent-app
+cd agent-app
+npm install
+npm start
+```
+
+Bun starter:
+
+```bash
+bunx create-mdan agent-app
+cd agent-app
+bun install
+bun start
+```
+
+You can also force either runtime with `--runtime node` or `--runtime bun`.
+
+## Runtime Adapters
+
+Shared server modeling stays on `@mdanai/sdk/server`:
+
+```ts
+import { createHostedApp } from "@mdanai/sdk/server";
+```
+
+Then choose the host adapter for your runtime:
+
+```ts
+import { createHost } from "@mdanai/sdk/server/node";
+```
+
+```ts
+import { createHost } from "@mdanai/sdk/server/bun";
+```
+
+## Docs
+
+- [Getting Started](https://docs.mdan.ai/getting-started)
+- [Understanding MDAN](https://docs.mdan.ai/understanding-mdan)
+- [SDK Overview](https://docs.mdan.ai/sdk)
+- [Custom Rendering](https://docs.mdan.ai/custom-rendering)
+- [Web Runtime](https://docs.mdan.ai/web-runtime)
+- [API Reference](https://docs.mdan.ai/api-reference)
+
+## Browser Debugging
+
+If you want to inspect raw browser-side MDAN traffic while using the default UI or your own custom renderer, enable debug messages on the headless host:
+
+```ts
+import { createHeadlessHost } from "@mdanai/sdk/web";
+
+const host = createHeadlessHost({
+  root: document,
+  debugMessages: true
+});
+```
+
+When enabled:
+
+- the browser records outgoing and incoming MDAN messages
+- each record keeps the raw Markdown payload
+- messages are available at `window.__MDAN_DEBUG__.messages`
+- the default `elements` UI also shows a small debug drawer in the browser

package/dist/core/errors.d.ts

@@ -0,0 +1,14 @@
+export interface MdanSourceLocation {
+    line: number;
+    column: number;
+}
+declare class MdanBaseError extends Error {
+    readonly location: MdanSourceLocation | undefined;
+    constructor(message: string, location?: MdanSourceLocation);
+}
+export declare class MdanParseError extends MdanBaseError {
+}
+export declare class MdanValidationError extends MdanBaseError {
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,cAAM,aAAc,SAAQ,KAAK;IAC/B,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,GAAG,SAAS,CAAC;gBAEtC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,kBAAkB;CAK3D;AAED,qBAAa,cAAe,SAAQ,aAAa;CAAG;AAEpD,qBAAa,mBAAoB,SAAQ,aAAa;CAAG"}

package/dist/core/errors.js

@@ -0,0 +1,13 @@
+class MdanBaseError extends Error {
+    location;
+    constructor(message, location) {
+        super(message);
+        this.name = new.target.name;
+        this.location = location;
+    }
+}
+export class MdanParseError extends MdanBaseError {
+}
+export class MdanValidationError extends MdanBaseError {
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAKA,MAAM,aAAc,SAAQ,KAAK;IACtB,QAAQ,CAAiC;IAElD,YAAY,OAAe,EAAE,QAA6B;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,aAAa;CAAG;AAEpD,MAAM,OAAO,mBAAoB,SAAQ,aAAa;CAAG"}

package/dist/core/index.d.ts

@@ -0,0 +1,16 @@
+import type { MdanComposedPage, MdanPage } from "./types.js";
+export * from "./errors.js";
+export * from "./markdown-renderer.js";
+export * from "./markdown-body.js";
+export * from "./negotiate.js";
+export * from "./serialize.js";
+export * from "./types.js";
+export * from "./validate.js";
+export interface ComposePageOptions {
+    blocks?: Record<string, string>;
+    visibleBlocks?: string[];
+}
+export declare function parsePage(source: string): MdanPage;
+export declare function parseAndValidatePage(source: string): MdanPage;
+export declare function composePage(source: string, options?: ComposePageOptions): MdanComposedPage;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAgB,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3E,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAE9B,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAgBlD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAE7D;AAaD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,gBAAgB,CAS9F"}

package/dist/core/index.js

@@ -0,0 +1,69 @@
+import { MdanParseError } from "./errors.js";
+import { parseAnchors } from "./parse/anchors.js";
+import { parseBlocks } from "./parse/block-parser.js";
+import { extractExecutableBlock } from "./parse/executable-block.js";
+import { parseFrontmatter } from "./parse/frontmatter.js";
+import { validatePage } from "./validate.js";
+export * from "./errors.js";
+export * from "./markdown-renderer.js";
+export * from "./markdown-body.js";
+export * from "./negotiate.js";
+export * from "./serialize.js";
+export * from "./types.js";
+export * from "./validate.js";
+export function parsePage(source) {
+    const { frontmatter, body } = parseFrontmatter(source);
+    const { markdown, executableContent } = extractExecutableBlock(body);
+    try {
+        return {
+            frontmatter,
+            markdown,
+            blocks: parseBlocks(executableContent),
+            blockAnchors: parseAnchors(markdown)
+        };
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw error;
+        }
+        throw new MdanParseError("Unknown parse failure.");
+    }
+}
+export function parseAndValidatePage(source) {
+    return validatePage(parsePage(source));
+}
+function attachFragmentHelper(page) {
+    const composed = page;
+    Object.defineProperty(composed, "fragment", {
+        value(blockName) {
+            return resolveFragmentForBlock(composed, blockName);
+        },
+        enumerable: false
+    });
+    return composed;
+}
+export function composePage(source, options = {}) {
+    const page = parseAndValidatePage(source);
+    if (options.blocks) {
+        page.blockContent = { ...options.blocks };
+    }
+    if (options.visibleBlocks) {
+        page.visibleBlockNames = [...options.visibleBlocks];
+    }
+    return attachFragmentHelper(page);
+}
+function resolveFragmentForBlock(page, blockName) {
+    const block = page.blocks.find((candidate) => candidate.name === blockName);
+    if (!block) {
+        throw new Error(`Unknown block "${blockName}".`);
+    }
+    const markdown = page.blockContent?.[blockName];
+    if (!markdown?.trim()) {
+        throw new Error(`Block "${blockName}" has no composed markdown content.`);
+    }
+    return {
+        markdown,
+        blocks: [block]
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"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"}

package/dist/core/markdown-body.d.ts

@@ -0,0 +1,3 @@
+export declare function parseMarkdownBody(body: string): Record<string, string>;
+export declare function serializeMarkdownBody(values: Record<string, string>): string;
+//# sourceMappingURL=markdown-body.d.ts.map

package/dist/core/markdown-body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-body.d.ts","sourceRoot":"","sources":["../../src/core/markdown-body.ts"],"names":[],"mappings":"AA+CA,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqBtE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAI5E"}

package/dist/core/markdown-body.js

@@ -0,0 +1,65 @@
+import { MdanParseError } from "./errors.js";
+function splitMarkdownBody(body) {
+    const parts = [];
+    let current = "";
+    let inString = false;
+    let escaped = false;
+    for (const char of body) {
+        if (escaped) {
+            current += char;
+            escaped = false;
+            continue;
+        }
+        if (char === "\\") {
+            current += char;
+            escaped = true;
+            continue;
+        }
+        if (char === "\"") {
+            current += char;
+            inString = !inString;
+            continue;
+        }
+        if (!inString && (char === "," || char === "\n")) {
+            const trimmed = current.trim();
+            if (trimmed) {
+                parts.push(trimmed);
+            }
+            current = "";
+            continue;
+        }
+        current += char;
+    }
+    const trimmed = current.trim();
+    if (trimmed) {
+        parts.push(trimmed);
+    }
+    return parts;
+}
+export function parseMarkdownBody(body) {
+    const result = {};
+    for (const part of splitMarkdownBody(body)) {
+        const match = part.match(/^([a-zA-Z_][\w-]*)\s*:\s*(.+)$/);
+        if (!match) {
+            throw new MdanParseError(`Invalid markdown body line: ${part}`);
+        }
+        let value;
+        try {
+            value = JSON.parse(match[2].trim());
+        }
+        catch {
+            throw new MdanParseError(`Invalid markdown body line: ${part}`);
+        }
+        if (typeof value !== "string") {
+            throw new MdanParseError(`Invalid markdown body line: ${part}`);
+        }
+        result[match[1]] = value;
+    }
+    return result;
+}
+export function serializeMarkdownBody(values) {
+    return Object.entries(values)
+        .map(([key, value]) => `${key}: ${JSON.stringify(value)}`)
+        .join(", ");
+}
+//# sourceMappingURL=markdown-body.js.map

package/dist/core/markdown-body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-body.js","sourceRoot":"","sources":["../../src/core/markdown-body.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,SAAS,iBAAiB,CAAC,IAAY;IACrC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,IAAI,IAAI,CAAC;YAChB,OAAO,GAAG,KAAK,CAAC;YAChB,SAAS;QACX,CAAC;QAED,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO,IAAI,IAAI,CAAC;YAChB,OAAO,GAAG,IAAI,CAAC;YACf,SAAS;QACX,CAAC;QAED,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO,IAAI,IAAI,CAAC;YAChB,QAAQ,GAAG,CAAC,QAAQ,CAAC;YACrB,SAAS;QACX,CAAC;QAED,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACjD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;YAC/B,IAAI,OAAO,EAAE,CAAC;gBACZ,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACtB,CAAC;YACD,OAAO,GAAG,EAAE,CAAC;YACb,SAAS;QACX,CAAC;QAED,OAAO,IAAI,IAAI,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAC3D,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,cAAc,CAAC,+BAA+B,IAAI,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,IAAI,KAAc,CAAC;QACnB,IAAI,CAAC;YACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,cAAc,CAAC,+BAA+B,IAAI,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,cAAc,CAAC,+BAA+B,IAAI,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,GAAG,KAAK,CAAC;IAC5B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAA8B;IAClE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;SAC1B,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;SACzD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/core/markdown-renderer.d.ts

@@ -0,0 +1,5 @@
+export interface MdanMarkdownRenderer {
+    render(markdown: string): string;
+}
+export declare const basicMarkdownRenderer: MdanMarkdownRenderer;
+//# sourceMappingURL=markdown-renderer.d.ts.map

package/dist/core/markdown-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-renderer.d.ts","sourceRoot":"","sources":["../../src/core/markdown-renderer.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;CAClC;AAoED,eAAO,MAAM,qBAAqB,EAAE,oBAiBnC,CAAC"}

package/dist/core/markdown-renderer.js

@@ -0,0 +1,75 @@
+function escapeHtml(value) {
+    return value
+        .replaceAll("&", "&")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;");
+}
+function parseRenderableMarkdown(markdown) {
+    const lines = markdown.split("\n");
+    const visible = [];
+    let inFrontmatter = false;
+    let frontmatterHandled = false;
+    let inCode = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!frontmatterHandled && trimmed === "---") {
+            inFrontmatter = !inFrontmatter;
+            if (!inFrontmatter) {
+                frontmatterHandled = true;
+            }
+            continue;
+        }
+        if (inFrontmatter) {
+            continue;
+        }
+        if (trimmed.startsWith("```")) {
+            inCode = !inCode;
+            continue;
+        }
+        if (inCode || trimmed.startsWith("<!-- mdan:block")) {
+            continue;
+        }
+        visible.push(line);
+    }
+    return visible
+        .join("\n")
+        .split(/\n{2,}/)
+        .map((chunk) => chunk.trim())
+        .filter(Boolean)
+        .map((chunk) => {
+        const rows = chunk.split("\n").map((row) => row.trim()).filter(Boolean);
+        if (rows.every((row) => row.startsWith("- "))) {
+            return {
+                type: "ul",
+                items: rows.map((row) => row.slice(2).trim())
+            };
+        }
+        if (chunk.startsWith("# ")) {
+            return { type: "h1", text: chunk.slice(2).trim() };
+        }
+        if (chunk.startsWith("## ")) {
+            return { type: "h2", text: chunk.slice(3).trim() };
+        }
+        return { type: "p", text: rows.join(" ") };
+    });
+}
+export const basicMarkdownRenderer = {
+    render(markdown) {
+        return parseRenderableMarkdown(markdown)
+            .map((node) => {
+            if (node.type === "h1") {
+                return `<h1>${escapeHtml(node.text)}</h1>`;
+            }
+            if (node.type === "h2") {
+                return `<h2>${escapeHtml(node.text)}</h2>`;
+            }
+            if (node.type === "p") {
+                return `<p>${escapeHtml(node.text)}</p>`;
+            }
+            return `<ul>${node.items.map((item) => `<li>${escapeHtml(item)}</li>`).join("")}</ul>`;
+        })
+            .join("\n");
+    }
+};
+//# sourceMappingURL=markdown-renderer.js.map

package/dist/core/markdown-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-renderer.js","sourceRoot":"","sources":["../../src/core/markdown-renderer.ts"],"names":[],"mappings":"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"}

package/dist/core/negotiate.d.ts

@@ -0,0 +1,3 @@
+import type { MdanRepresentation } from "./types.js";
+export declare function negotiateRepresentation(acceptHeader?: string): MdanRepresentation;
+//# sourceMappingURL=negotiate.d.ts.map

package/dist/core/negotiate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"negotiate.d.ts","sourceRoot":"","sources":["../../src/core/negotiate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAuBrD,wBAAgB,uBAAuB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,kBAAkB,CA0DjF"}

package/dist/core/negotiate.js

@@ -0,0 +1,63 @@
+function parseAcceptHeader(acceptHeader) {
+    return acceptHeader
+        .split(",")
+        .map((part) => part.trim())
+        .filter(Boolean)
+        .map((part) => {
+        const [mediaType = "", ...params] = part.split(";").map((value) => value.trim());
+        const qParam = params.find((value) => value.startsWith("q="));
+        const q = qParam ? Number(qParam.slice(2)) : 1;
+        return {
+            mediaType: mediaType.toLowerCase(),
+            q: Number.isFinite(q) ? q : 1
+        };
+    });
+}
+export function negotiateRepresentation(acceptHeader) {
+    if (!acceptHeader) {
+        return "html";
+    }
+    const accepted = parseAcceptHeader(acceptHeader);
+    const weightByRepresentation = {
+        "event-stream": 0,
+        markdown: 0,
+        html: 0
+    };
+    for (const entry of accepted) {
+        if (entry.q <= 0) {
+            continue;
+        }
+        if (entry.mediaType === "text/event-stream") {
+            weightByRepresentation["event-stream"] = Math.max(weightByRepresentation["event-stream"], entry.q);
+            continue;
+        }
+        if (entry.mediaType === "text/markdown") {
+            weightByRepresentation.markdown = Math.max(weightByRepresentation.markdown, entry.q);
+            continue;
+        }
+        if (["text/html", "text/*", "*/*"].includes(entry.mediaType)) {
+            weightByRepresentation.html = Math.max(weightByRepresentation.html, entry.q);
+        }
+    }
+    const candidates = Object.entries(weightByRepresentation).filter(([, weight]) => weight > 0);
+    if (candidates.length === 0) {
+        return "not-acceptable";
+    }
+    const tieBreaker = {
+        "event-stream": 3,
+        markdown: 2,
+        html: 1
+    };
+    candidates.sort((left, right) => {
+        if (right[1] !== left[1]) {
+            return right[1] - left[1];
+        }
+        return tieBreaker[right[0]] - tieBreaker[left[0]];
+    });
+    const winner = candidates[0]?.[0];
+    if (!winner) {
+        return "not-acceptable";
+    }
+    return winner;
+}
+//# sourceMappingURL=negotiate.js.map

package/dist/core/negotiate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"negotiate.js","sourceRoot":"","sources":["../../src/core/negotiate.ts"],"names":[],"mappings":"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"}

package/dist/core/parse/anchors.d.ts

@@ -0,0 +1,2 @@
+export declare function parseAnchors(markdown: string): string[];
+//# sourceMappingURL=anchors.d.ts.map

package/dist/core/parse/anchors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchors.d.ts","sourceRoot":"","sources":["../../../src/core/parse/anchors.ts"],"names":[],"mappings":"AAIA,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CA0BvD"}

package/dist/core/parse/anchors.js

@@ -0,0 +1,26 @@
+import { MdanParseError } from "../errors.js";
+const anchorPattern = /<!--\s*mdan:block\s+([a-zA-Z_][\w-]*)\s*-->/g;
+export function parseAnchors(markdown) {
+    const anchors = [];
+    const lines = markdown.split("\n");
+    let insideFence = false;
+    for (const line of lines) {
+        if (/^```/.test(line.trim())) {
+            insideFence = !insideFence;
+            continue;
+        }
+        if (insideFence) {
+            continue;
+        }
+        const matches = [...line.matchAll(anchorPattern)];
+        for (const match of matches) {
+            const name = match[1];
+            if (!name) {
+                throw new MdanParseError("Encountered malformed block anchor.");
+            }
+            anchors.push(name);
+        }
+    }
+    return anchors;
+}
+//# sourceMappingURL=anchors.js.map

package/dist/core/parse/anchors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchors.js","sourceRoot":"","sources":["../../../src/core/parse/anchors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,aAAa,GAAG,8CAA8C,CAAC;AAErE,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,WAAW,GAAG,KAAK,CAAC;IAExB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAC7B,WAAW,GAAG,CAAC,WAAW,CAAC;YAC3B,SAAS;QACX,CAAC;QAED,IAAI,WAAW,EAAE,CAAC;YAChB,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;QAClD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,cAAc,CAAC,qCAAqC,CAAC,CAAC;YAClE,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/core/parse/block-parser.d.ts

@@ -0,0 +1,3 @@
+import type { MdanBlock } from "../types.js";
+export declare function parseBlocks(source: string): MdanBlock[];
+//# sourceMappingURL=block-parser.d.ts.map

package/dist/core/parse/block-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-parser.d.ts","sourceRoot":"","sources":["../../../src/core/parse/block-parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAA4B,MAAM,aAAa,CAAC;AA6EvE,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CA0DvD"}