@keroway/tdsl-wasm 1.14.0 → 1.16.0

package/README.md

@@ -45,7 +45,9 @@ const svg = render_svg_from_source(source, 0);
 // Render to a standalone HTML document.
 const html = render_html_from_source(source);
 
-// Lint / diagnostics: returns a JSON array [{severity, message, line, col}] (0-indexed).
+// Lint / diagnostics: returns a JSON array [{severity, message, line, col}].
+// line/col are 1-based when a source position is available; diagnostics without
+// a position (e.g. unknown-lane lowering errors) report line: 0, col: 0.
 const diagnostics = JSON.parse(check_source(source));
 
 // Re-emit normalized source (2-space indent). Comments are not preserved.
@@ -60,7 +62,7 @@ const formatted = format_source(source);
 | `compile_to_ir` | `(source: string) => string` | Compile to JSON IR. Throws on compile error. |
 | `render_svg_from_source` | `(source: string, scale: number) => string` | Render SVG. `scale` = pixels-per-year; pass `0` for auto. |
 | `render_html_from_source` | `(source: string) => string` | Render a standalone HTML document. |
-| `check_source` | `(source: string) => string` | Diagnostics as a JSON array `[{severity, message, line, col}]`. |
+| `check_source` | `(source: string) => string` | Diagnostics as a JSON array `[{severity, message, line, col}]`. `line`/`col` are 1-based when a position is available, else `0`. |
 | `format_source` | `(source: string) => string` | Re-emit normalized source from the AST. |
 
 Full TypeScript definitions ship with the package (`tdsl_wasm.d.ts`).

package/package.json

@@ -2,7 +2,7 @@
   "name": "@keroway/tdsl-wasm",
   "type": "module",
   "description": "WebAssembly bindings for the Timeline DSL compiler (static compile + SVG/HTML render)",
-  "version": "1.14.0",
+  "version": "1.16.0",
   "license": "MIT",
   "repository": {
     "type": "git",

package/tdsl_wasm.d.ts

@@ -5,7 +5,13 @@
  * Check TDSL source and return diagnostics as JSON.
  *
  * Returns a JSON array of diagnostic objects: `[{severity, message, line, col}]`.
- * `severity` is `"error"` or `"warning"`. `line`/`col` are 0-indexed.
+ * `severity` is `"error"` or `"warning"`.
+ *
+ * `line`/`col` are **1-based** when a source position is available (parse errors via
+ * `ParseError::source_location`, validation warnings via the item's `source_span`),
+ * matching the IR `SourceSpan` numbering used by `render_svg_from_source`'s `data-line`
+ * attributes. Diagnostics that carry no position (lowering errors such as unknown-lane
+ * references) report `line: 0, col: 0`; the WebUI treats a `0` line as non-clickable.
  *
  * **Note on `import` blocks**: `import wikidata` blocks are not resolved in the browser
  * (no network access). Unresolved imports are **silently skipped** — they produce no

package/tdsl_wasm.js

@@ -4,7 +4,13 @@
  * Check TDSL source and return diagnostics as JSON.
  *
  * Returns a JSON array of diagnostic objects: `[{severity, message, line, col}]`.
- * `severity` is `"error"` or `"warning"`. `line`/`col` are 0-indexed.
+ * `severity` is `"error"` or `"warning"`.
+ *
+ * `line`/`col` are **1-based** when a source position is available (parse errors via
+ * `ParseError::source_location`, validation warnings via the item's `source_span`),
+ * matching the IR `SourceSpan` numbering used by `render_svg_from_source`'s `data-line`
+ * attributes. Diagnostics that carry no position (lowering errors such as unknown-lane
+ * references) report `line: 0, col: 0`; the WebUI treats a `0` line as non-clickable.
  *
  * **Note on `import` blocks**: `import wikidata` blocks are not resolved in the browser
  * (no network access). Unresolved imports are **silently skipped** — they produce no