tree-sitter-nsis 0.1.0

package/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Jan T. Sott
+
+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

@@ -0,0 +1,21 @@
+# tree-sitter-nsis
+
+> NSIS grammar for tree-sitter
+
+[![License](https://img.shields.io/github/license/idleberg/tree-sitter-nsis?color=blue&style=for-the-badge)](https://github.com/idleberg/tree-sitter-nsis/blob/main/LICENSE)
+[![Version: npm](https://img.shields.io/npm/v/tree-sitter-nsis?style=for-the-badge)](https://www.npmjs.org/package/tree-sitter-nsis)
+![GitHub branch check runs](https://img.shields.io/github/check-runs/idleberg/tree-sitter-nsis/main?style=for-the-badge)
+
+> [!WARNING]
+>
+> This package is in an experimental change and things might break.
+
+## Installation 💿
+
+```shell
+pnpm install tree-sitter-nsis
+```
+
+## License ©️
+
+[The MIT License](LICENSE) - Feel free to use, modify, and distribute this code.

package/grammar.js

@@ -0,0 +1,301 @@
+/// <reference types="tree-sitter-cli/dsl" />
+// @ts-check
+
+module.exports = grammar({
+  name: 'nsis',
+
+  extras: $ => [
+    /[ \t\r]/,
+    $.line_continuation,
+    $.comment,
+    $.block_comment,
+  ],
+
+  word: $ => $.identifier,
+
+  conflicts: $ => [],
+
+  rules: {
+    source_file: $ => repeat($._toplevel),
+
+    _toplevel: $ => choice(
+      $.function_definition,
+      $.section_definition,
+      $.section_group,
+      $.page_ex_block,
+      $.macro_definition,
+      $.preproc_conditional,
+      $.statement,
+      $.label,
+      $._newline,
+    ),
+
+    _newline: _ => /\n/,
+
+    // ── Block Definitions ──
+
+    function_definition: $ => seq(
+      alias(/function/i, 'Function'),
+      field('name', $._value),
+      $._newline,
+      repeat($._body_item),
+      alias(/functionend/i, 'FunctionEnd'),
+    ),
+
+    section_definition: $ => seq(
+      alias(/section/i, 'Section'),
+      repeat(field('parameter', $._value)),
+      $._newline,
+      repeat($._body_item),
+      alias(/sectionend/i, 'SectionEnd'),
+    ),
+
+    section_group: $ => seq(
+      alias(/sectiongroup/i, 'SectionGroup'),
+      repeat(field('parameter', $._value)),
+      $._newline,
+      repeat(choice(
+        $.section_definition,
+        $.section_group,
+        $.preproc_conditional,
+        $.statement,
+        $.label,
+        $._newline,
+      )),
+      alias(/sectiongroupend/i, 'SectionGroupEnd'),
+    ),
+
+    page_ex_block: $ => seq(
+      alias(/pageex/i, 'PageEx'),
+      optional(field('type', $._value)),
+      $._newline,
+      repeat($._body_item),
+      alias(/pageexend/i, 'PageExEnd'),
+    ),
+
+    macro_definition: $ => seq(
+      alias(/!macro/i, '!macro'),
+      field('name', $.identifier),
+      repeat(field('parameter', $.identifier)),
+      $._newline,
+      repeat($._macro_body_item),
+      alias(/!macroend/i, '!macroend'),
+    ),
+
+    _body_item: $ => choice(
+      $.preproc_conditional,
+      $.statement,
+      $.label,
+      $._newline,
+    ),
+
+    _macro_body_item: $ => choice(
+      $.function_definition,
+      $.section_definition,
+      $.section_group,
+      $.page_ex_block,
+      $.macro_definition,
+      $.preproc_conditional,
+      $.statement,
+      $.label,
+      $._newline,
+    ),
+
+    // ── Preprocessor Conditionals ──
+
+    preproc_conditional: $ => seq(
+      field('keyword', alias(
+        $._preproc_if_keyword,
+        $.preproc_keyword,
+      )),
+      repeat($._value),
+      $._newline,
+      repeat($._body_item),
+      repeat($.preproc_else),
+      alias(/!endif/i, '!endif'),
+    ),
+
+    preproc_else: $ => seq(
+      alias(/!else/i, '!else'),
+      optional(seq(
+        field('modifier', $.identifier),
+        repeat($._value),
+      )),
+      $._newline,
+      repeat($._body_item),
+    ),
+
+    _preproc_if_keyword: _ => choice(
+      /!ifdef/i,
+      /!ifndef/i,
+      /!ifmacrodef/i,
+      /!ifmacrondef/i,
+      /!if/i,
+    ),
+
+    // ── Statements ──
+
+    statement: $ => seq(
+      choice(
+        $.preproc_directive,
+        $.plugin_call,
+        $.variable_declaration,
+        $.command,
+      ),
+      $._newline,
+    ),
+
+    preproc_directive: $ => seq(
+      field('directive', $.preproc_keyword),
+      repeat(field('argument', $._value)),
+    ),
+
+    preproc_keyword: _ => choice(
+      /!addincludedir/i,
+      /!addplugindir/i,
+      /!appendfile/i,
+      /!assert/i,
+      /!cd/i,
+      /!define/i,
+      /!delfile/i,
+      /!echo/i,
+      /!error/i,
+      /!execute/i,
+      /!finalize/i,
+      /!getdllversion/i,
+      /!gettlbversion/i,
+      /!include/i,
+      /!insertmacro/i,
+      /!makensis/i,
+      /!packhdr/i,
+      /!pragma/i,
+      /!searchparse/i,
+      /!searchreplace/i,
+      /!system/i,
+      /!tempfile/i,
+      /!undef/i,
+      /!uninstfinalize/i,
+      /!verbose/i,
+      /!warning/i,
+    ),
+
+    command: $ => prec.right(seq(
+      field('name', $.identifier),
+      repeat(field('argument', $._value)),
+    )),
+
+    plugin_call: $ => seq(
+      field('plugin', $.identifier),
+      token.immediate('::'),
+      field('function', $.identifier),
+      repeat(field('argument', $._value)),
+    ),
+
+    variable_declaration: $ => seq(
+      alias(/var/i, 'Var'),
+      optional($.flag),
+      field('name', $.identifier),
+    ),
+
+    label: $ => seq(
+      field('name', $.identifier),
+      token.immediate(':'),
+    ),
+
+    // ── Values ──
+
+    _value: $ => choice(
+      $.string,
+      $.raw_string,
+      $.backtick_string,
+      $.variable,
+      $.define_reference,
+      $.lang_string_reference,
+      $.number,
+      $.flag,
+      $.label_reference,
+      $.comparison_operator,
+      $.pipe_operator,
+      $.identifier,
+    ),
+
+    pipe_operator: _ => '|',
+
+    label_reference: _ => /:[a-zA-Z_.][a-zA-Z0-9_.]*/,
+
+    // ── Strings ──
+
+    string: $ => seq(
+      '"',
+      repeat(choice(
+        $.string_content,
+        $._interpolation,
+      )),
+      '"',
+    ),
+
+    raw_string: $ => seq(
+      "'",
+      repeat(choice(
+        $.raw_string_content,
+        $._interpolation,
+      )),
+      "'",
+    ),
+
+    backtick_string: $ => seq(
+      '`',
+      repeat(choice(
+        $.backtick_string_content,
+        $._interpolation,
+      )),
+      '`',
+    ),
+
+    _interpolation: $ => choice(
+      $.variable,
+      $.define_reference,
+      $.lang_string_reference,
+      $.escape_sequence,
+    ),
+
+    string_content: _ => prec(-1, /[^"\n$]+/),
+    raw_string_content: _ => prec(-1, /[^'\n$]+/),
+    backtick_string_content: _ => prec(-1, /[^`\n$]+/),
+
+    escape_sequence: _ => token(choice(
+      /\$\\./,
+      '$$',
+    )),
+
+    // ── Variables & References ──
+
+    variable: _ => /\$([a-zA-Z_]\w*|[0-9])/,
+
+    define_reference: _ => /\$\{[\!\w\.:\^-]+\}/,
+
+    lang_string_reference: _ => /\$\([\!\w\.:\^-]+\)/,
+
+    // ── Literals ──
+
+    number: _ => /[+-]?[0-9]+(\.[0-9]+)?|0[xX][0-9a-fA-F]+/,
+
+    flag: _ => /\/[a-zA-Z_]\w*(=[^\s]*)?/,
+
+    comparison_operator: _ => choice('=', '!=', '<>', '<', '>'),
+
+    identifier: _ => /[a-zA-Z_.][a-zA-Z0-9_.]*/,
+
+    // ── Comments & Whitespace ──
+
+    comment: _ => token(seq(/[;#]/, /[^\n]*/)),
+
+    block_comment: _ => token(seq(
+      '/*',
+      /[^*]*\*+([^/*][^*]*\*+)*/,
+      '/',
+    )),
+
+    line_continuation: _ => token(seq('\\', /\r?\n/)),
+  },
+});

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "tree-sitter-nsis",
+  "version": "0.1.0",
+  "description": "NSIS grammar for tree-sitter",
+  "repository": "https://github.com/idleberg/tree-sitter-nsis",
+  "license": "MIT",
+  "author": "Jan T. Sott",
+  "keywords": [
+    "nsis",
+    "tree-sitter",
+    "parser"
+  ],
+  "files": [
+    "grammar.js",
+    "queries/*",
+    "src/**",
+    "*.wasm"
+  ],
+  "scripts": {
+    "generate": "tree-sitter generate",
+    "test": "tree-sitter test",
+    "parse": "tree-sitter parse"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^21.0.1",
+    "@commitlint/config-conventional": "^21.0.1",
+    "@idleberg/configs": "^0.4.2",
+    "tree-sitter-cli": "^0.25.0"
+  },
+  "tree-sitter": [
+    {
+      "scope": "source.nsis",
+      "file-types": [
+        "nsi",
+        "nsh"
+      ],
+      "highlights": "queries/highlights.scm",
+      "folds": "queries/folds.scm",
+      "indents": "queries/indents.scm"
+    }
+  ],
+  "packageManager": "pnpm@11.1.2"
+}

package/queries/folds.scm

@@ -0,0 +1,7 @@
+(function_definition) @fold
+(section_definition) @fold
+(section_group) @fold
+(page_ex_block) @fold
+(macro_definition) @fold
+(preproc_conditional) @fold
+(block_comment) @fold

package/queries/highlights.scm

@@ -0,0 +1,122 @@
+; ── Block Keywords ──
+
+(function_definition "Function" @keyword.function)
+(function_definition "FunctionEnd" @keyword.function)
+
+(section_definition "Section" @keyword)
+(section_definition "SectionEnd" @keyword)
+
+(section_group "SectionGroup" @keyword)
+(section_group "SectionGroupEnd" @keyword)
+
+(page_ex_block "PageEx" @keyword)
+(page_ex_block "PageExEnd" @keyword)
+
+(macro_definition "!macro" @keyword.directive)
+(macro_definition "!macroend" @keyword.directive)
+
+; ── Block Names ──
+
+(function_definition
+  name: (_) @function)
+
+(section_definition
+  parameter: (_) @string.special)
+
+(macro_definition
+  name: (identifier) @function.macro)
+
+(macro_definition
+  parameter: (identifier) @variable.parameter)
+
+; ── Preprocessor ──
+
+(preproc_conditional
+  keyword: (preproc_keyword) @keyword.directive)
+
+(preproc_conditional "!endif" @keyword.directive)
+
+(preproc_else "!else" @keyword.directive)
+
+(preproc_directive
+  directive: (preproc_keyword) @keyword.directive)
+
+; ── Variable Declaration ──
+
+(variable_declaration "Var" @keyword)
+(variable_declaration
+  name: (identifier) @variable)
+
+; ── Plugin Calls ──
+
+(plugin_call
+  plugin: (identifier) @module)
+(plugin_call
+  "::" @punctuation.delimiter)
+(plugin_call
+  function: (identifier) @function.method)
+
+; ── Labels ──
+
+(label
+  name: (identifier) @label)
+
+(label_reference) @label
+
+; ── Constants ──
+
+(identifier) @constant
+(#match? @constant "^(?i)(ARCHIVE|FILE_ATTRIBUTE_ARCHIVE|FILE_ATTRIBUTE_HIDDEN|FILE_ATTRIBUTE_NORMAL|FILE_ATTRIBUTE_OFFLINE|FILE_ATTRIBUTE_READONLY|FILE_ATTRIBUTE_SYSTEM|FILE_ATTRIBUTE_TEMPORARY|HIDDEN|HKCC|HKCR|HKCR32|HKCR64|HKCU|HKCU32|HKCU64|HKDD|HKEY_CLASSES_ROOT|HKEY_CURRENT_CONFIG|HKEY_CURRENT_USER|HKEY_DYN_DATA|HKEY_LOCAL_MACHINE|HKEY_PERFORMANCE_DATA|HKEY_USERS|HKLM|HKLM32|HKLM64|HKPD|HKU|IDABORT|IDCANCEL|IDD_DIR|IDD_INST|IDD_INSTFILES|IDD_LICENSE|IDD_SELCOM|IDD_UNINST|IDD_VERIFY|IDIGNORE|IDNO|IDOK|IDRETRY|IDYES|MB_ABORTRETRYIGNORE|MB_DEFBUTTON1|MB_DEFBUTTON2|MB_DEFBUTTON3|MB_DEFBUTTON4|MB_ICONEXCLAMATION|MB_ICONINFORMATION|MB_ICONQUESTION|MB_ICONSTOP|MB_OK|MB_OKCANCEL|MB_RETRYCANCEL|MB_RIGHT|MB_RTLREADING|MB_SETFOREGROUND|MB_TOPMOST|MB_USERICON|MB_YESNO|MB_YESNOCANCEL|NORMAL|OFFLINE|READONLY|SHCTX|SHELL_CONTEXT|SW_HIDE|SW_SHOWDEFAULT|SW_SHOWMAXIMIZED|SW_SHOWMINIMIZED|SW_SHOWNORMAL|SYSTEM|TEMPORARY)$")
+
+; ── Booleans ──
+
+(identifier) @boolean
+(#match? @boolean "^(?i)(true|on|false|off)$")
+
+; ── Commands ──
+
+(command
+  name: (identifier) @keyword
+  (#match? @keyword "^(?i)(Abort|AddBrandingImage|AddSize|AllowRootDirInstall|AllowSkipFiles|AutoCloseWindow|BGFont|BGGradient|BrandingText|BringToFront|Call|CallInstDLL|Caption|ChangeUI|CheckBitmap|ClearErrors|CompletedText|ComponentText|CopyFiles|CPU|CRCCheck|CreateDirectory|CreateFont|CreateShortCut|Delete|DeleteINISec|DeleteINIStr|DeleteRegKey|DeleteRegValue|DetailPrint|DetailsButtonText|DirText|DirVar|DirVerify|EnableWindow|EnumRegKey|EnumRegValue|Exch|Exec|ExecShell|ExecShellWait|ExecWait|ExpandEnvStrings|File|FileBufSize|FileClose|FileErrorText|FileOpen|FileRead|FileReadByte|FileReadUTF16LE|FileReadWord|FileWriteUTF16LE|FileSeek|FileWrite|FileWriteByte|FileWriteWord|FindClose|FindFirst|FindNext|FindWindow|FlushINI|GetCurInstType|GetCurrentAddress|GetDlgItem|GetDLLVersion|GetDLLVersionLocal|GetErrorLevel|GetFileTime|GetFileTimeLocal|GetFullPathName|GetFunctionAddress|GetInstDirError|GetKnownFolderPath|GetLabelAddress|GetRegView|GetShellVarContext|GetTempFileName|GetWinVer|Goto|HideWindow|Icon|IfAbort|IfAltRegView|IfErrors|IfFileExists|IfRebootFlag|IfRtlLanguage|IfShellVarContextAll|IfSilent|InitPluginsDir|InstallButtonText|InstallColors|InstallDir|InstallDirRegKey|InstProgressFlags|InstType|InstTypeGetText|InstTypeSetText|Int64Cmp|Int64CmpU|Int64Fmt|IntCmp|IntCmpU|IntFmt|IntOp|IntPtrCmp|IntPtrCmpU|IntPtrOp|IsWindow|LangString|LicenseBkColor|LicenseData|LicenseForceSelection|LicenseLangString|LicenseText|LoadAndSetImage|LoadLanguageFile|LockWindow|LogSet|LogText|ManifestAppendCustomString|ManifestDisableWindowFiltering|ManifestDPIAware|ManifestGdiScaling|ManifestLongPathAware|ManifestMaxVersionTested|ManifestSupportedOS|MessageBox|MiscButtonText|Name|Nop|OutFile|Page|PageCallbacks|PEAddResource|PEDllCharacteristics|PERemoveResource|PESubsysVer|Pop|Push|Quit|ReadEnvStr|ReadINIStr|ReadMemory|ReadRegDWORD|ReadRegStr|Reboot|RegDLL|Rename|RequestExecutionLevel|ReserveFile|Return|RMDir|SearchPath|SectionGetFlags|SectionGetInstTypes|SectionGetSize|SectionGetText|SectionIn|SectionSetFlags|SectionSetInstTypes|SectionSetSize|SectionSetText|SendMessage|SetAutoClose|SetBrandingImage|SetCompress|SetCompressionLevel|SetCompressor|SetCompressorDictSize|SetCtlColors|SetCurInstType|SetDatablockOptimize|SetDateSave|SetDetailsPrint|SetDetailsView|SetErrorLevel|SetErrors|SetFileAttributes|SetFont|SetOutPath|SetOverwrite|SetRebootFlag|SetRegView|SetShellVarContext|SetSilent|ShowInstDetails|ShowUninstDetails|ShowWindow|SilentInstall|SilentUnInstall|Sleep|SpaceTexts|StrCmp|StrCmpS|StrCpy|StrLen|SubCaption|Target|Unicode|UninstallButtonText|UninstallCaption|UninstallIcon|UninstallSubCaption|UninstallText|UninstPage|UnRegDLL|UnsafeStrCpy|VIAddVersionKey|VIFileVersion|VIProductVersion|WindowIcon|WriteINIStr|WriteRegBin|WriteRegDWORD|WriteRegExpandStr|WriteRegMultiStr|WriteRegNone|WriteRegStr|WriteUninstaller|XPStyle)$"))
+
+; ── Deprecated Commands ──
+
+(command
+  name: (identifier) @keyword.deprecated
+  (#match? @keyword.deprecated "^(?i)(CompareDLLVersions|CompareFileTimes|DirShow|DisabledBitmap|EnabledBitmap|GetFullDLLPath|GetParent|GetWinampInstPath|LangStringUP|PackEXEHeader|SectionDivider|SetPluginUnload|SubSection|SubSectionEnd|UninstallExeName)$"))
+
+; ── Variables & References ──
+
+(variable) @variable
+(define_reference) @constant.macro
+(lang_string_reference) @string.special
+
+; ── Built-in Variables ──
+
+(variable) @variable.builtin
+(#match? @variable.builtin "^\\$(?i)(ADMINTOOLS|APPDATA|CDBURN_AREA|CMDLINE|COMMONFILES|COOKIES|DESKTOP|DOCUMENTS|EXEDIR|EXEFILE|EXEPATH|FAVORITES|FONTS|HISTORY|HWNDPARENT|INSTDIR|INTERNET_CACHE|LANGUAGE|LOCALAPPDATA|MUSIC|NETHOOD|NSIS_MAX_STRLEN|NSIS_VERSION|NSISDIR|OUTDIR|PICTURES|PLUGINSDIR|PRINTHOOD|PROFILE|PROGRAMFILES|PROGRAMFILES32|PROGRAMFILES64|QUICKLAUNCH|RECENT|RESOURCES|RESOURCES_LOCALIZED|SENDTO|SMPROGRAMS|SMSTARTUP|STARTMENU|SYSDIR|TEMP|TEMPLATES|VIDEOS|WINDIR)$")
+
+; ── Strings ──
+
+(string) @string
+(raw_string) @string
+(backtick_string) @string
+(escape_sequence) @string.escape
+
+; ── Numbers ──
+
+(number) @number
+
+; ── Flags ──
+
+(flag) @attribute
+
+; ── Operators ──
+
+(comparison_operator) @operator
+(pipe_operator) @operator
+
+; ── Comments ──
+
+(comment) @comment.line
+(block_comment) @comment.block

package/queries/indents.scm

@@ -0,0 +1,17 @@
+(function_definition) @indent
+(function_definition "FunctionEnd" @outdent)
+
+(section_definition) @indent
+(section_definition "SectionEnd" @outdent)
+
+(section_group) @indent
+(section_group "SectionGroupEnd" @outdent)
+
+(page_ex_block) @indent
+(page_ex_block "PageExEnd" @outdent)
+
+(macro_definition) @indent
+(macro_definition "!macroend" @outdent)
+
+(preproc_conditional) @indent
+(preproc_conditional "!endif" @outdent)