@plurnk/plurnk-mimetypes-text-html 0.1.0

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,27 @@
+# @plurnk/plurnk-mimetypes-text-html
+
+`text/html` AND `application/xhtml+xml` mimetype handler for the [plurnk](https://github.com/plurnk) ecosystem. Converts HTML to markdown for LLM consumption via [turndown](https://www.npmjs.com/package/turndown).
+
+## install
+
+```
+npm i @plurnk/plurnk-mimetypes-text-html
+```
+
+## what it does
+
+HTML's value for an LLM lives in its rendered content, not in a separate symbol outline. So this handler overrides `preview()` to return the markdown-converted content directly, budgeted via the framework's `fitContent`:
+
+- `preview(content, budget)` — turndown-converts to markdown, fit to budget tokens.
+- `symbols(content)` — empty (the preview *is* the structural signal).
+- `validate(content)` — no-op (HTML is forgiving).
+
+Custom turndown rule (`safe-links`) salvaged from rummy.web: encodes parens in hrefs as `%28`/`%29` so URLs with literal parens don't break markdown's link syntax.
+
+## not in scope
+
+Web-page denoising (Readability-style filtering of nav/ads/comments) belongs in the fetcher layer (`plurnk-schemes-http` when it lands), not in a mimetype handler. This handler does pure HTML→markdown on whatever HTML it receives.
+
+## license
+
+MIT.

package/dist/TextHtml.d.ts

@@ -0,0 +1,5 @@
+import { BaseHandler } from "@plurnk/plurnk-mimetypes";
+export default class TextHtml extends BaseHandler {
+    preview(content: string | Uint8Array, budget: number): Promise<string>;
+}
+//# sourceMappingURL=TextHtml.d.ts.map

package/dist/TextHtml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextHtml.d.ts","sourceRoot":"","sources":["../src/TextHtml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,0BAA0B,CAAC;AAmCnE,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,WAAW;IACvC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAO/E"}

package/dist/TextHtml.js

@@ -0,0 +1,44 @@
+import { BaseHandler, fitContent } from "@plurnk/plurnk-mimetypes";
+import TurndownService from "turndown";
+// text/html + application/xhtml+xml handler. Converts HTML to markdown via
+// turndown for LLM consumption. The structural value of HTML lives in its
+// rendered content, not in a separate symbol outline — so this handler
+// overrides preview() to return the markdown-converted content directly,
+// budgeted via the framework's fitContent. symbols() stays empty (the
+// BaseHandler default).
+//
+// Web-page denoising (Readability-style filtering of nav/ads/comments) is
+// intentionally out of scope here — that's a fetcher concern (plurnk-schemes-http
+// when it lands), not a mimetype concern. This handler does pure HTML→md.
+//
+// Custom turndown rule (`safe-links`) is salvaged from rummy.web/WebFetcher:
+// encode parens in hrefs as %28/%29 so URLs with literal parens don't break
+// markdown's link syntax.
+const turndown = new TurndownService({
+    headingStyle: "atx",
+    codeBlockStyle: "fenced",
+});
+turndown.addRule("safe-links", {
+    filter: "a",
+    replacement(content, node) {
+        const el = node;
+        const href = el.getAttribute("href");
+        if (href === null)
+            return content;
+        const safeHref = href.replace(/\(/g, "%28").replace(/\)/g, "%29");
+        const title = el.getAttribute("title");
+        if (title !== null)
+            return `[${content}](${safeHref} "${title}")`;
+        return `[${content}](${safeHref})`;
+    },
+});
+export default class TextHtml extends BaseHandler {
+    async preview(content, budget) {
+        const html = typeof content === "string"
+            ? content
+            : new TextDecoder("utf-8").decode(content);
+        const markdown = turndown.turndown(html);
+        return fitContent(markdown, budget, this.tokenize);
+    }
+}
+//# sourceMappingURL=TextHtml.js.map

package/dist/TextHtml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextHtml.js","sourceRoot":"","sources":["../src/TextHtml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,eAAe,MAAM,UAAU,CAAC;AAEvC,2EAA2E;AAC3E,0EAA0E;AAC1E,uEAAuE;AACvE,yEAAyE;AACzE,sEAAsE;AACtE,wBAAwB;AACxB,EAAE;AACF,0EAA0E;AAC1E,kFAAkF;AAClF,0EAA0E;AAC1E,EAAE;AACF,6EAA6E;AAC7E,4EAA4E;AAC5E,0BAA0B;AAC1B,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC;IACjC,YAAY,EAAE,KAAK;IACnB,cAAc,EAAE,QAAQ;CAC3B,CAAC,CAAC;AAEH,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE;IAC3B,MAAM,EAAE,GAAG;IACX,WAAW,CAAC,OAAe,EAAE,IAAa;QACtC,MAAM,EAAE,GAAG,IAAqD,CAAC;QACjE,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,OAAO,CAAC;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAClE,MAAM,KAAK,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,IAAI,OAAO,KAAK,QAAQ,KAAK,KAAK,IAAI,CAAC;QAClE,OAAO,IAAI,OAAO,KAAK,QAAQ,GAAG,CAAC;IACvC,CAAC;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,WAAW;IAC7C,KAAK,CAAC,OAAO,CAAC,OAA4B,EAAE,MAAc;QACtD,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ;YACpC,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvD,CAAC;CACJ"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { default as TextHtml } from "./TextHtml.ts";
+export { default } from "./TextHtml.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,QAAQ,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { default as TextHtml } from "./TextHtml.js";
+export { default } from "./TextHtml.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,QAAQ,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+    "name": "@plurnk/plurnk-mimetypes-text-html",
+    "version": "0.1.0",
+    "description": "text/html and application/xhtml+xml mimetype handler for plurnk-service. Converts to markdown via turndown.",
+    "type": "module",
+    "license": "MIT",
+    "publishConfig": {
+        "access": "public"
+    },
+    "engines": {
+        "node": ">=25"
+    },
+    "plurnk": {
+        "kind": "mimetype",
+        "handlers": [
+            { "name": "text/html", "glyph": "🌐", "extensions": [".html", ".htm"] },
+            { "name": "application/xhtml+xml", "glyph": "🌐", "extensions": [".xhtml"] }
+        ]
+    },
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        },
+        "./package.json": "./package.json"
+    },
+    "files": [
+        "dist/**/*",
+        "README.md"
+    ],
+    "scripts": {
+        "test:lint": "tsc --noEmit",
+        "test:unit": "node --test src/**/*.test.ts",
+        "test": "npm run test:lint && npm run test:unit",
+        "build:dist": "tsc -p tsconfig.build.json",
+        "build": "npm run build:dist",
+        "prepare": "npm run build"
+    },
+    "dependencies": {
+        "@plurnk/plurnk-mimetypes": "^0.3.0",
+        "turndown": "^7.2.0",
+        "@types/turndown": "^5.0.5"
+    },
+    "devDependencies": {
+        "@types/node": "^25.8.0",
+        "typescript": "^6.0.3"
+    }
+}