@aiquants/markdown-explorer 0.3.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/CHANGELOG.md +28 -0
  2. package/README.md +45 -6
  3. package/dist/ExplorerSplit-rUVsf5i-.cjs +1 -0
  4. package/dist/ExplorerSplit-uX2ojZe8.js +1479 -0
  5. package/dist/MultiLayout-8s7q3-Hm.js +919 -0
  6. package/dist/MultiLayout-ZK2V9nms.cjs +1 -0
  7. package/dist/NativeScrollBar-D3VDRQqf.js +59 -0
  8. package/dist/NativeScrollBar-DqkutcGb.cjs +1 -0
  9. package/dist/{TreeLayout-D6hCSihW.js → TreeLayout-C7ZNnaOr.js} +3 -3
  10. package/dist/{TreeLayout-BQUfVNlA.cjs → TreeLayout-DkTVgxxb.cjs} +1 -1
  11. package/dist/core/config.d.cts +11 -0
  12. package/dist/core/config.d.ts +11 -0
  13. package/dist/core/contracts.d.cts +8 -0
  14. package/dist/core/contracts.d.ts +8 -0
  15. package/dist/core/labels.d.cts +5 -1
  16. package/dist/core/labels.d.ts +5 -1
  17. package/dist/core/treeSettings.d.cts +4 -2
  18. package/dist/core/treeSettings.d.ts +4 -2
  19. package/dist/dataRoute-DYjYBiXF.cjs +1 -0
  20. package/dist/{dataRoute-zUX-oR9j.js → dataRoute-Dl6xmEFs.js} +41 -36
  21. package/dist/index-CLe6vRXs.cjs +3 -0
  22. package/dist/{index-BJTmp0lR.js → index-Dv9lUZqD.js} +530 -503
  23. package/dist/index.cjs +1 -1
  24. package/dist/index.d.cts +2 -2
  25. package/dist/index.d.ts +2 -2
  26. package/dist/index.js +23 -22
  27. package/dist/location-2QZADLiv.cjs +1 -0
  28. package/dist/{location-V5BKeWNs.js → location-CaNtUswk.js} +202 -187
  29. package/dist/sanitizeWorker.cjs +1 -1
  30. package/dist/sanitizeWorker.js +1 -1
  31. package/dist/scrollBarGeometry-C46jBtmM.cjs +1 -0
  32. package/dist/scrollBarGeometry-DOBdGNV-.js +4 -0
  33. package/dist/server/errors.d.cts +1 -1
  34. package/dist/server/errors.d.ts +1 -1
  35. package/dist/server/fileSystemSource.d.cts +1 -0
  36. package/dist/server/fileSystemSource.d.ts +1 -0
  37. package/dist/server/ports.d.cts +4 -0
  38. package/dist/server/ports.d.ts +4 -0
  39. package/dist/server.cjs +1 -1
  40. package/dist/server.d.cts +1 -1
  41. package/dist/server.d.ts +1 -1
  42. package/dist/server.js +725 -680
  43. package/dist/styles/markdown-explorer.css +1 -1
  44. package/dist/tapScrollCircle-C5DGI-0H.cjs +1 -0
  45. package/dist/tapScrollCircle-u4EXeLhx.js +6 -0
  46. package/docs/behavior/dom-hooks.md +3 -1
  47. package/docs/behavior/layout.md +2 -0
  48. package/docs/behavior/localization.md +1 -0
  49. package/docs/behavior/security.md +1 -1
  50. package/package.json +7 -7
  51. package/dist/ExplorerSplit-B7pmzR8t.js +0 -1362
  52. package/dist/ExplorerSplit-Bi3yU6NG.cjs +0 -1
  53. package/dist/MultiLayout-BxeXOLX1.js +0 -909
  54. package/dist/MultiLayout-DtFrFRmS.cjs +0 -1
  55. package/dist/dataRoute-B9Wk-G7A.cjs +0 -1
  56. package/dist/index-DkiGlM7C.cjs +0 -3
  57. package/dist/location-DfYTzfFS.cjs +0 -1
package/dist/server.js CHANGED
@@ -1,20 +1,20 @@
1
- import { b as it, c as _t, f as Re, d as Nt, g as At, h as It, j as Mt, E as vt, k as Pt, i as te, l as $t, r as ct, m as jt, n as Lt, o as ut, p as zt, q as Ct, s as de, t as ee, e as Dt } from "./dataRoute-zUX-oR9j.js";
2
- import { D as lo, M as fo, u as mo } from "./dataRoute-zUX-oR9j.js";
3
- import { createHash as Ht, createHmac as Bt } from "node:crypto";
4
- import { createLinkCardHandler as Ft } from "@aiquants/markdown/server";
5
- import { data as Pe, redirect as Ut } from "react-router";
6
- import { w as Xt, d as Gt, r as Jt, i as Wt, a as Yt, p as Kt, b as Vt, f as Zt, N as Qt } from "./location-V5BKeWNs.js";
7
- import { existsSync as qt, statSync as er, realpathSync as tr, constants as ie } from "node:fs";
8
- import { extname as rr, isAbsolute as $e, relative as je, sep as Le, join as nr, resolve as or } from "node:path";
9
- import { fileURLToPath as be } from "node:url";
10
- import { Worker as sr } from "node:worker_threads";
11
- import { open as lt, lstat as ar, realpath as ir, readdir as cr } from "node:fs/promises";
12
- import { Readable as ur } from "node:stream";
13
- const ze = Object.freeze({ kind: "anonymous" }), so = Object.freeze({
14
- authenticate: async () => ({ status: "signed-in", principal: ze }),
15
- principalKey: () => ze.kind,
1
+ import { b as ut, c as Nt, f as _e, d as At, g as It, h as Mt, j as vt, E as Pt, i as te, k as $t, l as jt, r as lt, m as Lt, n as zt, o as dt, p as Dt, q as Ct, s as fe, t as ne, e as Ht } from "./dataRoute-Dl6xmEFs.js";
2
+ import { D as mo, M as po, u as wo } from "./dataRoute-Dl6xmEFs.js";
3
+ import { createHash as Bt, createHmac as Ft } from "node:crypto";
4
+ import { createLinkCardHandler as Ut } from "@aiquants/markdown/server";
5
+ import { data as je, redirect as Xt } from "react-router";
6
+ import { w as Gt, d as Jt, r as Wt, i as Yt, a as Kt, p as Vt, b as Zt, f as Qt, N as qt } from "./location-CaNtUswk.js";
7
+ import { existsSync as er, statSync as tr, realpathSync as rr, constants as ce } from "node:fs";
8
+ import { extname as nr, isAbsolute as Le, relative as ze, sep as De, join as or, resolve as sr } from "node:path";
9
+ import { fileURLToPath as Se } from "node:url";
10
+ import { Worker as ar } from "node:worker_threads";
11
+ import { open as ft, lstat as ir, realpath as cr, readdir as ur } from "node:fs/promises";
12
+ import { Readable as lr } from "node:stream";
13
+ const Ce = Object.freeze({ kind: "anonymous" }), io = Object.freeze({
14
+ authenticate: async () => ({ status: "signed-in", principal: Ce }),
15
+ principalKey: () => Ce.kind,
16
16
  signedOutPage: (e, t) => new Response(null, { status: 401, headers: t })
17
- }), lr = "application/octet-stream", dt = "application/pdf", dr = /* @__PURE__ */ new Set([
17
+ }), dr = "application/octet-stream", mt = "application/pdf", fr = /* @__PURE__ */ new Set([
18
18
  "image/png",
19
19
  "image/apng",
20
20
  "image/jpeg",
@@ -40,8 +40,8 @@ const ze = Object.freeze({ kind: "anonymous" }), so = Object.freeze({
40
40
  "video/webm",
41
41
  "video/ogg",
42
42
  "video/quicktime",
43
- dt
44
- ]), ft = "default-src 'none'; media-src 'self'; style-src 'unsafe-inline'", fr = `${ft}; sandbox`, mr = `${ft}; sandbox allow-same-origin`, Ce = /^[!#$%&'*+\-.^_`|~0-9A-Za-z]+$/u, pr = /^[\t\n\r ]+|[\t\n\r ]+$/gu, _e = /^[\t ]+|[\t ]+$/gu, wr = (e) => {
43
+ mt
44
+ ]), pt = "default-src 'none'; media-src 'self'; style-src 'unsafe-inline'", mr = `${pt}; sandbox`, pr = `${pt}; sandbox allow-same-origin`, He = /^[!#$%&'*+\-.^_`|~0-9A-Za-z]+$/u, wr = /^[\t\n\r ]+|[\t\n\r ]+$/gu, Ne = /^[\t ]+|[\t ]+$/gu, hr = (e) => {
45
45
  const t = [];
46
46
  let r = "", n = 0;
47
47
  for (; ; ) {
@@ -53,65 +53,65 @@ const ze = Object.freeze({ kind: "anonymous" }), so = Object.freeze({
53
53
  n += e[n] === "\\" ? 2 : 1;
54
54
  if (n = Math.min(n + 1, e.length), r += e.slice(a, n), n < e.length) continue;
55
55
  }
56
- if (t.push(r.replace(_e, "")), r = "", n >= e.length) return t;
56
+ if (t.push(r.replace(Ne, "")), r = "", n >= e.length) return t;
57
57
  n += 1;
58
58
  }
59
- }, hr = (e) => {
60
- const t = e.replace(pr, ""), r = t.indexOf("/");
59
+ }, gr = (e) => {
60
+ const t = e.replace(wr, ""), r = t.indexOf("/");
61
61
  if (r < 0) return null;
62
62
  const n = t.slice(0, r), a = t.indexOf(";", r + 1), o = t.slice(r + 1, a < 0 ? t.length : a).replace(/[\t\n\r ]+$/u, "");
63
- return Ce.test(n) && Ce.test(o) ? `${n}/${o}`.toLowerCase() : null;
64
- }, gr = (e) => {
63
+ return He.test(n) && He.test(o) ? `${n}/${o}`.toLowerCase() : null;
64
+ }, yr = (e) => {
65
65
  let t = null;
66
- for (const r of wr(e)) {
67
- const n = hr(r);
66
+ for (const r of hr(e)) {
67
+ const n = gr(r);
68
68
  n !== null && n !== "*/*" && (t = n);
69
69
  }
70
70
  return t;
71
- }, Er = /['()*]/gu, yr = (e) => encodeURIComponent(e).replace(Er, (t) => `%${t.charCodeAt(0).toString(16).toUpperCase()}`), br = Object.freeze({
71
+ }, Er = /['()*]/gu, br = (e) => encodeURIComponent(e).replace(Er, (t) => `%${t.charCodeAt(0).toString(16).toUpperCase()}`), Sr = Object.freeze({
72
72
  "Cache-Control": "private, max-age=60, stale-while-revalidate=600, no-transform",
73
73
  Vary: "Cookie"
74
- }), Sr = (e, t) => {
75
- const r = gr(e), n = r !== null && dr.has(r), a = n && (r.startsWith("audio/") || r.startsWith("video/"));
74
+ }), Tr = (e, t) => {
75
+ const r = yr(e), n = r !== null && fr.has(r), a = n && (r.startsWith("audio/") || r.startsWith("video/"));
76
76
  return {
77
- contentType: r === null ? lr : r,
77
+ contentType: r === null ? dr : r,
78
78
  inline: n,
79
79
  headers: {
80
80
  "X-Content-Type-Options": "nosniff",
81
- "Content-Disposition": `${n ? "inline" : "attachment"}; filename*=UTF-8''${yr(t)}`,
82
- ...r === dt ? {} : { "Content-Security-Policy": a ? mr : fr },
81
+ "Content-Disposition": `${n ? "inline" : "attachment"}; filename*=UTF-8''${br(t)}`,
82
+ ...r === mt ? {} : { "Content-Security-Policy": a ? pr : mr },
83
83
  "Cross-Origin-Resource-Policy": "same-origin"
84
84
  }
85
85
  };
86
- }, Tr = /^bytes=(?:(\d+)-(\d*)|-(\d+))$/iu, fe = Object.freeze({ kind: "whole" }), De = Object.freeze({ kind: "unsatisfiable" }), xr = (e, t, r) => {
86
+ }, xr = /^bytes=(?:(\d+)-(\d*)|-(\d+))$/iu, me = Object.freeze({ kind: "whole" }), Be = Object.freeze({ kind: "unsatisfiable" }), kr = (e, t, r) => {
87
87
  const n = e.get("Range");
88
- if (n === null) return fe;
88
+ if (n === null) return me;
89
89
  const a = e.get("If-Range");
90
- if (a !== null && a !== r) return fe;
91
- const o = Tr.exec(n);
92
- if (o === null) return fe;
93
- const [, c, f, g] = o;
94
- if (g !== void 0) {
95
- const p = Number(g);
96
- if (p === 0) return De;
97
- const _ = Math.max(0, t - p);
98
- return { kind: "partial", range: { offset: _, length: t - _ } };
90
+ if (a !== null && a !== r) return me;
91
+ const o = xr.exec(n);
92
+ if (o === null) return me;
93
+ const [, i, l, y] = o;
94
+ if (y !== void 0) {
95
+ const w = Number(y);
96
+ if (w === 0) return Be;
97
+ const O = Math.max(0, t - w);
98
+ return { kind: "partial", range: { offset: O, length: t - O } };
99
99
  }
100
- const T = Number(c), d = f === "" ? Number.POSITIVE_INFINITY : Number(f);
101
- return d < T ? fe : T >= t ? De : { kind: "partial", range: { offset: T, length: Math.min(d, t - 1) - T + 1 } };
102
- }, He = "W/", Or = (e) => {
100
+ const x = Number(i), f = l === "" ? Number.POSITIVE_INFINITY : Number(l);
101
+ return f < x ? me : x >= t ? Be : { kind: "partial", range: { offset: x, length: Math.min(f, t - 1) - x + 1 } };
102
+ }, Fe = "W/", Or = (e) => {
103
103
  const t = [];
104
104
  let r = 0, n = !1;
105
105
  for (let a = 0; a < e.length; a += 1)
106
- e[a] === '"' ? n = !n : e[a] === "," && !n && (t.push(e.slice(r, a).replace(_e, "")), r = a + 1);
107
- return t.push(e.slice(r).replace(_e, "")), t;
108
- }, Be = (e) => e.startsWith(He) ? e.slice(He.length) : e, kr = (e, t) => {
106
+ e[a] === '"' ? n = !n : e[a] === "," && !n && (t.push(e.slice(r, a).replace(Ne, "")), r = a + 1);
107
+ return t.push(e.slice(r).replace(Ne, "")), t;
108
+ }, Ue = (e) => e.startsWith(Fe) ? e.slice(Fe.length) : e, Rr = (e, t) => {
109
109
  if (e === null) return !1;
110
110
  const r = Or(e);
111
111
  if (r.length === 1 && r[0] === "*") return !0;
112
- const n = Be(t);
113
- return r.some((a) => Be(a) === n);
114
- }, Rr = (e, t) => {
112
+ const n = Ue(t);
113
+ return r.some((a) => Ue(a) === n);
114
+ }, _r = (e, t) => {
115
115
  let r = t;
116
116
  return e.pipeThrough(
117
117
  new TransformStream({
@@ -124,91 +124,91 @@ const ze = Object.freeze({ kind: "anonymous" }), so = Object.freeze({
124
124
  }
125
125
  })
126
126
  );
127
- }, Se = async (e, t, r, n, a) => {
127
+ }, Te = async (e, t, r, n, a) => {
128
128
  if (n !== null && r.set("Content-Length", String(n)), e.method.toUpperCase() === "HEAD") return new Response(null, { status: t, headers: r });
129
129
  const o = await a();
130
- return new Response(n === null ? o : Rr(o, n), { status: t, headers: r });
131
- }, _r = (e, t) => {
130
+ return new Response(n === null ? o : _r(o, n), { status: t, headers: r });
131
+ }, Nr = (e, t) => {
132
132
  const r = new Headers(e);
133
133
  for (const [n, a] of Object.entries({ "Accept-Ranges": "bytes", "Content-Range": `bytes */${t}`, "Cache-Control": "private, no-store", "X-Content-Type-Options": "nosniff" })) r.set(n, a);
134
134
  return new Response(null, { status: 416, headers: r });
135
- }, Nr = async (e, t, r) => {
136
- const n = `"${t.version}"`, a = Sr(t.contentType, t.name), o = new Headers(r);
137
- for (const [g, T] of Object.entries({ ...a.headers, ...br, ETag: n })) o.set(g, T);
138
- if (kr(e.headers.get("If-None-Match"), n)) return new Response(null, { status: 304, headers: o });
139
- if (o.set("Content-Type", a.contentType), t.size === null) return Se(e, 200, o, null, () => t.open(null));
135
+ }, Ar = async (e, t, r) => {
136
+ const n = `"${t.version}"`, a = Tr(t.contentType, t.name), o = new Headers(r);
137
+ for (const [y, x] of Object.entries({ ...a.headers, ...Sr, ETag: n })) o.set(y, x);
138
+ if (Rr(e.headers.get("If-None-Match"), n)) return new Response(null, { status: 304, headers: o });
139
+ if (o.set("Content-Type", a.contentType), t.size === null) return Te(e, 200, o, null, () => t.open(null));
140
140
  if (t.size === 0)
141
141
  return o.set("Content-Length", "0"), new Response(null, { status: 200, headers: o });
142
142
  o.set("Accept-Ranges", "bytes");
143
- const c = xr(e.headers, t.size, n);
144
- if (c.kind === "unsatisfiable") return _r(r, t.size);
145
- if (c.kind === "whole") return Se(e, 200, o, t.size, () => t.open(null));
146
- const { range: f } = c;
147
- return o.set("Content-Range", `bytes ${f.offset}-${f.offset + f.length - 1}/${t.size}`), Se(e, 206, o, f.length, () => t.open(f));
148
- }, Te = (e, t) => {
143
+ const i = kr(e.headers, t.size, n);
144
+ if (i.kind === "unsatisfiable") return Nr(r, t.size);
145
+ if (i.kind === "whole") return Te(e, 200, o, t.size, () => t.open(null));
146
+ const { range: l } = i;
147
+ return o.set("Content-Range", `bytes ${l.offset}-${l.offset + l.length - 1}/${t.size}`), Te(e, 206, o, l.length, () => t.open(l));
148
+ }, xe = (e, t) => {
149
149
  const r = new AbortController(), n = t(AbortSignal.any([e.signal, r.signal]));
150
150
  return new Promise((a) => {
151
151
  let o;
152
- const c = setTimeout(() => {
152
+ const i = setTimeout(() => {
153
153
  a(e.late), o = setTimeout(() => r.abort(), e.handOverMs);
154
- }, e.timeoutMs), f = () => {
155
- clearTimeout(c), clearTimeout(o);
154
+ }, e.timeoutMs), l = () => {
155
+ clearTimeout(i), clearTimeout(o);
156
156
  };
157
157
  n.then(
158
- (g) => {
159
- f(), a(g);
158
+ (y) => {
159
+ l(), a(y);
160
160
  },
161
161
  () => {
162
- f(), a(e.late);
162
+ l(), a(e.late);
163
163
  }
164
164
  );
165
165
  });
166
- }, Ar = Object.freeze({
166
+ }, Ir = Object.freeze({
167
167
  error: (e, t) => {
168
168
  console.error(e, t);
169
169
  }
170
- }), mt = /* @__PURE__ */ Symbol.for("@aiquants/markdown-explorer:ExplorerError");
170
+ }), wt = /* @__PURE__ */ Symbol.for("@aiquants/markdown-explorer:ExplorerError");
171
171
  class Ee extends Error {
172
172
  reason;
173
173
  code;
174
174
  constructor(t, r = {}) {
175
- if (!it(t)) throw new RangeError(`[markdown-explorer] ExplorerError needs a failure reason; got ${JSON.stringify(t)}`);
176
- if (r.code !== void 0 && !_t(r.code)) throw new RangeError(`[markdown-explorer] an ExplorerError code must be 1 to 64 lowercase letters, digits or hyphens; got ${JSON.stringify(r.code)}`);
177
- super(`[markdown-explorer] ${t}`, r.cause === void 0 ? void 0 : { cause: r.cause }), this.name = "ExplorerError", this.reason = t, this.code = r.code, Object.defineProperty(this, mt, { value: !0 });
175
+ if (!ut(t)) throw new RangeError(`[markdown-explorer] ExplorerError needs a failure reason; got ${JSON.stringify(t)}`);
176
+ if (r.code !== void 0 && !Nt(r.code)) throw new RangeError(`[markdown-explorer] an ExplorerError code must be 1 to 64 lowercase letters, digits or hyphens; got ${JSON.stringify(r.code)}`);
177
+ super(`[markdown-explorer] ${t}`, r.cause === void 0 ? void 0 : { cause: r.cause }), this.name = "ExplorerError", this.reason = t, this.code = r.code, Object.defineProperty(this, wt, { value: !0 });
178
178
  }
179
179
  }
180
- const Ir = (e) => e instanceof Error && Object.hasOwn(e, mt) && it(e.reason), Mr = (e) => typeof e == "object" && e !== null && e.name === "AbortError", Ne = (e, t, r) => {
180
+ const Mr = (e) => e instanceof Error && Object.hasOwn(e, wt) && ut(e.reason), vr = (e) => typeof e == "object" && e !== null && e.name === "AbortError", Ie = (e, t, r) => {
181
181
  try {
182
182
  e.error(t, r);
183
183
  } catch (n) {
184
184
  console.error("[markdown-explorer] the logger threw while reporting a failure", { operation: r.operation, error: n });
185
185
  }
186
- }, q = (e, t) => Ne(e, `[markdown-explorer] ${t.operation} failed`, t), vr = (e, t) => Ne(e, `[markdown-explorer] ${t.operation} left out an entry`, t), Pr = (e, t) => Ne(e, `[markdown-explorer] ${t.operation} refused a path the deny rules match`, { ...t, error: new RangeError("[markdown-explorer] the path matches a deny rule") }), Fe = (e, t) => {
186
+ }, ee = (e, t) => Ie(e, `[markdown-explorer] ${t.operation} failed`, t), Pr = (e, t) => Ie(e, `[markdown-explorer] ${t.operation} left out an entry`, t), $r = (e, t) => Ie(e, `[markdown-explorer] ${t.operation} refused a path the deny rules match`, { ...t, error: new RangeError("[markdown-explorer] the path matches a deny rule") }), Xe = (e, t) => {
187
187
  e === null || typeof e != "object" && typeof e != "function" || Promise.resolve(e).then(void 0, t);
188
- }, Q = (e, t, r, n) => Ir(e) ? Re(e.reason, e.code) : (Mr(e) || r.aborted || q(n, { ...t, error: e }), { reason: "failed" }), Ue = (e, t) => {
188
+ }, Q = (e, t, r, n) => Mr(e) ? _e(e.reason, e.code) : (vr(e) || r.aborted || ee(n, { ...t, error: e }), { reason: "failed" }), Ge = (e, t) => {
189
189
  if (!Number.isSafeInteger(t) || t <= 0) throw new RangeError(`[markdown-explorer] a cache ${e} must be a positive integer; got ${String(t)}`);
190
- }, pt = (e, t) => {
191
- Ue("capacity", e), t !== void 0 && Ue("weight budget", t.max);
190
+ }, ht = (e, t) => {
191
+ Ge("capacity", e), t !== void 0 && Ge("weight budget", t.max);
192
192
  const r = /* @__PURE__ */ new Map();
193
193
  let n = 0;
194
194
  const a = (o) => {
195
- const c = r.get(o);
196
- c !== void 0 && (r.delete(o), n -= c.weight);
195
+ const i = r.get(o);
196
+ i !== void 0 && (r.delete(o), n -= i.weight);
197
197
  };
198
198
  return {
199
199
  get: (o) => {
200
- const c = r.get(o);
201
- if (c !== void 0)
202
- return r.delete(o), r.set(o, c), c.value;
200
+ const i = r.get(o);
201
+ if (i !== void 0)
202
+ return r.delete(o), r.set(o, i), i.value;
203
203
  },
204
- set: (o, c) => {
204
+ set: (o, i) => {
205
205
  a(o);
206
- const f = t === void 0 ? 0 : t.of(o, c);
207
- if (!(t !== void 0 && f > t.max)) {
208
- r.set(o, { value: c, weight: f }), n += f;
209
- for (const g of r.keys()) {
206
+ const l = t === void 0 ? 0 : t.of(o, i);
207
+ if (!(t !== void 0 && l > t.max)) {
208
+ r.set(o, { value: i, weight: l }), n += l;
209
+ for (const y of r.keys()) {
210
210
  if (r.size <= e && (t === void 0 || n <= t.max)) break;
211
- a(g);
211
+ a(y);
212
212
  }
213
213
  }
214
214
  },
@@ -216,662 +216,693 @@ const Ir = (e) => e instanceof Error && Object.hasOwn(e, mt) && it(e.reason), Mr
216
216
  size: () => r.size,
217
217
  weight: () => n
218
218
  };
219
- }, wt = (e) => Math.max(1, e - 1), $r = 2147483647, Xe = Object.freeze({ status: "aborted" }), re = (e, t, r) => {
219
+ }, gt = (e) => Math.max(1, e - 1), jr = 2147483647, Je = Object.freeze({ status: "aborted" }), oe = (e, t, r) => {
220
220
  const n = (e.get(t) ?? 0) + r;
221
221
  n === 0 ? e.delete(t) : e.set(t, n);
222
- }, se = (e, t, r) => {
222
+ }, ie = (e, t, r) => {
223
223
  if (!Number.isSafeInteger(t) || t <= 0 || t > r) throw new RangeError(`[markdown-explorer] a worker pool's ${e} must be an integer in 1..${String(r)}; got ${String(t)}`);
224
- }, jr = (e) => e !== null && typeof e == "object" && e.ready === !0 && !("id" in e), Lr = (e, t) => e !== null && typeof e == "object" && e.id === t && "output" in e, zr = ({ url: e, size: t, deadlineMs: r, jobsPerScope: n, maxQueuedJobs: a, heapLimits: o }) => {
225
- se("size", t, Number.MAX_SAFE_INTEGER), se("deadline", r, $r), se("jobsPerScope", n, Number.MAX_SAFE_INTEGER), se("maxQueuedJobs", a, Number.MAX_SAFE_INTEGER), se("maxOldGenerationSizeMb", o.maxOldGenerationSizeMb, Number.MAX_SAFE_INTEGER), se("maxYoungGenerationSizeMb", o.maxYoungGenerationSizeMb, Number.MAX_SAFE_INTEGER);
226
- const c = Object.freeze({ maxOldGenerationSizeMb: o.maxOldGenerationSizeMb, maxYoungGenerationSizeMb: o.maxYoungGenerationSizeMb }), f = /* @__PURE__ */ new Set(), g = [], T = /* @__PURE__ */ new Map(), d = /* @__PURE__ */ new Map(), p = wt(t);
227
- let _ = 0;
228
- const R = (u, i) => {
229
- const { job: E } = u;
230
- u.timer !== null && clearTimeout(u.timer), u.timer = null, u.job = null, u.sent = !1, E !== null && (re(T, E.scope, -1), re(d, E.scope, -1), E.settle(i));
231
- }, I = (u) => {
232
- const [i] = g.splice(u, 1);
233
- i?.detach();
234
- }, O = () => {
235
- let u = -1, i = p, E = Number.POSITIVE_INFINITY;
236
- for (const [S, k] of g.entries()) {
237
- const A = T.get(k.scope) ?? 0, D = d.get(k.scope) ?? 0;
238
- (A < i || A === i && u >= 0 && D < E) && (u = S, i = A, E = D);
224
+ }, Lr = (e) => e !== null && typeof e == "object" && e.ready === !0 && !("id" in e), zr = (e, t) => e !== null && typeof e == "object" && e.id === t && "output" in e, Dr = ({ url: e, size: t, deadlineMs: r, jobsPerScope: n, maxQueuedJobs: a, heapLimits: o }) => {
225
+ ie("size", t, Number.MAX_SAFE_INTEGER), ie("deadline", r, jr), ie("jobsPerScope", n, Number.MAX_SAFE_INTEGER), ie("maxQueuedJobs", a, Number.MAX_SAFE_INTEGER), ie("maxOldGenerationSizeMb", o.maxOldGenerationSizeMb, Number.MAX_SAFE_INTEGER), ie("maxYoungGenerationSizeMb", o.maxYoungGenerationSizeMb, Number.MAX_SAFE_INTEGER);
226
+ const i = Object.freeze({ maxOldGenerationSizeMb: o.maxOldGenerationSizeMb, maxYoungGenerationSizeMb: o.maxYoungGenerationSizeMb }), l = /* @__PURE__ */ new Set(), y = [], x = /* @__PURE__ */ new Map(), f = /* @__PURE__ */ new Map(), w = gt(t);
227
+ let O = 0;
228
+ const _ = (u, h) => {
229
+ const { job: g } = u;
230
+ u.timer !== null && clearTimeout(u.timer), u.timer = null, u.job = null, u.sent = !1, g !== null && (oe(x, g.scope, -1), oe(f, g.scope, -1), g.settle(h));
231
+ }, v = (u) => {
232
+ const [h] = y.splice(u, 1);
233
+ h?.detach();
234
+ }, R = () => {
235
+ let u = -1, h = w, g = Number.POSITIVE_INFINITY;
236
+ for (const [T, b] of y.entries()) {
237
+ const N = x.get(b.scope) ?? 0, P = f.get(b.scope) ?? 0;
238
+ (N < h || N === h && u >= 0 && P < g) && (u = T, h = N, g = P);
239
239
  }
240
240
  return u;
241
- }, x = (u, i) => {
242
- f.has(u) && (f.delete(u), R(u, i), u.worker.terminate().catch(() => {
243
- }), z());
244
- }, P = (u) => {
241
+ }, k = (u, h) => {
242
+ l.has(u) && (l.delete(u), _(u, h), u.worker.terminate().catch(() => {
243
+ }), C());
244
+ }, j = (u) => {
245
245
  u.timer = setTimeout(() => {
246
- x(u, { status: "timeout" });
246
+ k(u, { status: "timeout" });
247
247
  }, r);
248
- }, b = (u, i) => u.sent ? { status: "crashed", error: i } : { status: "unavailable", error: i }, N = (u, i) => {
249
- u.sent = !0, P(u);
248
+ }, S = (u, h) => u.sent ? { status: "crashed", error: h } : { status: "unavailable", error: h }, A = (u, h) => {
249
+ u.sent = !0, j(u);
250
250
  try {
251
- u.worker.postMessage({ id: i.id, input: i.input });
252
- } catch (E) {
253
- R(u, { status: "crashed", error: E }), u.worker.unref();
251
+ u.worker.postMessage({ id: h.id, input: h.input });
252
+ } catch (g) {
253
+ _(u, { status: "crashed", error: g }), u.worker.unref();
254
254
  }
255
- }, C = () => {
256
- const u = { worker: new sr(e, { resourceLimits: c }), job: null, sent: !1, timer: null, ready: !1 };
255
+ }, D = () => {
256
+ const u = { worker: new ar(e, { resourceLimits: i }), job: null, sent: !1, timer: null, ready: !1 };
257
257
  return u.worker.unref(), u.timer = setTimeout(() => {
258
- x(u, { status: "unavailable", error: new Error(`[markdown-explorer] a worker did not start within ${String(r)} ms`) });
259
- }, r), u.worker.on("message", (i) => {
260
- if (!u.ready && jr(i)) {
261
- u.ready = !0, u.timer !== null && clearTimeout(u.timer), u.timer = null, u.job === null ? u.worker.unref() : N(u, u.job), u.job === null && z();
258
+ k(u, { status: "unavailable", error: new Error(`[markdown-explorer] a worker did not start within ${String(r)} ms`) });
259
+ }, r), u.worker.on("message", (h) => {
260
+ if (!u.ready && Lr(h)) {
261
+ u.ready = !0, u.timer !== null && clearTimeout(u.timer), u.timer = null, u.job === null ? u.worker.unref() : A(u, u.job), u.job === null && C();
262
262
  return;
263
263
  }
264
- const { job: E } = u;
265
- if (E === null || !Lr(i, E.id)) {
266
- x(u, b(u, new Error("[markdown-explorer] a worker sent a message that answers no job")));
264
+ const { job: g } = u;
265
+ if (g === null || !zr(h, g.id)) {
266
+ k(u, S(u, new Error("[markdown-explorer] a worker sent a message that answers no job")));
267
267
  return;
268
268
  }
269
- R(u, { status: "done", output: i.output }), u.worker.unref(), z();
270
- }), u.worker.on("error", (i) => {
271
- x(u, b(u, i));
272
- }), u.worker.on("messageerror", (i) => {
273
- x(u, b(u, i));
274
- }), u.worker.on("exit", (i) => {
275
- x(u, b(u, new Error(`[markdown-explorer] a worker exited with code ${String(i)}`)));
276
- }), f.add(u), u;
277
- }, z = () => {
269
+ _(u, { status: "done", output: h.output }), u.worker.unref(), C();
270
+ }), u.worker.on("error", (h) => {
271
+ k(u, S(u, h));
272
+ }), u.worker.on("messageerror", (h) => {
273
+ k(u, S(u, h));
274
+ }), u.worker.on("exit", (h) => {
275
+ k(u, S(u, new Error(`[markdown-explorer] a worker exited with code ${String(h)}`)));
276
+ }), l.add(u), u;
277
+ }, C = () => {
278
278
  for (; ; ) {
279
- const u = O(), i = g[u];
280
- if (i === void 0) return;
281
- let E;
282
- for (const k of f)
283
- if (k.job === null) {
284
- E = k;
279
+ const u = R(), h = y[u];
280
+ if (h === void 0) return;
281
+ let g;
282
+ for (const b of l)
283
+ if (b.job === null) {
284
+ g = b;
285
285
  break;
286
286
  }
287
- if (E === void 0 && f.size < t)
287
+ if (g === void 0 && l.size < t)
288
288
  try {
289
- E = C();
290
- } catch (k) {
291
- I(u), re(d, i.scope, -1), i.settle({ status: "unavailable", error: k });
289
+ g = D();
290
+ } catch (b) {
291
+ v(u), oe(f, h.scope, -1), h.settle({ status: "unavailable", error: b });
292
292
  continue;
293
293
  }
294
- if (E === void 0) return;
295
- I(u), re(T, i.scope, 1);
296
- const S = E;
297
- S.job = i, S.worker.ref(), S.ready && N(S, i);
294
+ if (g === void 0) return;
295
+ v(u), oe(x, h.scope, 1);
296
+ const T = g;
297
+ T.job = h, T.worker.ref(), T.ready && A(T, h);
298
298
  }
299
299
  };
300
300
  return {
301
- run: (u, { scope: i, signal: E }) => new Promise((S) => {
302
- if (E.aborted) {
303
- S(Xe);
301
+ run: (u, { scope: h, signal: g }) => new Promise((T) => {
302
+ if (g.aborted) {
303
+ T(Je);
304
304
  return;
305
305
  }
306
- if ((d.get(i) ?? 0) >= n) {
307
- S({ status: "refused", limit: "scope" });
306
+ if ((f.get(h) ?? 0) >= n) {
307
+ T({ status: "refused", limit: "scope" });
308
308
  return;
309
309
  }
310
- _ += 1;
311
- const k = { id: _, input: u, scope: i, settle: S, detach: () => {
310
+ O += 1;
311
+ const b = { id: O, input: u, scope: h, settle: T, detach: () => {
312
312
  } };
313
- g.push(k), re(d, i, 1), z();
314
- const A = g.indexOf(k);
315
- if (A < 0) return;
316
- if (g.length > a) {
317
- I(A), re(d, i, -1), S({ status: "refused", limit: "queue" });
313
+ y.push(b), oe(f, h, 1), C();
314
+ const N = y.indexOf(b);
315
+ if (N < 0) return;
316
+ if (y.length > a) {
317
+ v(N), oe(f, h, -1), T({ status: "refused", limit: "queue" });
318
318
  return;
319
319
  }
320
- const D = () => {
321
- const M = g.indexOf(k);
322
- M < 0 || (I(M), re(d, i, -1), S(Xe));
320
+ const P = () => {
321
+ const B = y.indexOf(b);
322
+ B < 0 || (v(B), oe(f, h, -1), T(Je));
323
323
  };
324
- E.addEventListener("abort", D, { once: !0 }), k.detach = () => {
325
- E.removeEventListener("abort", D);
324
+ g.addEventListener("abort", P, { once: !0 }), b.detach = () => {
325
+ g.removeEventListener("abort", P);
326
326
  };
327
327
  }),
328
- workers: () => f.size
328
+ workers: () => l.size
329
329
  };
330
- }, Ae = 1024 * 1024, Cr = 3e4, Dr = 4 * Ae, Hr = 64 * Ae, Br = 3, Fr = 2, Ur = (e, t) => e + wt(t) + Br, Xr = 4, Gr = 32, Jr = 512, Wr = 64, Yr = 4096, Kr = 32, Ge = 4096, Vr = 4, ht = ({ workerHeapMb: e, maxHtmlBytes: t }) => Math.floor(((e - Wr) * Ae - t * Kr) / Yr), Zr = ({ maxHtmlBytes: e }) => e, Qr = ({ maxHtmlBytes: e }) => Vr * e, qr = 1024, en = 2147483647, tn = 64, rn = 2 ** 29, nn = 1024 * 1024, on = 64, Je = Object.freeze({ status: "rejected", reason: "too-large", cause: null }), xe = Object.freeze({ status: "rejected", reason: "failed", cause: null }), ne = (e, t, r, n) => {
330
+ }, Me = 1024 * 1024, Cr = 3e4, Hr = 4 * Me, Br = 64 * Me, Fr = 3, Ur = 2, Xr = (e, t) => e + gt(t) + Fr, Gr = 4, Jr = 32, Wr = 512, Yr = 64, Kr = 4096, Vr = 32, We = 4096, Zr = 4, yt = ({ workerHeapMb: e, maxHtmlBytes: t }) => Math.floor(((e - Yr) * Me - t * Vr) / Kr), Qr = ({ maxHtmlBytes: e }) => e, qr = ({ maxHtmlBytes: e }) => Zr * e, en = 1024, tn = 2147483647, rn = 64, nn = 2 ** 29, on = 1024 * 1024, sn = 64, Ye = Object.freeze({ status: "rejected", reason: "too-large", cause: null }), ke = Object.freeze({ status: "rejected", reason: "failed", cause: null }), se = (e, t, r, n) => {
331
331
  if (t === void 0) return r;
332
332
  if (typeof t != "number") throw new TypeError(`[markdown-explorer] sanitizer.${e} must be a number; got ${typeof t}`);
333
333
  if (!Number.isSafeInteger(t) || t <= 0 || t > n) throw new RangeError(`[markdown-explorer] sanitizer.${e} must be an integer in 1..${String(n)}; got ${String(t)}`);
334
334
  return t;
335
- }, sn = (e, t) => {
335
+ }, an = (e, t) => {
336
336
  if (e !== void 0 && (e === null || typeof e != "object")) throw new TypeError("[markdown-explorer] sanitizer must be an object of { workers, deadlineMs, maxHtmlBytes, cacheBytes, workerHeapMb, jobsPerScope, maxQueuedJobs }");
337
- const { workers: r, deadlineMs: n, maxHtmlBytes: a, cacheBytes: o, workerHeapMb: c, jobsPerScope: f, maxQueuedJobs: g } = e ?? {}, T = ne("workers", r, Fr, tn), d = ne("jobsPerScope", f, Ur(t, T), Number.MAX_SAFE_INTEGER), p = Object.freeze({
338
- workers: T,
339
- deadlineMs: ne("deadlineMs", n, Cr, en),
340
- maxHtmlBytes: ne("maxHtmlBytes", a, Dr, rn),
341
- cacheBytes: ne("cacheBytes", o, Hr, Number.MAX_SAFE_INTEGER),
342
- workerHeapMb: ne("workerHeapMb", c, Jr, nn),
343
- jobsPerScope: d,
344
- maxQueuedJobs: ne("maxQueuedJobs", g, Xr * d, Number.MAX_SAFE_INTEGER)
337
+ const { workers: r, deadlineMs: n, maxHtmlBytes: a, cacheBytes: o, workerHeapMb: i, jobsPerScope: l, maxQueuedJobs: y } = e ?? {}, x = se("workers", r, Ur, rn), f = se("jobsPerScope", l, Xr(t, x), Number.MAX_SAFE_INTEGER), w = Object.freeze({
338
+ workers: x,
339
+ deadlineMs: se("deadlineMs", n, Cr, tn),
340
+ maxHtmlBytes: se("maxHtmlBytes", a, Hr, nn),
341
+ cacheBytes: se("cacheBytes", o, Br, Number.MAX_SAFE_INTEGER),
342
+ workerHeapMb: se("workerHeapMb", i, Wr, on),
343
+ jobsPerScope: f,
344
+ maxQueuedJobs: se("maxQueuedJobs", y, Gr * f, Number.MAX_SAFE_INTEGER)
345
345
  });
346
- if (p.jobsPerScope < t)
347
- throw new RangeError(`[markdown-explorer] sanitizer.jobsPerScope must be at least multiView.maxPanels (${String(t)}), because a page sends the document of every panel to the sanitizer at once for one reader; got ${String(p.jobsPerScope)}`);
348
- if (p.maxQueuedJobs < t)
349
- throw new RangeError(`[markdown-explorer] sanitizer.maxQueuedJobs must be at least multiView.maxPanels (${String(t)}), because a reader whose page finds every worker busy waits with the document of every panel; got ${String(p.maxQueuedJobs)}`);
350
- if (ht(p) < Ge)
346
+ if (w.jobsPerScope < t)
347
+ throw new RangeError(`[markdown-explorer] sanitizer.jobsPerScope must be at least multiView.maxPanels (${String(t)}), because a page sends the document of every panel to the sanitizer at once for one reader; got ${String(w.jobsPerScope)}`);
348
+ if (w.maxQueuedJobs < t)
349
+ throw new RangeError(`[markdown-explorer] sanitizer.maxQueuedJobs must be at least multiView.maxPanels (${String(t)}), because a reader whose page finds every worker busy waits with the document of every panel; got ${String(w.maxQueuedJobs)}`);
350
+ if (yt(w) < We)
351
351
  throw new RangeError(
352
- `[markdown-explorer] sanitizer.workerHeapMb (${String(p.workerHeapMb)} MiB) must leave room for ${String(Ge)} parsed nodes beside HTML of sanitizer.maxHtmlBytes (${String(p.maxHtmlBytes)} bytes); raise workerHeapMb or lower maxHtmlBytes`
352
+ `[markdown-explorer] sanitizer.workerHeapMb (${String(w.workerHeapMb)} MiB) must leave room for ${String(We)} parsed nodes beside HTML of sanitizer.maxHtmlBytes (${String(w.maxHtmlBytes)} bytes); raise workerHeapMb or lower maxHtmlBytes`
353
353
  );
354
- return p;
355
- }, an = () => {
356
- const e = import.meta.url, t = new URL(`./sanitizeWorker${rr(be(e))}`, e);
357
- if (!qt(be(t))) throw new Error(`[markdown-explorer] the HTML sanitizer worker is missing: ${be(t)}`);
354
+ return w;
355
+ }, cn = () => {
356
+ const e = import.meta.url, t = new URL(`./sanitizeWorker${nr(Se(e))}`, e);
357
+ if (!er(Se(t))) throw new Error(`[markdown-explorer] the HTML sanitizer worker is missing: ${Se(t)}`);
358
358
  return t;
359
- }, We = /* @__PURE__ */ new Map(), cn = (e, t) => {
359
+ }, Ke = /* @__PURE__ */ new Map(), un = (e, t) => {
360
360
  const r = [e.href, t.workers, t.deadlineMs, t.workerHeapMb, t.jobsPerScope, t.maxQueuedJobs].map(String).join("\0");
361
- let n = We.get(r);
362
- return n === void 0 && (n = zr({
361
+ let n = Ke.get(r);
362
+ return n === void 0 && (n = Dr({
363
363
  url: e,
364
364
  size: t.workers,
365
365
  deadlineMs: t.deadlineMs,
366
366
  jobsPerScope: t.jobsPerScope,
367
367
  maxQueuedJobs: t.maxQueuedJobs,
368
- heapLimits: { maxOldGenerationSizeMb: t.workerHeapMb, maxYoungGenerationSizeMb: Gr }
369
- }), We.set(r, n)), n;
370
- }, un = (e) => {
368
+ heapLimits: { maxOldGenerationSizeMb: t.workerHeapMb, maxYoungGenerationSizeMb: Jr }
369
+ }), Ke.set(r, n)), n;
370
+ }, ln = (e) => {
371
371
  if (e === null || typeof e != "object") return !1;
372
372
  const { status: t, html: r, message: n } = e;
373
373
  return t === "sanitized" && typeof r == "string" || t === "too-large" || t === "error" && typeof n == "string";
374
- }, ln = (e) => e instanceof Error && e.code === "ERR_WORKER_OUT_OF_MEMORY", dn = ({ iframeHosts: e, dataPath: t, options: r, pool: n }) => {
375
- const a = Object.freeze([...e]), o = ht(r), c = Zr(r), f = Qr(r), g = pt(qr, {
374
+ }, dn = (e) => e instanceof Error && e.code === "ERR_WORKER_OUT_OF_MEMORY", fn = ({ iframeHosts: e, dataPath: t, options: r, pool: n }) => {
375
+ const a = Object.freeze([...e]), o = yt(r), i = Qr(r), l = qr(r), y = ht(en, {
376
376
  max: r.cacheBytes,
377
- of: (O, x) => 2 * O.length + (x.status === "sanitized" ? 2 * x.html.length : on)
378
- }), T = /* @__PURE__ */ new Map(), d = /* @__PURE__ */ new Map(), p = (O) => {
379
- T.get(O.key) === O && T.delete(O.key);
380
- const x = d.get(O.hash);
381
- x?.delete(O), x?.size === 0 && d.delete(O.hash);
382
- }, _ = async (O, x, P) => {
383
- const b = await n.run({ html: O, iframeHosts: a, dataPath: t, maxNodes: o, maxAttributeChars: c, maxSanitizedChars: f }, { scope: x, signal: P });
384
- if (b.status === "refused") {
385
- const C = b.limit === "scope" ? `its reader already has ${String(r.jobsPerScope)} documents being sanitized or waiting` : `${String(r.maxQueuedJobs)} documents are already waiting`;
386
- return { outcome: { status: "rejected", reason: "failed", cause: new Error(`[markdown-explorer] the HTML sanitizer refused a document: ${C}`) }, lasting: !1 };
377
+ of: (R, k) => 2 * R.length + (k.status === "sanitized" ? 2 * k.html.length : sn)
378
+ }), x = /* @__PURE__ */ new Map(), f = /* @__PURE__ */ new Map(), w = (R) => {
379
+ x.get(R.key) === R && x.delete(R.key);
380
+ const k = f.get(R.hash);
381
+ k?.delete(R), k?.size === 0 && f.delete(R.hash);
382
+ }, O = async (R, k, j) => {
383
+ const S = await n.run({ html: R, iframeHosts: a, dataPath: t, maxNodes: o, maxAttributeChars: i, maxSanitizedChars: l }, { scope: k, signal: j });
384
+ if (S.status === "refused") {
385
+ const D = S.limit === "scope" ? `its reader already has ${String(r.jobsPerScope)} documents being sanitized or waiting` : `${String(r.maxQueuedJobs)} documents are already waiting`;
386
+ return { outcome: { status: "rejected", reason: "failed", cause: new Error(`[markdown-explorer] the HTML sanitizer refused a document: ${D}`) }, lasting: !1 };
387
387
  }
388
- if (b.status === "aborted") return { outcome: xe, lasting: !1 };
389
- if (b.status === "timeout") return { outcome: { status: "rejected", reason: "too-large", cause: new Error(`[markdown-explorer] the HTML sanitizer did not finish within ${String(r.deadlineMs)} ms`) }, lasting: !0 };
390
- if (b.status === "unavailable") return { outcome: { status: "rejected", reason: "failed", cause: new Error("[markdown-explorer] the HTML sanitizer worker could not start", { cause: b.error }) }, lasting: !1 };
391
- if (b.status === "crashed" && ln(b.error))
392
- return { outcome: { status: "rejected", reason: "too-large", cause: new Error(`[markdown-explorer] the HTML sanitizer ran out of its ${String(r.workerHeapMb)} MiB worker heap`, { cause: b.error }) }, lasting: !0 };
393
- if (b.status === "crashed") return { outcome: { status: "rejected", reason: "failed", cause: new Error("[markdown-explorer] the HTML sanitizer worker failed", { cause: b.error }) }, lasting: !0 };
394
- const { output: N } = b;
395
- return un(N) ? N.status === "too-large" ? { outcome: Je, lasting: !0 } : N.status === "error" ? { outcome: { status: "rejected", reason: "failed", cause: new Error(`[markdown-explorer] the HTML sanitizer failed: ${N.message}`) }, lasting: !0 } : N.html.length > f ? { outcome: { status: "rejected", reason: "too-large", cause: new Error(`[markdown-explorer] the HTML sanitizer's output of ${String(N.html.length)} characters exceeds its limit of ${String(f)}`) }, lasting: !0 } : { outcome: { status: "sanitized", html: N.html }, lasting: !0 } : { outcome: { status: "rejected", reason: "failed", cause: new Error("[markdown-explorer] the HTML sanitizer worker answered something that is not an outcome") }, lasting: !0 };
396
- }, R = (O, x, P, b) => {
397
- let N = () => {
388
+ if (S.status === "aborted") return { outcome: ke, lasting: !1 };
389
+ if (S.status === "timeout") return { outcome: { status: "rejected", reason: "too-large", cause: new Error(`[markdown-explorer] the HTML sanitizer did not finish within ${String(r.deadlineMs)} ms`) }, lasting: !0 };
390
+ if (S.status === "unavailable") return { outcome: { status: "rejected", reason: "failed", cause: new Error("[markdown-explorer] the HTML sanitizer worker could not start", { cause: S.error }) }, lasting: !1 };
391
+ if (S.status === "crashed" && dn(S.error))
392
+ return { outcome: { status: "rejected", reason: "too-large", cause: new Error(`[markdown-explorer] the HTML sanitizer ran out of its ${String(r.workerHeapMb)} MiB worker heap`, { cause: S.error }) }, lasting: !0 };
393
+ if (S.status === "crashed") return { outcome: { status: "rejected", reason: "failed", cause: new Error("[markdown-explorer] the HTML sanitizer worker failed", { cause: S.error }) }, lasting: !0 };
394
+ const { output: A } = S;
395
+ return ln(A) ? A.status === "too-large" ? { outcome: Ye, lasting: !0 } : A.status === "error" ? { outcome: { status: "rejected", reason: "failed", cause: new Error(`[markdown-explorer] the HTML sanitizer failed: ${A.message}`) }, lasting: !0 } : A.html.length > l ? { outcome: { status: "rejected", reason: "too-large", cause: new Error(`[markdown-explorer] the HTML sanitizer's output of ${String(A.html.length)} characters exceeds its limit of ${String(l)}`) }, lasting: !0 } : { outcome: { status: "sanitized", html: A.html }, lasting: !0 } : { outcome: { status: "rejected", reason: "failed", cause: new Error("[markdown-explorer] the HTML sanitizer worker answered something that is not an outcome") }, lasting: !0 };
396
+ }, _ = (R, k, j, S) => {
397
+ let A = () => {
398
398
  };
399
- const C = new Promise((i) => {
400
- N = i;
401
- }), z = { hash: x, key: P, outcome: C, answer: N, controller: new AbortController(), waiters: 0 };
402
- T.set(P, z);
403
- const u = d.get(x);
404
- return u === void 0 ? d.set(x, /* @__PURE__ */ new Set([z])) : u.add(z), _(O, b, z.controller.signal).catch((i) => ({ outcome: { status: "rejected", reason: "failed", cause: i instanceof Error ? i : new Error(String(i)) }, lasting: !0 })).then(({ outcome: i, lasting: E }) => {
405
- if (p(z), z.answer(i), !E) return;
406
- const S = g.get(x), k = S ?? (i.status === "rejected" ? { ...i, cause: null } : i);
407
- S === void 0 && g.set(x, k);
408
- for (const A of d.get(x) ?? [])
409
- p(A), A.answer(k), A.controller.abort();
410
- }), z;
411
- }, I = (O, x) => new Promise((P) => {
412
- O.waiters += 1;
413
- const b = () => {
414
- O.waiters -= 1, P(xe), !(O.waiters > 0) && (p(O), O.controller.abort());
399
+ const D = new Promise((h) => {
400
+ A = h;
401
+ }), C = { hash: k, key: j, outcome: D, answer: A, controller: new AbortController(), waiters: 0 };
402
+ x.set(j, C);
403
+ const u = f.get(k);
404
+ return u === void 0 ? f.set(k, /* @__PURE__ */ new Set([C])) : u.add(C), O(R, S, C.controller.signal).catch((h) => ({ outcome: { status: "rejected", reason: "failed", cause: h instanceof Error ? h : new Error(String(h)) }, lasting: !0 })).then(({ outcome: h, lasting: g }) => {
405
+ if (w(C), C.answer(h), !g) return;
406
+ const T = y.get(k), b = T ?? (h.status === "rejected" ? { ...h, cause: null } : h);
407
+ T === void 0 && y.set(k, b);
408
+ for (const N of f.get(k) ?? [])
409
+ w(N), N.answer(b), N.controller.abort();
410
+ }), C;
411
+ }, v = (R, k) => new Promise((j) => {
412
+ R.waiters += 1;
413
+ const S = () => {
414
+ R.waiters -= 1, j(ke), !(R.waiters > 0) && (w(R), R.controller.abort());
415
415
  };
416
- x.addEventListener("abort", b, { once: !0 }), O.outcome.then((N) => {
417
- x.removeEventListener("abort", b), P(N);
416
+ k.addEventListener("abort", S, { once: !0 }), R.outcome.then((A) => {
417
+ k.removeEventListener("abort", S), j(A);
418
418
  });
419
419
  });
420
- return (O, { scope: x, signal: P }) => {
421
- if (O.length > r.maxHtmlBytes || Buffer.byteLength(O, "utf8") > r.maxHtmlBytes) return Promise.resolve(Je);
422
- const b = Ht("sha256").update(O, "utf8").digest("base64"), N = g.get(b);
423
- if (N !== void 0) return Promise.resolve(N);
424
- if (P.aborted) return Promise.resolve(xe);
425
- const C = `${b}\0${x}`, z = T.get(C);
426
- return I(z === void 0 ? R(O, b, C, x) : z, P);
420
+ return (R, { scope: k, signal: j }) => {
421
+ if (R.length > r.maxHtmlBytes || Buffer.byteLength(R, "utf8") > r.maxHtmlBytes) return Promise.resolve(Ye);
422
+ const S = Bt("sha256").update(R, "utf8").digest("base64"), A = y.get(S);
423
+ if (A !== void 0) return Promise.resolve(A);
424
+ if (j.aborted) return Promise.resolve(ke);
425
+ const D = `${S}\0${k}`, C = x.get(D);
426
+ return v(C === void 0 ? _(R, S, D, k) : C, j);
427
427
  };
428
- }, ye = (e) => ({ result: e, json: JSON.stringify(e) }), Oe = Object.freeze(ye(Object.freeze({ status: "error", failure: Object.freeze({ reason: "failed" }) }))), fn = (e) => e.status === "ok" && e.entries.length > 0, mn = ({ ttlMs: e, maxEntries: t, maxBytes: r, now: n }) => {
429
- const a = pt(t, { max: r, of: (d, p) => 2 * p.tree.json.length }), o = /* @__PURE__ */ new Map(), c = /* @__PURE__ */ new Map(), f = (d, p) => {
430
- const _ = new AbortController(), R = { waiters: 0, superseded: !1, started: !1, loadTree: p }, I = c.get(d), O = (C, z) => {
431
- const u = ye(C);
432
- return !(R.superseded || _.signal.aborted) && fn(C) && a.set(d, { tree: u, loadedAt: z }), u;
433
- }, P = (async () => {
434
- if (I !== void 0 && await I, _.signal.aborted) return Oe;
435
- const C = n();
436
- return R.started = !0, O(await R.loadTree(_.signal, C), C);
428
+ }, be = (e) => ({ result: e, json: JSON.stringify(e) }), Oe = Object.freeze(be(Object.freeze({ status: "error", failure: Object.freeze({ reason: "failed" }) }))), mn = (e) => e.status === "ok" && e.entries.length > 0, pn = ({ ttlMs: e, maxEntries: t, maxBytes: r, now: n }) => {
429
+ const a = ht(t, { max: r, of: (f, w) => 2 * w.tree.json.length }), o = /* @__PURE__ */ new Map(), i = /* @__PURE__ */ new Map(), l = (f, w) => {
430
+ const O = new AbortController(), _ = { waiters: 0, superseded: !1, started: !1, loadTree: w }, v = i.get(f), R = (D, C) => {
431
+ const u = be(D);
432
+ return !(_.superseded || O.signal.aborted) && mn(D) && a.set(f, { tree: u, loadedAt: C }), u;
433
+ }, j = (async () => {
434
+ if (v !== void 0 && await v, O.signal.aborted) return Oe;
435
+ const D = n();
436
+ return _.started = !0, R(await _.loadTree(O.signal, D), D);
437
437
  })().finally(() => {
438
- o.get(d) === b && o.delete(d);
439
- }), b = { promise: P, controller: _, state: R };
440
- o.set(d, b);
441
- const N = P.then(
438
+ o.get(f) === S && o.delete(f);
439
+ }), S = { promise: j, controller: O, state: _ };
440
+ o.set(f, S);
441
+ const A = j.then(
442
442
  () => {
443
443
  },
444
444
  () => {
445
445
  }
446
446
  );
447
- return c.set(d, N), N.then(() => {
448
- c.get(d) === N && c.delete(d);
449
- }), b;
450
- }, g = (d, p, _) => {
451
- p.state.waiters += 1;
452
- const R = () => {
453
- p.state.waiters -= 1, !(p.state.waiters > 0) && (o.get(d) === p && o.delete(d), p.controller.abort());
447
+ return i.set(f, A), A.then(() => {
448
+ i.get(f) === A && i.delete(f);
449
+ }), S;
450
+ }, y = (f, w, O) => {
451
+ w.state.waiters += 1;
452
+ const _ = () => {
453
+ w.state.waiters -= 1, !(w.state.waiters > 0) && (o.get(f) === w && o.delete(f), w.controller.abort());
454
454
  };
455
- return _.addEventListener("abort", R, { once: !0 }), p.promise.finally(() => {
456
- _.removeEventListener("abort", R);
455
+ return O.addEventListener("abort", _, { once: !0 }), w.promise.finally(() => {
456
+ O.removeEventListener("abort", _);
457
457
  });
458
- }, T = (d) => {
459
- a.delete(d);
460
- const p = o.get(d);
461
- p?.state.started && (p.state.superseded = !0, o.delete(d));
458
+ }, x = (f) => {
459
+ a.delete(f);
460
+ const w = o.get(f);
461
+ w?.state.started && (w.state.superseded = !0, o.delete(f));
462
462
  };
463
463
  return {
464
- load: (d, p, _) => {
465
- if (p.aborted) return Promise.resolve(Oe);
466
- const R = a.get(d);
467
- if (R !== void 0) {
468
- if (n() - R.loadedAt < e) return Promise.resolve(R.tree);
469
- a.delete(d);
464
+ load: (f, w, O) => {
465
+ if (w.aborted) return Promise.resolve(Oe);
466
+ const _ = a.get(f);
467
+ if (_ !== void 0) {
468
+ if (n() - _.loadedAt < e) return Promise.resolve(_.tree);
469
+ a.delete(f);
470
470
  }
471
- const I = o.get(d);
472
- return g(d, I === void 0 ? f(d, _) : I, p);
471
+ const v = o.get(f);
472
+ return y(f, v === void 0 ? l(f, O) : v, w);
473
473
  },
474
- refresh: (d, p, _) => {
475
- if (p.aborted) return Promise.resolve(Oe);
476
- T(d);
477
- const R = o.get(d);
478
- return R === void 0 ? g(d, f(d, _), p) : (R.state.loadTree = _, g(d, R, p));
474
+ refresh: (f, w, O) => {
475
+ if (w.aborted) return Promise.resolve(Oe);
476
+ x(f);
477
+ const _ = o.get(f);
478
+ return _ === void 0 ? y(f, l(f, O), w) : (_.state.loadTree = O, y(f, _, w));
479
479
  },
480
- forget: T
480
+ forget: x
481
481
  };
482
- }, pn = (e) => ({
483
- load: (t, r, n) => n(r, e()).then(ye),
484
- refresh: (t, r, n) => n(r, e()).then(ye),
482
+ }, wn = (e) => ({
483
+ load: (t, r, n) => n(r, e()).then(be),
484
+ refresh: (t, r, n) => n(r, e()).then(be),
485
485
  forget: () => {
486
486
  }
487
- }), v = (e) => {
487
+ }), $ = (e) => {
488
488
  throw new TypeError(`[markdown-explorer] ${e}`);
489
- }, wn = (e) => {
489
+ }, hn = (e) => {
490
490
  if (e === null || typeof e != "object") return null;
491
491
  const { name: t, path: r } = e;
492
492
  return typeof t != "string" || typeof r != "string" ? null : t === "" ? { path: r, reason: "an empty name" } : te(r) ? null : { path: r, reason: "a path the browser cannot address (empty, too long, a lone surrogate, a control character or a backslash)" };
493
- }, hn = (e, t, r, n, a) => {
494
- const o = /* @__PURE__ */ new Set(), c = (g) => {
495
- if (!Array.isArray(g)) return v("a source returned entries that are not an array");
496
- const T = [];
497
- for (const d of g) {
498
- const p = f(d);
499
- p !== null && T.push(p);
493
+ }, gn = (e, t, r, n) => {
494
+ if (e === null) return null;
495
+ if (!Array.isArray(e)) throw new TypeError(`[markdown-explorer] a source's ancestors must be null or an array of folder paths; got ${typeof e}`);
496
+ const a = /* @__PURE__ */ new Set();
497
+ for (const o of e) {
498
+ if (typeof o != "string" || !te(o)) throw new TypeError("[markdown-explorer] a source's ancestors held a path the explorer does not accept");
499
+ if (r.deniesPath(o)) throw new TypeError("[markdown-explorer] a source's ancestors held a denied path");
500
+ if (!n(o)) throw new TypeError("[markdown-explorer] a source's ancestors held a path outside the source's boundary");
501
+ if (o === t) throw new TypeError("[markdown-explorer] a source's ancestors held the document itself");
502
+ if (a.has(o)) throw new TypeError("[markdown-explorer] a source's ancestors held a path twice");
503
+ a.add(o);
504
+ }
505
+ return Object.freeze([...a]);
506
+ }, yn = (e, t, r, n, a) => {
507
+ const o = /* @__PURE__ */ new Set(), i = (y) => {
508
+ if (!Array.isArray(y)) return $("a source returned entries that are not an array");
509
+ const x = [];
510
+ for (const f of y) {
511
+ const w = l(f);
512
+ w !== null && x.push(w);
500
513
  }
501
- return T;
502
- }, f = (g) => {
503
- const T = wn(g);
504
- if (T !== null)
505
- return n(T), null;
506
- const d = Pt(g);
507
- if (d !== null) return v(d);
508
- const p = g;
509
- if (o.has(p)) return v("a source returned entries that contain themselves");
510
- const { name: _, path: R, type: I, mimeType: O, children: x, lazy: P } = p;
511
- if (t.deniesName(_) || t.deniesPath(R)) return null;
512
- if (!a(R))
513
- return n({ path: R, reason: "a path outside the source's boundary" }), null;
514
- const b = O === void 0 ? { name: _, path: R } : { name: _, path: R, mimeType: O };
515
- if (I === "file") return { ...b, type: I };
516
- if (P === !0)
517
- return r ? { ...b, type: I, lazy: !0, children: [] } : v("a lazy directory came from a source without a children function");
518
- if (x === void 0) return { ...b, type: I };
519
- o.add(p);
520
- const N = c(x);
521
- return o.delete(p), { ...b, type: I, children: N };
514
+ return x;
515
+ }, l = (y) => {
516
+ const x = hn(y);
517
+ if (x !== null)
518
+ return n(x), null;
519
+ const f = $t(y);
520
+ if (f !== null) return $(f);
521
+ const w = y;
522
+ if (o.has(w)) return $("a source returned entries that contain themselves");
523
+ const { name: O, path: _, type: v, mimeType: R, children: k, lazy: j } = w;
524
+ if (t.deniesName(O) || t.deniesPath(_)) return null;
525
+ if (!a(_))
526
+ return n({ path: _, reason: "a path outside the source's boundary" }), null;
527
+ const S = R === void 0 ? { name: O, path: _ } : { name: O, path: _, mimeType: R };
528
+ if (v === "file") return { ...S, type: v };
529
+ if (j === !0)
530
+ return r ? { ...S, type: v, lazy: !0, children: [] } : $("a lazy directory came from a source without a children function");
531
+ if (k === void 0) return { ...S, type: v };
532
+ o.add(w);
533
+ const A = i(k);
534
+ return o.delete(w), { ...S, type: v, children: A };
522
535
  };
523
- return c(e);
524
- }, gn = /^[\x21\x23-\x7E]{1,256}$/u, gt = (e) => typeof e == "string" && gn.test(e), En = /* @__PURE__ */ new Set(["text", "image", "media", "file"]), yn = (e) => typeof e == "string" && En.has(e), bn = (e, t) => {
536
+ return i(e);
537
+ }, En = /^[\x21\x23-\x7E]{1,256}$/u, Et = (e) => typeof e == "string" && En.test(e), bn = /* @__PURE__ */ new Set(["text", "image", "media", "file"]), Sn = (e) => typeof e == "string" && bn.has(e), Tn = (e, t) => {
525
538
  if (e !== null && typeof e == "object") {
526
539
  const a = e, { kind: o } = a;
527
- if (yn(o)) {
528
- if (Object.hasOwn(a, "url")) return v(`a ${o} document carries its version, not a url`);
529
- if (typeof a.name != "string") return v("a document needs a name string");
530
- if (!gt(a.version)) return v(`a ${o} document needs a version of 1 to 256 visible ASCII characters other than '"'`);
531
- const c = t(a.version);
540
+ if (Sn(o)) {
541
+ if (Object.hasOwn(a, "url")) return $(`a ${o} document carries its version, not a url`);
542
+ if (typeof a.name != "string") return $("a document needs a name string");
543
+ if (!Et(a.version)) return $(`a ${o} document needs a version of 1 to 256 visible ASCII characters other than '"'`);
544
+ const i = t(a.version);
532
545
  switch (o) {
533
546
  case "image":
534
547
  case "file":
535
- return { kind: o, name: a.name, url: c };
548
+ return { kind: o, name: a.name, url: i };
536
549
  case "media": {
537
- const { mediaType: f } = a;
538
- return It(f) ? { kind: o, name: a.name, url: c, mediaType: f } : v(`unknown media type ${typeof f == "string" ? JSON.stringify(f.slice(0, 64)) : typeof f}`);
550
+ const { mediaType: l } = a;
551
+ return Mt(l) ? { kind: o, name: a.name, url: i, mediaType: l } : $(`unknown media type ${typeof l == "string" ? JSON.stringify(l.slice(0, 64)) : typeof l}`);
539
552
  }
540
553
  case "text":
541
- return typeof a.text != "string" || typeof a.truncated != "boolean" ? v("a text document needs text and truncated") : { kind: o, name: a.name, text: a.text, truncated: a.truncated, url: c };
554
+ return typeof a.text != "string" || typeof a.truncated != "boolean" ? $("a text document needs text and truncated") : { kind: o, name: a.name, text: a.text, truncated: a.truncated, url: i };
542
555
  }
543
556
  }
544
557
  }
545
- const r = Mt(e);
546
- if (r !== null) return v(r);
558
+ const r = vt(e);
559
+ if (r !== null) return $(r);
547
560
  const n = e;
548
561
  switch (n.kind) {
549
562
  case "failure": {
550
563
  const { reason: a, code: o } = n.failure;
551
- return { kind: "failure", failure: Re(a, o) };
564
+ return { kind: "failure", failure: _e(a, o) };
552
565
  }
553
566
  case "markdown":
554
- return n.headings.length > vt ? { kind: "failure", failure: Re("too-large") } : { kind: "unsanitized-markdown", name: n.name, html: n.htmlContent, headings: n.headings.map(({ text: a, depth: o, id: c }) => ({ text: a, depth: o, id: c })) };
567
+ return n.headings.length > Pt ? { kind: "failure", failure: _e("too-large") } : { kind: "unsanitized-markdown", name: n.name, html: n.htmlContent, headings: n.headings.map(({ text: a, depth: o, id: i }) => ({ text: a, depth: o, id: i })) };
555
568
  }
556
- }, Sn = (e) => {
557
- if (e === null || typeof e != "object") return v("an asset file must be an object");
569
+ }, xn = (e) => {
570
+ if (e === null || typeof e != "object") return $("an asset file must be an object");
558
571
  const { name: t, contentType: r, size: n, version: a, open: o } = e;
559
- return typeof t != "string" || t === "" ? v("an asset file needs a non-empty name") : typeof r != "string" ? v("an asset file needs a contentType string ('' when unknown)") : n !== null && !(typeof n == "number" && Number.isSafeInteger(n) && n >= 0) ? v("an asset file's size must be null or a non-negative safe integer") : gt(a) ? typeof o != "function" ? v("an asset file needs an open function") : Object.freeze({ name: t, contentType: r, size: n, version: a, open: o }) : v(`an asset file needs a version of 1 to 256 visible ASCII characters other than '"'`);
560
- }, Tn = (e) => Array.isArray(e) ? e.map((t) => {
561
- if (t === null || typeof t != "object") return v("a notice must be an object");
562
- const { id: r, tone: n, title: a, body: o, action: c } = t;
563
- if (typeof r != "string" || r === "" || typeof a != "string") return v("a notice needs an id and a title");
564
- if (!Nt(n)) return v(`unknown notice tone ${typeof n == "string" ? JSON.stringify(n.slice(0, 64)) : typeof n}`);
565
- if (o !== void 0 && typeof o != "string") return v("a notice body must be a string");
566
- const g = { id: r, tone: n, title: a, ...o === void 0 ? {} : { body: o } };
567
- if (c === void 0) return g;
568
- if (c === null || typeof c != "object") return v("a notice action must be an object");
569
- const { label: T, href: d } = c;
570
- return typeof T != "string" || !At(d, $t) ? v("a notice action needs a label and an http(s), mailto or relative href") : { ...g, action: { label: T, href: d } };
571
- }) : v("notices must be an array"), xn = 4e3, me = Object.freeze({ ttlMs: 3e5, maxEntries: 64, maxBytes: 64 * 1024 * 1024 }), Ye = 32, Et = "private, no-store", On = Object.freeze({
572
+ return typeof t != "string" || t === "" ? $("an asset file needs a non-empty name") : typeof r != "string" ? $("an asset file needs a contentType string ('' when unknown)") : n !== null && !(typeof n == "number" && Number.isSafeInteger(n) && n >= 0) ? $("an asset file's size must be null or a non-negative safe integer") : Et(a) ? typeof o != "function" ? $("an asset file needs an open function") : Object.freeze({ name: t, contentType: r, size: n, version: a, open: o }) : $(`an asset file needs a version of 1 to 256 visible ASCII characters other than '"'`);
573
+ }, kn = (e) => Array.isArray(e) ? e.map((t) => {
574
+ if (t === null || typeof t != "object") return $("a notice must be an object");
575
+ const { id: r, tone: n, title: a, body: o, action: i } = t;
576
+ if (typeof r != "string" || r === "" || typeof a != "string") return $("a notice needs an id and a title");
577
+ if (!At(n)) return $(`unknown notice tone ${typeof n == "string" ? JSON.stringify(n.slice(0, 64)) : typeof n}`);
578
+ if (o !== void 0 && typeof o != "string") return $("a notice body must be a string");
579
+ const y = { id: r, tone: n, title: a, ...o === void 0 ? {} : { body: o } };
580
+ if (i === void 0) return y;
581
+ if (i === null || typeof i != "object") return $("a notice action must be an object");
582
+ const { label: x, href: f } = i;
583
+ return typeof x != "string" || !It(f, jt) ? $("a notice action needs a label and an http(s), mailto or relative href") : { ...y, action: { label: x, href: f } };
584
+ }) : $("notices must be an array"), On = 4e3, pe = Object.freeze({ ttlMs: 3e5, maxEntries: 64, maxBytes: 64 * 1024 * 1024 }), Ve = 32, bt = "private, no-store", Rn = Object.freeze({
572
585
  "Content-Type": "application/json; charset=utf-8",
573
- "Cache-Control": Et,
586
+ "Cache-Control": bt,
574
587
  "X-Content-Type-Options": "nosniff",
575
588
  "Content-Security-Policy": "default-src 'none'; frame-ancestors 'none'; sandbox",
576
589
  "Cross-Origin-Resource-Policy": "same-origin"
577
- }), kn = 22, Rn = 2147483647, ke = Object.freeze([]), Ke = Object.freeze(["contains", "confirm"]), Ve = Object.freeze({ readOnly: !1 }), _n = Object.freeze({ readOnly: !0 }), G = (e, t, r) => {
590
+ }), _n = 22, Nn = 2147483647, Re = Object.freeze([]), Ze = Object.freeze(["contains", "confirm"]), Qe = Object.freeze({ readOnly: !1 }), An = Object.freeze({ readOnly: !0 }), G = (e, t, r) => {
578
591
  if (!(r && t === void 0) && typeof t != "function")
579
592
  throw new TypeError(`[markdown-explorer] ${e} must be a function; got ${typeof t}`);
580
- }, ge = (e, t, r) => {
593
+ }, ye = (e, t, r) => {
581
594
  if (typeof t != "number") throw new TypeError(`[markdown-explorer] ${e} must be a number; got ${typeof t}`);
582
595
  if (!Number.isSafeInteger(t) || t <= 0 || t > r) throw new RangeError(`[markdown-explorer] ${e} must be an integer in 1..${String(r)}; got ${String(t)}`);
583
596
  return t;
584
- }, Nn = (e) => {
597
+ }, In = (e) => {
585
598
  if (e === null || typeof e != "object" || !Object.isFrozen(e)) throw new TypeError("[markdown-explorer] config must be the value returned by defineExplorerConfig");
586
- return Jt(e);
587
- }, Ze = (e) => {
599
+ return Wt(e);
600
+ }, qe = (e) => {
588
601
  try {
589
602
  return new Headers(e);
590
603
  } catch {
591
604
  throw new TypeError("[markdown-explorer] authenticate returned headers that are not a valid headers init (their values are not logged)");
592
605
  }
593
- }, Qe = (e) => e instanceof Response ? new TypeError(`[markdown-explorer] authenticate threw a Response (status ${String(e.status)}), which a data request does not follow`) : e, An = (e) => {
606
+ }, et = (e) => e instanceof Response ? new TypeError(`[markdown-explorer] authenticate threw a Response (status ${String(e.status)}), which a data request does not follow`) : e, Mn = (e) => {
594
607
  if (typeof e != "string") throw new TypeError(`[markdown-explorer] scopeSecret must be a string; got ${typeof e}`);
595
- if (e.length < Ye) throw new RangeError(`[markdown-explorer] scopeSecret must have at least ${String(Ye)} characters; got ${String(e.length)}`);
608
+ if (e.length < Ve) throw new RangeError(`[markdown-explorer] scopeSecret must have at least ${String(Ve)} characters; got ${String(e.length)}`);
596
609
  return e;
597
- }, In = (e, t) => {
598
- if (!Zt(t)) throw new TypeError(`[markdown-explorer] ${e}.boundary must be a plain object { contains, confirm? }`);
610
+ }, vn = (e, t) => {
611
+ if (!Qt(t)) throw new TypeError(`[markdown-explorer] ${e}.boundary must be a plain object { contains, confirm? }`);
599
612
  for (const r of Object.keys(t))
600
- if (!Ke.includes(r)) throw new RangeError(`[markdown-explorer] ${e}.boundary.${r} is not an option; expected ${Ke.join(", ")}`);
613
+ if (!Ze.includes(r)) throw new RangeError(`[markdown-explorer] ${e}.boundary.${r} is not an option; expected ${Ze.join(", ")}`);
601
614
  G(`${e}.boundary.contains`, t.contains, !1), G(`${e}.boundary.confirm`, t.confirm, !0);
602
- }, Mn = (e) => {
615
+ }, Pn = (e) => {
603
616
  if (!Array.isArray(e)) throw new TypeError("[markdown-explorer] sources must be an array");
604
617
  const t = e;
605
618
  if (t.length === 0) throw new RangeError("[markdown-explorer] sources must hold at least one source");
606
619
  const r = /* @__PURE__ */ new Set();
607
620
  for (const [n, a] of t.entries()) {
608
621
  if (a === null || typeof a != "object") throw new TypeError(`[markdown-explorer] sources[${String(n)}] must be an object`);
609
- const { id: o, label: c, boundary: f, tree: g, children: T, cacheScope: d } = a;
610
- if (!Wt(o))
622
+ const { id: o, label: i, boundary: l, tree: y, children: x, ancestors: f, cacheScope: w } = a;
623
+ if (!Yt(o))
611
624
  throw new RangeError(`[markdown-explorer] sources[${String(n)}].id must use lowercase letters, digits and "-" and start with a letter or digit; got ${typeof o == "string" ? JSON.stringify(o) : typeof o}`);
612
- const p = `source ${JSON.stringify(o)}`;
625
+ const O = `source ${JSON.stringify(o)}`;
613
626
  if (r.has(o)) throw new RangeError(`[markdown-explorer] source ids must be unique; ${JSON.stringify(o)} repeats at sources[${String(n)}]`);
614
- if (r.add(o), typeof c != "string" && typeof c != "function") throw new TypeError(`[markdown-explorer] ${p}.label must be a string or a function`);
615
- if (typeof c == "string" && c.trim() === "") throw new RangeError(`[markdown-explorer] ${p}.label must not be blank`);
616
- if (In(p, f), G(`${p}.tree`, g, !1), G(`${p}.children`, T, !0), d !== void 0 && d !== "principal" && d !== "shared") throw new RangeError(`[markdown-explorer] ${p}.cacheScope must be "principal" or "shared"; got ${JSON.stringify(d)}`);
627
+ if (r.add(o), typeof i != "string" && typeof i != "function") throw new TypeError(`[markdown-explorer] ${O}.label must be a string or a function`);
628
+ if (typeof i == "string" && i.trim() === "") throw new RangeError(`[markdown-explorer] ${O}.label must not be blank`);
629
+ if (vn(O, l), G(`${O}.tree`, y, !1), G(`${O}.children`, x, !0), G(`${O}.ancestors`, f, !0), w !== void 0 && w !== "principal" && w !== "shared") throw new RangeError(`[markdown-explorer] ${O}.cacheScope must be "principal" or "shared"; got ${JSON.stringify(w)}`);
617
630
  }
618
631
  return t;
619
- }, vn = (e) => {
632
+ }, $n = (e) => {
620
633
  if (e === !1) return !1;
621
- if (e === void 0) return me;
634
+ if (e === void 0) return pe;
622
635
  if (e === null || typeof e != "object") throw new TypeError("[markdown-explorer] treeCache must be { ttlMs, maxEntries, maxBytes } or false");
623
636
  const { ttlMs: t, maxEntries: r, maxBytes: n } = e;
624
637
  return {
625
- ttlMs: t === void 0 ? me.ttlMs : ge("treeCache.ttlMs", t, Number.MAX_SAFE_INTEGER),
626
- maxEntries: r === void 0 ? me.maxEntries : ge("treeCache.maxEntries", r, Number.MAX_SAFE_INTEGER),
627
- maxBytes: n === void 0 ? me.maxBytes : ge("treeCache.maxBytes", n, Number.MAX_SAFE_INTEGER)
638
+ ttlMs: t === void 0 ? pe.ttlMs : ye("treeCache.ttlMs", t, Number.MAX_SAFE_INTEGER),
639
+ maxEntries: r === void 0 ? pe.maxEntries : ye("treeCache.maxEntries", r, Number.MAX_SAFE_INTEGER),
640
+ maxBytes: n === void 0 ? pe.maxBytes : ye("treeCache.maxBytes", n, Number.MAX_SAFE_INTEGER)
628
641
  };
629
- }, qe = (e) => {
642
+ }, tt = (e) => {
630
643
  if (e === null || typeof e != "object") throw new TypeError("[markdown-explorer] authenticate must resolve to { status, ... }");
631
644
  const { status: t } = e;
632
645
  if (t !== "signed-in" && t !== "signed-out" && t !== "forbidden") throw new TypeError(`[markdown-explorer] authenticate resolved to an unknown status ${JSON.stringify(t)}`);
633
646
  return e;
634
- }, et = (e, t) => {
647
+ }, rt = (e, t) => {
635
648
  if (!(t instanceof Response)) throw new TypeError(`[markdown-explorer] ${e} must return a Response`);
636
649
  return t;
637
- }, tt = (e, t) => {
650
+ }, nt = (e, t) => {
638
651
  if (typeof t != "string" || t === "") throw new TypeError("[markdown-explorer] principalKey must return a non-empty string");
639
- return Bt("sha256", e).update(t, "utf8").digest("base64url").slice(0, kn);
640
- }, Pn = (e) => e.view === "multi" ? e.docs : e.doc === null ? [] : [e.doc], pe = (e, t) => {
652
+ return Ft("sha256", e).update(t, "utf8").digest("base64url").slice(0, _n);
653
+ }, jn = (e) => e.view === "multi" ? e.docs : e.doc === null ? [] : [e.doc], we = (e, t) => {
641
654
  const r = e.getAll(t), [n] = r;
642
655
  return r.length === 1 && n !== void 0 && n !== "" ? n : null;
643
656
  }, ae = (e, t, r, n = {}) => {
644
657
  const a = new Headers(r);
645
- for (const [o, c] of Object.entries({ ...On, ...n })) a.set(o, c);
658
+ for (const [o, i] of Object.entries({ ...Rn, ...n })) a.set(o, i);
646
659
  return new Response(t, { status: e, headers: a });
647
- }, B = (e, t, r) => ae(Lt[e.reason], JSON.stringify({ failure: e }), t, r), rt = (e, t) => {
660
+ }, F = (e, t, r) => ae(zt[e.reason], JSON.stringify({ failure: e }), t, r), ot = (e, t) => {
648
661
  const r = t === "refresh" ? ["POST"] : ["GET", "HEAD"];
649
662
  return r.includes(e.method.toUpperCase()) ? null : ae(405, JSON.stringify({ failure: { reason: "invalid" } }), void 0, { Allow: r.join(", ") });
650
- }, nt = (e) => {
651
- if (e.headers.get(ut) !== zt) return !1;
663
+ }, st = (e) => {
664
+ if (e.headers.get(dt) !== Dt) return !1;
652
665
  const t = e.headers.get("Sec-Fetch-Site");
653
666
  return t === null || t === "same-origin";
654
- }, $n = ({ parentHeaders: e, loaderHeaders: t, errorHeaders: r }) => {
667
+ }, Ln = ({ parentHeaders: e, loaderHeaders: t, errorHeaders: r }) => {
655
668
  const n = new Headers(), a = r === void 0 ? [e, t] : [e, t, r];
656
669
  for (const o of a)
657
- for (const [c, f] of o)
658
- c !== "set-cookie" && n.set(c, f);
670
+ for (const [i, l] of o)
671
+ i !== "set-cookie" && n.set(i, l);
659
672
  return n;
660
- }, ao = (e) => {
673
+ }, co = (e) => {
661
674
  if (e === null || typeof e != "object") throw new TypeError("[markdown-explorer] the server configuration must be an object");
662
- const t = Nn(e.config), r = An(e.scopeSecret);
675
+ const t = In(e.config), r = Mn(e.scopeSecret);
663
676
  G("authenticate", e.authenticate, !1), G("principalKey", e.principalKey, !1), G("document", e.document, !1), G("asset", e.asset, !1), G("signedOutPage", e.signedOutPage, !1), G("forbiddenPage", e.forbiddenPage, !0), G("notices", e.notices, !0), G("onTreeRefreshed", e.onTreeRefreshed, !0);
664
- const n = Mn(e.sources), a = Xt(
677
+ const n = Pn(e.sources), a = Gt(
665
678
  t,
666
679
  n.map((s) => s.id)
667
680
  ), o = e.logger;
668
681
  if (o !== void 0 && (o === null || typeof o != "object" || typeof o.error != "function"))
669
682
  throw new TypeError("[markdown-explorer] logger must be an object with an error function");
670
- const c = e.logger === void 0 ? Ar : e.logger, f = ct(e.deny), g = e.deferredTimeoutMs === void 0 ? xn : ge("deferredTimeoutMs", e.deferredTimeoutMs, Rn), T = vn(e.treeCache), d = () => Date.now(), p = T === !1 ? pn(d) : mn({ ...T, now: d }), _ = sn(e.sanitizer, t.multiView.maxPanels), R = dn({ iframeHosts: t.iframeHosts, dataPath: t.dataPath, options: _, pool: cn(an(), _) }), I = new Map(n.map((s) => [s.id, s])), O = Gt(t), { authenticate: x, principalKey: P, signedOutPage: b, forbiddenPage: N, onTreeRefreshed: C } = e, z = (s, m) => {
683
+ const i = e.logger === void 0 ? Ir : e.logger, l = lt(e.deny), y = e.deferredTimeoutMs === void 0 ? On : ye("deferredTimeoutMs", e.deferredTimeoutMs, Nn), x = $n(e.treeCache), f = () => Date.now(), w = x === !1 ? wn(f) : pn({ ...x, now: f }), O = an(e.sanitizer, t.multiView.maxPanels), _ = fn({ iframeHosts: t.iframeHosts, dataPath: t.dataPath, options: O, pool: un(cn(), O) }), v = new Map(n.map((s) => [s.id, s])), R = Jt(t), { authenticate: k, principalKey: j, signedOutPage: S, forbiddenPage: A, onTreeRefreshed: D } = e, C = (s, m) => {
671
684
  if (typeof s.label == "string") return s.label;
672
- const l = s.label(m);
673
- if (typeof l != "string" || l.trim() === "") throw new TypeError(`[markdown-explorer] the label of source ${JSON.stringify(s.id)} must be a non-blank string`);
674
- return l;
675
- }, u = (s, m) => s.cacheScope === "shared" ? s.id : `${s.id}\0${m}`, i = (s, m) => {
676
- const l = (h) => q(c, { operation: "boundary", sourceId: s.id, path: m, error: h });
677
- let w;
685
+ const c = s.label(m);
686
+ if (typeof c != "string" || c.trim() === "") throw new TypeError(`[markdown-explorer] the label of source ${JSON.stringify(s.id)} must be a non-blank string`);
687
+ return c;
688
+ }, u = (s, m) => s.cacheScope === "shared" ? s.id : `${s.id}\0${m}`, h = (s, m) => {
689
+ const c = (p) => ee(i, { operation: "boundary", sourceId: s.id, path: m, error: p });
690
+ let d;
678
691
  try {
679
- w = s.boundary.contains(m);
680
- } catch (h) {
681
- return l(h), !1;
692
+ d = s.boundary.contains(m);
693
+ } catch (p) {
694
+ return c(p), !1;
682
695
  }
683
- return typeof w == "boolean" ? w : (Fe(w, l), l(new TypeError(`[markdown-explorer] boundary.contains of source ${JSON.stringify(s.id)} must return a boolean; got ${typeof w}`)), !1);
684
- }, E = async (s, m, l) => {
685
- const { confirm: w } = s.boundary;
686
- if (w === void 0) return { status: "inside", readPath: l };
687
- let h;
696
+ return typeof d == "boolean" ? d : (Xe(d, c), c(new TypeError(`[markdown-explorer] boundary.contains of source ${JSON.stringify(s.id)} must return a boolean; got ${typeof d}`)), !1);
697
+ }, g = async (s, m, c) => {
698
+ const { confirm: d } = s.boundary;
699
+ if (d === void 0) return { status: "inside", readPath: c };
700
+ let p;
688
701
  try {
689
- h = await w(m, l);
690
- } catch (V) {
691
- return { status: "error", failure: Q(V, { operation: "boundary", sourceId: s.id, path: l }, m.signal, c) };
702
+ p = await d(m, c);
703
+ } catch (K) {
704
+ return { status: "error", failure: Q(K, { operation: "boundary", sourceId: s.id, path: c }, m.signal, i) };
692
705
  }
693
- const y = (V) => (q(c, { operation: "boundary", sourceId: s.id, path: l, error: new TypeError(`[markdown-explorer] boundary.confirm of source ${JSON.stringify(s.id)} ${V}`) }), { status: "outside" });
694
- if (h === null || typeof h != "object") return y(`must resolve to { inside, readPath? }; got ${h === null ? "null" : typeof h}`);
695
- const { inside: j, readPath: L } = h;
696
- return j === !1 ? { status: "outside" } : j !== !0 || typeof L != "string" ? y("must resolve to { inside: false } or { inside: true, readPath: string }") : !te(L) || f.deniesPath(L) ? (q(c, { operation: "boundary", sourceId: s.id, path: l, error: new RangeError(`[markdown-explorer] boundary.confirm of source ${JSON.stringify(s.id)} answered a readPath the explorer does not serve (unacceptable or denied)`) }), { status: "error", failure: { reason: "failed" } }) : { status: "inside", readPath: L };
697
- }, S = async (s, m) => {
698
- const l = n.filter((h) => i(h, m));
699
- if (l.length === 0) return { status: "error", failure: { reason: "forbidden" } };
700
- if (l.some((h) => h.boundary.confirm === void 0)) return { status: "inside", readPath: m };
701
- let w = null;
702
- for (const h of l) {
703
- const y = await E(h, s, m);
704
- if (y.status === "inside") return y;
705
- y.status === "error" && w === null && (w = y.failure);
706
+ const E = (K) => (ee(i, { operation: "boundary", sourceId: s.id, path: c, error: new TypeError(`[markdown-explorer] boundary.confirm of source ${JSON.stringify(s.id)} ${K}`) }), { status: "outside" });
707
+ if (p === null || typeof p != "object") return E(`must resolve to { inside, readPath? }; got ${p === null ? "null" : typeof p}`);
708
+ const { inside: I, readPath: z } = p;
709
+ return I === !1 ? { status: "outside" } : I !== !0 || typeof z != "string" ? E("must resolve to { inside: false } or { inside: true, readPath: string }") : !te(z) || l.deniesPath(z) ? (ee(i, { operation: "boundary", sourceId: s.id, path: c, error: new RangeError(`[markdown-explorer] boundary.confirm of source ${JSON.stringify(s.id)} answered a readPath the explorer does not serve (unacceptable or denied)`) }), { status: "error", failure: { reason: "failed" } }) : { status: "inside", readPath: z };
710
+ }, T = async (s, m) => {
711
+ const c = n.filter((p) => h(p, m));
712
+ if (c.length === 0) return { status: "error", failure: { reason: "forbidden" } };
713
+ if (c.some((p) => p.boundary.confirm === void 0)) return { status: "inside", readPath: m };
714
+ let d = null;
715
+ for (const p of c) {
716
+ const E = await g(p, s, m);
717
+ if (E.status === "inside") return E;
718
+ E.status === "error" && d === null && (d = E.failure);
706
719
  }
707
- return { status: "error", failure: w === null ? { reason: "forbidden" } : w };
708
- }, k = (s, m, l) => {
709
- const w = ({ path: h, reason: y }) => vr(c, { operation: l.operation, sourceId: l.sourceId, path: h, error: new TypeError(`[markdown-explorer] an entry with ${y} was left out`) });
720
+ return { status: "error", failure: d === null ? { reason: "forbidden" } : d };
721
+ }, b = (s, m, c) => {
722
+ const d = ({ path: p, reason: E }) => Pr(i, { operation: c.operation, sourceId: c.sourceId, path: p, error: new TypeError(`[markdown-explorer] an entry with ${E} was left out`) });
710
723
  try {
711
- return { status: "ok", entries: hn(s, f, m.children !== void 0, w, (h) => i(m, h)) };
712
- } catch (h) {
713
- return q(c, { ...l, error: h }), { status: "error", failure: { reason: "failed" } };
724
+ return { status: "ok", entries: yn(s, l, m.children !== void 0, d, (p) => h(m, p)) };
725
+ } catch (p) {
726
+ return ee(i, { ...c, error: p }), { status: "error", failure: { reason: "failed" } };
714
727
  }
715
- }, A = async (s, m, l) => {
716
- let w;
728
+ }, N = async (s, m, c) => {
729
+ let d;
717
730
  try {
718
- w = await s.tree(m);
719
- } catch (y) {
720
- return { status: "error", failure: Q(y, { operation: "tree", sourceId: s.id }, m.signal, c) };
731
+ d = await s.tree(m);
732
+ } catch (E) {
733
+ return { status: "error", failure: Q(E, { operation: "tree", sourceId: s.id }, m.signal, i) };
721
734
  }
722
- const h = k(w, s, { operation: "tree", sourceId: s.id });
723
- return h.status === "ok" ? { status: "ok", entries: h.entries, loadedAt: l } : h;
724
- }, D = (s, m, l, w) => (h, y) => A(s, { principal: m, request: l, signal: h, refresh: w }, y), M = (s, m, l, w, h) => p.load(u(s, l), h, D(s, m, w, !1)), U = (s, m, l, w) => p.refresh(u(s, l), w.signal, D(s, m, w, !0)), X = (s, m) => {
725
- if (C === void 0) return;
726
- const l = (w) => q(c, { operation: "refresh", sourceId: s.id, error: w });
735
+ const p = b(d, s, { operation: "tree", sourceId: s.id });
736
+ return p.status === "ok" ? { status: "ok", entries: p.entries, loadedAt: c } : p;
737
+ }, P = (s, m, c, d) => (p, E) => N(s, { principal: m, request: c, signal: p, refresh: d }, E), B = (s, m, c, d, p) => w.load(u(s, c), p, P(s, m, d, !1)), M = (s, m, c, d) => w.refresh(u(s, c), d.signal, P(s, m, d, !0)), X = (s, m) => {
738
+ if (D === void 0) return;
739
+ const c = (d) => ee(i, { operation: "refresh", sourceId: s.id, error: d });
727
740
  try {
728
- Fe(C(m), l);
729
- } catch (w) {
730
- l(w);
741
+ Xe(D(m), c);
742
+ } catch (d) {
743
+ c(d);
731
744
  }
732
- }, F = async (s, m, l, w) => {
733
- if (f.deniesPath(w) || !i(s, w)) return { status: "error", failure: { reason: "forbidden" } };
734
- const h = await E(s, l, w);
735
- if (h.status === "outside") return { status: "error", failure: { reason: "forbidden" } };
736
- if (h.status === "error") return { status: "error", failure: h.failure };
737
- let y;
745
+ }, J = async (s, m, c, d) => {
746
+ if (l.deniesPath(d) || !h(s, d)) return { status: "error", failure: { reason: "forbidden" } };
747
+ const p = await g(s, c, d);
748
+ if (p.status === "outside") return { status: "error", failure: { reason: "forbidden" } };
749
+ if (p.status === "error") return { status: "error", failure: p.failure };
750
+ let E;
738
751
  try {
739
- y = await m(l, w, h.readPath);
740
- } catch (j) {
741
- return { status: "error", failure: Q(j, { operation: "children", sourceId: s.id, path: w }, l.signal, c) };
752
+ E = await m(c, d, p.readPath);
753
+ } catch (I) {
754
+ return { status: "error", failure: Q(I, { operation: "children", sourceId: s.id, path: d }, c.signal, i) };
742
755
  }
743
- return k(y, s, { operation: "children", sourceId: s.id, path: w });
744
- }, Z = async (s, m, l) => {
745
- if (f.deniesPath(l)) return ee("forbidden");
746
- const w = await S(s, l);
747
- if (w.status === "error") return { kind: "failure", failure: w.failure };
748
- let h;
756
+ return b(E, s, { operation: "children", sourceId: s.id, path: d });
757
+ }, U = async (s, m, c, d) => {
758
+ if (l.deniesPath(d)) return { status: "error", failure: { reason: "forbidden" } };
759
+ if (!h(s, d)) return { status: "ok", ancestors: null };
760
+ const p = await g(s, c, d);
761
+ if (p.status === "outside") return { status: "ok", ancestors: null };
762
+ if (p.status === "error") return { status: "error", failure: p.failure };
763
+ let E;
749
764
  try {
750
- h = await e.document(s, l, w.readPath);
751
- } catch (L) {
752
- return { kind: "failure", failure: Q(L, { operation: "document", path: l }, s.signal, c) };
765
+ E = await m(c, d, p.readPath, { maxDepth: t.revealDocument.maxDepth });
766
+ } catch (I) {
767
+ return { status: "error", failure: Q(I, { operation: "ancestors", sourceId: s.id, path: d }, c.signal, i) };
753
768
  }
754
- let y;
769
+ if (Array.isArray(E) && E.length > t.revealDocument.maxDepth) return { status: "ok", ancestors: null };
755
770
  try {
756
- y = bn(h, (L) => Dt(t.dataPath, l, L));
757
- } catch (L) {
758
- return q(c, { operation: "document", path: l, error: L }), ee("failed");
771
+ return { status: "ok", ancestors: gn(E, d, l, (I) => h(s, I)) };
772
+ } catch (I) {
773
+ return ee(i, { operation: "ancestors", sourceId: s.id, path: d, error: I }), { status: "error", failure: { reason: "failed" } };
759
774
  }
760
- if (y.kind !== "unsanitized-markdown") return y;
761
- const j = await R(y.html, { scope: m, signal: s.signal });
762
- return j.status === "sanitized" ? { kind: "markdown", name: y.name, htmlContent: j.html, headings: y.headings } : (j.cause !== null && q(c, { operation: "document", path: l, error: j.cause }), ee(j.reason));
763
- }, $ = async (s) => {
764
- if (e.notices === void 0) return ke;
775
+ }, q = async (s, m, c) => {
776
+ if (l.deniesPath(c)) return ne("forbidden");
777
+ const d = await T(s, c);
778
+ if (d.status === "error") return { kind: "failure", failure: d.failure };
779
+ let p;
765
780
  try {
766
- return Tn(await e.notices(s));
781
+ p = await e.document(s, c, d.readPath);
782
+ } catch (z) {
783
+ return { kind: "failure", failure: Q(z, { operation: "document", path: c }, s.signal, i) };
784
+ }
785
+ let E;
786
+ try {
787
+ E = Tn(p, (z) => Ht(t.dataPath, c, z));
788
+ } catch (z) {
789
+ return ee(i, { operation: "document", path: c, error: z }), ne("failed");
790
+ }
791
+ if (E.kind !== "unsanitized-markdown") return E;
792
+ const I = await _(E.html, { scope: m, signal: s.signal });
793
+ return I.status === "sanitized" ? { kind: "markdown", name: E.name, htmlContent: I.html, headings: E.headings } : (I.cause !== null && ee(i, { operation: "document", path: c, error: I.cause }), ne(I.reason));
794
+ }, L = async (s) => {
795
+ if (e.notices === void 0) return Re;
796
+ try {
797
+ return kn(await e.notices(s));
767
798
  } catch (m) {
768
- return Q(m, { operation: "notices" }, s.signal, c), ke;
799
+ return Q(m, { operation: "notices" }, s.signal, i), Re;
769
800
  }
770
- }, J = async (s, m, l) => {
771
- const w = pe(m, de.path);
772
- if (w === null || !te(w)) return B({ reason: "invalid" }, l);
773
- if (f.deniesPath(w))
774
- return Pr(c, { operation: "asset", path: w }), B({ reason: "forbidden" }, l);
775
- const h = await S(s, w);
776
- if (h.status === "error") return B(h.failure, l);
801
+ }, W = async (s, m, c) => {
802
+ const d = we(m, fe.path);
803
+ if (d === null || !te(d)) return F({ reason: "invalid" }, c);
804
+ if (l.deniesPath(d))
805
+ return $r(i, { operation: "asset", path: d }), F({ reason: "forbidden" }, c);
806
+ const p = await T(s, d);
807
+ if (p.status === "error") return F(p.failure, c);
777
808
  try {
778
- const y = Sn(await e.asset(s, w, h.readPath));
779
- return await Nr(s.request, y, l);
780
- } catch (y) {
781
- return B(Q(y, { operation: "asset", path: w }, s.signal, c), l);
809
+ const E = xn(await e.asset(s, d, p.readPath));
810
+ return await Ar(s.request, E, c);
811
+ } catch (E) {
812
+ return F(Q(E, { operation: "asset", path: d }, s.signal, i), c);
782
813
  }
783
- }, K = async ({ request: s, url: m, params: l }) => {
784
- const w = qe(await x(s, Ve)), h = Ze(w.headers);
785
- if (h.set("Cache-Control", Et), w.status === "signed-out") throw et("signedOutPage", b(s, h));
786
- if (w.status === "forbidden") throw N === void 0 ? Pe(null, { status: 403, headers: h }) : et("forbiddenPage", N(s, h));
787
- const y = Yt(a, l["*"], m.searchParams);
788
- if (y.kind === "redirect") throw Ut(y.href, { headers: h });
789
- const { location: j } = y, { principal: L } = w, V = tt(r, P(L)), ce = I.get(j.source);
790
- if (ce === void 0) throw new RangeError(`[markdown-explorer] no source for ${JSON.stringify(j.source)}`);
791
- const ue = { signal: s.signal, timeoutMs: g, late: null, handOverMs: g }, oe = {
792
- scope: V,
793
- sources: n.map((H) => ({ id: H.id, label: z(H, L) })),
794
- settings: Kt(Vt(s.headers.get("Cookie"), t.settingsCookie), O),
795
- tree: j.view === "single" ? null : {
796
- sourceId: j.source,
797
- result: Te(ue, (H) => M(ce, L, V, s, H).then((Y) => Y.result))
814
+ }, Z = async ({ request: s, url: m, params: c }) => {
815
+ const d = tt(await k(s, Qe)), p = qe(d.headers);
816
+ if (p.set("Cache-Control", bt), d.status === "signed-out") throw rt("signedOutPage", S(s, p));
817
+ if (d.status === "forbidden") throw A === void 0 ? je(null, { status: 403, headers: p }) : rt("forbiddenPage", A(s, p));
818
+ const E = Kt(a, c["*"], m.searchParams);
819
+ if (E.kind === "redirect") throw Xt(E.href, { headers: p });
820
+ const { location: I } = E, { principal: z } = d, K = nt(r, j(z)), ue = v.get(I.source);
821
+ if (ue === void 0) throw new RangeError(`[markdown-explorer] no source for ${JSON.stringify(I.source)}`);
822
+ const le = { signal: s.signal, timeoutMs: y, late: null, handOverMs: y }, re = {
823
+ scope: K,
824
+ sources: n.map((H) => ({ id: H.id, label: C(H, z) })),
825
+ settings: Vt(Zt(s.headers.get("Cookie"), t.settingsCookie), R),
826
+ tree: I.view === "single" ? null : {
827
+ sourceId: I.source,
828
+ result: xe(le, (H) => B(ue, z, K, s, H).then((V) => V.result))
798
829
  },
799
- documents: Pn(j).map((H) => ({ path: H, document: Te(ue, (Y) => Z({ principal: L, request: s, signal: Y, refresh: !1 }, V, H)) })),
800
- notices: Te({ signal: s.signal, timeoutMs: g, late: ke, handOverMs: 0 }, (H) => $({ principal: L, request: s, signal: H, refresh: !1 }))
830
+ documents: jn(I).map((H) => ({ path: H, document: xe(le, (V) => q({ principal: z, request: s, signal: V, refresh: !1 }, K, H)) })),
831
+ notices: xe({ signal: s.signal, timeoutMs: y, late: Re, handOverMs: 0 }, (H) => L({ principal: z, request: s, signal: H, refresh: !1 }))
801
832
  };
802
- return Pe(oe, { headers: h });
803
- }, W = async (s, m) => {
804
- const l = qe(await x(s, m));
805
- return { authentication: l, headers: Ze(l.headers) };
806
- }, le = async (s, m, l) => {
807
- let w;
833
+ return je(re, { headers: p });
834
+ }, Y = async (s, m) => {
835
+ const c = tt(await k(s, m));
836
+ return { authentication: c, headers: qe(c.headers) };
837
+ }, de = async (s, m, c) => {
838
+ let d;
808
839
  try {
809
- w = await W(m, Ve);
810
- } catch (Y) {
811
- return B(Q(Qe(Y), { operation: "authenticate" }, m.signal, c));
840
+ d = await Y(m, Qe);
841
+ } catch (V) {
842
+ return F(Q(et(V), { operation: "authenticate" }, m.signal, i));
812
843
  }
813
- const { authentication: h, headers: y } = w;
814
- if (h.status === "signed-out") return B({ reason: "unauthorized" }, y);
815
- if (h.status === "forbidden") return B({ reason: "forbidden" }, y);
816
- const { principal: j } = h;
817
- if (s === "asset") return J({ principal: j, request: m, signal: m.signal, refresh: !1 }, l, y);
818
- const L = tt(r, P(j));
819
- y.set(Ct, L);
820
- const V = { principal: j, request: m, signal: m.signal, refresh: !1 }, ce = () => B({ reason: "invalid" }, y);
844
+ const { authentication: p, headers: E } = d;
845
+ if (p.status === "signed-out") return F({ reason: "unauthorized" }, E);
846
+ if (p.status === "forbidden") return F({ reason: "forbidden" }, E);
847
+ const { principal: I } = p;
848
+ if (s === "asset") return W({ principal: I, request: m, signal: m.signal, refresh: !1 }, c, E);
849
+ const z = nt(r, j(I));
850
+ E.set(Ct, z);
851
+ const K = { principal: I, request: m, signal: m.signal, refresh: !1 }, ue = () => F({ reason: "invalid" }, E);
821
852
  if (s === "document") {
822
- const Y = pe(l, de.path);
823
- if (Y === null || !te(Y)) return ce();
824
- const ve = m.headers.has(ut);
825
- return ve && !nt(m) ? B({ reason: "forbidden" }, y) : ae(200, JSON.stringify(await Z({ ...V, refresh: ve }, L, Y)), y);
853
+ const V = we(c, fe.path);
854
+ if (V === null || !te(V)) return ue();
855
+ const $e = m.headers.has(dt);
856
+ return $e && !st(m) ? F({ reason: "forbidden" }, E) : ae(200, JSON.stringify(await q({ ...K, refresh: $e }, z, V)), E);
826
857
  }
827
- const ue = pe(l, de.source), oe = pe(l, de.path);
828
- if (ue === null || s === "children" && (oe === null || !te(oe))) return ce();
829
- const H = I.get(ue);
830
- if (H === void 0) return B({ reason: "not-found" }, y);
831
- if (s === "tree") return ae(200, (await M(H, j, L, m, m.signal)).json, y);
858
+ const le = we(c, fe.source), re = we(c, fe.path);
859
+ if (le === null || (s === "children" || s === "ancestors") && (re === null || !te(re))) return ue();
860
+ const H = v.get(le);
861
+ if (H === void 0) return F({ reason: "not-found" }, E);
862
+ if (s === "tree") return ae(200, (await B(H, I, z, m, m.signal)).json, E);
832
863
  if (s === "refresh") {
833
- const Y = await U(H, j, L, m);
834
- return m.signal.aborted || X(H, u(H, L)), ae(200, Y.json, y);
864
+ const V = await M(H, I, z, m);
865
+ return m.signal.aborted || X(H, u(H, z)), ae(200, V.json, E);
835
866
  }
836
- return H.children === void 0 || oe === null ? B({ reason: "not-found" }, y) : ae(200, JSON.stringify(await F(H, H.children, V, oe)), y);
837
- }, kt = async (s) => {
838
- const { authentication: m, headers: l } = await W(s, _n);
839
- if (!l.keys().next().done) throw new TypeError("[markdown-explorer] authenticate returned headers in read-only mode; a read-only authentication must only read the session (none was forwarded)");
867
+ return s === "ancestors" ? H.ancestors === void 0 || re === null ? F({ reason: "not-found" }, E) : ae(200, JSON.stringify(await U(H, H.ancestors, K, re)), E) : H.children === void 0 || re === null ? F({ reason: "not-found" }, E) : ae(200, JSON.stringify(await J(H, H.children, K, re)), E);
868
+ }, Rt = async (s) => {
869
+ const { authentication: m, headers: c } = await Y(s, An);
870
+ if (!c.keys().next().done) throw new TypeError("[markdown-explorer] authenticate returned headers in read-only mode; a read-only authentication must only read the session (none was forwarded)");
840
871
  return m.status === "signed-in";
841
- }, Ie = t.embeds.linkCardEndpoint === null ? null : Ft({ authorize: kt }), Rt = async (s, m) => {
872
+ }, ve = t.embeds.linkCardEndpoint === null ? null : Ut({ authorize: Rt }), _t = async (s, m) => {
842
873
  try {
843
874
  return await s(m);
844
- } catch (l) {
845
- return B(Q(Qe(l), { operation: "authenticate" }, m.signal, c));
875
+ } catch (c) {
876
+ return F(Q(et(c), { operation: "authenticate" }, m.signal, i));
846
877
  }
847
- }, Me = async (s, m, l) => {
848
- if (new URL(s.url).pathname.endsWith(".data")) return B({ reason: "not-found" });
849
- if (!jt(l)) return B({ reason: "not-found" });
850
- if (l === "link-card") {
851
- if (Ie === null) return B({ reason: "not-found" });
852
- const h = rt(s, l);
853
- return h !== null ? h : Rt(Ie, s);
878
+ }, Pe = async (s, m, c) => {
879
+ if (new URL(s.url).pathname.endsWith(".data")) return F({ reason: "not-found" });
880
+ if (!Lt(c)) return F({ reason: "not-found" });
881
+ if (c === "link-card") {
882
+ if (ve === null) return F({ reason: "not-found" });
883
+ const p = ot(s, c);
884
+ return p !== null ? p : _t(ve, s);
854
885
  }
855
- const w = rt(s, l);
856
- if (w !== null) return w;
857
- if (l === "refresh" && !nt(s)) return B({ reason: "forbidden" });
886
+ const d = ot(s, c);
887
+ if (d !== null) return d;
888
+ if (c === "refresh" && !st(s)) return F({ reason: "forbidden" });
858
889
  try {
859
- return await le(l, s, m.searchParams);
860
- } catch (h) {
861
- return B(Q(h, { operation: l }, s.signal, c));
890
+ return await de(c, s, m.searchParams);
891
+ } catch (p) {
892
+ return F(Q(p, { operation: c }, s.signal, i));
862
893
  }
863
894
  };
864
895
  return Object.freeze({
865
- loader: K,
866
- headers: $n,
867
- dataLoader: ({ request: s, url: m, params: l }) => Me(s, m, l["*"]),
868
- dataAction: ({ request: s, url: m, params: l }) => Me(s, m, l["*"]),
896
+ loader: Z,
897
+ headers: Ln,
898
+ dataLoader: ({ request: s, url: m, params: c }) => Pe(s, m, c["*"]),
899
+ dataAction: ({ request: s, url: m, params: c }) => Pe(s, m, c["*"]),
869
900
  forgetTree: (s) => {
870
901
  if (typeof s != "string") throw new TypeError(`[markdown-explorer] forgetTree needs the string key onTreeRefreshed received; got ${typeof s}`);
871
- p.forget(s);
902
+ w.forget(s);
872
903
  }
873
904
  });
874
- }, we = Object.freeze({ maxEntries: 2e4, maxDocumentBytes: 2 * 1024 * 1024, textPreviewBytes: 8 * 1024, walkConcurrency: 8 }), jn = /* @__PURE__ */ new Set(["md", "markdown", "mdx"]), yt = new Map([
905
+ }, he = Object.freeze({ maxEntries: 2e4, maxDocumentBytes: 2 * 1024 * 1024, textPreviewBytes: 8 * 1024, walkConcurrency: 8 }), zn = /* @__PURE__ */ new Set(["md", "markdown", "mdx"]), St = new Map([
875
906
  ...[
876
907
  ["png", "image/png"],
877
908
  ["jpg", "image/jpeg"],
@@ -906,7 +937,7 @@ const Ir = (e) => e instanceof Error && Object.hasOwn(e, mt) && it(e.reason), Mr
906
937
  ["wma", "audio/x-ms-wma"]
907
938
  ].map(([e, t]) => [e, { kind: "media", mediaType: "audio", contentType: t }]),
908
939
  ["pdf", { kind: "media", mediaType: "pdf", contentType: "application/pdf" }]
909
- ]), Ln = /* @__PURE__ */ new Set([
940
+ ]), Dn = /* @__PURE__ */ new Set([
910
941
  "txt",
911
942
  "text",
912
943
  "log",
@@ -1031,7 +1062,7 @@ const Ir = (e) => e instanceof Error && Object.hasOwn(e, mt) && it(e.reason), Mr
1031
1062
  "eslintrc",
1032
1063
  "babelrc",
1033
1064
  "mailmap"
1034
- ]), zn = /* @__PURE__ */ new Set([
1065
+ ]), Cn = /* @__PURE__ */ new Set([
1035
1066
  "readme",
1036
1067
  "license",
1037
1068
  "licence",
@@ -1052,17 +1083,17 @@ const Ir = (e) => e instanceof Error && Object.hasOwn(e, mt) && it(e.reason), Mr
1052
1083
  "jenkinsfile",
1053
1084
  "brewfile",
1054
1085
  "codeowners"
1055
- ]), bt = typeof ie.O_NOFOLLOW == "number" ? ie.O_NOFOLLOW : 0, St = typeof ie.O_NONBLOCK == "number" ? ie.O_NONBLOCK : 0, ot = (e) => `${e.size}-${e.mtimeNs}`, Cn = (e) => e !== "" && e !== "." && e !== ".." && !e.includes(":") && !e.endsWith(".") && !e.endsWith(" "), st = (e) => te(e) && e === e.normalize("NFC") && e.split("/").every(Cn), Tt = (e) => {
1086
+ ]), Tt = typeof ce.O_NOFOLLOW == "number" ? ce.O_NOFOLLOW : 0, xt = typeof ce.O_NONBLOCK == "number" ? ce.O_NONBLOCK : 0, at = (e) => `${e.size}-${e.mtimeNs}`, Hn = (e) => e !== "" && e !== "." && e !== ".." && !e.includes(":") && !e.endsWith(".") && !e.endsWith(" "), it = (e) => te(e) && e === e.normalize("NFC") && e.split("/").every(Hn), kt = (e) => {
1056
1087
  const t = e.toLowerCase(), r = t.lastIndexOf(".");
1057
1088
  return r < 0 ? "" : t.slice(r + 1);
1058
- }, Dn = (e) => {
1059
- const t = Tt(e);
1060
- if (jn.has(t)) return { kind: "markdown" };
1061
- const r = yt.get(t);
1089
+ }, Bn = (e) => {
1090
+ const t = kt(e);
1091
+ if (zn.has(t)) return { kind: "markdown" };
1092
+ const r = St.get(t);
1062
1093
  if (r !== void 0) return r.kind === "image" ? { kind: "image" } : { kind: "media", mediaType: r.mediaType };
1063
1094
  const n = e.toLowerCase();
1064
- return Ln.has(t) || !n.includes(".") && zn.has(n) ? { kind: "text" } : { kind: "file" };
1065
- }, xt = (e) => {
1095
+ return Dn.has(t) || !n.includes(".") && Cn.has(n) ? { kind: "text" } : { kind: "file" };
1096
+ }, Ae = (e) => {
1066
1097
  switch (typeof e == "object" && e !== null ? e.code : void 0) {
1067
1098
  case "ENOENT":
1068
1099
  case "ENOTDIR":
@@ -1079,33 +1110,33 @@ const Ir = (e) => e instanceof Error && Object.hasOwn(e, mt) && it(e.reason), Mr
1079
1110
  return null;
1080
1111
  }
1081
1112
  }, Ot = (e) => {
1082
- const t = xt(e);
1113
+ const t = Ae(e);
1083
1114
  return t === null ? e : new Ee(t);
1084
- }, Hn = (e) => {
1115
+ }, Fn = (e) => {
1085
1116
  const t = typeof e == "object" && e !== null ? e.code : void 0;
1086
1117
  return t === "EACCES" || t === "EPERM" || t === "ENOENT" || t === "ENOTDIR";
1087
- }, at = async (e, t) => {
1118
+ }, ct = async (e, t) => {
1088
1119
  const r = [];
1089
1120
  for await (const n of e.createReadStream({ start: 0, end: t - 1, autoClose: !1 }))
1090
1121
  r.push(n);
1091
1122
  return Buffer.concat(r);
1092
- }, Bn = (e, t) => e !== null ? { start: e.offset, end: e.offset + e.length - 1 } : t === 0n ? {} : { start: 0, end: Number(t) - 1 }, Fn = async (e, t, r, n) => {
1123
+ }, Un = (e, t) => e !== null ? { start: e.offset, end: e.offset + e.length - 1 } : t === 0n ? {} : { start: 0, end: Number(t) - 1 }, Xn = async (e, t, r, n) => {
1093
1124
  let a;
1094
1125
  try {
1095
- a = await lt(e, ie.O_RDONLY | bt | St);
1096
- const g = await a.stat({ bigint: !0 });
1097
- if (!g.isFile() || g.ino !== t.ino || g.dev !== t.dev || g.size !== t.size || g.mtimeNs !== t.mtimeNs) throw new Ee("not-found");
1098
- } catch (g) {
1099
- throw await a?.close(), Ot(g);
1126
+ a = await ft(e, ce.O_RDONLY | Tt | xt);
1127
+ const y = await a.stat({ bigint: !0 });
1128
+ if (!y.isFile() || y.ino !== t.ino || y.dev !== t.dev || y.size !== t.size || y.mtimeNs !== t.mtimeNs) throw new Ee("not-found");
1129
+ } catch (y) {
1130
+ throw await a?.close(), Ot(y);
1100
1131
  }
1101
- const o = a.createReadStream(Bn(r, t.size)), c = ur.toWeb(o), f = () => {
1132
+ const o = a.createReadStream(Un(r, t.size)), i = lr.toWeb(o), l = () => {
1102
1133
  o.destroy(n.reason);
1103
1134
  };
1104
- return n.aborted ? f() : n.addEventListener("abort", f, { once: !0 }), c;
1105
- }, Un = (e, t) => {
1106
- const r = Qt.compare(e, t);
1135
+ return n.aborted ? l() : n.addEventListener("abort", l, { once: !0 }), i;
1136
+ }, Gn = (e, t) => {
1137
+ const r = qt.compare(e, t);
1107
1138
  return r !== 0 ? r : e === t ? 0 : e < t ? -1 : 1;
1108
- }, Xn = (e) => {
1139
+ }, Jn = (e) => {
1109
1140
  let t = 0;
1110
1141
  const r = [];
1111
1142
  return async (n) => {
@@ -1117,165 +1148,179 @@ const Ir = (e) => e instanceof Error && Object.hasOwn(e, mt) && it(e.reason), Mr
1117
1148
  a === void 0 ? t -= 1 : a();
1118
1149
  }
1119
1150
  };
1120
- }, Gn = (e, t) => {
1151
+ }, Wn = (e, t) => {
1121
1152
  if (e.isSymbolicLink()) return "symbolic-link";
1122
1153
  if (!(e.isDirectory() || e.isFile())) return "special-file";
1123
1154
  const { name: r } = e;
1124
1155
  return r !== r.normalize("NFC") ? "not-nfc" : r.includes(":") ? "colon" : r.endsWith(".") || r.endsWith(" ") ? "trailing-dot-or-space" : te(r) ? te(t) ? null : "path-too-long" : "control-character-or-backslash";
1125
- }, Jn = /* @__PURE__ */ new Set(["id", "label", "root", "pathPrefix", "parse", "deny", "maxEntries", "maxDocumentBytes", "textPreviewBytes", "walkConcurrency", "cacheScope", "reportSkipped"]), he = (e, t, r) => {
1156
+ }, Yn = /* @__PURE__ */ new Set(["id", "label", "root", "pathPrefix", "parse", "deny", "maxEntries", "maxDocumentBytes", "textPreviewBytes", "walkConcurrency", "cacheScope", "reportSkipped"]), ge = (e, t, r) => {
1126
1157
  if (t === void 0) return r;
1127
1158
  if (typeof t != "number" || !Number.isSafeInteger(t) || t <= 0) throw new RangeError(`[markdown-explorer] ${e} must be a positive integer; got ${String(t)}`);
1128
1159
  return t;
1129
- }, io = (e) => {
1160
+ }, uo = (e) => {
1130
1161
  if (e === null || typeof e != "object") throw new TypeError("[markdown-explorer] createFileSystemSource needs an options object");
1131
- for (const i of Object.keys(e))
1132
- if (!Jn.has(i)) throw new TypeError(`[markdown-explorer] createFileSystemSource does not know the option ${JSON.stringify(i)}`);
1162
+ for (const g of Object.keys(e))
1163
+ if (!Yn.has(g)) throw new TypeError(`[markdown-explorer] createFileSystemSource does not know the option ${JSON.stringify(g)}`);
1133
1164
  const { id: t, label: r, root: n, parse: a } = e;
1134
1165
  if (typeof t != "string" || t === "") throw new TypeError("[markdown-explorer] a file-system source needs a non-empty id");
1135
1166
  if (typeof r != "string" || r.trim() === "") throw new TypeError("[markdown-explorer] a file-system source needs a non-blank label");
1136
1167
  if (typeof a != "function") throw new TypeError("[markdown-explorer] a file-system source needs a parse function");
1137
- if (typeof n != "string" || !$e(n)) throw new RangeError(`[markdown-explorer] root must be an absolute path; got ${JSON.stringify(n)}`);
1168
+ if (typeof n != "string" || !Le(n)) throw new RangeError(`[markdown-explorer] root must be an absolute path; got ${JSON.stringify(n)}`);
1138
1169
  let o;
1139
1170
  try {
1140
- o = er(n).isDirectory();
1141
- } catch (i) {
1142
- throw new RangeError(`[markdown-explorer] root does not exist: ${n}`, { cause: i });
1171
+ o = tr(n).isDirectory();
1172
+ } catch (g) {
1173
+ throw new RangeError(`[markdown-explorer] root does not exist: ${n}`, { cause: g });
1143
1174
  }
1144
1175
  if (!o) throw new RangeError(`[markdown-explorer] root is not a directory: ${n}`);
1145
- const c = tr(n), f = e.pathPrefix;
1146
- if (typeof f != "string") throw new TypeError('[markdown-explorer] pathPrefix is required: "" for a source over the whole root, or relative segments ending with "/"');
1147
- if (f !== "" && !(f.endsWith("/") && st(f.slice(0, -1))))
1148
- throw new RangeError(`[markdown-explorer] pathPrefix must be empty or relative segments ending with "/"; got ${JSON.stringify(f)}`);
1149
- const g = ct(e.deny), T = he("maxEntries", e.maxEntries, we.maxEntries), d = he("maxDocumentBytes", e.maxDocumentBytes, we.maxDocumentBytes), p = he("textPreviewBytes", e.textPreviewBytes, we.textPreviewBytes), _ = he("walkConcurrency", e.walkConcurrency, we.walkConcurrency), R = e.cacheScope === void 0 ? "principal" : e.cacheScope;
1150
- if (R !== "principal" && R !== "shared") throw new RangeError(`[markdown-explorer] cacheScope must be "principal" or "shared"; got ${JSON.stringify(R)}`);
1151
- const I = e.reportSkipped;
1152
- if (I !== void 0 && typeof I != "function") throw new TypeError("[markdown-explorer] reportSkipped must be a function");
1153
- const O = I === void 0 ? (i) => {
1154
- console.warn(`[markdown-explorer] the file-system source ${JSON.stringify(i.sourceId)} does not list ${JSON.stringify(i.path)}: ${i.reason}`);
1155
- } : I, x = /* @__PURE__ */ new Set(), P = (i) => {
1156
- const E = or(c, ...i.split("/")), S = je(c, E);
1157
- return S === "" || S === ".." || S.startsWith(`..${Le}`) || $e(S) ? null : E;
1158
- }, b = (i, E) => {
1159
- const S = `${E}\0${i}`;
1160
- x.has(S) || x.size >= T || (x.add(S), O({ sourceId: t, path: i, reason: E }));
1161
- }, N = async ({ signal: i }) => {
1162
- i.throwIfAborted();
1163
- const E = new AbortController(), S = () => {
1164
- E.abort(i.reason);
1176
+ const i = rr(n), l = e.pathPrefix;
1177
+ if (typeof l != "string") throw new TypeError('[markdown-explorer] pathPrefix is required: "" for a source over the whole root, or relative segments ending with "/"');
1178
+ if (l !== "" && !(l.endsWith("/") && it(l.slice(0, -1))))
1179
+ throw new RangeError(`[markdown-explorer] pathPrefix must be empty or relative segments ending with "/"; got ${JSON.stringify(l)}`);
1180
+ const y = lt(e.deny), x = ge("maxEntries", e.maxEntries, he.maxEntries), f = ge("maxDocumentBytes", e.maxDocumentBytes, he.maxDocumentBytes), w = ge("textPreviewBytes", e.textPreviewBytes, he.textPreviewBytes), O = ge("walkConcurrency", e.walkConcurrency, he.walkConcurrency), _ = e.cacheScope === void 0 ? "principal" : e.cacheScope;
1181
+ if (_ !== "principal" && _ !== "shared") throw new RangeError(`[markdown-explorer] cacheScope must be "principal" or "shared"; got ${JSON.stringify(_)}`);
1182
+ const v = e.reportSkipped;
1183
+ if (v !== void 0 && typeof v != "function") throw new TypeError("[markdown-explorer] reportSkipped must be a function");
1184
+ const R = v === void 0 ? (g) => {
1185
+ console.warn(`[markdown-explorer] the file-system source ${JSON.stringify(g.sourceId)} does not list ${JSON.stringify(g.path)}: ${g.reason}`);
1186
+ } : v, k = /* @__PURE__ */ new Set(), j = (g) => {
1187
+ const T = sr(i, ...g.split("/")), b = ze(i, T);
1188
+ return b === "" || b === ".." || b.startsWith(`..${De}`) || Le(b) ? null : T;
1189
+ }, S = (g, T) => {
1190
+ const b = `${T}\0${g}`;
1191
+ k.has(b) || k.size >= x || (k.add(b), R({ sourceId: t, path: g, reason: T }));
1192
+ }, A = async ({ signal: g }) => {
1193
+ g.throwIfAborted();
1194
+ const T = new AbortController(), b = () => {
1195
+ T.abort(g.reason);
1165
1196
  };
1166
- i.addEventListener("abort", S, { once: !0 });
1167
- const k = Xn(_);
1168
- let A = 0;
1169
- const D = async (M, U) => {
1170
- const X = await k(async () => {
1171
- E.signal.throwIfAborted();
1197
+ g.addEventListener("abort", b, { once: !0 });
1198
+ const N = Jn(O);
1199
+ let P = 0;
1200
+ const B = async (M, X) => {
1201
+ const J = await N(async () => {
1202
+ T.signal.throwIfAborted();
1172
1203
  try {
1173
- return await cr(M, { withFileTypes: !0 });
1174
- } catch ($) {
1175
- if (U === "" || !Hn($)) throw $;
1204
+ return await ur(M, { withFileTypes: !0 });
1205
+ } catch (L) {
1206
+ if (X === "" || !Fn(L)) throw L;
1176
1207
  return null;
1177
1208
  }
1178
1209
  });
1179
- if (E.signal.throwIfAborted(), X === null)
1180
- return b(`${f}${U}`, "unreadable-directory"), null;
1181
- const F = [];
1182
- for (const $ of X) {
1183
- if (g.deniesName($.name)) continue;
1184
- const J = U === "" ? $.name : `${U}/${$.name}`, K = `${f}${J}`, W = Gn($, K);
1185
- if (W !== null) {
1186
- b(K, W);
1210
+ if (T.signal.throwIfAborted(), J === null)
1211
+ return S(`${l}${X}`, "unreadable-directory"), null;
1212
+ const U = [];
1213
+ for (const L of J) {
1214
+ if (y.deniesName(L.name)) continue;
1215
+ const W = X === "" ? L.name : `${X}/${L.name}`, Z = `${l}${W}`, Y = Wn(L, Z);
1216
+ if (Y !== null) {
1217
+ S(Z, Y);
1187
1218
  continue;
1188
1219
  }
1189
- F.push({ dirent: $, relativePath: J, path: K });
1220
+ U.push({ dirent: L, relativePath: W, path: Z });
1190
1221
  }
1191
- if (A += F.length, A > T) throw new Ee("too-large");
1192
- return F.sort(($, J) => Un($.dirent.name, J.dirent.name)), (await Promise.all(
1193
- F.map(async ({ dirent: $, relativePath: J, path: K }) => {
1194
- if (!$.isDirectory()) return { name: $.name, path: K, type: "file" };
1195
- const W = await D(nr(M, $.name), J);
1196
- return W === null ? null : { name: $.name, path: K, type: "directory", children: W };
1222
+ if (P += U.length, P > x) throw new Ee("too-large");
1223
+ return U.sort((L, W) => Gn(L.dirent.name, W.dirent.name)), (await Promise.all(
1224
+ U.map(async ({ dirent: L, relativePath: W, path: Z }) => {
1225
+ if (!L.isDirectory()) return { name: L.name, path: Z, type: "file" };
1226
+ const Y = await B(or(M, L.name), W);
1227
+ return Y === null ? null : { name: L.name, path: Z, type: "directory", children: Y };
1197
1228
  })
1198
- )).filter(($) => $ !== null);
1229
+ )).filter((L) => L !== null);
1199
1230
  };
1200
1231
  try {
1201
- const M = await D(c, "");
1232
+ const M = await B(i, "");
1202
1233
  if (M === null) throw new Error("[markdown-explorer] the source's root could not be listed");
1203
1234
  return M;
1204
1235
  } catch (M) {
1205
- throw E.abort(), M;
1236
+ throw T.abort(), M;
1206
1237
  } finally {
1207
- i.removeEventListener("abort", S);
1238
+ g.removeEventListener("abort", b);
1208
1239
  }
1209
- }, C = async (i) => {
1210
- if (!i.startsWith(f)) return { status: "refused", reason: "not-found" };
1211
- const E = i.slice(f.length);
1212
- if (!st(E)) return { status: "refused", reason: "invalid" };
1213
- if (g.deniesPath(E)) return { status: "refused", reason: "forbidden" };
1214
- const S = P(E);
1215
- if (S === null) return { status: "refused", reason: "forbidden" };
1216
- const k = await ar(S, { bigint: !0 });
1217
- if (k.isSymbolicLink()) return { status: "refused", reason: "forbidden" };
1218
- if (!k.isFile()) return { status: "refused", reason: "unsupported" };
1219
- const A = await ir(S);
1220
- return A !== S || g.deniesPath(je(c, A).split(Le).join("/")) ? { status: "refused", reason: "forbidden" } : { status: "file", target: S, name: E.slice(E.lastIndexOf("/") + 1), stats: k };
1221
- }, z = async (i, E, S) => {
1222
- let k;
1240
+ }, D = async (g) => {
1241
+ if (!g.startsWith(l)) return { status: "refused", reason: "not-found" };
1242
+ const T = g.slice(l.length);
1243
+ if (!it(T)) return { status: "refused", reason: "invalid" };
1244
+ if (y.deniesPath(T)) return { status: "refused", reason: "forbidden" };
1245
+ const b = j(T);
1246
+ if (b === null) return { status: "refused", reason: "forbidden" };
1247
+ const N = await ir(b, { bigint: !0 });
1248
+ if (N.isSymbolicLink()) return { status: "refused", reason: "forbidden" };
1249
+ if (!N.isFile()) return { status: "refused", reason: "unsupported" };
1250
+ const P = await cr(b);
1251
+ return P !== b || y.deniesPath(ze(i, P).split(De).join("/")) ? { status: "refused", reason: "forbidden" } : { status: "file", target: b, name: T.slice(T.lastIndexOf("/") + 1), stats: N };
1252
+ }, C = async (g, T, b) => {
1253
+ let N;
1223
1254
  try {
1224
- const A = await C(S);
1225
- if (A.status === "refused") return ee(A.reason);
1226
- const { target: D, name: M, stats: U } = A, X = Dn(M), F = ot(U);
1227
- if (X.kind === "image") return { kind: "image", name: M, version: F };
1228
- if (X.kind === "media") return { kind: "media", name: M, mediaType: X.mediaType, version: F };
1229
- if (X.kind === "file") return { kind: "file", name: M, version: F };
1230
- k = await lt(D, ie.O_RDONLY | bt | St);
1231
- const Z = await k.stat({ bigint: !0 });
1232
- if (!Z.isFile() || Z.ino !== U.ino || Z.dev !== U.dev) return ee("forbidden");
1233
- if (X.kind === "markdown") {
1234
- if (Z.size > BigInt(d)) return ee("too-large");
1235
- const W = await at(k, d + 1);
1236
- if (W.length > d) return ee("too-large");
1237
- const le = await a(new TextDecoder("utf-8").decode(W), E);
1238
- return { kind: "markdown", name: M, htmlContent: le.htmlContent, headings: le.headings };
1255
+ const P = await D(b);
1256
+ if (P.status === "refused") return ne(P.reason);
1257
+ const { target: B, name: M, stats: X } = P, J = Bn(M), U = at(X);
1258
+ if (J.kind === "image") return { kind: "image", name: M, version: U };
1259
+ if (J.kind === "media") return { kind: "media", name: M, mediaType: J.mediaType, version: U };
1260
+ if (J.kind === "file") return { kind: "file", name: M, version: U };
1261
+ N = await ft(B, ce.O_RDONLY | Tt | xt);
1262
+ const q = await N.stat({ bigint: !0 });
1263
+ if (!q.isFile() || q.ino !== X.ino || q.dev !== X.dev) return ne("forbidden");
1264
+ if (J.kind === "markdown") {
1265
+ if (q.size > BigInt(f)) return ne("too-large");
1266
+ const Y = await ct(N, f + 1);
1267
+ if (Y.length > f) return ne("too-large");
1268
+ const de = await a(new TextDecoder("utf-8").decode(Y), T);
1269
+ return { kind: "markdown", name: M, htmlContent: de.htmlContent, headings: de.headings };
1239
1270
  }
1240
- const $ = await at(k, p);
1241
- if ($.includes(0)) return { kind: "file", name: M, version: F };
1242
- const J = Z.size > BigInt(p), K = new TextDecoder("utf-8").decode($, { stream: J });
1243
- return { kind: "text", name: M, text: K, truncated: J, version: F };
1244
- } catch (A) {
1245
- const D = xt(A);
1246
- if (D === null) throw A;
1247
- return ee(D);
1271
+ const L = await ct(N, w);
1272
+ if (L.includes(0)) return { kind: "file", name: M, version: U };
1273
+ const W = q.size > BigInt(w), Z = new TextDecoder("utf-8").decode(L, { stream: W });
1274
+ return { kind: "text", name: M, text: Z, truncated: W, version: U };
1275
+ } catch (P) {
1276
+ const B = Ae(P);
1277
+ if (B === null) throw P;
1278
+ return ne(B);
1248
1279
  } finally {
1249
- await k?.close();
1280
+ await N?.close();
1250
1281
  }
1251
- }, u = async (i, E, S) => {
1252
- let k;
1282
+ }, u = async (g, T, b) => {
1283
+ let N;
1253
1284
  try {
1254
- k = await C(S);
1255
- } catch (F) {
1256
- throw Ot(F);
1285
+ N = await D(b);
1286
+ } catch (U) {
1287
+ throw Ot(U);
1288
+ }
1289
+ if (N.status === "refused") throw new Ee(N.reason);
1290
+ const { target: P, name: B, stats: M } = N, X = St.get(kt(B)), J = X === void 0 ? "" : X.contentType;
1291
+ return { name: B, contentType: J, size: Number(M.size), version: at(M), open: (U) => Xn(P, M, U, g.signal) };
1292
+ }, h = async (g, T, b) => {
1293
+ let N;
1294
+ try {
1295
+ N = await D(b);
1296
+ } catch (M) {
1297
+ if (Ae(M) !== null) return null;
1298
+ throw M;
1257
1299
  }
1258
- if (k.status === "refused") throw new Ee(k.reason);
1259
- const { target: A, name: D, stats: M } = k, U = yt.get(Tt(D)), X = U === void 0 ? "" : U.contentType;
1260
- return { name: D, contentType: X, size: Number(M.size), version: ot(M), open: (F) => Fn(A, M, F, i.signal) };
1300
+ if (N.status === "refused") return null;
1301
+ const P = b.slice(l.length).split("/");
1302
+ if (P.some((M) => y.deniesName(M))) return null;
1303
+ const B = P.slice(0, -1);
1304
+ return B.map((M, X) => `${l}${B.slice(0, X + 1).join("/")}`);
1261
1305
  };
1262
1306
  return Object.freeze({
1263
1307
  id: t,
1264
1308
  label: r,
1265
- cacheScope: R,
1266
- boundary: Object.freeze({ contains: (i) => i.startsWith(f) }),
1267
- tree: N,
1268
- document: z,
1309
+ cacheScope: _,
1310
+ boundary: Object.freeze({ contains: (g) => g.startsWith(l) }),
1311
+ tree: A,
1312
+ ancestors: h,
1313
+ document: C,
1269
1314
  asset: u
1270
1315
  });
1271
1316
  };
1272
1317
  export {
1273
- lo as DEFAULT_DENIED_PATH_SEGMENTS,
1318
+ mo as DEFAULT_DENIED_PATH_SEGMENTS,
1274
1319
  Ee as ExplorerError,
1275
- fo as MAX_DOCUMENT_PATH_LENGTH,
1276
- so as anonymousAccess,
1277
- io as createFileSystemSource,
1278
- ao as createMarkdownExplorer,
1320
+ po as MAX_DOCUMENT_PATH_LENGTH,
1321
+ io as anonymousAccess,
1322
+ uo as createFileSystemSource,
1323
+ co as createMarkdownExplorer,
1279
1324
  te as isAcceptableDocumentPath,
1280
- mo as isDeniedPath
1325
+ wo as isDeniedPath
1281
1326
  };