@sagl/server 0.0.0-stage → 0.1.0-next.49

package/dist/camera.d.ts

@@ -0,0 +1,188 @@
+import type { NativeServer } from "./native.js";
+import type { Vector3 } from "./player.js";
+type ThingRef = number | {
+    id: number;
+};
+/** A player, ped or vehicle the camera follows, with an offset from its middle. */
+export type CameraThing = {
+    player: ThingRef;
+    offset?: Vector3;
+} | {
+    ped: ThingRef;
+    offset?: Vector3;
+} | {
+    vehicle: ThingRef;
+    offset?: Vector3;
+};
+/** What a camera looks at: a spot, or a player, ped or vehicle it follows (with an offset). */
+export type CameraTarget = Vector3 | CameraThing;
+/** Where a camera is: a spot, or riding along with a player, ped or vehicle (`relative`: the offset turns with it). */
+export type CameraPosition = Vector3 | (CameraThing & {
+    relative?: boolean;
+});
+/**
+ * Depth of field's focus: metres from the camera, a spot or a player, ped
+ * or vehicle (with an offset) kept in focus, `"auto"` (the middle of the
+ * screen), or `null` (off).
+ */
+export type CameraFocus = number | CameraTarget | "auto" | null;
+/** Angles, in degrees: pan from north, anticlockwise (as headings); tilt up from level. */
+export interface CameraRotation {
+    pan: number;
+    tilt?: number;
+}
+/** How a move speeds up and slows down. `true` is `"inOut"`, `false` `"linear"`. */
+export type CameraEase = "linear" | "in" | "out" | "inOut" | boolean;
+export interface CameraShot {
+    /** Where the camera is. */
+    position: CameraPosition;
+    /** What it looks at. Leave out (with no `rotation`) to keep looking the way it was. */
+    lookAt?: CameraTarget;
+    /** Instead of `lookAt`: pan and tilt. Ridden along `relative`, pan is from the thing's heading. */
+    rotation?: CameraRotation;
+    /** Degrees, clockwise. Left out: as it was. */
+    roll?: number;
+    /** Field of view, 5 to 120 degrees (the game's is 70). Left out: as it was. */
+    fov?: number;
+    /**
+     * Depth of field: sharp at this many metres from the camera, at a spot,
+     * on a player, ped or vehicle (with an offset; kept in focus as it and
+     * the camera move), or `"auto"` (whatever's in the middle of the screen);
+     * `null` turns it off. Left out: as it was.
+     */
+    focus?: CameraFocus;
+    /** How shallow the focus is, as a lens's f-number: lower blurs more. Default 4. */
+    aperture?: number;
+    /** Glides here from where the camera is over this long (ms). Default 0: a cut. */
+    ms?: number;
+    /** Default `"inOut"`. */
+    ease?: CameraEase;
+    /**
+     * Cinematic: black bars top and bottom, and every HUD put away (the
+     * game's, the chat, name tags, scripts' HUDs) until `reset()`. On `set`
+     * and `play`'s options.
+     */
+    widescreen?: boolean;
+}
+/** A point on a path: a spot, with per-point angles, roll and field of view if wanted. */
+export type CameraPathPoint = Vector3 & {
+    pan?: number;
+    tilt?: number;
+    roll?: number;
+    fov?: number;
+};
+export interface CameraPath {
+    /** The points it flies through (2 to 256 in a sequence). It starts at the first: a cut there. */
+    path: CameraPathPoint[];
+    /** How long the whole path takes (ms). Or `speed`. */
+    ms?: number;
+    /** Metres a second, when `ms` isn't given. Default 10. Either way it moves evenly along the curve. */
+    speed?: number;
+    /** 0: straight lines between points; 1 (default): a smooth curve through every point. */
+    smoothing?: number;
+    /**
+     * What it looks at: `"ahead"` (where it's heading), a spot, a thing it
+     * follows, or `rotation`'s angles. Left out: the points' own pan and tilt
+     * if they have them, else `"ahead"`.
+     */
+    lookAt?: CameraTarget | "ahead";
+    /** Fixed angles all along, instead of `lookAt`. */
+    rotation?: CameraRotation;
+    /** `"ahead"`: how far along the path it looks (m). Default 5. */
+    lookAhead?: number;
+    /** Degrees all along (or the points' own `roll`, if they have them). */
+    roll?: number;
+    /** Rolls into turns like an aircraft. */
+    bank?: boolean;
+    /** All along (or the points' own `fov`, if they have them). */
+    fov?: number;
+    /**
+     * Depth of field: sharp at this many metres from the camera, at a spot,
+     * on a player, ped or vehicle (with an offset; kept in focus as it and
+     * the camera move), or `"auto"` (whatever's in the middle of the screen);
+     * `null` turns it off. Left out: as it was.
+     */
+    focus?: CameraFocus;
+    /** How shallow the focus is, as a lens's f-number: lower blurs more. Default 4. */
+    aperture?: number;
+    /** Speeding up from the start and slowing at the end. Default `"inOut"`. */
+    ease?: CameraEase;
+}
+/** A step of a camera sequence: a shot, a hold (stays, ms), or a path. */
+export type CameraStep = CameraShot | {
+    hold: number;
+} | CameraPath;
+export interface CameraPlayOptions {
+    /** From the first step again after the last, until stopped. */
+    loop?: boolean;
+    /** Black bars and the HUD away, as `CameraShot.widescreen`. */
+    widescreen?: boolean;
+}
+/** A sequence playing on a player's camera (`player.camera.play`). */
+export interface CameraSequence {
+    /** Resolves true when the last step finishes, false if stopped, replaced or handed back first. */
+    readonly done: Promise<boolean>;
+    /** Calls `fn` as each step starts (its index), as their game plays it. Returns a remover. */
+    onStep(fn: (step: number) => void): () => void;
+    /** Stops it: the camera stays where it is (`reset()` hands it back). */
+    stop(): void;
+}
+/** @internal Floats a step. */
+export declare const STEP_FLOATS = 32;
+/** @internal Floats a path point. */
+export declare const POINT_FLOATS = 8;
+/** @internal Steps as floats, for the player's game. */
+export declare function encodeCamera(steps: readonly CameraStep[]): {
+    steps: number[];
+    points: number[];
+};
+/**
+ * A player's camera (`player.camera`): shots and glides between them,
+ * sequences of moves and paths played on their game, a freecam they fly, or
+ * behind them as normal. Position, what it looks at (or pan and tilt),
+ * roll and field of view. Client scripts have the same: `sagl.camera`.
+ *
+ * ```ts
+ * await player.camera.set({ position: { x: 1500, y: -1700, z: 60 }, lookAt: { x: 1480, y: -1750, z: 13 } });
+ * await player.camera.set({ position: { x: 1450, y: -1700, z: 40 }, lookAt: car, fov: 40, roll: 5, ms: 5000 });
+ * await player.camera.play([
+ *   { path: [a, b, c, d], ms: 10000, bank: true },
+ *   { hold: 2000 },
+ * ]).done;
+ * player.camera.reset();
+ * ```
+ */
+export declare class PlayerCamera {
+    #private;
+    /** @internal */
+    constructor(native: NativeServer, player: number);
+    /**
+     * Where their camera looks (a unit vector), as their last sync: where
+     * they aim, or what they look at. Null before it, and for passengers.
+     */
+    get front(): Vector3 | null;
+    /** Where their camera is, as their last sync; null as `front`. */
+    get position(): Vector3 | null;
+    /** One shot, gliding there from where the camera is over `ms`; resolves when it's there (false if replaced first). */
+    set(shot: CameraShot): Promise<boolean>;
+    /** Plays a sequence of shots, holds and paths on their game, in order. */
+    play(steps: readonly CameraStep[], options?: CameraPlayOptions): CameraSequence;
+    /**
+     * Lets them fly it: the mouse turns it, the movement keys move it, sprint
+     * goes up, crouch down, jump faster, the mouse wheel zooms. Their ped
+     * stays put meanwhile. `speed` in m/s (default 10). `reset()` ends it.
+     */
+    freecam(options?: {
+        speed?: number;
+        widescreen?: boolean;
+    }): void;
+    /** Stops whatever's playing (or the freecam): the camera stays where it is. */
+    stop(): void;
+    /** Back behind them, as normal. */
+    reset(): void;
+    /** @internal Their game's report: step `step` started (0), done (1), stopped (2). */
+    heard(id: number, step: number, kind: number): void;
+    /** @internal They left: whatever was playing stops. */
+    disconnected(): void;
+}
+export {};

package/dist/camera.js

@@ -0,0 +1,247 @@
+// ---- The flat layout (as client/src/camera.cpp reads it) ------------------------
+/** @internal Floats a step. */
+export const STEP_FLOATS = 32;
+/** @internal Floats a path point. */
+export const POINT_FLOATS = 8;
+const MAX_STEPS = 32;
+const MAX_POINTS = 256;
+const num = (v, what) => {
+    if (typeof v !== "number" || !Number.isFinite(v))
+        throw new TypeError(`camera: ${what} must be a number`);
+    return v;
+};
+const vec = (v, what) => {
+    const o = v;
+    if (!o || typeof o !== "object")
+        throw new TypeError(`camera: ${what} must be { x, y, z }`);
+    return { x: num(o.x, `${what}.x`), y: num(o.y, `${what}.y`), z: num(o.z, `${what}.z`) };
+};
+const easeOf = (e) => e === undefined || e === true || e === "inOut" ? 3 : e === false || e === "linear" ? 0 : e === "in" ? 1 : e === "out" ? 2 : 3;
+const fovOf = (v) => Math.min(120, Math.max(5, num(v, "fov")));
+// A spot or a thing: [kind, id, x, y, z] (kind 0 a spot, 1 a ped, 2 a player, 3 a vehicle).
+function target(t, what) {
+    const o = t;
+    if (!o || typeof o !== "object")
+        throw new TypeError(`camera: ${what} must be a spot or { player | ped | vehicle }`);
+    const idOf = (x) => (typeof x === "number" ? x : num(x?.id, `${what}'s id`));
+    const kind = "ped" in o ? 1 : "player" in o ? 2 : "vehicle" in o ? 3 : 0;
+    if (!kind) {
+        const v = vec(o, what);
+        return [0, 0, v.x, v.y, v.z];
+    }
+    const off = o.offset === undefined ? { x: 0, y: 0, z: 0 } : vec(o.offset, `${what}.offset`);
+    return [kind, idOf(o.ped ?? o.player ?? o.vehicle), off.x, off.y, off.z];
+}
+/** @internal Steps as floats, for the player's game. */
+export function encodeCamera(steps) {
+    if (!Array.isArray(steps) || steps.length === 0)
+        throw new TypeError("camera: at least one step");
+    if (steps.length > MAX_STEPS)
+        throw new RangeError(`camera: at most ${MAX_STEPS} steps`);
+    const out = [];
+    const points = [];
+    steps.forEach((step, i) => {
+        const s = step;
+        const f = new Array(STEP_FLOATS).fill(0);
+        f[10] = 7 /* Look.Keep */;
+        let flags = 0;
+        const focus = (v, aperture, where) => {
+            if (v === null)
+                f[24] = 1;
+            else if (v === "auto")
+                f[24] = 3;
+            else if (typeof v === "number")
+                (f[24] = 2), (f[30] = Math.max(0.1, num(v, `${where}.focus`)));
+            else if (v !== undefined) {
+                f[24] = 4;
+                [f[25], f[26], f[27], f[28], f[29]] = target(v, `${where}.focus`);
+            }
+            if (aperture !== undefined)
+                f[31] = Math.max(0.5, num(aperture, `${where}.aperture`));
+        };
+        const lookAt = (look, rotation, where, ahead) => {
+            if (rotation !== undefined) {
+                const r = rotation;
+                f[10] = 4 /* Look.Rotation */;
+                f[15] = num(r.pan, `${where}.rotation.pan`);
+                f[16] = r.tilt === undefined ? 0 : num(r.tilt, `${where}.rotation.tilt`);
+            }
+            else if (look === "ahead") {
+                f[10] = 5 /* Look.Ahead */;
+            }
+            else if (look !== undefined) {
+                const t = target(look, `${where}.lookAt`);
+                [f[10], f[11], f[12], f[13], f[14]] = t;
+            }
+            else if (ahead) {
+                f[10] = 5 /* Look.Ahead */;
+            }
+        };
+        if ("hold" in s) {
+            f[0] = 1;
+            f[1] = Math.max(0, num(s.hold, `step ${i}.hold`));
+        }
+        else if ("path" in s) {
+            const path = s.path;
+            if (!Array.isArray(path) || path.length < 2)
+                throw new TypeError(`camera: step ${i}.path needs at least 2 points`);
+            if (points.length / POINT_FLOATS + path.length > MAX_POINTS)
+                throw new RangeError(`camera: at most ${MAX_POINTS} path points in all`);
+            f[0] = 2;
+            f[1] = s.ms === undefined ? 0 : Math.max(0, num(s.ms, `step ${i}.ms`));
+            f[2] = s.speed === undefined ? 10 : Math.max(0.1, num(s.speed, `step ${i}.speed`));
+            f[3] = easeOf(s.ease);
+            f[4] = -1;
+            f[17] = s.lookAhead === undefined ? 5 : Math.max(0.5, num(s.lookAhead, `step ${i}.lookAhead`));
+            f[21] = points.length / POINT_FLOATS;
+            f[22] = path.length;
+            f[23] = s.smoothing === undefined ? 1 : Math.min(1, Math.max(0, num(s.smoothing, `step ${i}.smoothing`)));
+            const pointsTurn = path.every((p) => p.pan !== undefined);
+            const pointsRoll = path.some((p) => p.roll !== undefined);
+            const pointsFov = path.some((p) => p.fov !== undefined);
+            for (const [j, p] of path.entries()) {
+                const v = vec(p, `step ${i}.path[${j}]`);
+                points.push(v.x, v.y, v.z, p.pan ?? 0, p.tilt ?? 0, p.roll ?? 0, p.fov === undefined ? 70 : fovOf(p.fov), 0);
+            }
+            if (s.lookAt === undefined && s.rotation === undefined && pointsTurn)
+                f[10] = 6 /* Look.Points */;
+            else
+                lookAt(s.lookAt, s.rotation, `step ${i}`, true);
+            if (pointsRoll)
+                flags |= 8 /* Flag.PointRoll */;
+            else if (s.bank)
+                flags |= 4 /* Flag.Bank */;
+            else if (s.roll !== undefined)
+                (flags |= 1 /* Flag.Roll */), (f[19] = num(s.roll, `step ${i}.roll`));
+            if (pointsFov)
+                flags |= 16 /* Flag.PointFov */;
+            else if (s.fov !== undefined)
+                (flags |= 2 /* Flag.Fov */), (f[20] = fovOf(s.fov));
+            focus(s.focus, s.aperture, `step ${i}`);
+        }
+        else {
+            if (s.position === undefined)
+                throw new TypeError(`camera: step ${i} needs position, hold or path`);
+            f[0] = 0;
+            f[1] = s.ms === undefined ? 0 : Math.max(0, num(s.ms, `step ${i}.ms`));
+            f[3] = easeOf(s.ease);
+            const p = target(s.position, `step ${i}.position`);
+            [f[4], f[5], f[6], f[7], f[8]] = p;
+            f[9] = s.position.relative ? 1 : 0;
+            lookAt(s.lookAt, s.rotation, `step ${i}`, false);
+            if (s.roll !== undefined)
+                (flags |= 1 /* Flag.Roll */), (f[19] = num(s.roll, `step ${i}.roll`));
+            if (s.fov !== undefined)
+                (flags |= 2 /* Flag.Fov */), (f[20] = fovOf(s.fov));
+            focus(s.focus, s.aperture, `step ${i}`);
+        }
+        f[18] = flags;
+        out.push(...f);
+    });
+    return { steps: out, points };
+}
+/**
+ * A player's camera (`player.camera`): shots and glides between them,
+ * sequences of moves and paths played on their game, a freecam they fly, or
+ * behind them as normal. Position, what it looks at (or pan and tilt),
+ * roll and field of view. Client scripts have the same: `sagl.camera`.
+ *
+ * ```ts
+ * await player.camera.set({ position: { x: 1500, y: -1700, z: 60 }, lookAt: { x: 1480, y: -1750, z: 13 } });
+ * await player.camera.set({ position: { x: 1450, y: -1700, z: 40 }, lookAt: car, fov: 40, roll: 5, ms: 5000 });
+ * await player.camera.play([
+ *   { path: [a, b, c, d], ms: 10000, bank: true },
+ *   { hold: 2000 },
+ * ]).done;
+ * player.camera.reset();
+ * ```
+ */
+export class PlayerCamera {
+    #native;
+    #player;
+    #next = 1;
+    #playing = null;
+    /** @internal */
+    constructor(native, player) {
+        this.#native = native;
+        this.#player = player;
+    }
+    /**
+     * Where their camera looks (a unit vector), as their last sync: where
+     * they aim, or what they look at. Null before it, and for passengers.
+     */
+    get front() {
+        return this.#native.player(this.#player)?.cameraFront ?? null;
+    }
+    /** Where their camera is, as their last sync; null as `front`. */
+    get position() {
+        return this.#native.player(this.#player)?.cameraPosition ?? null;
+    }
+    /** One shot, gliding there from where the camera is over `ms`; resolves when it's there (false if replaced first). */
+    set(shot) {
+        return this.play([shot], { widescreen: shot.widescreen }).done;
+    }
+    /** Plays a sequence of shots, holds and paths on their game, in order. */
+    play(steps, options = {}) {
+        const encoded = encodeCamera(steps);
+        const id = this.#next++;
+        let resolve;
+        const done = new Promise((r) => (resolve = r));
+        const listeners = new Set();
+        this.#replace({ id, done: resolve, steps: listeners });
+        this.#native.camera(this.#player, { id, ...encoded, loop: options.loop ?? false, widescreen: options.widescreen ?? false });
+        return {
+            done,
+            onStep: (fn) => {
+                listeners.add(fn);
+                return () => listeners.delete(fn);
+            },
+            stop: () => {
+                if (this.#playing?.id === id)
+                    this.stop();
+            },
+        };
+    }
+    /**
+     * Lets them fly it: the mouse turns it, the movement keys move it, sprint
+     * goes up, crouch down, jump faster, the mouse wheel zooms. Their ped
+     * stays put meanwhile. `speed` in m/s (default 10). `reset()` ends it.
+     */
+    freecam(options = {}) {
+        this.#replace(null);
+        this.#native.camera(this.#player, { freecam: true, freecamSpeed: options.speed ?? 0, widescreen: options.widescreen ?? false });
+    }
+    /** Stops whatever's playing (or the freecam): the camera stays where it is. */
+    stop() {
+        this.#replace(null);
+        this.#native.camera(this.#player, { stop: true });
+    }
+    /** Back behind them, as normal. */
+    reset() {
+        this.#replace(null);
+        this.#native.camera(this.#player, { behind: true });
+    }
+    /** @internal Their game's report: step `step` started (0), done (1), stopped (2). */
+    heard(id, step, kind) {
+        const p = this.#playing;
+        if (!p || p.id !== id)
+            return;
+        if (kind === 0)
+            for (const fn of p.steps)
+                fn(step);
+        else {
+            this.#playing = null;
+            p.done(kind === 1);
+        }
+    }
+    /** @internal They left: whatever was playing stops. */
+    disconnected() {
+        this.#replace(null);
+    }
+    #replace(next) {
+        const old = this.#playing;
+        this.#playing = next;
+        old?.done(false);
+    }
+}
+//# sourceMappingURL=camera.js.map

package/dist/camera.js.map

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

package/dist/claims.d.ts

@@ -0,0 +1,27 @@
+import type { Player } from "./player.js";
+/**
+ * First come, first served (`server.claims`): one player at a time holds a
+ * thing (a payphone, a seat, a job), by any key you like. Let go with
+ * `release`, after `ms`, or when they leave.
+ *
+ * ```ts
+ * channel.on((player, msg) => {
+ *   if (msg.answer && player.isNear(PHONE, 2) && server.claims.take("payphone", player, { ms: 15_000 })) {
+ *     channel.broadcast({ answeredBy: player.id });
+ *   }
+ * });
+ * ```
+ */
+export declare class Claims {
+    #private;
+    /** True if they now hold it (it was free, or already theirs); false if someone else does. */
+    take(key: string, player: Player, options?: {
+        ms?: number;
+    }): boolean;
+    /** Lets go of it (only if `player` holds it, when given). */
+    release(key: string, player?: Player): void;
+    /** Who holds it, or null. */
+    holder(key: string): Player | null;
+    /** @internal A player left: what they held is free. */
+    forget(player: Player): void;
+}

package/dist/claims.js

@@ -0,0 +1,48 @@
+/**
+ * First come, first served (`server.claims`): one player at a time holds a
+ * thing (a payphone, a seat, a job), by any key you like. Let go with
+ * `release`, after `ms`, or when they leave.
+ *
+ * ```ts
+ * channel.on((player, msg) => {
+ *   if (msg.answer && player.isNear(PHONE, 2) && server.claims.take("payphone", player, { ms: 15_000 })) {
+ *     channel.broadcast({ answeredBy: player.id });
+ *   }
+ * });
+ * ```
+ */
+export class Claims {
+    #held = new Map();
+    /** True if they now hold it (it was free, or already theirs); false if someone else does. */
+    take(key, player, options = {}) {
+        const held = this.#held.get(key);
+        if (held && held.player !== player && held.player.connected)
+            return false;
+        if (held?.timer)
+            clearTimeout(held.timer);
+        const timer = options.ms ? setTimeout(() => this.release(key), options.ms) : null;
+        this.#held.set(key, { player, timer });
+        return true;
+    }
+    /** Lets go of it (only if `player` holds it, when given). */
+    release(key, player) {
+        const held = this.#held.get(key);
+        if (!held || (player && held.player !== player))
+            return;
+        if (held.timer)
+            clearTimeout(held.timer);
+        this.#held.delete(key);
+    }
+    /** Who holds it, or null. */
+    holder(key) {
+        const held = this.#held.get(key);
+        return held && held.player.connected ? held.player : null;
+    }
+    /** @internal A player left: what they held is free. */
+    forget(player) {
+        for (const [key, held] of [...this.#held])
+            if (held.player === player)
+                this.release(key);
+    }
+}
+//# sourceMappingURL=claims.js.map

package/dist/claims.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claims.js","sourceRoot":"","sources":["../src/claims.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,MAAM;IACjB,KAAK,GAAG,IAAI,GAAG,EAA2E,CAAC;IAE3F,6FAA6F;IAC7F,IAAI,CAAC,GAAW,EAAE,MAAc,EAAE,UAA2B,EAAE;QAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS;YAAE,OAAO,KAAK,CAAC;QAC1E,IAAI,IAAI,EAAE,KAAK;YAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAClF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6DAA6D;IAC7D,OAAO,CAAC,GAAW,EAAE,MAAe;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC;YAAE,OAAO;QACxD,IAAI,IAAI,CAAC,KAAK;YAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,6BAA6B;IAC7B,MAAM,CAAC,GAAW;QAChB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,OAAO,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5D,CAAC;IAED,uDAAuD;IACvD,MAAM,CAAC,MAAc;QACnB,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;YAAE,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM;gBAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3F,CAAC;CACF"}

package/dist/commands.d.ts

@@ -0,0 +1,135 @@
+import type { Player } from "./player.js";
+import type { Vehicle } from "./vehicle.js";
+/** A command's usage went wrong: the message is shown to the player. */
+export declare class CommandError extends Error {
+}
+/**
+ * What an argument takes: how it's read from what was typed, how the chat
+ * suggests it, and how it's shown in usage. Made with `arg.*`.
+ */
+export interface ArgType<T> {
+    /** As the chat shows it in usage ("player", "1-100"...). */
+    readonly label: string;
+    /** @internal The client's token (type[:params]). */
+    readonly token: string;
+    /** Takes the rest of the line (text). */
+    readonly greedy?: boolean;
+    /** Reads it; throws `CommandError` if it can't. */
+    parse(input: string, player: Player): T;
+    /** Suggestions the server makes for it (custom types): the chat asks as they type. */
+    suggest?(player: Player, partial: string): string[] | Promise<string[]>;
+}
+/** @internal Players, to resolve `arg.player()` and `arg.vehicle()`. */
+export interface Lookup {
+    players(): Player[];
+    vehicle(id: number): Vehicle | undefined;
+}
+/** @internal */
+export declare function setLookup(l: Lookup): void;
+/** Argument types for `command(...).argument(name, type)`. */
+export declare const arg: {
+    /** A player: by id, their name, or the start of it (one match). */
+    player(): ArgType<Player>;
+    /** A whole number, within `min`-`max`. */
+    integer(o?: {
+        min?: number;
+        max?: number;
+    }): ArgType<number>;
+    /** A number (decimals too), within `min`-`max`. */
+    number(o?: {
+        min?: number;
+        max?: number;
+    }): ArgType<number>;
+    /** One word. */
+    word(): ArgType<string>;
+    /** The rest of the line (it must come last). */
+    text(): ArgType<string>;
+    /** yes/no, true/false, on/off, 1/0. */
+    boolean(): ArgType<boolean>;
+    /** One of these words. */
+    choice<T extends string>(choices: readonly T[]): ArgType<T>;
+    /** A vehicle, by its id. */
+    vehicle(): ArgType<Vehicle>;
+    /**
+     * Your own: `parse` reads it (throw `CommandError` to refuse), `suggest`
+     * offers what the chat suggests as they type (asked of the server).
+     */
+    custom<T>(o: {
+        label: string;
+        parse(input: string, player: Player): T;
+        suggest?(player: Player, partial: string): string[] | Promise<string[]>;
+        greedy?: boolean;
+    }): ArgType<T>;
+};
+interface ArgDef {
+    name: string;
+    type: ArgType<unknown>;
+    optional: boolean;
+}
+/** What a command's executor gets: its arguments by name. */
+export type CommandArgs = Record<string, unknown>;
+export type Executor = (player: Player, args: CommandArgs, line: string) => void | Promise<void>;
+/**
+ * A command, built up (as Minecraft's Brigadier): its name, aliases,
+ * arguments, subcommands, who may use it, and what it does. Made with
+ * `command(name)`.
+ *
+ * ```ts
+ * server.commands.register(
+ *   command("pay").description("Give money to a player")
+ *     .argument("player", arg.player())
+ *     .argument("amount", arg.integer({ min: 1 }))
+ *     .executes((player, { player: to, amount }) => { ... }),
+ * );
+ * ```
+ */
+export declare class CommandBuilder {
+    /** @internal */ readonly name: string;
+    /** @internal */ aliases: string[];
+    /** @internal */ text: string;
+    /** @internal */ check: ((player: Player) => boolean) | null;
+    /** @internal */ args: ArgDef[];
+    /** @internal */ children: CommandBuilder[];
+    /** @internal */ run: Executor | null;
+    /** @internal */
+    constructor(name: string);
+    /** Other names for it. */
+    alias(...names: string[]): this;
+    /** What it does, shown with its usage in the chat's suggestions. */
+    description(text: string): this;
+    /** Who may use it (and see it suggested): checked per player. */
+    requires(check: (player: Player) => boolean): this;
+    /** The next argument. Optional ones come last. */
+    argument(name: string, type: ArgType<unknown>, options?: {
+        optional?: boolean;
+    }): this;
+    /** A subcommand: `/faction invite ...` is `command("faction").then(command("invite")...)`. */
+    then(sub: CommandBuilder): this;
+    /** What it does: `fn(player, args, line)`; throw `CommandError` to tell them what's wrong. */
+    executes(fn: Executor): this;
+}
+/** Starts a command: see `CommandBuilder`. */
+export declare function command(name: string): CommandBuilder;
+/** `server.commands`: the server's chat commands. */
+export declare class Commands {
+    #private;
+    /** @internal */
+    constructor(send: (player: Player, tree: string) => void, players: () => Player[], error: (player: Player, text: string) => void);
+    /** Adds commands (players' chat suggests them at once). */
+    register(...commands: CommandBuilder[]): this;
+    /** Removes a command, by its name. */
+    unregister(name: string): void;
+    /** Sends their chat the commands they can use now: after what `requires` checks changes (their admin level...). */
+    refresh(player: Player): void;
+    /**
+     * @internal A /command line from `player`: true if a registered command
+     * took it (run, or its usage error shown), false if none is called that.
+     */
+    handle(player: Player, line: string): Promise<boolean>;
+    /**
+     * @internal Suggestions for the custom argument being typed at the end of
+     * `line`: [where its word starts, suggestions], or null.
+     */
+    suggest(player: Player, line: string): Promise<[number, string[]] | null>;
+}
+export {};