@kubohiroya/turbowarp-document-data 0.0.0-stage → 0.1.1

package/dist/extension-manifest.json

@@ -0,0 +1,117 @@
+{
+  "formatVersion": 1,
+  "id": "kubohiroyadocumentdata",
+  "blocks": [
+    {
+      "opcode": "deleteDocument",
+      "blockType": "COMMAND",
+      "arguments": [
+        {
+          "id": "NAME",
+          "type": "STRING"
+        }
+      ]
+    },
+    {
+      "opcode": "documentKind",
+      "blockType": "REPORTER",
+      "arguments": [
+        {
+          "id": "NAME",
+          "type": "STRING"
+        }
+      ]
+    },
+    {
+      "opcode": "getDocumentText",
+      "blockType": "REPORTER",
+      "arguments": [
+        {
+          "id": "LOCATION",
+          "type": "STRING"
+        },
+        {
+          "id": "NAME",
+          "type": "STRING"
+        }
+      ]
+    },
+    {
+      "opcode": "hasDocument",
+      "blockType": "BOOLEAN",
+      "arguments": [
+        {
+          "id": "NAME",
+          "type": "STRING"
+        }
+      ]
+    },
+    {
+      "opcode": "parseHtml",
+      "blockType": "COMMAND",
+      "arguments": [
+        {
+          "id": "NAME",
+          "type": "STRING"
+        },
+        {
+          "id": "TEXT",
+          "type": "STRING"
+        }
+      ]
+    },
+    {
+      "opcode": "parseMarkdown",
+      "blockType": "COMMAND",
+      "arguments": [
+        {
+          "id": "NAME",
+          "type": "STRING"
+        },
+        {
+          "id": "TEXT",
+          "type": "STRING"
+        }
+      ]
+    },
+    {
+      "opcode": "replaceDocumentText",
+      "blockType": "COMMAND",
+      "arguments": [
+        {
+          "id": "LOCATION",
+          "type": "STRING"
+        },
+        {
+          "id": "NAME",
+          "type": "STRING"
+        },
+        {
+          "id": "TEXT",
+          "type": "STRING"
+        }
+      ]
+    },
+    {
+      "opcode": "serializeDocument",
+      "blockType": "REPORTER",
+      "arguments": [
+        {
+          "id": "FORMAT",
+          "type": "STRING",
+          "menu": "documentFormat"
+        },
+        {
+          "id": "NAME",
+          "type": "STRING"
+        }
+      ]
+    }
+  ],
+  "menus": [
+    {
+      "id": "documentFormat",
+      "acceptReporters": true
+    }
+  ]
+}

package/docs/architecture.ja.md

@@ -0,0 +1,7 @@
+# アーキテクチャ
+
+名前付きbindingは`WeakMap<Target, Map<Name, Binding>>`に保持し、更新時はtree全体を検証してからimmutable replacementします。HTMLはparse5から正規化したtyped tree、Markdownは位置情報を除いたmdastとして保持します。
+
+block APIはdocumentを操作し、Named Data providerは同じstoreをread-onlyで参照してHTTP向けのreplayable UTF-8 bodyを生成します。canonical `@kubohiroya/turbowarp-named-data` composition契約を実装し、persistent lifetimeでruntime共通registryへ登録します。project stopではprovider登録を維持し、bindingとsession handleだけをclearします。
+
+HTMLとMarkdownの変換はlossyになり得るため暗黙に実行しません。また、parse済みHTMLをsafeまたはsanitizedとは表示しません。

package/docs/architecture.md

@@ -0,0 +1,7 @@
+# Architecture
+
+The extension stores immutable replacement bindings in `WeakMap<Target, Map<Name, Binding>>`. HTML input becomes a small typed tree normalized from parse5; Markdown input becomes a position-free mdast tree. Revisions increase whenever a binding is replaced.
+
+The block API operates on documents. The Named Data provider is a read-only adapter over the same binding store and produces replayable UTF-8 bytes for HTTP consumers. It implements the canonical `@kubohiroya/turbowarp-named-data` composition contract and registers in the runtime registry with persistent lifetime. Project stop clears bindings and session handles without unregistering the provider.
+
+Cross-format serialization is rejected because HTML and Markdown conversion may be lossy. This package never describes parsed HTML as safe or sanitized.

package/docs/fixed-input-editors.ja.md

@@ -0,0 +1,17 @@
+# 固定入力の編集
+
+S3-4のローカル実装です。対応GUIの固定入力機能は既定OFFです。旧GUI・API無し・固定入力機能OFFではブロックの従来動作を保ちます。`getInfo()` に存在する対象opcodeだけ登録し、再取得・APIの置換・拡張の`dispose()`・runtimeの破棄に対応します。既存SOURCEエディターとopcodeは分離しています。
+
+|ブロックopcode|引数|UI|
+|---|---|---|
+|`serializeDocument`|`FORMAT`|既定値からの選択：`html`, `markdown`|
+
+数値の新規入力は、空白を除いた完全な有限JSON数値トークンを受け付け、指数表記・負のゼロ・表記を保持します。空文字、16進表記、先頭の`+`、先頭ゼロや未完成トークンは新規保存しません。既存値は開いただけで書き換えません。既存の有限数値別表記は参照用に投影し、未編集の生値を保ちます。未知の旧enum値も無操作では保存し直しません。
+
+Document Data MVP の既定OFFは変更しません。MVPが無効で `getInfo()` に対象opcodeが無い場合、登録しません。
+
+reporter接続は読取専用で、実行・置換しません。新しい選択や数値を保存するときだけ純粋codecとSchemaで検証します。検証失敗時は全変更を拒否し、ブロックや接続を部分的に書き換えません。
+
+正本は本ownerの `schemas/block-editor-fixed-inputs.schema.json`、TSモジュールは選択・参照用、`dist`は生成物です。外部候補取得や実行時Schema生成は行いません。
+
+切戻しはGUIの固定入力機能OFFで行えます。既存のプロジェクト形式・opcode・メニュー・defaultValue・実行時の処理は維持します。

package/docs/index.html

@@ -0,0 +1,54 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width,initial-scale=1">
+  <title>Document Data documentation</title>
+  <style>
+    body{font-family:system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;max-width:900px;margin:0 auto;padding:2rem;line-height:1.6;color:#222}
+    code{background:#f3f3f3;padding:.1em .3em;border-radius:.25em}
+    pre{background:#f6f8fa;padding:1rem;overflow:auto;border-radius:.5rem}
+  </style>
+<style id="block-reference-style">
+#extension-block-reference{max-width:72rem;margin:2rem auto;padding:1rem;line-height:1.6;overflow-wrap:anywhere}
+#extension-block-reference .block-reference-entry{display:block;scroll-margin-top:6rem;margin:2rem 0;padding:1rem;border:1px solid currentColor;border-radius:.5rem}
+#extension-block-reference .block-reference-table{overflow-x:auto}
+#extension-block-reference table{border-collapse:collapse;width:100%}
+#extension-block-reference th,#extension-block-reference td{text-align:left;vertical-align:top;border:1px solid currentColor;padding:.5rem}
+#extension-block-reference code{white-space:pre-wrap}
+#extension-block-reference a:focus-visible{outline:3px solid currentColor;outline-offset:3px}
+</style>
+</head>
+<body><p lang="en" class="complete-block-reference-link"><a href="#extension-block-reference">Complete block reference (8 blocks)</a></p>
+  <h1>Document Data</h1>
+  <p>Parse HTML and Markdown into target-local named document trees, edit text, and expose deterministic UTF-8 HTTP response bodies.</p>
+
+  <h2>Blocks</h2>
+  <p>Use <code>parse HTML ... as document ...</code> or <code>parse Markdown ... as document ...</code>, then inspect, replace, or serialize its text. Tree locations use <code>$</code> or numeric paths such as <code>$[0][1]</code>. HTML also supports one simple tag, <code>#id</code>, or <code>.class</code> selector.</p>
+
+  <h2>Safety boundary</h2>
+  <p>Parsing does not sanitize HTML, execute scripts, or mount a DOM. HTML/Markdown conversion is rejected because it may be lossy. The extension is unsandboxed and its <code>DOCUMENT_DATA_MVP</code> flag defaults to off.</p>
+
+  <h2>Development</h2>
+  <p>Run <code>pnpm run check</code>. See the repository README and architecture documents for limits and the Named Data provider contract.</p>
+<!-- BEGIN COMPLETE BLOCK REFERENCE -->
+<section lang="en" id="extension-block-reference" aria-labelledby="block-reference-title">
+<h2 id="block-reference-title">Document Data: complete block reference</h2>
+<p>All 8 blocks are documented below, including compatibility blocks and blocks available through optional features. Select a block to read its behavior, arguments, default values, and menu choices. Each block has a permanent link.</p>
+<nav aria-label="Block reference"><ul><li><a href="#block-parseHtml"><code>parse HTML [TEXT] as document [NAME]</code></a></li>
+<li><a href="#block-parseMarkdown"><code>parse Markdown [TEXT] as document [NAME]</code></a></li>
+<li><a href="#block-hasDocument"><code>document [NAME] exists?</code></a></li>
+<li><a href="#block-deleteDocument"><code>delete document [NAME]</code></a></li>
+<li><a href="#block-documentKind"><code>kind of document [NAME]</code></a></li>
+<li><a href="#block-getDocumentText"><code>text in document [NAME] at [LOCATION]</code></a></li>
+<li><a href="#block-replaceDocumentText"><code>replace text in document [NAME] at [LOCATION] with [TEXT]</code></a></li>
+<li><a href="#block-serializeDocument"><code>serialize document [NAME] as [FORMAT]</code></a></li>
+</ul></nav>
+<article id="block-parseHtml" class="block-reference-entry"><h3><code>parse HTML [TEXT] as document [NAME]</code></h3><p>Parse HTML into a target-local named document tree. This does not sanitize HTML.</p><p>Block type: COMMAND. Opcode: <code>parseHtml</code>. <a href="#block-parseHtml">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>TEXT</code></th><td>STRING</td><td><code>&lt;p&gt;Hello&lt;/p&gt;</code></td><td></td></tr><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>page</code></td><td></td></tr></tbody></table></div></article><article id="block-parseMarkdown" class="block-reference-entry"><h3><code>parse Markdown [TEXT] as document [NAME]</code></h3><p>Parse Markdown into a target-local named syntax tree.</p><p>Block type: COMMAND. Opcode: <code>parseMarkdown</code>. <a href="#block-parseMarkdown">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>TEXT</code></th><td>STRING</td><td><code># Hello</code></td><td></td></tr><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>page</code></td><td></td></tr></tbody></table></div></article><article id="block-hasDocument" class="block-reference-entry"><h3><code>document [NAME] exists?</code></h3><p>Report whether the current target has the named document.</p><p>Block type: BOOLEAN. Opcode: <code>hasDocument</code>. <a href="#block-hasDocument">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>page</code></td><td></td></tr></tbody></table></div></article><article id="block-deleteDocument" class="block-reference-entry"><h3><code>delete document [NAME]</code></h3><p>Delete the named document from the current target.</p><p>Block type: COMMAND. Opcode: <code>deleteDocument</code>. <a href="#block-deleteDocument">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>page</code></td><td></td></tr></tbody></table></div></article><article id="block-documentKind" class="block-reference-entry"><h3><code>kind of document [NAME]</code></h3><p>Return html or markdown.</p><p>Block type: REPORTER. Opcode: <code>documentKind</code>. <a href="#block-documentKind">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>page</code></td><td></td></tr></tbody></table></div></article><article id="block-getDocumentText" class="block-reference-entry"><h3><code>text in document [NAME] at [LOCATION]</code></h3><p>Get text at the root, a numeric tree path, or a simple HTML selector.</p><p>Block type: REPORTER. Opcode: <code>getDocumentText</code>. <a href="#block-getDocumentText">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>page</code></td><td></td></tr><tr><th scope="row"><code>LOCATION</code></th><td>STRING</td><td><code>$</code></td><td></td></tr></tbody></table></div></article><article id="block-replaceDocumentText" class="block-reference-entry"><h3><code>replace text in document [NAME] at [LOCATION] with [TEXT]</code></h3><p>Immutably replace text at the selected node.</p><p>Block type: COMMAND. Opcode: <code>replaceDocumentText</code>. <a href="#block-replaceDocumentText">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>page</code></td><td></td></tr><tr><th scope="row"><code>LOCATION</code></th><td>STRING</td><td><code>$</code></td><td></td></tr><tr><th scope="row"><code>TEXT</code></th><td>STRING</td><td><code>Hello</code></td><td></td></tr></tbody></table></div></article><article id="block-serializeDocument" class="block-reference-entry"><h3><code>serialize document [NAME] as [FORMAT]</code></h3><p>Deterministically serialize a document in its native format. Cross-format conversion is rejected as lossy.</p><p>Block type: REPORTER. Opcode: <code>serializeDocument</code>. <a href="#block-serializeDocument">Permanent link</a></p><div class="block-reference-table"><table><thead><tr><th>Argument</th><th>Type</th><th>Default value</th><th>Menu choices</th></tr></thead><tbody><tr><th scope="row"><code>NAME</code></th><td>STRING</td><td><code>page</code></td><td></td></tr><tr><th scope="row"><code>FORMAT</code></th><td>STRING</td><td><code>html</code></td><td><ul><li><code>html</code></li><li><code>markdown</code></li></ul></td></tr></tbody></table></div><p lang="ja" class="fixed-input-help"><a href="#fixed-input-editors">このブロックの固定入力編集と互換性</a></p>
+</article>
+<p><a href="https://github.com/kubohiroya/turbowarp-document-data/blob/main/README.md">Repository guide and examples</a></p>
+</section>
+<!-- END COMPLETE BLOCK REFERENCE -->
+<section lang="ja" id="fixed-input-editors"><h2>固定入力の編集</h2><p>対応GUIの固定入力機能は既定OFFです。既存値は開いただけでは変更せず、reporter接続は評価・置換しません。新しい選択と有限JSON数値入力のみを検証して保存し、既存の補正・丸め処理を維持します。機能OFFで従来の編集へ戻せます。</p><p><a href="fixed-input-editors.ja.md">対象入力・Schemaの正本・互換性・切戻し</a></p></section>
+</body>
+</html>

package/package.json

@@ -1,6 +1,87 @@
 {
   "name": "@kubohiroya/turbowarp-document-data",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Named HTML and Markdown document trees for TurboWarp and HTTP response bodies.",
+  "author": "Hiroya Kubo <hiroya@cuc.ac.jp>",
+  "license": "MPL-2.0",
+  "homepage": "https://github.com/kubohiroya/turbowarp-document-data#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kubohiroya/turbowarp-document-data.git"
+  },
+  "bugs": {
+    "url": "https://github.com/kubohiroya/turbowarp-document-data/issues"
+  },
+  "keywords": [
+    "turbowarp",
+    "scratch",
+    "extension",
+    "document",
+    "html",
+    "markdown",
+    "vite",
+    "typescript"
+  ],
+  "type": "module",
+  "files": [
+    "dist/",
+    "docs/",
+    "src/",
+    "README.md",
+    "README.ja.md",
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md",
+    "schemas/"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "peerDependencies": {
+    "@kubohiroya/turbowarp-named-data": "0.3.1"
+  },
+  "packageManager": "pnpm@11.11.0",
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "scripts": {
+    "dev": "vite build --watch",
+    "typecheck": "tsc --noEmit",
+    "build": "vite build",
+    "lint": "eslint src tests scripts vite.config.ts eslint.config.ts",
+    "test": "vitest run",
+    "docs": "node scripts/generate-readme.ts",
+    "docs:check": "node scripts/check-docs.ts",
+    "template:readme": "node scripts/apply-readme-template.ts",
+    "repo:check": "node scripts/check-repo.ts",
+    "pack:check": "npm pack --dry-run --ignore-scripts",
+    "check": "pnpm run typecheck && pnpm run lint && pnpm run test && pnpm run docs:check && pnpm run check:dist && pnpm run repo:check && pnpm run pack:check",
+    "check:dist": "pnpm run build && node scripts/check-dist.ts"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.5",
+    "@kubohiroya/turbowarp-extension-manifest": "0.3.2",
+    "@kubohiroya/turbowarp-named-data": "0.3.1",
+    "@kubohiroya/vite-plugin-turbowarp-extension": "0.6.1",
+    "@types/mdast": "^4.0.4",
+    "@types/node": "^24.13.3",
+    "eslint": "^9.39.5",
+    "jiti": "^2.7.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.66.0",
+    "vite": "^8.2.2",
+    "vitest": "^5.0.0",
+    "@kubohiroya/turbowarp-extension-data-editor": "0.2.1"
+  },
+  "dependencies": {
+    "mdast-util-from-markdown": "^2.0.3",
+    "mdast-util-to-markdown": "^2.1.2",
+    "parse5": "^8.0.1"
+  },
+  "gitHead": "d1b34cb87df3ee0630f5fea7ff7fbe8f7f3f7ae3",
+  "x-turbowarp-source": {
+    "revision": "d1b34cb87df3ee0630f5fea7ff7fbe8f7f3f7ae3",
+    "revisionRole": "base-commit",
+    "sourceState": "local-release-overlay"
+  }
+}

package/schemas/block-editor-fixed-inputs.schema.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://kubohiroya.github.io/turbowarp-document-data/schemas/block-editor-fixed-inputs.schema.json",
+  "$defs": {
+    "serializeDocument": {
+      "type": "object",
+      "properties": {
+        "FORMAT": {
+          "type": "string",
+          "enum": [
+            "html",
+            "markdown"
+          ]
+        }
+      },
+      "required": [
+        "FORMAT"
+      ],
+      "additionalProperties": true
+    }
+  }
+}

package/src/block-definitions.json

@@ -0,0 +1,14 @@
+{
+  "extensionName": "Document Data",
+  "menus": {"documentFormat": {"acceptReporters": true, "items": ["html", "markdown"]}},
+  "blocks": [
+    {"opcode":"parseHtml","blockType":"COMMAND","text":"parse HTML [TEXT] as document [NAME]","description":"Parse HTML into a target-local named document tree. This does not sanitize HTML.","arguments":{"TEXT":{"type":"STRING","defaultValue":"<p>Hello</p>"},"NAME":{"type":"STRING","defaultValue":"page"}}},
+    {"opcode":"parseMarkdown","blockType":"COMMAND","text":"parse Markdown [TEXT] as document [NAME]","description":"Parse Markdown into a target-local named syntax tree.","arguments":{"TEXT":{"type":"STRING","defaultValue":"# Hello"},"NAME":{"type":"STRING","defaultValue":"page"}}},
+    {"opcode":"hasDocument","blockType":"BOOLEAN","text":"document [NAME] exists?","description":"Report whether the current target has the named document.","arguments":{"NAME":{"type":"STRING","defaultValue":"page"}}},
+    {"opcode":"deleteDocument","blockType":"COMMAND","text":"delete document [NAME]","description":"Delete the named document from the current target.","arguments":{"NAME":{"type":"STRING","defaultValue":"page"}}},
+    {"opcode":"documentKind","blockType":"REPORTER","text":"kind of document [NAME]","description":"Return html or markdown.","arguments":{"NAME":{"type":"STRING","defaultValue":"page"}}},
+    {"opcode":"getDocumentText","blockType":"REPORTER","text":"text in document [NAME] at [LOCATION]","description":"Get text at the root, a numeric tree path, or a simple HTML selector.","arguments":{"NAME":{"type":"STRING","defaultValue":"page"},"LOCATION":{"type":"STRING","defaultValue":"$"}}},
+    {"opcode":"replaceDocumentText","blockType":"COMMAND","text":"replace text in document [NAME] at [LOCATION] with [TEXT]","description":"Immutably replace text at the selected node.","arguments":{"NAME":{"type":"STRING","defaultValue":"page"},"LOCATION":{"type":"STRING","defaultValue":"$"},"TEXT":{"type":"STRING","defaultValue":"Hello"}}},
+    {"opcode":"serializeDocument","blockType":"REPORTER","text":"serialize document [NAME] as [FORMAT]","description":"Deterministically serialize a document in its native format. Cross-format conversion is rejected as lossy.","arguments":{"NAME":{"type":"STRING","defaultValue":"page"},"FORMAT":{"type":"STRING","defaultValue":"html","menu":"documentFormat"}}}
+  ]
+}

package/src/config.ts

@@ -0,0 +1,21 @@
+export const DOCUMENT_DATA_MVP_DEFAULT = false;
+
+export function isDocumentDataMvpEnabled(
+  source: {DOCUMENT_DATA_MVP?: unknown} = globalThis as {DOCUMENT_DATA_MVP?: unknown}
+): boolean {
+  const value = source.DOCUMENT_DATA_MVP;
+  return value === undefined ? DOCUMENT_DATA_MVP_DEFAULT : value === true || value === 'true';
+}
+
+export const extensionConfig = {
+  id: 'kubohiroyadocumentdata',
+  slug: 'document-data',
+  name: 'Document Data',
+  description: 'Named HTML and Markdown document trees for TurboWarp and HTTP bodies.',
+  author: 'Hiroya Kubo',
+  license: 'MPL-2.0',
+  unsandboxed: true,
+  docsURI: 'https://kubohiroya.github.io/turbowarp-document-data/',
+  blockIconURI:
+    'data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCA0OCA0OCI+PHJlY3QgeD0iNCIgeT0iOCIgd2lkdGg9IjE4IiBoZWlnaHQ9IjE0IiByeD0iMyIgZmlsbD0iIzRDOTdGRiIvPjxyZWN0IHg9IjI2IiB5PSI4IiB3aWR0aD0iMTgiIGhlaWdodD0iMTQiIHJ4PSIzIiBmaWxsPSIjNTlDMDU5Ii8+PHJlY3QgeD0iMTUiIHk9IjI2IiB3aWR0aD0iMTgiIGhlaWdodD0iMTQiIHJ4PSIzIiBmaWxsPSIjRkZBQjE5Ii8+PC9zdmc+'
+} as const;

package/src/document-provider.ts

@@ -0,0 +1,92 @@
+import {DOCUMENT_MAX_OUTPUT_BYTES, serializeDocument, type DocumentTree} from './document.js';
+import {
+  NamedDataError,
+  type NamedDataBody,
+  type NamedDataMetadata,
+  type NamedDataProvider,
+  type NamedDataReference,
+  type NamedDataReleaseReason,
+  type NamedDataRepresentation,
+  type NamedDataResolveContext
+} from '@kubohiroya/turbowarp-named-data/composition';
+
+export const DOCUMENT_DATA_NAMESPACE = 'document';
+export interface DocumentBinding {tree: DocumentTree; revision: number}
+export interface DocumentBindingStore {get(target: object, name: string): DocumentBinding | undefined}
+
+export class DocumentNamedDataProvider implements NamedDataProvider {
+  public readonly namespace = DOCUMENT_DATA_NAMESPACE;
+  public readonly kind = 'document' as const;
+  private readonly handles = new Set<symbol>();
+  private released = false;
+
+  public constructor(private readonly store: DocumentBindingStore) {}
+
+  public canResolve(
+    reference: NamedDataReference,
+    representation: NamedDataRepresentation
+  ): boolean {
+    return (
+      !this.released &&
+      reference.namespace === this.namespace &&
+      reference.name.trim().length > 0 &&
+      reference.kind === this.kind &&
+      reference.scope === 'target' &&
+      (representation === 'html' || representation === 'markdown')
+    );
+  }
+
+  public stat(reference: NamedDataReference, representation: NamedDataRepresentation, context: NamedDataResolveContext): NamedDataMetadata {
+    const result = this.resolve(reference, representation, context);
+    return this.metadata(reference, representation, result.bytes.byteLength, result.binding.revision);
+  }
+
+  public openBody(reference: NamedDataReference, representation: NamedDataRepresentation, context: NamedDataResolveContext): NamedDataBody {
+    const result = this.resolve(reference, representation, context);
+    const handle = Symbol('document-body');
+    this.handles.add(handle);
+    let released = false;
+    return {
+      ...this.metadata(reference, representation, result.bytes.byteLength, result.binding.revision),
+      body: result.bytes,
+      release: (reason?: NamedDataReleaseReason) => {
+        void reason;
+        if (!released) {
+          released = true;
+          this.handles.delete(handle);
+        }
+      }
+    };
+  }
+
+  public clearSession(): void {this.handles.clear();}
+  public release(reason?: NamedDataReleaseReason): void {
+    void reason;
+    this.released = true;
+    this.handles.clear();
+  }
+
+  private resolve(reference: NamedDataReference, representation: NamedDataRepresentation, context: NamedDataResolveContext): {binding: DocumentBinding; bytes: Uint8Array} {
+    if (this.released) throw new NamedDataError('NAMED_DATA_PROVIDER_RELEASED', 'The document provider was released.');
+    if (context.signal?.aborted) throw new NamedDataError('NAMED_DATA_ABORTED', 'Body resolution was aborted.');
+    if (reference.namespace !== this.namespace || reference.name.trim().length === 0) throw new NamedDataError('NAMED_DATA_INVALID_REF', 'Invalid document reference.');
+    if (reference.kind !== this.kind) throw new NamedDataError('NAMED_DATA_KIND_MISMATCH', `Expected document, received ${reference.kind}.`);
+    if (reference.scope !== 'target' || !context.target) throw new NamedDataError('NAMED_DATA_SCOPE_MISMATCH', 'Document data requires target scope and target context.');
+    if (representation !== 'html' && representation !== 'markdown') throw new NamedDataError('NAMED_DATA_REPRESENTATION_UNSUPPORTED', `Documents cannot be rendered as ${representation}.`);
+    const binding = this.store.get(context.target, reference.name);
+    if (!binding) throw new NamedDataError('NAMED_DATA_NOT_FOUND', `Document does not exist: ${reference.name}`);
+    if (binding.tree.kind !== representation) throw new NamedDataError('NAMED_DATA_REPRESENTATION_UNSUPPORTED', `Cross-format ${binding.tree.kind} to ${representation} conversion may be lossy.`);
+    const bytes = new TextEncoder().encode(serializeDocument(binding.tree));
+    if (bytes.byteLength > DOCUMENT_MAX_OUTPUT_BYTES) throw new NamedDataError('NAMED_DATA_BODY_TOO_LARGE', 'Serialized document is too large.');
+    if (context.signal?.aborted) throw new NamedDataError('NAMED_DATA_ABORTED', 'Body resolution was aborted.');
+    return {binding, bytes};
+  }
+
+  private metadata(reference: NamedDataReference, representation: NamedDataRepresentation, byteLength: number, revision: number): NamedDataMetadata {
+    return {
+      reference: {...reference}, nativeRepresentation: representation, representation,
+      mediaType: representation === 'html' ? 'text/html; charset=utf-8' : 'text/markdown; charset=utf-8',
+      byteLength, revision: String(revision), replayable: true
+    };
+  }
+}