massarg 1.0.7-pre.1 → 2.0.0-pre.10

package/option.js

@@ -0,0 +1,308 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MassargHelpFlag = exports.MassargFlag = exports.MassargNumber = exports.MassargOption = exports.NEGATE_SHORT_PREFIX = exports.NEGATE_FULL_PREFIX = exports.OPT_SHORT_PREFIX = exports.OPT_FULL_PREFIX = exports.ArrayOptionConfig = exports.TypedOptionConfig = exports.FlagConfig = exports.OptionConfig = void 0;
+const zod_1 = require("zod");
+const error_1 = require("./error");
+const utils_1 = require("./utils");
+const OptionConfig = (type) => zod_1.z.object({
+    /** Name of the option */
+    name: zod_1.z.string(),
+    /** Description of the option, displayed in the help output */
+    description: zod_1.z.string(),
+    /** Default value of the option */
+    defaultValue: zod_1.z.any().optional(),
+    /** Aliases for the option, which can be used with the shorthand option notation. */
+    aliases: zod_1.z.string().array(),
+    /**
+     * Parse the value of the option. You can return any type here, or throw an error if the value
+     * is invalid.
+     */
+    parse: zod_1.z.function().args(zod_1.z.string(), zod_1.z.any()).returns(type).optional(),
+    /**
+     * Whether the option is an array.
+     *
+     * Array options can be specified multiple times, and the values will be collected into an array.
+     *
+     * Normally, specifying an option multiple times will override the previous value.
+     */
+    array: zod_1.z.boolean().optional(),
+    /** Whether the option is required. If it is required, parsing will throw an error if it's not
+     * present.
+     */
+    required: zod_1.z.boolean().optional(),
+    /** Whether the option is the default option. The default option is the option that is used if
+     * no other option is specified, e.g. a value is passed in without an option name.
+     *
+     * Note that if commands match the same argument first, they will be used instead of the default
+     * option.
+     */
+    isDefault: zod_1.z.boolean().optional(),
+    /** Whether the option is hidden. Hidden options are not displayed in the help output. */
+    hidden: zod_1.z.boolean().optional(),
+    /** Specify a custom name for the output, which will be used when parsing the args. */
+    outputName: zod_1.z.string().optional(),
+});
+exports.OptionConfig = OptionConfig;
+exports.FlagConfig = (0, exports.OptionConfig)(zod_1.z.any())
+    .omit({ parse: true, isDefault: true })
+    .merge(zod_1.z.object({
+    /** Whether the flag can be negated, e.g. `--no-verbose` */
+    negatable: zod_1.z.boolean().optional(),
+}));
+const TypedOptionConfig = (type) => (0, exports.OptionConfig)(type).merge(zod_1.z.object({
+    type: zod_1.z.enum(['number']).optional(),
+}));
+exports.TypedOptionConfig = TypedOptionConfig;
+/**
+ * @see OptionConfig
+ * @see ArrayOptionConfig
+ */
+const ArrayOptionConfig = (type) => (0, exports.TypedOptionConfig)(zod_1.z.array(type)).merge(
+// OptionConfig(z.array(type)).merge(
+zod_1.z.object({
+    defaultValue: zod_1.z.array(type).optional(),
+}));
+exports.ArrayOptionConfig = ArrayOptionConfig;
+// TODO turn to options
+exports.OPT_FULL_PREFIX = '--';
+exports.OPT_SHORT_PREFIX = '-';
+exports.NEGATE_FULL_PREFIX = '--no-';
+exports.NEGATE_SHORT_PREFIX = '^';
+/**
+ * An option that can be passed to a command.
+ *
+ * Options can be specified in two ways:
+ *
+ * - Using the long form, e.g. `--option value`
+ * - Using the short form, e.g. `-o value`
+ *
+ * They can also have a parse function, which will be used to parse the value passed in from the
+ * original argument (string).
+ *
+ * @example
+ * ```ts
+ * massarg(options).option({
+ *   name: 'option',
+ *   description: 'An option',
+ *   defaultValue: 'default',
+ *   aliases: ['o'],
+ *   parse: (value) => value.toUpperCase(),
+ * })
+ * ```
+ */
+class MassargOption {
+    constructor(options) {
+        (0, exports.OptionConfig)(zod_1.z.any()).parse(options);
+        this.name = options.name;
+        this.description = options.description;
+        this.defaultValue = options.defaultValue;
+        this.aliases = options.aliases;
+        this.parse = options.parse ?? ((x) => x);
+        this.isArray = options.array ?? false;
+        this.isDefault = options.isDefault ?? false;
+        this.isRequired = options.required ?? false;
+        this.outputName = options.outputName;
+    }
+    static fromTypedConfig(config) {
+        switch (config.type) {
+            case 'number':
+                return new MassargNumber(config);
+        }
+        return new MassargOption(config);
+    }
+    getOutputName() {
+        return this.outputName || (0, utils_1.toCamelCase)(this.name);
+    }
+    parseDetails(argv, options, prefixes) {
+        let input = '';
+        try {
+            if (!this.isMatch(argv[0], prefixes)) {
+                throw new error_1.ParseError({
+                    path: [this.name],
+                    code: 'invalid_option',
+                    message: `Expected option ${this.name}`,
+                    received: JSON.stringify(argv[0]),
+                });
+            }
+            argv.shift();
+            input = argv.shift();
+            const value = this.parse(input, options);
+            return { key: this.getOutputName(), value, argv };
+        }
+        catch (e) {
+            if ((0, error_1.isZodError)(e)) {
+                throw new error_1.ParseError({
+                    path: [this.name, ...e.issues[0].path.map((p) => p.toString())],
+                    code: e.issues[0].code,
+                    message: e.issues[0].message,
+                    received: JSON.stringify(input),
+                });
+            }
+            throw e;
+        }
+    }
+    helpString() {
+        const aliases = this.aliases.length ? `|${this.aliases.join('|-')}` : '';
+        return `--${this.name}${aliases} ${this.description}`;
+    }
+    /** Returns true if the flag (including any prefixes) matches the name or aliases */
+    isMatch(arg, prefixes) {
+        const name = MassargOption.findNameInArg(arg, prefixes);
+        return name === this.name || this.aliases.includes(name);
+    }
+    /**
+     * Returns the name of the flag, removing any prefixes. It is discriminate of if the option
+     * exists, as it is a static method; it only returns the name of the flag if it matches the
+     * prefixes format.
+     */
+    static findNameInArg(arg, prefixes) {
+        const { optionPrefix, aliasPrefix, negateFlagPrefix, negateAliasPrefix } = prefixes;
+        // negate full prefix
+        if (arg.startsWith(negateFlagPrefix)) {
+            return arg.slice(negateFlagPrefix.length);
+        }
+        if (arg.startsWith(optionPrefix)) {
+            return arg.slice(optionPrefix.length);
+        }
+        // negate short prefix
+        if (arg.startsWith(negateAliasPrefix)) {
+            return arg.slice(negateAliasPrefix.length);
+        }
+        // short prefix
+        if (arg.startsWith(aliasPrefix) || arg.startsWith(negateAliasPrefix)) {
+            return arg.slice(aliasPrefix.length);
+        }
+        return '<blank>';
+    }
+}
+exports.MassargOption = MassargOption;
+/**
+ * An option that can be passed to a command.
+ *
+ * This type of option parses a number, and fails if it is not a valid number.
+ *
+ * @example
+ * ```ts
+ * massarg(options).option({
+ *   name: 'number',
+ *   description: 'A number',
+ *   defaultValue: 0,
+ *   aliases: ['n'],
+ *   type: 'number',
+ * })
+ * ```
+ */
+class MassargNumber extends MassargOption {
+    constructor(options) {
+        super({
+            ...options,
+            parse: (value) => Number(value),
+        });
+    }
+    parseDetails(argv, options, prefixes) {
+        try {
+            const { argv: _argv, value } = super.parseDetails(argv, options, prefixes);
+            if (isNaN(value)) {
+                throw new error_1.ParseError({
+                    path: [this.name],
+                    code: 'invalid_type',
+                    message: 'Expected a number',
+                    received: JSON.stringify(argv[0]),
+                });
+            }
+            return { key: this.name, value, argv: _argv };
+        }
+        catch (e) {
+            if ((0, error_1.isZodError)(e)) {
+                throw new error_1.ParseError({
+                    path: [this.name, ...e.issues[0].path.map((p) => p.toString())],
+                    code: e.issues[0].code,
+                    message: e.issues[0].message,
+                    received: JSON.stringify(argv[0]),
+                });
+            }
+            throw e;
+        }
+    }
+}
+exports.MassargNumber = MassargNumber;
+/**
+ * An option that can be passed to a command.
+ *
+ * A flag is an option that is either present or not. It can be used to toggle
+ * a boolean value, or to indicate that a command should be run in a different
+ * mode.
+ *
+ * A flag can be negated by prefixing it with `no-`. For example, `--no-verbose`,
+ * or by prefixing the alias with `^` instead of `-`. This is configurable via the command's
+ * configuration. To turn this behavior on, set `negatable: true` in the flag's configuration.
+ *
+ * @example
+ * ```ts
+ * massarg.flag({
+ *   name: 'verbose',
+ *   aliases: ['v'],
+ *   description: 'Enable verbose logging',
+ *   defaultValue: false,
+ * })
+ * ```
+ */
+class MassargFlag extends MassargOption {
+    constructor(options) {
+        super({
+            ...options,
+            parse: () => true,
+        });
+        this.negatable = options.negatable ?? false;
+    }
+    parseDetails(argv, _options, prefixes) {
+        try {
+            const isNegation = argv[0]?.startsWith(prefixes.negateAliasPrefix) ||
+                argv[0]?.startsWith(prefixes.negateFlagPrefix);
+            if (!this.negatable && isNegation) {
+                throw new error_1.ParseError({
+                    path: [this.name],
+                    code: 'invalid_option',
+                    message: `Option ${this.name} cannot be negated`,
+                    received: JSON.stringify(argv[0]),
+                });
+            }
+            if (!this.isMatch(argv[0], prefixes)) {
+                throw new error_1.ParseError({
+                    path: [this.name],
+                    code: 'invalid_option',
+                    message: `Expected option ${this.name}`,
+                    received: JSON.stringify(argv[0]),
+                });
+            }
+            argv.shift();
+            if (isNegation) {
+                return { key: this.getOutputName(), value: false, argv };
+            }
+            return { key: this.getOutputName(), value: true, argv };
+        }
+        catch (e) {
+            if ((0, error_1.isZodError)(e)) {
+                throw new error_1.ParseError({
+                    path: [this.name, ...e.issues[0].path.map((p) => p.toString())],
+                    code: e.issues[0].code,
+                    message: e.issues[0].message,
+                });
+            }
+            throw e;
+        }
+    }
+}
+exports.MassargFlag = MassargFlag;
+class MassargHelpFlag extends MassargFlag {
+    constructor(config = {}) {
+        super({
+            name: 'help',
+            description: 'Show this help message',
+            aliases: ['h'],
+            ...config,
+        });
+    }
+}
+exports.MassargHelpFlag = MassargHelpFlag;
+//# sourceMappingURL=option.js.map

package/option.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"option.js","sourceRoot":"","sources":["../src/option.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "massarg",
-  "version": "1.0.7-pre.1",
+  "version": "2.0.0-pre.10",
   "description": "Flexible, powerful, and simple command/argument parser for CLI applications",
   "keywords": [
     "shell",
@@ -15,23 +15,30 @@
   "author": "Chen Asraf <chenasrafil@gmail.com>",
   "license": "Apache",
   "scripts": {
-    "clean": "rm -rf build",
-    "build": "yarn clean && tsc -p tsconfig.build.json && cp package.json README.md build",
-    "develop": "tsc --watch",
-    "sample": "node build/sample.js",
-    "test": "jest"
+    "build": "tsc -p tsconfig.build.json && cp package.json README.md build",
+    "dev": "tsc --watch",
+    "cmd": "ts-node src/sample.ts",
+    "test": "jest",
+    "doc": "typedoc",
+    "deploy-doc": "pnpm doc && gh-pages -d docs",
+    "semantic-release": "semantic-release"
   },
   "devDependencies": {
-    "@types/jest": "^27.0.3",
-    "@types/lodash": "^4.14.177",
-    "@types/node": "^16.11.11",
-    "jest": "^27.4.3",
-    "ts-jest": "^27.0.7",
-    "ts-node": "^10.1.0",
-    "typescript": "^4.5.2"
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/exec": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@types/jest": "^29.5.8",
+    "@types/node": "^20.9.2",
+    "gh-pages": "^6.1.0",
+    "jest": "^29.7.0",
+    "semantic-release": "^22.0.8",
+    "ts-jest": "^29.1.1",
+    "ts-node": "^10.9.1",
+    "typedoc": "^0.25.3",
+    "typedoc-plugin-zod": "^1.1.0",
+    "typescript": "^5.2.2"
   },
   "dependencies": {
-    "chalk": "^4.1.2",
-    "lodash": "^4.17.21"
+    "zod": "^3.22.4"
   }
 }

package/style.d.ts

@@ -0,0 +1,46 @@
+import z from 'zod';
+export { strConcat, indent } from './utils';
+export declare const ansiStyles: {
+    reset: string;
+    bold: string;
+    underline: string;
+    black: string;
+};
+export declare const ansiColors: {
+    red: string;
+    green: string;
+    yellow: string;
+    blue: string;
+    magenta: string;
+    cyan: string;
+    white: string;
+    gray: string;
+    grey: string;
+    brightRed: string;
+    brightGreen: string;
+    brightYellow: string;
+    brightBlue: string;
+    brightMagenta: string;
+    brightCyan: string;
+    brightWhite: string;
+};
+export declare const StringStyle: z.ZodObject<{
+    bold: z.ZodOptional<z.ZodBoolean>;
+    underline: z.ZodOptional<z.ZodBoolean>;
+    color: z.ZodOptional<z.ZodEnum<["red" | "green" | "yellow" | "blue" | "magenta" | "cyan" | "white" | "gray" | "grey" | "brightRed" | "brightGreen" | "brightYellow" | "brightBlue" | "brightMagenta" | "brightCyan" | "brightWhite", ...("red" | "green" | "yellow" | "blue" | "magenta" | "cyan" | "white" | "gray" | "grey" | "brightRed" | "brightGreen" | "brightYellow" | "brightBlue" | "brightMagenta" | "brightCyan" | "brightWhite")[]]>>;
+    reset: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    bold?: boolean | undefined;
+    underline?: boolean | undefined;
+    color?: "red" | "green" | "yellow" | "blue" | "magenta" | "cyan" | "white" | "gray" | "grey" | "brightRed" | "brightGreen" | "brightYellow" | "brightBlue" | "brightMagenta" | "brightCyan" | "brightWhite" | undefined;
+    reset?: boolean | undefined;
+}, {
+    bold?: boolean | undefined;
+    underline?: boolean | undefined;
+    color?: "red" | "green" | "yellow" | "blue" | "magenta" | "cyan" | "white" | "gray" | "grey" | "brightRed" | "brightGreen" | "brightYellow" | "brightBlue" | "brightMagenta" | "brightCyan" | "brightWhite" | undefined;
+    reset?: boolean | undefined;
+}>;
+export type StringStyle = z.infer<typeof StringStyle>;
+export declare function format(string: string, style?: StringStyle): string;
+export declare function stripStyle(string: string): string;
+//# sourceMappingURL=style.d.ts.map

package/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../src/style.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAA;AAEnB,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAE3C,eAAO,MAAM,UAAU;;;;;CAKtB,CAAA;AAED,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;CAiBtB,CAAA;AAED,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;EAKtB,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;AAErD,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,WAAgB,GAAG,MAAM,CAOtE;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/style.js

@@ -0,0 +1,55 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripStyle = exports.format = exports.StringStyle = exports.ansiColors = exports.ansiStyles = exports.indent = exports.strConcat = void 0;
+const zod_1 = __importDefault(require("zod"));
+const utils_1 = require("./utils");
+var utils_2 = require("./utils");
+Object.defineProperty(exports, "strConcat", { enumerable: true, get: function () { return utils_2.strConcat; } });
+Object.defineProperty(exports, "indent", { enumerable: true, get: function () { return utils_2.indent; } });
+exports.ansiStyles = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    underline: '\x1b[4m',
+    black: '\x1b[30m',
+};
+exports.ansiColors = {
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    magenta: '\x1b[35m',
+    cyan: '\x1b[36m',
+    white: '\x1b[37m',
+    gray: '\x1b[90m',
+    grey: '\x1b[90m',
+    brightRed: '\x1b[91m',
+    brightGreen: '\x1b[92m',
+    brightYellow: '\x1b[93m',
+    brightBlue: '\x1b[94m',
+    brightMagenta: '\x1b[95m',
+    brightCyan: '\x1b[96m',
+    brightWhite: '\x1b[97m',
+};
+exports.StringStyle = zod_1.default.object({
+    bold: zod_1.default.boolean().optional(),
+    underline: zod_1.default.boolean().optional(),
+    color: (0, utils_1.zodEnumFromObjKeys)(exports.ansiColors).optional(),
+    reset: zod_1.default.boolean().default(true).optional(),
+});
+function format(string, style = {}) {
+    const { color, bold, underline, reset = true } = style;
+    const colorCode = color ? exports.ansiColors[color] : '';
+    const boldCode = bold ? exports.ansiStyles.bold : '';
+    const underlineCode = underline ? exports.ansiStyles.underline : '';
+    const resetCode = reset ? exports.ansiStyles.reset : '';
+    return `${colorCode}${boldCode}${underlineCode}${string}${resetCode}`;
+}
+exports.format = format;
+function stripStyle(string) {
+    return string.replace(/\x1b\[\d+m/gi, '');
+}
+exports.stripStyle = stripStyle;
+//# sourceMappingURL=style.js.map

package/style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.js","sourceRoot":"","sources":["../src/style.ts"],"names":[],"mappings":";;;;;;AAAA,8CAAmB;AACnB,mCAA4C;AAC5C,iCAA2C;AAAlC,kGAAA,SAAS,OAAA;AAAE,+FAAA,MAAM,OAAA;AAEb,QAAA,UAAU,GAAG;IACxB,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,SAAS,EAAE,SAAS;IACpB,KAAK,EAAE,UAAU;CAClB,CAAA;AAEY,QAAA,UAAU,GAAG;IACxB,GAAG,EAAE,UAAU;IACf,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,UAAU;IACnB,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,UAAU;IACjB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,UAAU;IAChB,SAAS,EAAE,UAAU;IACrB,WAAW,EAAE,UAAU;IACvB,YAAY,EAAE,UAAU;IACxB,UAAU,EAAE,UAAU;IACtB,aAAa,EAAE,UAAU;IACzB,UAAU,EAAE,UAAU;IACtB,WAAW,EAAE,UAAU;CACxB,CAAA;AAEY,QAAA,WAAW,GAAG,aAAC,CAAC,MAAM,CAAC;IAClC,IAAI,EAAE,aAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC5B,SAAS,EAAE,aAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjC,KAAK,EAAE,IAAA,0BAAkB,EAAC,kBAAU,CAAC,CAAC,QAAQ,EAAE;IAChD,KAAK,EAAE,aAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;CAC5C,CAAC,CAAA;AAIF,SAAgB,MAAM,CAAC,MAAc,EAAE,QAAqB,EAAE;IAC5D,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,KAAK,CAAA;IACtD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,kBAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,kBAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAA;IAC5C,MAAM,aAAa,GAAG,SAAS,CAAC,CAAC,CAAC,kBAAU,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAA;IAC3D,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,kBAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;IAC/C,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,aAAa,GAAG,MAAM,GAAG,SAAS,EAAE,CAAA;AACvE,CAAC;AAPD,wBAOC;AAED,SAAgB,UAAU,CAAC,MAAc;IACvC,OAAO,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAA;AAC3C,CAAC;AAFD,gCAEC"}

package/utils.d.ts

@@ -1,14 +1,36 @@
-import chalk from "chalk";
-export declare function color(color: ArrayOr<keyof typeof chalk>, ...text: any[]): string;
-export declare function colorCount(...colors: any[]): number;
-export interface WrapOptions {
-    indent?: number;
-    firstLineIndent?: number;
-    printWidth?: number;
-    colorCount?: number;
-}
-export declare function wrap(text: string, options?: WrapOptions): string[];
-export declare const COLOR_CODE_LEN: number;
-export declare type ArrayOr<T> = T | T[];
-export declare function asArray<T>(obj: T | T[]): T[];
+import z from 'zod';
+/** @internal */
+export declare function setOrPush<T>(newValue: unknown, currentValue: T[] | T | undefined, isArray: boolean): T;
+type Parseable = string | number | boolean | null | undefined | Record<string, unknown>;
+/** A type that makes all properties of an object required, recursively. */
+export type DeepRequired<T> = {
+    [P in keyof T]-?: T[P] extends object ? DeepRequired<T[P]> : NonNullable<T[P]>;
+};
+/**
+ * Concatenates strings, arrays of strings, and objects with truthy values.
+ *
+ * It works recursively, so adding an array of strings to an array of strings will work.
+ *
+ * Falsy values are ignored, so pasing `undefined` or `null` will not add anything to the result,
+ * and using a boolean will only add it if it is `true`. Using 0 will also not add anything.
+ */
+export declare function strConcat(...strs: (Parseable | Parseable[])[]): string;
+/**
+ * Indents a string or an array of strings. Concatenates them all using `strConcat`.
+ */
+export declare function indent(str: Parseable | Parseable[], indent?: number): string;
+/** @internal */
+export declare function zodEnumFromObjKeys<K extends string>(obj: Record<K, any>): z.ZodEnum<[K, ...K[]]>;
+/** @internal */
+export declare function deepMerge<T1, T2>(obj1: T1, obj2: T2): NonNullable<T1> & NonNullable<T2>;
+export declare function capitalize(str: string): string;
+/**
+ * Splits a name into words, using camelCase, PascalCase, snake_case, and kebab-case or
+ * regular spaced strings.
+ */
+export declare function splitWords(str: string): string[];
+export declare function toCamelCase(str: string): string;
+export declare function toPascalCase(str: string): string;
+export declare function getErrorMessage(err: unknown): string;
+export {};
 //# sourceMappingURL=utils.d.ts.map

package/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,OAAO,KAAK,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,CAMhF;AAED,wBAAgB,UAAU,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,CAEnD;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,EAAE,CAqClE;AAED,eAAO,MAAM,cAAc,QAAkC,CAAA;AAqB7D,oBAAY,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAA;AAChC,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,CAE5C"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAA;AAGnB,gBAAgB;AAChB,wBAAgB,SAAS,CAAC,CAAC,EACzB,QAAQ,EAAE,OAAO,EACjB,YAAY,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,EACjC,OAAO,EAAE,OAAO,GACf,CAAC,CAKH;AACD,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEvF,2EAA2E;AAC3E,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;KAC3B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC/E,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,GAAG,IAAI,EAAE,CAAC,SAAS,GAAG,SAAS,EAAE,CAAC,EAAE,UA4B7D;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,SAAS,GAAG,SAAS,EAAE,EAAE,MAAM,SAAI,GAAG,MAAM,CAKvE;AAED,gBAAgB;AAChB,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAGhG;AAED,gBAAgB;AAChB,wBAAgB,SAAS,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,WAAW,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,EAAE,CAAC,CAYvF;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAUhD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI/C;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAKpD"}