@maizzle/framework 6.0.0-rc.1 → 6.0.0-rc.2

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 (207) hide show
  1. package/bin/maizzle.mjs +1 -1
  2. package/dist/build.mjs +2 -1
  3. package/dist/build.mjs.map +1 -1
  4. package/dist/config/index.mjs +7 -0
  5. package/dist/config/index.mjs.map +1 -1
  6. package/dist/render/createRenderer.d.mts +2 -0
  7. package/dist/render/createRenderer.d.mts.map +1 -1
  8. package/dist/render/createRenderer.mjs +7 -2
  9. package/dist/render/createRenderer.mjs.map +1 -1
  10. package/dist/render/index.mjs +2 -1
  11. package/dist/render/index.mjs.map +1 -1
  12. package/dist/serve.mjs +2 -1
  13. package/dist/serve.mjs.map +1 -1
  14. package/dist/types/config.d.mts +3 -0
  15. package/dist/types/config.d.mts.map +1 -1
  16. package/node_modules/@clack/core/CHANGELOG.md +87 -4
  17. package/node_modules/@clack/core/README.md +1 -1
  18. package/node_modules/@clack/core/dist/index.d.mts +186 -48
  19. package/node_modules/@clack/core/dist/index.mjs +10 -14
  20. package/node_modules/@clack/core/dist/index.mjs.map +1 -1
  21. package/node_modules/@clack/core/package.json +7 -9
  22. package/node_modules/@clack/prompts/CHANGELOG.md +171 -7
  23. package/node_modules/@clack/prompts/README.md +66 -3
  24. package/node_modules/@clack/prompts/dist/index.d.mts +302 -76
  25. package/node_modules/@clack/prompts/dist/index.mjs +134 -84
  26. package/node_modules/@clack/prompts/dist/index.mjs.map +1 -1
  27. package/node_modules/@clack/prompts/package.json +14 -10
  28. package/node_modules/citty/LICENSE +0 -15
  29. package/node_modules/citty/README.md +166 -69
  30. package/node_modules/citty/dist/index.d.mts +88 -56
  31. package/node_modules/citty/dist/index.mjs +399 -437
  32. package/node_modules/citty/package.json +28 -35
  33. package/node_modules/giget/README.md +59 -11
  34. package/node_modules/giget/dist/THIRD-PARTY-LICENSES.md +205 -0
  35. package/node_modules/giget/dist/_chunks/giget.mjs +508 -0
  36. package/node_modules/giget/dist/_chunks/libs/citty.mjs +269 -0
  37. package/node_modules/giget/dist/_chunks/libs/nypm.d.mts +1 -0
  38. package/node_modules/giget/dist/_chunks/libs/nypm.mjs +669 -0
  39. package/node_modules/giget/dist/_chunks/libs/tar.mjs +2931 -0
  40. package/node_modules/giget/dist/_chunks/rolldown-runtime.mjs +14 -0
  41. package/node_modules/giget/dist/cli.d.mts +1 -0
  42. package/node_modules/giget/dist/cli.mjs +89 -111
  43. package/node_modules/giget/dist/index.d.mts +46 -35
  44. package/node_modules/giget/dist/index.mjs +2 -22
  45. package/node_modules/giget/package.json +32 -45
  46. package/node_modules/maizzle/README.md +140 -0
  47. package/node_modules/maizzle/bin/maizzle.mjs +5 -0
  48. package/node_modules/maizzle/dist/commands/new.d.mts +7 -0
  49. package/node_modules/maizzle/dist/commands/new.mjs +278 -0
  50. package/node_modules/{@maizzle/cli → maizzle}/dist/index.d.mts +1 -1
  51. package/node_modules/maizzle/dist/index.mjs +44 -0
  52. package/node_modules/{commander → maizzle/node_modules/commander}/Readme.md +94 -67
  53. package/node_modules/{commander → maizzle/node_modules/commander}/lib/argument.js +5 -4
  54. package/node_modules/{commander → maizzle/node_modules/commander}/lib/command.js +154 -39
  55. package/node_modules/{commander → maizzle/node_modules/commander}/lib/help.js +77 -39
  56. package/node_modules/{commander → maizzle/node_modules/commander}/lib/option.js +16 -3
  57. package/node_modules/{commander → maizzle/node_modules/commander}/package-support.json +4 -1
  58. package/node_modules/{commander → maizzle/node_modules/commander}/package.json +8 -8
  59. package/node_modules/{commander → maizzle/node_modules/commander}/typings/index.d.ts +71 -3
  60. package/node_modules/{@maizzle/cli → maizzle}/package.json +13 -11
  61. package/node_modules/tinyexec/README.md +49 -3
  62. package/node_modules/tinyexec/dist/main.d.mts +25 -14
  63. package/node_modules/tinyexec/dist/main.mjs +148 -100
  64. package/node_modules/tinyexec/package.json +9 -8
  65. package/package.json +3 -3
  66. package/node_modules/@clack/core/dist/index.cjs +0 -15
  67. package/node_modules/@clack/core/dist/index.cjs.map +0 -1
  68. package/node_modules/@clack/core/dist/index.d.cts +0 -211
  69. package/node_modules/@clack/core/dist/index.d.ts +0 -211
  70. package/node_modules/@clack/prompts/dist/index.cjs +0 -87
  71. package/node_modules/@clack/prompts/dist/index.cjs.map +0 -1
  72. package/node_modules/@clack/prompts/dist/index.d.cts +0 -165
  73. package/node_modules/@clack/prompts/dist/index.d.ts +0 -165
  74. package/node_modules/@maizzle/cli/README.md +0 -58
  75. package/node_modules/@maizzle/cli/dist/index.mjs +0 -42
  76. package/node_modules/citty/dist/index.cjs +0 -475
  77. package/node_modules/citty/dist/index.d.cts +0 -80
  78. package/node_modules/citty/dist/index.d.ts +0 -80
  79. package/node_modules/consola/LICENSE +0 -47
  80. package/node_modules/consola/README.md +0 -352
  81. package/node_modules/consola/basic.d.ts +0 -1
  82. package/node_modules/consola/browser.d.ts +0 -1
  83. package/node_modules/consola/core.d.ts +0 -1
  84. package/node_modules/consola/dist/basic.cjs +0 -32
  85. package/node_modules/consola/dist/basic.d.cts +0 -23
  86. package/node_modules/consola/dist/basic.d.mts +0 -21
  87. package/node_modules/consola/dist/basic.d.ts +0 -23
  88. package/node_modules/consola/dist/basic.mjs +0 -24
  89. package/node_modules/consola/dist/browser.cjs +0 -84
  90. package/node_modules/consola/dist/browser.d.cts +0 -23
  91. package/node_modules/consola/dist/browser.d.mts +0 -21
  92. package/node_modules/consola/dist/browser.d.ts +0 -23
  93. package/node_modules/consola/dist/browser.mjs +0 -76
  94. package/node_modules/consola/dist/chunks/prompt.cjs +0 -288
  95. package/node_modules/consola/dist/chunks/prompt.mjs +0 -280
  96. package/node_modules/consola/dist/core.cjs +0 -517
  97. package/node_modules/consola/dist/core.d.cts +0 -459
  98. package/node_modules/consola/dist/core.d.mts +0 -459
  99. package/node_modules/consola/dist/core.d.ts +0 -459
  100. package/node_modules/consola/dist/core.mjs +0 -512
  101. package/node_modules/consola/dist/index.cjs +0 -663
  102. package/node_modules/consola/dist/index.d.cts +0 -24
  103. package/node_modules/consola/dist/index.d.mts +0 -22
  104. package/node_modules/consola/dist/index.d.ts +0 -24
  105. package/node_modules/consola/dist/index.mjs +0 -651
  106. package/node_modules/consola/dist/shared/consola.DCGIlDNP.cjs +0 -75
  107. package/node_modules/consola/dist/shared/consola.DRwqZj3T.mjs +0 -72
  108. package/node_modules/consola/dist/shared/consola.DXBYu-KD.mjs +0 -288
  109. package/node_modules/consola/dist/shared/consola.DwRq1yyg.cjs +0 -312
  110. package/node_modules/consola/dist/utils.cjs +0 -64
  111. package/node_modules/consola/dist/utils.d.cts +0 -286
  112. package/node_modules/consola/dist/utils.d.mts +0 -286
  113. package/node_modules/consola/dist/utils.d.ts +0 -286
  114. package/node_modules/consola/dist/utils.mjs +0 -54
  115. package/node_modules/consola/lib/index.cjs +0 -10
  116. package/node_modules/consola/package.json +0 -136
  117. package/node_modules/consola/utils.d.ts +0 -1
  118. package/node_modules/create-maizzle/README.md +0 -86
  119. package/node_modules/create-maizzle/bin/create-maizzle.mjs +0 -4
  120. package/node_modules/create-maizzle/node_modules/@clack/core/CHANGELOG.md +0 -340
  121. package/node_modules/create-maizzle/node_modules/@clack/core/LICENSE +0 -9
  122. package/node_modules/create-maizzle/node_modules/@clack/core/README.md +0 -22
  123. package/node_modules/create-maizzle/node_modules/@clack/core/dist/index.d.mts +0 -349
  124. package/node_modules/create-maizzle/node_modules/@clack/core/dist/index.mjs +0 -11
  125. package/node_modules/create-maizzle/node_modules/@clack/core/dist/index.mjs.map +0 -1
  126. package/node_modules/create-maizzle/node_modules/@clack/core/package.json +0 -60
  127. package/node_modules/create-maizzle/node_modules/@clack/prompts/CHANGELOG.md +0 -576
  128. package/node_modules/create-maizzle/node_modules/@clack/prompts/LICENSE +0 -9
  129. package/node_modules/create-maizzle/node_modules/@clack/prompts/README.md +0 -270
  130. package/node_modules/create-maizzle/node_modules/@clack/prompts/dist/index.d.mts +0 -391
  131. package/node_modules/create-maizzle/node_modules/@clack/prompts/dist/index.mjs +0 -137
  132. package/node_modules/create-maizzle/node_modules/@clack/prompts/dist/index.mjs.map +0 -1
  133. package/node_modules/create-maizzle/node_modules/@clack/prompts/package.json +0 -65
  134. package/node_modules/create-maizzle/package.json +0 -47
  135. package/node_modules/create-maizzle/src/index.js +0 -242
  136. package/node_modules/defu/LICENSE +0 -21
  137. package/node_modules/defu/README.md +0 -171
  138. package/node_modules/defu/dist/defu.cjs +0 -77
  139. package/node_modules/defu/dist/defu.d.cts +0 -31
  140. package/node_modules/defu/dist/defu.d.mts +0 -29
  141. package/node_modules/defu/dist/defu.d.ts +0 -31
  142. package/node_modules/defu/dist/defu.mjs +0 -69
  143. package/node_modules/defu/lib/defu.cjs +0 -10
  144. package/node_modules/defu/lib/defu.d.cts +0 -12
  145. package/node_modules/defu/package.json +0 -48
  146. package/node_modules/giget/dist/shared/giget.OCaTp9b-.mjs +0 -468
  147. package/node_modules/node-fetch-native/LICENSE +0 -114
  148. package/node_modules/node-fetch-native/README.md +0 -225
  149. package/node_modules/node-fetch-native/dist/chunks/multipart-parser.cjs +0 -2
  150. package/node_modules/node-fetch-native/dist/chunks/multipart-parser.mjs +0 -2
  151. package/node_modules/node-fetch-native/dist/index.cjs +0 -1
  152. package/node_modules/node-fetch-native/dist/index.mjs +0 -1
  153. package/node_modules/node-fetch-native/dist/native.cjs +0 -1
  154. package/node_modules/node-fetch-native/dist/native.mjs +0 -1
  155. package/node_modules/node-fetch-native/dist/node.cjs +0 -19
  156. package/node_modules/node-fetch-native/dist/node.mjs +0 -19
  157. package/node_modules/node-fetch-native/dist/polyfill.cjs +0 -1
  158. package/node_modules/node-fetch-native/dist/polyfill.mjs +0 -1
  159. package/node_modules/node-fetch-native/dist/proxy-stub.cjs +0 -1
  160. package/node_modules/node-fetch-native/dist/proxy-stub.mjs +0 -1
  161. package/node_modules/node-fetch-native/dist/proxy.cjs +0 -58
  162. package/node_modules/node-fetch-native/dist/shared/node-fetch-native.DfbY2q-x.mjs +0 -1
  163. package/node_modules/node-fetch-native/dist/shared/node-fetch-native.DhEqb06g.cjs +0 -1
  164. package/node_modules/node-fetch-native/index.d.ts +0 -1
  165. package/node_modules/node-fetch-native/lib/empty.cjs +0 -0
  166. package/node_modules/node-fetch-native/lib/empty.mjs +0 -0
  167. package/node_modules/node-fetch-native/lib/index.cjs +0 -11
  168. package/node_modules/node-fetch-native/lib/index.d.cts +0 -10
  169. package/node_modules/node-fetch-native/lib/index.d.mts +0 -10
  170. package/node_modules/node-fetch-native/lib/index.d.ts +0 -10
  171. package/node_modules/node-fetch-native/lib/native.cjs +0 -11
  172. package/node_modules/node-fetch-native/lib/polyfill.d.cts +0 -1
  173. package/node_modules/node-fetch-native/lib/polyfill.d.mts +0 -1
  174. package/node_modules/node-fetch-native/lib/polyfill.d.ts +0 -1
  175. package/node_modules/node-fetch-native/lib/proxy.d.ts +0 -32
  176. package/node_modules/node-fetch-native/node.d.ts +0 -1
  177. package/node_modules/node-fetch-native/package.json +0 -138
  178. package/node_modules/node-fetch-native/polyfill.d.ts +0 -1
  179. package/node_modules/node-fetch-native/proxy.d.ts +0 -1
  180. package/node_modules/nypm/node_modules/citty/LICENSE +0 -21
  181. package/node_modules/nypm/node_modules/citty/README.md +0 -231
  182. package/node_modules/nypm/node_modules/citty/dist/index.d.mts +0 -112
  183. package/node_modules/nypm/node_modules/citty/dist/index.mjs +0 -425
  184. package/node_modules/nypm/node_modules/citty/package.json +0 -42
  185. /package/node_modules/{nypm/node_modules/citty → citty}/dist/THIRD-PARTY-LICENSES.md +0 -0
  186. /package/node_modules/{nypm/node_modules/citty → citty}/dist/_chunks/libs/scule.mjs +0 -0
  187. /package/node_modules/{@maizzle/cli → maizzle}/LICENSE +0 -0
  188. /package/node_modules/{@maizzle/cli → maizzle}/dist/commands/make/component.d.mts +0 -0
  189. /package/node_modules/{@maizzle/cli → maizzle}/dist/commands/make/component.mjs +0 -0
  190. /package/node_modules/{@maizzle/cli → maizzle}/dist/commands/make/config.d.mts +0 -0
  191. /package/node_modules/{@maizzle/cli → maizzle}/dist/commands/make/config.mjs +0 -0
  192. /package/node_modules/{@maizzle/cli → maizzle}/dist/commands/make/layout.d.mts +0 -0
  193. /package/node_modules/{@maizzle/cli → maizzle}/dist/commands/make/layout.mjs +0 -0
  194. /package/node_modules/{@maizzle/cli → maizzle}/dist/commands/make/scaffold.d.mts +0 -0
  195. /package/node_modules/{@maizzle/cli → maizzle}/dist/commands/make/scaffold.mjs +0 -0
  196. /package/node_modules/{@maizzle/cli → maizzle}/dist/commands/make/stubs/component.vue +0 -0
  197. /package/node_modules/{@maizzle/cli → maizzle}/dist/commands/make/stubs/config.ts +0 -0
  198. /package/node_modules/{@maizzle/cli → maizzle}/dist/commands/make/stubs/layout.vue +0 -0
  199. /package/node_modules/{@maizzle/cli → maizzle}/dist/commands/make/stubs/template.vue +0 -0
  200. /package/node_modules/{@maizzle/cli → maizzle}/dist/commands/make/template.d.mts +0 -0
  201. /package/node_modules/{@maizzle/cli → maizzle}/dist/commands/make/template.mjs +0 -0
  202. /package/node_modules/{commander → maizzle/node_modules/commander}/LICENSE +0 -0
  203. /package/node_modules/{commander → maizzle/node_modules/commander}/esm.mjs +0 -0
  204. /package/node_modules/{commander → maizzle/node_modules/commander}/index.js +0 -0
  205. /package/node_modules/{commander → maizzle/node_modules/commander}/lib/error.js +0 -0
  206. /package/node_modules/{commander → maizzle/node_modules/commander}/lib/suggestSimilar.js +0 -0
  207. /package/node_modules/{commander → maizzle/node_modules/commander}/typings/esm.d.mts +0 -0
@@ -1,425 +0,0 @@
1
- import { n as kebabCase, r as snakeCase, t as camelCase } from "./_chunks/libs/scule.mjs";
2
- import { parseArgs as parseArgs$1 } from "node:util";
3
- //#region src/_utils.ts
4
- function toArray(val) {
5
- if (Array.isArray(val)) return val;
6
- return val === void 0 ? [] : [val];
7
- }
8
- function formatLineColumns(lines, linePrefix = "") {
9
- const maxLength = [];
10
- for (const line of lines) for (const [i, element] of line.entries()) maxLength[i] = Math.max(maxLength[i] || 0, element.length);
11
- return lines.map((l) => l.map((c, i) => linePrefix + c[i === 0 ? "padStart" : "padEnd"](maxLength[i])).join(" ")).join("\n");
12
- }
13
- function resolveValue(input) {
14
- return typeof input === "function" ? input() : input;
15
- }
16
- var CLIError = class extends Error {
17
- code;
18
- constructor(message, code) {
19
- super(message);
20
- this.name = "CLIError";
21
- this.code = code;
22
- }
23
- };
24
- //#endregion
25
- //#region src/_parser.ts
26
- function parseRawArgs(args = [], opts = {}) {
27
- const booleans = new Set(opts.boolean || []);
28
- const strings = new Set(opts.string || []);
29
- const aliasMap = opts.alias || {};
30
- const defaults = opts.default || {};
31
- const aliasToMain = /* @__PURE__ */ new Map();
32
- const mainToAliases = /* @__PURE__ */ new Map();
33
- for (const [key, value] of Object.entries(aliasMap)) {
34
- const targets = value;
35
- for (const target of targets) {
36
- aliasToMain.set(key, target);
37
- if (!mainToAliases.has(target)) mainToAliases.set(target, []);
38
- mainToAliases.get(target).push(key);
39
- aliasToMain.set(target, key);
40
- if (!mainToAliases.has(key)) mainToAliases.set(key, []);
41
- mainToAliases.get(key).push(target);
42
- }
43
- }
44
- const options = {};
45
- function getType(name) {
46
- if (booleans.has(name)) return "boolean";
47
- const aliases = mainToAliases.get(name) || [];
48
- for (const alias of aliases) if (booleans.has(alias)) return "boolean";
49
- return "string";
50
- }
51
- function isStringType(name) {
52
- if (strings.has(name)) return true;
53
- const aliases = mainToAliases.get(name) || [];
54
- for (const alias of aliases) if (strings.has(alias)) return true;
55
- return false;
56
- }
57
- const allOptions = new Set([
58
- ...booleans,
59
- ...strings,
60
- ...Object.keys(aliasMap),
61
- ...Object.values(aliasMap).flat(),
62
- ...Object.keys(defaults)
63
- ]);
64
- for (const name of allOptions) if (!options[name]) options[name] = {
65
- type: getType(name),
66
- default: defaults[name]
67
- };
68
- for (const [alias, main] of aliasToMain.entries()) if (alias.length === 1 && options[main] && !options[main].short) options[main].short = alias;
69
- const processedArgs = [];
70
- const negatedFlags = {};
71
- for (let i = 0; i < args.length; i++) {
72
- const arg = args[i];
73
- if (arg === "--") {
74
- processedArgs.push(...args.slice(i));
75
- break;
76
- }
77
- if (arg.startsWith("--no-")) {
78
- const flagName = arg.slice(5);
79
- negatedFlags[flagName] = true;
80
- continue;
81
- }
82
- processedArgs.push(arg);
83
- }
84
- let parsed;
85
- try {
86
- parsed = parseArgs$1({
87
- args: processedArgs,
88
- options: Object.keys(options).length > 0 ? options : void 0,
89
- allowPositionals: true,
90
- strict: false
91
- });
92
- } catch {
93
- parsed = {
94
- values: {},
95
- positionals: processedArgs
96
- };
97
- }
98
- const out = { _: [] };
99
- out._ = parsed.positionals;
100
- for (const [key, value] of Object.entries(parsed.values)) {
101
- let coerced = value;
102
- if (getType(key) === "boolean" && typeof value === "string") coerced = value !== "false";
103
- else if (isStringType(key) && typeof value === "boolean") coerced = "";
104
- out[key] = coerced;
105
- }
106
- for (const [name] of Object.entries(negatedFlags)) {
107
- out[name] = false;
108
- const mainName = aliasToMain.get(name);
109
- if (mainName) out[mainName] = false;
110
- const aliases = mainToAliases.get(name);
111
- if (aliases) for (const alias of aliases) out[alias] = false;
112
- }
113
- for (const [alias, main] of aliasToMain.entries()) {
114
- if (out[alias] !== void 0 && out[main] === void 0) out[main] = out[alias];
115
- if (out[main] !== void 0 && out[alias] === void 0) out[alias] = out[main];
116
- if (out[alias] !== out[main] && defaults[main] === out[main]) out[main] = out[alias];
117
- }
118
- return out;
119
- }
120
- //#endregion
121
- //#region src/_color.ts
122
- const noColor = /* @__PURE__ */ (() => {
123
- const env = globalThis.process?.env ?? {};
124
- return env.NO_COLOR === "1" || env.TERM === "dumb" || env.TEST || env.CI;
125
- })();
126
- const _c = (c, r = 39) => (t) => noColor ? t : `\u001B[${c}m${t}\u001B[${r}m`;
127
- const bold = /* @__PURE__ */ _c(1, 22);
128
- const cyan = /* @__PURE__ */ _c(36);
129
- const gray = /* @__PURE__ */ _c(90);
130
- const underline = /* @__PURE__ */ _c(4, 24);
131
- //#endregion
132
- //#region src/args.ts
133
- function parseArgs(rawArgs, argsDef) {
134
- const parseOptions = {
135
- boolean: [],
136
- string: [],
137
- alias: {},
138
- default: {}
139
- };
140
- const args = resolveArgs(argsDef);
141
- for (const arg of args) {
142
- if (arg.type === "positional") continue;
143
- if (arg.type === "string" || arg.type === "enum") parseOptions.string.push(arg.name);
144
- else if (arg.type === "boolean") parseOptions.boolean.push(arg.name);
145
- if (arg.default !== void 0) parseOptions.default[arg.name] = arg.default;
146
- if (arg.alias) parseOptions.alias[arg.name] = arg.alias;
147
- const camelName = camelCase(arg.name);
148
- const kebabName = kebabCase(arg.name);
149
- if (camelName !== arg.name || kebabName !== arg.name) {
150
- const existingAliases = toArray(parseOptions.alias[arg.name] || []);
151
- if (camelName !== arg.name && !existingAliases.includes(camelName)) existingAliases.push(camelName);
152
- if (kebabName !== arg.name && !existingAliases.includes(kebabName)) existingAliases.push(kebabName);
153
- if (existingAliases.length > 0) parseOptions.alias[arg.name] = existingAliases;
154
- }
155
- }
156
- const parsed = parseRawArgs(rawArgs, parseOptions);
157
- const [ ...positionalArguments] = parsed._;
158
- const parsedArgsProxy = new Proxy(parsed, { get(target, prop) {
159
- return target[prop] ?? target[camelCase(prop)] ?? target[kebabCase(prop)];
160
- } });
161
- for (const [, arg] of args.entries()) if (arg.type === "positional") {
162
- const nextPositionalArgument = positionalArguments.shift();
163
- if (nextPositionalArgument !== void 0) parsedArgsProxy[arg.name] = nextPositionalArgument;
164
- else if (arg.default === void 0 && arg.required !== false) throw new CLIError(`Missing required positional argument: ${arg.name.toUpperCase()}`, "EARG");
165
- else parsedArgsProxy[arg.name] = arg.default;
166
- } else if (arg.type === "enum") {
167
- const argument = parsedArgsProxy[arg.name];
168
- const options = arg.options || [];
169
- if (argument !== void 0 && options.length > 0 && !options.includes(argument)) throw new CLIError(`Invalid value for argument: ${cyan(`--${arg.name}`)} (${cyan(argument)}). Expected one of: ${options.map((o) => cyan(o)).join(", ")}.`, "EARG");
170
- } else if (arg.required && parsedArgsProxy[arg.name] === void 0) throw new CLIError(`Missing required argument: --${arg.name}`, "EARG");
171
- return parsedArgsProxy;
172
- }
173
- function resolveArgs(argsDef) {
174
- const args = [];
175
- for (const [name, argDef] of Object.entries(argsDef || {})) args.push({
176
- ...argDef,
177
- name,
178
- alias: toArray(argDef.alias)
179
- });
180
- return args;
181
- }
182
- //#endregion
183
- //#region src/plugin.ts
184
- function defineCittyPlugin(plugin) {
185
- return plugin;
186
- }
187
- async function resolvePlugins(plugins) {
188
- return Promise.all(plugins.map((p) => resolveValue(p)));
189
- }
190
- //#endregion
191
- //#region src/command.ts
192
- function defineCommand(def) {
193
- return def;
194
- }
195
- async function runCommand(cmd, opts) {
196
- const cmdArgs = await resolveValue(cmd.args || {});
197
- const parsedArgs = parseArgs(opts.rawArgs, cmdArgs);
198
- const context = {
199
- rawArgs: opts.rawArgs,
200
- args: parsedArgs,
201
- data: opts.data,
202
- cmd
203
- };
204
- const plugins = await resolvePlugins(cmd.plugins ?? []);
205
- let result;
206
- let runError;
207
- try {
208
- for (const plugin of plugins) await plugin.setup?.(context);
209
- if (typeof cmd.setup === "function") await cmd.setup(context);
210
- const subCommands = await resolveValue(cmd.subCommands);
211
- if (subCommands && Object.keys(subCommands).length > 0) {
212
- const subCommandArgIndex = findSubCommandIndex(opts.rawArgs, cmdArgs);
213
- const explicitName = opts.rawArgs[subCommandArgIndex];
214
- if (explicitName) {
215
- const subCommand = await _findSubCommand(subCommands, explicitName);
216
- if (!subCommand) throw new CLIError(`Unknown command ${cyan(explicitName)}`, "E_UNKNOWN_COMMAND");
217
- await runCommand(subCommand, { rawArgs: opts.rawArgs.slice(subCommandArgIndex + 1) });
218
- } else {
219
- const defaultSubCommand = await resolveValue(cmd.default);
220
- if (defaultSubCommand) {
221
- if (cmd.run) throw new CLIError(`Cannot specify both 'run' and 'default' on the same command.`, "E_DEFAULT_CONFLICT");
222
- const subCommand = await _findSubCommand(subCommands, defaultSubCommand);
223
- if (!subCommand) throw new CLIError(`Default sub command ${cyan(defaultSubCommand)} not found in subCommands.`, "E_UNKNOWN_COMMAND");
224
- await runCommand(subCommand, { rawArgs: opts.rawArgs });
225
- } else if (!cmd.run) throw new CLIError(`No command specified.`, "E_NO_COMMAND");
226
- }
227
- }
228
- if (typeof cmd.run === "function") result = await cmd.run(context);
229
- } catch (error) {
230
- runError = error;
231
- }
232
- const cleanupErrors = [];
233
- if (typeof cmd.cleanup === "function") try {
234
- await cmd.cleanup(context);
235
- } catch (error) {
236
- cleanupErrors.push(error);
237
- }
238
- for (const plugin of [...plugins].reverse()) try {
239
- await plugin.cleanup?.(context);
240
- } catch (error) {
241
- cleanupErrors.push(error);
242
- }
243
- if (runError) throw runError;
244
- if (cleanupErrors.length === 1) throw cleanupErrors[0];
245
- if (cleanupErrors.length > 1) throw new Error("Multiple cleanup errors", { cause: cleanupErrors });
246
- return { result };
247
- }
248
- async function resolveSubCommand(cmd, rawArgs, parent) {
249
- const subCommands = await resolveValue(cmd.subCommands);
250
- if (subCommands && Object.keys(subCommands).length > 0) {
251
- const subCommandArgIndex = findSubCommandIndex(rawArgs, await resolveValue(cmd.args || {}));
252
- const subCommandName = rawArgs[subCommandArgIndex];
253
- const subCommand = await _findSubCommand(subCommands, subCommandName);
254
- if (subCommand) return resolveSubCommand(subCommand, rawArgs.slice(subCommandArgIndex + 1), cmd);
255
- }
256
- return [cmd, parent];
257
- }
258
- async function _findSubCommand(subCommands, name) {
259
- if (name in subCommands) return resolveValue(subCommands[name]);
260
- for (const sub of Object.values(subCommands)) {
261
- const resolved = await resolveValue(sub);
262
- const meta = await resolveValue(resolved?.meta);
263
- if (meta?.alias) {
264
- if (toArray(meta.alias).includes(name)) return resolved;
265
- }
266
- }
267
- }
268
- function findSubCommandIndex(rawArgs, argsDef) {
269
- for (let i = 0; i < rawArgs.length; i++) {
270
- const arg = rawArgs[i];
271
- if (arg === "--") return -1;
272
- if (arg.startsWith("-")) {
273
- if (!arg.includes("=") && _isValueFlag(arg, argsDef)) i++;
274
- continue;
275
- }
276
- return i;
277
- }
278
- return -1;
279
- }
280
- function _isValueFlag(flag, argsDef) {
281
- const name = flag.replace(/^-{1,2}/, "");
282
- const normalized = camelCase(name);
283
- for (const [key, def] of Object.entries(argsDef)) {
284
- if (def.type !== "string" && def.type !== "enum") continue;
285
- if (normalized === camelCase(key)) return true;
286
- if ((Array.isArray(def.alias) ? def.alias : def.alias ? [def.alias] : []).includes(name)) return true;
287
- }
288
- return false;
289
- }
290
- //#endregion
291
- //#region src/usage.ts
292
- async function showUsage(cmd, parent) {
293
- try {
294
- console.log(await renderUsage(cmd, parent) + "\n");
295
- } catch (error) {
296
- console.error(error);
297
- }
298
- }
299
- const negativePrefixRe = /^no[-A-Z]/;
300
- async function renderUsage(cmd, parent) {
301
- const cmdMeta = await resolveValue(cmd.meta || {});
302
- const cmdArgs = resolveArgs(await resolveValue(cmd.args || {}));
303
- const parentMeta = await resolveValue(parent?.meta || {});
304
- const commandName = `${parentMeta.name ? `${parentMeta.name} ` : ""}` + (cmdMeta.name || process.argv[1]);
305
- const argLines = [];
306
- const posLines = [];
307
- const commandsLines = [];
308
- const usageLine = [];
309
- for (const arg of cmdArgs) if (arg.type === "positional") {
310
- const name = arg.name.toUpperCase();
311
- const isRequired = arg.required !== false && arg.default === void 0;
312
- posLines.push([cyan(name + renderValueHint(arg)), renderDescription(arg, isRequired)]);
313
- usageLine.push(isRequired ? `<${name}>` : `[${name}]`);
314
- } else {
315
- const isRequired = arg.required === true && arg.default === void 0;
316
- const argStr = [...(arg.alias || []).map((a) => `-${a}`), `--${arg.name}`].join(", ") + renderValueHint(arg);
317
- argLines.push([cyan(argStr), renderDescription(arg, isRequired)]);
318
- /**
319
- * print negative boolean arg variant usage when
320
- * - enabled by default or has `negativeDescription`
321
- * - not prefixed with `no-` or `no[A-Z]`
322
- */
323
- if (arg.type === "boolean" && (arg.default === true || arg.negativeDescription) && !negativePrefixRe.test(arg.name)) {
324
- const negativeArgStr = [...(arg.alias || []).map((a) => `--no-${a}`), `--no-${arg.name}`].join(", ");
325
- argLines.push([cyan(negativeArgStr), [arg.negativeDescription, isRequired ? gray("(Required)") : ""].filter(Boolean).join(" ")]);
326
- }
327
- if (isRequired) usageLine.push(`--${arg.name}` + renderValueHint(arg));
328
- }
329
- if (cmd.subCommands) {
330
- const commandNames = [];
331
- const subCommands = await resolveValue(cmd.subCommands);
332
- for (const [name, sub] of Object.entries(subCommands)) {
333
- const meta = await resolveValue((await resolveValue(sub))?.meta);
334
- if (meta?.hidden) continue;
335
- const aliases = toArray(meta?.alias);
336
- const label = [name, ...aliases].join(", ");
337
- commandsLines.push([cyan(label), meta?.description || ""]);
338
- commandNames.push(name, ...aliases);
339
- }
340
- usageLine.push(commandNames.join("|"));
341
- }
342
- const usageLines = [];
343
- const version = cmdMeta.version || parentMeta.version;
344
- usageLines.push(gray(`${cmdMeta.description} (${commandName + (version ? ` v${version}` : "")})`), "");
345
- const hasOptions = argLines.length > 0 || posLines.length > 0;
346
- usageLines.push(`${underline(bold("USAGE"))} ${cyan(`${commandName}${hasOptions ? " [OPTIONS]" : ""} ${usageLine.join(" ")}`)}`, "");
347
- if (posLines.length > 0) {
348
- usageLines.push(underline(bold("ARGUMENTS")), "");
349
- usageLines.push(formatLineColumns(posLines, " "));
350
- usageLines.push("");
351
- }
352
- if (argLines.length > 0) {
353
- usageLines.push(underline(bold("OPTIONS")), "");
354
- usageLines.push(formatLineColumns(argLines, " "));
355
- usageLines.push("");
356
- }
357
- if (commandsLines.length > 0) {
358
- usageLines.push(underline(bold("COMMANDS")), "");
359
- usageLines.push(formatLineColumns(commandsLines, " "));
360
- usageLines.push("", `Use ${cyan(`${commandName} <command> --help`)} for more information about a command.`);
361
- }
362
- return usageLines.filter((l) => typeof l === "string").join("\n");
363
- }
364
- function renderValueHint(arg) {
365
- const valueHint = arg.valueHint ? `=<${arg.valueHint}>` : "";
366
- const fallbackValueHint = valueHint || `=<${snakeCase(arg.name)}>`;
367
- if (!arg.type || arg.type === "positional" || arg.type === "boolean") return valueHint;
368
- if (arg.type === "enum" && arg.options?.length) return `=<${arg.options.join("|")}>`;
369
- return fallbackValueHint;
370
- }
371
- function renderDescription(arg, required) {
372
- const requiredHint = required ? gray("(Required)") : "";
373
- const defaultHint = arg.default === void 0 ? "" : gray(`(Default: ${arg.default})`);
374
- return [
375
- arg.description,
376
- requiredHint,
377
- defaultHint
378
- ].filter(Boolean).join(" ");
379
- }
380
- //#endregion
381
- //#region src/main.ts
382
- async function runMain(cmd, opts = {}) {
383
- const rawArgs = opts.rawArgs || process.argv.slice(2);
384
- const showUsage$1 = opts.showUsage || showUsage;
385
- try {
386
- const builtinFlags = await _resolveBuiltinFlags(cmd);
387
- if (builtinFlags.help.length > 0 && rawArgs.some((arg) => builtinFlags.help.includes(arg))) {
388
- await showUsage$1(...await resolveSubCommand(cmd, rawArgs));
389
- process.exit(0);
390
- } else if (rawArgs.length === 1 && builtinFlags.version.includes(rawArgs[0])) {
391
- const meta = typeof cmd.meta === "function" ? await cmd.meta() : await cmd.meta;
392
- if (!meta?.version) throw new CLIError("No version specified", "E_NO_VERSION");
393
- console.log(meta.version);
394
- } else await runCommand(cmd, { rawArgs });
395
- } catch (error) {
396
- if (error instanceof CLIError) {
397
- await showUsage$1(...await resolveSubCommand(cmd, rawArgs));
398
- console.error(error.message);
399
- } else console.error(error, "\n");
400
- process.exit(1);
401
- }
402
- }
403
- function createMain(cmd) {
404
- return (opts = {}) => runMain(cmd, opts);
405
- }
406
- async function _resolveBuiltinFlags(cmd) {
407
- const argsDef = await resolveValue(cmd.args || {});
408
- const userNames = /* @__PURE__ */ new Set();
409
- const userAliases = /* @__PURE__ */ new Set();
410
- for (const [name, def] of Object.entries(argsDef)) {
411
- userNames.add(name);
412
- for (const alias of toArray(def.alias)) userAliases.add(alias);
413
- }
414
- return {
415
- help: _getBuiltinFlags("help", "h", userNames, userAliases),
416
- version: _getBuiltinFlags("version", "v", userNames, userAliases)
417
- };
418
- }
419
- function _getBuiltinFlags(long, short, userNames, userAliases) {
420
- if (userNames.has(long) || userAliases.has(long)) return [];
421
- if (userNames.has(short) || userAliases.has(short)) return [`--${long}`];
422
- return [`--${long}`, `-${short}`];
423
- }
424
- //#endregion
425
- export { createMain, defineCittyPlugin, defineCommand, parseArgs, renderUsage, runCommand, runMain, showUsage };
@@ -1,42 +0,0 @@
1
- {
2
- "name": "citty",
3
- "version": "0.2.2",
4
- "description": "Elegant CLI Builder",
5
- "license": "MIT",
6
- "repository": "unjs/citty",
7
- "files": [
8
- "dist"
9
- ],
10
- "type": "module",
11
- "sideEffects": false,
12
- "types": "./dist/index.d.mts",
13
- "exports": {
14
- ".": "./dist/index.mjs"
15
- },
16
- "scripts": {
17
- "build": "obuild",
18
- "dev": "vitest dev",
19
- "lint": "oxlint . && oxfmt --check",
20
- "fmt": "oxlint . --fix && oxfmt",
21
- "prepack": "pnpm run build",
22
- "play": "node ./playground/cli.ts",
23
- "release": "pnpm test && pnpm build && changelogen --release --push && npm publish",
24
- "test": "pnpm lint && pnpm test:types && vitest run --coverage",
25
- "test:types": "tsgo --noEmit"
26
- },
27
- "devDependencies": {
28
- "@types/node": "^25.5.0",
29
- "@typescript/native-preview": "^7.0.0-dev.20260401.1",
30
- "@vitest/coverage-v8": "^4.1.2",
31
- "automd": "^0.4.3",
32
- "changelogen": "^0.6.2",
33
- "eslint-config-unjs": "^0.6.2",
34
- "obuild": "^0.4.32",
35
- "oxfmt": "^0.43.0",
36
- "oxlint": "^1.58.0",
37
- "scule": "^1.3.0",
38
- "typescript": "^6.0.2",
39
- "vitest": "^4.1.2"
40
- },
41
- "packageManager": "pnpm@10.33.0"
42
- }
File without changes