ranty-js 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ranty.js contributors
+
+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,235 @@
+[![NPM](https://img.shields.io/npm/dy/ranty-js)](https://www.npmjs.com/package/ranty-js)
+
+# Ranty.js
+
+Ranty.js is the TypeScript port of
+[Ranty](https://github.com/insanityfarm/ranty), a procedural templating
+language and runtime for generating text and structured values.
+
+This repository is intentionally downstream of the Rust implementation. Shared
+language, runtime, module, stdlib, and CLI behavior is authored upstream first,
+then ported here against the checked-in parity contract under
+[`./upstream/ranty/`](./upstream/ranty/).
+
+## Documentation
+
+- Shared Ranty reference: <https://insanityfarm.github.io/ranty/>
+- Local JS-specific reference: this README
+
+## How To Use The Ranty Docs From Ranty.js
+
+Use the hosted Ranty reference for:
+
+- language syntax
+- standard-library behavior
+- module semantics
+- runtime concepts
+- CLI semantics that are shared across Rust and JS
+
+Use this README for:
+
+- package installation and runtime targets
+- Node.js and browser embedding
+- the public JS host API
+- the `ranty-js` CLI package and entrypoint
+- JS-specific differences from the Rust embedding surface
+
+When the hosted docs talk about embedding Ranty in Rust, keep the shared
+language and runtime concepts, but ignore the Rust API details. The equivalent
+JS host surface is documented below.
+
+## Runtime Targets
+
+- Node.js `>=22.0.0` for library or CLI usage
+- browsers with ES2022 and `BigInt` support
+- package name: `ranty-js`
+- CLI command: `ranty-js`
+- browser bundle: `dist/ranty.js`
+- browser namespace: `globalThis.Ranty`
+
+## Install
+
+```bash
+npm install ranty-js
+```
+
+For contributors working in this repository:
+
+```bash
+npm install
+npm run context:build
+npm run verify
+```
+
+## Node Library Use
+
+```ts
+import { Ranty } from "ranty-js";
+
+const ranty = new Ranty({ seed: 0xdeadbeefn });
+const program = ranty.compileQuiet(`
+[$greet:name] {
+  {Hello|Hi|Hey}, <name>!
+}
+[greet:world]
+`);
+
+console.log(ranty.run(program));
+```
+
+The `Ranty` constructor accepts a partial `RantyOptions` object. The main
+options are:
+
+| Option                   | Meaning                                                                                          |
+| ------------------------ | ------------------------------------------------------------------------------------------------ |
+| `useStdlib`              | Load the built-in globals. Disable it to supply a narrower custom prelude.                       |
+| `debugMode`              | Emit richer compiler metadata and runtime diagnostics.                                           |
+| `topLevelDefsAreGlobals` | Keep top-level definitions after a run, which is useful for REPL-like hosts.                     |
+| `seed`                   | Set the initial RNG seed as a `number` or `bigint`.                                              |
+| `gcAllocationThreshold`  | Reserved parity option; present on the JS API, but manual GC control does not currently do work. |
+
+Useful host-side entrypoints include:
+
+- `compileQuiet()`, `compileNamed()`, `compileFileQuiet()`
+- `run()` and `runWith()`
+- `setGlobalConst()` and `setGlobal()`
+- `usingModuleResolver()`
+- `addDataSource()` and `clearDataSources()`
+- `Ranty.createVirtualModules()`
+
+## Browser Use
+
+Ranty.js ships a UMD bundle. In browsers, the exported symbols live under the
+`globalThis.Ranty` namespace object.
+
+```html
+<script src="./node_modules/ranty-js/dist/ranty.js"></script>
+<script>
+  const { Ranty, VirtualModuleResolver } = globalThis.Ranty;
+
+  const ranty = new Ranty().usingModuleResolver(
+    new VirtualModuleResolver({
+      "mods/greetings.ranty": '<%module = (:: hello = "browser world")><module>'
+    })
+  );
+
+  const program = ranty.compileQuiet(
+    '@require "mods/greetings"[greetings/hello]'
+  );
+
+  console.log(ranty.run(program));
+</script>
+```
+
+Browser `@require` is synchronous. The runtime does not fetch modules over the
+network, walk the filesystem, or infer module contents from URLs. Provide
+modules up front through `VirtualModuleResolver` or another host-controlled
+resolver.
+
+## CLI Use
+
+The published CLI command is `ranty-js`.
+
+```bash
+npx ranty-js --eval '"hello from ranty-js"'
+npx ranty-js --seed deadbeef --eval '[rand:1;6]'
+npx ranty-js ./example.ranty
+printf '"from stdin"' | npx ranty-js
+```
+
+The Node CLI chooses its launch mode in this order:
+
+1. `--eval PROGRAM`
+2. `FILE`
+3. piped stdin
+4. REPL
+
+Supported flags:
+
+| Flag                   | Meaning                                                                     |
+| ---------------------- | --------------------------------------------------------------------------- |
+| `-e`, `--eval PROGRAM` | Run an inline program string.                                               |
+| `-s`, `--seed SEED`    | Set the initial RNG seed as 1 to 16 hexadecimal digits, with optional `0x`. |
+| `-b`, `--bench-mode`   | Print compile and execution timing to stderr.                               |
+| `-W`, `--no-warnings`  | Suppress compiler warnings.                                                 |
+| `-D`, `--no-debug`     | Disable debug symbol emission during compilation.                           |
+| `-h`, `--help`         | Show CLI help.                                                              |
+| `-V`, `--version`      | Show the build version.                                                     |
+
+Exit codes:
+
+| Code | Meaning                                    |
+| ---- | ------------------------------------------ |
+| `0`  | Success                                    |
+| `64` | Invalid CLI usage, such as an invalid seed |
+| `65` | Compilation failed                         |
+| `66` | Input file not found                       |
+| `70` | Runtime execution failed                   |
+
+## Host Integration Example
+
+```ts
+import { Ranty } from "ranty-js";
+import type { DataSource } from "ranty-js";
+
+const buildInfo: DataSource = {
+  typeId() {
+    return "build-info";
+  },
+
+  requestData(args) {
+    const channel = String(args[0] ?? "dev");
+    return `channel:${channel}`;
+  }
+};
+
+const ranty = new Ranty();
+ranty.addDataSource(buildInfo);
+
+console.log(
+  ranty.run(ranty.compileQuiet('[ds-request:"build-info";"stable"]'))
+);
+```
+
+Scripts access registered data sources through `[ds-request: ...]` and can
+enumerate them through `[ds-query-sources]`.
+
+## JS-Specific Differences
+
+| Topic                     | Ranty.js behavior                                                                                                                                                                                                                              |
+| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Package and command names | The npm package is `ranty-js`, and the packaged binary is `ranty-js`.                                                                                                                                                                          |
+| Shared docs split         | The hosted docs at <https://insanityfarm.github.io/ranty/> are the shared language/runtime reference. This README is the local JS-specific host guide.                                                                                         |
+| Host API naming           | The JS API uses camelCase method names such as `compileQuiet()`, `compileNamed()`, `compileFileQuiet()`, `usingModuleResolver()`, and `addDataSource()`.                                                                                       |
+| Error model               | Host-side operations throw normal JS errors such as `CompilerError`, `RuntimeError`, `ModuleResolveError`, and `DataSourceError` instead of returning Rust `Result` values.                                                                    |
+| Return values             | `run()` returns native JS values. Text output is a `string`; exact integers may be `bigint`; maps are `Map<string, unknown>`; list and tuple values are arrays; functions are JS callables.                                                    |
+| Exact integers and seeds  | Integer-heavy APIs accept `number` or `bigint`. `RantyInt` preserves signed i64 semantics, and `toApiValue()` returns a `number` only when the value stays inside the safe integer range.                                                      |
+| Node module resolution    | `DefaultModuleResolver` checks the dependant file directory first, then `localModulesPath` or `process.cwd()`, then `RANTY_MODULES_PATH` when global modules are enabled. When no extension is supplied, `.ranty` is preferred before `.rant`. |
+| Browser module loading    | In browsers, `@require` only works through host-supplied resolvers such as `VirtualModuleResolver`. The runtime does not perform ambient filesystem or network lookup.                                                                         |
+| Data sources              | Implement the `DataSource` interface and register it with `addDataSource()`. Scripts consume these integrations through `[ds-request: ...]` and `[ds-query-sources]`.                                                                          |
+| Bundle shape              | `dist/ranty.js` is a UMD bundle. Browser consumers read exports from `globalThis.Ranty`, for example `globalThis.Ranty.Ranty` and `globalThis.Ranty.VirtualModuleResolver`.                                                                    |
+| GC and ownership notes    | Rust ownership and borrowing guidance does not apply directly. `gcAllocationThreshold` remains part of the options surface for parity, and `collectGarbage()` is currently a no-op in the JS runtime.                                          |
+
+## Upstream Parity
+
+- The Rust repo at [insanityfarm/ranty](https://github.com/insanityfarm/ranty)
+  is authoritative for shared language and runtime behavior.
+- The vendored upstream bundle lives under [`./upstream/ranty/`](./upstream/ranty/).
+- Refresh it with `npm run upstream:sync -- --ref=<rust-sha-or-branch>`.
+- CI runs `npm run upstream:check-freshness` and only blocks pull requests that
+  touch core, public API, or build-sensitive surfaces while the local parity
+  lock is behind upstream Rust `main`.
+
+## Contributor Workflow
+
+- Read [`./spec/README.md`](./spec/README.md).
+- Read [`./glossary/README.md`](./glossary/README.md).
+- Read [`./AGENTS.md`](./AGENTS.md).
+- Run `npm run context:task -- "<task>"` before editing.
+- Run `npm run context:build` after changing glossary terms, subsystem records,
+  or ADRs.
+- Run `npm run verify` before treating a change as done.
+
+## License
+
+MIT. See [`./LICENSE`](./LICENSE).

package/dist/core/binding.d.ts

@@ -0,0 +1,34 @@
+import type { Sequence } from "./lang";
+import type { RantyValue } from "./values";
+export interface LazyThunk {
+    readonly name: string | null;
+    readonly expr: Sequence;
+    readonly scopes: readonly Map<string, RantyBinding>[];
+}
+export interface PendingLazyState {
+    readonly kind: "pending";
+    readonly thunk: LazyThunk;
+}
+export interface EvaluatingLazyState {
+    readonly kind: "evaluating";
+    readonly thunk: LazyThunk;
+}
+export interface ReadyLazyState {
+    readonly kind: "ready";
+    readonly value: RantyValue;
+}
+export type LazyState = PendingLazyState | EvaluatingLazyState | ReadyLazyState;
+export interface ValueBinding {
+    kind: "value";
+    value: RantyValue;
+    readonly const: boolean;
+}
+export interface LazyBinding {
+    kind: "lazy";
+    state: LazyState;
+    readonly const: boolean;
+}
+export type RantyBinding = ValueBinding | LazyBinding;
+export declare function valueBinding(value: RantyValue, isConst?: boolean): RantyBinding;
+export declare function lazyBinding(thunk: LazyThunk, isConst?: boolean): RantyBinding;
+//# sourceMappingURL=binding.d.ts.map

package/dist/core/binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../../src/core/binding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC;CACvD;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,MAAM,MAAM,SAAS,GAAG,gBAAgB,GAAG,mBAAmB,GAAG,cAAc,CAAC;AAEhF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,WAAW,CAAC;AAEtD,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,UAAQ,GAAG,YAAY,CAM7E;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,UAAQ,GAAG,YAAY,CAS3E"}

package/dist/core/compiler/index.d.ts

@@ -0,0 +1,5 @@
+import type { Reporter } from "../messages";
+import { RantyProgram, type RantyProgramInfo } from "../program";
+export declare function compileString(source: string, reporter: Reporter, _debugEnabled: boolean, info?: RantyProgramInfo): RantyProgram;
+export declare function compileFile(path: string, reporter: Reporter, debugEnabled: boolean): RantyProgram;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/compiler/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/compiler/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAMjE,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,OAAO,EACtB,IAAI,GAAE,gBAAqB,GAC1B,YAAY,CAId;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,OAAO,GACpB,YAAY,CAyCd"}

package/dist/core/compiler/lexer.d.ts

@@ -0,0 +1,30 @@
+import type { Reporter } from "../messages";
+interface TokenBase {
+    readonly start: number;
+    readonly end: number;
+}
+export type RantyToken = (TokenBase & {
+    readonly type: "whitespace";
+    readonly value: string;
+}) | (TokenBase & {
+    readonly type: "comment";
+    readonly value: string;
+}) | (TokenBase & {
+    readonly type: "string";
+    readonly value: string;
+    readonly raw: string;
+}) | (TokenBase & {
+    readonly type: "number";
+    readonly value: string;
+}) | (TokenBase & {
+    readonly type: "identifier";
+    readonly value: string;
+}) | (TokenBase & {
+    readonly type: "symbol";
+    readonly value: string;
+}) | (TokenBase & {
+    readonly type: "eof";
+});
+export declare function lex(source: string, reporter: Reporter): RantyToken[];
+export {};
+//# sourceMappingURL=lexer.d.ts.map

package/dist/core/compiler/lexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lexer.d.ts","sourceRoot":"","sources":["../../../src/core/compiler/lexer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAI5C,UAAU,SAAS;IACjB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,UAAU,GAClB,CAAC,SAAS,GAAG;IACX,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC,GACF,CAAC,SAAS,GAAG;IACX,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC,GACF,CAAC,SAAS,GAAG;IACX,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,CAAC,GACF,CAAC,SAAS,GAAG;IACX,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC,GACF,CAAC,SAAS,GAAG;IACX,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC,GACF,CAAC,SAAS,GAAG;IACX,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC,GACF,CAAC,SAAS,GAAG;IACX,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;CACtB,CAAC,CAAC;AAmFP,wBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,UAAU,EAAE,CA6JpE"}

package/dist/core/compiler/message.d.ts

@@ -0,0 +1,4 @@
+import { type Reporter, type Severity } from "../messages";
+export declare function reportCompilerMessage(reporter: Reporter, code: string, message: string, severity: Severity, start: number, end: number, inlineMessage?: string): void;
+export declare function nullReporter(): Reporter;
+//# sourceMappingURL=message.d.ts.map

package/dist/core/compiler/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../src/core/compiler/message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5E,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,aAAa,CAAC,EAAE,MAAM,GACrB,IAAI,CAmBN;AAED,wBAAgB,YAAY,IAAI,QAAQ,CAIvC"}

package/dist/core/compiler/parser.d.ts

@@ -0,0 +1,6 @@
+import type { Sequence } from "../lang";
+import type { Reporter } from "../messages";
+import { type RantyToken } from "./lexer";
+export declare function parse(source: string, reporter: Reporter): Sequence;
+export declare function parseTokens(tokens: readonly RantyToken[], source: string, reporter: Reporter): Sequence;
+//# sourceMappingURL=parser.d.ts.map

package/dist/core/compiler/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/core/compiler/parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAiBV,QAAQ,EAOT,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAO,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AA+yG/C,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAElE;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,SAAS,UAAU,EAAE,EAC7B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,GACjB,QAAQ,CAEV"}

package/dist/core/compiler/reader.d.ts

@@ -0,0 +1,12 @@
+export declare class SourceReader {
+    #private;
+    readonly source: string;
+    constructor(source: string);
+    index(): number;
+    setIndex(index: number): void;
+    isEof(): boolean;
+    peek(offset?: number): string | undefined;
+    next(): string | undefined;
+    consumeWhile(predicate: (char: string) => boolean): string;
+}
+//# sourceMappingURL=reader.d.ts.map

package/dist/core/compiler/reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../../src/core/compiler/reader.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAY;;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAGZ,MAAM,EAAE,MAAM;IAI1B,KAAK,IAAI,MAAM;IAIf,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7B,KAAK,IAAI,OAAO;IAIhB,IAAI,CAAC,MAAM,SAAI,GAAG,MAAM,GAAG,SAAS;IAIpC,IAAI,IAAI,MAAM,GAAG,SAAS;IAQ1B,YAAY,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM;CAW3D"}

package/dist/core/compiler/token-reader.d.ts

@@ -0,0 +1,17 @@
+import type { RantyToken } from "./lexer";
+export declare class TokenReader {
+    #private;
+    readonly source: string;
+    readonly tokens: readonly RantyToken[];
+    constructor(tokens: readonly RantyToken[], source: string);
+    mark(): number;
+    reset(mark: number): void;
+    index(): number;
+    isEof(): boolean;
+    peek(offset?: number): RantyToken | undefined;
+    peekRaw(offset?: number): RantyToken | undefined;
+    next(): RantyToken | undefined;
+    consumeTrivia(): void;
+    currentToken(): RantyToken | undefined;
+}
+//# sourceMappingURL=token-reader.d.ts.map

package/dist/core/compiler/token-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-reader.d.ts","sourceRoot":"","sources":["../../../src/core/compiler/token-reader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAM1C,qBAAa,WAAW;;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;gBAG3B,MAAM,EAAE,SAAS,UAAU,EAAE,EAAE,MAAM,EAAE,MAAM;IAKzD,IAAI,IAAI,MAAM;IAId,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIzB,KAAK,IAAI,MAAM;IAIf,KAAK,IAAI,OAAO;IAIhB,IAAI,CAAC,MAAM,SAAI,GAAG,UAAU,GAAG,SAAS;IAOxC,OAAO,CAAC,MAAM,SAAI,GAAG,UAAU,GAAG,SAAS;IAI3C,IAAI,IAAI,UAAU,GAAG,SAAS;IAQ9B,aAAa,IAAI,IAAI;IAMrB,YAAY,IAAI,UAAU,GAAG,SAAS;CAGvC"}

package/dist/core/constants.d.ts

@@ -0,0 +1,8 @@
+export declare const BUILD_VERSION = "1.0.0";
+export declare const RANTY_LANG_VERSION = "1.0.0";
+export declare const DEFAULT_PROGRAM_NAME = "program";
+export declare const RANTY_FILE_EXTENSION = "ranty";
+export declare const RANTY_COMPAT_FILE_EXTENSION = "rant";
+export declare const RANTY_SUPPORTED_FILE_EXTENSIONS: readonly ["ranty", "rant"];
+export declare const MODULES_CACHE_KEY = "__MODULES";
+//# sourceMappingURL=constants.d.ts.map

package/dist/core/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,UAAU,CAAC;AACrC,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAC1C,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAC9C,eAAO,MAAM,oBAAoB,UAAU,CAAC;AAC5C,eAAO,MAAM,2BAA2B,SAAS,CAAC;AAClD,eAAO,MAAM,+BAA+B,4BAGlC,CAAC;AACX,eAAO,MAAM,iBAAiB,cAAc,CAAC"}

package/dist/core/data-source.d.ts

@@ -0,0 +1,6 @@
+import type { RantyValue } from "./values";
+export interface DataSource {
+    typeId(): string;
+    requestData(args: readonly RantyValue[]): RantyValue;
+}
+//# sourceMappingURL=data-source.d.ts.map

package/dist/core/data-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-source.d.ts","sourceRoot":"","sources":["../../src/core/data-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,WAAW,UAAU;IACzB,MAAM,IAAI,MAAM,CAAC;IACjB,WAAW,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,GAAG,UAAU,CAAC;CACtD"}

package/dist/core/errors.d.ts

@@ -0,0 +1,56 @@
+import type { CompilerMessage } from "./messages";
+export type CompilerErrorKind = "syntax" | "io";
+export declare class CompilerError extends Error {
+    readonly kind: CompilerErrorKind;
+    constructor(kind: CompilerErrorKind, message?: string);
+}
+export type ModuleResolveErrorReason = {
+    readonly kind: "not_found";
+} | {
+    readonly kind: "compile_failed";
+    readonly messages: readonly CompilerMessage[];
+} | {
+    readonly kind: "file_io_error";
+    readonly error: unknown;
+};
+export declare class ModuleResolveError extends Error {
+    readonly moduleName: string;
+    readonly reason: ModuleResolveErrorReason;
+    constructor(moduleName: string, reason: ModuleResolveErrorReason);
+}
+export declare class ModuleLoadError extends Error {
+    constructor(message: string);
+}
+export declare class DataSourceError extends Error {
+    readonly type: "user" | "internal";
+    constructor(type: "user" | "internal", message: string);
+}
+export declare enum RuntimeErrorType {
+    StackOverflow = "STACK_OVERFLOW_ERROR",
+    StackUnderflow = "STACK_UNDERFLOW_ERROR",
+    InvalidAccess = "INVALID_ACCESS_ERROR",
+    InvalidOperation = "INVALID_OP_ERROR",
+    LazyBindingCycle = "LAZY_BINDING_CYCLE_ERROR",
+    InternalError = "INTERNAL_ERROR",
+    ArgumentMismatch = "ARG_MISMATCH_ERROR",
+    ArgumentError = "ARG_ERROR",
+    CannotInvokeValue = "INVOKE_ERROR",
+    AssertError = "ASSERT_ERROR",
+    TypeError = "TYPE_ERROR",
+    ValueError = "VALUE_ERROR",
+    IndexError = "INDEX_ERROR",
+    KeyError = "KEY_ERROR",
+    SliceError = "SLICE_ERROR",
+    SelectorError = "SELECTOR_ERROR",
+    ModuleError = "MODULE_ERROR",
+    UserError = "USER_ERROR",
+    ControlFlowError = "CONTROL_FLOW_ERROR",
+    DataSourceError = "DATA_SOURCE_ERROR"
+}
+export declare class RuntimeError extends Error {
+    readonly errorType: RuntimeErrorType;
+    readonly description: string | undefined;
+    readonly stackTrace: string | undefined;
+    constructor(errorType: RuntimeErrorType, description?: string, stackTrace?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,IAAI,CAAC;AAEhD,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;gBAErB,IAAI,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,MAAM;CAKtD;AAED,MAAM,MAAM,wBAAwB,GAChC;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GAC9B;IACE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;CAC/C,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAEhE,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;gBAE9B,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,wBAAwB;CAYjE;AAED,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;gBAEvB,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,OAAO,EAAE,MAAM;CAKvD;AAED,oBAAY,gBAAgB;IAC1B,aAAa,yBAAyB;IACtC,cAAc,0BAA0B;IACxC,aAAa,yBAAyB;IACtC,gBAAgB,qBAAqB;IACrC,gBAAgB,6BAA6B;IAC7C,aAAa,mBAAmB;IAChC,gBAAgB,uBAAuB;IACvC,aAAa,cAAc;IAC3B,iBAAiB,iBAAiB;IAClC,WAAW,iBAAiB;IAC5B,SAAS,eAAe;IACxB,UAAU,gBAAgB;IAC1B,UAAU,gBAAgB;IAC1B,QAAQ,cAAc;IACtB,UAAU,gBAAgB;IAC1B,aAAa,mBAAmB;IAChC,WAAW,iBAAiB;IAC5B,SAAS,eAAe;IACxB,gBAAgB,uBAAuB;IACvC,eAAe,sBAAsB;CACtC;AAED,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;gBAGtC,SAAS,EAAE,gBAAgB,EAC3B,WAAW,CAAC,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,MAAM;CAQtB"}

package/dist/core/format-state.d.ts

@@ -0,0 +1,28 @@
+import type { RantyValue } from "./values";
+export type WhitespaceFormatMode = "default" | "ignore-all" | "verbatim" | "custom";
+export type NumeralSystem = "west-arabic" | "east-arabic" | "persian" | "roman" | "babylonian" | "hex" | "octal" | "binary" | "alpha";
+export type Endianness = "big" | "little";
+export type SignStyle = "negative-only" | "explicit" | "explicit-non-zero";
+export type InfinityStyle = "keyword" | "symbol";
+export interface WhitespaceFormatState {
+    mode: WhitespaceFormatMode;
+    customValue: RantyValue;
+}
+export interface NumberFormatState {
+    system: NumeralSystem;
+    alt: boolean;
+    precision: number | null;
+    padding: number;
+    upper: boolean;
+    endian: Endianness;
+    sign: SignStyle;
+    infinity: InfinityStyle;
+    groupSep: string;
+    decimalSep: string;
+}
+export interface OutputFormatState {
+    whitespace: WhitespaceFormatState;
+    number: NumberFormatState;
+}
+export declare function defaultOutputFormatState(): OutputFormatState;
+//# sourceMappingURL=format-state.d.ts.map

package/dist/core/format-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-state.d.ts","sourceRoot":"","sources":["../../src/core/format-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,MAAM,oBAAoB,GAC5B,SAAS,GACT,YAAY,GACZ,UAAU,GACV,QAAQ,CAAC;AACb,MAAM,MAAM,aAAa,GACrB,aAAa,GACb,aAAa,GACb,SAAS,GACT,OAAO,GACP,YAAY,GACZ,KAAK,GACL,OAAO,GACP,QAAQ,GACR,OAAO,CAAC;AACZ,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,QAAQ,CAAC;AAC1C,MAAM,MAAM,SAAS,GAAG,eAAe,GAAG,UAAU,GAAG,mBAAmB,CAAC;AAC3E,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEjD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,WAAW,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,aAAa,CAAC;IACtB,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,qBAAqB,CAAC;IAClC,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED,wBAAgB,wBAAwB,IAAI,iBAAiB,CAmB5D"}

package/dist/core/int64.d.ts

@@ -0,0 +1,9 @@
+export declare class RantyInt {
+    readonly value: bigint;
+    private constructor();
+    static from(value: bigint | number | string | RantyInt): RantyInt;
+    toApiValue(): bigint | number;
+    toString(): string;
+}
+export declare function toExactInt(value: bigint | number | string | RantyInt): bigint;
+//# sourceMappingURL=int64.d.ts.map

package/dist/core/int64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"int64.d.ts","sourceRoot":"","sources":["../../src/core/int64.ts"],"names":[],"mappings":"AAaA,qBAAa,QAAQ;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,OAAO;IAIP,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ;IAoBjE,UAAU,IAAI,MAAM,GAAG,MAAM;IAQ7B,QAAQ,IAAI,MAAM;CAGnB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAE7E"}