@taskless/vale-grammars 0.0.0-stage → 3.27.0-20261117230017

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.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2016 Joseph Kato
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,55 @@
1
- # Temporary Holding Version
1
+ # @taskless/vale-grammars
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ The tree-sitter grammar modules that [Vale](https://vale.sh) uses to read
4
+ comments in source code, redistributed as an npm package so that
5
+ `@taskless/cli` can hand them to Vale with no download step at install or lint
6
+ time.
7
+
8
+ Since Vale 3.27.0 these grammars are WebAssembly modules that ship separately
9
+ from the Vale executable, and Vale normally installs them with `vale sync`.
10
+ Without them Vale finds comments by their delimiters, which lints linter
11
+ directives such as `//nolint` as prose and misses a one-line CSS `/* … */`
12
+ comment. `@taskless/cli` names this package's `grammars/` directory to Vale
13
+ through `VALE_GRAMMARS_PATH` instead.
14
+
15
+ ## What the published tarball holds
16
+
17
+ `grammars/<name>.wasm` for every grammar upstream publishes with the Vale
18
+ release, this README, Vale's upstream `LICENSE`, and `package.json`. Nothing
19
+ else: no `bin` entry, no JavaScript, and no lifecycle script.
20
+
21
+ There is one package for every platform, with no `os` or `cpu`, because a
22
+ WebAssembly module is the same bytes on every host. A grammar therefore cannot
23
+ be one version on macOS and another on Linux.
24
+
25
+ ## Versioning
26
+
27
+ Published versions are `<valeVersion>-<yyyymmddhhmmss>`, exactly as the
28
+ `@taskless/vale-<os>-<cpu>` packages are, and the release workflow stamps all
29
+ of them with one version in one run. `@taskless/cli` pins this package and the
30
+ platform packages at that same exact version.
31
+
32
+ The `version` field in the repository is the placeholder `0.0.0`. The release
33
+ workflow overwrites it with the stamped version immediately before packing, and
34
+ the placeholder is never itself published.
35
+
36
+ ## Where the grammars come from
37
+
38
+ The modules are not stored in this repository. `.github/workflows/release-vale.yml`
39
+ downloads each `grammar-<name>.zip` from the upstream Vale release, checks the
40
+ archive's SHA256 against the digest committed in
41
+ `.github/scripts/vale-manifest.json`, refuses to go further on a mismatch, and
42
+ only then reads the one `.wasm` member out of it.
43
+
44
+ Upstream's `vale_<version>_checksums.txt` does not cover these archives. Each
45
+ committed digest is the one GitHub records for the release asset when it is
46
+ uploaded, which anyone can read back from the releases API to check it.
47
+
48
+ ## License
49
+
50
+ Vale is MIT licensed, Copyright (c) 2016 Joseph Kato (errata-ai). The upstream
51
+ `LICENSE` ships in this package unmodified. Each grammar module is compiled by
52
+ the Vale project from the corresponding tree-sitter grammar, and upstream
53
+ distributes the modules without separate license files. This package
54
+ redistributes that build and is not affiliated with or endorsed by the Vale
55
+ project.
Binary file
Binary file
Binary file
Binary file
Binary file
Binary file
Binary file
Binary file
Binary file
Binary file
Binary file
Binary file
Binary file
Binary file
Binary file
Binary file
Binary file
Binary file
Binary file
Binary file
Binary file
Binary file
package/package.json CHANGED
@@ -1,6 +1,17 @@
1
1
  {
2
2
  "name": "@taskless/vale-grammars",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "description": "Vale's tree-sitter grammar modules, packaged for @taskless/cli",
4
+ "version": "3.27.0-20261117230017",
5
+ "license": "MIT",
6
+ "repository": {
7
+ "type": "git",
8
+ "url": "https://github.com/taskless/cli.git",
9
+ "directory": "packages/vale-grammars"
10
+ },
11
+ "files": [
12
+ "grammars"
13
+ ],
14
+ "publishConfig": {
15
+ "access": "public"
16
+ }
17
+ }