@stephansama/auto-readme 0.2.1 → 0.2.3
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 +19 -59
- package/config/schema.cjs +119 -128
- package/config/schema.d.cts +94 -135
- package/config/schema.d.ts +94 -135
- package/config/schema.js +96 -101
- package/config/schema.json +1 -1
- package/config/schema.yaml +1 -0
- package/dist/index.cjs +604 -664
- package/dist/index.d.cts +4 -0
- package/dist/index.d.ts +4 -0
- package/dist/index.js +559 -634
- package/package.json +26 -27
- package/config/schema.cjs.map +0 -1
- package/config/schema.js.map +0 -1
- package/dist/index.cjs.map +0 -1
- package/dist/index.js.map +0 -1
package/config/schema.js
CHANGED
|
@@ -1,106 +1,101 @@
|
|
|
1
|
-
// src/schema.js
|
|
2
1
|
import { z } from "zod";
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
2
|
+
|
|
3
|
+
//#region src/schema.ts
|
|
4
|
+
const actionsSchema = z.enum([
|
|
5
|
+
"ACTION",
|
|
6
|
+
"PKG",
|
|
7
|
+
"USAGE",
|
|
8
|
+
"WORKSPACE",
|
|
9
|
+
"ZOD"
|
|
10
|
+
]).describe("Comment action options");
|
|
11
|
+
const formatsSchema = z.enum(["LIST", "TABLE"]).default("TABLE").optional();
|
|
12
|
+
const languageSchema = z.enum(["JS", "RS"]).optional().default("JS");
|
|
13
|
+
const headingsSchema = z.enum([
|
|
14
|
+
"default",
|
|
15
|
+
"description",
|
|
16
|
+
"devDependency",
|
|
17
|
+
"downloads",
|
|
18
|
+
"name",
|
|
19
|
+
"private",
|
|
20
|
+
"required",
|
|
21
|
+
"version"
|
|
15
22
|
]).describe("Table heading options");
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
23
|
+
const tableHeadingsSchema = z.record(actionsSchema, headingsSchema.array().optional()).optional().describe("Table heading action configuration").default({
|
|
24
|
+
ACTION: [
|
|
25
|
+
"name",
|
|
26
|
+
"required",
|
|
27
|
+
"default",
|
|
28
|
+
"description"
|
|
29
|
+
],
|
|
30
|
+
PKG: [
|
|
31
|
+
"name",
|
|
32
|
+
"version",
|
|
33
|
+
"devDependency"
|
|
34
|
+
],
|
|
35
|
+
USAGE: [],
|
|
36
|
+
WORKSPACE: [
|
|
37
|
+
"name",
|
|
38
|
+
"version",
|
|
39
|
+
"downloads",
|
|
40
|
+
"description"
|
|
41
|
+
],
|
|
42
|
+
ZOD: []
|
|
21
43
|
});
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
"https://img.shields.io/npm/v/{{uri_name}}?logo=npm&logoColor=red&color=211F1F&labelColor=211F1F"
|
|
37
|
-
)
|
|
44
|
+
const templatesSchema = z.object({
|
|
45
|
+
downloadImage: z.string().optional().default("https://img.shields.io/npm/dw/{{name}}?labelColor=211F1F"),
|
|
46
|
+
emojis: z.record(headingsSchema, z.string()).optional().describe("Table heading emojis used when enabled").default({
|
|
47
|
+
default: "⚙️",
|
|
48
|
+
description: "📝",
|
|
49
|
+
devDependency: "💻",
|
|
50
|
+
downloads: "📥",
|
|
51
|
+
name: "🏷️",
|
|
52
|
+
private: "🔒",
|
|
53
|
+
required: "",
|
|
54
|
+
version: ""
|
|
55
|
+
}),
|
|
56
|
+
registryUrl: z.string().optional().default("https://www.npmjs.com/package/{{name}}"),
|
|
57
|
+
versionImage: z.string().optional().default("https://img.shields.io/npm/v/{{uri_name}}?logo=npm&logoColor=red&color=211F1F&labelColor=211F1F")
|
|
38
58
|
});
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
templates: templatesSchema.optional().default(defaultTemplates).describe(
|
|
78
|
-
"Handlebars templates used to fuel list and table generation"
|
|
79
|
-
),
|
|
80
|
-
tocHeading: z.string().optional().default("Table of contents").meta({
|
|
81
|
-
description: "Markdown heading used to generate table of contents"
|
|
82
|
-
}),
|
|
83
|
-
usageFile: z.string().optional().default("").meta({
|
|
84
|
-
description: "Workspace level usage file"
|
|
85
|
-
}),
|
|
86
|
-
usageHeading: z.string().optional().default("Usage").meta({
|
|
87
|
-
description: "Markdown heading used to generate usage example"
|
|
88
|
-
}),
|
|
89
|
-
verbose: z.boolean().default(false).meta({
|
|
90
|
-
alias: "v",
|
|
91
|
-
description: "whether or not to display verbose logging"
|
|
92
|
-
})
|
|
59
|
+
const defaultTemplates = templatesSchema.parse({});
|
|
60
|
+
const defaultTableHeadings = tableHeadingsSchema.parse(void 0);
|
|
61
|
+
const _configSchema = z.object({
|
|
62
|
+
affectedRegexes: z.string().array().optional().default([]),
|
|
63
|
+
collapseHeadings: z.string().array().optional().default([]),
|
|
64
|
+
defaultLanguage: languageSchema.meta({
|
|
65
|
+
alias: "l",
|
|
66
|
+
description: "Default language to infer projects from"
|
|
67
|
+
}),
|
|
68
|
+
disableEmojis: z.boolean().default(false).meta({
|
|
69
|
+
alias: "e",
|
|
70
|
+
description: "Whether or not to use emojis in markdown table headings"
|
|
71
|
+
}),
|
|
72
|
+
disableMarkdownHeadings: z.boolean().default(false).meta({ description: "Whether or not to display markdown headings" }),
|
|
73
|
+
enablePrettier: z.boolean().default(true).meta({ description: "Whether or not to use prettier to format the files" }),
|
|
74
|
+
enableToc: z.boolean().default(false).meta({
|
|
75
|
+
alias: "t",
|
|
76
|
+
description: "generate table of contents for readmes"
|
|
77
|
+
}),
|
|
78
|
+
enableUsage: z.boolean().optional().default(false).meta({ description: "Whether or not to enable usage plugin" }),
|
|
79
|
+
headings: tableHeadingsSchema.optional().default(defaultTableHeadings).describe("List of headings for different table outputs"),
|
|
80
|
+
onlyReadmes: z.boolean().default(true).meta({
|
|
81
|
+
alias: "r",
|
|
82
|
+
description: "Whether or not to only traverse readmes"
|
|
83
|
+
}),
|
|
84
|
+
onlyShowPublicPackages: z.boolean().default(false).meta({
|
|
85
|
+
alias: "p",
|
|
86
|
+
description: "Only show public packages in workspaces"
|
|
87
|
+
}),
|
|
88
|
+
removeScope: z.string().optional().default("").meta({ description: "Remove common workspace scope" }),
|
|
89
|
+
templates: templatesSchema.optional().default(defaultTemplates).describe("Handlebars templates used to fuel list and table generation"),
|
|
90
|
+
tocHeading: z.string().optional().default("Table of contents").meta({ description: "Markdown heading used to generate table of contents" }),
|
|
91
|
+
usageFile: z.string().optional().default("").meta({ description: "Workspace level usage file" }),
|
|
92
|
+
usageHeading: z.string().optional().default("Usage").meta({ description: "Markdown heading used to generate usage example" }),
|
|
93
|
+
verbose: z.boolean().default(false).meta({
|
|
94
|
+
alias: "v",
|
|
95
|
+
description: "whether or not to display verbose logging"
|
|
96
|
+
})
|
|
93
97
|
});
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
defaultTableHeadings,
|
|
99
|
-
defaultTemplates,
|
|
100
|
-
formatsSchema,
|
|
101
|
-
headingsSchema,
|
|
102
|
-
languageSchema,
|
|
103
|
-
tableHeadingsSchema,
|
|
104
|
-
templatesSchema
|
|
105
|
-
};
|
|
106
|
-
//# sourceMappingURL=schema.js.map
|
|
98
|
+
const configSchema = _configSchema.optional();
|
|
99
|
+
|
|
100
|
+
//#endregion
|
|
101
|
+
export { actionsSchema, configSchema, defaultTableHeadings, defaultTemplates, formatsSchema, languageSchema };
|
package/config/schema.json
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"affectedRegexes":{"default":[],"type":"array","items":{"type":"string"}},"collapseHeadings":{"default":[],"type":"array","items":{"type":"string"}},"defaultLanguage":{"alias":"l","description":"Default language to infer projects from","default":"JS","type":"string","enum":["JS","RS"]},"disableEmojis":{"alias":"e","description":"Whether or not to use emojis in markdown table headings","default":false,"type":"boolean"},"disableMarkdownHeadings":{"description":"Whether or not to display markdown headings","default":false,"type":"boolean"},"enablePrettier":{"description":"Whether or not to use prettier to format the files","default":true,"type":"boolean"},"enableToc":{"alias":"t","description":"generate table of contents for readmes","default":false,"type":"boolean"},"enableUsage":{"description":"Whether or not to enable usage plugin","default":false,"type":"boolean"},"headings":{"description":"List of headings for different table outputs","default":{"ACTION":["name","required","default","description"],"PKG":["name","version","devDependency"],"WORKSPACE":["name","version","downloads","description"],"ZOD":[]},"type":"object","propertyNames":{"description":"Comment action options","type":"string","enum":["ACTION","PKG","USAGE","WORKSPACE","ZOD"]},"additionalProperties":{"type":"array","items":{"description":"Table heading options","type":"string","enum":["default","description","devDependency","downloads","name","private","required","version"]}}},"onlyReadmes":{"alias":"r","description":"Whether or not to only traverse readmes","default":true,"type":"boolean"},"onlyShowPublicPackages":{"alias":"p","description":"Only show public packages in workspaces","default":false,"type":"boolean"},"removeScope":{"description":"Remove common workspace scope","default":"","type":"string"},"templates":{"description":"Handlebars templates used to fuel list and table generation","default":{"downloadImage":"https://img.shields.io/npm/dw/{{name}}?labelColor=211F1F","emojis":{"default":"⚙️","description":"📝","devDependency":"💻","downloads":"📥","name":"🏷️","private":"🔒","required":"","version":""},"registryUrl":"https://www.npmjs.com/package/{{name}}","versionImage":"https://img.shields.io/npm/v/{{uri_name}}?logo=npm&logoColor=red&color=211F1F&labelColor=211F1F"},"type":"object","properties":{"downloadImage":{"default":"https://img.shields.io/npm/dw/{{name}}?labelColor=211F1F","type":"string"},"emojis":{"default":{"default":"⚙️","description":"📝","devDependency":"💻","downloads":"📥","name":"🏷️","private":"🔒","required":"","version":""},"description":"Table heading emojis used when enabled","type":"object","propertyNames":{"description":"Table heading options","type":"string","enum":["default","description","devDependency","downloads","name","private","required","version"]},"additionalProperties":{"type":"string"}},"registryUrl":{"default":"https://www.npmjs.com/package/{{name}}","type":"string"},"versionImage":{"default":"https://img.shields.io/npm/v/{{uri_name}}?logo=npm&logoColor=red&color=211F1F&labelColor=211F1F","type":"string"}},"required":["downloadImage","emojis","registryUrl","versionImage"],"additionalProperties":false},"tocHeading":{"description":"Markdown heading used to generate table of contents","default":"Table of contents","type":"string"},"usageFile":{"description":"Workspace level usage file","default":"","type":"string"},"usageHeading":{"description":"Markdown heading used to generate usage example","default":"Usage","type":"string"},"verbose":{"alias":"v","description":"whether or not to display verbose logging","default":false,"type":"boolean"}},"required":["affectedRegexes","collapseHeadings","defaultLanguage","disableEmojis","disableMarkdownHeadings","enablePrettier","enableToc","enableUsage","headings","onlyReadmes","onlyShowPublicPackages","removeScope","templates","tocHeading","usageFile","usageHeading","verbose"],"additionalProperties":false}
|
|
1
|
+
{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"affectedRegexes":{"default":[],"type":"array","items":{"type":"string"}},"collapseHeadings":{"default":[],"type":"array","items":{"type":"string"}},"defaultLanguage":{"alias":"l","description":"Default language to infer projects from","default":"JS","type":"string","enum":["JS","RS"]},"disableEmojis":{"alias":"e","description":"Whether or not to use emojis in markdown table headings","default":false,"type":"boolean"},"disableMarkdownHeadings":{"description":"Whether or not to display markdown headings","default":false,"type":"boolean"},"enablePrettier":{"description":"Whether or not to use prettier to format the files","default":true,"type":"boolean"},"enableToc":{"alias":"t","description":"generate table of contents for readmes","default":false,"type":"boolean"},"enableUsage":{"description":"Whether or not to enable usage plugin","default":false,"type":"boolean"},"headings":{"description":"List of headings for different table outputs","default":{"ACTION":["name","required","default","description"],"PKG":["name","version","devDependency"],"USAGE":[],"WORKSPACE":["name","version","downloads","description"],"ZOD":[]},"type":"object","propertyNames":{"description":"Comment action options","type":"string","enum":["ACTION","PKG","USAGE","WORKSPACE","ZOD"]},"additionalProperties":{"type":"array","items":{"description":"Table heading options","type":"string","enum":["default","description","devDependency","downloads","name","private","required","version"]}}},"onlyReadmes":{"alias":"r","description":"Whether or not to only traverse readmes","default":true,"type":"boolean"},"onlyShowPublicPackages":{"alias":"p","description":"Only show public packages in workspaces","default":false,"type":"boolean"},"removeScope":{"description":"Remove common workspace scope","default":"","type":"string"},"templates":{"description":"Handlebars templates used to fuel list and table generation","default":{"downloadImage":"https://img.shields.io/npm/dw/{{name}}?labelColor=211F1F","emojis":{"default":"⚙️","description":"📝","devDependency":"💻","downloads":"📥","name":"🏷️","private":"🔒","required":"","version":""},"registryUrl":"https://www.npmjs.com/package/{{name}}","versionImage":"https://img.shields.io/npm/v/{{uri_name}}?logo=npm&logoColor=red&color=211F1F&labelColor=211F1F"},"type":"object","properties":{"downloadImage":{"default":"https://img.shields.io/npm/dw/{{name}}?labelColor=211F1F","type":"string"},"emojis":{"default":{"default":"⚙️","description":"📝","devDependency":"💻","downloads":"📥","name":"🏷️","private":"🔒","required":"","version":""},"description":"Table heading emojis used when enabled","type":"object","propertyNames":{"description":"Table heading options","type":"string","enum":["default","description","devDependency","downloads","name","private","required","version"]},"additionalProperties":{"type":"string"}},"registryUrl":{"default":"https://www.npmjs.com/package/{{name}}","type":"string"},"versionImage":{"default":"https://img.shields.io/npm/v/{{uri_name}}?logo=npm&logoColor=red&color=211F1F&labelColor=211F1F","type":"string"}},"required":["downloadImage","emojis","registryUrl","versionImage"],"additionalProperties":false},"tocHeading":{"description":"Markdown heading used to generate table of contents","default":"Table of contents","type":"string"},"usageFile":{"description":"Workspace level usage file","default":"","type":"string"},"usageHeading":{"description":"Markdown heading used to generate usage example","default":"Usage","type":"string"},"verbose":{"alias":"v","description":"whether or not to display verbose logging","default":false,"type":"boolean"}},"required":["affectedRegexes","collapseHeadings","defaultLanguage","disableEmojis","disableMarkdownHeadings","enablePrettier","enableToc","enableUsage","headings","onlyReadmes","onlyShowPublicPackages","removeScope","templates","tocHeading","usageFile","usageHeading","verbose"],"additionalProperties":false}
|