@theia/preferences 1.34.1 → 1.34.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (128) hide show
  1. package/LICENSE +641 -641
  2. package/README.md +81 -81
  3. package/lib/browser/abstract-resource-preference-provider.d.ts +46 -46
  4. package/lib/browser/abstract-resource-preference-provider.js +237 -237
  5. package/lib/browser/abstract-resource-preference-provider.spec.d.ts +1 -1
  6. package/lib/browser/abstract-resource-preference-provider.spec.js +83 -83
  7. package/lib/browser/folder-preference-provider.d.ts +20 -20
  8. package/lib/browser/folder-preference-provider.js +59 -59
  9. package/lib/browser/folders-preferences-provider.d.ts +25 -25
  10. package/lib/browser/folders-preferences-provider.js +239 -239
  11. package/lib/browser/index.d.ts +7 -7
  12. package/lib/browser/index.js +34 -34
  13. package/lib/browser/monaco-jsonc-editor.d.ts +9 -9
  14. package/lib/browser/monaco-jsonc-editor.js +80 -80
  15. package/lib/browser/package.spec.js +25 -25
  16. package/lib/browser/preference-bindings.d.ts +4 -4
  17. package/lib/browser/preference-bindings.js +63 -63
  18. package/lib/browser/preference-frontend-module.d.ts +6 -6
  19. package/lib/browser/preference-frontend-module.js +52 -52
  20. package/lib/browser/preference-open-handler.d.ts +9 -9
  21. package/lib/browser/preference-open-handler.js +64 -64
  22. package/lib/browser/preference-transaction-manager.d.ts +98 -98
  23. package/lib/browser/preference-transaction-manager.js +295 -295
  24. package/lib/browser/preference-tree-model.d.ts +59 -59
  25. package/lib/browser/preference-tree-model.js +240 -240
  26. package/lib/browser/preferences-contribution.d.ts +37 -37
  27. package/lib/browser/preferences-contribution.js +279 -279
  28. package/lib/browser/preferences-json-schema-contribution.d.ts +17 -17
  29. package/lib/browser/preferences-json-schema-contribution.js +91 -91
  30. package/lib/browser/preferences-monaco-contribution.d.ts +1 -1
  31. package/lib/browser/preferences-monaco-contribution.js +30 -30
  32. package/lib/browser/section-preference-provider.d.ts +21 -21
  33. package/lib/browser/section-preference-provider.js +96 -96
  34. package/lib/browser/user-configs-preference-provider.d.ts +21 -21
  35. package/lib/browser/user-configs-preference-provider.js +134 -134
  36. package/lib/browser/user-preference-provider.d.ts +13 -13
  37. package/lib/browser/user-preference-provider.js +41 -41
  38. package/lib/browser/util/preference-scope-command-manager.d.ts +17 -17
  39. package/lib/browser/util/preference-scope-command-manager.js +87 -87
  40. package/lib/browser/util/preference-tree-generator.d.ts +30 -30
  41. package/lib/browser/util/preference-tree-generator.js +234 -234
  42. package/lib/browser/util/preference-tree-label-provider.d.ts +11 -11
  43. package/lib/browser/util/preference-tree-label-provider.js +77 -77
  44. package/lib/browser/util/preference-tree-label-provider.spec.d.ts +1 -1
  45. package/lib/browser/util/preference-tree-label-provider.spec.js +87 -87
  46. package/lib/browser/util/preference-types.d.ts +62 -62
  47. package/lib/browser/util/preference-types.js +128 -128
  48. package/lib/browser/views/components/preference-array-input.d.ts +28 -28
  49. package/lib/browser/views/components/preference-array-input.js +180 -180
  50. package/lib/browser/views/components/preference-boolean-input.d.ts +17 -17
  51. package/lib/browser/views/components/preference-boolean-input.js +79 -79
  52. package/lib/browser/views/components/preference-file-input.d.ts +29 -29
  53. package/lib/browser/views/components/preference-file-input.js +110 -110
  54. package/lib/browser/views/components/preference-json-input.d.ts +19 -19
  55. package/lib/browser/views/components/preference-json-input.js +93 -93
  56. package/lib/browser/views/components/preference-node-renderer-creator.d.ts +48 -48
  57. package/lib/browser/views/components/preference-node-renderer-creator.js +132 -132
  58. package/lib/browser/views/components/preference-node-renderer.d.ts +111 -111
  59. package/lib/browser/views/components/preference-node-renderer.js +460 -460
  60. package/lib/browser/views/components/preference-number-input.d.ts +34 -34
  61. package/lib/browser/views/components/preference-number-input.js +142 -142
  62. package/lib/browser/views/components/preference-select-input.d.ts +27 -27
  63. package/lib/browser/views/components/preference-select-input.js +135 -135
  64. package/lib/browser/views/components/preference-string-input.d.ts +17 -17
  65. package/lib/browser/views/components/preference-string-input.js +89 -89
  66. package/lib/browser/views/preference-editor-widget.d.ts +67 -67
  67. package/lib/browser/views/preference-editor-widget.js +376 -376
  68. package/lib/browser/views/preference-scope-tabbar-widget.d.ts +54 -54
  69. package/lib/browser/views/preference-scope-tabbar-widget.js +343 -343
  70. package/lib/browser/views/preference-searchbar-widget.d.ts +53 -53
  71. package/lib/browser/views/preference-searchbar-widget.js +173 -173
  72. package/lib/browser/views/preference-tree-widget.d.ts +17 -17
  73. package/lib/browser/views/preference-tree-widget.js +104 -104
  74. package/lib/browser/views/preference-widget-bindings.d.ts +3 -3
  75. package/lib/browser/views/preference-widget-bindings.js +85 -85
  76. package/lib/browser/views/preference-widget.d.ts +35 -35
  77. package/lib/browser/views/preference-widget.js +123 -123
  78. package/lib/browser/workspace-file-preference-provider.d.ts +23 -23
  79. package/lib/browser/workspace-file-preference-provider.js +110 -110
  80. package/lib/browser/workspace-preference-provider.d.ts +28 -28
  81. package/lib/browser/workspace-preference-provider.js +142 -142
  82. package/package.json +9 -9
  83. package/src/browser/abstract-resource-preference-provider.spec.ts +95 -95
  84. package/src/browser/abstract-resource-preference-provider.ts +228 -228
  85. package/src/browser/folder-preference-provider.ts +58 -58
  86. package/src/browser/folders-preferences-provider.ts +236 -236
  87. package/src/browser/index.ts +23 -23
  88. package/src/browser/monaco-jsonc-editor.ts +67 -67
  89. package/src/browser/package.spec.ts +28 -28
  90. package/src/browser/preference-bindings.ts +65 -65
  91. package/src/browser/preference-frontend-module.ts +57 -57
  92. package/src/browser/preference-open-handler.ts +53 -53
  93. package/src/browser/preference-transaction-manager.ts +283 -283
  94. package/src/browser/preference-tree-model.ts +246 -246
  95. package/src/browser/preferences-contribution.ts +263 -263
  96. package/src/browser/preferences-json-schema-contribution.ts +86 -86
  97. package/src/browser/preferences-monaco-contribution.ts +30 -30
  98. package/src/browser/section-preference-provider.ts +83 -83
  99. package/src/browser/style/index.css +456 -456
  100. package/src/browser/style/preference-array.css +90 -90
  101. package/src/browser/style/preference-context-menu.css +74 -74
  102. package/src/browser/style/preference-file.css +32 -32
  103. package/src/browser/style/preference-object.css +49 -49
  104. package/src/browser/style/search-input.css +66 -66
  105. package/src/browser/user-configs-preference-provider.ts +123 -123
  106. package/src/browser/user-preference-provider.ts +35 -35
  107. package/src/browser/util/preference-scope-command-manager.ts +75 -75
  108. package/src/browser/util/preference-tree-generator.ts +222 -222
  109. package/src/browser/util/preference-tree-label-provider.spec.ts +108 -108
  110. package/src/browser/util/preference-tree-label-provider.ts +64 -64
  111. package/src/browser/util/preference-types.ts +169 -169
  112. package/src/browser/views/components/preference-array-input.ts +174 -174
  113. package/src/browser/views/components/preference-boolean-input.ts +69 -69
  114. package/src/browser/views/components/preference-file-input.ts +104 -104
  115. package/src/browser/views/components/preference-json-input.ts +78 -78
  116. package/src/browser/views/components/preference-node-renderer-creator.ts +141 -141
  117. package/src/browser/views/components/preference-node-renderer.ts +499 -499
  118. package/src/browser/views/components/preference-number-input.ts +147 -147
  119. package/src/browser/views/components/preference-select-input.ts +127 -127
  120. package/src/browser/views/components/preference-string-input.ts +76 -76
  121. package/src/browser/views/preference-editor-widget.ts +361 -361
  122. package/src/browser/views/preference-scope-tabbar-widget.tsx +344 -344
  123. package/src/browser/views/preference-searchbar-widget.tsx +183 -183
  124. package/src/browser/views/preference-tree-widget.tsx +93 -93
  125. package/src/browser/views/preference-widget-bindings.ts +99 -99
  126. package/src/browser/views/preference-widget.tsx +113 -113
  127. package/src/browser/workspace-file-preference-provider.ts +100 -100
  128. package/src/browser/workspace-preference-provider.ts +134 -134
package/README.md CHANGED
@@ -1,81 +1,81 @@
1
- <div align='center'>
2
-
3
- <br />
4
-
5
- <img src='https://raw.githubusercontent.com/eclipse-theia/theia/master/logo/theia.svg?sanitize=true' alt='theia-ext-logo' width='100px' />
6
-
7
- <h2>ECLIPSE THEIA - PREFERENCES EXTENSION</h2>
8
-
9
- <hr />
10
-
11
- </div>
12
-
13
- ## Description
14
-
15
- The `@theia/preferences` extension implements the preferences API defined in `@theia/core`, including the four preference providers:
16
- - `Default` Preference, which serves as default values of preferences,
17
- - `User` Preference for the user home directory, which has precedence over the default values,
18
- - `Workspace` Preference for the workspace, which has precedence over User Preference, and
19
- - `Folder` Preference for the root folder, which has precedence over the Workspace Preference
20
-
21
- To set:
22
- - `User` Preferences: Create or edit a `settings.json` under the `.theia` folder located either in the user home.
23
- - `Workspace` Preference: If one folder is opened as the workspace, create or edit a `settings.json` under the root of the workspace. If a multi-root workspace is opened, create or edit the "settings" property in the workspace file.
24
- - `Folder` Preferences: Create or edit a `settings.json` under any of the root folders.
25
-
26
- Example of a `settings.json` below:
27
-
28
- ```typescript
29
- {
30
- // Enable/Disable the line numbers in the monaco editor
31
- "editor.lineNumbers": "off",
32
- // Tab width in the editor
33
- "editor.tabSize": 4,
34
- "files.watcherExclude": "path/to/file"
35
- }
36
- ```
37
-
38
- Example of a workspace file below:
39
-
40
- ```typescript
41
- {
42
- "folders": [
43
- {
44
- "path": "file:///home/username/helloworld"
45
- },
46
- {
47
- "path": "file:///home/username/dev/byeworld"
48
- }
49
- ],
50
- "settings": {
51
- // Enable/Disable the line numbers in the monaco editor
52
- "editor.lineNumbers": "off",
53
- // Tab width in the editor
54
- "editor.tabSize": 4,
55
- }
56
- }
57
- ```
58
-
59
- ## Additional Information
60
-
61
- - [API documentation for `@theia/preferences`](https://eclipse-theia.github.io/theia/docs/next/modules/preferences.html)
62
- - [Theia - GitHub](https://github.com/eclipse-theia/theia)
63
- - [Theia - Website](https://theia-ide.org/)
64
-
65
- ## License
66
-
67
- - [Eclipse Public License 2.0](http://www.eclipse.org/legal/epl-2.0/)
68
- - [一 (Secondary) GNU General Public License, version 2 with the GNU Classpath Exception](https://projects.eclipse.org/license/secondary-gpl-2.0-cp)
69
-
70
- ## Trademark
71
- "Theia" is a trademark of the Eclipse Foundation
72
- https://www.eclipse.org/theia
73
-
74
-
75
- # Theia - Preferences Extension
76
-
77
-
78
-
79
- ## License
80
- - [Eclipse Public License 2.0](http://www.eclipse.org/legal/epl-2.0/)
81
- - [一 (Secondary) GNU General Public License, version 2 with the GNU Classpath Exception](https://projects.eclipse.org/license/secondary-gpl-2.0-cp)
1
+ <div align='center'>
2
+
3
+ <br />
4
+
5
+ <img src='https://raw.githubusercontent.com/eclipse-theia/theia/master/logo/theia.svg?sanitize=true' alt='theia-ext-logo' width='100px' />
6
+
7
+ <h2>ECLIPSE THEIA - PREFERENCES EXTENSION</h2>
8
+
9
+ <hr />
10
+
11
+ </div>
12
+
13
+ ## Description
14
+
15
+ The `@theia/preferences` extension implements the preferences API defined in `@theia/core`, including the four preference providers:
16
+ - `Default` Preference, which serves as default values of preferences,
17
+ - `User` Preference for the user home directory, which has precedence over the default values,
18
+ - `Workspace` Preference for the workspace, which has precedence over User Preference, and
19
+ - `Folder` Preference for the root folder, which has precedence over the Workspace Preference
20
+
21
+ To set:
22
+ - `User` Preferences: Create or edit a `settings.json` under the `.theia` folder located either in the user home.
23
+ - `Workspace` Preference: If one folder is opened as the workspace, create or edit a `settings.json` under the root of the workspace. If a multi-root workspace is opened, create or edit the "settings" property in the workspace file.
24
+ - `Folder` Preferences: Create or edit a `settings.json` under any of the root folders.
25
+
26
+ Example of a `settings.json` below:
27
+
28
+ ```typescript
29
+ {
30
+ // Enable/Disable the line numbers in the monaco editor
31
+ "editor.lineNumbers": "off",
32
+ // Tab width in the editor
33
+ "editor.tabSize": 4,
34
+ "files.watcherExclude": "path/to/file"
35
+ }
36
+ ```
37
+
38
+ Example of a workspace file below:
39
+
40
+ ```typescript
41
+ {
42
+ "folders": [
43
+ {
44
+ "path": "file:///home/username/helloworld"
45
+ },
46
+ {
47
+ "path": "file:///home/username/dev/byeworld"
48
+ }
49
+ ],
50
+ "settings": {
51
+ // Enable/Disable the line numbers in the monaco editor
52
+ "editor.lineNumbers": "off",
53
+ // Tab width in the editor
54
+ "editor.tabSize": 4,
55
+ }
56
+ }
57
+ ```
58
+
59
+ ## Additional Information
60
+
61
+ - [API documentation for `@theia/preferences`](https://eclipse-theia.github.io/theia/docs/next/modules/preferences.html)
62
+ - [Theia - GitHub](https://github.com/eclipse-theia/theia)
63
+ - [Theia - Website](https://theia-ide.org/)
64
+
65
+ ## License
66
+
67
+ - [Eclipse Public License 2.0](http://www.eclipse.org/legal/epl-2.0/)
68
+ - [一 (Secondary) GNU General Public License, version 2 with the GNU Classpath Exception](https://projects.eclipse.org/license/secondary-gpl-2.0-cp)
69
+
70
+ ## Trademark
71
+ "Theia" is a trademark of the Eclipse Foundation
72
+ https://www.eclipse.org/theia
73
+
74
+
75
+ # Theia - Preferences Extension
76
+
77
+
78
+
79
+ ## License
80
+ - [Eclipse Public License 2.0](http://www.eclipse.org/legal/epl-2.0/)
81
+ - [一 (Secondary) GNU General Public License, version 2 with the GNU Classpath Exception](https://projects.eclipse.org/license/secondary-gpl-2.0-cp)
@@ -1,47 +1,47 @@
1
- import { PreferenceProvider, PreferenceSchemaProvider, PreferenceScope } from '@theia/core/lib/browser';
2
- import URI from '@theia/core/lib/common/uri';
3
- import { PreferenceConfigurations } from '@theia/core/lib/browser/preferences/preference-configurations';
4
- import { Deferred } from '@theia/core/lib/common/promise-util';
5
- import { FileService } from '@theia/filesystem/lib/browser/file-service';
6
- import { PreferenceContext, PreferenceTransaction, PreferenceTransactionFactory } from './preference-transaction-manager';
7
- import { Emitter, Event } from '@theia/core';
8
- export declare abstract class AbstractResourcePreferenceProvider extends PreferenceProvider {
9
- protected preferences: Record<string, any>;
10
- protected _fileExists: boolean;
11
- protected readonly loading: Deferred<void>;
12
- protected transaction: PreferenceTransaction | undefined;
13
- protected readonly onDidChangeValidityEmitter: Emitter<boolean>;
14
- set fileExists(exists: boolean);
15
- get onDidChangeValidity(): Event<boolean>;
16
- protected readonly transactionFactory: PreferenceTransactionFactory;
17
- protected readonly schemaProvider: PreferenceSchemaProvider;
18
- protected readonly fileService: FileService;
19
- protected readonly configurations: PreferenceConfigurations;
20
- protected init(): Promise<void>;
21
- protected abstract getUri(): URI;
22
- abstract getScope(): PreferenceScope;
23
- get valid(): boolean;
24
- getConfigUri(): URI;
25
- getConfigUri(resourceUri: string | undefined): URI | undefined;
26
- contains(resourceUri: string | undefined): boolean;
27
- getPreferences(resourceUri?: string): {
28
- [key: string]: any;
29
- };
30
- setPreference(key: string, value: any, resourceUri?: string): Promise<boolean>;
31
- protected doSetPreference(key: string, path: string[], value: unknown): Promise<boolean>;
32
- /**
33
- * Use this method as intermediary for interactions with actual files.
34
- * Allows individual providers to modify where they store their files without disrupting the preference system's
35
- * conventions about scope and file location.
36
- */
37
- protected toFileManager(): PreferenceContext;
38
- protected getPath(preferenceName: string): string[] | undefined;
39
- protected readPreferencesFromFile(): Promise<void>;
40
- protected readPreferencesFromContent(content: string): void;
41
- protected parse(content: string): any;
42
- protected handlePreferenceChanges(newPrefs: {
43
- [key: string]: any;
44
- }): void;
45
- protected reset(): void;
46
- }
1
+ import { PreferenceProvider, PreferenceSchemaProvider, PreferenceScope } from '@theia/core/lib/browser';
2
+ import URI from '@theia/core/lib/common/uri';
3
+ import { PreferenceConfigurations } from '@theia/core/lib/browser/preferences/preference-configurations';
4
+ import { Deferred } from '@theia/core/lib/common/promise-util';
5
+ import { FileService } from '@theia/filesystem/lib/browser/file-service';
6
+ import { PreferenceContext, PreferenceTransaction, PreferenceTransactionFactory } from './preference-transaction-manager';
7
+ import { Emitter, Event } from '@theia/core';
8
+ export declare abstract class AbstractResourcePreferenceProvider extends PreferenceProvider {
9
+ protected preferences: Record<string, any>;
10
+ protected _fileExists: boolean;
11
+ protected readonly loading: Deferred<void>;
12
+ protected transaction: PreferenceTransaction | undefined;
13
+ protected readonly onDidChangeValidityEmitter: Emitter<boolean>;
14
+ set fileExists(exists: boolean);
15
+ get onDidChangeValidity(): Event<boolean>;
16
+ protected readonly transactionFactory: PreferenceTransactionFactory;
17
+ protected readonly schemaProvider: PreferenceSchemaProvider;
18
+ protected readonly fileService: FileService;
19
+ protected readonly configurations: PreferenceConfigurations;
20
+ protected init(): Promise<void>;
21
+ protected abstract getUri(): URI;
22
+ abstract getScope(): PreferenceScope;
23
+ get valid(): boolean;
24
+ getConfigUri(): URI;
25
+ getConfigUri(resourceUri: string | undefined): URI | undefined;
26
+ contains(resourceUri: string | undefined): boolean;
27
+ getPreferences(resourceUri?: string): {
28
+ [key: string]: any;
29
+ };
30
+ setPreference(key: string, value: any, resourceUri?: string): Promise<boolean>;
31
+ protected doSetPreference(key: string, path: string[], value: unknown): Promise<boolean>;
32
+ /**
33
+ * Use this method as intermediary for interactions with actual files.
34
+ * Allows individual providers to modify where they store their files without disrupting the preference system's
35
+ * conventions about scope and file location.
36
+ */
37
+ protected toFileManager(): PreferenceContext;
38
+ protected getPath(preferenceName: string): string[] | undefined;
39
+ protected readPreferencesFromFile(): Promise<void>;
40
+ protected readPreferencesFromContent(content: string): void;
41
+ protected parse(content: string): any;
42
+ protected handlePreferenceChanges(newPrefs: {
43
+ [key: string]: any;
44
+ }): void;
45
+ protected reset(): void;
46
+ }
47
47
  //# sourceMappingURL=abstract-resource-preference-provider.d.ts.map