├── icon.png
├── source
    ├── index.ts
    ├── nestable
    │   ├── index.ts
    │   ├── data.ts
    │   ├── array.ts
    │   ├── key_value.ts
    │   └── table.ts
    ├── first-class
    │   ├── index.ts
    │   ├── comment.ts
    │   ├── literal.ts
    │   ├── datetime.ts
    │   ├── string.ts
    │   └── number.ts
    └── build.ts
├── extension
    ├── extension-browser.ts
    ├── extension.ts
    ├── toml.configuration.json
    └── toml.tmLanguage.json
├── .vscodeignore
├── .gitignore
├── tslint.json
├── test
    ├── showtime.toml
    └── readme.toml
├── README.md
├── package.json
├── tsconfig.json
└── License.md


/icon.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/oovm/vscode-toml/HEAD/icon.png


--------------------------------------------------------------------------------
/source/index.ts:
--------------------------------------------------------------------------------
1 | export * from './first-class'
2 | export * from './nestable'


--------------------------------------------------------------------------------
/extension/extension-browser.ts:
--------------------------------------------------------------------------------
1 | export function activate() {
2 |   /* NOP for browser */
3 | }
4 | 


--------------------------------------------------------------------------------
/.vscodeignore:
--------------------------------------------------------------------------------
1 | node_modules/
2 | !node_modules/toml_vscode/
3 | source/
4 | test/
5 | extension/extension.ts


--------------------------------------------------------------------------------
/source/nestable/index.ts:
--------------------------------------------------------------------------------
1 | export * from './array'
2 | export * from './table'
3 | export * from './data'
4 | export * from './key_value'


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
 1 | # IDEs
 2 | .vscode
 3 | .idea
 4 | .vs
 5 | 
 6 | # Bin
 7 | *.vsix
 8 | 
 9 | # Node
10 | node_modules
11 | dist/
12 | yarn.lock
13 | yarn-error.log


--------------------------------------------------------------------------------
/source/first-class/index.ts:
--------------------------------------------------------------------------------
1 | export * from './literal'
2 | export * from './number'
3 | export * from './string'
4 | export * from './datetime'
5 | export * from './comment'
6 | 
7 | 


--------------------------------------------------------------------------------
/source/nestable/data.ts:
--------------------------------------------------------------------------------
1 | import { string, datetime, boolean, number, illegal } from '../first-class'
2 | import { array } from './array'
3 | import { table_inline } from './table'
4 | 
5 | export const data: any = {
6 |     patterns: [].concat(table_inline, array, string, datetime, boolean, number),
7 | }


--------------------------------------------------------------------------------
/source/first-class/comment.ts:
--------------------------------------------------------------------------------
 1 | export const comment: any = {
 2 |     captures: {
 3 |         1: {
 4 |             name: 'comment.line.number-sign.toml',
 5 |         },
 6 |         2: {
 7 |             name: 'punctuation.definition.comment.toml',
 8 |         },
 9 |     },
10 |     comment: 'Comments',
11 |     match: '\\s*((#).*)$',
12 | }


--------------------------------------------------------------------------------
/source/first-class/literal.ts:
--------------------------------------------------------------------------------
 1 | export const boolean: any = [
 2 |     {
 3 |         match: '(?<!\\w)(true|false)(?!\\w)',
 4 |         captures: {
 5 |             1: {
 6 |                 name: 'constant.other.boolean.toml',
 7 |             },
 8 |         },
 9 |     },
10 | ]
11 | export const illegal: any = {
12 |     captures: {
13 |         1: {
14 |             name: 'invalid.illegal.toml',
15 |         },
16 |     },
17 |     match: '(.*)',
18 | }


--------------------------------------------------------------------------------
/source/nestable/array.ts:
--------------------------------------------------------------------------------
 1 | export const array: any = {
 2 |     begin: '(?<!\\w)(\\[)\\s*',
 3 |     beginCaptures: {
 4 |         1: {
 5 |             name: 'punctuation.definition.array.toml',
 6 |         },
 7 |     },
 8 |     end: '\\s*(\\])(?!\\w)',
 9 |     endCaptures: {
10 |         1: {
11 |             name: 'punctuation.definition.array.toml',
12 |         },
13 |     },
14 |     patterns: [
15 |         {
16 |             include: '#comment',
17 |         },
18 |         {
19 |             include: '#data',
20 |         },
21 |     ],
22 | }


--------------------------------------------------------------------------------
/extension/extension.ts:
--------------------------------------------------------------------------------
 1 | import * as vscode from 'vscode'
 2 | import { rs_format } from 'toml_vscode'
 3 | 
 4 | export function activate(context: vscode.ExtensionContext) {
 5 |     // 👍 formatter implemented using API
 6 |     vscode.languages.registerDocumentFormattingEditProvider('toml', {
 7 |         provideDocumentFormattingEdits(document: vscode.TextDocument): vscode.TextEdit[] {
 8 |             const text = document.getText()
 9 |             const start = document.lineAt(0).range.start
10 |             const end = document.lineAt(document.lineCount - 1).range.end
11 |             const r = new vscode.Range(start, end)
12 |             return [vscode.TextEdit.replace(r, rs_format(text))]
13 |         },
14 |     })
15 | }
16 | 


--------------------------------------------------------------------------------
/extension/toml.configuration.json:
--------------------------------------------------------------------------------
 1 | {
 2 | 	"comments": {
 3 | 		"lineComment": "#"
 4 | 	},
 5 | 	"brackets": [
 6 | 		["{", "}"],
 7 | 		["[", "]"],
 8 | 		["(", ")"]
 9 | 	],
10 | 	"autoClosingPairs": [
11 | 		{ "open": "{", "close": "}" },
12 | 		{ "open": "[", "close": "]" },
13 | 		{ "open": "(", "close": ")" },
14 | 		{ "open": "'", "close": "'", "notIn": ["string"] },
15 | 		{ "open": "\"", "close": "\"", "notIn": ["string"] }
16 | 	],
17 | 	"surroundingPairs": [
18 |         ["\"", "\""],
19 | 		["{", "}"],
20 | 		["[", "]"],
21 | 		["(", ")"],
22 | 		["'", "'"],
23 | 		["`", "`"],
24 |         ["<", ">"]
25 | 	],
26 |     "autoCloseBefore": ";:.,=}])>` \n\t",
27 |     "folding": {
28 |         "markers": {
29 |             "start": "^\\s*//\\s*#?region\\b",
30 |             "end": "^\\s*//\\s*#?endregion\\b"
31 |         }
32 |     }
33 | }


--------------------------------------------------------------------------------
/tslint.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "rules": {
 3 |         "semicolon": [
 4 |             true,
 5 |             "never"
 6 |         ],
 7 |         "quotemark": [
 8 |             true,
 9 |             "single",
10 |             "avoid-escape",
11 |             "avoid-template"
12 |         ],
13 |         "indent": [
14 |             true,
15 |             "spaces",
16 |             4
17 |         ],
18 |         "object-literal-key-quotes": [
19 |             true,
20 |             "consistent-as-needed"
21 |         ],
22 |         "no-var-requires": true,
23 |         "member-access": false,
24 |         "trailing-comma": [
25 |             true,
26 |             {
27 |                 "multiline": "always",
28 |                 "singleline": "never"
29 |             }
30 |         ]
31 |     },
32 |     "linterOptions": {
33 |         "exclude": [
34 |             "dist/**",
35 |             "node_modules/**",
36 |             "*.d.ts"
37 |         ]
38 |     }
39 | }


--------------------------------------------------------------------------------
/source/first-class/datetime.ts:
--------------------------------------------------------------------------------
 1 | const local_time = {
 2 |     name: 'constant.other.time.toml',
 3 |     match: /\d{2}:\d{2}:\d{2}(?:\.\d+)?/.source,
 4 | }
 5 | 
 6 | const local_date = {
 7 |     name: 'constant.other.date.toml',
 8 |     match: /\d{4}\-\d{2}\-\d{2}/.source,
 9 | }
10 | 
11 | const local_date_time = {
12 |     captures: {
13 |         1: {
14 |             name: 'constant.other.datetime.local.toml',
15 |         },
16 |     },
17 |     match: '(\\d{4}\\-\\d{2}\\-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?)',
18 | }
19 | 
20 | const offset_date_time = {
21 |     captures: {
22 |         1: {
23 |             name: 'constant.other.datetime.offset.toml',
24 |         },
25 |     },
26 |     match: '(?<!\\w)(\\d{4}\\-\\d{2}\\-\\d{2}[T| ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[\\+\\-]\\d{2}:\\d{2}))(?!\\w)',
27 | }
28 | 
29 | //ordered, must reverse
30 | export const datetime: any = [
31 |     offset_date_time,
32 |     local_date_time,
33 |     local_date,
34 |     local_time,
35 | ]
36 | 
37 | 


--------------------------------------------------------------------------------
/test/showtime.toml:
--------------------------------------------------------------------------------
 1 | [String]
 2 | singleline = "this is a new line"
 3 | multiline  = """
 4 | \b     - backspace       (U+0008)
 5 | \t     - tab             (U+0009)
 6 | \n     - linefeed        (U+000A)
 7 | \f     - form feed       (U+000C)
 8 | \r     - carriage return (U+000D)
 9 | \"     - quote           (U+0022)
10 | \u1234 - unicode         (U+1234)
11 | """
12 | 
13 | [Number]
14 | int1 = +5349221
15 | int2 = -5_3_49_221
16 | fp1  = +6.626e-34
17 | fp2  = 224_617.445_991_228
18 | sf1  = -inf # negative infinity
19 | sf2  = +nan # not a number
20 | 
21 | [DateTime]
22 | ld1  = 1979-05-27           # Local Date
23 | lt1  = 07:32:00             # Local Time
24 | ldt1 = 1979-05-27T07:32:00  # Local Date-Time
25 | odt1 = 1979-05-27 07:32:00Z # Offset Date-Time
26 | 
27 | [Array]
28 | array = [[1, 2], ["a", "b", "c"]]
29 | inlineTable = [
30 |     { x = 1, y = 2, z = 3 },
31 |     { x = 7, y = 8, z = 9 },
32 |     { x = 2, y = 4, z = 8 },
33 | ]
34 | 
35 | 
36 | 
37 | 
38 | 
39 | 
40 | 
41 | 
42 | 


--------------------------------------------------------------------------------
/source/build.ts:
--------------------------------------------------------------------------------
 1 | import * as path from 'path'
 2 | import { writeFileSync, readFileSync } from 'fs'
 3 | import { data, comment, table, key_value, illegal } from '.'
 4 | function including(_: string) { return { include: '#' + _ } }
 5 | 
 6 | function getVersion() {
 7 |     const json = readFileSync(path.resolve(__dirname, '..', 'package.json'))
 8 |     return 'v' + JSON.parse(json.toString()).version
 9 | }
10 | 
11 | const syntax = {
12 |     version: getVersion(),
13 |     scopeName: 'source.toml',
14 |     uuid: '9b00c027-8f13-4f5a-a57e-d90478a1f817',
15 |     information_for_contributors: [
16 |         'aster: galaster@foxmail.com',
17 |     ],
18 |     patterns: [
19 |         including('comment'),
20 |         including('table'),
21 |         including('key_value'),
22 |     ],
23 |     repository: {
24 |         comment: comment,
25 |         table: table,
26 |         key_value: key_value,
27 |         data: data,
28 |         illegal: illegal,
29 |     },
30 | }
31 | 
32 | writeFileSync(
33 |     path.resolve(__dirname, '..') + '/extension/toml.tmLanguage.json',
34 |     JSON.stringify(syntax, null, 4),
35 | )
36 | 


--------------------------------------------------------------------------------
/source/first-class/string.ts:
--------------------------------------------------------------------------------
 1 | const escape = [
 2 |     {
 3 |         match: '\\\\([btnfr"\\\\\\n/ ]|u[0-9A-Fa-f]{4}|U[0-9A-Fa-f]{8})',
 4 |         name: 'constant.character.escape.toml',
 5 |     },
 6 |     {
 7 |         match: '\\\\[^btnfr/"\\\\\\n]',
 8 |         name: 'invalid.illegal.escape.toml',
 9 |     },
10 | ]
11 | const string_single = {
12 |     name: 'string.quoted.single.basic.line.toml',
13 |     match: '"[^"\\\\]*(?:\\\\.[^"\\\\]*)*"',
14 |     patterns: escape,
15 | }
16 | const string_block = {
17 |     name: 'string.quoted.triple.basic.block.toml',
18 |     begin: '"""',
19 |     end: '"""',
20 |     patterns: escape,
21 | }
22 | // do not need escape characters
23 | const literal_string_single = {
24 |     name: 'string.quoted.single.literal.line.toml',
25 |     match: "'.*?'",
26 | }
27 | const literal_string_block = {
28 |     name: 'string.quoted.triple.literal.block.toml',
29 |     begin: "'''",
30 |     end: "'''",
31 | }
32 | 
33 | //ordered, block must before single
34 | export const string: any = [
35 |     string_block,
36 |     string_single,
37 |     literal_string_block,
38 |     literal_string_single,
39 | ]


--------------------------------------------------------------------------------
/source/nestable/key_value.ts:
--------------------------------------------------------------------------------
 1 | export const key_value: any = {
 2 |     patterns: [
 3 |         {
 4 |             name: 'invalid.illegal.noKey.toml',
 5 |             match: '(\\s*=.*)$',
 6 |         },
 7 |         {
 8 |             name: 'invalid.deprecated.noValue.toml',
 9 |             match: '(\\s*[A-Za-z_\\-][A-Za-z0-9_\\-]*\\s*=)(?=\\s*$)',
10 |         },
11 |         {
12 |             begin: "\\s*([A-Za-z_-][A-Za-z0-9_-]*|\".+\"|'.+'|[0-9]+)\\s*(=)\\s*",
13 |             beginCaptures: {
14 |                 1: {
15 |                     name: 'entity.name.tag.toml',
16 |                 },
17 |                 2: {
18 |                     name: 'punctuation.definition.keyValue.toml',
19 |                 },
20 |             },
21 |             end: '($|(?==)|\\,|\\s*(?=\\}))',
22 |             patterns: [
23 |                 {
24 |                     include: '#comment',
25 |                 },
26 |                 {
27 |                     include: '#data',
28 |                 },
29 |                 {
30 |                     include: '#illegal',
31 |                 },
32 |             ],
33 |         },
34 |     ],
35 | }


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | TOML support for vscode
 2 | =======================
 3 | [![Site](https://img.shields.io/badge/TOML-v1.0-%23FF4D5B.svg?style=flat-square)](https://github.com/toml-lang/toml)
 4 | [![LICENSE](https://img.shields.io/badge/license-Anti%20996-blue.svg?style=flat-square)](https://github.com/996icu/996.ICU/blob/master/LICENSE)
 5 | [![LICENSE](https://img.shields.io/badge/license-MPL%202.0-blue.svg?style=flat-square)](https://github.com/GalAster/vscode-toml/blob/master/License.md)
 6 | 
 7 | *Tom's Obvious Minimal Language*
 8 | 
 9 | https://github.com/GalAster/vscode-toml
10 | 
11 | ## Todo List
12 | 
13 | - [x] TOML Formatter
14 | - [x] Support v1.0
15 | - [ ] Json to Toml
16 | - [ ] Yaml to Toml
17 | 
18 | LSP is not included in the plan of this project, if you want a better dynamic interactive experience, please try [Even Better Toml](https://marketplace.visualstudio.com/items?itemName=tamasfe.even-better-toml)!
19 | 
20 | ## Theme Compatibility
21 | 
22 | Highlighting is compatible with all themes, but the visual experience will be affected by the theme.
23 | 
24 | Main development environment was under [Flatland Monokai](https://marketplace.visualstudio.com/items?itemName=gerane.Theme-FlatlandMonokai).
25 | 
26 | ![Flatland Monokai](https://user-images.githubusercontent.com/17541209/56551634-76ec5400-65bb-11e9-84d0-5771027b1513.png)
27 | 
28 | And we review the visual experience under: Dark, OneDarkPro, Monokai, Electron
29 | 
30 | There also a specialized theme for TOML: [Nyx](https://marketplace.visualstudio.com/items?itemName=Aster.nyx-theme)
31 | 
32 | ![Nyx](https://user-images.githubusercontent.com/17541209/56551632-76ec5400-65bb-11e9-97f4-0764a3dfabd4.png)
33 | 
34 | ## Limitation
35 | The plugin only provide static lexical highlighting, so it can't find all the invaild inputs.
36 | 


--------------------------------------------------------------------------------
/source/first-class/number.ts:
--------------------------------------------------------------------------------
 1 | const integer = {
 2 |     match: '(?<!\\w)((?:[\\+\\-]?(0|([1-9](([0-9]|_[0-9])+)?))))(?!\\w)',
 3 |     captures: {
 4 |         1: {
 5 |             name: 'constant.numeric.integer.toml',
 6 |         },
 7 |     },
 8 | }
 9 | const float = {
10 |     match: '(?<!\\w)([\\+\\-]?(0|([1-9](([0-9]|_[0-9])+)?))(?:(?:\\.(0|([1-9](([0-9]|_[0-9])+)?)))?[eE][\\+\\-]?[1-9]_?[0-9]*|(?:\\.[0-9_]*)))(?!\\w)',
11 |     captures: {
12 |         1: {
13 |             name: 'constant.numeric.float.toml',
14 |         },
15 |     },
16 | }
17 | const sp = [
18 |     {
19 |         match: '(?<!\\w)([\\+\\-]?inf)(?!\\w)',
20 |         captures: {
21 |             1: {
22 |                 name: 'constant.numeric.inf.toml',
23 |             },
24 |         },
25 |     },
26 |     {
27 |         match: '(?<!\\w)([\\+\\-]?nan)(?!\\w)',
28 |         captures: {
29 |             1: {
30 |                 name: 'constant.numeric.nan.toml',
31 |             },
32 |         },
33 |     }
34 | ]
35 | const leading0 = [
36 |     {
37 |         match: '(?<!\\w)((?:0x(([0-9a-fA-F](([0-9a-fA-F]|_[0-9a-fA-F])+)?))))(?!\\w)',
38 |         captures: {
39 |             1: {
40 |                 name: 'constant.numeric.hex.toml',
41 |             },
42 |         },
43 |     },
44 |     {
45 |         match: /(?<!\w)(0o[0-7](_?[0-7])*)(?!\w)/.source,
46 |         captures: {
47 |             1: {
48 |                 name: 'constant.numeric.oct.toml',
49 |             },
50 |         },
51 |     },
52 |     {
53 |         match: /(?<!\w)(0b[01](_?[01])*)(?!\w)/.source,
54 |         captures: {
55 |             1: {
56 |                 name: 'constant.numeric.bin.toml',
57 |             },
58 |         },
59 |     }
60 | ]
61 | //ordered, float before integer
62 | export const number: any = [float, integer]
63 |     .concat(sp, leading0)


--------------------------------------------------------------------------------
/source/nestable/table.ts:
--------------------------------------------------------------------------------
 1 | const table_basic: any = {
 2 |     captures: {
 3 |         1: {
 4 |             name: 'punctuation.definition.table.toml',
 5 |         },
 6 |         2: {
 7 |             patterns: [
 8 |                 {
 9 |                     match: '[^\\s.]+',
10 |                     name: 'entity.other.attribute-name.table.toml',
11 |                 },
12 |             ],
13 |         },
14 |         3: {
15 |             name: 'punctuation.definition.table.toml',
16 |         },
17 |     },
18 |     match: '^\\s*(\\[)([^\\[\\]]*)(\\])',
19 |     name: 'meta.tag.table.toml',
20 | }
21 | 
22 | const table_array: any = {
23 |     name: 'meta.tag.table.array.toml',
24 |     match: '^\\s*(\\[\\[)([^\\[\\]]*)(\\]\\])',
25 |     captures: {
26 |         1: {
27 |             name: 'punctuation.definition.table.array.toml',
28 |         },
29 |         2: {
30 |             patterns: [
31 |                 {
32 |                     match: '[^\\s.]+',
33 |                     name: 'entity.other.attribute-name.table.array.toml',
34 |                 },
35 |             ],
36 |         },
37 |         3: {
38 |             name: 'punctuation.definition.table.array.toml',
39 |         },
40 |     },
41 | }
42 | 
43 | export const table_inline: any = {
44 |     begin: '(?<!\\w)(\\{)\\s*',
45 |     beginCaptures: {
46 |         1: {
47 |             name: 'punctuation.definition.table.inline.toml',
48 |         },
49 |     },
50 |     end: '\\s*(\\})(?!\\w)',
51 |     endCaptures: {
52 |         1: {
53 |             name: 'punctuation.definition.table.inline.toml',
54 |         },
55 |     },
56 |     patterns: [
57 |         {
58 |             include: '#key_value',
59 |         },
60 |         {
61 |             include: '#data',
62 |         },
63 |     ],
64 | }
65 | 
66 | export const table: any = {
67 |     patterns: [
68 |         table_basic,
69 |         table_array,
70 |         table_inline,
71 |     ],
72 | }


--------------------------------------------------------------------------------
/package.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "name": "toml",
 3 |     "displayName": "TOML Language Support",
 4 |     "description": "TOML language support",
 5 |     "version": "0.6.0",
 6 |     "publisher": "be5invis",
 7 |     "repository": {
 8 |         "type": "git",
 9 |         "url": "https://github.com/GalAster/vscode-toml.git"
10 |     },
11 |     "engines": {
12 |         "vscode": "^1.8.0"
13 |     },
14 |     "main": "./dist/extension.js",
15 |     "browser": "./dist/extension-browser.js",
16 |     "activationEvents": [
17 |         "onLanguage:toml"
18 |     ],
19 |     "categories": [
20 |         "Programming Languages",
21 |         "Formatters"
22 |     ],
23 |     "scripts": {
24 |         "build": "ts-node source/build.ts && tsc",
25 |         "lint": "tslint **/*.ts --fix"
26 |     },
27 |     "contributes": {
28 |         "languages": [
29 |             {
30 |                 "id": "toml",
31 |                 "aliases": [
32 |                     "TOML"
33 |                 ],
34 |                 "extensions": [
35 |                     ".toml",
36 |                     ".tml"
37 |                 ],
38 |                 "filenames": [
39 |                     "Cargo.lock",
40 |                     "Gopkg.lock"
41 |                 ],
42 |                 "mimetypes": [
43 |                     "text/x-toml"
44 |                 ],
45 |                 "configuration": "./extension/toml.configuration.json"
46 |             }
47 |         ],
48 |         "grammars": [
49 |             {
50 |                 "language": "toml",
51 |                 "scopeName": "source.toml",
52 |                 "path": "./extension/toml.tmLanguage.json"
53 |             }
54 |         ]
55 |     },
56 |     "dependencies": {
57 |         "toml_vscode": "^0.1.3"
58 |     },
59 |     "devDependencies": {
60 |         "@types/node": "^13.7.6",
61 |         "ts-node": "^10.4.0",
62 |         "typescript": "^4.4.4",
63 |         "vscode": "^1.1.37"
64 |     }
65 | }
66 | 


--------------------------------------------------------------------------------
/test/readme.toml:
--------------------------------------------------------------------------------
  1 | # This is a TOML document.
  2 | title = "TOML Example"
  3 | 
  4 | 
  5 | [database]
  6 | server = "192.168.1.1"
  7 | ports = [8001, 8001, 8002]
  8 | connection_max = 5000
  9 | 
 10 | 
 11 | [servers]
 12 | [servers.alpha]
 13 | ip = "10.0.0.1"
 14 | pw = "纸曲笔伏霍音起"
 15 | enabled = true
 16 | [servers.beta]
 17 | ip = "10.0.0.2"
 18 | pw = "疑似圣驾过丽沟"
 19 | enabled = ture  # ❌
 20 | 
 21 | [clients]
 22 | data = [["gamma", "delta"], [1, 2]]
 23 | # Line breaks are OK when inside arrays
 24 | hosts = [
 25 |   "alpha",
 26 |   "omega", # Comment available here
 27 | ]
 28 | 
 29 | 
 30 | [String]
 31 | singleline = "I'm a string. \"You can quote me\". Name\tJos\u00E9\nLocation\tSF."
 32 | multiline = """
 33 | \b     - backspace       (U+0008)
 34 | \t     - tab             (U+0009)
 35 | \n     - linefeed        (U+000A)
 36 | \f     - form feed       (U+000C)
 37 | \r     - carriage return (U+000D)
 38 | \"     - quote           (U+0022)
 39 | \/     - slash           (U+002F)
 40 | \\     - backslash       (U+005C)
 41 | \u1234 - unicode         (U+1234)
 42 | """
 43 | 
 44 | literal = '''
 45 | \b     - backspace       (U+0008)
 46 | \t     - tab             (U+0009)
 47 | \n     - linefeed        (U+000A)
 48 | \f     - form feed       (U+000C)
 49 | \r     - carriage return (U+000D)
 50 | \"     - quote           (U+0022)
 51 | \/     - slash           (U+002F)
 52 | \\     - backslash       (U+005C)
 53 | \u1234 - unicode         (U+1234)
 54 | '''
 55 | 
 56 | 
 57 | [Number]
 58 | int1 =+99
 59 | int2 = 42
 60 | int3 = 0
 61 | int4 =-17
 62 | int5 = 1_000
 63 | int6 = 5_349_221
 64 | int7 = 1_2_3_4_5  # VALID but discouraged
 65 | int8 = 0_         # ❌
 66 | int9 = 1__2       # ❌
 67 | 
 68 | [Number.Float]
 69 | flt1 = 3.1415
 70 | flt2 =+0.
 71 | flt3 =-0.0
 72 | flt4 = .0         # ❌
 73 | flt5 = 5e+22
 74 | flt6 =+1e6
 75 | flt7 =-2E-2
 76 | flt8 =+6.626e-34
 77 | flt9 = 224_617.445_991_228
 78 | 
 79 | [Number.Special]
 80 | sf1 = inf  # positive infinity
 81 | sf2 =+inf  # positive infinity
 82 | sf3 =-inf  # negative infinity
 83 | sf4 = nan  # actual sNaN/qNaN encoding is implementation specific
 84 | sf5 =+nan  # same as `nan`
 85 | sf6 =-nan  # valid, actual encoding is implementation specific
 86 | 
 87 | [Number.Literal]
 88 | # hexadecimal with prefix `0x`
 89 | hex1 = 0xDEADBEEF
 90 | hex2 = 0xdeadbeef
 91 | hex3 = 0xdead_beef
 92 | hex4 = 0x0ABCDEF
 93 | hex5 = 0x0abcdefg  # ❌
 94 | # octal with prefix `0o`
 95 | oct1 = 0o755       # useful for Unix file permissions
 96 | oct2 = 0o01234567
 97 | oct3 = 0o12345678  # ❌
 98 | # binary with prefix `0b`
 99 | bin1 = 0b11010110
100 | bin2 = 0b123       # ❌
101 | 
102 | [DateTime]
103 | # Local Date
104 | ld1 = 1979-05-27
105 | # Local Time
106 | lt1 = 07:32:00
107 | lt2 = 00:32:00.999999
108 | # Local Date-Time
109 | ldt1 = 1979-05-27T07:32:00
110 | ldt2 = 1979-05-27T00:32:00.999999
111 | # Offset Date-Time
112 | odt1 = 1979-05-27T07:32:00Z
113 | odt2 = 1979-05-27T00:32:00-07:00
114 | odt3 = 1979-05-27T00:32:00.999999-07:00
115 | odt4 = 1979-05-27 07:32:00Z
116 | 
117 | 
118 | [Tuple]
119 | arr1 = [1, 2, 3]
120 | arr2 = ["red", "yellow", "green"]
121 | arr3 = [[1, 2], [3, 4, 5]]
122 | arr4 = ["all", 'strings', """are the same""", '''type''']
123 | arr5 = [[1, 2], ["a", "b", "c"]]
124 | arr6 = [1, 2.0]  # ❌
125 | 
126 | 
127 | [[fruit]] # Array
128 | name = "apple"
129 | [[fruit.variety]]
130 | name = "red delicious"
131 | [[fruit.variety]]
132 | name = "granny smith"
133 | [fruit.physical]
134 | color = "red"
135 | shape = "round"
136 | inlineTable = [
137 |     { x = 1, y = 2, z = 3 },
138 |     { x = 7, y = 8, z = 9 },
139 |     { x = 2, y = 4, z = 8 },
140 | ]
141 | 


--------------------------------------------------------------------------------
/tsconfig.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "include": [
 3 |         "extension"
 4 |     ],
 5 |     "compilerOptions": {
 6 |         "outDir": "dist",
 7 |         /* Basic Options */
 8 |         "target": "ES5",
 9 |         "module": "commonjs",
10 |         "lib": ["esnext", "dom"],                 /* Specify library files to be included in the compilation. */
11 |         // "allowJs": true,                       /* Allow javascript files to be compiled. */
12 |         // "checkJs": true,                       /* Report errors in .js files. */
13 |         // "jsx": "preserve",                     /* Specify JSX code generation: 'preserve', 'react-native', or 'react'. */
14 |         "declaration": true,                      /* Generates corresponding '.d.ts' file. */
15 |         "declarationMap": true,                   /* Generates a sourcemap for each corresponding '.d.ts' file. */
16 |         "sourceMap": true,                        /* Generates corresponding '.map' file. */
17 |         // "outFile": "./",                       /* Concatenate and emit output to single file. */
18 |         // "outDir": "./",                        /* Redirect output structure to the directory. */
19 |         // "rootDir": "./",                       /* Specify the root directory of input files. Use to control the output directory structure with --outDir. */
20 |         // "composite": true,                     /* Enable project compilation */
21 |         "removeComments": true,                   /* Do not emit comments to output. */
22 |         // "noEmit": true,                        /* Do not emit outputs. */
23 |         // "importHelpers": true,                 /* Import emit helpers from 'tslib'. */
24 |         // "downlevelIteration": true,            /* Provide full support for iterables in 'for-of', spread, and destructuring when targeting 'ES5' or 'ES3'. */
25 |         // "isolatedModules": true,               /* Transpile each file as a separate module (similar to 'ts.transpileModule'). */
26 | 
27 |         /* Strict Type-Checking Options */
28 |         "strict": true,                           /* Enable all strict type-checking options. */
29 |         // "noImplicitAny": true,                 /* Raise error on expressions and declarations with an implied 'any' type. */
30 |         // "strictNullChecks": true,              /* Enable strict null checks. */
31 |         // "strictFunctionTypes": true,           /* Enable strict checking of function types. */
32 |         // "strictBindCallApply": true,           /* Enable strict 'bind', 'call', and 'apply' methods on functions. */
33 |         // "strictPropertyInitialization": true,  /* Enable strict checking of property initialization in classes. */
34 |         // "noImplicitThis": true,                /* Raise error on 'this' expressions with an implied 'any' type. */
35 |         "alwaysStrict": true,                     /* Parse in strict mode and emit "use strict" for each source file. */
36 | 
37 |         /* Additional Checks */
38 |         // "noUnusedLocals": true,                /* Report errors on unused locals. */
39 |         // "noUnusedParameters": true,            /* Report errors on unused parameters. */
40 |         // "noImplicitReturns": true,             /* Report error when not all code paths in function return a value. */
41 |         // "noFallthroughCasesInSwitch": true,    /* Report errors for fallthrough cases in switch statement. */
42 | 
43 |         /* Module Resolution Options */
44 |         //"resolveJsonModule": true,              /* Import json as object. */
45 |         // "moduleResolution": "node",            /* Specify module resolution strategy: 'node' (Node.js) or 'classic' (TypeScript pre-1.6). */
46 |         // "baseUrl": "./",                       /* Base directory to resolve non-absolute module names. */
47 |         // "paths": {},                           /* A series of entries which re-map imports to lookup locations relative to the 'baseUrl'. */
48 |         // "rootDirs": [],                        /* List of root folders whose combined content represents the structure of the project at runtime. */
49 |         // "typeRoots": [],                       /* List of folders to include type definitions from. */
50 |         // "types": [],                           /* Type declaration files to be included in compilation. */
51 |         // "allowSyntheticDefaultImports": true,  /* Allow default imports from modules with no default export. This does not affect code emit, just typechecking. */
52 |         "esModuleInterop": true,                  /* Enables emit interoperability between CommonJS and ES Modules via creation of namespace objects for all imports. Implies 'allowSyntheticDefaultImports'. */
53 |         // "preserveSymlinks": true,              /* Do not resolve the real path of symlinks. */
54 | 
55 |         /* Source Map Options */
56 |         // "sourceRoot": "",                      /* Specify the location where debugger should locate TypeScript files instead of source locations. */
57 |         // "mapRoot": "",                         /* Specify the location where debugger should locate map files instead of generated locations. */
58 |         // "inlineSourceMap": true,               /* Emit a single file with source maps instead of having a separate file. */
59 |         // "inlineSources": true,                 /* Emit the source alongside the sourcemaps within a single file; requires '--inlineSourceMap' or '--sourceMap' to be set. */
60 | 
61 |         /* Experimental Options */
62 |         "experimentalDecorators": true,           /* Enables experimental support for ES7 decorators. */
63 |         "emitDecoratorMetadata": true,            /* Enables experimental support for emitting type metadata for decorators. */
64 |     },
65 |     "compileOnSave": true,
66 | }
67 | 


--------------------------------------------------------------------------------
/extension/toml.tmLanguage.json:
--------------------------------------------------------------------------------
  1 | {
  2 |     "version": "v0.6.0",
  3 |     "scopeName": "source.toml",
  4 |     "uuid": "9b00c027-8f13-4f5a-a57e-d90478a1f817",
  5 |     "information_for_contributors": [
  6 |         "aster: galaster@foxmail.com"
  7 |     ],
  8 |     "patterns": [
  9 |         {
 10 |             "include": "#comment"
 11 |         },
 12 |         {
 13 |             "include": "#table"
 14 |         },
 15 |         {
 16 |             "include": "#key_value"
 17 |         }
 18 |     ],
 19 |     "repository": {
 20 |         "comment": {
 21 |             "captures": {
 22 |                 "1": {
 23 |                     "name": "comment.line.number-sign.toml"
 24 |                 },
 25 |                 "2": {
 26 |                     "name": "punctuation.definition.comment.toml"
 27 |                 }
 28 |             },
 29 |             "comment": "Comments",
 30 |             "match": "\\s*((#).*)$"
 31 |         },
 32 |         "table": {
 33 |             "patterns": [
 34 |                 {
 35 |                     "captures": {
 36 |                         "1": {
 37 |                             "name": "punctuation.definition.table.toml"
 38 |                         },
 39 |                         "2": {
 40 |                             "patterns": [
 41 |                                 {
 42 |                                     "match": "[^\\s.]+",
 43 |                                     "name": "entity.other.attribute-name.table.toml"
 44 |                                 }
 45 |                             ]
 46 |                         },
 47 |                         "3": {
 48 |                             "name": "punctuation.definition.table.toml"
 49 |                         }
 50 |                     },
 51 |                     "match": "^\\s*(\\[)([^\\[\\]]*)(\\])",
 52 |                     "name": "meta.tag.table.toml"
 53 |                 },
 54 |                 {
 55 |                     "name": "meta.tag.table.array.toml",
 56 |                     "match": "^\\s*(\\[\\[)([^\\[\\]]*)(\\]\\])",
 57 |                     "captures": {
 58 |                         "1": {
 59 |                             "name": "punctuation.definition.table.array.toml"
 60 |                         },
 61 |                         "2": {
 62 |                             "patterns": [
 63 |                                 {
 64 |                                     "match": "[^\\s.]+",
 65 |                                     "name": "entity.other.attribute-name.table.array.toml"
 66 |                                 }
 67 |                             ]
 68 |                         },
 69 |                         "3": {
 70 |                             "name": "punctuation.definition.table.array.toml"
 71 |                         }
 72 |                     }
 73 |                 },
 74 |                 {
 75 |                     "begin": "(?<!\\w)(\\{)\\s*",
 76 |                     "beginCaptures": {
 77 |                         "1": {
 78 |                             "name": "punctuation.definition.table.inline.toml"
 79 |                         }
 80 |                     },
 81 |                     "end": "\\s*(\\})(?!\\w)",
 82 |                     "endCaptures": {
 83 |                         "1": {
 84 |                             "name": "punctuation.definition.table.inline.toml"
 85 |                         }
 86 |                     },
 87 |                     "patterns": [
 88 |                         {
 89 |                             "include": "#key_value"
 90 |                         },
 91 |                         {
 92 |                             "include": "#data"
 93 |                         }
 94 |                     ]
 95 |                 }
 96 |             ]
 97 |         },
 98 |         "key_value": {
 99 |             "patterns": [
100 |                 {
101 |                     "name": "invalid.illegal.noKey.toml",
102 |                     "match": "(\\s*=.*)$"
103 |                 },
104 |                 {
105 |                     "name": "invalid.deprecated.noValue.toml",
106 |                     "match": "(\\s*[A-Za-z_\\-][A-Za-z0-9_\\-]*\\s*=)(?=\\s*$)"
107 |                 },
108 |                 {
109 |                     "begin": "\\s*([A-Za-z_-][A-Za-z0-9_-]*|\".+\"|'.+'|[0-9]+)\\s*(=)\\s*",
110 |                     "beginCaptures": {
111 |                         "1": {
112 |                             "name": "entity.name.tag.toml"
113 |                         },
114 |                         "2": {
115 |                             "name": "punctuation.definition.keyValue.toml"
116 |                         }
117 |                     },
118 |                     "end": "($|(?==)|\\,|\\s*(?=\\}))",
119 |                     "patterns": [
120 |                         {
121 |                             "include": "#comment"
122 |                         },
123 |                         {
124 |                             "include": "#data"
125 |                         },
126 |                         {
127 |                             "include": "#illegal"
128 |                         }
129 |                     ]
130 |                 }
131 |             ]
132 |         },
133 |         "data": {
134 |             "patterns": [
135 |                 {
136 |                     "begin": "(?<!\\w)(\\{)\\s*",
137 |                     "beginCaptures": {
138 |                         "1": {
139 |                             "name": "punctuation.definition.table.inline.toml"
140 |                         }
141 |                     },
142 |                     "end": "\\s*(\\})(?!\\w)",
143 |                     "endCaptures": {
144 |                         "1": {
145 |                             "name": "punctuation.definition.table.inline.toml"
146 |                         }
147 |                     },
148 |                     "patterns": [
149 |                         {
150 |                             "include": "#key_value"
151 |                         },
152 |                         {
153 |                             "include": "#data"
154 |                         }
155 |                     ]
156 |                 },
157 |                 {
158 |                     "begin": "(?<!\\w)(\\[)\\s*",
159 |                     "beginCaptures": {
160 |                         "1": {
161 |                             "name": "punctuation.definition.array.toml"
162 |                         }
163 |                     },
164 |                     "end": "\\s*(\\])(?!\\w)",
165 |                     "endCaptures": {
166 |                         "1": {
167 |                             "name": "punctuation.definition.array.toml"
168 |                         }
169 |                     },
170 |                     "patterns": [
171 |                         {
172 |                             "include": "#comment"
173 |                         },
174 |                         {
175 |                             "include": "#data"
176 |                         }
177 |                     ]
178 |                 },
179 |                 {
180 |                     "name": "string.quoted.triple.basic.block.toml",
181 |                     "begin": "\"\"\"",
182 |                     "end": "\"\"\"",
183 |                     "patterns": [
184 |                         {
185 |                             "match": "\\\\([btnfr\"\\\\\\n/ ]|u[0-9A-Fa-f]{4}|U[0-9A-Fa-f]{8})",
186 |                             "name": "constant.character.escape.toml"
187 |                         },
188 |                         {
189 |                             "match": "\\\\[^btnfr/\"\\\\\\n]",
190 |                             "name": "invalid.illegal.escape.toml"
191 |                         }
192 |                     ]
193 |                 },
194 |                 {
195 |                     "name": "string.quoted.single.basic.line.toml",
196 |                     "match": "\"[^\"\\\\]*(?:\\\\.[^\"\\\\]*)*\"",
197 |                     "patterns": [
198 |                         {
199 |                             "match": "\\\\([btnfr\"\\\\\\n/ ]|u[0-9A-Fa-f]{4}|U[0-9A-Fa-f]{8})",
200 |                             "name": "constant.character.escape.toml"
201 |                         },
202 |                         {
203 |                             "match": "\\\\[^btnfr/\"\\\\\\n]",
204 |                             "name": "invalid.illegal.escape.toml"
205 |                         }
206 |                     ]
207 |                 },
208 |                 {
209 |                     "name": "string.quoted.triple.literal.block.toml",
210 |                     "begin": "'''",
211 |                     "end": "'''"
212 |                 },
213 |                 {
214 |                     "name": "string.quoted.single.literal.line.toml",
215 |                     "match": "'.*?'"
216 |                 },
217 |                 {
218 |                     "captures": {
219 |                         "1": {
220 |                             "name": "constant.other.datetime.offset.toml"
221 |                         }
222 |                     },
223 |                     "match": "(?<!\\w)(\\d{4}\\-\\d{2}\\-\\d{2}[T| ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[\\+\\-]\\d{2}:\\d{2}))(?!\\w)"
224 |                 },
225 |                 {
226 |                     "captures": {
227 |                         "1": {
228 |                             "name": "constant.other.datetime.local.toml"
229 |                         }
230 |                     },
231 |                     "match": "(\\d{4}\\-\\d{2}\\-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?)"
232 |                 },
233 |                 {
234 |                     "name": "constant.other.date.toml",
235 |                     "match": "\\d{4}\\-\\d{2}\\-\\d{2}"
236 |                 },
237 |                 {
238 |                     "name": "constant.other.time.toml",
239 |                     "match": "\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?"
240 |                 },
241 |                 {
242 |                     "match": "(?<!\\w)(true|false)(?!\\w)",
243 |                     "captures": {
244 |                         "1": {
245 |                             "name": "constant.other.boolean.toml"
246 |                         }
247 |                     }
248 |                 },
249 |                 {
250 |                     "match": "(?<!\\w)([\\+\\-]?(0|([1-9](([0-9]|_[0-9])+)?))(?:(?:\\.(0|([1-9](([0-9]|_[0-9])+)?)))?[eE][\\+\\-]?[1-9]_?[0-9]*|(?:\\.[0-9_]*)))(?!\\w)",
251 |                     "captures": {
252 |                         "1": {
253 |                             "name": "constant.numeric.float.toml"
254 |                         }
255 |                     }
256 |                 },
257 |                 {
258 |                     "match": "(?<!\\w)((?:[\\+\\-]?(0|([1-9](([0-9]|_[0-9])+)?))))(?!\\w)",
259 |                     "captures": {
260 |                         "1": {
261 |                             "name": "constant.numeric.integer.toml"
262 |                         }
263 |                     }
264 |                 },
265 |                 {
266 |                     "match": "(?<!\\w)([\\+\\-]?inf)(?!\\w)",
267 |                     "captures": {
268 |                         "1": {
269 |                             "name": "constant.numeric.inf.toml"
270 |                         }
271 |                     }
272 |                 },
273 |                 {
274 |                     "match": "(?<!\\w)([\\+\\-]?nan)(?!\\w)",
275 |                     "captures": {
276 |                         "1": {
277 |                             "name": "constant.numeric.nan.toml"
278 |                         }
279 |                     }
280 |                 },
281 |                 {
282 |                     "match": "(?<!\\w)((?:0x(([0-9a-fA-F](([0-9a-fA-F]|_[0-9a-fA-F])+)?))))(?!\\w)",
283 |                     "captures": {
284 |                         "1": {
285 |                             "name": "constant.numeric.hex.toml"
286 |                         }
287 |                     }
288 |                 },
289 |                 {
290 |                     "match": "(?<!\\w)(0o[0-7](_?[0-7])*)(?!\\w)",
291 |                     "captures": {
292 |                         "1": {
293 |                             "name": "constant.numeric.oct.toml"
294 |                         }
295 |                     }
296 |                 },
297 |                 {
298 |                     "match": "(?<!\\w)(0b[01](_?[01])*)(?!\\w)",
299 |                     "captures": {
300 |                         "1": {
301 |                             "name": "constant.numeric.bin.toml"
302 |                         }
303 |                     }
304 |                 }
305 |             ]
306 |         },
307 |         "illegal": {
308 |             "captures": {
309 |                 "1": {
310 |                     "name": "invalid.illegal.toml"
311 |                 }
312 |             },
313 |             "match": "(.*)"
314 |         }
315 |     }
316 | }


--------------------------------------------------------------------------------
/License.md:
--------------------------------------------------------------------------------
  1 | Mozilla Public License Version 2.0
  2 | ==================================
  3 | 
  4 | ### 1. Definitions
  5 | 
  6 | **1.1. “Contributor”**
  7 |     means each individual or legal entity that creates, contributes to
  8 |     the creation of, or owns Covered Software.
  9 | 
 10 | **1.2. “Contributor Version”**
 11 |     means the combination of the Contributions of others (if any) used
 12 |     by a Contributor and that particular Contributor's Contribution.
 13 | 
 14 | **1.3. “Contribution”**
 15 |     means Covered Software of a particular Contributor.
 16 | 
 17 | **1.4. “Covered Software”**
 18 |     means Source Code Form to which the initial Contributor has attached
 19 |     the notice in Exhibit A, the Executable Form of such Source Code
 20 |     Form, and Modifications of such Source Code Form, in each case
 21 |     including portions thereof.
 22 | 
 23 | **1.5. “Incompatible With Secondary Licenses”**
 24 |     means
 25 | 
 26 | * **(a)** that the initial Contributor has attached the notice described
 27 |     in Exhibit B to the Covered Software; or
 28 | * **(b)** that the Covered Software was made available under the terms of
 29 |     version 1.1 or earlier of the License, but not also under the
 30 |     terms of a Secondary License.
 31 | 
 32 | **1.6. “Executable Form”**
 33 |     means any form of the work other than Source Code Form.
 34 | 
 35 | **1.7. “Larger Work”**
 36 |     means a work that combines Covered Software with other material, in
 37 |     a separate file or files, that is not Covered Software.
 38 | 
 39 | **1.8. “License”**
 40 |     means this document.
 41 | 
 42 | **1.9. “Licensable”**
 43 |     means having the right to grant, to the maximum extent possible,
 44 |     whether at the time of the initial grant or subsequently, any and
 45 |     all of the rights conveyed by this License.
 46 | 
 47 | **1.10. “Modifications”**
 48 |     means any of the following:
 49 | 
 50 | * **(a)** any file in Source Code Form that results from an addition to,
 51 |     deletion from, or modification of the contents of Covered
 52 |     Software; or
 53 | * **(b)** any new file in Source Code Form that contains any Covered
 54 |     Software.
 55 | 
 56 | **1.11. “Patent Claims” of a Contributor**
 57 |     means any patent claim(s), including without limitation, method,
 58 |     process, and apparatus claims, in any patent Licensable by such
 59 |     Contributor that would be infringed, but for the grant of the
 60 |     License, by the making, using, selling, offering for sale, having
 61 |     made, import, or transfer of either its Contributions or its
 62 |     Contributor Version.
 63 | 
 64 | **1.12. “Secondary License”**
 65 |     means either the GNU General Public License, Version 2.0, the GNU
 66 |     Lesser General Public License, Version 2.1, the GNU Affero General
 67 |     Public License, Version 3.0, or any later versions of those
 68 |     licenses.
 69 | 
 70 | **1.13. “Source Code Form”**
 71 |     means the form of the work preferred for making modifications.
 72 | 
 73 | **1.14. “You” (or “Your”)**
 74 |     means an individual or a legal entity exercising rights under this
 75 |     License. For legal entities, “You” includes any entity that
 76 |     controls, is controlled by, or is under common control with You. For
 77 |     purposes of this definition, “control” means **(a)** the power, direct
 78 |     or indirect, to cause the direction or management of such entity,
 79 |     whether by contract or otherwise, or **(b)** ownership of more than
 80 |     fifty percent (50%) of the outstanding shares or beneficial
 81 |     ownership of such entity.
 82 | 
 83 | 
 84 | ### 2. License Grants and Conditions
 85 | 
 86 | #### 2.1. Grants
 87 | 
 88 | Each Contributor hereby grants You a world-wide, royalty-free,
 89 | non-exclusive license:
 90 | 
 91 | * **(a)** under intellectual property rights (other than patent or trademark)
 92 |     Licensable by such Contributor to use, reproduce, make available,
 93 |     modify, display, perform, distribute, and otherwise exploit its
 94 |     Contributions, either on an unmodified basis, with Modifications, or
 95 |     as part of a Larger Work; and
 96 | * **(b)** under Patent Claims of such Contributor to make, use, sell, offer
 97 |     for sale, have made, import, and otherwise transfer either its
 98 |     Contributions or its Contributor Version.
 99 | 
100 | #### 2.2. Effective Date
101 | 
102 | The licenses granted in Section 2.1 with respect to any Contribution
103 | become effective for each Contribution on the date the Contributor first
104 | distributes such Contribution.
105 | 
106 | #### 2.3. Limitations on Grant Scope
107 | 
108 | The licenses granted in this Section 2 are the only rights granted under
109 | this License. No additional rights or licenses will be implied from the
110 | distribution or licensing of Covered Software under this License.
111 | Notwithstanding Section 2.1(b) above, no patent license is granted by a
112 | Contributor:
113 | 
114 | * **(a)** for any code that a Contributor has removed from Covered Software;
115 |     or
116 | * **(b)** for infringements caused by: **(i)** Your and any other third party's
117 |     modifications of Covered Software, or **(ii)** the combination of its
118 |     Contributions with other software (except as part of its Contributor
119 |     Version); or
120 | * **(c)** under Patent Claims infringed by Covered Software in the absence of
121 |     its Contributions.
122 | 
123 | This License does not grant any rights in the trademarks, service marks,
124 | or logos of any Contributor (except as may be necessary to comply with
125 | the notice requirements in Section 3.4).
126 | 
127 | #### 2.4. Subsequent Licenses
128 | 
129 | No Contributor makes additional grants as a result of Your choice to
130 | distribute the Covered Software under a subsequent version of this
131 | License (see Section 10.2) or under the terms of a Secondary License (if
132 | permitted under the terms of Section 3.3).
133 | 
134 | #### 2.5. Representation
135 | 
136 | Each Contributor represents that the Contributor believes its
137 | Contributions are its original creation(s) or it has sufficient rights
138 | to grant the rights to its Contributions conveyed by this License.
139 | 
140 | #### 2.6. Fair Use
141 | 
142 | This License is not intended to limit any rights You have under
143 | applicable copyright doctrines of fair use, fair dealing, or other
144 | equivalents.
145 | 
146 | #### 2.7. Conditions
147 | 
148 | Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted
149 | in Section 2.1.
150 | 
151 | 
152 | ### 3. Responsibilities
153 | 
154 | #### 3.1. Distribution of Source Form
155 | 
156 | All distribution of Covered Software in Source Code Form, including any
157 | Modifications that You create or to which You contribute, must be under
158 | the terms of this License. You must inform recipients that the Source
159 | Code Form of the Covered Software is governed by the terms of this
160 | License, and how they can obtain a copy of this License. You may not
161 | attempt to alter or restrict the recipients' rights in the Source Code
162 | Form.
163 | 
164 | #### 3.2. Distribution of Executable Form
165 | 
166 | If You distribute Covered Software in Executable Form then:
167 | 
168 | * **(a)** such Covered Software must also be made available in Source Code
169 |     Form, as described in Section 3.1, and You must inform recipients of
170 |     the Executable Form how they can obtain a copy of such Source Code
171 |     Form by reasonable means in a timely manner, at a charge no more
172 |     than the cost of distribution to the recipient; and
173 | 
174 | * **(b)** You may distribute such Executable Form under the terms of this
175 |     License, or sublicense it under different terms, provided that the
176 |     license for the Executable Form does not attempt to limit or alter
177 |     the recipients' rights in the Source Code Form under this License.
178 | 
179 | #### 3.3. Distribution of a Larger Work
180 | 
181 | You may create and distribute a Larger Work under terms of Your choice,
182 | provided that You also comply with the requirements of this License for
183 | the Covered Software. If the Larger Work is a combination of Covered
184 | Software with a work governed by one or more Secondary Licenses, and the
185 | Covered Software is not Incompatible With Secondary Licenses, this
186 | License permits You to additionally distribute such Covered Software
187 | under the terms of such Secondary License(s), so that the recipient of
188 | the Larger Work may, at their option, further distribute the Covered
189 | Software under the terms of either this License or such Secondary
190 | License(s).
191 | 
192 | #### 3.4. Notices
193 | 
194 | You may not remove or alter the substance of any license notices
195 | (including copyright notices, patent notices, disclaimers of warranty,
196 | or limitations of liability) contained within the Source Code Form of
197 | the Covered Software, except that You may alter any license notices to
198 | the extent required to remedy known factual inaccuracies.
199 | 
200 | #### 3.5. Application of Additional Terms
201 | 
202 | You may choose to offer, and to charge a fee for, warranty, support,
203 | indemnity or liability obligations to one or more recipients of Covered
204 | Software. However, You may do so only on Your own behalf, and not on
205 | behalf of any Contributor. You must make it absolutely clear that any
206 | such warranty, support, indemnity, or liability obligation is offered by
207 | You alone, and You hereby agree to indemnify every Contributor for any
208 | liability incurred by such Contributor as a result of warranty, support,
209 | indemnity or liability terms You offer. You may include additional
210 | disclaimers of warranty and limitations of liability specific to any
211 | jurisdiction.
212 | 
213 | 
214 | ### 4. Inability to Comply Due to Statute or Regulation
215 | 
216 | If it is impossible for You to comply with any of the terms of this
217 | License with respect to some or all of the Covered Software due to
218 | statute, judicial order, or regulation then You must: **(a)** comply with
219 | the terms of this License to the maximum extent possible; and **(b)**
220 | describe the limitations and the code they affect. Such description must
221 | be placed in a text file included with all distributions of the Covered
222 | Software under this License. Except to the extent prohibited by statute
223 | or regulation, such description must be sufficiently detailed for a
224 | recipient of ordinary skill to be able to understand it.
225 | 
226 | 
227 | ### 5. Termination
228 | 
229 | **5.1.** The rights granted under this License will terminate automatically
230 | if You fail to comply with any of its terms. However, if You become
231 | compliant, then the rights granted under this License from a particular
232 | Contributor are reinstated **(a)** provisionally, unless and until such
233 | Contributor explicitly and finally terminates Your grants, and **(b)** on an
234 | ongoing basis, if such Contributor fails to notify You of the
235 | non-compliance by some reasonable means prior to 60 days after You have
236 | come back into compliance. Moreover, Your grants from a particular
237 | Contributor are reinstated on an ongoing basis if such Contributor
238 | notifies You of the non-compliance by some reasonable means, this is the
239 | first time You have received notice of non-compliance with this License
240 | from such Contributor, and You become compliant prior to 30 days after
241 | Your receipt of the notice.
242 | 
243 | **5.2.** If You initiate litigation against any entity by asserting a patent
244 | infringement claim (excluding declaratory judgment actions,
245 | counter-claims, and cross-claims) alleging that a Contributor Version
246 | directly or indirectly infringes any patent, then the rights granted to
247 | You by any and all Contributors for the Covered Software under Section
248 | 2.1 of this License shall terminate.
249 | 
250 | **5.3.** In the event of termination under Sections 5.1 or 5.2 above, all
251 | end user license agreements (excluding distributors and resellers) which
252 | have been validly granted by You or Your distributors under this License
253 | prior to termination shall survive termination.
254 | 
255 | 
256 | ### 6. Disclaimer of Warranty
257 | 
258 | > Covered Software is provided under this License on an “as is”
259 | > basis, without warranty of any kind, either expressed, implied, or
260 | > statutory, including, without limitation, warranties that the
261 | > Covered Software is free of defects, merchantable, fit for a
262 | > particular purpose or non-infringing. The entire risk as to the
263 | > quality and performance of the Covered Software is with You.
264 | > Should any Covered Software prove defective in any respect, You
265 | > (not any Contributor) assume the cost of any necessary servicing,
266 | > repair, or correction. This disclaimer of warranty constitutes an
267 | > essential part of this License. No use of any Covered Software is
268 | > authorized under this License except under this disclaimer.
269 | 
270 | ### 7. Limitation of Liability
271 | 
272 | > Under no circumstances and under no legal theory, whether tort
273 | > (including negligence), contract, or otherwise, shall any
274 | > Contributor, or anyone who distributes Covered Software as
275 | > permitted above, be liable to You for any direct, indirect,
276 | > special, incidental, or consequential damages of any character
277 | > including, without limitation, damages for lost profits, loss of
278 | > goodwill, work stoppage, computer failure or malfunction, or any
279 | > and all other commercial damages or losses, even if such party
280 | > shall have been informed of the possibility of such damages. This
281 | > limitation of liability shall not apply to liability for death or
282 | > personal injury resulting from such party's negligence to the
283 | > extent applicable law prohibits such limitation. Some
284 | > jurisdictions do not allow the exclusion or limitation of
285 | > incidental or consequential damages, so this exclusion and
286 | > limitation may not apply to You.
287 | 
288 | 
289 | ### 8. Litigation
290 | 
291 | Any litigation relating to this License may be brought only in the
292 | courts of a jurisdiction where the defendant maintains its principal
293 | place of business and such litigation shall be governed by laws of that
294 | jurisdiction, without reference to its conflict-of-law provisions.
295 | Nothing in this Section shall prevent a party's ability to bring
296 | cross-claims or counter-claims.
297 | 
298 | 
299 | ### 9. Miscellaneous
300 | 
301 | This License represents the complete agreement concerning the subject
302 | matter hereof. If any provision of this License is held to be
303 | unenforceable, such provision shall be reformed only to the extent
304 | necessary to make it enforceable. Any law or regulation which provides
305 | that the language of a contract shall be construed against the drafter
306 | shall not be used to construe this License against a Contributor.
307 | 
308 | 
309 | ### 10. Versions of the License
310 | 
311 | #### 10.1. New Versions
312 | 
313 | Mozilla Foundation is the license steward. Except as provided in Section
314 | 10.3, no one other than the license steward has the right to modify or
315 | publish new versions of this License. Each version will be given a
316 | distinguishing version number.
317 | 
318 | #### 10.2. Effect of New Versions
319 | 
320 | You may distribute the Covered Software under the terms of the version
321 | of the License under which You originally received the Covered Software,
322 | or under the terms of any subsequent version published by the license
323 | steward.
324 | 
325 | #### 10.3. Modified Versions
326 | 
327 | If you create software not governed by this License, and you want to
328 | create a new license for such software, you may create and use a
329 | modified version of this License if you rename the license and remove
330 | any references to the name of the license steward (except to note that
331 | such modified license differs from this License).
332 | 
333 | #### 10.4. Distributing Source Code Form that is Incompatible With Secondary Licenses
334 | 
335 | If You choose to distribute Source Code Form that is Incompatible With
336 | Secondary Licenses under the terms of this version of the License, the
337 | notice described in Exhibit B of this License must be attached.
338 | 
339 | ## Exhibit A - Source Code Form License Notice
340 | 
341 |     This Source Code Form is subject to the terms of the Mozilla Public
342 |     License, v. 2.0. If a copy of the MPL was not distributed with this
343 |     file, You can obtain one at http://mozilla.org/MPL/2.0/.
344 | 
345 | If it is not possible or desirable to put the notice in a particular
346 | file, then You may include the notice in a location (such as a LICENSE
347 | file in a relevant directory) where a recipient would be likely to look
348 | for such a notice.
349 | 
350 | You may add additional accurate notices of copyright ownership.
351 | 
352 | ## Exhibit B - “Incompatible With Secondary Licenses” Notice
353 | 
354 |     This Source Code Form is "Incompatible With Secondary Licenses", as
355 |     defined by the Mozilla Public License, v. 2.0.
356 | 
357 | 


--------------------------------------------------------------------------------