ZedScripts 0.0.3__tar.gz → 1.0.1__tar.gz

zedscripts-1.0.1/PKG-INFO

@@ -0,0 +1,242 @@
+Metadata-Version: 2.4
+Name: ZedScripts
+Version: 1.0.1
+Author: SimKDT
+License: MIT License
+        
+        Copyright (c) 2026 PZ Wiki Modding
+        
+        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.
+        
+Requires-Python: >=3.12.3
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: lsprotocol
+Requires-Dist: pygls
+Requires-Dist: requests-cache
+Requires-Dist: pydantic
+Requires-Dist: deepmerge
+Provides-Extra: build
+Requires-Dist: pyinstaller; extra == "build"
+Provides-Extra: debug
+Requires-Dist: debugpy; extra == "debug"
+Dynamic: license-file
+
+# ZedScripts LSP
+
+[![License](https://img.shields.io/github/license/PZ-Wiki-Modding/ZedScripts?label=License)](LICENSE)
+![Code Size](https://img.shields.io/github/languages/code-size/PZ-Wiki-Modding/ZedScripts?label=Code%20Size)
+[![PyPi Version](https://img.shields.io/pypi/v/ZedScripts)](https://pypi.org/project/ZedScripts/)
+
+ZedScripts LSP is a language server protocol implemented in Python for the [scripting format](https://pzwiki.net/wiki/Scripts) of Project Zomboid. Previously a [VSCode extension](https://github.com/PZ-Wiki-Modding/ZedScripts), it is now reimplemented as a standalone LSP.
+
+It is powered by the [pz-scripts-data](https://github.com/PZ-Wiki-Modding/pz-scripts-data) to provide up-to-date information about the Scripts format. See [configuration](#configuration) to learn how to specify the dataset version.
+
+## Installation
+### Releases
+
+### Python package
+
+ZedScripts LSP is available directly as a Python package if you ever need to use its functionality outside of an IDE.
+
+<details open>
+<summary>PyPI</summary>
+
+```bash
+pip install ZedScripts
+```
+</details>
+
+<details>
+<summary>Git</summary>
+
+```bash
+pip install git+https://github.com/PZ-Wiki-Modding/ZedScripts-LSP.git
+```
+</details>
+
+<details>
+<summary>Dev</summary>
+
+```bash
+pip install -e .
+```
+</details>
+
+## Cache directory
+
+A cache directory is used on your system to cache the [pz-scripts-data](https://github.com/PZ-Wiki-Modding/pz-scripts-data) and logs, as well as global configuration. You can find it here:
+
+<details>
+<summary>Linux</summary>
+
+```bash
+~/.zedscripts
+```
+</details>
+
+<details>
+<summary>Windows</summary>
+
+```bash
+%USERPROFILE%\.zedscripts
+```
+</details>
+
+## Configuration
+
+The LSP uses configurations files `.zedscripts.json` which provide information to the LSP about various settings.
+
+Example of configuration file content:
+```json
+{
+    "$schema": "https://raw.githubusercontent.com/PZ-Wiki-Modding/ZedScripts-LSP/refs/heads/main/schema/zedscripts.json",
+    "dataset": {
+        "latest": true
+    },
+    "libraries": [
+        "~/.steam/debian-installation/steamapps/common/ProjectZomboid/projectzomboid/media",
+    ]
+}
+```
+
+They are optional and should be placed at the root of your workspaces or in the [cache directory](#cache-directory). The local configuration (root of your workspaces) will override the global configuration (cache directory).
+
+```bash
+📁 workspace1
+    📁 Contents/mods/YourMod/42/media/scripts
+        📄 example_script.txt
+    📄 .zedscripts.json
+📁 workspace2
+    📄 .zedscripts.json
+```
+```bash
+📁 ~
+    📁 .zedscripts
+        📄 .zedscripts.json
+```
+
+A schema is available to validate the configuration files and can be found in the [schema directory](schema/zedscripts.json).
+
+See the following sections for detailed explanation of each parameters.
+
+### Dataset
+You can configure the version of the [pz-scripts-data](https://github.com/PZ-Wiki-Modding/pz-scripts-data) dataset.
+
+```json
+{
+    "dataset": {
+        ...
+    }
+}
+```
+
+The key-values which can be set in the `dataset` section are the following:
+- `latest`: a boolean indicating the LSP to use the latest available version for the dataset (latest game version and dataset version)
+- `stable`: a boolean indicating the LSP to use the latest stable version of the dataset
+- `release`: used to indicate a specific release version of the dataset with the following arguments:
+  - `major`: major build version (e.g. `42`, `43`)
+  - `minor`: minor build version (e.g. `0`, `1`)
+  - `patch`: patch build version (e.g. `0`, `1`)
+  - `version` (optional): the dataset version (e.g. `0`, `1`, `2`)
+  - for example, version `42.21.0` of the game would be specified as:
+```json
+{
+    "release": {
+        "major": 42,
+        "minor": 21,
+        "patch": 0
+    }
+}
+```
+
+It's suggested to use the `stable` option.
+
+### Libraries
+A list of paths that should include the base game path, as well as other games that your mod depends on for its scripts. This will provide LSP the ability to find other blocks definitions that you may reference inside your mod's scripts.
+```json
+{
+    "libraries": [
+        "path/to/base/game",
+        "path/to/other/dependent/game"
+    ]
+}
+```
+
+### Ignored
+A list of regex patterns tested on file paths that should be ignored by the LSP, by default this includes large script files that can slow down the LSP.
+```json
+{
+    "ignored": [
+        "path/to/large/script/file"
+    ]
+}
+```
+
+### Diagnostics
+A list of diagnostics with modifiers to change the diagnostic behavior of the LSP. The following parameters:
+- `type`: the type of the diagnostic, that is the ID shown in the diagnostics hover tooltip (for example, `BLOCK_UNKNOWN_BLOCK`)
+- `enable` (optional): boolean to disable the diagnostic
+- `severity` (optional): the severity level of the diagnostic (accepted values: `Error`, `Warning`, `Information`, `Hint`)
+- `tags` (optional): an array of tags which an IDE may use to provide additional context or behavior for the diagnostic (accepted values: `Unnecessary`, `Deprecated`)
+
+Each diagnostic by default have a specific set of modifiers that can be overridden in the configuration.
+
+```json
+{
+    "diagnostics": [
+        {
+            "type": "BLOCK_UNKNOWN_BLOCK",
+            "enable": true,
+            "severity": "Warning",
+            "tags": ["Unnecessary"]
+        }
+    ]
+}
+```
+
+## IDE configuration
+Based on the IDE you use, you may need to install the ZedScripts LSP application for your OS in the [releases](https://github.com/PZ-Wiki-Modding/ZedScripts-LSP/releases) (Linux, Windows).
+
+### Visual Studio Code
+
+Install the [ZedScripts extension](https://marketplace.visualstudio.com/items?itemName=SimKDT.ZedScripts) from the Visual Studio Code marketplace. The extension will handle the downloading and setup of the ZedScripts LSP server for you.
+
+### VIM
+
+Using [yegappan/lsp](https://github.com/yegappan/lsp), setup the ZedScripts LSP server as follows:
+
+```vim
+let lspServers = [
+      \ #{
+      \   name: 'zedscripts',
+      \   filetype: ['text', 'zedscripts'],
+      \   path: 'path/to/ZedScripts',
+      \   args: []
+      \ }
+      \ ]
+
+autocmd User LspSetup call LspAddServer(lspServers)
+```
+
+> [!NOTE]
+> You can see [this video](https://www.youtube.com/watch?v=-5lb_jLQmKc) which explains how to set up VIM, and notably setup a LSP server.
+
+## License and contribution
+This project is licensed under a [MIT license](LICENSE). Before contributing to the project, please see [CONTRIBUTING](CONTRIBUTING.md).

zedscripts-1.0.1/README.md

@@ -0,0 +1,202 @@
+# ZedScripts LSP
+
+[![License](https://img.shields.io/github/license/PZ-Wiki-Modding/ZedScripts?label=License)](LICENSE)
+![Code Size](https://img.shields.io/github/languages/code-size/PZ-Wiki-Modding/ZedScripts?label=Code%20Size)
+[![PyPi Version](https://img.shields.io/pypi/v/ZedScripts)](https://pypi.org/project/ZedScripts/)
+
+ZedScripts LSP is a language server protocol implemented in Python for the [scripting format](https://pzwiki.net/wiki/Scripts) of Project Zomboid. Previously a [VSCode extension](https://github.com/PZ-Wiki-Modding/ZedScripts), it is now reimplemented as a standalone LSP.
+
+It is powered by the [pz-scripts-data](https://github.com/PZ-Wiki-Modding/pz-scripts-data) to provide up-to-date information about the Scripts format. See [configuration](#configuration) to learn how to specify the dataset version.
+
+## Installation
+### Releases
+
+### Python package
+
+ZedScripts LSP is available directly as a Python package if you ever need to use its functionality outside of an IDE.
+
+<details open>
+<summary>PyPI</summary>
+
+```bash
+pip install ZedScripts
+```
+</details>
+
+<details>
+<summary>Git</summary>
+
+```bash
+pip install git+https://github.com/PZ-Wiki-Modding/ZedScripts-LSP.git
+```
+</details>
+
+<details>
+<summary>Dev</summary>
+
+```bash
+pip install -e .
+```
+</details>
+
+## Cache directory
+
+A cache directory is used on your system to cache the [pz-scripts-data](https://github.com/PZ-Wiki-Modding/pz-scripts-data) and logs, as well as global configuration. You can find it here:
+
+<details>
+<summary>Linux</summary>
+
+```bash
+~/.zedscripts
+```
+</details>
+
+<details>
+<summary>Windows</summary>
+
+```bash
+%USERPROFILE%\.zedscripts
+```
+</details>
+
+## Configuration
+
+The LSP uses configurations files `.zedscripts.json` which provide information to the LSP about various settings.
+
+Example of configuration file content:
+```json
+{
+    "$schema": "https://raw.githubusercontent.com/PZ-Wiki-Modding/ZedScripts-LSP/refs/heads/main/schema/zedscripts.json",
+    "dataset": {
+        "latest": true
+    },
+    "libraries": [
+        "~/.steam/debian-installation/steamapps/common/ProjectZomboid/projectzomboid/media",
+    ]
+}
+```
+
+They are optional and should be placed at the root of your workspaces or in the [cache directory](#cache-directory). The local configuration (root of your workspaces) will override the global configuration (cache directory).
+
+```bash
+📁 workspace1
+    📁 Contents/mods/YourMod/42/media/scripts
+        📄 example_script.txt
+    📄 .zedscripts.json
+📁 workspace2
+    📄 .zedscripts.json
+```
+```bash
+📁 ~
+    📁 .zedscripts
+        📄 .zedscripts.json
+```
+
+A schema is available to validate the configuration files and can be found in the [schema directory](schema/zedscripts.json).
+
+See the following sections for detailed explanation of each parameters.
+
+### Dataset
+You can configure the version of the [pz-scripts-data](https://github.com/PZ-Wiki-Modding/pz-scripts-data) dataset.
+
+```json
+{
+    "dataset": {
+        ...
+    }
+}
+```
+
+The key-values which can be set in the `dataset` section are the following:
+- `latest`: a boolean indicating the LSP to use the latest available version for the dataset (latest game version and dataset version)
+- `stable`: a boolean indicating the LSP to use the latest stable version of the dataset
+- `release`: used to indicate a specific release version of the dataset with the following arguments:
+  - `major`: major build version (e.g. `42`, `43`)
+  - `minor`: minor build version (e.g. `0`, `1`)
+  - `patch`: patch build version (e.g. `0`, `1`)
+  - `version` (optional): the dataset version (e.g. `0`, `1`, `2`)
+  - for example, version `42.21.0` of the game would be specified as:
+```json
+{
+    "release": {
+        "major": 42,
+        "minor": 21,
+        "patch": 0
+    }
+}
+```
+
+It's suggested to use the `stable` option.
+
+### Libraries
+A list of paths that should include the base game path, as well as other games that your mod depends on for its scripts. This will provide LSP the ability to find other blocks definitions that you may reference inside your mod's scripts.
+```json
+{
+    "libraries": [
+        "path/to/base/game",
+        "path/to/other/dependent/game"
+    ]
+}
+```
+
+### Ignored
+A list of regex patterns tested on file paths that should be ignored by the LSP, by default this includes large script files that can slow down the LSP.
+```json
+{
+    "ignored": [
+        "path/to/large/script/file"
+    ]
+}
+```
+
+### Diagnostics
+A list of diagnostics with modifiers to change the diagnostic behavior of the LSP. The following parameters:
+- `type`: the type of the diagnostic, that is the ID shown in the diagnostics hover tooltip (for example, `BLOCK_UNKNOWN_BLOCK`)
+- `enable` (optional): boolean to disable the diagnostic
+- `severity` (optional): the severity level of the diagnostic (accepted values: `Error`, `Warning`, `Information`, `Hint`)
+- `tags` (optional): an array of tags which an IDE may use to provide additional context or behavior for the diagnostic (accepted values: `Unnecessary`, `Deprecated`)
+
+Each diagnostic by default have a specific set of modifiers that can be overridden in the configuration.
+
+```json
+{
+    "diagnostics": [
+        {
+            "type": "BLOCK_UNKNOWN_BLOCK",
+            "enable": true,
+            "severity": "Warning",
+            "tags": ["Unnecessary"]
+        }
+    ]
+}
+```
+
+## IDE configuration
+Based on the IDE you use, you may need to install the ZedScripts LSP application for your OS in the [releases](https://github.com/PZ-Wiki-Modding/ZedScripts-LSP/releases) (Linux, Windows).
+
+### Visual Studio Code
+
+Install the [ZedScripts extension](https://marketplace.visualstudio.com/items?itemName=SimKDT.ZedScripts) from the Visual Studio Code marketplace. The extension will handle the downloading and setup of the ZedScripts LSP server for you.
+
+### VIM
+
+Using [yegappan/lsp](https://github.com/yegappan/lsp), setup the ZedScripts LSP server as follows:
+
+```vim
+let lspServers = [
+      \ #{
+      \   name: 'zedscripts',
+      \   filetype: ['text', 'zedscripts'],
+      \   path: 'path/to/ZedScripts',
+      \   args: []
+      \ }
+      \ ]
+
+autocmd User LspSetup call LspAddServer(lspServers)
+```
+
+> [!NOTE]
+> You can see [this video](https://www.youtube.com/watch?v=-5lb_jLQmKc) which explains how to set up VIM, and notably setup a LSP server.
+
+## License and contribution
+This project is licensed under a [MIT license](LICENSE). Before contributing to the project, please see [CONTRIBUTING](CONTRIBUTING.md).

{zedscripts-0.0.3 → zedscripts-1.0.1}/pyproject.toml

@@ -3,9 +3,8 @@ name = "ZedScripts"
 description = ""
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.12.3"
-version = "0.0.3"
-license = "MIT"
-license-files = ["LICENSE"]
+version = "1.0.1"
+license = {file = "LICENSE"}
 authors = [
   { name = "SimKDT" },
 ]

zedscripts-1.0.1/src/ZedScripts/__about__.py

@@ -0,0 +1,4 @@
+__version__ = "1.0.1"
+
+if __name__ == "__main__":
+    print(__version__)

{zedscripts-0.0.3 → zedscripts-1.0.1}/src/ZedScripts/enums/Diagnostic.py

@@ -76,7 +76,7 @@ DiagnosticDefinition(DiagnosticType.BLOCK_UNEXPECTED_ID,
                      tags=[DiagnosticTag.Unnecessary])
 DiagnosticDefinition(DiagnosticType.BLOCK_MISSING_ID,
                      DiagnosticSeverity.Error,
-                     args={"type": str, "id": str})
+                     args={"type": str})
 DiagnosticDefinition(DiagnosticType.BLOCK_HAS_ID_IN_PARENT,
                      DiagnosticSeverity.Error,
                      args={"type": str, "parent_type": str, "invalid_blocks": list},

{zedscripts-0.0.3 → zedscripts-1.0.1}/src/ZedScripts/providers/notifications.py

@@ -1,6 +1,6 @@
 import enum
 
-from typing import TYPE_CHECKING, Literal, overload
+from typing import TYPE_CHECKING, Literal, overload, Any
 if TYPE_CHECKING:
     from ..environment import WorkspaceType
 
@@ -40,6 +40,10 @@ def send_notification(
 def send_notification(
     notification: Literal[ZedNotification.LOADING_DOCUMENTS],
     *, uri: str, workspace_type: 'WorkspaceType', index: int) -> None: ...
+@overload
+def send_notification(
+    notification: Literal[ZedNotification.LOADING_DOCUMENTS_DONE],
+) -> None: ...
 
 
 def send_notification(notification: ZedNotification, **kargs) -> None:

{zedscripts-0.0.3 → zedscripts-1.0.1}/src/ZedScripts/scripts/block.py

@@ -405,7 +405,7 @@ class ScriptBlock(Block, Element["BlockNode"]):
                 self.add_diagnostic(
                     DiagnosticType.BLOCK_MISSING_ID,
                     node.type.to_range(),
-                    {"id": ID_data}
+                    {"type": type}
                 )
                 return False
 

{zedscripts-0.0.3 → zedscripts-1.0.1}/src/ZedScripts/server.py

@@ -31,7 +31,7 @@ class ZedServer(LanguageServer):
         zedlocalizer.load_locale_files()
         ZedServer.instance = self
 
-    def send_notification(self, method: notifications.ZedNotification, params: dict | None = None) -> None:
+    def send_notification(self, method: notifications.ZedNotification, params: dict = {}) -> None:
         logging.debug("Sending notification: %s with params: %s", method, params)
         self.protocol.notify(
             method,
@@ -214,7 +214,7 @@ def initialized(server: ZedServer, params: types.InitializedParams) -> None:
     if should_load_libraries:
         Workspace.load_libraries()
 
-    server.send_notification(notifications.ZedNotification.LOADING_DOCUMENTS_DONE)
+    notifications.send_notification(notifications.ZedNotification.LOADING_DOCUMENTS_DONE)
 
 
 @zedserver.feature(types.TEXT_DOCUMENT_DID_OPEN)

{zedscripts-0.0.3 → zedscripts-1.0.1}/src/ZedScripts/structure/parser.py

@@ -93,10 +93,6 @@ def parse_type_id(tokens: list[Token]) -> tuple[TokenCollection | None, TokenCol
     return type_token, id_token
 
 
-def parse(text: str) -> ParseResult:
-    return parse_tokens(Lexer.tokenize(text))
-
-
 def parse_tokens(tokens: TokenCollection) -> ParseResult:
     parser = Parser()
     unparsed_tokens: list[Token] = []

zedscripts-1.0.1/src/ZedScripts.egg-info/PKG-INFO

@@ -0,0 +1,242 @@
+Metadata-Version: 2.4
+Name: ZedScripts
+Version: 1.0.1
+Author: SimKDT
+License: MIT License
+        
+        Copyright (c) 2026 PZ Wiki Modding
+        
+        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.
+        
+Requires-Python: >=3.12.3
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: lsprotocol
+Requires-Dist: pygls
+Requires-Dist: requests-cache
+Requires-Dist: pydantic
+Requires-Dist: deepmerge
+Provides-Extra: build
+Requires-Dist: pyinstaller; extra == "build"
+Provides-Extra: debug
+Requires-Dist: debugpy; extra == "debug"
+Dynamic: license-file
+
+# ZedScripts LSP
+
+[![License](https://img.shields.io/github/license/PZ-Wiki-Modding/ZedScripts?label=License)](LICENSE)
+![Code Size](https://img.shields.io/github/languages/code-size/PZ-Wiki-Modding/ZedScripts?label=Code%20Size)
+[![PyPi Version](https://img.shields.io/pypi/v/ZedScripts)](https://pypi.org/project/ZedScripts/)
+
+ZedScripts LSP is a language server protocol implemented in Python for the [scripting format](https://pzwiki.net/wiki/Scripts) of Project Zomboid. Previously a [VSCode extension](https://github.com/PZ-Wiki-Modding/ZedScripts), it is now reimplemented as a standalone LSP.
+
+It is powered by the [pz-scripts-data](https://github.com/PZ-Wiki-Modding/pz-scripts-data) to provide up-to-date information about the Scripts format. See [configuration](#configuration) to learn how to specify the dataset version.
+
+## Installation
+### Releases
+
+### Python package
+
+ZedScripts LSP is available directly as a Python package if you ever need to use its functionality outside of an IDE.
+
+<details open>
+<summary>PyPI</summary>
+
+```bash
+pip install ZedScripts
+```
+</details>
+
+<details>
+<summary>Git</summary>
+
+```bash
+pip install git+https://github.com/PZ-Wiki-Modding/ZedScripts-LSP.git
+```
+</details>
+
+<details>
+<summary>Dev</summary>
+
+```bash
+pip install -e .
+```
+</details>
+
+## Cache directory
+
+A cache directory is used on your system to cache the [pz-scripts-data](https://github.com/PZ-Wiki-Modding/pz-scripts-data) and logs, as well as global configuration. You can find it here:
+
+<details>
+<summary>Linux</summary>
+
+```bash
+~/.zedscripts
+```
+</details>
+
+<details>
+<summary>Windows</summary>
+
+```bash
+%USERPROFILE%\.zedscripts
+```
+</details>
+
+## Configuration
+
+The LSP uses configurations files `.zedscripts.json` which provide information to the LSP about various settings.
+
+Example of configuration file content:
+```json
+{
+    "$schema": "https://raw.githubusercontent.com/PZ-Wiki-Modding/ZedScripts-LSP/refs/heads/main/schema/zedscripts.json",
+    "dataset": {
+        "latest": true
+    },
+    "libraries": [
+        "~/.steam/debian-installation/steamapps/common/ProjectZomboid/projectzomboid/media",
+    ]
+}
+```
+
+They are optional and should be placed at the root of your workspaces or in the [cache directory](#cache-directory). The local configuration (root of your workspaces) will override the global configuration (cache directory).
+
+```bash
+📁 workspace1
+    📁 Contents/mods/YourMod/42/media/scripts
+        📄 example_script.txt
+    📄 .zedscripts.json
+📁 workspace2
+    📄 .zedscripts.json
+```
+```bash
+📁 ~
+    📁 .zedscripts
+        📄 .zedscripts.json
+```
+
+A schema is available to validate the configuration files and can be found in the [schema directory](schema/zedscripts.json).
+
+See the following sections for detailed explanation of each parameters.
+
+### Dataset
+You can configure the version of the [pz-scripts-data](https://github.com/PZ-Wiki-Modding/pz-scripts-data) dataset.
+
+```json
+{
+    "dataset": {
+        ...
+    }
+}
+```
+
+The key-values which can be set in the `dataset` section are the following:
+- `latest`: a boolean indicating the LSP to use the latest available version for the dataset (latest game version and dataset version)
+- `stable`: a boolean indicating the LSP to use the latest stable version of the dataset
+- `release`: used to indicate a specific release version of the dataset with the following arguments:
+  - `major`: major build version (e.g. `42`, `43`)
+  - `minor`: minor build version (e.g. `0`, `1`)
+  - `patch`: patch build version (e.g. `0`, `1`)
+  - `version` (optional): the dataset version (e.g. `0`, `1`, `2`)
+  - for example, version `42.21.0` of the game would be specified as:
+```json
+{
+    "release": {
+        "major": 42,
+        "minor": 21,
+        "patch": 0
+    }
+}
+```
+
+It's suggested to use the `stable` option.
+
+### Libraries
+A list of paths that should include the base game path, as well as other games that your mod depends on for its scripts. This will provide LSP the ability to find other blocks definitions that you may reference inside your mod's scripts.
+```json
+{
+    "libraries": [
+        "path/to/base/game",
+        "path/to/other/dependent/game"
+    ]
+}
+```
+
+### Ignored
+A list of regex patterns tested on file paths that should be ignored by the LSP, by default this includes large script files that can slow down the LSP.
+```json
+{
+    "ignored": [
+        "path/to/large/script/file"
+    ]
+}
+```
+
+### Diagnostics
+A list of diagnostics with modifiers to change the diagnostic behavior of the LSP. The following parameters:
+- `type`: the type of the diagnostic, that is the ID shown in the diagnostics hover tooltip (for example, `BLOCK_UNKNOWN_BLOCK`)
+- `enable` (optional): boolean to disable the diagnostic
+- `severity` (optional): the severity level of the diagnostic (accepted values: `Error`, `Warning`, `Information`, `Hint`)
+- `tags` (optional): an array of tags which an IDE may use to provide additional context or behavior for the diagnostic (accepted values: `Unnecessary`, `Deprecated`)
+
+Each diagnostic by default have a specific set of modifiers that can be overridden in the configuration.
+
+```json
+{
+    "diagnostics": [
+        {
+            "type": "BLOCK_UNKNOWN_BLOCK",
+            "enable": true,
+            "severity": "Warning",
+            "tags": ["Unnecessary"]
+        }
+    ]
+}
+```
+
+## IDE configuration
+Based on the IDE you use, you may need to install the ZedScripts LSP application for your OS in the [releases](https://github.com/PZ-Wiki-Modding/ZedScripts-LSP/releases) (Linux, Windows).
+
+### Visual Studio Code
+
+Install the [ZedScripts extension](https://marketplace.visualstudio.com/items?itemName=SimKDT.ZedScripts) from the Visual Studio Code marketplace. The extension will handle the downloading and setup of the ZedScripts LSP server for you.
+
+### VIM
+
+Using [yegappan/lsp](https://github.com/yegappan/lsp), setup the ZedScripts LSP server as follows:
+
+```vim
+let lspServers = [
+      \ #{
+      \   name: 'zedscripts',
+      \   filetype: ['text', 'zedscripts'],
+      \   path: 'path/to/ZedScripts',
+      \   args: []
+      \ }
+      \ ]
+
+autocmd User LspSetup call LspAddServer(lspServers)
+```
+
+> [!NOTE]
+> You can see [this video](https://www.youtube.com/watch?v=-5lb_jLQmKc) which explains how to set up VIM, and notably setup a LSP server.
+
+## License and contribution
+This project is licensed under a [MIT license](LICENSE). Before contributing to the project, please see [CONTRIBUTING](CONTRIBUTING.md).

zedscripts-0.0.3/PKG-INFO

@@ -1,132 +0,0 @@
-Metadata-Version: 2.4
-Name: ZedScripts
-Version: 0.0.3
-Author: SimKDT
-License-Expression: MIT
-Requires-Python: >=3.12.3
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: lsprotocol
-Requires-Dist: pygls
-Requires-Dist: requests-cache
-Requires-Dist: pydantic
-Requires-Dist: deepmerge
-Provides-Extra: build
-Requires-Dist: pyinstaller; extra == "build"
-Provides-Extra: debug
-Requires-Dist: debugpy; extra == "debug"
-Dynamic: license-file
-
-# ZedScripts LSP
-
-[![License](https://img.shields.io/github/license/PZ-Wiki-Modding/ZedScripts?label=License)](LICENSE)
-![Code Size](https://img.shields.io/github/languages/code-size/PZ-Wiki-Modding/ZedScripts?label=Code%20Size)
-[![PyPi Version](https://img.shields.io/pypi/v/ZedScripts)](https://pypi.org/project/ZedScripts/)
-[![PyPi Downloads](https://img.shields.io/pypi/dm/ZedScripts)](https://pypi.org/project/ZedScripts/)
-![PyPI Python Version](https://img.shields.io/pypi/pyversions/ZedScripts)
-
-> [!IMPORTANT]
-> Work In Progress, this is a BETA release
-
-ZedScripts LSP is a language server protocol implementation in Python for the [scripting format]() of Project Zomboid. Previously a VSCode extension, it is now reimplemented as a standalone LSP.
-
-## Installation
-### Releases
-
-### Python package
-
-<!-- <details open>
-<summary>PyPi</summary>
-
-```bash
-pip install ZedScripts-LSP
-```
-</details> -->
-
-<details>
-<summary>Git</summary>
-
-```bash
-pip install git+https://github.com/PZ-Wiki-Modding/ZedScripts-LSP.git
-```
-</details>
-
-<details>
-<summary>Local</summary>
-
-```bash
-pip install .
-```
-</details>
-
-## Usage
-
-You can either launch the LSP from Python or you can launch the software as is.
-
-### LSP cache directory
-
-The LSP uses a cache directory on your system to store temporary files and logs as well as configuration files. You can find it here: 
-
-<details>
-<summary>Linux</summary>
-
-```bash
-~/.zedscripts
-```
-</details>
-
-<details>
-<summary>Windows</summary>
-
-```bash
-%USERPROFILE%\.zedscripts
-```
-</details>
-
-### Configuration
-
-The LSP uses configurations files which provide information to the LSP about various settings. You have access to a global configuration file
-
-Example configuration:
-```json
-{
-    "dataset": {
-        "latest": true
-    },
-    "libraries": [
-        "/home/simon/.steam/debian-installation/steamapps/common/ProjectZomboid/projectzomboid/media",
-    ]
-}
-```
-
-WIP: proper documentation will come soon
-
-## IDE configuration
-Based on the IDE you use, you may need to install the ZedScripts LSP application for your OS in the [releases](https://github.com/PZ-Wiki-Modding/ZedScripts-LSP/releases) (Linux, Windows).
-
-### Visual Studio Code
-
-Install the [ZedScripts extension](https://marketplace.visualstudio.com/items?itemName=SimKDT.ZedScripts) from the Visual Studio Code marketplace. The extension will handle the downloading and setup of the ZedScripts LSP server for you.
-
-### VIM
-
-Using [yegappan/lsp](https://github.com/yegappan/lsp), setup the ZedScripts LSP server as follows:
-
-```vim
-let lspServers = [
-      \ #{
-      \   name: 'zedscripts',
-      \   filetype: ['text', 'zedscripts'],
-      \   path: 'path/to/ZedScripts',
-      \   args: []
-      \ }
-      \ ]
-
-autocmd User LspSetup call LspAddServer(lspServers)
-```
-
-> [!NOTE]
-> You can see [this video](https://www.youtube.com/watch?v=-5lb_jLQmKc) which explains how to set up VIM, and notably setup a LSP server.
-
-## License
-See [LICENSE](LICENSE) for details.

zedscripts-0.0.3/README.md

@@ -1,113 +0,0 @@
-# ZedScripts LSP
-
-[![License](https://img.shields.io/github/license/PZ-Wiki-Modding/ZedScripts?label=License)](LICENSE)
-![Code Size](https://img.shields.io/github/languages/code-size/PZ-Wiki-Modding/ZedScripts?label=Code%20Size)
-[![PyPi Version](https://img.shields.io/pypi/v/ZedScripts)](https://pypi.org/project/ZedScripts/)
-[![PyPi Downloads](https://img.shields.io/pypi/dm/ZedScripts)](https://pypi.org/project/ZedScripts/)
-![PyPI Python Version](https://img.shields.io/pypi/pyversions/ZedScripts)
-
-> [!IMPORTANT]
-> Work In Progress, this is a BETA release
-
-ZedScripts LSP is a language server protocol implementation in Python for the [scripting format]() of Project Zomboid. Previously a VSCode extension, it is now reimplemented as a standalone LSP.
-
-## Installation
-### Releases
-
-### Python package
-
-<!-- <details open>
-<summary>PyPi</summary>
-
-```bash
-pip install ZedScripts-LSP
-```
-</details> -->
-
-<details>
-<summary>Git</summary>
-
-```bash
-pip install git+https://github.com/PZ-Wiki-Modding/ZedScripts-LSP.git
-```
-</details>
-
-<details>
-<summary>Local</summary>
-
-```bash
-pip install .
-```
-</details>
-
-## Usage
-
-You can either launch the LSP from Python or you can launch the software as is.
-
-### LSP cache directory
-
-The LSP uses a cache directory on your system to store temporary files and logs as well as configuration files. You can find it here: 
-
-<details>
-<summary>Linux</summary>
-
-```bash
-~/.zedscripts
-```
-</details>
-
-<details>
-<summary>Windows</summary>
-
-```bash
-%USERPROFILE%\.zedscripts
-```
-</details>
-
-### Configuration
-
-The LSP uses configurations files which provide information to the LSP about various settings. You have access to a global configuration file
-
-Example configuration:
-```json
-{
-    "dataset": {
-        "latest": true
-    },
-    "libraries": [
-        "/home/simon/.steam/debian-installation/steamapps/common/ProjectZomboid/projectzomboid/media",
-    ]
-}
-```
-
-WIP: proper documentation will come soon
-
-## IDE configuration
-Based on the IDE you use, you may need to install the ZedScripts LSP application for your OS in the [releases](https://github.com/PZ-Wiki-Modding/ZedScripts-LSP/releases) (Linux, Windows).
-
-### Visual Studio Code
-
-Install the [ZedScripts extension](https://marketplace.visualstudio.com/items?itemName=SimKDT.ZedScripts) from the Visual Studio Code marketplace. The extension will handle the downloading and setup of the ZedScripts LSP server for you.
-
-### VIM
-
-Using [yegappan/lsp](https://github.com/yegappan/lsp), setup the ZedScripts LSP server as follows:
-
-```vim
-let lspServers = [
-      \ #{
-      \   name: 'zedscripts',
-      \   filetype: ['text', 'zedscripts'],
-      \   path: 'path/to/ZedScripts',
-      \   args: []
-      \ }
-      \ ]
-
-autocmd User LspSetup call LspAddServer(lspServers)
-```
-
-> [!NOTE]
-> You can see [this video](https://www.youtube.com/watch?v=-5lb_jLQmKc) which explains how to set up VIM, and notably setup a LSP server.
-
-## License
-See [LICENSE](LICENSE) for details.

zedscripts-0.0.3/src/ZedScripts/__about__.py

@@ -1 +0,0 @@
-__version__ = "0.0.1"

zedscripts-0.0.3/src/ZedScripts.egg-info/PKG-INFO

@@ -1,132 +0,0 @@
-Metadata-Version: 2.4
-Name: ZedScripts
-Version: 0.0.3
-Author: SimKDT
-License-Expression: MIT
-Requires-Python: >=3.12.3
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: lsprotocol
-Requires-Dist: pygls
-Requires-Dist: requests-cache
-Requires-Dist: pydantic
-Requires-Dist: deepmerge
-Provides-Extra: build
-Requires-Dist: pyinstaller; extra == "build"
-Provides-Extra: debug
-Requires-Dist: debugpy; extra == "debug"
-Dynamic: license-file
-
-# ZedScripts LSP
-
-[![License](https://img.shields.io/github/license/PZ-Wiki-Modding/ZedScripts?label=License)](LICENSE)
-![Code Size](https://img.shields.io/github/languages/code-size/PZ-Wiki-Modding/ZedScripts?label=Code%20Size)
-[![PyPi Version](https://img.shields.io/pypi/v/ZedScripts)](https://pypi.org/project/ZedScripts/)
-[![PyPi Downloads](https://img.shields.io/pypi/dm/ZedScripts)](https://pypi.org/project/ZedScripts/)
-![PyPI Python Version](https://img.shields.io/pypi/pyversions/ZedScripts)
-
-> [!IMPORTANT]
-> Work In Progress, this is a BETA release
-
-ZedScripts LSP is a language server protocol implementation in Python for the [scripting format]() of Project Zomboid. Previously a VSCode extension, it is now reimplemented as a standalone LSP.
-
-## Installation
-### Releases
-
-### Python package
-
-<!-- <details open>
-<summary>PyPi</summary>
-
-```bash
-pip install ZedScripts-LSP
-```
-</details> -->
-
-<details>
-<summary>Git</summary>
-
-```bash
-pip install git+https://github.com/PZ-Wiki-Modding/ZedScripts-LSP.git
-```
-</details>
-
-<details>
-<summary>Local</summary>
-
-```bash
-pip install .
-```
-</details>
-
-## Usage
-
-You can either launch the LSP from Python or you can launch the software as is.
-
-### LSP cache directory
-
-The LSP uses a cache directory on your system to store temporary files and logs as well as configuration files. You can find it here: 
-
-<details>
-<summary>Linux</summary>
-
-```bash
-~/.zedscripts
-```
-</details>
-
-<details>
-<summary>Windows</summary>
-
-```bash
-%USERPROFILE%\.zedscripts
-```
-</details>
-
-### Configuration
-
-The LSP uses configurations files which provide information to the LSP about various settings. You have access to a global configuration file
-
-Example configuration:
-```json
-{
-    "dataset": {
-        "latest": true
-    },
-    "libraries": [
-        "/home/simon/.steam/debian-installation/steamapps/common/ProjectZomboid/projectzomboid/media",
-    ]
-}
-```
-
-WIP: proper documentation will come soon
-
-## IDE configuration
-Based on the IDE you use, you may need to install the ZedScripts LSP application for your OS in the [releases](https://github.com/PZ-Wiki-Modding/ZedScripts-LSP/releases) (Linux, Windows).
-
-### Visual Studio Code
-
-Install the [ZedScripts extension](https://marketplace.visualstudio.com/items?itemName=SimKDT.ZedScripts) from the Visual Studio Code marketplace. The extension will handle the downloading and setup of the ZedScripts LSP server for you.
-
-### VIM
-
-Using [yegappan/lsp](https://github.com/yegappan/lsp), setup the ZedScripts LSP server as follows:
-
-```vim
-let lspServers = [
-      \ #{
-      \   name: 'zedscripts',
-      \   filetype: ['text', 'zedscripts'],
-      \   path: 'path/to/ZedScripts',
-      \   args: []
-      \ }
-      \ ]
-
-autocmd User LspSetup call LspAddServer(lspServers)
-```
-
-> [!NOTE]
-> You can see [this video](https://www.youtube.com/watch?v=-5lb_jLQmKc) which explains how to set up VIM, and notably setup a LSP server.
-
-## License
-See [LICENSE](LICENSE) for details.