@keroway/tdsl-wasm 1.19.0 → 1.21.0

package/README.md

@@ -54,6 +54,45 @@ const diagnostics = JSON.parse(check_source(source));
 const formatted = format_source(source);
 ```
 
+### Render options (`JsRenderOptions`)
+
+For finer control over the output, use the `*_with_options` entry points with a
+`JsRenderOptions` instance:
+
+```js
+import init, {
+  JsRenderOptions,
+  render_svg_from_source_with_options,
+} from "@keroway/tdsl-wasm";
+
+await init();
+
+const opts = new JsRenderOptions();
+opts.orientation = "vertical"; // "horizontal" (default) | "vertical"
+opts.grid = "decade"; // "none" (default) | "decade" | "year" | "month"
+opts.theme = "dark"; // "default" | "dark" | "print" | "pastel"
+opts.show_table = true;
+opts.show_event_labels = true;
+opts.lane_height = 96; // px per lane; 0 (default) = renderer default (60)
+
+// scale = pixels-per-year; pass 0 for auto.
+const svg = render_svg_from_source_with_options(source, 0, opts);
+```
+
+`lane_height` controls vertical density. Increasing it makes the SVG taller and
+proportionally thickens each lane band, bar, and intra-lane padding — useful for
+timelines with few lanes but many overlapping spans. Leave it at `0` to keep the
+default appearance.
+
+| 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` |
+| `lane_height` | px per lane; `0` = renderer default (60) | `0` |
+
 ## API
 
 | Function | Signature | Description |
@@ -61,7 +100,9 @@ const formatted = format_source(source);
 | `init(module_or_path?)` | `(…) => Promise<InitOutput>` | Default export. Loads the `.wasm` binary. Must be awaited before any call. |
 | `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_svg_from_source_with_options` | `(source: string, scale: number, opts: JsRenderOptions) => string` | Render SVG with explicit options (orientation, grid, theme, table, event labels, `lane_height`). |
 | `render_html_from_source` | `(source: string) => string` | Render a standalone HTML document. |
+| `render_html_from_source_with_options` | `(source: string, opts: JsRenderOptions) => string` | Render a standalone HTML document with explicit options. |
 | `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. |
 

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

package/tdsl_wasm.d.ts

@@ -15,11 +15,21 @@
  * | `theme` | `"default"`, `"dark"`, `"print"`, `"pastel"` | `"default"` |
  * | `show_table` | `true`, `false` | `false` |
  * | `show_event_labels` | `true`, `false` | `false` |
+ * | `lane_height` | px per lane; `0` = renderer default (60) | `0` |
+ *
+ * `lane_height` controls vertical density: the SVG height, each lane band, the
+ * bar thickness and intra-lane padding all follow it. Leave it at `0` (the
+ * default) to keep the historical appearance.
  */
 export class JsRenderOptions {
     free(): void;
     [Symbol.dispose](): void;
     constructor();
+    /**
+     * Height of each lane in pixels. `0` (default) uses the renderer default (60).
+     * Larger values increase vertical density (taller bands and thicker bars).
+     */
+    lane_height: number;
     /**
      * When true, labels are rendered next to Event/EventRange items.
      */
@@ -133,9 +143,11 @@ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembl
 
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
+    readonly __wbg_get_jsrenderoptions_lane_height: (a: number) => number;
     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_lane_height: (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;

package/tdsl_wasm.js

@@ -14,6 +14,11 @@
  * | `theme` | `"default"`, `"dark"`, `"print"`, `"pastel"` | `"default"` |
  * | `show_table` | `true`, `false` | `false` |
  * | `show_event_labels` | `true`, `false` | `false` |
+ * | `lane_height` | px per lane; `0` = renderer default (60) | `0` |
+ *
+ * `lane_height` controls vertical density: the SVG height, each lane band, the
+ * bar thickness and intra-lane padding all follow it. Leave it at `0` (the
+ * default) to keep the historical appearance.
  */
 export class JsRenderOptions {
     __destroy_into_raw() {
@@ -26,6 +31,15 @@ export class JsRenderOptions {
         const ptr = this.__destroy_into_raw();
         wasm.__wbg_jsrenderoptions_free(ptr, 0);
     }
+    /**
+     * Height of each lane in pixels. `0` (default) uses the renderer default (60).
+     * Larger values increase vertical density (taller bands and thicker bars).
+     * @returns {number}
+     */
+    get lane_height() {
+        const ret = wasm.__wbg_get_jsrenderoptions_lane_height(this.__wbg_ptr);
+        return ret;
+    }
     /**
      * When true, labels are rendered next to Event/EventRange items.
      * @returns {boolean}
@@ -129,6 +143,14 @@ export class JsRenderOptions {
             wasm.__wbindgen_export(deferred1_0, deferred1_1, 1);
         }
     }
+    /**
+     * Height of each lane in pixels. `0` (default) uses the renderer default (60).
+     * Larger values increase vertical density (taller bands and thicker bars).
+     * @param {number} arg0
+     */
+    set lane_height(arg0) {
+        wasm.__wbg_set_jsrenderoptions_lane_height(this.__wbg_ptr, arg0);
+    }
     /**
      * When true, labels are rendered next to Event/EventRange items.
      * @param {boolean} arg0