@p-buddy/parkdown 0.0.0

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

@@ -0,0 +1,42 @@
+{
+  "name": "@p-buddy/parkdown",
+  "type": "module",
+  "private": false,
+  "version": "0.0.0",
+  "main": "dist/index.js",
+  "bin": "dist/cli.js",
+  "devDependencies": {
+    "@types/node": "^22.13.10",
+    "@types/unist": "^3.0.3",
+    "typescript": "^5.8.2",
+    "vite": "^6.2.1",
+    "vite-plugin-dts": "^4.5.3",
+    "vite-plugin-externalize-deps": "^0.9.0",
+    "vitest": "^3.0.8"
+  },
+  "dependencies": {
+    "@commander-js/extra-typings": "^13.1.0",
+    "@flex-development/import-regex": "^3.0.0",
+    "extract-comments": "^1.1.0",
+    "remark-parse": "^11.0.0",
+    "stable-hash": "^0.0.4",
+    "ts-dedent": "^2.2.0",
+    "unified": "^11.0.5",
+    "unist-util-visit": "^5.0.0"
+  },
+  "scripts": {
+    "build:lib": "vite build",
+    "build:cli": "vite build --config vite.cli.config.ts",
+    "build": "pnpm run build:lib && pnpm run build:cli",
+    "test": "vitest",
+    "test:run": "vitest run"
+  },
+  "typings": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "dist/index.d.ts",
+      "import": "dist/index.js",
+      "require": "dist/index.umd.cjs"
+    }
+  }
+}

package/src/api/index.test.ts

@@ -0,0 +1,32 @@
+import { describe, expect, test } from "vitest";
+import { MethodDefinition } from "./types";
+import { numberedParameters, createParser } from "./index";
+
+describe(numberedParameters.name, () => {
+  test("simple", () => {
+    const definitions = [
+      "example(0: string, 1?: string)" satisfies MethodDefinition,
+    ] as const;
+
+    const result = createParser(definitions)("example(z,a)");
+    expect(numberedParameters(result)).toEqual(["z", "a"]);
+  });
+
+  test("mixed types", () => {
+    const definitions = [
+      "example(0: string, 1?: string, 2: boolean)" satisfies MethodDefinition,
+    ] as const;
+
+    const result = createParser(definitions)("example(z,a,true)");
+    expect(numberedParameters(result)).toEqual(["z", "a", true]);
+  });
+
+  test("mixed positions", () => {
+    const definitions = [
+      "example(0: string, hi: string, 1: boolean)" satisfies MethodDefinition,
+    ] as const;
+
+    const result = createParser(definitions)("example(z,hi,true)");
+    expect(numberedParameters(result)).toEqual(["z", true]);
+  });
+});

package/src/api/index.ts

@@ -0,0 +1,8 @@
+export type { MethodDefinition } from "./types";
+import type { Parser } from "./types";
+export { createParser } from "./utils";
+
+export const numberedParameters = (result: ReturnType<Parser<any>>) =>
+  Object.entries(result)
+    .filter(([key]) => key !== "name" && !isNaN(Number(key)))
+    .map(([_, value]) => value);

package/src/api/types.ts

@@ -0,0 +1,78 @@
+export type TypeRecord = {
+  "string": string,
+  "number": number,
+  "boolean": boolean,
+}
+
+type ExpandRecursively<T> =
+  T extends (...args: infer A) => infer R
+  /**/ ? (...args: ExpandRecursively<A>) => ExpandRecursively<R>
+  /**/ : T extends object
+    /**/ ? T extends infer O
+      /**/ ? { [K in keyof O]: ExpandRecursively<O[K]> }
+      /**/ : never
+    /**/ : T;
+
+type WithoutLeadingWhitespace<T extends string> = T extends ` ${infer Without}` ? Without : T;
+
+type SplitOn<T extends string, Delimeter extends string> =
+  T extends `${infer Left}${Delimeter}${infer Right}` ? [Left, ...SplitOn<Right, Delimeter>] : [T];
+
+type RepeatInTuple<Element, Count extends number, Acc extends unknown[] = []> = {
+  [k in Count]: Acc['length'] extends k
+  ? Acc
+  : RepeatInTuple<Element, k, [...Acc, Element]>;
+}[Count];
+
+type Join<T extends string[], D extends string> =
+  T extends []
+    /**/ ? ''
+    /**/ : T extends [infer F extends string]
+      /**/ ? F
+      /**/ : T extends [infer F extends string, ...infer R extends string[]]
+        /**/ ? `${F}${D}${Join<R, D>}`
+        /**/ : string;
+
+type Capture<T extends string, Start extends string, End extends string> = {
+  [k in T]: k extends `${infer Before}${Start}${infer Captured}${End}${infer After}`
+  /**/ ? { before: Before, captured: Captured, after: After }
+  /**/ : { before: T, captured: "", after: "" };
+}[T]
+
+type SplitOnComma<T extends string> = { [k in SplitOn<T, ",">[number]]: k }[SplitOn<T, ",">[number]];
+
+type Parameter<Name extends string, Optional extends boolean, Type extends TypeRecord[keyof TypeRecord]> = { name: Name, optional: Optional, type: Type };
+
+type ExtractParameter<T extends string> = T extends `${infer Name}?: ${infer Type extends keyof TypeRecord}`
+/**/ ? Parameter<Name, true, Type>
+/**/ : T extends `${infer Name}: ${infer Type extends keyof TypeRecord}`
+  /**/ ? Parameter<Name, false, Type>
+  /**/ : never;
+
+type FunctionName<T extends string> = Capture<T, "(", ")">["before"];
+
+type ParameterRecord<T extends string> = {
+  [k in WithoutLeadingWhitespace<SplitOnComma<Capture<T, "(", ")">["captured"]>> as ExtractParameter<k>["name"]]: ExtractParameter<k>["optional"] extends true ? TypeRecord[ExtractParameter<k>["type"]] | undefined : TypeRecord[ExtractParameter<k>["type"]]
+}
+
+type UndefinedToOptional<T> = {
+  [K in keyof T as undefined extends T[K] ? K : never]?: Exclude<T[K], undefined>;
+} & {
+  [K in keyof T as undefined extends T[K] ? never : K]: T[K];
+};
+
+type ParseMethodDefinition<T extends string> = { [t in T as FunctionName<t>]: UndefinedToOptional<ParameterRecord<t>> };
+
+type ParameterDefinition = `${string}${"?" | ""}: ${keyof TypeRecord}`;
+/** Can add more parameters by adding more numbers to the count union, but it adds a lot of complexity to the type */
+type ZeroOrMoreParameters = Join<RepeatInTuple<ParameterDefinition, 0 | 1 | 2>, ", ">;
+export type MethodDefinition = `${string}(${ZeroOrMoreParameters})`;
+
+export type MethodDefinitions = string[] | readonly string[];
+
+export type ParsingCandidates<T extends MethodDefinitions> = ExpandRecursively<{
+  [k in keyof ParseMethodDefinition<T[number]>]: ParseMethodDefinition<T[number]>[k] & { name: k }
+}[keyof ParseMethodDefinition<T[number]>]>;
+
+export type Parser<T extends MethodDefinitions> = (query: string) => ParsingCandidates<T>;
+export type CreateParser = <T extends MethodDefinitions>(definitions: T) => Parser<T>;