@forumulate/cli 0.9.0 → 0.11.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 (240) hide show
  1. package/README.md +3 -3
  2. package/dist/api/args.d.ts.map +1 -1
  3. package/dist/api/args.js +1 -0
  4. package/dist/api/args.js.map +1 -1
  5. package/dist/api/command.d.ts +1 -1
  6. package/dist/api/command.d.ts.map +1 -1
  7. package/dist/api/command.js +86 -11
  8. package/dist/api/command.js.map +1 -1
  9. package/dist/api/http.d.ts +8 -0
  10. package/dist/api/http.d.ts.map +1 -1
  11. package/dist/api/http.js +3 -2
  12. package/dist/api/http.js.map +1 -1
  13. package/dist/api/live-spec.d.ts +48 -0
  14. package/dist/api/live-spec.d.ts.map +1 -0
  15. package/dist/api/live-spec.js +72 -0
  16. package/dist/api/live-spec.js.map +1 -0
  17. package/dist/api/operations.json +1 -1
  18. package/dist/api/request.d.ts.map +1 -1
  19. package/dist/api/request.js +25 -1
  20. package/dist/api/request.js.map +1 -1
  21. package/dist/api/send.d.ts +10 -1
  22. package/dist/api/send.d.ts.map +1 -1
  23. package/dist/api/send.js +14 -3
  24. package/dist/api/send.js.map +1 -1
  25. package/dist/api/slim.d.ts +14 -0
  26. package/dist/api/slim.d.ts.map +1 -0
  27. package/dist/api/slim.js +174 -0
  28. package/dist/api/slim.js.map +1 -0
  29. package/dist/cache-command.d.ts +12 -0
  30. package/dist/cache-command.d.ts.map +1 -0
  31. package/dist/cache-command.js +93 -0
  32. package/dist/cache-command.js.map +1 -0
  33. package/dist/check/command.d.ts +48 -0
  34. package/dist/check/command.d.ts.map +1 -0
  35. package/dist/check/command.js +256 -0
  36. package/dist/check/command.js.map +1 -0
  37. package/dist/check/external.d.ts +66 -0
  38. package/dist/check/external.d.ts.map +1 -0
  39. package/dist/check/external.js +177 -0
  40. package/dist/check/external.js.map +1 -0
  41. package/dist/check/markdown-links.d.ts +38 -0
  42. package/dist/check/markdown-links.d.ts.map +1 -0
  43. package/dist/check/markdown-links.js +166 -0
  44. package/dist/check/markdown-links.js.map +1 -0
  45. package/dist/cli.js +42 -7
  46. package/dist/cli.js.map +1 -1
  47. package/dist/commands/completion.d.ts.map +1 -1
  48. package/dist/commands/completion.js +3 -0
  49. package/dist/commands/completion.js.map +1 -1
  50. package/dist/commands/context.d.ts.map +1 -1
  51. package/dist/commands/context.js +6 -2
  52. package/dist/commands/context.js.map +1 -1
  53. package/dist/commands/groups-api.d.ts.map +1 -1
  54. package/dist/commands/groups-api.js +20 -2
  55. package/dist/commands/groups-api.js.map +1 -1
  56. package/dist/commands/groups-docs.d.ts.map +1 -1
  57. package/dist/commands/groups-docs.js +8 -2
  58. package/dist/commands/groups-docs.js.map +1 -1
  59. package/dist/commands/groups-jobs.d.ts +10 -0
  60. package/dist/commands/groups-jobs.d.ts.map +1 -0
  61. package/dist/commands/groups-jobs.js +89 -0
  62. package/dist/commands/groups-jobs.js.map +1 -0
  63. package/dist/commands/groups-org.d.ts.map +1 -1
  64. package/dist/commands/groups-org.js +59 -2
  65. package/dist/commands/groups-org.js.map +1 -1
  66. package/dist/commands/groups-site.d.ts.map +1 -1
  67. package/dist/commands/groups-site.js +33 -3
  68. package/dist/commands/groups-site.js.map +1 -1
  69. package/dist/commands/groups-spaces.d.ts.map +1 -1
  70. package/dist/commands/groups-spaces.js +11 -5
  71. package/dist/commands/groups-spaces.js.map +1 -1
  72. package/dist/commands/groups-types.d.ts.map +1 -1
  73. package/dist/commands/groups-types.js +74 -0
  74. package/dist/commands/groups-types.js.map +1 -1
  75. package/dist/commands/groups.d.ts.map +1 -1
  76. package/dist/commands/groups.js +2 -0
  77. package/dist/commands/groups.js.map +1 -1
  78. package/dist/commands/index.d.ts +9 -0
  79. package/dist/commands/index.d.ts.map +1 -1
  80. package/dist/commands/index.js +18 -3
  81. package/dist/commands/index.js.map +1 -1
  82. package/dist/commands/job-wait.d.ts +64 -0
  83. package/dist/commands/job-wait.d.ts.map +1 -0
  84. package/dist/commands/job-wait.js +91 -0
  85. package/dist/commands/job-wait.js.map +1 -0
  86. package/dist/commands/resource.d.ts +19 -0
  87. package/dist/commands/resource.d.ts.map +1 -1
  88. package/dist/commands/resource.js +65 -3
  89. package/dist/commands/resource.js.map +1 -1
  90. package/dist/content/library.d.ts +8 -0
  91. package/dist/content/library.d.ts.map +1 -1
  92. package/dist/content/library.js +10 -2
  93. package/dist/content/library.js.map +1 -1
  94. package/dist/credentials.d.ts +43 -4
  95. package/dist/credentials.d.ts.map +1 -1
  96. package/dist/credentials.js +67 -4
  97. package/dist/credentials.js.map +1 -1
  98. package/dist/doctor/address-checks.d.ts +56 -0
  99. package/dist/doctor/address-checks.d.ts.map +1 -0
  100. package/dist/doctor/address-checks.js +183 -0
  101. package/dist/doctor/address-checks.js.map +1 -0
  102. package/dist/doctor/boilerplate.d.ts +33 -0
  103. package/dist/doctor/boilerplate.d.ts.map +1 -0
  104. package/dist/doctor/boilerplate.js +78 -0
  105. package/dist/doctor/boilerplate.js.map +1 -0
  106. package/dist/doctor/command.d.ts +18 -0
  107. package/dist/doctor/command.d.ts.map +1 -0
  108. package/dist/doctor/command.js +234 -0
  109. package/dist/doctor/command.js.map +1 -0
  110. package/dist/doctor/crawl.d.ts +49 -0
  111. package/dist/doctor/crawl.d.ts.map +1 -0
  112. package/dist/doctor/crawl.js +210 -0
  113. package/dist/doctor/crawl.js.map +1 -0
  114. package/dist/doctor/extended.d.ts +52 -0
  115. package/dist/doctor/extended.d.ts.map +1 -0
  116. package/dist/doctor/extended.js +150 -0
  117. package/dist/doctor/extended.js.map +1 -0
  118. package/dist/doctor/page-checks.d.ts +42 -0
  119. package/dist/doctor/page-checks.d.ts.map +1 -0
  120. package/dist/doctor/page-checks.js +200 -0
  121. package/dist/doctor/page-checks.js.map +1 -0
  122. package/dist/doctor/probe.d.ts +63 -0
  123. package/dist/doctor/probe.d.ts.map +1 -0
  124. package/dist/doctor/probe.js +170 -0
  125. package/dist/doctor/probe.js.map +1 -0
  126. package/dist/doctor/reader-auth-atlas.d.ts +18 -0
  127. package/dist/doctor/reader-auth-atlas.d.ts.map +1 -0
  128. package/dist/doctor/reader-auth-atlas.js +50 -0
  129. package/dist/doctor/reader-auth-atlas.js.map +1 -0
  130. package/dist/doctor/robots-params.d.ts +36 -0
  131. package/dist/doctor/robots-params.d.ts.map +1 -0
  132. package/dist/doctor/robots-params.js +97 -0
  133. package/dist/doctor/robots-params.js.map +1 -0
  134. package/dist/doctor/site.d.ts +42 -0
  135. package/dist/doctor/site.d.ts.map +1 -0
  136. package/dist/doctor/site.js +82 -0
  137. package/dist/doctor/site.js.map +1 -0
  138. package/dist/doctor.d.ts +21 -0
  139. package/dist/doctor.d.ts.map +1 -1
  140. package/dist/doctor.js +94 -3
  141. package/dist/doctor.js.map +1 -1
  142. package/dist/exit-codes.d.ts +40 -0
  143. package/dist/exit-codes.d.ts.map +1 -0
  144. package/dist/exit-codes.js +66 -0
  145. package/dist/exit-codes.js.map +1 -0
  146. package/dist/help-commands.d.ts +14 -0
  147. package/dist/help-commands.d.ts.map +1 -0
  148. package/dist/help-commands.js +264 -0
  149. package/dist/help-commands.js.map +1 -0
  150. package/dist/help.d.ts +1 -1
  151. package/dist/help.d.ts.map +1 -1
  152. package/dist/help.js +67 -11
  153. package/dist/help.js.map +1 -1
  154. package/dist/io.d.ts +33 -0
  155. package/dist/io.d.ts.map +1 -0
  156. package/dist/io.js +81 -0
  157. package/dist/io.js.map +1 -0
  158. package/dist/plan/command.d.ts +51 -0
  159. package/dist/plan/command.d.ts.map +1 -0
  160. package/dist/plan/command.js +182 -0
  161. package/dist/plan/command.js.map +1 -0
  162. package/dist/plan/document.d.ts +24 -0
  163. package/dist/plan/document.d.ts.map +1 -0
  164. package/dist/plan/document.js +208 -0
  165. package/dist/plan/document.js.map +1 -0
  166. package/dist/plan/markdown-dir.d.ts +64 -0
  167. package/dist/plan/markdown-dir.d.ts.map +1 -0
  168. package/dist/plan/markdown-dir.js +191 -0
  169. package/dist/plan/markdown-dir.js.map +1 -0
  170. package/dist/plan/output.d.ts +59 -0
  171. package/dist/plan/output.d.ts.map +1 -0
  172. package/dist/plan/output.js +102 -0
  173. package/dist/plan/output.js.map +1 -0
  174. package/dist/preview-comment.d.ts +20 -0
  175. package/dist/preview-comment.d.ts.map +1 -0
  176. package/dist/preview-comment.js +88 -0
  177. package/dist/preview-comment.js.map +1 -0
  178. package/dist/publish/about.d.ts +23 -0
  179. package/dist/publish/about.d.ts.map +1 -0
  180. package/dist/publish/about.js +66 -0
  181. package/dist/publish/about.js.map +1 -0
  182. package/dist/publish/command.d.ts +20 -0
  183. package/dist/publish/command.d.ts.map +1 -1
  184. package/dist/publish/command.js +97 -4
  185. package/dist/publish/command.js.map +1 -1
  186. package/dist/publish/context.d.ts +8 -0
  187. package/dist/publish/context.d.ts.map +1 -1
  188. package/dist/publish/context.js.map +1 -1
  189. package/dist/publish/docs-apply.d.ts.map +1 -1
  190. package/dist/publish/docs-apply.js +13 -1
  191. package/dist/publish/docs-apply.js.map +1 -1
  192. package/dist/publish/extras.d.ts +10 -0
  193. package/dist/publish/extras.d.ts.map +1 -1
  194. package/dist/publish/extras.js +54 -2
  195. package/dist/publish/extras.js.map +1 -1
  196. package/dist/publish/manifest.d.ts.map +1 -1
  197. package/dist/publish/manifest.js +27 -2
  198. package/dist/publish/manifest.js.map +1 -1
  199. package/dist/publish/preview.d.ts +56 -0
  200. package/dist/publish/preview.d.ts.map +1 -0
  201. package/dist/publish/preview.js +133 -0
  202. package/dist/publish/preview.js.map +1 -0
  203. package/dist/publish/redirects.d.ts +13 -0
  204. package/dist/publish/redirects.d.ts.map +1 -0
  205. package/dist/publish/redirects.js +154 -0
  206. package/dist/publish/redirects.js.map +1 -0
  207. package/dist/publish/scan.d.ts +2 -0
  208. package/dist/publish/scan.d.ts.map +1 -1
  209. package/dist/publish/scan.js +1 -0
  210. package/dist/publish/scan.js.map +1 -1
  211. package/dist/publish/studio-edits.d.ts +25 -0
  212. package/dist/publish/studio-edits.d.ts.map +1 -0
  213. package/dist/publish/studio-edits.js +53 -0
  214. package/dist/publish/studio-edits.js.map +1 -0
  215. package/dist/publish/types.d.ts +22 -1
  216. package/dist/publish/types.d.ts.map +1 -1
  217. package/dist/publish-command.d.ts +55 -0
  218. package/dist/publish-command.d.ts.map +1 -0
  219. package/dist/publish-command.js +197 -0
  220. package/dist/publish-command.js.map +1 -0
  221. package/dist/run.d.ts +3 -10
  222. package/dist/run.d.ts.map +1 -1
  223. package/dist/run.js +152 -120
  224. package/dist/run.js.map +1 -1
  225. package/dist/translations/target.d.ts.map +1 -1
  226. package/dist/translations/target.js +2 -2
  227. package/dist/translations/target.js.map +1 -1
  228. package/dist/validate.d.ts +39 -0
  229. package/dist/validate.d.ts.map +1 -0
  230. package/dist/validate.js +166 -0
  231. package/dist/validate.js.map +1 -0
  232. package/dist/version.d.ts +8 -0
  233. package/dist/version.d.ts.map +1 -0
  234. package/dist/version.js +11 -0
  235. package/dist/version.js.map +1 -0
  236. package/dist/whoami.d.ts +41 -0
  237. package/dist/whoami.d.ts.map +1 -0
  238. package/dist/whoami.js +161 -0
  239. package/dist/whoami.js.map +1 -0
  240. package/package.json +2 -2
@@ -0,0 +1,208 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.loadPlanDocument = loadPlanDocument;
4
+ exports.dropImplied = dropImplied;
5
+ exports.pagesOf = pagesOf;
6
+ const node_fs_1 = require("node:fs");
7
+ const node_path_1 = require("node:path");
8
+ const yaml_1 = require("yaml");
9
+ const markdown_dir_1 = require("./markdown-dir");
10
+ /**
11
+ * `forumulate.yaml` as `forumulate plan` / `apply` read it (DX-D): the API's
12
+ * version-2 manifest (`PUT /orgs/{org}/manifest`), plus the few things only a
13
+ * file on disk can say.
14
+ *
15
+ * version: 2
16
+ * org: numestri # or --org / FORUMULATE_ORG
17
+ * spaces:
18
+ * - slug: about
19
+ * name: About
20
+ * type: ABOUT
21
+ * locales: [{ code: es, label: Español }]
22
+ * about: about.yaml # a file beside this one, or the map itself
23
+ * - slug: contact
24
+ * type: CONTACT
25
+ * contactForm: contact-form.yaml
26
+ * - slug: reference
27
+ * type: DOCS
28
+ * homeDoc: intro.md # the intro; intro.es.md beside it is its Spanish twin
29
+ * openapi: { spec: openapi.yaml, collection: API reference } # a spec file, read as text
30
+ * pages:
31
+ * - { dir: content/about, space: about } # a Markdown folder (see markdown-dir.ts)
32
+ * - { space: about, slug: press, title: Press, body: "…" } # or a page, inline
33
+ * sites: [...]
34
+ *
35
+ * Everything else is sent to the API exactly as written, and the API — not
36
+ * this file — decides what is valid: the same schemas its endpoints use, so a
37
+ * key the CLI let through cannot mean something the API would refuse. What is
38
+ * resolved here is only what needs the disk: a `dir` becomes its pages, a
39
+ * file name under `about` / `contactForm` becomes the map it holds, a
40
+ * `homeDoc` file becomes the intro (with its `.<code>.md` twins), and an
41
+ * `openapi[].spec` file name becomes the document's text.
42
+ */
43
+ /** Keys only the CLI reads; never sent. */
44
+ const CLI_ONLY = ['org', '$schema'];
45
+ function asMap(v, where) {
46
+ if (!v || typeof v !== 'object' || Array.isArray(v))
47
+ throw new Error(`${where} must be a map`);
48
+ return v;
49
+ }
50
+ function readData(file) {
51
+ const text = (0, node_fs_1.readFileSync)(file, 'utf8');
52
+ try {
53
+ return /\.json$/i.test(file) ? JSON.parse(text) : (0, yaml_1.parse)(text);
54
+ }
55
+ catch (e) {
56
+ throw new Error(`${file}: ${e.message}`);
57
+ }
58
+ }
59
+ /**
60
+ * `homeDoc: intro.md` → `{body, translations}`: the file, and each declared
61
+ * language's twin beside it (`intro.es.md`) — the suffix form a Markdown
62
+ * folder uses (markdown-dir.ts). A map stays a map.
63
+ */
64
+ function homeDocOf(v, base, locales, where) {
65
+ if (typeof v !== 'string')
66
+ return v;
67
+ const file = (0, node_path_1.resolve)(base, v);
68
+ if (!(0, node_fs_1.existsSync)(file))
69
+ throw new Error(`${where}: ${v} does not exist`);
70
+ const stem = (0, node_path_1.join)((0, node_path_1.dirname)(file), (0, node_path_1.basename)(file, (0, node_path_1.extname)(file)));
71
+ const translations = {};
72
+ for (const code of locales) {
73
+ const twin = `${stem}.${code}${(0, node_path_1.extname)(file)}`;
74
+ if ((0, node_fs_1.existsSync)(twin))
75
+ translations[code] = { body: (0, node_fs_1.readFileSync)(twin, 'utf8') };
76
+ }
77
+ return { body: (0, node_fs_1.readFileSync)(file, 'utf8'), ...(Object.keys(translations).length ? { translations } : {}) };
78
+ }
79
+ /** `openapi: {spec: openapi.yaml}` → the file's text, which the import door parses (YAML or JSON). */
80
+ function openApiOf(v, base) {
81
+ const one = (e) => {
82
+ if (!e || typeof e !== 'object' || Array.isArray(e))
83
+ return e;
84
+ const spec = e.spec;
85
+ if (typeof spec !== 'string' || !/\.(ya?ml|json)$/i.test(spec))
86
+ return e;
87
+ const file = (0, node_path_1.resolve)(base, spec);
88
+ return (0, node_fs_1.existsSync)(file) ? { ...e, spec: (0, node_fs_1.readFileSync)(file, 'utf8') } : e;
89
+ };
90
+ return Array.isArray(v) ? v.map(one) : one(v);
91
+ }
92
+ /** `about: about.yaml` → the map in that file; a map stays a map. */
93
+ function fileOrMap(v, base, where) {
94
+ if (typeof v !== 'string')
95
+ return v;
96
+ return asMap(readData((0, node_path_1.resolve)(base, v)), `${where} (${v})`);
97
+ }
98
+ function loadPlanDocument(file) {
99
+ const raw = asMap(readData(file) ?? {}, file);
100
+ if (raw.version !== 2) {
101
+ throw new Error(`${file}: \`forumulate plan\` and \`apply\` read a \`version: 2\` manifest. ` +
102
+ (raw.version === undefined
103
+ ? 'This looks like a `forumulate publish` file (one folder per space); add `version: 2` and the blocks in docs/guides/forumulate-yaml-apply.md, or keep using `forumulate publish`.'
104
+ : `It says version ${String(raw.version)}.`));
105
+ }
106
+ const base = (0, node_path_1.dirname)(file);
107
+ const body = {};
108
+ for (const [k, v] of Object.entries(raw))
109
+ if (!CLI_ONLY.includes(k))
110
+ body[k] = v;
111
+ const spaces = Array.isArray(body.spaces) ? body.spaces : [];
112
+ for (const [i, s] of spaces.entries()) {
113
+ asMap(s, `spaces[${i}]`);
114
+ if (s.about !== undefined)
115
+ s.about = fileOrMap(s.about, base, `spaces[${i}].about`);
116
+ if (s.contactForm !== undefined)
117
+ s.contactForm = fileOrMap(s.contactForm, base, `spaces[${i}].contactForm`);
118
+ const codes = Array.isArray(s.locales) ? s.locales.map((l) => String(l.code ?? '')) : [];
119
+ if (s.homeDoc !== undefined)
120
+ s.homeDoc = homeDocOf(s.homeDoc, base, codes, `spaces[${i}].homeDoc`);
121
+ if (s.openapi !== undefined)
122
+ s.openapi = openApiOf(s.openapi, base);
123
+ }
124
+ const localesOf = (slug) => {
125
+ const s = spaces.find((x) => x.slug === slug);
126
+ return Array.isArray(s?.locales) ? s.locales.map((l) => String(l.code ?? '')) : [];
127
+ };
128
+ const assets = new Map();
129
+ const skipped = [];
130
+ const implied = new Map();
131
+ if (body.pages !== undefined) {
132
+ if (!Array.isArray(body.pages))
133
+ throw new Error(`${file}: pages must be a list`);
134
+ const pages = [];
135
+ for (const [i, entry] of body.pages.entries()) {
136
+ const e = asMap(entry, `pages[${i}]`);
137
+ if (e.dir === undefined) {
138
+ pages.push(e);
139
+ continue;
140
+ }
141
+ const extra = Object.keys(e).filter((k) => !['dir', 'space', 'collection', 'locales'].includes(k));
142
+ if (extra.length)
143
+ throw new Error(`pages[${i}]: a folder entry takes dir, space, collection and locales; not ${extra.join(', ')}`);
144
+ if (typeof e.dir !== 'string' || typeof e.space !== 'string')
145
+ throw new Error(`pages[${i}]: a folder entry needs \`dir\` and \`space\``);
146
+ const extraLocales = Array.isArray(e.locales) ? e.locales.map(String) : [];
147
+ const scan = (0, markdown_dir_1.scanMarkdownDir)((0, node_path_1.resolve)(base, e.dir), {
148
+ space: e.space,
149
+ locales: [...localesOf(e.space), ...extraLocales],
150
+ ...(typeof e.collection === 'string' ? { collection: e.collection } : {}),
151
+ });
152
+ pages.push(...scan.pages);
153
+ skipped.push(...scan.skipped.map((s) => `${e.dir}/${s}`));
154
+ const forSpace = assets.get(e.space) ?? new Map();
155
+ for (const [k, v] of scan.assets)
156
+ forSpace.set(k, v);
157
+ if (forSpace.size)
158
+ assets.set(e.space, forSpace);
159
+ const added = declareCollections(spaces, e.space, scan.collections);
160
+ if (added.length)
161
+ implied.set(e.space, [...(implied.get(e.space) ?? []), ...added]);
162
+ }
163
+ body.pages = pages;
164
+ }
165
+ return {
166
+ file,
167
+ ...(typeof raw.org === 'string' ? { org: raw.org } : {}),
168
+ body,
169
+ assets,
170
+ skipped,
171
+ implied,
172
+ };
173
+ }
174
+ /** Take back implied collections the space turned out to have already. */
175
+ function dropImplied(body, space, existing, implied) {
176
+ const s = (Array.isArray(body.spaces) ? body.spaces : []).find((x) => x.slug === space);
177
+ if (!s || !Array.isArray(s.collections))
178
+ return;
179
+ s.collections = s.collections.filter((c) => !(implied.includes(String(c.slug)) && existing.has(String(c.slug))));
180
+ if (s.collections.length === 0)
181
+ delete s.collections;
182
+ }
183
+ /**
184
+ * A folder of pages is a collection; the space's `collections` block gets
185
+ * each one it does not already declare, so a tree with a `guides/` folder
186
+ * needs no second mention of `guides`. Only for a space the document itself
187
+ * declares — the API creates collections through that block.
188
+ */
189
+ function declareCollections(spaces, slug, found) {
190
+ const space = spaces.find((s) => s.slug === slug);
191
+ if (!space || found.size === 0)
192
+ return [];
193
+ const list = Array.isArray(space.collections) ? space.collections : [];
194
+ const added = [];
195
+ for (const [cslug, name] of found) {
196
+ if (list.some((c) => c.slug === cslug))
197
+ continue;
198
+ list.push({ name, slug: cslug });
199
+ added.push(cslug);
200
+ }
201
+ space.collections = list;
202
+ return added;
203
+ }
204
+ /** The pages of a body, typed loosely: what the CLI rewrites and batches. */
205
+ function pagesOf(body) {
206
+ return Array.isArray(body.pages) ? body.pages : [];
207
+ }
208
+ //# sourceMappingURL=document.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"document.js","sourceRoot":"","sources":["../../src/plan/document.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,64 @@
1
+ /**
2
+ * A folder of Markdown → the manifest's `pages` entries (DX-D).
3
+ *
4
+ * content/about/
5
+ * index.md → page `index`
6
+ * index.es.md → its Spanish twin (suffix form)
7
+ * 01-team.md → page `team`, order 1
8
+ * guides/setup.md → page `setup` in the `guides` collection
9
+ * es/guides/setup.md → the Spanish twin of guides/setup.md (folder form)
10
+ *
11
+ * Both twin forms are read, because both are what static-site generators
12
+ * write (Hugo and Jekyll put the language in the file name, Docusaurus and
13
+ * MkDocs in a folder) and a customer moving to us should not have to rename a
14
+ * tree to say the same thing. A suffix or a top folder only counts as a
15
+ * language when it is one of the space's declared language codes: `v1.2.md`
16
+ * and a folder called `de` in a German-only space are ordinary names.
17
+ *
18
+ * Front matter, per file: `title`, `slug`, `seoTitle`, `seoDescription`,
19
+ * `canonicalUrl`, `sections` (Markdown per slot), `collection`, `order`, and
20
+ * every page metadata key `forumulate publish` reads (same aliases: `description`
21
+ * is `seoDescription`, `canonical` is `canonicalUrl`, …). A key nothing reads
22
+ * is an error naming the file, not a value silently not published. `draft:
23
+ * true` leaves the file out. Without a `title`, the leading `# heading` is the
24
+ * title and is taken out of the body, as the importer does.
25
+ */
26
+ export interface ScannedPage {
27
+ space: string;
28
+ slug: string;
29
+ title: string;
30
+ body?: string;
31
+ sections?: Record<string, string>;
32
+ seoTitle?: string;
33
+ seoDescription?: string;
34
+ canonicalUrl?: string;
35
+ metadata?: Record<string, unknown>;
36
+ collection?: string;
37
+ order?: number;
38
+ translations?: Record<string, Omit<ScannedPage, 'space' | 'collection' | 'order' | 'translations' | 'slug'> & {
39
+ slug?: string;
40
+ }>;
41
+ }
42
+ export interface ScanResult {
43
+ pages: ScannedPage[];
44
+ /** Folders read as collections: slug → name, for the space's `collections` block. */
45
+ collections: Map<string, string>;
46
+ /** Local files the pages point at, by page key (`slug` or `slug@es`): reference → absolute path. */
47
+ assets: Map<string, Map<string, string>>;
48
+ /** Files left out, and why (a draft). */
49
+ skipped: string[];
50
+ }
51
+ /**
52
+ * Read one directory into page entries for `space`. `locales` are the codes
53
+ * the space publishes in (from the document); `collection` puts every page of
54
+ * the directory into that collection unless a sub-folder or front matter says
55
+ * otherwise.
56
+ */
57
+ export declare function scanMarkdownDir(dir: string, opts: {
58
+ space: string;
59
+ locales?: string[];
60
+ collection?: string;
61
+ }): ScanResult;
62
+ /** For messages: a path as the user wrote it. */
63
+ export declare function shown(root: string, abs: string): string;
64
+ //# sourceMappingURL=markdown-dir.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"markdown-dir.d.ts","sourceRoot":"","sources":["../../src/plan/markdown-dir.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,YAAY,GAAG,OAAO,GAAG,cAAc,GAAG,MAAM,CAAC,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClI;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,qFAAqF;IACrF,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,oGAAoG;IACpG,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACzC,yCAAyC;IACzC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AA+GD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/D,UAAU,CA8DZ;AAED,iDAAiD;AACjD,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvD"}
@@ -0,0 +1,191 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.scanMarkdownDir = scanMarkdownDir;
4
+ exports.shown = shown;
5
+ const node_fs_1 = require("node:fs");
6
+ const node_path_1 = require("node:path");
7
+ const frontmatter_1 = require("../publish/frontmatter");
8
+ const names_1 = require("../publish/names");
9
+ const scan_1 = require("../publish/scan");
10
+ const rewrite_1 = require("../publish/rewrite");
11
+ /** Front matter keys this reader consumes itself; the rest go through `pageMeta`. */
12
+ const OWN = new Set(['title', 'slug', 'sections', 'collection', 'locale']);
13
+ function walk(root, rel = '') {
14
+ const out = [];
15
+ for (const name of (0, node_fs_1.readdirSync)((0, node_path_1.join)(root, rel)).sort()) {
16
+ if (name.startsWith('.') || name.startsWith('_') || name === 'node_modules')
17
+ continue;
18
+ const r = rel ? `${rel}/${name}` : name;
19
+ if ((0, node_fs_1.statSync)((0, node_path_1.join)(root, r)).isDirectory())
20
+ out.push(...walk(root, r));
21
+ else if (names_1.MD.test(name))
22
+ out.push(r);
23
+ }
24
+ return out;
25
+ }
26
+ /** `01-getting-started.es.md` → `{stem: '01-getting-started', locale: 'es'}` when `es` is declared. */
27
+ function splitName(file, locales) {
28
+ const stem = (0, node_path_1.basename)(file, (0, node_path_1.extname)(file));
29
+ const dot = stem.lastIndexOf('.');
30
+ if (dot > 0) {
31
+ const code = stem.slice(dot + 1).toLowerCase();
32
+ if (locales.has(code))
33
+ return { stem: stem.slice(0, dot), locale: code };
34
+ }
35
+ return { stem, locale: null };
36
+ }
37
+ /** The leading `# heading` as a title, removed from the body (the importer's rule). */
38
+ function takeTitle(body) {
39
+ const m = /^\s*#\s+(.+?)\s*#*\s*(?:\r?\n|$)/.exec(body);
40
+ if (!m)
41
+ return { title: null, body };
42
+ const plain = m[1]
43
+ .replace(/!?\[([^\]]*)\]\([^)]*\)/g, '$1')
44
+ .replace(/[`*_~]/g, '')
45
+ .trim();
46
+ return { title: plain || null, body: body.slice(m[0].length).replace(/^\s*\n/, '') };
47
+ }
48
+ function parseFile(root, file, locales, defaultCollection) {
49
+ const abs = (0, node_path_1.join)(root, file);
50
+ const text = (0, node_fs_1.readFileSync)(abs, 'utf8');
51
+ let front;
52
+ try {
53
+ front = (0, frontmatter_1.splitFront)(text);
54
+ }
55
+ catch (e) {
56
+ throw new Error(`${file}: ${e.message}`);
57
+ }
58
+ if ((0, frontmatter_1.isDraft)(front.data))
59
+ return 'draft';
60
+ // A top folder named after a declared language holds that language's tree.
61
+ const parts = file.split('/');
62
+ let locale = null;
63
+ if (parts.length > 1 && locales.has(parts[0].toLowerCase()))
64
+ locale = parts.shift().toLowerCase();
65
+ const named = splitName(parts[parts.length - 1], locales);
66
+ if (named.locale) {
67
+ if (locale && locale !== named.locale)
68
+ throw new Error(`${file}: the folder says ${locale} and the file name says ${named.locale}`);
69
+ locale = named.locale;
70
+ }
71
+ const folder = parts.length > 1 ? parts[0] : null;
72
+ const data = front.data;
73
+ const lower = Object.fromEntries(Object.entries(data).map(([k, v]) => [k.toLowerCase().replace(/[-_\s]/g, ''), v]));
74
+ const collection = typeof lower.collection === 'string' ? lower.collection : folder ? (0, names_1.slugify)(folder.replace(names_1.NUMERIC, ''), 'section') : (defaultCollection ?? null);
75
+ const slug = typeof data.slug === 'string' && data.slug ? data.slug : (0, names_1.slugify)(named.stem.replace(names_1.NUMERIC, ''));
76
+ const prefix = names_1.NUMERIC.exec(named.stem);
77
+ const order = (0, frontmatter_1.declaredOrder)(data) ?? (prefix ? Number(prefix[1]) : undefined);
78
+ const rest = {};
79
+ for (const [k, v] of Object.entries(data))
80
+ if (!OWN.has(k.toLowerCase()))
81
+ rest[k] = v;
82
+ const { meta, unknown } = (0, frontmatter_1.pageMeta)(rest, []);
83
+ if (unknown.length)
84
+ throw new Error(`${file}: front matter key(s) nothing reads: ${unknown.join(', ')}`);
85
+ const { seoTitle, seoDescription, canonicalUrl, ...metadata } = meta;
86
+ let body = front.body;
87
+ let title = typeof data.title === 'string' && data.title.trim() ? data.title.trim() : null;
88
+ if (!title) {
89
+ const t = takeTitle(body);
90
+ title = t.title;
91
+ body = t.body;
92
+ }
93
+ const sections = data.sections;
94
+ if (sections !== undefined && (typeof sections !== 'object' || sections === null || Array.isArray(sections)))
95
+ throw new Error(`${file}: \`sections\` must be a map of slot → Markdown`);
96
+ const words = {
97
+ slug,
98
+ title: title ?? (0, names_1.titleize)(named.stem),
99
+ ...(body.trim() ? { body } : {}),
100
+ ...(sections ? { sections: Object.fromEntries(Object.entries(sections).map(([k, v]) => [k, String(v ?? '')])) } : {}),
101
+ ...(typeof seoTitle === 'string' ? { seoTitle } : {}),
102
+ ...(typeof seoDescription === 'string' ? { seoDescription } : {}),
103
+ ...(typeof canonicalUrl === 'string' ? { canonicalUrl } : {}),
104
+ ...(Object.keys(metadata).length ? { metadata } : {}),
105
+ ...(order !== undefined ? { order } : {}),
106
+ };
107
+ // The twin of `guides/setup` is `es/guides/setup` or `guides/setup.es`: one key for both.
108
+ const key = [...parts.slice(0, -1), named.stem].join('/');
109
+ const slugDeclared = typeof data.slug === 'string' && !!data.slug;
110
+ return { file, key, locale, collection, slugDeclared, words, assets: (0, scan_1.assetRefs)(text, (0, node_path_1.dirname)(abs), data) };
111
+ }
112
+ /**
113
+ * Read one directory into page entries for `space`. `locales` are the codes
114
+ * the space publishes in (from the document); `collection` puts every page of
115
+ * the directory into that collection unless a sub-folder or front matter says
116
+ * otherwise.
117
+ */
118
+ function scanMarkdownDir(dir, opts) {
119
+ if (!(0, node_fs_1.existsSync)(dir) || !(0, node_fs_1.statSync)(dir).isDirectory())
120
+ throw new Error(`pages: ${dir} is not a directory`);
121
+ const locales = new Set((opts.locales ?? []).map((l) => l.toLowerCase()));
122
+ const sources = new Map();
123
+ const twins = [];
124
+ const skipped = [];
125
+ for (const file of walk(dir)) {
126
+ const parsed = parseFile(dir, file.split(node_path_1.sep).join(node_path_1.posix.sep), locales, opts.collection);
127
+ if (parsed === 'draft') {
128
+ skipped.push(`${file} (draft)`);
129
+ continue;
130
+ }
131
+ if (parsed.locale)
132
+ twins.push(parsed);
133
+ else if (sources.has(parsed.key))
134
+ throw new Error(`${file}: the same page as ${sources.get(parsed.key).file}`);
135
+ else
136
+ sources.set(parsed.key, parsed);
137
+ }
138
+ // Links between files become links between pages, in the importer's own
139
+ // form — the same rewrite `forumulate publish` does, by the same function.
140
+ const slugByFile = new Map();
141
+ for (const p of sources.values())
142
+ slugByFile.set(p.file, p.words.slug);
143
+ for (const t of twins)
144
+ slugByFile.set(t.file, t.slugDeclared ? t.words.slug : (sources.get(t.key)?.words.slug ?? t.words.slug));
145
+ const linked = (p) => ({
146
+ ...p.words,
147
+ ...(p.words.body !== undefined ? { body: (0, rewrite_1.rewriteLinks)(p.words.body, p.file, slugByFile) } : {}),
148
+ ...(p.words.sections
149
+ ? {
150
+ sections: Object.fromEntries(Object.entries(p.words.sections).map(([k, v]) => [k, (0, rewrite_1.rewriteLinks)(v, p.file, slugByFile)])),
151
+ }
152
+ : {}),
153
+ });
154
+ const pages = new Map();
155
+ const collections = new Map();
156
+ const assets = new Map();
157
+ const slugs = new Map();
158
+ for (const p of sources.values()) {
159
+ const prior = slugs.get(p.words.slug);
160
+ if (prior)
161
+ throw new Error(`${p.file}: slug "${p.words.slug}" is also ${prior}'s`);
162
+ slugs.set(p.words.slug, p.file);
163
+ if (p.collection)
164
+ collections.set(p.collection, (0, names_1.titleize)(p.collection));
165
+ pages.set(p.key, {
166
+ space: opts.space,
167
+ ...linked(p),
168
+ ...(p.collection ? { collection: p.collection } : {}),
169
+ });
170
+ if (p.assets.size)
171
+ assets.set(p.words.slug, p.assets);
172
+ }
173
+ for (const t of twins) {
174
+ const source = pages.get(t.key);
175
+ if (!source)
176
+ throw new Error(`${t.file}: a ${t.locale} version of a page that does not exist (${t.key})`);
177
+ if (t.words.order !== undefined && t.words.order !== source.order)
178
+ throw new Error(`${t.file}: \`order\` belongs on the source page; a twin follows its place`);
179
+ // A twin keeps the source's address unless its own front matter names one.
180
+ const { order: _o, slug, ...words } = linked(t);
181
+ source.translations = { ...(source.translations ?? {}), [t.locale]: t.slugDeclared ? { ...words, slug } : words };
182
+ if (t.assets.size)
183
+ assets.set(`${source.slug}@${t.locale}`, t.assets);
184
+ }
185
+ return { pages: [...pages.values()], collections, assets, skipped };
186
+ }
187
+ /** For messages: a path as the user wrote it. */
188
+ function shown(root, abs) {
189
+ return (0, node_path_1.relative)(root, abs) || '.';
190
+ }
191
+ //# sourceMappingURL=markdown-dir.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"markdown-dir.js","sourceRoot":"","sources":["../../src/plan/markdown-dir.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,59 @@
1
+ /**
2
+ * What `forumulate plan` and `apply` print (DX-D): the API's manifest answer
3
+ * (`ManifestResultV2`), as lines a person reads in a pull request's CI log.
4
+ *
5
+ * A plan lists only what would MOVE — `+` create, `~` update, `-` delete —
6
+ * with the fields each update touches; `unchanged` steps are counted, not
7
+ * listed (`--verbose` lists them), because a forty-page site re-planned after
8
+ * a one-word fix should print one line, not forty. Drift (a page edited
9
+ * outside the manifest) is an update like any other, and its `content` field
10
+ * says so in words.
11
+ */
12
+ export interface ManifestStep {
13
+ unit: string;
14
+ ref: string;
15
+ action: 'create' | 'update' | 'unchanged' | 'delete' | 'unsupported';
16
+ diff?: Record<string, {
17
+ from: unknown;
18
+ to: unknown;
19
+ }>;
20
+ id?: string | null;
21
+ status?: 'planned' | 'applied' | 'unchanged' | 'failed' | 'skipped';
22
+ readBack?: 'ok' | 'mismatch' | null;
23
+ error?: string;
24
+ shownOnce?: Record<string, string | null>;
25
+ }
26
+ export interface ManifestAnswer {
27
+ dryRun: boolean;
28
+ ok: boolean;
29
+ steps: ManifestStep[];
30
+ manual?: {
31
+ kind: string;
32
+ name?: string;
33
+ type?: string;
34
+ value?: string;
35
+ host?: string;
36
+ path?: string;
37
+ origin?: string;
38
+ for: string;
39
+ }[];
40
+ extras?: {
41
+ kind: string;
42
+ space?: string;
43
+ key: string;
44
+ }[];
45
+ units?: {
46
+ error?: string;
47
+ status: string;
48
+ kind: string;
49
+ key: string;
50
+ }[];
51
+ }
52
+ export declare function formatPlan(answer: ManifestAnswer, opts: {
53
+ diff: boolean;
54
+ verbose: boolean;
55
+ }): string[];
56
+ export declare function formatApply(answers: ManifestAnswer[], opts: {
57
+ verbose: boolean;
58
+ }): string[];
59
+ //# sourceMappingURL=output.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/plan/output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,aAAa,CAAC;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,EAAE,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACtD,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IACpE,QAAQ,CAAC,EAAE,IAAI,GAAG,UAAU,GAAG,IAAI,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACtI,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzD,KAAK,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACzE;AAqBD,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,EAAE,CAsBtG;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,IAAI,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,EAAE,CA6B3F"}