@p-buddy/parkdown 0.0.5 → 0.0.6

package/README.md

@@ -44,7 +44,7 @@ populateMarkdownInclusions(file, writeFile);
 
 [](./.assets/authoring.md)
 <!-- p↓ BEGIN -->
-<!-- p↓ length lines: 558 chars: 17214 -->
+<!-- p↓ length lines: 572 chars: 17752 -->
 ## 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`).
@@ -254,7 +254,7 @@ Before...
 
 [](.assets/query.md?heading=-1)
 <!-- p↓ BEGIN -->
-<!-- p↓ length lines: 347 chars: 12711 -->
+<!-- p↓ length lines: 361 chars: 13249 -->
 ### Query parameters
 
 You can pass query parameters to your inclusion links to control how their content is processed and included within your markdown.
@@ -294,6 +294,8 @@ Below is the currently supported API for the `region` query parameter, where eac
 - `[](<url>?region=remove(some-specifier))`
 - `[](<url>?region=replace(some-specifier,replacement-content))`
 
+If no value(s) are included (e.g. `[](<url>?region)`), then simply all comments that contain `parkdown:` or `p↓:` will be stripped (as is done as a post-processing step for all other `region` functionality).
+
 [](.assets/api-note.md?wrap=quote)
 <!-- p↓ BEGIN -->
 <!-- p↓ length lines: 9 chars: 352 -->
@@ -355,7 +357,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: 17 chars: 267 -->
+<!-- p↓ length lines: 21 chars: 525 -->
 
 <details>
 <summary>
@@ -364,11 +366,15 @@ See default processing behavior.
 
 ```ts
 if (extension === "md") {
-  ...
-  content = recursivelyPopulateInclusions(content, ...);
+ 
+  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);
 }
 else if (/^(js|ts)x?|svelte$/i.test(extension))
-  content = wrap(content, "code", ...);
+  content = wrap(content, "code", { extension, inline });
 ```
 
 </details>
@@ -422,6 +428,14 @@ If we instead wanted the included heading to remain a `h1` / `#` heading, we'd m
 [](./to-be-included.md?heading=-1)
 ```
 
+which would result in the following:
+
+```md
+# Heading
+
+# Included Heading
+```
+
 </details>
 
 #### `inline` (Advanced)
@@ -496,7 +510,7 @@ const definitions = [
 
 [](.assets/api.md?heading=-1)
 <!-- p↓ BEGIN -->
-<!-- p↓ length lines: 104 chars: 4981 -->
+<!-- p↓ length lines: 104 chars: 4973 -->
 #### 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:
@@ -570,7 +584,7 @@ const urlCharacters = {
 
 [](src/utils.ts?region=extract(sanitize))
 <!-- p↓ BEGIN -->
-<!-- p↓ length lines: 29 chars: 779 -->
+<!-- p↓ length lines: 29 chars: 771 -->
 
 ```ts
 type Replacement = [from: RegExp | string, to: string];
@@ -591,8 +605,8 @@ const replacements: Record<string, Replacement[]> = {
 const applyReplacement = (accumulator: string, [from, to]: Replacement) =>
   accumulator.replaceAll(from, to);
 
-export const sanitize = (replacement: string, space: string = DEFAULT_SPACE) => {
-  const sanitized = replacements.static.reduce(applyReplacement, replacement)
+export const sanitize = (content: string, space: string = DEFAULT_SPACE) => {
+  const sanitized = replacements.static.reduce(applyReplacement, content)
   return replacements.url
     .map(([key, to]) => ([space + key + space, to] satisfies Replacement))
     .reduce(applyReplacement, sanitized)

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { Command as t } from "@commander-js/extra-typings";
 import { populateMarkdownInclusions as r, depopulateMarkdownInclusions as l } from "@p-buddy/parkdown";
-const p = "0.0.5", f = new t().version(p).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("-r, --remap-imports", "Remap import specifiers in code blocks from one destination to another").parse(), { inclusions: a, depopulate: c, file: n, write: i } = f.opts();
+const p = "0.0.6", f = new t().version(p).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("-r, --remap-imports", "Remap import specifiers in code blocks from one destination to another").parse(), { inclusions: a, depopulate: c, file: n, write: i } = f.opts();
 n.length === 0 && n.push("README.md");
 const u = [
   [r, !a],

package/dist/index.js

@@ -1,43 +1,43 @@
-var ae = Object.defineProperty;
-var pe = (e, t, n) => t in e ? ae(e, t, { enumerable: !0, configurable: !0, writable: !0, value: n }) : e[t] = n;
-var q = (e, t, n) => pe(e, typeof t != "symbol" ? t + "" : t, n);
-import { writeFileSync as z, readFileSync as me } from "node:fs";
-import { basename as ue, dirname as O, join as S, resolve as X } from "node:path";
-import { URLSearchParams as he } from "node:url";
-import { unified as ge } from "unified";
-import fe from "remark-parse";
-import { visit as de } from "unist-util-visit";
-import ve from "stable-hash";
-import { dedent as T } from "ts-dedent";
-import we from "extract-comments";
-const g = (e, t) => e.position.start.offset - t.position.start.offset;
-g.reverse = (e, t) => g(t, e);
-const D = (e) => e.position !== void 0 && e.position.start.offset !== void 0 && e.position.end.offset !== void 0, $e = ge().use(fe), I = {
-  md: (e) => $e.parse(e)
-}, b = (e, t) => {
+var ue = Object.defineProperty;
+var me = (e, t, n) => t in e ? ue(e, t, { enumerable: !0, configurable: !0, writable: !0, value: n }) : e[t] = n;
+var q = (e, t, n) => me(e, typeof t != "symbol" ? t + "" : t, n);
+import { writeFileSync as J, readFileSync as he } from "node:fs";
+import { basename as fe, dirname as O, join as x, resolve as V } from "node:path";
+import { URLSearchParams as ge } from "node:url";
+import { unified as de } from "unified";
+import ve from "remark-parse";
+import { visit as we } from "unist-util-visit";
+import $e from "stable-hash";
+import { dedent as D } from "ts-dedent";
+import Ce from "extract-comments";
+const f = (e, t) => e.position.start.offset - t.position.start.offset;
+f.reverse = (e, t) => f(t, e);
+const I = (e) => e.position !== void 0 && e.position.start.offset !== void 0 && e.position.end.offset !== void 0, ye = de().use(ve), j = {
+  md: (e) => ye.parse(e)
+}, S = (e, t) => {
   const n = [];
-  return de(e, (s, o, r) => {
-    if (s.type !== "root") {
-      if (t && s.type !== t) return;
-      if (D(s)) {
-        const i = ve(r), c = ((r == null ? void 0 : r.children.length) ?? 0) - 1;
-        n.push({ ...s, parentID: i, siblingIndex: o, siblingCount: c });
+  return we(e, (o, s, r) => {
+    if (o.type !== "root") {
+      if (t && o.type !== t) return;
+      if (I(o)) {
+        const i = $e(r), c = ((r == null ? void 0 : r.children.length) ?? 0) - 1;
+        n.push({ ...o, parentID: i, siblingIndex: s, siblingCount: c });
       }
     }
   }), n;
-}, Ce = (e) => e.children.length === 0, J = (e, t, ...n) => {
+}, Ee = (e) => e.children.length === 0, Z = (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);
-}, ye = (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);
-  return e.slice(s, o);
-}, E = (...e) => e.join(" "), Ee = (...e) => e.join(`
-`), Se = (e) => {
+  n.sort(f);
+  const o = n.at(0), s = n.at(-1);
+  return e.slice(0, o.position.start.offset) + t + e.slice(s.position.end.offset);
+}, xe = (e, t, n) => {
+  const o = Math.min(t.position.end.offset, n.position.end.offset), s = Math.max(t.position.start.offset, n.position.start.offset);
+  return e.slice(o, s);
+}, E = (...e) => e.join(" "), Se = (...e) => e.join(`
+`), be = (e) => {
   const t = e.split("?");
   return t.length > 1 ? [t.slice(0, -1).join("?"), t.at(-1)] : [e, ""];
-}, be = (e) => Se(e)[0];
+}, ke = (e) => be(e)[0];
 class d {
   constructor() {
     q(this, "intervals", []);
@@ -53,32 +53,32 @@ class d {
     if (!t.length) return this.intervals = [];
     t.sort((r, i) => r[0] - i[0]);
     const n = [];
-    let [s, o] = t[0];
+    let [o, s] = 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);
+      i <= s ? s = Math.max(s, c) : (n.push([o, s]), o = i, s = c);
     }
-    return n.push([s, o]), this.intervals = n;
+    return n.push([o, s]), this.intervals = n;
   }
   subtract(t) {
-    const { intervals: n } = this, { intervals: s } = t;
-    if (!n.length || !s.length) return n;
-    let o = [...n];
-    for (const [r, i] of s) {
+    const { intervals: n } = this, { intervals: o } = t;
+    if (!n.length || !o.length) return n;
+    let s = [...n];
+    for (const [r, i] of o) {
       const c = [];
-      for (const [l, a] of o) {
+      for (const [l, a] of s) {
         if (i <= l || r >= a) {
           c.push([l, a]);
           continue;
         }
         r > l && c.push([l, r]), i < a && c.push([i, a]);
       }
-      o = c;
+      s = c;
     }
-    return this.intervals = o;
+    return this.intervals = s;
   }
 }
-const L = /,\s*(?![^()]*\))/, W = {
+const W = /,\s*(?![^()]*\))/, B = {
   reserved: {
     semi: ";",
     slash: "/",
@@ -104,7 +104,7 @@ const L = /,\s*(?![^()]*\))/, W = {
     unsquare: "]",
     tick: "`"
   }
-}, Ne = "-", B = {
+}, Ne = "-", F = {
   static: [
     ["'''", '"'],
     ["''", "'"],
@@ -112,87 +112,87 @@ const L = /,\s*(?![^()]*\))/, W = {
     [/p↓:\s+/g, ""]
   ],
   url: [
-    ...Object.entries(W.unsafe),
-    ...Object.entries(W.reserved)
+    ...Object.entries(B.unsafe),
+    ...Object.entries(B.reserved)
   ]
-}, F = (e, [t, n]) => e.replaceAll(t, n), V = (e, t = Ne) => {
-  const n = B.static.reduce(F, e);
-  return B.url.map(([s, o]) => [t + s + t, o]).reduce(F, n).replaceAll(t, " ");
-}, ke = ["string", "number", "boolean"], xe = (e) => ke.includes(e), Me = /^([a-zA-Z0-9_-]+)(?:\(([^)]*)\))?$/, _e = (e) => {
-  const t = e.match(Me);
+}, U = (e, [t, n]) => e.replaceAll(t, n), K = (e, t = Ne) => {
+  const n = F.static.reduce(U, e);
+  return F.url.map(([o, s]) => [t + o + t, s]).reduce(U, n).replaceAll(t, " ");
+}, Me = ["string", "number", "boolean"], _e = (e) => Me.includes(e), Te = /^([a-zA-Z0-9_-]+)(?:\(([^)]*)\))?$/, Oe = (e) => {
+  const t = e.match(Te);
   if (!t) throw new Error(`Invalid invocation: ${e}`);
-  const [, n, s = ""] = t;
-  if (!s.trim()) return { name: n, parameters: [] };
-  const o = Te(s);
-  return { name: n, parameters: o };
-}, Oe = (e, t) => {
+  const [, n, o = ""] = t;
+  if (!o.trim()) return { name: n, parameters: [] };
+  const s = Ie(o);
+  return { name: n, parameters: s };
+}, De = (e, t) => {
   for (let n = t + 1; n < e.length; n++)
     if (e[n] !== void 0) return !1;
   return !0;
-}, Te = (e) => {
+}, Ie = (e) => {
   const t = [];
-  let n = "", 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;
+  let n = "", o = !1;
+  for (let s = 0; s < e.length; s++) {
+    const r = e[s], i = r === "'";
+    if (i && e.at(s + 1) === "'") {
+      const c = e.at(s + 2) === "'";
+      o = !o, n += c ? "'''" : "''", s += c ? 2 : 1;
+    } else i ? (o = !o, n += r) : r === "," && !o ? (t.push(n.trim()), n = "") : n += r;
   }
-  return t.push(n.trim()), t.map((o) => o === "" ? void 0 : o ? De(o) : void 0).filter((o, r, i) => o !== void 0 || !Oe(i, r));
-}, De = (e) => {
+  return t.push(n.trim()), t.map((s) => s === "" ? void 0 : s ? je(s) : void 0).filter((s, r, i) => s !== void 0 || !De(i, r));
+}, je = (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);
-}, Ie = (e) => {
+}, Le = (e) => {
   const t = /^(\w+)(?:\(([^)]*)\))?/, n = e.match(t);
   if (!n) return { name: e };
-  const [, s, o] = n;
-  if (!o) return { name: s };
+  const [, o, s] = n;
+  if (!s) return { name: o };
   const r = /(\w+)(\?)?:\s*([^,]+)/g, i = [];
   let c;
-  for (; (c = r.exec(o)) !== null; ) {
-    const [, l, a, p] = c, m = p.trim();
-    if (!xe(m)) throw new Error(`Unsupported type: ${m}`);
-    i.push({ name: l, optional: a === "?", type: m });
+  for (; (c = r.exec(s)) !== null; ) {
+    const [, l, a, p] = c, u = p.trim();
+    if (!_e(u)) throw new Error(`Unsupported type: ${u}`);
+    i.push({ name: l, optional: a === "?", type: u });
   }
-  return { name: s, parameters: i };
-}, Z = (e) => {
-  const t = e.map(Ie).reduce(
-    (n, { name: s, parameters: o }) => n.set(s, o),
+  return { name: o, parameters: i };
+}, Y = (e) => {
+  const t = e.map(Le).reduce(
+    (n, { name: o, parameters: s }) => n.set(o, s),
     /* @__PURE__ */ new Map()
   );
   return (n) => {
-    const { name: s, parameters: o } = _e(n);
-    if (!t.has(s))
-      throw new Error(`Unknown method: ${s}`);
-    const r = t.get(s);
+    const { name: o, parameters: s } = Oe(n);
+    if (!t.has(o))
+      throw new Error(`Unknown method: ${o}`);
+    const r = t.get(o);
     if (r === void 0)
-      return { name: s };
-    if (o.length > r.length) {
+      return { name: o };
+    if (s.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})`);
+      throw new Error(`Too many parameters: ${s.length} for method '${o}' (expected: ${c})`);
     }
     return r.reduce((i, { name: c, optional: l, type: a }, p) => {
-      const m = o[p];
-      if (m === void 0) {
+      const u = s[p];
+      if (u === void 0) {
         if (l) return i;
-        throw new Error(`Missing required parameter: ${c} for method '${s}'`);
+        throw new Error(`Missing required parameter: ${c} for method '${o}'`);
       }
       switch (a) {
         case "string":
-          i[c] = m;
+          i[c] = u;
           break;
         case "number":
         case "boolean":
-          i[c] = JSON.parse(m);
+          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}'`);
+        throw new Error(`Invalid type: ${c} must be ${a}, got ${typeof i[c]} for method '${o}'`);
       return i;
-    }, { name: s });
+    }, { name: o });
   };
-}, U = (e) => Object.entries(e).filter(([t]) => t !== "name" && !isNaN(Number(t))).map(([t, n]) => n), je = [
+}, G = (e) => Object.entries(e).filter(([t]) => t !== "name" && !isNaN(Number(t))).map(([t, n]) => n), Ae = [
   /**
    * Wraps the content in a markdown-formatted code block.
    * @param lang The language of the code block (defaults to the file extension).
@@ -222,26 +222,26 @@ const L = /,\s*(?![^()]*\))/, W = {
    * @example [](<url>?wrap=dropdown(hello_world,,_)) 
    */
   "dropdown(summary: string, open?: boolean, space?: string)"
-], Re = Z(je), f = (e, t = 1) => `
+], Pe = Y(Ae), g = (e, t = 1) => `
 `.repeat(t) + e + `
-`.repeat(t), _ = (e, t, n) => `<${t}${n ? ` ${n}` : ""}>${f(e)}</${t}>`, G = (e, t, n) => {
-  const s = Re(t);
-  switch (s.name) {
+`.repeat(t), T = (e, t, n) => `<${t}${n ? ` ${n}` : ""}>${g(e)}</${t}>`, H = (e, t, n) => {
+  const o = Pe(t);
+  switch (o.name) {
     case "code":
-      if (!s.lang && !s.meta && (n == null ? void 0 : n.inline) && !e.includes(`
+      if (!o.lang && !o.meta && (n == null ? void 0 : n.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 = o.lang ?? (n == null ? void 0 : n.extension) ?? "", i = o.meta ? ` ${o.meta}` : "";
+      return g(`\`\`\`${r}${i}${g(e)}\`\`\``);
     case "quote":
       return n != null && n.inline && !e.includes(`
 
-`) ? `> ${e}` : f(_(f(e), "blockquote"));
+`) ? `> ${e}` : g(T(g(e), "blockquote"));
     case "dropdown":
-      const c = _(V(s.summary), "summary");
-      return f(_([c, e].join(`
-`), "details", s.open ? "open" : void 0));
+      const c = T(K(o.summary), "summary");
+      return g(T([c, e].join(`
+`), "details", o.open ? "open" : void 0));
   }
-}, Ae = [
+}, Re = [
   /**
    * Extract regions from the retrieved content between comments that INCLUDE the specified ids.
    * @param id The id of the comment to extract.
@@ -272,201 +272,214 @@ const L = /,\s*(?![^()]*\))/, W = {
    * @example [](<url>?region=replace(specifier,new_content,_)
    */
   "replace(id: string, with?: string, space?: string)"
-], Pe = Z(Ae), j = (e) => we(e), H = (e, t) => j(e).filter(({ value: n }) => n.includes(t)).sort((n, s) => n.range[0] - s.range[0]), qe = (e, ...t) => {
+], qe = Y(Re), L = (e) => Ce(e), b = (e, t) => L(e).filter(({ value: n }) => n.includes(t)).sort((n, o) => n.range[0] - o.range[0]), We = (e, ...t) => {
   if (t.length === 0) return e;
-  const n = ([i, c]) => e.slice(i, c), s = j(e), o = new d(), r = new d();
+  const n = ([i, c]) => e.slice(i, c), o = L(e), s = new d(), r = new d();
   for (const i of t) {
-    const c = s.filter(({ value: l }) => l.includes(i)).sort((l, a) => l.range[0] - a.range[0]);
+    const c = o.filter(({ value: l }) => l.includes(i)).sort((l, a) => l.range[0] - a.range[0]);
     for (let l = 0; l < c.length - 1; l += 2) {
       const a = c[l], p = c[l + 1];
-      o.push(a.range[1], p.range[0]);
-      const [m, ...y] = n([a.range[1], p.range[0]]), v = y[y.length - 1];
-      r.push(a.range[0], a.range[1] + (m.trim() ? 0 : 1)), r.push(p.range[0], p.range[1] + (v.trim() ? 0 : 1));
+      s.push(a.range[1], p.range[0]);
+      const [u, ...y] = n([a.range[1], p.range[0]]), v = y[y.length - 1];
+      r.push(a.range[0], a.range[1] + (u.trim() ? 0 : 1)), r.push(p.range[0], p.range[1] + (v.trim() ? 0 : 1));
     }
   }
-  return o.collapse(), r.collapse(), T(
-    o.subtract(r).map(n).filter(Boolean).join("")
+  return s.collapse(), r.collapse(), D(
+    s.subtract(r).map(n).filter(Boolean).join("")
   ).trim();
-}, Le = (e, ...t) => {
+}, Be = (e, ...t) => {
   if (t.length === 0) return e;
-  const n = ([i, c]) => e.slice(i, c), s = j(e), o = new d();
+  const n = ([i, c]) => e.slice(i, c), o = L(e), s = new d();
   for (const i of t) {
-    const c = s.filter(({ value: l }) => l.includes(i)).sort((l, a) => l.range[0] - a.range[0]);
+    const c = o.filter(({ value: l }) => l.includes(i)).sort((l, a) => l.range[0] - a.range[0]);
     for (let l = 0; l < c.length - 1; l += 2) {
-      const a = c[l], p = c[l + 1], m = n([p.range[1], p.range[1] + 1]).at(-1);
-      o.push(a.range[0], m === `
+      const a = c[l], p = c[l + 1], u = n([p.range[1], p.range[1] + 1]).at(-1);
+      s.push(a.range[0], u === `
 ` ? p.range[1] + 1 : p.range[1]);
     }
   }
-  o.collapse();
+  s.collapse();
   const r = new d();
-  return r.push(0, e.length), r.subtract(o), T(
+  return r.push(0, e.length), r.subtract(s), D(
     r.collapse().map(n).filter(Boolean).join("")
   ).trim();
-}, We = (e, t, n, s) => {
+}, Fe = (e, t, n, o) => {
   if (!t) return e;
-  const o = H(e, t);
-  if (o.length < 2) return e;
+  const s = b(e, t);
+  if (s.length < 2) return e;
   let r = "", i = 0;
-  for (let l = 0; l < o.length - 1; l += 2) {
-    const a = o[l], p = o[l + 1];
-    r += e.slice(i, a.range[1]), r += V(n ?? a.value, s), i = p.range[0];
+  for (let l = 0; l < s.length - 1; l += 2) {
+    const a = s[l], p = s[l + 1];
+    r += e.slice(i, a.range[1]), r += K(n ?? a.value, o), i = p.range[0];
   }
   r += e.slice(i);
   const c = new d();
   return c.push(0, r.length), c.subtract(
-    H(r, t).reduce((l, { range: a }) => (l.push(...a), l), new d())
-  ), T(
+    b(r, t).reduce((l, { range: a }) => (l.push(...a), l), new d())
+  ), D(
     c.collapse().map(([l, a]) => r.slice(l, a)).filter(Boolean).join("")
   ).trim();
-}, Be = (e, t) => {
-  const n = Pe(t);
+}, Q = (e) => ({ space: e === " ", newline: e === `
+` }), z = (e) => [
+  ...b(e, "p↓:"),
+  ...b(e, "parkdown:")
+].sort((t, n) => t.range[0] - n.range[0]).reverse().reduce((t, { range: [n, o], loc: { start: { column: s } } }) => {
+  const r = (l, a) => t.slice(0, l) + t.slice(a), i = {
+    prev: Q(t[n - 1]),
+    next: Q(t[o]),
+    startLine: s === 0,
+    final: o === t.length
+  };
+  return i.startLine && (i.next.newline || i.final) ? r(n - (i.final ? 1 : 0), o + 1) : i.startLine ? r(n, o + (i.next.space ? 1 : 0)) : r(n - (i.prev.space ? 1 : 0), o);
+}, e), Ue = (e, t) => {
+  if (!t) return z(e);
+  const n = qe(t);
   switch (n.name) {
     case "extract":
-      e = qe(e, n.id, ...U(n));
+      e = We(e, n.id, ...G(n));
       break;
     case "remove":
-      e = Le(e, n.id, ...U(n));
+      e = Be(e, n.id, ...G(n));
       break;
     case "replace":
-      e = We(e, n.id, n.with, n.space);
+      e = Fe(e, n.id, n.with, n.space);
       break;
   }
-  return e;
-}, Fe = ["http", "./", "../"], Ue = ({ url: e }) => Fe.some((t) => e.startsWith(t)), Ge = (e) => D(e) && Ce(e) && Ue(e), K = ({ url: e }, t) => `[](${t ? S(t, e) : e})`, u = {
+  return z(e);
+}, Ge = ["http", "./", "../"], He = ({ url: e }) => Ge.some((t) => e.startsWith(t)), Qe = (e) => I(e) && Ee(e) && He(e), ee = ({ url: e }, t) => `[](${t ? x(t, e) : e})`, m = {
   _open: "<!--",
   _close: "-->",
   _flag: "p↓",
   get begin() {
-    return E(u._open, u._flag, "BEGIN", u._close);
+    return E(m._open, m._flag, "BEGIN", m._close);
   },
   get end() {
-    return E(u._open, u._flag, "END", u._close);
+    return E(m._open, m._flag, "END", m._close);
   },
   lengthOf(e) {
     const t = `lines: ${e.split(`
 `).length}`, n = `chars: ${e.length}`;
-    return E(u._open, u._flag, "length", t, n, u._close);
+    return E(m._open, m._flag, "length", t, n, m._close);
   }
-}, Q = (e) => (t) => D(t) && t.value === u[e], He = ({ position: e, url: t, siblingCount: n }, s) => ({ position: e, url: t, headingDepth: s, inline: n >= 1 }), Qe = ({ position: { start: e }, url: t, siblingCount: n }, { position: { end: s } }, o) => ({ position: { start: e, end: s }, url: t, headingDepth: o, inline: n >= 1 }), ze = (e, t, n) => (e.inline ? E : Ee)(
-  K(e, n),
-  u.begin,
-  u.lengthOf(t),
+}, X = (e) => (t) => I(t) && t.value === m[e], ze = ({ position: e, url: t, siblingCount: n }, o) => ({ position: e, url: t, headingDepth: o, inline: n >= 1 }), Xe = ({ position: { start: e }, url: t, siblingCount: n }, { position: { end: o } }, s) => ({ position: { start: e, end: o }, url: t, headingDepth: s, inline: n >= 1 }), Je = (e, t, n) => (e.inline ? E : Se)(
+  ee(e, n),
+  m.begin,
+  m.lengthOf(t),
   t,
-  u.end
-), Xe = (e) => {
-  const t = b(e, "heading").reduce((n, { position: s, depth: o }) => n.set(s.start.line, o), /* @__PURE__ */ new Map());
+  m.end
+), Ve = (e) => {
+  const t = S(e, "heading").reduce((n, { position: o, depth: s }) => n.set(o.start.line, s), /* @__PURE__ */ new Map());
   return (n) => {
-    for (let s = n.position.start.line; s >= 1; s--) {
-      const o = t.get(s);
-      if (o) return o;
+    for (let o = n.position.start.line; o >= 1; o--) {
+      const s = t.get(o);
+      if (s) return s;
     }
     return 0;
   };
-}, N = {
+}, k = {
   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`)
-}, Je = (e, t) => {
-  const n = [], s = [
+}, Ze = (e, t) => {
+  const n = [], o = [
     ...e.map((r) => ({ node: r, type: "open" })),
     ...t.map((r) => ({ node: r, type: "close" }))
-  ].sort((r, i) => g(r.node, i.node)), o = [];
-  for (const r of s)
-    if (r.type === "open") o.push(r);
+  ].sort((r, i) => f(r.node, i.node)), s = [];
+  for (const r of o)
+    if (r.type === "open") s.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;
+      if (s.length === 0)
+        throw k.closingCommentNotMatchedToOpening(i);
+      const c = s.pop().node;
+      if (s.length > 0) continue;
       n.push({ open: c, close: i });
     }
-  if (o.length > 0)
-    throw N.openingCommentNotClosed(o[0].node);
+  if (s.length > 0)
+    throw k.openingCommentNotClosed(s[0].node);
   return n;
-}, Ve = (e, t, n) => {
-  const s = [...t].sort(g), o = [];
-  return [...n].sort((r, i) => g.reverse(r.open, i.open)).forEach((r) => {
-    for (; s.length > 0; ) {
-      const i = s.pop();
+}, Ke = (e, t, n) => {
+  const o = [...t].sort(f), s = [];
+  return [...n].sort((r, i) => f.reverse(r.open, i.open)).forEach((r) => {
+    for (; o.length > 0; ) {
+      const i = o.pop();
       if (i.position.start.offset < r.open.position.start.offset) {
-        if (ye(e, i, r.open).trim() !== "")
-          throw N.openingCommentDoesNotFollowLink(r.open);
-        return o.push([i, r]);
+        if (xe(e, i, r.open).trim() !== "")
+          throw k.openingCommentDoesNotFollowLink(r.open);
+        return s.push([i, r]);
       }
-      o.push(i);
+      s.push(i);
     }
-    throw N.openingCommentDoesNotFollowLink(r.open);
-  }), o.push(...s.reverse()), o.reverse();
-}, Y = (e, t) => {
-  t ?? (t = I.md(e));
-  const n = Xe(t), s = b(t, "link").filter(Ge), o = b(t, "html").sort(g), r = o.filter(Q("begin")), i = o.filter(Q("end")), c = Je(r, i);
-  return Ve(e, s, c).map((a) => Array.isArray(a) ? Qe(a[0], a[1].close, n(a[0])) : He(a, n(a)));
-}, Ze = (e, { url: t }) => (n) => e(S(O(t), n)), ee = (...e) => {
-  const t = e.reduce((n, s) => n + s, 0);
+    throw k.openingCommentDoesNotFollowLink(r.open);
+  }), s.push(...o.reverse()), s.reverse();
+}, te = (e, t) => {
+  t ?? (t = j.md(e));
+  const n = Ve(t), o = S(t, "link").filter(Qe), s = S(t, "html").sort(f), r = s.filter(X("begin")), i = s.filter(X("end")), c = Ze(r, i);
+  return Ke(e, o, c).map((a) => Array.isArray(a) ? Xe(a[0], a[1].close, n(a[0])) : ze(a, n(a)));
+}, Ye = (e, { url: t }) => (n) => e(x(O(t), n)), ne = (...e) => {
+  const t = e.reduce((n, o) => n + o, 0);
   return Math.min(Math.max(t, 1), 6);
-}, Ke = (e, t, n) => {
+}, et = (e, t, n) => {
   if (t === 0) return e;
-  n ?? (n = I.md(e));
-  const s = b(n, "heading"), o = e.split(`
+  n ?? (n = j.md(e));
+  const o = S(n, "heading"), s = e.split(`
 `);
-  for (const r of s) {
-    const { depth: i, position: { start: c, end: l } } = r, a = ee(i, t), p = o[c.line - 1].slice(i, l.column), m = "#".repeat(a) + p;
-    o[c.line - 1] = m, r.depth = a;
+  for (const r of o) {
+    const { depth: i, position: { start: c, end: l } } = r, a = ne(i, t), p = s[c.line - 1].slice(i, l.column), u = "#".repeat(a) + p;
+    s[c.line - 1] = u, r.depth = a;
   }
-  return o.join(`
+  return s.join(`
 `);
-}, te = (e) => Y(e).reverse().sort(g.reverse).reduce((t, n) => J(t, K(n), n), e), ne = (e, t, n, s, o) => {
+}, oe = (e) => te(e).reverse().sort(f.reverse).reduce((t, n) => Z(t, ee(n), n), e), se = (e, t, n, o, s) => {
   try {
-    e = te(e), e = Ke(e, t);
-    const r = I.md(e);
-    return Y(e, r).sort(g).reverse().map((i) => {
-      var A, P;
-      const { url: c, headingDepth: l } = i, [a, ...p] = ue(c).split("?"), m = a.split(".").pop() ?? "", y = p.join("?"), v = O(c), R = S(v, a);
+    e = oe(e), e = et(e, t);
+    const r = j.md(e);
+    return te(e, r).sort(f).reverse().map((i) => {
+      var P, R;
+      const { url: c, headingDepth: l } = i, [a, ...p] = fe(c).split("?"), u = a.split(".").pop() ?? "", y = p.join("?"), v = O(c), A = x(v, a);
       if (c.startsWith("./") || c.startsWith("../")) {
-        let h = n(R);
-        const w = new he(y), k = (A = w.get("region")) == null ? void 0 : A.split(L);
-        h = (k == null ? void 0 : k.reduce(($, C) => Be($, C), h)) ?? h;
-        const re = w.has("skip"), ie = w.get("heading") ?? 0, ce = w.has("inline");
-        let { inline: x } = i;
-        if (ce && (x = !0), !re)
-          if (m === "md") {
-            const $ = Ze(n, i), C = o ? S(o, v) : v, le = ee(l, Number(ie));
-            h = ne(
+        let h = n(A);
+        const w = new ge(y), N = (P = w.get("region")) == null ? void 0 : P.split(W);
+        h = (N == null ? void 0 : N.reduce(($, C) => Ue($, C), h)) ?? h;
+        const ce = w.has("skip"), le = w.get("heading") ?? 0, ae = w.has("inline");
+        let { inline: M } = i;
+        if (ae && (M = !0), !ce)
+          if (u === "md") {
+            const $ = Ye(n, i), C = s ? x(s, v) : v, pe = ne(l, Number(le));
+            h = se(
               h,
               /** p↓: ... */
-              le,
+              pe,
               $,
-              R,
+              A,
               C
               /** p↓: ... */
             );
-          } else /^(js|ts)x?|svelte$/i.test(m) && (h = G(
+          } else /^(js|ts)x?|svelte$/i.test(u) && (h = H(
             h,
             "code",
             /** p↓: ... */
-            { extension: m, inline: x }
+            { extension: u, inline: M }
             /** p↓: ... */
           ));
-        const M = (P = w.get("wrap")) == null ? void 0 : P.split(L);
-        return h = (M == null ? void 0 : M.reduce(($, C) => G($, C, { extension: m, inline: x }), h)) ?? h, { target: i, content: ze(i, h, o) };
+        const _ = (R = w.get("wrap")) == null ? void 0 : R.split(W);
+        return h = (_ == null ? void 0 : _.reduce(($, C) => H($, C, { extension: u, inline: M }), h)) ?? h, { target: i, content: Je(i, h, s) };
       } 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 }) => J(i, l, c), e);
+    }).reduce((i, { target: c, content: l }) => Z(i, l, c), e);
   } catch (r) {
-    throw new Error(`Error populating inclusions in file ${s}: ${r}`);
+    throw new Error(`Error populating inclusions in file ${o}: ${r}`);
   }
-}, oe = (e) => me(e, "utf-8"), se = (e) => {
-  const t = X(e), n = O(t);
-  return { markdown: oe(t), dir: n, path: t };
-}, at = (e, t = !0) => {
-  const { dir: n, path: s, markdown: o } = se(e), i = ne(o, 0, (c) => oe(X(n, be(c))), s);
-  return t && z(s, i), i;
-}, pt = (e, t = !0) => {
-  const { path: n, markdown: s } = se(e), o = te(s);
-  return t && z(n, o), o;
+}, re = (e) => he(e, "utf-8"), ie = (e) => {
+  const t = V(e), n = O(t);
+  return { markdown: re(t), dir: n, path: t };
+}, ut = (e, t = !0) => {
+  const { dir: n, path: o, markdown: s } = ie(e), i = se(s, 0, (c) => re(V(n, ke(c))), o);
+  return t && J(o, i), i;
+}, mt = (e, t = !0) => {
+  const { path: n, markdown: o } = ie(e), s = oe(o);
+  return t && J(n, s), s;
 };
 export {
-  pt as depopulateMarkdownInclusions,
-  at as populateMarkdownInclusions
+  mt as depopulateMarkdownInclusions,
+  ut as populateMarkdownInclusions
 };

package/dist/index.umd.cjs

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