@mks2508/better-logger 0.18.2-alpha.1 → 0.18.2-alpha.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 (185) hide show
  1. package/README.md +38 -336
  2. package/dist/Logger.d.ts +243 -154
  3. package/dist/Logger.d.ts.map +1 -1
  4. package/dist/ScopedLogger.d.ts +511 -8
  5. package/dist/ScopedLogger.d.ts.map +1 -1
  6. package/dist/chunks/HookBridge-C-AvXmPD.cjs +504 -0
  7. package/dist/chunks/HookBridge-C-AvXmPD.cjs.map +1 -0
  8. package/dist/chunks/HookBridge-CI2PH79S.js +487 -0
  9. package/dist/chunks/HookBridge-CI2PH79S.js.map +1 -0
  10. package/dist/chunks/{LogContext-L7HzynFw.cjs → LogContext-BaMXleWj.cjs} +19 -4
  11. package/dist/chunks/LogContext-BaMXleWj.cjs.map +1 -0
  12. package/dist/chunks/{LogContext-Cwn-1Zzb.js → LogContext-DjlITOzZ.js} +19 -4
  13. package/dist/chunks/LogContext-DjlITOzZ.js.map +1 -0
  14. package/dist/chunks/SerializerBridge-Ba43Mk7j.js +393 -0
  15. package/dist/chunks/SerializerBridge-Ba43Mk7j.js.map +1 -0
  16. package/dist/chunks/SerializerBridge-C4a9Z37F.cjs +410 -0
  17. package/dist/chunks/SerializerBridge-C4a9Z37F.cjs.map +1 -0
  18. package/dist/chunks/{StyleManager-CIpd6wbO.cjs → StyleManager-DQ6UNRB-.cjs} +37 -11
  19. package/dist/chunks/StyleManager-DQ6UNRB-.cjs.map +1 -0
  20. package/dist/chunks/StyleManager-DjwAYbxE.js +113 -0
  21. package/dist/chunks/StyleManager-DjwAYbxE.js.map +1 -0
  22. package/dist/chunks/{core-PoT7RrTK.js → core-Blfi2klP.js} +1 -4
  23. package/dist/chunks/core-Blfi2klP.js.map +1 -0
  24. package/dist/chunks/{core-Dzz7agGa.cjs → core-CqS_UBzJ.cjs} +1 -4
  25. package/dist/chunks/core-CqS_UBzJ.cjs.map +1 -0
  26. package/dist/chunks/{environment-detector-CI3TrWK_.js → environment-detector-7NvnYUfr.js} +11 -11
  27. package/dist/chunks/environment-detector-7NvnYUfr.js.map +1 -0
  28. package/dist/chunks/{environment-detector-Cnn6wr6O.cjs → environment-detector-D-tHkKWA.cjs} +11 -11
  29. package/dist/chunks/environment-detector-D-tHkKWA.cjs.map +1 -0
  30. package/dist/chunks/server-fallback-CaCPjWby.cjs +119 -0
  31. package/dist/chunks/server-fallback-CaCPjWby.cjs.map +1 -0
  32. package/dist/chunks/server-fallback-jj0T6XaK.js +114 -0
  33. package/dist/chunks/server-fallback-jj0T6XaK.js.map +1 -0
  34. package/dist/chunks/{spinner-DNvxbM9a.cjs → spinner-BHyYEXsM.cjs} +319 -37
  35. package/dist/chunks/spinner-BHyYEXsM.cjs.map +1 -0
  36. package/dist/chunks/{spinner-D3FsF78o.js → spinner-BtkwpzYv.js} +319 -37
  37. package/dist/chunks/spinner-BtkwpzYv.js.map +1 -0
  38. package/dist/chunks/styling-CRw3KQW4.js +1592 -0
  39. package/dist/chunks/styling-CRw3KQW4.js.map +1 -0
  40. package/dist/chunks/styling-Cel2wPRy.cjs +1645 -0
  41. package/dist/chunks/styling-Cel2wPRy.cjs.map +1 -0
  42. package/dist/chunks/transports-BGfwwakw.js +1237 -0
  43. package/dist/chunks/transports-BGfwwakw.js.map +1 -0
  44. package/dist/chunks/transports-yK6CL0Ml.cjs +1278 -0
  45. package/dist/chunks/transports-yK6CL0Ml.cjs.map +1 -0
  46. package/dist/chunks/{utils-BqlFYocD.cjs → utils-W_cxqriN.cjs} +44 -37
  47. package/dist/chunks/utils-W_cxqriN.cjs.map +1 -0
  48. package/dist/chunks/{utils-VETbVpkR.js → utils-tKfBAWUM.js} +44 -37
  49. package/dist/chunks/utils-tKfBAWUM.js.map +1 -0
  50. package/dist/cli/CommandProcessor.d.ts +166 -19
  51. package/dist/cli/CommandProcessor.d.ts.map +1 -1
  52. package/dist/cli/commands/ConfigCommand.d.ts +36 -1
  53. package/dist/cli/commands/ConfigCommand.d.ts.map +1 -1
  54. package/dist/cli/commands/ExportCommand.d.ts +49 -3
  55. package/dist/cli/commands/ExportCommand.d.ts.map +1 -1
  56. package/dist/cli/commands/ThemeCommand.d.ts +62 -3
  57. package/dist/cli/commands/ThemeCommand.d.ts.map +1 -1
  58. package/dist/cli/help.d.ts +30 -2
  59. package/dist/cli/help.d.ts.map +1 -1
  60. package/dist/cli/index.d.ts +29 -2
  61. package/dist/cli/index.d.ts.map +1 -1
  62. package/dist/cli.cjs +2 -2
  63. package/dist/cli.js +2 -2
  64. package/dist/context/LogContext.d.ts +165 -66
  65. package/dist/context/LogContext.d.ts.map +1 -1
  66. package/dist/context.cjs +1 -1
  67. package/dist/context.js +1 -1
  68. package/dist/core.cjs +52 -29
  69. package/dist/core.cjs.map +1 -1
  70. package/dist/core.d.ts +50 -27
  71. package/dist/core.d.ts.map +1 -1
  72. package/dist/core.js +52 -29
  73. package/dist/core.js.map +1 -1
  74. package/dist/hooks/HookBridge.d.ts +15 -9
  75. package/dist/hooks/HookBridge.d.ts.map +1 -1
  76. package/dist/hooks/HookManager.d.ts +295 -2
  77. package/dist/hooks/HookManager.d.ts.map +1 -1
  78. package/dist/hooks.cjs +1 -1
  79. package/dist/hooks.js +1 -1
  80. package/dist/index.cjs +1092 -212
  81. package/dist/index.cjs.map +1 -1
  82. package/dist/index.js +1092 -212
  83. package/dist/index.js.map +1 -1
  84. package/dist/playground/TerminalBridge.d.ts +23 -16
  85. package/dist/playground/TerminalBridge.d.ts.map +1 -1
  86. package/dist/playground/box.d.ts +36 -5
  87. package/dist/playground/box.d.ts.map +1 -1
  88. package/dist/playground/cli-table.d.ts +41 -5
  89. package/dist/playground/cli-table.d.ts.map +1 -1
  90. package/dist/playground/divider.d.ts +22 -3
  91. package/dist/playground/divider.d.ts.map +1 -1
  92. package/dist/playground/header.d.ts +21 -4
  93. package/dist/playground/header.d.ts.map +1 -1
  94. package/dist/playground/server-fallback.d.ts +96 -9
  95. package/dist/playground/server-fallback.d.ts.map +1 -1
  96. package/dist/playground/spinner.d.ts +159 -10
  97. package/dist/playground/spinner.d.ts.map +1 -1
  98. package/dist/playground/step.d.ts +25 -6
  99. package/dist/playground/step.d.ts.map +1 -1
  100. package/dist/playground.cjs +1 -1
  101. package/dist/playground.js +1 -1
  102. package/dist/serializers/SerializerBridge.d.ts +13 -6
  103. package/dist/serializers/SerializerBridge.d.ts.map +1 -1
  104. package/dist/serializers/SerializerRegistry.d.ts +236 -0
  105. package/dist/serializers/SerializerRegistry.d.ts.map +1 -1
  106. package/dist/serializers.cjs +1 -1
  107. package/dist/serializers.js +1 -1
  108. package/dist/styles/StyleManager.d.ts +138 -31
  109. package/dist/styles/StyleManager.d.ts.map +1 -1
  110. package/dist/styles.cjs +2 -2
  111. package/dist/styles.js +2 -2
  112. package/dist/styling/SmartPresets.d.ts +100 -6
  113. package/dist/styling/SmartPresets.d.ts.map +1 -1
  114. package/dist/styling/StyleBuilder.d.ts +453 -32
  115. package/dist/styling/StyleBuilder.d.ts.map +1 -1
  116. package/dist/styling/banners.d.ts +83 -7
  117. package/dist/styling/banners.d.ts.map +1 -1
  118. package/dist/styling/themes.d.ts +41 -2
  119. package/dist/styling/themes.d.ts.map +1 -1
  120. package/dist/transports/ConsoleTransport.d.ts +95 -0
  121. package/dist/transports/ConsoleTransport.d.ts.map +1 -1
  122. package/dist/transports/FileTransport.d.ts +99 -18
  123. package/dist/transports/FileTransport.d.ts.map +1 -1
  124. package/dist/transports/HttpTransport.d.ts +135 -22
  125. package/dist/transports/HttpTransport.d.ts.map +1 -1
  126. package/dist/transports/OtlpTransport.d.ts +53 -36
  127. package/dist/transports/OtlpTransport.d.ts.map +1 -1
  128. package/dist/transports/TransportBridge.d.ts +19 -13
  129. package/dist/transports/TransportBridge.d.ts.map +1 -1
  130. package/dist/transports/TransportManager.d.ts +223 -8
  131. package/dist/transports/TransportManager.d.ts.map +1 -1
  132. package/dist/transports.cjs +1 -1
  133. package/dist/transports.js +1 -1
  134. package/dist/types/core.d.ts +155 -59
  135. package/dist/types/core.d.ts.map +1 -1
  136. package/dist/types/hooks.d.ts +92 -14
  137. package/dist/types/hooks.d.ts.map +1 -1
  138. package/dist/types/serializers.d.ts +72 -0
  139. package/dist/types/serializers.d.ts.map +1 -1
  140. package/dist/types/transports.d.ts +42 -37
  141. package/dist/types/transports.d.ts.map +1 -1
  142. package/dist/utils/ansi-colors.d.ts +15 -15
  143. package/dist/utils/environment-detector.d.ts +11 -11
  144. package/dist/utils/formatting.d.ts +8 -8
  145. package/dist/utils/output.d.ts +9 -9
  146. package/dist/utils/output.d.ts.map +1 -1
  147. package/dist/utils/stackTrace.d.ts +2 -2
  148. package/package.json +24 -25
  149. package/dist/chunks/HookBridge-CiRfR67f.cjs +0 -190
  150. package/dist/chunks/HookBridge-CiRfR67f.cjs.map +0 -1
  151. package/dist/chunks/HookBridge-SgMmbXZB.js +0 -173
  152. package/dist/chunks/HookBridge-SgMmbXZB.js.map +0 -1
  153. package/dist/chunks/LogContext-Cwn-1Zzb.js.map +0 -1
  154. package/dist/chunks/LogContext-L7HzynFw.cjs.map +0 -1
  155. package/dist/chunks/SerializerBridge-BaOQOb8q.cjs +0 -166
  156. package/dist/chunks/SerializerBridge-BaOQOb8q.cjs.map +0 -1
  157. package/dist/chunks/SerializerBridge-BkpQu5c9.js +0 -149
  158. package/dist/chunks/SerializerBridge-BkpQu5c9.js.map +0 -1
  159. package/dist/chunks/StyleManager-CIpd6wbO.cjs.map +0 -1
  160. package/dist/chunks/StyleManager-LCvVlVdx.js +0 -87
  161. package/dist/chunks/StyleManager-LCvVlVdx.js.map +0 -1
  162. package/dist/chunks/core-Dzz7agGa.cjs.map +0 -1
  163. package/dist/chunks/core-PoT7RrTK.js.map +0 -1
  164. package/dist/chunks/environment-detector-CI3TrWK_.js.map +0 -1
  165. package/dist/chunks/environment-detector-Cnn6wr6O.cjs.map +0 -1
  166. package/dist/chunks/server-fallback-BUKjdLS7.cjs +0 -42
  167. package/dist/chunks/server-fallback-BUKjdLS7.cjs.map +0 -1
  168. package/dist/chunks/server-fallback-BsuWH1Dk.js +0 -37
  169. package/dist/chunks/server-fallback-BsuWH1Dk.js.map +0 -1
  170. package/dist/chunks/spinner-D3FsF78o.js.map +0 -1
  171. package/dist/chunks/spinner-DNvxbM9a.cjs.map +0 -1
  172. package/dist/chunks/styling-84N8T97t.js +0 -941
  173. package/dist/chunks/styling-84N8T97t.js.map +0 -1
  174. package/dist/chunks/styling-Cg5saQ46.cjs +0 -994
  175. package/dist/chunks/styling-Cg5saQ46.cjs.map +0 -1
  176. package/dist/chunks/transports-BiDk345e.js +0 -715
  177. package/dist/chunks/transports-BiDk345e.js.map +0 -1
  178. package/dist/chunks/transports-COPWmlF1.cjs +0 -756
  179. package/dist/chunks/transports-COPWmlF1.cjs.map +0 -1
  180. package/dist/chunks/utils-BqlFYocD.cjs.map +0 -1
  181. package/dist/chunks/utils-VETbVpkR.js.map +0 -1
  182. package/dist/example.d.ts +0 -18
  183. package/dist/example.d.ts.map +0 -1
  184. package/dist/main.d.ts +0 -2
  185. package/dist/main.d.ts.map +0 -1
@@ -4,12 +4,47 @@
4
4
  import type { ICommand } from '../CommandProcessor.js';
5
5
  import type { Logger } from '../../Logger.js';
6
6
  /**
7
- * Configuration command handler
7
+ * Comando `/config` del CLI runtime del {@link Logger}. Inspecciona o muta
8
+ * la configuración del logger en vivo desde la DevTools console.
9
+ *
10
+ * Acepta tres modos de invocación:
11
+ * - Sin argumentos: vuelca el estado actual como tabla agrupada.
12
+ * - JSON completo (empieza con `{`): aplica un objeto de configuración parcial.
13
+ * - Pares `key=value` separados por coma: atajo para mutaciones puntuales.
14
+ *
15
+ * Solo se aplican las keys de la whitelist interna (`theme`, `verbosity`,
16
+ * `enableColors`, `enableTimestamps`, `enableStackTrace`, `globalPrefix`,
17
+ * `bannerType`); cualquier otra key se rechaza con un `warn` y se ignora.
18
+ *
19
+ * @example
20
+ * // Sin argumentos: ver estado actual
21
+ * // > /config
22
+ *
23
+ * @example
24
+ * // Objeto JSON completo
25
+ * // > /config {"theme":"neon","verbosity":"debug"}
26
+ *
27
+ * @example
28
+ * // Atajo key=value (múltiples pares separados por coma)
29
+ * // > /config theme=neon,verbosity=debug,globalPrefix=MiApp
30
+ *
31
+ * @see {@link ICommand} para el contrato que implementa este comando.
32
+ * @see {@link Logger.setTheme}, {@link Logger.setVerbosity},
33
+ * {@link Logger.setBannerType}, {@link Logger.setGlobalPrefix}
34
+ * para los setters subyacentes.
8
35
  */
9
36
  export declare class ConfigCommand implements ICommand {
10
37
  name: string;
11
38
  description: string;
12
39
  usage: string;
40
+ /**
41
+ * Ejecuta el comando `/config` contra el logger dado.
42
+ *
43
+ * @param args - Argumentos crudos del usuario. Vacío = status; con `{`
44
+ * inicial = parse JSON; resto = pares `key=value` separados
45
+ * por coma.
46
+ * @param logger - Instancia destino cuyos setters se invocan.
47
+ */
13
48
  execute(args: string, logger: Logger): void;
14
49
  private showStatus;
15
50
  private applyConfig;
@@ -1 +1 @@
1
- {"version":3,"file":"ConfigCommand.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/ConfigCommand.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAG9C;;GAEG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC1C,IAAI,SAAY;IAChB,WAAW,SAAyC;IACpD,KAAK,SAAkC;IAEvC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IA4B3C,OAAO,CAAC,UAAU;IAiBlB,OAAO,CAAC,WAAW;CA+BtB"}
1
+ {"version":3,"file":"ConfigCommand.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/ConfigCommand.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAG9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC1C,IAAI,SAAY;IAChB,WAAW,SAAyC;IACpD,KAAK,SAAkC;IAEvC;;;;;;;OAOG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IA4B3C,OAAO,CAAC,UAAU;IAiBlB,OAAO,CAAC,WAAW;CA+BtB"}
@@ -4,30 +4,76 @@
4
4
  import type { ICommand } from '../CommandProcessor.js';
5
5
  import type { Logger } from '../../Logger.js';
6
6
  /**
7
- * Status command - show logger configuration and statistics
7
+ * Comando `/status` del CLI runtime del {@link Logger}. Vuelca la
8
+ * configuración vigente y algunas estadísticas (theme, verbosity, flags
9
+ * de features, handler count, bufferSize) en una tabla agrupada dentro
10
+ * de la consola. Es de solo lectura: no muta el logger.
11
+ *
12
+ * @example
13
+ * // Inspeccionar el estado actual del logger
14
+ * // > /status
15
+ *
16
+ * @see {@link Logger.getConfig} fuente de los datos mostrados.
8
17
  */
9
18
  export declare class StatusCommand implements ICommand {
10
19
  name: string;
11
20
  description: string;
12
21
  usage: string;
22
+ /**
23
+ * Ejecuta el comando `/status` contra el logger dado.
24
+ *
25
+ * @param _args - Ignorado (comando sin parámetros).
26
+ * @param logger - Instancia de la que se lee la configuración.
27
+ */
13
28
  execute(_args: string, logger: Logger): void;
14
29
  }
15
30
  /**
16
- * Reset command - reset logger to defaults
31
+ * Comando `/reset` del CLI runtime del {@link Logger}. Restaura la
32
+ * configuración a sus defaults de fábrica vía {@link Logger.resetConfig}.
33
+ * No resetea handlers ni transports registrados — solo config.
34
+ *
35
+ * @example
36
+ * // Volver a la configuración por defecto
37
+ * // > /reset
38
+ *
39
+ * @see {@link Logger.resetConfig} para el método subyacente.
17
40
  */
18
41
  export declare class ResetCommand implements ICommand {
19
42
  name: string;
20
43
  description: string;
21
44
  usage: string;
45
+ /**
46
+ * Ejecuta el comando `/reset` contra el logger dado.
47
+ *
48
+ * @param _args - Ignorado (comando sin parámetros).
49
+ * @param logger - Instancia cuya configuración se resetea.
50
+ */
22
51
  execute(_args: string, logger: Logger): void;
23
52
  }
24
53
  /**
25
- * Demo command - show logger feature demonstration
54
+ * Comando `/demo` del CLI runtime del {@link Logger}. Ejecuta una
55
+ * demostración integral de las capacidades del logger: todos los niveles
56
+ * de log (debug → critical), tablas, timers (`time`/`timeEnd`), SVG inline
57
+ * y mensajes animados. Útil para validar que el styling funciona en un
58
+ * entorno nuevo o tras un cambio de tema.
59
+ *
60
+ * @example
61
+ * // Lanzar la demo completa
62
+ * // > /demo
63
+ *
64
+ * @see {@link Logger} para cada feature individual (`table`, `time`,
65
+ * `logWithSVG`, `logAnimated`, ...).
26
66
  */
27
67
  export declare class DemoCommand implements ICommand {
28
68
  name: string;
29
69
  description: string;
30
70
  usage: string;
71
+ /**
72
+ * Ejecuta el comando `/demo` contra el logger dado.
73
+ *
74
+ * @param _args - Ignorado (comando sin parámetros).
75
+ * @param logger - Instancia sobre la que se ejecutan los ejemplos.
76
+ */
31
77
  execute(_args: string, logger: Logger): void;
32
78
  }
33
79
  //# sourceMappingURL=ExportCommand.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"ExportCommand.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/ExportCommand.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;GAEG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC1C,IAAI,SAAY;IAChB,WAAW,SAAkD;IAC7D,KAAK,SAAa;IAElB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAkB/C;AAED;;GAEG;AACH,qBAAa,YAAa,YAAW,QAAQ;IACzC,IAAI,SAAW;IACf,WAAW,SAA4C;IACvD,KAAK,SAAY;IAEjB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAG/C;AAED;;GAEG;AACH,qBAAa,WAAY,YAAW,QAAQ;IACxC,IAAI,SAAU;IACd,WAAW,SAA8C;IACzD,KAAK,SAAW;IAEhB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAuC/C"}
1
+ {"version":3,"file":"ExportCommand.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/ExportCommand.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;;;;;;;;;;GAWG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC1C,IAAI,SAAY;IAChB,WAAW,SAAkD;IAC7D,KAAK,SAAa;IAElB;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAkB/C;AAED;;;;;;;;;;GAUG;AACH,qBAAa,YAAa,YAAW,QAAQ;IACzC,IAAI,SAAW;IACf,WAAW,SAA4C;IACvD,KAAK,SAAY;IAEjB;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAG/C;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,WAAY,YAAW,QAAQ;IACxC,IAAI,SAAU;IACd,WAAW,SAA8C;IACzD,KAAK,SAAW;IAEhB;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAuC/C"}
@@ -4,30 +4,89 @@
4
4
  import type { ICommand } from '../CommandProcessor.js';
5
5
  import type { Logger } from '../../Logger.js';
6
6
  /**
7
- * Themes command - show available themes
7
+ * Comando `/themes` del CLI runtime del {@link Logger}. Lista los presets
8
+ * temáticos disponibles en {@link THEME_PRESETS}, renderizando una preview
9
+ * con los colores reales de cada tema (background, foreground, border).
10
+ *
11
+ * Es de solo lectura: no muta el logger. Útil para descubrir qué tema
12
+ * aplicar antes de correr `/config theme=<name>`.
13
+ *
14
+ * @example
15
+ * // Listar todos los temas con preview coloreada
16
+ * // > /themes
17
+ *
18
+ * @see {@link THEME_PRESETS} para el catálogo completo de temas.
19
+ * @see {@link ConfigCommand} para aplicar un tema vía `/config theme=...`.
8
20
  */
9
21
  export declare class ThemesCommand implements ICommand {
10
22
  name: string;
11
23
  description: string;
12
24
  usage: string;
25
+ /**
26
+ * Ejecuta el comando `/themes` contra el logger dado.
27
+ *
28
+ * @param _args - Ignorado (comando sin parámetros).
29
+ * @param logger - Instancia usada para abrir/cerrar el `group` de salida.
30
+ */
13
31
  execute(_args: string, logger: Logger): void;
14
32
  }
15
33
  /**
16
- * Banners command - show available banner types
34
+ * Comando `/banners` del CLI runtime del {@link Logger}. Enumera los tipos
35
+ * de banner disponibles en {@link BANNER_VARIANTS} (`simple`, `ascii`,
36
+ * `unicode`, ...) con una mini-preview de cada uno para inspección visual.
37
+ *
38
+ * Es de solo lectura: no muta el logger. Para cambiar el banner activo
39
+ * usar {@link BannerCommand}.
40
+ *
41
+ * @example
42
+ * // Listar todas las variantes de banner con preview
43
+ * // > /banners
44
+ *
45
+ * @see {@link BANNER_VARIANTS} para el catálogo completo de variantes.
46
+ * @see {@link BannerCommand} para aplicar un tipo concreto.
17
47
  */
18
48
  export declare class BannersCommand implements ICommand {
19
49
  name: string;
20
50
  description: string;
21
51
  usage: string;
52
+ /**
53
+ * Ejecuta el comando `/banners` contra el logger dado.
54
+ *
55
+ * @param _args - Ignorado (comando sin parámetros).
56
+ * @param logger - Instancia usada para abrir/cerrar el `group` de salida.
57
+ */
22
58
  execute(_args: string, logger: Logger): void;
23
59
  }
24
60
  /**
25
- * Banner command - change/show banner type
61
+ * Comando `/banner [type]` del CLI runtime del {@link Logger}.
62
+ *
63
+ * - Sin argumentos: re-renderiza el banner actualmente activo.
64
+ * - Con un tipo válido: lo aplica vía {@link Logger.setBannerType} y lo
65
+ * muestra inmediatamente.
66
+ * - Con un tipo inválido: loguea un `error` listando las opciones válidas.
67
+ *
68
+ * @example
69
+ * // Mostrar el banner actual
70
+ * // > /banner
71
+ *
72
+ * @example
73
+ * // Cambiar a un tipo concreto
74
+ * // > /banner ascii
75
+ *
76
+ * @see {@link BANNER_VARIANTS} para los tipos aceptados.
77
+ * @see {@link Logger.setBannerType} y {@link Logger.showBanner} para los
78
+ * métodos subyacentes.
26
79
  */
27
80
  export declare class BannerCommand implements ICommand {
28
81
  name: string;
29
82
  description: string;
30
83
  usage: string;
84
+ /**
85
+ * Ejecuta el comando `/banner` contra el logger dado.
86
+ *
87
+ * @param args - Tipo de banner solicitado. Vacío = mostrar banner actual.
88
+ * @param logger - Instancia destino cuyo banner se actualiza/muestra.
89
+ */
31
90
  execute(args: string, logger: Logger): void;
32
91
  }
33
92
  //# sourceMappingURL=ThemeCommand.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"ThemeCommand.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/ThemeCommand.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAK9C;;GAEG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC1C,IAAI,SAAY;IAChB,WAAW,SAAkC;IAC7C,KAAK,SAAa;IAElB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAgB/C;AAED;;GAEG;AACH,qBAAa,cAAe,YAAW,QAAQ;IAC3C,IAAI,SAAa;IACjB,WAAW,SAAiC;IAC5C,KAAK,SAAc;IAEnB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAoB/C;AAED;;GAEG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC1C,IAAI,SAAY;IAChB,WAAW,SAAwC;IACnD,KAAK,SAAoB;IAEzB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAa9C"}
1
+ {"version":3,"file":"ThemeCommand.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/ThemeCommand.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAK9C;;;;;;;;;;;;;;GAcG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC1C,IAAI,SAAY;IAChB,WAAW,SAAkC;IAC7C,KAAK,SAAa;IAElB;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAgB/C;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAe,YAAW,QAAQ;IAC3C,IAAI,SAAa;IACjB,WAAW,SAAiC;IAC5C,KAAK,SAAc;IAEnB;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAoB/C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC1C,IAAI,SAAY;IAChB,WAAW,SAAwC;IACnD,KAAK,SAAoB;IAEzB;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAa9C"}
@@ -1,15 +1,43 @@
1
1
  /**
2
- * @fileoverview Help system for Advanced Logger CLI
2
+ * @fileoverview Help system del CLI del logger. Expone {@link HelpCommand},
3
+ * que renderiza un panel ASCII con la lista completa de comandos, opciones de
4
+ * configuración, filtros de export y ejemplos de uso.
3
5
  */
4
6
  import type { ICommand } from './CommandProcessor.js';
5
7
  import type { Logger } from '../Logger.js';
6
8
  /**
7
- * Help command - show comprehensive CLI help
9
+ * Comando `/help`: renderiza en consola el panel de ayuda del CLI con todos
10
+ * los comandos disponibles, opciones de configuración, filtros de export y
11
+ * ejemplos. El panel usa un gradient claro con {@link StyleBuilder} y los
12
+ * quick tips se agrupan vía `logger.group`.
13
+ *
14
+ * Registrado por defecto por {@link createDefaultCLI}.
15
+ *
16
+ * @example
17
+ * ```ts
18
+ * const cli = createDefaultCLI();
19
+ * await cli.processCommand('/help', logger);
20
+ * // Imprime el panel ASCII con gradient + grupo "Quick Tips".
21
+ * ```
22
+ *
23
+ * @see {@link ICommand}
24
+ * @see {@link createDefaultCLI}
8
25
  */
9
26
  export declare class HelpCommand implements ICommand {
10
27
  name: string;
11
28
  description: string;
12
29
  usage: string;
30
+ /**
31
+ * Renderiza el panel de ayuda completo. Actualmente ignora `_args`: el
32
+ * `usage` declara `/help [command]` (sub-comando opcional) pero la
33
+ * implementación siempre muestra el panel global.
34
+ *
35
+ * @param {string} _args - Argumentos opcionales (reservado para ayuda por
36
+ * sub-comando; sin uso actual).
37
+ * @param {Logger} logger - Logger activo; se usa solo para `group`/`info`
38
+ * de los quick tips.
39
+ * @returns {void}
40
+ */
13
41
  execute(_args: string, logger: Logger): void;
14
42
  }
15
43
  //# sourceMappingURL=help.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C;;GAEG;AACH,qBAAa,WAAY,YAAW,QAAQ;IACxC,IAAI,SAAU;IACd,WAAW,SAA0C;IACrD,KAAK,SAAqB;IAE1B,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CA8G/C"}
1
+ {"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,WAAY,YAAW,QAAQ;IACxC,IAAI,SAAU;IACd,WAAW,SAA0C;IACrD,KAAK,SAAqB;IAE1B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CA8G/C"}
@@ -1,5 +1,9 @@
1
1
  /**
2
- * @fileoverview CLI system exports for Advanced Logger
2
+ * @fileoverview Punto de entrada del subsistema CLI del logger. Re-exporta el
3
+ * processor, los comandos estándar y expone {@link createDefaultCLI} como
4
+ * factory principal. El CLI no es un binario standalone — se invoca desde
5
+ * código vía `logger.cli()` o desde la devtools vía `window.cli()` (cuando el
6
+ * modo interactivo está activo).
3
7
  */
4
8
  export { CommandProcessor, type ICommand } from './CommandProcessor.js';
5
9
  import { CommandProcessor } from './CommandProcessor.js';
@@ -8,7 +12,30 @@ export { ThemesCommand, BannersCommand, BannerCommand } from './commands/ThemeCo
8
12
  export { StatusCommand, ResetCommand, DemoCommand } from './commands/ExportCommand.js';
9
13
  export { HelpCommand } from './help.js';
10
14
  /**
11
- * Create and configure default CLI processor
15
+ * Crea un {@link CommandProcessor} con los 8 comandos estándar ya registrados:
16
+ * `help`, `config`, `themes`, `banners`, `banner`, `status`, `reset` y
17
+ * `demo`. Es el factory canónico — los consumidores normalmente no construyen
18
+ * un `CommandProcessor` vacío a mano, ya que este no trae comandos cargados.
19
+ *
20
+ * @returns {CommandProcessor} Processor listo para usar, sin modo interactivo activo.
21
+ *
22
+ * @example
23
+ * ```ts
24
+ * const cli = createDefaultCLI();
25
+ * await cli.processCommand('/help', logger);
26
+ * await cli.processCommand('/config theme=neon', logger);
27
+ * ```
28
+ *
29
+ * @example
30
+ * ```ts
31
+ * // Modo interactivo en el navegador: expone `window.cli`
32
+ * const cli = createDefaultCLI();
33
+ * cli.enterInteractiveMode(logger);
34
+ * // desde devtools: cli('themes') → procesa '/themes'
35
+ * ```
36
+ *
37
+ * @see {@link CommandProcessor}
38
+ * @see {@link HelpCommand}
12
39
  */
13
40
  export declare function createDefaultCLI(): CommandProcessor;
14
41
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,gBAAgB,EAAE,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAGvF,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAQxC;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,gBAAgB,CAcnD"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,gBAAgB,EAAE,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAGvF,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAQxC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,gBAAgB,IAAI,gBAAgB,CAcnD"}
package/dist/cli.cjs CHANGED
@@ -1,6 +1,6 @@
1
1
  Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
- const require_spinner = require("./chunks/spinner-DNvxbM9a.cjs");
3
- const require_server_fallback = require("./chunks/server-fallback-BUKjdLS7.cjs");
2
+ const require_spinner = require("./chunks/spinner-BHyYEXsM.cjs");
3
+ const require_server_fallback = require("./chunks/server-fallback-CaCPjWby.cjs");
4
4
  exports.NoopSpinner = require_spinner.NoopSpinner;
5
5
  exports.ServerFallback = require_server_fallback.ServerFallback;
6
6
  exports.SpinnerManager = require_spinner.SpinnerManager;
package/dist/cli.js CHANGED
@@ -1,3 +1,3 @@
1
- import { a as renderDivider, i as renderBox, n as SpinnerManager, o as renderHeader, r as renderTable, s as renderStep, t as NoopSpinner } from "./chunks/spinner-D3FsF78o.js";
2
- import { t as ServerFallback } from "./chunks/server-fallback-BsuWH1Dk.js";
1
+ import { a as renderDivider, i as renderBox, n as SpinnerManager, o as renderHeader, r as renderTable, s as renderStep, t as NoopSpinner } from "./chunks/spinner-BtkwpzYv.js";
2
+ import { t as ServerFallback } from "./chunks/server-fallback-jj0T6XaK.js";
3
3
  export { NoopSpinner, ServerFallback, SpinnerManager, renderBox, renderDivider, renderHeader, renderStep, renderTable };