@konomanoasa/tree-sitter-diagnostic-sh 0.0.0-stage → 0.2.0

package/Cargo.toml

@@ -0,0 +1,37 @@
+[package]
+name = "konomanoasa-tree-sitter-diagnostic-sh"
+version = "0.2.0"
+edition = "2024"
+description = "Tree-sitter grammar for diagnostics of POSIX sh."
+readme = "README.md"
+repository = "https://github.com/konomanoasa/tree-sitter-diagnostic-sh"
+license = "MIT"
+build = "bindings/rust/build.rs"
+links = "tree-sitter-diagnostic-sh"
+include = [
+  "/LICENSE",
+  "/README.md",
+  "/bindings/rust/*.rs",
+  "/src/*.c",
+  "/src/node-types.json",
+  "/src/tree_sitter/*.h",
+  "/test/bindings.test.rs",
+  "/test/support/parser-cases.json",
+]
+
+[lib]
+path = "bindings/rust/lib.rs"
+
+[[test]]
+name = "bindings"
+path = "test/bindings.test.rs"
+
+[dependencies]
+tree-sitter-language = "0.1.8"
+
+[dev-dependencies]
+serde_json = "1"
+tree-sitter = "0.27.1"
+
+[build-dependencies]
+cc = "1.4"

package/LICENSE

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

package/README.md

@@ -1,3 +1,34 @@
-# Temporary Holding Version
+# tree-sitter-diagnostic-sh
 
-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.
+[![CI](https://github.com/konomanoasa/tree-sitter-diagnostic-sh/actions/workflows/ci.yaml/badge.svg)](https://github.com/konomanoasa/tree-sitter-diagnostic-sh/actions/workflows/ci.yaml)
+[![crates.io](https://img.shields.io/crates/v/konomanoasa-tree-sitter-diagnostic-sh)](https://crates.io/crates/konomanoasa-tree-sitter-diagnostic-sh)
+[![npm](https://img.shields.io/npm/v/@konomanoasa/tree-sitter-diagnostic-sh)](https://www.npmjs.com/package/@konomanoasa/tree-sitter-diagnostic-sh)
+
+[Tree-sitter](https://tree-sitter.github.io/tree-sitter/) grammar for
+diagnostics of the POSIX.1-2024 Shell Command Language.
+
+Guarantees cover fresh parsing only.
+
+## Installation
+
+```sh
+npm install @konomanoasa/tree-sitter-diagnostic-sh
+```
+
+## Development
+
+Development uses Node.js 24.21.0 or later.
+
+```sh
+npm install
+npm run build
+npm test
+```
+
+## Specification
+
+[POSIX.1-2024 Shell Command Language](https://pubs.opengroup.org/onlinepubs/9799919799.2024edition/utilities/V3_chap02.html)
+
+## License
+
+[MIT](LICENSE)

package/bindings/rust/build.rs

@@ -0,0 +1,12 @@
+fn main() {
+  println!("cargo::rerun-if-changed=src");
+  let mut build = cc::Build::new();
+  build.std("c17");
+  if build.get_compiler().is_like_msvc() {
+    build.flag("-utf-8");
+  }
+  build
+    .include("src")
+    .files(["src/parser.c", "src/scanner.c"])
+    .compile("tree-sitter-diagnostic-sh");
+}

package/bindings/rust/lib.rs

@@ -0,0 +1,10 @@
+use tree_sitter_language::LanguageFn;
+
+unsafe extern "C" {
+  fn tree_sitter_diagnostic_sh() -> *const ();
+}
+
+pub const LANGUAGE: LanguageFn =
+  unsafe { LanguageFn::from_raw(tree_sitter_diagnostic_sh) };
+
+pub const NODE_TYPES: &str = include_str!("../../src/node-types.json");

package/grammar.js

@@ -0,0 +1,174 @@
+const owners = [
+  "list",
+  "compound_list",
+  "and_or",
+  "pipeline",
+  "simple_command",
+  "word",
+  "subshell",
+  "brace_group",
+  "if_clause",
+  "else_part",
+  "for_clause",
+  "while_clause",
+  "until_clause",
+  "do_group",
+  "case_clause",
+  "case_item",
+  "function_definition",
+  "io_redirect",
+  "here_document_body",
+  "single_quoted",
+  "double_quoted",
+  "dollar_single_quoted",
+  "escaped_character",
+  "dollar_single_quote_escape",
+  "parameter_expansion",
+  "arithmetic_expansion",
+  "command_substitution",
+  "backquote_substitution",
+];
+
+const faults = [
+  "invalid_encoding",
+  "nul_character",
+  "unmatched_parenthesis",
+  "unmatched_brace",
+  "unexpected_then",
+  "unexpected_elif",
+  "unexpected_else",
+  "unmatched_fi",
+  "unexpected_do",
+  "unmatched_done",
+  "unmatched_esac",
+  "unexpected_in",
+  "unexpected_semicolon",
+  "unexpected_ampersand",
+  "unexpected_pipe",
+  "unexpected_and_if",
+  "unexpected_or_if",
+  "unexpected_case_separator",
+  "unexpected_case_fallthrough",
+  "unexpected_negation",
+  "command_gap",
+  "separator_gap",
+  "unspecified_negation_spacing",
+  "reserved_colon_word",
+  "redirection_target_gap",
+  "invalid_redirection_target",
+  "here_document_delimiter_gap",
+  "invalid_here_document_delimiter",
+  "here_document_ending_gap",
+  "unspecified_here_document_start",
+  "unspecified_here_document_newline",
+  "for_name_gap",
+  "invalid_for_name",
+  "for_separator_gap",
+  "invalid_for_header",
+  "invalid_for_separator",
+  "then_gap",
+  "fi_gap",
+  "do_gap",
+  "invalid_do",
+  "done_gap",
+  "in_gap",
+  "esac_gap",
+  "case_word_gap",
+  "invalid_case_word",
+  "invalid_in",
+  "case_pattern_gap",
+  "invalid_case_pattern",
+  "case_pattern_separator_error",
+  "parenthesis_gap",
+  "brace_gap",
+  "function_body_gap",
+  "invalid_function_body",
+  "function_parameter_error",
+  "single_quote_gap",
+  "double_quote_gap",
+  "dollar_quote_gap",
+  "incomplete_escape",
+  "unspecified_dollar_quote_escape",
+  "unspecified_empty_hex_escape",
+  "unspecified_control_escape",
+  "unspecified_hex_escape",
+  "unspecified_octal_escape",
+  "parameter_name_gap",
+  "invalid_parameter_name",
+  "parameter_operator_gap",
+  "parameter_operator_error",
+  "parameter_length_suffix_error",
+  "parameter_word_gap",
+  "parameter_ending_gap",
+  "unspecified_parameter_quote",
+  "unspecified_expansion_start",
+  "arithmetic_ending_gap",
+  "substitution_ending_gap",
+  "backquote_gap",
+  "undefined_backquote_quote",
+  "undefined_backquote_comment",
+  "undefined_backquote_here_document",
+  "undefined_backquote_substitution",
+];
+
+function contents($) {
+  return repeat(
+    choice(
+      $.source,
+      field("issue", $.syntax_issue),
+      field("unowned_issue", alias($._unowned_issue, $.syntax_issue)),
+      $._owner,
+    ),
+  );
+}
+
+function issue($) {
+  return seq(
+    field("fault", choice(...faults.map((kind) => $[kind]))),
+    optional(field("fragment", $.recovery_fragment)),
+    field("boundary", choice($.recovery_resume, $.recovery_eof)),
+  );
+}
+
+export default grammar({
+  name: "diagnostic_sh",
+  externals: ($) => [
+    $._start,
+    $._finish,
+    ...owners.map((kind) => $[`_begin_${kind}`]),
+    $._end_owner,
+    $._begin_issue,
+    $._begin_unowned_issue,
+    $.source,
+    ...faults.map((kind) => $[kind]),
+    $.recovery_fragment,
+    $.recovery_resume,
+    $.recovery_eof,
+  ],
+  // Prevents lexer fallback from accepting EOF mid-input.
+  extras: ($) => [$._unmatchable],
+  rules: {
+    program: ($) =>
+      seq(
+        $._start,
+        repeat(
+          choice(
+            $.source,
+            field("unowned_issue", alias($._unowned_issue, $.syntax_issue)),
+            $._owner,
+          ),
+        ),
+        $._finish,
+      ),
+    _owner: ($) => choice(...owners.map((kind) => $[kind])),
+    ...Object.fromEntries(
+      owners.map((kind) => [
+        kind,
+        ($) => seq($[`_begin_${kind}`], contents($), $._end_owner),
+      ]),
+    ),
+    syntax_issue: ($) => seq($._begin_issue, issue($)),
+    _unowned_issue: ($) => seq($._begin_unowned_issue, issue($)),
+    _unmatchable: () => token(seq(/[\s\S]/, /[^\s\S]/)),
+  },
+});

package/package.json

@@ -1,6 +1,41 @@
 {
   "name": "@konomanoasa/tree-sitter-diagnostic-sh",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "type": "module",
+  "description": "Tree-sitter grammar for diagnostics of POSIX sh.",
+  "license": "MIT",
+  "repository": "git+https://github.com/konomanoasa/tree-sitter-diagnostic-sh.git",
+  "files": [
+    "Cargo.toml",
+    "bindings/rust/*.rs",
+    "grammar.js",
+    "src/*.c",
+    "src/*.json",
+    "src/tree_sitter/*.h",
+    "test/bindings.test.rs",
+    "test/support/parser-cases.json",
+    "tree-sitter.json"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "npm run tree-sitter -- build-all",
+    "check": "biome check . && tsc --noEmit",
+    "format": "biome format --write .",
+    "generate": "npm run tree-sitter -- generate-all",
+    "test": "node --test --test-concurrency=1 \"test/*.test.js\"",
+    "test:sanitize": "node scripts/check-c.js --sanitize",
+    "test:scanner": "node scripts/check-c.js",
+    "tree-sitter": "node scripts/tree-sitter.js"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.5.15",
+    "@types/node": "26.6.5",
+    "tree-sitter-cli": "0.27.1",
+    "typescript": "7.0.2"
+  },
+  "allowScripts": {
+    "tree-sitter-cli": true
+  }
+}