zard-cli 1.0.0-beta.114 → 1.0.0-beta.116

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 (202) hide show
  1. package/commands/add/component-installer.js +3 -3
  2. package/commands/add/component-installer.js.map +1 -1
  3. package/commands/add/component-selector.d.ts +3 -3
  4. package/commands/add/component-selector.js +3 -3
  5. package/commands/add/dependency-resolver.js +10 -7
  6. package/commands/add/dependency-resolver.js.map +1 -1
  7. package/commands/add/index.d.ts.map +1 -1
  8. package/commands/add/index.js +12 -20
  9. package/commands/add/index.js.map +1 -1
  10. package/commands/add/wizard.d.ts +8 -7
  11. package/commands/add/wizard.d.ts.map +1 -1
  12. package/commands/add/wizard.js +2 -2
  13. package/commands/add/wizard.js.map +1 -1
  14. package/commands/init/config-prompter.d.ts +18 -13
  15. package/commands/init/config-prompter.d.ts.map +1 -1
  16. package/commands/init/config-prompter.js +25 -19
  17. package/commands/init/config-prompter.js.map +1 -1
  18. package/commands/init/dependencies.d.ts.map +1 -1
  19. package/commands/init/dependencies.js +21 -24
  20. package/commands/init/dependencies.js.map +1 -1
  21. package/commands/init/index.js +20 -20
  22. package/commands/init/index.js.map +1 -1
  23. package/commands/init/project-kind.d.ts +39 -39
  24. package/commands/init/project-kind.d.ts.map +1 -1
  25. package/commands/init/project-kind.js +44 -44
  26. package/commands/init/project-kind.js.map +1 -1
  27. package/commands/init/steps.d.ts +3 -4
  28. package/commands/init/steps.d.ts.map +1 -1
  29. package/commands/init/steps.js +25 -24
  30. package/commands/init/steps.js.map +1 -1
  31. package/commands/init/tailwind-setup.d.ts +5 -5
  32. package/commands/init/tailwind-setup.js +14 -14
  33. package/commands/init/tailwind-setup.js.map +1 -1
  34. package/commands/init/tsconfig-updater.d.ts +4 -4
  35. package/commands/init/tsconfig-updater.js +12 -12
  36. package/commands/init/tsconfig-updater.js.map +1 -1
  37. package/commands/init/update-angular-config.js +4 -4
  38. package/commands/init/vite-setup.d.ts +5 -4
  39. package/commands/init/vite-setup.d.ts.map +1 -1
  40. package/commands/init/vite-setup.js +11 -10
  41. package/commands/init/vite-setup.js.map +1 -1
  42. package/commands/init/wizard.d.ts +5 -5
  43. package/commands/init/wizard.d.ts.map +1 -1
  44. package/commands/init/wizard.js +29 -29
  45. package/commands/init/wizard.js.map +1 -1
  46. package/core/icons/families.d.ts +20 -20
  47. package/core/icons/families.d.ts.map +1 -1
  48. package/core/icons/families.js +11 -11
  49. package/core/icons/families.js.map +1 -1
  50. package/core/icons/icon-map.d.ts.map +1 -1
  51. package/core/icons/icon-map.js +9 -4
  52. package/core/icons/icon-map.js.map +1 -1
  53. package/core/icons/index.d.ts +50 -50
  54. package/core/icons/index.d.ts.map +1 -1
  55. package/core/icons/index.js +45 -45
  56. package/core/icons/index.js.map +1 -1
  57. package/core/registry/registry-data.d.ts.map +1 -1
  58. package/core/registry/registry-data.js +103 -14
  59. package/core/registry/registry-data.js.map +1 -1
  60. package/core/themes/theme-definitions.d.ts.map +1 -1
  61. package/core/themes/theme-definitions.js +10 -0
  62. package/core/themes/theme-definitions.js.map +1 -1
  63. package/index.js +3 -2
  64. package/index.js.map +1 -1
  65. package/package.json +6 -8
  66. package/ui/blocks.d.ts +29 -28
  67. package/ui/blocks.d.ts.map +1 -1
  68. package/ui/blocks.js +27 -27
  69. package/ui/blocks.js.map +1 -1
  70. package/ui/brand.d.ts +5 -5
  71. package/ui/brand.d.ts.map +1 -1
  72. package/ui/brand.js +6 -6
  73. package/ui/brand.js.map +1 -1
  74. package/ui/engine/animation/index.d.ts +2 -3
  75. package/ui/engine/animation/index.d.ts.map +1 -1
  76. package/ui/engine/animation/index.js +2 -3
  77. package/ui/engine/animation/index.js.map +1 -1
  78. package/ui/engine/ansi/index.d.ts +10 -11
  79. package/ui/engine/ansi/index.d.ts.map +1 -1
  80. package/ui/engine/ansi/index.js +6 -7
  81. package/ui/engine/ansi/index.js.map +1 -1
  82. package/ui/engine/components/index.d.ts +3 -3
  83. package/ui/engine/components/index.js +4 -4
  84. package/ui/engine/cursor/index.d.ts +3 -4
  85. package/ui/engine/cursor/index.d.ts.map +1 -1
  86. package/ui/engine/cursor/index.js +2 -3
  87. package/ui/engine/cursor/index.js.map +1 -1
  88. package/ui/engine/diff/index.d.ts +2 -3
  89. package/ui/engine/diff/index.d.ts.map +1 -1
  90. package/ui/engine/diff/index.js +5 -6
  91. package/ui/engine/diff/index.js.map +1 -1
  92. package/ui/engine/events/index.d.ts +2 -2
  93. package/ui/engine/events/index.js +3 -3
  94. package/ui/engine/events/index.js.map +1 -1
  95. package/ui/engine/focus/index.d.ts +2 -2
  96. package/ui/engine/focus/index.js +2 -2
  97. package/ui/engine/frame/index.d.ts +4 -4
  98. package/ui/engine/frame/index.js +0 -0
  99. package/ui/engine/index.d.ts +7 -7
  100. package/ui/engine/index.js +7 -7
  101. package/ui/engine/input/index.d.ts +2 -2
  102. package/ui/engine/input/index.js +11 -11
  103. package/ui/engine/input/index.js.map +1 -1
  104. package/ui/engine/layout/index.d.ts +3 -3
  105. package/ui/engine/layout/index.js +7 -7
  106. package/ui/engine/layout/index.js.map +1 -1
  107. package/ui/engine/renderer/index.d.ts +4 -4
  108. package/ui/engine/renderer/index.d.ts.map +1 -1
  109. package/ui/engine/renderer/index.js +3 -3
  110. package/ui/engine/scheduler/index.d.ts +3 -3
  111. package/ui/engine/scheduler/index.js +5 -5
  112. package/ui/engine/scheduler/index.js.map +1 -1
  113. package/ui/engine/screen/index.d.ts +5 -5
  114. package/ui/engine/screen/index.d.ts.map +1 -1
  115. package/ui/engine/screen/index.js +7 -7
  116. package/ui/engine/screen/index.js.map +1 -1
  117. package/ui/engine/terminal/index.d.ts +29 -29
  118. package/ui/engine/terminal/index.d.ts.map +1 -1
  119. package/ui/engine/terminal/index.js +47 -47
  120. package/ui/engine/terminal/index.js.map +1 -1
  121. package/ui/engine/testing/index.d.ts +4 -4
  122. package/ui/engine/testing/index.d.ts.map +1 -1
  123. package/ui/engine/testing/index.js +2 -2
  124. package/ui/engine/theme/index.d.ts +2 -3
  125. package/ui/engine/theme/index.d.ts.map +1 -1
  126. package/ui/engine/theme/index.js +3 -4
  127. package/ui/engine/theme/index.js.map +1 -1
  128. package/ui/engine/utils/index.d.ts +2 -2
  129. package/ui/engine/utils/index.js +4 -4
  130. package/ui/engine/utils/index.js.map +1 -1
  131. package/ui/gate.d.ts +7 -7
  132. package/ui/gate.d.ts.map +1 -1
  133. package/ui/gate.js +5 -5
  134. package/ui/index.d.ts +3 -3
  135. package/ui/index.js +3 -3
  136. package/ui/log-sink.d.ts +9 -9
  137. package/ui/log-sink.d.ts.map +1 -1
  138. package/ui/log-sink.js +9 -9
  139. package/ui/log-sink.js.map +1 -1
  140. package/ui/output.d.ts +6 -6
  141. package/ui/output.d.ts.map +1 -1
  142. package/ui/output.js +6 -6
  143. package/ui/output.js.map +1 -1
  144. package/ui/report.d.ts +8 -8
  145. package/ui/report.d.ts.map +1 -1
  146. package/ui/report.js +7 -7
  147. package/ui/report.js.map +1 -1
  148. package/ui/runner.d.ts +25 -25
  149. package/ui/runner.d.ts.map +1 -1
  150. package/ui/runner.js +27 -27
  151. package/ui/runner.js.map +1 -1
  152. package/ui/style.d.ts +7 -7
  153. package/ui/style.d.ts.map +1 -1
  154. package/ui/style.js +8 -8
  155. package/ui/style.js.map +1 -1
  156. package/ui/testing/fake-tty.d.ts +4 -4
  157. package/ui/testing/fake-tty.js +4 -4
  158. package/ui/text-input.d.ts +14 -13
  159. package/ui/text-input.d.ts.map +1 -1
  160. package/ui/text-input.js +15 -13
  161. package/ui/text-input.js.map +1 -1
  162. package/ui/theme.d.ts +4 -4
  163. package/ui/theme.js +4 -4
  164. package/utils/angular-compat.d.ts +21 -0
  165. package/utils/angular-compat.d.ts.map +1 -0
  166. package/utils/angular-compat.js +52 -0
  167. package/utils/angular-compat.js.map +1 -0
  168. package/utils/config.d.ts +6 -6
  169. package/utils/config.d.ts.map +1 -1
  170. package/utils/config.js +20 -20
  171. package/utils/config.js.map +1 -1
  172. package/utils/errors.d.ts +5 -5
  173. package/utils/errors.js +5 -5
  174. package/utils/get-project-info.d.ts +6 -6
  175. package/utils/get-project-info.d.ts.map +1 -1
  176. package/utils/get-project-info.js +35 -35
  177. package/utils/get-project-info.js.map +1 -1
  178. package/utils/http-client.d.ts.map +1 -1
  179. package/utils/http-client.js +18 -3
  180. package/utils/http-client.js.map +1 -1
  181. package/utils/icon-catalog.d.ts +16 -15
  182. package/utils/icon-catalog.d.ts.map +1 -1
  183. package/utils/icon-catalog.js +21 -20
  184. package/utils/icon-catalog.js.map +1 -1
  185. package/utils/logger.d.ts +3 -3
  186. package/utils/logger.js +9 -9
  187. package/utils/logger.js.map +1 -1
  188. package/utils/package-manager.d.ts +25 -25
  189. package/utils/package-manager.js +48 -48
  190. package/utils/package-manager.js.map +1 -1
  191. package/utils/registry.d.ts +14 -14
  192. package/utils/registry.d.ts.map +1 -1
  193. package/utils/registry.js +23 -19
  194. package/utils/registry.js.map +1 -1
  195. package/utils/schema-version.d.ts +11 -10
  196. package/utils/schema-version.d.ts.map +1 -1
  197. package/utils/schema-version.js +11 -10
  198. package/utils/schema-version.js.map +1 -1
  199. package/utils/source-file.d.ts +21 -21
  200. package/utils/source-file.d.ts.map +1 -1
  201. package/utils/source-file.js +24 -24
  202. package/utils/source-file.js.map +1 -1
package/ui/runner.js CHANGED
@@ -1,31 +1,31 @@
1
1
  /**
2
- * Runner — a ponte entre o loop de frames da engine e o fluxo async da CLI.
2
+ * Runner — the bridge between the engine's frame loop and the CLI's async flow.
3
3
  *
4
- * Os comandos são sequenciais (`const config = await promptForConfig(...)`),
5
- * enquanto a engine é um laço de render dirigido por eventos. O runner concilia
6
- * os dois: monta a tela, entrega o controle ao `onKey`/`run` e resolve uma
7
- * Promise quando o fluxo chama `done()`.
4
+ * Commands are sequential (`const config = await promptForConfig(...)`), while
5
+ * the engine is an event-driven render loop. The runner reconciles the two: it
6
+ * mounts the screen, hands control to `onKey`/`run`, and resolves a Promise when
7
+ * the flow calls `done()`.
8
8
  *
9
- * Três invariantes valem para qualquer wizard:
10
- * 1. o terminal é restaurado em todos os caminhos de saída — inclusive erro,
11
- * SIGINT e crash do processo;
12
- * 2. sem TTY a tela nunca é montada: quem chamou recebe NonInteractiveError e
13
- * segue pelo caminho headless;
14
- * 3. o que o logger escreveria durante a montagem fica retido no sink e é
15
- * reemitido depois, para não rasgar o frame.
9
+ * Three invariants hold for every wizard:
10
+ * 1. the terminal is restored on every exit path — errors, SIGINT and a
11
+ * process crash included;
12
+ * 2. with no TTY the screen is never mounted: the caller gets a
13
+ * NonInteractiveError and follows the headless path;
14
+ * 3. whatever the logger would write during the mount is held in the sink and
15
+ * re-emitted afterwards, so the frame is not torn.
16
16
  */
17
17
  import { createScreen, createTerminal, resolveTerminalStreams, } from './engine/index.js';
18
18
  import { beginCapture, endCapture } from './log-sink.js';
19
19
  import { flushRecords } from './output.js';
20
20
  import { zardTheme } from './theme.js';
21
- /** Sinaliza que o comando precisa seguir sem UI interativa (CI, pipe, --yes). */
21
+ /** Signals that the command has to carry on without an interactive UI (CI, pipe, --yes). */
22
22
  export class NonInteractiveError extends Error {
23
23
  constructor(message = 'This terminal is not interactive.') {
24
24
  super(message);
25
25
  this.name = 'NonInteractiveError';
26
26
  }
27
27
  }
28
- /** O usuário abandonou o wizard (Ctrl+C ou um passo que cancela o fluxo). */
28
+ /** The user abandoned the wizard (Ctrl+C, or a step that cancels the flow). */
29
29
  export class WizardCancelledError extends Error {
30
30
  constructor(message = 'Operation cancelled.') {
31
31
  super(message);
@@ -33,12 +33,12 @@ export class WizardCancelledError extends Error {
33
33
  }
34
34
  }
35
35
  /**
36
- * true quando existe um terminal onde montar a tela.
36
+ * True when there is a terminal to mount the screen on.
37
37
  *
38
- * Não basta olhar `process.stdout.isTTY && process.stdin.isTTY`: era isso que
39
- * fazia `npx zard-cli init` sair em modo texto no macOS e no Linux, onde o npm
40
- * executa o binário por um shell e entrega o stdin como pipe. O terminal de
41
- * controle continua alcançável, e é ele que decide.
38
+ * Looking at `process.stdout.isTTY && process.stdin.isTTY` is not enough: that
39
+ * is what made `npx zard-cli init` fall back to text mode on macOS and Linux,
40
+ * where npm runs the binary through a shell and hands over stdin as a pipe. The
41
+ * controlling terminal is still reachable, and it is what decides.
42
42
  */
43
43
  export function isInteractive(resolve = resolveTerminalStreams) {
44
44
  const streams = resolve();
@@ -55,8 +55,8 @@ export async function runWizard(options) {
55
55
  theme: zardTheme,
56
56
  fps: options.fps ?? 30,
57
57
  terminal: createTerminal({ stdin: streams.input, stdout: streams.output }),
58
- // O teardown é nosso: interceptamos Ctrl+C para encerrar o wizard com uma
59
- // mensagem, em vez de matar o processo direto de dentro da engine.
58
+ // Teardown is ours: we intercept Ctrl+C to end the wizard with a message,
59
+ // instead of killing the process from inside the engine.
60
60
  handleExitSignals: false,
61
61
  });
62
62
  let settled = false;
@@ -66,15 +66,15 @@ export async function runWizard(options) {
66
66
  return;
67
67
  teardownDone = true;
68
68
  screen.unmount();
69
- // Depois do unmount: é ele que devolve o terminal ao estado normal, e
70
- // fechar os streams antes deixaria o alt-screen e o raw mode ligados.
69
+ // After the unmount: that is what returns the terminal to its normal state,
70
+ // and closing the streams first would leave the alt-screen and raw mode on.
71
71
  streams.close();
72
72
  process.off('exit', teardown);
73
73
  process.off('SIGINT', onSignal);
74
74
  process.off('SIGTERM', onSignal);
75
75
  };
76
- // Rede de segurança: se o processo morrer com a tela montada, o terminal
77
- // ainda volta ao normal (cursor visível, sem raw mode, fora do alt-screen).
76
+ // Safety net: if the process dies with the screen mounted, the terminal still
77
+ // returns to normal (cursor visible, no raw mode, out of the alt-screen).
78
78
  function onSignal() {
79
79
  teardown();
80
80
  process.exit(130);
@@ -123,8 +123,8 @@ export async function runWizard(options) {
123
123
  return { value, logs: endCapture() };
124
124
  }
125
125
  catch (error) {
126
- // Última chance de mostrar o que foi retido: a tela já caiu e quem trata o
127
- // erro acima só verá a mensagem da exceção.
126
+ // Last chance to show what was held: the screen is already down and whoever
127
+ // handles the error above will only see the exception's message.
128
128
  flushRecords(endCapture());
129
129
  throw error;
130
130
  }
package/ui/runner.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/ui/runner.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/ui/runner.ts"],"names":[],"mappings":"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"}
package/ui/style.d.ts CHANGED
@@ -1,11 +1,11 @@
1
1
  /**
2
- * Estilo para saída em linha — o que a CLI escreve fora da tela interativa.
2
+ * Styling for line output — what the CLI writes outside the interactive screen.
3
3
  *
4
- * Substitui o chalk usando o vocabulário ANSI da própria engine, o que mantém
5
- * uma única fonte de verdade de cor: os mesmos tokens do tema valem para o
6
- * wizard em alt-screen e para o texto que sobra no histórico do terminal.
4
+ * Replaces chalk using the engine's own ANSI vocabulary, which keeps a single
5
+ * source of truth for colour: the same theme tokens apply to the wizard in the
6
+ * alt-screen and to the text left behind in the terminal's history.
7
7
  */
8
- /** Reavalia a capacidade de cor — usado em teste, quando o stdout é trocado. */
8
+ /** Re-evaluates the colour capability — used in tests, when stdout is swapped. */
9
9
  export declare function resetColorLevel(): void;
10
10
  export declare const style: {
11
11
  primary: (text: string) => string;
@@ -16,9 +16,9 @@ export declare const style: {
16
16
  foreground: (text: string) => string;
17
17
  bold: (text: string) => string;
18
18
  dim: (text: string) => string;
19
- /** Destaque de nome de arquivo, comando ou caminho dentro de uma frase. */
19
+ /** Highlights a file name, command or path inside a sentence. */
20
20
  code: (text: string) => string;
21
21
  };
22
- /** true quando o terminal aceita as caixas e glifos Unicode da UI. */
22
+ /** True when the terminal accepts the UI's Unicode boxes and glyphs. */
23
23
  export declare function supportsUnicode(): boolean;
24
24
  //# sourceMappingURL=style.d.ts.map
package/ui/style.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../src/ui/style.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,gFAAgF;AAChF,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAWD,eAAO,MAAM,KAAK;oBACA,MAAM;oBACN,MAAM;oBACN,MAAM;mBACP,MAAM;kBACP,MAAM;uBACD,MAAM;iBACZ,MAAM;gBACP,MAAM;IAClB,2EAA2E;iBAC9D,MAAM;CACpB,CAAC;AAEF,sEAAsE;AACtE,wBAAgB,eAAe,IAAI,OAAO,CAEzC"}
1
+ {"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../src/ui/style.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,kFAAkF;AAClF,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAWD,eAAO,MAAM,KAAK;oBACA,MAAM;oBACN,MAAM;oBACN,MAAM;mBACP,MAAM;kBACP,MAAM;uBACD,MAAM;iBACZ,MAAM;gBACP,MAAM;IAClB,iEAAiE;iBACpD,MAAM;CACpB,CAAC;AAEF,wEAAwE;AACxE,wBAAgB,eAAe,IAAI,OAAO,CAEzC"}
package/ui/style.js CHANGED
@@ -1,19 +1,19 @@
1
1
  /**
2
- * Estilo para saída em linha — o que a CLI escreve fora da tela interativa.
2
+ * Styling for line output — what the CLI writes outside the interactive screen.
3
3
  *
4
- * Substitui o chalk usando o vocabulário ANSI da própria engine, o que mantém
5
- * uma única fonte de verdade de cor: os mesmos tokens do tema valem para o
6
- * wizard em alt-screen e para o texto que sobra no histórico do terminal.
4
+ * Replaces chalk using the engine's own ANSI vocabulary, which keeps a single
5
+ * source of truth for colour: the same theme tokens apply to the wizard in the
6
+ * alt-screen and to the text left behind in the terminal's history.
7
7
  */
8
8
  import { Attr, createSgrBuilder, createTerminal } from './engine/index.js';
9
9
  import { zardTheme } from './theme.js';
10
10
  let cachedLevel = null;
11
- /** Nível de cor do terminal atual, resolvido uma única vez por processo. */
11
+ /** The current terminal's colour depth, resolved once per process. */
12
12
  function colorLevel() {
13
13
  cachedLevel ??= createTerminal().caps.colors;
14
14
  return cachedLevel;
15
15
  }
16
- /** Reavalia a capacidade de cor — usado em teste, quando o stdout é trocado. */
16
+ /** Re-evaluates the colour capability — used in tests, when stdout is swapped. */
17
17
  export function resetColorLevel() {
18
18
  cachedLevel = null;
19
19
  }
@@ -34,10 +34,10 @@ export const style = {
34
34
  foreground: (text) => paint(text, 'foreground'),
35
35
  bold: (text) => paint(text, undefined, Attr.Bold),
36
36
  dim: (text) => paint(text, undefined, Attr.Dim),
37
- /** Destaque de nome de arquivo, comando ou caminho dentro de uma frase. */
37
+ /** Highlights a file name, command or path inside a sentence. */
38
38
  code: (text) => paint(text, 'primary', Attr.Bold),
39
39
  };
40
- /** true quando o terminal aceita as caixas e glifos Unicode da UI. */
40
+ /** True when the terminal accepts the UI's Unicode boxes and glyphs. */
41
41
  export function supportsUnicode() {
42
42
  return createTerminal().caps.unicode;
43
43
  }
package/ui/style.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"style.js","sourceRoot":"","sources":["../../src/ui/style.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,cAAc,EAAmB,MAAM,mBAAmB,CAAC;AAC5F,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,IAAI,WAAW,GAAsB,IAAI,CAAC;AAE1C,4EAA4E;AAC5E,SAAS,UAAU;IACjB,WAAW,KAAK,cAAc,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC;IAC7C,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,eAAe;IAC7B,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC;AAED,SAAS,KAAK,CAAC,IAAY,EAAE,KAAyB,EAAE,QAAc,IAAI,CAAC,IAAI;IAC7E,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,IAAI,KAAK,KAAK,MAAM,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAElF,MAAM,GAAG,GAAG,gBAAgB,EAAE,CAAC;IAC/B,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC3C,OAAO,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,KAAK,CAAC,GAAG,IAAI,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC;AAC7E,CAAC;AAED,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC;IACjD,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC;IACjD,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC;IACjD,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC;IAC/C,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC;IAC7C,UAAU,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC;IACvD,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC;IACzD,GAAG,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC;IACvD,2EAA2E;IAC3E,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC;CAC1D,CAAC;AAEF,sEAAsE;AACtE,MAAM,UAAU,eAAe;IAC7B,OAAO,cAAc,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC;AACvC,CAAC"}
1
+ {"version":3,"file":"style.js","sourceRoot":"","sources":["../../src/ui/style.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,cAAc,EAAmB,MAAM,mBAAmB,CAAC;AAC5F,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,IAAI,WAAW,GAAsB,IAAI,CAAC;AAE1C,sEAAsE;AACtE,SAAS,UAAU;IACjB,WAAW,KAAK,cAAc,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC;IAC7C,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,eAAe;IAC7B,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC;AAED,SAAS,KAAK,CAAC,IAAY,EAAE,KAAyB,EAAE,QAAc,IAAI,CAAC,IAAI;IAC7E,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,IAAI,KAAK,KAAK,MAAM,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAElF,MAAM,GAAG,GAAG,gBAAgB,EAAE,CAAC;IAC/B,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC3C,OAAO,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,KAAK,CAAC,GAAG,IAAI,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC;AAC7E,CAAC;AAED,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC;IACjD,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC;IACjD,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC;IACjD,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC;IAC/C,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC;IAC7C,UAAU,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC;IACvD,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC;IACzD,GAAG,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC;IACvD,iEAAiE;IACjE,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC;CAC1D,CAAC;AAEF,wEAAwE;AACxE,MAAM,UAAU,eAAe;IAC7B,OAAO,cAAc,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC;AACvC,CAAC"}
@@ -1,9 +1,9 @@
1
1
  /**
2
- * Um TTY simulado para exercitar wizards sem um terminal real.
2
+ * A simulated TTY, to exercise wizards without a real terminal.
3
3
  *
4
- * `runWizard` se recusa a montar fora de um TTY — é o que protege o usuário de
5
- * uma UI de tela cheia num pipe. Para testar o wizard em si, então, stdout vira
6
- * um buffer e stdin um emissor onde injetamos bytes de teclado.
4
+ * `runWizard` refuses to mount outside a TTY — that is what protects the user
5
+ * from a full-screen UI inside a pipe. To test the wizard itself, then, stdout
6
+ * becomes a buffer and stdin an emitter we inject keyboard bytes into.
7
7
  */
8
8
  export interface FakeTty {
9
9
  /** Tudo o que foi escrito, concatenado. */
@@ -1,9 +1,9 @@
1
1
  /**
2
- * Um TTY simulado para exercitar wizards sem um terminal real.
2
+ * A simulated TTY, to exercise wizards without a real terminal.
3
3
  *
4
- * `runWizard` se recusa a montar fora de um TTY — é o que protege o usuário de
5
- * uma UI de tela cheia num pipe. Para testar o wizard em si, então, stdout vira
6
- * um buffer e stdin um emissor onde injetamos bytes de teclado.
4
+ * `runWizard` refuses to mount outside a TTY — that is what protects the user
5
+ * from a full-screen UI inside a pipe. To test the wizard itself, then, stdout
6
+ * becomes a buffer and stdin an emitter we inject keyboard bytes into.
7
7
  */
8
8
  import { EventEmitter } from 'node:events';
9
9
  export const KEY = {
@@ -1,30 +1,31 @@
1
1
  /**
2
- * Edição de uma linha de texto num campo do wizard.
2
+ * Editing a single line of text in a wizard field.
3
3
  *
4
- * O campo aceitava só duas coisas — digitar no fim e apagar de trás para a
5
- * frente. Quem quisesse trocar o meio de um alias (`@/shared/components` para
6
- * `@app/shared/components`) apertava as setas, não via nada acontecer e ficava
7
- * sem saída a não ser apagar tudo e redigitar. Aqui o cursor é de verdade:
8
- * anda, insere no meio, apaga para os dois lados.
4
+ * The field accepted exactly two things — typing at the end and deleting
5
+ * backwards. Anyone who wanted to change the middle of an alias
6
+ * (`@/shared/components` to `@app/shared/components`) pressed the arrow keys,
7
+ * saw nothing happen, and was left with no option but to delete everything and
8
+ * retype it. Here the cursor is real: it moves, inserts in the middle, and
9
+ * deletes in both directions.
9
10
  */
10
11
  import type { KeyEvent } from '../ui/engine/index.js';
11
12
  export interface TextInput {
12
13
  readonly value: string;
13
- /** Posição do cursor, em caracteres — nunca fora de `[0, comprimento]`. */
14
+ /** Cursor position, in characters — never outside `[0, length]`. */
14
15
  readonly caret: number;
15
16
  /**
16
- * true enquanto o campo ainda mostra a sugestão e o usuário não tocou nela:
17
- * a primeira tecla digitada substitui a sugestão inteira, em vez de emendar
18
- * nela. Mover o cursor ou apagar assume o valor e passa a editá-lo.
17
+ * True while the field still shows the suggestion and the user has not touched
18
+ * it: the first key typed replaces the whole suggestion instead of appending
19
+ * to it. Moving the cursor or deleting adopts the value and starts editing it.
19
20
  */
20
21
  readonly pristine: boolean;
21
22
  }
22
23
  export declare function startInput(value: string): TextInput;
23
24
  /**
24
- * Aplica uma tecla ao campo.
25
+ * Applies one key to the field.
25
26
  *
26
- * Devolve `null` quando a tecla não é de edição — `enter` e `escape` pertencem
27
- * ao fluxo do wizard, e é ele quem decide o que fazer com elas.
27
+ * Returns `null` when the key is not an editing key — `enter` and `escape`
28
+ * belong to the wizard's flow, and it decides what to do with them.
28
29
  */
29
30
  export declare function editInput(state: TextInput, event: KeyEvent): TextInput | null;
30
31
  //# sourceMappingURL=text-input.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"text-input.d.ts","sourceRoot":"","sources":["../../src/ui/text-input.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI,CA0C7E"}
1
+ {"version":3,"file":"text-input.d.ts","sourceRoot":"","sources":["../../src/ui/text-input.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI,CA2C7E"}
package/ui/text-input.js CHANGED
@@ -1,20 +1,21 @@
1
1
  /**
2
- * Edição de uma linha de texto num campo do wizard.
2
+ * Editing a single line of text in a wizard field.
3
3
  *
4
- * O campo aceitava só duas coisas — digitar no fim e apagar de trás para a
5
- * frente. Quem quisesse trocar o meio de um alias (`@/shared/components` para
6
- * `@app/shared/components`) apertava as setas, não via nada acontecer e ficava
7
- * sem saída a não ser apagar tudo e redigitar. Aqui o cursor é de verdade:
8
- * anda, insere no meio, apaga para os dois lados.
4
+ * The field accepted exactly two things — typing at the end and deleting
5
+ * backwards. Anyone who wanted to change the middle of an alias
6
+ * (`@/shared/components` to `@app/shared/components`) pressed the arrow keys,
7
+ * saw nothing happen, and was left with no option but to delete everything and
8
+ * retype it. Here the cursor is real: it moves, inserts in the middle, and
9
+ * deletes in both directions.
9
10
  */
10
11
  export function startInput(value) {
11
12
  return { value, caret: [...value].length, pristine: true };
12
13
  }
13
14
  /**
14
- * Aplica uma tecla ao campo.
15
+ * Applies one key to the field.
15
16
  *
16
- * Devolve `null` quando a tecla não é de edição — `enter` e `escape` pertencem
17
- * ao fluxo do wizard, e é ele quem decide o que fazer com elas.
17
+ * Returns `null` when the key is not an editing key — `enter` and `escape`
18
+ * belong to the wizard's flow, and it decides what to do with them.
18
19
  */
19
20
  export function editInput(state, event) {
20
21
  const chars = [...state.value];
@@ -24,8 +25,9 @@ export function editInput(state, event) {
24
25
  if (event.alt)
25
26
  return null;
26
27
  if (event.key.length === 1) {
27
- // A sugestão inteira sai na primeira tecla: quem já sabe o que quer digita
28
- // direto, sem apagar caractere por caractere o que a CLI propôs.
28
+ // The whole suggestion goes on the first key: someone who already knows what
29
+ // they want types straight over it, rather than deleting the CLI's proposal
30
+ // one character at a time.
29
31
  if (state.pristine)
30
32
  return { value: event.key, caret: 1, pristine: false };
31
33
  chars.splice(caret, 0, event.key);
@@ -57,9 +59,9 @@ export function editInput(state, event) {
57
59
  /** Os atalhos de linha que qualquer shell oferece. */
58
60
  function editWithControl(state, chars, caret, key) {
59
61
  switch (key) {
60
- case 'u': // limpa até o começo
62
+ case 'u': // clear to the start
61
63
  return { value: chars.slice(caret).join(''), caret: 0, pristine: false };
62
- case 'k': // limpa até o fim
64
+ case 'k': // clear to the end
63
65
  return { value: chars.slice(0, caret).join(''), caret, pristine: false };
64
66
  case 'w': {
65
67
  // apaga a palavra anterior, incluindo os separadores que a antecedem
@@ -1 +1 @@
1
- {"version":3,"file":"text-input.js","sourceRoot":"","sources":["../../src/ui/text-input.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"text-input.js","sourceRoot":"","sources":["../../src/ui/text-input.ts"],"names":[],"mappings":"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"}
package/ui/theme.d.ts CHANGED
@@ -1,9 +1,9 @@
1
1
  /**
2
- * Tema da CLI — tokens semânticos consumidos por toda a UI do terminal.
2
+ * The CLI's theme — semantic tokens consumed by the whole terminal UI.
3
3
  *
4
- * A paleta segue a base neutra do ZardUI (zinc) para texto e bordas, com os
5
- * acentos reservados para estado: primary marca o passo ativo e o cursor,
6
- * success/warning/danger comunicam o resultado de cada etapa.
4
+ * The palette follows ZardUI's neutral base (zinc) for text and borders, with
5
+ * the accents reserved for state: primary marks the active step and the cursor,
6
+ * while success/warning/danger communicate each step's outcome.
7
7
  */
8
8
  import { type Theme } from './engine/index.js';
9
9
  export declare const zardTheme: Theme;
package/ui/theme.js CHANGED
@@ -1,9 +1,9 @@
1
1
  /**
2
- * Tema da CLI — tokens semânticos consumidos por toda a UI do terminal.
2
+ * The CLI's theme — semantic tokens consumed by the whole terminal UI.
3
3
  *
4
- * A paleta segue a base neutra do ZardUI (zinc) para texto e bordas, com os
5
- * acentos reservados para estado: primary marca o passo ativo e o cursor,
6
- * success/warning/danger comunicam o resultado de cada etapa.
4
+ * The palette follows ZardUI's neutral base (zinc) for text and borders, with
5
+ * the accents reserved for state: primary marks the active step and the cursor,
6
+ * while success/warning/danger communicate each step's outcome.
7
7
  */
8
8
  import { createTheme } from './engine/index.js';
9
9
  export const zardTheme = createTheme({
@@ -0,0 +1,21 @@
1
+ /**
2
+ * Pins the dependencies whose releases are tied to an Angular major.
3
+ *
4
+ * Zard supports Angular 19 and above, but several of the packages it installs
5
+ * ship one release per Angular major and peer on `>=` that major. Asking for
6
+ * them by name resolves to `latest`, which peers on an Angular newer than the
7
+ * project's: npm then fails the whole install with ERESOLVE, and the retry with
8
+ * `--legacy-peer-deps` "succeeds" while leaving a version that cannot compile.
9
+ */
10
+ /** The major of an Angular version string, or null when it could not be read. */
11
+ export declare function angularMajorOf(angularVersion: string | null | undefined): number | null;
12
+ /**
13
+ * The install specifier for one package.
14
+ *
15
+ * Returns the name unchanged whenever nothing is known to constrain it — an
16
+ * unrecognized package, or an Angular major this package has no history for.
17
+ */
18
+ export declare function pinForAngular(packageName: string, angularMajor: number | null): string;
19
+ /** `pinForAngular` over a batch, keeping the order the caller passed. */
20
+ export declare function pinAllForAngular(packageNames: Iterable<string>, angularVersion: string | null): string[];
21
+ //# sourceMappingURL=angular-compat.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"angular-compat.d.ts","sourceRoot":"","sources":["../../src/utils/angular-compat.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAoBH,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAKvF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAOtF;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,EAAE,CAGxG"}
@@ -0,0 +1,52 @@
1
+ /**
2
+ * Pins the dependencies whose releases are tied to an Angular major.
3
+ *
4
+ * Zard supports Angular 19 and above, but several of the packages it installs
5
+ * ship one release per Angular major and peer on `>=` that major. Asking for
6
+ * them by name resolves to `latest`, which peers on an Angular newer than the
7
+ * project's: npm then fails the whole install with ERESOLVE, and the retry with
8
+ * `--legacy-peer-deps` "succeeds" while leaving a version that cannot compile.
9
+ */
10
+ /** Packages whose own major is the Angular major, so the pin is arithmetic. */
11
+ const TRACKS_ANGULAR_MAJOR = new Set(['@angular/cdk', 'embla-carousel-angular', 'ngx-echarts']);
12
+ /**
13
+ * The newest release of a package that still accepts a given Angular major, for
14
+ * the packages that version on their own schedule.
15
+ *
16
+ * Entries are only ever needed for a superseded Angular major, and those never
17
+ * go stale: once Angular N is behind us, the last release built for it is
18
+ * history. The current major is deliberately absent — it falls through
19
+ * unconstrained to `latest`, which is the release made for it. So when Angular
20
+ * N+1 ships, N gets its entry here.
21
+ */
22
+ const LAST_COMPATIBLE = {
23
+ '@ng-icons/core': { 19: '^31', 20: '^32', 21: '^34' },
24
+ '@ng-icons/lucide': { 19: '^31', 20: '^32', 21: '^34' },
25
+ };
26
+ /** The major of an Angular version string, or null when it could not be read. */
27
+ export function angularMajorOf(angularVersion) {
28
+ if (!angularVersion)
29
+ return null;
30
+ const major = Number.parseInt(angularVersion.split('.')[0], 10);
31
+ return Number.isNaN(major) ? null : major;
32
+ }
33
+ /**
34
+ * The install specifier for one package.
35
+ *
36
+ * Returns the name unchanged whenever nothing is known to constrain it — an
37
+ * unrecognized package, or an Angular major this package has no history for.
38
+ */
39
+ export function pinForAngular(packageName, angularMajor) {
40
+ if (angularMajor === null)
41
+ return packageName;
42
+ if (TRACKS_ANGULAR_MAJOR.has(packageName))
43
+ return `${packageName}@^${angularMajor}`;
44
+ const range = LAST_COMPATIBLE[packageName]?.[angularMajor];
45
+ return range ? `${packageName}@${range}` : packageName;
46
+ }
47
+ /** `pinForAngular` over a batch, keeping the order the caller passed. */
48
+ export function pinAllForAngular(packageNames, angularVersion) {
49
+ const major = angularMajorOf(angularVersion);
50
+ return Array.from(packageNames, name => pinForAngular(name, major));
51
+ }
52
+ //# sourceMappingURL=angular-compat.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"angular-compat.js","sourceRoot":"","sources":["../../src/utils/angular-compat.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,+EAA+E;AAC/E,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,wBAAwB,EAAE,aAAa,CAAC,CAAC,CAAC;AAEhG;;;;;;;;;GASG;AACH,MAAM,eAAe,GAA2C;IAC9D,gBAAgB,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE;IACrD,kBAAkB,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE;CACxD,CAAC;AAEF,iFAAiF;AACjF,MAAM,UAAU,cAAc,CAAC,cAAyC;IACtE,IAAI,CAAC,cAAc;QAAE,OAAO,IAAI,CAAC;IAEjC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAW,EAAE,EAAE,CAAC,CAAC;IAC1E,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB,EAAE,YAA2B;IAC5E,IAAI,YAAY,KAAK,IAAI;QAAE,OAAO,WAAW,CAAC;IAE9C,IAAI,oBAAoB,CAAC,GAAG,CAAC,WAAW,CAAC;QAAE,OAAO,GAAG,WAAW,KAAK,YAAY,EAAE,CAAC;IAEpF,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC;IAC3D,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,WAAW,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;AACzD,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,gBAAgB,CAAC,YAA8B,EAAE,cAA6B;IAC5F,MAAM,KAAK,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;IAC7C,OAAO,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;AACtE,CAAC"}
package/utils/config.d.ts CHANGED
@@ -37,18 +37,18 @@ export type Config = z.infer<typeof configSchema>;
37
37
  export declare const DEFAULT_CONFIG: Config;
38
38
  export declare function getConfig(cwd: string): Promise<Config | null>;
39
39
  /**
40
- * Separa o prefixo do alias do caminho que vem depois dele.
40
+ * Splits an alias prefix from the path that follows it.
41
41
  *
42
- * `@`, `@app`, `~` — o nome não importa: o prefixo é um apelido para `baseUrl`,
43
- * e o resto é o caminho dentro do projeto. Tratar só `@/` fazia um alias como
44
- * `@app/components` escapar da substituição e virar uma pasta literal chamada
45
- * `@app` na raiz, fora de qualquer coisa que o tsconfig mapeie.
42
+ * `@`, `@app`, `~` — the name does not matter: the prefix is a nickname for
43
+ * `baseUrl`, and the rest is the path inside the project. Handling only `@/`
44
+ * let an alias like `@app/components` escape the substitution and become a
45
+ * literal folder named `@app` at the root, outside anything the tsconfig maps.
46
46
  */
47
47
  export declare function splitAlias(alias: string): {
48
48
  prefix: string;
49
49
  rest: string;
50
50
  };
51
- /** O prefixo do alias, com `/*` — a chave que o tsconfig precisa mapear. */
51
+ /** The alias prefix, with `/*` — the key the tsconfig has to map. */
52
52
  export declare function aliasPattern(alias: string): string;
53
53
  export declare function resolveAliasToPath(alias: string, baseUrl: string): string;
54
54
  export declare function resolveConfigPaths(cwd: string, config: Config): Promise<{
@@ -1 +1 @@
1
- {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgBxB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyChB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,eAAO,MAAM,cAAc,EAAE,MAkB5B,CAAC;AAEF,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqBnE;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAO1E;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAKzE;AAED,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAcnE"}
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgBxB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyChB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,eAAO,MAAM,cAAc,EAAE,MAkB5B,CAAC;AAEF,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqBnE;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAO1E;AAED,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAKzE;AAED,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAcnE"}