@appium/docutils 0.1.6 → 0.2.1

package/build/lib/cli/config.js

@@ -0,0 +1,114 @@
+"use strict";
+/**
+ * Handles reading of a config file for docutils
+ * @module
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = exports.findConfig = void 0;
+const lilconfig_ts_loader_1 = __importDefault(require("@sliphua/lilconfig-ts-loader"));
+const consola_1 = require("consola");
+const lilconfig_1 = require("lilconfig");
+const lodash_1 = __importDefault(require("lodash"));
+const node_path_1 = __importDefault(require("node:path"));
+const yaml_1 = __importDefault(require("yaml"));
+const yargs_parser_1 = __importDefault(require("yargs-parser"));
+const helpers_1 = require("yargs/helpers");
+const constants_1 = require("../constants");
+const logger_1 = __importDefault(require("../logger"));
+const util_1 = require("../util");
+const log = logger_1.default.withTag('config');
+/**
+ * `lilconfig` loader for YAML
+ */
+const loadYaml = lodash_1.default.rearg(yaml_1.default.parse, [2, 0, 1]);
+/**
+ * `lilconfig` loader for ESM/CJS
+ */
+const loadEsm = (filepath) => Promise.resolve().then(() => __importStar(require(filepath)));
+/**
+ * Controls how we load/find a config file.
+ *
+ * Takes _raw_ args from the CLI, and uses `yargs-parser` to parse them as to not interfere with the
+ * main usage of args.
+ *
+ * We're looking for various things in the CLI args:
+ * - `--no-config` - if this is present, we don't load a config file
+ * - `--log-level` - if this is present, we set the log level
+ * - `--verbose` - same as above
+ * - `--config` - if this is present, we load the config file at the given path
+ * - `--help`, `--version` - do nothing
+ * @param argv Raw CLI args
+ * @returns
+ */
+async function findConfig(argv = (0, helpers_1.hideBin)(process.argv)) {
+    const preArgs = (0, yargs_parser_1.default)(argv);
+    if (preArgs.verbose || preArgs.logLevel === 'debug') {
+        log.level = consola_1.LogLevel.Debug;
+    }
+    return preArgs.noConfig || preArgs.help || preArgs.version
+        ? {}
+        : await loadConfig(preArgs.config);
+}
+exports.findConfig = findConfig;
+/**
+ * Loads a config file or finds and loads one if none provided
+ * @param filepath Config file path, if provided
+ * @param cwd Current working directory
+ * @returns A config object or an empty object. Could be anything; `yargs` will validate it.
+ */
+async function loadConfig(filepath, cwd = process.cwd()) {
+    const relativePath = (0, util_1.relative)(cwd);
+    const searcher = (0, lilconfig_1.lilconfig)(constants_1.NAME_BIN, {
+        loaders: {
+            '.yaml': loadYaml,
+            '.yml': loadYaml,
+            '.ts': lilconfig_ts_loader_1.default,
+            '.js': loadEsm,
+            '.cjs': loadEsm,
+            '.mjs': loadEsm,
+        },
+    });
+    const result = filepath
+        ? await searcher.load(node_path_1.default.normalize(filepath))
+        : await searcher.search(cwd);
+    if (result === null) {
+        log.debug('No config found');
+        return {};
+    }
+    if (result.isEmpty) {
+        log.debug('Config loaded at %s but it was empty', result.filepath);
+        return {};
+    }
+    const relFilepath = relativePath(result.filepath);
+    log.success('Loaded config from %s', relFilepath);
+    log.debug('Config contents: %O', result.config);
+    return result.config;
+}
+exports.loadConfig = loadConfig;
+//# sourceMappingURL=config.js.map

package/build/lib/cli/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../lib/cli/config.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uFAAkD;AAClD,qCAAiC;AACjC,yCAA4C;AAC5C,oDAAuB;AACvB,0DAA6B;AAC7B,gDAAwB;AACxB,gEAAkC;AAClC,2CAAsC;AACtC,4CAAsC;AACtC,uDAA+B;AAC/B,kCAAiC;AACjC,MAAM,GAAG,GAAG,gBAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAErC;;GAEG;AACH,MAAM,QAAQ,GAAW,gBAAC,CAAC,KAAK,CAAC,cAAI,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACxD;;GAEG;AACH,MAAM,OAAO,GAAW,CAAC,QAAgB,EAAE,EAAE,mDAAQ,QAAQ,GAAC,CAAC;AAE/D;;;;;;;;;;;;;;GAcG;AACI,KAAK,UAAU,UAAU,CAAC,OAAiB,IAAA,iBAAO,EAAC,OAAO,CAAC,IAAI,CAAC;IACrE,MAAM,OAAO,GAAG,IAAA,sBAAM,EAAC,IAAI,CAAC,CAAC;IAE7B,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE;QACnD,GAAG,CAAC,KAAK,GAAG,kBAAQ,CAAC,KAAK,CAAC;KAC5B;IAED,OAAO,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,OAAO;QACxD,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,MAA4B,CAAC,CAAC;AAC7D,CAAC;AAVD,gCAUC;AAED;;;;;GAKG;AACI,KAAK,UAAU,UAAU,CAAC,QAAiB,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IACrE,MAAM,YAAY,GAAG,IAAA,eAAQ,EAAC,GAAG,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAA,qBAAS,EAAC,oBAAQ,EAAE;QACnC,OAAO,EAAE;YACP,OAAO,EAAE,QAAQ;YACjB,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,6BAAM;YACb,KAAK,EAAE,OAAO;YACd,MAAM,EAAE,OAAO;YACf,MAAM,EAAE,OAAO;SAChB;KACF,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,QAAQ;QACrB,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,mBAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC/C,CAAC,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,MAAM,KAAK,IAAI,EAAE;QACnB,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC7B,OAAO,EAAE,CAAC;KACX;IACD,IAAI,MAAM,CAAC,OAAO,EAAE;QAClB,GAAG,CAAC,KAAK,CAAC,sCAAsC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnE,OAAO,EAAE,CAAC;KACX;IACD,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClD,GAAG,CAAC,OAAO,CAAC,uBAAuB,EAAE,WAAW,CAAC,CAAC;IAClD,GAAG,CAAC,KAAK,CAAC,qBAAqB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAChD,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC;AA5BD,gCA4BC"}

package/build/lib/cli/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+export declare function main(argv?: string[]): Promise<{
+    [x: string]: unknown;
+    verbose: boolean | undefined;
+    logLevel: "info" | "silent" | "error" | "warn" | "debug";
+    "log-level": "info" | "silent" | "error" | "warn" | "debug";
+    config: string | undefined;
+    noConfig: boolean | undefined;
+    "no-config": boolean | undefined;
+    _: (string | number)[];
+    $0: string;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/build/lib/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/cli/index.ts"],"names":[],"mappings":";AAYA,wBAAsB,IAAI,CAAC,IAAI,WAAwB;;;;;;;;;;GAoEtD"}

package/build/lib/cli/index.js

@@ -0,0 +1,91 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.main = void 0;
+const logger_1 = __importDefault(require("../logger"));
+const lodash_1 = __importDefault(require("lodash"));
+const helpers_1 = require("yargs/helpers");
+const yargs_1 = __importDefault(require("yargs/yargs"));
+const constants_1 = require("../constants");
+const error_1 = require("../error");
+const command_1 = require("./command");
+const config_1 = require("./config");
+const log = logger_1.default.withTag('cli');
+async function main(argv = (0, helpers_1.hideBin)(process.argv)) {
+    const config = await (0, config_1.findConfig)(argv);
+    const y = (0, yargs_1.default)(argv);
+    return await y
+        .scriptName(constants_1.NAME_BIN)
+        .command(command_1.build)
+        .command(command_1.init)
+        .command(command_1.validate)
+        .options({
+        verbose: {
+            type: 'boolean',
+            describe: 'Alias for --log-level=debug',
+        },
+        'log-level': {
+            alias: 'L',
+            choices: ['debug', 'info', 'warn', 'error', 'silent'],
+            describe: 'Sets the log level',
+            default: constants_1.DEFAULT_LOG_LEVEL,
+            coerce: lodash_1.default.identity,
+        },
+        config: {
+            alias: 'c',
+            type: 'string',
+            describe: 'Path to config file',
+            normalize: true,
+            nargs: 1,
+            requiresArg: true,
+            defaultDescription: '(discovered automatically)',
+        },
+        'no-config': {
+            type: 'boolean',
+            describe: 'Disable config file discovery',
+        },
+    })
+        .middleware(
+    /**
+     * Configures logging; `--verbose` implies `--log-level=debug`
+     */
+    (argv) => {
+        if (argv.verbose) {
+            argv.logLevel = 'debug';
+            log.debug('Debug logging enabled via --verbose');
+        }
+        log.level = constants_1.LogLevelMap[argv.logLevel];
+    })
+        .fail(
+    /**
+     * Custom failure handler so we can log nicely.
+     */
+    (msg, error) => {
+        // if it is a DocutilsError, it has nothing to do with the CLI
+        if (error instanceof error_1.DocutilsError) {
+            log.error(error.message);
+        }
+        else {
+            y.showHelp();
+            log.error(msg ?? error.message);
+        }
+        y.exit(1, error);
+    })
+        .config(config)
+        // at least one command is required (but not for --version or --help)
+        .demandCommand(1)
+        // fail if unknown option or command is provided
+        .strict()
+        .parseAsync();
+}
+exports.main = main;
+if (require.main === module) {
+    // eslint-disable-next-line promise/prefer-await-to-then
+    main().catch((err) => {
+        log.error('Caught otherwise-unhandled rejection (this is probably a bug):', err);
+    });
+}
+//# sourceMappingURL=index.js.map

package/build/lib/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/cli/index.ts"],"names":[],"mappings":";;;;;;;AACA,uDAA+B;AAE/B,oDAAuB;AACvB,2CAAsC;AACtC,wDAAgC;AAChC,4CAAsE;AACtE,oCAAuC;AACvC,uCAAgD;AAChD,qCAAoC;AAEpC,MAAM,GAAG,GAAG,gBAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC3B,KAAK,UAAU,IAAI,CAAC,IAAI,GAAG,IAAA,iBAAO,EAAC,OAAO,CAAC,IAAI,CAAC;IACrD,MAAM,MAAM,GAAG,MAAM,IAAA,mBAAU,EAAC,IAAI,CAAC,CAAC;IAEtC,MAAM,CAAC,GAAG,IAAA,eAAK,EAAC,IAAI,CAAC,CAAC;IACtB,OAAO,MAAM,CAAC;SACX,UAAU,CAAC,oBAAQ,CAAC;SACpB,OAAO,CAAC,eAAK,CAAC;SACd,OAAO,CAAC,cAAI,CAAC;SACb,OAAO,CAAC,kBAAQ,CAAC;SACjB,OAAO,CAAC;QACP,OAAO,EAAE;YACP,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,6BAA6B;SACxC;QACD,WAAW,EAAE;YACX,KAAK,EAAE,GAAG;YACV,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC;YACrD,QAAQ,EAAE,oBAAoB;YAC9B,OAAO,EAAE,6BAAiB;YAC1B,MAAM,EAAE,gBAAC,CAAC,QAAmD;SAC9D;QACD,MAAM,EAAE;YACN,KAAK,EAAE,GAAG;YACV,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,qBAAqB;YAC/B,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,IAAI;YACjB,kBAAkB,EAAE,4BAA4B;SACjD;QACD,WAAW,EAAE;YACX,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,+BAA+B;SAC1C;KACF,CAAC;SACD,UAAU;IACT;;OAEG;IACH,CAAC,IAAI,EAAE,EAAE;QACP,IAAI,IAAI,CAAC,OAAO,EAAE;YAChB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;YACxB,GAAG,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;SAClD;QACD,GAAG,CAAC,KAAK,GAAG,uBAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC,CACF;SACA,IAAI;IACH;;OAEG;IACH,CAAC,GAAkB,EAAE,KAAK,EAAE,EAAE;QAC5B,8DAA8D;QAC9D,IAAI,KAAK,YAAY,qBAAa,EAAE;YAClC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;SAC1B;aAAM;YACL,CAAC,CAAC,QAAQ,EAAE,CAAC;YACb,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;SACjC;QACD,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACnB,CAAC,CACF;SACA,MAAM,CAAC,MAAM,CAAC;QACf,qEAAqE;SACpE,aAAa,CAAC,CAAC,CAAC;QACjB,gDAAgD;SAC/C,MAAM,EAAE;SACR,UAAU,EAAE,CAAC;AAClB,CAAC;AApED,oBAoEC;AAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE;IAC3B,wDAAwD;IACxD,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACnB,GAAG,CAAC,KAAK,CAAC,gEAAgE,EAAE,GAAG,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;CACJ"}

package/build/lib/cli/init.d.ts

@@ -0,0 +1,143 @@
+import { CommandModule, InferredOptionTypes } from 'yargs';
+declare const opts: {
+    readonly copyright: {
+        readonly description: "Copyright notice";
+        readonly group: "MkDocs Config:";
+        readonly nargs: 1;
+        readonly requiresArg: true;
+        readonly type: "string";
+    };
+    readonly dir: {
+        readonly default: ".";
+        readonly defaultDescription: "(current directory)";
+        readonly description: "Directory of package";
+        readonly group: "Paths:";
+        readonly normalize: true;
+        readonly type: "string";
+    };
+    readonly 'dry-run': {
+        readonly describe: "Do not write any files; show what would be done";
+        readonly group: "Initialization Behavior:";
+        readonly type: "boolean";
+    };
+    readonly force: {
+        readonly alias: "f";
+        readonly describe: "Overwrite existing configurations";
+        readonly group: "Initialization Behavior:";
+        readonly type: "boolean";
+    };
+    readonly include: {
+        readonly alias: "i";
+        readonly array: true;
+        readonly coerce: (value: string | string[]) => string[];
+        readonly description: "Files to include in compilation (globs OK)";
+        readonly nargs: 1;
+        readonly requiresArg: true;
+        readonly type: "string";
+    };
+    readonly mkdocs: {
+        readonly default: true;
+        readonly description: "Create mkdocs.yml if needed";
+        readonly group: "Initialization Behavior:";
+        readonly type: "boolean";
+    };
+    readonly 'mkdocs-yml': {
+        readonly defaultDescription: "./mkdocs.yml";
+        readonly description: "Path to mkdocs.yml";
+        readonly group: "Paths:";
+        readonly nargs: 1;
+        readonly normalize: true;
+        readonly requiresArg: true;
+        readonly type: "string";
+    };
+    readonly 'package-json': {
+        readonly defaultDescription: "./package.json";
+        readonly describe: "Path to package.json";
+        readonly group: "Paths:";
+        readonly nargs: 1;
+        readonly normalize: true;
+        readonly requiresArg: true;
+        readonly type: "string";
+    };
+    readonly python: {
+        readonly default: true;
+        readonly description: "Install Python dependencies if needed";
+        readonly group: "Initialization Behavior:";
+        readonly type: "boolean";
+    };
+    readonly 'python-path': {
+        readonly defaultDescription: "(derived from shell)";
+        readonly description: "Path to python 3 executable";
+        readonly group: "Paths:";
+        readonly nargs: 1;
+        readonly normalize: true;
+        readonly requiresArg: true;
+        readonly type: "string";
+    };
+    readonly 'repo-name': {
+        readonly defaultDescription: "(derived from --repo-url)";
+        readonly description: "Name of extension repository";
+        readonly group: "MkDocs Config:";
+        readonly nargs: 1;
+        readonly requiresArg: true;
+        readonly type: "string";
+    };
+    readonly 'repo-url': {
+        readonly defaultDescription: "(from package.json)";
+        readonly description: "URL of extension repository";
+        readonly group: "MkDocs Config:";
+        readonly nargs: 1;
+        readonly requiresArg: true;
+        readonly type: "string";
+    };
+    readonly 'site-description': {
+        readonly defaultDescription: "(from package.json)";
+        readonly description: "Site description";
+        readonly group: "MkDocs Config:";
+        readonly nargs: 1;
+        readonly requiresArg: true;
+        readonly type: "string";
+    };
+    readonly 'site-name': {
+        readonly defaultDescription: "(extension package name)";
+        readonly description: "Name of site";
+        readonly group: "MkDocs Config:";
+        readonly nargs: 1;
+        readonly requiresArg: true;
+        readonly type: "string";
+    };
+    readonly 'tsconfig-json': {
+        readonly defaultDescription: "./tsconfig.json";
+        readonly describe: "Path to tsconfig.json";
+        readonly group: "Paths:";
+        readonly nargs: 1;
+        readonly normalize: true;
+        readonly requiresArg: true;
+        readonly type: "string";
+    };
+    readonly typedoc: {
+        readonly default: true;
+        readonly description: "Create typedoc.json if needed";
+        readonly group: "Initialization Behavior:";
+        readonly type: "boolean";
+    };
+    readonly 'typedoc-json': {
+        readonly defaultDescription: "./typedoc.json";
+        readonly describe: "Path to typedoc.json";
+        readonly group: "Paths:";
+        readonly nargs: 1;
+        readonly normalize: true;
+        readonly requiresArg: true;
+        readonly type: "string";
+    };
+    readonly typescript: {
+        readonly default: true;
+        readonly description: "Create tsconfig.json if needed";
+        readonly group: "Initialization Behavior:";
+        readonly type: "boolean";
+    };
+};
+declare type InitOptions = InferredOptionTypes<typeof opts>;
+declare const initCommand: CommandModule<{}, InitOptions>;
+export default initCommand;
+//# sourceMappingURL=init.d.ts.map

package/build/lib/cli/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../lib/cli/init.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,aAAa,EAAE,mBAAmB,EAAU,MAAM,OAAO,CAAC;AAWlE,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCA8BU,MAAM,GAAG,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2G3B,CAAC;AAGX,aAAK,WAAW,GAAG,mBAAmB,CAAC,OAAO,IAAI,CAAC,CAAC;AAEpD,QAAA,MAAM,WAAW,EAAE,aAAa,CAAC,EAAE,EAAE,WAAW,CAS/C,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/build/lib/cli/init.js

@@ -0,0 +1,164 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const lodash_1 = __importDefault(require("lodash"));
+const init_1 = require("../init");
+const logger_1 = __importDefault(require("../logger"));
+const util_1 = require("../util");
+const log = logger_1.default.withTag('init');
+const NAME_GROUP_INIT_MKDOCS = 'MkDocs Config:';
+const NAME_GROUP_INIT_PATHS = 'Paths:';
+const NAME_GROUP_INIT_BEHAVIOR = 'Initialization Behavior:';
+const opts = {
+    copyright: {
+        description: 'Copyright notice',
+        group: NAME_GROUP_INIT_MKDOCS,
+        nargs: 1,
+        requiresArg: true,
+        type: 'string',
+    },
+    dir: {
+        default: '.',
+        defaultDescription: '(current directory)',
+        description: 'Directory of package',
+        group: NAME_GROUP_INIT_PATHS,
+        normalize: true,
+        type: 'string',
+    },
+    'dry-run': {
+        describe: 'Do not write any files; show what would be done',
+        group: NAME_GROUP_INIT_BEHAVIOR,
+        type: 'boolean',
+    },
+    force: {
+        alias: 'f',
+        describe: 'Overwrite existing configurations',
+        group: NAME_GROUP_INIT_BEHAVIOR,
+        type: 'boolean',
+    },
+    include: {
+        alias: 'i',
+        array: true,
+        coerce: (value) => lodash_1.default.castArray(value),
+        description: 'Files to include in compilation (globs OK)',
+        nargs: 1,
+        requiresArg: true,
+        type: 'string',
+    },
+    mkdocs: {
+        default: true,
+        description: 'Create mkdocs.yml if needed',
+        group: NAME_GROUP_INIT_BEHAVIOR,
+        type: 'boolean',
+    },
+    'mkdocs-yml': {
+        defaultDescription: './mkdocs.yml',
+        description: 'Path to mkdocs.yml',
+        group: NAME_GROUP_INIT_PATHS,
+        nargs: 1,
+        normalize: true,
+        requiresArg: true,
+        type: 'string',
+    },
+    'package-json': {
+        defaultDescription: './package.json',
+        describe: 'Path to package.json',
+        group: NAME_GROUP_INIT_PATHS,
+        nargs: 1,
+        normalize: true,
+        requiresArg: true,
+        type: 'string',
+    },
+    python: {
+        default: true,
+        description: 'Install Python dependencies if needed',
+        group: NAME_GROUP_INIT_BEHAVIOR,
+        type: 'boolean',
+    },
+    'python-path': {
+        defaultDescription: '(derived from shell)',
+        description: 'Path to python 3 executable',
+        group: NAME_GROUP_INIT_PATHS,
+        nargs: 1,
+        normalize: true,
+        requiresArg: true,
+        type: 'string',
+    },
+    'repo-name': {
+        defaultDescription: '(derived from --repo-url)',
+        description: 'Name of extension repository',
+        group: NAME_GROUP_INIT_MKDOCS,
+        nargs: 1,
+        requiresArg: true,
+        type: 'string',
+    },
+    'repo-url': {
+        defaultDescription: '(from package.json)',
+        description: 'URL of extension repository',
+        group: NAME_GROUP_INIT_MKDOCS,
+        nargs: 1,
+        requiresArg: true,
+        type: 'string',
+    },
+    'site-description': {
+        defaultDescription: '(from package.json)',
+        description: 'Site description',
+        group: NAME_GROUP_INIT_MKDOCS,
+        nargs: 1,
+        requiresArg: true,
+        type: 'string',
+    },
+    'site-name': {
+        defaultDescription: '(extension package name)',
+        description: 'Name of site',
+        group: NAME_GROUP_INIT_MKDOCS,
+        nargs: 1,
+        requiresArg: true,
+        type: 'string',
+    },
+    'tsconfig-json': {
+        defaultDescription: './tsconfig.json',
+        describe: 'Path to tsconfig.json',
+        group: NAME_GROUP_INIT_PATHS,
+        nargs: 1,
+        normalize: true,
+        requiresArg: true,
+        type: 'string',
+    },
+    typedoc: {
+        default: true,
+        description: 'Create typedoc.json if needed',
+        group: NAME_GROUP_INIT_BEHAVIOR,
+        type: 'boolean',
+    },
+    'typedoc-json': {
+        defaultDescription: './typedoc.json',
+        describe: 'Path to typedoc.json',
+        group: NAME_GROUP_INIT_PATHS,
+        nargs: 1,
+        normalize: true,
+        requiresArg: true,
+        type: 'string',
+    },
+    typescript: {
+        default: true,
+        description: 'Create tsconfig.json if needed',
+        group: NAME_GROUP_INIT_BEHAVIOR,
+        type: 'boolean',
+    },
+};
+opts; // type check
+const initCommand = {
+    command: 'init',
+    describe: 'Initialize package for doc generation',
+    builder: opts,
+    async handler(args) {
+        const done = (0, util_1.stopwatch)('init');
+        await (0, init_1.init)({ ...args, overwrite: args.force, cwd: args.dir });
+        log.success('Done (%dms)', done());
+    },
+};
+exports.default = initCommand;
+//# sourceMappingURL=init.js.map

package/build/lib/cli/init.js.map

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

package/build/lib/cli/options.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=options.d.ts.map

package/build/lib/cli/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../lib/cli/options.ts"],"names":[],"mappings":""}

package/build/lib/cli/options.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=options.js.map

package/build/lib/cli/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../lib/cli/options.ts"],"names":[],"mappings":""}

package/build/lib/cli/validate.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=validate.d.ts.map

package/build/lib/cli/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../lib/cli/validate.ts"],"names":[],"mappings":""}

package/build/lib/cli/validate.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=validate.js.map

package/build/lib/cli/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../lib/cli/validate.ts"],"names":[],"mappings":""}

package/build/lib/cli.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+export declare function main(argv?: string[]): Promise<{
+    [x: string]: unknown;
+    verbose: boolean | undefined;
+    "log-level": "error" | "debug" | "info" | "warn" | "silent";
+    logLevel: "error" | "debug" | "info" | "warn" | "silent";
+    _: (string | number)[];
+    $0: string;
+}>;
+//# sourceMappingURL=cli.d.ts.map

package/build/lib/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../lib/cli.ts"],"names":[],"mappings":";AA2BA,wBAAsB,IAAI,CAAC,IAAI,WAAwB;;;;;;;GA6TtD"}