@plurnk/plurnk-mimetypes-grammar-python 0.1.0

package/.grammar-pin

@@ -0,0 +1 @@
+26855eabccb19c6abf499fbc5b8dc7cc9ab8bc64

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PossumTech Laboratories, LLC
+
+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,29 @@
+# @plurnk/plurnk-mimetypes-grammar-python
+
+Pre-built `tree-sitter-python` WASM grammar for the [@plurnk/plurnk-mimetypes](https://github.com/plurnk/plurnk-mimetypes) framework.
+
+## install
+
+```
+npm i @plurnk/plurnk-mimetypes-grammar-python
+```
+
+That's it — the framework automatically picks up the bundled WASM and enables Python (`text/x-python`) support.
+
+## what's in here
+
+- **`python.wasm`** — pre-built from the pinned upstream [tree-sitter-python](https://github.com/tree-sitter/tree-sitter-python) commit (recorded in `.grammar-pin`)
+- `scripts/build-wasm.mjs` — reproducible build from the pinned source
+- `scripts/verify-wasm.mjs` — CI check that the committed WASM matches a fresh rebuild byte-for-byte
+
+There is no runtime code here. The framework's `TreeSitterLanguageHandler` resolves the WASM via `import.meta.resolve("@plurnk/plurnk-mimetypes-grammar-python/python.wasm")` and loads it through `web-tree-sitter`.
+
+## why a separate package
+
+Plurnk's "support every grammar" promise is paid for by per-grammar packages. The framework alone is small; you install only the grammars you actually use. Want Python? Install this. Want everything? `npm i @plurnk/plurnk-mimetypes-grammars-all`.
+
+This model also kills the long-standing peer-dependency conflict between upstream `tree-sitter-{lang}` packages (which all declare different peer ranges of the native `tree-sitter` binding, which we don't need). Our grammar packages declare only `web-tree-sitter` as a peer — no node-gyp, no conflicts, ever.
+
+## license
+
+MIT. The bundled `python.wasm` is built from the upstream tree-sitter-python grammar, which is MIT-licensed; see the pinned commit for that project's attribution.

package/index.js

@@ -0,0 +1,19 @@
+// Pre-built tree-sitter-python WASM grammar for @plurnk/plurnk-mimetypes.
+//
+// This package ships exactly one thing: python.wasm at the package root,
+// reachable via the "./python.wasm" subpath export. The framework's
+// TreeSitterLanguageHandler resolves it at runtime and hands it to
+// web-tree-sitter's Language.load().
+//
+// There is no JS API to call. This file exists to give Node a default entry
+// point for `import "@plurnk/plurnk-mimetypes-grammar-python"`, which the
+// framework uses to detect presence via `import.meta.resolve()`. The export
+// is the wasm-relative path so callers (almost always the framework) can
+// route directly to the binary.
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+
+/** Absolute filesystem path to the bundled python.wasm. */
+export const wasmPath = path.join(here, "python.wasm");

package/package.json

@@ -0,0 +1,42 @@
+{
+    "name": "@plurnk/plurnk-mimetypes-grammar-python",
+    "version": "0.1.0",
+    "description": "Pre-built tree-sitter-python WASM grammar for @plurnk/plurnk-mimetypes. Install this package to enable Python (text/x-python) support in plurnk-service.",
+    "type": "module",
+    "license": "MIT",
+    "publishConfig": {
+        "access": "public"
+    },
+    "engines": {
+        "node": ">=25"
+    },
+    "exports": {
+        ".": {
+            "default": "./index.js"
+        },
+        "./package.json": "./package.json",
+        "./python.wasm": "./python.wasm"
+    },
+    "files": [
+        "python.wasm",
+        ".grammar-pin",
+        "index.js",
+        "README.md"
+    ],
+    "scripts": {
+        "build:wasm": "node scripts/build-wasm.mjs",
+        "verify:wasm": "node scripts/verify-wasm.mjs"
+    },
+    "peerDependencies": {
+        "@plurnk/plurnk-mimetypes": ">=0.11.0",
+        "web-tree-sitter": "^0.25.0"
+    },
+    "peerDependenciesMeta": {
+        "@plurnk/plurnk-mimetypes": {
+            "optional": false
+        },
+        "web-tree-sitter": {
+            "optional": false
+        }
+    }
+}