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

package/dist/vehiclecolors.js

@@ -0,0 +1,49 @@
+import { CAR_COLORS } from "./modshop_data.js";
+/**
+ * Car colours: the game's (0-127) and your own (`server.vehicleColors`).
+ * Add a colour of your own and you get an id, 128 up, that works anywhere
+ * a colour does: `vehicle.colors`, `createVehicle`, the mod shops' colour
+ * grid (where yours are added by default).
+ *
+ * ```ts
+ * const teal = server.vehicleColors.add(0x00a8a8);
+ * vehicle.colors = [teal, 1];
+ * ```
+ */
+export class VehicleColors {
+    #native;
+    #players;
+    #custom = [];
+    /** @internal */
+    constructor(native, players) {
+        this.#native = native;
+        this.#players = players;
+    }
+    /** Adds a colour (0xRRGGBB) and gives its id (128 up; the same colour twice: the same id). At most 128. */
+    add(rgb) {
+        const c = rgb & 0xffffff;
+        const at = this.#custom.indexOf(c);
+        if (at >= 0)
+            return 128 + at;
+        if (this.#custom.length >= 128)
+            throw new RangeError("at most 128 colours of your own");
+        this.#custom.push(c);
+        for (const p of this.#players())
+            this.joined(p);
+        return 127 + this.#custom.length;
+    }
+    /** Your colours' ids, in order. */
+    get custom() {
+        return this.#custom.map((_, i) => 128 + i);
+    }
+    /** A colour id's 0xRRGGBB (the game's or yours), or undefined. */
+    rgb(id) {
+        return id < 128 ? CAR_COLORS[id] : this.#custom[id - 128];
+    }
+    /** @internal A player joined: they get yours. */
+    joined(player) {
+        if (player.connected && this.#custom.length)
+            this.#native.vehiclePalette(player.id, this.#custom);
+    }
+}
+//# sourceMappingURL=vehiclecolors.js.map

package/dist/vehiclecolors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vehiclecolors.js","sourceRoot":"","sources":["../src/vehiclecolors.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,MAAM,OAAO,aAAa;IACxB,OAAO,CAAe;IACtB,QAAQ,CAAiB;IACzB,OAAO,GAAa,EAAE,CAAC;IAEvB,gBAAgB;IAChB,YAAY,MAAoB,EAAE,OAAuB;QACvD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,2GAA2G;IAC3G,GAAG,CAAC,GAAW;QACb,MAAM,CAAC,GAAG,GAAG,GAAG,QAAQ,CAAC;QACzB,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,EAAE,IAAI,CAAC;YAAE,OAAO,GAAG,GAAG,EAAE,CAAC;QAC7B,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,GAAG;YAAE,MAAM,IAAI,UAAU,CAAC,iCAAiC,CAAC,CAAC;QACxF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE;YAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAChD,OAAO,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IACnC,CAAC;IAED,mCAAmC;IACnC,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,kEAAkE;IAClE,GAAG,CAAC,EAAU;QACZ,OAAO,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC;IAC5D,CAAC;IAED,iDAAiD;IACjD,MAAM,CAAC,MAAc;QACnB,IAAI,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACpG,CAAC;CACF"}

package/dist/world.d.ts

@@ -0,0 +1,222 @@
+import type { NativeServer } from "./native.js";
+import type { Vector3 } from "./player.js";
+/** The game's weather types (eWeatherType). */
+export declare const Weather: {
+    readonly ExtraSunnyLA: 0;
+    readonly SunnyLA: 1;
+    readonly ExtraSunnySmogLA: 2;
+    readonly SunnySmogLA: 3;
+    readonly CloudyLA: 4;
+    readonly SunnySF: 5;
+    readonly ExtraSunnySF: 6;
+    readonly CloudySF: 7;
+    readonly RainySF: 8;
+    readonly FoggySF: 9;
+    readonly SunnyVegas: 10;
+    readonly ExtraSunnyVegas: 11;
+    readonly CloudyVegas: 12;
+    readonly ExtraSunnyCountryside: 13;
+    readonly SunnyCountryside: 14;
+    readonly CloudyCountryside: 15;
+    readonly RainyCountryside: 16;
+    readonly ExtraSunnyDesert: 17;
+    readonly SunnyDesert: 18;
+    readonly SandstormDesert: 19;
+    readonly Underwater: 20;
+    readonly ExtraColours1: 21;
+    readonly ExtraColours2: 22;
+    /** Each player's game runs its own weather cycle (not synced). */
+    readonly GameCycle: -1;
+};
+/**
+ * A virtual world's settings. Worlds share world 0's time and weather until
+ * given their own: setting `time` or `weather` here (on any world but 0)
+ * starts it off from world 0's; `synced = true` makes it follow world 0
+ * again.
+ */
+/** A world's ambient population (`world.population`, `server.population`). */
+export interface Population {
+    /** Ambient peds on foot. */
+    peds: boolean;
+    /** Ambient vehicles with their drivers. */
+    traffic: boolean;
+    /** 1 is single-player's; 0-3. */
+    density: number;
+    /** Gang members and gang cars, in their territories. */
+    gangs: boolean;
+    /**
+     * Cops: patrolling, and responding to a wanted player (whatever made them
+     * wanted: the game's crime rules, or the gamemode). Off, no cop ever
+     * appears, wanted or not. Default off; works with peds and traffic off.
+     */
+    police: boolean;
+    /** Medics and ambulances, sent to the injured as in single-player. Default off. */
+    ambulance: boolean;
+    /** Firemen and fire trucks, sent to fires as in single-player. Default off. */
+    fire: boolean;
+    /**
+     * Crimes make players wanted, as in single-player (the game raises their
+     * wanted level, and lowers it as they lose the cops; `wantedLevel` can
+     * refuse or change it). Off: wanted levels are only what the gamemode
+     * sets. Default off.
+     */
+    wanted: boolean;
+    /**
+     * Losing the cops: with no police (cops or their vehicles) within
+     * `evadeDistance` m (default 60) for this many seconds, a star goes, and
+     * so on for the next. 0 (the default): only as the game's own rules
+     * allow, under which a city never lets more than one star go (that takes
+     * a Pay 'n' Spray).
+     */
+    evadeSeconds: number;
+    evadeDistance: number;
+    /**
+     * Ambient drivers (and server peds driving) signal their turns with their
+     * indicators, and put their hazards on when their car's broken down.
+     * Default on.
+     */
+    indicators: boolean;
+}
+/** A traffic light: for pedestrians, `"yellow"` is the flashing "don't walk". `"off"` and `"flashing"` (yellow) let cars through. */
+export type TrafficLight = "green" | "yellow" | "red" | "off" | "flashing";
+/** Every traffic light, by the way it faces: SA's lights are all one of these two, plus the crossings. */
+export interface TrafficLightStates {
+    northSouth: TrafficLight;
+    eastWest: TrafficLight;
+    pedestrians: TrafficLight;
+}
+/** How long each part of the lights' round lasts (ms). */
+export interface TrafficLightTiming {
+    /** Each direction's green. Default 10000. */
+    green: number;
+    /** Each direction's yellow. Default 2000. */
+    yellow: number;
+    /** Pedestrians' walk (every car waits). Default 6766. */
+    walk: number;
+    /** Then their flashing "don't walk". Default 2002. */
+    flashing: number;
+}
+/**
+ * A world's traffic lights (`world.trafficLights`, `server.trafficLights`
+ * for world 0's), the same for everyone in it: the lights change together
+ * on every screen, and traffic stops for them alike. SA's lights all run
+ * on one round: north-south green, then yellow, then east-west's, then
+ * every car waits while pedestrians cross. They go as the world's time and
+ * weather do: changing them in a world without its own gives it its own.
+ *
+ * ```ts
+ * server.trafficLights.timing = { green: 15000 };   // longer greens
+ * server.trafficLights.freeze();                    // held as they are
+ * server.trafficLights.set({ northSouth: "green", eastWest: "red" });
+ * server.trafficLights.set({ northSouth: "flashing", eastWest: "flashing" });  // out of order
+ * server.trafficLights.resume();                    // the round goes on
+ * ```
+ */
+export declare class TrafficLights {
+    #private;
+    /** @internal */
+    constructor(native: NativeServer, world: number);
+    /** The lights now. */
+    get state(): TrafficLightStates;
+    /** Held (by `freeze` or `set`), not going round. */
+    get frozen(): boolean;
+    /**
+     * Whether a vehicle (or anything facing `heading` at `position`) is at a
+     * red light: within `radius` m (default 25) of a junction with lights,
+     * and the lights its way red or amber. Its way is by its heading: north
+     * or south, else east or west.
+     *
+     * ```ts
+     * if (car.speed < 0.5 && server.trafficLights.isRedFor(car)) ...
+     * ```
+     */
+    isRedFor(what: {
+        position: Vector3;
+        heading: number;
+    }, radius?: number): boolean;
+    /** Holds them as they are now. */
+    freeze(): void;
+    /** Holds them, these as given (the rest as they are now). */
+    set(states: Partial<TrafficLightStates>): void;
+    /** Back to going round, from where they were held. */
+    resume(): void;
+    /** The round's timing (ms); setting some keeps the rest. Each at least 500. */
+    get timing(): TrafficLightTiming;
+    set timing(timing: Partial<TrafficLightTiming>);
+}
+export declare class World {
+    #private;
+    readonly id: number;
+    /** @internal Created by Server.world(). */
+    constructor(nativeServer: NativeServer, id: number);
+    /**
+     * Its ambient population: peds on foot and traffic as in single-player,
+     * shared by everyone in it, and what's allowed in it (gangs, police,
+     * ambulances, fire trucks). Off by default; worlds without their own
+     * settings use world 0's. Setting only some fields keeps the rest.
+     */
+    get population(): Population;
+    set population(settings: Partial<Population>);
+    /** Follows world 0's time and weather (always true for world 0 itself). */
+    get synced(): boolean;
+    set synced(synced: boolean);
+    get time(): {
+        hour: number;
+        minute: number;
+        frozen: boolean;
+    };
+    set time(value: {
+        hour: number;
+        minute: number;
+    });
+    freezeTime(): void;
+    unfreezeTime(): void;
+    /** `Weather` (0-22), or `Weather.GameCycle`. */
+    get weather(): number;
+    set weather(weather: number);
+    /** Its traffic lights (world 0's until it has its own, as its time and weather). */
+    get trafficLights(): TrafficLights;
+    /** Lets this world see `target` (one way); see `server.setWorldView`. */
+    view(target: number, visible?: boolean): void;
+}
+/** Cull zone attribute flags (eZoneAttributes). */
+export declare const ZoneAttribute: {
+    readonly CameraCloseIn: 1;
+    readonly CameraStairs: 2;
+    readonly FirstPersonBoats: 4;
+    readonly NoRain: 8;
+    readonly NoPolice: 16;
+    readonly PoliceAbandonCars: 256;
+    readonly InRoomForAudio: 512;
+    readonly FewerPeds: 1024;
+    readonly MilitaryZone: 4096;
+    readonly ExtraAirResistance: 16384;
+    readonly FewerCars: 32768;
+};
+/** Game audio zone ids for `createCullZone({ audio })`: interior music/ambience. */
+export declare const AudioZone: {
+    readonly AmmuNation: 48;
+    readonly ClothesShop: 54;
+    readonly Barbers: 57;
+    readonly Gym: 59;
+    readonly GymOrBarbers: 61;
+    readonly Tattoo: 58;
+    readonly Diner: 44;
+    readonly FastFood: 44;
+    readonly Bar: 29;
+    readonly Casino: 17;
+    readonly StripClub: 66;
+    readonly PoliceStation: 39;
+    readonly Stadium: 41;
+};
+/** A server cull zone (`server.createCullZone`). */
+export declare class CullZone {
+    #private;
+    readonly id: number;
+    /** @internal */
+    constructor(id: number, destroy: (zone: CullZone) => void);
+    get exists(): boolean;
+    /** @internal */
+    markDestroyed(): void;
+    destroy(): void;
+}

package/dist/world.js

@@ -0,0 +1,227 @@
+import { JUNCTIONS } from "./junctions.js";
+/** The game's weather types (eWeatherType). */
+export const Weather = {
+    ExtraSunnyLA: 0,
+    SunnyLA: 1,
+    ExtraSunnySmogLA: 2,
+    SunnySmogLA: 3,
+    CloudyLA: 4,
+    SunnySF: 5,
+    ExtraSunnySF: 6,
+    CloudySF: 7,
+    RainySF: 8,
+    FoggySF: 9,
+    SunnyVegas: 10,
+    ExtraSunnyVegas: 11,
+    CloudyVegas: 12,
+    ExtraSunnyCountryside: 13,
+    SunnyCountryside: 14,
+    CloudyCountryside: 15,
+    RainyCountryside: 16,
+    ExtraSunnyDesert: 17,
+    SunnyDesert: 18,
+    SandstormDesert: 19,
+    Underwater: 20,
+    ExtraColours1: 21,
+    ExtraColours2: 22,
+    /** Each player's game runs its own weather cycle (not synced). */
+    GameCycle: -1,
+};
+const TRAFFIC_LIGHTS = ["green", "yellow", "red", "off", "flashing"];
+/**
+ * A world's traffic lights (`world.trafficLights`, `server.trafficLights`
+ * for world 0's), the same for everyone in it: the lights change together
+ * on every screen, and traffic stops for them alike. SA's lights all run
+ * on one round: north-south green, then yellow, then east-west's, then
+ * every car waits while pedestrians cross. They go as the world's time and
+ * weather do: changing them in a world without its own gives it its own.
+ *
+ * ```ts
+ * server.trafficLights.timing = { green: 15000 };   // longer greens
+ * server.trafficLights.freeze();                    // held as they are
+ * server.trafficLights.set({ northSouth: "green", eastWest: "red" });
+ * server.trafficLights.set({ northSouth: "flashing", eastWest: "flashing" });  // out of order
+ * server.trafficLights.resume();                    // the round goes on
+ * ```
+ */
+export class TrafficLights {
+    #native;
+    #world;
+    /** @internal */
+    constructor(native, world) {
+        this.#native = native;
+        this.#world = world;
+    }
+    /** The lights now. */
+    get state() {
+        const s = this.#native.trafficLights(this.#world);
+        return {
+            northSouth: TRAFFIC_LIGHTS[s.northSouth] ?? "red",
+            eastWest: TRAFFIC_LIGHTS[s.eastWest] ?? "red",
+            pedestrians: TRAFFIC_LIGHTS[s.pedestrians] ?? "red",
+        };
+    }
+    /** Held (by `freeze` or `set`), not going round. */
+    get frozen() {
+        return this.#native.trafficLights(this.#world).fixed;
+    }
+    /**
+     * Whether a vehicle (or anything facing `heading` at `position`) is at a
+     * red light: within `radius` m (default 25) of a junction with lights,
+     * and the lights its way red or amber. Its way is by its heading: north
+     * or south, else east or west.
+     *
+     * ```ts
+     * if (car.speed < 0.5 && server.trafficLights.isRedFor(car)) ...
+     * ```
+     */
+    isRedFor(what, radius = 25) {
+        const at = what.position;
+        if (!JUNCTIONS.some(([x, y, z]) => Math.hypot(x - at.x, y - at.y) < radius && Math.abs(z - at.z) < 15))
+            return false;
+        const h = (what.heading * Math.PI) / 180;
+        const northSouth = Math.abs(Math.cos(h)) > Math.abs(Math.sin(h));
+        const s = this.state;
+        const theirs = northSouth ? s.northSouth : s.eastWest;
+        return theirs === "red" || theirs === "yellow";
+    }
+    /** Holds them as they are now. */
+    freeze() {
+        this.#native.holdTrafficLights(this.#world);
+    }
+    /** Holds them, these as given (the rest as they are now). */
+    set(states) {
+        const light = (l) => {
+            if (l === undefined)
+                return -1;
+            const i = TRAFFIC_LIGHTS.indexOf(l);
+            if (i < 0)
+                throw new RangeError(`not a traffic light: ${l}`);
+            return i;
+        };
+        this.#native.setTrafficLights(light(states.northSouth), light(states.eastWest), light(states.pedestrians), this.#world);
+    }
+    /** Back to going round, from where they were held. */
+    resume() {
+        this.#native.resumeTrafficLights(this.#world);
+    }
+    /** The round's timing (ms); setting some keeps the rest. Each at least 500. */
+    get timing() {
+        return this.#native.trafficLights(this.#world).timing;
+    }
+    set timing(timing) {
+        const t = { ...this.timing, ...timing };
+        this.#native.setTrafficTiming(t.green, t.yellow, t.walk, t.flashing, this.#world);
+    }
+}
+export class World {
+    id;
+    #native;
+    /** @internal Created by Server.world(). */
+    constructor(nativeServer, id) {
+        this.#native = nativeServer;
+        this.id = id;
+    }
+    /**
+     * Its ambient population: peds on foot and traffic as in single-player,
+     * shared by everyone in it, and what's allowed in it (gangs, police,
+     * ambulances, fire trucks). Off by default; worlds without their own
+     * settings use world 0's. Setting only some fields keeps the rest.
+     */
+    get population() {
+        return this.#native.population(this.id);
+    }
+    set population(settings) {
+        this.#native.setPopulation(this.id, settings);
+    }
+    /** Follows world 0's time and weather (always true for world 0 itself). */
+    get synced() {
+        return this.id === 0 || this.#native.worldSynced(this.id);
+    }
+    set synced(synced) {
+        this.#native.setWorldSynced(this.id, synced);
+    }
+    get time() {
+        return this.#native.getTime(this.id);
+    }
+    set time(value) {
+        if (value.hour < 0 || value.hour > 23 || value.minute < 0 || value.minute > 59) {
+            throw new RangeError("time must be 00:00-23:59");
+        }
+        this.#native.setTime(value.hour, value.minute, this.id);
+    }
+    freezeTime() {
+        this.#native.freezeTime(true, this.id);
+    }
+    unfreezeTime() {
+        this.#native.freezeTime(false, this.id);
+    }
+    /** `Weather` (0-22), or `Weather.GameCycle`. */
+    get weather() {
+        return this.#native.getWeather(this.id);
+    }
+    set weather(weather) {
+        this.#native.setWeather(weather, this.id);
+    }
+    /** Its traffic lights (world 0's until it has its own, as its time and weather). */
+    get trafficLights() {
+        return new TrafficLights(this.#native, this.id);
+    }
+    /** Lets this world see `target` (one way); see `server.setWorldView`. */
+    view(target, visible = true) {
+        this.#native.setWorldView(this.id, target, visible);
+    }
+}
+/** Cull zone attribute flags (eZoneAttributes). */
+export const ZoneAttribute = {
+    CameraCloseIn: 0x1,
+    CameraStairs: 0x2,
+    FirstPersonBoats: 0x4,
+    NoRain: 0x8,
+    NoPolice: 0x10,
+    PoliceAbandonCars: 0x100,
+    InRoomForAudio: 0x200,
+    FewerPeds: 0x400,
+    MilitaryZone: 0x1000,
+    ExtraAirResistance: 0x4000,
+    FewerCars: 0x8000,
+};
+/** Game audio zone ids for `createCullZone({ audio })`: interior music/ambience. */
+export const AudioZone = {
+    AmmuNation: 48,
+    ClothesShop: 54,
+    Barbers: 57,
+    Gym: 59,
+    GymOrBarbers: 61,
+    Tattoo: 58,
+    Diner: 44,
+    FastFood: 44,
+    Bar: 29,
+    Casino: 17,
+    StripClub: 66,
+    PoliceStation: 39,
+    Stadium: 41,
+};
+/** A server cull zone (`server.createCullZone`). */
+export class CullZone {
+    id;
+    #destroy;
+    #exists = true;
+    /** @internal */
+    constructor(id, destroy) {
+        this.id = id;
+        this.#destroy = destroy;
+    }
+    get exists() {
+        return this.#exists;
+    }
+    /** @internal */
+    markDestroyed() {
+        this.#exists = false;
+    }
+    destroy() {
+        if (this.#exists)
+            this.#destroy(this);
+    }
+}
+//# sourceMappingURL=world.js.map

package/dist/world.js.map

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

package/dist/zone.d.ts

@@ -0,0 +1,89 @@
+import type { NativeServer } from "./native.js";
+import type { Vector3 } from "./player.js";
+/** The game's garage types (as the map files define them). */
+export declare const GarageType: {
+    readonly Mission: 1;
+    readonly BombShopTimed: 2;
+    readonly BombShopEngine: 3;
+    readonly BombShopRemote: 4;
+    readonly PayNSpray: 5;
+    readonly SafehouseGanton: 16;
+    readonly SafehouseSantaMaria: 17;
+    readonly SafehouseRockshore: 18;
+    readonly ImpoundLS: 33;
+    readonly ImpoundSF: 34;
+    readonly ImpoundLV: 35;
+};
+/**
+ * An area the server watches players against, firing `zoneEnter`,
+ * `zoneLeave` and `zoneMove` (each position update while inside). Positions
+ * are the ones players sync, on foot or driving.
+ */
+export declare class Zone {
+    #private;
+    readonly id: number;
+    /** The garage this zone covers, for the built-in garage zones. */
+    readonly garage: Garage | null;
+    /** Free-form storage for gamemode data. */
+    readonly data: Record<string, unknown>;
+    /** @internal Created by Server. */
+    constructor(id: number, garage: Garage | null, destroy: (zone: Zone) => void);
+    get exists(): boolean;
+    /** @internal */
+    markDestroyed(): void;
+    /** Stops watching it (no leave events are sent). */
+    destroy(): void;
+}
+/**
+ * One of the game's garages: a door the server opens and closes for
+ * everyone, and a zone over its floor. Players' games run none of the
+ * garage's own logic (no Pay 'n' Spray, safehouse storage, ...): build that
+ * from `zoneEnter` on `garage.zone`.
+ */
+export declare class Garage {
+    #private;
+    readonly id: number;
+    /** As in the map files; not unique. */
+    readonly name: string;
+    /** See `GarageType`. */
+    readonly type: number;
+    readonly position: Vector3;
+    zone: Zone;
+    /** @internal Created by Server. */
+    constructor(nativeServer: NativeServer, state: {
+        id: number;
+        name: string;
+        type: number;
+        x: number;
+        y: number;
+        z: number;
+        open: boolean;
+        frontX: number;
+        frontY: number;
+        sideX: number;
+        sideY: number;
+        topZ: number;
+    });
+    /**
+     * Whether a spot is inside it, at least `margin` m from its walls (not
+     * the floor or roof): a car's position with a margin of half its length
+     * is a car wholly inside, as the game's garages check before shutting.
+     * A negative margin reaches that far outside.
+     */
+    contains(at: Vector3, margin?: number): boolean;
+    /**
+     * The spot `distance` m outside the wall nearest `at`, across from `at`
+     * (for where a car drove in: in front of the door), facing away from the
+     * garage: where to put a car driving out.
+     */
+    outside(at: Vector3, distance?: number): {
+        position: Vector3;
+        heading: number;
+    };
+    /** Its floor's middle. */
+    get center(): Vector3;
+    get isOpen(): boolean;
+    open(): void;
+    close(): void;
+    toString(): string;
+}