@p-buddy/parkdown 0.0.1 → 0.0.3

package/dist/cli.js

@@ -0,0 +1,14 @@
+#!/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.3", 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],
+  [l, c]
+];
+for (const [e] of u.filter(([o, s]) => s))
+  for (const o of n) {
+    const s = e(o, !i);
+    i && console.log(s);
+  }

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export declare const depopulateMarkdownInclusions: (file: string, writeFile?: boolean) => string;
+
+export declare const populateMarkdownInclusions: (file: string, writeFile?: boolean) => string;
+
+export declare const remapImportSpecifiers: (file: string, writeFile?: boolean) => void;
+
+export { }

package/dist/index.js

@@ -0,0 +1,396 @@
+import { writeFileSync as q, readFileSync as te } from "node:fs";
+import { basename as ne, dirname as _, join as C, resolve as U } from "node:path";
+import { URLSearchParams as oe } from "node:url";
+import { unified as se } from "unified";
+import re from "remark-parse";
+import { visit as ie } from "unist-util-visit";
+import ce from "stable-hash";
+import { dedent as k } from "ts-dedent";
+import le from "extract-comments";
+const g = (e, n) => e.position.start.offset - n.position.start.offset;
+g.reverse = (e, n) => g(n, e);
+const T = (e) => e.position !== void 0 && e.position.start.offset !== void 0 && e.position.end.offset !== void 0, ae = se().use(re), I = {
+  md: (e) => ae.parse(e)
+}, y = (e, n) => {
+  const t = [];
+  return ie(e, (s, o, r) => {
+    if (s.type !== "root") {
+      if (n && s.type !== n) return;
+      if (T(s)) {
+        const i = ce(r), c = ((r == null ? void 0 : r.children.length) ?? 0) - 1;
+        t.push({ ...s, parentID: i, siblingIndex: o, siblingCount: c });
+      }
+    }
+  }), t;
+}, pe = (e) => e.children.length === 0, G = (e, n, ...t) => {
+  if (t.length === 0) throw new Error("No nodes to replace content from");
+  t.sort(g);
+  const s = t.at(0), o = t.at(-1);
+  return e.slice(0, s.position.start.offset) + n + e.slice(o.position.end.offset);
+}, me = (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);
+}, L = (...e) => e.join(" "), ue = (...e) => e.join(`
+`), he = (e) => {
+  const n = e.split("?");
+  return n.length > 1 ? [n.slice(0, -1).join("?"), n.at(-1)] : [e, ""];
+}, ge = (e) => he(e)[0];
+class d {
+  constructor() {
+    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 P = /,\s*(?![^()]*\))/, fe = [
+  [/'''/g, '"'],
+  [/''/g, "'"],
+  [/parkdown:\s+/g, ""],
+  [/p▼:\s+/g, ""]
+], de = (e, n = "-") => {
+  const t = fe.reduce((s, [o, r]) => s.replaceAll(o, r), e);
+  return n ? t.replaceAll(n, " ") : t;
+}, we = ["string", "number", "boolean"], ve = (e) => we.includes(e), $e = /^([a-zA-Z0-9_-]+)(?:\(([^)]*)\))?$/, Ce = (e) => {
+  const n = e.match($e);
+  if (!n) throw new Error(`Invalid invocation: ${e}`);
+  const [, t, s = ""] = n;
+  if (!s.trim()) return { name: t, parameters: [] };
+  const o = Ee(s);
+  return { name: t, parameters: o };
+}, ye = (e, n) => {
+  for (let t = n + 1; t < e.length; t++)
+    if (e[t] !== void 0) return !1;
+  return !0;
+}, Ee = (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 || !ye(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);
+}, Ne = (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, p] = c, m = p.trim();
+    if (!ve(m)) throw new Error(`Unsupported type: ${m}`);
+    i.push({ name: l, optional: a === "?", type: m });
+  }
+  return { name: s, parameters: i };
+}, H = (e) => {
+  const n = e.map(Ne).reduce(
+    (t, { name: s, parameters: o }) => t.set(s, o),
+    /* @__PURE__ */ new Map()
+  );
+  return (t) => {
+    const { name: s, parameters: o } = Ce(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 }, p) => {
+      const m = o[p];
+      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 });
+  };
+}, R = (e) => Object.entries(e).filter(([n]) => n !== "name" && !isNaN(Number(n))).map(([n, t]) => t), xe = [
+  /**
+   * Wraps the content in a markdown-formatted code block.
+   * @param lang The language of the code block (defaults to the file extension).
+   * @param meta Additional metadata to include in the top line of the code block (i.e. to the right of the `lang`).
+   * @example [](<url>?wrap=code)
+   * @example [](<url>?wrap=code())
+   * @example [](<url>?wrap=code(ts))
+   * @example [](<url>?wrap=code(,some-meta))
+   */
+  "code(lang?: string, meta?: string)",
+  /**
+   * Wraps the content in a markdown-formatted blockquote 
+   * (using the `>` character if the content is a single line, 
+   * or the `<blockquote>` tag if the content is a multi-line block).
+   * @example [](<url>?wrap=quote)
+   * @example [](<url>?wrap=quote())
+   * @example [](<url>?wrap=quote(,))
+   */
+  "quote()",
+  /**
+   * Wraps the content in a markdown-formatted dropdown (using the `<details>` and `<summary>` tags).
+   * @param summary The summary text of the dropdown.
+   * @param open Whether the dropdown should be open by default.
+   * @param space The space character to use between words in the summary (defaults to `-`).
+   * @example [](<url>?wrap=dropdown(hello-world))
+   * @example [](<url>?wrap=dropdown('hello,-world',true))
+   * @example [](<url>?wrap=dropdown(hello_world,,_)) 
+   */
+  "dropdown(summary: string, open?: boolean, space?: string)"
+], Me = "-", be = H(xe), W = (e, n, t) => {
+  const s = be(n), o = (t == null ? void 0 : t.inline) && !e.includes(`
+
+`);
+  switch (s.name) {
+    case "code":
+      const r = s.lang ?? (t == null ? void 0 : t.extension) ?? "", i = s.meta ? ` ${s.meta}` : "";
+      return `\`\`\`${r}${i}
+${e}
+\`\`\``;
+    case "quote":
+      return o ? `> ${e}` : `<blockquote>
+
+${e}
+
+</blockquote>
+`;
+    case "dropdown":
+      const c = `<details${s.open ? " open" : ""}>`, l = `<summary>${s.summary.split(s.space ?? Me).join(" ")}</summary>`;
+      return ["", c, l, "", e, "</details>", ""].join(`
+`);
+  }
+}, _e = [
+  "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)"
+], ke = H(_e), D = (e) => le(e), B = (e, n) => D(e).filter(({ value: t }) => t.includes(n)).sort((t, s) => t.range[0] - s.range[0]), Te = (e, ...n) => {
+  if (n.length === 0) return e;
+  const t = ([i, c]) => e.slice(i, c), s = D(e), o = new d(), r = new d();
+  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], p = c[l + 1];
+      o.push(a.range[1], p.range[0]);
+      const [m, ...f] = t([a.range[1], p.range[0]]), S = f[f.length - 1];
+      r.push(a.range[0], a.range[1] + (m.trim() ? 0 : 1)), r.push(p.range[0], p.range[1] + (S.trim() ? 0 : 1));
+    }
+  }
+  return o.collapse(), r.collapse(), k(
+    o.subtract(r).map(t).filter(Boolean).join("")
+  ).trim();
+}, Ie = (e, ...n) => {
+  if (n.length === 0) return e;
+  const t = ([i, c]) => e.slice(i, c), s = D(e), o = new d();
+  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], p = c[l + 1], m = t([p.range[1], p.range[1] + 1]).at(-1);
+      o.push(a.range[0], m === `
+` ? p.range[1] + 1 : p.range[1]);
+    }
+  }
+  o.collapse();
+  const r = new d();
+  return r.push(0, e.length), r.subtract(o), k(
+    r.collapse().map(t).filter(Boolean).join("")
+  ).trim();
+}, De = (e, n, t, s) => {
+  if (!n) return e;
+  const o = B(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], p = o[l + 1];
+    r += e.slice(i, a.range[1]), r += de(t ?? a.value, s), i = p.range[0];
+  }
+  r += e.slice(i);
+  const c = new d();
+  return c.push(0, r.length), c.subtract(
+    B(r, n).reduce((l, { range: a }) => (l.push(...a), l), new d())
+  ), k(
+    c.collapse().map(([l, a]) => r.slice(l, a)).filter(Boolean).join("")
+  ).trim();
+}, je = (e, n) => {
+  const t = ke(n);
+  switch (t.name) {
+    case "extract":
+      return Te(e, t.id, ...R(t));
+    case "remove":
+      return Ie(e, t.id, ...R(t));
+    case "replace":
+      return De(e, t.id, t.with, t.space);
+  }
+}, Oe = ["http", "./", "../"], Ae = ({ url: e }) => Oe.some((n) => e.startsWith(n)), Le = (e) => T(e) && pe(e) && Ae(e), b = ({ url: e }, n) => `[](${n ? C(n, e) : e})`, h = {
+  _open: "<!--",
+  _close: "-->",
+  _flag: "p▼",
+  get begin() {
+    return L(h._open, h._flag, "BEGIN", h._close);
+  },
+  get end() {
+    return L(h._open, h._flag, "END", h._close);
+  }
+}, F = (e) => (n) => T(n) && n.value === h[e], Pe = ({ position: e, url: n, siblingCount: t }, s) => ({ position: e, url: n, headingDepth: s, inline: t >= 1 }), Re = ({ position: { start: e }, url: n, siblingCount: t }, { position: { end: s } }, o) => ({ position: { start: e, end: s }, url: n, headingDepth: o, inline: t >= 1 }), We = (e, n, t) => e.inline ? `${b(e, t)} ${h.begin} ${n} ${h.end}` : ue(b(e, t), h.begin, n, h.end), Be = (e) => {
+  const n = y(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;
+  };
+}, E = {
+  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`)
+}, Fe = (e, n) => {
+  const t = [], s = [
+    ...e.map((r) => ({ node: r, type: "open" })),
+    ...n.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);
+    else {
+      const i = r.node;
+      if (o.length === 0)
+        throw E.closingCommentNotMatchedToOpening(i);
+      const c = o.pop().node;
+      if (o.length > 0) continue;
+      t.push({ open: c, close: i });
+    }
+  if (o.length > 0)
+    throw E.openingCommentNotClosed(o[0].node);
+  return t;
+}, qe = (e, n, t) => {
+  const s = [...n].sort(g), o = [];
+  return [...t].sort((r, i) => g.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 (me(e, i, r.open).trim() !== "")
+          throw E.openingCommentDoesNotFollowLink(r.open);
+        return o.push([i, r]);
+      }
+      o.push(i);
+    }
+    throw E.openingCommentDoesNotFollowLink(r.open);
+  }), o.push(...s.reverse()), o.reverse();
+}, Q = (e, n) => {
+  n ?? (n = I.md(e));
+  const t = Be(n), s = y(n, "link").filter(Le), o = y(n, "html").sort(g), r = o.filter(F("begin")), i = o.filter(F("end")), c = Fe(r, i);
+  return qe(e, s, c).map((a) => Array.isArray(a) ? Re(a[0], a[1].close, t(a[0])) : Pe(a, t(a)));
+}, Ue = (e, { url: n }) => (t) => e(C(_(n), t)), z = (...e) => {
+  const n = e.reduce((t, s) => t + s, 0);
+  return Math.min(Math.max(n, 1), 6);
+}, Ge = (e, n, t) => {
+  if (n === 0) return e;
+  t ?? (t = I.md(e));
+  const s = y(t, "heading"), o = e.split(`
+`);
+  for (const r of s) {
+    const { depth: i, position: { start: c, end: l } } = r, a = z(i, n), p = o[c.line - 1].slice(i, l.column), m = "#".repeat(a) + p;
+    o[c.line - 1] = m, r.depth = a;
+  }
+  return o.join(`
+`);
+}, X = (e) => Q(e).reverse().sort(g.reverse).reduce((n, t) => G(n, b(t), t), e), J = (e, n, t, s) => {
+  e = X(e), e = Ge(e, n);
+  const o = I.md(e);
+  return Q(e, o).sort(g).reverse().map((r) => {
+    var O, A;
+    const { url: i, headingDepth: c } = r, [l, ...a] = ne(i).split("?"), p = l.split(".").pop() ?? "", m = a.join("?"), f = _(i), S = C(f, l);
+    if (i.startsWith("./") || i.startsWith("../")) {
+      let u = t(S);
+      const w = new oe(m), N = (O = w.get("region")) == null ? void 0 : O.split(P);
+      u = (N == null ? void 0 : N.reduce((v, $) => je(v, $), u)) ?? u;
+      const Z = w.has("skip"), K = w.get("heading") ?? 0, Y = w.has("inline");
+      let { inline: x } = r;
+      if (Y && (x = !0), !Z)
+        if (p === "md") {
+          const v = Ue(t, r), $ = s ? C(s, f) : f, ee = z(c, Number(K));
+          u = J(
+            u,
+            /** p▼: ... */
+            ee,
+            v,
+            $
+            /** p▼: ... */
+          );
+        } else /^(js|ts)x?|svelte$/i.test(p) && (u = W(
+          u,
+          "code",
+          /** p▼: ... */
+          { extension: p, inline: x }
+          /** p▼: ... */
+        ));
+      const M = (A = w.get("wrap")) == null ? void 0 : A.split(P);
+      return u = (M == null ? void 0 : M.reduce((v, $) => W(v, $, { extension: p, inline: x }), u)) ?? u, { target: r, content: We(r, u, s) };
+    } else throw i.startsWith("http") ? new Error("External web links are not implemented yet") : new Error(`Unsupported link type: ${i}`);
+  }).reduce((r, { target: i, content: c }) => G(r, c, i), e);
+}, V = (e) => te(e, "utf-8"), j = (e) => {
+  const n = U(e), t = _(n);
+  return { markdown: V(n), dir: t, path: n };
+}, et = (e, n = !0) => {
+  const { dir: t, path: s, markdown: o } = j(e), i = J(o, 0, (c) => V(U(t, ge(c))));
+  return n && q(s, i), i;
+}, tt = (e, n = !0) => {
+  const { path: t, markdown: s } = j(e), o = X(s);
+  return n && q(t, o), o;
+}, nt = (e, n = !0) => {
+  j(e);
+};
+export {
+  tt as depopulateMarkdownInclusions,
+  et as populateMarkdownInclusions,
+  nt as remapImportSpecifiers
+};

package/dist/index.umd.cjs

@@ -0,0 +1,15 @@
+(function(u,w){typeof exports=="object"&&typeof module<"u"?w(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"],w):(u=typeof globalThis<"u"?globalThis:u||self,w(u.index={},u.node_fs,u.node_path,u.node_url,u.unified,u.remarkParse,u.unistUtilVisit,u.hash,u.tsDedent,u._extractComments))})(this,function(u,w,f,J,Z,K,Y,ee,x,te){"use strict";const g=(e,n)=>e.position.start.offset-n.position.start.offset;g.reverse=(e,n)=>g(n,e);const N=e=>e.position!==void 0&&e.position.start.offset!==void 0&&e.position.end.offset!==void 0,ne=Z.unified().use(K),k={md:e=>ne.parse(e)},E=(e,n)=>{const t=[];return Y.visit(e,(o,s,r)=>{if(o.type!=="root"){if(n&&o.type!==n)return;if(N(o)){const i=ee(r),c=((r==null?void 0:r.children.length)??0)-1;t.push({...o,parentID:i,siblingIndex:s,siblingCount:c})}}}),t},se=e=>e.children.length===0,P=(e,n,...t)=>{if(t.length===0)throw new Error("No nodes to replace content from");t.sort(g);const o=t.at(0),s=t.at(-1);return e.slice(0,o.position.start.offset)+n+e.slice(s.position.end.offset)},oe=(e,n,t)=>{const o=Math.min(n.position.end.offset,t.position.end.offset),s=Math.max(n.position.start.offset,t.position.start.offset);return e.slice(o,s)},A=(...e)=>e.join(" "),re=(...e)=>e.join(`
+`),ie=e=>{const n=e.split("?");return n.length>1?[n.slice(0,-1).join("?"),n.at(-1)]:[e,""]},ce=e=>ie(e)[0];class v{constructor(){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[o,s]=n[0];for(let r=1;r<n.length;r++){const[i,c]=n[r];i<=s?s=Math.max(s,c):(t.push([o,s]),o=i,s=c)}return t.push([o,s]),this.intervals=t}subtract(n){const{intervals:t}=this,{intervals:o}=n;if(!t.length||!o.length)return t;let s=[...t];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 L=/,\s*(?![^()]*\))/,le=[[/'''/g,'"'],[/''/g,"'"],[/parkdown:\s+/g,""],[/p▼:\s+/g,""]],ae=(e,n="-")=>{const t=le.reduce((o,[s,r])=>o.replaceAll(s,r),e);return n?t.replaceAll(n," "):t},pe=["string","number","boolean"],ue=e=>pe.includes(e),me=/^([a-zA-Z0-9_-]+)(?:\(([^)]*)\))?$/,de=e=>{const n=e.match(me);if(!n)throw new Error(`Invalid invocation: ${e}`);const[,t,o=""]=n;if(!o.trim())return{name:t,parameters:[]};const s=fe(o);return{name:t,parameters:s}},he=(e,n)=>{for(let t=n+1;t<e.length;t++)if(e[t]!==void 0)return!1;return!0},fe=e=>{const n=[];let t="",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,t+=c?"'''":"''",s+=c?2:1}else i?(o=!o,t+=r):r===","&&!o?(n.push(t.trim()),t=""):t+=r}return n.push(t.trim()),n.map(s=>s===""?void 0:s?ge(s):void 0).filter((s,r,i)=>s!==void 0||!he(i,r))},ge=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)},we=e=>{const n=/^(\w+)(?:\(([^)]*)\))?/,t=e.match(n);if(!t)return{name:e};const[,o,s]=t;if(!s)return{name:o};const r=/(\w+)(\?)?:\s*([^,]+)/g,i=[];let c;for(;(c=r.exec(s))!==null;){const[,l,a,p]=c,m=p.trim();if(!ue(m))throw new Error(`Unsupported type: ${m}`);i.push({name:l,optional:a==="?",type:m})}return{name:o,parameters:i}},R=e=>{const n=e.map(we).reduce((t,{name:o,parameters:s})=>t.set(o,s),new Map);return t=>{const{name:o,parameters:s}=de(t);if(!n.has(o))throw new Error(`Unknown method: ${o}`);const r=n.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},p)=>{const m=s[p];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})}},_=e=>Object.entries(e).filter(([n])=>n!=="name"&&!isNaN(Number(n))).map(([n,t])=>t),ve=["code(lang?: string, meta?: string)","quote()","dropdown(summary: string, open?: boolean, space?: string)"],$e="-",Ce=R(ve),F=(e,n,t)=>{const o=Ce(n),s=(t==null?void 0:t.inline)&&!e.includes(`
+
+`);switch(o.name){case"code":const r=o.lang??(t==null?void 0:t.extension)??"",i=o.meta?` ${o.meta}`:"";return`\`\`\`${r}${i}
+${e}
+\`\`\``;case"quote":return s?`> ${e}`:`<blockquote>
+
+${e}
+
+</blockquote>
+`;case"dropdown":const c=`<details${o.open?" open":""}>`,l=`<summary>${o.summary.split(o.space??$e).join(" ")}</summary>`;return["",c,l,"",e,"</details>",""].join(`
+`)}},ye=R(["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)"]),T=e=>te(e),W=(e,n)=>T(e).filter(({value:t})=>t.includes(n)).sort((t,o)=>t.range[0]-o.range[0]),Se=(e,...n)=>{if(n.length===0)return e;const t=([i,c])=>e.slice(i,c),o=T(e),s=new v,r=new v;for(const i of n){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];s.push(a.range[1],p.range[0]);const[m,...$]=t([a.range[1],p.range[0]]),b=$[$.length-1];r.push(a.range[0],a.range[1]+(m.trim()?0:1)),r.push(p.range[0],p.range[1]+(b.trim()?0:1))}}return s.collapse(),r.collapse(),x.dedent(s.subtract(r).map(t).filter(Boolean).join("")).trim()},Ee=(e,...n)=>{if(n.length===0)return e;const t=([i,c])=>e.slice(i,c),o=T(e),s=new v;for(const i of n){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=t([p.range[1],p.range[1]+1]).at(-1);s.push(a.range[0],m===`
+`?p.range[1]+1:p.range[1])}}s.collapse();const r=new v;return r.push(0,e.length),r.subtract(s),x.dedent(r.collapse().map(t).filter(Boolean).join("")).trim()},Me=(e,n,t,o)=>{if(!n)return e;const s=W(e,n);if(s.length<2)return e;let r="",i=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+=ae(t??a.value,o),i=p.range[0]}r+=e.slice(i);const c=new v;return c.push(0,r.length),c.subtract(W(r,n).reduce((l,{range:a})=>(l.push(...a),l),new v)),x.dedent(c.collapse().map(([l,a])=>r.slice(l,a)).filter(Boolean).join("")).trim()},xe=(e,n)=>{const t=ye(n);switch(t.name){case"extract":return Se(e,t.id,..._(t));case"remove":return Ee(e,t.id,..._(t));case"replace":return Me(e,t.id,t.with,t.space)}},Ne=["http","./","../"],ke=({url:e})=>Ne.some(n=>e.startsWith(n)),Te=e=>N(e)&&se(e)&&ke(e),I=({url:e},n)=>`[](${n?f.join(n,e):e})`,d={_open:"<!--",_close:"-->",_flag:"p▼",get begin(){return A(d._open,d._flag,"BEGIN",d._close)},get end(){return A(d._open,d._flag,"END",d._close)}},B=e=>n=>N(n)&&n.value===d[e],Ie=({position:e,url:n,siblingCount:t},o)=>({position:e,url:n,headingDepth:o,inline:t>=1}),je=({position:{start:e},url:n,siblingCount:t},{position:{end:o}},s)=>({position:{start:e,end:o},url:n,headingDepth:s,inline:t>=1}),be=(e,n,t)=>e.inline?`${I(e,t)} ${d.begin} ${n} ${d.end}`:re(I(e,t),d.begin,n,d.end),qe=e=>{const n=E(e,"heading").reduce((t,{position:o,depth:s})=>t.set(o.start.line,s),new Map);return t=>{for(let o=t.position.start.line;o>=1;o--){const s=n.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`)},De=(e,n)=>{const t=[],o=[...e.map(r=>({node:r,type:"open"})),...n.map(r=>({node:r,type:"close"}))].sort((r,i)=>g(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;t.push({open:c,close:i})}if(s.length>0)throw M.openingCommentNotClosed(s[0].node);return t},Oe=(e,n,t)=>{const o=[...n].sort(g),s=[];return[...t].sort((r,i)=>g.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(oe(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()},U=(e,n)=>{n??(n=k.md(e));const t=qe(n),o=E(n,"link").filter(Te),s=E(n,"html").sort(g),r=s.filter(B("begin")),i=s.filter(B("end")),c=De(r,i);return Oe(e,o,c).map(a=>Array.isArray(a)?je(a[0],a[1].close,t(a[0])):Ie(a,t(a)))},Pe=(e,{url:n})=>t=>e(f.join(f.dirname(n),t)),G=(...e)=>{const n=e.reduce((t,o)=>t+o,0);return Math.min(Math.max(n,1),6)},Ae=(e,n,t)=>{if(n===0)return e;t??(t=k.md(e));const o=E(t,"heading"),s=e.split(`
+`);for(const r of o){const{depth:i,position:{start:c,end:l}}=r,a=G(i,n),p=s[c.line-1].slice(i,l.column),m="#".repeat(a)+p;s[c.line-1]=m,r.depth=a}return s.join(`
+`)},H=e=>U(e).reverse().sort(g.reverse).reduce((n,t)=>P(n,I(t),t),e),Q=(e,n,t,o)=>{e=H(e),e=Ae(e,n);const s=k.md(e);return U(e,s).sort(g).reverse().map(r=>{var X,V;const{url:i,headingDepth:c}=r,[l,...a]=f.basename(i).split("?"),p=l.split(".").pop()??"",m=a.join("?"),$=f.dirname(i),b=f.join($,l);if(i.startsWith("./")||i.startsWith("../")){let h=t(b);const C=new J.URLSearchParams(m),q=(X=C.get("region"))==null?void 0:X.split(L);h=(q==null?void 0:q.reduce((y,S)=>xe(y,S),h))??h;const Fe=C.has("skip"),We=C.get("heading")??0,Be=C.has("inline");let{inline:D}=r;if(Be&&(D=!0),!Fe)if(p==="md"){const y=Pe(t,r),S=o?f.join(o,$):$,Ue=G(c,Number(We));h=Q(h,Ue,y,S)}else/^(js|ts)x?|svelte$/i.test(p)&&(h=F(h,"code",{extension:p,inline:D}));const O=(V=C.get("wrap"))==null?void 0:V.split(L);return h=(O==null?void 0:O.reduce((y,S)=>F(y,S,{extension:p,inline:D}),h))??h,{target:r,content:be(r,h,o)}}else throw i.startsWith("http")?new Error("External web links are not implemented yet"):new Error(`Unsupported link type: ${i}`)}).reduce((r,{target:i,content:c})=>P(r,c,i),e)},z=e=>w.readFileSync(e,"utf-8"),j=e=>{const n=f.resolve(e),t=f.dirname(n);return{markdown:z(n),dir:t,path:n}},Le=(e,n=!0)=>{const{dir:t,path:o,markdown:s}=j(e),i=Q(s,0,c=>z(f.resolve(t,ce(c))));return n&&w.writeFileSync(o,i),i},Re=(e,n=!0)=>{const{path:t,markdown:o}=j(e),s=H(o);return n&&w.writeFileSync(t,s),s},_e=(e,n=!0)=>{j(e)};u.depopulateMarkdownInclusions=Re,u.populateMarkdownInclusions=Le,u.remapImportSpecifiers=_e,Object.defineProperty(u,Symbol.toStringTag,{value:"Module"})});

package/package.json

@@ -2,9 +2,17 @@
   "name": "@p-buddy/parkdown",
   "type": "module",
   "private": false,
-  "version": "0.0.1",
+  "version": "0.0.3",
   "main": "dist/index.js",
   "bin": "dist/cli.js",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
   "devDependencies": {
     "@types/node": "^22.13.10",
     "@types/unist": "^3.0.3",

package/.assets/api-note.md

@@ -1,3 +0,0 @@
-**_NOTE ON API USAGE:_** As you can see from the included examples, each _invocation_ of an API method looks like a less strict (more quirky) version of a typical javascript function invocation. 
-
-Please see the [full explanation](#query-parameters-with-function-like-apis) to learn more and/or if the below is confusing.

package/.assets/api.md

@@ -1,34 +0,0 @@
-## 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:
-
-```ts
-const definitions = [
-  "method(arg1: string, arg2: boolean, arg3?: number)",
-  "otherMethod(arg1: string, arg2?: boolean, arg3?: number)"
-]
-```
-
-These APIs are utilized when setting the query parameter with a _function-like_ invocation syntax, such as:
-
-```md
-[](<url>?example=method(hello-world,true))
-```
-
-As you can maybe tell from the example above, we're relaxing some constraints on typical function invocations (like the need to wrap string arguments in quotes), while also imposing some additional constraints (like not using spaces) to ensure the links are valid markdown and the URLs are [safe](https://support.exactonline.com/community/s/knowledge-base?language=en_GB#All-All-DNO-Content-urlcharacters).
-
-The goal is to make it as painless as possible to author links that are valid markdown, valid URLs, and easy to read and write.
-
-Please note the following:
-
-- Methods that take no arguments can be invoked without parentheses (e.g. `[](<url>?example=method)`).
-- String arguments do not need to be wrapped in quotes (e.g. `[](<url>?example=method(some-string))`), and they should **NOT** be wrapped in double quotes (see more below).
-- You cannot use spaces within a string argument or anywhere else in the query (as this would violate the markdown link syntax). For arguments that reasonably could include spaces, there should be an optional `space` argument that defaults to `-`, so that any usage of the space character will be converted to a space (e.g. `hello-world` becomes `hello world`).
-- If a method takes a string argument, and you want to include a comma within that argument, you must wrap it in one or more single quotes (`'`). 
-- String arguments wrapped in single set of single quotes will automatically have their single quotes removed when the query is parsed (e.g. the argument included in `[](<url>?example=method('hello,world'))` will parse to `hello,world`).
-- If you want single quotes preserved in the parsed output, use two single quotes in a row (e.g. `[](<url>?example=method(''single-quoted''))`). 
-- You cannot use double quotes within a string argument (as they are not a [URL safe character](https://support.exactonline.com/community/s/knowledge-base#All-All-DNO-Content-urlcharacters)). To include a double-quote in the parsed output, use three single quotes in a row (e.g. `[](<url>?example=method'''double-quoted'''))`).
-- Optional arguments can be completely ommitted (for example if a `method` took 3 optional arguments, and you only wanted to provide the third, you could do the following: `[](<url>?example=method(,,your-third-argument))`).
-- Overall, text meant to be displayed to a human will be _sanitized_ in the following manner (unless otherwise noted):
-
-[](../src/utils.ts?region=extract(sanitize))

package/.assets/authoring.md

@@ -1,69 +0,0 @@
-# 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`).
-
-These links can be rendered either [inline](#inline) or [block](#block), depending on how you author them.
-
-## Inline
-
-Inline inclusions occur when your _text-less_ link has 1 or more siblings (meaning it's **not** the only node in a [paragraph](https://www.markdownguide.org/basic-syntax/#paragraphs-1)).
-
-There are two equivalent ways to author inline inclusions, [single-line](#single-line) or [multi-line](#multi-line), and which you choose depends solely on how you want your raw markdown to look (it will **not** affect the rendered output).
-
-### Single-line
-
-What you write:
-
-[](./unpopulated/inline.single.md?wrap=code)
-
-What is rendered (**_before_** processing, same as [Option B](#option-b-multi-line)):
-
-[](./unpopulated/inline.single.md?wrap=quote&inline)
-
-What your markdown file contains (**_after_** processing):
-
-[](./populated/inline.single.md?wrap=code)
-
-What is rendered (**_after_** processing, same as [Option B](#option-b-multi-line)):
-
-[](./populated/inline.single.md?wrap=quote&inline)
-
-### Multi-line
-
-What you write:
-
-[](./unpopulated/inline.multi.md?wrap=code)
-
-What is rendered (**_before_** processing, same as [Option A](#option-a-single-line)):
-
-[](./unpopulated/inline.multi.md?wrap=quote&inline)
-
-What your markdown file contains (**_after_** processing):
-
-[](./populated/inline.multi.md?wrap=code)
-
-What is rendered (**_after_** processing, same as [Option A](#option-a-single-line)):
-
-[](./populated/inline.multi.md?wrap=quote&inline)
-
-## Block
-
-Block inclusions occur when your "empty" link is the **only** node in a [paragraph](https://www.markdownguide.org/basic-syntax/#paragraphs-1) (at least before being populated). This is likely the most common way to author inclusions.
-
-What you write:
-
-[](./unpopulated/block.md?wrap=code)
-
-What is rendered (**_before_** processing):
-
-[](./unpopulated/block.md?wrap=quote)
-
-What your markdown file contains (**_after_** processing):
-
-[](./populated/block.md?wrap=code)
-
-What is rendered (**_after_** processing):
-
-[](./populated/block.md?wrap=quote)
-
-[](./query.md?heading=-1)

package/.assets/code/depopulate.ts

@@ -1,6 +0,0 @@
-import { depopulateMarkdownInclusions } from /** p▼: pkg */ "../../src" /** p▼: pkg */;
-
-const file = "README.md";
-const writeFile = true;
-
-depopulateMarkdownInclusions(file, writeFile);

package/.assets/code/inclusions.ts

@@ -1,6 +0,0 @@
-import { populateMarkdownInclusions } from /** p▼: pkg */ "../../src" /** p▼: pkg */;
-
-const file = "README.md";
-const writeFile = true;
-
-populateMarkdownInclusions(file, writeFile);

package/.assets/depopulated.md

@@ -1,25 +0,0 @@
-# Removing populated inclusions
-
-Sometimes you may want to remove populated inclusions from your markdown file, since they can make things more difficult to read during authoring. You can do this either using the [cli](#cli-removing-populated-inclusions) or via the `removePopulatedInclusions` [export](#depopulateMarkdownIncludes-export):
-
-## CLI (removing populated inclusions)
-
-The following commands are all equivalent:
-
-```bash
-npx parkdown --file ./README.md --depopulate --no-inclusions
-npx parkdown -f README.md -d --ni # Notice the double-dash (--) on 'ni'
-npx parkdown -d --ni # defaults to processing the 'README.md' file of the current working directory
-```
-
-The following commands will lead to the same result, but since `--no-inclusions` (`--ni`) is not specified, there will be some wasted work as inclusions will be processed and then removed.
-
-```bash
-npx parkdown --file ./README.md --depopulate
-npx parkdown -f README.md -d
-npx parkdown -d # defaults to processing the 'README.md' file of the current working directory
-```
-
-## `depopulateMarkdownIncludes` export
-
-[](./code/depopulate.ts?region=replace(pkg,'''parkdown'''))

package/.assets/invocation.md

@@ -1,16 +0,0 @@
-# Invocation
-
-Invoke [parkdown's]() functionality with either the [cli](#cli-inclusions) or via the `processMarkdownIncludes` [export](#populateMarkdownIncludes-export):
-
-## CLI
-
-The following commands are all equivalent:
-```bash
-npx parkdown --file ./README.md
-npx parkdown -f README.md
-npx parkdown # defaults to processing inclusions in the 'README.md' file of the current working directory
-```
-
-## `populateMarkdownIncludes` export
-
-[](./code/inclusions.ts?region=replace(pkg,'''parkdown'''))

package/.assets/populated/block.md

@@ -1,9 +0,0 @@
-Before...
-
-[](<url>)
-<!-- p▼ Begin  -->
-...Included Content...
-...Included Content...
-<!-- p▼ End  -->
-
-...After

package/.assets/populated/inline.multi.md

@@ -1,5 +0,0 @@
-Before... 
-[](<url>) <!-- p▼ Begin -->
-...Included Content...
-...Included Content... <!-- p▼ End --> 
-...After