@dpuse/dpuse-development 0.3.812 → 0.3.813

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.
@@ -1,58 +1,59 @@
1
- import { A as e, C as t, D as n, E as r, S as i, T as a, _ as o, a as s, b as c, c as l, d as u, f as d, g as f, h as p, i as m, k as h, l as g, m as _, n as ee, o as te, p as v, r as y, s as ne, t as re, u as b, v as x, w as S, x as C, y as w } from "./utilities-CQ2h3IWL.js";
2
- import { existsSync as ie } from "node:fs";
3
- import T from "node:path";
4
- import { promisify as ae } from "node:util";
5
- import { execFile as oe } from "node:child_process";
6
- import { fileURLToPath as se } from "node:url";
7
- import { run as ce } from "npm-check-updates";
8
- import { init as le } from "license-checker-rseidelsohn";
1
+ import { A as e, C as t, D as n, E as r, S as i, T as a, _ as o, a as s, b as c, c as l, d as u, f as d, g as f, h as p, i as m, k as h, l as g, m as _, n as ee, o as te, p as v, r as ne, s as re, t as ie, u as y, v as b, w as x, x as S, y as C } from "./utilities-CQ2h3IWL.js";
2
+ import { SHIPPED_PACKAGES_FILE_NAME as ae } from "./vite.es.js";
3
+ import { existsSync as oe, promises as se } from "node:fs";
4
+ import w from "node:path";
5
+ import { promisify as ce } from "node:util";
6
+ import { execFile as le } from "node:child_process";
7
+ import { fileURLToPath as ue } from "node:url";
8
+ import { run as de } from "npm-check-updates";
9
+ import { init as fe } from "license-checker-rseidelsohn";
9
10
  //#region src/actions/auditDependencies.ts
10
- async function ue() {
11
+ async function pe() {
11
12
  try {
12
- f("Audit Dependencies"), await S("1️⃣ Check shipped dependencies for any vulnerability", "npm", ["audit", "--omit=dev"]), await S("2️⃣ Check all dependencies for high or critical vulnerabilities", "npm", ["audit", "--audit-level=high"]), o("Dependencies audited");
13
+ f("Audit Dependencies"), await x("1️⃣ Check shipped dependencies for any vulnerability", "npm", ["audit", "--omit=dev"]), await x("2️⃣ Check all dependencies for high or critical vulnerabilities", "npm", ["audit", "--audit-level=high"]), o("Dependencies audited");
13
14
  } catch (e) {
14
15
  console.error("❌ Error auditing dependencies", e), process.exit(1);
15
16
  }
16
17
  }
17
18
  //#endregion
18
19
  //#region src/actions/buildProject.ts
19
- var E = "build:wasm";
20
- async function de() {
20
+ var me = "build:wasm";
21
+ async function he() {
21
22
  try {
22
- f("Build Project"), await D("1️⃣ ", await c("package.json")), o("Project built");
23
+ f("Build Project"), await T("1️⃣ ", await c("package.json")), o("Project built");
23
24
  } catch (e) {
24
25
  console.error("❌ Error building project", e), process.exit(1);
25
26
  }
26
27
  }
27
- async function D(e, t) {
28
- t.scripts?.[E] != null && await S(`${e} Build WebAssembly`, "npm", ["run", E]), await S(`${e} Bundle project`, "vite", ["build"]);
28
+ async function T(e, t) {
29
+ t.scripts?.[me] != null && await x(`${e} Build WebAssembly`, "npm", ["run", me]), await x(`${e} Bundle project`, "vite", ["build"]);
29
30
  }
30
31
  //#endregion
31
32
  //#region src/actions/checkConfigFiles.ts
32
- var O = "@dpuse/dpuse-development/prettierrc", fe = "dpuse-development";
33
- async function pe() {
33
+ var E = "@dpuse/dpuse-development/prettierrc", ge = "dpuse-development";
34
+ async function _e() {
34
35
  try {
35
- f("Check configuration files"), x("1️⃣ Check individual files");
36
- let e = await c("config.json"), t = await c("package.json"), n = t.private === !0, r = _(e.id), a = T.dirname(se(import.meta.url));
37
- await k(a, ".editorconfig"), await k(a, ".gitattributes"), await k(a, ".gitignore", [".gitignore_default"]), await k(a, ".markdownlint.json"), await k(a, ".ncurc.json"), await me(r, a), await k(a, "LICENSE"), await ge(r, a), await _e(r, a), await ve(r, a), await be(r, a), he(r, t);
36
+ f("Check configuration files"), b("1️⃣ Check individual files");
37
+ let e = await c("config.json"), t = await c("package.json"), n = t.private === !0, r = _(e.id), a = w.dirname(ue(import.meta.url));
38
+ await D(a, ".editorconfig"), await D(a, ".gitattributes"), await D(a, ".gitignore", [".gitignore_default"]), await D(a, ".markdownlint.json"), await D(a, ".ncurc.json"), await ve(r, a), await D(a, "LICENSE"), await be(r, a), await xe(r, a), await Se(r, a), await we(r, a), ye(r, t);
38
39
  let s = await i(l) !== null;
39
- s && await k(a, "rust-toolchain.toml"), await k(a, ".github/dependabot.yml", [`.github/dependabot${n ? ".private" : ""}${s ? ".rust" : ""}.yml`]), n ? console.info("ℹ️ GitHub workflows and file 'SECURITY.md' are NOT required by this project") : (await ye(a), await k(a, "SECURITY.md", [], (t) => t.replaceAll(fe, () => e.id))), o("Configuration files checked");
40
+ s && await D(a, "rust-toolchain.toml"), await D(a, ".github/dependabot.yml", [`.github/dependabot${n ? ".private" : ""}${s ? ".rust" : ""}.yml`]), n ? console.info("ℹ️ GitHub workflows and file 'SECURITY.md' are NOT required by this project") : (await Ce(a), await D(a, "SECURITY.md", [], (t) => t.replaceAll(ge, () => e.id))), o("Configuration files checked");
40
41
  } catch (e) {
41
42
  console.error("❌ Error checking configuration files", e), process.exit(1);
42
43
  }
43
44
  }
44
- async function me(e, t) {
45
+ async function ve(e, t) {
45
46
  ["github", "kb"].includes(e.typeId) ? console.info("ℹ️ File 'eslint.config.js' is NOT required by this project") : [
46
47
  "app",
47
48
  "api",
48
49
  "development",
49
50
  "eslint"
50
- ].includes(e.typeId) ? console.info("⚠️ File 'eslint.config.js' is UNIQUE to this project") : await k(t, "eslint.config.js", ["eslint.config.default.js"]);
51
+ ].includes(e.typeId) ? console.info("⚠️ File 'eslint.config.js' is UNIQUE to this project") : await D(t, "eslint.config.js", ["eslint.config.default.js"]);
51
52
  }
52
- function he(e, t) {
53
- e.typeId === "development" ? console.info("ℹ️ File '.prettierrc.json' is the template") : e.typeId === "app" ? console.info("⚠️ File '.prettierrc.json' is UNIQUE to this project") : t.prettier === O ? console.info(`ℹ️ Prettier configuration is '${O}'`) : console.info(`❌ Prettier configuration is NOT '${O}'`);
53
+ function ye(e, t) {
54
+ e.typeId === "development" ? console.info("ℹ️ File '.prettierrc.json' is the template") : e.typeId === "app" ? console.info("⚠️ File '.prettierrc.json' is UNIQUE to this project") : t.prettier === E ? console.info(`ℹ️ Prettier configuration is '${E}'`) : console.info(`❌ Prettier configuration is NOT '${E}'`);
54
55
  }
55
- async function ge(e, t) {
56
+ async function be(e, t) {
56
57
  ["github"].includes(e.typeId) ? console.info("ℹ️ File 'tsconfig.json' is NOT required by this project") : [
57
58
  "connector",
58
59
  "cookbook",
@@ -61,12 +62,12 @@ async function ge(e, t) {
61
62
  "presenter",
62
63
  "shared",
63
64
  "tool"
64
- ].includes(e.typeId) ? await k(t, "tsconfig.json") : console.info("⚠️ File 'tsconfig.json' is UNIQUE to this project");
65
+ ].includes(e.typeId) ? await D(t, "tsconfig.json") : console.info("⚠️ File 'tsconfig.json' is UNIQUE to this project");
65
66
  }
66
- async function _e(e, t) {
67
- ["github"].includes(e.typeId) ? console.info("ℹ️ File 'scripts/tsconfig.json' is NOT required by this project") : await k(t, "scripts/tsconfig.json");
67
+ async function xe(e, t) {
68
+ ["github"].includes(e.typeId) ? console.info("ℹ️ File 'scripts/tsconfig.json' is NOT required by this project") : await D(t, "scripts/tsconfig.json");
68
69
  }
69
- async function ve(e, t) {
70
+ async function Se(e, t) {
70
71
  if ([
71
72
  "eslint",
72
73
  "github",
@@ -89,25 +90,25 @@ async function ve(e, t) {
89
90
  break;
90
91
  default: n = ["vite.config.default.ts"];
91
92
  }
92
- await k(t, "vite.config.ts", n);
93
+ await D(t, "vite.config.ts", n);
93
94
  }
94
95
  }
95
- async function ye(e) {
96
- await k(e, ".github/workflows/ci.yml"), await k(e, ".github/workflows/codeql.yml"), await k(e, ".github/workflows/publish.yml"), await k(e, ".github/workflows/scorecard.yml");
96
+ async function Ce(e) {
97
+ await D(e, ".github/workflows/ci.yml"), await D(e, ".github/workflows/codeql.yml"), await D(e, ".github/workflows/publish.yml"), await D(e, ".github/workflows/scorecard.yml");
97
98
  }
98
- async function be(e, t) {
99
+ async function we(e, t) {
99
100
  [
100
101
  "app",
101
102
  "api",
102
103
  "eslint",
103
104
  "github",
104
105
  "kb"
105
- ].includes(e.typeId) ? console.info("ℹ️ File 'vitest.config.ts' is NOT required by this project") : await k(t, "vitest.config.ts");
106
+ ].includes(e.typeId) ? console.info("ℹ️ File 'vitest.config.ts' is NOT required by this project") : await D(t, "vitest.config.ts");
106
107
  }
107
- async function k(e, t, n = [], r = (e) => e) {
108
- let i = T.resolve(process.cwd(), t), a = n.length > 0 ? n : [t], o;
108
+ async function D(e, t, n = [], r = (e) => e) {
109
+ let i = w.resolve(process.cwd(), t), a = n.length > 0 ? n : [t], o;
109
110
  try {
110
- o = await C(i);
111
+ o = await S(i);
111
112
  } catch (e) {
112
113
  if (e.code !== "ENOENT") throw e;
113
114
  }
@@ -116,7 +117,7 @@ async function k(e, t, n = [], r = (e) => e) {
116
117
  return;
117
118
  }
118
119
  for (let n of a) {
119
- let i = T.resolve(e, `../${n}`), a = r(await C(i));
120
+ let i = w.resolve(e, `../${n}`), a = r(await S(i));
120
121
  if (o === a) {
121
122
  console.info(`ℹ️ File '${t}' is the same as '${n}'`);
122
123
  return;
@@ -126,43 +127,43 @@ async function k(e, t, n = [], r = (e) => e) {
126
127
  }
127
128
  //#endregion
128
129
  //#region src/actions/checkDependencies.ts
129
- async function xe() {
130
+ async function Te() {
130
131
  try {
131
- f("Check Dependencies"), await S("1️⃣ Check using 'npm outdated'", "npm", ["outdated"], !0), x("2️⃣ Check using 'npm-check-updates'");
132
+ f("Check Dependencies"), await x("1️⃣ Check using 'npm outdated'", "npm", ["outdated"], !0), b("2️⃣ Check using 'npm-check-updates'");
132
133
  let e = {};
133
134
  try {
134
- e = await c(T.resolve(process.cwd(), ".ncurc.json"));
135
+ e = await c(w.resolve(process.cwd(), ".ncurc.json"));
135
136
  } catch (e) {
136
137
  if (e.code !== "ENOENT") throw e;
137
138
  }
138
- await ce({
139
+ await de({
139
140
  interactive: !0,
140
141
  upgrade: !0,
141
142
  dep: "dev,prod,peer,optional",
142
143
  install: "never",
143
144
  ...e
144
- }), await S("3️⃣ Install updated dependencies", "npm", [
145
+ }), await x("3️⃣ Install updated dependencies", "npm", [
145
146
  "install",
146
147
  "--prefer-online",
147
148
  "--no-strict-allow-scripts",
148
149
  "--no-audit",
149
150
  "--no-fund"
150
- ]), await S("4️⃣ Fix vulnerabilities where a compatible upgrade exists", "npm", [
151
+ ]), await x("4️⃣ Fix vulnerabilities where a compatible upgrade exists", "npm", [
151
152
  "audit",
152
153
  "fix",
153
154
  "--no-strict-allow-scripts",
154
155
  "--no-fund"
155
156
  ], !0);
156
- let t = await Se();
157
- t.length > 0 ? await S("5️⃣ Move install-script pins to installed versions", "npm", [
157
+ let t = await Ee();
158
+ t.length > 0 ? await x("5️⃣ Move install-script pins to installed versions", "npm", [
158
159
  "install-scripts",
159
160
  "approve",
160
161
  ...t
161
- ]) : x("5️⃣ No pinned install-script approvals to move"), process.platform === "darwin" ? await S("6️⃣ Remove unused install-script entries", "npm", ["install-scripts", "prune"]) : x("6️⃣ Skipped removing unused install-script entries (macOS only)"), t.length > 0 && await S("7️⃣ Run install scripts skipped in steps 3 and 4", "npm", [
162
+ ]) : b("5️⃣ No pinned install-script approvals to move"), process.platform === "darwin" ? await x("6️⃣ Remove unused install-script entries", "npm", ["install-scripts", "prune"]) : b("6️⃣ Skipped removing unused install-script entries (macOS only)"), t.length > 0 && await x("7️⃣ Run install scripts skipped in steps 3 and 4", "npm", [
162
163
  "rebuild",
163
164
  ...t,
164
165
  "--no-strict-allow-scripts"
165
- ]), await S("8️⃣ Confirm every install script is reviewed", "npm", [
166
+ ]), await x("8️⃣ Confirm every install script is reviewed", "npm", [
166
167
  "install",
167
168
  "--strict-allow-scripts",
168
169
  "--no-audit",
@@ -172,56 +173,56 @@ async function xe() {
172
173
  console.error("❌ Error checking dependencies", e), process.exit(1);
173
174
  }
174
175
  }
175
- async function Se() {
176
- let { allowScripts: e = {} } = await c(T.resolve(process.cwd(), "package.json")), t = Object.entries(e).filter(([e, t]) => t && e.lastIndexOf("@") > 0).map(([e]) => e.slice(0, e.lastIndexOf("@")));
176
+ async function Ee() {
177
+ let { allowScripts: e = {} } = await c(w.resolve(process.cwd(), "package.json")), t = Object.entries(e).filter(([e, t]) => t && e.lastIndexOf("@") > 0).map(([e]) => e.slice(0, e.lastIndexOf("@")));
177
178
  return [...new Set(t)];
178
179
  }
179
180
  //#endregion
180
181
  //#region src/actions/checkProject.ts
181
- async function Ce() {
182
- await pe(), await xe();
182
+ async function De() {
183
+ await _e(), await Te();
183
184
  }
184
185
  //#endregion
185
186
  //#region src/actions/documentActions.ts
186
- var we = "<!-- SUPPORTED_ACTIONS_START -->", Te = "<!-- SUPPORTED_ACTIONS_END -->", Ee = "Connectors conform to a unified interface contract by implementing a specific subset of standard actions. These standardised actions allow the DPUse application to interact with any underlying data source in the same way, enabling Connectors to be built independently and loaded dynamically at runtime.", De = {
187
+ var Oe = "<!-- SUPPORTED_ACTIONS_START -->", ke = "<!-- SUPPORTED_ACTIONS_END -->", Ae = "Connectors conform to a unified interface contract by implementing a specific subset of standard actions. These standardised actions allow the DPUse application to interact with any underlying data source in the same way, enabling Connectors to be built independently and loaded dynamically at runtime.", je = {
187
188
  source: "This connector is a Source connector that supports only read actions. Connectors can also function as a Destination (write-only) or Bidirectional (read/write), depending on the actions they support.",
188
189
  destination: "This connector is a Destination connector that supports only write actions. Connectors can also function as a Source (read-only) or Bidirectional (read/write), depending on the actions they support.",
189
190
  bidirectional: "This connector is a Bidirectional connector that supports both read and write actions. Connectors can also function as a Source (read-only) or Destination (write-only), depending on the actions they support.",
190
191
  unknown: "This connector does not yet implement any read or write actions, so its type cannot be determined. Connectors function as a Source (read-only), a Destination (write-only), or Bidirectional (read/write), depending on the actions they support."
191
- }, Oe = "The table below lists all connector actions and highlights those supported by this connector.";
192
- async function ke() {
192
+ }, Me = "The table below lists all connector actions and highlights those supported by this connector.";
193
+ async function Ne() {
193
194
  try {
194
- f("Document Actions"), x("1️⃣ Insert actions description and table into 'README.md'");
195
- let t = (await c("config.json")).actionNames ?? [], r = h(t), i = e(t), a = `## Supported Actions\n\n${Ee}\n\n${De[r]} ${Oe}\n\n${i}`;
196
- await n(a, we, Te), o("Actions documented");
195
+ f("Document Actions"), b("1️⃣ Insert actions description and table into 'README.md'");
196
+ let t = (await c("config.json")).actionNames ?? [], r = h(t), i = e(t), a = `## Supported Actions\n\n${Ae}\n\n${je[r]} ${Me}\n\n${i}`;
197
+ await n(a, Oe, ke), o("Actions documented");
197
198
  } catch (e) {
198
199
  console.error("❌ Error documenting actions", e), process.exit(1);
199
200
  }
200
201
  }
201
202
  //#endregion
202
203
  //#region src/actions/documentContributingLicense.ts
203
- async function Ae() {
204
+ async function Pe() {
204
205
  try {
205
206
  f("Document Contributing & License");
206
- let [e, r] = await Promise.all([c("package.json"), c("config.json")]), { owner: i, repo: a } = t(e, "document contributing and license"), s = je(e), l = Me(r.firstCreatedAt);
207
- x("1️⃣ Insert contributing and license content into 'README.md'"), await w(), await n(Ne(i, a, s, l), ee, re), o("Contributing & license documented");
207
+ let [e, r] = await Promise.all([c("package.json"), c("config.json")]), { owner: i, repo: a } = t(e, "document contributing and license"), s = Fe(e), l = Ie(r.firstCreatedAt);
208
+ b("1️⃣ Insert contributing and license content into 'README.md'"), await C(), await n(Le(i, a, s, l), ee, ie), o("Contributing & license documented");
208
209
  } catch (e) {
209
210
  console.error("❌ Error documenting contributing and license", e), process.exit(1);
210
211
  }
211
212
  }
212
- function je(e) {
213
+ function Fe(e) {
213
214
  let t = e.author, n = typeof t == "string" ? t : t?.name;
214
215
  if (n == null || n === "") throw Error("package.json 'author' field is required to document contributing and license.");
215
216
  let r = n.indexOf("<"), i = r === -1 ? -1 : n.indexOf(">", r);
216
217
  return i === -1 ? n.trim() : [n.slice(0, r).trim(), n.slice(i + 1).trim()].filter((e) => e !== "").join(" ");
217
218
  }
218
- function Me(e) {
219
+ function Ie(e) {
219
220
  let t = (/* @__PURE__ */ new Date()).getFullYear();
220
221
  if (e == null) return String(t);
221
222
  let n = new Date(e).getFullYear();
222
223
  return n === t ? String(t) : `${String(n)}-present`;
223
224
  }
224
- function Ne(e, t, n, r) {
225
+ function Le(e, t, n, r) {
225
226
  return `## Contributing
226
227
 
227
228
  This repository is maintained solely by its owner and does not, at present, accept external contributions into the canonical repo. Its source is published openly under the MIT License — every DPUse project is fully open source except DPUse Engine, which remains closed and proprietary.
@@ -236,83 +237,132 @@ This project is licensed under the MIT License, permitting free use, modificatio
236
237
  }
237
238
  //#endregion
238
239
  //#region src/actions/documentDependencies.ts
239
- var A = "<!-- DEPENDENCY_LICENSES_START -->", j = "<!-- DEPENDENCY_LICENSES_END -->", M = "## Dependency Licenses", Pe = "The dependency tree below lists every package in this project — direct and transitive — along with its installed version, release date, and update status. Packages flagged ❗ have a newer version available; ⚠️ indicates a package that hasn't been updated in the last 6 months or longer. Neither flag necessarily indicates a problem: we let new releases stabilise before upgrading, and some packages are mature and stable (have limited or no dependencies), so they require no active development.";
240
- async function Fe(e = "MIT") {
240
+ var O = "<!-- DEPENDENCY_LICENSES_START -->", k = "<!-- DEPENDENCY_LICENSES_END -->", A = "## Dependency Licenses", Re = `bundle-analysis-reports/${ae}`, j = "licenses/licenseTree.json", ze = "The dependency tree below lists every package in this project — direct and transitive — along with its installed version, release date, and update status. Packages flagged ❗ have a newer version available; ⚠️ indicates a package that hasn't been updated in the last 6 months or longer. Neither flag necessarily indicates a problem: we let new releases stabilise before upgrading, and some packages are mature and stable (have limited or no dependencies), so they require no active development.";
241
+ async function Be(e = "MIT") {
241
242
  try {
242
243
  f("Document Dependencies");
243
244
  let t = await c("package.json");
244
245
  if (t.name === "@dpuse/dpuse-development" || t.name === "@dpuse/eslint-config-dpuse") {
245
- await Ie(t.name), o("Dependencies documented");
246
+ await Ve(t.name), o("Dependencies documented");
246
247
  return;
247
248
  }
248
249
  await u("1️⃣ Clear downloaded licenses", "licenses/downloads");
249
- let n = await Re();
250
- x("2️⃣ Identify production licenses"), await new Promise((r, i) => {
251
- let a = {
252
- start: process.cwd(),
253
- production: !0,
254
- json: !0,
255
- files: "licenses/downloads",
256
- relativeModulePath: !0,
257
- relativeLicensePath: !0,
258
- onlyAllow: e,
259
- excludePackages: [t.name ?? "", ...n].join(";"),
260
- out: "licenses/licenses.json"
261
- };
262
- le(a, (e) => {
263
- e == null ? r() : i(e);
264
- });
265
- }), await a("3️⃣ Identify transitive dependencies", "npm", [
266
- "ls",
267
- "--all",
268
- "--json",
269
- "--omit=dev"
270
- ], "licenses/licenseTree.json"), await Le("4️⃣ ", e, new Set(n)), o("Dependencies documented");
250
+ let n = await We(), r = await Ge();
251
+ if (r === null) {
252
+ let r = Ye(n);
253
+ await N("2️⃣ Identify production licenses", e, [t.name ?? "", ...r], !0), await a("3️⃣ Identify transitive dependencies", "npm", [
254
+ "ls",
255
+ "--all",
256
+ "--json",
257
+ "--omit=dev"
258
+ ], j), await He("4️⃣ ", e, new Set(r));
259
+ } else {
260
+ let i = Ke(r, n), a = qe(n), o = a.filter((e) => !i.has(e));
261
+ await N("2️⃣ Identify shipped licenses", e, [t.name ?? "", ...o], !1), Je(i, new Set(a)), await se.rm(j, { force: !0 }), await Ue("3️⃣ ", e);
262
+ }
263
+ o("Dependencies documented");
271
264
  } catch (e) {
272
265
  console.error("❌ Error documenting dependencies", e), process.exit(1);
273
266
  }
274
267
  }
275
- async function Ie(e) {
276
- x(`1️⃣ Skip: ${e} is a development-only tool and is never part of a production release.`);
268
+ async function Ve(e) {
269
+ b(`1️⃣ Skip: ${e} is a development-only tool and is never part of a production release.`);
277
270
  let t = `> [!WARNING]\n> Dependency licenses are not documented here: ${e} is a development-only tool and is never part of a production release.`;
278
- await n(`${M}\n\n${t}`, A, j);
279
- }
280
- async function Le(e, t, r) {
281
- x(`${e} Insert licenses into 'README.md'`);
282
- let [i, a] = await Promise.all([c("licenses/licenses.json"), c("licenses/licenseTree.json")]), o = /* @__PURE__ */ new Map();
283
- for (let [e, t] of Object.entries(i)) o.set(e, We(e, t));
284
- await Promise.all(o.values().map(async (e) => {
285
- let t = await Ge(e.name, e.installedVersion);
271
+ await n(`${A}\n\n${t}`, O, k);
272
+ }
273
+ async function He(e, t, r) {
274
+ b(`${e} Insert licenses into 'README.md'`);
275
+ let i = await c(j), a = await M(), o = `${L(t, !1)}\n\n|Dependency|Version|License(s)|Document|\n|:-|:-:|:-|:-|\n`;
276
+ for (let e of a.values()) o += et(e);
277
+ let s = [];
278
+ i.dependencies != null && R(i.dependencies, a, r, s, 0);
279
+ let l = `${ze}\n\n${s.join("\n")}`;
280
+ await n(`${A}\n\n${o.trimEnd()}\n\n### Dependency Tree\n\n${l}`, O, k);
281
+ }
282
+ async function Ue(e, t) {
283
+ b(`${e} Insert licenses into 'README.md'`);
284
+ let r = (await M()).values().toArray().toSorted((e, t) => e.name.localeCompare(t.name, "en") || e.installedVersion.localeCompare(t.installedVersion, "en")), i = `${L(t, !0)}\n\n|Dependency|Version|Release|License(s)|Document|\n|:-|:-:|:-|:-|:-|\n`;
285
+ for (let e of r) i += tt(e);
286
+ await n(`${A}\n\n${i.trimEnd()}`, O, k);
287
+ }
288
+ async function M() {
289
+ let e = await c("licenses/licenses.json"), t = /* @__PURE__ */ new Map();
290
+ for (let [n, r] of Object.entries(e)) t.set(n, Qe(n, r));
291
+ return await Promise.all(t.values().map(async (e) => {
292
+ let t = await $e(e.name, e.installedVersion);
286
293
  e.latestVersion = t.latestVersion, e.latestPublishedDate = t.latestPublishedDate, e.publishedDate = t.publishedDate;
287
- }));
288
- let s = `${He(t)}\n\n|Dependency|Version|License(s)|Document|\n|:-|:-:|:-|:-|\n`;
289
- for (let e of o.values()) s += Ke(e);
290
- let l = [];
291
- a.dependencies != null && qe(a.dependencies, o, r, l, 0);
292
- let u = `${Pe}\n\n${l.join("\n")}`;
293
- await n(`${M}\n\n${s.trimEnd()}\n\n### Dependency Tree\n\n${u}`, A, j);
294
- }
295
- async function Re() {
296
- let e = await i("package-lock.json"), t = e === null ? {} : JSON.parse(e).packages ?? {}, n = ze(t), r = /* @__PURE__ */ new Set(), a = /* @__PURE__ */ new Set();
297
- for (let [e, i] of Object.entries(t)) {
298
- if (e === "" || i.version === void 0) continue;
299
- let t = `${i.name ?? e.slice(e.lastIndexOf("node_modules/") + 13)}@${i.version}`;
300
- n.has(e) ? r.add(t) : a.add(t);
294
+ })), t;
295
+ }
296
+ async function N(e, t, n, r) {
297
+ b(e), await new Promise((e, i) => {
298
+ let a = {
299
+ start: process.cwd(),
300
+ production: r,
301
+ json: !0,
302
+ files: "licenses/downloads",
303
+ relativeModulePath: !0,
304
+ relativeLicensePath: !0,
305
+ onlyAllow: t,
306
+ excludePackages: n.join(";"),
307
+ out: "licenses/licenses.json"
308
+ };
309
+ fe(a, (t) => {
310
+ t == null ? e() : i(t);
311
+ });
312
+ });
313
+ }
314
+ async function We() {
315
+ let e = await i("package-lock.json");
316
+ return e === null ? {} : JSON.parse(e).packages ?? {};
317
+ }
318
+ async function Ge() {
319
+ let e = await i(Re);
320
+ return e === null ? null : JSON.parse(e);
321
+ }
322
+ function Ke(e, t) {
323
+ let n = new Set(e.packages);
324
+ for (let r of e.external) {
325
+ let e = I(t, "", r);
326
+ if (e !== void 0) for (let r of [e, ...F(t, e)]) {
327
+ let e = t[r];
328
+ e?.version !== void 0 && n.add(P(r, e));
329
+ }
330
+ }
331
+ return n;
332
+ }
333
+ function qe(e) {
334
+ let t = /* @__PURE__ */ new Set();
335
+ for (let [n, r] of Object.entries(e)) n !== "" && r.version !== void 0 && t.add(P(n, r));
336
+ return [...t];
337
+ }
338
+ function Je(e, t) {
339
+ let n = [...e.difference(t)];
340
+ n.length > 0 && console.warn(`⚠️ Not installed, so not checked; rebuild to refresh the record: ${n.join(", ")}`);
341
+ }
342
+ function P(e, t) {
343
+ return `${t.name ?? e.slice(e.lastIndexOf("node_modules/") + 13)}@${String(t.version)}`;
344
+ }
345
+ function Ye(e) {
346
+ let t = F(e, ""), n = /* @__PURE__ */ new Set(), r = /* @__PURE__ */ new Set();
347
+ for (let [i, a] of Object.entries(e)) {
348
+ if (i === "" || a.version === void 0) continue;
349
+ let e = P(i, a);
350
+ t.has(i) ? n.add(e) : r.add(e);
301
351
  }
302
- return a.values().filter((e) => !r.has(e)).toArray();
303
- }
304
- function ze(e) {
305
- let t = /* @__PURE__ */ new Set(), n = [""];
306
- for (; n.length > 0;) {
307
- let r = n.pop() ?? "", i = e[r];
308
- if (i !== void 0) for (let a of Be(i)) {
309
- let i = Ve(e, r, a);
310
- i === void 0 || t.has(i) || (t.add(i), n.push(i));
352
+ return r.values().filter((e) => !n.has(e)).toArray();
353
+ }
354
+ function F(e, t) {
355
+ let n = /* @__PURE__ */ new Set(), r = [t];
356
+ for (; r.length > 0;) {
357
+ let t = r.pop() ?? "", i = e[t];
358
+ if (i !== void 0) for (let a of Xe(i)) {
359
+ let i = I(e, t, a);
360
+ i === void 0 || n.has(i) || (n.add(i), r.push(i));
311
361
  }
312
362
  }
313
- return t;
363
+ return n;
314
364
  }
315
- function Be(e) {
365
+ function Xe(e) {
316
366
  let t = Object.keys(e.peerDependencies ?? {}).filter((t) => e.peerDependenciesMeta?.[t]?.optional !== !0);
317
367
  return [
318
368
  ...Object.keys(e.dependencies ?? {}),
@@ -320,7 +370,7 @@ function Be(e) {
320
370
  ...t
321
371
  ];
322
372
  }
323
- function Ve(e, t, n) {
373
+ function I(e, t, n) {
324
374
  let r = t;
325
375
  for (;;) {
326
376
  let t = r === "" ? `node_modules/${n}` : `${r}/node_modules/${n}`, i = e[t];
@@ -330,13 +380,14 @@ function Ve(e, t, n) {
330
380
  r = a === -1 ? "" : r.slice(0, a);
331
381
  }
332
382
  }
333
- function He(e) {
334
- return `License data is updated each time \`npm run document\` is run, using [license-checker](https://github.com/RSeidelsohn/license-checker-rseidelsohn). The following table lists all production dependencies. These dependencies (including transitive ones) have been checked and confirmed to use ${Ue(e.split(";"))}, all of which allow commercial use. All are used unmodified, so any licence conditions that apply only to modified versions are not triggered. These checks cover the dependencies of the published library; developers cloning this repository should independently verify development dependencies.`;
383
+ function L(e, t) {
384
+ let n = Ze(e.split(";"));
385
+ return `License data is updated each time \`npm run document\` is run, using [license-checker](https://github.com/RSeidelsohn/license-checker-rseidelsohn). ${t ? "The following table lists every package whose code, styles or assets are included in this project's build, as recorded by the build itself. Modules loaded at run time are not included; each documents its own." : "The following table lists all production dependencies. This project has no build record, so the list is taken from its declared dependencies."} These dependencies have been checked and confirmed to use ${n}, all of which allow commercial use. All are used unmodified, so any licence conditions that apply only to modified versions are not triggered. Developers cloning this repository should independently verify development dependencies.`;
335
386
  }
336
- function Ue(e) {
387
+ function Ze(e) {
337
388
  return e.length === 1 ? e[0] ?? "" : e.length === 2 ? `${String(e[0])} or ${String(e[1])}` : `${e.slice(0, -1).join(", ")}, or ${String(e.at(-1))}`;
338
389
  }
339
- function We(e, t) {
390
+ function Qe(e, t) {
340
391
  let n = e.lastIndexOf("@"), r = n > 0 ? e.slice(0, n) : e, i = n > 0 ? e.slice(n + 1) : "";
341
392
  return {
342
393
  name: r,
@@ -350,7 +401,7 @@ function We(e, t) {
350
401
  ...t.licenseFile != null && { licenseFileLink: t.licenseFile }
351
402
  };
352
403
  }
353
- async function Ge(e, t) {
404
+ async function $e(e, t) {
354
405
  try {
355
406
  let n = await fetch(`https://registry.npmjs.org/${encodeURIComponent(e)}`);
356
407
  if (n.ok) {
@@ -368,27 +419,32 @@ async function Ge(e, t) {
368
419
  publishedDate: ""
369
420
  };
370
421
  }
371
- function Ke(e) {
422
+ function et(e) {
372
423
  let t = e.licenseFileLink == null || e.licenseFileLink === "" ? "⚠️ No license file" : `[LICENSE](licenses/${e.licenseFileLink})`;
373
424
  return `|[${e.name}](${e.repository})|${e.installedVersion}|${e.licenseTypes}|${t}|\n`;
374
425
  }
375
- function qe(e, t, n, r, i) {
426
+ function tt(e) {
427
+ let t = e.licenseFileLink == null || e.licenseFileLink === "" ? "⚠️ No license file" : `[LICENSE](licenses/${e.licenseFileLink})`;
428
+ return `|[${e.name}](${e.repository})|${e.installedVersion}|${z(e).replace(/^ — /, "")}|${e.licenseTypes}|${t}|\n`;
429
+ }
430
+ function R(e, t, n, r, i) {
376
431
  let a = " ".repeat(i);
377
432
  for (let [o, s] of Object.entries(e)) {
378
- let e = s.version ?? "";
433
+ if (s.version === void 0) continue;
434
+ let e = s.version;
379
435
  if (n.has(`${o}@${e}`)) continue;
380
- let c = t.get(`${o}@${e}`), l = c == null ? o : `[${o}](${c.repository})`, u = Je(c);
381
- r.push(`${a}- **${l}** ${e}${u}`), s.dependencies != null && qe(s.dependencies, t, n, r, i + 1);
436
+ let c = t.get(`${o}@${e}`), l = c == null ? o : `[${o}](${c.repository})`, u = z(c);
437
+ r.push(`${a}- **${l}** ${e}${u}`), s.dependencies != null && R(s.dependencies, t, n, r, i + 1);
382
438
  }
383
439
  }
384
- function Je(e) {
440
+ function z(e) {
385
441
  if (e == null) return "";
386
- let t = e.publishedDate ? Ye(e.publishedDate.split("T", 1)[0]) : "";
442
+ let t = e.publishedDate ? B(e.publishedDate.split("T", 1)[0]) : "";
387
443
  if (e.latestVersion === "" || e.latestVersion === e.installedVersion) return t === "" ? "" : ` — ${t}`;
388
- let n = e.latestPublishedDate ? Ye(e.latestPublishedDate.split("T", 1)[0]) : "", r = n === "" ? `**latest**: ${e.latestVersion} ❗` : `**latest**: ${e.latestVersion} — ${n} ❗`;
444
+ let n = e.latestPublishedDate ? B(e.latestPublishedDate.split("T", 1)[0]) : "", r = n === "" ? `**latest**: ${e.latestVersion} ❗` : `**latest**: ${e.latestVersion} — ${n} ❗`;
389
445
  return t === "" ? ` — → ${r}` : ` — ${t} → ${r}`;
390
446
  }
391
- function Ye(e) {
447
+ function B(e) {
392
448
  if (e == null || e === "") return "n/a";
393
449
  let t = e.split("T", 1)[0];
394
450
  if (t == null || t === "") return "n/a";
@@ -397,31 +453,31 @@ function Ye(e) {
397
453
  }
398
454
  //#endregion
399
455
  //#region src/actions/documentOpening.ts
400
- var Xe = "<!-- OPENING_START -->", Ze = "<!-- OPENING_END -->";
401
- async function Qe() {
456
+ var nt = "<!-- OPENING_START -->", rt = "<!-- OPENING_END -->";
457
+ async function it() {
402
458
  try {
403
- f("Document Opening"), x("1️⃣ Insert opening content into 'README.md'");
404
- let e = await c("package.json"), r = await c("config.json"), { owner: i, repo: a } = t(e, "document opening"), s = $e(e), l = tt(r), u = nt(i, a, s, _(r.id).publishedTo === "npm" ? et(e) : void 0, e.description, l);
405
- await n(u, Xe, Ze), o("Opening documented");
459
+ f("Document Opening"), b("1️⃣ Insert opening content into 'README.md'");
460
+ let e = await c("package.json"), r = await c("config.json"), { owner: i, repo: a } = t(e, "document opening"), s = at(e), l = st(r), u = ct(i, a, s, _(r.id).publishedTo === "npm" ? ot(e) : void 0, e.description, l);
461
+ await n(u, nt, rt), o("Opening documented");
406
462
  } catch (e) {
407
463
  console.error("❌ Error documenting opening", e), process.exit(1);
408
464
  }
409
465
  }
410
- function $e(e) {
466
+ function at(e) {
411
467
  let t = e.license;
412
468
  if (t == null || t === "") throw Error("package.json 'license' field is required to document opening.");
413
469
  return t;
414
470
  }
415
- function et(e) {
471
+ function ot(e) {
416
472
  let t = e.name;
417
473
  if (t == null || t === "") throw Error("package.json 'name' field is required to document opening.");
418
474
  return t;
419
475
  }
420
- function tt(e) {
476
+ function st(e) {
421
477
  let t = e.description.en?.trim();
422
478
  return t === void 0 || t === "" ? void 0 : t;
423
479
  }
424
- function nt(e, t, n, r, i, a) {
480
+ function ct(e, t, n, r, i, a) {
425
481
  let o = `https://github.com/${e}/${t}`;
426
482
  return `[![License: ${n}](https://img.shields.io/badge/License-${n.replaceAll("-", "--")}-blue.svg)](./LICENSE)
427
483
  [![DPUse version](https://img.shields.io/github/v/release/${e}/${t}?color=f6821f&label=DPUse)](${o}/releases/latest)${r === void 0 ? "" : `\n[![npm version](https://img.shields.io/npm/v/${r}?color=cb3837&label=npm)](https://www.npmjs.com/package/${r})`}
@@ -443,71 +499,71 @@ In addition, DPUse provides [Tools](https://www.dpuse.app) used by the applicati
443
499
  }
444
500
  //#endregion
445
501
  //#region src/actions/documentQualitySecurity.ts
446
- var rt = {
502
+ var V = {
447
503
  "Branch-Protection": 3,
448
504
  "Code-Review": 0,
449
505
  Contributors: 0
450
- }, it = /* @__PURE__ */ new Set(["CII-Best-Practices"]), at = "coverage/coverage-final.json", ot = "coverage/coverage-summary.json", N = 80, st = 60, P = "code-health-reports/vitest/badge.json", ct = {
506
+ }, lt = /* @__PURE__ */ new Set(["CII-Best-Practices"]), ut = "coverage/coverage-final.json", dt = "coverage/coverage-summary.json", H = 80, ft = 60, pt = "code-health-reports/vitest/badge.json", mt = {
451
507
  actions: "GitHub Actions",
452
508
  "javascript-typescript": "JavaScript/TypeScript",
453
509
  rust: "Rust"
454
- }, lt = {
510
+ }, ht = {
455
511
  A: "brightgreen",
456
512
  B: "green",
457
513
  C: "yellow",
458
514
  D: "orange",
459
515
  F: "red"
460
- }, F = `${m}/health.json`, ut = ae(oe);
461
- async function dt() {
516
+ }, gt = `${m}/health.json`, _t = ce(le);
517
+ async function vt() {
462
518
  try {
463
519
  f("Document Quality & Security");
464
- let e = await c("package.json"), r = await ft(e), i = await mt(e, r === void 0 ? [] : ["--coverage", at]), { owner: a, repo: s } = t(e, "document quality and security");
465
- x("4️⃣ Read security checks and settings");
466
- let l = await gt(a, s, e);
467
- x("5️⃣ Look up OpenSSF Best Practices badge and Scorecard results");
468
- let [u, d] = await Promise.all([_t(`https://github.com/${a}/${s}`), vt(`github.com/${a}/${s}`)]);
469
- x("6️⃣ Insert quality and security content into 'README.md'");
470
- let p = xt(a, s, {
520
+ let e = await c("package.json"), r = await yt(e), i = await xt(e, r === void 0 ? [] : ["--coverage", ut]), { owner: a, repo: s } = t(e, "document quality and security");
521
+ b("4️⃣ Read security checks and settings");
522
+ let l = await Ct(a, s, e);
523
+ b("5️⃣ Look up OpenSSF Best Practices badge and Scorecard results");
524
+ let [u, d] = await Promise.all([wt(`https://github.com/${a}/${s}`), Tt(`github.com/${a}/${s}`)]);
525
+ b("6️⃣ Insert quality and security content into 'README.md'");
526
+ let p = At(a, s, {
471
527
  coveragePercent: r,
472
528
  fallowHealth: i,
473
529
  securitySettings: l
474
530
  }, u, d);
475
- await w(), await n(p, ne, te), o("Quality & security documented");
531
+ await C(), await n(p, re, te), o("Quality & security documented");
476
532
  } catch (e) {
477
533
  console.error("❌ Error documenting quality and security", e), process.exit(1);
478
534
  }
479
535
  }
480
- async function ft(e) {
536
+ async function yt(e) {
481
537
  if (e.devDependencies?.["@vitest/coverage-v8"] == null) {
482
- x("1️⃣ Test coverage NOT measured, as '@vitest/coverage-v8' is not installed");
538
+ b("1️⃣ Test coverage NOT measured, as '@vitest/coverage-v8' is not installed");
483
539
  return;
484
540
  }
485
- await S("1️⃣ Measure test coverage", "vitest", [
541
+ await x("1️⃣ Measure test coverage", "vitest", [
486
542
  "run",
487
543
  "--passWithNoTests",
488
544
  "--coverage"
489
545
  ]);
490
- let t = await i(ot);
546
+ let t = await i(dt);
491
547
  if (t === null) return;
492
548
  let n = JSON.parse(t).total.lines.pct;
493
- return await pt(n), n;
549
+ return await bt(n), n;
494
550
  }
495
- async function pt(e) {
551
+ async function bt(e) {
496
552
  let t = [
497
553
  "red",
498
554
  "yellow",
499
555
  "brightgreen"
500
- ], n = Number(e >= st) + Number(e >= N);
501
- await r(P, {
556
+ ], n = Number(e >= ft) + Number(e >= H);
557
+ await r(pt, {
502
558
  schemaVersion: 1,
503
559
  label: "coverage",
504
560
  message: `${e.toFixed(1)}%`,
505
561
  color: t[n]
506
562
  });
507
563
  }
508
- async function mt(e, t) {
564
+ async function xt(e, t) {
509
565
  if (e.devDependencies?.fallow == null) {
510
- x("2️⃣ Code health NOT measured, as Fallow is not installed"), x("3️⃣ Code health report NOT required");
566
+ b("2️⃣ Code health NOT measured, as Fallow is not installed"), b("3️⃣ Code health report NOT required");
511
567
  return;
512
568
  }
513
569
  await a("2️⃣ Measure code health", "fallow", [
@@ -516,33 +572,33 @@ async function mt(e, t) {
516
572
  "--format",
517
573
  "json",
518
574
  ...t
519
- ], F), await a("3️⃣ Write code health report", "fallow", ["--format", "markdown"], s, !0);
520
- let n = await c(F);
521
- return await ht(n), n;
575
+ ], gt), await a("3️⃣ Write code health report", "fallow", ["--format", "markdown"], s, !0);
576
+ let n = await c(gt);
577
+ return await St(n), n;
522
578
  }
523
- async function ht(e) {
579
+ async function St(e) {
524
580
  let { score: t, grade: n } = e.health_score;
525
- await r(y, {
581
+ await r(ne, {
526
582
  schemaVersion: 1,
527
583
  label: "fallow",
528
584
  message: `${n} (${String(Math.round(t))})`,
529
- color: lt[n] ?? "lightgrey"
585
+ color: ht[n] ?? "lightgrey"
530
586
  });
531
587
  }
532
- async function gt(e, t, n) {
588
+ async function Ct(e, t, n) {
533
589
  let [r, a, o, s] = await Promise.all([
534
590
  i(".github/workflows/ci.yml"),
535
591
  i(".github/workflows/codeql.yml"),
536
592
  i(".github/dependabot.yml"),
537
593
  i(l)
538
594
  ]), [c, u, d, f] = await Promise.all([
539
- I(`repos/${e}/${t}`),
540
- I(`repos/${e}/${t}/private-vulnerability-reporting`),
541
- I(`repos/${e}/${t}/vulnerability-alerts`),
542
- I(`repos/${e}/${t}/commits/main/check-runs?per_page=100`)
595
+ U(`repos/${e}/${t}`),
596
+ U(`repos/${e}/${t}/private-vulnerability-reporting`),
597
+ U(`repos/${e}/${t}/vulnerability-alerts`),
598
+ U(`repos/${e}/${t}/commits/main/check-runs?per_page=100`)
543
599
  ]), p = c === void 0 ? void 0 : JSON.parse(c).security_and_analysis, m = (e) => p?.[e] === void 0 ? void 0 : p[e].status === "enabled", h = new Set((f === void 0 ? [] : JSON.parse(f).check_runs).map((e) => e.app?.slug)), g = o?.match(/package-ecosystem:/g)?.length ?? 0, _ = o?.match(/open-pull-requests-limit: 0\b/g)?.length ?? 0;
544
600
  return {
545
- codeQLLanguages: (a ?? "").matchAll(/- language: ([\w-]+)/g).filter(([, e]) => e !== "rust" || s !== null).map(([, e = ""]) => ct[e] ?? e).toArray(),
601
+ codeQLLanguages: (a ?? "").matchAll(/- language: ([\w-]+)/g).filter(([, e]) => e !== "rust" || s !== null).map(([, e = ""]) => mt[e] ?? e).toArray(),
546
602
  codeQLQueries: /queries: ([\w-]+)/.exec(a ?? "")?.[1],
547
603
  dependabotAlerts: d !== void 0,
548
604
  dependabotSecurityUpdates: m("dependabot_security_updates"),
@@ -559,37 +615,37 @@ async function gt(e, t, n) {
559
615
  testsInCI: r?.includes("npm test") ?? !1
560
616
  };
561
617
  }
562
- async function I(e) {
618
+ async function U(e) {
563
619
  try {
564
- let { stdout: t } = await ut("gh", ["api", e]);
620
+ let { stdout: t } = await _t("gh", ["api", e]);
565
621
  return t;
566
622
  } catch (e) {
567
623
  if (String(e.stderr).includes("HTTP 404")) return;
568
624
  throw e;
569
625
  }
570
626
  }
571
- async function _t(e) {
627
+ async function wt(e) {
572
628
  let t = await fetch(`https://www.bestpractices.dev/projects.json?url=${encodeURIComponent(e)}`);
573
629
  if (!t.ok) throw Error(`OpenSSF Best Practices lookup failed with status ${String(t.status)}.`);
574
630
  return (await t.json()).find((t) => t.repo_url === e)?.id;
575
631
  }
576
- async function vt(e) {
632
+ async function Tt(e) {
577
633
  let t = await fetch(`https://api.scorecard.dev/projects/${e}`);
578
634
  if (t.status !== 404) {
579
635
  if (!t.ok) throw Error(`OpenSSF Scorecard lookup failed with status ${String(t.status)}.`);
580
636
  return await t.json();
581
637
  }
582
638
  }
583
- function yt(e) {
584
- return e.checks.every(({ name: e, score: t }) => t === -1 || t === 10 || it.has(e) || rt[e] !== void 0 && t >= rt[e]);
639
+ function Et(e) {
640
+ return e.checks.every(({ name: e, score: t }) => t === -1 || t === 10 || lt.has(e) || V[e] !== void 0 && t >= V[e]);
585
641
  }
586
- function L(e) {
642
+ function Dt(e) {
587
643
  return e === !1 ? " These are handled manually." : "";
588
644
  }
589
- function R(e) {
645
+ function W(e) {
590
646
  return e === void 0 ? "❔ Unknown" : e ? "✅ On" : "❌ Off";
591
647
  }
592
- function z(e, t) {
648
+ function G(e, t) {
593
649
  return t.length === 0 ? "" : `### ${e}
594
650
 
595
651
  |Check|Status|What it does|
@@ -598,90 +654,90 @@ ${t.map((e) => `|${e.join("|")}|`).join("\n")}
598
654
 
599
655
  `;
600
656
  }
601
- function B(e, t, n, r) {
657
+ function Ot(e, t, n, r) {
602
658
  return `![${n}](https://img.shields.io/endpoint?url=${encodeURIComponent(`https://raw.githubusercontent.com/${e}/${t}/main/${r}`)})`;
603
659
  }
604
- function bt(e, t, { coveragePercent: n, fallowHealth: r, securitySettings: i }) {
660
+ function kt(e, t, { coveragePercent: n, fallowHealth: r, securitySettings: i }) {
605
661
  let a = `https://github.com/${e}/${t}`, o = (e) => e ? ` Part of the [CI workflow](${a}/actions/workflows/ci.yml) on every push and pull request to \`main\`.` : "", c = [[
606
662
  "Unit tests",
607
- R(i.testsInCI),
663
+ W(i.testsInCI),
608
664
  `[Vitest](https://vitest.dev) runs the unit tests.${o(i.testsInCI)}`
609
665
  ], [
610
666
  "Property-based tests",
611
- R(i.propertyTests),
667
+ W(i.propertyTests),
612
668
  `[fast-check](https://fast-check.dev) runs many random inputs per test to find edge cases, alongside the unit tests.${o(i.propertyTests && i.testsInCI)}`
613
669
  ]];
614
670
  n !== void 0 && c.push([
615
671
  "Test coverage",
616
- R(!0),
617
- `${B(e, t, "Coverage", P)} [Vitest's V8 coverage](https://vitest.dev/guide/coverage) measures the share of source lines the unit tests run. The target is ${String(N)}%.`
672
+ W(!0),
673
+ `${Ot(e, t, "Coverage", pt)} [Vitest's V8 coverage](https://vitest.dev/guide/coverage) measures the share of source lines the unit tests run. The target is ${String(H)}%.`
618
674
  ]);
619
675
  let l = `[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=${e}_${t}&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=${e}_${t}) `, u = [[
620
676
  "Code analysis",
621
- R(i.sonarCloud),
677
+ W(i.sonarCloud),
622
678
  `${i.sonarCloud ? l : ""}[SonarCloud](https://sonarcloud.io) checks every push for bugs, code smells and vulnerabilities.`
623
679
  ], [
624
680
  "Linting",
625
- R(i.lintInCI),
681
+ W(i.lintInCI),
626
682
  `[ESLint](https://eslint.org) checks the code for errors and style problems.${o(i.lintInCI)}`
627
683
  ]];
628
684
  r !== void 0 && u.unshift([
629
685
  "Code health",
630
- R(!0),
631
- `[${B(e, t, "Fallow code health", y)}](./${s}) [Fallow](https://github.com/fallow-rs/fallow) finds unused code, duplication, complexity and dependency problems.`
686
+ W(!0),
687
+ `[${Ot(e, t, "Fallow code health", ne)}](./${s}) [Fallow](https://github.com/fallow-rs/fallow) finds unused code, duplication, complexity and dependency problems.`
632
688
  ]);
633
689
  let d = i.codeQLLanguages.length > 0, f = `[![CodeQL](${a}/actions/workflows/codeql.yml/badge.svg)](${a}/security/code-scanning) `, p = i.codeQLQueries === "security-extended" ? "using the extended security queries" : "using the default queries", m = d ? ` ${i.codeQLLanguages.join(" and ")}` : "", h = [
634
690
  [
635
691
  "Push protection",
636
- R(i.pushProtection),
692
+ W(i.pushProtection),
637
693
  "[GitHub push protection](https://docs.github.com/en/code-security/secret-scanning/push-protection-for-repositories-and-organizations) blocks pushes that contain credentials."
638
694
  ],
639
695
  [
640
696
  "Static analysis",
641
- R(d),
697
+ W(d),
642
698
  `${d ? f : ""}[CodeQL](https://codeql.github.com) scans${m} for security vulnerabilities, ${p}, on every push and pull request to \`main\` and weekly.`
643
699
  ],
644
700
  [
645
701
  "Secret scanning",
646
- R(i.secretScanning),
702
+ W(i.secretScanning),
647
703
  "[GitHub secret scanning](https://docs.github.com/en/code-security/secret-scanning) detects credentials, such as API keys and tokens, committed to the repository."
648
704
  ]
649
705
  ], g = "[Dependabot](https://docs.github.com/en/code-security/dependabot)", _ = [
650
706
  [
651
707
  "Vulnerability audit",
652
- R(i.npmAuditInCI),
708
+ W(i.npmAuditInCI),
653
709
  i.npmAuditLevel === void 0 ? `[npm audit](https://docs.npmjs.com/cli/commands/npm-audit) fails when a shipped dependency has any known vulnerability, or a development dependency has a high or critical one.${o(i.npmAuditInCI)}` : `[npm audit](https://docs.npmjs.com/cli/commands/npm-audit) fails when a dependency has a known vulnerability of ${i.npmAuditLevel} severity or above.${o(i.npmAuditInCI)}`
654
710
  ],
655
711
  [
656
712
  "Supply chain risk",
657
- R(i.socket),
713
+ W(i.socket),
658
714
  "[Socket](https://socket.dev) flags malicious packages, typosquatting and suspicious behaviour that may not yet have a CVE."
659
715
  ],
660
716
  [
661
717
  "Security alerts",
662
- R(i.dependabotAlerts),
718
+ W(i.dependabotAlerts),
663
719
  `${g} alerts when a dependency has a known vulnerability, using the GitHub Advisory Database.`
664
720
  ],
665
721
  [
666
722
  "Security updates",
667
- R(i.dependabotSecurityUpdates),
668
- `${g} opens pull requests that update vulnerable dependencies.${L(i.dependabotSecurityUpdates)}`
723
+ W(i.dependabotSecurityUpdates),
724
+ `${g} opens pull requests that update vulnerable dependencies.${Dt(i.dependabotSecurityUpdates)}`
669
725
  ],
670
726
  [
671
727
  "Version updates",
672
- R(i.dependabotVersionUpdates),
673
- `${g} opens pull requests for new dependency versions.${L(i.dependabotVersionUpdates)}`
728
+ W(i.dependabotVersionUpdates),
729
+ `${g} opens pull requests for new dependency versions.${Dt(i.dependabotVersionUpdates)}`
674
730
  ]
675
731
  ];
676
732
  return `This section is updated each time \`npm run document\` is run. Settings come from the repository's workflow files and GitHub. Test coverage and the Fallow score are measured at the same time.
677
733
 
678
- ${z("Testing", c)}${z("Code Quality", u)}${z("Security Analysis", h)}${z("Dependencies", _)}`;
734
+ ${G("Testing", c)}${G("Code Quality", u)}${G("Security Analysis", h)}${G("Dependencies", _)}`;
679
735
  }
680
- function xt(e, t, n, r, i) {
681
- let a = `https://github.com/${e}/${t}`, o = `github.com/${e}/${t}`, s = `https://www.bestpractices.dev/projects/${String(r)}`, c = i !== void 0 && yt(i) ? "\n\n> [!NOTE]\n> Apart from the Best Practices badge above, the remaining Scorecard gaps need multi-person review or a pull-request workflow, which this solo-maintained project doesn't use." : "", l = r === void 0 ? "" : `[![OpenSSF Best Practices](${s}/badge)](${s})\n`, u = n.securitySettings.privateVulnerabilityReporting === !0 ? `Use [GitHub private vulnerability reporting](${a}/security/advisories/new) instead. See [SECURITY.md](./SECURITY.md) for the full disclosure policy, contact details, and expected response times.` : "See [SECURITY.md](./SECURITY.md) for how to report one privately, the full disclosure policy, and expected response times.";
736
+ function At(e, t, n, r, i) {
737
+ let a = `https://github.com/${e}/${t}`, o = `github.com/${e}/${t}`, s = `https://www.bestpractices.dev/projects/${String(r)}`, c = i !== void 0 && Et(i) ? "\n\n> [!NOTE]\n> Apart from the Best Practices badge above, the remaining Scorecard gaps need multi-person review or a pull-request workflow, which this solo-maintained project doesn't use." : "", l = r === void 0 ? "" : `[![OpenSSF Best Practices](${s}/badge)](${s})\n`, u = n.securitySettings.privateVulnerabilityReporting === !0 ? `Use [GitHub private vulnerability reporting](${a}/security/advisories/new) instead. See [SECURITY.md](./SECURITY.md) for the full disclosure policy, contact details, and expected response times.` : "See [SECURITY.md](./SECURITY.md) for how to report one privately, the full disclosure policy, and expected response times.";
682
738
  return `## Quality & Security
683
739
 
684
- ${bt(e, t, n)}### OpenSSF 🚧
740
+ ${kt(e, t, n)}### OpenSSF 🚧
685
741
 
686
742
  ${l}[![OpenSSF Scorecard](https://api.scorecard.dev/projects/${o}/badge)](https://scorecard.dev/viewer/?uri=${o})
687
743
 
@@ -693,37 +749,37 @@ Please do not open public GitHub issues for security vulnerabilities. ${u}`;
693
749
  }
694
750
  //#endregion
695
751
  //#region src/actions/documentUsage.ts
696
- var St = "<!-- USAGE_START -->", Ct = "<!-- USAGE_END -->", wt = /* @__PURE__ */ new Set([
752
+ var jt = "<!-- USAGE_START -->", Mt = "<!-- USAGE_END -->", Nt = /* @__PURE__ */ new Set([
697
753
  "connector",
698
754
  "cookbook",
699
755
  "presenter"
700
- ]), Tt = /* @__PURE__ */ new Set(["development", "eslint"]), Et = "> [!WARNING]\n> This project is not designed for general use. It is custom built for the DPUse CI/CD process. You are welcome to clone and customise it for your own purposes, but you will need to adapt it to your own project structure and tooling.", Dt = "This repository manages itself using the actions it implements.", Ot = "This repository is managed using the common set of actions provided by [@dpuse/dpuse-development](https://github.com/dpuse/dpuse-development).";
701
- async function kt() {
756
+ ]), Pt = /* @__PURE__ */ new Set(["development", "eslint"]), Ft = "> [!WARNING]\n> This project is not designed for general use. It is custom built for the DPUse CI/CD process. You are welcome to clone and customise it for your own purposes, but you will need to adapt it to your own project structure and tooling.", It = "This repository manages itself using the actions it implements.", Lt = "This repository is managed using the common set of actions provided by [@dpuse/dpuse-development](https://github.com/dpuse/dpuse-development).";
757
+ async function Rt() {
702
758
  try {
703
- f("Document Usage"), x("1️⃣ Insert usage content into 'README.md'");
704
- let [e, t] = await Promise.all([c("package.json"), c("config.json")]), r = At(e), i = jt(r), a = V(e.engines?.node), s = V(e.engines?.npm), l = V(e.devDependencies?.typescript), u = Mt(_(t.id), e.name), d = `${r.replace(/\.git$/, "")}/blob/main/package.json`, p = Nt(u, r, i, a, s, l, `${e.name === "@dpuse/dpuse-development" ? Dt : Ot} See the \`scripts\` block in [package.json](${d}) for details.`);
705
- await n(p, St, Ct), o("Usage documented");
759
+ f("Document Usage"), b("1️⃣ Insert usage content into 'README.md'");
760
+ let [e, t] = await Promise.all([c("package.json"), c("config.json")]), r = zt(e), i = Bt(r), a = K(e.engines?.node), s = K(e.engines?.npm), l = K(e.devDependencies?.typescript), u = Vt(_(t.id), e.name), d = `${r.replace(/\.git$/, "")}/blob/main/package.json`, p = Ht(u, r, i, a, s, l, `${e.name === "@dpuse/dpuse-development" ? It : Lt} See the \`scripts\` block in [package.json](${d}) for details.`);
761
+ await n(p, jt, Mt), o("Usage documented");
706
762
  } catch (e) {
707
763
  console.error("❌ Error documenting usage", e), process.exit(1);
708
764
  }
709
765
  }
710
- function At(e) {
766
+ function zt(e) {
711
767
  let t = e.repository, n = typeof t == "string" ? t : t?.url;
712
768
  if (n == null || n === "") throw Error("package.json 'repository' field is required to document usage.");
713
769
  return n.replace(/^git\+/, "");
714
770
  }
715
- function jt(e) {
771
+ function Bt(e) {
716
772
  return (e.split("/").at(-1) ?? "").replace(/\.git$/, "");
717
773
  }
718
- function V(e) {
774
+ function K(e) {
719
775
  if (e == null) throw Error("package.json version range is required to document usage.");
720
776
  let t = /\d+(?:\.\d+)*/.exec(e);
721
777
  if (t == null) throw Error(`Unable to parse version from '${e}'.`);
722
778
  return t[0];
723
779
  }
724
- function Mt(e, t) {
780
+ function Vt(e, t) {
725
781
  let { typeId: n } = e;
726
- if (wt.has(n)) return `This ${n} is automatically uploaded to the DPUse Engine cloud once released and becomes instantly available to all new browser app instances, with existing instances notified of the update.
782
+ if (Nt.has(n)) return `This ${n} is automatically uploaded to the DPUse Engine cloud once released and becomes instantly available to all new browser app instances, with existing instances notified of the update.
727
783
 
728
784
  You may view or clone this repository for your own purposes, such as building a new, similar ${n}, though there is currently no process to accept third-party ${n}s into DPUse at this stage.`;
729
785
  if (e.publishedTo === "npm") {
@@ -734,11 +790,11 @@ You may view or clone this repository for your own purposes, such as building a
734
790
  npm install ${t}
735
791
  \`\`\`
736
792
 
737
- ${Tt.has(n) ? `${Et}\n\n` : ""}To work on the source instead, clone this repository.`;
793
+ ${Pt.has(n) ? `${Ft}\n\n` : ""}To work on the source instead, clone this repository.`;
738
794
  }
739
795
  return "You may view or clone this repository for your own purposes.";
740
796
  }
741
- function Nt(e, t, n, r, i, a, o) {
797
+ function Ht(e, t, n, r, i, a, o) {
742
798
  return `## Usage
743
799
 
744
800
  ${e}
@@ -755,102 +811,102 @@ ${o}`;
755
811
  }
756
812
  //#endregion
757
813
  //#region src/actions/documentApiReference.ts
758
- var H = "API_REFERENCE.md";
759
- async function Pt() {
814
+ var q = "API_REFERENCE.md";
815
+ async function Ut() {
760
816
  try {
761
817
  f("Document API Reference");
762
818
  let { writeAPIReference: e } = await import("./apiReference-Fj5_02JP.js");
763
- await e("1️⃣ ", H), o("API reference documented");
819
+ await e("1️⃣ ", q), o("API reference documented");
764
820
  } catch (e) {
765
821
  console.error("❌ Error documenting API reference", e), process.exit(1);
766
822
  }
767
823
  }
768
824
  //#endregion
769
825
  //#region src/actions/documentBundleSizes.ts
770
- var U = "bundle-analysis-reports/sonda/index.json", Ft = "<!-- BUNDLE_START -->", It = "<!-- BUNDLE_END -->", W = "&nbsp;&nbsp;&nbsp;&nbsp;", G = 20, K = "█", q = "▒", Lt = 100 / G / 2, Rt = 100 / G, zt = "This report is updated with each release, from the bundle the release builds, using [Sonda](https://sonda.dev/), which analyses final source maps to reveal the actual effects of tree-shaking and minification rather than relying on pre-build estimates.\n\n_Note: Sonda's Vite reports currently exclude CSS files, since Vite does not generate source maps for CSS._", J = "Bars show each row's share of its output file.", Bt = "↳ rows are part of the row above.", Y = "(bundler output, whitespace & JSON)", Vt = `${Y} = bytes Sonda can't trace to a source file: whitespace (indentation and line breaks), code the bundler generates (region comments, the combined import/export lines, its small runtime helper and wrappers), and imported JSON such as \`config.json\`, which the bundler doesn't map. The JSON and the generated code are real bytes that ship; the whitespace mostly disappears once compressed.`;
771
- async function Ht(e) {
826
+ var Wt = "bundle-analysis-reports/sonda/index.json", Gt = "<!-- BUNDLE_START -->", Kt = "<!-- BUNDLE_END -->", J = "&nbsp;&nbsp;&nbsp;&nbsp;", Y = 20, qt = "█", Jt = "▒", Yt = 100 / Y / 2, Xt = 100 / Y, Zt = "This report is updated with each release, from the bundle the release builds, using [Sonda](https://sonda.dev/), which analyses final source maps to reveal the actual effects of tree-shaking and minification rather than relying on pre-build estimates.\n\n_Note: Sonda's Vite reports currently exclude CSS files, since Vite does not generate source maps for CSS._", Qt = "Bars show each row's share of its output file.", $t = "↳ rows are part of the row above.", X = "(bundler output, whitespace & JSON)", en = `${X} = bytes Sonda can't trace to a source file: whitespace (indentation and line breaks), code the bundler generates (region comments, the combined import/export lines, its small runtime helper and wrappers), and imported JSON such as \`config.json\`, which the bundler doesn't map. The JSON and the generated code are real bytes that ship; the whitespace mostly disappears once compressed.`;
827
+ async function tn(e) {
772
828
  try {
773
- f("Document Bundle Sizes"), x("1️⃣ Read bundle analysis report");
774
- let t = await c(U);
775
- x("2️⃣ Insert table into 'README.md'");
776
- let r = Ut(t, e?.moduleLevel ?? !1), i = r.includes("↳") ? `${J} ${Bt}` : J;
777
- await n(`## Bundle Analysis\n\n${zt}\n\n${r}\n\n${i}\n\n${Vt}`, Ft, It), o("Bundle sizes documented");
829
+ f("Document Bundle Sizes"), b("1️⃣ Read bundle analysis report");
830
+ let t = await c(Wt);
831
+ b("2️⃣ Insert table into 'README.md'");
832
+ let r = nn(t, e?.moduleLevel ?? !1), i = r.includes("↳") ? `${Qt} ${$t}` : Qt;
833
+ await n(`## Bundle Analysis\n\n${Zt}\n\n${r}\n\n${i}\n\n${en}`, Gt, Kt), o("Bundle sizes documented");
778
834
  } catch (e) {
779
835
  console.error("❌ Error documenting bundle sizes", e), process.exit(1);
780
836
  }
781
837
  }
782
- function Ut(e, t) {
783
- let n = Xt(e), r = n.values().flatMap((e) => e.values().toArray()).reduce((e, t) => e + t.sizes.uncompressed, 0), i = e.resources.filter((e) => e.kind === "asset").map((e) => [e.name, Q(e)]).toSorted((e, t) => t[1].uncompressed - e[1].uncompressed), a = ["|Chunk/Module/File|Composition|", "|:------ |:-----------|"];
838
+ function nn(e, t) {
839
+ let n = un(e), r = n.values().flatMap((e) => e.values().toArray()).reduce((e, t) => e + t.sizes.uncompressed, 0), i = e.resources.filter((e) => e.kind === "asset").map((e) => [e.name, hn(e)]).toSorted((e, t) => t[1].uncompressed - e[1].uncompressed), a = ["|Chunk/Module/File|Composition|", "|:------ |:-----------|"];
784
840
  for (let [e, o] of i) {
785
- let i = [...n.get(e) ?? /* @__PURE__ */ new Map()].toSorted(Wt), s = i.reduce((e, [, t]) => e + t.sizes.uncompressed, 0), c = s > 0 && r > 0 ? ` · ${an(s, r)} of the build` : "";
786
- a.push(`| **${e}** | ${en(o)}${c} |`, ...Gt(i, s, t));
841
+ let i = [...n.get(e) ?? /* @__PURE__ */ new Map()].toSorted(rn), s = i.reduce((e, [, t]) => e + t.sizes.uncompressed, 0), c = s > 0 && r > 0 ? ` · ${bn(s, r)} of the build` : "";
842
+ a.push(`| **${e}** | ${gn(o)}${c} |`, ...an(i, s, t));
787
843
  }
788
844
  return a.join("\n");
789
845
  }
790
- function Wt(e, t) {
791
- return e[0] === Y == (t[0] === Y) ? t[1].sizes.uncompressed - e[1].sizes.uncompressed : e[0] === Y ? 1 : -1;
846
+ function rn(e, t) {
847
+ return e[0] === X == (t[0] === X) ? t[1].sizes.uncompressed - e[1].sizes.uncompressed : e[0] === X ? 1 : -1;
792
848
  }
793
- function Gt(e, t, n) {
849
+ function an(e, t, n) {
794
850
  let r = [];
795
851
  for (let [i, { sizes: a, files: o }] of e) {
796
852
  if (o.size === 1) {
797
- let e = Yt(o);
798
- r.push(`| ${W}${Jt(i, e)} | ${X(a.uncompressed, t)} |`);
853
+ let e = ln(o);
854
+ r.push(`| ${J}${cn(i, e)} | ${Z(a.uncompressed, t)} |`);
799
855
  continue;
800
856
  }
801
- r.push(`| ${W}${i} | ${X(a.uncompressed, t)} |`), n || r.push(...Kt(o, t));
857
+ r.push(`| ${J}${i} | ${Z(a.uncompressed, t)} |`), n || r.push(...on(o, t));
802
858
  }
803
859
  return r;
804
860
  }
805
- function Kt(e, t) {
806
- let n = [...e].toSorted((e, t) => t[1].uncompressed - e[1].uncompressed), r = qt(n, t), i = (r > 0 ? n.slice(0, -r) : n).map(([e, n]) => `| ${W}${W}↳ ${e} | ${X(n.uncompressed, t, q)} |`);
861
+ function on(e, t) {
862
+ let n = [...e].toSorted((e, t) => t[1].uncompressed - e[1].uncompressed), r = sn(n, t), i = (r > 0 ? n.slice(0, -r) : n).map(([e, n]) => `| ${J}${J}↳ ${e} | ${Z(n.uncompressed, t, Jt)} |`);
807
863
  if (r > 0) {
808
864
  let e = n.slice(-r).reduce((e, [, t]) => e + t.uncompressed, 0);
809
- i.push(`| ${W}${W}↳ ${String(r)} smaller files | ${X(e, t, q)} |`);
865
+ i.push(`| ${J}${J}↳ ${String(r)} smaller files | ${Z(e, t, Jt)} |`);
810
866
  }
811
867
  return i;
812
868
  }
813
- function qt(e, t) {
869
+ function sn(e, t) {
814
870
  if (t <= 0) return 0;
815
871
  let n = 0, r = 0;
816
872
  for (let [, i] of e.toReversed()) {
817
- let e = i.uncompressed / t * 100 < Lt, a = (r + i.uncompressed) / t * 100 <= Rt;
873
+ let e = i.uncompressed / t * 100 < Yt, a = (r + i.uncompressed) / t * 100 <= Xt;
818
874
  if (!e || !a) break;
819
875
  n++, r += i.uncompressed;
820
876
  }
821
877
  return n >= 2 ? n : 0;
822
878
  }
823
- function X(e, t, n = K) {
824
- return `${tn(t > 0 ? e / t * 100 : 0, n)} · ${$(e)}`;
879
+ function Z(e, t, n = qt) {
880
+ return `${_n(t > 0 ? e / t * 100 : 0, n)} · ${Q(e)}`;
825
881
  }
826
- function Jt(e, t) {
882
+ function cn(e, t) {
827
883
  return t === "" ? e : `${e} → ${t}`;
828
884
  }
829
- function Yt(e) {
885
+ function ln(e) {
830
886
  let [t] = e.keys();
831
887
  if (t === void 0) throw Error("Expected exactly one file");
832
888
  return t;
833
889
  }
834
- function Xt(e) {
835
- let t = Zt(e.dependencies), n = /* @__PURE__ */ new Map();
890
+ function un(e) {
891
+ let t = dn(e.dependencies), n = /* @__PURE__ */ new Map();
836
892
  for (let r of e.resources) {
837
893
  if (r.kind !== "chunk" || !r.parent) continue;
838
- let { group: e, file: i } = Qt(r.name, t), a = Q(r), o = n.get(r.parent) ?? /* @__PURE__ */ new Map();
894
+ let { group: e, file: i } = fn(r.name, t), a = hn(r), o = n.get(r.parent) ?? /* @__PURE__ */ new Map();
839
895
  n.set(r.parent, o);
840
896
  let s = o.get(e) ?? {
841
- sizes: nn(),
897
+ sizes: vn(),
842
898
  files: /* @__PURE__ */ new Map()
843
899
  };
844
- o.set(e, s), rn(s.sizes, a);
845
- let c = s.files.get(i) ?? nn();
846
- s.files.set(i, c), rn(c, a);
900
+ o.set(e, s), yn(s.sizes, a);
901
+ let c = s.files.get(i) ?? vn();
902
+ s.files.set(i, c), yn(c, a);
847
903
  }
848
904
  return n;
849
905
  }
850
- function Zt(e) {
906
+ function dn(e) {
851
907
  return e.flatMap((e) => e.paths.map((t) => [t, e.name])).toSorted((e, t) => t[0].length - e[0].length);
852
908
  }
853
- function Qt(e, t) {
909
+ function fn(e, t) {
854
910
  let n = t.find(([t]) => e === t || e.startsWith(`${t}/`));
855
911
  if (n) {
856
912
  let [t, r] = n;
@@ -860,65 +916,65 @@ function Qt(e, t) {
860
916
  };
861
917
  }
862
918
  return e === "[unassigned]" ? {
863
- group: Y,
919
+ group: X,
864
920
  file: ""
865
921
  } : e.startsWith("\0") ? {
866
922
  group: "(runtime)",
867
923
  file: e.slice(1)
868
924
  } : e.startsWith("rust/") ? {
869
925
  group: "wasm",
870
- file: $t(e)
926
+ file: pn(e)
871
927
  } : {
872
928
  group: "src",
873
- file: Z(e)
929
+ file: mn(e)
874
930
  };
875
931
  }
876
- function $t(e) {
877
- let t = e.split("/", 2)[1] ?? "", n = Z(e);
932
+ function pn(e) {
933
+ let t = e.split("/", 2)[1] ?? "", n = mn(e);
878
934
  return t !== "" && n.startsWith(t) ? `…${n.slice(t.length)}` : n;
879
935
  }
880
- function Z(e) {
936
+ function mn(e) {
881
937
  return e.split("/").at(-1) ?? e;
882
938
  }
883
- function Q(e) {
939
+ function hn(e) {
884
940
  return {
885
941
  uncompressed: e.uncompressed,
886
942
  gzip: e.gzip ?? 0
887
943
  };
888
944
  }
889
- function en(e) {
890
- return `${$(e.uncompressed)} · gzip ${$(e.gzip)}`;
945
+ function gn(e) {
946
+ return `${Q(e.uncompressed)} · gzip ${Q(e.gzip)}`;
891
947
  }
892
- function tn(e, t = K) {
893
- let n = Math.round(e / 100 * G);
894
- return `\`${t.repeat(n)}${"░".repeat(G - n)}\` ${e.toFixed(1)}%`;
948
+ function _n(e, t = qt) {
949
+ let n = Math.round(e / 100 * Y);
950
+ return `\`${t.repeat(n)}${"░".repeat(Y - n)}\` ${e.toFixed(1)}%`;
895
951
  }
896
- function nn() {
952
+ function vn() {
897
953
  return {
898
954
  uncompressed: 0,
899
955
  gzip: 0
900
956
  };
901
957
  }
902
- function rn(e, t) {
958
+ function yn(e, t) {
903
959
  e.uncompressed += t.uncompressed, e.gzip += t.gzip;
904
960
  }
905
- function an(e, t) {
961
+ function bn(e, t) {
906
962
  return `${(e / t * 100).toFixed(1)}%`;
907
963
  }
908
- function $(e) {
964
+ function Q(e) {
909
965
  return e < 1024 ? `${String(e)} B` : `${(e / 1024).toFixed(1)} kB`;
910
966
  }
911
967
  //#endregion
912
968
  //#region src/actions/documentProject.ts
913
- async function on(e = "MIT", t = !1) {
969
+ async function xn(e = "MIT", t = !1) {
914
970
  try {
915
971
  let n = await c("config.json"), r = _(n.id).typeId === "connector";
916
- await Qe(), r && await ke(), await kt(), await Fe(e), await i("bundle-analysis-reports/sonda/index.json") === null ? x(`ℹ️ Bundle sizes NOT documented, as there is no '${U}' yet. Build the project first.`) : await Ht({ moduleLevel: t }), await dt(), await Ae();
917
- let a = await i(H) !== null;
918
- a ? await Pt() : x(`ℹ️ '${H}' NOT required by this project`), await S("ℹ️ Format generated files", "prettier", [
972
+ await it(), r && await Ne(), await Rt(), await Be(e), await i("bundle-analysis-reports/sonda/index.json") === null ? b(`ℹ️ Bundle sizes NOT documented, as there is no '${Wt}' yet. Build the project first.`) : await tn({ moduleLevel: t }), await vt(), await Pe();
973
+ let a = await i(q) !== null;
974
+ a ? await Ut() : b(`ℹ️ '${q}' NOT required by this project`), await x("ℹ️ Format generated files", "prettier", [
919
975
  "--write",
920
976
  "README.md",
921
- ...a ? [H] : []
977
+ ...a ? [q] : []
922
978
  ]);
923
979
  } catch (e) {
924
980
  console.error("❌ Error documenting project", e), process.exit(1);
@@ -926,7 +982,7 @@ async function on(e = "MIT", t = !1) {
926
982
  }
927
983
  //#endregion
928
984
  //#region src/actions/formatCode.ts
929
- async function sn() {
985
+ async function Sn() {
930
986
  try {
931
987
  f("Format Code");
932
988
  let e = [
@@ -938,25 +994,25 @@ async function sn() {
938
994
  "app",
939
995
  "src",
940
996
  "tests"
941
- ].filter((e) => ie(e)).map((e) => `${e}/**`)
997
+ ].filter((e) => oe(e)).map((e) => `${e}/**`)
942
998
  ];
943
- await S("1️⃣ Format", "prettier", e), o("Code formatted");
999
+ await x("1️⃣ Format", "prettier", e), o("Code formatted");
944
1000
  } catch (e) {
945
1001
  console.error("❌ Error formatting code", e), process.exit(1);
946
1002
  }
947
1003
  }
948
1004
  //#endregion
949
1005
  //#region src/actions/lintCode.ts
950
- async function cn() {
1006
+ async function Cn() {
951
1007
  try {
952
- f("Lint Code"), await S("1️⃣ Lint", "eslint", ["."]), o("Code linted");
1008
+ f("Lint Code"), await x("1️⃣ Lint", "eslint", ["."]), o("Code linted");
953
1009
  } catch (e) {
954
1010
  console.error("❌ Error linting code", e), process.exit(1);
955
1011
  }
956
1012
  }
957
1013
  //#endregion
958
1014
  //#region src/utilities/cloudflare.ts
959
- async function ln() {
1015
+ async function wn() {
960
1016
  let e = await c("config.json"), t = {
961
1017
  body: JSON.stringify(e),
962
1018
  headers: { "Content-Type": "application/json" },
@@ -964,7 +1020,7 @@ async function ln() {
964
1020
  }, n = await fetch(`https://api.dpuse.app/configs/${e.id}`, t);
965
1021
  if (!n.ok) throw Error(await n.text());
966
1022
  }
967
- async function un(e, t) {
1023
+ async function Tn(e, t) {
968
1024
  async function n(e, t, r) {
969
1025
  for (let i of r) {
970
1026
  let r = `${e}/${i}`, a = `${t}/${i}`;
@@ -982,7 +1038,7 @@ async function un(e, t) {
982
1038
  let r = await v(`${e}/${t}/`);
983
1039
  await n(`${e}/${t}`, t, r);
984
1040
  }
985
- async function dn(e) {
1041
+ async function En(e) {
986
1042
  let t = e.id, n = {
987
1043
  body: JSON.stringify(e),
988
1044
  headers: { "Content-Type": "application/json" },
@@ -990,7 +1046,7 @@ async function dn(e) {
990
1046
  }, r = await fetch(`https://api.dpuse.app/configs/${t}`, n);
991
1047
  if (!r.ok) throw Error(await r.text());
992
1048
  }
993
- async function fn(e, t) {
1049
+ async function Dn(e, t) {
994
1050
  let n = `v${e.version ?? "unknown"}`;
995
1051
  async function r(e, r = "") {
996
1052
  let i = await v(e, { withFileTypes: !0 });
@@ -1014,34 +1070,34 @@ async function fn(e, t) {
1014
1070
  }
1015
1071
  //#endregion
1016
1072
  //#region src/actions/publishProject.ts
1017
- async function pn() {
1073
+ async function On() {
1018
1074
  try {
1019
1075
  f("Publish Project");
1020
1076
  let e = await c("package.json"), t = await c("config.json"), n = _(t.id);
1021
- n.publishedTo === "npm" ? await S("1️⃣ Publish to npm", "npm", ["publish", "--provenance"]) : x("1️⃣ Publishing to npm NOT required"), await mn("2️⃣ ", e, t, n), o(`Project version '${e.version ?? "unknown"}' published.`);
1077
+ n.publishedTo === "npm" ? await x("1️⃣ Publish to npm", "npm", ["publish", "--provenance"]) : b("1️⃣ Publishing to npm NOT required"), await $("2️⃣ ", e, t, n), o(`Project version '${e.version ?? "unknown"}' published.`);
1022
1078
  } catch (e) {
1023
1079
  console.error("❌ Error publishing project", e), process.exit(1);
1024
1080
  }
1025
1081
  }
1026
- async function mn(e, t, n, r) {
1027
- if (r.typeId === "app") x(`${e} Register module`), await ln();
1028
- else if (r.typeId === "engine") x(`${e} Register module`), await fn(t, `dpuse-engine-eu/${r.uploadGroupName ?? "unknown"}`), await dn(n);
1029
- else if (r.uploadGroupName === void 0) x(`${e} Registration NOT required`);
1082
+ async function $(e, t, n, r) {
1083
+ if (r.typeId === "app") b(`${e} Register module`), await wn();
1084
+ else if (r.typeId === "engine") b(`${e} Register module`), await Dn(t, `dpuse-engine-eu/${r.uploadGroupName ?? "unknown"}`), await En(n);
1085
+ else if (r.uploadGroupName === void 0) b(`${e} Registration NOT required`);
1030
1086
  else {
1031
- x(`${e} Register module`);
1087
+ b(`${e} Register module`);
1032
1088
  let i = n.id.split("-").slice(2).join("-");
1033
- await fn(t, `dpuse-engine-eu/${r.uploadGroupName}/${i}`), await dn(n);
1089
+ await Dn(t, `dpuse-engine-eu/${r.uploadGroupName}/${i}`), await En(n);
1034
1090
  }
1035
1091
  }
1036
1092
  //#endregion
1037
1093
  //#region src/actions/releaseProject.ts
1038
- async function hn(e = "MIT", t = !1) {
1094
+ async function kn(e = "MIT", t = !1) {
1039
1095
  try {
1040
1096
  f("Release Project");
1041
1097
  let n = await c("package.json"), r = await c("config.json"), i = _(r.id);
1042
- await b("1️⃣ ", n);
1098
+ await y("1️⃣ ", n);
1043
1099
  let a = await g("2️⃣ ", n, i);
1044
- if (await D("3️⃣ ", n), x("4️⃣ Regenerate README"), await on(e, t), await d("5️⃣ Stage changes", "git", ["add", "."]), await d("6️⃣ Commit changes", "git", [
1100
+ if (await T("3️⃣ ", n), b("4️⃣ Regenerate README"), await xn(e, t), await d("5️⃣ Stage changes", "git", ["add", "."]), await d("6️⃣ Commit changes", "git", [
1045
1101
  "commit",
1046
1102
  "-m",
1047
1103
  `v${n.version ?? "unknown"}`
@@ -1049,9 +1105,9 @@ async function hn(e = "MIT", t = !1) {
1049
1105
  "push",
1050
1106
  "origin",
1051
1107
  "main:main"
1052
- ]), await mn("8️⃣ ", n, a, i), i.publishedTo === "npm") {
1108
+ ]), await $("8️⃣ ", n, a, i), i.publishedTo === "npm") {
1053
1109
  let e = `v${n.version ?? "unknown"}`;
1054
- await S("9️⃣ Create GitHub release", "gh", [
1110
+ await x("9️⃣ Create GitHub release", "gh", [
1055
1111
  "release",
1056
1112
  "create",
1057
1113
  e,
@@ -1060,7 +1116,7 @@ async function hn(e = "MIT", t = !1) {
1060
1116
  "--generate-notes",
1061
1117
  "--latest"
1062
1118
  ]);
1063
- } else x(`9️⃣ Publishing NOT required for package with type identifier of '${i.typeId}'.`);
1119
+ } else b(`9️⃣ Publishing NOT required for package with type identifier of '${i.typeId}'.`);
1064
1120
  o(`Project version '${n.version ?? "unknown"}' released.`);
1065
1121
  } catch (e) {
1066
1122
  console.error("❌ Error releasing project", e), process.exit(1);
@@ -1068,11 +1124,11 @@ async function hn(e = "MIT", t = !1) {
1068
1124
  }
1069
1125
  //#endregion
1070
1126
  //#region src/actions/syncProjectWithGitHub.ts
1071
- async function gn() {
1127
+ async function An() {
1072
1128
  try {
1073
1129
  f("Synchronise Project with GitHub");
1074
1130
  let e = await c("package.json"), t = await c("config.json"), n = _(t.id);
1075
- await b("1️⃣ ", e), await g("2️⃣ ", e, n), await d("3️⃣ Stage changes", "git", ["add", "."]), await d("4️⃣ Commit changes", "git", [
1131
+ await y("1️⃣ ", e), await g("2️⃣ ", e, n), await d("3️⃣ Stage changes", "git", ["add", "."]), await d("4️⃣ Commit changes", "git", [
1076
1132
  "commit",
1077
1133
  "-m",
1078
1134
  `v${e.version ?? "unknown"}`
@@ -1087,12 +1143,12 @@ async function gn() {
1087
1143
  }
1088
1144
  //#endregion
1089
1145
  //#region src/actions/testProject.ts
1090
- var _n = [
1146
+ var jn = [
1091
1147
  "1️⃣ ",
1092
1148
  "2️⃣ ",
1093
1149
  "3️⃣ ",
1094
1150
  "4️⃣ "
1095
- ], vn = [{
1151
+ ], Mn = [{
1096
1152
  id: "unit",
1097
1153
  label: "Run unit tests",
1098
1154
  command: "vitest",
@@ -1105,14 +1161,14 @@ var _n = [
1105
1161
  arguments: ["test", "--pass-with-no-tests"],
1106
1162
  configFileName: "playwright.config.ts"
1107
1163
  }];
1108
- async function yn(e = ["unit"]) {
1164
+ async function Nn(e = ["unit"]) {
1109
1165
  try {
1110
1166
  f("Test Project");
1111
1167
  let t = 0;
1112
- for (let n of vn) {
1168
+ for (let n of Mn) {
1113
1169
  if (!e.includes(n.id) || await i(n.configFileName) === null) continue;
1114
- let r = `${_n[t] ?? ""} ${n.label}`;
1115
- await S(r, n.command, n.arguments), t += 1;
1170
+ let r = `${jn[t] ?? ""} ${n.label}`;
1171
+ await x(r, n.command, n.arguments), t += 1;
1116
1172
  }
1117
1173
  if (t === 0) {
1118
1174
  console.warn("\n⚠️ No tests configured for this project.\n");
@@ -1124,4 +1180,4 @@ async function yn(e = ["unit"]) {
1124
1180
  }
1125
1181
  }
1126
1182
  //#endregion
1127
- export { ue as auditDependencies, de as buildProject, Ce as checkProject, on as documentProject, sn as formatCode, cn as lintCode, pn as publishProject, hn as releaseProject, gn as syncProjectWithGitHub, yn as testProject, un as uploadDirectoryToR2 };
1183
+ export { pe as auditDependencies, he as buildProject, De as checkProject, xn as documentProject, Sn as formatCode, Cn as lintCode, On as publishProject, kn as releaseProject, An as syncProjectWithGitHub, Nn as testProject, Tn as uploadDirectoryToR2 };