hyperprop-charting-library 0.1.132 → 0.1.134

package/docs/API.md

@@ -607,3 +607,18 @@ Script contract:
 Errors never break the chart: compile or runtime errors render as an inline red message in the
 pane. Scripts are plain JavaScript executed in the page context — treat them like any other code
 you'd paste into your app (only run scripts you trust).
+
+### Execution budget
+
+Loop conditions are instrumented at compile time, and each `compute()` invocation gets a
+1000 ms wall-clock budget. A script that exceeds it (e.g. `while (true) {}`) throws
+`"Script exceeded the 1000ms execution budget"`, which renders as the usual inline pane error
+instead of freezing the tab. After a budget trip the script is circuit-broken — it is not run
+again for that compiled instance, so live ticks don't re-trigger the stall. Recompiling (editing
+the source and calling `compileScriptIndicator` again) resets the breaker. String/template/comment
+contents are never instrumented; `for...of` / `for...in` loops are left untouched.
+
+`validateScriptSource(source: string): string | null` — compile-checks a script without
+registering it, returning an error message or `null`. It runs under the same execution budget, so
+validating a script with a top-level infinite loop returns a budget error instead of hanging the
+caller. Use this for editor save-validation instead of running `new Function` yourself.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hyperprop-charting-library",
-  "version": "0.1.132",
+  "version": "0.1.134",
   "description": "Lightweight TypeScript charting core",
   "type": "module",
   "main": "./dist/hyperprop-charting-library.cjs",