@jseeio/jsee 0.4.2 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,95 @@
 # Changelog
 
+## 0.8.0
+### Features:
+- Full bundle: new build target `jsee.full.js` that includes Observable Plot, Three.js, and Leaflet for rich output types out of the box. The CLI and Python server auto-select `jsee.full.js` vs `jsee.core.js` based on schema output types. Build with `npm run build-full`
+- Bundle rename: `jsee.runtime.js` → `jsee.core.js`, new `jsee.full.js` (was `jsee.runtime.extended.js`). `dist/jsee.runtime.js` is still produced as a backward-compatible copy of `jsee.core.js`
+- `chart` output type: SVG charts via Observable Plot — supports line, dot, bar, area, and more. Model returns array of objects, column-oriented data `{x: [...], y: [...]}`, or a full Plot config `{marks: [...]}`. Schema props: `mark`, `x`, `y`, `color`, `width`, `height`
+- `3d` output type: 3D model viewer via Three.js — renders programmatic geometry `{vertices, faces}` or GLTF/GLB URLs. Auto-creates scene with lighting and camera
+- `map` output type: interactive maps via Leaflet — supports markers `[{lat, lng, popup}]`, GeoJSON, and `{center, markers, zoom}` objects. Auto-fits bounds. Schema props: `height`, `zoom`, `center`, `tiles`
+- `pdf` output type: browser-native PDF viewer — renders from URL, data URL, Blob, ArrayBuffer, or Uint8Array. Included in the core bundle. Schema prop: `height`
+- Dependency cleanup: remove PDF.js/canvas and Showdown/KaTeX from runtime dependencies; Markdown rendering now uses `markdown-it`
+- `gallery` output type (zero-cost, core bundle): CSS grid of images with click-to-expand lightbox. Model returns array of URLs. Schema props: `columns`, `gap`
+- `highlight` output type (zero-cost, core bundle): colored text spans with label badges. Model returns `[{text, label, color}]` segments
+- `gauge` output type (zero-cost, core bundle): SVG semicircle gauge. Model returns number or `{value, label}`. Schema props: `min`, `max`, `label`, `color`
+- `number` output type (zero-cost, core bundle): large KPI number with optional delta indicator (green up-arrow / red down-arrow). Model returns number or `{value, delta, label}`. Schema props: `label`, `prefix`, `suffix`, `precision`
+- `alert` output type (zero-cost, core bundle): colored status banner with 4 variants (info/success/warning/error). Model returns string or `{message, type}`. Schema prop: `alertType`
+- Graceful degradation: library-dependent output types show a helpful message with link when the library is not loaded, instead of crashing
+- `columnsToRows()` utility for converting column-oriented to row-oriented data
+- Schema-driven theming: `design.primary`, `design.secondary`, `design.bg`, `design.fg`, `design.font`, `design.radius` — set accent colors, background, text, font family, and border radius directly from the schema without custom CSS
+- `jsee init` command: scaffold new projects with `jsee init` (minimal) or `jsee init chat` templates. Node generates `schema.json` + `model.js` + `README.md` (or `--html` for a single `index.html`). Python generates `schema.json` + `model.py` + `README.md`
+- Server-side execution by default: when serving local `.js` models (no `-o` flag), JSEE now auto-enables server-side execution. Use `--client` to force browser execution
+- Serve bar: a top bar shown only when serving (not in `-o` output) with server address, Browser/Server execution toggle, and Save HTML button. Consistent across Node and Python servers. Stripped when saving bundled HTML via Save or `download()`
+- Python `create_app()`: WSGI factory function for production deployment with gunicorn, uWSGI, etc. Same target resolution as `serve()`. Routes: GET /, GET /api, GET /api/openapi.json, GET /static/jsee.js, static files, POST model endpoints
+- CLI data inputs: pass data from the command line as positional args (`jsee schema.json 42 hello`) or named args (`jsee schema.json --a=100`). Values are auto-detected (numbers, JSON, file paths, strings). CLI-set inputs are locked in the GUI. Works in both Node and Python CLIs
+- `folder` input type: directory browser with optional file selection checkboxes. In CLI, reads from a path; in browser, uses `<input webkitdirectory>` or drag-drop. Returns array of file objects. Schema props: `select`, `reactive`
+- File/folder serving: `jsee report.pdf` or `jsee data/` serves files without a schema or model. Auto-detects output type from extension. Folders get a file browser with stats and preview
+- Smart output auto-detection: model results are now type-inferred — image URLs render as `<img>`, PDF URLs as PDF viewer, arrays of objects as tables, etc. Works for both explicit outputs and auto-created outputs
+- No-model identity: schemas with inputs but no model use an identity pipeline (pass inputs to outputs). Useful for file viewing and data inspection
+
+### Breaking changes:
+- Drop `jsee.js` build (Vue template compiler). Only two bundles now: `jsee.core.js` and `jsee.full.js`. The `design.template` schema option is no longer supported — use the default render function instead
+- All HTML files should update `<script src="/dist/jsee.js">` to `<script src="/dist/jsee.core.js">`
+
+## 0.7.1
+### Features:
+- Per-input validation: `validate` (filtrex expression) and `required: true` with `error` message display; invalid inputs show red border + error text and block model execution
+- Textarea autosize: `text` inputs auto-grow to fit content (up to 400px max-height), with manual resize still available
+- `audio` output type: HTML5 `<audio>` player from URL or data URL
+- `video` output type: HTML5 `<video>` player from URL or data URL
+
+## 0.7.0
+### Features:
+- Input persistence: save/restore input values to `localStorage` across page refreshes (priority: URL params > localStorage > defaults; opt-out with `persist: false`; Reset clears storage)
+- Notifications: `schema.notify: true` fires browser `Notification` when a run completes while the tab is hidden (permission requested on init)
+- Streaming outputs (SSE): `model.stream: true` enables Server-Sent Events; POST handler reads `text/event-stream` responses with incremental `output()` calls per `data:` line
+- Python SSE support: generator functions are auto-detected and served as `text/event-stream` with `data: {json}\n\n` framing; `stream=True` kwarg in `generate_schema()`/`serve()`
+- Efficient binary outputs: large base64 image data URLs (>50KB) in `image` outputs are auto-converted to `URL.createObjectURL()` blob URLs (33% memory saving); previous blob URLs are revoked on update
+- Typed array passing for WASM: `arrayBuffer: true` on inputs converts JS arrays to typed arrays (`dtype`: `float32`, `float64`, `uint8`, etc.) before worker/WASM dispatch; uses `postMessage` transferables for zero-copy transfer
+- `collectTransferables()` utility for extracting `ArrayBuffer` references from nested payloads
+
+## 0.6.0
+### Features:
+- Python: richer type introspection — `Literal` → select, `Enum` → select, `Annotated[T, jsee.Slider()]` → slider, `Optional` unwrapping, `datetime.date` → date picker, plus `Text`, `Radio`, `Select`, `MultiSelect`, `Range`, `Color` annotation descriptors
+- Python: `serve()` keyword args — `title`, `description`, `examples`, `reactive`; auto-parses docstring for description
+- Python: result serialization — tuple → list, bytes/PIL Image → base64 data URL, list-of-dicts → `{columns, rows}` table format, per-value serialization in dict results
+- Python: output type declarations — `Annotated[str, jsee.Markdown()]` return types, `outputs` kwarg for `serve()`/`generate_schema()`, auto-detect `list` → table and `bytes` → image; output descriptors: `Markdown`, `Html`, `Code`, `Image`, `Table`, `Svg`, `File`
+- Python: multipart/form-data file upload support in POST handler
+- Node.js: result serialization parity — `serializeResult()` wraps primitives, converts Buffer/Uint8Array to base64 image
+- Node.js: multipart/form-data POST support via `parseMultipart()` (zero new dependencies)
+- Node.js: JSON 404 error for unknown model POST (was falling through to Express HTML 404)
+- Chat interface: new `chat` output type with message accumulation, history injection, Markdown-rendered bubbles, auto-scroll, Enter-to-send; Python `serve(fn, chat=True)` shorthand for `fn(message, history) → str` pattern
+
+## 0.5.2
+### Features:
+- Add `design.layout: 'sidebar'` option — fixed-width (280px) sticky input panel that stays visible while scrolling outputs, collapses to single column on mobile
+- Add server API endpoints: `GET /api` (schema discovery), `GET /api/openapi.json` (auto-generated OpenAPI 3.1 spec), CORS support
+- Fix async model execution in server-side mode (`--execute`)
+- Move Python package into monorepo (`py/`): zero-dependency stdlib server with offline runtime, unified API surface matching Node.js
+
+## 0.5.1
+### Features:
+- Add `style` property to `group` input type: `blocks` (default flat list), `accordion` (collapsible), `tabs` (tabbed view)
+- Add `group` output type with `tabs` and `blocks` display styles for organizing outputs
+- Unnamed top-level input groups now flatten child values into the top-level input object
+### Bug fixes:
+- Fix crash when a top-level input has no `name` (e.g. layout-only group) — `getUrlParam` now guards against undefined names
+
+## 0.5.0
+### Breaking:
+- Remove Bulma dependency — the minimal (framework-free) theme is now the default. `design.framework: 'bulma'` still works as a backward-compatible alias for `'minimal'`. Bundle size reduced by ~50% (224 KB removed)
+### Features:
+- Add new input types: `slider`, `radio`, `toggle`, `date`, `multi-select`, `range` (dual-handle)
+- Add `group` input type with collapsible accordion support (`collapsed: true`)
+- Add `markdown` output type (renders Markdown via showdown, including tables)
+- Add `image` output type (renders `<img>` from data URL or URL)
+- Add `table` output type with virtualized scrolling
+- Add CSS variable theming — all components use `--jsee-*` custom properties, overridable via `design.theme: 'dark'` or custom CSS
+- Add progress bar to loading overlay (determinate and indeterminate modes)
+### Testing:
+- Switch E2E tests from Puppeteer/Jest to Playwright
+- Add E2E tests for all new input/output types, accordion groups, and dark theme
+
 ## 0.4.1
 ### Bug fixes:
 - Fix relative import URLs (e.g. `dist/core.js`) resolving against CDN instead of page URL — now resolves against `window.location.href` so blob workers can load them correctly

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021-2026 Anton Zemlyansky
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.