@bonsae/nrg-runtime 0.22.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-present Allan Oricil
+
+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.

package/README.md

@@ -0,0 +1,24 @@
+<p align="center">
+  <a href="https://www.npmjs.com/package/@bonsae/nrg-runtime"><img src="https://img.shields.io/npm/v/@bonsae/nrg-runtime.svg" alt="npm package"></a>
+</p>
+
+# @bonsae/nrg-runtime
+
+The runtime for Node-RED nodes built with [`@bonsae/nrg`](https://www.npmjs.com/package/@bonsae/nrg) — node base classes, JSON Schema types, the AJV validator, and the editor client runtime. It carries only what a built node needs at runtime (TypeBox, AJV, Vue) and **none** of the build tooling (no Vite/esbuild/TypeScript).
+
+> [!NOTE]
+> You normally don't install this directly. `@bonsae/nrg` depends on it, and a node you build declares `@bonsae/nrg-runtime` (not the toolkit) as its only nrg dependency — so installing a built node pulls just this small runtime, never the authoring toolchain.
+
+## What's inside
+
+- Node base classes (`IONode`, `Node`, `ConfigNode`) and type registration
+- `SchemaType` (TypeBox) schema builders and the AJV validator
+- The editor client runtime (form rendering and validation), served as a static asset
+
+## Versioning
+
+Published lockstep with `@bonsae/nrg` at the same version. While nrg is at `v0`, breaking changes can land in any release without a major bump — pin an exact version and review the [changelog](https://github.com/bonsaedev/nrg/blob/main/CHANGELOG.md) before upgrading.
+
+## License
+
+See [LICENSE](./LICENSE).

package/internal/README.md

@@ -0,0 +1,30 @@
+# `internal/` — test-support surface (not public API)
+
+These modules are **not public API**. They exist so `@bonsae/nrg`'s published
+test utilities (`@bonsae/nrg/test/*`) can reach the framework internals they
+need to exercise a consumer's nodes:
+
+- **`server/`** — Node-side internals (the wiring symbol, context setup,
+  validator init, and internal types) used by the server unit/integration test
+  harness.
+- **`client/`** — the form composables (`index`, kept `.vue`-free) and the real
+  Vue form components (`components`) used by the component test harness.
+
+## Why they ship in the published package
+
+A consumer testing their nodes imports `@bonsae/nrg/test/*`, which at runtime
+imports these from the **installed** `@bonsae/nrg-runtime`. The test harness has
+to operate on the **same** runtime instance the consumer's nodes use — the
+`WIRE_HANDLERS` symbol and `instanceof` checks only hold when both sides share
+one copy. So these can't be bundled into the toolkit; they must be a real,
+importable part of this package. (There's no such thing as a published-but-hidden
+export — anything in `exports` is importable.)
+
+This is the same pattern as `svelte/internal` and `@angular/core/testing`:
+shipped, importable, but not part of the supported API.
+
+## Stability
+
+**No semver guarantees.** Don't import `@bonsae/nrg-runtime/internal/*` directly
+in your own code — use the documented `@bonsae/nrg/test/*` utilities instead.
+These entry points can change in any release.