@tozd/prosemirror 0.1.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,22 @@
+The ported Go packages are derivative works of the corresponding ProseMirror
+(https://prosemirror.net/) packages, used under the MIT license:
+
+Copyright (C) 2015-2017 by Marijn Haverbeke <marijn@haverbeke.berlin> and others
+
+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,121 @@
+# Go port of ProseMirror
+
+[![pkg.go.dev](https://pkg.go.dev/badge/gitlab.com/tozd/go/prosemirror)](https://pkg.go.dev/gitlab.com/tozd/go/prosemirror)
+[![NPM](https://img.shields.io/npm/v/@tozd/prosemirror.svg)](https://www.npmjs.com/package/@tozd/prosemirror)
+[![Go Report Card](https://goreportcard.com/badge/gitlab.com/tozd/go/prosemirror)](https://goreportcard.com/report/gitlab.com/tozd/go/prosemirror)
+[![pipeline status](https://gitlab.com/tozd/go/prosemirror/badges/main/pipeline.svg?ignore_skipped=true)](https://gitlab.com/tozd/go/prosemirror/-/pipelines)
+[![coverage report](https://gitlab.com/tozd/go/prosemirror/badges/main/coverage.svg)](https://gitlab.com/tozd/go/prosemirror/-/graphs/main/charts)
+
+A Go port of [ProseMirror](https://prosemirror.net/) for server-side parsing, validation, and canonical HTML
+serialization of documents, with a TypeScript companion (the `@tozd/prosemirror` NPM package) that builds the same
+schema in the browser from the same shareable JSON.
+
+The components currently available:
+
+- `model` package, ported from [prosemirror-model](https://github.com/ProseMirror/prosemirror-model) v1.25.8 – the
+  document model: schemas, nodes, marks, content expressions, HTML fragment parsing, and canonical HTML serialization.
+
+Each ported component mirrors the structure of its ProseMirror
+TypeScript source so the two can be kept in sync. See [PORTING.md](PORTING.md)
+for the porting contract.
+
+It is used by [PeerDB](https://gitlab.com/peerdb/peerdb), a collaborative database.
+
+## Installation
+
+### Go installation
+
+You can add it to your project using `go get`:
+
+```sh
+go get gitlab.com/tozd/go/prosemirror/model
+```
+
+It requires Go 1.25 or newer.
+
+### TypeScript/JavaScript installation
+
+You can add frontend utilities for Go port of ProseMirror to your project using `npm`:
+
+```sh
+npm install --save @tozd/prosemirror prosemirror-model
+```
+
+It requires node 22 or newer.
+
+## Usage
+
+### Go usage
+
+```go
+schema, errE := model.NewSchema(schemaJSON, map[string]model.AttrValidator{
+  "linkURL": validateLinkURL,
+})
+if errE != nil {
+  // Handle the error.
+}
+
+doc, errE := model.ParseHTML(schema, `<p>Hello, <b>world</b>!</p>`, model.ParseOptions{})
+if errE != nil {
+  // Handle the error.
+}
+
+canonical := model.SerializeHTML(doc)
+
+ok, errE := model.IsCanonicalHTML(schema, canonical, model.ParseOptions{})
+// ok is true: serializing a parsed document always yields the canonical form.
+```
+
+See full package documentation with examples on [pkg.go.dev](https://pkg.go.dev/gitlab.com/tozd/go/prosemirror#section-documentation).
+
+### TypeScript/JavaScript usage
+
+The same schema JSON can be built into a ProseMirror schema in the browser:
+
+```ts
+import { buildSchema } from "@tozd/prosemirror"
+
+const schema = buildSchema(schemaJSON, { linkURL: validateLinkURL })
+```
+
+`buildSchema` takes a parsed schema JSON object and a registry of named attribute validators and returns a
+`prosemirror-model` `Schema`, with `parseDOM` and `toDOM` derived from the dialect, the browser-usable counterpart of
+`model.NewSchema`. `prosemirror-model` is a peer dependency. The frontend and the Go backend build the same schema from
+one shared JSON definition.
+
+## Schema JSON dialect
+
+Schemas are described by a single JSON document that can be shared with a ProseMirror TypeScript implementation.
+Functions cannot live in JSON, so attribute validators are referenced by name (resolved against a registry passed to
+`model.NewSchema`) and the HTML mapping is declarative (`toHTML` and `parseHTML` keys on nodes and marks).
+`model.NewSchema` accepts any spec in this dialect, not only the example schema shipped as a fixture: `toHTML` covers
+the declarative subset of ProseMirror's `DOMOutputSpec` (including nested elements such as a code block rendered as
+`pre` wrapping `code`), and `parseHTML` accepts a full CSS selector in `tag` (matched with
+[cascadia](https://github.com/andybalholm/cascadia)), style rules keyed on an inline CSS declaration
+(`{"style": "font-weight=bold"}`), and a `namespace` constraint, alongside `context` and `priority`. See
+[PORTING.md](PORTING.md) for the full specification of the dialect.
+
+The one documented fidelity boundary is style matching: a style rule matches only an element's own inline longhand
+declarations and does not perform CSSOM shorthand expansion or value normalization. So `style="font-weight: bold"`
+matches a `font-weight` rule, but `style="font: bold 12px serif"` (which exposes `font-weight` only after shorthand
+expansion in a browser) does not. Everything else parses identically to the browser. Editor-only behaviors and the
+transform and collaboration layers are out of scope.
+
+## Related projects
+
+- [prosemirror-go](https://github.com/cozy/prosemirror-go) – a similar port which is somewhat stale and is
+  licensed under AGPL.
+
+## GitHub mirror
+
+There is also a [read-only GitHub mirror available](https://github.com/tozd/go-prosemirror),
+if you need to fork the project there.
+
+## Disclaimer
+
+Port has been fully generated and maintained by AI.
+
+## License
+
+Licensed under the Apache License, Version 2.0 (see [LICENSE](LICENSE)). The ported packages are derivative works of the
+corresponding [ProseMirror](https://prosemirror.net/) packages, used under the MIT license (see [NOTICE](NOTICE)).

package/dist/index.d.ts

@@ -0,0 +1,66 @@
+import type { Attrs, DOMOutputSpec, MarkSpec, NodeSpec, ParseOptions, ParseRule, Node as PMNode } from "prosemirror-model";
+import { Schema } from "prosemirror-model";
+export interface AttributeSpecJSON {
+    default?: unknown;
+    validate?: string;
+    onInvalid?: "rejectRule" | "drop";
+}
+export interface ToHTMLJSON {
+    tag: string;
+    attrs?: string[];
+    content?: ToHTMLJSON;
+}
+export interface ParseRuleJSON {
+    tag?: string;
+    style?: string;
+    namespace?: string;
+    context?: string;
+    priority?: number;
+    preserveWhitespace?: boolean | "full";
+    attrs?: Record<string, unknown>;
+}
+export interface NodeSpecJSON {
+    content?: string;
+    marks?: string;
+    group?: string;
+    inline?: boolean;
+    atom?: boolean;
+    code?: boolean;
+    whitespace?: "pre" | "normal";
+    linebreakReplacement?: boolean;
+    defining?: boolean;
+    selectable?: boolean;
+    attrs?: Record<string, AttributeSpecJSON>;
+    toHTML?: ToHTMLJSON;
+    parseHTML?: ParseRuleJSON[];
+}
+export interface MarkSpecJSON {
+    group?: string;
+    code?: boolean;
+    excludes?: string;
+    spanning?: boolean;
+    inclusive?: boolean;
+    attrs?: Record<string, AttributeSpecJSON>;
+    toHTML?: ToHTMLJSON;
+    parseHTML?: ParseRuleJSON[];
+}
+export interface SchemaJSON {
+    topNode?: string;
+    nodes: Record<string, NodeSpecJSON>;
+    marks?: Record<string, MarkSpecJSON>;
+}
+export type Validator = (value: unknown) => boolean;
+export declare function buildParseRule(ruleJSON: ParseRuleJSON, attrSpecs: Record<string, AttributeSpecJSON> | undefined, validators: Record<string, Validator>): ParseRule;
+export declare function buildOutputSpec(toHTML: ToHTMLJSON, attrs: Attrs, hole: boolean): DOMOutputSpec;
+export declare function buildAttrs(attrsJSON: Record<string, AttributeSpecJSON>): Record<string, {
+    default?: unknown;
+}>;
+export declare function translateNodeSpec(json: NodeSpecJSON, validators: Record<string, Validator>): NodeSpec;
+export declare function translateMarkSpec(json: MarkSpecJSON, validators: Record<string, Validator>): MarkSpec;
+export declare function buildSchema(spec: SchemaJSON, validators?: Record<string, Validator>): Schema;
+export declare function escapeHTML(text: string): string;
+export declare function serializeDOM(node: Node): string;
+export declare function htmlToDoc(schema: Schema, html: string, options?: ParseOptions, domDocument?: Document): PMNode;
+export declare function docToHtml(schema: Schema, doc: PMNode, domDocument?: Document): string;
+export declare function isCanonicalHTML(schema: Schema, html: string, options?: ParseOptions, domDocument?: Document): boolean;
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,266 @@
+// ProseMirror frontend utilities for Go port of ProseMirror. It provides:
+//
+// A builder for ProseMirror Schema from the schema JSON dialect described in the "Schema JSON dialect" section of PORTING.md, the same dialect the Go port parses.
+// Given an already-parsed schema JSON object and a registry of named attribute validators, it produces a prosemirror-model Schema (with parseDOM and toDOM derived
+// from the dialect) that a frontend can use directly.
+//
+// A canonical HTML serializer (serializeDOM, with escapeHTML) that stringifies the DOM produced by prosemirror-model's DOMSerializer into the same canonical HTML
+// the Go SerializeHTML emits (the same five-character escaping, lowercased tags, double-quoted attributes, void-element handling, and pre newline rule), so a
+// frontend can compute the same canonical HTML as the backend.
+//
+// HTML conversion helpers (htmlToDoc, docToHtml, isCanonicalHTML) that parse an HTML string into a document of a given schema, serialize a document back to its
+// canonical HTML, and report whether HTML is already canonical (its parse/serialize round trip is the identity), matching the Go ParseHTML/SerializeHTML and the
+// claim-validity check IsCanonicalHTML.
+import { DOMParser, DOMSerializer, Schema } from "prosemirror-model";
+// Builds a ProseMirror parse rule from a dialect parseHTML rule. Constant attribute entries (number/boolean/null) become static rule attrs;
+// string entries are attribute extraction and become a getAttrs function which reads the named HTML attribute, falls back to the attribute spec
+// default when the attribute is absent (rejecting the rule when the attribute is required), and applies the named validator when one is
+// configured: on failure, onInvalid "rejectRule" (the default) rejects the rule and "drop" replaces the value with the default.
+export function buildParseRule(ruleJSON, attrSpecs, validators) {
+    // Style rules produce marks and match an inline CSS declaration; their attrs are always constants (the declarative dialect does not extract from the
+    // style value). Tag rules match a CSS selector, optionally restricted by namespace, and may extract attributes from the element.
+    if (ruleJSON.style !== undefined) {
+        const rule = { style: ruleJSON.style };
+        if (ruleJSON.context !== undefined)
+            rule.context = ruleJSON.context;
+        if (ruleJSON.priority !== undefined)
+            rule.priority = ruleJSON.priority;
+        if (ruleJSON.attrs !== undefined)
+            rule.attrs = ruleJSON.attrs;
+        return rule;
+    }
+    const rule = { tag: ruleJSON.tag };
+    if (ruleJSON.namespace !== undefined)
+        rule.namespace = ruleJSON.namespace;
+    if (ruleJSON.context !== undefined)
+        rule.context = ruleJSON.context;
+    if (ruleJSON.priority !== undefined)
+        rule.priority = ruleJSON.priority;
+    if (ruleJSON.preserveWhitespace !== undefined)
+        rule.preserveWhitespace = ruleJSON.preserveWhitespace;
+    if (ruleJSON.attrs !== undefined) {
+        const constants = {};
+        const extracted = {};
+        for (const [attrName, value] of Object.entries(ruleJSON.attrs)) {
+            if (typeof value === "string") {
+                extracted[attrName] = value;
+            }
+            else {
+                constants[attrName] = value;
+            }
+        }
+        if (Object.keys(extracted).length === 0) {
+            rule.attrs = constants;
+        }
+        else {
+            rule.getAttrs = (dom) => {
+                const attrs = { ...constants };
+                for (const [attrName, htmlAttr] of Object.entries(extracted)) {
+                    const attrSpec = attrSpecs?.[attrName];
+                    if (attrSpec === undefined) {
+                        throw new Error(`parse rule for tag "${ruleJSON.tag}" extracts undeclared attribute "${attrName}"`);
+                    }
+                    const hasDefault = Object.prototype.hasOwnProperty.call(attrSpec, "default");
+                    const value = dom.getAttribute(htmlAttr);
+                    if (value === null) {
+                        if (!hasDefault) {
+                            return false;
+                        }
+                        attrs[attrName] = attrSpec.default;
+                        continue;
+                    }
+                    if (attrSpec.validate !== undefined) {
+                        const validator = validators[attrSpec.validate];
+                        if (validator === undefined) {
+                            throw new Error(`unknown validator "${attrSpec.validate}" for attribute "${attrName}"`);
+                        }
+                        if (!validator(value)) {
+                            if ((attrSpec.onInvalid ?? "rejectRule") === "drop") {
+                                attrs[attrName] = attrSpec.default;
+                                continue;
+                            }
+                            return false;
+                        }
+                    }
+                    attrs[attrName] = value;
+                }
+                return attrs;
+            };
+        }
+    }
+    return rule;
+}
+// Builds a DOMOutputSpec from a (possibly nested) dialect toHTML spec against concrete attribute values: "{attr}" placeholders in the tag are substituted
+// with String(value) and the attribute object is built from the listed attribute names, skipping null/undefined values. When the spec has a content field
+// the element wraps the nested spec, so the content hole (when hole is true, for nodes with content and for marks) sits at the innermost element.
+export function buildOutputSpec(toHTML, attrs, hole) {
+    const tag = toHTML.tag.replace(/\{([^{}]+)\}/g, (_match, name) => String(attrs[name]));
+    const attrsObj = {};
+    for (const name of toHTML.attrs ?? []) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        const value = attrs[name];
+        if (value === null || value === undefined) {
+            continue;
+        }
+        attrsObj[name] = value;
+    }
+    if (toHTML.content !== undefined) {
+        return [tag, attrsObj, buildOutputSpec(toHTML.content, attrs, hole)];
+    }
+    return (hole ? [tag, attrsObj, 0] : [tag, attrsObj]);
+}
+// Translates the attrs object of a node/mark spec, keeping only the "default" key (validate/onInvalid govern HTML parse behavior and are handled
+// by buildParseRule; passing them to ProseMirror would change node creation semantics).
+export function buildAttrs(attrsJSON) {
+    const attrs = {};
+    for (const [name, attrJSON] of Object.entries(attrsJSON)) {
+        attrs[name] = Object.prototype.hasOwnProperty.call(attrJSON, "default") ? { default: attrJSON.default } : {};
+    }
+    return attrs;
+}
+export function translateNodeSpec(json, validators) {
+    const spec = {};
+    if (json.content !== undefined)
+        spec.content = json.content;
+    if (json.marks !== undefined)
+        spec.marks = json.marks;
+    if (json.group !== undefined)
+        spec.group = json.group;
+    if (json.inline !== undefined)
+        spec.inline = json.inline;
+    if (json.atom !== undefined)
+        spec.atom = json.atom;
+    if (json.code !== undefined)
+        spec.code = json.code;
+    if (json.whitespace !== undefined)
+        spec.whitespace = json.whitespace;
+    if (json.linebreakReplacement !== undefined)
+        spec.linebreakReplacement = json.linebreakReplacement;
+    if (json.defining !== undefined)
+        spec.defining = json.defining;
+    if (json.selectable !== undefined)
+        spec.selectable = json.selectable;
+    if (json.attrs !== undefined)
+        spec.attrs = buildAttrs(json.attrs);
+    // A node's parse rules are tag rules; style rules produce marks and the dialect (like the Go side) only allows them on mark types.
+    if (json.parseHTML !== undefined)
+        spec.parseDOM = json.parseHTML.map((rule) => buildParseRule(rule, json.attrs, validators));
+    if (json.toHTML !== undefined) {
+        const toHTML = json.toHTML;
+        const hasContent = Boolean(json.content);
+        spec.toDOM = (node) => buildOutputSpec(toHTML, node.attrs, hasContent);
+    }
+    return spec;
+}
+export function translateMarkSpec(json, validators) {
+    const spec = {};
+    if (json.group !== undefined)
+        spec.group = json.group;
+    if (json.code !== undefined)
+        spec.code = json.code;
+    if (json.excludes !== undefined)
+        spec.excludes = json.excludes;
+    if (json.spanning !== undefined)
+        spec.spanning = json.spanning;
+    if (json.inclusive !== undefined)
+        spec.inclusive = json.inclusive;
+    if (json.attrs !== undefined)
+        spec.attrs = buildAttrs(json.attrs);
+    if (json.parseHTML !== undefined)
+        spec.parseDOM = json.parseHTML.map((rule) => buildParseRule(rule, json.attrs, validators));
+    if (json.toHTML !== undefined) {
+        const toHTML = json.toHTML;
+        spec.toDOM = (mark) => buildOutputSpec(toHTML, mark.attrs, true);
+    }
+    return spec;
+}
+// Builds a prosemirror-model Schema from a parsed schema JSON object. The validators registry resolves the validate names referenced by attribute specs;
+// it defaults to empty, so a schema that references a validator must supply it (an unknown validator throws during HTML parsing).
+//
+// JSON.parse preserves the declaration order of (non-numeric) object keys, which determines mark rank, parse rule precedence, and group expansion order,
+// matching the strict decoding on the Go side; pass the object from JSON.parse to preserve that order.
+export function buildSchema(spec, validators = {}) {
+    const nodes = {};
+    for (const [name, nodeSpec] of Object.entries(spec.nodes)) {
+        nodes[name] = translateNodeSpec(nodeSpec, validators);
+    }
+    const marks = {};
+    for (const [name, markSpec] of Object.entries(spec.marks ?? {})) {
+        marks[name] = translateMarkSpec(markSpec, validators);
+    }
+    return new Schema({ topNode: spec.topNode, nodes, marks });
+}
+// The five characters escaped in text and attribute values; everything else, including U+00A0, is emitted raw.
+const GO_HTML_ESCAPES = {
+    "&": "&",
+    "'": "'",
+    "<": "&lt;",
+    ">": "&gt;",
+    '"': "&#34;",
+};
+// Escapes the five characters the Go canonical serializer escapes in text and attribute values, leaving everything else (including U+00A0) raw.
+export function escapeHTML(text) {
+    return text.replace(/[&'<>"]/g, (c) => GO_HTML_ESCAPES[c]);
+}
+// The full HTML spec void element set, emitted as an open tag only; this keeps any schema well formed.
+const VOID_ELEMENTS = new Set(["area", "base", "br", "col", "embed", "hr", "img", "input", "link", "meta", "source", "track", "wbr"]);
+const ELEMENT_NODE = 1;
+const TEXT_NODE = 3;
+// Recursive string serialization of the DOM produced by DOMSerializer: lowercase tags, attributes always double-quoted in DOM order, void elements emitted as the
+// open tag only, and one extra "\n" after a pre open tag whose first child is a text node starting with "\n" (the HTML parser drops one newline right after the pre
+// open tag, so the doubled form keeps the parse round trip lossless). It produces the same canonical HTML as the Go SerializeHTML.
+export function serializeDOM(node) {
+    if (node.nodeType === TEXT_NODE) {
+        return escapeHTML(node.data);
+    }
+    if (node.nodeType !== ELEMENT_NODE) {
+        // DOMSerializer produces only elements and text nodes.
+        return "";
+    }
+    const element = node;
+    const tag = element.tagName.toLowerCase();
+    let out = "<" + tag;
+    for (let i = 0; i < element.attributes.length; i++) {
+        const attr = element.attributes[i];
+        out += " " + attr.name + '="' + escapeHTML(attr.value) + '"';
+    }
+    out += ">";
+    if (VOID_ELEMENTS.has(tag)) {
+        return out;
+    }
+    if (tag === "pre" && element.firstChild !== null && element.firstChild.nodeType === TEXT_NODE && element.firstChild.data.startsWith("\n")) {
+        out += "\n";
+    }
+    for (const child of element.childNodes) {
+        out += serializeDOM(child);
+    }
+    return out + "</" + tag + ">";
+}
+// htmlToDoc parses an HTML string into a document of the given schema: it assigns the HTML to the innerHTML of a detached div (the HTML fragment parsing the browser
+// uses) and runs the schema's DOMParser over it. options are the prosemirror-model parse options, notably preserveWhitespace. domDocument supplies the DOM
+// implementation used to create the container; it defaults to the global document, so a browser caller can omit it, while a non-browser caller (for example one using
+// jsdom) passes its document.
+export function htmlToDoc(schema, html, options = {}, domDocument = document) {
+    const container = domDocument.createElement("div");
+    container.innerHTML = html;
+    return DOMParser.fromSchema(schema).parse(container, options);
+}
+// docToHtml serializes a document to its canonical HTML form: it runs the schema's DOMSerializer to build a DOM fragment and stringifies it with serializeDOM,
+// producing the same canonical HTML the Go SerializeHTML emits. The output is a pure function of the document (the same on every browser engine), so collaborating
+// clients can compare HTML against their own editor state directly. domDocument supplies the DOM implementation used to build the fragment; it defaults to the global
+// document, so a browser caller can omit it, while a non-browser caller passes its document.
+export function docToHtml(schema, doc, domDocument = document) {
+    const fragment = DOMSerializer.fromSchema(schema).serializeFragment(doc.content, { document: domDocument });
+    let html = "";
+    for (const child of fragment.childNodes) {
+        html += serializeDOM(child);
+    }
+    return html;
+}
+// isCanonicalHTML reports whether html is already in the canonical form docToHtml produces: parsing it into the schema and serializing it back is the identity. The
+// parse options have to match those used to produce the canonical HTML for the answer to be meaningful. It mirrors the Go IsCanonicalHTML and is the HTML claim
+// validity check on the frontend.
+export function isCanonicalHTML(schema, html, options = {}, domDocument = document) {
+    return docToHtml(schema, htmlToDoc(schema, html, options, domDocument), domDocument) === html;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@tozd/prosemirror",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "ProseMirror frontend utilities for Go port of ProseMirror.",
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=22"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/tozd/go/prosemirror.git"
+  },
+  "module": "./dist/index.js",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "src",
+    "dist",
+    "NOTICE",
+    "!src/*.test.ts"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.eslint.json",
+    "lint": "eslint --fix src scripts",
+    "fmt": "prettier src scripts package.json --write",
+    "test": "vitest",
+    "coverage": "vitest --coverage",
+    "test-ci": "vitest run --reporter junit --reporter default --outputFile tests.xml --coverage",
+    "generate-fixtures": "tsx scripts/generate-fixtures.ts",
+    "upgrade": "ncu -u",
+    "prepare": "npm run build"
+  },
+  "peerDependencies": {
+    "prosemirror-model": "^1.25.8"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^2.0.5",
+    "@eslint/js": "^9.39.1",
+    "@types/jsdom": "^28.0.3",
+    "@types/node": "^24.0.0",
+    "@vitest/coverage-v8": "^4.1.5",
+    "eslint": "^9.39.1",
+    "eslint-config-prettier": "^10.1.8",
+    "globals": "^17.5.0",
+    "jsdom": "^29.1.1",
+    "npm-check-updates": "^21.0.3",
+    "prettier": "^3.8.3",
+    "prettier-plugin-organize-imports": "^4.3.0",
+    "prosemirror-model": "^1.25.8",
+    "tsx": "^4.22.4",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.59.0",
+    "vitest": "^4.1.5"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/index.ts

@@ -0,0 +1,315 @@
+// ProseMirror frontend utilities for Go port of ProseMirror. It provides:
+//
+// A builder for ProseMirror Schema from the schema JSON dialect described in the "Schema JSON dialect" section of PORTING.md, the same dialect the Go port parses.
+// Given an already-parsed schema JSON object and a registry of named attribute validators, it produces a prosemirror-model Schema (with parseDOM and toDOM derived
+// from the dialect) that a frontend can use directly.
+//
+// A canonical HTML serializer (serializeDOM, with escapeHTML) that stringifies the DOM produced by prosemirror-model's DOMSerializer into the same canonical HTML
+// the Go SerializeHTML emits (the same five-character escaping, lowercased tags, double-quoted attributes, void-element handling, and pre newline rule), so a
+// frontend can compute the same canonical HTML as the backend.
+//
+// HTML conversion helpers (htmlToDoc, docToHtml, isCanonicalHTML) that parse an HTML string into a document of a given schema, serialize a document back to its
+// canonical HTML, and report whether HTML is already canonical (its parse/serialize round trip is the identity), matching the Go ParseHTML/SerializeHTML and the
+// claim-validity check IsCanonicalHTML.
+
+import type { Attrs, DOMOutputSpec, Mark, MarkSpec, NodeSpec, ParseOptions, ParseRule, Node as PMNode, StyleParseRule, TagParseRule } from "prosemirror-model"
+
+import { DOMParser, DOMSerializer, Schema } from "prosemirror-model"
+
+// Shapes of the schema JSON dialect.
+
+export interface AttributeSpecJSON {
+  default?: unknown
+  validate?: string
+  onInvalid?: "rejectRule" | "drop"
+}
+
+export interface ToHTMLJSON {
+  tag: string
+  attrs?: string[]
+  content?: ToHTMLJSON
+}
+
+export interface ParseRuleJSON {
+  tag?: string
+  style?: string
+  namespace?: string
+  context?: string
+  priority?: number
+  preserveWhitespace?: boolean | "full"
+  attrs?: Record<string, unknown>
+}
+
+export interface NodeSpecJSON {
+  content?: string
+  marks?: string
+  group?: string
+  inline?: boolean
+  atom?: boolean
+  code?: boolean
+  whitespace?: "pre" | "normal"
+  linebreakReplacement?: boolean
+  defining?: boolean
+  selectable?: boolean
+  attrs?: Record<string, AttributeSpecJSON>
+  toHTML?: ToHTMLJSON
+  parseHTML?: ParseRuleJSON[]
+}
+
+export interface MarkSpecJSON {
+  group?: string
+  code?: boolean
+  excludes?: string
+  spanning?: boolean
+  inclusive?: boolean
+  attrs?: Record<string, AttributeSpecJSON>
+  toHTML?: ToHTMLJSON
+  parseHTML?: ParseRuleJSON[]
+}
+
+export interface SchemaJSON {
+  topNode?: string
+  nodes: Record<string, NodeSpecJSON>
+  marks?: Record<string, MarkSpecJSON>
+}
+
+// A named attribute validator returns true when the value is acceptable. The registry passed to buildSchema maps validator names used in the schema JSON
+// to these functions; a schema referencing a name that is not in the registry is an error.
+export type Validator = (value: unknown) => boolean
+
+// Builds a ProseMirror parse rule from a dialect parseHTML rule. Constant attribute entries (number/boolean/null) become static rule attrs;
+// string entries are attribute extraction and become a getAttrs function which reads the named HTML attribute, falls back to the attribute spec
+// default when the attribute is absent (rejecting the rule when the attribute is required), and applies the named validator when one is
+// configured: on failure, onInvalid "rejectRule" (the default) rejects the rule and "drop" replaces the value with the default.
+export function buildParseRule(ruleJSON: ParseRuleJSON, attrSpecs: Record<string, AttributeSpecJSON> | undefined, validators: Record<string, Validator>): ParseRule {
+  // Style rules produce marks and match an inline CSS declaration; their attrs are always constants (the declarative dialect does not extract from the
+  // style value). Tag rules match a CSS selector, optionally restricted by namespace, and may extract attributes from the element.
+  if (ruleJSON.style !== undefined) {
+    const rule: StyleParseRule = { style: ruleJSON.style }
+    if (ruleJSON.context !== undefined) rule.context = ruleJSON.context
+    if (ruleJSON.priority !== undefined) rule.priority = ruleJSON.priority
+    if (ruleJSON.attrs !== undefined) rule.attrs = ruleJSON.attrs
+    return rule
+  }
+  const rule: TagParseRule = { tag: ruleJSON.tag! }
+  if (ruleJSON.namespace !== undefined) rule.namespace = ruleJSON.namespace
+  if (ruleJSON.context !== undefined) rule.context = ruleJSON.context
+  if (ruleJSON.priority !== undefined) rule.priority = ruleJSON.priority
+  if (ruleJSON.preserveWhitespace !== undefined) rule.preserveWhitespace = ruleJSON.preserveWhitespace
+  if (ruleJSON.attrs !== undefined) {
+    const constants: Record<string, unknown> = {}
+    const extracted: Record<string, string> = {}
+    for (const [attrName, value] of Object.entries(ruleJSON.attrs)) {
+      if (typeof value === "string") {
+        extracted[attrName] = value
+      } else {
+        constants[attrName] = value
+      }
+    }
+    if (Object.keys(extracted).length === 0) {
+      rule.attrs = constants
+    } else {
+      rule.getAttrs = (dom: HTMLElement): Attrs | false => {
+        const attrs: Record<string, unknown> = { ...constants }
+        for (const [attrName, htmlAttr] of Object.entries(extracted)) {
+          const attrSpec = attrSpecs?.[attrName]
+          if (attrSpec === undefined) {
+            throw new Error(`parse rule for tag "${ruleJSON.tag}" extracts undeclared attribute "${attrName}"`)
+          }
+          const hasDefault = Object.prototype.hasOwnProperty.call(attrSpec, "default")
+          const value = dom.getAttribute(htmlAttr)
+          if (value === null) {
+            if (!hasDefault) {
+              return false
+            }
+            attrs[attrName] = attrSpec.default
+            continue
+          }
+          if (attrSpec.validate !== undefined) {
+            const validator = validators[attrSpec.validate]
+            if (validator === undefined) {
+              throw new Error(`unknown validator "${attrSpec.validate}" for attribute "${attrName}"`)
+            }
+            if (!validator(value)) {
+              if ((attrSpec.onInvalid ?? "rejectRule") === "drop") {
+                attrs[attrName] = attrSpec.default
+                continue
+              }
+              return false
+            }
+          }
+          attrs[attrName] = value
+        }
+        return attrs
+      }
+    }
+  }
+  return rule
+}
+
+// Builds a DOMOutputSpec from a (possibly nested) dialect toHTML spec against concrete attribute values: "{attr}" placeholders in the tag are substituted
+// with String(value) and the attribute object is built from the listed attribute names, skipping null/undefined values. When the spec has a content field
+// the element wraps the nested spec, so the content hole (when hole is true, for nodes with content and for marks) sits at the innermost element.
+export function buildOutputSpec(toHTML: ToHTMLJSON, attrs: Attrs, hole: boolean): DOMOutputSpec {
+  const tag = toHTML.tag.replace(/\{([^{}]+)\}/g, (_match, name: string) => String(attrs[name]))
+  const attrsObj: Record<string, unknown> = {}
+  for (const name of toHTML.attrs ?? []) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    const value = attrs[name]
+    if (value === null || value === undefined) {
+      continue
+    }
+    attrsObj[name] = value
+  }
+  if (toHTML.content !== undefined) {
+    return [tag, attrsObj, buildOutputSpec(toHTML.content, attrs, hole)] as DOMOutputSpec
+  }
+  return (hole ? [tag, attrsObj, 0] : [tag, attrsObj]) as DOMOutputSpec
+}
+
+// Translates the attrs object of a node/mark spec, keeping only the "default" key (validate/onInvalid govern HTML parse behavior and are handled
+// by buildParseRule; passing them to ProseMirror would change node creation semantics).
+export function buildAttrs(attrsJSON: Record<string, AttributeSpecJSON>): Record<string, { default?: unknown }> {
+  const attrs: Record<string, { default?: unknown }> = {}
+  for (const [name, attrJSON] of Object.entries(attrsJSON)) {
+    attrs[name] = Object.prototype.hasOwnProperty.call(attrJSON, "default") ? { default: attrJSON.default } : {}
+  }
+  return attrs
+}
+
+export function translateNodeSpec(json: NodeSpecJSON, validators: Record<string, Validator>): NodeSpec {
+  const spec: NodeSpec = {}
+  if (json.content !== undefined) spec.content = json.content
+  if (json.marks !== undefined) spec.marks = json.marks
+  if (json.group !== undefined) spec.group = json.group
+  if (json.inline !== undefined) spec.inline = json.inline
+  if (json.atom !== undefined) spec.atom = json.atom
+  if (json.code !== undefined) spec.code = json.code
+  if (json.whitespace !== undefined) spec.whitespace = json.whitespace
+  if (json.linebreakReplacement !== undefined) spec.linebreakReplacement = json.linebreakReplacement
+  if (json.defining !== undefined) spec.defining = json.defining
+  if (json.selectable !== undefined) spec.selectable = json.selectable
+  if (json.attrs !== undefined) spec.attrs = buildAttrs(json.attrs)
+  // A node's parse rules are tag rules; style rules produce marks and the dialect (like the Go side) only allows them on mark types.
+  if (json.parseHTML !== undefined) spec.parseDOM = json.parseHTML.map((rule) => buildParseRule(rule, json.attrs, validators)) as TagParseRule[]
+  if (json.toHTML !== undefined) {
+    const toHTML = json.toHTML
+    const hasContent = Boolean(json.content)
+    spec.toDOM = (node: PMNode): DOMOutputSpec => buildOutputSpec(toHTML, node.attrs, hasContent)
+  }
+  return spec
+}
+
+export function translateMarkSpec(json: MarkSpecJSON, validators: Record<string, Validator>): MarkSpec {
+  const spec: MarkSpec = {}
+  if (json.group !== undefined) spec.group = json.group
+  if (json.code !== undefined) spec.code = json.code
+  if (json.excludes !== undefined) spec.excludes = json.excludes
+  if (json.spanning !== undefined) spec.spanning = json.spanning
+  if (json.inclusive !== undefined) spec.inclusive = json.inclusive
+  if (json.attrs !== undefined) spec.attrs = buildAttrs(json.attrs)
+  if (json.parseHTML !== undefined) spec.parseDOM = json.parseHTML.map((rule) => buildParseRule(rule, json.attrs, validators))
+  if (json.toHTML !== undefined) {
+    const toHTML = json.toHTML
+    spec.toDOM = (mark: Mark): DOMOutputSpec => buildOutputSpec(toHTML, mark.attrs, true)
+  }
+  return spec
+}
+
+// Builds a prosemirror-model Schema from a parsed schema JSON object. The validators registry resolves the validate names referenced by attribute specs;
+// it defaults to empty, so a schema that references a validator must supply it (an unknown validator throws during HTML parsing).
+//
+// JSON.parse preserves the declaration order of (non-numeric) object keys, which determines mark rank, parse rule precedence, and group expansion order,
+// matching the strict decoding on the Go side; pass the object from JSON.parse to preserve that order.
+export function buildSchema(spec: SchemaJSON, validators: Record<string, Validator> = {}): Schema {
+  const nodes: Record<string, NodeSpec> = {}
+  for (const [name, nodeSpec] of Object.entries(spec.nodes)) {
+    nodes[name] = translateNodeSpec(nodeSpec, validators)
+  }
+  const marks: Record<string, MarkSpec> = {}
+  for (const [name, markSpec] of Object.entries(spec.marks ?? {})) {
+    marks[name] = translateMarkSpec(markSpec, validators)
+  }
+  return new Schema({ topNode: spec.topNode, nodes, marks })
+}
+
+// The five characters escaped in text and attribute values; everything else, including U+00A0, is emitted raw.
+const GO_HTML_ESCAPES: Record<string, string> = {
+  "&": "&amp;",
+  "'": "&#39;",
+  "<": "&lt;",
+  ">": "&gt;",
+  '"': "&#34;",
+}
+
+// Escapes the five characters the Go canonical serializer escapes in text and attribute values, leaving everything else (including U+00A0) raw.
+export function escapeHTML(text: string): string {
+  return text.replace(/[&'<>"]/g, (c) => GO_HTML_ESCAPES[c])
+}
+
+// The full HTML spec void element set, emitted as an open tag only; this keeps any schema well formed.
+const VOID_ELEMENTS = new Set(["area", "base", "br", "col", "embed", "hr", "img", "input", "link", "meta", "source", "track", "wbr"])
+
+const ELEMENT_NODE = 1
+const TEXT_NODE = 3
+
+// Recursive string serialization of the DOM produced by DOMSerializer: lowercase tags, attributes always double-quoted in DOM order, void elements emitted as the
+// open tag only, and one extra "\n" after a pre open tag whose first child is a text node starting with "\n" (the HTML parser drops one newline right after the pre
+// open tag, so the doubled form keeps the parse round trip lossless). It produces the same canonical HTML as the Go SerializeHTML.
+export function serializeDOM(node: Node): string {
+  if (node.nodeType === TEXT_NODE) {
+    return escapeHTML((node as Text).data)
+  }
+  if (node.nodeType !== ELEMENT_NODE) {
+    // DOMSerializer produces only elements and text nodes.
+    return ""
+  }
+  const element = node as Element
+  const tag = element.tagName.toLowerCase()
+  let out = "<" + tag
+  for (let i = 0; i < element.attributes.length; i++) {
+    const attr = element.attributes[i]
+    out += " " + attr.name + '="' + escapeHTML(attr.value) + '"'
+  }
+  out += ">"
+  if (VOID_ELEMENTS.has(tag)) {
+    return out
+  }
+  if (tag === "pre" && element.firstChild !== null && element.firstChild.nodeType === TEXT_NODE && (element.firstChild as Text).data.startsWith("\n")) {
+    out += "\n"
+  }
+  for (const child of element.childNodes) {
+    out += serializeDOM(child)
+  }
+  return out + "</" + tag + ">"
+}
+
+// htmlToDoc parses an HTML string into a document of the given schema: it assigns the HTML to the innerHTML of a detached div (the HTML fragment parsing the browser
+// uses) and runs the schema's DOMParser over it. options are the prosemirror-model parse options, notably preserveWhitespace. domDocument supplies the DOM
+// implementation used to create the container; it defaults to the global document, so a browser caller can omit it, while a non-browser caller (for example one using
+// jsdom) passes its document.
+export function htmlToDoc(schema: Schema, html: string, options: ParseOptions = {}, domDocument: Document = document): PMNode {
+  const container = domDocument.createElement("div")
+  container.innerHTML = html
+  return DOMParser.fromSchema(schema).parse(container, options)
+}
+
+// docToHtml serializes a document to its canonical HTML form: it runs the schema's DOMSerializer to build a DOM fragment and stringifies it with serializeDOM,
+// producing the same canonical HTML the Go SerializeHTML emits. The output is a pure function of the document (the same on every browser engine), so collaborating
+// clients can compare HTML against their own editor state directly. domDocument supplies the DOM implementation used to build the fragment; it defaults to the global
+// document, so a browser caller can omit it, while a non-browser caller passes its document.
+export function docToHtml(schema: Schema, doc: PMNode, domDocument: Document = document): string {
+  const fragment = DOMSerializer.fromSchema(schema).serializeFragment(doc.content, { document: domDocument })
+  let html = ""
+  for (const child of fragment.childNodes) {
+    html += serializeDOM(child)
+  }
+  return html
+}
+
+// isCanonicalHTML reports whether html is already in the canonical form docToHtml produces: parsing it into the schema and serializing it back is the identity. The
+// parse options have to match those used to produce the canonical HTML for the answer to be meaningful. It mirrors the Go IsCanonicalHTML and is the HTML claim
+// validity check on the frontend.
+export function isCanonicalHTML(schema: Schema, html: string, options: ParseOptions = {}, domDocument: Document = document): boolean {
+  return docToHtml(schema, htmlToDoc(schema, html, options, domDocument), domDocument) === html
+}