@mylasertools/kerfscript 0.2.0 → 0.3.0

package/dist/lexer.d.cts

@@ -3,7 +3,9 @@ export interface Pos {
     line: number;
     col: number;
     offset: number;
+    file?: string;
 }
+export declare const where: (pos: Pos, col?: boolean) => string;
 export interface Token {
     type: TokenType;
     value: string;
@@ -20,9 +22,10 @@ export declare class KerfError extends Error {
     col?: number;
     echoes: string[];
     missingFonts?: string[];
+    file?: string;
     constructor(message: string, pos?: Pos);
 }
-export declare function tokenize(src: string): {
+export declare function tokenize(src: string, file?: string): {
     tokens: Token[];
     comments: Comment[];
 };

package/dist/lexer.d.ts

@@ -3,7 +3,9 @@ export interface Pos {
     line: number;
     col: number;
     offset: number;
+    file?: string;
 }
+export declare const where: (pos: Pos, col?: boolean) => string;
 export interface Token {
     type: TokenType;
     value: string;
@@ -20,9 +22,10 @@ export declare class KerfError extends Error {
     col?: number;
     echoes: string[];
     missingFonts?: string[];
+    file?: string;
     constructor(message: string, pos?: Pos);
 }
-export declare function tokenize(src: string): {
+export declare function tokenize(src: string, file?: string): {
     tokens: Token[];
     comments: Comment[];
 };

package/dist/parser.d.cts

@@ -1,6 +1,6 @@
 import type { Program } from './ast.cjs';
 import { type Comment } from './lexer.cjs';
-export declare function parse(src: string): {
+export declare function parse(src: string, file?: string): {
     program: Program;
     comments: Comment[];
 };

package/dist/parser.d.ts

@@ -1,6 +1,6 @@
 import type { Program } from './ast.js';
 import { type Comment } from './lexer.js';
-export declare function parse(src: string): {
+export declare function parse(src: string, file?: string): {
     program: Program;
     comments: Comment[];
 };

package/dist/render.d.cts

@@ -1,8 +1,8 @@
-import { type LayerDef } from './evaluator.cjs';
+import { type LayerDef, type Limits } from './evaluator.cjs';
 import { type LayerPath } from './export/svg.cjs';
 import { type Layer } from './geometry.cjs';
 import { type FontSource } from './text.cjs';
-import type { Value } from './values.cjs';
+import { type Value } from './values.cjs';
 export interface RenderOptions {
     params?: Record<string, Value>;
     fonts?: Record<string, FontSource>;
@@ -15,6 +15,7 @@ export interface RenderOptions {
     margin?: number;
     guides?: boolean;
     maxSteps?: number;
+    limits?: Partial<Limits>;
 }
 export interface PartInfo {
     name: string;

package/dist/render.d.ts

@@ -1,8 +1,8 @@
-import { type LayerDef } from './evaluator.js';
+import { type LayerDef, type Limits } from './evaluator.js';
 import { type LayerPath } from './export/svg.js';
 import { type Layer } from './geometry.js';
 import { type FontSource } from './text.js';
-import type { Value } from './values.js';
+import { type Value } from './values.js';
 export interface RenderOptions {
     params?: Record<string, Value>;
     fonts?: Record<string, FontSource>;
@@ -15,6 +15,7 @@ export interface RenderOptions {
     margin?: number;
     guides?: boolean;
     maxSteps?: number;
+    limits?: Partial<Limits>;
 }
 export interface PartInfo {
     name: string;

package/dist/values.d.cts

@@ -16,10 +16,18 @@ export type Value = number | string | boolean | undefined | Value[] | Range | Cl
 export declare const isRange: (v: Value) => v is Range;
 export declare const isFn: (v: Value) => v is Closure;
 export declare const isNum: (v: Value) => v is number;
+export declare const own: <T>(o: Record<string, T> | undefined, key: string) => T | undefined;
+export declare function checkSetting(name: string, v: unknown, depth?: number): void;
 export declare function rangeValues(r: Range, limit: number): number[];
 export declare function truthy(v: Value): boolean;
-export declare function equals(a: Value, b: Value): boolean;
+export declare function equals(a: Value, b: Value, step?: () => void): boolean;
 export declare function typeName(v: Value): string;
+export declare function write(v: Value, max: number, quote?: boolean): {
+    text: string;
+    whole: boolean;
+};
+export declare function joinText(vs: Value[], sep: string, max: number): string | undefined;
 export declare function show(v: Value): string;
-export declare function str(v: Value): string;
+export declare const toText: (v: Value) => string;
+export declare function toNumber(v: Value): number;
 export declare function fmt(n: number): string;

package/dist/values.d.ts

@@ -16,10 +16,18 @@ export type Value = number | string | boolean | undefined | Value[] | Range | Cl
 export declare const isRange: (v: Value) => v is Range;
 export declare const isFn: (v: Value) => v is Closure;
 export declare const isNum: (v: Value) => v is number;
+export declare const own: <T>(o: Record<string, T> | undefined, key: string) => T | undefined;
+export declare function checkSetting(name: string, v: unknown, depth?: number): void;
 export declare function rangeValues(r: Range, limit: number): number[];
 export declare function truthy(v: Value): boolean;
-export declare function equals(a: Value, b: Value): boolean;
+export declare function equals(a: Value, b: Value, step?: () => void): boolean;
 export declare function typeName(v: Value): string;
+export declare function write(v: Value, max: number, quote?: boolean): {
+    text: string;
+    whole: boolean;
+};
+export declare function joinText(vs: Value[], sep: string, max: number): string | undefined;
 export declare function show(v: Value): string;
-export declare function str(v: Value): string;
+export declare const toText: (v: Value) => string;
+export declare function toNumber(v: Value): number;
 export declare function fmt(n: number): string;

package/dist/wasm.d.cts

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

package/dist/wasm.d.ts

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

package/docs/cli.md

@@ -1,61 +1,102 @@
 # Command line
 
-The `kerf` command renders `.kerf` files to SVG, DXF or JSON. It needs
-Node.js 20 or newer and comes with the `@mylasertools/kerfscript` npm
-package.
+Use the `kerf` command to export designs, change parameters and inspect
+parts from your terminal. Install the package with Node.js 20 or newer:
 
 ```sh
 npm install --global @mylasertools/kerfscript
 kerf render box.kerf -o box.svg
 ```
 
-Or without installing:
+You can also run it through `npx`:
 
 ```sh
 npx @mylasertools/kerfscript render box.kerf -o box.svg
 ```
 
+## Without Node.js
+
+The [releases](https://github.com/mylasertools/kerfscript/releases) page has a
+standalone `kerf` for Windows, macOS and Linux (x64 and arm64) that needs no
+Node.js: `kerf-<version>-<os>-<arch>.zip` or `.tar.gz`, and
+`kerfscript-cli-<version>-linux-<arch>.deb` or `.rpm`. It has the
+Atkinson Hyperlegible font built in, like the npm package.
+
+| System           | Install                                                                                                       |
+| ---------------- | ------------------------------------------------------------------------------------------------------------- |
+| macOS, Linux     | `brew install mylasertools/tap/kerfscript`                                                                    |
+| Windows          | `winget install MyLaserTools.KerfScript.CLI`, or `choco install kerfscript`                                   |
+| Windows (Scoop)  | `scoop bucket add mylasertools https://github.com/mylasertools/scoop-bucket`, then `scoop install kerfscript` |
+| Linux (Snap)     | `sudo snap install kerfscript`; the command is `kerfscript.kerf`                                              |
+| Arch Linux (AUR) | `kerfscript-bin`                                                                                              |
+| macOS (MacPorts) | `sudo port install kerfscript`                                                                                |
+| Docker           | `docker run --rm -v "$PWD:/work" --user "$(id -u):$(id -g)" ghcr.io/mylasertools/kerfscript render box.kerf`  |
+
+Package manager listings follow each release as they are approved. The
+binaries are not signed yet. On macOS, Homebrew and MacPorts install them
+without a warning; a downloaded `kerf` needs
+`xattr -d com.apple.quarantine kerf` once. On Windows, SmartScreen may warn
+the first time.
+
+Save a `.kerf` file from the [models](https://kerfscript.mylasertools.com/models/)
+to try these commands.
+
 ## Commands
 
 ```sh
 kerf render <file.kerf> [-o out.svg] [options]
-kerf params <file.kerf>     # settings as JSON
-kerf check <file.kerf>      # parts, sizes, cut length, sheets and warnings
+kerf params <file.kerf>
+kerf check <file.kerf>
 ```
 
+`render` exports SVG, DXF or JSON, using the output file's extension to
+choose the format. `params` lists the editable settings as JSON. `check`
+reports parts, dimensions, cut lengths, sheets and warnings.
+
 ## Options
 
-| Option                | What it does                                                           |
-| --------------------- | ---------------------------------------------------------------------- |
-| `-o, --out <file>`    | output file, `.svg`, `.dxf` or `.json`; default `<file>.svg`           |
-| `-D name=value`       | set a setting; the value is KerfScript: `40`, `"Oak"`, `true`, `[1,2]` |
-| `-p, --params <file>` | JSON file of setting values                                            |
-| `--font <file.ttf>`   | font for `text()`; repeat for more fonts. The name is the file name    |
-| `--kerf <mm>`         | override kerf compensation for every part                              |
-| `--sheet <W>x<H>`     | sheet size for packing, in mm                                          |
-| `--gap <mm>`          | space between packed parts                                             |
-| `--margin <mm>`       | space between the parts and the sheet edge (default: the gap)          |
-| `--no-pack`           | keep parts where the program placed them                               |
-| `--guides`            | include guide layer geometry                                           |
-| `--split`             | write one file per sheet (`out-1.svg`, `out-2.svg`, ...)               |
-| `-h, --help`          | show help                                                              |
-| `-v, --version`       | show the version                                                       |
+| Option                | Use                                                                       |
+| --------------------- | ------------------------------------------------------------------------- |
+| `-o, --out <file>`    | Output path ending in `.svg`, `.dxf` or `.json`; defaults to `<file>.svg` |
+| `-D name=value`       | Override a parameter; repeat for multiple values                          |
+| `-p, --params <file>` | Load parameter values from a JSON file                                    |
+| `--font <file.ttf>`   | Supply a font file; repeat for multiple fonts. `Atkinson` is built in     |
+| `--kerf <mm>`         | Override kerf for every part                                              |
+| `--sheet <W>x<H>`     | Set the sheet width and height in millimetres                             |
+| `--gap <mm>`          | Set spacing between parts                                                 |
+| `--margin <mm>`       | Set spacing at sheet edges; defaults to the gap                           |
+| `--no-pack`           | Keep the positions defined in the program                                 |
+| `--guides`            | Include the guide layer                                                   |
+| `--split`             | Export one file per sheet                                                 |
+| `-h, --help`          | Show command help                                                         |
+| `-v, --version`       | Show version numbers                                                      |
+
+`-D` accepts KerfScript values, including numbers, quoted strings, booleans
+and lists. For example: `-D width=200` or `-D 'name="Ada"'`.
 
 ## Examples
 
 ```sh
-kerf render sign.kerf -D 'name="Ada"' --font Inter-Bold.ttf -o ada.svg
+kerf render name-sign.kerf -D 'name="Ada"' --font Inter-Bold.ttf -o ada.svg
 kerf render box.kerf --sheet 400x300 --kerf 0.12 --split -o box.svg
 kerf render box.kerf -o box.dxf
 kerf check box.kerf
 ```
 
-Warnings go to standard error and do not stop the render. Errors stop it with
-the line and column, and a non-zero exit code.
+For multiple sheets, `--split` creates numbered files such as `box-1.svg`
+and `box-2.svg`. Use it for DXF exports of a design with several sheets.
+
+Warnings are written to standard error and allow rendering to continue.
+An error stops the command, reports its location when available and returns
+a non-zero exit code.
 
 ## Fonts
 
-KerfScript does not ship fonts and never reads system fonts, so a file
-renders the same everywhere. Pass the fonts a design uses with `--font`. A
-design that asks for `font = "Inter-Bold"` needs `--font Inter-Bold.ttf`; the
-first font given is the default.
+The CLI has one font built in, Atkinson Hyperlegible, as `Atkinson`: the same
+font and name as the playground. Text that names no font uses it.
+
+Supply other font files with `--font`. The CLI does not look up fonts
+installed on your system. `--font Inter-Bold.ttf` makes the font available
+as `Inter-Bold`. A design can request it with `font = "Inter-Bold"`. The
+first supplied font becomes the default for text that does not name one, and
+`Atkinson` stays available.

package/docs/compatibility.md

@@ -1,89 +1,64 @@
 # Laser software
 
-KerfScript writes ordinary SVG and DXF files, so any program that reads
-those can open them. This page says what we have actually checked, in which
-version, and what you still need to set up yourself.
+Export SVG or DXF from KerfScript, then set up the cutting job in your laser
+software. Check the imported size and layers before assigning power, speed
+and operation order.
 
 ## What is in the files
 
 **SVG**
 
-- Size in millimetres (`width="100mm"`), with a matching `viewBox`, so one
-  unit is one millimetre.
-- One group per layer, marked as an Inkscape layer and named after it:
-  `engrave`, your own layers, `score`, `cut`, `guide`.
-- Cut lines red `#ff0000`, score lines blue `#0000ff`, 0.1 mm hairline
-  strokes. Engraved areas are filled black `#000000` with the even-odd rule.
-- Holes and inner cuts come before outer outlines.
+- Millimetre dimensions with a matching `viewBox`.
+- Named layer groups for engraving, scoring, cutting and any custom layers.
+- Red cut paths, blue score paths and black filled engraving.
+- Inner cut paths before outer outlines in the file.
 
 **DXF**
 
-- R12 (AC1009) polylines, units set to millimetres.
-- One DXF layer per KerfScript layer, in capitals (`CUT`, `SCORE`,
-  `ENGRAVE`), with matching AutoCAD colours.
-- DXF R12 has no fills. Engraved areas arrive as outlines; set that layer to
-  fill in your laser software.
-- A DXF holds one sheet. Use `--split` for designs with several sheets.
+- R12 polylines with millimetre units.
+- Named layers such as `CUT`, `SCORE` and `ENGRAVE`.
+- Engraving as outlines. Set the engraving layer to fill in your laser software.
+- One sheet per file. Use the CLI's `--split` option for several sheets.
 
 ## Checked
 
-| Program  | Version | SVG | DXF | How                         |
-| -------- | ------- | --- | --- | --------------------------- |
-| Inkscape | 1.4.2   | yes | yes | automatic, `npm run compat` |
+| Program  | Version | SVG    | DXF    | Checks                           |
+| -------- | ------- | ------ | ------ | -------------------------------- |
+| Inkscape | 1.4.2   | Passed | Passed | Dimensions, layers and SVG fills |
 
-`npm run compat` renders six reference models (the calibration square, the
-kerf test, a six-panel finger-jointed box, a living hinge card, a coaster
-with an engraved ring, and a jigsaw puzzle), opens every SVG and DXF in
-Inkscape from the command line, and checks that:
-
-- the size of the drawing matches KerfScript's geometry within 0.02 mm,
-  kerf compensation included;
-- every layer arrives as a layer with the right name;
-- engraved layers are filled in the SVG.
-
-All six passed in both formats on 28 October 2026.
+Six reference models passed these import checks on 28 October 2026.
+Drawing dimensions matched within 0.02 mm, including kerf compensation.
+These results cover file imports; they do not establish a fit for a
+particular machine or material.
 
 ## Not checked yet
 
-We have not yet run the reference set through **LightBurn**, **xTool
-Studio** or **xTool Creative Space**, **RDWorks** or **LaserGRBL**, and we
-have not cut it on machines outside MyLaserTools. Until we have, treat them as
-untested: they read standard SVG and DXF, but each imports colours, layers
-and fills its own way.
-
-If you try one, we would like to hear what happened. The checklist below is
-what we look at.
+LightBurn, xTool Studio, xTool Creative Space, RDWorks and LaserGRBL have
+not yet been verified with the reference models. Import handling can differ
+between programs, especially for units, layer colours and fills.
 
 ## Checklist for a new program
 
-Open `calibration-square.svg` and `box.svg` from the
-[models](https://kerfscript.mylasertools.com/models/) and check:
-
-1. **Size.** The square is 100.15 mm wide with the default 0.15 mm kerf
-   (100 mm plus compensation), not 26.4 mm or 377.95 mm. If it is wrong, the
-   program ignored the millimetre units; look for an import DPI or unit
-   setting.
-2. **Layers.** Cut, score and engrave arrive as separate layers or colours,
-   so each can get its own power and speed.
-3. **Fill.** The engraved text on the square is filled, not just outlined.
-4. **Holes.** The hole in the square is cut, and engraving does not appear
-   inside it.
-5. **Order.** The program's cut order cuts holes before outlines. Most
-   programs have an "inner shapes first" option; turn it on.
-6. **Parts.** All six box panels arrive, none overlapping.
+Download the calibration square and box from the
+[models](https://kerfscript.mylasertools.com/models/) and check their imports:
 
-## What the file does not decide
+1. **Size:** the calibration square's cut path is 100.15 mm wide with
+   `$kerf = 0.15`, allowing for a finished 100 mm square. If the imported
+   size differs, check the unit and DPI settings.
+2. **Layers:** cutting, scoring and engraving can be assigned separate operations.
+3. **Fill:** engraved text has filled letters. For DXF, select fill in the
+   engraving layer's settings.
+4. **Holes:** cut holes remain open and contain no engraving.
+5. **Order:** the job preview cuts inner paths before outer outlines.
+6. **Parts:** the box contains all six panels without overlaps.
 
-The file describes geometry and layers. Your laser software decides how the
-machine runs it:
+## What the file does not decide
 
-- **Order of operations.** Layer order in an SVG is a hint. Most programs
-  sort operations themselves; check that engraving runs before cutting and
-  inner cuts before outer ones.
-- **Power, speed, passes and focus** for each layer and material.
-- **Material and thickness.** KerfScript records them per sheet; make sure
-  the file you send matches the sheet in the machine.
-- **Kerf.** If your laser software also applies kerf offset, turn one of them
-  off, or parts will be compensated twice.
+Set power, speed, passes and focus for your machine and material. Check the
+job preview for engraving before cutting and holes before outer outlines;
+laser software can reorder the paths in a file.
 
-Always run a test on scrap before cutting good material.
+For multiple sheets, use a separate file and matching material settings for
+each sheet. If KerfScript has already applied kerf compensation, leave the
+laser software's kerf offset at zero. Test the job on scrap before cutting
+the final material.

package/docs/customizer.md

@@ -1,9 +1,8 @@
 # Settings
 
-Top-level variables with a plain value become **settings**: sliders, menus,
-checkboxes and text boxes in the playground, on MyLaserTools, and in any tool
-that reads OpenSCAD customizer comments. The format is the same as
-OpenSCAD's.
+Expose dimensions, text and other choices as controls beside your design.
+Comments define sliders and menus, while the variable values provide their
+defaults. KerfScript uses OpenSCAD's customizer comment format.
 
 ```kerf
 /* [Size] */
@@ -24,39 +23,52 @@ wall = 3;
 rect([width, depth]);
 ```
 
+This example defines several control types. The rectangle uses `width`
+and `depth`; the other variables illustrate settings you can use elsewhere
+in a design.
+
 ## What becomes a setting
 
-A top-level assignment whose value is a number, a string, `true` or `false`,
-or a list of numbers. An expression like `width / 2` is not a setting; it is
-worked out from the others.
+A variable declared at the top level becomes a setting when its value is a
+number, string, boolean or list of numbers. Variables defined by expressions,
+such as `half_width = width / 2`, are calculated from the other values and
+do not get their own controls.
 
 ## Comments
 
-| Comment after the value           | Control                       |
-| --------------------------------- | ----------------------------- |
-| `// [40:5:400]`                   | slider from 40 to 400, step 5 |
-| `// [40:400]`                     | slider from 40 to 400         |
-| `// [200]`                        | number up to 200              |
-| `// [2, 3, 4]`                    | menu of those values          |
-| `// [round:Round, square:Square]` | menu with labels              |
-| none, on `true` or `false`        | checkbox                      |
-| none, on a string                 | text box                      |
-
-- `/* [Group name] */` starts a group for the settings below it.
-  `/* [Hidden] */` hides the ones that follow.
-- A `//` comment on its own line just above a setting is its caption.
-  A comment at the end of the line before does not count.
-- Put a blank line between a file's opening comment and its first setting,
-  so the opening comment is not taken as that setting's caption.
+Put a range or choice list after the assignment:
+
+| Comment after the value           | Control                              |
+| --------------------------------- | ------------------------------------ |
+| `// [40:5:400]`                   | Slider from 40 to 400, in steps of 5 |
+| `// [40:400]`                     | Slider from 40 to 400                |
+| `// [200]`                        | Number with an upper limit of 200    |
+| `// [2, 3, 4]`                    | Choice of 2, 3 or 4                  |
+| `// [round:Round, square:Square]` | Menu with a label for each value     |
+| No comment on a boolean           | Checkbox                             |
+| No comment on a string            | Text field                           |
+
+`/* [Size] */` starts a group named Size. `/* [Hidden] */` hides the
+settings that follow it, until another group begins.
+
+A `//` comment immediately above a variable supplies its caption. Keep the
+file's introductory comment separate with a blank line so it does not
+become the first setting's caption.
 
 ## Changing settings without editing the file
 
+The CLI accepts values with `-D` or a JSON file with `--params`:
+
 ```sh
-kerf render box.kerf -D width=200 -D 'label="Oak"'
-kerf render box.kerf --params oak.json
+kerf render box.kerf -D width=200
+kerf render box.kerf --params box-settings.json
 kerf params box.kerf
 ```
 
-`-D` values are KerfScript values, so strings need their quotes. `kerf params`
-prints the settings as JSON. From JavaScript, pass `params` to `render()` and
-read them with `parameters()`; see [JavaScript API](javascript.md).
+`box-settings.json` can contain `{"width": 200, "lid": false}`.
+Use `kerf params` to list a design's settings as JSON.
+
+String values need quotes, for example `-D 'label="Oak"'` for a design
+with a `label` setting. In JavaScript, pass values through `render()`'s
+`params` option and read the settings with `parameters()`. See the
+[JavaScript API](javascript.md).

package/docs/desktop.md

@@ -0,0 +1,96 @@
+# Desktop app
+
+The KerfScript app is the [playground](https://kerfscript.mylasertools.com/playground/)
+on your computer: the same editor, settings and preview, with your designs
+saved as `.kerf` files. It works offline.
+
+## Install
+
+Download the app for your system from the
+[releases](https://github.com/mylasertools/kerfscript/releases):
+
+| System  | File                                                                         |
+| ------- | ---------------------------------------------------------------------------- |
+| Windows | `kerfscript-desktop-<version>-windows-x64-setup.exe`, or the `.msi`          |
+| macOS   | `kerfscript-desktop-<version>-macos-universal.dmg` (Apple silicon and Intel) |
+| Linux   | `.AppImage`, `.deb` or `.rpm`, for x64 or arm64                              |
+
+Package manager listings (winget, Chocolatey, Flathub and the AUR) follow as
+each one is approved.
+
+The app is not signed with an Apple or Microsoft certificate yet:
+
+- **macOS** says the app cannot be checked for malicious software. Open it
+  once with right click → **Open**, or run
+  `xattr -d com.apple.quarantine /Applications/KerfScript.app`.
+- **Windows** SmartScreen may say it protected your PC. Choose
+  **More info** → **Run anyway**.
+
+## Files
+
+| Action                | Keys                                          |
+| --------------------- | --------------------------------------------- |
+| Open a `.kerf` file   | Ctrl+O (⌘O on a Mac), or the **Open…** button |
+| Save                  | Ctrl+S                                        |
+| Save under a new name | Ctrl+Shift+S, or **Save as…**                 |
+
+Double-click a `.kerf` file to open it in the app. The title bar shows the
+file name, or Untitled, and a dot when there are unsaved changes. The app asks
+before it closes, or opens another design or an example over them, also for a
+design you have not saved yet. A design can be up to 1,000,000 characters
+long, the same as in the playground. Saving writes the whole file before it
+replaces the old one, so a full disk or a crash cannot leave half a design.
+
+SVG, DXF and sheet ZIP exports open a save dialog in the design's folder.
+On Linux, a name typed without `.kerf`, `.svg`, `.dxf` or `.zip` gets it, and
+the app asks before replacing a file of that name.
+
+## LightBurn
+
+**Open in LightBurn** sends the cut file straight to
+[LightBurn](https://lightburnsoftware.com) 2.2 or later, through LightBurn's
+[REST API](https://github.com/LightBurnSoftware/LightBurn-REST). With several
+sheets, each sheet in the cut files list has its own **LightBurn** link.
+
+LightBurn has to be open on the same computer. The first time, LightBurn
+asks whether to allow KerfScript; choose **Allow** within 30 seconds. The
+window may open behind KerfScript. KerfScript asks only to send files: it
+cannot read your projects, change cut settings or start the laser.
+
+The file opens as a new LightBurn project, as if you had used File → Open,
+and LightBurn asks first if your current project has unsaved changes. Check
+the layers and cut settings in LightBurn before you run the job.
+
+To stop KerfScript sending files, remove it in LightBurn under
+Settings → Extensions → Manage API Authorizations.
+
+LightBurn is a trademark of LightBurn Software, Inc. KerfScript is not made,
+endorsed or certified by LightBurn Software.
+
+## Libraries
+
+`use <path>` and `include <path>` find files in the open design's folder and
+the folders below it: with the design at `projects/box.kerf`,
+`use <lib/tabs>` reads `projects/lib/tabs.kerf`. Unlike the
+[command line](cli.md), the app reads only `.kerf` files, and not from folders
+above the design's, such as `use <../shared/tabs>`; keep them next to the
+design or in a folder below it. That way a design you download cannot read
+other files on your computer. Standard library paths such as `use <kerf/box>` work
+everywhere. A design that has not been saved yet can only use the standard
+library.
+
+## Fonts
+
+`text()` uses Atkinson Hyperlegible, as in the playground. The app does not
+read fonts installed on your system yet; use the [command line](cli.md) with
+`--font` for other fonts.
+
+## About and licences
+
+**About** shows the app's version, a link to its source code, and the
+licences of KerfScript and of everything built into the app.
+
+## Sharing
+
+**Copy web link** copies a link that opens your code in the playground on the
+website, so people without the app can see it.