@keroway/tdsl-wasm 1.16.0 → 1.18.0

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.16.0",
+  "version": "1.18.0",
   "license": "MIT",
   "repository": {
     "type": "git",

package/tdsl_wasm.d.ts

@@ -1,11 +1,43 @@
 /* tslint:disable */
 /* eslint-disable */
 
+/**
+ * Rendering options exposed to JavaScript.
+ *
+ * Create with `new JsRenderOptions()` — all fields default to the same values
+ * as `RenderOptions::default()`.  String fields (`orientation`, `grid`, `theme`)
+ * accept the lowercase variant names defined below.
+ *
+ * | Field | Accepted values | Default |
+ * |-------|----------------|---------|
+ * | `orientation` | `"horizontal"`, `"vertical"` | `"horizontal"` |
+ * | `grid` | `"none"`, `"decade"`, `"year"`, `"month"` | `"none"` |
+ * | `theme` | `"default"`, `"dark"`, `"print"`, `"pastel"` | `"default"` |
+ * | `show_table` | `true`, `false` | `false` |
+ * | `show_event_labels` | `true`, `false` | `false` |
+ */
+export class JsRenderOptions {
+    free(): void;
+    [Symbol.dispose](): void;
+    constructor();
+    /**
+     * When true, labels are rendered next to Event/EventRange items.
+     */
+    show_event_labels: boolean;
+    /**
+     * `"horizontal"` (default) or `"vertical"`
+     */
+    show_table: boolean;
+    grid: string;
+    orientation: string;
+    theme: string;
+}
+
 /**
  * Check TDSL source and return diagnostics as JSON.
  *
  * Returns a JSON array of diagnostic objects: `[{severity, message, line, col}]`.
- * `severity` is `"error"` or `"warning"`.
+ * `severity` is `"error"`, `"warning"`, or `"info"`.
  *
  * `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`),
@@ -13,10 +45,9 @@
  * 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
- * diagnostics, but the resulting IR / SVG will omit those items. Use static `span`,
- * `event`, and `event_range` statements for content that must render in the browser.
+ * **Note on `import`/`map` blocks**: Wikidata fetch is not available in the browser.
+ * Each `import` or `map` block receives an `"info"` diagnostic pointing to its start
+ * line so the user knows to run `tdsl build` for full resolution.
  */
 export function check_source(source: string): string;
 
@@ -37,6 +68,32 @@ export function compile_to_ir(source: string): string;
  */
 export function format_source(source: string): string;
 
+/**
+ * Apply `tdsl lint --fix` to TDSL source and return the rewritten source.
+ *
+ * - When at least one fixable issue is applied, the rewritten source is returned.
+ * - When the input has no fixable issues, the original source is returned unchanged
+ *   (callers can compare lengths / equality to detect a no-op).
+ * - On parse failure, returns `Err(parse_error_message)`.
+ *
+ * Comments are not preserved because `tdsl-parser` skips them at the PEG layer,
+ * matching the behavior of `format_source` and the `tdsl lint --fix` CLI.
+ */
+export function lint_fix_source(source: string): string;
+
+/**
+ * Run lint rules on TDSL source and return issues as JSON.
+ *
+ * Returns a JSON array of `{code, severity, line, message, fixable}` objects.
+ * `severity` is `"error"` or `"warning"` (lint does not emit `"info"`).
+ * `line` is **1-based** and matches `check_source`'s line numbering.
+ * `fixable` is `true` when `lint_fix_source` can automatically resolve the issue.
+ *
+ * On parse error, the array contains a single entry with `code: "parse_error"`
+ * so callers can still surface the failure through the same path as lint issues.
+ */
+export function lint_source(source: string): string;
+
 /**
  * Initialize the panic hook for better error messages in the browser console.
  */
@@ -48,6 +105,12 @@ export function main(): void;
  */
 export function render_html_from_source(source: string): string;
 
+/**
+ * Render standalone HTML from TDSL source with explicit render options.
+ * Returns Ok(html_string) or Err(error_message).
+ */
+export function render_html_from_source_with_options(source: string, opts: JsRenderOptions): string;
+
 /**
  * Render SVG from TDSL source (static items only).
  * `scale` controls pixels-per-year. Pass `0.0` (or negative) to auto-calculate
@@ -58,15 +121,39 @@ export function render_html_from_source(source: string): string;
  */
 export function render_svg_from_source(source: string, scale: number): string;
 
+/**
+ * Render SVG from TDSL source with explicit render options.
+ *
+ * `scale` controls pixels-per-year. Pass `0.0` (or negative) to auto-calculate.
+ * Returns Ok(svg_string) or Err(error_message).
+ */
+export function render_svg_from_source_with_options(source: string, scale: number, opts: JsRenderOptions): string;
+
 export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
 
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
+    readonly __wbg_get_jsrenderoptions_show_event_labels: (a: number) => number;
+    readonly __wbg_get_jsrenderoptions_show_table: (a: number) => number;
+    readonly __wbg_jsrenderoptions_free: (a: number, b: number) => void;
+    readonly __wbg_set_jsrenderoptions_show_event_labels: (a: number, b: number) => void;
+    readonly __wbg_set_jsrenderoptions_show_table: (a: number, b: number) => void;
     readonly check_source: (a: number, b: number, c: number) => void;
     readonly compile_to_ir: (a: number, b: number, c: number) => void;
     readonly format_source: (a: number, b: number, c: number) => void;
+    readonly jsrenderoptions_grid: (a: number, b: number) => void;
+    readonly jsrenderoptions_new: () => number;
+    readonly jsrenderoptions_orientation: (a: number, b: number) => void;
+    readonly jsrenderoptions_set_grid: (a: number, b: number, c: number) => void;
+    readonly jsrenderoptions_set_orientation: (a: number, b: number, c: number) => void;
+    readonly jsrenderoptions_set_theme: (a: number, b: number, c: number) => void;
+    readonly jsrenderoptions_theme: (a: number, b: number) => void;
+    readonly lint_fix_source: (a: number, b: number, c: number) => void;
+    readonly lint_source: (a: number, b: number, c: number) => void;
     readonly render_html_from_source: (a: number, b: number, c: number) => void;
+    readonly render_html_from_source_with_options: (a: number, b: number, c: number, d: number) => void;
     readonly render_svg_from_source: (a: number, b: number, c: number, d: number) => void;
+    readonly render_svg_from_source_with_options: (a: number, b: number, c: number, d: number, e: number) => void;
     readonly main: () => void;
     readonly __wbindgen_export: (a: number, b: number, c: number) => void;
     readonly __wbindgen_export2: (a: number, b: number) => number;

package/tdsl_wasm.js

@@ -1,10 +1,156 @@
 /* @ts-self-types="./tdsl_wasm.d.ts" */
 
+/**
+ * Rendering options exposed to JavaScript.
+ *
+ * Create with `new JsRenderOptions()` — all fields default to the same values
+ * as `RenderOptions::default()`.  String fields (`orientation`, `grid`, `theme`)
+ * accept the lowercase variant names defined below.
+ *
+ * | Field | Accepted values | Default |
+ * |-------|----------------|---------|
+ * | `orientation` | `"horizontal"`, `"vertical"` | `"horizontal"` |
+ * | `grid` | `"none"`, `"decade"`, `"year"`, `"month"` | `"none"` |
+ * | `theme` | `"default"`, `"dark"`, `"print"`, `"pastel"` | `"default"` |
+ * | `show_table` | `true`, `false` | `false` |
+ * | `show_event_labels` | `true`, `false` | `false` |
+ */
+export class JsRenderOptions {
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+        JsRenderOptionsFinalization.unregister(this);
+        return ptr;
+    }
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_jsrenderoptions_free(ptr, 0);
+    }
+    /**
+     * When true, labels are rendered next to Event/EventRange items.
+     * @returns {boolean}
+     */
+    get show_event_labels() {
+        const ret = wasm.__wbg_get_jsrenderoptions_show_event_labels(this.__wbg_ptr);
+        return ret !== 0;
+    }
+    /**
+     * `"horizontal"` (default) or `"vertical"`
+     * @returns {boolean}
+     */
+    get show_table() {
+        const ret = wasm.__wbg_get_jsrenderoptions_show_table(this.__wbg_ptr);
+        return ret !== 0;
+    }
+    /**
+     * @returns {string}
+     */
+    get grid() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.jsrenderoptions_grid(retptr, this.__wbg_ptr);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            deferred1_0 = r0;
+            deferred1_1 = r1;
+            return getStringFromWasm0(r0, r1);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+            wasm.__wbindgen_export(deferred1_0, deferred1_1, 1);
+        }
+    }
+    constructor() {
+        const ret = wasm.jsrenderoptions_new();
+        this.__wbg_ptr = ret >>> 0;
+        JsRenderOptionsFinalization.register(this, this.__wbg_ptr, this);
+        return this;
+    }
+    /**
+     * @returns {string}
+     */
+    get orientation() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.jsrenderoptions_orientation(retptr, this.__wbg_ptr);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            deferred1_0 = r0;
+            deferred1_1 = r1;
+            return getStringFromWasm0(r0, r1);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+            wasm.__wbindgen_export(deferred1_0, deferred1_1, 1);
+        }
+    }
+    /**
+     * @param {string} val
+     */
+    set grid(val) {
+        const ptr0 = passStringToWasm0(val, wasm.__wbindgen_export2, wasm.__wbindgen_export3);
+        const len0 = WASM_VECTOR_LEN;
+        wasm.jsrenderoptions_set_grid(this.__wbg_ptr, ptr0, len0);
+    }
+    /**
+     * @param {string} val
+     */
+    set orientation(val) {
+        const ptr0 = passStringToWasm0(val, wasm.__wbindgen_export2, wasm.__wbindgen_export3);
+        const len0 = WASM_VECTOR_LEN;
+        wasm.jsrenderoptions_set_orientation(this.__wbg_ptr, ptr0, len0);
+    }
+    /**
+     * @param {string} val
+     */
+    set theme(val) {
+        const ptr0 = passStringToWasm0(val, wasm.__wbindgen_export2, wasm.__wbindgen_export3);
+        const len0 = WASM_VECTOR_LEN;
+        wasm.jsrenderoptions_set_theme(this.__wbg_ptr, ptr0, len0);
+    }
+    /**
+     * @returns {string}
+     */
+    get theme() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.jsrenderoptions_theme(retptr, this.__wbg_ptr);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            deferred1_0 = r0;
+            deferred1_1 = r1;
+            return getStringFromWasm0(r0, r1);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+            wasm.__wbindgen_export(deferred1_0, deferred1_1, 1);
+        }
+    }
+    /**
+     * When true, labels are rendered next to Event/EventRange items.
+     * @param {boolean} arg0
+     */
+    set show_event_labels(arg0) {
+        wasm.__wbg_set_jsrenderoptions_show_event_labels(this.__wbg_ptr, arg0);
+    }
+    /**
+     * `"horizontal"` (default) or `"vertical"`
+     * @param {boolean} arg0
+     */
+    set show_table(arg0) {
+        wasm.__wbg_set_jsrenderoptions_show_table(this.__wbg_ptr, arg0);
+    }
+}
+if (Symbol.dispose) JsRenderOptions.prototype[Symbol.dispose] = JsRenderOptions.prototype.free;
+
 /**
  * Check TDSL source and return diagnostics as JSON.
  *
  * Returns a JSON array of diagnostic objects: `[{severity, message, line, col}]`.
- * `severity` is `"error"` or `"warning"`.
+ * `severity` is `"error"`, `"warning"`, or `"info"`.
  *
  * `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`),
@@ -12,10 +158,9 @@
  * 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
- * diagnostics, but the resulting IR / SVG will omit those items. Use static `span`,
- * `event`, and `event_range` statements for content that must render in the browser.
+ * **Note on `import`/`map` blocks**: Wikidata fetch is not available in the browser.
+ * Each `import` or `map` block receives an `"info"` diagnostic pointing to its start
+ * line so the user knows to run `tdsl build` for full resolution.
  * @param {string} source
  * @returns {string}
  */
@@ -109,6 +254,78 @@ export function format_source(source) {
     }
 }
 
+/**
+ * Apply `tdsl lint --fix` to TDSL source and return the rewritten source.
+ *
+ * - When at least one fixable issue is applied, the rewritten source is returned.
+ * - When the input has no fixable issues, the original source is returned unchanged
+ *   (callers can compare lengths / equality to detect a no-op).
+ * - On parse failure, returns `Err(parse_error_message)`.
+ *
+ * Comments are not preserved because `tdsl-parser` skips them at the PEG layer,
+ * matching the behavior of `format_source` and the `tdsl lint --fix` CLI.
+ * @param {string} source
+ * @returns {string}
+ */
+export function lint_fix_source(source) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(source, wasm.__wbindgen_export2, wasm.__wbindgen_export3);
+        const len0 = WASM_VECTOR_LEN;
+        wasm.lint_fix_source(retptr, ptr0, len0);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+        var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+        var ptr2 = r0;
+        var len2 = r1;
+        if (r3) {
+            ptr2 = 0; len2 = 0;
+            throw takeObject(r2);
+        }
+        deferred3_0 = ptr2;
+        deferred3_1 = len2;
+        return getStringFromWasm0(ptr2, len2);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+        wasm.__wbindgen_export(deferred3_0, deferred3_1, 1);
+    }
+}
+
+/**
+ * Run lint rules on TDSL source and return issues as JSON.
+ *
+ * Returns a JSON array of `{code, severity, line, message, fixable}` objects.
+ * `severity` is `"error"` or `"warning"` (lint does not emit `"info"`).
+ * `line` is **1-based** and matches `check_source`'s line numbering.
+ * `fixable` is `true` when `lint_fix_source` can automatically resolve the issue.
+ *
+ * On parse error, the array contains a single entry with `code: "parse_error"`
+ * so callers can still surface the failure through the same path as lint issues.
+ * @param {string} source
+ * @returns {string}
+ */
+export function lint_source(source) {
+    let deferred2_0;
+    let deferred2_1;
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(source, wasm.__wbindgen_export2, wasm.__wbindgen_export3);
+        const len0 = WASM_VECTOR_LEN;
+        wasm.lint_source(retptr, ptr0, len0);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        deferred2_0 = r0;
+        deferred2_1 = r1;
+        return getStringFromWasm0(r0, r1);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+        wasm.__wbindgen_export(deferred2_0, deferred2_1, 1);
+    }
+}
+
 /**
  * Initialize the panic hook for better error messages in the browser console.
  */
@@ -149,6 +366,42 @@ export function render_html_from_source(source) {
     }
 }
 
+/**
+ * Render standalone HTML from TDSL source with explicit render options.
+ * Returns Ok(html_string) or Err(error_message).
+ * @param {string} source
+ * @param {JsRenderOptions} opts
+ * @returns {string}
+ */
+export function render_html_from_source_with_options(source, opts) {
+    let deferred4_0;
+    let deferred4_1;
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(source, wasm.__wbindgen_export2, wasm.__wbindgen_export3);
+        const len0 = WASM_VECTOR_LEN;
+        _assertClass(opts, JsRenderOptions);
+        var ptr1 = opts.__destroy_into_raw();
+        wasm.render_html_from_source_with_options(retptr, ptr0, len0, ptr1);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+        var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+        var ptr3 = r0;
+        var len3 = r1;
+        if (r3) {
+            ptr3 = 0; len3 = 0;
+            throw takeObject(r2);
+        }
+        deferred4_0 = ptr3;
+        deferred4_1 = len3;
+        return getStringFromWasm0(ptr3, len3);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+        wasm.__wbindgen_export(deferred4_0, deferred4_1, 1);
+    }
+}
+
 /**
  * Render SVG from TDSL source (static items only).
  * `scale` controls pixels-per-year. Pass `0.0` (or negative) to auto-calculate
@@ -186,9 +439,51 @@ export function render_svg_from_source(source, scale) {
         wasm.__wbindgen_export(deferred3_0, deferred3_1, 1);
     }
 }
+
+/**
+ * Render SVG from TDSL source with explicit render options.
+ *
+ * `scale` controls pixels-per-year. Pass `0.0` (or negative) to auto-calculate.
+ * Returns Ok(svg_string) or Err(error_message).
+ * @param {string} source
+ * @param {number} scale
+ * @param {JsRenderOptions} opts
+ * @returns {string}
+ */
+export function render_svg_from_source_with_options(source, scale, opts) {
+    let deferred4_0;
+    let deferred4_1;
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(source, wasm.__wbindgen_export2, wasm.__wbindgen_export3);
+        const len0 = WASM_VECTOR_LEN;
+        _assertClass(opts, JsRenderOptions);
+        var ptr1 = opts.__destroy_into_raw();
+        wasm.render_svg_from_source_with_options(retptr, ptr0, len0, scale, ptr1);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+        var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+        var ptr3 = r0;
+        var len3 = r1;
+        if (r3) {
+            ptr3 = 0; len3 = 0;
+            throw takeObject(r2);
+        }
+        deferred4_0 = ptr3;
+        deferred4_1 = len3;
+        return getStringFromWasm0(ptr3, len3);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+        wasm.__wbindgen_export(deferred4_0, deferred4_1, 1);
+    }
+}
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
+        __wbg___wbindgen_throw_6b64449b9b9ed33c: function(arg0, arg1) {
+            throw new Error(getStringFromWasm0(arg0, arg1));
+        },
         __wbg_error_a6fa202b58aa1cd3: function(arg0, arg1) {
             let deferred0_0;
             let deferred0_1;
@@ -226,6 +521,10 @@ function __wbg_get_imports() {
     };
 }
 
+const JsRenderOptionsFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_jsrenderoptions_free(ptr >>> 0, 1));
+
 function addHeapObject(obj) {
     if (heap_next === heap.length) heap.push(heap.length + 1);
     const idx = heap_next;
@@ -235,6 +534,12 @@ function addHeapObject(obj) {
     return idx;
 }
 
+function _assertClass(instance, klass) {
+    if (!(instance instanceof klass)) {
+        throw new Error(`expected instance of ${klass.name}`);
+    }
+}
+
 function dropObject(idx) {
     if (idx < 1028) return;
     heap[idx] = heap_next;