@o3r/stylelint-plugin 8.2.0-alpha.9 → 8.2.0-alpha.90

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 (3) hide show
  1. package/LICENSE +26 -26
  2. package/README.md +9 -197
  3. package/package.json +7 -4
package/LICENSE CHANGED
@@ -1,26 +1,26 @@
1
- Copyright Amadeus SAS
2
-
3
- Redistribution and use in source and binary forms, with or without modification,
4
- are permitted provided that the following conditions are met:
5
-
6
- 1. Redistributions of source code must retain the above copyright notice, this
7
- list of conditions and the following disclaimer.
8
-
9
- 2. Redistributions in binary form must reproduce the above copyright notice,
10
- this list of conditions and the following disclaimer in the documentation and/or
11
- other materials provided with the distribution.
12
-
13
- 3. Neither the name of the copyright holder nor the names of its contributors
14
- may be used to endorse or promote products derived from this software without
15
- specific prior written permission.
16
-
17
- THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
18
- ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
19
- WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
20
- DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
21
- ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
22
- (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
23
- LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
24
- ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25
- (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
26
- SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
1
+ Copyright Amadeus SAS
2
+
3
+ Redistribution and use in source and binary forms, with or without modification,
4
+ are permitted provided that the following conditions are met:
5
+
6
+ 1. Redistributions of source code must retain the above copyright notice, this
7
+ list of conditions and the following disclaimer.
8
+
9
+ 2. Redistributions in binary form must reproduce the above copyright notice,
10
+ this list of conditions and the following disclaimer in the documentation and/or
11
+ other materials provided with the distribution.
12
+
13
+ 3. Neither the name of the copyright holder nor the names of its contributors
14
+ may be used to endorse or promote products derived from this software without
15
+ specific prior written permission.
16
+
17
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
18
+ ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
19
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
20
+ DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
21
+ ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
22
+ (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
23
+ LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
24
+ ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25
+ (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
26
+ SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
package/README.md CHANGED
@@ -1,212 +1,24 @@
1
- <h1 align="center">Otter Framework</h1>
1
+ <h1 align="center">Otter stylelint plugin</h1>
2
2
  <p align="center">
3
- <img src="./.attachments/logo.png" alt="Super cute Otter!"/>
3
+ <img src="../../../.attachments/otter.png" alt="Super cute Otter!" width="40%"/>
4
4
  </p>
5
5
 
6
+ This package is an [Otter Framework Module](https://github.com/AmadeusITGroup/otter/tree/main/docs/core/MODULE.md).
6
7
  <br />
7
8
  <br />
8
9
 
9
10
  ## Description
10
- The **Otter** project is a highly modular framework whose goal is to provide a common platform to accelerate and facilitate the development on Angular web applications.
11
- It is split into several units to cover different aspects of these applications (localization, testing, customization, etc.).
12
- Also, to customize an application, metadata can be extracted from the application source code and injected into a CMS to manage dynamic configuration.
13
11
 
14
- > **Note**: The full documentation is available [here](./docs/README.md).
12
+ In-house stylint plugins to use in your own eslint configuration
15
13
 
16
- ## Built With
17
-
18
- * [Angular](https://angular.io/)
19
- * [Typescript](https://www.typescriptlang.org/)
20
- * [RxJs](http://reactivex.io/rxjs/)
21
- * [Redux](http://redux.js.org/)
22
- * [Sass](http://sass-lang.com/)
23
- * [Nx](https://nx.dev/)
24
-
25
- ## Get Started
26
-
27
- A new application can be set up with these simple commands:
14
+ ## How to install
28
15
 
29
16
  ```shell
30
- # Starting a new angular application
31
- npm install -g @angular/cli
32
- ng new my-app
33
-
34
- # Add Otter framework
35
- ng add @o3r/core
17
+ ng add @o3r/styling-plugin
36
18
  ```
37
19
 
38
- > **Note**: Please refer to [Otter Get Started](./docs/core/START_NEW_APPLICATION.md) and [Angular Get Started](https://angular.io/guide/setup-local#install-the-angular-cli) for complete documentation.
39
-
40
- ## Contributing
41
-
42
- Please read the [Contributing](./CONTRIBUTING.md) file for details on our code of conduct and the process to submit pull requests.
43
-
44
- ## Versioning
45
-
46
- Please refer to [Security file](./SECURITY.md).
47
-
48
- ## License
49
-
50
- Please refer to the [License file](./LICENSE).
51
-
52
- ## Acknowledgments
53
-
54
- The Otter Team, @AmadeusITGroup/otter_admins, is responsible for the review of the code of this repository.
55
- Any bug of feature request can be addressed via [issue](https://github.com/AmadeusITGroup/otter/issues/new) report.
56
-
57
- ## Developer
58
-
59
- ### Building and Testing library
60
-
61
- These documents describe how to set up your development environment to build and test the framework.
62
- It also explains the basic mechanics of using `git`, `node`, and `npm`.
63
-
64
- - [Description](#description)
65
- - [Built With](#built-with)
66
- - [Get Started](#get-started)
67
- - [Contributing](#contributing)
68
- - [Versioning](#versioning)
69
- - [License](#license)
70
- - [Acknowledgments](#acknowledgments)
71
- - [Developer](#developer)
72
- - [Building and Testing library](#building-and-testing-library)
73
- - [Prerequisite Software](#prerequisite-software)
74
- - [Getting the Sources](#getting-the-sources)
75
- - [Installing NPM Modules](#installing-npm-modules)
76
- - [Build command](#build-command)
77
- - [Running tests locally](#running-tests-locally)
78
- - [Manage task cache](#manage-task-cache)
79
- - [Debugging with Visual Studio Code](#debugging-with-visual-studio-code)
80
- - [Link local packages](#link-local-packages)
81
-
82
- Refer to the [contribution guidelines](./CONTRIBUTING.md)
83
- if you'd like to contribute to the framework.
84
-
85
- #### Prerequisite Software
86
-
87
- Before you can build and test Otter modules, you must install and configure the
88
- following products on your development machine:
89
-
90
- * [Git](http://git-scm.com) and/or the **GitHub app** (for [Mac](http://mac.github.com) or
91
- [Windows](http://windows.github.com))
92
- * [GitHub's Guide to Installing
93
- Git](https://help.github.com/articles/set-up-git) is a good source of information.
94
-
95
- * [Node.js](http://nodejs.org), (version `>=10.0.0`)
96
- * This is used to run tests and generate distributable files. We also use Node's Package Manager, `npm`
97
- (version `>3.8.x`), which comes with Node. Depending on your system, you can install Node either from
98
- source or as a pre-packaged bundle.
99
-
100
- * [Yarn](https://yarnpkg.com/lang/en/docs/install/), a Node's Package Manager
101
- * You can install yarn using NPM manager (coming with Node.js).
102
- The version of Yarn currently used is embedded in the repository. In case you need to link this library with your project, you can check the section "Link local packages".
103
-
104
- * [Chrome](https://www.google.com/chrome/browser/desktop/index.html)
105
- * We use Chrome to run our tests.
106
-
107
- #### Getting the sources
108
-
109
- Clone the Otter repository using the button `Code` or using the following git command:
110
-
111
- ```shell
112
- git clone https://github.com/AmadeusITGroup/otter.git
113
- ```
114
-
115
- #### Installing NPM modules
116
-
117
- Next, install the JavaScript modules needed to build:
118
-
119
- ```shell
120
- # Install library project dependencies (package.json)
121
- yarn install
122
- ```
123
-
124
- #### Build command
125
-
126
- To build the modules, run:
127
-
128
- ```shell
129
- yarn run build
130
- ```
20
+ > **Warning**: this module requires [@o3r/core](https://www.npmjs.com/package/@o3r/core) to be installed.
131
21
 
132
- Each module can be built independently thanks to [Nx](https://nx.dev/packages/nx/documents/run) commands:
22
+ ## Rules
133
23
 
134
- ```shell
135
- # ex: Build Core package only
136
- yarn nx build core
137
- ```
138
-
139
- > **Note**: Results are put in the `dist` of each module (`packages/@<scope>/<module>/dist`).
140
-
141
- #### Running tests locally
142
-
143
- Check the formatting:
144
-
145
- ```shell
146
- yarn run lint
147
- ```
148
-
149
- Check Unit Tests:
150
-
151
- ```shell
152
- yarn run test
153
- ```
154
-
155
- Each module can be test independently thanks to [Nx](https://nx.dev/packages/nx/documents/run) commands:
156
-
157
- ```shell
158
- # ex: Test Core package only
159
- yarn nx test core
160
-
161
- # ex: Lint Core package only
162
- yarn nx lint core
163
- ```
164
-
165
- #### Manage task cache
166
-
167
- When running the Build, Lint, or Test commands, **Nx** can use its [cache mechanism](https://nx.dev/concepts/how-caching-works).
168
- In some cases, it may be useful to clear the cache to investigate an issue. This can be done with the following command:
169
-
170
- ```shell
171
- yarn nx reset
172
- ```
173
-
174
- #### Debugging with Visual Studio Code
175
-
176
- The repository contains the mandatory configuration and the recommended VSCode plugins to ensure optimal comfort and productivity while developing on the Otter Framework.
177
-
178
- The default configuration of the repository provides a way to run Unit Tests one by one and to define, within VSCode, break points using the `vscode-jest-tests` debugger task.
179
-
180
- #### Link local packages
181
-
182
- For Yarn v1, add the `resolutions` property in the main package.json. It should be filled with the relative path to the `dist` of the local packages you want to link. The protocol `link:` can be used.
183
-
184
- NOTE: It will not import the transitive dependencies of the linked packages.
185
-
186
- Example:
187
-
188
- ```json
189
- {
190
- "resolutions": {
191
- "@o3r/localization": "./relative/path/to/otter/packages/@o3r/localization/dist",
192
- "@o3r/core": "link:./relative/path/to/otter/packages/@o3r/core/dist",
193
- }
194
- }
195
- ```
196
-
197
- For Yarn v2+, the protocol `portal:` can also be used.
198
-
199
- NOTE: The portal protocol will also import all the transitive dependencies of the linked packages.
200
- Please keep in mind that mismatched versions of these dependencies may cause some issues.
201
-
202
- Example:
203
-
204
- ```json
205
- {
206
- "resolutions": {
207
- "@o3r/localization": "./relative/path/to/otter/library/@o3r/localization/dist",
208
- "@o3r/core": "link:./relative/path/to/otter/library/@o3r/core/dist",
209
- "@o3r/rules-engine": "portal:./relative/path/to/otter/library/@o3r/rules-engine/dist",
210
- }
211
- }
212
- ```
24
+ The list of rules is available in the [documentation](https://github.com/AmadeusITGroup/otter/tree/main/docs/linter/stylelint-plugin/rules.md).
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@o3r/stylelint-plugin",
3
- "version": "8.2.0-alpha.9",
3
+ "version": "8.2.0-alpha.90",
4
4
  "description": "Stylelint Otter Plugin",
5
5
  "keywords": [
6
6
  "stylelint",
@@ -27,10 +27,13 @@
27
27
  "devDependencies": {
28
28
  "@angular-eslint/eslint-plugin": "~15.2.0",
29
29
  "@angular/compiler": "~15.2.0",
30
+ "@babel/core": "~7.21.0",
31
+ "@babel/preset-typescript": "~7.21.0",
32
+ "@compodoc/compodoc": "^1.1.19",
30
33
  "@nrwl/jest": "~15.9.0",
31
- "@o3r/build-helpers": "^8.2.0-alpha.9",
32
- "@o3r/eslint-config-otter": "^8.2.0-alpha.9",
33
- "@o3r/eslint-plugin": "^8.2.0-alpha.9",
34
+ "@o3r/build-helpers": "^8.2.0-alpha.90",
35
+ "@o3r/eslint-config-otter": "^8.2.0-alpha.90",
36
+ "@o3r/eslint-plugin": "^8.2.0-alpha.90",
34
37
  "@types/jest": "~28.1.2",
35
38
  "@types/node": "^17.0.45",
36
39
  "@typescript-eslint/eslint-plugin": "^5.19.0",