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
@@ -5,7 +5,7 @@ import {
5
5
  } from "./chunk-FVZ5JBRI.js";
6
6
  import {
7
7
  bail
8
- } from "./chunk-AIMEXBTK.js";
8
+ } from "./chunk-YNJNMQWU.js";
9
9
 
10
10
  // src/modules/options.ts
11
11
  var Options = class {
@@ -5,7 +5,7 @@ import {
5
5
  } from "./chunk-CMUWRPSQ.js";
6
6
  import {
7
7
  bail
8
- } from "./chunk-AIMEXBTK.js";
8
+ } from "./chunk-YNJNMQWU.js";
9
9
 
10
10
  // src/glob.ts
11
11
  var stripDot = (p) => p.replace(/^(\.\/)+/, "");
@@ -5,21 +5,22 @@ import {
5
5
  capabilities,
6
6
  modules,
7
7
  runCapabilities
8
- } from "./chunk-GJNIQAIH.js";
9
- import "./chunk-B5E27PLU.js";
10
- import "./chunk-Z44IAMNG.js";
11
- import "./chunk-2QTJTEBV.js";
12
- import "./chunk-ERAIEV3O.js";
8
+ } from "./chunk-GSNRAGKQ.js";
9
+ import "./chunk-FENJHLNM.js";
10
+ import "./chunk-VILOEVK7.js";
11
+ import "./chunk-ULCT3PAV.js";
12
+ import "./chunk-6U5VIQVY.js";
13
13
  import "./chunk-AD3HAW3W.js";
14
14
  import "./chunk-YCOTX2VM.js";
15
- import "./chunk-GS5B3CBW.js";
16
- import "./chunk-JC54PHIT.js";
17
- import "./chunk-HFSWUTXX.js";
15
+ import "./chunk-DDV6JEC2.js";
16
+ import "./chunk-6OUCRDYI.js";
17
+ import "./chunk-SPIFZBIW.js";
18
18
  import "./chunk-FVZ5JBRI.js";
19
- import "./chunk-UU43WIZG.js";
20
- import "./chunk-IOBC665M.js";
19
+ import "./chunk-FJML7INB.js";
20
+ import "./chunk-4AZFCSGJ.js";
21
21
  import "./chunk-CMUWRPSQ.js";
22
- import "./chunk-AIMEXBTK.js";
22
+ import "./chunk-YNJNMQWU.js";
23
+ import "./chunk-VJWQSYEG.js";
23
24
  import "./chunk-I3PS26CI.js";
24
25
  export {
25
26
  MODULE_EXPORTS,
@@ -6,9 +6,10 @@ import {
6
6
  globSet,
7
7
  globToRegExp,
8
8
  isGlob
9
- } from "./chunk-HFSWUTXX.js";
9
+ } from "./chunk-SPIFZBIW.js";
10
10
  import "./chunk-CMUWRPSQ.js";
11
- import "./chunk-AIMEXBTK.js";
11
+ import "./chunk-YNJNMQWU.js";
12
+ import "./chunk-VJWQSYEG.js";
12
13
  import "./chunk-I3PS26CI.js";
13
14
  export {
14
15
  globBase,
@@ -2,21 +2,22 @@ import { createRequire as __ssqchCreateRequire } from "node:module";
2
2
  const require = __ssqchCreateRequire(import.meta.url);
3
3
  import {
4
4
  modules
5
- } from "./chunk-GJNIQAIH.js";
5
+ } from "./chunk-GSNRAGKQ.js";
6
6
  import {
7
7
  BUILTIN_FILTERS
8
- } from "./chunk-GLJQ4C76.js";
8
+ } from "./chunk-V3G2QGL3.js";
9
+ import "./chunk-25WERNDD.js";
9
10
  import {
10
11
  longHelp
11
12
  } from "./chunk-RIAOXEXC.js";
12
13
  import {
13
14
  agentsMd
14
- } from "./chunk-B5E27PLU.js";
15
+ } from "./chunk-FENJHLNM.js";
15
16
  import {
16
17
  configOptions
17
- } from "./chunk-Z44IAMNG.js";
18
- import "./chunk-2QTJTEBV.js";
19
- import "./chunk-ERAIEV3O.js";
18
+ } from "./chunk-VILOEVK7.js";
19
+ import "./chunk-ULCT3PAV.js";
20
+ import "./chunk-6U5VIQVY.js";
20
21
  import {
21
22
  VERSION
22
23
  } from "./chunk-AD3HAW3W.js";
@@ -25,14 +26,14 @@ import {
25
26
  bundledNames,
26
27
  types
27
28
  } from "./chunk-YCOTX2VM.js";
28
- import "./chunk-GS5B3CBW.js";
29
- import "./chunk-JC54PHIT.js";
30
- import "./chunk-HFSWUTXX.js";
29
+ import "./chunk-DDV6JEC2.js";
30
+ import "./chunk-6OUCRDYI.js";
31
+ import "./chunk-SPIFZBIW.js";
31
32
  import {
32
33
  closest
33
34
  } from "./chunk-FVZ5JBRI.js";
34
- import "./chunk-UU43WIZG.js";
35
- import "./chunk-IOBC665M.js";
35
+ import "./chunk-FJML7INB.js";
36
+ import "./chunk-4AZFCSGJ.js";
36
37
  import "./chunk-CMUWRPSQ.js";
37
38
  import {
38
39
  OTHER_CONFIGS,
@@ -40,7 +41,8 @@ import {
40
41
  jsYaml,
41
42
  red,
42
43
  toJson
43
- } from "./chunk-AIMEXBTK.js";
44
+ } from "./chunk-YNJNMQWU.js";
45
+ import "./chunk-VJWQSYEG.js";
44
46
  import "./chunk-I3PS26CI.js";
45
47
 
46
48
  // src/commands/docs.ts
@@ -293,11 +295,15 @@ function also(all, name, not) {
293
295
  found.sort((a, b) => b[1] - a[1] || a[0] - b[0]);
294
296
  return found.map(([i]) => i).slice(0, 4);
295
297
  }
298
+ function plainTitle(title) {
299
+ const at = /[:?] /.exec(title);
300
+ return at ? title.slice(at.index + 2) : title;
301
+ }
296
302
  function heading(all, query) {
297
303
  const q = words(query);
298
304
  if (q.length === 0) return void 0;
299
305
  const anchor = query.replace(/^#+/, "");
300
- const exact = all.findIndex((s) => words(s.title).join(" ") === q.join(" ") || slug(s.title) === anchor);
306
+ const exact = all.findIndex((s) => words(s.title).join(" ") === q.join(" ") || words(plainTitle(s.title)).join(" ") === q.join(" ") || slug(s.title) === anchor);
301
307
  if (exact !== -1) return exact;
302
308
  let best;
303
309
  all.forEach((s, i) => {
@@ -410,7 +416,7 @@ function answerText(all, a) {
410
416
  `;
411
417
  if (described.length) out += "\n";
412
418
  if (a.section !== void 0 && a.passages.length) {
413
- out += `From "${all[a.section].title}" (ssqch docs "${all[a.section].title}"):
419
+ out += `From "${all[a.section].title}" (ssqch docs "${plainTitle(all[a.section].title)}"):
414
420
 
415
421
  ${a.passages.join("\n\n")}
416
422
  `;
@@ -635,9 +641,10 @@ ${body.trim()}
635
641
  return out(json ? JSON.stringify({ query, found: true, page: { file: `site/src/docs/${page.file}`, url: guideUrl(page.file.replace(/^trailheads\//, "")), text } }, null, 2) + "\n" : text);
636
642
  }
637
643
  }
638
- const a = page?.title !== void 0 ? { query, names: [], passages: [], also: [], section: all.findIndex((s) => s.level <= 2 && s.title === page.title) } : answer(grammar, all, known, query);
644
+ const trail = page === void 0 ? trailheadSection(query) : void 0;
645
+ const exact = trail !== void 0 && !known.some((n) => n.name === query) && !all.some((s) => s.title.toLowerCase() === query.trim().toLowerCase() || plainTitle(s.title).toLowerCase() === query.trim().toLowerCase());
646
+ const a = page?.title !== void 0 ? { query, names: [], passages: [], also: [], section: all.findIndex((s) => s.level <= 2 && s.title === page.title) } : exact ? void 0 : answer(grammar, all, known, query);
639
647
  if (a && a.section !== -1) return out(json ? JSON.stringify(answerJson(all, a), null, 2) + "\n" : answerText(all, a));
640
- const trail = trailheadSection(query);
641
648
  if (trail) return out(json ? JSON.stringify({ query, found: true, trailhead: trail }, null, 2) + "\n" : `From "${trail.page}" (ssqch docs --from ${trail.generator}):
642
649
 
643
650
  ${trail.text}`);
@@ -657,6 +664,7 @@ export {
657
664
  docsPage,
658
665
  docsText,
659
666
  names,
667
+ plainTitle,
660
668
  runDocs,
661
669
  sections,
662
670
  slug,
@@ -2,12 +2,12 @@ import { createRequire as __ssqchCreateRequire } from "node:module";
2
2
  const require = __ssqchCreateRequire(import.meta.url);
3
3
  import {
4
4
  BUDGETS
5
- } from "./chunk-2QTJTEBV.js";
5
+ } from "./chunk-ULCT3PAV.js";
6
6
  import {
7
7
  bytes,
8
8
  count,
9
9
  fixed
10
- } from "./chunk-ERAIEV3O.js";
10
+ } from "./chunk-6U5VIQVY.js";
11
11
  import {
12
12
  padEnd,
13
13
  padStart
@@ -15,10 +15,12 @@ import {
15
15
  import {
16
16
  BuildError,
17
17
  bail,
18
- compareText,
19
- realPath,
20
18
  warning
21
- } from "./chunk-AIMEXBTK.js";
19
+ } from "./chunk-YNJNMQWU.js";
20
+ import {
21
+ compareText,
22
+ realPath
23
+ } from "./chunk-VJWQSYEG.js";
22
24
 
23
25
  // src/footprint.ts
24
26
  import fs from "node:fs";
@@ -8,7 +8,7 @@ import {
8
8
  } from "./chunk-CMUWRPSQ.js";
9
9
  import {
10
10
  bail
11
- } from "./chunk-AIMEXBTK.js";
11
+ } from "./chunk-YNJNMQWU.js";
12
12
 
13
13
  // src/budgets.ts
14
14
  var BUDGETS = [
@@ -4,14 +4,15 @@ import {
4
4
  BUILTINS,
5
5
  DEFAULTS,
6
6
  EngineCache,
7
+ addMkdocsTheme,
7
8
  configOptions,
8
9
  findConfig,
9
10
  loadConfig,
10
11
  meant,
11
12
  tomlKeyLine
12
- } from "./chunk-Z44IAMNG.js";
13
- import "./chunk-2QTJTEBV.js";
14
- import "./chunk-ERAIEV3O.js";
13
+ } from "./chunk-VILOEVK7.js";
14
+ import "./chunk-ULCT3PAV.js";
15
+ import "./chunk-6U5VIQVY.js";
15
16
  import "./chunk-AD3HAW3W.js";
16
17
  import "./chunk-YCOTX2VM.js";
17
18
  import {
@@ -20,20 +21,22 @@ import {
20
21
  parseEnvironment,
21
22
  shownDir,
22
23
  shownOutput
23
- } from "./chunk-GS5B3CBW.js";
24
- import "./chunk-JC54PHIT.js";
25
- import "./chunk-HFSWUTXX.js";
24
+ } from "./chunk-DDV6JEC2.js";
25
+ import "./chunk-6OUCRDYI.js";
26
+ import "./chunk-SPIFZBIW.js";
26
27
  import "./chunk-FVZ5JBRI.js";
27
- import "./chunk-UU43WIZG.js";
28
- import "./chunk-IOBC665M.js";
28
+ import "./chunk-FJML7INB.js";
29
+ import "./chunk-4AZFCSGJ.js";
29
30
  import "./chunk-CMUWRPSQ.js";
30
- import "./chunk-AIMEXBTK.js";
31
+ import "./chunk-YNJNMQWU.js";
32
+ import "./chunk-VJWQSYEG.js";
31
33
  import "./chunk-I3PS26CI.js";
32
34
  export {
33
35
  BUILTINS,
34
36
  CONFIG_FILES,
35
37
  DEFAULTS,
36
38
  EngineCache,
39
+ addMkdocsTheme,
37
40
  configOptions,
38
41
  dirsOf,
39
42
  findConfig,
@@ -1,118 +1,27 @@
1
1
  import { createRequire as __ssqchCreateRequire } from "node:module";
2
2
  const require = __ssqchCreateRequire(import.meta.url);
3
+ import {
4
+ escapeText,
5
+ headings,
6
+ htmlText,
7
+ splitWhitespace,
8
+ toc
9
+ } from "./chunk-25WERNDD.js";
3
10
  import {
4
11
  withBase
5
- } from "./chunk-Z44IAMNG.js";
12
+ } from "./chunk-VILOEVK7.js";
6
13
  import {
7
14
  slugOptions,
8
15
  slugText,
9
16
  slugWith
10
- } from "./chunk-JC54PHIT.js";
17
+ } from "./chunk-6OUCRDYI.js";
11
18
  import {
12
19
  BuildError,
13
- compareText,
14
20
  isPlainObject
15
- } from "./chunk-AIMEXBTK.js";
16
-
17
- // src/content.ts
18
- var HEADING = /<h([1-6])(\s[^>]*)?>(.*?)<\/h[1-6]\s*>/gis;
19
- var ID_ATTR = /(?:^|\s)id\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s"'>]+))/i;
20
- var TAG = /<(\/?)([A-Za-z][A-Za-z0-9-]*)([^>]*)>|<!--.*?-->/gs;
21
- var HIDDEN = /\saria-hidden\s*=\s*["']?true/i;
22
- var CODE = /<!--.*?-->|<(pre|script|style|template|textarea)\b.*?<\/(?:pre|script|style|template|textarea)\s*>/gis;
23
- var CODE_WITH_HEADING = /<code\b(?:(?!<\/code\s*>).)*?<h[1-6][\s>](?:(?!<\/code\s*>).)*<\/code\s*>/gis;
24
- var VOID = /* @__PURE__ */ new Set(["area", "base", "br", "col", "embed", "hr", "img", "input", "link", "meta", "param", "source", "track", "wbr"]);
25
- function headings(html) {
26
- if (!html.includes("<h") && !html.includes("<H")) return [];
27
- const out = [];
28
- for (const found of html.replace(CODE, "").replace(CODE_WITH_HEADING, "").matchAll(HEADING)) {
29
- const id = ID_ATTR.exec(found[2] ?? "");
30
- const value = id ? id[1] ?? id[2] ?? id[3] : void 0;
31
- out.push({ level: Number(found[1]), id: value === void 0 ? void 0 : decodeEntities(value), text: htmlText(found[3]) });
32
- }
33
- return out;
34
- }
35
- function htmlText(html) {
36
- let text = "";
37
- let hidden = 0;
38
- let last = 0;
39
- for (const found of html.matchAll(TAG)) {
40
- if (hidden === 0) text += html.slice(last, found.index);
41
- last = found.index + found[0].length;
42
- if (found[2] === void 0) continue;
43
- const name = found[2].toLowerCase();
44
- const attrs = found[3] ?? "";
45
- if (VOID.has(name) || attrs.endsWith("/")) {
46
- if (name === "br" && hidden === 0) text += " ";
47
- continue;
48
- }
49
- if (found[1] === "/") hidden = Math.max(0, hidden - 1);
50
- else if (hidden > 0 || HIDDEN.test(attrs)) hidden++;
51
- }
52
- if (hidden === 0) text += html.slice(last);
53
- return splitWhitespace(decodeEntities(text)).join(" ");
54
- }
55
- function splitWhitespace(text) {
56
- return text.split(/[\t-\r \u0085\u00a0\u1680\u2000-\u200a\u2028\u2029\u202f\u205f\u3000]+/).filter((word) => word !== "");
57
- }
58
- var ENTITY = /&(#[0-9]{1,7}|#[xX][0-9A-Fa-f]{1,6}|[A-Za-z]+);/g;
59
- var NAMED = { amp: "&", lt: "<", gt: ">", quot: '"', apos: "'", nbsp: "\xA0" };
60
- function decodeEntities(s) {
61
- if (!s.includes("&")) return s;
62
- return s.replace(ENTITY, (whole, name) => {
63
- if (Object.hasOwn(NAMED, name)) return NAMED[name];
64
- if (name[0] !== "#") return whole;
65
- const code = name[1] === "x" || name[1] === "X" ? Number.parseInt(name.slice(2), 16) : Number.parseInt(name.slice(1), 10);
66
- return code <= 1114111 && !(code >= 55296 && code <= 57343) ? String.fromCodePoint(code) : whole;
67
- });
68
- }
69
- function escapeText(s) {
70
- return s.replace(/[&<>"]/g, (c) => c === "&" ? "&amp;" : c === "<" ? "&lt;" : c === ">" ? "&gt;" : "&quot;");
71
- }
72
- function escapeHtml(s) {
73
- return s.replace(/[&<>"']/g, (c) => c === "&" ? "&amp;" : c === "<" ? "&lt;" : c === ">" ? "&gt;" : c === '"' ? "&quot;" : "&#39;");
74
- }
75
- function excerpt(html) {
76
- const more = /<!--\s*more\s*-->/.exec(html);
77
- if (more) return html.slice(0, more.index).trim();
78
- return /<p(?:\s[^>]*)?>.*?<\/p>/is.exec(html)?.[0];
79
- }
80
- function toc(list, from, to, ordered, markup = {}) {
81
- const tag = ordered ? "ol" : "ul";
82
- const attr = (name, value) => value ? ` ${name}="${escapeHtml(value)}"` : "";
83
- const open = (outer) => `<${tag}${outer ? attr("id", markup.id) + attr("class", markup.class) : attr("class", markup.sublistClass)}>`;
84
- const link = attr("class", markup.linkClass);
85
- const items = [];
86
- for (const v of list) {
87
- const h = v;
88
- if (typeof h?.level !== "number") continue;
89
- const level = Math.trunc(h.level);
90
- const id = typeof h.id === "string" && h.id !== "" ? h.id : void 0;
91
- if (id !== void 0 && level >= from && level <= to) items.push({ level, id, text: String(h.text) });
92
- }
93
- let out = "";
94
- const stack = [];
95
- for (const h of items) {
96
- if (!stack.length) {
97
- out += open(true);
98
- stack.push(h.level);
99
- } else {
100
- while (stack.length > 1 && h.level < stack[stack.length - 1]) {
101
- out += `</li></${tag}>`;
102
- stack.pop();
103
- }
104
- if (h.level > stack[stack.length - 1]) {
105
- out += open(false);
106
- stack.push(h.level);
107
- } else {
108
- out += "</li>";
109
- }
110
- }
111
- out += `<li${attr("class", markup.itemClass?.replaceAll("{level}", String(h.level)))}><a href="#${escapeHtml(h.id ?? "")}"${link}>${escapeText(h.text)}</a>`;
112
- }
113
- for (const _ of stack) out += `</li></${tag}>`;
114
- return out;
115
- }
21
+ } from "./chunk-YNJNMQWU.js";
22
+ import {
23
+ compareText
24
+ } from "./chunk-VJWQSYEG.js";
116
25
 
117
26
  // src/nav.ts
118
27
  var CHILD_KEYS = ["children", "items", "pages"];
@@ -396,8 +305,6 @@ function builtinFilters(markdown, config) {
396
305
  }
397
306
 
398
307
  export {
399
- headings,
400
- excerpt,
401
308
  BUILTIN_FILTERS,
402
309
  builtinFilters
403
310
  };
@@ -2,11 +2,11 @@ import { createRequire as __ssqchCreateRequire } from "node:module";
2
2
  const require = __ssqchCreateRequire(import.meta.url);
3
3
  import {
4
4
  budget
5
- } from "./chunk-2QTJTEBV.js";
5
+ } from "./chunk-ULCT3PAV.js";
6
6
  import {
7
7
  bytes,
8
8
  count
9
- } from "./chunk-ERAIEV3O.js";
9
+ } from "./chunk-6U5VIQVY.js";
10
10
  import {
11
11
  VERSION
12
12
  } from "./chunk-AD3HAW3W.js";
@@ -15,9 +15,10 @@ import {
15
15
  } from "./chunk-YCOTX2VM.js";
16
16
  import {
17
17
  CONFIG_FILES
18
- } from "./chunk-GS5B3CBW.js";
18
+ } from "./chunk-DDV6JEC2.js";
19
19
  import {
20
20
  WebAssembly,
21
+ addMarkdownSteps,
21
22
  applyMarkdownOptions,
22
23
  checkLanguages,
23
24
  defaultMarkdownOptions,
@@ -26,11 +27,11 @@ import {
26
27
  site,
27
28
  undecodable,
28
29
  withPage
29
- } from "./chunk-JC54PHIT.js";
30
+ } from "./chunk-6OUCRDYI.js";
30
31
  import {
31
32
  globProblem,
32
33
  globToRegExp
33
- } from "./chunk-HFSWUTXX.js";
34
+ } from "./chunk-SPIFZBIW.js";
34
35
  import {
35
36
  closest
36
37
  } from "./chunk-FVZ5JBRI.js";
@@ -41,7 +42,7 @@ import {
41
42
  loadedFiles,
42
43
  settle,
43
44
  watchSettle
44
- } from "./chunk-IOBC665M.js";
45
+ } from "./chunk-4AZFCSGJ.js";
45
46
  import {
46
47
  charCount,
47
48
  firstChars,
@@ -55,9 +56,7 @@ import {
55
56
  TomlError,
56
57
  aliasUsed,
57
58
  bail,
58
- compareText,
59
59
  context,
60
- displayPath,
61
60
  error,
62
61
  find,
63
62
  isPlainObject,
@@ -65,13 +64,17 @@ import {
65
64
  otherGenerator,
66
65
  progress,
67
66
  readToml,
68
- realPath,
69
- shown,
70
67
  toDate,
71
68
  tomlReason,
72
69
  warn,
73
70
  warning
74
- } from "./chunk-AIMEXBTK.js";
71
+ } from "./chunk-YNJNMQWU.js";
72
+ import {
73
+ compareText,
74
+ displayPath,
75
+ realPath,
76
+ shown
77
+ } from "./chunk-VJWQSYEG.js";
75
78
  import {
76
79
  __require
77
80
  } from "./chunk-I3PS26CI.js";
@@ -3355,13 +3358,13 @@ function emptyConfig(options) {
3355
3358
  ignore: [],
3356
3359
  bundles: false,
3357
3360
  strict: false,
3358
- trimAfterFrontMatter: false,
3359
3361
  jekyllTemplates: false,
3360
3362
  mkdocsTemplates: null,
3361
3363
  jinjaAutoescape: null,
3362
3364
  lastModified: null,
3363
3365
  dateFallback: "file",
3364
3366
  timeZone: null,
3367
+ urls: "folders",
3365
3368
  layoutAliases: /* @__PURE__ */ new Map(),
3366
3369
  base: "",
3367
3370
  serveRun: [],
@@ -3377,6 +3380,8 @@ function emptyConfig(options) {
3377
3380
  collections: [],
3378
3381
  transforms: [],
3379
3382
  htmlTransforms: [],
3383
+ markdownGiven: /* @__PURE__ */ new Set(),
3384
+ vitepress: false,
3380
3385
  engines: /* @__PURE__ */ new Map(),
3381
3386
  engineCaches: [],
3382
3387
  beforeBuild: [],
@@ -3385,6 +3390,7 @@ function emptyConfig(options) {
3385
3390
  plugins: [],
3386
3391
  summaries: [],
3387
3392
  generators: [],
3393
+ componentRenderers: [],
3388
3394
  fileBuilders: [],
3389
3395
  settle: []
3390
3396
  };
@@ -3473,7 +3479,7 @@ var EngineCache = class {
3473
3479
  this.now.set(source, html);
3474
3480
  }
3475
3481
  };
3476
- var SETTINGS = ["dirs", "templateFormats", "markdownEngine", "htmlEngine", "markdown", "deepMerge", "leaveNoTrace", "clean", "ignore", "bundles", "strict", "trimAfterFrontMatter", "jekyllTemplates", "mkdocsTemplates", "jinja", "lastModified", "dateFallback", "timeZone", "layoutAliases", "base", "schemas", "theme", "serve", "budgets"];
3482
+ var SETTINGS = ["dirs", "templateFormats", "markdownEngine", "htmlEngine", "markdown", "deepMerge", "leaveNoTrace", "ignore", "bundles", "strict", "jinja", "lastModified", "dateFallback", "timeZone", "urls", "layoutAliases", "base", "schemas", "theme", "serve", "budgets"];
3477
3483
  var PARTS = ["data", "filters", "collections", "transforms", "engines", "passthrough", "watch", "beforeBuild", "afterBuild", "plugins"];
3478
3484
  var CORE_ENGINES = ["edge", "html", "txt"];
3479
3485
  var DIRS = ["input", "output", "includes", "layouts", "data"];
@@ -3502,6 +3508,11 @@ function meant(key, options) {
3502
3508
  return best ? ` (did you mean "${best.option}"?)` : "";
3503
3509
  }
3504
3510
  var configWord = (key) => find(key, "config");
3511
+ var RETIRED = {
3512
+ jekyllTemplates: "it's fromJekyll() from \"ssqch/from-jekyll\" now, which also turns on kramdown's Markdown (`fromJekyll({ kramdown: false })` leaves that out): add it to plugins (`ssqch docs fromJekyll`)",
3513
+ mkdocsTemplates: 'it\'s fromMkdocs({ templates: true }) from "ssqch/from-mkdocs" now (`config: "docs/mkdocs.yml"` names another mkdocs.yml), which also turns on MkDocs\' Markdown: add it to plugins (`ssqch docs fromMkdocs`)',
3514
+ trimAfterFrontMatter: "the blank lines after a template's front matter are whitespace between tags in HTML, which browsers and `ssqch diff` read as the same. Where one matters (a feed that has to start with `<?xml`, a text file), take it out of that template: `ssqch scout --patch` does it for a Jekyll site"
3515
+ };
3505
3516
  var fail = (message) => {
3506
3517
  throw new TypeError(message);
3507
3518
  };
@@ -3541,7 +3552,7 @@ function aliased(part, where) {
3541
3552
  return out;
3542
3553
  }
3543
3554
  var BUILTINS = /* @__PURE__ */ new Map();
3544
- var BUILTIN_NAMES = ["ssqch/rss", "ssqch/image", "ssqch/minify", "ssqch/assets", "ssqch/links", "ssqch/sitemap", "ssqch/redirects", "ssqch/sass", "ssqch/elements"];
3555
+ var BUILTIN_NAMES = ["ssqch/rss", "ssqch/image", "ssqch/minify", "ssqch/assets", "ssqch/links", "ssqch/sitemap", "ssqch/redirects", "ssqch/sass", "ssqch/elements", "ssqch/llms", "ssqch/vue", "ssqch/robots", "ssqch/from-mkdocs", "ssqch/from-jekyll", "ssqch/from-hugo", "ssqch/from-vitepress"];
3545
3556
  async function loadJs(config, file) {
3546
3557
  const name = path7.basename(file);
3547
3558
  const { root, env, serving } = config;
@@ -3621,6 +3632,7 @@ async function loadJs(config, file) {
3621
3632
  let guessed = false;
3622
3633
  for (const key of Object.keys(part)) {
3623
3634
  if ((key === "name" || key === "rust") && !top) continue;
3635
+ if (!top && (key === "markdown" || key === "defaults")) continue;
3624
3636
  if (SETTINGS.includes(key)) {
3625
3637
  if (!top) fail(`${where}: "${key}" can only be set in the config itself, not in a plugin`);
3626
3638
  } else if (!PARTS.includes(key)) {
@@ -3635,6 +3647,10 @@ async function loadJs(config, file) {
3635
3647
  More: ${equivalent.more}`);
3636
3648
  continue;
3637
3649
  }
3650
+ if (top && Object.hasOwn(RETIRED, key)) {
3651
+ unknown.push(`${where}: "${key}" is gone: ${RETIRED[key]}`);
3652
+ continue;
3653
+ }
3638
3654
  const hint = top && DIRS.includes(key) ? ` (it goes in dirs: { ${key}: "..." })` : meant(key, options);
3639
3655
  unknown.push(`${where}: "${key}" isn't a config option${hint}`);
3640
3656
  guessed = true;
@@ -3644,6 +3660,27 @@ async function loadJs(config, file) {
3644
3660
  const options = top ? [...SETTINGS, ...PARTS] : PARTS;
3645
3661
  fail(unknown.join("\n") + (guessed ? ` (options: ${options.join(", ")})` : ""));
3646
3662
  }
3663
+ if (!top && part.markdown !== void 0) {
3664
+ const steps = part.markdown;
3665
+ ops.push(() => {
3666
+ addMarkdownSteps(config.markdown.steps, where, steps);
3667
+ });
3668
+ }
3669
+ if (!top && part.defaults !== void 0) {
3670
+ const defaults = part.defaults;
3671
+ if (!isObject2(defaults)) fail(`${where}: defaults must be an object, like { markdown: { headingIds: "ascii" } }`);
3672
+ for (const key of Object.keys(defaults)) if (key !== "markdown") fail(`${where}: defaults.${key}: a plugin's defaults can be markdown options only`);
3673
+ if (defaults.markdown !== void 0 && !isObject2(defaults.markdown)) fail(`${where}: defaults.markdown must be an object of markdown options`);
3674
+ ops.push(() => {
3675
+ const own = Object.fromEntries(Object.entries(defaults.markdown ?? {}).filter(([key]) => !config.markdownGiven.has(key)));
3676
+ if (!Object.keys(own).length) return;
3677
+ try {
3678
+ applyMarkdownOptions(config.markdown, own);
3679
+ } catch (e) {
3680
+ throw context(e, `${where}: defaults`);
3681
+ }
3682
+ });
3683
+ }
3647
3684
  if (!top && part.rust !== void 0) {
3648
3685
  const rust = loadRustPart(part.rust, where, root);
3649
3686
  if (rust.transform) {
@@ -3815,30 +3852,21 @@ function applySettings(config, settings) {
3815
3852
  else bail(`${key} must be a string or false, not ${typeof value}`);
3816
3853
  }
3817
3854
  if (settings.markdown !== void 0) applyMarkdownOptions(config.markdown, settings.markdown);
3855
+ if (isObject2(settings.markdown)) config.markdownGiven = new Set(Object.keys(settings.markdown));
3818
3856
  checkLanguages(config.markdown, config.root);
3819
3857
  if (settings.deepMerge !== void 0) {
3820
3858
  if (typeof settings.deepMerge !== "boolean") bail(`deepMerge must be true or false, not ${typeof settings.deepMerge}`);
3821
3859
  config.deepMerge = settings.deepMerge;
3822
3860
  }
3823
- let trace;
3824
- for (const key of ["leaveNoTrace", "clean"]) {
3825
- const value = settings[key];
3826
- if (value === void 0) continue;
3827
- if (typeof value !== "boolean") bail(`${key} must be true or false, not ${typeof value}`);
3828
- if (trace !== void 0) bail("leaveNoTrace and clean are two names for one option; set one of them");
3829
- trace = value;
3830
- }
3861
+ const trace = settings.leaveNoTrace;
3862
+ if (trace !== void 0 && typeof trace !== "boolean") bail(`leaveNoTrace must be true or false, not ${typeof trace}`);
3831
3863
  if (trace !== void 0) config.leaveNoTrace = trace;
3832
- for (const key of ["bundles", "strict", "trimAfterFrontMatter", "jekyllTemplates"]) {
3864
+ for (const key of ["bundles", "strict"]) {
3833
3865
  const value = settings[key];
3834
3866
  if (value === void 0) continue;
3835
3867
  if (typeof value !== "boolean") bail(`${key} must be true or false, not ${typeof value}`);
3836
3868
  config[key] = value;
3837
3869
  }
3838
- const mkdocs = settings.mkdocsTemplates;
3839
- if (mkdocs === true) config.mkdocsTemplates = "mkdocs.yml";
3840
- else if (typeof mkdocs === "string" && mkdocs.trim() !== "") config.mkdocsTemplates = mkdocs;
3841
- else if (mkdocs !== void 0 && mkdocs !== false && mkdocs !== null) bail(`mkdocsTemplates must be true, false or the path of an mkdocs.yml, not ${typeof mkdocs === "string" ? "an empty string" : typeof mkdocs}`);
3842
3870
  const jinja = settings.jinja;
3843
3871
  if (isObject2(jinja)) {
3844
3872
  const unknown = Object.keys(jinja).find((k) => k !== "autoescape");
@@ -3855,6 +3883,10 @@ function applySettings(config, settings) {
3855
3883
  if (fallback === "git" || fallback === "file") config.dateFallback = fallback;
3856
3884
  else if (fallback !== void 0 && fallback !== null) bail(`dateFallback must be "git" or "file", not ${typeof fallback === "string" ? `"${fallback}"` : typeof fallback}`);
3857
3885
  if (settings.timeZone !== void 0 && settings.timeZone !== null) config.timeZone = checkTimeZone(settings.timeZone);
3886
+ const urls = settings.urls;
3887
+ if (urls === "folders" || urls === "html") config.urls = urls;
3888
+ else if (urls !== void 0 && urls !== null) bail(`urls must be "folders" (/guide/intro/) or "html" (/guide/intro.html), not ${typeof urls === "string" ? `"${urls}"` : typeof urls}`);
3889
+ config.markdown.htmlUrls = config.urls === "html";
3858
3890
  if (settings.layoutAliases !== void 0 && settings.layoutAliases !== null) {
3859
3891
  if (!isObject2(settings.layoutAliases)) bail(`layoutAliases must be an object of { name: layout }, like { post: "layouts/post.njk" }, not ${typeof settings.layoutAliases}`);
3860
3892
  for (const [name, target] of Object.entries(settings.layoutAliases)) {
@@ -3868,7 +3900,6 @@ function applySettings(config, settings) {
3868
3900
  const theme = settings.theme;
3869
3901
  const themes = theme === void 0 || theme === null || theme === false ? [] : Array.isArray(theme) ? theme : [theme];
3870
3902
  for (const one of themes) addTheme(config, one);
3871
- if (config.mkdocsTemplates !== null) addMkdocsTheme(config);
3872
3903
  if (isObject2(settings.schemas)) {
3873
3904
  for (const [name, spec] of Object.entries(settings.schemas)) {
3874
3905
  const schema = parseSchema(name, spec);
@@ -4081,5 +4112,6 @@ export {
4081
4112
  configOptions,
4082
4113
  meant,
4083
4114
  BUILTINS,
4115
+ addMkdocsTheme,
4084
4116
  tomlKeyLine
4085
4117
  };