@jseeio/jsee 0.8.2 → 0.8.8

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.8.8 - 2026-05-25
+
+- Applied app package `browser` field aliases during CLI dependency bundling so installed JSEE app packages can bundle legacy browser dependencies reliably.
+
+## 0.8.7
+### Features:
+- Add `jsee --run` for one-shot CLI execution of local JavaScript JSEE apps. Default output is pipeable stdout; `--outputs <dir>` writes all outputs into a directory; named output flags such as `--file out.csv` write individual outputs.
+- Allow raw camelCase schema input names on the CLI, so inputs such as `nSamples` work with both `--nSamples` and sanitized `--nsamples`.
+
+### Fixes:
+- Keep `runPackage(..., ['--run', ...])` output paths relative to the caller working directory instead of the package root.
+
 ## 0.8.1
 ### Fixes:
 - Fix `jsee init` JavaScript templates so generated minimal and chat apps accept the default object payload in both browser and server-side execution modes.

package/README.md

@@ -34,7 +34,7 @@ Smallest browser example:
 <script src="https://cdn.jsdelivr.net/npm/@jseeio/jsee@latest/dist/jsee.core.js"></script>
 ```
 
-Pin a version for production, for example `@jseeio/jsee@0.8.1`.
+Pin a version for production, for example `@jseeio/jsee@0.8.8`.
 
 **npm CLI/dev server:**
 
@@ -509,7 +509,7 @@ JSEE is part of the [StatSim](https://statsim.com) ecosystem. The schema/runtime
 ## CLI — Node.js
 
 ```
-jsee [schema.json] [data...] [options]
+jsee [schema.json|package] [data...] [options]
 jsee init [template] [--html]
 ```
 
@@ -525,16 +525,24 @@ jsee init chat              # chat template
 jsee init --html            # single index.html with CDN script
 ```
 
-#### `jsee <schema> [data...]`
+#### `jsee <schema|package> [data...]`
 
-Start a dev server or generate a static HTML file from a schema.
+Start a dev server or generate a static HTML file from a local schema or a JSEE app package. Package inputs resolve the package `jsee` field, for example `{ "jsee": "schema.json" }`, and use the package directory as the app root. If the app package is not installed locally, let npm provide both packages with `npx -p @jseeio/jsee -p <package> jsee <package> --serve`.
 
 ```bash
-jsee schema.json                    # dev server on port 3000
-jsee schema.json -o app.html        # generate static HTML
-jsee schema.json -o app.html --bundle  # self-contained HTML with bundled runtime
+jsee schema.json                       # dev server on port 3000
+jsee @statsim/gen --serve              # serve a resolvable JSEE app package
+jsee schema.json -o app.html           # generate static HTML
+jsee @statsim/gen -o app.html --bundle # bundled HTML from package app
+jsee @statsim/gen --run --dataset Moons --nSamples 500
+jsee @statsim/gen --run --dataset Moons --file moons.csv
+npx -p @jseeio/jsee -p @statsim/gen jsee @statsim/gen --serve
 ```
 
+JSEE app packages can also expose their own bin with `require('@jseeio/jsee').runPackage(__dirname, process.argv.slice(2))`. The helper reads the package `jsee` field, uses the package root as the app root, and forwards ordinary JSEE CLI options.
+
+Use `--run` for one-shot CLI execution. With no output target, JSEE writes a pipeable stdout stream: a single `file` output writes its file content, a single text/table/object output writes that value, and multiple outputs write a JSON object. In `--run` mode, `--outputs <dir>` writes all outputs into a directory, while an output-name flag such as `--file moons.csv` or `--output-file moons.csv` writes one named output to a specific path.
+
 ### Options
 
 | Flag | Description |
@@ -546,6 +554,8 @@ jsee schema.json -o app.html --bundle  # self-contained HTML with bundled runtim
 | `-v, --version <version>` | JSEE runtime version (`latest`, `dev`, or semver) |
 | `-b, --bundle` | Bundle runtime + all deps into a single offline HTML |
 | `-f, --fetch` | Backward-compatible alias for `--bundle` |
+| `-s, --serve` | Serve explicitly (default when no output is provided) |
+| `--run` | Execute the model once from the CLI and write pipeable outputs |
 | `-e, --execute` | Run models server-side (auto-enabled when serving local .js models) |
 | `--client` | Force client-side execution (disable auto server-side) |
 | `-c, --cdn <url\|bool>` | Rewrite model URLs for CDN deployment |