ai-release-notes 0.3.0 → 0.4.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.
- package/README.md +261 -12
- package/dist/bin/cli.js +428 -331
- package/dist/bin/cli.js.map +1 -1
- package/dist/generator.d.ts.map +1 -1
- package/dist/generator.js +25 -44
- package/dist/generator.js.map +1 -1
- package/dist/index.d.ts +17 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +47 -1
- package/dist/index.js.map +1 -1
- package/dist/output-index.d.ts +71 -1
- package/dist/output-index.d.ts.map +1 -1
- package/dist/output-index.js +333 -1
- package/dist/output-index.js.map +1 -1
- package/dist/output-path.d.ts +61 -0
- package/dist/output-path.d.ts.map +1 -0
- package/dist/output-path.js +182 -0
- package/dist/output-path.js.map +1 -0
- package/dist/promote.d.ts +133 -0
- package/dist/promote.d.ts.map +1 -0
- package/dist/promote.js +0 -0
- package/dist/promote.js.map +1 -0
- package/dist/prompt-session.d.ts +172 -0
- package/dist/prompt-session.d.ts.map +1 -0
- package/dist/prompt-session.js +484 -0
- package/dist/prompt-session.js.map +1 -0
- package/dist/prompts/builder.d.ts +77 -0
- package/dist/prompts/builder.d.ts.map +1 -1
- package/dist/prompts/builder.js +134 -0
- package/dist/prompts/builder.js.map +1 -1
- package/dist/release-date.d.ts +14 -0
- package/dist/release-date.d.ts.map +1 -0
- package/dist/release-date.js +54 -0
- package/dist/release-date.js.map +1 -0
- package/dist/release-document.d.ts +150 -0
- package/dist/release-document.d.ts.map +1 -0
- package/dist/release-document.js +651 -0
- package/dist/release-document.js.map +1 -0
- package/dist/release.d.ts +27 -3
- package/dist/release.d.ts.map +1 -1
- package/dist/release.js +88 -2
- package/dist/release.js.map +1 -1
- package/dist/text-diff.d.ts +19 -0
- package/dist/text-diff.d.ts.map +1 -0
- package/dist/text-diff.js +81 -0
- package/dist/text-diff.js.map +1 -0
- package/dist/types.d.ts +10 -7
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js.map +1 -1
- package/package.json +1 -1
- package/prompts/release-notes-edit-system.md +48 -0
- package/prompts/release-notes-promote-opening.md +59 -0
- package/prompts/release-notes-session-router.md +68 -0
- package/dist/prompts/translation-system.md +0 -8
package/dist/output-index.js
CHANGED
|
@@ -1,12 +1,29 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
/**
|
|
3
|
-
*
|
|
3
|
+
* The release summary: one page per environment listing every release it has,
|
|
4
|
+
* newest first, each linking to its notes.
|
|
5
|
+
*
|
|
6
|
+
* It is created on the first release and updated on every one after it,
|
|
7
|
+
* whether that release was just written or promoted from another environment.
|
|
4
8
|
*/
|
|
5
9
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
10
|
+
exports.ENTRY_TEMPLATE_SEPARATOR = void 0;
|
|
6
11
|
exports.discoverOutputIndexLanguages = discoverOutputIndexLanguages;
|
|
12
|
+
exports.updateOutputIndexes = updateOutputIndexes;
|
|
13
|
+
exports.createOrUpdateOutputIndex = createOrUpdateOutputIndex;
|
|
14
|
+
exports.unwrapHtmlDocumentCodeFence = unwrapHtmlDocumentCodeFence;
|
|
15
|
+
exports.toRelativeLink = toRelativeLink;
|
|
7
16
|
const promises_1 = require("fs/promises");
|
|
8
17
|
const fs_1 = require("fs");
|
|
9
18
|
const path_1 = require("path");
|
|
19
|
+
const release_js_1 = require("./release.js");
|
|
20
|
+
const output_path_js_1 = require("./output-path.js");
|
|
21
|
+
const version_js_1 = require("./version.js");
|
|
22
|
+
/**
|
|
23
|
+
* A language stands where this placeholder does while the localized indexes of
|
|
24
|
+
* a run are looked for. It never reaches a file.
|
|
25
|
+
*/
|
|
26
|
+
const LANGUAGE_PATH_PLACEHOLDER = "aireleasenoteslanguageplaceholder";
|
|
10
27
|
/**
|
|
11
28
|
* Discover index files whose path differs at one language placeholder.
|
|
12
29
|
* The placeholder may be a whole folder name or part of a filename.
|
|
@@ -50,4 +67,319 @@ async function discoverOutputIndexLanguages(patternPath, placeholder) {
|
|
|
50
67
|
})
|
|
51
68
|
.sort((left, right) => left.language.localeCompare(right.language));
|
|
52
69
|
}
|
|
70
|
+
/**
|
|
71
|
+
* Add a release to every configured index, creating the ones that do not exist.
|
|
72
|
+
*
|
|
73
|
+
* An index carries what it knows about each release it lists, so the whole list
|
|
74
|
+
* is rendered again on every run: a template or a language that changed reaches
|
|
75
|
+
* the entire history, not just the release being added.
|
|
76
|
+
*/
|
|
77
|
+
async function updateOutputIndexes(params) {
|
|
78
|
+
if (params.outputIndexes.length === 0 || params.releases.length === 0)
|
|
79
|
+
return;
|
|
80
|
+
const pathVersions = {
|
|
81
|
+
fromVersion: params.pathFromVersion ?? params.fromVersion,
|
|
82
|
+
toVersion: params.pathToVersion ?? params.toVersion,
|
|
83
|
+
};
|
|
84
|
+
const indexPath = (saveTo, language) => (0, path_1.resolve)((0, output_path_js_1.formatOutputPath)(saveTo, {
|
|
85
|
+
...pathVersions,
|
|
86
|
+
environment: params.environment,
|
|
87
|
+
language,
|
|
88
|
+
}));
|
|
89
|
+
const outputIndexTargets = params.outputIndexes.flatMap((outputIndex, groupId) => outputIndex.saveTo.includes("{lang}")
|
|
90
|
+
? params.languages.map((language) => ({
|
|
91
|
+
path: indexPath(outputIndex.saveTo, language),
|
|
92
|
+
groupId,
|
|
93
|
+
language,
|
|
94
|
+
format: outputIndex.format,
|
|
95
|
+
templatePath: outputIndex.template,
|
|
96
|
+
entryTemplatePath: outputIndex.entryTemplate,
|
|
97
|
+
templateLanguage: params.primaryLanguage,
|
|
98
|
+
}))
|
|
99
|
+
: [{
|
|
100
|
+
path: indexPath(outputIndex.saveTo),
|
|
101
|
+
groupId,
|
|
102
|
+
format: outputIndex.format,
|
|
103
|
+
templatePath: outputIndex.template,
|
|
104
|
+
entryTemplatePath: outputIndex.entryTemplate,
|
|
105
|
+
templateLanguage: params.primaryLanguage,
|
|
106
|
+
}]);
|
|
107
|
+
if (outputIndexTargets.some((index) => params.releases.some((release) => (0, path_1.resolve)(release.path) === index.path))) {
|
|
108
|
+
throw new Error("outputIndex.saveTo must be different from every output.saveTo path");
|
|
109
|
+
}
|
|
110
|
+
const duplicateIndexPath = outputIndexTargets.find((target, index) => outputIndexTargets.findIndex((candidate) => candidate.path.toLowerCase() === target.path.toLowerCase()) !== index);
|
|
111
|
+
if (duplicateIndexPath) {
|
|
112
|
+
throw new Error(`outputIndex.saveTo resolves more than once to ${duplicateIndexPath.path}. ` +
|
|
113
|
+
`Use distinct paths and language values.`);
|
|
114
|
+
}
|
|
115
|
+
const outputIndexLanguageTargets = outputIndexTargets
|
|
116
|
+
.flatMap((target) => target.language ? [{ ...target, language: target.language }] : []);
|
|
117
|
+
for (const [groupId, outputIndex] of params.outputIndexes.entries()) {
|
|
118
|
+
if (!outputIndex.saveTo.includes("{lang}"))
|
|
119
|
+
continue;
|
|
120
|
+
const discovered = await discoverOutputIndexLanguages(indexPath(outputIndex.saveTo, LANGUAGE_PATH_PLACEHOLDER), LANGUAGE_PATH_PLACEHOLDER);
|
|
121
|
+
for (const existingIndex of discovered) {
|
|
122
|
+
const alreadyAvailable = outputIndexLanguageTargets.some((target) => target.groupId === groupId &&
|
|
123
|
+
target.path.toLowerCase() === existingIndex.path.toLowerCase());
|
|
124
|
+
if (!alreadyAvailable) {
|
|
125
|
+
outputIndexLanguageTargets.push({
|
|
126
|
+
...existingIndex,
|
|
127
|
+
groupId,
|
|
128
|
+
format: outputIndex.format,
|
|
129
|
+
templatePath: outputIndex.template,
|
|
130
|
+
});
|
|
131
|
+
}
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
for (const index of outputIndexTargets) {
|
|
135
|
+
await (0, promises_1.mkdir)((0, path_1.dirname)(index.path), { recursive: true });
|
|
136
|
+
const outputIndexContent = await createOrUpdateOutputIndex({
|
|
137
|
+
outputPath: index.path,
|
|
138
|
+
format: index.format,
|
|
139
|
+
templatePath: index.templatePath,
|
|
140
|
+
entryTemplatePath: index.entryTemplatePath,
|
|
141
|
+
translateTemplate: params.translateTemplate && shouldTranslateTemplate(index.templateLanguage, index.language)
|
|
142
|
+
? (template) => params.translateTemplate(template, index.language)
|
|
143
|
+
: undefined,
|
|
144
|
+
projectName: params.projectName,
|
|
145
|
+
environment: params.environment,
|
|
146
|
+
language: index.language,
|
|
147
|
+
fromVersion: params.fromVersion,
|
|
148
|
+
toVersion: params.toVersion,
|
|
149
|
+
date: params.date,
|
|
150
|
+
releasePaths: getReleasePathsForIndex(index, params.releases),
|
|
151
|
+
languageLinks: getOutputIndexLanguageLinks(index, outputIndexLanguageTargets),
|
|
152
|
+
});
|
|
153
|
+
await (0, promises_1.writeFile)(index.path, outputIndexContent, "utf-8");
|
|
154
|
+
params.onUpdated?.(index.path, "release");
|
|
155
|
+
}
|
|
156
|
+
// An index this run did not write may still gain a sibling language, and its
|
|
157
|
+
// switcher is the only thing that has to change.
|
|
158
|
+
const currentIndexPaths = new Set(outputIndexTargets.map((target) => target.path.toLowerCase()));
|
|
159
|
+
for (const existingIndex of outputIndexLanguageTargets) {
|
|
160
|
+
if (currentIndexPaths.has(existingIndex.path.toLowerCase()))
|
|
161
|
+
continue;
|
|
162
|
+
const existing = await (0, promises_1.readFile)(existingIndex.path, "utf-8");
|
|
163
|
+
const languageLinks = getOutputIndexLanguageLinks(existingIndex, outputIndexLanguageTargets);
|
|
164
|
+
const languageSwitcher = (0, release_js_1.renderOutputIndexLanguageSwitcher)(existingIndex.format, languageLinks);
|
|
165
|
+
const hasLanguageSwitcher = (0, release_js_1.hasOutputIndexLanguageSwitcher)(existing);
|
|
166
|
+
let updated = (0, release_js_1.applyOutputIndexLanguageSwitcher)(existing, languageSwitcher);
|
|
167
|
+
if (!hasLanguageSwitcher &&
|
|
168
|
+
!existingIndex.templatePath &&
|
|
169
|
+
languageLinks.length > 1 &&
|
|
170
|
+
existing.includes(release_js_1.RELEASES_MARKER)) {
|
|
171
|
+
updated = existing.replace(release_js_1.RELEASES_MARKER, `${languageSwitcher}\n\n${release_js_1.RELEASES_MARKER}`);
|
|
172
|
+
}
|
|
173
|
+
if (updated !== existing) {
|
|
174
|
+
await (0, promises_1.writeFile)(existingIndex.path, updated, "utf-8");
|
|
175
|
+
params.onUpdated?.(existingIndex.path, "languages");
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
}
|
|
179
|
+
function getReleasePathsForIndex(index, releases) {
|
|
180
|
+
const languageReleases = releases.filter((release) => !index.language || !release.language || release.language === index.language);
|
|
181
|
+
const preferred = languageReleases.filter((release) => releaseFormat(release) === index.format);
|
|
182
|
+
const selected = preferred.length > 0
|
|
183
|
+
? preferred
|
|
184
|
+
: languageReleases.filter((release) => releaseFormat(release) !== index.format);
|
|
185
|
+
return [...new Set(selected.map((release) => (0, path_1.resolve)(release.path)))];
|
|
186
|
+
}
|
|
187
|
+
function releaseFormat(release) {
|
|
188
|
+
return release.format === "html" ? "html" : "markdown";
|
|
189
|
+
}
|
|
190
|
+
function getOutputIndexLanguageLinks(index, targets) {
|
|
191
|
+
return targets
|
|
192
|
+
.filter((candidate) => candidate.groupId === index.groupId)
|
|
193
|
+
.map((candidate) => ({
|
|
194
|
+
language: candidate.language,
|
|
195
|
+
href: toRelativeLink(index.path, candidate.path),
|
|
196
|
+
active: candidate.path.toLowerCase() === index.path.toLowerCase(),
|
|
197
|
+
}));
|
|
198
|
+
}
|
|
199
|
+
async function createOrUpdateOutputIndex(params) {
|
|
200
|
+
const languageSwitcher = (0, release_js_1.renderOutputIndexLanguageSwitcher)(params.format, params.languageLinks);
|
|
201
|
+
const record = {
|
|
202
|
+
environment: params.environment,
|
|
203
|
+
fromVersion: params.fromVersion,
|
|
204
|
+
toVersion: params.toVersion,
|
|
205
|
+
date: params.date,
|
|
206
|
+
href: toRelativeLink(params.outputPath, params.releasePaths[0]),
|
|
207
|
+
};
|
|
208
|
+
const renderReleases = (records, entryTemplate) => (0, release_js_1.renderOutputIndexReleases)({
|
|
209
|
+
records,
|
|
210
|
+
entryTemplate,
|
|
211
|
+
format: params.format,
|
|
212
|
+
localizeDate: (date) => localizeIndexDate(date, params.language),
|
|
213
|
+
});
|
|
214
|
+
if ((0, fs_1.existsSync)(params.outputPath)) {
|
|
215
|
+
const existing = await (0, promises_1.readFile)(params.outputPath, "utf-8");
|
|
216
|
+
// An index written before the releases were bounded ends its list at the
|
|
217
|
+
// first thing that follows it, so give it that boundary before reading the
|
|
218
|
+
// list back out.
|
|
219
|
+
const normalizedExisting = ensureOutputIndexReleaseBoundary(params.format === "html" ? unwrapHtmlDocumentCodeFence(existing) : existing, params.format);
|
|
220
|
+
// The entry template is read from its file on every run, so an index never
|
|
221
|
+
// has to carry a copy of it: editing the file is what changes the shape.
|
|
222
|
+
const { entryTemplate } = await loadOutputIndexEntryTemplate(params);
|
|
223
|
+
// Every release the index knows is rendered again from its record, so a
|
|
224
|
+
// template or a language that changed reaches the whole history, not just
|
|
225
|
+
// the release being added.
|
|
226
|
+
const region = (0, release_js_1.readOutputIndexReleasesRegion)(normalizedExisting);
|
|
227
|
+
const records = (0, release_js_1.upsertOutputIndexReleaseRecord)((0, release_js_1.readOutputIndexReleaseRecords)(region), record);
|
|
228
|
+
const legacyEntries = (0, release_js_1.readLegacyOutputIndexEntries)(region, records.map(release_js_1.outputIndexReleaseId));
|
|
229
|
+
const updated = (0, release_js_1.replaceOutputIndexReleases)(normalizedExisting, [renderReleases(records, entryTemplate), ...legacyEntries].filter(Boolean).join("\n"));
|
|
230
|
+
const hasLanguageSwitcher = (0, release_js_1.hasOutputIndexLanguageSwitcher)(updated);
|
|
231
|
+
const withLanguageSwitcher = (0, release_js_1.applyOutputIndexLanguageSwitcher)(updated, languageSwitcher);
|
|
232
|
+
if (!params.templatePath && params.languageLinks.length > 1 && !hasLanguageSwitcher) {
|
|
233
|
+
return updated.replace(release_js_1.RELEASES_MARKER, `${languageSwitcher}\n\n${release_js_1.RELEASES_MARKER}`);
|
|
234
|
+
}
|
|
235
|
+
return withLanguageSwitcher;
|
|
236
|
+
}
|
|
237
|
+
const { template, entryTemplate } = await loadOutputIndexEntryTemplate(params);
|
|
238
|
+
const rendered = renderOutputIndexTemplate(template, {
|
|
239
|
+
projectName: params.projectName || "Project",
|
|
240
|
+
environment: params.environment,
|
|
241
|
+
language: params.language || "",
|
|
242
|
+
date: localizeIndexDate(params.date, params.language),
|
|
243
|
+
releases: renderReleases([record], entryTemplate),
|
|
244
|
+
languages: languageSwitcher,
|
|
245
|
+
version: version_js_1.AI_RELEASE_NOTES_VERSION,
|
|
246
|
+
}, params.format);
|
|
247
|
+
if (params.format === "markdown") {
|
|
248
|
+
return rendered.trim() + "\n";
|
|
249
|
+
}
|
|
250
|
+
const isHtmlTemplate = !params.templatePath || /\.html?$/i.test(params.templatePath);
|
|
251
|
+
// An index is assembled here from the template and already-escaped entries,
|
|
252
|
+
// so its own markup is allowed through. A release note is model output and
|
|
253
|
+
// never gets that trust.
|
|
254
|
+
const html = isHtmlTemplate
|
|
255
|
+
? rendered
|
|
256
|
+
: (0, release_js_1.markdownToHtml)(rendered, { trustedHtml: true });
|
|
257
|
+
return html;
|
|
258
|
+
}
|
|
259
|
+
/**
|
|
260
|
+
* Joins the summary and the entry template on their way to the translator.
|
|
261
|
+
*
|
|
262
|
+
* It exists for the length of one call: it is never written to a template nor
|
|
263
|
+
* to a generated index.
|
|
264
|
+
*/
|
|
265
|
+
exports.ENTRY_TEMPLATE_SEPARATOR = "__AI_RELEASE_NOTES_PART__";
|
|
266
|
+
/**
|
|
267
|
+
* The summary template to render, and the entry shape to list releases with.
|
|
268
|
+
*
|
|
269
|
+
* The entry shape is not configurable, so it never comes from the summary
|
|
270
|
+
* template. Both are translated in one pass, then split apart again: only the
|
|
271
|
+
* summary is rendered, and the entry shape is stored in the index.
|
|
272
|
+
*/
|
|
273
|
+
async function loadOutputIndexEntryTemplate(params) {
|
|
274
|
+
const summary = await loadOutputIndexTemplate(params.templatePath, params.format);
|
|
275
|
+
const entryFile = await loadEntryTemplate(params.entryTemplatePath, params.format);
|
|
276
|
+
const joined = `${summary}\n${exports.ENTRY_TEMPLATE_SEPARATOR}\n${entryFile}`;
|
|
277
|
+
const localized = params.translateTemplate
|
|
278
|
+
? await params.translateTemplate(joined)
|
|
279
|
+
: joined;
|
|
280
|
+
// A translation that lost the separator cannot be split back apart. The
|
|
281
|
+
// summary stays usable; the entry falls back to the file that was sent.
|
|
282
|
+
const separator = localized.lastIndexOf(exports.ENTRY_TEMPLATE_SEPARATOR);
|
|
283
|
+
return {
|
|
284
|
+
template: (separator < 0 ? localized : localized.slice(0, separator)).trimEnd(),
|
|
285
|
+
entryTemplate: separator < 0
|
|
286
|
+
? entryFile.trim()
|
|
287
|
+
: localized.slice(separator + exports.ENTRY_TEMPLATE_SEPARATOR.length).trim(),
|
|
288
|
+
};
|
|
289
|
+
}
|
|
290
|
+
async function loadEntryTemplate(entryTemplatePath, format) {
|
|
291
|
+
if (!entryTemplatePath) {
|
|
292
|
+
return loadBundledTemplate("default-release-summary-entry", format);
|
|
293
|
+
}
|
|
294
|
+
const resolvedPath = (0, path_1.resolve)(entryTemplatePath);
|
|
295
|
+
if (!(0, fs_1.existsSync)(resolvedPath)) {
|
|
296
|
+
throw new Error(`Output index entry template not found: ${resolvedPath}`);
|
|
297
|
+
}
|
|
298
|
+
return (0, promises_1.readFile)(resolvedPath, "utf-8");
|
|
299
|
+
}
|
|
300
|
+
async function loadOutputIndexTemplate(templatePath, format) {
|
|
301
|
+
if (!templatePath) {
|
|
302
|
+
return loadBundledTemplate("default-release-summary", format);
|
|
303
|
+
}
|
|
304
|
+
const resolvedTemplatePath = (0, path_1.resolve)(templatePath);
|
|
305
|
+
if (!(0, fs_1.existsSync)(resolvedTemplatePath)) {
|
|
306
|
+
throw new Error(`Output index template not found: ${resolvedTemplatePath}`);
|
|
307
|
+
}
|
|
308
|
+
return (0, promises_1.readFile)(resolvedTemplatePath, "utf-8");
|
|
309
|
+
}
|
|
310
|
+
function loadBundledTemplate(name, format) {
|
|
311
|
+
const extension = format === "html" ? "html" : "md";
|
|
312
|
+
return (0, promises_1.readFile)((0, path_1.resolve)(__dirname, `../templates/${name}.${extension}`), "utf-8");
|
|
313
|
+
}
|
|
314
|
+
function renderOutputIndexTemplate(template, values, format = "markdown") {
|
|
315
|
+
// A project name and an environment reach an HTML index straight from config
|
|
316
|
+
// and the command line, so they are escaped like every other value there.
|
|
317
|
+
const value = (raw) => (format === "html" ? escapeHtml(raw) : raw);
|
|
318
|
+
const rendered = template
|
|
319
|
+
.replaceAll("{{projectName}}", value(values.projectName))
|
|
320
|
+
.replaceAll("{{environment}}", value(values.environment))
|
|
321
|
+
.replaceAll("{{language}}", value(values.language))
|
|
322
|
+
.replaceAll("{{date}}", value(values.date))
|
|
323
|
+
.replaceAll("{{releases}}", `${values.releases}\n${release_js_1.RELEASES_END_MARKER}`)
|
|
324
|
+
.replaceAll("{{version}}", value(values.version));
|
|
325
|
+
return (0, release_js_1.applyOutputIndexLanguageSwitcher)(rendered, values.languages);
|
|
326
|
+
}
|
|
327
|
+
function localizeIndexDate(date, language) {
|
|
328
|
+
if (!language)
|
|
329
|
+
return date;
|
|
330
|
+
const parsed = new Date(date);
|
|
331
|
+
if (Number.isNaN(parsed.getTime()))
|
|
332
|
+
return date;
|
|
333
|
+
return new Intl.DateTimeFormat(language, {
|
|
334
|
+
day: "numeric",
|
|
335
|
+
month: "long",
|
|
336
|
+
year: "numeric",
|
|
337
|
+
}).format(parsed);
|
|
338
|
+
}
|
|
339
|
+
function shouldTranslateTemplate(templateLanguage, outputLanguage) {
|
|
340
|
+
if (!outputLanguage)
|
|
341
|
+
return false;
|
|
342
|
+
return languageCode(templateLanguage) !== languageCode(outputLanguage);
|
|
343
|
+
}
|
|
344
|
+
function languageCode(language) {
|
|
345
|
+
return language.toLowerCase().split(/[-_]/, 1)[0];
|
|
346
|
+
}
|
|
347
|
+
/** Models occasionally wrap an HTML template in a Markdown code fence. */
|
|
348
|
+
function unwrapHtmlDocumentCodeFence(content) {
|
|
349
|
+
const openingFence = /^\s*```html?\s*\r?\n(?=\s*<!doctype html|\s*<html\b)/i;
|
|
350
|
+
if (!openingFence.test(content))
|
|
351
|
+
return content;
|
|
352
|
+
return content
|
|
353
|
+
.replace(openingFence, "")
|
|
354
|
+
.replace(/\r?\n```\s*$/, "");
|
|
355
|
+
}
|
|
356
|
+
function ensureOutputIndexReleaseBoundary(content, format) {
|
|
357
|
+
if (!content.includes(release_js_1.RELEASES_MARKER) || content.includes(release_js_1.RELEASES_END_MARKER)) {
|
|
358
|
+
return content;
|
|
359
|
+
}
|
|
360
|
+
const releasesStart = content.indexOf(release_js_1.RELEASES_MARKER) + release_js_1.RELEASES_MARKER.length;
|
|
361
|
+
const boundary = [
|
|
362
|
+
format === "html"
|
|
363
|
+
? content.indexOf("</main>", releasesStart)
|
|
364
|
+
: content.indexOf("\n---\n", releasesStart),
|
|
365
|
+
].filter((index) => index >= 0)[0];
|
|
366
|
+
if (boundary === undefined) {
|
|
367
|
+
return `${content.trimEnd()}\n${release_js_1.RELEASES_END_MARKER}\n`;
|
|
368
|
+
}
|
|
369
|
+
return `${content.slice(0, boundary).trimEnd()}\n${release_js_1.RELEASES_END_MARKER}\n${content.slice(boundary).replace(/^\n/, "")}`;
|
|
370
|
+
}
|
|
371
|
+
function toRelativeLink(fromPath, toPath) {
|
|
372
|
+
return (0, path_1.relative)((0, path_1.dirname)(fromPath), toPath)
|
|
373
|
+
.replaceAll("\\", "/")
|
|
374
|
+
.split("/")
|
|
375
|
+
.map((segment) => segment === "." || segment === ".." ? segment : encodeURIComponent(segment))
|
|
376
|
+
.join("/");
|
|
377
|
+
}
|
|
378
|
+
function escapeHtml(value) {
|
|
379
|
+
return value
|
|
380
|
+
.replaceAll("&", "&")
|
|
381
|
+
.replaceAll("<", "<")
|
|
382
|
+
.replaceAll(">", ">")
|
|
383
|
+
.replaceAll('"', """);
|
|
384
|
+
}
|
|
53
385
|
//# sourceMappingURL=output-index.js.map
|
package/dist/output-index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"output-index.js","sourceRoot":"","sources":["../src/output-index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,0CAAsC;AACtC,2BAAgC;AAEhC,+BAA+C;AAO/C;;;GAGG;AACI,KAAK,uCACV,WAAmB,EACnB,WAAmB;IAEnB,IAAI,mBAAmB,GAAG,WAAW,CAAC;IACtC,MAAM,gBAAgB,GAAa,EAAE,CAAC;IAEtC,OAAO,CAAC,IAAA,eAAQ,EAAC,mBAAmB,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5D,MAAM,MAAM,GAAG,IAAA,cAAO,EAAC,mBAAmB,CAAC,CAAC;QAC5C,IAAI,MAAM,KAAK,mBAAmB;YAAE,OAAO,EAAE,CAAC;QAC9C,gBAAgB,CAAC,OAAO,CAAC,IAAA,eAAQ,EAAC,mBAAmB,CAAC,CAAC,CAAC;QACxD,mBAAmB,GAAG,MAAM,CAAC;IAC/B,CAAC;IAED,MAAM,eAAe,GAAG,IAAA,cAAO,EAAC,mBAAmB,CAAC,CAAC;IACrD,MAAM,cAAc,GAAG,IAAA,eAAQ,EAAC,mBAAmB,CAAC,CAAC;IACrD,MAAM,gBAAgB,GAAG,cAAc,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,gBAAgB,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAE3E,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,IAAA,kBAAO,EAAC,eAAe,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QAClE,MAAM,KAAK,CAAC;IACd,CAAC;IAED,OAAO,OAAO;SACX,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACjB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,CAAC;QAC9E,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC;YACnC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM;YACnC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;QACtB,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC9D,IAAI,CAAC,QAAQ,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,EAAE,CAAC;QAE5D,MAAM,UAAU,GAAG,IAAA,WAAI,EAAC,eAAe,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,gBAAgB,CAAC,CAAC;QAC1E,OAAO,IAAA,eAAU,EAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,CAAC,CAAC;SACD,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;AACxE,CAAC"}
|
|
1
|
+
{"version":3,"file":"output-index.js","sourceRoot":"","sources":["../src/output-index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Where a release file goes, and which releases are already there.
|
|
3
|
+
*
|
|
4
|
+
* An `output.saveTo` is a pattern: `{env}`, `{lang}`, `{from}` and `{to}` name
|
|
5
|
+
* the parts that change from one release to the next. Filling it in says where
|
|
6
|
+
* to write. Reading it back says what has already been written, which is where
|
|
7
|
+
* promoting a release from one environment to the next starts.
|
|
8
|
+
*/
|
|
9
|
+
/** The placeholders a `saveTo` pattern may carry. */
|
|
10
|
+
export declare const OUTPUT_PATH_PLACEHOLDERS: readonly ["env", "lang", "from", "to"];
|
|
11
|
+
export type OutputPathPlaceholder = (typeof OUTPUT_PATH_PLACEHOLDERS)[number];
|
|
12
|
+
export interface OutputPathValues {
|
|
13
|
+
environment?: string;
|
|
14
|
+
language?: string;
|
|
15
|
+
fromVersion?: string;
|
|
16
|
+
toVersion?: string;
|
|
17
|
+
}
|
|
18
|
+
/** An environment as it appears in a path: `pre-prod` and `PRE PROD` are one. */
|
|
19
|
+
export declare function normalizeEnvironment(environment: string): string;
|
|
20
|
+
/** A language as it appears in a path. */
|
|
21
|
+
export declare function normalizeLanguage(language: string): string;
|
|
22
|
+
/**
|
|
23
|
+
* Fill a `saveTo` pattern with the values it is given.
|
|
24
|
+
*
|
|
25
|
+
* A value that is not supplied leaves its placeholder standing, so a pattern
|
|
26
|
+
* can be filled in stages: the environment now, the versions once they are
|
|
27
|
+
* known — or never, when what is wanted is a pattern to search with.
|
|
28
|
+
*/
|
|
29
|
+
export declare function formatOutputPath(saveTo: string, values: OutputPathValues): string;
|
|
30
|
+
/**
|
|
31
|
+
* Whether a `saveTo` pattern resolves to a different file for every release.
|
|
32
|
+
*
|
|
33
|
+
* With a version placeholder each release gets its own file and owns it.
|
|
34
|
+
* Without one, every release resolves to the same path, which is how a
|
|
35
|
+
* cumulative changelog is configured, and there the releases stack up instead.
|
|
36
|
+
*/
|
|
37
|
+
export declare function isReleaseSpecificPath(saveTo: string): boolean;
|
|
38
|
+
/** A release file found on disk, and what its path says about it. */
|
|
39
|
+
export interface DiscoveredRelease {
|
|
40
|
+
path: string;
|
|
41
|
+
environment?: string;
|
|
42
|
+
language?: string;
|
|
43
|
+
/** Absent when the pattern names only the version a release ends at. */
|
|
44
|
+
fromVersion?: string;
|
|
45
|
+
toVersion: string;
|
|
46
|
+
/** Last write time: the only order available when versions cannot be read. */
|
|
47
|
+
modifiedAt: number;
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* The releases already written for a `saveTo` pattern.
|
|
51
|
+
*
|
|
52
|
+
* Known values are filled in before the pattern is read back, so what is
|
|
53
|
+
* searched for is only what varies: given an environment, only that
|
|
54
|
+
* environment's releases are found, and a version that happens to look like an
|
|
55
|
+
* environment cannot be mistaken for one.
|
|
56
|
+
*
|
|
57
|
+
* A pattern that names no version matches one shared file rather than one file
|
|
58
|
+
* per release, so there is nothing to discover and nothing is returned.
|
|
59
|
+
*/
|
|
60
|
+
export declare function discoverReleases(saveTo: string, values?: OutputPathValues): Promise<DiscoveredRelease[]>;
|
|
61
|
+
//# sourceMappingURL=output-path.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"output-path.d.ts","sourceRoot":"","sources":["../src/output-path.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,qDAAqD;AACrD,eAAO,MAAM,wBAAwB,YAAI,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAU,CAAC;AAE/E,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9E,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,iFAAiF;AACjF,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,0CAA0C;AAC1C,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAUjF;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,qEAAqE;AACrE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,gBAAqB,GAC5B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAO9B"}
|
|
@@ -0,0 +1,182 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* Where a release file goes, and which releases are already there.
|
|
4
|
+
*
|
|
5
|
+
* An `output.saveTo` is a pattern: `{env}`, `{lang}`, `{from}` and `{to}` name
|
|
6
|
+
* the parts that change from one release to the next. Filling it in says where
|
|
7
|
+
* to write. Reading it back says what has already been written, which is where
|
|
8
|
+
* promoting a release from one environment to the next starts.
|
|
9
|
+
*/
|
|
10
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
11
|
+
exports.OUTPUT_PATH_PLACEHOLDERS = void 0;
|
|
12
|
+
exports.normalizeEnvironment = normalizeEnvironment;
|
|
13
|
+
exports.normalizeLanguage = normalizeLanguage;
|
|
14
|
+
exports.formatOutputPath = formatOutputPath;
|
|
15
|
+
exports.isReleaseSpecificPath = isReleaseSpecificPath;
|
|
16
|
+
exports.discoverReleases = discoverReleases;
|
|
17
|
+
const promises_1 = require("fs/promises");
|
|
18
|
+
const fs_1 = require("fs");
|
|
19
|
+
const path_1 = require("path");
|
|
20
|
+
/** The placeholders a `saveTo` pattern may carry. */
|
|
21
|
+
exports.OUTPUT_PATH_PLACEHOLDERS = ["env", "lang", "from", "to"];
|
|
22
|
+
/** An environment as it appears in a path: `pre-prod` and `PRE PROD` are one. */
|
|
23
|
+
function normalizeEnvironment(environment) {
|
|
24
|
+
return environment.trim().toUpperCase().replace(/[^A-Z0-9]+/g, "_");
|
|
25
|
+
}
|
|
26
|
+
/** A language as it appears in a path. */
|
|
27
|
+
function normalizeLanguage(language) {
|
|
28
|
+
return language.trim().toLowerCase().replace(/[^a-z0-9]+/g, "_");
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
* Fill a `saveTo` pattern with the values it is given.
|
|
32
|
+
*
|
|
33
|
+
* A value that is not supplied leaves its placeholder standing, so a pattern
|
|
34
|
+
* can be filled in stages: the environment now, the versions once they are
|
|
35
|
+
* known — or never, when what is wanted is a pattern to search with.
|
|
36
|
+
*/
|
|
37
|
+
function formatOutputPath(saveTo, values) {
|
|
38
|
+
return saveTo
|
|
39
|
+
.replaceAll("{env}", values.environment === undefined
|
|
40
|
+
? "{env}"
|
|
41
|
+
: normalizeEnvironment(values.environment))
|
|
42
|
+
.replaceAll("{lang}", values.language === undefined
|
|
43
|
+
? "{lang}"
|
|
44
|
+
: normalizeLanguage(values.language))
|
|
45
|
+
.replaceAll("{from}", values.fromVersion ?? "{from}")
|
|
46
|
+
.replaceAll("{to}", values.toVersion ?? "{to}");
|
|
47
|
+
}
|
|
48
|
+
/**
|
|
49
|
+
* Whether a `saveTo` pattern resolves to a different file for every release.
|
|
50
|
+
*
|
|
51
|
+
* With a version placeholder each release gets its own file and owns it.
|
|
52
|
+
* Without one, every release resolves to the same path, which is how a
|
|
53
|
+
* cumulative changelog is configured, and there the releases stack up instead.
|
|
54
|
+
*/
|
|
55
|
+
function isReleaseSpecificPath(saveTo) {
|
|
56
|
+
return saveTo.includes("{from}") || saveTo.includes("{to}");
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
* The releases already written for a `saveTo` pattern.
|
|
60
|
+
*
|
|
61
|
+
* Known values are filled in before the pattern is read back, so what is
|
|
62
|
+
* searched for is only what varies: given an environment, only that
|
|
63
|
+
* environment's releases are found, and a version that happens to look like an
|
|
64
|
+
* environment cannot be mistaken for one.
|
|
65
|
+
*
|
|
66
|
+
* A pattern that names no version matches one shared file rather than one file
|
|
67
|
+
* per release, so there is nothing to discover and nothing is returned.
|
|
68
|
+
*/
|
|
69
|
+
async function discoverReleases(saveTo, values = {}) {
|
|
70
|
+
const pattern = formatOutputPath(saveTo, { ...values, fromVersion: undefined, toVersion: undefined });
|
|
71
|
+
if (!pattern.includes("{to}"))
|
|
72
|
+
return [];
|
|
73
|
+
const segments = (0, path_1.resolve)(pattern).split(path_1.sep);
|
|
74
|
+
const releases = await walkPatternSegments(segments[0] || path_1.sep, segments.slice(1), {});
|
|
75
|
+
return releases.sort(compareDiscoveredReleases);
|
|
76
|
+
}
|
|
77
|
+
async function walkPatternSegments(directory, segments, captured) {
|
|
78
|
+
const [segment, ...rest] = segments;
|
|
79
|
+
if (segment === undefined)
|
|
80
|
+
return [];
|
|
81
|
+
const matcher = compileSegment(segment);
|
|
82
|
+
const isLeaf = rest.length === 0;
|
|
83
|
+
if (!matcher) {
|
|
84
|
+
const path = joinSegment(directory, segment);
|
|
85
|
+
if (!(0, fs_1.existsSync)(path))
|
|
86
|
+
return [];
|
|
87
|
+
return isLeaf ? describeRelease(path, captured) : walkPatternSegments(path, rest, captured);
|
|
88
|
+
}
|
|
89
|
+
let entries;
|
|
90
|
+
try {
|
|
91
|
+
entries = await (0, promises_1.readdir)(directory, { withFileTypes: true });
|
|
92
|
+
}
|
|
93
|
+
catch (error) {
|
|
94
|
+
if (error.code === "ENOENT")
|
|
95
|
+
return [];
|
|
96
|
+
throw error;
|
|
97
|
+
}
|
|
98
|
+
// Only the last segment names a file; every segment before it is a folder.
|
|
99
|
+
const wantsDirectory = !isLeaf;
|
|
100
|
+
const matched = await Promise.all(entries.map(async (entry) => {
|
|
101
|
+
if (entry.isDirectory() !== wantsDirectory)
|
|
102
|
+
return [];
|
|
103
|
+
const match = matcher.regex.exec(entry.name);
|
|
104
|
+
if (!match)
|
|
105
|
+
return [];
|
|
106
|
+
const merged = { ...captured };
|
|
107
|
+
matcher.keys.forEach((key, index) => {
|
|
108
|
+
merged[key] = match[index + 1];
|
|
109
|
+
});
|
|
110
|
+
const path = joinSegment(directory, entry.name);
|
|
111
|
+
return isLeaf
|
|
112
|
+
? describeRelease(path, merged)
|
|
113
|
+
: walkPatternSegments(path, rest, merged);
|
|
114
|
+
}));
|
|
115
|
+
return matched.flat();
|
|
116
|
+
}
|
|
117
|
+
async function describeRelease(path, captured) {
|
|
118
|
+
if (!captured.to)
|
|
119
|
+
return [];
|
|
120
|
+
let modifiedAt = 0;
|
|
121
|
+
try {
|
|
122
|
+
modifiedAt = (await (0, promises_1.stat)(path)).mtimeMs;
|
|
123
|
+
}
|
|
124
|
+
catch {
|
|
125
|
+
return [];
|
|
126
|
+
}
|
|
127
|
+
return [{
|
|
128
|
+
path,
|
|
129
|
+
environment: captured.env,
|
|
130
|
+
language: captured.lang,
|
|
131
|
+
fromVersion: captured.from,
|
|
132
|
+
toVersion: captured.to,
|
|
133
|
+
modifiedAt,
|
|
134
|
+
}];
|
|
135
|
+
}
|
|
136
|
+
function joinSegment(directory, segment) {
|
|
137
|
+
return directory.endsWith(path_1.sep) ? directory + segment : directory + path_1.sep + segment;
|
|
138
|
+
}
|
|
139
|
+
/**
|
|
140
|
+
* What each placeholder may stand for inside one path segment.
|
|
141
|
+
*
|
|
142
|
+
* An environment and a language are normalized on their way into a path, so
|
|
143
|
+
* what they may contain is known. A version is whatever the repository tags
|
|
144
|
+
* are, so it is bounded only by the separators around it: a version carrying
|
|
145
|
+
* the character that separates it from the next one cannot be told apart from
|
|
146
|
+
* two versions, and is the one shape this cannot read back.
|
|
147
|
+
*/
|
|
148
|
+
const PLACEHOLDER_PATTERNS = {
|
|
149
|
+
env: "[A-Za-z0-9_]+?",
|
|
150
|
+
lang: "[A-Za-z0-9_]+?",
|
|
151
|
+
from: ".+?",
|
|
152
|
+
to: ".+?",
|
|
153
|
+
};
|
|
154
|
+
const PLACEHOLDER = /\{(env|lang|from|to)\}/g;
|
|
155
|
+
/** A matcher for one path segment, or nothing when the segment is literal. */
|
|
156
|
+
function compileSegment(segment) {
|
|
157
|
+
const keys = [];
|
|
158
|
+
let source = "";
|
|
159
|
+
let position = 0;
|
|
160
|
+
PLACEHOLDER.lastIndex = 0;
|
|
161
|
+
for (let match = PLACEHOLDER.exec(segment); match; match = PLACEHOLDER.exec(segment)) {
|
|
162
|
+
const key = match[1];
|
|
163
|
+
keys.push(key);
|
|
164
|
+
source += escapeRegExp(segment.slice(position, match.index));
|
|
165
|
+
source += `(${PLACEHOLDER_PATTERNS[key]})`;
|
|
166
|
+
position = match.index + match[0].length;
|
|
167
|
+
}
|
|
168
|
+
if (keys.length === 0)
|
|
169
|
+
return undefined;
|
|
170
|
+
source += escapeRegExp(segment.slice(position));
|
|
171
|
+
return { regex: new RegExp(`^${source}$`), keys };
|
|
172
|
+
}
|
|
173
|
+
function escapeRegExp(value) {
|
|
174
|
+
return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
|
|
175
|
+
}
|
|
176
|
+
function compareDiscoveredReleases(left, right) {
|
|
177
|
+
return ((left.language || "").localeCompare(right.language || "") ||
|
|
178
|
+
(left.fromVersion || "").localeCompare(right.fromVersion || "") ||
|
|
179
|
+
left.toVersion.localeCompare(right.toVersion) ||
|
|
180
|
+
left.path.localeCompare(right.path));
|
|
181
|
+
}
|
|
182
|
+
//# sourceMappingURL=output-path.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"output-path.js","sourceRoot":"","sources":["../src/output-path.ts"],"names":[],"mappings":"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"}
|