@plurnk/plurnk-mimetypes-text-dockerfile 0.1.1

package/.dockerfile-grammar-pin

@@ -0,0 +1 @@
+971acdd908568b4531b0ba28a445bf0bb720aba5

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,33 @@
+# @plurnk/plurnk-mimetypes-text-dockerfile
+
+`text/x-dockerfile` mimetype handler for the [plurnk](https://github.com/plurnk) ecosystem. Tier 2 — uses the [camdencheek/tree-sitter-dockerfile](https://github.com/camdencheek/tree-sitter-dockerfile) grammar built to WASM and shipped pre-built in this package (52 KB).
+
+## install
+
+```
+npm i @plurnk/plurnk-mimetypes-text-dockerfile
+```
+
+No build tools required at install time. The `dockerfile.wasm` artifact is included.
+
+## what it does
+
+Three channels per the framework's #10 contract:
+
+- **symbols** (`extractRaw` / `preview`) — multi-stage builds surface each `FROM ... AS <name>` stage as a `module`; ARG declarations and ENV/LABEL pair names surface as `constant` symbols. Imperative instructions (RUN, COPY, CMD, ENTRYPOINT, WORKDIR, EXPOSE, USER, etc.) don't produce symbols — they have no name to navigate to. The model can still find them via regex or deep-json queries.
+- **deep-json** (`deepJson`) — inherited from `TreeSitterExtractor`: full named-children walk of the Dockerfile parse tree. jsonpath queries like `$..children[?(@.type=='run_instruction')]` find every RUN, `$..children[?(@.type=='copy_instruction')]` finds every COPY, etc.
+- **deep-xml** — framework-projected from deep-json.
+
+Registers as `text/x-dockerfile` with extensions `.dockerfile` and exact filenames `Dockerfile` and `Containerfile`.
+
+## coverage
+
+Validated against real-world Dockerfiles including BuildKit syntax. The grammar handles standard and multi-stage builds cleanly; advanced BuildKit features (`--mount=type=secret`, `COPY --parents` from the dockerfile/1.7-labs syntax) may produce localized parse warnings but symbol extraction continues to work.
+
+## the grammar pin
+
+`.dockerfile-grammar-pin` records the upstream commit SHA `dockerfile.wasm` is built from. `scripts/build-wasm.mjs` builds it; `scripts/verify-wasm.mjs` rebuilds and byte-compares.
+
+## license
+
+MIT.

package/dist/TextDockerfile.d.ts

@@ -0,0 +1,7 @@
+import { TreeSitterExtractor } from "@plurnk/plurnk-mimetypes";
+import type { HandlerContent, MimeSymbol, TreeSitterParser, TreeSitterTree } from "@plurnk/plurnk-mimetypes";
+export default class TextDockerfile extends TreeSitterExtractor {
+    protected loadParser(): Promise<TreeSitterParser>;
+    protected extractFromTree(tree: TreeSitterTree, _content: HandlerContent): MimeSymbol[];
+}
+//# sourceMappingURL=TextDockerfile.d.ts.map

package/dist/TextDockerfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextDockerfile.d.ts","sourceRoot":"","sources":["../src/TextDockerfile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EACR,cAAc,EACd,UAAU,EAEV,gBAAgB,EAChB,cAAc,EACjB,MAAM,0BAA0B,CAAC;AAclC,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,mBAAmB;cAC3C,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAkBvD,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,GAAG,UAAU,EAAE;CAG1F"}

package/dist/TextDockerfile.js

@@ -0,0 +1,36 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { TreeSitterExtractor } from "@plurnk/plurnk-mimetypes";
+import { extract } from "./dockerfile.js";
+// text/x-dockerfile handler. Tier 2 — tree-sitter-dockerfile grammar built to
+// WASM at package publish time and shipped alongside this code. The .wasm file
+// lives at the package root; we resolve it via import.meta.url so the path is
+// stable across consumers.
+//
+// Why Tier 2: camdencheek/tree-sitter-dockerfile's npm package doesn't ship
+// WASM. We build it ourselves (see scripts/build-wasm.mjs +
+// scripts/verify-wasm.mjs) so consumers get pure WASM at install time.
+//
+// Also registers as `Dockerfile` and `Containerfile` filename matches (no
+// extension; the framework's discover() routes by exact filename for these).
+export default class TextDockerfile extends TreeSitterExtractor {
+    async loadParser() {
+        const ts = await import(__rewriteRelativeImportExtension("web-tree-sitter"));
+        await ts.Parser.init();
+        const wasmUrl = new URL("../dockerfile.wasm", import.meta.url);
+        const lang = await ts.Language.load(wasmUrl.pathname);
+        const parser = new ts.Parser();
+        parser.setLanguage(lang);
+        return parser;
+    }
+    extractFromTree(tree, _content) {
+        return extract(tree.rootNode);
+    }
+}
+//# sourceMappingURL=TextDockerfile.js.map

package/dist/TextDockerfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextDockerfile.js","sourceRoot":"","sources":["../src/TextDockerfile.ts"],"names":[],"mappings":";;;;;;;;AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAQ/D,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C,8EAA8E;AAC9E,+EAA+E;AAC/E,8EAA8E;AAC9E,2BAA2B;AAC3B,EAAE;AACF,4EAA4E;AAC5E,4DAA4D;AAC5D,uEAAuE;AACvE,EAAE;AACF,0EAA0E;AAC1E,6EAA6E;AAC7E,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,mBAAmB;IACjD,KAAK,CAAC,UAAU;QACtB,MAAM,EAAE,GAAG,MAAM,MAAM,kCAAC,iBAA2B,EAQlD,CAAC;QACF,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/D,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC;QAC/B,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACzB,OAAO,MAAqC,CAAC;IACjD,CAAC;IAES,eAAe,CAAC,IAAoB,EAAE,QAAwB;QACpE,OAAO,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;CACJ"}

package/dist/dockerfile.d.ts

@@ -0,0 +1,3 @@
+import type { MimeSymbol, TreeSitterNode } from "@plurnk/plurnk-mimetypes";
+export declare function extract(root: TreeSitterNode): MimeSymbol[];
+//# sourceMappingURL=dockerfile.d.ts.map

package/dist/dockerfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dockerfile.d.ts","sourceRoot":"","sources":["../src/dockerfile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAc3E,wBAAgB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,EAAE,CAqE1D"}

package/dist/dockerfile.js

@@ -0,0 +1,96 @@
+// Dockerfile SPEC §3 mapping for tree-sitter-dockerfile.
+//
+//   from_instruction with `as: image_alias` → module, named by the alias
+//   from_instruction without alias          → module, "stage" + index
+//   arg_instruction → constant (named by arg name)
+//   env_instruction → constant per env_pair (named by env var)
+//   label_instruction → constant per label_pair (named by label key)
+//
+// Everything else (RUN, COPY, CMD, ENTRYPOINT, WORKDIR, EXPOSE, USER,
+// VOLUME, HEALTHCHECK, SHELL, STOPSIGNAL) is not surfaced as a symbol —
+// they're imperative steps with no name to navigate to. The model can
+// still find them via regex or the deep-json channel.
+export function extract(root) {
+    const out = [];
+    let stageIndex = 0;
+    for (let i = 0; i < root.namedChildCount; i += 1) {
+        const child = root.namedChild(i);
+        if (!child)
+            continue;
+        switch (child.type) {
+            case "from_instruction": {
+                const alias = child.childForFieldName("as");
+                const name = alias ? alias.text : `stage_${stageIndex}`;
+                stageIndex += 1;
+                out.push({
+                    name,
+                    kind: "module",
+                    line: child.startPosition.row + 1,
+                    endLine: child.endPosition.row + 1,
+                });
+                break;
+            }
+            case "arg_instruction": {
+                const nameNode = child.childForFieldName("name");
+                if (nameNode) {
+                    out.push({
+                        name: nameNode.text,
+                        kind: "constant",
+                        line: child.startPosition.row + 1,
+                        endLine: child.endPosition.row + 1,
+                    });
+                }
+                break;
+            }
+            case "env_instruction": {
+                for (let j = 0; j < child.namedChildCount; j += 1) {
+                    const pair = child.namedChild(j);
+                    if (!pair || pair.type !== "env_pair")
+                        continue;
+                    const nameNode = pair.childForFieldName("name");
+                    if (nameNode) {
+                        out.push({
+                            name: nameNode.text,
+                            kind: "constant",
+                            line: pair.startPosition.row + 1,
+                            endLine: pair.endPosition.row + 1,
+                        });
+                    }
+                }
+                break;
+            }
+            case "label_instruction": {
+                for (let j = 0; j < child.namedChildCount; j += 1) {
+                    const pair = child.namedChild(j);
+                    if (!pair || pair.type !== "label_pair")
+                        continue;
+                    const keyNode = pair.childForFieldName("key");
+                    if (keyNode) {
+                        out.push({
+                            name: stripQuotes(keyNode.text),
+                            kind: "constant",
+                            line: pair.startPosition.row + 1,
+                            endLine: pair.endPosition.row + 1,
+                        });
+                    }
+                }
+                break;
+            }
+            default:
+                // imperative instructions (RUN/COPY/CMD/etc.) — no symbol
+                break;
+        }
+    }
+    return out;
+}
+function stripQuotes(text) {
+    if (text.length >= 2) {
+        const first = text.charCodeAt(0);
+        const last = text.charCodeAt(text.length - 1);
+        if ((first === 0x22 && last === 0x22) || (first === 0x27 && last === 0x27)) {
+            return text.slice(1, -1);
+        }
+    }
+    return text;
+}
+//# sourceMappingURL=dockerfile.js.map

package/dist/dockerfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dockerfile.js","sourceRoot":"","sources":["../src/dockerfile.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { default as TextDockerfile } from "./TextDockerfile.ts";
+export { default } from "./TextDockerfile.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { default as TextDockerfile } from "./TextDockerfile.js";
+export { default } from "./TextDockerfile.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC"}

package/package.json

@@ -0,0 +1,63 @@
+{
+    "name": "@plurnk/plurnk-mimetypes-text-dockerfile",
+    "version": "0.1.1",
+    "description": "text/x-dockerfile mimetype handler for plurnk-service. Tier 2: tree-sitter-dockerfile grammar built to WASM and shipped pre-built in this package.",
+    "type": "module",
+    "license": "MIT",
+    "publishConfig": {
+        "access": "public"
+    },
+    "engines": {
+        "node": ">=25"
+    },
+    "plurnk": {
+        "kind": "mimetype",
+        "handlers": [
+            {
+                "name": "text/x-dockerfile",
+                "glyph": "🐳",
+                "extensions": [
+                    ".dockerfile",
+                    "Dockerfile",
+                    "Containerfile"
+                ]
+            }
+        ]
+    },
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        },
+        "./package.json": "./package.json",
+        "./dockerfile.wasm": "./dockerfile.wasm"
+    },
+    "files": [
+        "dist/**/*",
+        "dockerfile.wasm",
+        ".dockerfile-grammar-pin",
+        "README.md"
+    ],
+    "scripts": {
+        "build:wasm": "node scripts/build-wasm.mjs",
+        "build:dist": "tsc -p tsconfig.build.json",
+        "build": "npm run build:dist",
+        "test:lint": "tsc --noEmit",
+        "test:unit": "node --test src/**/*.test.ts",
+        "test": "npm run test:lint && npm run test:unit",
+        "prepare": "npm run build",
+        "verify:wasm": "node scripts/verify-wasm.mjs"
+    },
+    "dependencies": {
+        "web-tree-sitter": "^0.25.10"
+    },
+    "devDependencies": {
+        "@types/node": "^25.9.1",
+        "tree-sitter-cli": "^0.26.9",
+        "typescript": "^6.0.3",
+        "@plurnk/plurnk-mimetypes": "^0.14.1"
+    },
+    "peerDependencies": {
+        "@plurnk/plurnk-mimetypes": "^0.14.1"
+    }
+}