@xanots/xanoscript 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Xano, Inc.
+
+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,69 @@
+# @xanots/xanoscript
+
+Renders a [XanoTS](https://github.com/xanots/sdk) workspace to **XanoScript** —
+the language the Xano engine actually runs.
+
+> **Status: private, pre-release.** The plugin entry, the published docs and the
+> npm release land in later units of the extraction. Today this repo is the
+> emitter, its vendored engine data, its tooling and its corpus.
+
+## What it is
+
+The emitter is a **file-for-file port of the Xano engine's own JSON → XanoScript
+encoder**, pinned to one engine commit. Its contract is not "looks right" — it is
+**byte equality with the engine**, proven against 1,280 of the engine's own
+golden fixtures on every run.
+
+That is what makes a committed `xanoscript/` tree worth reading: a backend change
+shows up in review as the XanoScript the engine will run, one file per object,
+beside the TypeScript that produced it.
+
+## Quick start (maintainers)
+
+```bash
+npm install
+npx vitest run            # the full suite, corpus included
+npm run xs:report         # the corpus, as pass/fail counts grouped by reason
+npm run typecheck
+npm run lint
+```
+
+`npm run xs:report` should print **1279 passed, 1 failed** — that one failure is
+a documented corpus artifact, recorded with its reason in
+`test/corpus-known-failures.json`.
+
+## Layout
+
+| Path | What it is |
+|---|---|
+| `src/index.ts` | the emitter entry (`emitXanoScript`, `createScriptContext`) |
+| `src/engine/` | the encoder core — parsers, kinds, values, coercion semantics |
+| `src/transform/` | one class per statement kind |
+| `src/multidoc.ts` | workspace → multidoc assembly |
+| `src/tree.ts` | multidoc → one-file-per-object placement |
+| `src/writer.ts` | the committed `xanoscript/` tree: write, check, README, placeholders |
+| `src/render-def.ts` | one def rendered alone — the only file needing the `@xanots/sdk` peer |
+| `src/diff.ts` | document-aware comparison of two multidocs |
+| `vendor/xs-engine/` | generated engine data and the commit lock (never hand-edited) |
+| `scripts/xs-engine/` | the drift loop — vendor, sync, drift, report |
+
+## The emitter takes no peer
+
+Everything under `src/` imports nothing from `@xanots/sdk` except
+`render-def.ts`. The `.` entry builds and its suite passes with the peer absent,
+and `test/peer-free.test.ts` asserts it. That isolation is why this package can
+follow the engine's release cadence instead of the SDK's.
+
+## Contributing
+
+Read `AGENTS.md` in the repository first — **especially the disclosure block at
+the top**. It carries the drift loop, the porting order, the coercion-semantics
+rule, and the redaction procedure for a credential found in the corpus.
+
+`AGENTS.md` is deliberately NOT in the published tarball: it describes the
+engine's internal layout, which belongs in the repository and not on a public
+registry. See the disclosure block for what that constrains.
+
+## License
+
+MIT