react-intl-lint 1.0.4 → 1.1.0

package/LICENSE.md

@@ -1,21 +1,21 @@
-# MIT License
-
-Copyright (c) 2018
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+# MIT License
+
+Copyright (c) 2018
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,229 +1,299 @@
-# react-intl-lint
-
-> Simple tools for check react-intl keys in whole app which use regexp.
-
-[![semantic](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)
-[![npm](https://img.shields.io/npm/v/react-intl-lint.svg)](https://www.npmjs.com/package/react-intl-lint)
-[![download npm](https://img.shields.io/npm/dm/react-intl-lint.svg)](https://www.npmjs.com/package/react-intl-lint)
-
-> for `react-i18next` use [`react-i18next-lint`](https://www.npmjs.com/package/react-i18next-lint)
-> 
-> for `ngx-translate` use [`ngx-translate-lint`](https://www.npmjs.com/package/ngx-translate-lint) 
-
-## Table of Contents
-
-- [Background](#background)
-- [Installation](#installation)
-- [Usage](#usage)
-    - [CLI](#cli)
-    - [TypeScript](#TypeScript)
-- [Contribute](#contribute)
-- [Used By](#UsedBy)
-- [License](#license)
-
-## Background
-
-There are a lot of translation `react-intl` keys in the whole app.
-This repository contains a proposal to check all translation keys in the whole app
-which should exist in all languages files.
-
-## Installation
-
-### NPM
-
-```bash
-npm install react-intl-lint -g
-```
-
-### GitHub
-
-The source code are available for download
-at [GitHub Releases][github-release-url] and
-[GitHub pages][github-pages-url] as well.
-
-## Usage
-
-### CLI
-
-```text
-
-Usage: react-intl-lint [options]
-
-Simple CLI tools for check `react-intl` keys in app
-
-Options:
-  -p,  --project [glob] (required)
-          The path to project folder
-          Possible Values: <relative path|absolute path>
-          (default: "./src/**/*.{html,ts,js}")
-  -l,  --languages [glob] (required)
-          The path to languages folder
-          Possible Values: <relative path|absolute path>
-          (default: "./src/assets/i18n/*.json")
-  -kv,  --keysOnViews [enum]
-          Described how to handle the error of missing keys on view
-          Possible Values: <disable|warning|error>
-          (default: "error")
-  -zk,  --zombieKeys [enum]
-          Described how to handle the error of zombies keys
-          Possible Values: <disable|warning|error>
-          (default: "warning")
-  -ek, --emptyKeys [enum]
-          Described how to handle empty value on translate keys
-          Possible Values: <disable|warning|error>
-           (default: "warning")
-  -i,  --ignore [glob]
-          Ignore projects and languages files
-          Possible Values: <relative path|absolute path>
-  --maxWarning [glob]
-          Max count of warnings in all files. If this value more that count of warnings, then an error is return
-          Possible Values: <number>
-           (default: "0")
-  -mk,  --misprintKeys [enum]
-          Try to find matches with misprint keys on views and languages keys. CCan be longer process!!
-          Possible Values: <disable|warning|error>
-           (default: "disable")
-  -ds,  --deepSearch [enum]
-          Add each translate key to global regexp end try to find them on project. Can be longer process!!
-          Possible Values: <disable|enable>
-           (default: "disable")
-  -mc, --misprintCoefficient [number]
-          Coefficient for misprint option can be from 0 to 1.0.
-          (default: "0.9")
-  -c, --config [path]
-          Path to the config file.
-
-
-  -V, --version   output the version number
-  -h, --help      output usage information
-
-
-Examples:
-
-    $ npx react-intl-lint  -p ./src/app/**/*.{html,ts,js} -l ./src/assets/i18n/*.json
-    $ react-intl-lint -p ./src/app/**/*.{html,ts,js} -l ./src/assets/i18n/*.json
-    $ react-intl-lint -p ./src/app/**/*.{html,ts,js} -z disable -v error
-```
-
-> NOTE: For `project` and `languages` options need to include file types like on the example.
-
-
-Default Config is:
-```json
-{
-    "rules": {
-        "keysOnViews": "error",
-        "zombieKeys": "warning",
-        "misprintKeys": "disable",
-        "deepSearch": "disable",
-        "emptyKeys": "warning",
-        "maxWarning": "0",
-        "misprintCoefficient": "0.9",
-        "ignoredKeys": [ "IGNORED.KEY.(.*)" ], // can be string or RegExp
-        "ignoredMisprintKeys": [],
-        "customRegExpToFindKeys": [ "(?<=marker\\(['\"])([A-Za-z0-9_\\-.]+)(?=['\"]\\))"], // to find: marker('TRSNLATE.KEY');
-    },
-    "project": "./src/app/**/*.{html,ts,js}",
-    "languages": "./src/assets/i18n/*.json"
-}
-```
-
-#### How to write Custom RegExp
-
-We have `(?<=marker\\(['\"])([A-Za-z0-9_\\-.]+)(?=['\"]\\))` RegExp witch contains of 3 parts:
-
-- Prefix - `(?<=marker\\(['\"])`
-   - This construction tells that what we need matching before translate key
-   - start with `(?<=` and end `)`.
-   - `marker\\(['\"]` - tells that we try to find word `market` witch have on the second character `'`or `"`
-   - To summarize, we are trying to find keys before each word to be `market` and commas `'` or `"`
-  
-- Matching for key: `([A-Za-z0-9_\\-.]+)`
-  - This construction tells that we find and save all words which contain alphabet, numbers, and `_` or `-`.
-  - We recommend using this part of RegExp to find and save translated keys
-  - But you can also use `(.*)` If it's enough for your project
-- Postfix - `(?=['\"]\\))` (the same as prefix, but need to be ended)
-  - This construction tells that what we need matching after translate key
-  - start with `(?=` and end `)`
-  - `['\"]\\)` - tells that we try to find word comas `'` or `"` and ended with `)`
-  - To summarize, we are trying to find keys ended each word to be commas `'` or `"` and `)`
-
-Example RegExp will find following keys
-  - `marker('TRSNLATE.KEY')`
-  - `marker("TRSNLATE.KEY-2")`
-
-#### Exit Codes
-
-The CLI process may exit with the following codes:
-
-- `0`: Linting succeeded without errors (warnings may have occurred)
-- `1`: Linting failed with one or more rule violations with severity error
-- `2`: An invalid command line argument or combination thereof was used
-
-### TypeScript
-
-```typescript
-import { ToggleRule, ReactintlLint, IRulesConfig, ResultCliModel, ErrorTypes, LanguagesModel } from 'react-intl-lint';
-
-const viewsPath: string = './src/app/**/*.{html,ts,js}';
-const languagesPath: string = './src/assets/i18n/*.json';
-const ignoredLanguagesPath: string = "./src/assets/i18n/ru.json, ./src/assets/i18n/ru-RU.json";
-const ruleConfig: IRulesConfig = {
-        keysOnViews: ErrorTypes.error,
-        zombieKeys: ErrorTypes.warning,
-        misprintKeys: ErrorTypes.disable,
-        deepSearch: ToggleRule.disable,
-        emptyKeys: ErrorTypes.warning,
-        maxWarning: 0,
-        misprintCoefficient: 0.9,
-        ignoredKeys: [ 'EXAMPLE.KEY', 'IGNORED.KEY.(.*)' ], // can be string or RegExp
-        ignoredMisprintKeys: [],
-        customRegExpToFindKeys: [ "(?<=marker\\(['\"])([A-Za-z0-9_\\-.]+)(?=['\"]\\))" ] // to find: marker('TRSNLATE.KEY');
-};
-
-const reactIntlLint = new ReactIntlLint(viewsPath, languagesPath, ignoredLanguagesPath, ruleConfig)
-const resultLint: ResultCliModel = reactIntlLint.lint(); // Run Lint
-const languages: LanguagesModel[] = reactIntlLint.getLanguages()  // Get Languages with all keys and views
-
-```
-
-#### NOTE!
-If you have error `Can't resolve 'fs' in ...`. Please add next setting to you project:
-
- - tsconfig.json
- ```json
-{
-    "skipLibCheck": true
-}
-```
-
-## Contribute
-
-You may contribute in several ways like requesting new features,
-adding tests, fixing bugs, improving documentation or examples.
-Please check our [contributing guidelines][contributing].
-
-## Used By
-
-Here can be your extensions
-
-## License
-
-[MIT][license-url]
-
-[react-intl]: https://formatjs.io/docs/getting-started/installation/
-[semantic-shield]: https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg
-[semantic-url]: https://github.com/semantic-release/semantic-release
-[npm-shield]: https://img.shields.io/npm/v/svoboda-rabstvo/react-intl-lint.svg
-[npm-url]: https://www.npmjs.com/package/react-intl-lint
-[npm]: https://www.npmjs.com
-[node-js]: https://nodejs.org
-[github-shield]: https://img.shields.io/github/release/svoboda-rabstvo/react-intl-lint.svg?label=github
-[github-url]: https://github.com/svoboda-rabstvo/react-intl-lint
-[github-release-url]: https://github.com/svoboda-rabstvo/react-intl-lint/releases
-[github-pages-url]: https://svoboda-rabstvo.github.io/react-intl-lint/
-[schema-url]: http://json-schema.org/
-[doc-url]: https://github.com/svoboda-rabstvo/react-intl-lint/blob/develop/doc
-[license-url]: https://github.com/svoboda-rabstvo/react-intl-lint/blob/develop/LICENSE.md
-[meta-url]: https://en.wikipedia.org/wiki/List_of_software_package_management_systems#Meta_package_managers
-[contributing]: https://github.com/svoboda-rabstvo/react-intl-lint/blob/develop/.github/CONTRIBUTING.md
+# react-intl-lint
+
+> Simple tools for check react-intl keys in whole app which use regexp.
+
+[![semantic](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)
+[![npm](https://img.shields.io/npm/v/react-intl-lint.svg)](https://www.npmjs.com/package/react-intl-lint)
+[![download npm](https://img.shields.io/npm/dm/react-intl-lint.svg)](https://www.npmjs.com/package/react-intl-lint)
+
+> for `react-i18next` use [`react-i18next-lint`](https://www.npmjs.com/package/react-i18next-lint)
+> 
+> for `ngx-translate` use [`ngx-translate-lint`](https://www.npmjs.com/package/ngx-translate-lint) 
+
+
+## Table of Contents
+
+- [Background](#background)
+- [Installation](#installation)
+- [Usage](#usage)
+    - [CLI](#cli)
+    - [TypeScript](#TypeScript)
+- [Contribute](#contribute)
+- [Used By](#UsedBy)
+- [License](#license)
+
+## Background
+
+There are a lot of translation `react-intl` keys in the whole app.
+This repository contains a proposal to check all translation keys in the whole app
+which should exist in all languages files.
+
+## Installation
+
+### NPM
+
+```bash
+npm install react-intl-lint -g
+```
+
+### GitHub
+
+The source code are available for download
+at [GitHub Releases][github-release-url] and
+[GitHub pages][github-pages-url] as well.
+
+## Usage
+
+### CLI
+
+```text
+
+Usage: react-intl-lint [options]
+
+Simple CLI tools for check `react-intl` keys in app
+
+Options:
+  -p, --project [glob]                   
+          The path to project folder
+          Possible Values: <relative path|absolute path>
+          
+  -l, --languages [glob]                 
+          The path to languages folder
+          Possible Values: <relative path|absolute path|URL>
+          
+  --kv, --keysOnViews [enum]             
+          Described how to handle the error of missing keys on view
+          Possible Values: <disable|warning|error>
+          
+  --zk, --zombieKeys [enum]              
+          Described how to handle the error of zombies keys. Zombie keys are keys that doesn't exist on any languages file but exist on project, or exist languages but doesn't exist on project
+          Possible Values: <disable|warning|error>
+          
+  --ek, --emptyKeys [enum]               
+          Described how to handle empty value on translate keys. Empty keys are keys that doesn't have any value on languages files
+          Possible Values: <disable|warning|error>
+          
+  -i, --ignore [glob]                    
+          Ignore projects and languages files
+          Possible Values: <relative path|absolute path>
+          
+  --maxWarning [glob]                    
+          Max count of warnings in all files. If this value more that count of warnings, then an error is return
+          Possible Values: <number>
+          
+  --mk, --misprintKeys [enum]            
+          Try to find matches with misprint keys on views and languages keys. Coefficient: 0.9. Can be longer process!!
+          Possible Values: <disable|warning|error>
+          
+  --ds, --deepSearch [enum]              
+          Add each translate key to global regexp end try to find them on project. Can be longer process!!
+          Possible Values: <disable|enable>
+          
+  --mc, --misprintCoefficient [number]   
+          Coefficient for misprint option can be from 0 to 1.0.
+          
+          
+  -c, --config [path]                    
+          Path to config via JSON or JS file
+          Possible Values: <relative path|absolute path>
+          
+  --fz, --fixZombiesKeys [boolean]       
+          Auto fix zombies keys on languages files
+          
+          
+  -v, --version                          Print current version of react-intl-lint
+  -h, --help                             display help for command
+
+
+Examples:
+
+    $ npx react-intl-lint  -p ./src/app/**/*.{html,ts,js} -l ./src/assets/i18n/*.json
+    $ react-intl-lint -p ./src/app/**/*.{html,ts,js} -l ./src/assets/i18n/*.json
+    $ react-intl-lint -p ./src/app/**/*.{html,ts,js} -z disable -v error
+    $ react-intl-lint -p ./src/app/**/*.{html,ts,js} -l https://8.8.8.8/locales/EN-eu.json
+```
+
+> NOTE: For `project` and `languages` options need to include file types like on the example.
+
+Default JSON Config is:
+```json
+{
+    "rules": {
+        "keysOnViews": "error",
+        "zombieKeys": "warning",
+        "misprintKeys": "disable",
+        "deepSearch": "disable",
+        "emptyKeys": "warning",
+        "maxWarning": "0",
+        "misprintCoefficient": "0.9",
+        "ignoredKeys": [ "IGNORED.KEY.(.*)" ], // can be string or RegExp
+        "ignoredMisprintKeys": [],
+        "customRegExpToFindKeys": [ "(?<=marker\\(['\"])([A-Za-z0-9_\\-.]+)(?=['\"]\\))"], // to find: marker('TRSNLATE.KEY');
+    },
+    "fetch": {
+        "requestQuery": "",
+        "requestHeaders": {},
+        "responseQuery": ""
+    },
+    "fixZombiesKeys": false,
+    "project": "./src/app/**/*.{html,ts}",
+    "languages": "./src/assets/i18n/*.json"
+}
+```
+
+JS Config should have `default` export via object like config. See example:
+
+Example JS config is:
+```javascript
+
+const config = {
+    rules: {
+        keysOnViews: "error",
+        zombieKeys: "warning",
+        emptyKeys: "warning",
+        misprint: {
+            type: "warning",
+            coefficient: 0.9
+        },
+        ignoredKeys: [],
+        ignoredMisprintKeys: []
+    },
+    fetch: {
+        requestQuery: "",
+        requestHeaders: {},
+        responseQuery: "",
+        get: async () => {
+            const requestOne = fetch('https://8.8.8.8/locales/EN-eu.json');
+            const requestTwo = fetch('https://8.8.8.8/locales/EN-us.json');
+            const result = await Promise.all([requestOne, requestTwo]).then(async ([responseOne, responseTwo]) => {
+                return {
+                    ...(await responseOne.json()),
+                    ...(await  responseTwo.json())
+                }
+            });
+            // NOTE: result should contains only translation keys. Example 
+            // {
+            //   "translation.key": "value"
+            // }
+            return result;
+        }
+    },
+    fixZombiesKeys: false,
+    project: "./src/app/**/*.{html,ts}",
+    languages: "./src/assets/i18n/*.json"
+}
+
+export default config;
+```
+
+#### How to write Custom RegExp
+
+We have `(?<=marker\\(['\"])([A-Za-z0-9_\\-.]+)(?=['\"]\\))` RegExp witch contains of 3 parts:
+
+- Prefix - `(?<=marker\\(['\"])`
+    - This construction tells that what we need matching before translate key
+    - start with `(?<=` and end `)`.
+    - `marker\\(['\"]` - tells that we try to find word `market` witch have on the second character `'`or `"`
+    - To summarize, we are trying to find keys before each word to be `market` and commas `'` or `"`
+
+- Matching for key: `([A-Za-z0-9_\\-.]+)`
+    - This construction tells that we find and save all words which contain alphabet, numbers, and `_` or `-`.
+    - We recommend using this part of RegExp to find and save translated keys
+    - But you can also use `(.*)` If it's enough for your project
+- Postfix - `(?=['\"]\\))` (the same as prefix, but need to be ended)
+    - This construction tells that what we need matching after translate key
+    - start with `(?=` and end `)`
+    - `['\"]\\)` - tells that we try to find word comas `'` or `"` and ended with `)`
+    - To summarize, we are trying to find keys ended each word to be commas `'` or `"` and `)`
+
+Example RegExp will find following keys
+- `marker('TRSNLATE.KEY')`
+- `marker("TRSNLATE.KEY-2")`
+
+#### Exit Codes
+
+The CLI process may exit with the following codes:
+
+- `0`: Linting succeeded without errors (warnings may have occurred)
+- `1`: Linting failed with one or more rule violations with severity error
+- `2`: An invalid command line argument or combination thereof was used
+
+### TypeScript
+
+```typescript
+import {
+    ToggleRule,
+    NgxTranslateLint,
+    IRulesConfig,
+    ResultCliModel,
+    ErrorTypes,
+    LanguagesModel,
+    IFetch,
+    ngxTranslateRegEx,
+} from 'ngx-translate-lint';
+
+const viewsPath: string = './src/app/**/*.{html,ts}';
+const languagesPath: string = './src/assets/i18n/*.json';
+const ignoredLanguagesPath: string = "./src/assets/i18n/ru.json, ./src/assets/i18n/ru-RU.json";
+const ruleConfig: IRulesConfig = {
+    keysOnViews: ErrorTypes.error,
+    zombieKeys: ErrorTypes.warning,
+    misprintKeys: ErrorTypes.disable,
+    deepSearch: ToggleRule.disable,
+    emptyKeys: ErrorTypes.warning,
+    maxWarning: 0,
+    misprintCoefficient: 0.9,
+    fixZombiesKeys: false,
+    ignoredKeys: ['EXAMPLE.KEY', 'IGNORED.KEY.(.*)'], // can be string or RegExp
+    ignoredMisprintKeys: [],
+    customRegExpToFindKeys: ["(?<=marker\\(['\"])([A-Za-z0-9_\\-.]+)(?=['\"]\\))"] // to find: marker('TRSNLATE.KEY');
+};
+const fixZombiesKeys: boolean = false;
+const fetchSettings: IFetch = {
+    requestQuery: "",
+    requestHeaders: {},
+    responseQuery: "",
+    get: () => {
+        // You fetch to get locales
+    }
+};
+const ngxTranslateRegEx: ngxTranslateRegEx = ngxTranslateRegEx; // Here can be your array of regexp to find keys
+const ngxTranslateLint = new NgxTranslateLint(viewsPath, languagesPath, ignoredLanguagesPath, ruleConfig, fixZombiesKeys, fetchSettings, ngxTranslateRegEx)
+const resultLint: ResultCliModel = ngxTranslateLint.lint(); // Run Lint
+const languages: LanguagesModel[] = ngxTranslateLint.getLanguages()  // Get Languages with all keys and views
+
+```
+
+## Contribute
+
+You may contribute in several ways like requesting new features,
+adding tests, fixing bugs, improving documentation or examples.
+Please check our [contributing guidelines][contributing].
+
+## Used By
+
+Here can be your extensions:
+
+- [ngx-translate-editor](https://github.com/svoboda-rabstvo/ngx-translate-editor) - Simple GUI for CRUD translate keys of ngx-translate, which included ngx-translate-lint
+- [121 Platform](https://github.com/global-121/121-platform) - 121 is an open source platform for Cash based Aid built with Digital Identity & Local/Global Financial service partners.
+
+## License
+
+[MIT][license-url]
+
+[react-intl]: https://formatjs.io/docs/getting-started/installation/
+[semantic-shield]: https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg
+[semantic-url]: https://github.com/semantic-release/semantic-release
+[npm-shield]: https://img.shields.io/npm/v/svoboda-rabstvo/react-intl-lint.svg
+[npm-url]: https://www.npmjs.com/package/react-intl-lint
+[npm]: https://www.npmjs.com
+[node-js]: https://nodejs.org
+[github-shield]: https://img.shields.io/github/release/svoboda-rabstvo/react-intl-lint.svg?label=github
+[github-url]: https://github.com/svoboda-rabstvo/react-intl-lint
+[github-release-url]: https://github.com/svoboda-rabstvo/react-intl-lint/releases
+[github-pages-url]: https://svoboda-rabstvo.github.io/react-intl-lint/
+[schema-url]: http://json-schema.org/
+[doc-url]: https://github.com/svoboda-rabstvo/react-intl-lint/blob/develop/doc
+[license-url]: https://github.com/svoboda-rabstvo/react-intl-lint/blob/develop/LICENSE.md
+[meta-url]: https://en.wikipedia.org/wiki/List_of_software_package_management_systems#Meta_package_managers
+[contributing]: https://github.com/svoboda-rabstvo/react-intl-lint/blob/develop/.github/CONTRIBUTING.md

package/dist/bin.d.ts

@@ -1,2 +1,2 @@
-#!/usr/bin/env node
-import './src/cli/bin';
+#!/usr/bin/env node
+import './src/cli/bin';

package/dist/bin.js

@@ -1,5 +1,5 @@
-#!/usr/bin/env node
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-require("./src/cli/bin");
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+require("./src/cli/bin");
 //# sourceMappingURL=bin.js.map