@cognipilot/rumoca 0.9.4 → 0.9.5

package/README.md

@@ -1,7 +1,7 @@
 # npm Packaging
 
 This directory is the canonical npm entrypoint for Rumoca WASM packaging.
-The build copies this README into each generated `pkg/<profile>-<variant>`
+The build copies this README into each generated `packages/rumoca/dist/<profile>-<variant>`
 package so the published npm package links back to the packaging workflow.
 
 ## Common commands
@@ -16,7 +16,7 @@ npm run build:dev:full-web:rayon
 
 ## Notes
 
-- Shared build logic is implemented in `packaging/npm/build.mjs`.
-- Non-pack builds land in `pkg/<profile>-<variant>[-rayon]` at repo root.
-- Packed tarballs are moved to `pkg/` at repo root.
-- Publishing uses the generated `pkg/*` package metadata and artifacts.
+- Shared build logic is implemented in `packages/rumoca/build.mjs`.
+- Non-pack builds land in `packages/rumoca/dist/<profile>-<variant>[-rayon]`.
+- Packed tarballs are moved to `packages/rumoca/dist/`.
+- Publishing uses the generated `packages/rumoca/dist/*` package metadata and artifacts.

package/modelica_language.js

@@ -0,0 +1,88 @@
+// Shared Modelica language definition for Monaco editors.
+//
+// Used by the full WASM playground (`monaco_setup.js`) and by the mini
+// editors embedded in the mdBook guides (`docs/user-guide/live/rumoca-live.js`).
+// Keep this the single source of truth for Modelica tokenization in Monaco.
+
+export function registerModelicaLanguage(monaco) {
+    if (monaco.languages.getLanguages().some((lang) => lang.id === 'modelica')) {
+        return;
+    }
+    monaco.languages.register({ id: 'modelica' });
+    monaco.languages.setLanguageConfiguration('modelica', {
+        comments: {
+            lineComment: '//',
+            blockComment: ['/*', '*/']
+        },
+        brackets: [
+            ['{', '}'],
+            ['[', ']'],
+            ['(', ')']
+        ],
+        autoClosingPairs: [
+            { open: '{', close: '}' },
+            { open: '[', close: ']' },
+            { open: '(', close: ')' },
+            { open: '"', close: '"', notIn: ['string', 'comment'] }
+        ]
+    });
+    monaco.languages.setMonarchTokensProvider('modelica', {
+        keywords: [
+            'algorithm', 'and', 'annotation', 'assert', 'block', 'break',
+            'class', 'connect', 'connector', 'constant', 'constrainedby',
+            'der', 'discrete', 'each', 'else', 'elseif', 'elsewhen',
+            'encapsulated', 'end', 'enumeration', 'equation', 'expandable',
+            'extends', 'external', 'false', 'final', 'flow', 'for',
+            'function', 'if', 'import', 'impure', 'in', 'initial',
+            'inner', 'input', 'loop', 'model', 'not', 'operator',
+            'or', 'outer', 'output', 'package', 'parameter', 'partial',
+            'protected', 'public', 'pure', 'record', 'redeclare',
+            'replaceable', 'return', 'stream', 'then', 'true', 'type',
+            'when', 'while', 'within'
+        ],
+        types: ['Real', 'Integer', 'Boolean', 'String'],
+        builtins: [
+            // Event/state functions
+            'der', 'pre', 'edge', 'change', 'initial', 'terminal', 'sample',
+            'smooth', 'delay', 'cardinality', 'homotopy', 'semiLinear',
+            'inStream', 'actualStream', 'getInstanceName', 'spatialDistribution',
+            'reinit', 'assert', 'terminate',
+            // Math functions
+            'abs', 'sign', 'sqrt', 'sin', 'cos', 'tan', 'asin', 'acos', 'atan', 'atan2',
+            'sinh', 'cosh', 'tanh', 'exp', 'log', 'log10',
+            'floor', 'ceil', 'mod', 'rem', 'div', 'integer',
+            // Array functions
+            'size', 'ndims', 'scalar', 'vector', 'matrix', 'transpose',
+            'outerProduct', 'symmetric', 'cross', 'skew', 'identity', 'diagonal',
+            'zeros', 'ones', 'fill', 'linspace', 'min', 'max', 'sum', 'product', 'cat',
+            // Builtin variables/special names frequently used in expressions
+            'time', 'noEvent', 'Connections'
+        ],
+        tokenizer: {
+            root: [
+                [/[a-zA-Z_]\w*/, {
+                    cases: {
+                        '@keywords': 'keyword',
+                        '@types': 'type',
+                        '@builtins': 'predefined',
+                        '@default': 'identifier'
+                    }
+                }],
+                [/[{}()\[\]]/, 'delimiter.bracket'],
+                [/[;,.]/, 'delimiter'],
+                // Comments must be matched before '/' operator tokens.
+                [/\/\/.*$/, 'comment'],
+                [/\/\*/, 'comment', '@comment'],
+                [/[<>=!]+/, 'operator'],
+                [/[+\-*\/^:]/, 'operator'],
+                [/\d+\.?\d*([eE][-+]?\d+)?/, 'number'],
+                [/"([^"\\]|\\.)*"/, 'string'],
+            ],
+            comment: [
+                [/[^/*]+/, 'comment'],
+                [/\*\//, 'comment', '@pop'],
+                [/[/*]/, 'comment']
+            ],
+        }
+    });
+}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@cognipilot/rumoca",
   "type": "module",
   "description": "WebAssembly bindings for Rumoca compile and optional simulation surfaces",
-  "version": "0.9.4",
+  "version": "0.9.5",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -13,12 +13,15 @@
     "rumoca_bind_wasm.js",
     "rumoca_bind_wasm.d.ts",
     "rumoca_gpu.js",
+    "rumoca_interactive.js",
     "rumoca_diffsol.js",
     "rumoca_bind_wasm_diffsol.js",
     "rumoca_bind_wasm_diffsol_bg.wasm",
     "rumoca_bind_wasm_diffsol.d.ts",
     "rumoca_worker.js",
     "parse_worker.js",
+    "rumoca_runtime.js",
+    "modelica_language.js",
     "rumoca_package_meta.json",
     "README.md"
   ],
@@ -39,6 +42,9 @@
     "./gpu": {
       "import": "./rumoca_gpu.js"
     },
+    "./interactive": {
+      "import": "./rumoca_interactive.js"
+    },
     "./diffsol": {
       "import": "./rumoca_diffsol.js"
     }

package/parse_worker.js

@@ -39,8 +39,7 @@ self.onmessage = async (e) => {
             const ast = parse_source_root_file(source, filename);
             results.push([filename, ast]);
         } catch (e) {
-            // Skip files that fail to parse
-            console.warn(`[ParseWorker] Failed to parse ${filename}:`, e.message);
+            // Skip files that fail to parse; live diagnostics surface user-facing errors.
         }
 
         // Report progress every 10 files

package/rumoca_bind_wasm.d.ts

@@ -1,6 +1,57 @@
 /* tslint:disable */
 /* eslint-disable */
 
+/**
+ * Opaque handle to a real-time simulation stepper running in WASM.
+ *
+ * Compiles a Modelica model and creates an interactive stepper that can be
+ * driven from JavaScript via `requestAnimationFrame`.
+ */
+export class WasmStepper {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Read a single variable value by name.
+     */
+    get(name: string): number | undefined;
+    /**
+     * Get available input names as a JSON array string.
+     */
+    input_names(): string;
+    /**
+     * Compile a Modelica model and create a stepper ready for interactive stepping.
+     *
+     * `source` is the full Modelica source text and `model_name` is the class
+     * to simulate. The stepper backend is chosen by the compiled package and
+     * model experiment metadata, not by the batch simulation solver selector.
+     */
+    constructor(source: string, model_name: string);
+    /**
+     * Reset the simulation to initial conditions.
+     */
+    reset(): void;
+    /**
+     * Set an input value by name. Takes effect on the next `step()` call.
+     */
+    set_input(name: string, value: number): void;
+    /**
+     * Get all current variable values as a JSON string `{"time": t, "values": {...}}`.
+     */
+    state_json(): string;
+    /**
+     * Step the simulation forward by `dt` seconds.
+     */
+    step(dt: number): void;
+    /**
+     * Get the current simulation time.
+     */
+    time(): number;
+    /**
+     * Get all solver variable names as a JSON array string.
+     */
+    variable_names(): string;
+}
+
 /**
  * Check Modelica source code and return all diagnostics.
  */
@@ -28,8 +79,6 @@ export function compile_check_with_source_roots_with_options(source: string, mod
  */
 export function compile_to_json(source: string, model_name: string): string;
 
-export function compile_with_project_sources(source: string, model_name: string, project_sources_json: string): string;
-
 export function compile_with_source_roots(source: string, model_name: string, source_roots_json: string): string;
 
 /**
@@ -42,6 +91,8 @@ export function compile_with_source_roots(source: string, model_name: string, so
  */
 export function compile_with_source_roots_with_options(source: string, model_name: string, source_roots_json: string, compile_options_json: string): string;
 
+export function compile_with_workspace_sources(source: string, model_name: string, workspace_sources_json: string): string;
+
 export function export_parsed_source_roots_binary(uris_json: string): Uint8Array;
 
 /**
@@ -104,7 +155,7 @@ export function load_source_roots(source_roots_json: string): string;
  * diffsol addon (`@cognipilot/rumoca/diffsol`) to simulate. Lets the stiff
  * solver run without putting relaxed-SIMD in this (universal) module.
  */
-export function lower_model_to_solve_json(source: string, model_name: string, t_end: number, dt: number): string;
+export function lower_model_to_solve_json(source: string, model_name: string, t_end: number, dt: number, parameter_overrides_json: string): string;
 
 /**
  * Get code actions (quick fixes) for diagnostics in a selected range.
@@ -155,6 +206,21 @@ export function merge_parsed_source_roots(definitions_json: string): number;
 
 export function merge_parsed_source_roots_binary(bytes: Uint8Array): number;
 
+/**
+ * Compile a model and return tunable scalar parameter metadata as JSON.
+ */
+export function model_parameter_metadata(source: string, model_name: string): string;
+
+/**
+ * Compile with additional source-root libraries and return parameter metadata.
+ */
+export function model_parameter_metadata_with_source_roots(source: string, model_name: string, source_roots_json: string): string;
+
+/**
+ * Compile with additional workspace-local sources and return parameter metadata.
+ */
+export function model_parameter_metadata_with_workspace_sources(source: string, model_name: string, workspace_sources_json: string): string;
+
 /**
  * Parse Modelica source code and return whether it's valid.
  */
@@ -186,19 +252,98 @@ export function parse_source_root_file(source: string, filename: string): string
  */
 export function prepare_gpu_simulation(source: string, model_name: string): string;
 
+export function prime_source_root_completion_cache(): number;
+
 export function render_target(dae_json: string, model_name: string, target: string, manifest_source: string, templates_json: string): any;
 
+/**
+ * Default colocated `rumoca-scenario.<model>.toml` (`{ ok, path, content }`)
+ * for a create-config action on a Modelica model.
+ */
+export function scenario_default_scenario_config(workspace_sources_json: string, model: string, task: string): string;
+
+/**
+ * Configured `[codegen]` target settings for a model (`{ target, outputDir }`).
+ */
+export function scenario_get_codegen_config(workspace_sources_json: string, model: string): string;
+
+/**
+ * Parse a single `rumoca-scenario.toml` scenario file (by workspace path) into the editor's
+ * scenario descriptor (`task`, `model`, `viewerMode`, interactive ports, ...).
+ */
+export function scenario_get_scenario_config(workspace_sources_json: string, path: string): string;
+
+/**
+ * Full `rumoca-scenario.toml` scenario as a JSON tree for the config GUI:
+ * `{ ok, config: <toml-as-json>, descriptor }`. The `config` tree round-trips
+ * every section (including nested interactive-IO) losslessly.
+ */
+export function scenario_get_scenario_config_full(workspace_sources_json: string, path: string): string;
+
+/**
+ * Effective + preset + default simulation settings for a model, given the
+ * workspace's `rumoca-scenario.toml` files and an optional editor `fallback` settings JSON.
+ */
+export function scenario_get_simulation_config(workspace_sources_json: string, model: string, fallback_json: string): string;
+
+/**
+ * Scenario-local source roots configured for a model (`{ sourceRootPaths }`).
+ */
+export function scenario_get_source_roots(workspace_sources_json: string, model: string, task: string): string;
+
+/**
+ * Configured plot/visualization views for a model (`{ views: [...] }`).
+ */
+export function scenario_get_visualization_config(workspace_sources_json: string, model: string): string;
+
+/**
+ * Clear a model's simulation preset. Returns `{ writes, result }`.
+ */
+export function scenario_reset_simulation_preset(workspace_sources_json: string, model: string): string;
+
+/**
+ * Write a model's `[codegen]` target settings. Returns `{ writes, result }`.
+ */
+export function scenario_set_codegen_config(workspace_sources_json: string, model: string, codegen_json: string): string;
+
+/**
+ * Render a `rumoca-scenario.toml` from the config GUI's JSON tree. Returns
+ * `{ writes: [{path, content}], result }` for the editor to apply.
+ */
+export function scenario_set_scenario_config(path: string, config_json: string): string;
+
+/**
+ * Write a model's simulation preset into its colocated `rum.<model>.toml`.
+ * Returns `{ writes, result }` for the editor to apply to its workspace store.
+ */
+export function scenario_set_simulation_preset(workspace_sources_json: string, model: string, preset_json: string): string;
+
+/**
+ * Write a model's scenario-local source roots. Returns `{ writes, result }`.
+ */
+export function scenario_set_source_roots(workspace_sources_json: string, model: string, source_roots_json: string): string;
+
+/**
+ * Write a model's plot/visualization views. Returns `{ writes, result }`.
+ */
+export function scenario_set_visualization_config(workspace_sources_json: string, model: string, views_json: string): string;
+
 /**
  * Compile and simulate a Modelica model.
  */
-export function simulate_model(source: string, model_name: string, t_end: number, dt: number, solver: string): string;
+export function simulate_model(source: string, model_name: string, t_end: number, dt: number, solver: string, parameter_overrides_json: string): string;
 
 /**
- * Compile with additional project-local sources and simulate a Modelica model.
+ * Compile with additional source-root libraries and simulate a Modelica model.
  */
-export function simulate_model_with_project_sources(source: string, model_name: string, project_sources_json: string, t_end: number, dt: number, solver: string): string;
+export function simulate_model_with_source_roots(source: string, model_name: string, source_roots_json: string, t_end: number, dt: number, solver: string, parameter_overrides_json: string): string;
 
-export function sync_project_sources(project_sources_json: string): string;
+/**
+ * Compile with additional workspace-local sources and simulate a Modelica model.
+ */
+export function simulate_model_with_workspace_sources(source: string, model_name: string, workspace_sources_json: string, t_end: number, dt: number, solver: string, parameter_overrides_json: string): string;
+
+export function sync_workspace_sources(workspace_sources_json: string): string;
 
 /**
  * Re-settle the prepared vectors of the last `prepare_gpu_simulation` for
@@ -213,18 +358,21 @@ export function update_gpu_parameters(source: string, model_name: string, overri
  */
 export function wasm_init(_num_threads: number): boolean;
 
+export function workspace_effective_source_roots(workspace_sources_json: string, focus_path: string): string;
+
 export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
 
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
+    readonly __wbg_wasmstepper_free: (a: number, b: number) => void;
     readonly check: (a: number, b: number) => any;
     readonly compile: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly compile_check_with_source_roots: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
     readonly compile_check_with_source_roots_with_options: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
     readonly compile_to_json: (a: number, b: number, c: number, d: number) => [number, number, number, number];
-    readonly compile_with_project_sources: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
     readonly compile_with_source_roots: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
     readonly compile_with_source_roots_with_options: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
+    readonly compile_with_workspace_sources: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
     readonly export_parsed_source_roots_binary: (a: number, b: number) => [number, number, number, number];
     readonly get_build_time_utc: () => [number, number];
     readonly get_builtin_targets: () => any;
@@ -239,7 +387,7 @@ export interface InitOutput {
     readonly list_classes: () => [number, number, number, number];
     readonly load_bundled_source_root_cache: (a: number, b: number) => [number, number, number];
     readonly load_source_roots: (a: number, b: number) => [number, number, number, number];
-    readonly lower_model_to_solve_json: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+    readonly lower_model_to_solve_json: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
     readonly lsp_code_actions: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
     readonly lsp_completion: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly lsp_completion_with_timing: (a: number, b: number, c: number, d: number) => [number, number, number, number];
@@ -251,15 +399,43 @@ export interface InitOutput {
     readonly lsp_semantic_tokens: (a: number, b: number) => [number, number, number, number];
     readonly merge_parsed_source_roots: (a: number, b: number) => [number, number, number];
     readonly merge_parsed_source_roots_binary: (a: number, b: number) => [number, number, number];
+    readonly model_parameter_metadata: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly model_parameter_metadata_with_source_roots: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+    readonly model_parameter_metadata_with_workspace_sources: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
     readonly parse: (a: number, b: number) => any;
     readonly parse_source_root_file: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly prepare_gpu_simulation: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly prime_source_root_completion_cache: () => [number, number, number];
     readonly render_target: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number, number];
-    readonly simulate_model: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
-    readonly simulate_model_with_project_sources: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number, number, number];
-    readonly sync_project_sources: (a: number, b: number) => [number, number, number, number];
+    readonly scenario_default_scenario_config: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+    readonly scenario_get_codegen_config: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly scenario_get_scenario_config: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly scenario_get_scenario_config_full: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly scenario_get_simulation_config: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+    readonly scenario_get_source_roots: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+    readonly scenario_get_visualization_config: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly scenario_reset_simulation_preset: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly scenario_set_codegen_config: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+    readonly scenario_set_scenario_config: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly scenario_set_simulation_preset: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+    readonly scenario_set_source_roots: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+    readonly scenario_set_visualization_config: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+    readonly simulate_model: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number, number, number];
+    readonly simulate_model_with_source_roots: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number) => [number, number, number, number];
+    readonly simulate_model_with_workspace_sources: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number) => [number, number, number, number];
+    readonly sync_workspace_sources: (a: number, b: number) => [number, number, number, number];
     readonly update_gpu_parameters: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
     readonly wasm_init: (a: number) => number;
+    readonly wasmstepper_get: (a: number, b: number, c: number) => [number, number];
+    readonly wasmstepper_input_names: (a: number) => [number, number];
+    readonly wasmstepper_new: (a: number, b: number, c: number, d: number) => [number, number, number];
+    readonly wasmstepper_reset: (a: number) => [number, number];
+    readonly wasmstepper_set_input: (a: number, b: number, c: number, d: number) => [number, number];
+    readonly wasmstepper_state_json: (a: number) => [number, number];
+    readonly wasmstepper_step: (a: number, b: number) => [number, number];
+    readonly wasmstepper_time: (a: number) => number;
+    readonly wasmstepper_variable_names: (a: number) => [number, number];
+    readonly workspace_effective_source_roots: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly init: () => void;
     readonly clear_source_root_cache: () => void;
     readonly __wbindgen_malloc: (a: number, b: number) => number;