ssqch 0.11.0 → 0.13.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 (138) hide show
  1. package/bundled/completions/bash +67 -9
  2. package/bundled/completions/elvish +24 -4
  3. package/bundled/completions/fish +37 -25
  4. package/bundled/completions/powershell +26 -4
  5. package/bundled/completions/zsh +45 -10
  6. package/bundled/docs/agents.md +2 -2
  7. package/bundled/docs/build-summary.md +1 -1
  8. package/bundled/docs/comparing-builds.md +7 -4
  9. package/bundled/docs/configuring.md +7 -12
  10. package/bundled/docs/deploying.md +1 -1
  11. package/bundled/docs/field-guide.md +4 -4
  12. package/bundled/docs/github-pages.md +2 -1
  13. package/bundled/docs/index.md +1 -1
  14. package/bundled/docs/install.md +1 -1
  15. package/bundled/docs/known-gaps.md +1 -1
  16. package/bundled/docs/markdown.md +11 -13
  17. package/bundled/docs/nav.yml +6 -1
  18. package/bundled/docs/netlify.md +4 -2
  19. package/bundled/docs/patrol.md +48 -0
  20. package/bundled/docs/plugins.md +6 -4
  21. package/bundled/docs/robots.md +72 -0
  22. package/bundled/docs/seo.md +2 -38
  23. package/bundled/docs/serving-markdown.md +142 -0
  24. package/bundled/docs/template-languages.md +2 -1
  25. package/bundled/docs/templates.md +2 -1
  26. package/bundled/docs/trailheads/from-component-frameworks.md +9 -10
  27. package/bundled/docs/trailheads/from-hugo.md +5 -3
  28. package/bundled/docs/trailheads/from-jekyll.md +54 -13
  29. package/bundled/docs/trailheads/from-mkdocs.md +15 -12
  30. package/bundled/docs/trailheads/from-vitepress.md +142 -0
  31. package/bundled/docs/trailheads.md +5 -5
  32. package/bundled/docs/where-values-come-from.md +5 -5
  33. package/bundled/docs/writing-plugins.md +69 -0
  34. package/bundled/ssqch.d.ts +150 -34
  35. package/bundled/starter/engines/index.edge +1 -0
  36. package/bundled/starter/engines/index.ejs +1 -0
  37. package/bundled/starter/engines/index.hbs +1 -0
  38. package/bundled/starter/engines/index.liquid +1 -0
  39. package/bundled/starter/engines/layout.edge +7 -0
  40. package/bundled/starter/engines/layout.ejs +4 -0
  41. package/bundled/starter/engines/layout.hbs +4 -0
  42. package/bundled/starter/engines/layout.liquid +4 -0
  43. package/bundled/starter/src/_data/site.json +1 -0
  44. package/bundled/starter/src/_includes/layout.jinja +4 -0
  45. package/bundled/starter/src/index.jinja +1 -0
  46. package/bundled/starter/ssqch.config.js +14 -1
  47. package/bundled/starter-docs/engines/edge/base.edge +7 -0
  48. package/bundled/starter-docs/engines/edge/doc.edge +4 -0
  49. package/bundled/starter-docs/engines/ejs/base.ejs +4 -0
  50. package/bundled/starter-docs/engines/ejs/doc.ejs +4 -0
  51. package/bundled/starter-docs/engines/hbs/base.hbs +4 -0
  52. package/bundled/starter-docs/engines/hbs/doc.hbs +3 -0
  53. package/bundled/starter-docs/engines/liquid/base.liquid +4 -0
  54. package/bundled/starter-docs/engines/liquid/doc.liquid +4 -0
  55. package/bundled/starter-docs/src/_data/site.json +1 -0
  56. package/bundled/starter-docs/src/_includes/base.jinja +4 -0
  57. package/bundled/starter-docs/src/_includes/doc.jinja +4 -0
  58. package/bundled/starter-docs/src/assets/docs.css +4 -0
  59. package/bundled/starter-docs/src/assets/docs.js +17 -0
  60. package/bundled/starter-docs/ssqch.config.js +14 -1
  61. package/lib/assets.js +13 -11
  62. package/lib/chunk-25WERNDD.js +112 -0
  63. package/lib/{chunk-H5K2ZE7B.js → chunk-2BJFGKOE.js} +13 -5
  64. package/lib/chunk-2FKYWYAB.js +268 -0
  65. package/lib/{chunk-LJOURBYT.js → chunk-3ZTRIO6O.js} +21 -19
  66. package/lib/{chunk-IOBC665M.js → chunk-4AZFCSGJ.js} +5 -3
  67. package/lib/{chunk-HWW5NCVJ.js → chunk-4Q6WMTER.js} +1 -1
  68. package/lib/{chunk-V2FSMOFX.js → chunk-55WXDGO4.js} +3 -3
  69. package/lib/{chunk-ZR3JYLFB.js → chunk-6FY77I4M.js} +331 -58
  70. package/lib/{chunk-JC54PHIT.js → chunk-6OUCRDYI.js} +514 -141
  71. package/lib/{chunk-ERAIEV3O.js → chunk-6U5VIQVY.js} +9 -7
  72. package/lib/{chunk-Z5OP43HU.js → chunk-7U5GWTEH.js} +455 -94
  73. package/lib/{chunk-CMJ7X5WW.js → chunk-AIJNG6MJ.js} +3 -2
  74. package/lib/{chunk-3K237XAX.js → chunk-C2Q7JKFI.js} +12 -10
  75. package/lib/{chunk-GS5B3CBW.js → chunk-DDV6JEC2.js} +1 -1
  76. package/lib/{chunk-A75EVUJX.js → chunk-DFJFHULZ.js} +47 -20
  77. package/lib/{chunk-KZZS4W2V.js → chunk-ENWDM2RW.js} +45 -42
  78. package/lib/{chunk-I3HYKEEW.js → chunk-ER72RPD6.js} +3 -3
  79. package/lib/chunk-F3JPNFCZ.js +23 -0
  80. package/lib/{chunk-B5E27PLU.js → chunk-FENJHLNM.js} +6 -3
  81. package/lib/{chunk-UU43WIZG.js → chunk-FJML7INB.js} +4 -2
  82. package/lib/{chunk-KCF2Z6N7.js → chunk-FQZDUDFK.js} +5 -3
  83. package/lib/{chunk-GJNIQAIH.js → chunk-GSNRAGKQ.js} +13 -6
  84. package/lib/{chunk-443ZQLVX.js → chunk-GU7BBYWB.js} +5 -4
  85. package/lib/{chunk-X2GAVYV2.js → chunk-HDKU6LRI.js} +110 -748
  86. package/lib/chunk-J3C2LEW7.js +121 -0
  87. package/lib/{chunk-XS4EJSEK.js → chunk-K5WZ2VYK.js} +7 -5
  88. package/lib/{chunk-3HZZY3Y7.js → chunk-OOKBXQAY.js} +7 -6
  89. package/lib/chunk-P2WS4RM4.js +707 -0
  90. package/lib/{chunk-RBNPBTDP.js → chunk-SNQOHNXE.js} +1 -1
  91. package/lib/{chunk-HFSWUTXX.js → chunk-SPIFZBIW.js} +1 -1
  92. package/lib/{chunk-QLUTNR37.js → chunk-T5IUI7W7.js} +12 -11
  93. package/lib/{chunk-ZINLHOX4.js → chunk-TGSVSG2G.js} +3 -2
  94. package/lib/{chunk-2L3HR67O.js → chunk-U2KEMVXO.js} +24 -16
  95. package/lib/{chunk-RYIWYWRQ.js → chunk-UHRBPZ4A.js} +7 -5
  96. package/lib/{chunk-2QTJTEBV.js → chunk-ULCT3PAV.js} +1 -1
  97. package/lib/{chunk-FCM3NYFR.js → chunk-UZNUS7RP.js} +12 -9
  98. package/lib/{chunk-GLJQ4C76.js → chunk-V3G2QGL3.js} +13 -106
  99. package/lib/{chunk-Z44IAMNG.js → chunk-VILOEVK7.js} +60 -28
  100. package/lib/chunk-VJWQSYEG.js +119 -0
  101. package/lib/{chunk-5ELAUHRL.js → chunk-WGAIE3DD.js} +23 -19
  102. package/lib/{chunk-OQGXZYZS.js → chunk-WUCRAV36.js} +13 -7
  103. package/lib/{chunk-RZYAIX2R.js → chunk-XYAWJTHM.js} +11 -10
  104. package/lib/{chunk-OSBEH67S.js → chunk-YA23NDMW.js} +5 -3
  105. package/lib/{chunk-AIMEXBTK.js → chunk-YNJNMQWU.js} +37 -142
  106. package/lib/{chunk-QJ5ZFTML.js → chunk-ZMG25MXF.js} +20 -18
  107. package/lib/cli.js +72 -35
  108. package/lib/elements.js +13 -11
  109. package/lib/from-hugo.js +36 -0
  110. package/lib/from-jekyll.js +41 -0
  111. package/lib/from-mkdocs.js +49 -0
  112. package/lib/from-vitepress.js +49 -0
  113. package/lib/image.js +12 -11
  114. package/lib/links.js +13 -11
  115. package/lib/llms.js +613 -0
  116. package/lib/minify.js +14 -12
  117. package/lib/redirects.js +13 -11
  118. package/lib/robots.js +87 -0
  119. package/lib/rss.js +24 -13
  120. package/lib/sass.js +12 -11
  121. package/lib/sitemap.js +23 -18
  122. package/lib/ssqch.js +6 -5
  123. package/lib/vue.js +400 -0
  124. package/package.json +29 -1
  125. package/types/from-hugo.d.ts +5 -0
  126. package/types/from-jekyll.d.ts +11 -0
  127. package/types/from-mkdocs.d.ts +11 -0
  128. package/types/from-vitepress.d.ts +5 -0
  129. package/types/index.d.ts +51 -31
  130. package/types/llms.d.ts +27 -0
  131. package/types/robots.d.ts +13 -0
  132. package/types/sass.d.ts +1 -1
  133. package/types/sitemap.d.ts +2 -2
  134. package/types/vue.d.ts +17 -0
  135. package/wasm/markdown.wasm +0 -0
  136. package/lib/chunk-RVXGUMFI.js +0 -21
  137. /package/lib/{chunk-ZR3JYLFB.js.LEGAL.txt → chunk-6FY77I4M.js.LEGAL.txt} +0 -0
  138. /package/lib/{chunk-AIMEXBTK.js.LEGAL.txt → chunk-YNJNMQWU.js.LEGAL.txt} +0 -0
@@ -6,30 +6,32 @@ import {
6
6
  build,
7
7
  edgeCodeMentionsForTest,
8
8
  inEdgeCode,
9
- inspectPages,
10
9
  runCommand,
11
- sameContentsForTest
12
- } from "./chunk-ZR3JYLFB.js";
13
- import "./chunk-OSBEH67S.js";
10
+ sameContentsForTest,
11
+ tracePages
12
+ } from "./chunk-6FY77I4M.js";
13
+ import "./chunk-YA23NDMW.js";
14
+ import "./chunk-V3G2QGL3.js";
14
15
  import {
15
16
  commandLine,
16
17
  toolPath
17
- } from "./chunk-HWW5NCVJ.js";
18
- import "./chunk-GLJQ4C76.js";
19
- import "./chunk-RYIWYWRQ.js";
20
- import "./chunk-Z44IAMNG.js";
21
- import "./chunk-2QTJTEBV.js";
22
- import "./chunk-ERAIEV3O.js";
18
+ } from "./chunk-4Q6WMTER.js";
19
+ import "./chunk-UHRBPZ4A.js";
20
+ import "./chunk-25WERNDD.js";
21
+ import "./chunk-VILOEVK7.js";
22
+ import "./chunk-ULCT3PAV.js";
23
+ import "./chunk-6U5VIQVY.js";
23
24
  import "./chunk-AD3HAW3W.js";
24
25
  import "./chunk-YCOTX2VM.js";
25
- import "./chunk-GS5B3CBW.js";
26
- import "./chunk-JC54PHIT.js";
27
- import "./chunk-HFSWUTXX.js";
26
+ import "./chunk-DDV6JEC2.js";
27
+ import "./chunk-6OUCRDYI.js";
28
+ import "./chunk-SPIFZBIW.js";
28
29
  import "./chunk-FVZ5JBRI.js";
29
- import "./chunk-UU43WIZG.js";
30
- import "./chunk-IOBC665M.js";
30
+ import "./chunk-FJML7INB.js";
31
+ import "./chunk-4AZFCSGJ.js";
31
32
  import "./chunk-CMUWRPSQ.js";
32
- import "./chunk-AIMEXBTK.js";
33
+ import "./chunk-YNJNMQWU.js";
34
+ import "./chunk-VJWQSYEG.js";
33
35
  import "./chunk-I3PS26CI.js";
34
36
  export {
35
37
  OUTPUT_LIST,
@@ -38,8 +40,8 @@ export {
38
40
  commandLine,
39
41
  edgeCodeMentionsForTest,
40
42
  inEdgeCode,
41
- inspectPages,
42
43
  runCommand,
43
44
  sameContentsForTest,
44
- toolPath
45
+ toolPath,
46
+ tracePages
45
47
  };
package/lib/cli.js CHANGED
@@ -2,7 +2,7 @@ import { createRequire as __ssqchCreateRequire } from "node:module";
2
2
  const require = __ssqchCreateRequire(import.meta.url);
3
3
  import {
4
4
  BUILDER
5
- } from "./chunk-I3HYKEEW.js";
5
+ } from "./chunk-ER72RPD6.js";
6
6
  import {
7
7
  Printed,
8
8
  UsageError,
@@ -10,7 +10,7 @@ import {
10
10
  } from "./chunk-RIAOXEXC.js";
11
11
  import {
12
12
  DEFAULT_ENGINE
13
- } from "./chunk-B5E27PLU.js";
13
+ } from "./chunk-FENJHLNM.js";
14
14
  import {
15
15
  VERSION
16
16
  } from "./chunk-AD3HAW3W.js";
@@ -22,10 +22,10 @@ import {
22
22
  parseEnvironment,
23
23
  shownDir,
24
24
  shownOutput
25
- } from "./chunk-GS5B3CBW.js";
25
+ } from "./chunk-DDV6JEC2.js";
26
26
  import {
27
27
  describeThrown
28
- } from "./chunk-IOBC665M.js";
28
+ } from "./chunk-4AZFCSGJ.js";
29
29
  import {
30
30
  prettyJson,
31
31
  quoted
@@ -44,14 +44,17 @@ import {
44
44
  printError,
45
45
  progress,
46
46
  red,
47
- relative,
48
47
  setQuiet,
49
48
  takeWarnings,
50
49
  toJson,
51
50
  toJson2,
52
51
  warn,
53
52
  warning
54
- } from "./chunk-AIMEXBTK.js";
53
+ } from "./chunk-YNJNMQWU.js";
54
+ import {
55
+ isDir,
56
+ relative
57
+ } from "./chunk-VJWQSYEG.js";
55
58
  import "./chunk-I3PS26CI.js";
56
59
 
57
60
  // src/cli.ts
@@ -104,11 +107,11 @@ var COMMANDS = [
104
107
  afterHelp: 'The blueprint is named after the page\'s folder (_blueprints/posts.md for posts/), then `default`.\nIts body is copied as it is; only front matter keys are filled in. Nothing is overwritten.\n\n ssqch new posts/pine-cones.md\n ssqch new posts --title "Pine cones" (named like the other pages in posts/)\n ssqch new docs/guides/install.md --set order=3 --set draft=true'
105
108
  },
106
109
  {
107
- name: "inspect",
108
- about: "Show where a page comes from, and which level of the data cascade set each value",
110
+ name: "trace",
111
+ about: "Follow a page's tracks: where it comes from, and which level of the data cascade set each value",
109
112
  options: [{ long: "field", value: "NAME", help: "One field of its data, in full, with every level that set it (a dotted path reaches inside: hero.alt)" }, FORMAT],
110
113
  positionals: [{ name: "PAGE", help: "The page: its URL (/about/), or its template's path", required: true }],
111
- afterHelp: "The site is read as a build reads it, up to rendering: beforeBuild hooks run (data can depend on them),\nbut no page is rendered or written, and afterBuild hooks don't run. Standard output is only the report.\n\n ssqch inspect /guides/install/\n ssqch inspect src/guides/install.md --field title\n ssqch inspect /guides/install/ --field hero.alt --format json"
114
+ afterHelp: "The site is read as a build reads it, up to rendering: beforeBuild hooks run (data can depend on them),\nbut no page is rendered or written, and afterBuild hooks don't run. Standard output is only the report.\n\n ssqch trace /guides/install/\n ssqch trace src/guides/install.md --field title\n ssqch trace /guides/install/ --field hero.alt --format json"
112
115
  },
113
116
  {
114
117
  name: "completions",
@@ -125,6 +128,7 @@ var COMMANDS = [
125
128
  options: [
126
129
  { long: "exact", help: "Compare bytes: don't match fingerprinted files or ignore whitespace" },
127
130
  { long: "ungrouped", help: "List each file with all its changes, without grouping the ones shared by several files" },
131
+ { long: "text", help: "Compare the article text of each page, word by word, and say how much of it matches" },
128
132
  { long: "ignore", value: "REGEX", help: "Leave out text matching this regular expression before comparing (repeatable)", many: true },
129
133
  { long: "only", value: "GLOB", help: "Only compare files matching this glob, like '**/*.html' (repeatable)", many: true },
130
134
  { long: "exclude", value: "GLOB", help: "Leave out files matching this glob, like 'img/**' (repeatable)", many: true },
@@ -141,6 +145,13 @@ var COMMANDS = [
141
145
  positionals: [{ name: "DIR", help: "The build folder (default: the site's output folder)", required: false, path: true }],
142
146
  afterHelp: "It reads a build folder, so build first:\n\n ssqch build\n ssqch footprint (the site's output folder)\n ssqch footprint dist-before (any build)\n ssqch footprint --top 20 --format json"
143
147
  },
148
+ {
149
+ name: "patrol",
150
+ about: "Check a build for what agents and crawlers read: robots.txt, the sitemap, llms.txt, Markdown copies, headings and descriptions",
151
+ options: [FORMAT],
152
+ positionals: [{ name: "DIR", help: "The build folder (default: the site's output folder)", required: false, path: true }],
153
+ afterHelp: "It reads a build folder, any generator's, so build first:\n\n ssqch build\n ssqch patrol (the site's output folder)\n ssqch patrol _site (another generator's build, before a move)\n ssqch patrol --format json\n\nEach warning has a code (`ssqch docs \"what patrol checks\"` says what each means). Exits with 0 when it found nothing, 1 when\nit warned, and 2 on an error."
154
+ },
144
155
  {
145
156
  name: "init",
146
157
  about: "Create a starter site (config, layout, five posts, data and editor types)",
@@ -354,29 +365,30 @@ async function main(argv) {
354
365
  `);
355
366
  return 1;
356
367
  }
357
- if (command === "baseline") return (await import("./chunk-RVXGUMFI.js")).runBaseline({ root: value("root") ?? ".", command: cli.positionals.join(" "), from: value("from") ?? "_site", runs: Number(value("runs") ?? "3"), commit: value("commit"), to: value("to") ?? ".cache/ssqch/baseline/ref", link: [cli.options.link ?? []].flat(), patch: value("patch"), copyInstalls: flag("copy-installs"), quiet: flag("quiet") });
358
- if (command === "scout") return (await import("./chunk-Z5OP43HU.js")).runScout(cli.positionals[0] ?? ".", { from: value("from"), format: value("format") === "json" ? "json" : "text", writeDraft: flag("write-draft"), patch: value("patch"), compare: flag("compare") ? value("reference") ?? "" : void 0 });
368
+ if (command === "baseline") return (await import("./chunk-F3JPNFCZ.js")).runBaseline({ root: value("root") ?? ".", command: cli.positionals.join(" "), from: value("from") ?? "_site", runs: Number(value("runs") ?? "3"), commit: value("commit"), to: value("to") ?? ".cache/ssqch/baseline/ref", link: [cli.options.link ?? []].flat(), patch: value("patch"), copyInstalls: flag("copy-installs"), quiet: flag("quiet") });
369
+ if (command === "scout") return (await import("./chunk-7U5GWTEH.js")).runScout(cli.positionals[0] ?? ".", { from: value("from"), format: value("format") === "json" ? "json" : "text", writeDraft: flag("write-draft"), patch: value("patch"), compare: flag("compare") ? value("reference") ?? "" : void 0 });
359
370
  switch (command) {
360
371
  case "init":
361
- return (await import("./chunk-CMJ7X5WW.js")).runInit({ dir: cli.positionals[0] ?? ".", starter: value("starter") ?? "site", engine: value("engine") ?? DEFAULT_ENGINE, quiet: flag("quiet") });
372
+ return (await import("./chunk-AIJNG6MJ.js")).runInit({ dir: cli.positionals[0] ?? ".", starter: value("starter") ?? "site", engine: value("engine") ?? DEFAULT_ENGINE, quiet: flag("quiet") });
362
373
  case "capabilities":
363
- return (await import("./chunk-QLUTNR37.js")).runCapabilities(format, CAPABILITY_ORDER);
374
+ return (await import("./chunk-T5IUI7W7.js")).runCapabilities(format, CAPABILITY_ORDER);
364
375
  case "docs":
365
- return (await import("./chunk-2L3HR67O.js")).runDocs(GRAMMAR, { query: cli.positionals, from: value("from"), format });
376
+ return (await import("./chunk-U2KEMVXO.js")).runDocs(GRAMMAR, { query: cli.positionals, from: value("from"), format });
366
377
  case "sighting":
367
- return (await import("./chunk-LJOURBYT.js")).runSighting(path.resolve(value("root") ?? "."));
378
+ return (await import("./chunk-3ZTRIO6O.js")).runSighting(path.resolve(value("root") ?? "."));
368
379
  case "completions": {
369
380
  process.stdout.write(bundled(`completions/${cli.positionals[0]}`));
370
381
  return 0;
371
382
  }
372
383
  case "types": {
373
384
  routeConsole();
374
- return (await import("./chunk-RZYAIX2R.js")).runTypes({ root: value("root"), out: value("out") ?? "ssqch.d.ts" });
385
+ return (await import("./chunk-XYAWJTHM.js")).runTypes({ root: value("root"), out: value("out") ?? "ssqch.d.ts" });
375
386
  }
376
387
  }
377
388
  const many = (name) => Array.isArray(cli.options[name]) ? cli.options[name] : typeof cli.options[name] === "string" ? [cli.options[name]] : [];
378
389
  const top = Number(value("top") ?? "5");
379
- if (command === "diff") return runDiff(cli.positionals, { exact: flag("exact"), ignore: many("ignore"), only: many("only"), exclude: many("exclude"), ungrouped: flag("ungrouped"), lines: Number(value("lines") ?? "10"), format });
390
+ if (command === "diff") return runDiff(cli.positionals, { exact: flag("exact"), ignore: many("ignore"), only: many("only"), exclude: many("exclude"), ungrouped: flag("ungrouped"), text: flag("text"), lines: Number(value("lines") ?? "10"), format });
391
+ if (command === "patrol" && cli.positionals[0] !== void 0) return runPatrol(cli.positionals[0], cli.positionals[0], format);
380
392
  if (command === "footprint" && cli.positionals[0] !== void 0) {
381
393
  try {
382
394
  await runFootprint(cli.positionals[0], cli.positionals[0], top, format);
@@ -387,8 +399,8 @@ async function main(argv) {
387
399
  return 1;
388
400
  }
389
401
  }
390
- const inspecting = command === "inspect";
391
- if (inspecting) capture();
402
+ const tracing = command === "trace";
403
+ if (tracing) capture();
392
404
  const serving = command === "serve";
393
405
  const given = value("env") ?? process.env.SSQCH_ENV ?? process.env.NODE_ENV;
394
406
  const env = (given === void 0 ? void 0 : parseEnvironment(given)) ?? (serving ? "development" : "production");
@@ -397,15 +409,15 @@ async function main(argv) {
397
409
  const root = path.resolve(value("root") ?? ".");
398
410
  siteRoot = root;
399
411
  routeConsole();
400
- const makeConfig = async () => (await import("./chunk-FCM3NYFR.js")).loadConfig({ root, rootGiven: value("root") ?? ".", env, serving, quiet: flag("quiet") || inspecting, verbose: flag("verbose"), profile: command === "build" && flag("profile"), output: value("output"), base: value("base") });
412
+ const makeConfig = async () => (await import("./chunk-UZNUS7RP.js")).loadConfig({ root, rootGiven: value("root") ?? ".", env, serving, quiet: flag("quiet") || tracing, verbose: flag("verbose"), profile: command === "build" && flag("profile"), output: value("output"), base: value("base") });
401
413
  if (command === "new") return newPage(makeConfig, root, { path: cli.positionals[0], title: value("title"), date: value("date"), blueprint: value("blueprint"), set: cli.options.set ?? [], format });
402
414
  if (serving) {
403
- if (building) return (await import("./chunk-5ELAUHRL.js")).runBuilder(building, makeConfig, root);
415
+ if (building) return (await import("./chunk-WGAIE3DD.js")).runBuilder(building, makeConfig, root);
404
416
  const readyFile = value("ready-file") === void 0 ? void 0 : path.resolve(value("ready-file"));
405
417
  const options = { port: Number(value("port") ?? "8080"), readyFile, quiet: flag("quiet") };
406
418
  if (!flag("built")) {
407
419
  try {
408
- return await (await import("./chunk-A75EVUJX.js")).serve(argv, options);
420
+ return await (await import("./chunk-DFJFHULZ.js")).serve(argv, options);
409
421
  } catch (e) {
410
422
  printError("error:", e, "build", new Locator(root));
411
423
  return 1;
@@ -419,7 +431,7 @@ async function main(argv) {
419
431
  return 1;
420
432
  }
421
433
  try {
422
- return await (await import("./chunk-A75EVUJX.js")).serveBuilt(config2, options);
434
+ return await (await import("./chunk-DFJFHULZ.js")).serveBuilt(config2, options);
423
435
  } catch (e) {
424
436
  printError("error:", e, "build", locatorOf(config2));
425
437
  return 1;
@@ -439,16 +451,17 @@ async function main(argv) {
439
451
  return 1;
440
452
  }
441
453
  try {
442
- if (inspecting) {
443
- await runInspect(config, cli.positionals[0], value("field"), format);
454
+ if (tracing) {
455
+ await runTrace(config, cli.positionals[0], value("field"), format);
444
456
  return 0;
445
457
  }
458
+ if (command === "patrol") return runPatrol(shownDir(config, config.output), shownOutput(config), format);
446
459
  if (command === "footprint") {
447
460
  const dirs = dirsOf(config);
448
461
  await runFootprint(shownDir(config, config.output), shownOutput(config), top, format);
449
462
  return 0;
450
463
  }
451
- const [{ build }, { summary, profileText }] = await Promise.all([import("./chunk-QJ5ZFTML.js"), import("./chunk-443ZQLVX.js")]);
464
+ const [{ build }, { summary, profileText }] = await Promise.all([import("./chunk-ZMG25MXF.js"), import("./chunk-GU7BBYWB.js")]);
452
465
  const report = await build(config);
453
466
  if (!config.quiet) process.stdout.write(summary(config, report));
454
467
  if (report.profile) process.stdout.write(profileText(report.profile));
@@ -467,7 +480,7 @@ async function newPage(makeConfig, root, command) {
467
480
  return 1;
468
481
  }
469
482
  try {
470
- (await import("./chunk-3K237XAX.js")).runNew(config, command);
483
+ (await import("./chunk-C2Q7JKFI.js")).runNew(config, command);
471
484
  return 0;
472
485
  } catch (e) {
473
486
  printError("error:", e, "build", locatorOf(config));
@@ -477,12 +490,12 @@ async function newPage(makeConfig, root, command) {
477
490
  var checkFormat = (format) => {
478
491
  if (format !== "text" && format !== "json") bail(`--format ${format}: use text or json`);
479
492
  };
480
- async function runInspect(config, target, name, format) {
493
+ async function runTrace(config, target, name, format) {
481
494
  checkFormat(format);
482
- const { field, fieldText, inspect, inspectionJson, inspectionText } = await import("./chunk-KZZS4W2V.js");
495
+ const { field, fieldText, trace, traceJson, traceText } = await import("./chunk-ENWDM2RW.js");
483
496
  let report;
484
497
  try {
485
- report = await inspect(config, target);
498
+ report = await trace(config, target);
486
499
  } finally {
487
500
  for (const found of takeWarnings()) process.stderr.write(`warn: ${found.message}
488
501
  `);
@@ -492,14 +505,14 @@ async function runInspect(config, target, name, format) {
492
505
  one = field(report, name);
493
506
  if (!one) bail(`${report.url ?? report.inputPath} has no \`${name.split(".")[0]}\` in its data (it has: ${report.fields.map((f) => f.name).join(", ")})`);
494
507
  }
495
- if (format === "json") process.stdout.write(prettyJson(inspectionJson(report, one)) + "\n");
496
- else process.stdout.write(one ? fieldText(one) : inspectionText(report));
508
+ if (format === "json") process.stdout.write(prettyJson(traceJson(report, one)) + "\n");
509
+ else process.stdout.write(one ? fieldText(one) : traceText(report));
497
510
  }
498
511
  async function runDiff(dirs, options) {
499
512
  const [before, after] = dirs;
500
513
  try {
501
514
  checkFormat(options.format);
502
- const [{ rustRegExp }, { globProblem, globToRegExp }, { compare, compareRuns, diffJson, diffText, isSame, runsJson, runsText }] = await Promise.all([import("./chunk-IAFM5ITE.js"), import("./chunk-ZINLHOX4.js"), import("./chunk-OQGXZYZS.js")]);
515
+ const [{ rustRegExp }, { globProblem, globToRegExp }, { compare, compareRuns, diffJson, diffText, isSame, runsJson, runsText }] = await Promise.all([import("./chunk-IAFM5ITE.js"), import("./chunk-TGSVSG2G.js"), import("./chunk-WUCRAV36.js")]);
503
516
  const ignore = options.ignore.map((pattern) => {
504
517
  try {
505
518
  return rustRegExp(pattern, "g");
@@ -515,6 +528,17 @@ async function runDiff(dirs, options) {
515
528
  });
516
529
  const only = options.only.length ? globs("only", options.only) : void 0;
517
530
  const exclude = globs("exclude", options.exclude);
531
+ if (options.text) {
532
+ if (dirs.length > 2) bail("--text compares two builds; give it the reference and ssqch's (`ssqch diff ref dist --text`)");
533
+ for (const dir of [before, after]) if (!isDir(dir)) bail(`${dir} isn't a folder; give \`ssqch diff --text\` two build folders, like \`ssqch diff .cache/ssqch/baseline/ref-1 dist --text\``);
534
+ const { compareArticleText, textMatchJson, textMatchText, textSummary } = await import("./chunk-J3C2LEW7.js");
535
+ const keep = (file) => (!only || only.some((re) => re.test(file))) && !exclude.some((re) => re.test(file));
536
+ const report2 = compareArticleText(before, after, keep, ignore);
537
+ if (options.format === "json") process.stdout.write(JSON.stringify(textMatchJson(report2), null, 2) + "\n");
538
+ else process.stdout.write(textMatchText(report2, options.lines));
539
+ const s = textSummary(report2);
540
+ return s.identical === s.pages && !s.missing.length ? 0 : 1;
541
+ }
518
542
  if (dirs.length > 2) {
519
543
  const runs = await compareRuns(dirs, { exact: options.exact, ungrouped: options.ungrouped, ignore, only, onlyGiven: options.only, exclude, lines: options.lines });
520
544
  if (options.format === "json") process.stdout.write(JSON.stringify(runsJson(runs, options.lines), null, 2) + "\n");
@@ -531,9 +555,22 @@ async function runDiff(dirs, options) {
531
555
  return 2;
532
556
  }
533
557
  }
558
+ async function runPatrol(dir, shown, format) {
559
+ try {
560
+ checkFormat(format);
561
+ const { patrol, patrolJson, patrolText } = await import("./chunk-2FKYWYAB.js");
562
+ const report = patrol(dir);
563
+ process.stdout.write(format === "json" ? JSON.stringify(patrolJson(report, shown), null, 2) + "\n" : patrolText(report, shown));
564
+ return report.findings.length ? 1 : 0;
565
+ } catch (e) {
566
+ process.stderr.write(`${red("error:")} ${describeThrown(e, process.cwd())}
567
+ `);
568
+ return 2;
569
+ }
570
+ }
534
571
  async function runFootprint(dir, shown, top, format) {
535
572
  checkFormat(format);
536
- const { footprintJson, footprintText, measure } = await import("./chunk-3HZZY3Y7.js");
573
+ const { footprintJson, footprintText, measure } = await import("./chunk-OOKBXQAY.js");
537
574
  const measured = await measure(dir);
538
575
  if (format === "json") process.stdout.write(JSON.stringify(footprintJson(measured, shown, top), null, 2) + "\n");
539
576
  else process.stdout.write(footprintText(measured, shown, top));
@@ -557,7 +594,7 @@ async function buildJson(makeConfig, root, env) {
557
594
  const dirs = dirsOf(config);
558
595
  out.output = shownOutput(config);
559
596
  try {
560
- const report = await (await import("./chunk-QJ5ZFTML.js")).build(config);
597
+ const report = await (await import("./chunk-ZMG25MXF.js")).build(config);
561
598
  out.durationMs = ms(report.durationMs);
562
599
  out.pages = { written: report.pagesWritten, templates: report.templates, bytes: report.pageBytes, new: report.pagesNew ?? null, gone: report.pagesGone ?? null };
563
600
  out.copied = { files: report.filesCopied, unchanged: report.filesUnchanged, bytes: report.passthroughBytes };
package/lib/elements.js CHANGED
@@ -2,35 +2,37 @@ import { createRequire as __ssqchCreateRequire } from "node:module";
2
2
  const require = __ssqchCreateRequire(import.meta.url);
3
3
  import {
4
4
  Options
5
- } from "./chunk-RBNPBTDP.js";
5
+ } from "./chunk-SNQOHNXE.js";
6
6
  import {
7
7
  BUILTINS,
8
8
  debugString,
9
9
  rewriteHtml,
10
10
  withBase
11
- } from "./chunk-Z44IAMNG.js";
12
- import "./chunk-2QTJTEBV.js";
11
+ } from "./chunk-VILOEVK7.js";
12
+ import "./chunk-ULCT3PAV.js";
13
13
  import {
14
14
  count
15
- } from "./chunk-ERAIEV3O.js";
15
+ } from "./chunk-6U5VIQVY.js";
16
16
  import "./chunk-AD3HAW3W.js";
17
17
  import "./chunk-YCOTX2VM.js";
18
- import "./chunk-GS5B3CBW.js";
19
- import "./chunk-JC54PHIT.js";
20
- import "./chunk-HFSWUTXX.js";
18
+ import "./chunk-DDV6JEC2.js";
19
+ import "./chunk-6OUCRDYI.js";
20
+ import "./chunk-SPIFZBIW.js";
21
21
  import "./chunk-FVZ5JBRI.js";
22
- import "./chunk-UU43WIZG.js";
23
- import "./chunk-IOBC665M.js";
22
+ import "./chunk-FJML7INB.js";
23
+ import "./chunk-4AZFCSGJ.js";
24
24
  import "./chunk-CMUWRPSQ.js";
25
25
  import {
26
26
  bail,
27
+ context
28
+ } from "./chunk-YNJNMQWU.js";
29
+ import {
27
30
  compareText,
28
- context,
29
31
  displayPath,
30
32
  isDir,
31
33
  isFile,
32
34
  slashes
33
- } from "./chunk-AIMEXBTK.js";
35
+ } from "./chunk-VJWQSYEG.js";
34
36
  import "./chunk-I3PS26CI.js";
35
37
 
36
38
  // src/modules/elements.ts
@@ -0,0 +1,36 @@
1
+ import { createRequire as __ssqchCreateRequire } from "node:module";
2
+ const require = __ssqchCreateRequire(import.meta.url);
3
+ import {
4
+ Options
5
+ } from "./chunk-SNQOHNXE.js";
6
+ import {
7
+ BUILTINS
8
+ } from "./chunk-VILOEVK7.js";
9
+ import "./chunk-ULCT3PAV.js";
10
+ import "./chunk-6U5VIQVY.js";
11
+ import "./chunk-AD3HAW3W.js";
12
+ import "./chunk-YCOTX2VM.js";
13
+ import "./chunk-DDV6JEC2.js";
14
+ import {
15
+ applyMarkdownOptions
16
+ } from "./chunk-6OUCRDYI.js";
17
+ import "./chunk-SPIFZBIW.js";
18
+ import "./chunk-FVZ5JBRI.js";
19
+ import "./chunk-FJML7INB.js";
20
+ import "./chunk-4AZFCSGJ.js";
21
+ import "./chunk-CMUWRPSQ.js";
22
+ import "./chunk-YNJNMQWU.js";
23
+ import "./chunk-VJWQSYEG.js";
24
+ import "./chunk-I3PS26CI.js";
25
+
26
+ // src/modules/from-hugo.ts
27
+ function fromHugo(options = {}) {
28
+ return { name: "fromHugo", builtin: "ssqch/from-hugo", options };
29
+ }
30
+ BUILTINS.set("ssqch/from-hugo", (config, given) => {
31
+ new Options(given, []);
32
+ if (!config.markdownGiven.has("shortcodes")) applyMarkdownOptions(config.markdown, { shortcodes: "hugo" }, "module");
33
+ });
34
+ export {
35
+ fromHugo
36
+ };
@@ -0,0 +1,41 @@
1
+ import { createRequire as __ssqchCreateRequire } from "node:module";
2
+ const require = __ssqchCreateRequire(import.meta.url);
3
+ import {
4
+ Options
5
+ } from "./chunk-SNQOHNXE.js";
6
+ import {
7
+ BUILTINS
8
+ } from "./chunk-VILOEVK7.js";
9
+ import "./chunk-ULCT3PAV.js";
10
+ import "./chunk-6U5VIQVY.js";
11
+ import "./chunk-AD3HAW3W.js";
12
+ import "./chunk-YCOTX2VM.js";
13
+ import "./chunk-DDV6JEC2.js";
14
+ import {
15
+ applyMarkdownOptions
16
+ } from "./chunk-6OUCRDYI.js";
17
+ import "./chunk-SPIFZBIW.js";
18
+ import "./chunk-FVZ5JBRI.js";
19
+ import "./chunk-FJML7INB.js";
20
+ import "./chunk-4AZFCSGJ.js";
21
+ import "./chunk-CMUWRPSQ.js";
22
+ import "./chunk-YNJNMQWU.js";
23
+ import "./chunk-VJWQSYEG.js";
24
+ import "./chunk-I3PS26CI.js";
25
+
26
+ // src/modules/from-jekyll.ts
27
+ function fromJekyll(options = {}) {
28
+ return { name: "fromJekyll", builtin: "ssqch/from-jekyll", options };
29
+ }
30
+ var KRAMDOWN_DEFAULTS = { htmlMarkdown: "kramdown", headingIds: "kramdown", smartPunctuation: true, autolinks: false };
31
+ BUILTINS.set("ssqch/from-jekyll", (config, given) => {
32
+ const o = new Options(given, ["templates", "kramdown"]);
33
+ if (o.bool("kramdown") ?? true) {
34
+ const own = Object.fromEntries(Object.entries(KRAMDOWN_DEFAULTS).filter(([key]) => !config.markdownGiven.has(key)));
35
+ if (Object.keys(own).length) applyMarkdownOptions(config.markdown, own, "module");
36
+ }
37
+ if (o.bool("templates") ?? true) config.jekyllTemplates = true;
38
+ });
39
+ export {
40
+ fromJekyll
41
+ };
@@ -0,0 +1,49 @@
1
+ import { createRequire as __ssqchCreateRequire } from "node:module";
2
+ const require = __ssqchCreateRequire(import.meta.url);
3
+ import {
4
+ Options
5
+ } from "./chunk-SNQOHNXE.js";
6
+ import {
7
+ BUILTINS,
8
+ addMkdocsTheme,
9
+ debugString
10
+ } from "./chunk-VILOEVK7.js";
11
+ import "./chunk-ULCT3PAV.js";
12
+ import "./chunk-6U5VIQVY.js";
13
+ import "./chunk-AD3HAW3W.js";
14
+ import "./chunk-YCOTX2VM.js";
15
+ import "./chunk-DDV6JEC2.js";
16
+ import {
17
+ applyMarkdownOptions
18
+ } from "./chunk-6OUCRDYI.js";
19
+ import "./chunk-SPIFZBIW.js";
20
+ import "./chunk-FVZ5JBRI.js";
21
+ import "./chunk-FJML7INB.js";
22
+ import "./chunk-4AZFCSGJ.js";
23
+ import "./chunk-CMUWRPSQ.js";
24
+ import {
25
+ bail
26
+ } from "./chunk-YNJNMQWU.js";
27
+ import "./chunk-VJWQSYEG.js";
28
+ import "./chunk-I3PS26CI.js";
29
+
30
+ // src/modules/from-mkdocs.ts
31
+ function fromMkdocs(options = {}) {
32
+ return { name: "fromMkdocs", builtin: "ssqch/from-mkdocs", options };
33
+ }
34
+ var MKDOCS_DEFAULTS = { dialect: "python-markdown", admonitions: "mkdocs", tabs: "mkdocs", headingIds: "python-markdown", sourceLinks: "relative" };
35
+ function mkdocsTemplates(config, file) {
36
+ config.mkdocsTemplates = file;
37
+ addMkdocsTheme(config);
38
+ }
39
+ BUILTINS.set("ssqch/from-mkdocs", (config, given) => {
40
+ const o = new Options(given, ["config", "templates"]);
41
+ const file = o.string("config") ?? "mkdocs.yml";
42
+ if (file.trim() === "") bail(`config must be the path of an mkdocs.yml, like "docs/mkdocs.yml" (got ${debugString(file)})`);
43
+ const own = Object.fromEntries(Object.entries(MKDOCS_DEFAULTS).filter(([key]) => !config.markdownGiven.has(key)));
44
+ if (Object.keys(own).length) applyMarkdownOptions(config.markdown, own, "module");
45
+ if (o.bool("templates")) mkdocsTemplates(config, file);
46
+ });
47
+ export {
48
+ fromMkdocs
49
+ };
@@ -0,0 +1,49 @@
1
+ import { createRequire as __ssqchCreateRequire } from "node:module";
2
+ const require = __ssqchCreateRequire(import.meta.url);
3
+ import {
4
+ Options
5
+ } from "./chunk-SNQOHNXE.js";
6
+ import {
7
+ BUILTINS
8
+ } from "./chunk-VILOEVK7.js";
9
+ import "./chunk-ULCT3PAV.js";
10
+ import "./chunk-6U5VIQVY.js";
11
+ import "./chunk-AD3HAW3W.js";
12
+ import "./chunk-YCOTX2VM.js";
13
+ import "./chunk-DDV6JEC2.js";
14
+ import {
15
+ VITEPRESS_HOOKS,
16
+ addMarkdownSteps,
17
+ applyMarkdownOptions,
18
+ vitepressAfter,
19
+ vitepressBefore
20
+ } from "./chunk-6OUCRDYI.js";
21
+ import "./chunk-SPIFZBIW.js";
22
+ import "./chunk-FVZ5JBRI.js";
23
+ import "./chunk-FJML7INB.js";
24
+ import "./chunk-4AZFCSGJ.js";
25
+ import "./chunk-CMUWRPSQ.js";
26
+ import "./chunk-YNJNMQWU.js";
27
+ import "./chunk-VJWQSYEG.js";
28
+ import "./chunk-I3PS26CI.js";
29
+
30
+ // src/modules/from-vitepress.ts
31
+ function vitepressMarkdown() {
32
+ const hooks = {};
33
+ for (const [name, hook] of Object.entries(VITEPRESS_HOOKS)) hooks[name] = (value, context) => hook(value, { htmlUrls: context.urls === "html" });
34
+ return { before: vitepressBefore, after: vitepressAfter, hooks };
35
+ }
36
+ var VITEPRESS_DEFAULTS = { headingIds: "vitepress", autolinks: "email" };
37
+ function fromVitepress(options = {}) {
38
+ return { name: "fromVitepress", builtin: "ssqch/from-vitepress", options };
39
+ }
40
+ BUILTINS.set("ssqch/from-vitepress", (config, given) => {
41
+ new Options(given, []);
42
+ addMarkdownSteps(config.markdown.steps, 'plugin "fromVitepress"', vitepressMarkdown());
43
+ const own = Object.fromEntries(Object.entries(VITEPRESS_DEFAULTS).filter(([key]) => !config.markdownGiven.has(key)));
44
+ if (Object.keys(own).length) applyMarkdownOptions(config.markdown, own, "module");
45
+ config.vitepress = true;
46
+ });
47
+ export {
48
+ fromVitepress
49
+ };
package/lib/image.js CHANGED
@@ -4,21 +4,22 @@ import {
4
4
  image,
5
5
  imagePlugin,
6
6
  imageUrl
7
- } from "./chunk-V2FSMOFX.js";
8
- import "./chunk-RBNPBTDP.js";
9
- import "./chunk-Z44IAMNG.js";
10
- import "./chunk-2QTJTEBV.js";
11
- import "./chunk-ERAIEV3O.js";
7
+ } from "./chunk-55WXDGO4.js";
8
+ import "./chunk-SNQOHNXE.js";
9
+ import "./chunk-VILOEVK7.js";
10
+ import "./chunk-ULCT3PAV.js";
11
+ import "./chunk-6U5VIQVY.js";
12
12
  import "./chunk-AD3HAW3W.js";
13
13
  import "./chunk-YCOTX2VM.js";
14
- import "./chunk-GS5B3CBW.js";
15
- import "./chunk-JC54PHIT.js";
16
- import "./chunk-HFSWUTXX.js";
14
+ import "./chunk-DDV6JEC2.js";
15
+ import "./chunk-6OUCRDYI.js";
16
+ import "./chunk-SPIFZBIW.js";
17
17
  import "./chunk-FVZ5JBRI.js";
18
- import "./chunk-UU43WIZG.js";
19
- import "./chunk-IOBC665M.js";
18
+ import "./chunk-FJML7INB.js";
19
+ import "./chunk-4AZFCSGJ.js";
20
20
  import "./chunk-CMUWRPSQ.js";
21
- import "./chunk-AIMEXBTK.js";
21
+ import "./chunk-YNJNMQWU.js";
22
+ import "./chunk-VJWQSYEG.js";
22
23
  import "./chunk-I3PS26CI.js";
23
24
  export {
24
25
  image,
package/lib/links.js CHANGED
@@ -2,40 +2,42 @@ import { createRequire as __ssqchCreateRequire } from "node:module";
2
2
  const require = __ssqchCreateRequire(import.meta.url);
3
3
  import {
4
4
  Options
5
- } from "./chunk-RBNPBTDP.js";
5
+ } from "./chunk-SNQOHNXE.js";
6
6
  import {
7
7
  BUILTINS,
8
8
  rewriteHtml
9
- } from "./chunk-Z44IAMNG.js";
10
- import "./chunk-2QTJTEBV.js";
9
+ } from "./chunk-VILOEVK7.js";
10
+ import "./chunk-ULCT3PAV.js";
11
11
  import {
12
12
  count
13
- } from "./chunk-ERAIEV3O.js";
13
+ } from "./chunk-6U5VIQVY.js";
14
14
  import "./chunk-AD3HAW3W.js";
15
15
  import "./chunk-YCOTX2VM.js";
16
16
  import {
17
17
  dirsOf
18
- } from "./chunk-GS5B3CBW.js";
19
- import "./chunk-JC54PHIT.js";
20
- import "./chunk-HFSWUTXX.js";
18
+ } from "./chunk-DDV6JEC2.js";
19
+ import "./chunk-6OUCRDYI.js";
20
+ import "./chunk-SPIFZBIW.js";
21
21
  import {
22
22
  closest,
23
23
  closestPathFinder
24
24
  } from "./chunk-FVZ5JBRI.js";
25
25
  import {
26
26
  TRAIL_GOES_COLD
27
- } from "./chunk-UU43WIZG.js";
28
- import "./chunk-IOBC665M.js";
27
+ } from "./chunk-FJML7INB.js";
28
+ import "./chunk-4AZFCSGJ.js";
29
29
  import "./chunk-CMUWRPSQ.js";
30
30
  import {
31
31
  Diagnostics,
32
32
  bail,
33
- compareText,
34
33
  error,
35
34
  isCapturing,
36
35
  warn,
37
36
  warning
38
- } from "./chunk-AIMEXBTK.js";
37
+ } from "./chunk-YNJNMQWU.js";
38
+ import {
39
+ compareText
40
+ } from "./chunk-VJWQSYEG.js";
39
41
  import "./chunk-I3PS26CI.js";
40
42
 
41
43
  // src/modules/links.ts