@mylasertools/kerfscript 0.0.0-stage → 0.2.1

package/README.md

@@ -1,3 +1,188 @@
-# Temporary Holding Version
+<p align="center">
+  <a href="https://kerfscript.mylasertools.com"><img src=".github/readme/banner.png" alt="KerfScript, a programming language for laser cutting" width="840"></a>
+</p>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<p align="center">
+  <a href="https://www.npmjs.com/package/@mylasertools/kerfscript"><img src="https://img.shields.io/npm/v/@mylasertools/kerfscript?color=d8361f&label=npm" alt="npm version"></a>
+  <a href="COMMERCIAL-LICENSE.md"><img src="https://img.shields.io/badge/licence-AGPL--3.0%20or%20free%20commercial-1f1a17" alt="Licence: AGPL-3.0 or free commercial"></a>
+  <a href="LANGUAGE.md"><img src="https://img.shields.io/badge/language-0.1-e3c69a" alt="Language version 0.1"></a>
+  <a href="https://kerfscript.mylasertools.com/playground/"><img src="https://img.shields.io/badge/try%20it-playground-5a3519" alt="Try it in the playground"></a>
+</p>
+
+<p align="center">
+  <a href="https://kerfscript.mylasertools.com">Website</a> ·
+  <a href="https://kerfscript.mylasertools.com/playground/">Playground</a> ·
+  <a href="https://kerfscript.mylasertools.com/models/">Models</a> ·
+  <a href="https://kerfscript.mylasertools.com/docs/">Docs</a> ·
+  <a href="https://www.npmjs.com/package/@mylasertools/kerfscript">npm</a>
+</p>
+
+Write a part once as code, change a number, and get a new cut file. KerfScript
+is to laser cutters what OpenSCAD is to 3D printers, except it was designed for
+flat parts from the start: cut, score and engrave layers, kerf compensation,
+finger joints, living hinges, parts and sheets are part of the language.
+
+<p align="center">
+  <a href="https://kerfscript.mylasertools.com/playground/?model=fractal-tree"><img src=".github/readme/playground.gif" alt="Moving a slider in the playground changes the number in the code and redraws the fractal tree" width="840"></a>
+  <br><sub>The <a href="https://kerfscript.mylasertools.com/playground/">playground</a> runs the interpreter in your browser. A comment after a number turns it into a slider.</sub>
+</p>
+
+## Example
+
+<table>
+<tr>
+<td width="50%" valign="top">
+
+```kerf
+use <kerf/box>
+
+/* [Size] */
+width = 120; // [40:5:400]
+depth = 80; // [40:5:400]
+height = 50; // [20:5:300]
+lid = true;
+
+/* [Material] */
+$thickness = 3; // [1.5:0.5:10]
+$kerf = 0.15; // [0:0.01:0.5]
+
+box([width, depth, height], lid = lid);
+```
+
+</td>
+<td width="50%" valign="top">
+<img src=".github/readme/model-box.png" alt="Six finger-jointed panels of a box, packed on a sheet">
+</td>
+</tr>
+</table>
+
+```sh
+npx @mylasertools/kerfscript render box.kerf -o box.svg -D width=200
+```
+
+That writes all six panels packed on a sheet, kerf compensated, as a
+millimetre SVG with one layer per operation. Output is checked automatically
+in Inkscape; see [docs/compatibility.md](docs/compatibility.md) for what has
+and has not been tested in other laser software.
+
+## Made with KerfScript
+
+Every model is a file in [examples/](examples). Open one on the website to
+turn it around in 3D, change its settings and download the SVG or DXF, or copy
+it as the start of your own design.
+
+<table>
+<tr>
+<td width="33%" valign="top"><a href="https://kerfscript.mylasertools.com/models/hadal/"><img src="site/public/3d/hadal.webp" alt="Hadal sculpture, assembled"></a><br><b><a href="https://kerfscript.mylasertools.com/models/hadal/">Hadal sculpture</a></b><br><sub>13 slotted parts, ribs computed from lists</sub></td>
+<td width="33%" valign="top"><a href="https://kerfscript.mylasertools.com/models/tilt-maze/"><img src="site/public/3d/tilt-maze.webp" alt="Tilt maze, assembled"></a><br><b><a href="https://kerfscript.mylasertools.com/models/tilt-maze/">Tilt maze</a></b><br><sub>a new maze for every seed, by recursion</sub></td>
+<td width="33%" valign="top"><a href="https://kerfscript.mylasertools.com/models/topo-island/"><img src="site/public/3d/topo-island.webp" alt="Layered island, assembled"></a><br><b><a href="https://kerfscript.mylasertools.com/models/topo-island/">Layered island</a></b><br><sub>contours traced from a height formula</sub></td>
+</tr>
+<tr>
+<td width="33%" valign="top"><a href="https://kerfscript.mylasertools.com/models/fractal-tree/"><img src="site/public/3d/fractal-tree.webp" alt="Fractal tree, assembled"></a><br><b><a href="https://kerfscript.mylasertools.com/models/fractal-tree/">Fractal tree</a></b><br><sub>a module that calls itself</sub></td>
+<td width="33%" valign="top"><a href="https://kerfscript.mylasertools.com/models/round-badge/"><img src="site/public/3d/round-badge.webp" alt="Round badge, assembled"></a><br><b><a href="https://kerfscript.mylasertools.com/models/round-badge/">Round badge</a></b><br><sub>text set letter by letter around a circle</sub></td>
+<td width="33%" valign="top"><a href="https://kerfscript.mylasertools.com/models/winterlight/"><img src="site/public/3d/winterlight.webp" alt="Winterlight ornaments, assembled"></a><br><b><a href="https://kerfscript.mylasertools.com/models/winterlight/">Winterlight ornaments</a></b><br><sub>one-piece ornaments with scored detail</sub></td>
+</tr>
+<tr>
+<td width="33%" valign="top"><a href="https://kerfscript.mylasertools.com/models/xenospora/"><img src="site/public/3d/xenospora.webp" alt="Xenospora seed pod, assembled"></a><br><b><a href="https://kerfscript.mylasertools.com/models/xenospora/">Xenospora seed pod</a></b><br><sub>16 parts on 3 sheets, one file per sheet</sub></td>
+<td width="33%" valign="top"><a href="https://kerfscript.mylasertools.com/models/solstice/"><img src="site/public/3d/solstice.webp" alt="Solstice lantern, assembled"></a><br><b><a href="https://kerfscript.mylasertools.com/models/solstice/">Solstice lantern</a></b><br><sub>tabs, slots and a fit test piece</sub></td>
+<td width="33%" valign="top"><a href="https://kerfscript.mylasertools.com/models/box/"><img src="site/public/3d/box.webp" alt="Finger-jointed box, assembled"></a><br><b><a href="https://kerfscript.mylasertools.com/models/box/">Finger-jointed box</a></b><br><sub>six panels from one library call</sub></td>
+</tr>
+<tr>
+<td width="33%" valign="top"><a href="https://kerfscript.mylasertools.com/models/wave-cathedral/"><img src="site/public/3d/wave-cathedral.webp" alt="Wave Cathedral, assembled"></a><br><b><a href="https://kerfscript.mylasertools.com/models/wave-cathedral/">Wave Cathedral</a></b><br><sub>17 different ribs from one formula</sub></td>
+<td width="33%" valign="top"><a href="https://kerfscript.mylasertools.com/models/gift-tags/"><img src="site/public/3d/gift-tags.webp" alt="Gift tags from a list, assembled"></a><br><b><a href="https://kerfscript.mylasertools.com/models/gift-tags/">Gift tags from a list</a></b><br><sub>one tag per name, each name fitted</sub></td>
+<td width="33%" valign="top"><a href="https://kerfscript.mylasertools.com/models/umbra/"><img src="site/public/3d/umbra.webp" alt="Umbra shadow machine, assembled"></a><br><b><a href="https://kerfscript.mylasertools.com/models/umbra/">Umbra shadow machine</a></b><br><sub>six fins whose shadows make one dragon</sub></td>
+</tr>
+</table>
+
+## Why a new language
+
+- **Laser concepts are built in.** `engrave()`, `score()` and `cut()` put
+  geometry on machine layers. Engraving is clipped to the material, inner
+  cuts come before outer ones, and the whole part is offset by half the kerf.
+- **Parts, not just shapes.** `part("lid", qty = 2)` names a piece; the
+  renderer packs parts by material and thickness onto sheets.
+- **Joinery that fits.** `finger_rect`, `finger_holes`, `tslot` and
+  `living_hinge` use `$thickness`, so changing the material keeps joints
+  tight.
+- **Familiar syntax.** If you know OpenSCAD, you can read KerfScript. The
+  customizer comments are the same, so editors that understand OpenSCAD
+  parameters understand KerfScript ones.
+- **Runs anywhere.** Pure TypeScript with no native code: the same interpreter
+  runs in browsers, Node, workers and the command line.
+- **Safe to run.** Programs read libraries only through the resolver you
+  provide. Step and recursion limits stop runaway programs, and errors name
+  the line.
+
+## Install
+
+```sh
+npm install @mylasertools/kerfscript
+```
+
+## Command line
+
+```sh
+kerf render design.kerf -o design.svg      # or .dxf / .json
+kerf render design.kerf -D width=200 -D 'label="Oak"' --font Inter.ttf
+kerf render design.kerf --sheet 400x300 --kerf 0.1 --split
+kerf params design.kerf                    # customizer parameters as JSON
+kerf check design.kerf                     # parts, sizes, cut length, warnings
+```
+
+## Library
+
+```js
+import { render, parameters } from '@mylasertools/kerfscript';
+
+const result = render(source, {
+  params: { width: 200 },
+  fonts: { inter: await (await fetch('/Inter.ttf')).arrayBuffer() },
+  sheet: [600, 400],
+});
+
+result.svg; // all sheets in one SVG
+result.sheets; // [{ width, height, material, thickness, svg, dxf, items }]
+result.parts; // [{ name, qty, width, height, pieces, cutLength, thickness, kerf, material }]
+result.warnings; // e.g. a part that falls apart, or one bigger than the sheet
+result.echoes; // echo() output
+
+parameters(source).parameters; // [{ name, caption, group, type, initial, min, max, step, options, span }]
+```
+
+Errors are thrown as `KerfError` with `line` and `col`.
+
+## Learn the language
+
+- [Getting started](docs/getting-started.md), then the guides on
+  [layers](docs/layers.md), [kerf](docs/kerf.md),
+  [parts and sheets](docs/parts-and-sheets.md), [settings](docs/customizer.md),
+  the [command line](docs/cli.md) and the [JavaScript API](docs/javascript.md)
+- [Coming from OpenSCAD](docs/openscad.md): what is the same and what is not
+- [LANGUAGE.md](LANGUAGE.md): the full language reference
+- [Versions](docs/versions.md): language and package versions, and what stays
+  stable before 1.0
+- [examples/](examples): every model on the website, including a
+  calibration square and a kerf test
+
+## Community
+
+Bug reports, cut reports and ideas are welcome; see
+[CONTRIBUTING.md](CONTRIBUTING.md), the [roadmap](ROADMAP.md),
+[SECURITY.md](SECURITY.md) and the [code of conduct](CODE_OF_CONDUCT.md).
+
+## Licence
+
+Copyright (c) 2026 MyLaserTools.
+
+KerfScript is free software under the
+[GNU AGPL 3.0](LICENSE), with an [additional permission](COMMERCIAL-LICENSE.md#additional-permission-your-designs-are-yours)
+that makes **your `.kerf` designs and the files KerfScript generates yours to
+license and sell however you like**.
+
+Building KerfScript into a closed-source app, machine or service? The
+[commercial licence](COMMERCIAL-LICENSE.md#free-commercial-licence) is free:
+just email hi@mylasertools.com.
+
+"KerfScript" is a trademark of MyLaserTools; see [TRADEMARKS.md](TRADEMARKS.md).
+Contributions need the [CLA](CLA.md); see [CONTRIBUTING.md](CONTRIBUTING.md).
+Bundled third-party code is listed in [THIRD-PARTY-NOTICES.md](THIRD-PARTY-NOTICES.md).

package/THIRD-PARTY-NOTICES.md

@@ -0,0 +1,124 @@
+# Third-party notices
+
+KerfScript bundles the following software in `dist/`. Their licences apply to
+those parts only.
+
+## Clipper2 / clipper2-ts 2.0.1-18 (bundled)
+
+Original Clipper2: Copyright Angus Johnson 2010–2025.
+TypeScript port by Jeremy Tribby (countertype).
+Source: https://github.com/countertype/clipper2-ts
+
+```text
+Boost Software License - Version 1.0 - August 17th, 2003
+
+Permission is hereby granted, free of charge, to any person or organization
+obtaining a copy of the software and accompanying documentation covered by
+this license (the "Software") to use, reproduce, display, distribute,
+execute, and transmit the Software, and to prepare derivative works of the
+Software, and to permit third-parties to whom the Software is furnished to
+do so, all subject to the following:
+
+The copyright notices in the Software and this entire statement, including
+the above license grant, this restriction and the following disclaimer,
+must be included in all copies of the Software, in whole or in part, and
+all derivative works of the Software, unless such copies or derivative
+works are solely in the form of machine-executable object code generated by
+a source language processor.
+
+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, TITLE AND NON-INFRINGEMENT. IN NO EVENT
+SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
+FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+```
+
+## opentype.js 1.3.4 (bundled)
+
+Source: https://github.com/opentypejs/opentype.js
+
+```text
+The MIT License (MIT)
+
+Copyright (c) 2020 Frederik De Bleser
+
+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.
+```
+
+## tiny-inflate 1.0.3 (bundled, part of opentype.js)
+
+Source: https://github.com/foliojs/tiny-inflate
+
+```text
+MIT License
+
+Copyright (c) 2015-present Devon Govett
+
+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.
+```
+
+## string.prototype.codepointat 0.2.1 (bundled, part of opentype.js)
+
+Source: https://github.com/mathiasbynens/String.prototype.codePointAt
+
+```text
+Copyright Mathias Bynens <https://mathiasbynens.be/>
+
+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.
+```
+
+## Atkinson Hyperlegible (test fixture only, not published to npm)
+
+`test/fixtures/AtkinsonHyperlegible-Regular.ttf`, Copyright 2020 Braille
+Institute of America, Inc., licensed under the SIL Open Font License 1.1. See
+`test/fixtures/OFL.txt`.

package/TRADEMARKS.md

@@ -0,0 +1,45 @@
+# Trademark policy
+
+"KerfScript", the `.kerf` file format name used as a product name, and the
+KerfScript logo are trademarks of MyLaserTools. The software licences
+(AGPL-3.0-only and the free commercial licence) cover the code. They do not grant rights to the
+name or logo.
+
+This policy identifies the official KerfScript project while allowing others
+to describe tools that work with the language. MyLaserTools controls the
+official language versions and releases.
+
+## You may, without asking
+
+- say your design, tutorial, course, video or library is written **in**
+  KerfScript or works **with** KerfScript
+- describe an independent editor, implementation or service as compatible
+  with a specific KerfScript language version when the claim is accurate,
+  its limitations are clear and you do not imply MyLaserTools endorsement
+- use KerfScript in a descriptive phrase such as "an editor for KerfScript"
+  alongside your own distinct product name
+- use the `.kerf` file extension for KerfScript programs
+- use the name to refer to this project and to unmodified copies of it
+- publish a fork for development, as long as it is clearly marked as a fork
+  and does not use the name or logo as its own product name
+
+## You need written permission to
+
+- name a product, service, company, domain or package "KerfScript" or anything
+  confusingly similar (for example "KerfScript Pro", "kerfscript-cloud")
+- call your own implementation, editor or service "official" or imply
+  that MyLaserTools endorses it
+- use the logo, other than to link to this project
+- distribute a modified interpreter under the KerfScript name
+
+## Language specification
+
+The language reference ([LANGUAGE.md](LANGUAGE.md)) is published under
+Creative Commons Attribution 4.0 (CC BY 4.0). You may copy, translate and
+adapt it with attribution and a note describing your changes. Adapted
+references are not official KerfScript language versions. MyLaserTools
+publishes the official reference and decides which language changes it adopts.
+
+## Contact
+
+hi@mylasertools.com

package/dist/ast.d.cts

@@ -0,0 +1,160 @@
+import type { Pos } from './lexer.cjs';
+export type Expr = {
+    kind: 'num';
+    value: number;
+    pos: Pos;
+} | {
+    kind: 'str';
+    value: string;
+    pos: Pos;
+} | {
+    kind: 'bool';
+    value: boolean;
+    pos: Pos;
+} | {
+    kind: 'undef';
+    pos: Pos;
+} | {
+    kind: 'var';
+    name: string;
+    pos: Pos;
+} | {
+    kind: 'list';
+    items: ListItem[];
+    pos: Pos;
+} | {
+    kind: 'range';
+    start: Expr;
+    step: Expr | null;
+    end: Expr;
+    pos: Pos;
+} | {
+    kind: 'unary';
+    op: string;
+    arg: Expr;
+    pos: Pos;
+} | {
+    kind: 'binary';
+    op: string;
+    left: Expr;
+    right: Expr;
+    pos: Pos;
+} | {
+    kind: 'ternary';
+    cond: Expr;
+    then: Expr;
+    else: Expr;
+    pos: Pos;
+} | {
+    kind: 'index';
+    target: Expr;
+    index: Expr;
+    pos: Pos;
+} | {
+    kind: 'member';
+    target: Expr;
+    name: string;
+    pos: Pos;
+} | {
+    kind: 'call';
+    callee: Expr;
+    args: Arg[];
+    pos: Pos;
+} | {
+    kind: 'lambda';
+    params: Param[];
+    body: Expr;
+    pos: Pos;
+} | {
+    kind: 'let';
+    assigns: Assign[];
+    body: Expr;
+    pos: Pos;
+};
+export type ListItem = {
+    kind: 'item';
+    expr: Expr;
+} | {
+    kind: 'each';
+    expr: Expr;
+} | {
+    kind: 'for';
+    assigns: Assign[];
+    body: ListItem;
+} | {
+    kind: 'if';
+    cond: Expr;
+    then: ListItem;
+    else: ListItem | null;
+} | {
+    kind: 'let';
+    assigns: Assign[];
+    body: ListItem;
+};
+export interface Arg {
+    name: string | null;
+    value: Expr;
+}
+export interface Param {
+    name: string;
+    default: Expr | null;
+}
+export interface Assign {
+    name: string;
+    value: Expr;
+    pos: Pos;
+}
+export type Stmt = {
+    kind: 'assign';
+    name: string;
+    value: Expr;
+    span: [number, number];
+    pos: Pos;
+} | {
+    kind: 'module';
+    name: string;
+    params: Param[];
+    body: Stmt[];
+    pos: Pos;
+} | {
+    kind: 'function';
+    name: string;
+    params: Param[];
+    body: Expr;
+    pos: Pos;
+} | {
+    kind: 'call';
+    name: string;
+    args: Arg[];
+    children: Stmt[];
+    modifier: string | null;
+    pos: Pos;
+} | {
+    kind: 'for';
+    assigns: Assign[];
+    body: Stmt[];
+    pos: Pos;
+} | {
+    kind: 'if';
+    cond: Expr;
+    then: Stmt[];
+    else: Stmt[];
+    pos: Pos;
+} | {
+    kind: 'let';
+    assigns: Assign[];
+    body: Stmt[];
+    pos: Pos;
+} | {
+    kind: 'block';
+    body: Stmt[];
+    pos: Pos;
+} | {
+    kind: 'use';
+    path: string;
+    include: boolean;
+    pos: Pos;
+};
+export interface Program {
+    body: Stmt[];
+}

package/dist/ast.d.ts

@@ -0,0 +1,160 @@
+import type { Pos } from './lexer.js';
+export type Expr = {
+    kind: 'num';
+    value: number;
+    pos: Pos;
+} | {
+    kind: 'str';
+    value: string;
+    pos: Pos;
+} | {
+    kind: 'bool';
+    value: boolean;
+    pos: Pos;
+} | {
+    kind: 'undef';
+    pos: Pos;
+} | {
+    kind: 'var';
+    name: string;
+    pos: Pos;
+} | {
+    kind: 'list';
+    items: ListItem[];
+    pos: Pos;
+} | {
+    kind: 'range';
+    start: Expr;
+    step: Expr | null;
+    end: Expr;
+    pos: Pos;
+} | {
+    kind: 'unary';
+    op: string;
+    arg: Expr;
+    pos: Pos;
+} | {
+    kind: 'binary';
+    op: string;
+    left: Expr;
+    right: Expr;
+    pos: Pos;
+} | {
+    kind: 'ternary';
+    cond: Expr;
+    then: Expr;
+    else: Expr;
+    pos: Pos;
+} | {
+    kind: 'index';
+    target: Expr;
+    index: Expr;
+    pos: Pos;
+} | {
+    kind: 'member';
+    target: Expr;
+    name: string;
+    pos: Pos;
+} | {
+    kind: 'call';
+    callee: Expr;
+    args: Arg[];
+    pos: Pos;
+} | {
+    kind: 'lambda';
+    params: Param[];
+    body: Expr;
+    pos: Pos;
+} | {
+    kind: 'let';
+    assigns: Assign[];
+    body: Expr;
+    pos: Pos;
+};
+export type ListItem = {
+    kind: 'item';
+    expr: Expr;
+} | {
+    kind: 'each';
+    expr: Expr;
+} | {
+    kind: 'for';
+    assigns: Assign[];
+    body: ListItem;
+} | {
+    kind: 'if';
+    cond: Expr;
+    then: ListItem;
+    else: ListItem | null;
+} | {
+    kind: 'let';
+    assigns: Assign[];
+    body: ListItem;
+};
+export interface Arg {
+    name: string | null;
+    value: Expr;
+}
+export interface Param {
+    name: string;
+    default: Expr | null;
+}
+export interface Assign {
+    name: string;
+    value: Expr;
+    pos: Pos;
+}
+export type Stmt = {
+    kind: 'assign';
+    name: string;
+    value: Expr;
+    span: [number, number];
+    pos: Pos;
+} | {
+    kind: 'module';
+    name: string;
+    params: Param[];
+    body: Stmt[];
+    pos: Pos;
+} | {
+    kind: 'function';
+    name: string;
+    params: Param[];
+    body: Expr;
+    pos: Pos;
+} | {
+    kind: 'call';
+    name: string;
+    args: Arg[];
+    children: Stmt[];
+    modifier: string | null;
+    pos: Pos;
+} | {
+    kind: 'for';
+    assigns: Assign[];
+    body: Stmt[];
+    pos: Pos;
+} | {
+    kind: 'if';
+    cond: Expr;
+    then: Stmt[];
+    else: Stmt[];
+    pos: Pos;
+} | {
+    kind: 'let';
+    assigns: Assign[];
+    body: Stmt[];
+    pos: Pos;
+} | {
+    kind: 'block';
+    body: Stmt[];
+    pos: Pos;
+} | {
+    kind: 'use';
+    path: string;
+    include: boolean;
+    pos: Pos;
+};
+export interface Program {
+    body: Stmt[];
+}

package/dist/cli.d.cts

@@ -0,0 +1 @@
+export {};

package/dist/cli.d.ts

@@ -0,0 +1 @@
+export {};