@appium/docutils 0.4.13 → 1.0.1

package/lib/init.ts

@@ -5,21 +5,15 @@
  */
 
 import * as JSON5 from 'json5';
-import {
-  NAME_MKDOCS_YML,
-  NAME_TSCONFIG_JSON,
-  NAME_PYTHON,
-  REQUIREMENTS_TXT_PATH,
-  NAME_TYPEDOC_JSON,
-  NAME_PACKAGE_JSON,
-} from './constants';
+import {NAME_MKDOCS_YML, NAME_TSCONFIG_JSON, NAME_PYTHON, REQUIREMENTS_TXT_PATH} from './constants';
 import YAML from 'yaml';
 import {exec} from 'teen_process';
-import {PackageJson, Simplify} from 'type-fest';
+import {Simplify} from 'type-fest';
 import {DocutilsError} from './error';
 import {createScaffoldTask, ScaffoldTaskOptions} from './scaffold';
+import type { ScaffoldTask } from './scaffold';
 import {getLogger} from './logger';
-import {MkDocsYml, TsConfigJson, TypeDocJson} from './model';
+import {MkDocsYml, TsConfigJson} from './model';
 import _ from 'lodash';
 import {findPython, stringifyJson5, stringifyYaml} from './fs';
 
@@ -32,18 +26,6 @@ const BASE_MKDOCS_YML: Readonly<MkDocsYml> = Object.freeze({
   site_dir: 'site',
 });
 
-/**
- * Data for the base `typedoc.json` file
- */
-const BASE_TYPEDOC_JSON: Readonly<TypeDocJson> = Object.freeze({
-  $schema: 'https://typedoc.org/schema.json',
-  cleanOutputDir: true,
-  entryPointStrategy: 'packages',
-  theme: 'appium',
-  readme: 'none',
-  entryPoints: ['.'],
-});
-
 /**
  * Data for the base `tsconfig.json` file
  */
@@ -55,13 +37,6 @@ const BASE_TSCONFIG_JSON: Readonly<TsConfigJson> = Object.freeze({
   },
 });
 
-/**
- * Data for the base `package.json` file.
- * We expect `package.json` to exist, and we are not in the business of creating it.
- * However, we will need to add a `typedoc.entryPoint` prop to it.
- */
-const BASE_PACKAGE_JSON: Readonly<PackageJson> = Object.freeze({});
-
 const log = getLogger('init');
 const dryRunLog = getLogger('dry-run', log);
 
@@ -96,42 +71,13 @@ export const initTsConfigJson = createScaffoldTask<InitTsConfigOptions, TsConfig
     },
     deserialize: JSON5.parse,
     serialize: stringifyJson5,
-  }
-);
-
-/**
- * Function which scaffolds a `typedoc.json` file
- */
-export const initTypeDocJson = createScaffoldTask<InitTypeDocOptions, TypeDocJson>(
-  NAME_TYPEDOC_JSON,
-  BASE_TYPEDOC_JSON,
-  'TypeDoc configuration'
-);
-
-/**
- * Function which scaffolds a `package.json` file
- *
- * This only amends prop `typedoc.entryPoint` to the `package.json` file.
- *
- * If, strangely, `package.json` did not exist, then it will now contain _only_ that prop.
- */
-export const initTypeDocPkgJson = createScaffoldTask<InitTypeDocOptions, PackageJson>(
-  NAME_PACKAGE_JSON,
-  BASE_PACKAGE_JSON,
-  'Package configuration for TypeDoc',
-  {
-    transform: (content, opts) =>
-      ({
-        ...content,
-        typedoc: {entryPoint: opts.typeDocEntryPoint},
-      } as PackageJson),
-  }
+  },
 );
 
 /**
  * Function which scaffolds an `mkdocs.yml` file
  */
-export const initMkDocs = createScaffoldTask<InitMkDocsOptions, MkDocsYml>(
+export const initMkDocs: ScaffoldTask<InitMkDocsOptions, MkDocsYml> = createScaffoldTask<InitMkDocsOptions, MkDocsYml>(
   NAME_MKDOCS_YML,
   BASE_MKDOCS_YML,
   'MkDocs configuration',
@@ -181,7 +127,7 @@ export const initMkDocs = createScaffoldTask<InitMkDocsOptions, MkDocsYml>(
         site_description: siteDescription,
       };
     },
-  }
+  },
 );
 
 /**
@@ -212,7 +158,7 @@ export async function initPython({
       }
     } catch (err) {
       throw new DocutilsError(
-        `Could not install Python dependencies. Reason: ${(err as Error).message}`
+        `Could not install Python dependencies. Reason: ${(err as Error).message}`,
       );
     }
   }
@@ -238,7 +184,6 @@ export interface InitMkDocsOptions extends ScaffoldTaskOptions {
  */
 export async function init({
   typescript,
-  typedoc,
   python,
   tsconfigJson: tsconfigJsonPath,
   packageJson: packageJsonPath,
@@ -254,15 +199,7 @@ export async function init({
   cwd,
   pythonPath,
   upgrade,
-  typedocJson: typeDocJsonPath,
-  entryPoint: typeDocEntryPoint,
 }: InitOptions = {}): Promise<void> {
-  if (!typescript && typedoc) {
-    log.warn(
-      'Initialization of tsconfig.json disabled. TypeDoc requires a tsconfig.json; please ensure it exists'
-    );
-  }
-
   if (typescript && !upgrade) {
     await initTsConfigJson({
       dest: tsconfigJsonPath,
@@ -274,23 +211,6 @@ export async function init({
     });
   }
 
-  if (typedoc && !upgrade) {
-    await initTypeDocJson({
-      dest: typeDocJsonPath,
-      packageJson: packageJsonPath,
-      overwrite,
-      dryRun,
-      cwd,
-    });
-    await initTypeDocPkgJson({
-      packageJson: packageJsonPath,
-      overwrite: true, // <-- always overwrite
-      dryRun,
-      cwd,
-      typeDocEntryPoint,
-    });
-  }
-
   if (python) {
     await initPython({pythonPath, dryRun, upgrade});
   }
@@ -310,10 +230,6 @@ export async function init({
   }
 }
 
-export interface InitTypeDocOptions extends ScaffoldTaskOptions {
-  typeDocEntryPoint?: string;
-}
-
 export interface InitTsConfigOptions extends ScaffoldTaskOptions {
   /**
    * List of source files (globs supported); typically `src` or `lib`
@@ -338,15 +254,11 @@ export interface InitPythonOptions extends ScaffoldTaskOptions {
  * The props of the various "path" options are rewritten as `dest` for the scaffold tasks functions.
  */
 export type InitOptions = Simplify<
-  Omit<InitPythonOptions & InitTsConfigOptions & InitTypeDocOptions & InitMkDocsOptions, 'dest'> & {
+  Omit<InitPythonOptions & InitTsConfigOptions & InitMkDocsOptions, 'dest'> & {
     /**
      * If `true` will initialize a `tsconfig.json` file
      */
     typescript?: boolean;
-    /**
-     * If `true` will initialize a `typedoc.json` file
-     */
-    typedoc?: boolean;
     /**
      * If `true` will install Python deps
      */
@@ -355,10 +267,6 @@ export type InitOptions = Simplify<
      * If `true` will initialize a `mkdocs.yml` file
      */
     mkdocs?: boolean;
-    /**
-     * Path to new or existing `typedoc.json` file
-     */
-    typedocJson?: string;
     /**
      * Path to new or existing `tsconfig.json` file
      */
@@ -376,10 +284,5 @@ export type InitOptions = Simplify<
      * If `true`, upgrade only
      */
     upgrade?: boolean;
-
-    /**
-     * Path to entry point of extension (source; not "main" field)
-     */
-    entryPoint?: string;
   }
 >;

package/lib/model.ts

@@ -5,7 +5,6 @@
  */
 
 import type {Jsonify, JsonValue, TsConfigJson as TsConfigJsonBase} from 'type-fest';
-import type {TypeDocOptions} from 'typedoc';
 
 /**
  * A `tsconfig.json` file w/ `$schema` prop
@@ -14,19 +13,6 @@ export type TsConfigJson = TsConfigJsonBase & {
   $schema?: string;
 };
 
-/**
- * A `typedoc.json` file w/ `$schema` and `extends` props
- *
- * TypeDoc doesn't recognize `$schema` and ignores it; its own config parser expands the value of
- * `extends` before it reaches its `Options` class. This is why we cannot use `TypeDocOptions` directly.
- */
-export type TypeDocJson = Jsonify<
-  Partial<TypeDocOptions> & {
-    $schema?: string;
-    extends?: string;
-  }
->;
-
 /**
  * The `nav` prop of an `mkdocs.yml` file
  * @see {@linkcode MkDocsYml}

package/lib/validate.ts

@@ -12,7 +12,6 @@ import path from 'node:path';
 import {satisfies} from 'semver';
 import {exec} from 'teen_process';
 import {
-  DEFAULT_REL_TYPEDOC_OUT_PATH,
   DOCUTILS_PKG,
   NAME_BIN,
   NAME_ERR_ENOENT,
@@ -24,24 +23,13 @@ import {
   NAME_PYTHON,
   NAME_REQUIREMENTS_TXT,
   NAME_TSCONFIG_JSON,
-  NAME_TYPEDOC,
-  NAME_TYPEDOC_JSON,
   NAME_TYPESCRIPT,
   REQUIREMENTS_TXT_PATH,
 } from './constants';
 import {DocutilsError} from './error';
-import {
-  findMkDocsYml,
-  findPkgDir,
-  findTypeDoc,
-  readJson5,
-  readMkDocsYml,
-  readTypedocJson,
-  whichNpm,
-  findPython,
-} from './fs';
+import {findMkDocsYml, findPkgDir, readJson5, readMkDocsYml, whichNpm, findPython} from './fs';
 import {getLogger} from './logger';
-import {MkDocsYml, PipPackage, TypeDocJson} from './model';
+import {MkDocsYml, PipPackage} from './model';
 import {relative} from './util';
 
 /**
@@ -54,11 +42,6 @@ const PYTHON_VER_STR = 'Python 3.';
  */
 const TYPESCRIPT_VERSION_REGEX = /Version\s(\d+\.\d+\..+)/;
 
-/**
- * Matches the TypeDoc version string from `typedoc --version`
- */
-const TYPEDOC_VERSION_REGEX = /TypeDoc\s(\d+\.\d+\..+)/;
-
 /**
  * Matches the MkDocs version string from `mkdocs --version`
  */
@@ -72,7 +55,6 @@ const log = getLogger('validate');
 export type ValidationKind =
   | typeof NAME_PYTHON
   | typeof NAME_TYPESCRIPT
-  | typeof NAME_TYPEDOC
   | typeof NAME_NPM
   | typeof NAME_MKDOCS;
 
@@ -137,13 +119,6 @@ export class DocutilsValidator extends EventEmitter {
    */
   protected tsconfigJsonPath?: string;
 
-  /**
-   * Path to `typedoc.json`.  If not provided, will be lazily resolved.
-   */
-  protected typeDocJsonPath?: string;
-
-  protected typeDocPath?: string;
-
   /**
    * Emitted when validation begins with a list of validation kinds to be performed
    * @event
@@ -180,21 +155,15 @@ export class DocutilsValidator extends EventEmitter {
     this.pythonPath = opts.pythonPath;
     this.cwd = opts.cwd ?? process.cwd();
     this.tsconfigJsonPath = opts.tsconfigJson;
-    this.typeDocJsonPath = opts.typedocJson;
     this.npmPath = opts.npm;
     this.mkDocsYmlPath = opts.mkdocsYml;
-    this.typeDocPath = opts.typedocPath;
 
     if (opts.python) {
       this.validations.add(NAME_PYTHON);
     }
     if (opts.typescript) {
       this.validations.add(NAME_TYPESCRIPT);
-      // npm validation is required for both typescript and typedoc validation
-      this.validations.add(NAME_NPM);
-    }
-    if (opts.typedoc) {
-      this.validations.add(NAME_TYPEDOC);
+      // npm validation is required for typescript
       this.validations.add(NAME_NPM);
     }
     if (opts.mkdocs) {
@@ -233,11 +202,6 @@ export class DocutilsValidator extends EventEmitter {
         await this.validateTypeScriptConfig();
       }
 
-      if (this.validations.has(NAME_TYPEDOC)) {
-        await this.validateTypeDoc();
-        await this.validateTypeDocConfig();
-      }
-
       this.emit(DocutilsValidator.END, this.emittedErrors.size);
     } finally {
       this.reset();
@@ -321,7 +285,7 @@ export class DocutilsValidator extends EventEmitter {
 
     if (!pythonPath) {
       return this.fail(
-        `Could not find ${NAME_PYTHON} executable in PATH. If it is installed, check your PATH environment variable.`
+        `Could not find ${NAME_PYTHON} executable in PATH. If it is installed, check your PATH environment variable.`,
       );
     }
 
@@ -338,18 +302,18 @@ export class DocutilsValidator extends EventEmitter {
       const mkDocsPipPkg = _.find(reqs, {name: NAME_MKDOCS});
       if (!mkDocsPipPkg) {
         throw new DocutilsError(
-          `No ${NAME_MKDOCS} package in ${REQUIREMENTS_TXT_PATH}. This is a bug.`
+          `No ${NAME_MKDOCS} package in ${REQUIREMENTS_TXT_PATH}. This is a bug.`,
         );
       }
       const {version: mkDocsReqdVersion} = mkDocsPipPkg;
       if (version !== mkDocsReqdVersion) {
         return this.fail(
-          `${NAME_MKDOCS} is v${version}, but ${REQUIREMENTS_TXT_PATH} requires v${mkDocsReqdVersion}`
+          `${NAME_MKDOCS} is v${version}, but ${REQUIREMENTS_TXT_PATH} requires v${mkDocsReqdVersion}`,
         );
       }
     } else {
       throw new DocutilsError(
-        `Could not parse version from MkDocs. This is a bug. Output was ${rawMkDocsVersion}`
+        `Could not parse version from MkDocs. This is a bug. Output was ${rawMkDocsVersion}`,
       );
     }
 
@@ -365,7 +329,7 @@ export class DocutilsValidator extends EventEmitter {
     mkDocsYmlPath = mkDocsYmlPath ?? this.mkDocsYmlPath ?? (await findMkDocsYml(this.cwd));
     if (!mkDocsYmlPath) {
       return this.fail(
-        `Could not find ${NAME_MKDOCS_YML} from ${this.cwd}. Run "${NAME_BIN} init" to create it`
+        `Could not find ${NAME_MKDOCS_YML} from ${this.cwd}. Run "${NAME_BIN} init" to create it`,
       );
     }
     let mkDocsYml: MkDocsYml;
@@ -375,7 +339,7 @@ export class DocutilsValidator extends EventEmitter {
       const err = e as NodeJS.ErrnoException;
       if (err.code === NAME_ERR_ENOENT) {
         return this.fail(
-          `Could not find ${NAME_MKDOCS_YML} at ${mkDocsYmlPath}. Use --mkdocs-yml to specify a different path.`
+          `Could not find ${NAME_MKDOCS_YML} at ${mkDocsYmlPath}. Use --mkdocs-yml to specify a different path.`,
         );
       }
       return this.fail(`Could not parse ${mkDocsYmlPath}: ${err}`);
@@ -402,7 +366,7 @@ export class DocutilsValidator extends EventEmitter {
       const npmPath = this.npmPath ?? (await whichNpm());
       if (!npmPath) {
         throw new DocutilsError(
-          `Could not find ${NAME_NPM} in PATH. That seems weird, doesn't it?`
+          `Could not find ${NAME_NPM} in PATH. That seems weird, doesn't it?`,
         );
       }
       const {stdout: npmVersion} = await exec(npmPath, ['-v']);
@@ -445,7 +409,7 @@ export class DocutilsValidator extends EventEmitter {
       installedPkgs = JSON.parse(pipListOutput) as PipPackage[];
     } catch {
       throw new DocutilsError(
-        `Could not parse output of "${NAME_PIP} list" as JSON: ${pipListOutput}`
+        `Could not parse output of "${NAME_PIP} list" as JSON: ${pipListOutput}`,
       );
     }
 
@@ -470,23 +434,23 @@ export class DocutilsValidator extends EventEmitter {
       msgParts.push(
         `The following required ${util.pluralize(
           'package',
-          missingPackages.length
+          missingPackages.length,
         )} could not be found:\n${missingPackages
           .map((p) => chalk`- {yellow ${p.name}} @ {yellow ${p.version}}`)
-          .join('\n')}`
+          .join('\n')}`,
       );
     }
     if (invalidVersionPackages.length) {
       msgParts.push(
         `The following required ${util.pluralize(
           'package',
-          invalidVersionPackages.length
+          invalidVersionPackages.length,
         )} are installed, but at the wrong version:\n${invalidVersionPackages
           .map(
             ([expected, actual]) =>
-              chalk`- {yellow ${expected.name}} @ {yellow ${expected.version}} (found {red ${actual.version}})`
+              chalk`- {yellow ${expected.name}} @ {yellow ${expected.version}} (found {red ${actual.version}})`,
           )
-          .join('\n')}`
+          .join('\n')}`,
       );
     }
     if (msgParts.length) {
@@ -509,7 +473,7 @@ export class DocutilsValidator extends EventEmitter {
       const {stdout} = await exec(pythonPath, ['--version']);
       if (!stdout.includes(PYTHON_VER_STR)) {
         return this.fail(
-          `Could not find Python 3.x in PATH; found ${stdout}.  Please use --python-path`
+          `Could not find Python 3.x in PATH; found ${stdout}.  Please use --python-path`,
         );
       }
     } catch {
@@ -518,107 +482,6 @@ export class DocutilsValidator extends EventEmitter {
     this.ok('Python version OK');
   }
 
-  /**
-   * Asserts TypeDoc is installed, runnable, the correct version, and that the config file is readable
-   * and constaints required options
-   *
-   * @todo Another option would be to `npm exec typedoc@<version>` which delegates to `npx`.
-   */
-  protected async validateTypeDoc() {
-    const pkgDir = await this.findPkgDir();
-    const typeDocPath = this.typeDocPath ?? (await findTypeDoc(pkgDir));
-
-    if (!typeDocPath) {
-      return this.fail(`Could not find ${NAME_TYPEDOC}; is it installed?`);
-    }
-    log.debug('Found %s at %s', NAME_TYPEDOC, typeDocPath);
-
-    let rawTypeDocVersion: string;
-    let typeDocVersion: string;
-    try {
-      ({stdout: rawTypeDocVersion} = await exec(process.execPath, [typeDocPath, '--version'], {
-        cwd: pkgDir,
-      }));
-    } catch (err) {
-      return this.fail(
-        `Could not execute ${process.execPath} ${typeDocPath} from ${pkgDir}. Reason: ${
-          (err as Error).message
-        }`
-      );
-    }
-
-    if (rawTypeDocVersion) {
-      const match = rawTypeDocVersion.match(TYPEDOC_VERSION_REGEX);
-      if (match) {
-        typeDocVersion = match[1];
-      } else {
-        throw new DocutilsError(
-          `Could not parse TypeDoc version from "typedoc --version"; output was:\n ${rawTypeDocVersion}`
-        );
-      }
-
-      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-      const reqdTypeDocVersion = DOCUTILS_PKG.dependencies!.typedoc!; // this is our own package.json
-      if (!satisfies(typeDocVersion, reqdTypeDocVersion)) {
-        return this.fail(
-          `Found TypeDoc version ${typeDocVersion}, but ${reqdTypeDocVersion} is required`
-        );
-      }
-      this.ok('TypeDoc install OK');
-    }
-  }
-
-  /**
-   * Validates the `typedoc.json` file
-   */
-  protected async validateTypeDocConfig() {
-    const pkgDir = await this.findPkgDir();
-    if (!pkgDir) {
-      return this.fail(new DocutilsError(`Could not find package.json in ${this.cwd}`));
-    }
-    const typeDocJsonPath = (this.typeDocJsonPath =
-      this.typeDocJsonPath ?? path.join(pkgDir, NAME_TYPEDOC_JSON));
-    const relTypeDocJsonPath = relative(this.cwd, typeDocJsonPath);
-    let typeDocJson: TypeDocJson;
-
-    // handle the case where the user passes a JS file as the typedoc config
-    // (which is allowed by TypeDoc)
-    if (typeDocJsonPath.endsWith('.js')) {
-      try {
-        typeDocJson = require(typeDocJsonPath);
-      } catch (err) {
-        throw new DocutilsError(
-          `TypeDoc config at ${relTypeDocJsonPath} threw an exception: ${err}`
-        );
-      }
-    } else {
-      try {
-        typeDocJson = readTypedocJson(typeDocJsonPath);
-      } catch (e) {
-        if (e instanceof SyntaxError) {
-          return this.fail(
-            new DocutilsError(`Unparseable ${NAME_TYPEDOC_JSON} at ${relTypeDocJsonPath}: ${e}`)
-          );
-        }
-        return this.fail(
-          new DocutilsError(
-            `Missing ${NAME_TYPEDOC_JSON} at ${relTypeDocJsonPath}; "${NAME_BIN} init" can help`
-          )
-        );
-      }
-    }
-
-    if (!typeDocJson.out) {
-      return this.fail(
-        new DocutilsError(
-          `Missing "out" property in ${relTypeDocJsonPath}; path "${DEFAULT_REL_TYPEDOC_OUT_PATH}" is recommended`
-        )
-      );
-    }
-
-    this.ok('TypeDoc config OK');
-  }
-
   /**
    * Asserts that TypeScript is installed, runnable, the correct version, and a parseable `tsconfig.json` exists.
    */
@@ -642,7 +505,7 @@ export class DocutilsValidator extends EventEmitter {
       typeScriptVersion = match[1];
     } else {
       return this.fail(
-        `Could not parse TypeScript version from "tsc --version"; output was:\n ${rawTypeScriptVersion}`
+        `Could not parse TypeScript version from "tsc --version"; output was:\n ${rawTypeScriptVersion}`,
       );
     }
 
@@ -650,13 +513,13 @@ export class DocutilsValidator extends EventEmitter {
 
     if (!reqdTypeScriptVersion) {
       throw new DocutilsError(
-        `Could not find a dep for ${NAME_TYPESCRIPT} in ${NAME_PACKAGE_JSON}. This is a bug.`
+        `Could not find a dep for ${NAME_TYPESCRIPT} in ${NAME_PACKAGE_JSON}. This is a bug.`,
       );
     }
 
     if (!satisfies(typeScriptVersion, reqdTypeScriptVersion)) {
       return this.fail(
-        `Found TypeScript version ${typeScriptVersion}, but ${reqdTypeScriptVersion} is required`
+        `Found TypeScript version ${typeScriptVersion}, but ${reqdTypeScriptVersion} is required`,
       );
     }
     this.ok('TypeScript install OK');
@@ -678,13 +541,13 @@ export class DocutilsValidator extends EventEmitter {
     } catch (e) {
       if (e instanceof SyntaxError) {
         return this.fail(
-          new DocutilsError(`Unparseable ${NAME_TSCONFIG_JSON} at ${relTsconfigJsonPath}: ${e}`)
+          new DocutilsError(`Unparseable ${NAME_TSCONFIG_JSON} at ${relTsconfigJsonPath}: ${e}`),
         );
       }
       return this.fail(
         new DocutilsError(
-          `Missing ${NAME_TSCONFIG_JSON} at ${relTsconfigJsonPath}; "${NAME_BIN} init" can help`
-        )
+          `Missing ${NAME_TSCONFIG_JSON} at ${relTsconfigJsonPath}; "${NAME_BIN} init" can help`,
+        ),
       );
     }
 
@@ -725,18 +588,6 @@ export interface DocutilsValidatorOpts {
    * Path to `tsconfig.json`
    */
   tsconfigJson?: string;
-  /**
-   * If `true`, run TypeDoc validation
-   */
-  typedoc?: boolean;
-  /**
-   * Path to `typedoc` executable
-   */
-  typedocPath?: string;
-  /**
-   * Path to `typedoc.json`
-   */
-  typedocJson?: string;
   /**
    * If `true`, run TypeScript validation
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appium/docutils",
-  "version": "0.4.13",
+  "version": "1.0.1",
   "description": "Documentation generation utilities for Appium and related projects",
   "keywords": [
     "automation",
@@ -38,7 +38,6 @@
     "build",
     "tsconfig.json",
     "!build/tsconfig.tsbuildinfo",
-    "typedoc-shared.json",
     "requirements.txt"
   ],
   "scripts": {
@@ -49,16 +48,14 @@
     "start": "node ./build/lib/cli/index.js"
   },
   "dependencies": {
-    "@appium/support": "^4.1.10",
+    "@appium/support": "^4.1.11",
     "@appium/tsconfig": "^0.x",
-    "@appium/typedoc-plugin-appium": "^0.x",
     "@sliphua/lilconfig-ts-loader": "3.2.2",
-    "@types/which": "3.0.1",
+    "@types/which": "3.0.3",
     "chalk": "4.1.2",
     "consola": "2.15.3",
     "diff": "5.1.0",
     "figures": "3.2.0",
-    "find-up": "5.0.0",
     "json5": "2.2.3",
     "lilconfig": "2.1.0",
     "lodash": "4.17.21",
@@ -67,12 +64,9 @@
     "read-pkg": "5.2.0",
     "semver": "7.5.4",
     "source-map-support": "0.5.21",
-    "teen_process": "2.0.101",
-    "type-fest": "3.13.1",
-    "typedoc": "0.23.28",
-    "typedoc-plugin-markdown": "3.14.0",
-    "typedoc-plugin-resolve-crossmodule-references": "0.3.3",
-    "typescript": "5.0.4",
+    "teen_process": "2.1.1",
+    "type-fest": "4.8.3",
+    "typescript": "5.2.2",
     "yaml": "2.3.4",
     "yargs": "17.7.2",
     "yargs-parser": "21.1.1"
@@ -84,5 +78,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "67504604b7d4602561db2cb3529860b241bec427"
+  "gitHead": "5c1d20517cfc8773cd5ffb0f8bb996668d71116b"
 }

package/requirements.txt

@@ -1,4 +1,5 @@
 mkdocs==1.5.3
-mkdocs-material==9.4.12
-mkdocs-material-extensions==1.3.1
-mike==1.1.2
+mkdocs-git-revision-date-localized-plugin==1.2.1
+mkdocs-material==9.5.2
+mkdocs-redirects==1.2.1
+mike==2.0.0

package/tsconfig.json

@@ -3,6 +3,7 @@
   "compilerOptions": {
     "rootDir": ".",
     "outDir": "build",
+    "checkJs": true,
     "paths": {
       "@appium/support": ["../support"],
       "@appium/types": ["../types"]