Merge pull request #212 from pathsim/feature/url-model-loading

Feature/url model loading

Author: milanofthe

README.md

@@ -428,6 +428,43 @@ PathView uses JSON-based file formats for saving and sharing:
 
 ---
 
+## Sharing Models via URL
+
+Models can be loaded directly from a URL using query parameters:
+
+```
+https://view.pathsim.org/?model=<url>
+https://view.pathsim.org/?modelgh=<github-shorthand>
+```
+
+### Parameters
+
+| Parameter | Description | Example |
+|-----------|-------------|---------|
+| `model` | Direct URL to a `.pvm` or `.json` file | `?model=https://example.com/mymodel.pvm` |
+| `modelgh` | GitHub shorthand (expands to raw.githubusercontent.com) | `?modelgh=user/repo/path/to/model.pvm` |
+
+### GitHub Shorthand
+
+The `modelgh` parameter expands to a raw GitHub URL:
+
+```
+modelgh=user/repo/examples/demo.pvm
+→ https://raw.githubusercontent.com/user/repo/main/examples/demo.pvm
+```
+
+### Examples
+
+```
+# Load from any URL
+https://view.pathsim.org/?model=https://mysite.com/models/feedback.pvm
+
+# Load from GitHub repository
+https://view.pathsim.org/?modelgh=pathsim/pathview/static/examples/feedback-system.json
+```
+
+---
+
 ## Scripts
 
 | Script | Purpose |

package-lock.json

@@ -31,7 +31,12 @@
 from pathsim.blocks import *
 from pathsim.subsystem import Subsystem, Interface
 
-from pathsim_chem.tritium import *
+try:
+    from pathsim_chem.tritium import *
+    HAS_PATHSIM_CHEM = True
+except ImportError:
+    HAS_PATHSIM_CHEM = False
+    print("Warning: pathsim_chem not installed, Chemical blocks will be skipped")
 
 # Block configuration - defines which blocks to extract and their categories
 BLOCK_CONFIG = {
@@ -441,6 +446,10 @@ def main():
     # Extract all blocks
     extracted_blocks = {}
     for category, block_names in BLOCK_CONFIG.items():
+        # Skip Chemical category if pathsim_chem not available
+        if category == "Chemical" and not HAS_PATHSIM_CHEM:
+            print(f"  Skipping {category} category (pathsim_chem not installed)")
+            continue
         for block_name in block_names:
             print(f"  Extracting {block_name}...")
             block_data = extract_block(block_name)
@@ -464,8 +473,11 @@ def main():
 
     print(f"Extracted {len(extracted_blocks)} blocks")
 
+    # Filter config to only include categories that were extracted
+    filtered_config = {k: v for k, v in BLOCK_CONFIG.items() if k != "Chemical" or HAS_PATHSIM_CHEM}
+
     # Generate TypeScript
-    ts_content = generate_typescript(extracted_blocks, BLOCK_CONFIG, UI_OVERRIDES)
+    ts_content = generate_typescript(extracted_blocks, filtered_config, UI_OVERRIDES)
 
     # Write output file
     output_path = (