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
package/lib/redirects.js CHANGED
@@ -2,33 +2,35 @@ 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
  escapeHtml,
10
10
  withBase
11
- } from "./chunk-Z44IAMNG.js";
12
- import "./chunk-2QTJTEBV.js";
13
- import "./chunk-ERAIEV3O.js";
11
+ } from "./chunk-VILOEVK7.js";
12
+ import "./chunk-ULCT3PAV.js";
13
+ import "./chunk-6U5VIQVY.js";
14
14
  import "./chunk-AD3HAW3W.js";
15
15
  import "./chunk-YCOTX2VM.js";
16
- import "./chunk-GS5B3CBW.js";
17
- import "./chunk-JC54PHIT.js";
18
- import "./chunk-HFSWUTXX.js";
16
+ import "./chunk-DDV6JEC2.js";
17
+ import "./chunk-6OUCRDYI.js";
18
+ import "./chunk-SPIFZBIW.js";
19
19
  import "./chunk-FVZ5JBRI.js";
20
- import "./chunk-UU43WIZG.js";
21
- import "./chunk-IOBC665M.js";
20
+ import "./chunk-FJML7INB.js";
21
+ import "./chunk-4AZFCSGJ.js";
22
22
  import "./chunk-CMUWRPSQ.js";
23
23
  import {
24
24
  bail,
25
+ context
26
+ } from "./chunk-YNJNMQWU.js";
27
+ import {
25
28
  compareText,
26
- context,
27
29
  displayPath,
28
30
  isInside,
29
31
  relative,
30
32
  slashes
31
- } from "./chunk-AIMEXBTK.js";
33
+ } from "./chunk-VJWQSYEG.js";
32
34
  import "./chunk-I3PS26CI.js";
33
35
 
34
36
  // src/modules/redirects.ts
package/lib/robots.js ADDED
@@ -0,0 +1,87 @@
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
+ debugString
9
+ } from "./chunk-VILOEVK7.js";
10
+ import "./chunk-ULCT3PAV.js";
11
+ import "./chunk-6U5VIQVY.js";
12
+ import "./chunk-AD3HAW3W.js";
13
+ import "./chunk-YCOTX2VM.js";
14
+ import "./chunk-DDV6JEC2.js";
15
+ import "./chunk-6OUCRDYI.js";
16
+ import "./chunk-SPIFZBIW.js";
17
+ import "./chunk-FVZ5JBRI.js";
18
+ import "./chunk-FJML7INB.js";
19
+ import "./chunk-4AZFCSGJ.js";
20
+ import "./chunk-CMUWRPSQ.js";
21
+ import {
22
+ bail
23
+ } from "./chunk-YNJNMQWU.js";
24
+ import "./chunk-VJWQSYEG.js";
25
+ import "./chunk-I3PS26CI.js";
26
+
27
+ // src/modules/robots.ts
28
+ function robotsPlugin(options = {}) {
29
+ return { name: "ssqch/robots", builtin: "ssqch/robots", options };
30
+ }
31
+ var CRAWLERS = [
32
+ { token: "GPTBot", purpose: "training", who: "OpenAI", source: "https://developers.openai.com/api/docs/bots" },
33
+ { token: "ClaudeBot", purpose: "training", who: "Anthropic", source: "https://support.claude.com/en/articles/8896518" },
34
+ { token: "Google-Extended", purpose: "training", who: "Google (Gemini; Search isn't affected)", source: "https://specification.website/spec/agent-readiness/robots-for-ai-crawlers/" },
35
+ { token: "Applebot-Extended", purpose: "training", who: "Apple (Apple Intelligence; Siri and Spotlight aren't affected)", source: "https://specification.website/spec/agent-readiness/robots-for-ai-crawlers/" },
36
+ { token: "CCBot", purpose: "training", who: "Common Crawl", source: "https://commoncrawl.org/ccbot" },
37
+ { token: "meta-externalagent", purpose: "training", who: "Meta", source: "https://developers.facebook.com/docs/sharing/webmasters/web-crawlers" },
38
+ { token: "Bytespider", purpose: "training", who: "ByteDance", source: "https://specification.website/spec/agent-readiness/robots-for-ai-crawlers/" },
39
+ { token: "OAI-SearchBot", purpose: "search", who: "OpenAI (ChatGPT search)", source: "https://developers.openai.com/api/docs/bots" },
40
+ { token: "Claude-SearchBot", purpose: "search", who: "Anthropic", source: "https://support.claude.com/en/articles/8896518" },
41
+ { token: "PerplexityBot", purpose: "search", who: "Perplexity", source: "https://docs.perplexity.ai/docs/resources/perplexity-crawlers" },
42
+ { token: "ChatGPT-User", purpose: "fetch", who: "OpenAI", source: "https://developers.openai.com/api/docs/bots" },
43
+ { token: "Claude-User", purpose: "fetch", who: "Anthropic", source: "https://support.claude.com/en/articles/8896518" },
44
+ { token: "Perplexity-User", purpose: "fetch", who: "Perplexity", source: "https://docs.perplexity.ai/docs/resources/perplexity-crawlers" },
45
+ { token: "meta-externalfetcher", purpose: "fetch", who: "Meta", source: "https://developers.facebook.com/docs/sharing/webmasters/web-crawlers" }
46
+ ];
47
+ var PURPOSES = ["training", "search", "fetch"];
48
+ function robotsTxt(disallow, ai, sitemap) {
49
+ const lines = ["User-agent: *", ...disallow.length ? disallow.map((p) => `Disallow: ${p}`) : ["Allow: /"]];
50
+ for (const purpose of PURPOSES) {
51
+ if (ai[purpose]) continue;
52
+ lines.push("", ...CRAWLERS.filter((c) => c.purpose === purpose).map((c) => `User-agent: ${c.token}`), "Disallow: /");
53
+ }
54
+ if (sitemap) lines.push("", `Sitemap: ${sitemap}`);
55
+ return `${lines.join("\n")}
56
+ `;
57
+ }
58
+ BUILTINS.set("ssqch/robots", (config, given) => {
59
+ const o = new Options(given, ["ai", "disallow", "sitemap"]);
60
+ const disallow = o.list("disallow") ?? [];
61
+ for (const p of disallow) if (!p.startsWith("/")) bail(`disallow: ${debugString(p)} must be a URL path starting with /, like "/drafts/"`);
62
+ const ai = { training: true, search: true, fetch: true };
63
+ const given_ = o.get("ai");
64
+ if (given_ !== void 0) {
65
+ if (typeof given_ !== "object" || given_ === null || Array.isArray(given_)) bail("ai must be an object, like { training: false, search: true, fetch: true }");
66
+ for (const [key, value] of Object.entries(given_)) {
67
+ if (!PURPOSES.includes(key)) bail(`ai: unknown purpose "${key}" (purposes: ${PURPOSES.join(", ")})`);
68
+ if (typeof value !== "boolean") bail(`ai.${key} must be true or false`);
69
+ ai[key] = value;
70
+ }
71
+ }
72
+ const sitemap = o.get("sitemap");
73
+ if (sitemap !== void 0 && typeof sitemap !== "boolean" && !(typeof sitemap === "string" && /^https?:\/\//.test(sitemap))) bail(`sitemap must be true, false or the sitemap's whole address, like "https://example.com/sitemap.xml" (got ${debugString(sitemap)})`);
74
+ config.generators.push(["ssqch/robots", (config2) => {
75
+ const named = (v) => typeof v === "string" ? /(^|\/)robots\.txt$/.test(v) : v !== null && typeof v === "object" && Object.entries(v).some(([k, x]) => named(k) || named(x));
76
+ if (config2.passthrough.some(named)) bail("the site copies its own robots.txt (passthrough) and robotsPlugin() writes one: keep one of them. robotsPlugin() writes the sitemap line, `disallow` and the AI crawlers' groups (`ssqch docs robotsPlugin`)");
77
+ let line;
78
+ if (typeof sitemap === "string") line = sitemap;
79
+ else if (sitemap !== false && config2.sitemap) line = config2.sitemap();
80
+ else if (sitemap === true) bail(`sitemap: true needs sitemapPlugin({ url }) in the config, for the sitemap's address (or give the address: sitemap: "https://example.com/sitemap.xml")`);
81
+ const base = config2.base.replace(/\/$/, "");
82
+ return [{ path: "/robots.txt", contents: robotsTxt(disallow.map((p) => base + p), ai, line) }];
83
+ }]);
84
+ });
85
+ export {
86
+ robotsPlugin
87
+ };
package/lib/rss.js CHANGED
@@ -2,30 +2,33 @@ import { createRequire as __ssqchCreateRequire } from "node:module";
2
2
  const require = __ssqchCreateRequire(import.meta.url);
3
3
  import {
4
4
  feedImages
5
- } from "./chunk-V2FSMOFX.js";
5
+ } from "./chunk-55WXDGO4.js";
6
6
  import {
7
7
  Options
8
- } from "./chunk-RBNPBTDP.js";
8
+ } from "./chunk-SNQOHNXE.js";
9
9
  import {
10
10
  BUILTINS,
11
11
  rewriteHtml,
12
12
  withBaseOnce
13
- } from "./chunk-Z44IAMNG.js";
14
- import "./chunk-2QTJTEBV.js";
15
- import "./chunk-ERAIEV3O.js";
13
+ } from "./chunk-VILOEVK7.js";
14
+ import "./chunk-ULCT3PAV.js";
15
+ import "./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
+ aliasUsed,
26
27
  bail,
28
+ find,
27
29
  toDate
28
- } from "./chunk-AIMEXBTK.js";
30
+ } from "./chunk-YNJNMQWU.js";
31
+ import "./chunk-VJWQSYEG.js";
29
32
  import "./chunk-I3PS26CI.js";
30
33
 
31
34
  // src/modules/rss.ts
@@ -112,8 +115,16 @@ BUILTINS.set("ssqch/rss", (config, options) => {
112
115
  filters.set("getNewestCollectionItemDate", (items) => getNewestCollectionItemDate(items));
113
116
  filters.set("dateToRfc3339", (date) => dateToRfc3339(date));
114
117
  filters.set("dateToRfc822", (date) => dateToRfc822(date));
115
- filters.set("rssDate", (date) => dateToRfc3339(date));
116
- filters.set("rssLastUpdatedDate", (items) => dateToRfc3339(getNewestCollectionItemDate(items)));
118
+ const rssDate = find("rssDate", "filter");
119
+ const rssLastUpdatedDate = find("rssLastUpdatedDate", "filter");
120
+ filters.set("rssDate", (date) => {
121
+ aliasUsed(rssDate);
122
+ return dateToRfc3339(date);
123
+ });
124
+ filters.set("rssLastUpdatedDate", (items) => {
125
+ aliasUsed(rssLastUpdatedDate);
126
+ return dateToRfc3339(getNewestCollectionItemDate(items));
127
+ });
117
128
  filters.set("absoluteUrl", (url, base) => absoluteUrl(output(url), output(base), config.base));
118
129
  filters.set("htmlToAbsoluteUrls", (html, base) => htmlToAbsoluteUrls(output(html), output(base), config.base));
119
130
  const unprefixed = (e) => {
package/lib/sass.js CHANGED
@@ -2,22 +2,23 @@ import { createRequire as __ssqchCreateRequire } from "node:module";
2
2
  const require = __ssqchCreateRequire(import.meta.url);
3
3
  import {
4
4
  sassPlugin
5
- } from "./chunk-XS4EJSEK.js";
5
+ } from "./chunk-K5WZ2VYK.js";
6
6
  import "./chunk-3NYSSA2C.js";
7
- import "./chunk-RBNPBTDP.js";
8
- import "./chunk-Z44IAMNG.js";
9
- import "./chunk-2QTJTEBV.js";
10
- import "./chunk-ERAIEV3O.js";
7
+ import "./chunk-SNQOHNXE.js";
8
+ import "./chunk-VILOEVK7.js";
9
+ import "./chunk-ULCT3PAV.js";
10
+ import "./chunk-6U5VIQVY.js";
11
11
  import "./chunk-AD3HAW3W.js";
12
12
  import "./chunk-YCOTX2VM.js";
13
- import "./chunk-GS5B3CBW.js";
14
- import "./chunk-JC54PHIT.js";
15
- import "./chunk-HFSWUTXX.js";
13
+ import "./chunk-DDV6JEC2.js";
14
+ import "./chunk-6OUCRDYI.js";
15
+ import "./chunk-SPIFZBIW.js";
16
16
  import "./chunk-FVZ5JBRI.js";
17
- import "./chunk-UU43WIZG.js";
18
- import "./chunk-IOBC665M.js";
17
+ import "./chunk-FJML7INB.js";
18
+ import "./chunk-4AZFCSGJ.js";
19
19
  import "./chunk-CMUWRPSQ.js";
20
- import "./chunk-AIMEXBTK.js";
20
+ import "./chunk-YNJNMQWU.js";
21
+ import "./chunk-VJWQSYEG.js";
21
22
  import "./chunk-I3PS26CI.js";
22
23
  export {
23
24
  sassPlugin
package/lib/sitemap.js CHANGED
@@ -2,33 +2,33 @@ 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
  escapeHtml,
10
10
  isoDay
11
- } from "./chunk-Z44IAMNG.js";
12
- import "./chunk-2QTJTEBV.js";
13
- import "./chunk-ERAIEV3O.js";
11
+ } from "./chunk-VILOEVK7.js";
12
+ import "./chunk-ULCT3PAV.js";
13
+ import "./chunk-6U5VIQVY.js";
14
14
  import "./chunk-AD3HAW3W.js";
15
15
  import "./chunk-YCOTX2VM.js";
16
- import "./chunk-GS5B3CBW.js";
17
- import "./chunk-JC54PHIT.js";
16
+ import "./chunk-DDV6JEC2.js";
17
+ import "./chunk-6OUCRDYI.js";
18
18
  import {
19
19
  globSet
20
- } from "./chunk-HFSWUTXX.js";
20
+ } from "./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
- compareText,
28
- toDate,
29
- warn,
30
- warning
31
- } from "./chunk-AIMEXBTK.js";
27
+ toDate
28
+ } from "./chunk-YNJNMQWU.js";
29
+ import {
30
+ compareText
31
+ } from "./chunk-VJWQSYEG.js";
32
32
  import "./chunk-I3PS26CI.js";
33
33
 
34
34
  // src/modules/sitemap.ts
@@ -43,24 +43,29 @@ function isLaterPage(data) {
43
43
  return number > 0 && size > 1;
44
44
  }
45
45
  BUILTINS.set("ssqch/sitemap", (config, given) => {
46
+ if (given !== null && typeof given === "object" && Object.hasOwn(given, "format")) bail("`format` is gone: the sitemap is ssqch's own, with the same URLs as any other generator's. Leave it out (`ssqch diff` lists sitemap.xml as changed, and that's expected)");
46
47
  const o = new Options(given, ["url", "exclude", "lastmod", "output", "paginated", "alternates"]);
47
48
  const alternates = o.get("alternates");
48
49
  if (alternates !== void 0 && typeof alternates !== "function") bail(`alternates must be a function that gets each page and returns its translations, like (page) => [{ hreflang: "fr", href: "/fr/" }] (got ${typeof alternates})`);
49
- const url = o.string("url") || void 0;
50
+ const url = o.string("url");
51
+ if (url === void 0 || url === "") bail(`needs the site's address, like sitemapPlugin({ url: "https://example.com" }): a sitemap lists whole addresses, and search engines read only those`);
50
52
  const exclude = o.list("exclude") ?? [];
51
53
  const lastmod = o.bool("lastmod") ?? true;
52
54
  const output = o.string("output") ?? "/sitemap.xml";
53
55
  const paginated = o.bool("paginated") ?? false;
54
- if (url !== void 0 && !(url.startsWith("https://") || url.startsWith("http://"))) bail(`url must be the site's address, like "https://example.com" (got ${debugString(url)})`);
56
+ if (!(url.startsWith("https://") || url.startsWith("http://"))) bail(`url must be the site's address, like "https://example.com" (got ${debugString(url)})`);
55
57
  if (!output.startsWith("/") || output.endsWith("/")) bail(`output must be a URL path to a file, like "/sitemap.xml" (got ${debugString(output)})`);
56
58
  const matchers = exclude.map((glob) => {
57
59
  if (!glob.startsWith("/")) bail(`exclude: ${debugString(glob)} must be a URL path or glob starting with /, like "/tags/**"`);
58
60
  return globSet("exclude", [glob]);
59
61
  });
60
62
  const excluded = (url2) => matchers.some((m) => m(url2));
63
+ config.sitemap = () => {
64
+ const trimmed = url.replace(/\/+$/, "");
65
+ return `${trimmed.endsWith(config.base) ? trimmed : trimmed + config.base}${output}`;
66
+ };
61
67
  config.generators.push(["ssqch/sitemap", (config2, pages) => {
62
- if (url === void 0) warn(warning("config", `sitemapPlugin() has no url, so ${output}'s <loc>s are paths from the site's root (as jekyll-sitemap writes them without one), and search engines read only whole addresses: give it the site's address, like { url: "https://example.com" }`));
63
- const trimmed = (url ?? "").replace(/\/+$/, "");
68
+ const trimmed = url.replace(/\/+$/, "");
64
69
  const withBase = trimmed.endsWith(config2.base) ? trimmed : trimmed + config2.base;
65
70
  const entries = [];
66
71
  const absolute = (href) => href.startsWith("/") ? withBase + href : href;
package/lib/ssqch.js CHANGED
@@ -9,13 +9,14 @@ import {
9
9
  safe,
10
10
  slugger,
11
11
  slugify
12
- } from "./chunk-JC54PHIT.js";
13
- import "./chunk-HFSWUTXX.js";
12
+ } from "./chunk-6OUCRDYI.js";
13
+ import "./chunk-SPIFZBIW.js";
14
14
  import "./chunk-FVZ5JBRI.js";
15
- import "./chunk-UU43WIZG.js";
16
- import "./chunk-IOBC665M.js";
15
+ import "./chunk-FJML7INB.js";
16
+ import "./chunk-4AZFCSGJ.js";
17
17
  import "./chunk-CMUWRPSQ.js";
18
- import "./chunk-AIMEXBTK.js";
18
+ import "./chunk-YNJNMQWU.js";
19
+ import "./chunk-VJWQSYEG.js";
19
20
  import "./chunk-I3PS26CI.js";
20
21
  export {
21
22
  api_default as default,