1681-engine 0.5.10 → 0.6.1

package/dist/types/ai/behaviorTree.d.ts

@@ -0,0 +1,133 @@
+/** What a node answers each tick: done well, done badly, or not done yet. */
+export type BtStatus = 'success' | 'failure' | 'running';
+/**
+ * One node of a tree. Nodes hold no state of their own, so one tree drives any number of agents: what a node must
+ * remember between ticks (the child a sequence is on, when a wait began) lives in the agent's memory, `run.state`.
+ */
+export interface BtNode<C> {
+    readonly kind: string;
+    /** Shown in a trace; actions and conditions are named after what they do. */
+    readonly name?: string;
+    readonly children: readonly BtNode<C>[];
+    tick(ctx: C, run: BtRun<C>): BtStatus;
+    /** A running node left behind (its parent moved on, the tree was reset): undo what it started. */
+    halt?(ctx: C, run: BtRun<C>): void;
+}
+/** What a node may use while it ticks: the agent's clock and memory, and its children's ticks. */
+export interface BtRun<C> {
+    /** The time this tick was given (ms), for waits, cooldowns and timeouts. */
+    readonly now: number;
+    /** This node's memory for this agent, made by `init` the first time and after a halt. */
+    state<T>(node: BtNode<C>, init: () => T): T;
+    /** Memory that outlives the node finishing (a cooldown's ready time); only `reset` clears it. */
+    lasting<T>(node: BtNode<C>, init: () => T): T;
+    /** Ticks a child; use this, never `child.tick`, so it is traced and halted right. */
+    tick(child: BtNode<C>, ctx: C): BtStatus;
+    /** Stops a child that was left running, and everything under it. */
+    halt(child: BtNode<C>, ctx: C): void;
+}
+/** One line of `BtAgent.trace`: a node, how deep it is, and what it last answered (null: not ticked this time). */
+export interface BtTraceLine {
+    depth: number;
+    kind: string;
+    name: string | undefined;
+    status: BtStatus | null;
+}
+/** A tree's root, and the agents it drives. */
+export declare class BehaviorTree<C> {
+    readonly root: BtNode<C>;
+    constructor(root: BtNode<C>);
+    /** A new agent on this tree, with memory of its own. */
+    agent(): BtAgent<C>;
+}
+/** One agent running a tree: its memory, and the tick that drives it. */
+export declare class BtAgent<C> implements BtRun<C> {
+    readonly root: BtNode<C>;
+    now: number;
+    private memory;
+    private readonly kept;
+    /** Nodes that answered 'running' last time they ticked: the ones a halt must reach. */
+    private readonly open;
+    private last;
+    private seen;
+    constructor(root: BtNode<C>);
+    /** Ticks the tree once at time `now` (ms) and returns the root's answer. */
+    update(ctx: C, now: number): BtStatus;
+    /** Halts whatever is running and forgets all memory: the agent starts the tree afresh (it died, it was stunned). */
+    reset(ctx: C): void;
+    /** Whether a node is running for this agent now. */
+    isRunning(node: BtNode<C>): boolean;
+    state<T>(node: BtNode<C>, init: () => T): T;
+    lasting<T>(node: BtNode<C>, init: () => T): T;
+    tick(child: BtNode<C>, ctx: C): BtStatus;
+    halt(child: BtNode<C>, ctx: C): void;
+    /** The tree as it ran on the last tick, depth first: for a debug overlay. */
+    trace(): BtTraceLine[];
+}
+/**
+ * A trace as text, one node a line, indented by depth, with what each answered (`·` when it was not ticked): for a
+ * debug overlay's `Text`, or a log.
+ *
+ * ```
+ * reactive-selector running
+ *   sequence failure
+ *     hurt failure
+ *     flee ·
+ *   wander running
+ * ```
+ */
+export declare function formatTrace(trace: readonly BtTraceLine[]): string;
+/**
+ * Runs its children in order until one fails: all must succeed. A running child is resumed on the next tick
+ * without asking the ones before it again (`reactiveSequence` does ask them).
+ */
+export declare function sequence<C>(...children: BtNode<C>[]): BtNode<C>;
+/** Tries its children in order until one does not fail: the first that works. Resumes a running child. */
+export declare function selector<C>(...children: BtNode<C>[]): BtNode<C>;
+/**
+ * A sequence that asks every child from the first again on each tick: a guard in front ("still sees the player?")
+ * is checked every time, and when it fails the child that was running is halted.
+ */
+export declare function reactiveSequence<C>(...children: BtNode<C>[]): BtNode<C>;
+/**
+ * A selector that asks from the first child again on each tick: a higher-priority branch ("flee when hurt") takes
+ * over the moment it can run, halting the lower one it interrupts.
+ */
+export declare function reactiveSelector<C>(...children: BtNode<C>[]): BtNode<C>;
+export interface ParallelPolicy {
+    /** Children that must succeed for the whole to (default all). */
+    succeed?: number;
+    /** Children that must fail for the whole to (default 1). */
+    fail?: number;
+}
+/**
+ * Ticks every child each tick (walk and look about at once). Succeeds once `succeed` have succeeded, fails once
+ * `fail` have failed, halting the rest; a child that finished is not ticked again until the whole finishes.
+ */
+export declare function parallel<C>(policy: ParallelPolicy, ...children: BtNode<C>[]): BtNode<C>;
+/** Swaps success and failure. */
+export declare function invert<C>(child: BtNode<C>): BtNode<C>;
+/** Succeeds whatever its child answers, once the child is done: an optional step. */
+export declare function succeed<C>(child: BtNode<C>): BtNode<C>;
+/**
+ * Runs its child `times` times in a row (Infinity: for good), stopping at the first failure. One pass per tick at
+ * most, so a child that succeeds at once cannot spin a frame.
+ */
+export declare function repeat<C>(times: number, child: BtNode<C>): BtNode<C>;
+/** Tries its child up to `times` times until it succeeds, a try a tick. */
+export declare function retry<C>(times: number, child: BtNode<C>): BtNode<C>;
+/** Runs its child at most once every `ms`: after it finishes, it fails at once until the time is up. */
+export declare function cooldown<C>(ms: number, child: BtNode<C>): BtNode<C>;
+/** Fails, halting its child, when the child has run longer than `ms`. */
+export declare function timeout<C>(ms: number, child: BtNode<C>): BtNode<C>;
+/** Runs for `ms`, then succeeds. */
+export declare function wait<C>(ms: number): BtNode<C>;
+/** A test: success when `test` holds, else failure. Never runs. */
+export declare function condition<C>(name: string, test: (ctx: C) => boolean): BtNode<C>;
+export interface ActionOptions<C> {
+    /** The action was running and the tree left it (a higher branch took over): stop what it started. */
+    onHalt?: (ctx: C) => void;
+}
+/** Something the agent does: `run` answers each tick until the doing is done. */
+export declare function action<C>(name: string, run: (ctx: C, now: number) => BtStatus, options?: ActionOptions<C>): BtNode<C>;
+//# sourceMappingURL=behaviorTree.d.ts.map

package/dist/types/ai/behaviorTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"behaviorTree.d.ts","sourceRoot":"","sources":["../../../src/ai/behaviorTree.ts"],"names":[],"mappings":"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"}

package/dist/types/ai/buildTree.d.ts

@@ -0,0 +1,55 @@
+import { type ActionOptions, type BtNode, type BtStatus } from './behaviorTree.js';
+/**
+ * A tree written as data (a JSON file a designer edits): composites hold `children`, decorators one `child`, and
+ * leaves name an action or a condition the game registered.
+ *
+ * ```json
+ * { "type": "reactiveSelector", "children": [
+ *   { "type": "sequence", "children": [{ "type": "condition", "name": "hurt" }, { "type": "action", "name": "flee" }] },
+ *   { "type": "cooldown", "ms": 2000, "child": { "type": "action", "name": "bark" } },
+ *   { "type": "action", "name": "wander" }
+ * ] }
+ * ```
+ */
+export type BtSpec = {
+    type: 'sequence' | 'selector' | 'reactiveSequence' | 'reactiveSelector';
+    children: BtSpec[];
+} | {
+    type: 'parallel';
+    succeed?: number;
+    fail?: number;
+    children: BtSpec[];
+} | {
+    type: 'invert' | 'succeed';
+    child: BtSpec;
+} | {
+    type: 'repeat' | 'retry';
+    times: number;
+    child: BtSpec;
+} | {
+    type: 'cooldown' | 'timeout';
+    ms: number;
+    child: BtSpec;
+} | {
+    type: 'wait';
+    ms: number;
+} | {
+    type: 'action' | 'condition';
+    name: string;
+}
+/** A named subtree of the registry, so a tree is shared by several (a "flee" every monster uses). */
+ | {
+    type: 'tree';
+    name: string;
+};
+/** What the leaves of a data tree name. */
+export interface BtRegistry<C> {
+    actions?: Record<string, ((ctx: C, now: number) => BtStatus) | ({
+        run: (ctx: C, now: number) => BtStatus;
+    } & ActionOptions<C>)>;
+    conditions?: Record<string, (ctx: C) => boolean>;
+    trees?: Record<string, BtSpec>;
+}
+/** A tree from its data. Throws, naming the path, on an unknown type, a missing leaf or a subtree that names itself. */
+export declare function buildTree<C>(spec: BtSpec, registry: BtRegistry<C>): BtNode<C>;
+//# sourceMappingURL=buildTree.d.ts.map

package/dist/types/ai/buildTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildTree.d.ts","sourceRoot":"","sources":["../../../src/ai/buildTree.ts"],"names":[],"mappings":"AAAA,OAAO,EAeL,KAAK,aAAa,EAClB,KAAK,MAAM,EACX,KAAK,QAAQ,EACd,MAAM,gBAAgB,CAAC;AAExB;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,MAAM,GACd;IAAE,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GAC/F;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,QAAQ,GAAG,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAChD,qGAAqG;GACnG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC,2CAA2C;AAC3C,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,KAAK,QAAQ,CAAC,IAAG;QAAE,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,KAAK,QAAQ,CAAA;KAAE,GAAG,aAAa,CAAC,CAAC,CAAC,CAAA,CAAC,CAAC;IAC9H,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,wHAAwH;AACxH,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAE7E"}

package/dist/types/audio/spatial.d.ts

@@ -0,0 +1,107 @@
+/** A point in the world, px. */
+export interface Point {
+    readonly x: number;
+    readonly y: number;
+}
+export interface SpatialMixOptions {
+    /** Beyond this (px) the source is not heard (default 480). */
+    range?: number;
+    /** How the loudness falls off: 1 straight, higher drops faster near the edge of `range` (default 1.5). */
+    rolloff?: number;
+    /** Px off to one side at which the sound is panned fully that way (default `range / 2`). */
+    panWidth?: number;
+    /** The furthest it pans, 0–1: 1 is one ear only, which sounds wrong on headphones (default 0.8). */
+    maxPan?: number;
+    /** Low-pass cutoff (Hz) beside the listener and at the edge of `range`, so far sounds are dull; null for none. */
+    muffle?: readonly [number, number] | null;
+}
+/** How a source sounds from where the listener stands. */
+export interface SpatialMix {
+    /** Within `range`. */
+    audible: boolean;
+    /** 0–1. */
+    gain: number;
+    /** −1 left … 1 right. */
+    pan: number;
+    /** The low-pass cutoff, Hz (the top of hearing when `muffle` is null). */
+    cutoffHz: number;
+}
+/** The mix of a source at `source` heard from `listener`: louder near, panned to its side, duller far. */
+export declare function spatialMix(listener: Point, source: Point, options?: SpatialMixOptions): SpatialMix;
+export interface EmitterOptions extends SpatialMixOptions {
+    /** 0–1 (default 1). */
+    volume?: number;
+    /** Plays on for good (default true); a one-shot ends by itself. */
+    loop?: boolean;
+    playbackRate?: number;
+}
+/** A sound placed in the world by `SpatialAudio`. */
+export interface SpatialEmitter {
+    x: number;
+    y: number;
+    volume: number;
+    /** Playing now: false while out of range (a loop waits silent), and for good once stopped or ended. */
+    readonly playing: boolean;
+    readonly done: boolean;
+    stop(fadeMs?: number): void;
+}
+/**
+ * Sounds placed in the world, heard from a listener that moves: a waterfall, a campfire, a machine humming, or a
+ * one-shot at a spot. Each emitter is panned to its side, fades with distance and loses its highs far away
+ * (`spatialMix`), eased each `update` so a moving source does not click. A loop out of range stops its source to
+ * save the voice and starts again at the point it would have reached, so it seems to have played on.
+ *
+ * ```ts
+ * const world = new SpatialAudio(audioContext);
+ * const falls = world.emitter(fallsBuffer, 320, 96, { range: 400, volume: 0.6 });
+ * // each frame: world.update(hero);
+ * ```
+ */
+export declare class SpatialAudio {
+    readonly context: BaseAudioContext;
+    /** Every emitter's gain goes through this: the game's volume setting. */
+    readonly output: GainNode;
+    private readonly emitters;
+    private here;
+    constructor(context: BaseAudioContext, destination?: AudioNode);
+    /** The listener's place as of the last `update`. */
+    get listener(): Point;
+    /** How many emitters are alive (playing or waiting out of range). */
+    get size(): number;
+    /** A sound at (x, y), looping by default. Starts at once when in range of the listener. */
+    emitter(buffer: AudioBuffer, x: number, y: number, options?: EmitterOptions): SpatialEmitter;
+    /** A one-shot at (x, y), dropped when it ends; skipped (and done at once) when out of range. */
+    play(buffer: AudioBuffer, x: number, y: number, options?: Omit<EmitterOptions, 'loop'>): SpatialEmitter;
+    /** Moves the listener and re-mixes every emitter. Call once a frame. */
+    update(listener?: Point): void;
+    /** Stops every emitter. */
+    stopAll(fadeMs?: number): void;
+    destroy(): void;
+    /** @internal */
+    forget(e: Emitter): void;
+}
+declare class Emitter implements SpatialEmitter {
+    private readonly owner;
+    private readonly buffer;
+    x: number;
+    y: number;
+    private readonly options;
+    volume: number;
+    done: boolean;
+    private source;
+    private readonly gain;
+    private readonly panner;
+    private readonly filter;
+    /** When the loop would have begun, had it never stopped: where a restart picks it up. */
+    private readonly origin;
+    private readonly rate;
+    constructor(owner: SpatialAudio, buffer: AudioBuffer, x: number, y: number, options: EmitterOptions);
+    get playing(): boolean;
+    refresh(listener: Point, smooth: boolean): void;
+    stop(fadeMs?: number): void;
+    private begin;
+    private halt;
+    private release;
+}
+export {};
+//# sourceMappingURL=spatial.d.ts.map

package/dist/types/audio/spatial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spatial.d.ts","sourceRoot":"","sources":["../../../src/audio/spatial.ts"],"names":[],"mappings":"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"}

package/dist/types/core/Camera.d.ts

@@ -34,6 +34,8 @@ export declare class Camera {
     resolution: number;
     /** Lands the view on whole backing pixels (pixel art); off, the world moves smoothly between them. */
     roundPixels: boolean;
+    /** The world is drawn on its own pixel grid (`Stage.pixelPerfect`): `snapRoot` lands on whole world pixels. Set by the stage. */
+    pixelGrid: boolean;
     scrollX: number;
     scrollY: number;
     width: number;
@@ -57,6 +59,12 @@ export declare class Camera {
     setZoom(z: number): this;
     /** A world coordinate snapped to the nearest backing pixel: one screen pixel, or a half at ×1.5. */
     snap(v: number): number;
+    /**
+     * Where an object's root lands (a body, and whatever is laid over one): a whole world pixel while the world is drawn
+     * on its own grid (`Stage.pixelPerfect`), else `snap`. One rule for every root, so a body, what it holds and what
+     * points at it fall on the same pixel; children keep whole-pixel offsets from it.
+     */
+    snapRoot(v: number): number;
     setBounds(x: number, y: number, width: number, height: number): this;
     /** Lets the view go anywhere again. */
     clearBounds(): this;

package/dist/types/core/Camera.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Camera.d.ts","sourceRoot":"","sources":["../../../src/core/Camera.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Camera.d.ts","sourceRoot":"","sources":["../../../src/core/Camera.ts"],"names":[],"mappings":"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"}

package/dist/types/core/ObjectFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ObjectFactory.d.ts","sourceRoot":"","sources":["../../../src/core/ObjectFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AAE9C,6FAA6F;AAC7F,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,KAAK;IAEzC,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK;IAIxE;;;OAGG;IACH,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,GAAG,KAAK;IAS9C,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,QAAQ;IAMrD,SAAS,CAAC,CAAC,SAAI,EAAE,CAAC,SAAI,EAAE,QAAQ,GAAE,SAAS,EAAO,GAAG,KAAK;IAO1D,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,SAAS;IAM1F,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAIhE,oGAAoG;IACpG,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,SAAK,GAAG,WAAW;IAI7K,mHAAmH;IACnH,QAAQ,CAAC,CAAC,SAAS,SAAS,GAAG;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC;IAI3D,OAAO,CAAC,MAAM;CAKf"}
+{"version":3,"file":"ObjectFactory.d.ts","sourceRoot":"","sources":["../../../src/core/ObjectFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AAE9C,6FAA6F;AAC7F,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,KAAK;IAEzC,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK;IAIxE;;;OAGG;IACH,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,GAAG,KAAK;IAS9C,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,QAAQ;IAMrD,SAAS,CAAC,CAAC,SAAI,EAAE,CAAC,SAAI,EAAE,QAAQ,GAAE,SAAS,EAAO,GAAG,KAAK;IAO1D,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,SAAS;IAM1F,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAMhE,oGAAoG;IACpG,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,SAAK,GAAG,WAAW;IAM7K,mHAAmH;IACnH,QAAQ,CAAC,CAAC,SAAS,SAAS,GAAG;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC;IAI3D,OAAO,CAAC,MAAM;CAKf"}

package/dist/types/core/PixelGrid.d.ts

@@ -0,0 +1,30 @@
+import { type Application, type Container } from 'pixi.js';
+import type { Camera } from './Camera.js';
+import { SharpText } from './SharpText.js';
+/**
+ * A pixel-perfect world (`Stage.pixelPerfect`): the world layer is taken off the stage and drawn each frame into a
+ * texture of one texel per world pixel, whose origin sits on a whole world pixel, then shown at the camera's zoom and
+ * moved by the scroll's fraction, so the camera still glides one backing pixel at a time. Everything turned, scaled or
+ * placed between pixels lands on the same grid as the rest of the art, so no pixel on screen is drawn at another size
+ * ("mixels"); the world is also filled at 1/zoom² of the screen's pixels. Roots placed with `Camera.snapRoot` land on
+ * whole world pixels meanwhile, and text stays at screen resolution (`SharpText`).
+ */
+export declare class PixelGrid {
+    private readonly app;
+    private readonly world;
+    private texture;
+    private sprite;
+    readonly text: SharpText;
+    private readonly transform;
+    private on;
+    constructor(app: Application, world: Container);
+    get enabled(): boolean;
+    /** Once a frame, after the camera wrote the world's transform and before Pixi draws the screen. */
+    render(cam: Camera, enabled: boolean): void;
+    destroy(cam: Camera): void;
+    private enable;
+    private disable;
+    /** The texture at exactly this size, made again only when the screen or the zoom changed. */
+    private fit;
+}
+//# sourceMappingURL=PixelGrid.d.ts.map

package/dist/types/core/PixelGrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PixelGrid.d.ts","sourceRoot":"","sources":["../../../src/core/PixelGrid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAC1F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;;;;;GAOG;AACH,qBAAa,SAAS;IAQlB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IARxB,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,MAAM,CAAuB;IACrC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,EAAE,CAAS;gBAGA,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,SAAS;IAKnC,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,mGAAmG;IACnG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAmB3C,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK1B,OAAO,CAAC,MAAM;IAWd,OAAO,CAAC,OAAO;IAef,6FAA6F;IAC7F,OAAO,CAAC,GAAG;CAOZ"}

package/dist/types/core/SharpText.d.ts

@@ -0,0 +1,32 @@
+import { Container } from 'pixi.js';
+/**
+ * The world's text kept at screen resolution while the rest of the world is drawn one texel to a world pixel
+ * (`PixelGrid`): a small font squeezed into world pixels cannot be read. Each tracked label (every `add.text` and
+ * `add.label`; `Stage.keepSharp` for one made elsewhere) is lifted out of the container it was put in and hung on a
+ * stand-in on this layer, which copies that container's transform relative to the world, its visibility and alpha every
+ * frame, so the game keeps writing the label's own position, text and alpha as before. All of them draw over the world,
+ * sorted by the depth of the world's child they belong to; a label's container destroyed takes the label with it.
+ */
+export declare class SharpText {
+    private readonly world;
+    readonly layer: Container<import("pixi.js").ContainerChild>;
+    private readonly labels;
+    private readonly m;
+    /** Labels tracked since the last sweep for destroyed ones: off, nothing else sweeps them. */
+    private sinceSweep;
+    constructor(world: Container);
+    track(obj: Container): void;
+    /** Lays the layer over the world (`origin`: where the world's origin lands on screen) and every label on its home. */
+    sync(origin: {
+        x: number;
+        y: number;
+    }, zoom: number): void;
+    /** Every label back in its home (the grid switched off), the stand-ins gone. */
+    release(): void;
+    /** Forgets labels the game destroyed while nothing synced (the grid off). */
+    prune(): void;
+    destroy(): void;
+    private place;
+    private drop;
+}
+//# sourceMappingURL=SharpText.d.ts.map

package/dist/types/core/SharpText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SharpText.d.ts","sourceRoot":"","sources":["../../../src/core/SharpText.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAU,MAAM,SAAS,CAAC;AAU5C;;;;;;;GAOG;AACH,qBAAa,SAAS;IAOR,OAAO,CAAC,QAAQ,CAAC,KAAK;IANlC,QAAQ,CAAC,KAAK,8CAA6C;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAgB;IAClC,6FAA6F;IAC7F,OAAO,CAAC,UAAU,CAAK;gBAEM,KAAK,EAAE,SAAS;IAE7C,KAAK,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI;IAK3B,sHAAsH;IACtH,IAAI,CAAC,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IA4B1D,gFAAgF;IAChF,OAAO,IAAI,IAAI;IAiBf,6EAA6E;IAC7E,KAAK,IAAI,IAAI;IAKb,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,KAAK;IAyBb,OAAO,CAAC,IAAI;CAIb"}

package/dist/types/core/Stage.d.ts

@@ -25,6 +25,15 @@ export declare abstract class Stage {
     readonly input: {
         activePointer: Pointer;
     };
+    /**
+     * Pixel-perfect: the world drawn one texel to a world pixel and scaled up by the camera's zoom (`PixelGrid`), so turned,
+     * scaled and between-pixels art lands on one grid; text made by `add.text`/`add.label` stays at screen resolution.
+     * Off (the default), the world is drawn straight at the zoom. Takes effect on the next frame; may be switched any time.
+     */
+    pixelPerfect: boolean;
+    private readonly grid;
+    /** Whether the grid drew last frame, so the frame it is switched off still takes it down. */
+    private gridLive;
     private readonly resizeListeners;
     private lastWidth;
     private lastHeight;
@@ -41,6 +50,11 @@ export declare abstract class Stage {
      * good — the canvas frozen and no input reaching the server (seen on Android).
      */
     frame(delta: number): void;
+    /**
+     * Keeps a piece of text made outside `add.text`/`add.label` (put on the world any way) at screen resolution while the
+     * world is pixel-perfect. Those two do it themselves.
+     */
+    keepSharp(obj: Container): void;
     private readonly reported;
     /**
      * Runs one step of a frame and swallows what it throws, so the steps after it still run. Subclasses guard the parts

package/dist/types/core/Stage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Stage.d.ts","sourceRoot":"","sources":["../../../src/core/Stage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;GAGG;AACH,8BAAsB,KAAK;IAgBvB,QAAQ,CAAC,GAAG,EAAE,WAAW;IACzB,QAAQ,CAAC,QAAQ,EAAE,eAAe;IAhBpC,yFAAyF;IACzF,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAEvE,QAAQ,CAAC,KAAK,8CAA6C;IAC3D,QAAQ,CAAC,MAAM,8CAAmB;IAClC,QAAQ,CAAC,GAAG,gBAA2B;IACvC,QAAQ,CAAC,MAAM,UAAiB;IAChC,QAAQ,CAAC,IAAI,QAAe;IAC5B,QAAQ,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE;QAAE,aAAa,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsB;IACtD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAK;gBAGZ,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,eAAe;IAUpC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,6GAA6G;IAC7G,QAAQ,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAQpC,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAEjD;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAS1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAE9C;;;;OAIG;IACH,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;IAInD,2EAA2E;IAC3E,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC;IAS/D,iIAAiI;IACjI,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI;IASlD,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,QAAQ;CAWjB"}
+{"version":3,"file":"Stage.d.ts","sourceRoot":"","sources":["../../../src/core/Stage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;GAGG;AACH,8BAAsB,KAAK;IAyBvB,QAAQ,CAAC,GAAG,EAAE,WAAW;IACzB,QAAQ,CAAC,QAAQ,EAAE,eAAe;IAzBpC,yFAAyF;IACzF,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAEvE,QAAQ,CAAC,KAAK,8CAA6C;IAC3D,QAAQ,CAAC,MAAM,8CAAmB;IAClC,QAAQ,CAAC,GAAG,gBAA2B;IACvC,QAAQ,CAAC,MAAM,UAAiB;IAChC,QAAQ,CAAC,IAAI,QAAe;IAC5B,QAAQ,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE;QAAE,aAAa,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3C;;;;OAIG;IACH,YAAY,UAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAY;IACjC,6FAA6F;IAC7F,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsB;IACtD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAK;gBAGZ,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,eAAe;IAWpC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,6GAA6G;IAC7G,QAAQ,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAQpC,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAEjD;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAc1B;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI;IAI/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAE9C;;;;OAIG;IACH,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;IAInD,2EAA2E;IAC3E,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC;IAS/D,iIAAiI;IACjI,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI;IASlD,OAAO,IAAI,IAAI;IAUf,OAAO,CAAC,QAAQ;CAWjB"}

package/dist/types/core/gridPlacement.d.ts

@@ -0,0 +1,20 @@
+/** Where the world's grid texture goes this frame (`gridPlacement`). */
+export interface GridPlacement {
+    /** The world pixel the texture's top-left texel shows. */
+    readonly tx: number;
+    readonly ty: number;
+    /** The texture's size in texels: the screen's width and height in world pixels, plus room for the fraction. */
+    readonly width: number;
+    readonly height: number;
+    /** Where the texture's top-left corner lands on screen (screen px, whole backing pixels). */
+    readonly x: number;
+    readonly y: number;
+}
+/**
+ * The pixel grid's arithmetic (`PixelGrid`). `originX/Y` is where the camera put the world's origin on screen (the
+ * scroll, plus any shake), `zoom` screen pixels a world pixel, `resolution` backing pixels a screen pixel. The texture
+ * starts on the whole world pixel at the screen's corner and is moved by what is left over, rounded to a backing pixel,
+ * so a world pixel never lands between two.
+ */
+export declare function gridPlacement(originX: number, originY: number, zoom: number, resolution: number, screenWidth: number, screenHeight: number): GridPlacement;
+//# sourceMappingURL=gridPlacement.d.ts.map

package/dist/types/core/gridPlacement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gridPlacement.d.ts","sourceRoot":"","sources":["../../../src/core/gridPlacement.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,+GAA+G;IAC/G,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6FAA6F;IAC7F,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,aAAa,CAY1J"}

package/dist/types/dialogue/DialogueRunner.d.ts

@@ -0,0 +1,78 @@
+import { type ExprValue } from './expr.js';
+import type { DialogueScript, DialogueStep } from './script.js';
+export interface DialogueOptions {
+    /** The variables conditions read and `set` writes; shared with the game (default a fresh object). */
+    vars?: Record<string, unknown>;
+    /** Functions an expression may call, beside the built-in `visited(node)` and `chose(node, index)`. */
+    functions?: Record<string, (...args: ExprValue[]) => ExprValue>;
+    /** A `do` command: what the game does for it. */
+    onCommand?: (name: string, args: readonly unknown[], runner: DialogueRunner) => void;
+    /** A line's or a choice's text in the player's language, before `{…}` is filled in (default as written). */
+    translate?: (text: string, key: string | undefined) => string;
+}
+/** Where a dialogue was, and what it knew, for a save: plain data. */
+export interface DialogueSave {
+    node: string | null;
+    line: number;
+    vars: Record<string, unknown>;
+    visits: Record<string, number>;
+    chosen: string[];
+}
+/**
+ * Runs a `DialogueScript`: hands the game one step at a time — a line, a set of choices, the end — and moves on when
+ * the game says the line was read (`next`) or a choice made (`choose`). It draws nothing: the game's own box shows a
+ * `ShownLine` however it likes (a typewriter, a portrait from `tags`).
+ *
+ * ```ts
+ * const talk = new DialogueRunner(script, { vars: save.flags, onCommand: (name, args) => game.run(name, args) });
+ * let step = talk.start();
+ * // on a press: step = step.type === 'line' ? talk.next() : talk.choose(picked);
+ * ```
+ */
+export declare class DialogueRunner {
+    readonly script: DialogueScript;
+    private readonly options;
+    readonly vars: Record<string, unknown>;
+    private node;
+    private line;
+    private step;
+    private readonly visits;
+    private readonly chosen;
+    private readonly scope;
+    constructor(script: DialogueScript, options?: DialogueOptions);
+    /** The step showing now. */
+    get current(): DialogueStep;
+    /** The node the dialogue is in, or null once it has ended. */
+    get at(): string | null;
+    /** How many times a node was entered. */
+    visited(node: string): number;
+    /** Begins at `node` (default the script's `start`, else its first node). */
+    start(node?: string | undefined): DialogueStep;
+    /** The line showing was read: on to the next line, the choices, or wherever the node leads. */
+    next(): DialogueStep;
+    /** Picks a choice by its `index` (as shown). A locked or unknown index changes nothing. */
+    choose(index: number): DialogueStep;
+    /** Jumps to a node from outside (the game's own event broke in). */
+    jump(node: string): DialogueStep;
+    /** Ends the dialogue now. */
+    stop(): DialogueStep;
+    /** The value of an expression over this dialogue's variables, for a game that shares the language. */
+    evaluate(source: string): ExprValue;
+    save(): DialogueSave;
+    /** Puts a saved dialogue back where it was, without running the node's `set` and `do` again. */
+    restore(save: DialogueSave): DialogueStep;
+    private go;
+    private enter;
+    /** The step from the current line on: the next line that holds, else the choices, else the way on. */
+    private show;
+    private offered;
+    private wayOn;
+    private finish;
+    private nodeOf;
+    private test;
+    private assign;
+    private run;
+    /** `text` translated, with each `{expression}` replaced by its value; `{{` and `}}` are braces. */
+    private text;
+}
+//# sourceMappingURL=DialogueRunner.d.ts.map

package/dist/types/dialogue/DialogueRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DialogueRunner.d.ts","sourceRoot":"","sources":["../../../src/dialogue/DialogueRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,KAAK,EAA+D,cAAc,EAAE,YAAY,EAAe,MAAM,UAAU,CAAC;AAEvI,MAAM,WAAW,eAAe;IAC9B,qGAAqG;IACrG,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,sGAAsG;IACtG,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,SAAS,EAAE,KAAK,SAAS,CAAC,CAAC;IAChE,iDAAiD;IACjD,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,OAAO,EAAE,EAAE,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;IACrF,4GAA4G;IAC5G,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,CAAC;CAC/D;AAED,sEAAsE;AACtE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAKD;;;;;;;;;;GAUG;AACH,qBAAa,cAAc;IAUvB,QAAQ,CAAC,MAAM,EAAE,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAV1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,OAAO,CAAC,IAAI,CAAuB;IACnC,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,IAAI,CAAiC;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;gBAGvB,MAAM,EAAE,cAAc,EACd,OAAO,GAAE,eAAoB;IAgBhD,4BAA4B;IAC5B,IAAI,OAAO,IAAI,YAAY,CAE1B;IAED,8DAA8D;IAC9D,IAAI,EAAE,IAAI,MAAM,GAAG,IAAI,CAEtB;IAED,yCAAyC;IACzC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI7B,4EAA4E;IAC5E,KAAK,CAAC,IAAI,qBAAyD,GAAG,YAAY;IAKlF,+FAA+F;IAC/F,IAAI,IAAI,YAAY;IAMpB,2FAA2F;IAC3F,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY;IAYnC,oEAAoE;IACpE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;IAIhC,6BAA6B;IAC7B,IAAI,IAAI,YAAY;IAIpB,sGAAsG;IACtG,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IAInC,IAAI,IAAI,YAAY;IAUpB,gGAAgG;IAChG,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY;IAazC,OAAO,CAAC,EAAE;IAIV,OAAO,CAAC,KAAK;IAab,sGAAsG;IACtG,OAAO,CAAC,IAAI;IAgBZ,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,KAAK;IAOb,OAAO,CAAC,MAAM;IAKd,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,MAAM;IAOd,OAAO,CAAC,GAAG;IAOX,mGAAmG;IACnG,OAAO,CAAC,IAAI;CASb"}

package/dist/types/dialogue/expr.d.ts

@@ -0,0 +1,12 @@
+export type ExprValue = number | string | boolean | null | undefined;
+/** What an expression reads: variables by (dotted) name, and the functions it may call. */
+export interface ExprScope {
+    get(name: string): unknown;
+    call(name: string, args: ExprValue[]): ExprValue;
+}
+export type CompiledExpr = (scope: ExprScope) => ExprValue;
+/** Compiles `src`; throws with what and where on a syntax error. */
+export declare function compileExpr(src: string): CompiledExpr;
+/** `compileExpr`, kept: a script asks the same few conditions again and again. */
+export declare function expr(src: string): CompiledExpr;
+//# sourceMappingURL=expr.d.ts.map

package/dist/types/dialogue/expr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expr.d.ts","sourceRoot":"","sources":["../../../src/dialogue/expr.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAErE,2FAA2F;AAC3F,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,SAAS,CAAC;CAClD;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,SAAS,CAAC;AAsD3D,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAgHrD;AAID,kFAAkF;AAClF,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAQ9C"}