weml-monaco 0.5.1 → 0.6.0

package/CHANGELOG.md

@@ -8,6 +8,28 @@ This package mirrors the language logic of the VS Code extension; entries below
 track the port catching up with the VS Code provider changes (see the root
 `CHANGELOG.md` for the extension).
 
+## [0.6.0] — 2026-10-06
+
+### Added
+- `registerWemlWorker` (`weml-monaco/worker`) and the worker module
+  (`weml-monaco/weml.worker`): the same language with completion, hover, outline
+  and diagnostics computed in a Web Worker, so typing in a large document no
+  longer waits for a full parse per keystroke. The worker mirrors models from
+  their edits and answers only the current version of a model. `registerWeml`
+  and the global build are unchanged.
+
+## [0.5.2] — 2026-09-26
+
+### Added
+- Support table `align`, hr `background`/`foreground`, paragraph `hash`,
+  `refcode-short`/`refcode-long`, and `original-id`/`hash` metadata in
+  completions, hover documentation and diagnostics.
+
+### Fixed
+- Validate paragraph IDs as positive 32-bit integers and detect numerically
+  equivalent duplicate IDs, including leading zeros.
+- Preserve multiline metadata descriptions and omit unspecified attribute defaults.
+
 ## [0.5.1] — 2026-09-26
 
 ### Changed

package/README.md

@@ -99,6 +99,48 @@ formatter directly, call `formatWemlText(source)`.
 Structural validation failures are also available through
 `isWemlStructureValidationFailure(error)` and include a code, line and column.
 
+## Analysis in a Web Worker
+
+`registerWeml` runs completion, hover, outline and diagnostics on the main
+thread, and each of them parses the whole document for every new model version.
+On a large file — a whole book, a megabyte and more — that is tens of
+milliseconds per keystroke on the thread that handles the keystrokes, and typing
+falls behind. `registerWemlWorker` registers the same language with that work in
+a Web Worker:
+
+```ts
+import * as monaco from 'monaco-editor/editor/editor.api.js';
+import { registerWemlWorker } from 'weml-monaco/worker';
+import WemlWorker from 'weml-monaco/weml.worker?worker'; // Vite
+
+const disposable = registerWemlWorker(monaco, { worker: () => new WemlWorker() });
+// Without Vite's `?worker`:
+// registerWemlWorker(monaco, {
+//     worker: () => new Worker(new URL('weml-monaco/weml.worker', import.meta.url), { type: 'module' }),
+// });
+```
+
+It is an addition, not a replacement: `registerWeml` is unchanged, and an
+application chooses one of the two (registering both doubles every provider).
+The worker runs the very providers `registerWeml` registers, so suggestions,
+hovers, outline and markers are the same; only where they are computed changes.
+
+- The worker mirrors each `weml` model's text and keeps it current from the
+  edits Monaco reports — the main thread never sends the whole text again.
+- A request is answered only for the model's current version: one overtaken by
+  further typing is answered empty without parsing, so holding a key down does
+  not build up a queue of parses.
+- Markers computed for a version the model has since left are dropped.
+- The tokenizer, language configuration and formatting stay on the main thread,
+  as with `registerWeml` — they are cheap or run on demand.
+- `weml-monaco/weml.worker` imports nothing of Monaco at runtime; it needs a
+  bundler (or a module worker) to load, and is ESM only.
+
+`registerWemlWorker(monaco, options)` takes the options of `registerWeml` plus
+`worker`, a function that starts the worker (called once; the worker is
+terminated on `dispose()`). The global `<script>` build (`index.global.js`) has
+no worker variant.
+
 ## Toolbar & editor commands
 
 Monaco has no webview panels, so the VS Code toolbar is ported as a **DOM top

package/dist/index.cjs

@@ -29473,8 +29473,19 @@ var TAGS = {
   },
   "hr": {
     "tag": "hr",
-    "description": "Represents a horizontal ruler. Has no attributes or other special meanings.",
-    "attributes": [],
+    "description": "Represents a horizontal ruler with optional foreground and background colors.",
+    "attributes": [
+      {
+        "name": "background",
+        "required": false,
+        "description": "Background color. See Colors."
+      },
+      {
+        "name": "foreground",
+        "required": false,
+        "description": "Foreground color. See Colors."
+      }
+    ],
     "notes": "Usually displayed as an ornament or three centered asterisks.",
     "source": "blocks/hr.md"
   },
@@ -29768,7 +29779,14 @@ var TAGS = {
   "table": {
     "tag": "table",
     "description": "",
-    "attributes": [],
+    "attributes": [
+      {
+        "name": "align",
+        "required": false,
+        "description": "Horizontal alignment of the table. See corresponding page for possible values",
+        "enumRef": "horizontal-alignment"
+      }
+    ],
     "notes": "Contains optional `<thead>` and `<tbody>` sections. Both of them, if specfied, must\nhave at least one table row.\n\n`THEAD` element includes cells from the table header and `TBODY` represents actual\ntabular data.\n\nIs displayed as a table. Borderless or bordered, is determined by the client",
     "source": "blocks/table.md"
   },
@@ -30031,7 +30049,22 @@ var TAGS = {
       {
         "name": "id",
         "required": true,
-        "description": "Unique numeric ID of the paragraph within the document. Should be preserved between imports."
+        "description": "Positive 32-bit integer ID (1\u20132147483647), unique within the document. Should be preserved between imports."
+      },
+      {
+        "name": "hash",
+        "required": false,
+        "description": "Paragraph hash. Preserved without calculation or verification."
+      },
+      {
+        "name": "refcode-short",
+        "required": false,
+        "description": "Short reference code."
+      },
+      {
+        "name": "refcode-long",
+        "required": false,
+        "description": "Long reference code."
       },
       {
         "name": "data-skip",
@@ -30048,6 +30081,10 @@ var META_FIELDS = [
     "name": "pubid",
     "description": "Publication id. Must be unique for each publication."
   },
+  {
+    "name": "original-id",
+    "description": "Original publication ID for a translation. Optional 32-bit integer, represented by `WemlDocumentHeader.OriginalId` (`int?`). Missing or unparseable WEML values are read as `null`."
+  },
   {
     "name": "code",
     "description": "Publication short code."
@@ -30091,11 +30128,15 @@ var META_FIELDS = [
   },
   {
     "name": "purchase-link",
-    "description": "Purchase link."
+    "description": "Absolute purchase URI."
   },
   {
     "name": "version-id",
     "description": "Publication version GUID."
+  },
+  {
+    "name": "hash",
+    "description": "Publication version hash."
   }
 ];
 
@@ -30598,7 +30639,9 @@ var ATTRIBUTE_CONSTRAINTS = [
   { tag: "td", attribute: "rowspan", kind: "integer-min", min: 1, message: "`rowspan` must be an integer >= 1." },
   { tag: "th", attribute: "colspan", kind: "integer-min", min: 1, message: "`colspan` must be an integer >= 1." },
   { tag: "th", attribute: "rowspan", kind: "integer-min", min: 1, message: "`rowspan` must be an integer >= 1." },
-  { tag: "div", attribute: "id", kind: "integer-min", min: 0, message: "`id` must be a non-negative integer, unique within the document." }
+  { tag: "hr", attribute: "background", kind: "pattern", pattern: COLOR_VALUE, allowEmpty: false, message: "`background` must be a color in #RGB, #RGBA, #RRGGBB or #RRGGBBAA format." },
+  { tag: "hr", attribute: "foreground", kind: "pattern", pattern: COLOR_VALUE, allowEmpty: false, message: "`foreground` must be a color in #RGB, #RGBA, #RRGGBB or #RRGGBBAA format." },
+  { tag: "div", attribute: "id", kind: "integer-range", min: 1, max: 2147483647, pattern: /^\+?\d+$/, message: "`id` must be a positive 32-bit integer (1\u20132147483647), unique within the document." }
 ];
 var META_CONSTRAINTS = [
   { name: "pubid", kind: "digits", message: 'meta[name="pubid"] content must contain only digits.' },
@@ -31318,9 +31361,10 @@ function validateWemlModel(m, model) {
       const id = stripQuotes2(node.attributes?.["id"]);
       const range = attrs.get("id")?.valueRange ?? tagRange;
       if (id !== void 0) {
-        const list = divIds.get(id) ?? [];
+        const key = /^\+?\d+$/.test(id.trim()) ? String(Number(id)) : id;
+        const list = divIds.get(key) ?? [];
         list.push(range);
-        divIds.set(id, list);
+        divIds.set(key, list);
       }
     }
   }
@@ -31334,7 +31378,7 @@ function validateWemlModel(m, model) {
       return;
     }
     const n = Number(info.value);
-    if (!Number.isInteger(n)) {
+    if (!Number.isInteger(n) || constraint.pattern && !constraint.pattern.test(info.value.trim())) {
       push(info.valueRange, constraint.message, "error");
       return;
     }