@p-buddy/parkdown 0.0.11 → 0.0.13

package/README.md

@@ -44,7 +44,7 @@ populateMarkdownInclusions(file, writeFile);
 
 [](./.assets/authoring.md)
 <!-- p↓ BEGIN -->
-<!-- p↓ length lines: 574 chars: 17955 -->
+<!-- p↓ length lines: 601 chars: 19975 -->
 ## Authoring
 
 You author inclusions in your markdown files using a link with no text i.e. `[](<url>)`, where `<url>` points to some local or remote text resource (e.g.`./other.md`, `https://example.com/remote.md`).
@@ -256,7 +256,7 @@ Before...
 
 [](.assets/query.md?heading=-1)
 <!-- p↓ BEGIN -->
-<!-- p↓ length lines: 361 chars: 13249 -->
+<!-- p↓ length lines: 388 chars: 15269 -->
 ### Query parameters
 
 You can pass query parameters to your inclusion links to control how their content is processed and included within your markdown.
@@ -290,6 +290,8 @@ Specifiers will be searched for within the file's comments, and are expected to
 /** some-specifier */
 ```
 
+Identifiers will be searched for within the text of a comment split by spaces (i.e. `some-specifier` is a single identifier, but `some specifier` represents two separate identifiers).
+
 Below is the currently supported API for the `region` query parameter, where each defined method signature can be _invoked_ as a value for the `region` parameter, for example:
 
 - `[](<url>?region=extract(some-specifier))`
@@ -314,7 +316,7 @@ Please see the [full explanation](#query-parameters-with-function-like-apis) to
 
 [](src/region.ts?region=extract(definition))
 <!-- p↓ BEGIN -->
-<!-- p↓ length lines: 36 chars: 1651 -->
+<!-- p↓ length lines: 64 chars: 3718 -->
 
 ```ts
 const definitions = [
@@ -348,6 +350,34 @@ const definitions = [
    * @example [](<url>?region=replace(specifier,new_content,_)
    */
   "replace(id: string, with?: string, space?: string)",
+  /**
+   * Splice the retrieved content at the boundary of a comment region (which must INCLUDE the specified id).
+   * 
+   * **NOTE:** Unlike `extract`, `remove`, and `replace`, `splice` does remove the comment from the content after processing.
+   * @param id The id of the comment regions to act on.
+   * @param deleteCount The number of characters to delete at either the beginning or end of the comment region.
+   * Specifying a number greater than or equal to 0 indicates the action should be taken at the end of the comment region.
+   * Specifying undefined or a number less than 0 indicates the action should be taken at the beginning of the comment region.
+   * @param insert The content to insert.
+   * @param space The space character to use between words in the content to insert (defaults to `-`).
+   * @example [](<url>?region=splice(specifier,-1)) // Delete one character at the beginning of the comment region.
+   * @example [](<url>?region=splice(specifier,undefined,new-content)) // Insert at the beginning of the comment region.
+   * @example [](<url>?region=splice(specifier,0,new-content)) // Insert at the end of the comment region.
+   * @example [](<url>?region=splice(specifier,1,new-content)) // Delete one character at the end of the comment region and insert.
+   */
+  "splice(id: string, deleteCount?: number, insert?: string, space?: string)",
+  /**
+   * Remap the content within a comment region (which must INCLUDE the specified id).
+   * 
+   * **NOTE:** Unlike `extract`, `remove`, and `replace`, `remap` does not remove the comment from the content after processing.
+   * @param id The id of the comment regions to act on.
+   * @param from The content to replace.
+   * @param to The content to replace with.
+   * @param space The space character to use between words in the content to replace (defaults to `-`).
+   * @example [](<url>?region=remap(specifier,hello-world,hello-universe))
+   * @example [](<url>?region=remap(specifier,hello_world,hello_universe,_)
+   */
+  "remap(id: string, from: string, to?: string, space?: string)",
 ]
 ```
 
@@ -359,7 +389,7 @@ Skip the default processing behavior for the given type of file.
 
 [](src/include.ts?wrap=dropdown(See-default-processing-behavior.)&region=extract(Default-Behavior),replace(...))
 <!-- p↓ BEGIN -->
-<!-- p↓ length lines: 21 chars: 525 -->
+<!-- p↓ length lines: 17 chars: 273 -->
 
 <details>
 <summary>
@@ -368,15 +398,11 @@ See default processing behavior.
 
 ```ts
 if (extension === "md") {
- 
-  const getContent = extendGetRelativePathContent(getRelativePathContent, target);
-  const relative = basePath ? join(basePath, dir) : dir;
-  const depth = clampHeadingSum(headingDepth, Number(headingModfiier));
- 
-  content = recursivelyPopulateInclusions(content, depth, getContent, path, relative);
+  * ...
+  content = recursivelyPopulateInclusions(content, * ...);
 }
 else if (/^(js|ts)x?|svelte$/i.test(extension))
-  content = wrap(content, "code", { extension, inline });
+  content = wrap(content, "code", * ...);
 ```
 
 </details>
@@ -512,7 +538,7 @@ const definitions = [
 
 [](.assets/api.md?heading=-1)
 <!-- p↓ BEGIN -->
-<!-- p↓ length lines: 104 chars: 4973 -->
+<!-- p↓ length lines: 105 chars: 4993 -->
 #### Query Parameters with Function-like APIs
 
 Some query parameters have more complex APIs, which are defined by a collection of typescript function singatures (limited to only `string`, `boolean`, and `number` arguments), like:
@@ -543,7 +569,7 @@ Please note the following:
 
 [](src/utils.ts?region=extract(url))
 <!-- p↓ BEGIN -->
-<!-- p↓ length lines: 31 chars: 498 -->
+<!-- p↓ length lines: 32 chars: 518 -->
 
 ```ts
 const urlCharacters = {
@@ -571,6 +597,7 @@ const urlCharacters = {
     ["square"]: "[",
     ["unsquare"]: "]",
     ["tick"]: "`",
+    ["line"]: "\n",
   }
 }
 ```

package/dist/cli.js

@@ -1,14 +1,15 @@
 #!/usr/bin/env node
-import { Command as t } from "@commander-js/extra-typings";
-import { populateMarkdownInclusions as l, depopulateMarkdownInclusions as r } from "@p-buddy/parkdown";
-const f = "0.0.11", p = new t().version(f).option("--nw, --no-write", "Do NOT write result to file (defaults to false)", !1).option("--ni, --no-inclusions", "Do NOT process file inclusions (defaults to false)", !1).option("-d, --depopulate", "Remove populated inclusions from the file", !1).option("-f, --file <flag>", "The file(s) to process", (s, o) => (o.push(s), o), new Array()).parse(), { inclusions: c, depopulate: u, file: n, write: i } = p.opts();
-n.length === 0 && n.push("README.md");
-const a = [
-  [l, !c],
-  [r, u]
+import { Command as r } from "@commander-js/extra-typings";
+import { populateMarkdownInclusions as l, depopulateMarkdownInclusions as a } from "@p-buddy/parkdown";
+import f from "chokidar";
+const c = "0.0.13", p = new r().version(c).option("--nw, --no-write", "Do NOT write result to file (defaults to false)", !1).option("--ni, --no-inclusions", "Do NOT process file inclusions (defaults to false)", !1).option("-d, --depopulate", "Remove populated inclusions from the file", !1).option("-f, --file <flag>", "The file(s) to process", (e, o) => (o.push(e), o), new Array()).option("-w, --watch", "Watch the file(s) for changes and update automatically", !1).parse(), { inclusions: u, depopulate: d, file: t, write: n, watch: h } = p.opts();
+t.length === 0 && t.push("README.md");
+const m = [
+  [l, !u],
+  [a, d]
 ];
-for (const [s] of a.filter(([o, e]) => e))
-  for (const o of n) {
-    const e = s(o, !i);
-    i && console.log(e);
+for (const [e] of m.filter(([o, s]) => s))
+  for (const o of t) {
+    const s = h ? f.watch([], { persistent: !0, awaitWriteFinish: !0, atomic: !0 }) : void 0, i = e(o, !n, s);
+    n && console.log(i);
   }

package/dist/index.d.ts

@@ -1,5 +1,9 @@
-export declare const depopulateMarkdownInclusions: (file: string, writeFile?: boolean) => string;
+import { default as default_2 } from 'chokidar';
 
-export declare const populateMarkdownInclusions: (file: string, writeFile?: boolean) => string;
+export declare const depopulateMarkdownInclusions: (file: string, writeFile?: boolean, watcher?: Watcher) => string;
+
+export declare const populateMarkdownInclusions: (file: string, writeFile?: boolean, watcher?: Watcher) => string;
+
+declare type Watcher = ReturnType<typeof default_2.watch>;
 
 export { }

package/dist/index.js

@@ -1,84 +1,84 @@
-var fe = Object.defineProperty;
-var de = (e, t, n) => t in e ? fe(e, t, { enumerable: !0, configurable: !0, writable: !0, value: n }) : e[t] = n;
-var B = (e, t, n) => de(e, typeof t != "symbol" ? t + "" : t, n);
-import { writeFileSync as Z, readFileSync as ve } from "node:fs";
-import { basename as we, dirname as O, join as y, resolve as K } from "node:path";
-import { URLSearchParams as $e } from "node:url";
-import { unified as Ce } from "unified";
+var he = Object.defineProperty;
+var de = (e, n, t) => n in e ? he(e, n, { enumerable: !0, configurable: !0, writable: !0, value: t }) : e[n] = t;
+var F = (e, n, t) => de(e, typeof n != "symbol" ? n + "" : n, t);
+import { writeFileSync as K, readFileSync as ve } from "node:fs";
+import { basename as $e, dirname as A, join as y, resolve as Y } from "node:path";
+import { URLSearchParams as Ce } from "node:url";
+import { unified as we } from "unified";
 import Ee from "remark-parse";
 import { visit as ye } from "unist-util-visit";
-import { dedent as R } from "ts-dedent";
-const g = (e, t) => e.position.start.offset - t.position.start.offset;
-g.reverse = (e, t) => g(t, e);
-const j = (e) => e.position !== void 0 && e.position.start.offset !== void 0 && e.position.end.offset !== void 0, Se = Ce().use(Ee), A = {
+import { dedent as j } from "ts-dedent";
+const f = (e, n) => e.position.start.offset - n.position.start.offset;
+f.reverse = (e, n) => f(n, e);
+const D = (e) => e.position !== void 0 && e.position.start.offset !== void 0 && e.position.end.offset !== void 0, Se = we().use(Ee), I = {
   md: (e) => Se.parse(e)
-}, S = (e, t) => {
-  const n = [];
+}, S = (e, n) => {
+  const t = [];
   return ye(e, (s, o, r) => {
     if (s.type !== "root") {
-      if (t && s.type !== t) return;
-      if (j(s)) {
+      if (n && s.type !== n) return;
+      if (D(s)) {
         const i = ((r == null ? void 0 : r.children.length) ?? 0) - 1;
-        n.push({ ...s, siblingIndex: o, siblingCount: i });
+        t.push({ ...s, siblingIndex: o, siblingCount: i });
       }
     }
-  }), n;
-}, xe = (e) => e.children.length === 0, Y = (e, t, ...n) => {
-  if (n.length === 0) throw new Error("No nodes to replace content from");
-  n.sort(g);
-  const s = n.at(0), o = n.at(-1);
-  return e.slice(0, s.position.start.offset) + t + e.slice(o.position.end.offset);
-}, Ne = (e, t, n) => {
-  const s = Math.min(t.position.end.offset, n.position.end.offset), o = Math.max(t.position.start.offset, n.position.start.offset);
+  }), t;
+}, xe = (e) => e.children.length === 0, ee = (e, n, ...t) => {
+  if (t.length === 0) throw new Error("No nodes to replace content from");
+  t.sort(f);
+  const s = t.at(0), o = t.at(-1);
+  return e.slice(0, s.position.start.offset) + n + e.slice(o.position.end.offset);
+}, Ne = (e, n, t) => {
+  const s = Math.min(n.position.end.offset, t.position.end.offset), o = Math.max(n.position.start.offset, t.position.start.offset);
   return e.slice(s, o);
 }, E = (...e) => e.join(" "), be = (...e) => e.join(`
 `), ke = (e) => {
-  const t = e.split("?");
-  return t.length > 1 ? [t.slice(0, -1).join("?"), t.at(-1)] : [e, ""];
+  const n = e.split("?");
+  return n.length > 1 ? [n.slice(0, -1).join("?"), n.at(-1)] : [e, ""];
 }, Me = (e) => ke(e)[0];
 class d {
-  constructor(...t) {
-    B(this, "intervals", []);
-    for (const [n, s] of t)
-      this.push(n, s);
+  constructor(...n) {
+    F(this, "intervals", []);
+    for (const [t, s] of n)
+      this.push(t, s);
   }
-  push(t, n) {
-    this.intervals.push([Math.min(t, n), Math.max(t, n)]);
+  push(n, t) {
+    this.intervals.push([Math.min(n, t), Math.max(n, t)]);
   }
-  combine(t) {
-    this.intervals.push(...t.intervals);
+  combine(n) {
+    this.intervals.push(...n.intervals);
   }
   collapse() {
-    const { intervals: t } = this;
-    if (!t.length) return this.intervals = [];
-    t.sort((r, i) => r[0] - i[0]);
-    const n = [];
-    let [s, o] = t[0];
-    for (let r = 1; r < t.length; r++) {
-      const [i, c] = t[r];
-      i <= o ? o = Math.max(o, c) : (n.push([s, o]), s = i, o = c);
+    const { intervals: n } = this;
+    if (!n.length) return this.intervals = [];
+    n.sort((r, i) => r[0] - i[0]);
+    const t = [];
+    let [s, o] = n[0];
+    for (let r = 1; r < n.length; r++) {
+      const [i, l] = n[r];
+      i <= o ? o = Math.max(o, l) : (t.push([s, o]), s = i, o = l);
     }
-    return n.push([s, o]), this.intervals = n;
+    return t.push([s, o]), this.intervals = t;
   }
-  subtract(t) {
-    const { intervals: n } = this, { intervals: s } = t;
-    if (!n.length || !s.length) return n;
-    let o = [...n];
+  subtract(n) {
+    const { intervals: t } = this, { intervals: s } = n;
+    if (!t.length || !s.length) return t;
+    let o = [...t];
     for (const [r, i] of s) {
-      const c = [];
-      for (const [l, a] of o) {
-        if (i <= l || r >= a) {
-          c.push([l, a]);
+      const l = [];
+      for (const [c, a] of o) {
+        if (i <= c || r >= a) {
+          l.push([c, a]);
           continue;
         }
-        r > l && c.push([l, r]), i < a && c.push([i, a]);
+        r > c && l.push([c, r]), i < a && l.push([i, a]);
       }
-      o = c;
+      o = l;
     }
     return this.intervals = o;
   }
 }
-const F = /,\s*(?![^()]*\))/, U = {
+const U = /,\s*(?![^()]*\))/, H = {
   reserved: {
     semi: ";",
     slash: "/",
@@ -114,87 +114,87 @@ const F = /,\s*(?![^()]*\))/, U = {
     [/p↓:\s+/g, ""]
   ],
   url: [
-    ...Object.entries(U.unsafe),
-    ...Object.entries(U.reserved)
+    ...Object.entries(H.unsafe),
+    ...Object.entries(H.reserved)
   ]
-}, H = (e, [t, n]) => e.replaceAll(t, n), D = (e, t = _e) => {
-  const n = G.static.reduce(H, e);
-  return G.url.map(([s, o]) => [t + s + t, o]).reduce(H, n).replaceAll(t, " ");
-}, Te = (e) => e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), Oe = ["string", "number", "boolean"], Re = (e) => Oe.includes(e), je = /^([a-zA-Z0-9_-]+)(?:\(([^)]*)\))?$/, Ae = (e) => {
-  const t = e.match(je);
-  if (!t) throw new Error(`Invalid invocation: ${e}`);
-  const [, n, s = ""] = t;
-  if (!s.trim()) return { name: n, parameters: [] };
+}, Q = (e, [n, t]) => e.replaceAll(n, t), N = (e, n = _e) => {
+  const t = G.static.reduce(Q, e);
+  return G.url.map(([s, o]) => [n + s + n, o]).reduce(Q, t).replaceAll(n, " ");
+}, Re = (e) => e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), Oe = ["string", "number", "boolean"], Te = (e) => Oe.includes(e), Ae = /^([a-zA-Z0-9_-]+)(?:\(([^)]*)\))?$/, je = (e) => {
+  const n = e.match(Ae);
+  if (!n) throw new Error(`Invalid invocation: ${e}`);
+  const [, t, s = ""] = n;
+  if (!s.trim()) return { name: t, parameters: [] };
   const o = Ie(s);
-  return { name: n, parameters: o };
-}, De = (e, t) => {
-  for (let n = t + 1; n < e.length; n++)
-    if (e[n] !== void 0) return !1;
+  return { name: t, parameters: o };
+}, De = (e, n) => {
+  for (let t = n + 1; t < e.length; t++)
+    if (e[t] !== void 0) return !1;
   return !0;
 }, Ie = (e) => {
-  const t = [];
-  let n = "", s = !1;
+  const n = [];
+  let t = "", s = !1;
   for (let o = 0; o < e.length; o++) {
     const r = e[o], i = r === "'";
     if (i && e.at(o + 1) === "'") {
-      const c = e.at(o + 2) === "'";
-      s = !s, n += c ? "'''" : "''", o += c ? 2 : 1;
-    } else i ? (s = !s, n += r) : r === "," && !s ? (t.push(n.trim()), n = "") : n += r;
+      const l = e.at(o + 2) === "'";
+      s = !s, t += l ? "'''" : "''", o += l ? 2 : 1;
+    } else i ? (s = !s, t += r) : r === "," && !s ? (n.push(t.trim()), t = "") : t += r;
   }
-  return t.push(n.trim()), t.map((o) => o === "" ? void 0 : o ? Pe(o) : void 0).filter((o, r, i) => o !== void 0 || !De(i, r));
+  return n.push(t.trim()), n.map((o) => o === "" ? void 0 : o ? Pe(o) : void 0).filter((o, r, i) => o !== void 0 || !De(i, r));
 }, Pe = (e) => {
-  const t = e.length >= 2 && e[0] === "'" && e.at(-1) === "'", n = t && e.length >= 4 && e[1] === "'" && e.at(-2) === "'";
-  return !t || n ? e : e.slice(1, -1);
+  const n = e.length >= 2 && e[0] === "'" && e.at(-1) === "'", t = n && e.length >= 4 && e[1] === "'" && e.at(-2) === "'";
+  return !n || t ? e : e.slice(1, -1);
 }, We = (e) => {
-  const t = /^(\w+)(?:\(([^)]*)\))?/, n = e.match(t);
-  if (!n) return { name: e };
-  const [, s, o] = n;
+  const n = /^(\w+)(?:\(([^)]*)\))?/, t = e.match(n);
+  if (!t) return { name: e };
+  const [, s, o] = t;
   if (!o) return { name: s };
   const r = /(\w+)(\?)?:\s*([^,]+)/g, i = [];
-  let c;
-  for (; (c = r.exec(o)) !== null; ) {
-    const [, l, a, u] = c, p = u.trim();
-    if (!Re(p)) throw new Error(`Unsupported type: ${p}`);
-    i.push({ name: l, optional: a === "?", type: p });
+  let l;
+  for (; (l = r.exec(o)) !== null; ) {
+    const [, c, a, u] = l, p = u.trim();
+    if (!Te(p)) throw new Error(`Unsupported type: ${p}`);
+    i.push({ name: c, optional: a === "?", type: p });
   }
   return { name: s, parameters: i };
-}, I = (e) => {
-  const t = e.map(We).reduce(
-    (n, { name: s, parameters: o }) => n.set(s, o),
+}, P = (e) => {
+  const n = e.map(We).reduce(
+    (t, { name: s, parameters: o }) => t.set(s, o),
     /* @__PURE__ */ new Map()
   );
-  return (n) => {
-    const { name: s, parameters: o } = Ae(n);
-    if (!t.has(s))
+  return (t) => {
+    const { name: s, parameters: o } = je(t);
+    if (!n.has(s))
       throw new Error(`Unknown method: ${s}`);
-    const r = t.get(s);
+    const r = n.get(s);
     if (r === void 0)
       return { name: s };
     if (o.length > r.length) {
-      const i = r.filter(({ optional: l }) => !l).length, c = i === r.length ? i.toString() : `${i} - ${r.length}`;
-      throw new Error(`Too many parameters: ${o.length} for method '${s}' (expected: ${c})`);
+      const i = r.filter(({ optional: c }) => !c).length, l = i === r.length ? i.toString() : `${i} - ${r.length}`;
+      throw new Error(`Too many parameters: ${o.length} for method '${s}' (expected: ${l})`);
     }
-    return r.reduce((i, { name: c, optional: l, type: a }, u) => {
+    return r.reduce((i, { name: l, optional: c, type: a }, u) => {
       const p = o[u];
       if (p === void 0) {
-        if (l) return i;
-        throw new Error(`Missing required parameter: ${c} for method '${s}'`);
+        if (c) return i;
+        throw new Error(`Missing required parameter: ${l} for method '${s}'`);
       }
       switch (a) {
         case "string":
-          i[c] = p;
+          i[l] = p;
           break;
         case "number":
         case "boolean":
-          i[c] = JSON.parse(p);
+          i[l] = JSON.parse(p);
           break;
       }
-      if (typeof i[c] !== a)
-        throw new Error(`Invalid type: ${c} must be ${a}, got ${typeof i[c]} for method '${s}'`);
+      if (typeof i[l] !== a)
+        throw new Error(`Invalid type: ${l} must be ${a}, got ${typeof i[l]} for method '${s}'`);
       return i;
     }, { name: s });
   };
-}, Q = (e) => Object.entries(e).filter(([t]) => t !== "name" && !isNaN(Number(t))).map(([t, n]) => n), Le = [
+}, z = (e) => Object.entries(e).filter(([n]) => n !== "name" && !isNaN(Number(n))).map(([n, t]) => t), Le = [
   /**
    * Wraps the content in a markdown-formatted code block.
    * @param lang The language of the code block (defaults to the file extension).
@@ -224,50 +224,54 @@ const F = /,\s*(?![^()]*\))/, U = {
    * @example [](<url>?wrap=dropdown(hello_world,,_)) 
    */
   "dropdown(summary: string, open?: boolean, space?: string)"
-], qe = I(Le), f = (e, t = 1) => `
-`.repeat(t) + e + `
-`.repeat(t), T = (e, t, n) => `<${t}${n ? ` ${n}` : ""}>${f(e)}</${t}>`, z = (e, t, n) => {
-  const s = qe(t);
+], qe = P(Le), h = (e, n = 1) => `
+`.repeat(n) + e + `
+`.repeat(n), T = (e, n, t) => `<${n}${t ? ` ${t}` : ""}>${h(e)}</${n}>`, X = (e, n, t) => {
+  const s = qe(n);
   switch (s.name) {
     case "code":
-      if (!s.lang && !s.meta && (n == null ? void 0 : n.inline) && !e.includes(`
+      if (!s.lang && !s.meta && (t == null ? void 0 : t.inline) && !e.includes(`
 `)) return `\`${e}\``;
-      const r = s.lang ?? (n == null ? void 0 : n.extension) ?? "", i = s.meta ? ` ${s.meta}` : "";
-      return f(`\`\`\`${r}${i}${f(e)}\`\`\``);
+      const r = s.lang ?? (t == null ? void 0 : t.extension) ?? "", i = s.meta ? ` ${s.meta}` : "";
+      return h(`\`\`\`${r}${i}${h(e)}\`\`\``);
     case "quote":
-      return n != null && n.inline && !e.includes(`
+      return t != null && t.inline && !e.includes(`
 
-`) ? `> ${e}` : f(T(f(e), "blockquote"));
+`) ? `> ${e}` : h(T(h(e), "blockquote"));
     case "dropdown":
-      const c = T(D(s.summary), "summary");
-      return f(T([c, e].join(`
+      const l = T(N(s.summary), "summary");
+      return h(T([l, e].join(`
 `), "details", s.open ? "open" : void 0));
   }
-}, P = (e) => {
-  const t = /(\/\/[^\n]*|\/\*[\s\S]*?\*\/|<!--[\s\S]*?-->)/gm, n = [];
+}, W = (e) => {
+  const n = /(\/\/[^\n]*|\/\*[\s\S]*?\*\/|<!--[\s\S]*?-->)/gm, t = [];
   let s;
-  for (; (s = t.exec(e)) !== null; ) {
+  for (; (s = n.exec(e)) !== null; ) {
     const o = [s.index, s.index + s[0].length], r = Be(s[0]).trim();
-    n.push({ range: o, value: r });
+    t.push({ range: o, value: r });
   }
-  return n;
-}, Be = (e) => e.startsWith("//") ? e.slice(2) : e.startsWith("/*") ? e.slice(2, -2) : e.startsWith("<!--") ? e.slice(4, -3) : e, ee = [
+  return t;
+}, Be = (e) => e.startsWith("//") ? e.slice(2) : e.startsWith("/*") ? e.slice(2, -2) : e.startsWith("<!--") ? e.slice(4, -3) : e, ne = [
   "p↓:",
   "pd:",
   "parkdown:"
 ], Fe = [
   "splice(delete?: number, insert?: string)"
 ];
-I(Fe);
-const te = (e, t) => e.range[0] - t.range[0], ne = (e, t, n) => (n ?? P(e)).filter(({ value: s }) => s.includes(t)).sort(te), X = (e) => ({
+P(Fe);
+const te = (e, n) => e.range[0] - n.range[0], se = (e, n, t) => (t ?? W(e)).filter(({ value: s }) => s.split(" ").includes(n)).sort(te), V = (e) => ({
   isSpace: e === " ",
   isNewline: e === `
 ` || e === void 0
-}), V = (e) => ee.flatMap((t) => ne(e, t)).sort((t, n) => t.range[0] - n.range[0]).reverse().reduce((t, { range: [n, s], value: o }) => {
-  const r = (a, u) => t.slice(0, a) + t.slice(u), i = X(t[n - 1]), c = X(t[s]), l = s === t.length;
-  return i.isNewline && c.isNewline ? r(n - (l ? 1 : 0), s + 1) : i.isNewline ? r(n, s + (c.isSpace ? 1 : 0)) : r(n - (i.isSpace ? 1 : 0), s);
+}), J = (e) => ne.flatMap((n) => se(e, n)).sort((n, t) => n.range[0] - t.range[0]).reverse().reduce((n, { range: [t, s], value: o }) => {
+  const r = (p, b) => n.slice(0, p) + n.slice(b), i = V(n[t - 1]), l = V(n[s]), c = s === n.length;
+  let a = t;
+  for (; a > 0 && n[a - 1] !== `
+`; ) a--;
+  const u = n.slice(a, t).trim() === "";
+  return i.isNewline && l.isNewline ? r(t - (c ? 1 : 0), s + 1) : i.isNewline || u ? r(a, s + (l.isSpace || l.isNewline ? 1 : 0)) : r(t - (i.isSpace ? 1 : 0), s);
 }, e);
-ee.map((e) => new RegExp(`^${Te(e)}(\\?[^\\s]+)`));
+ne.map((e) => new RegExp(`^${Re(e)}(\\?[^\\s]+)`));
 const Ue = [
   /**
    * Extract regions from the retrieved content between comments that INCLUDE the specified ids.
@@ -326,66 +330,74 @@ const Ue = [
    * @example [](<url>?region=remap(specifier,hello-world,hello-universe))
    * @example [](<url>?region=remap(specifier,hello_world,hello_universe,_)
    */
-  "remap(id: string, from: string, to: string, space?: string)"
-], Ge = I(Ue), C = (e, t, n) => {
-  const s = ne(e, t, n), o = [];
+  "remap(id: string, from: string, to?: string, space?: string)"
+], He = P(Ue), v = (e, n, t) => {
+  const s = se(e, n, t), o = [];
   for (let r = 0; r < s.length - 1; r += 2)
     o.push([s[r], s[r + 1]]);
   return o;
-}, He = (e, ...t) => {
-  if (t.length === 0) return e;
-  const n = P(e), s = ([i, c]) => e.slice(i, c), o = new d(), r = new d();
-  for (const i of t)
-    for (const [c, l] of C(e, i, n)) {
-      o.push(c.range[1], l.range[0]);
-      const [a, ...u] = s([c.range[1], l.range[0]]), p = u[u.length - 1];
-      r.push(c.range[0], c.range[1] + (a.trim() ? 0 : 1)), r.push(l.range[0], l.range[1] + (p.trim() ? 0 : 1));
+}, Ge = (e, ...n) => {
+  if (n.length === 0) return e;
+  const t = W(e), s = ([i, l]) => e.slice(i, l), o = new d(), r = new d();
+  for (const i of n)
+    for (const [l, c] of v(e, i, t)) {
+      o.push(l.range[1], c.range[0]);
+      const [a, ...u] = s([l.range[1], c.range[0]]), p = u[u.length - 1];
+      r.push(l.range[0], l.range[1] + (a.trim() ? 0 : 1)), r.push(c.range[0], c.range[1] + (p.trim() ? 0 : 1));
     }
-  return o.collapse(), r.collapse(), R(
+  return o.collapse(), r.collapse(), j(
     o.subtract(r).map(s).filter(Boolean).join("")
   ).trim();
-}, Qe = (e, ...t) => {
-  if (t.length === 0) return e;
-  const n = P(e), s = ([i, c]) => e.slice(i, c), o = new d();
-  for (const i of t)
-    for (const [c, l] of C(e, i, n)) {
-      const a = s([l.range[1], l.range[1] + 1]).at(-1);
-      o.push(c.range[0], a === `
-` ? l.range[1] + 1 : l.range[1]);
+}, Qe = (e, ...n) => {
+  if (n.length === 0) return e;
+  const t = W(e), s = ([i, l]) => e.slice(i, l), o = new d();
+  for (const i of n)
+    for (const [l, c] of v(e, i, t)) {
+      const a = s([c.range[1], c.range[1] + 1]).at(-1);
+      o.push(l.range[0], a === `
+` ? c.range[1] + 1 : c.range[1]);
     }
   o.collapse();
   const r = new d([0, e.length]);
-  return r.subtract(o), R(
+  return r.subtract(o), j(
     r.collapse().map(s).filter(Boolean).join("")
   ).trim();
-}, ze = (e, t, n, s) => {
-  if (!t) return e;
+}, ze = (e, n, t, s) => {
+  if (!n) return e;
   let o = "", r = 0;
-  for (const [c, l] of C(e, t))
-    o += e.slice(r, c.range[1]), o += D(n ?? c.value, s), r = l.range[0];
+  for (const [l, c] of v(e, n))
+    o += e.slice(r, l.range[1]), o += N(t ?? l.value, s), r = c.range[0];
   o += e.slice(r);
   const i = new d([0, o.length]);
   return i.subtract(new d(
-    ...C(o, t).flatMap(([c, l]) => [c.range, l.range])
-  )), R(
-    i.collapse().map(([c, l]) => o.slice(c, l)).filter(Boolean).join("")
+    ...v(o, n).flatMap(([l, c]) => [l.range, c.range])
+  )), j(
+    i.collapse().map(([l, c]) => o.slice(l, c)).filter(Boolean).join("")
   ).trim();
-}, Xe = (e, t, n, s, o) => {
-  if (!t) return e;
-  const r = n === void 0 ? !1 : n >= 0, i = s ? D(s, o) : "", c = n ?? 0;
-  return C(e, t).map((l) => l[r ? 1 : 0]).sort(te).reverse().reduce(
-    (l, { range: a }) => r ? l.slice(0, a[1]) + i + l.slice(Math.min(a[1] + c, l.length)) : l.slice(0, Math.max(a[0] + c, 0)) + i + l.slice(a[0]),
+}, Xe = (e, n, t, s, o) => {
+  if (!n) return e;
+  const r = t === void 0 ? !1 : t >= 0, i = s ? N(s, o) : "", l = t ?? 0;
+  return v(e, n).map((c) => c[r ? 1 : 0]).sort(te).reverse().reduce(
+    (c, { range: a }) => r ? c.slice(0, a[1]) + i + c.slice(Math.min(a[1] + l, c.length)) : c.slice(0, Math.max(a[0] + l, 0)) + i + c.slice(a[0]),
     e
   );
-}, Ve = (e, t, n) => {
-  if (!t) return V(e);
-  const s = Ge(t);
+}, Ve = (e, n, t, s, o) => {
+  if (!n) return e;
+  let r = "", i = 0;
+  const l = [t, s ?? ""].map((c) => N(c, o));
+  console.log(l);
+  for (const [c, a] of v(e, n))
+    r += e.slice(i, c.range[1]), r += e.slice(c.range[1], a.range[0]).replaceAll(l[0], l[1]), i = a.range[0];
+  return r += e.slice(i), r;
+}, Je = (e, n, t) => {
+  if (!n) return J(e);
+  const s = He(n);
   switch (s.name) {
     case "extract":
-      e = He(e, s.id, ...Q(s));
+      e = Ge(e, s.id, ...z(s));
       break;
     case "remove":
-      e = Qe(e, s.id, ...Q(s));
+      e = Qe(e, s.id, ...z(s));
       break;
     case "replace":
       e = ze(e, s.id, s.with, s.space);
@@ -393,9 +405,12 @@ const Ue = [
     case "splice":
       e = Xe(e, s.id, s.deleteCount, s.insert, s.space);
       break;
+    case "remap":
+      e = Ve(e, s.id, s.from, s.to, s.space);
+      break;
   }
-  return n ? V(e) : e;
-}, Je = ["http", "./", "../"], Ze = ({ url: e }) => Je.some((t) => e.startsWith(t)), Ke = (e) => j(e) && xe(e) && Ze(e), se = ({ url: e }, t) => `[](${t ? y(t, e) : e})`, m = {
+  return t ? J(e) : e;
+}, Ze = ["http", "./", "../"], Ke = ({ url: e }) => Ze.some((n) => e.startsWith(n)), Ye = (e) => D(e) && xe(e) && Ke(e), oe = ({ url: e }, n) => `[](${n ? y(n, e) : e})`, m = {
   _open: "<!--",
   _close: "-->",
   _flag: "p↓",
@@ -406,21 +421,21 @@ const Ue = [
     return E(m._open, m._flag, "END", m._close);
   },
   lengthOf(e) {
-    const t = `lines: ${e.split(`
-`).length}`, n = `chars: ${e.length}`;
-    return E(m._open, m._flag, "length", t, n, m._close);
+    const n = `lines: ${e.split(`
+`).length}`, t = `chars: ${e.length}`;
+    return E(m._open, m._flag, "length", n, t, m._close);
   }
-}, J = (e) => (t) => j(t) && t.value === m[e], Ye = ({ position: e, url: t, siblingCount: n }, s) => ({ position: e, url: t, headingDepth: s, inline: n >= 1 }), et = ({ position: { start: e }, url: t, siblingCount: n }, { position: { end: s } }, o) => ({ position: { start: e, end: s }, url: t, headingDepth: o, inline: n >= 1 }), tt = (e, t, n) => (e.inline ? E : be)(
-  se(e, n),
+}, Z = (e) => (n) => D(n) && n.value === m[e], en = ({ position: e, url: n, siblingCount: t }, s) => ({ position: e, url: n, headingDepth: s, inline: t >= 1 }), nn = ({ position: { start: e }, url: n, siblingCount: t }, { position: { end: s } }, o) => ({ position: { start: e, end: s }, url: n, headingDepth: o, inline: t >= 1 }), tn = (e, n, t) => (e.inline ? E : be)(
+  oe(e, t),
   m.begin,
-  m.lengthOf(t),
-  t,
+  m.lengthOf(n),
+  n,
   m.end
-), nt = (e) => {
-  const t = S(e, "heading").reduce((n, { position: s, depth: o }) => n.set(s.start.line, o), /* @__PURE__ */ new Map());
-  return (n) => {
-    for (let s = n.position.start.line; s >= 1; s--) {
-      const o = t.get(s);
+), sn = (e) => {
+  const n = S(e, "heading").reduce((t, { position: s, depth: o }) => t.set(s.start.line, o), /* @__PURE__ */ new Map());
+  return (t) => {
+    for (let s = t.position.start.line; s >= 1; s--) {
+      const o = n.get(s);
       if (o) return o;
     }
     return 0;
@@ -429,27 +444,27 @@ const Ue = [
   openingCommentDoesNotFollowLink: ({ position: { start: e } }) => new Error(`Opening comment (@${e.line}:${e.column}) does not follow link`),
   closingCommentNotMatchedToOpening: ({ position: { start: e } }) => new Error(`Closing comment (@${e.line}:${e.column}) does not match to opening comment`),
   openingCommentNotClosed: ({ position: { start: e } }) => new Error(`Opening comment (@${e.line}:${e.column}) is not followed by a closing comment`)
-}, st = (e, t) => {
-  const n = [], s = [
+}, on = (e, n) => {
+  const t = [], s = [
     ...e.map((r) => ({ node: r, type: "open" })),
-    ...t.map((r) => ({ node: r, type: "close" }))
-  ].sort((r, i) => g(r.node, i.node)), o = [];
+    ...n.map((r) => ({ node: r, type: "close" }))
+  ].sort((r, i) => f(r.node, i.node)), o = [];
   for (const r of s)
     if (r.type === "open") o.push(r);
     else {
       const i = r.node;
       if (o.length === 0)
         throw x.closingCommentNotMatchedToOpening(i);
-      const c = o.pop().node;
+      const l = o.pop().node;
       if (o.length > 0) continue;
-      n.push({ open: c, close: i });
+      t.push({ open: l, close: i });
     }
   if (o.length > 0)
     throw x.openingCommentNotClosed(o[0].node);
-  return n;
-}, ot = (e, t, n) => {
-  const s = [...t].sort(g), o = [];
-  return [...n].sort((r, i) => g.reverse(r.open, i.open)).forEach((r) => {
+  return t;
+}, rn = (e, n, t) => {
+  const s = [...n].sort(f), o = [];
+  return [...t].sort((r, i) => f.reverse(r.open, i.open)).forEach((r) => {
     for (; s.length > 0; ) {
       const i = s.pop();
       if (i.position.start.offset < r.open.position.start.offset) {
@@ -461,77 +476,84 @@ const Ue = [
     }
     throw x.openingCommentDoesNotFollowLink(r.open);
   }), o.push(...s.reverse()), o.reverse();
-}, oe = (e, t) => {
-  t ?? (t = A.md(e));
-  const n = nt(t), s = S(t, "link").filter(Ke), o = S(t, "html").sort(g), r = o.filter(J("begin")), i = o.filter(J("end")), c = st(r, i);
-  return ot(e, s, c).map((a) => Array.isArray(a) ? et(a[0], a[1].close, n(a[0])) : Ye(a, n(a)));
-}, rt = (e, { url: t }) => (n) => e(y(O(t), n)), re = (...e) => {
-  const t = e.reduce((n, s) => n + s, 0);
-  return Math.min(Math.max(t, 1), 6);
-}, it = (e, t, n) => {
-  if (t === 0) return e;
-  n ?? (n = A.md(e));
-  const s = S(n, "heading"), o = e.split(`
+}, re = (e, n) => {
+  n ?? (n = I.md(e));
+  const t = sn(n), s = S(n, "link").filter(Ye), o = S(n, "html").sort(f), r = o.filter(Z("begin")), i = o.filter(Z("end")), l = on(r, i);
+  return rn(e, s, l).map((a) => Array.isArray(a) ? nn(a[0], a[1].close, t(a[0])) : en(a, t(a)));
+}, ln = (e, { url: n }) => (t) => e(y(A(n), t)), ie = (...e) => {
+  const n = e.reduce((t, s) => t + s, 0);
+  return Math.min(Math.max(n, 1), 6);
+}, cn = (e, n, t) => {
+  if (n === 0) return e;
+  t ?? (t = I.md(e));
+  const s = S(t, "heading"), o = e.split(`
 `);
   for (const r of s) {
-    const { depth: i, position: { start: c, end: l } } = r, a = re(i, t), u = o[c.line - 1].slice(i, l.column), p = "#".repeat(a) + u;
-    o[c.line - 1] = p, r.depth = a;
+    const { depth: i, position: { start: l, end: c } } = r, a = ie(i, n), u = o[l.line - 1].slice(i, c.column), p = "#".repeat(a) + u;
+    o[l.line - 1] = p, r.depth = a;
   }
   return o.join(`
 `);
-}, ie = (e) => oe(e).reverse().sort(g.reverse).reduce((t, n) => Y(t, se(n), n), e), ce = (e, t, n, s, o) => {
+}, le = (e) => re(e).reverse().sort(f.reverse).reduce((n, t) => ee(n, oe(t), t), e), ce = (e, n, t, s, o) => {
   try {
-    e = ie(e), e = it(e, t);
-    const r = A.md(e);
-    return oe(e, r).sort(g).reverse().map((i) => {
-      var L, q;
-      const { url: c, headingDepth: l } = i, [a, ...u] = we(c).split("?"), p = a.split(".").pop() ?? "", pe = u.join("?"), N = O(c), W = y(N, a);
-      if (c.startsWith("./") || c.startsWith("../")) {
-        let h = n(W);
-        const v = new $e(pe), b = (L = v.get("region")) == null ? void 0 : L.split(F);
-        h = (b == null ? void 0 : b.reduce(
-          (w, $, _, { length: ge }) => Ve(w, $, _ === ge - 1),
-          h
-        )) ?? h;
-        const me = v.has("skip"), ue = v.get("heading") ?? 0, he = v.has("inline");
-        let { inline: k } = i;
-        if (he && (k = !0), !me)
+    e = le(e), e = cn(e, n);
+    const r = I.md(e);
+    return re(e, r).sort(f).reverse().map((i) => {
+      var q, B;
+      const { url: l, headingDepth: c } = i, [a, ...u] = $e(l).split("?"), p = a.split(".").pop() ?? "", b = u.join("?"), k = A(l), L = y(k, a);
+      if (l.startsWith("./") || l.startsWith("../")) {
+        let g = t(L);
+        const $ = new Ce(b), M = (q = $.get("region")) == null ? void 0 : q.split(U);
+        g = (M == null ? void 0 : M.reduce(
+          (C, w, O, { length: fe }) => Je(C, w, O === fe - 1),
+          g
+        )) ?? g;
+        const me = $.has("skip"), ue = $.get("heading") ?? 0, ge = $.has("inline");
+        let { inline: _ } = i;
+        if (ge && (_ = !0), !me)
           if (p === "md") {
-            const w = rt(n, i), $ = o ? y(o, N) : N, _ = re(l, Number(ue));
-            h = ce(
-              h,
+            const C = ln(t, i), w = o ? y(o, k) : k, O = ie(c, Number(ue));
+            g = ce(
+              g,
               /** p↓: ... */
-              _,
-              w,
-              W,
-              $
+              O,
+              C,
+              L,
+              w
               /** p↓: ... */
             );
-          } else /^(js|ts)x?|svelte$/i.test(p) && (h = z(
-            h,
+          } else /^(js|ts)x?|svelte$/i.test(p) && (g = X(
+            g,
             "code",
             /** p↓: ... */
-            { extension: p, inline: k }
+            { extension: p, inline: _ }
             /** p↓: ... */
           ));
-        const M = (q = v.get("wrap")) == null ? void 0 : q.split(F);
-        return h = (M == null ? void 0 : M.reduce((w, $) => z(w, $, { extension: p, inline: k }), h)) ?? h, { target: i, content: tt(i, h, o) };
-      } else throw c.startsWith("http") ? new Error("External web links are not implemented yet") : new Error(`Unsupported link type: ${c}`);
-    }).reduce((i, { target: c, content: l }) => Y(i, l, c), e);
+        const R = (B = $.get("wrap")) == null ? void 0 : B.split(U);
+        return g = (R == null ? void 0 : R.reduce((C, w) => X(C, w, { extension: p, inline: _ }), g)) ?? g, { target: i, content: tn(i, g, o) };
+      } else throw l.startsWith("http") ? new Error("External web links are not implemented yet") : new Error(`Unsupported link type: ${l}`);
+    }).reduce((i, { target: l, content: c }) => ee(i, c, l), e);
   } catch (r) {
     throw new Error(`Error populating inclusions in file ${s ?? "(unknown)"}: ${r}`);
   }
-}, le = (e) => ve(e, "utf-8"), ae = (e) => {
-  const t = K(e), n = O(t);
-  return { markdown: le(t), dir: n, path: t };
-}, ft = (e, t = !0) => {
-  const { dir: n, path: s, markdown: o } = ae(e), i = ce(o, 0, (c) => le(K(n, Me(c))), s);
-  return t && Z(s, i), i;
-}, dt = (e, t = !0) => {
-  const { path: n, markdown: s } = ae(e), o = ie(s);
-  return t && Z(n, o), o;
+}, ae = (e) => ve(e, "utf-8"), pe = (e) => {
+  const n = Y(e), t = A(n);
+  return { content: ae(n), dir: t, path: n };
+}, an = (e, n = !0, t) => {
+  const { dir: s, path: o, content: r } = pe(e);
+  t == null || t.unwatch(o), t == null || t.once("change", (c, a) => {
+    console.log(`Change detected in "${c}". Regenerating "${o}"...`), an(e, n, t);
+  });
+  const l = ce(r, 0, (c) => {
+    const a = Y(s, Me(c));
+    return t == null || t.add(a), ae(a);
+  }, o);
+  return n && K(o, l), t == null || t.add(o), l;
+}, $n = (e, n = !0, t) => {
+  const { path: s, content: o } = pe(e), r = le(o);
+  return n && K(s, r), r;
 };
 export {
-  dt as depopulateMarkdownInclusions,
-  ft as populateMarkdownInclusions
+  $n as depopulateMarkdownInclusions,
+  an as populateMarkdownInclusions
 };

package/dist/index.umd.cjs

@@ -1,14 +1,15 @@
-(function(p,m){typeof exports=="object"&&typeof module<"u"?m(exports,require("node:fs"),require("node:path"),require("node:url"),require("unified"),require("remark-parse"),require("unist-util-visit"),require("ts-dedent")):typeof define=="function"&&define.amd?define(["exports","node:fs","node:path","node:url","unified","remark-parse","unist-util-visit","ts-dedent"],m):(p=typeof globalThis<"u"?globalThis:p||self,m(p.index={},p.node_fs,p.node_path,p.node_url,p.unified,p.remarkParse,p.unistUtilVisit,p.tsDedent))})(this,function(p,m,d,ae,pe,ue,me,M){"use strict";var nn=Object.defineProperty;var tn=(p,m,d)=>m in p?nn(p,m,{enumerable:!0,configurable:!0,writable:!0,value:d}):p[m]=d;var le=(p,m,d)=>tn(p,typeof m!="symbol"?m+"":m,d);const v=(e,n)=>e.position.start.offset-n.position.start.offset;v.reverse=(e,n)=>v(n,e);const b=e=>e.position!==void 0&&e.position.start.offset!==void 0&&e.position.end.offset!==void 0,de=pe.unified().use(ue),T={md:e=>de.parse(e)},x=(e,n)=>{const t=[];return me.visit(e,(s,o,r)=>{if(s.type!=="root"){if(n&&s.type!==n)return;if(b(s)){const i=((r==null?void 0:r.children.length)??0)-1;t.push({...s,siblingIndex:o,siblingCount:i})}}}),t},fe=e=>e.children.length===0,_=(e,n,...t)=>{if(t.length===0)throw new Error("No nodes to replace content from");t.sort(v);const s=t.at(0),o=t.at(-1);return e.slice(0,s.position.start.offset)+n+e.slice(o.position.end.offset)},he=(e,n,t)=>{const s=Math.min(n.position.end.offset,t.position.end.offset),o=Math.max(n.position.start.offset,t.position.start.offset);return e.slice(s,o)},k=(...e)=>e.join(" "),ge=(...e)=>e.join(`
-`),ve=e=>{const n=e.split("?");return n.length>1?[n.slice(0,-1).join("?"),n.at(-1)]:[e,""]},we=e=>ve(e)[0];class w{constructor(...n){le(this,"intervals",[]);for(const[t,s]of n)this.push(t,s)}push(n,t){this.intervals.push([Math.min(n,t),Math.max(n,t)])}combine(n){this.intervals.push(...n.intervals)}collapse(){const{intervals:n}=this;if(!n.length)return this.intervals=[];n.sort((r,i)=>r[0]-i[0]);const t=[];let[s,o]=n[0];for(let r=1;r<n.length;r++){const[i,c]=n[r];i<=o?o=Math.max(o,c):(t.push([s,o]),s=i,o=c)}return t.push([s,o]),this.intervals=t}subtract(n){const{intervals:t}=this,{intervals:s}=n;if(!t.length||!s.length)return t;let o=[...t];for(const[r,i]of s){const c=[];for(const[l,a]of o){if(i<=l||r>=a){c.push([l,a]);continue}r>l&&c.push([l,r]),i<a&&c.push([i,a])}o=c}return this.intervals=o}}const L=/,\s*(?![^()]*\))/,F={reserved:{semi:";",slash:"/",question:"?",colon:":",at:"@",equal:"=",and:"&"},unsafe:{quote:'"',angle:"<",unangle:">",hash:"#",percent:"%",curly:"{",uncurly:"}",pipe:"|",back:"\\",carrot:"^",tilde:"~",square:"[",unsquare:"]",tick:"`",line:`
-`}},$e="-",B={static:[["'''",'"'],["''","'"],[/parkdown:\s+/g,""],[/p↓:\s+/g,""]],url:[...Object.entries(F.unsafe),...Object.entries(F.reserved)]},U=(e,[n,t])=>e.replaceAll(n,t),j=(e,n=$e)=>{const t=B.static.reduce(U,e);return B.url.map(([s,o])=>[n+s+n,o]).reduce(U,t).replaceAll(n," ")},Ce=e=>e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),ye=["string","number","boolean"],Ee=e=>ye.includes(e),Se=/^([a-zA-Z0-9_-]+)(?:\(([^)]*)\))?$/,xe=e=>{const n=e.match(Se);if(!n)throw new Error(`Invalid invocation: ${e}`);const[,t,s=""]=n;if(!s.trim())return{name:t,parameters:[]};const o=Ne(s);return{name:t,parameters:o}},ke=(e,n)=>{for(let t=n+1;t<e.length;t++)if(e[t]!==void 0)return!1;return!0},Ne=e=>{const n=[];let t="",s=!1;for(let o=0;o<e.length;o++){const r=e[o],i=r==="'";if(i&&e.at(o+1)==="'"){const c=e.at(o+2)==="'";s=!s,t+=c?"'''":"''",o+=c?2:1}else i?(s=!s,t+=r):r===","&&!s?(n.push(t.trim()),t=""):t+=r}return n.push(t.trim()),n.map(o=>o===""?void 0:o?Me(o):void 0).filter((o,r,i)=>o!==void 0||!ke(i,r))},Me=e=>{const n=e.length>=2&&e[0]==="'"&&e.at(-1)==="'",t=n&&e.length>=4&&e[1]==="'"&&e.at(-2)==="'";return!n||t?e:e.slice(1,-1)},be=e=>{const n=/^(\w+)(?:\(([^)]*)\))?/,t=e.match(n);if(!t)return{name:e};const[,s,o]=t;if(!o)return{name:s};const r=/(\w+)(\?)?:\s*([^,]+)/g,i=[];let c;for(;(c=r.exec(o))!==null;){const[,l,a,h]=c,u=h.trim();if(!Ee(u))throw new Error(`Unsupported type: ${u}`);i.push({name:l,optional:a==="?",type:u})}return{name:s,parameters:i}},O=e=>{const n=e.map(be).reduce((t,{name:s,parameters:o})=>t.set(s,o),new Map);return t=>{const{name:s,parameters:o}=xe(t);if(!n.has(s))throw new Error(`Unknown method: ${s}`);const r=n.get(s);if(r===void 0)return{name:s};if(o.length>r.length){const i=r.filter(({optional:l})=>!l).length,c=i===r.length?i.toString():`${i} - ${r.length}`;throw new Error(`Too many parameters: ${o.length} for method '${s}' (expected: ${c})`)}return r.reduce((i,{name:c,optional:l,type:a},h)=>{const u=o[h];if(u===void 0){if(l)return i;throw new Error(`Missing required parameter: ${c} for method '${s}'`)}switch(a){case"string":i[c]=u;break;case"number":case"boolean":i[c]=JSON.parse(u);break}if(typeof i[c]!==a)throw new Error(`Invalid type: ${c} must be ${a}, got ${typeof i[c]} for method '${s}'`);return i},{name:s})}},G=e=>Object.entries(e).filter(([n])=>n!=="name"&&!isNaN(Number(n))).map(([n,t])=>t),Te=O(["code(lang?: string, meta?: string)","quote()","dropdown(summary: string, open?: boolean, space?: string)"]),$=(e,n=1)=>`
+(function(p,m){typeof exports=="object"&&typeof module<"u"?m(exports,require("node:fs"),require("node:path"),require("node:url"),require("unified"),require("remark-parse"),require("unist-util-visit"),require("ts-dedent")):typeof define=="function"&&define.amd?define(["exports","node:fs","node:path","node:url","unified","remark-parse","unist-util-visit","ts-dedent"],m):(p=typeof globalThis<"u"?globalThis:p||self,m(p.index={},p.node_fs,p.node_path,p.node_url,p.unified,p.remarkParse,p.unistUtilVisit,p.tsDedent))})(this,function(p,m,d,ue,me,de,ge,M){"use strict";var tn=Object.defineProperty;var sn=(p,m,d)=>m in p?tn(p,m,{enumerable:!0,configurable:!0,writable:!0,value:d}):p[m]=d;var pe=(p,m,d)=>sn(p,typeof m!="symbol"?m+"":m,d);const v=(e,n)=>e.position.start.offset-n.position.start.offset;v.reverse=(e,n)=>v(n,e);const T=e=>e.position!==void 0&&e.position.start.offset!==void 0&&e.position.end.offset!==void 0,fe=me.unified().use(de),j={md:e=>fe.parse(e)},x=(e,n)=>{const t=[];return ge.visit(e,(s,o,r)=>{if(s.type!=="root"){if(n&&s.type!==n)return;if(T(s)){const i=((r==null?void 0:r.children.length)??0)-1;t.push({...s,siblingIndex:o,siblingCount:i})}}}),t},he=e=>e.children.length===0,L=(e,n,...t)=>{if(t.length===0)throw new Error("No nodes to replace content from");t.sort(v);const s=t.at(0),o=t.at(-1);return e.slice(0,s.position.start.offset)+n+e.slice(o.position.end.offset)},ve=(e,n,t)=>{const s=Math.min(n.position.end.offset,t.position.end.offset),o=Math.max(n.position.start.offset,t.position.start.offset);return e.slice(s,o)},N=(...e)=>e.join(" "),$e=(...e)=>e.join(`
+`),Ce=e=>{const n=e.split("?");return n.length>1?[n.slice(0,-1).join("?"),n.at(-1)]:[e,""]},we=e=>Ce(e)[0];class ${constructor(...n){pe(this,"intervals",[]);for(const[t,s]of n)this.push(t,s)}push(n,t){this.intervals.push([Math.min(n,t),Math.max(n,t)])}combine(n){this.intervals.push(...n.intervals)}collapse(){const{intervals:n}=this;if(!n.length)return this.intervals=[];n.sort((r,i)=>r[0]-i[0]);const t=[];let[s,o]=n[0];for(let r=1;r<n.length;r++){const[i,l]=n[r];i<=o?o=Math.max(o,l):(t.push([s,o]),s=i,o=l)}return t.push([s,o]),this.intervals=t}subtract(n){const{intervals:t}=this,{intervals:s}=n;if(!t.length||!s.length)return t;let o=[...t];for(const[r,i]of s){const l=[];for(const[c,a]of o){if(i<=c||r>=a){l.push([c,a]);continue}r>c&&l.push([c,r]),i<a&&l.push([i,a])}o=l}return this.intervals=o}}const B=/,\s*(?![^()]*\))/,F={reserved:{semi:";",slash:"/",question:"?",colon:":",at:"@",equal:"=",and:"&"},unsafe:{quote:'"',angle:"<",unangle:">",hash:"#",percent:"%",curly:"{",uncurly:"}",pipe:"|",back:"\\",carrot:"^",tilde:"~",square:"[",unsquare:"]",tick:"`",line:`
+`}},ye="-",U={static:[["'''",'"'],["''","'"],[/parkdown:\s+/g,""],[/p↓:\s+/g,""]],url:[...Object.entries(F.unsafe),...Object.entries(F.reserved)]},H=(e,[n,t])=>e.replaceAll(n,t),k=(e,n=ye)=>{const t=U.static.reduce(H,e);return U.url.map(([s,o])=>[n+s+n,o]).reduce(H,t).replaceAll(n," ")},Se=e=>e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),Ee=["string","number","boolean"],xe=e=>Ee.includes(e),Ne=/^([a-zA-Z0-9_-]+)(?:\(([^)]*)\))?$/,ke=e=>{const n=e.match(Ne);if(!n)throw new Error(`Invalid invocation: ${e}`);const[,t,s=""]=n;if(!s.trim())return{name:t,parameters:[]};const o=Me(s);return{name:t,parameters:o}},be=(e,n)=>{for(let t=n+1;t<e.length;t++)if(e[t]!==void 0)return!1;return!0},Me=e=>{const n=[];let t="",s=!1;for(let o=0;o<e.length;o++){const r=e[o],i=r==="'";if(i&&e.at(o+1)==="'"){const l=e.at(o+2)==="'";s=!s,t+=l?"'''":"''",o+=l?2:1}else i?(s=!s,t+=r):r===","&&!s?(n.push(t.trim()),t=""):t+=r}return n.push(t.trim()),n.map(o=>o===""?void 0:o?Te(o):void 0).filter((o,r,i)=>o!==void 0||!be(i,r))},Te=e=>{const n=e.length>=2&&e[0]==="'"&&e.at(-1)==="'",t=n&&e.length>=4&&e[1]==="'"&&e.at(-2)==="'";return!n||t?e:e.slice(1,-1)},je=e=>{const n=/^(\w+)(?:\(([^)]*)\))?/,t=e.match(n);if(!t)return{name:e};const[,s,o]=t;if(!o)return{name:s};const r=/(\w+)(\?)?:\s*([^,]+)/g,i=[];let l;for(;(l=r.exec(o))!==null;){const[,c,a,f]=l,u=f.trim();if(!xe(u))throw new Error(`Unsupported type: ${u}`);i.push({name:c,optional:a==="?",type:u})}return{name:s,parameters:i}},O=e=>{const n=e.map(je).reduce((t,{name:s,parameters:o})=>t.set(s,o),new Map);return t=>{const{name:s,parameters:o}=ke(t);if(!n.has(s))throw new Error(`Unknown method: ${s}`);const r=n.get(s);if(r===void 0)return{name:s};if(o.length>r.length){const i=r.filter(({optional:c})=>!c).length,l=i===r.length?i.toString():`${i} - ${r.length}`;throw new Error(`Too many parameters: ${o.length} for method '${s}' (expected: ${l})`)}return r.reduce((i,{name:l,optional:c,type:a},f)=>{const u=o[f];if(u===void 0){if(c)return i;throw new Error(`Missing required parameter: ${l} for method '${s}'`)}switch(a){case"string":i[l]=u;break;case"number":case"boolean":i[l]=JSON.parse(u);break}if(typeof i[l]!==a)throw new Error(`Invalid type: ${l} must be ${a}, got ${typeof i[l]} for method '${s}'`);return i},{name:s})}},G=e=>Object.entries(e).filter(([n])=>n!=="name"&&!isNaN(Number(n))).map(([n,t])=>t),Oe=O(["code(lang?: string, meta?: string)","quote()","dropdown(summary: string, open?: boolean, space?: string)"]),C=(e,n=1)=>`
 `.repeat(n)+e+`
-`.repeat(n),q=(e,n,t)=>`<${n}${t?` ${t}`:""}>${$(e)}</${n}>`,H=(e,n,t)=>{const s=Te(n);switch(s.name){case"code":if(!s.lang&&!s.meta&&(t==null?void 0:t.inline)&&!e.includes(`
-`))return`\`${e}\``;const r=s.lang??(t==null?void 0:t.extension)??"",i=s.meta?` ${s.meta}`:"";return $(`\`\`\`${r}${i}${$(e)}\`\`\``);case"quote":return t!=null&&t.inline&&!e.includes(`
+`.repeat(n),R=(e,n,t)=>`<${n}${t?` ${t}`:""}>${C(e)}</${n}>`,Q=(e,n,t)=>{const s=Oe(n);switch(s.name){case"code":if(!s.lang&&!s.meta&&(t==null?void 0:t.inline)&&!e.includes(`
+`))return`\`${e}\``;const r=s.lang??(t==null?void 0:t.extension)??"",i=s.meta?` ${s.meta}`:"";return C(`\`\`\`${r}${i}${C(e)}\`\`\``);case"quote":return t!=null&&t.inline&&!e.includes(`
 
-`)?`> ${e}`:$(q($(e),"blockquote"));case"dropdown":const c=q(j(s.summary),"summary");return $(q([c,e].join(`
-`),"details",s.open?"open":void 0))}},R=e=>{const n=/(\/\/[^\n]*|\/\*[\s\S]*?\*\/|<!--[\s\S]*?-->)/gm,t=[];let s;for(;(s=n.exec(e))!==null;){const o=[s.index,s.index+s[0].length],r=je(s[0]).trim();t.push({range:o,value:r})}return t},je=e=>e.startsWith("//")?e.slice(2):e.startsWith("/*")?e.slice(2,-2):e.startsWith("<!--")?e.slice(4,-3):e,Q=["p↓:","pd:","parkdown:"];O(["splice(delete?: number, insert?: string)"]);const z=(e,n)=>e.range[0]-n.range[0],V=(e,n,t)=>(t??R(e)).filter(({value:s})=>s.includes(n)).sort(z),X=e=>({isSpace:e===" ",isNewline:e===`
-`||e===void 0}),J=e=>Q.flatMap(n=>V(e,n)).sort((n,t)=>n.range[0]-t.range[0]).reverse().reduce((n,{range:[t,s],value:o})=>{const r=(a,h)=>n.slice(0,a)+n.slice(h),i=X(n[t-1]),c=X(n[s]),l=s===n.length;return i.isNewline&&c.isNewline?r(t-(l?1:0),s+1):i.isNewline?r(t,s+(c.isSpace?1:0)):r(t-(i.isSpace?1:0),s)},e);Q.map(e=>new RegExp(`^${Ce(e)}(\\?[^\\s]+)`));const Oe=O(["extract(id: string, 0?: string, 1?: string, 2?: string)","remove(id: string, 0?: string, 1?: string, 2?: string)","replace(id: string, with?: string, space?: string)","splice(id: string, deleteCount?: number, insert?: string, space?: string)","remap(id: string, from: string, to: string, space?: string)"]),C=(e,n,t)=>{const s=V(e,n,t),o=[];for(let r=0;r<s.length-1;r+=2)o.push([s[r],s[r+1]]);return o},qe=(e,...n)=>{if(n.length===0)return e;const t=R(e),s=([i,c])=>e.slice(i,c),o=new w,r=new w;for(const i of n)for(const[c,l]of C(e,i,t)){o.push(c.range[1],l.range[0]);const[a,...h]=s([c.range[1],l.range[0]]),u=h[h.length-1];r.push(c.range[0],c.range[1]+(a.trim()?0:1)),r.push(l.range[0],l.range[1]+(u.trim()?0:1))}return o.collapse(),r.collapse(),M.dedent(o.subtract(r).map(s).filter(Boolean).join("")).trim()},Re=(e,...n)=>{if(n.length===0)return e;const t=R(e),s=([i,c])=>e.slice(i,c),o=new w;for(const i of n)for(const[c,l]of C(e,i,t)){const a=s([l.range[1],l.range[1]+1]).at(-1);o.push(c.range[0],a===`
-`?l.range[1]+1:l.range[1])}o.collapse();const r=new w([0,e.length]);return r.subtract(o),M.dedent(r.collapse().map(s).filter(Boolean).join("")).trim()},Ie=(e,n,t,s)=>{if(!n)return e;let o="",r=0;for(const[c,l]of C(e,n))o+=e.slice(r,c.range[1]),o+=j(t??c.value,s),r=l.range[0];o+=e.slice(r);const i=new w([0,o.length]);return i.subtract(new w(...C(o,n).flatMap(([c,l])=>[c.range,l.range]))),M.dedent(i.collapse().map(([c,l])=>o.slice(c,l)).filter(Boolean).join("")).trim()},Pe=(e,n,t,s,o)=>{if(!n)return e;const r=t===void 0?!1:t>=0,i=s?j(s,o):"",c=t??0;return C(e,n).map(l=>l[r?1:0]).sort(z).reverse().reduce((l,{range:a})=>r?l.slice(0,a[1])+i+l.slice(Math.min(a[1]+c,l.length)):l.slice(0,Math.max(a[0]+c,0))+i+l.slice(a[0]),e)},Ae=(e,n,t)=>{if(!n)return J(e);const s=Oe(n);switch(s.name){case"extract":e=qe(e,s.id,...G(s));break;case"remove":e=Re(e,s.id,...G(s));break;case"replace":e=Ie(e,s.id,s.with,s.space);break;case"splice":e=Pe(e,s.id,s.deleteCount,s.insert,s.space);break}return t?J(e):e},De=["http","./","../"],We=({url:e})=>De.some(n=>e.startsWith(n)),_e=e=>b(e)&&fe(e)&&We(e),Z=({url:e},n)=>`[](${n?d.join(n,e):e})`,f={_open:"<!--",_close:"-->",_flag:"p↓",get begin(){return k(f._open,f._flag,"BEGIN",f._close)},get end(){return k(f._open,f._flag,"END",f._close)},lengthOf(e){const n=`lines: ${e.split(`
-`).length}`,t=`chars: ${e.length}`;return k(f._open,f._flag,"length",n,t,f._close)}},K=e=>n=>b(n)&&n.value===f[e],Le=({position:e,url:n,siblingCount:t},s)=>({position:e,url:n,headingDepth:s,inline:t>=1}),Fe=({position:{start:e},url:n,siblingCount:t},{position:{end:s}},o)=>({position:{start:e,end:s},url:n,headingDepth:o,inline:t>=1}),Be=(e,n,t)=>(e.inline?k:ge)(Z(e,t),f.begin,f.lengthOf(n),n,f.end),Ue=e=>{const n=x(e,"heading").reduce((t,{position:s,depth:o})=>t.set(s.start.line,o),new Map);return t=>{for(let s=t.position.start.line;s>=1;s--){const o=n.get(s);if(o)return o}return 0}},N={openingCommentDoesNotFollowLink:({position:{start:e}})=>new Error(`Opening comment (@${e.line}:${e.column}) does not follow link`),closingCommentNotMatchedToOpening:({position:{start:e}})=>new Error(`Closing comment (@${e.line}:${e.column}) does not match to opening comment`),openingCommentNotClosed:({position:{start:e}})=>new Error(`Opening comment (@${e.line}:${e.column}) is not followed by a closing comment`)},Ge=(e,n)=>{const t=[],s=[...e.map(r=>({node:r,type:"open"})),...n.map(r=>({node:r,type:"close"}))].sort((r,i)=>v(r.node,i.node)),o=[];for(const r of s)if(r.type==="open")o.push(r);else{const i=r.node;if(o.length===0)throw N.closingCommentNotMatchedToOpening(i);const c=o.pop().node;if(o.length>0)continue;t.push({open:c,close:i})}if(o.length>0)throw N.openingCommentNotClosed(o[0].node);return t},He=(e,n,t)=>{const s=[...n].sort(v),o=[];return[...t].sort((r,i)=>v.reverse(r.open,i.open)).forEach(r=>{for(;s.length>0;){const i=s.pop();if(i.position.start.offset<r.open.position.start.offset){if(he(e,i,r.open).trim()!=="")throw N.openingCommentDoesNotFollowLink(r.open);return o.push([i,r])}o.push(i)}throw N.openingCommentDoesNotFollowLink(r.open)}),o.push(...s.reverse()),o.reverse()},Y=(e,n)=>{n??(n=T.md(e));const t=Ue(n),s=x(n,"link").filter(_e),o=x(n,"html").sort(v),r=o.filter(K("begin")),i=o.filter(K("end")),c=Ge(r,i);return He(e,s,c).map(a=>Array.isArray(a)?Fe(a[0],a[1].close,t(a[0])):Le(a,t(a)))},Qe=(e,{url:n})=>t=>e(d.join(d.dirname(n),t)),ee=(...e)=>{const n=e.reduce((t,s)=>t+s,0);return Math.min(Math.max(n,1),6)},ze=(e,n,t)=>{if(n===0)return e;t??(t=T.md(e));const s=x(t,"heading"),o=e.split(`
-`);for(const r of s){const{depth:i,position:{start:c,end:l}}=r,a=ee(i,n),h=o[c.line-1].slice(i,l.column),u="#".repeat(a)+h;o[c.line-1]=u,r.depth=a}return o.join(`
-`)},ne=e=>Y(e).reverse().sort(v.reverse).reduce((n,t)=>_(n,Z(t),t),e),te=(e,n,t,s,o)=>{try{e=ne(e),e=ze(e,n);const r=T.md(e);return Y(e,r).sort(v).reverse().map(i=>{var ie,ce;const{url:c,headingDepth:l}=i,[a,...h]=d.basename(c).split("?"),u=a.split(".").pop()??"",Je=h.join("?"),I=d.dirname(c),re=d.join(I,a);if(c.startsWith("./")||c.startsWith("../")){let g=t(re);const y=new ae.URLSearchParams(Je),P=(ie=y.get("region"))==null?void 0:ie.split(L);g=(P==null?void 0:P.reduce((E,S,W,{length:en})=>Ae(E,S,W===en-1),g))??g;const Ze=y.has("skip"),Ke=y.get("heading")??0,Ye=y.has("inline");let{inline:A}=i;if(Ye&&(A=!0),!Ze)if(u==="md"){const E=Qe(t,i),S=o?d.join(o,I):I,W=ee(l,Number(Ke));g=te(g,W,E,re,S)}else/^(js|ts)x?|svelte$/i.test(u)&&(g=H(g,"code",{extension:u,inline:A}));const D=(ce=y.get("wrap"))==null?void 0:ce.split(L);return g=(D==null?void 0:D.reduce((E,S)=>H(E,S,{extension:u,inline:A}),g))??g,{target:i,content:Be(i,g,o)}}else throw c.startsWith("http")?new Error("External web links are not implemented yet"):new Error(`Unsupported link type: ${c}`)}).reduce((i,{target:c,content:l})=>_(i,l,c),e)}catch(r){throw new Error(`Error populating inclusions in file ${s??"(unknown)"}: ${r}`)}},se=e=>m.readFileSync(e,"utf-8"),oe=e=>{const n=d.resolve(e),t=d.dirname(n);return{markdown:se(n),dir:t,path:n}},Ve=(e,n=!0)=>{const{dir:t,path:s,markdown:o}=oe(e),i=te(o,0,c=>se(d.resolve(t,we(c))),s);return n&&m.writeFileSync(s,i),i},Xe=(e,n=!0)=>{const{path:t,markdown:s}=oe(e),o=ne(s);return n&&m.writeFileSync(t,o),o};p.depopulateMarkdownInclusions=Xe,p.populateMarkdownInclusions=Ve,Object.defineProperty(p,Symbol.toStringTag,{value:"Module"})});
+`)?`> ${e}`:C(R(C(e),"blockquote"));case"dropdown":const l=R(k(s.summary),"summary");return C(R([l,e].join(`
+`),"details",s.open?"open":void 0))}},q=e=>{const n=/(\/\/[^\n]*|\/\*[\s\S]*?\*\/|<!--[\s\S]*?-->)/gm,t=[];let s;for(;(s=n.exec(e))!==null;){const o=[s.index,s.index+s[0].length],r=Re(s[0]).trim();t.push({range:o,value:r})}return t},Re=e=>e.startsWith("//")?e.slice(2):e.startsWith("/*")?e.slice(2,-2):e.startsWith("<!--")?e.slice(4,-3):e,z=["p↓:","pd:","parkdown:"];O(["splice(delete?: number, insert?: string)"]);const V=(e,n)=>e.range[0]-n.range[0],X=(e,n,t)=>(t??q(e)).filter(({value:s})=>s.split(" ").includes(n)).sort(V),J=e=>({isSpace:e===" ",isNewline:e===`
+`||e===void 0}),Z=e=>z.flatMap(n=>X(e,n)).sort((n,t)=>n.range[0]-t.range[0]).reverse().reduce((n,{range:[t,s],value:o})=>{const r=(u,I)=>n.slice(0,u)+n.slice(I),i=J(n[t-1]),l=J(n[s]),c=s===n.length;let a=t;for(;a>0&&n[a-1]!==`
+`;)a--;const f=n.slice(a,t).trim()==="";return i.isNewline&&l.isNewline?r(t-(c?1:0),s+1):i.isNewline||f?r(a,s+(l.isSpace||l.isNewline?1:0)):r(t-(i.isSpace?1:0),s)},e);z.map(e=>new RegExp(`^${Se(e)}(\\?[^\\s]+)`));const qe=O(["extract(id: string, 0?: string, 1?: string, 2?: string)","remove(id: string, 0?: string, 1?: string, 2?: string)","replace(id: string, with?: string, space?: string)","splice(id: string, deleteCount?: number, insert?: string, space?: string)","remap(id: string, from: string, to?: string, space?: string)"]),w=(e,n,t)=>{const s=X(e,n,t),o=[];for(let r=0;r<s.length-1;r+=2)o.push([s[r],s[r+1]]);return o},Ie=(e,...n)=>{if(n.length===0)return e;const t=q(e),s=([i,l])=>e.slice(i,l),o=new $,r=new $;for(const i of n)for(const[l,c]of w(e,i,t)){o.push(l.range[1],c.range[0]);const[a,...f]=s([l.range[1],c.range[0]]),u=f[f.length-1];r.push(l.range[0],l.range[1]+(a.trim()?0:1)),r.push(c.range[0],c.range[1]+(u.trim()?0:1))}return o.collapse(),r.collapse(),M.dedent(o.subtract(r).map(s).filter(Boolean).join("")).trim()},Ae=(e,...n)=>{if(n.length===0)return e;const t=q(e),s=([i,l])=>e.slice(i,l),o=new $;for(const i of n)for(const[l,c]of w(e,i,t)){const a=s([c.range[1],c.range[1]+1]).at(-1);o.push(l.range[0],a===`
+`?c.range[1]+1:c.range[1])}o.collapse();const r=new $([0,e.length]);return r.subtract(o),M.dedent(r.collapse().map(s).filter(Boolean).join("")).trim()},Pe=(e,n,t,s)=>{if(!n)return e;let o="",r=0;for(const[l,c]of w(e,n))o+=e.slice(r,l.range[1]),o+=k(t??l.value,s),r=c.range[0];o+=e.slice(r);const i=new $([0,o.length]);return i.subtract(new $(...w(o,n).flatMap(([l,c])=>[l.range,c.range]))),M.dedent(i.collapse().map(([l,c])=>o.slice(l,c)).filter(Boolean).join("")).trim()},De=(e,n,t,s,o)=>{if(!n)return e;const r=t===void 0?!1:t>=0,i=s?k(s,o):"",l=t??0;return w(e,n).map(c=>c[r?1:0]).sort(V).reverse().reduce((c,{range:a})=>r?c.slice(0,a[1])+i+c.slice(Math.min(a[1]+l,c.length)):c.slice(0,Math.max(a[0]+l,0))+i+c.slice(a[0]),e)},We=(e,n,t,s,o)=>{if(!n)return e;let r="",i=0;const l=[t,s??""].map(c=>k(c,o));console.log(l);for(const[c,a]of w(e,n))r+=e.slice(i,c.range[1]),r+=e.slice(c.range[1],a.range[0]).replaceAll(l[0],l[1]),i=a.range[0];return r+=e.slice(i),r},_e=(e,n,t)=>{if(!n)return Z(e);const s=qe(n);switch(s.name){case"extract":e=Ie(e,s.id,...G(s));break;case"remove":e=Ae(e,s.id,...G(s));break;case"replace":e=Pe(e,s.id,s.with,s.space);break;case"splice":e=De(e,s.id,s.deleteCount,s.insert,s.space);break;case"remap":e=We(e,s.id,s.from,s.to,s.space);break}return t?Z(e):e},Le=["http","./","../"],Be=({url:e})=>Le.some(n=>e.startsWith(n)),Fe=e=>T(e)&&he(e)&&Be(e),K=({url:e},n)=>`[](${n?d.join(n,e):e})`,g={_open:"<!--",_close:"-->",_flag:"p↓",get begin(){return N(g._open,g._flag,"BEGIN",g._close)},get end(){return N(g._open,g._flag,"END",g._close)},lengthOf(e){const n=`lines: ${e.split(`
+`).length}`,t=`chars: ${e.length}`;return N(g._open,g._flag,"length",n,t,g._close)}},Y=e=>n=>T(n)&&n.value===g[e],Ue=({position:e,url:n,siblingCount:t},s)=>({position:e,url:n,headingDepth:s,inline:t>=1}),He=({position:{start:e},url:n,siblingCount:t},{position:{end:s}},o)=>({position:{start:e,end:s},url:n,headingDepth:o,inline:t>=1}),Ge=(e,n,t)=>(e.inline?N:$e)(K(e,t),g.begin,g.lengthOf(n),n,g.end),Qe=e=>{const n=x(e,"heading").reduce((t,{position:s,depth:o})=>t.set(s.start.line,o),new Map);return t=>{for(let s=t.position.start.line;s>=1;s--){const o=n.get(s);if(o)return o}return 0}},b={openingCommentDoesNotFollowLink:({position:{start:e}})=>new Error(`Opening comment (@${e.line}:${e.column}) does not follow link`),closingCommentNotMatchedToOpening:({position:{start:e}})=>new Error(`Closing comment (@${e.line}:${e.column}) does not match to opening comment`),openingCommentNotClosed:({position:{start:e}})=>new Error(`Opening comment (@${e.line}:${e.column}) is not followed by a closing comment`)},ze=(e,n)=>{const t=[],s=[...e.map(r=>({node:r,type:"open"})),...n.map(r=>({node:r,type:"close"}))].sort((r,i)=>v(r.node,i.node)),o=[];for(const r of s)if(r.type==="open")o.push(r);else{const i=r.node;if(o.length===0)throw b.closingCommentNotMatchedToOpening(i);const l=o.pop().node;if(o.length>0)continue;t.push({open:l,close:i})}if(o.length>0)throw b.openingCommentNotClosed(o[0].node);return t},Ve=(e,n,t)=>{const s=[...n].sort(v),o=[];return[...t].sort((r,i)=>v.reverse(r.open,i.open)).forEach(r=>{for(;s.length>0;){const i=s.pop();if(i.position.start.offset<r.open.position.start.offset){if(ve(e,i,r.open).trim()!=="")throw b.openingCommentDoesNotFollowLink(r.open);return o.push([i,r])}o.push(i)}throw b.openingCommentDoesNotFollowLink(r.open)}),o.push(...s.reverse()),o.reverse()},ee=(e,n)=>{n??(n=j.md(e));const t=Qe(n),s=x(n,"link").filter(Fe),o=x(n,"html").sort(v),r=o.filter(Y("begin")),i=o.filter(Y("end")),l=ze(r,i);return Ve(e,s,l).map(a=>Array.isArray(a)?He(a[0],a[1].close,t(a[0])):Ue(a,t(a)))},Xe=(e,{url:n})=>t=>e(d.join(d.dirname(n),t)),ne=(...e)=>{const n=e.reduce((t,s)=>t+s,0);return Math.min(Math.max(n,1),6)},Je=(e,n,t)=>{if(n===0)return e;t??(t=j.md(e));const s=x(t,"heading"),o=e.split(`
+`);for(const r of s){const{depth:i,position:{start:l,end:c}}=r,a=ne(i,n),f=o[l.line-1].slice(i,c.column),u="#".repeat(a)+f;o[l.line-1]=u,r.depth=a}return o.join(`
+`)},te=e=>ee(e).reverse().sort(v.reverse).reduce((n,t)=>L(n,K(t),t),e),se=(e,n,t,s,o)=>{try{e=te(e),e=Je(e,n);const r=j.md(e);return ee(e,r).sort(v).reverse().map(i=>{var ce,ae;const{url:l,headingDepth:c}=i,[a,...f]=d.basename(l).split("?"),u=a.split(".").pop()??"",I=f.join("?"),A=d.dirname(l),le=d.join(A,a);if(l.startsWith("./")||l.startsWith("../")){let h=t(le);const y=new ue.URLSearchParams(I),P=(ce=y.get("region"))==null?void 0:ce.split(B);h=(P==null?void 0:P.reduce((S,E,_,{length:nn})=>_e(S,E,_===nn-1),h))??h;const Ke=y.has("skip"),Ye=y.get("heading")??0,en=y.has("inline");let{inline:D}=i;if(en&&(D=!0),!Ke)if(u==="md"){const S=Xe(t,i),E=o?d.join(o,A):A,_=ne(c,Number(Ye));h=se(h,_,S,le,E)}else/^(js|ts)x?|svelte$/i.test(u)&&(h=Q(h,"code",{extension:u,inline:D}));const W=(ae=y.get("wrap"))==null?void 0:ae.split(B);return h=(W==null?void 0:W.reduce((S,E)=>Q(S,E,{extension:u,inline:D}),h))??h,{target:i,content:Ge(i,h,o)}}else throw l.startsWith("http")?new Error("External web links are not implemented yet"):new Error(`Unsupported link type: ${l}`)}).reduce((i,{target:l,content:c})=>L(i,c,l),e)}catch(r){throw new Error(`Error populating inclusions in file ${s??"(unknown)"}: ${r}`)}},oe=e=>m.readFileSync(e,"utf-8"),re=e=>{const n=d.resolve(e),t=d.dirname(n);return{content:oe(n),dir:t,path:n}},ie=(e,n=!0,t)=>{const{dir:s,path:o,content:r}=re(e);t==null||t.unwatch(o),t==null||t.once("change",(c,a)=>{console.log(`Change detected in "${c}". Regenerating "${o}"...`),ie(e,n,t)});const l=se(r,0,c=>{const a=d.resolve(s,we(c));return t==null||t.add(a),oe(a)},o);return n&&m.writeFileSync(o,l),t==null||t.add(o),l},Ze=(e,n=!0,t)=>{const{path:s,content:o}=re(e),r=te(o);return n&&m.writeFileSync(s,r),r};p.depopulateMarkdownInclusions=Ze,p.populateMarkdownInclusions=ie,Object.defineProperty(p,Symbol.toStringTag,{value:"Module"})});

package/package.json

@@ -2,7 +2,7 @@
   "name": "@p-buddy/parkdown",
   "type": "module",
   "private": false,
-  "version": "0.0.11",
+  "version": "0.0.13",
   "main": "./dist/index.js",
   "bin": "./dist/cli.js",
   "files": [
@@ -24,6 +24,7 @@
   },
   "dependencies": {
     "@commander-js/extra-typings": "^13.1.0",
+    "chokidar": "^4.0.3",
     "remark-parse": "^11.0.0",
     "ts-dedent": "^2.2.0",
     "unified": "^11.0.5",