mdeval 1.5.0 → 2.0.0

package/README.md

@@ -3,14 +3,9 @@
 </p>
 <h1 align="center">mdeval</h1>
 
-Ever wanted dynamic values in your Markdown — package versions, star counts, computed tables — without a separate generation script that's easy to forget about?
+mdeval runs JavaScript or TypeScript written in HTML comments inside your Markdown, and writes the results back into the file. The code sits next to the content it produces. The file renders normally on GitHub and in any editor, because HTML comments are invisible.
 
-mdeval embeds JavaScript directly in your Markdown using HTML comments. The logic lives right next to the content it produces, and the file renders normally everywhere — GitHub, editors, any Markdown viewer — because HTML comments are invisible.
-
-Any value that matters — a dependency count, a version string, a benchmark result — is computed, not typed. Whether written by a person or an AI agent, the expression shows the work and anyone can verify it. Re-run `mdeval` and every value updates.
-
-> [!TIP]
-> Particularly useful for **knowledge bases** — contact lists, project trackers, changelogs, or any Markdown that functions as a source of truth. Values stay accurate on every run, so nothing drifts. AI agents reading the files also benefit: pre-computed values mean they don't need to re-process raw data across multiple documents, cutting token usage significantly.
+Values such as a version string, a dependency count, or a benchmark result are computed, not typed by hand, so anyone can check where they came from. Run `mdeval` again and every value updates. This also works well for Markdown knowledge bases, such as contact lists or project trackers, where files share data.
 
 ## Install
 
@@ -20,9 +15,7 @@ npm i mdeval
 
 ## Quick start
 
-mdeval adds two types of HTML comments to your Markdown:
-
-A **script block** is where you write JavaScript. It starts with `<!--mdeval` followed by a newline:
+A **script block** holds code. It starts with `<!--mdeval` followed by a newline:
 
 ```markdown
 <!--mdeval
@@ -31,255 +24,178 @@ const pkg = JSON.parse(await fs.readFile('package.json', 'utf8'));
 -->
 ```
 
-Script blocks support:
+Script blocks are ES modules with full Node.js access: imports, top-level `await`, and any installed package.
 
-- Full Node.js — any built-in module or installed package
-- ESM `import` / `export`
-- Top-level `await`
-- Shell commands via [`$`](https://google.github.io/zx/)
-
-A **value marker** is where the result appears. It starts with `<!--mdeval ` (with a space) followed by a JavaScript expression:
+A **value marker** shows a result. It starts with `<!--mdeval ` (with a space) followed by an expression. The text between `-->` and `<!--/mdeval-->` is the current value:
 
 ```markdown
 Version: <!--mdeval pkg.version-->1.0.0<!--/mdeval-->
 ```
 
-The `1.0.0` between `-->` and `<!--/mdeval-->` is the current value — it gets overwritten with the result of `pkg.version` every time you run mdeval:
+Run mdeval to replace each value with the result of its expression:
 
 ```bash
 mdeval README.md
 ```
 
-The file is updated in-place. You can pass multiple files or glob patterns: `mdeval README.md "docs/**/*.md"`.
-
-`node_modules` and hidden directories are automatically excluded from glob expansion.
-
 ## Example
 
-**`CONTACTS.md`** — a contact list stored as data, rendered as a table when viewed:
+**`CONTACTS.md`** stores contacts as data and renders them as a table, using [md-pen](https://github.com/privatenumber/md-pen) to generate Markdown:
 
 ````markdown
 <!--mdeval
 import { table, link } from 'md-pen';
 
-export const contacts = [
-  {
-    name: 'Alice Martin',
-    linkedin: 'https://linkedin.com/in/alice-martin',
-    notes: 'Met at JSConf 2023',
-  },
-  {
-    name: 'Bob Tanaka',
-    linkedin: 'https://linkedin.com/in/bob-tanaka',
-    notes: 'Former colleague at Acme Co.',
-  },
-];
-
-export const findContact = name => contacts.find(c => c.name === name);
+type Contact = {
+  name: string;
+  linkedin: string;
+};
 
-const contactsTable = table(
-  contacts.map(({ name, linkedin, notes }) => ({ Name: link(linkedin, name), Notes: notes })),
-);
+export const contacts: Contact[] = [
+  { name: 'Alice Martin', linkedin: 'https://linkedin.com/in/alice-martin' },
+  { name: 'Bob Tanaka', linkedin: 'https://linkedin.com/in/bob-tanaka' },
+];
 -->
 
-<!--mdeval block(contactsTable)-->
-| Name | Notes |
-| - | - |
-| [Alice Martin](https://linkedin.com/in/alice-martin) | Met at JSConf 2023 |
-| [Bob Tanaka](https://linkedin.com/in/bob-tanaka) | Former colleague at Acme Co. |
+<!--mdeval block(table(contacts.map(({ name, linkedin }) => ({ Name: link(linkedin, name) }))))-->
+| Name |
+| - |
+| [Alice Martin](https://linkedin.com/in/alice-martin) |
+| [Bob Tanaka](https://linkedin.com/in/bob-tanaka) |
 <!--/mdeval-->
 ````
 
-**`TIMELINE.md`** — imports contacts and links them by LinkedIn:
+**`TIMELINE.md`** imports the contacts from `CONTACTS.md`:
 
 ````markdown
 <!--mdeval
-import { link, ul, bold } from 'md-pen';
+import { link } from 'md-pen';
+import { contacts } from './CONTACTS.md';
 
-// Imports from the mdeval block!
-import { findContact } from './CONTACTS.md';
-
-const events = [
-  { date: '2023-10-15', description: 'Attended JSConf 2023' },
-  { date: '2024-03-01', description: `Coffee with ${link(findContact('Alice Martin').linkedin, 'Alice Martin')}` },
-  { date: '2024-11-08', description: 'Started new open-source project' },
-];
-
-const list = ul(events.map(({ date, description }) => `${bold(date)} — ${description}`));
+const alice = contacts.find(contact => contact.name === 'Alice Martin')!;
 -->
 
-<!--mdeval block(list)-->
-- __2023-10-15__ — Attended JSConf 2023
-- __2024-03-01__ — Coffee with [Alice Martin](https://linkedin.com/in/alice-martin)
-- __2024-11-08__ — Started new open-source project
-<!--/mdeval-->
+- 2024-03-01: Coffee with <!--mdeval link(alice.linkedin, alice.name)-->[Alice Martin](https://linkedin.com/in/alice-martin)<!--/mdeval-->
 ````
 
-The source of truth for contacts live in `CONTACTS.md`. If contact info changes, run `mdeval **/*.md` and all files get re-rendered with the latest data.
-
-## Helpers
-
-mdeval ships two helpers used in markers:
-
-| Helper | Description |
-|--------|-------------|
-| `block(value)` | Wraps the value with surrounding newlines so block-level Markdown (headings, lists, tables) renders correctly |
-| `$` | [zx](https://google.github.io/zx/) shell — run commands via tagged templates |
-
-How you access them depends on the file extension:
-
-| File | Access |
-|------|--------|
-| `.md` | Available as globals — call directly: `block(x)` or `` $`cmd` `` |
-| `.js`, `.ts`, anything else | Import explicitly: `import { block, $ } from 'mdeval'` |
-
-The `.md` case works because the CLI (and `--import mdeval/loader`) seeds the helpers on `globalThis` at startup. Modules imported transitively from a `.md` see them too, but in non-`.md` files prefer the explicit import for clarity and portability. The plain `import { block, $ } from 'mdeval'` is side-effect-free — no globals are touched, no loader is registered.
+When a contact changes, run `mdeval "**/*.md"` and both files update.
 
-## Using `.md` exports from a script
+## Writing mdeval code
 
-`.md` files with mdeval script blocks are real ESM modules — anything they `export` can be imported from a Node script. Useful for validation tools, migration scripts, or any code that needs to read structured data out of a Markdown knowledge base.
+### Helpers
 
-Run your script with `--import mdeval/loader`:
-
-```bash
-node --import mdeval/loader ./consumer.js
-```
-
-`consumer.js` can then use ordinary static imports against `.md` files:
-
-```js
-import { todos } from './TODOS.md'
-
-console.log(todos)
-```
-
-`--import mdeval/loader` is a side-effect-only entry. Before any of `consumer.js`'s imports are linked, it seeds `block` and `$` on `globalThis` and registers the Node ESM loader so `.md` files resolve as modules. Without it, the static `import` of a `.md` fails — Node has no idea how to load `.md` yet.
-
-The plain `mdeval` import stays pure — `import { block, $ } from 'mdeval'` just gives you the helpers without touching `globalThis` or registering any loader. The split keeps "I want the helpers in my script" separate from "I want to load `.md` files".
-
-You can also point `--import mdeval/loader` at a `.md` file directly:
-
-```bash
-node --import mdeval/loader ./TODOS.md
-```
+Two helpers are available as globals in `.md` files:
 
-Runtime stack traces from a `.md` point at original lines and columns — the loader sets up source maps automatically.
+| Helper | Description |
+| --- | --- |
+| `block(value)` | Puts the value on its own lines, so block-level Markdown such as headings, lists, and tables renders |
+| `$` | Runs shell commands with [zx](https://google.github.io/zx/): `` $`git branch --show-current` `` |
 
-## Notes
+Type-checked `.md` files can use these helpers without imports. Their types are visible throughout the TypeScript program; if another global conflicts, check Markdown with a separate tsconfig that excludes the conflicting declaration from all loaded files, including root files, imports, and `compilerOptions.types` inherited through `extends`. In `.js` and `.ts` files, import the helpers you use: `import { block, $ } from 'mdeval'`. The import has no side effects.
 
-- A file can have **multiple script blocks** — they're merged into one module, so variables and imports are shared. We recommend placing them at the top to signal the file has generated content.
+### Markers
 
-- **Markers can span multiple lines.** Don't cram everything into one line — give the expression room to breathe. This is what makes inlining marker-specific logic next to its output practical:
+- **Marker expressions are awaited**, so a promise resolves before its value is written:
 
   ```markdown
-  <!--mdeval block(table([
-    { name: 'cleye', version: '^2.3.0' },
-    { name: 'md-pen', version: '^0.0.2' },
-  ]))-->
-  | Package | Version |
-  | - | - |
-  | cleye | ^2.3.0 |
-  | md-pen | ^0.0.2 |
-  <!--/mdeval-->
+  Status: <!--mdeval fetch('https://api.github.com/repos/privatenumber/mdeval').then(response => response.status)-->200<!--/mdeval-->
   ```
 
-  When the expression needs statements or control flow, wrap it in an IIFE:
+- **Markers can span lines.** Keep logic that one marker needs inside the marker, and wrap statements in an IIFE:
 
   ```markdown
   <!--mdeval (() => {
     const n = 3;
-    if (n % 2 === 0) { return 'even' }
-    return 'odd'
+    return n % 2 === 0 ? 'even' : 'odd';
   })()-->odd<!--/mdeval-->
   ```
 
-  Coupling the expression to its rendered value keeps related code together and reads better than pushing every variable into a distant script block. Reserve script blocks for shared imports or values referenced by multiple markers.
+- **Script blocks share one module.** Variables and imports from every block in a file are visible to all of its markers. Blocks are joined in order, so a block starting with `(`, `[`, or a template literal can continue the previous block's last statement unless that statement ends with a semicolon. Use script blocks for imports and values that several markers share, and place them at the top of the file.
 
-- Marker expressions are **auto-awaited** — promises resolve automatically. Async APIs work directly in a marker without a script block:
+### Importing other `.md` files
 
-  ```markdown
-  Status: <!--mdeval (await fetch('https://api.github.com/repos/privatenumber/mdeval')).status-->200<!--/mdeval-->
-  ```
+A script block can import the exports of another `.md` file, as `TIMELINE.md` does above. mdeval runs only the script blocks of an imported file, not its markers.
 
-- You can **import from other `.md` files**. Only the script blocks are executed — no markers are processed:
+If the imported file might not have mdeval code yet, use a namespace import. A missing export is then `undefined`, while a named import of a missing export fails:
 
-  ```markdown
-  <!--mdeval
-  import { version } from './data.md';
-  -->
-  ```
+```markdown
+<!--mdeval
+import * as data from './stub.md';
+const version = data.version ?? 'tbd';
+-->
+```
 
-  This lets you share constants and logic across multiple markdown files.
+### TypeScript
 
-  If the imported file might not yet have mdeval content (e.g. a stub being filled in over time), use a **namespace import** so missing exports resolve to `undefined` instead of crashing Node's ESM linker:
+Scripts and markers can use TypeScript syntax that Node.js can remove without changing the code, such as type annotations, `interface`, `as`, and `satisfies`. Syntax that generates code, such as `enum`, `namespace` with values, and constructor parameter properties, fails ([Node.js docs](https://nodejs.org/api/typescript.html#type-stripping)). Markdown files under `node_modules` run as JavaScript, because Node.js does not strip types there.
 
-  ```markdown
-  <!--mdeval
-  import * as data from './stub.md';
-  const version = data.version ?? 'tbd';
-  -->
-  ```
+TypeScript 7.1 can also type-check mdeval code at its Markdown lines. See [Type checking](./docs/type-checking.md).
 
-- When processing multiple files (`mdeval a.md b.md`), all files **share the same Node.js runtime** — including the module cache, `globalThis`, and `process.env`. This is the same behavior as any Node.js program using `import()`.
+### Caveats
 
-## Caveats
+- **Script code cannot contain `-->`**, because it closes the HTML comment, or `<!--mdeval` followed by a space or newline, because mdeval treats it as an unclosed script. Build the text instead, such as `'<!--' + 'mdeval '`. Rewrite `x-- > y` as `x -= 1; x > y`.
+- **Values cannot contain `<!--mdeval` followed by a space, a newline, or CRLF, or `<!--/mdeval-->`.** mdeval throws instead of writing them, so the file stays parseable.
+- **Files processed together share one Node.js process,** including the module cache, `globalThis`, and `process.env`.
 
-- Script code **cannot contain `-->`** — it closes the HTML comment. Rewrite `x-- > y` as `x -= 1; x > y`.
-- Scripts are **JavaScript only** — no TypeScript.
-- Values **cannot contain `<!--mdeval `** or **`<!--/mdeval-->`** — mdeval will throw to prevent document corruption.
+## CLI
 
-## Tip: md-pen
+```bash
+mdeval README.md "docs/**/*.md"
+```
 
-[md-pen](https://github.com/privatenumber/md-pen) provides typed utilities for generating tables, lists, and other Markdown structures — useful when markers need to produce formatted output:
+mdeval accepts files and glob patterns, and updates each file in place. It prints the path of every file it changes.
 
-```markdown
-<!--mdeval
-import { table, bold, link } from 'md-pen';
-const deps = [
-  ['cleye', '^2.3.0'],
-  ['md-pen', '^0.0.2'],
-];
-const depsTable = table(deps.map(([name, version]) => [
-  link(`https://npm.im/${name}`, bold(name)),
-  version,
-]));
--->
+Line breaks in a value use the same line endings as the rest of the file.
 
-<!--mdeval block(depsTable)-->
-| Package | Version |
-| - | - |
-| [__cleye__](https://npm.im/cleye) | ^2.3.0 |
-| [__md-pen__](https://npm.im/md-pen) | ^0.0.2 |
-<!--/mdeval-->
+Globs skip `node_modules` and hidden directories. To include them, start the pattern with their path, such as `"node_modules/pkg/*.md"` or `".github/**/*.md"`.
+
+To check values in CI without rewriting files, run:
+
+```bash
+npx mdeval --check "**/*.md"
 ```
 
-## Git hook
+This prints paths that would change and exits with code 1 if any are outdated or a file fails. It still evaluates the Markdown code, which can have side effects.
 
-Run mdeval automatically before every commit so values never go stale. [Lefthook](https://github.com/evilmartians/lefthook) makes this easy:
+### Git hook
 
-```sh
-npm install lefthook --save-dev
-```
+To catch stale values before they are committed, run the check in a pre-commit hook. With [Lefthook](https://github.com/evilmartians/lefthook):
 
 ```yaml
 # lefthook.yml
 pre-commit:
   jobs:
     - name: mdeval
-      # lefthook's default `gobwas` matcher requires `**` to span 1+ dirs,
-      # so `**/*.md` alone misses root-level files like README.md
-      glob: ["*.md", "**/*.md"]
-      run: |
-        files=$(npx mdeval "**/*.md")
-        [ -n "$files" ] && git add $files
+      run: npx mdeval --check "**/*.md"
+```
+
+When the check fails, the commit stops. mdeval itself writes and stages nothing, but the Markdown scripts still run with full access and can change files. Run `npx mdeval "**/*.md"`, review and stage the updates, and commit again.
+
+Lefthook hides unstaged hunks in partially staged files while the job runs, so the hook checks their staged versions. If the check fails because of such a file, stage it fully or stash its unstaged hunks before running `npx mdeval` and committing again.
+
+The job runs on every commit that stages files, so a change to a non-Markdown input, such as `package.json`, is checked too. The hook checks your working tree, so a staged file can still differ from what it checked; the CI check on the committed files is the reliable one.
+
+## Importing `.md` files from scripts
+
+`.md` files are ES modules, so a Node.js script can import their exports. Register the loader with `--import`:
+
+```bash
+node --import mdeval/loader ./script.js
+```
+
+```js
+// script.js
+import { contacts } from './CONTACTS.md'
+
+console.log(contacts)
 ```
 
-`glob` makes the hook a no-op when no Markdown files are staged. mdeval prints the path of each file it rewrites to stdout, so `git add $files` re-stages only the files it actually updated. Note: `$files` relies on shell word-splitting, so this assumes `.md` paths without spaces.
+See [Node.js usage](./docs/node.md) for TypeScript scripts, running a `.md` file directly, and stack traces.
 
-## Agent Skills
+## Agent skill
 
-This package ships with a built-in [agent skill](./skills/mdeval/SKILL.md) for AI coding assistants. Set up [`skills-npm`](https://github.com/antfu/skills-npm) to automatically discover it.
+mdeval ships an [agent skill](./skills/mdeval/SKILL.md) that teaches AI coding assistants to write mdeval code.
 
 ## Related
 
-- [comment-mark](https://github.com/privatenumber/comment-mark) — Same idea of using HTML comment placeholders, but you write the script externally and pass values in via a JavaScript API. Useful when you want to keep the logic separate from the Markdown.
+- [comment-mark](https://github.com/privatenumber/comment-mark): also fills HTML comment placeholders, but values come from a script outside the Markdown through a JavaScript API.

package/dist/cli.mjs

@@ -1,3 +1,13 @@
 #!/usr/bin/env node
-var M=Object.defineProperty;var l=(o,r)=>M(o,"name",{value:r,configurable:!0});import m from"node:fs/promises";import x from"node:path";import{cli as O}from"cleye";import{glob as S}from"tinyglobby";import"./loader.mjs";import{p as d,b as _,E as b,M as f,C,a as u,c as P,i as R}from"./parse-markdown-wnFVEAED.mjs";import{pathToFileURL as $}from"node:url";import"node:module";import"./runtime.mjs";import"zx";import"micromark";const k=l(o=>{if(o==null)throw new Error(`Cannot interpolate ${o} \u2014 this is likely a bug in your script`);return typeof o=="string"?o:typeof o=="object"?Symbol.toPrimitive in o?String(o):JSON.stringify(o):String(o)},"coerceValue"),N=l(async(o,r)=>{const{markers:t}=d(o);if(t.length===0)return o;const i=await import($(r).href),n=_(t),w=await Promise.all(Array.from(n).map(async([e,p])=>{const s=k(await i[`${b}${p}`]);if(s.includes(f)||s.includes(`${C}
-`)||s.includes(u))throw new Error(`Expression "${e}" produced a value containing mdeval comment syntax, which would corrupt the document on re-parse`);return s})),a=[];let c=0;for(const e of t){const p=f.length+e.expression.length+P.length,s=e.start+p,E=e.end-u.length,y=n.get(e.expression);a.push(o.slice(c,s),w[y]),c=E}return a.push(o.slice(c)),a.join("")},"processSource"),T=O({name:"mdeval",parameters:["<files...>"]}),g=T._.files,v=g.some(o=>o.includes("node_modules")),h=await S(g,{ignore:v?[]:["**/node_modules/**"]});h.length===0&&(console.error("No files matched the given patterns"),process.exit(1)),await Promise.all(h.map(async o=>{try{const r=x.resolve(o),t=await m.readFile(r,"utf8"),i=d(t);R(t,i)&&console.warn(`Warning: ${o} has no markdown content outside of mdeval blocks`);const n=await N(t,r);n!==t&&(await m.writeFile(r,n,"utf8"),console.log(o))}catch(r){console.error(`Error processing ${o}:`,r instanceof Error?r.message:r),process.exitCode=1}}));
+var D=Object.defineProperty;var a=(t,e)=>D(t,"name",{value:e,configurable:!0});import O from"node:fs/promises";import w from"node:path";import{styleText as U}from"node:util";import{cli as V}from"cleye";import{h as B,p as M}from"./loader-D40biTy7.mjs";import{fileURLToPath as K,pathToFileURL as X}from"node:url";import j from"picomatch";import{glob as P,convertPathToPattern as G,isDynamicPattern as J}from"tinyglobby";import{b as z,E as Z,M as $,C as y,a as E,c as R,p as N,i as q}from"./node-modules-Bw1ALrxb.mjs";import{fromMarkdown as Q}from"mdast-util-from-markdown";import{gfmFootnote as Y}from"micromark-extension-gfm-footnote";import{gfmFootnoteFromMarkdown as tt}from"mdast-util-gfm-footnote";import{gfmTable as et}from"micromark-extension-gfm-table";import{gfmTableFromMarkdown as nt}from"mdast-util-gfm-table";import{toHast as rt,defaultHandlers as T}from"mdast-util-to-hast";import{visitParents as st}from"unist-util-visit-parents";import{parseFragment as ot}from"parse5";import"node:module";import"./runtime.mjs";import"zx";import"node:fs";import"@jridgewell/gen-mapping";import"micromark";var it="mdeval",at="2.0.0",A={name:it,version:at};const ct=/^\s*at (?:.*? \()?((?:file:\/\/|\/|[A-Za-z]:[\\/]).*?\.md):(\d+):(\d+)\)?$/m,lt=a((t,e)=>{try{const n=String(t.stack),r=String(t),o=(n.startsWith(r)?n.slice(r.length):n).match(ct);if(!o)return e;const s=o[1].startsWith("file:")?K(o[1]):o[1];return`${w.resolve(s)===w.resolve(e)?e:w.relative(process.cwd(),s)}:${o[2]}:${o[3]}`}catch{return e}},"formatErrorLocation"),ft=a(async t=>{try{const e=await O.stat(t);if(e.isDirectory()){const n=t.replace(/[\\/]$/,"")||t;return{pattern:`${G(n)}/**/*.md`}}return e.isFile()?{file:t}:{error:`${t}: not a file`}}catch(e){const n=e instanceof Error?e.code:void 0;if(n==="ENOENT"||n==="ENOTDIR")return J(t)?{pattern:t}:{error:`${t}: file does not exist`};const r=typeof n=="string"?n:e instanceof Error?e.message:e;return{error:`${t}: ${r}`}}},"classifyArgument"),ut=a(async t=>{const e=await Promise.all(t.map(ft)),n=e.flatMap(l=>l.error===void 0?[]:[l.error]);if(n.length>0)return{files:[],errors:n};const r=e.flatMap(l=>l.file===void 0?[]:[l.file]),o=e.flatMap(l=>l.pattern===void 0?[]:[l.pattern]),s=[],i=[],c=[];for(const l of o){const m=j.scan(l);m.negated?s.push(l):m.base.split("/").includes("node_modules")?c.push(l):i.push(l)}const[f,d]=await Promise.all([i.length>0?P([...i,...s],{ignore:["**/node_modules/**"]}):[],c.length>0?P([...c,...s]):[]]),u=new Set;return{files:[...r,...f,...d].filter(l=>{const m=w.resolve(l);return u.has(m)?!1:(u.add(m),!0)}),errors:n}},"resolveFiles"),mt=a(t=>{if(t==null)throw new Error(`Cannot interpolate ${t} \u2014 this is likely a bug in your script`);return typeof t=="string"?t:typeof t=="object"?Symbol.toPrimitive in t?String(t):JSON.stringify(t):String(t)},"coerceValue"),pt=a((t,e)=>{const n=[];let r=0;for(const i of e){const c=$.length+i.expression.length+R.length,f=i.start+c;n.push(t.slice(r,f)),r=i.end-E.length}n.push(t.slice(r));const o=new Map([[`
+`,0],[`\r
+`,0],["\r",0]]);for(const i of n)for(const[c]of i.matchAll(/\r\n|\r|\n/g))o.set(c,o.get(c)+1);let s=`
+`;for(const[i,c]of o)c>o.get(s)&&(s=i);return s},"getLineEnding"),dt=a(async(t,e,n=N(t))=>{const{markers:r}=n;if(r.length===0)return t;const o=pt(t,r),s=X(e).href,i=B(s),c={source:t,parsed:n};M.set(i,c);let f;try{f=await import(s)}finally{M.get(i)===c&&M.delete(i)}const d=z(r),u=await f[`${Z}markers`](),g=await Promise.all(Array.from(d).map(async([k,h])=>{const v=await u[h];if(v==null)throw new Error(`Expression "${k}" evaluated to ${v}`);const p=mt(v).replaceAll(/\r\n|\r|\n/g,o);if(p.includes($)||p.includes(`${y}
+`)||p.includes(`${y}\r
+`)||p.includes(E))throw new Error(`Expression "${k}" produced a value containing mdeval comment syntax, which would corrupt the document on re-parse`);return p})),l=[];let m=0;for(const k of r){const h=$.length+k.expression.length+R.length,v=k.start+h,p=k.end-E.length,x=d.get(k.expression);l.push(t.slice(m,v),g[x]),m=p}return l.push(t.slice(m)),l.join("")},"processSource"),ht=a(t=>{const e=[];for(let n=0;n<t.length;n+=1)t[n]==="\r"&&t[n+1]===`
+`?(n+=1,e.push(n)):(t[n]==="\r"||t[n]===`
+`)&&e.push(n);return e},"buildLineIndex"),gt=a((t,e)=>{let n=0,r=t.length;for(;n<r;){const s=Math.floor((n+r)/2);t[s]<e?n=s+1:r=s}const o=n===0?-1:t[n-1];return{line:n+1,column:e-o}},"offsetToLineColumn"),S=a((t,e,n,r)=>{let o=t,s=e;for(let i=0;i<r;i+=1)n[i]==="\r"||n[i]===`
+`?(n[i]==="\r"&&n[i+1]===`
+`&&i+1<r&&(i+=1),o+=1,s=1):s+=1;return{line:o,column:s}},"advanceByValue"),kt=a((t,e)=>{if(!t.startsWith(y,e))return!1;const n=t[e+y.length];return n===" "||n===`
+`?!0:n==="\r"&&t[e+y.length+1]===`
+`},"isMarkerOpening"),L=a((t,e=0,n=t.length)=>{const r=[];let o=0,s=e;for(;s<n;){const i=t.indexOf("<!--",s);if(i===-1||i>=n)break;kt(t,i)?(r.push(i),o+=1,s=i+y.length):t.startsWith(E,i)?(o>0?o-=1:r.push(i),s=i+E.length):s=i+4}return r},"findMarkerLeaks"),vt=a((t,e,n)=>{if(!t.attrs||!t.sourceCodeLocation?.attrs)return[];const r=[];for(const o of t.attrs){const s=t.sourceCodeLocation.attrs[o.name];if(!s)continue;const i=e+s.startOffset,{line:c,column:f}=n(i);for(const d of L(o.value))r.push({line:c,column:f})}return r},"attributeLeaks"),wt=a((t,e,n)=>{const{value:r}=t;if(t.nodeName!=="#text"||typeof r!="string"||t.sourceCodeLocation?.startOffset===void 0)return[];const o=e+t.sourceCodeLocation.startOffset,s=n(o);return L(r).map(i=>{const{line:c,column:f}=S(s.line,s.column,r,i);return{line:c,column:f}})},"textLeaks"),yt=a((t,e,n,r)=>{const o=t.slice(e,n),s=ot(o,{sourceCodeLocationInfo:!0}),i=[],c=a(f=>{i.push(...vt(f,e,r),...wt(f,e,r));for(const d of f.childNodes??[])c(d)},"visit");return c(s),i},"findRawHtmlLeaks"),Et=a(t=>{let e=!1;for(const n of t){if(n.tagName==="pre")return"code block";n.tagName==="code"&&(e=!0)}return e?"inline code":"text"},"classifyTextLeak"),Lt=a((t,e)=>e==="alt"?"image alt":t.tagName==="a"?"link title":"image title","classifyAttributeLeak"),F=a(t=>{const e=t.position?.start.offset,n=t.position?.end.offset;if(!(e===void 0||n===void 0))return{startOffset:e,endOffset:n,startLine:t.position?.start.line,startColumn:t.position?.start.column}},"rangeOf"),xt=a((t,e)=>{const n=F(t);if(n)return n;for(let r=e.length-1;r>=0;r-=1){const o=F(e[r]);if(o)return o}return{}},"positionRange"),Ot=a((t,e,n)=>{if(e.startOffset!==void 0){if(n==="code block"){const r=t[e.startOffset];if(r===" "||r==="	"){let i=e.startOffset;for(;t[i]===" "||t[i]==="	";)i+=1;return i}const o=/\r\n?|\n/g;o.lastIndex=e.startOffset;const s=o.exec(t);return s?s.index+s[0].length:e.startOffset}if(n==="inline code"){let r=e.startOffset;for(;t[r]==="`";)r+=1;return r}return e.startOffset}},"findContentStart"),Mt=a((t,e,n)=>t.map(r=>{const{line:o,column:s}=e(r);return{kind:n,line:o,column:s}}),"mapOffsetsToLeaks"),$t=a((t,e,n)=>e===void 0?{line:t.startLine??1,column:t.startColumn??1}:n(e),"resolveContentStart"),bt=a((t,e,n,r)=>e.map(o=>{const{line:s,column:i}=S(n.line,n.column,t,o);return{kind:r,line:s,column:i}}),"valueWalkLeaks"),Ct=a((t,e,n,r,o)=>{const s=n.value??"";if(!s.includes("mdeval"))return[];const i=L(s);if(i.length===0)return[];const c=xt(n,r),f=Ot(t,c,o);if(f!==void 0&&c.endOffset!==void 0){const u=L(t,f,c.endOffset);if(u.length===i.length)return Mt(u,e,o)}const d=$t(c,f,e);return bt(s,i,d,o)},"collectTextNodeLeaks"),Pt=a((t,e,n,r)=>{if(!n.includes("mdeval"))return[];const o=L(n);if(o.length===0)return[];const s=e.position?.start.offset??-1,{line:i,column:c}=s===-1?{line:e.position?.start.line??1,column:e.position?.start.column??1}:t(s);return o.map(()=>({kind:r,line:i,column:c}))},"collectAttributeLeaks"),Rt=a((t,e,n,r)=>n.type!=="text"||typeof n.value!="string"?[]:Ct(t,e,n,r,Et(r)),"textNodeLeaks"),Nt=a((t,e,n)=>{if(n.type!=="raw"||typeof n.value!="string")return[];const r=n.position?.start.offset,o=n.position?.end.offset;return r===void 0||o===void 0?[]:yt(t,r,o,e).map(s=>({kind:"raw html",...s}))},"rawNodeLeaks"),Tt=a((t,e)=>{if(e.type!=="element"||!e.properties)return[];const n=[];for(const r of["alt","title"]){const o=e.properties[r];if(typeof o=="string"){const s=Lt(e,r);n.push(...Pt(t,e,o,s))}}return n},"elementAttributeLeaks"),At=a(t=>{if(!t.includes("mdeval"))return[];const e=t.codePointAt(0)===65279?t.slice(1):t,n=ht(e),r=a(u=>gt(n,u),"point"),o=Q(e,{extensions:[Y(),et()],mdastExtensions:[tt(),nt()]}),s=[],i=new WeakMap,c=a((u,g)=>{const l=g.type==="linkReference"?T.linkReference(u,g):T.imageReference(u,g),m=u.definitionById.get(String(g.identifier).toUpperCase());return m&&!Array.isArray(l)&&l.type==="element"&&i.set(l,m),l},"referenceHandler"),f=rt(o,{allowDangerousHtml:!0,handlers:{linkReference:c,imageReference:c}}),d=new WeakMap;return st(f,(u,g)=>{const l=u,m=i.get(u),k=Tt(r,l);s.push(...Rt(e,r,l,g),...Nt(e,r,l),...k.flatMap(h=>{if(!m||h.kind!=="link title"&&h.kind!=="image title")return[h];const v=m.position?.start.offset;if(v===void 0)return[h];let p=d.get(m);p||(p=new Map,d.set(m,p));const x=p.get(h.kind);return x&&x!==u?[]:(p.set(h.kind,u),[{...h,...r(v)}])}))}),s},"findRenderedLeaks"),_=U("yellow","Warning:",{stream:process.stderr}),b=V({name:A.name,version:A.version,strictFlags:!0,flags:{check:{type:Boolean,description:"Report files with outdated values instead of rewriting them"}},parameters:["<files...>"]}),{files:I,errors:W}=await ut(b._.files);if(W.length>0){for(const t of W)console.error(t);process.exitCode=1}else I.length===0&&(console.error("No files matched the given patterns"),process.exitCode=1);let C=!1,H=!1;process.on("exit",()=>{(C||!H)&&(process.exitCode=1)}),await Promise.all(I.map(async t=>{try{if(w.extname(t)!==".md")throw new Error("mdeval only processes .md files");const e=w.resolve(t),n=await O.readFile(e,"utf8"),r=N(n);q(n,r)&&console.warn(`${_} ${t} has no markdown content outside of mdeval blocks`);const o=await dt(n,e,r);o!==n&&(b.flags.check?C=!0:await O.writeFile(e,o,"utf8"),console.log(t));for(const s of At(b.flags.check?n:o))console.warn(`${_} ${t}:${s.line}:${s.column} mdeval marker leaks into rendered ${s.kind}`)}catch(e){console.error(`Error processing ${lt(e,t)}:`,e instanceof Error?e.message:e),C=!0}})),H=!0;