@boneskull/bargs 3.6.2 → 4.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -19
- package/dist/bargs.cjs +56 -55
- package/dist/bargs.cjs.map +1 -1
- package/dist/bargs.d.cts +9 -0
- package/dist/bargs.d.cts.map +1 -1
- package/dist/bargs.d.ts +9 -0
- package/dist/bargs.d.ts.map +1 -1
- package/dist/bargs.js +56 -55
- package/dist/bargs.js.map +1 -1
- package/dist/errors.cjs +4 -0
- package/dist/errors.cjs.map +1 -1
- package/dist/errors.d.cts +4 -0
- package/dist/errors.d.cts.map +1 -1
- package/dist/errors.d.ts +4 -0
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +4 -0
- package/dist/errors.js.map +1 -1
- package/dist/help.cjs +2 -0
- package/dist/help.cjs.map +1 -1
- package/dist/help.d.cts +3 -0
- package/dist/help.d.cts.map +1 -1
- package/dist/help.d.ts +3 -0
- package/dist/help.d.ts.map +1 -1
- package/dist/help.js +2 -0
- package/dist/help.js.map +1 -1
- package/dist/index.cjs +40 -0
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +40 -0
- package/dist/index.d.cts.map +1 -1
- package/dist/index.d.ts +40 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +40 -0
- package/dist/index.js.map +1 -1
- package/dist/opt.cjs +4 -0
- package/dist/opt.cjs.map +1 -1
- package/dist/opt.d.cts +10 -0
- package/dist/opt.d.cts.map +1 -1
- package/dist/opt.d.ts +10 -0
- package/dist/opt.d.ts.map +1 -1
- package/dist/opt.js +4 -0
- package/dist/opt.js.map +1 -1
- package/dist/osc.cjs +3 -0
- package/dist/osc.cjs.map +1 -1
- package/dist/osc.d.cts +3 -0
- package/dist/osc.d.cts.map +1 -1
- package/dist/osc.d.ts +3 -0
- package/dist/osc.d.ts.map +1 -1
- package/dist/osc.js +3 -0
- package/dist/osc.js.map +1 -1
- package/dist/theme.cjs +18 -11
- package/dist/theme.cjs.map +1 -1
- package/dist/theme.d.cts +18 -1
- package/dist/theme.d.cts.map +1 -1
- package/dist/theme.d.ts +18 -1
- package/dist/theme.d.ts.map +1 -1
- package/dist/theme.js +18 -11
- package/dist/theme.js.map +1 -1
- package/dist/types.d.cts +70 -7
- package/dist/types.d.cts.map +1 -1
- package/dist/types.d.ts +70 -7
- package/dist/types.d.ts.map +1 -1
- package/package.json +19 -4
package/dist/osc.d.cts
CHANGED
|
@@ -17,6 +17,7 @@
|
|
|
17
17
|
* supports-hyperlinks package but implemented inline without dependencies.
|
|
18
18
|
*
|
|
19
19
|
* @function
|
|
20
|
+
* @group Terminal
|
|
20
21
|
*/
|
|
21
22
|
export declare const supportsHyperlinks: (stream?: NodeJS.WriteStream) => boolean;
|
|
22
23
|
/**
|
|
@@ -24,6 +25,7 @@ export declare const supportsHyperlinks: (stream?: NodeJS.WriteStream) => boolea
|
|
|
24
25
|
* the URL in supported terminals.
|
|
25
26
|
*
|
|
26
27
|
* @function
|
|
28
|
+
* @group Terminal
|
|
27
29
|
*/
|
|
28
30
|
export declare const link: (text: string, url: string) => string;
|
|
29
31
|
/**
|
|
@@ -31,6 +33,7 @@ export declare const link: (text: string, url: string) => string;
|
|
|
31
33
|
* clickable. Otherwise, text is returned unchanged.
|
|
32
34
|
*
|
|
33
35
|
* @function
|
|
36
|
+
* @group Terminal
|
|
34
37
|
*/
|
|
35
38
|
export declare const linkifyUrls: (text: string, stream?: NodeJS.WriteStream) => string;
|
|
36
39
|
//# sourceMappingURL=osc.d.ts.map
|
package/dist/osc.d.cts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"osc.d.ts","sourceRoot":"","sources":["../src/osc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAqEH
|
|
1
|
+
{"version":3,"file":"osc.d.ts","sourceRoot":"","sources":["../src/osc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAqEH;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAC7B,SAAQ,MAAM,CAAC,WAA4B,KAC1C,OAkHF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,EAAE,KAAK,MAAM,KAAG,MAIhD,CAAC;AAQF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,MAAM,EACZ,SAAQ,MAAM,CAAC,WAA4B,KAC1C,MAMF,CAAC"}
|
package/dist/osc.d.ts
CHANGED
|
@@ -17,6 +17,7 @@
|
|
|
17
17
|
* supports-hyperlinks package but implemented inline without dependencies.
|
|
18
18
|
*
|
|
19
19
|
* @function
|
|
20
|
+
* @group Terminal
|
|
20
21
|
*/
|
|
21
22
|
export declare const supportsHyperlinks: (stream?: NodeJS.WriteStream) => boolean;
|
|
22
23
|
/**
|
|
@@ -24,6 +25,7 @@ export declare const supportsHyperlinks: (stream?: NodeJS.WriteStream) => boolea
|
|
|
24
25
|
* the URL in supported terminals.
|
|
25
26
|
*
|
|
26
27
|
* @function
|
|
28
|
+
* @group Terminal
|
|
27
29
|
*/
|
|
28
30
|
export declare const link: (text: string, url: string) => string;
|
|
29
31
|
/**
|
|
@@ -31,6 +33,7 @@ export declare const link: (text: string, url: string) => string;
|
|
|
31
33
|
* clickable. Otherwise, text is returned unchanged.
|
|
32
34
|
*
|
|
33
35
|
* @function
|
|
36
|
+
* @group Terminal
|
|
34
37
|
*/
|
|
35
38
|
export declare const linkifyUrls: (text: string, stream?: NodeJS.WriteStream) => string;
|
|
36
39
|
//# sourceMappingURL=osc.d.ts.map
|
package/dist/osc.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"osc.d.ts","sourceRoot":"","sources":["../src/osc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAqEH
|
|
1
|
+
{"version":3,"file":"osc.d.ts","sourceRoot":"","sources":["../src/osc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAqEH;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAC7B,SAAQ,MAAM,CAAC,WAA4B,KAC1C,OAkHF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,EAAE,KAAK,MAAM,KAAG,MAIhD,CAAC;AAQF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,MAAM,EACZ,SAAQ,MAAM,CAAC,WAA4B,KAC1C,MAMF,CAAC"}
|
package/dist/osc.js
CHANGED
|
@@ -74,6 +74,7 @@ const parseVersion = (versionString = '') => {
|
|
|
74
74
|
* supports-hyperlinks package but implemented inline without dependencies.
|
|
75
75
|
*
|
|
76
76
|
* @function
|
|
77
|
+
* @group Terminal
|
|
77
78
|
*/
|
|
78
79
|
export const supportsHyperlinks = (stream = process.stdout) => {
|
|
79
80
|
const { CI, CURSOR_TRACE_ID, FORCE_HYPERLINK, NETLIFY, TEAMCITY_VERSION, TERM, TERM_PROGRAM, TERM_PROGRAM_VERSION, VTE_VERSION, } = process.env;
|
|
@@ -167,6 +168,7 @@ export const supportsHyperlinks = (stream = process.stdout) => {
|
|
|
167
168
|
* the URL in supported terminals.
|
|
168
169
|
*
|
|
169
170
|
* @function
|
|
171
|
+
* @group Terminal
|
|
170
172
|
*/
|
|
171
173
|
export const link = (text, url) => {
|
|
172
174
|
const openLink = wrapOsc(`${OSC}8${SEP}${SEP}${url}${BEL}`);
|
|
@@ -183,6 +185,7 @@ const URL_PATTERN = /https?:\/\/[^\s<>"\])}]+/g;
|
|
|
183
185
|
* clickable. Otherwise, text is returned unchanged.
|
|
184
186
|
*
|
|
185
187
|
* @function
|
|
188
|
+
* @group Terminal
|
|
186
189
|
*/
|
|
187
190
|
export const linkifyUrls = (text, stream = process.stdout) => {
|
|
188
191
|
if (!supportsHyperlinks(stream)) {
|
package/dist/osc.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"osc.js","sourceRoot":"","sources":["../src/osc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC;;GAEG;AACH,MAAM,GAAG,GAAG,OAAO,CAAC;AAEpB;;GAEG;AACH,MAAM,GAAG,GAAG,MAAM,CAAC;AAEnB;;GAEG;AACH,MAAM,GAAG,GAAG,GAAG,CAAC;AAEhB;;;;GAIG;AACH,MAAM,MAAM,GAAG,GAAY,EAAE,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,OAAO,GAAG,CAAC,QAAgB,EAAU,EAAE;IAC3C,IAAI,MAAM,EAAE,EAAE,CAAC;QACb,OAAO,YAAY,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC;IAC3E,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,YAAY,GAAG,CACnB,aAAa,GAAG,EAAE,EAC+B,EAAE;IACnD,uDAAuD;IACvD,IAAI,WAAW,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;QAC3D,OAAO;YACL,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC;YAC3C,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC;SAC5C,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC;SACnC,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACtC,OAAO;QACL,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;QACvB,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;QACvB,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;KACxB,CAAC;AACJ,CAAC,CAAC;AAEF
|
|
1
|
+
{"version":3,"file":"osc.js","sourceRoot":"","sources":["../src/osc.ts"],"names":[],"mappings":"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"}
|
package/dist/theme.cjs
CHANGED
|
@@ -15,7 +15,7 @@ const node_util_1 = require("node:util");
|
|
|
15
15
|
/**
|
|
16
16
|
* Strip all ANSI escape codes from a string.
|
|
17
17
|
*
|
|
18
|
-
* @
|
|
18
|
+
* @group Terminal
|
|
19
19
|
*/
|
|
20
20
|
exports.stripAnsi = node_util_1.stripVTControlCharacters;
|
|
21
21
|
/**
|
|
@@ -23,6 +23,8 @@ exports.stripAnsi = node_util_1.stripVTControlCharacters;
|
|
|
23
23
|
*
|
|
24
24
|
* Includes text styles (bold, italic, underline, etc.), foreground colors,
|
|
25
25
|
* bright foreground colors, background colors, and bright background colors.
|
|
26
|
+
*
|
|
27
|
+
* @group Theming
|
|
26
28
|
*/
|
|
27
29
|
exports.ansi = {
|
|
28
30
|
bgBlack: '\x1b[40m',
|
|
@@ -70,16 +72,16 @@ exports.ansi = {
|
|
|
70
72
|
* Default color values used when theme colors are not specified.
|
|
71
73
|
*/
|
|
72
74
|
const defaultColors = {
|
|
73
|
-
command: exports.ansi.bold,
|
|
74
|
-
commandAlias: exports.ansi.
|
|
75
|
-
defaultText: exports.ansi.
|
|
76
|
-
defaultValue: exports.ansi.
|
|
77
|
-
description:
|
|
78
|
-
epilog: exports.ansi.
|
|
79
|
-
example: exports.ansi.
|
|
80
|
-
flag: exports.ansi.
|
|
81
|
-
positional: exports.ansi.
|
|
82
|
-
scriptName: exports.ansi.bold,
|
|
75
|
+
command: exports.ansi.bold + exports.ansi.magenta,
|
|
76
|
+
commandAlias: exports.ansi.magenta,
|
|
77
|
+
defaultText: exports.ansi.yellow,
|
|
78
|
+
defaultValue: exports.ansi.green,
|
|
79
|
+
description: '',
|
|
80
|
+
epilog: exports.ansi.yellow,
|
|
81
|
+
example: exports.ansi.green,
|
|
82
|
+
flag: exports.ansi.cyan,
|
|
83
|
+
positional: exports.ansi.brightMagenta,
|
|
84
|
+
scriptName: exports.ansi.bold + exports.ansi.brightMagenta,
|
|
83
85
|
sectionHeader: exports.ansi.brightMagenta,
|
|
84
86
|
type: exports.ansi.magenta,
|
|
85
87
|
url: exports.ansi.cyan,
|
|
@@ -87,6 +89,8 @@ const defaultColors = {
|
|
|
87
89
|
};
|
|
88
90
|
/**
|
|
89
91
|
* Built-in themes.
|
|
92
|
+
*
|
|
93
|
+
* @group Theming
|
|
90
94
|
*/
|
|
91
95
|
exports.themes = {
|
|
92
96
|
/** Default colorful theme */
|
|
@@ -153,6 +157,8 @@ exports.themes = {
|
|
|
153
157
|
};
|
|
154
158
|
/**
|
|
155
159
|
* Default theme export for convenience.
|
|
160
|
+
*
|
|
161
|
+
* @group Theming
|
|
156
162
|
*/
|
|
157
163
|
exports.defaultTheme = exports.themes.default;
|
|
158
164
|
/**
|
|
@@ -192,6 +198,7 @@ const makeStyleFn = (color) => {
|
|
|
192
198
|
* to the default theme.
|
|
193
199
|
*
|
|
194
200
|
* @function
|
|
201
|
+
* @group Theming
|
|
195
202
|
*/
|
|
196
203
|
const createStyler = (theme) => {
|
|
197
204
|
const resolved = (0, exports.getTheme)(theme);
|
package/dist/theme.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"theme.js","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,yCAAqD;AAErD;;;;GAIG;AACU,QAAA,SAAS,GAAG,oCAAwB,CAAC;
|
|
1
|
+
{"version":3,"file":"theme.js","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"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"}
|
package/dist/theme.d.cts
CHANGED
|
@@ -12,12 +12,14 @@ import { stripVTControlCharacters } from 'node:util';
|
|
|
12
12
|
/**
|
|
13
13
|
* Strip all ANSI escape codes from a string.
|
|
14
14
|
*
|
|
15
|
-
* @
|
|
15
|
+
* @group Terminal
|
|
16
16
|
*/
|
|
17
17
|
export declare const stripAnsi: typeof stripVTControlCharacters;
|
|
18
18
|
/**
|
|
19
19
|
* A bargs color theme. All color properties are optional and fall back to the
|
|
20
20
|
* default theme.
|
|
21
|
+
*
|
|
22
|
+
* @group Theming
|
|
21
23
|
*/
|
|
22
24
|
export interface Theme {
|
|
23
25
|
colors?: Partial<ThemeColors>;
|
|
@@ -25,6 +27,8 @@ export interface Theme {
|
|
|
25
27
|
/**
|
|
26
28
|
* Color codes for each semantic element in help output. Empty string means no
|
|
27
29
|
* color (passthrough).
|
|
30
|
+
*
|
|
31
|
+
* @group Theming
|
|
28
32
|
*/
|
|
29
33
|
export interface ThemeColors {
|
|
30
34
|
/** Command names (e.g., "init", "build") */
|
|
@@ -58,6 +62,8 @@ export interface ThemeColors {
|
|
|
58
62
|
}
|
|
59
63
|
/**
|
|
60
64
|
* Theme input - either a theme name or a custom Theme object.
|
|
65
|
+
*
|
|
66
|
+
* @group Theming
|
|
61
67
|
*/
|
|
62
68
|
export type ThemeInput = keyof typeof themes | Theme;
|
|
63
69
|
/**
|
|
@@ -71,6 +77,8 @@ interface ResolvedTheme {
|
|
|
71
77
|
*
|
|
72
78
|
* Includes text styles (bold, italic, underline, etc.), foreground colors,
|
|
73
79
|
* bright foreground colors, background colors, and bright background colors.
|
|
80
|
+
*
|
|
81
|
+
* @group Theming
|
|
74
82
|
*/
|
|
75
83
|
export declare const ansi: {
|
|
76
84
|
readonly bgBlack: "\u001B[40m";
|
|
@@ -116,6 +124,8 @@ export declare const ansi: {
|
|
|
116
124
|
};
|
|
117
125
|
/**
|
|
118
126
|
* Built-in themes.
|
|
127
|
+
*
|
|
128
|
+
* @group Theming
|
|
119
129
|
*/
|
|
120
130
|
export declare const themes: {
|
|
121
131
|
/** Default colorful theme */
|
|
@@ -197,6 +207,8 @@ export declare const themes: {
|
|
|
197
207
|
};
|
|
198
208
|
/**
|
|
199
209
|
* Default theme export for convenience.
|
|
210
|
+
*
|
|
211
|
+
* @group Theming
|
|
200
212
|
*/
|
|
201
213
|
export declare const defaultTheme: {
|
|
202
214
|
readonly colors: {
|
|
@@ -225,10 +237,14 @@ export declare const defaultTheme: {
|
|
|
225
237
|
export declare const getTheme: (input: ThemeInput) => ResolvedTheme;
|
|
226
238
|
/**
|
|
227
239
|
* Style function that wraps text with ANSI codes.
|
|
240
|
+
*
|
|
241
|
+
* @group Theming
|
|
228
242
|
*/
|
|
229
243
|
export type StyleFn = (text: string) => string;
|
|
230
244
|
/**
|
|
231
245
|
* Styler object with methods for each semantic element.
|
|
246
|
+
*
|
|
247
|
+
* @group Theming
|
|
232
248
|
*/
|
|
233
249
|
export interface Styler {
|
|
234
250
|
command: StyleFn;
|
|
@@ -251,6 +267,7 @@ export interface Styler {
|
|
|
251
267
|
* to the default theme.
|
|
252
268
|
*
|
|
253
269
|
* @function
|
|
270
|
+
* @group Theming
|
|
254
271
|
*/
|
|
255
272
|
export declare const createStyler: (theme: Theme) => Styler;
|
|
256
273
|
export {};
|
package/dist/theme.d.cts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,SAAS,iCAA2B,CAAC;AAElD
|
|
1
|
+
{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"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"}
|
package/dist/theme.d.ts
CHANGED
|
@@ -12,12 +12,14 @@ import { stripVTControlCharacters } from 'node:util';
|
|
|
12
12
|
/**
|
|
13
13
|
* Strip all ANSI escape codes from a string.
|
|
14
14
|
*
|
|
15
|
-
* @
|
|
15
|
+
* @group Terminal
|
|
16
16
|
*/
|
|
17
17
|
export declare const stripAnsi: typeof stripVTControlCharacters;
|
|
18
18
|
/**
|
|
19
19
|
* A bargs color theme. All color properties are optional and fall back to the
|
|
20
20
|
* default theme.
|
|
21
|
+
*
|
|
22
|
+
* @group Theming
|
|
21
23
|
*/
|
|
22
24
|
export interface Theme {
|
|
23
25
|
colors?: Partial<ThemeColors>;
|
|
@@ -25,6 +27,8 @@ export interface Theme {
|
|
|
25
27
|
/**
|
|
26
28
|
* Color codes for each semantic element in help output. Empty string means no
|
|
27
29
|
* color (passthrough).
|
|
30
|
+
*
|
|
31
|
+
* @group Theming
|
|
28
32
|
*/
|
|
29
33
|
export interface ThemeColors {
|
|
30
34
|
/** Command names (e.g., "init", "build") */
|
|
@@ -58,6 +62,8 @@ export interface ThemeColors {
|
|
|
58
62
|
}
|
|
59
63
|
/**
|
|
60
64
|
* Theme input - either a theme name or a custom Theme object.
|
|
65
|
+
*
|
|
66
|
+
* @group Theming
|
|
61
67
|
*/
|
|
62
68
|
export type ThemeInput = keyof typeof themes | Theme;
|
|
63
69
|
/**
|
|
@@ -71,6 +77,8 @@ interface ResolvedTheme {
|
|
|
71
77
|
*
|
|
72
78
|
* Includes text styles (bold, italic, underline, etc.), foreground colors,
|
|
73
79
|
* bright foreground colors, background colors, and bright background colors.
|
|
80
|
+
*
|
|
81
|
+
* @group Theming
|
|
74
82
|
*/
|
|
75
83
|
export declare const ansi: {
|
|
76
84
|
readonly bgBlack: "\u001B[40m";
|
|
@@ -116,6 +124,8 @@ export declare const ansi: {
|
|
|
116
124
|
};
|
|
117
125
|
/**
|
|
118
126
|
* Built-in themes.
|
|
127
|
+
*
|
|
128
|
+
* @group Theming
|
|
119
129
|
*/
|
|
120
130
|
export declare const themes: {
|
|
121
131
|
/** Default colorful theme */
|
|
@@ -197,6 +207,8 @@ export declare const themes: {
|
|
|
197
207
|
};
|
|
198
208
|
/**
|
|
199
209
|
* Default theme export for convenience.
|
|
210
|
+
*
|
|
211
|
+
* @group Theming
|
|
200
212
|
*/
|
|
201
213
|
export declare const defaultTheme: {
|
|
202
214
|
readonly colors: {
|
|
@@ -225,10 +237,14 @@ export declare const defaultTheme: {
|
|
|
225
237
|
export declare const getTheme: (input: ThemeInput) => ResolvedTheme;
|
|
226
238
|
/**
|
|
227
239
|
* Style function that wraps text with ANSI codes.
|
|
240
|
+
*
|
|
241
|
+
* @group Theming
|
|
228
242
|
*/
|
|
229
243
|
export type StyleFn = (text: string) => string;
|
|
230
244
|
/**
|
|
231
245
|
* Styler object with methods for each semantic element.
|
|
246
|
+
*
|
|
247
|
+
* @group Theming
|
|
232
248
|
*/
|
|
233
249
|
export interface Styler {
|
|
234
250
|
command: StyleFn;
|
|
@@ -251,6 +267,7 @@ export interface Styler {
|
|
|
251
267
|
* to the default theme.
|
|
252
268
|
*
|
|
253
269
|
* @function
|
|
270
|
+
* @group Theming
|
|
254
271
|
*/
|
|
255
272
|
export declare const createStyler: (theme: Theme) => Styler;
|
|
256
273
|
export {};
|
package/dist/theme.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,SAAS,iCAA2B,CAAC;AAElD
|
|
1
|
+
{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"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"}
|
package/dist/theme.js
CHANGED
|
@@ -12,7 +12,7 @@ import { stripVTControlCharacters } from 'node:util';
|
|
|
12
12
|
/**
|
|
13
13
|
* Strip all ANSI escape codes from a string.
|
|
14
14
|
*
|
|
15
|
-
* @
|
|
15
|
+
* @group Terminal
|
|
16
16
|
*/
|
|
17
17
|
export const stripAnsi = stripVTControlCharacters;
|
|
18
18
|
/**
|
|
@@ -20,6 +20,8 @@ export const stripAnsi = stripVTControlCharacters;
|
|
|
20
20
|
*
|
|
21
21
|
* Includes text styles (bold, italic, underline, etc.), foreground colors,
|
|
22
22
|
* bright foreground colors, background colors, and bright background colors.
|
|
23
|
+
*
|
|
24
|
+
* @group Theming
|
|
23
25
|
*/
|
|
24
26
|
export const ansi = {
|
|
25
27
|
bgBlack: '\x1b[40m',
|
|
@@ -67,16 +69,16 @@ export const ansi = {
|
|
|
67
69
|
* Default color values used when theme colors are not specified.
|
|
68
70
|
*/
|
|
69
71
|
const defaultColors = {
|
|
70
|
-
command: ansi.bold,
|
|
71
|
-
commandAlias: ansi.
|
|
72
|
-
defaultText: ansi.
|
|
73
|
-
defaultValue: ansi.
|
|
74
|
-
description:
|
|
75
|
-
epilog: ansi.
|
|
76
|
-
example: ansi.
|
|
77
|
-
flag: ansi.
|
|
78
|
-
positional: ansi.
|
|
79
|
-
scriptName: ansi.bold,
|
|
72
|
+
command: ansi.bold + ansi.magenta,
|
|
73
|
+
commandAlias: ansi.magenta,
|
|
74
|
+
defaultText: ansi.yellow,
|
|
75
|
+
defaultValue: ansi.green,
|
|
76
|
+
description: '',
|
|
77
|
+
epilog: ansi.yellow,
|
|
78
|
+
example: ansi.green,
|
|
79
|
+
flag: ansi.cyan,
|
|
80
|
+
positional: ansi.brightMagenta,
|
|
81
|
+
scriptName: ansi.bold + ansi.brightMagenta,
|
|
80
82
|
sectionHeader: ansi.brightMagenta,
|
|
81
83
|
type: ansi.magenta,
|
|
82
84
|
url: ansi.cyan,
|
|
@@ -84,6 +86,8 @@ const defaultColors = {
|
|
|
84
86
|
};
|
|
85
87
|
/**
|
|
86
88
|
* Built-in themes.
|
|
89
|
+
*
|
|
90
|
+
* @group Theming
|
|
87
91
|
*/
|
|
88
92
|
export const themes = {
|
|
89
93
|
/** Default colorful theme */
|
|
@@ -150,6 +154,8 @@ export const themes = {
|
|
|
150
154
|
};
|
|
151
155
|
/**
|
|
152
156
|
* Default theme export for convenience.
|
|
157
|
+
*
|
|
158
|
+
* @group Theming
|
|
153
159
|
*/
|
|
154
160
|
export const defaultTheme = themes.default;
|
|
155
161
|
/**
|
|
@@ -188,6 +194,7 @@ const makeStyleFn = (color) => {
|
|
|
188
194
|
* to the default theme.
|
|
189
195
|
*
|
|
190
196
|
* @function
|
|
197
|
+
* @group Theming
|
|
191
198
|
*/
|
|
192
199
|
export const createStyler = (theme) => {
|
|
193
200
|
const resolved = getTheme(theme);
|
package/dist/theme.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"theme.js","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAErD;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,wBAAwB,CAAC;
|
|
1
|
+
{"version":3,"file":"theme.js","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"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"}
|