@yandex/ymaps3-cli

Yandex JS CLI utils

The project is used for inheritance in packages https://yandex.ru/dev/maps/jsapi/doc/3.0/ref/packages/index.html

Requires a key to work https://yandex.ru/dev/maps/jsapi/doc/3.0/quickstart.html#get-api-key

In your project, you can include this package in order to simplify the development of packages for ymaps3 JS API. It won't completely get rid of the boilerplate, but it will at least allow you to inherit all the main configs.

Create ymaps3 package by template

npx @yandex/ymaps3-cli --name="ymaps3-my-super-pkg"

You can see the full list of options here:

npx @yandex/ymaps3-cli help

Or you can set up all elements of the package yourself, such as autotests, linting and building.

Manual

Install package @yandex/ymaps3-cli

npm i -D @yandex/ymaps3-cli#main

For development, you may also need types for the libraries you use:

npm i -D @types/got @types/jest @types/jsdom @types/react @yandex/ymaps3-types

Linting

Install eslint

npm i eslint prettier @typescript-eslint/eslint-plugin @typescript-eslint/parser eslint-config-prettier eslint-plugin-prettier -D

Create .eslintrc.js file:

module.exports = {
  extends: ['./node_modules/@yandex/ymaps3-cli/.eslintrc.js']
};

Create .prettierrc.js file:

const config = require("@yandex/ymaps3-cli/.prettierrc.json");

module.exports = {
  ...config
}

Build

Install webpack and typescript

npm i webpack webpack-cli webpack-dev-server css-loader style-loader terser-webpack-plugin ts-loader typescript -D

Create files webpack.config.js:

module.exports = (args, env, dir = process.cwd()) => {
  return require('@yandex/ymaps3-cli/webpack.config')(args, env, dir);
}

and tsconfig.json

{
  "extends": ["@yandex/ymaps3-cli"],
  "compilerOptions": {
    "typeRoots": ["./node_modules/@types", "./node_modules/@yandex"]
  }
}

Test

We use jest + jsdom:

npm i -D jest jsdom ts-jest got@11.8.6 dotenv cross-fetch identity-obj-proxy

And create jest.config.json file:

module.exports = {
  ...require('@yandex/ymaps3-cli/jest.config.js')
};