brs-js 2.1.3 → 3.0.0

package/dist/src/brdb/bits.d.ts

@@ -0,0 +1,13 @@
+import type { BrdbValue } from './schema';
+/** Read bit i of a packed { Flags } column. Bytes past the end read as 0. */
+export declare const bit: (flags: {
+    Flags: number[];
+}, i: number) => boolean;
+/** Accumulate booleans into a packed { Flags } column. */
+export declare class BitFlags {
+    bytes: number[];
+    private bits;
+    push(v: boolean): void;
+    toValue(): BrdbValue;
+}
+//# sourceMappingURL=bits.d.ts.map

package/dist/src/brdb/bits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bits.d.ts","sourceRoot":"","sources":["../../../src/brdb/bits.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,6EAA6E;AAC7E,eAAO,MAAM,GAAG,GAAI,OAAO;IAAE,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,GAAG,MAAM,KAAG,OACP,CAAC;AAEtD,0DAA0D;AAC1D,qBAAa,QAAQ;IACnB,KAAK,EAAE,MAAM,EAAE,CAAM;IACrB,OAAO,CAAC,IAAI,CAAK;IACjB,IAAI,CAAC,CAAC,EAAE,OAAO;IAKf,OAAO,IAAI,SAAS;CAGrB"}

package/dist/src/brdb/brdb.d.ts

@@ -0,0 +1,131 @@
+import type { Compressor } from './brz';
+import type { FoundFile, WorldFs } from './fs';
+import type { PendingEntry } from './pending';
+import { WorldReader } from './reader';
+import { WriteBrzInput, WriteBrzOptions } from './world';
+export interface BrdbStatement {
+    run(...params: unknown[]): {
+        lastInsertRowid: number | bigint;
+    };
+    get(...params: unknown[]): unknown;
+    all(...params: unknown[]): unknown[];
+}
+export interface BrdbSqlite {
+    exec(sql: string): unknown;
+    prepare(sql: string): BrdbStatement;
+    close(): void;
+}
+export interface BrdbBlob {
+    blobId: number;
+    compression: number;
+    sizeUncompressed: number;
+    sizeCompressed: number;
+    deltaBaseId: number | null;
+    hash: Uint8Array;
+    content: Uint8Array;
+}
+export interface BrdbRevision {
+    revisionId: number;
+    description: string;
+    createdAt: number;
+}
+export interface WritePendingOptions {
+    /** Revision timestamp in unix seconds. Defaults to the wall clock. */
+    createdAt?: number;
+    /** Blob compressor. undefined uses the instance default (zstd level 14
+     * when opened through the lazy openers); null stores raw. */
+    compress?: Compressor | null;
+}
+export declare const BRDB_SQLITE_SCHEMA: string;
+export declare class Brdb implements WorldFs {
+    readonly db: BrdbSqlite;
+    /** Override how the better-sqlite3 module is resolved. Useful when a
+     * bundler or test runner cannot execute a native dynamic import. */
+    static engineLoader: (() => Promise<unknown>) | null;
+    /** zstd compressor applied to new blobs when no per-write compressor is
+     * given. The lazy openers set this; a directly-wrapped handle has none. */
+    defaultCompress: Compressor | null;
+    constructor(db: BrdbSqlite);
+    /** Create-container semantics on any handle: run the DDL and stamp the
+     * initial revision. */
+    static init(db: BrdbSqlite, createdAt?: number): Brdb;
+    /** Construct create/open semantics on a handle, closing it if construction
+     * (the DDL or the required-table guard) throws so a failed opener never
+     * leaks the underlying handle (and, on Windows, never leaves it locked). */
+    private static wrap;
+    /** Open an existing database file. Rejects (without creating a file) when
+     * the path does not already exist. */
+    static open(path: string): Promise<Brdb>;
+    /** Open an existing database file read-only. Rejects (without creating a
+     * file) when the path does not already exist. */
+    static openReadonly(path: string): Promise<Brdb>;
+    /** Create a new database file (container schema + initial revision). */
+    static create(path: string): Promise<Brdb>;
+    /** Open the file if it exists, otherwise create it. */
+    static openOrCreate(path: string): Promise<Brdb>;
+    /** New in-memory database. */
+    static memory(): Promise<Brdb>;
+    /** Open a database from serialized bytes. */
+    static fromBytes(bytes: Uint8Array): Promise<Brdb>;
+    /** Serialize the database to bytes (requires a better-sqlite3 handle). */
+    toBytes(): Uint8Array;
+    /** Write a world save as one revision. */
+    save(description: string, save: WriteBrzInput, options?: Omit<WriteBrzOptions, 'compress'> & WritePendingOptions): void;
+    /** Lazy world reader over this database (same surface as .brz reading).
+     * The reader caches decoded metadata (GlobalData, Owners, Bundle/World
+     * JSON) for its lifetime; if this Brdb is written to (save/writePending)
+     * after the reader is created, construct a fresh worldReader() rather
+     * than reusing the old one, or later reads may mix stale cached metadata
+     * with newly written chunk data. */
+    worldReader(): WorldReader;
+    sqliteSchema(): string;
+    createRevision(description: string, createdAt?: number): number;
+    revisions(): BrdbRevision[];
+    insertFolder(name: string, parentId: number | null, createdAt: number): number;
+    insertFile(name: string, parentId: number | null, contentId: number, createdAt: number): number;
+    /** Insert a blob (dedup by hash + uncompressed size), compressing when the
+     * compressor yields something strictly smaller. */
+    insertBlob(content: Uint8Array, hash: Uint8Array, compress: Compressor | null): number;
+    findBlobByHash(size: number, hash: Uint8Array): BrdbBlob | null;
+    findBlob(contentId: number): BrdbBlob;
+    deleteFile(fileId: number, deletedAt: number): void;
+    deleteFolder(folderId: number, deletedAt: number): void;
+    findFolder(parentId: number | null, name: string): number | null;
+    /** Like findFolder, but resolves against the tree as of a revision date
+     * instead of the current tree. Used by findFileByPathAtRevision so an
+     * ancestor folder that was soft-deleted after `date` does not hide a file
+     * that was still live at `date`. */
+    findFolderAtRevision(parentId: number | null, name: string, date: number): number | null;
+    findFile(parentId: number | null, name: string): FoundFile | null;
+    findFileAtRevision(parentId: number | null, name: string, date: number): FoundFile | null;
+    close(): void;
+    /** Merge a COMPLETE pending tree against the current tree in one
+     * transaction: identical files are noops, changed files are soft-deleted
+     * and reinserted, and existing entries absent from the pending tree are
+     * soft-deleted recursively. */
+    writePending(description: string, pending: PendingEntry[], options?: WritePendingOptions): void;
+    private currentFolders;
+    private currentFiles;
+    private mergeFolder;
+    private insertPending;
+    private deleteFolderRecursive;
+    /** Resolve a folder path. '' is the root. With no date, resolves against
+     * the current tree; with a date, resolves each segment against the tree
+     * as of that revision (see findFolderAtRevision). */
+    private folderIdOf;
+    findFileByPath(path: string): FoundFile | null;
+    /** Both folders and the leaf file resolve against the tree as of `date`,
+     * so a file is still reachable at a date before an ancestor folder was
+     * later soft-deleted. */
+    findFileByPathAtRevision(path: string, date: number): FoundFile | null;
+    childFolders(path: string): string[];
+    childFiles(path: string): string[];
+    /** Decompressed blob content. Empty files (contentId -1) yield empty
+     * bytes, matching the .brz reader's documented deviation. */
+    readBlob(contentId: number): Uint8Array;
+    readFile(path: string): Uint8Array;
+    /** The full current tree as a pending tree (folders first, then files,
+     * each in name order). */
+    toPending(): PendingEntry[];
+}
+//# sourceMappingURL=brdb.d.ts.map

package/dist/src/brdb/brdb.d.ts.map

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

package/dist/src/brdb/brz.d.ts

@@ -0,0 +1,51 @@
+import type { FoundFile, WorldFs } from './fs';
+import { PendingEntry } from './pending';
+export type Compressor = (data: Uint8Array) => Uint8Array | null;
+export interface BrzContainerOptions {
+    /** zstd compressor (e.g. node:zlib zstdCompressSync); return null to skip.
+     * Omitted -> every blob stored raw (still a valid archive, and what the
+     * byte-parity gates compare against). */
+    compress?: Compressor;
+}
+export declare function writeBrzContainer(root: PendingEntry[], options?: BrzContainerOptions): Uint8Array;
+export declare class BrzReader implements WorldFs {
+    readonly folderParentIds: number[];
+    readonly folderNames: string[];
+    readonly fileParentIds: number[];
+    readonly fileContentIds: number[];
+    readonly fileNames: string[];
+    private blobs;
+    private blobData;
+    private folderLut;
+    private fileLut;
+    private pathCache;
+    private constructor();
+    static from(data: Uint8Array): BrzReader;
+    /** parentId -1 = root */
+    findFolder(parentId: number, name: string): number | null;
+    findFile(parentId: number, name: string): {
+        contentId: number;
+    } | null;
+    private folderIdOf;
+    /** Names of the subfolders of a folder path ('' = root), in id order.
+     * A missing path yields []. */
+    childFolders(path: string): string[];
+    /** Names of the files directly inside a folder path ('' = root), in id
+     * order. A missing path yields []. */
+    childFiles(path: string): string[];
+    blobMethod(contentId: number): number;
+    private blob;
+    /** Decompress (if needed) and verify size + BLAKE3. */
+    readBlob(contentId: number): Uint8Array;
+    /** '/'-separated path from the root. An empty file (contentId -1) returns
+     * an empty buffer (the reference reader treats empty files as unfindable
+     * — deliberate, documented deviation for usability). */
+    readFile(path: string): Uint8Array;
+    /** Path lookup returning the WorldFs FoundFile shape. createdAt is always
+     * 0: a .brz archive holds exactly one revision. */
+    findFileByPath(path: string): FoundFile | null;
+    findFileByPathAtRevision(path: string, _date: number): FoundFile | null;
+    /** All file paths in file-id (BFS) order. */
+    listPaths(): string[];
+}
+//# sourceMappingURL=brz.d.ts.map

package/dist/src/brdb/brz.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brz.d.ts","sourceRoot":"","sources":["../../../src/brdb/brz.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAe,MAAM,WAAW,CAAC;AAEtD,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,UAAU,KAAK,UAAU,GAAG,IAAI,CAAC;AAEjE,MAAM,WAAW,mBAAmB;IAClC;;6CAEyC;IACzC,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,YAAY,EAAE,EACpB,OAAO,GAAE,mBAAwB,GAChC,UAAU,CAsGZ;AAWD,qBAAa,SAAU,YAAW,OAAO;IAMrC,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE;IAC5B,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,QAAQ;IAXlB,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,SAAS,CAAyB;IAE1C,OAAO;IAeP,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS;IAkFxC,yBAAyB;IACzB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIzD,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAKtE,OAAO,CAAC,UAAU;IAWlB;mCAC+B;IAC/B,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IASpC;0CACsC;IACtC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IASlC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAIrC,OAAO,CAAC,IAAI;IAMZ,uDAAuD;IACvD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU;IAkBvC;;4DAEwD;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAkBlC;uDACmD;IACnD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAU9C,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIvE,6CAA6C;IAC7C,SAAS,IAAI,MAAM,EAAE;CAkBtB"}

package/dist/src/brdb/bytes.d.ts

@@ -0,0 +1,56 @@
+export declare class ByteWriter {
+    private buf;
+    private view;
+    private len;
+    private ensure;
+    get length(): number;
+    u8(v: number): void;
+    i8(v: number): void;
+    bytes(v: Uint8Array | number[]): void;
+    u16be(v: number): void;
+    u32be(v: number): void;
+    u64be(v: bigint): void;
+    i16be(v: number): void;
+    i32be(v: number): void;
+    i64be(v: bigint): void;
+    f32be(v: number): void;
+    f64be(v: number): void;
+    u16le(v: number): void;
+    u32le(v: number): void;
+    u64le(v: bigint): void;
+    i16le(v: number): void;
+    i32le(v: number): void;
+    i64le(v: bigint): void;
+    f32le(v: number): void;
+    f64le(v: number): void;
+    toBytes(): Uint8Array;
+}
+export declare class ByteReader {
+    data: Uint8Array;
+    private view;
+    offset: number;
+    constructor(data: Uint8Array, offset?: number);
+    get remaining(): number;
+    private need;
+    peek(): number;
+    u8(): number;
+    i8(): number;
+    bytes(n: number): Uint8Array;
+    u16be(): number;
+    u32be(): number;
+    u64be(): bigint;
+    i16be(): number;
+    i32be(): number;
+    i64be(): bigint;
+    f32be(): number;
+    f64be(): number;
+    u16le(): number;
+    u32le(): number;
+    u64le(): bigint;
+    i16le(): number;
+    i32le(): number;
+    i64le(): bigint;
+    f32le(): number;
+    f64le(): number;
+}
+//# sourceMappingURL=bytes.d.ts.map

package/dist/src/brdb/bytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../../../src/brdb/bytes.ts"],"names":[],"mappings":"AAGA,qBAAa,UAAU;IACrB,OAAO,CAAC,GAAG,CAAuB;IAClC,OAAO,CAAC,IAAI,CAAiC;IAC7C,OAAO,CAAC,GAAG,CAAK;IAEhB,OAAO,CAAC,MAAM;IAUd,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,EAAE,CAAC,CAAC,EAAE,MAAM;IAKZ,EAAE,CAAC,CAAC,EAAE,MAAM;IAMZ,KAAK,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,EAAE;IAO9B,KAAK,CAAC,CAAC,EAAE,MAAM;IAKf,KAAK,CAAC,CAAC,EAAE,MAAM;IAKf,KAAK,CAAC,CAAC,EAAE,MAAM;IAKf,KAAK,CAAC,CAAC,EAAE,MAAM;IAKf,KAAK,CAAC,CAAC,EAAE,MAAM;IAKf,KAAK,CAAC,CAAC,EAAE,MAAM;IAKf,KAAK,CAAC,CAAC,EAAE,MAAM;IAKf,KAAK,CAAC,CAAC,EAAE,MAAM;IAMf,KAAK,CAAC,CAAC,EAAE,MAAM;IAKf,KAAK,CAAC,CAAC,EAAE,MAAM;IAKf,KAAK,CAAC,CAAC,EAAE,MAAM;IAKf,KAAK,CAAC,CAAC,EAAE,MAAM;IAKf,KAAK,CAAC,CAAC,EAAE,MAAM;IAKf,KAAK,CAAC,CAAC,EAAE,MAAM;IAKf,KAAK,CAAC,CAAC,EAAE,MAAM;IAKf,KAAK,CAAC,CAAC,EAAE,MAAM;IAMf,OAAO,IAAI,UAAU;CAGtB;AAED,qBAAa,UAAU;IAIF,IAAI,EAAE,UAAU;IAHnC,OAAO,CAAC,IAAI,CAAW;IACvB,MAAM,EAAE,MAAM,CAAC;gBAEI,IAAI,EAAE,UAAU,EAAE,MAAM,SAAI;IAK/C,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,OAAO,CAAC,IAAI;IAOZ,IAAI,IAAI,MAAM;IAKd,EAAE,IAAI,MAAM;IAIZ,EAAE,IAAI,MAAM;IAKZ,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU;IAO5B,KAAK,IAAI,MAAM;IAMf,KAAK,IAAI,MAAM;IAMf,KAAK,IAAI,MAAM;IAMf,KAAK,IAAI,MAAM;IAMf,KAAK,IAAI,MAAM;IAMf,KAAK,IAAI,MAAM;IAMf,KAAK,IAAI,MAAM;IAMf,KAAK,IAAI,MAAM;IAOf,KAAK,IAAI,MAAM;IAMf,KAAK,IAAI,MAAM;IAMf,KAAK,IAAI,MAAM;IAMf,KAAK,IAAI,MAAM;IAMf,KAAK,IAAI,MAAM;IAMf,KAAK,IAAI,MAAM;IAMf,KAAK,IAAI,MAAM;IAMf,KAAK,IAAI,MAAM;CAMhB"}

package/dist/src/brdb/catalog.d.ts

@@ -0,0 +1,5 @@
+export declare const BASIC_BRICK_ASSETS: readonly string[];
+export declare const PROCEDURAL_BRICK_ASSETS: readonly string[];
+/** Classify a brick asset as procedural (parametric, carries a size) or basic. */
+export declare function isProceduralAsset(name: string): boolean;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/src/brdb/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/brdb/catalog.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAwJ/C,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAuCpD,CAAC;AAKF,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKvD"}

package/dist/src/brdb/componentDb.d.ts

@@ -0,0 +1,8 @@
+/** Component type name -> data struct name ("None" = no data struct). */
+export declare const COMPONENT_TYPE_STRUCTS: ReadonlyMap<string, string>;
+/** Known wire port names (a save's port registry is built from the ports
+ * its wires actually use, but names must come from this vocabulary). */
+export declare const WIRE_PORT_NAMES: readonly string[];
+/** Entity type name -> data class name. */
+export declare const ENTITY_TYPE_STRUCTS: ReadonlyMap<string, string>;
+//# sourceMappingURL=componentDb.d.ts.map

package/dist/src/brdb/componentDb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentDb.d.ts","sourceRoot":"","sources":["../../../src/brdb/componentDb.ts"],"names":[],"mappings":"AAGA,yEAAyE;AACzE,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAkiC7D,CAAC;AAEH;wEACwE;AACxE,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAsiB5C,CAAC;AAEF,2CAA2C;AAC3C,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAG1D,CAAC"}

package/dist/src/brdb/fs.d.ts

@@ -0,0 +1,16 @@
+export interface FoundFile {
+    contentId: number;
+    createdAt: number;
+}
+export interface WorldFs {
+    findFileByPath(path: string): FoundFile | null;
+    /** The file revision whose [created_at, deleted_at) interval contains
+     * date. For single-revision containers this is findFileByPath. */
+    findFileByPathAtRevision(path: string, date: number): FoundFile | null;
+    /** Decompressed blob content. */
+    readBlob(contentId: number): Uint8Array;
+    readFile(path: string): Uint8Array;
+    /** Names of the subfolders of a folder path ('' = root). */
+    childFolders(path: string): string[];
+}
+//# sourceMappingURL=fs.d.ts.map

package/dist/src/brdb/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../../src/brdb/fs.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,OAAO;IACtB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAC/C;sEACkE;IAClE,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IACvE,iCAAiC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;IACnC,4DAA4D;IAC5D,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACtC"}

package/dist/src/brdb/guid.d.ts

@@ -0,0 +1,11 @@
+export interface BrGuid {
+    A: number;
+    B: number;
+    C: number;
+    D: number;
+}
+/** Owner-table row 0 sentinel (the PUBLIC owner). */
+export declare const PUBLIC_GUID: BrGuid;
+export declare function uuidToGuid(uuid: string): BrGuid;
+export declare function guidToUuid(guid: BrGuid): string;
+//# sourceMappingURL=guid.d.ts.map

package/dist/src/brdb/guid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guid.d.ts","sourceRoot":"","sources":["../../../src/brdb/guid.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,MAAM;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,qDAAqD;AACrD,eAAO,MAAM,WAAW,EAAE,MAKzB,CAAC;AAEF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAS/C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ/C"}

package/dist/src/brdb/index.d.ts

@@ -0,0 +1,21 @@
+export { CHUNK_HALF, CHUNK_SIZE, saveToPendingFs, toRelative, writeBrzLegacy, } from './world';
+export type { BrdbBrickExtras, BrdbComponentInput, BrdbSaveExtras, BrdbWireEndpointInput, BrdbWireInput, BundleJson, WriteBrzInput, WriteBrzOptions, WriteBrzSave, } from './world';
+export { MAIN_GRID, WorldReader } from './reader';
+export type { BrickChunkRef, BrzWorldBrick, ChunkCoord, ComponentInstance, EntityChunkIndex, EntityChunkRef, EntityRecord, FoundFile, RemoteWireEndpoint, WireChunk, WireEndpoint, WorldFs, } from './reader';
+export { BrzReader, writeBrzContainer } from './brz';
+export type { BrzContainerOptions, Compressor } from './brz';
+export { BrdbSchema, embeddedSchema } from './schema';
+export type { BrdbValue, BrdbVariant, PropDesc, SchemaSource, SchemaSourceProp, } from './schema';
+export type { SchemaData } from './schemaText';
+export type { EmbeddedSchemaName } from './schemas';
+export { guidToUuid, PUBLIC_GUID, uuidToGuid } from './guid';
+export type { BrGuid } from './guid';
+export { file, folder } from './pending';
+export type { PendingEntry, PendingNode } from './pending';
+export { isProceduralAsset } from './catalog';
+export { Brdb, BRDB_SQLITE_SCHEMA } from './brdb';
+export type { BrdbBlob, BrdbRevision, BrdbSqlite, BrdbStatement, WritePendingOptions, } from './brdb';
+export { bit, BitFlags } from './bits';
+export { ByteReader, ByteWriter } from './bytes';
+export * as msgpack from './msgpack';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/brdb/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/brdb/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,UAAU,EACV,eAAe,EACf,UAAU,EACV,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,UAAU,EACV,aAAa,EACb,eAAe,EACf,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAClD,YAAY,EACV,aAAa,EACb,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,SAAS,EACT,YAAY,EACZ,OAAO,GACR,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACtD,YAAY,EACV,SAAS,EACT,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC7D,YAAY,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAClD,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,aAAa,EACb,mBAAmB,GACpB,MAAM,QAAQ,CAAC;AAIhB,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC"}

package/dist/src/brdb/msgpack.d.ts

@@ -0,0 +1,23 @@
+import { ByteReader, ByteWriter } from './bytes';
+export declare const mpNil: (w: ByteWriter) => void;
+export declare const mpBool: (w: ByteWriter, v: boolean) => void;
+export declare function mpU8(w: ByteWriter, v: number): void;
+export declare function mpUint(w: ByteWriter, v: number): void;
+export declare function mpInt(w: ByteWriter, v: number): void;
+export declare function mpF32(w: ByteWriter, v: number): void;
+export declare function mpF64(w: ByteWriter, v: number): void;
+export declare function mpStr(w: ByteWriter, s: string): void;
+export declare function mpBinHeader(w: ByteWriter, len: number): void;
+export declare function mpArrayHeader(w: ByteWriter, len: number): void;
+export declare function mpMapHeader(w: ByteWriter, len: number): void;
+export declare function rdInt(r: ByteReader): number;
+export declare function rdUint(r: ByteReader): number;
+export declare function rdF32(r: ByteReader): number;
+export declare function rdF64(r: ByteReader): number;
+export declare function rdBool(r: ByteReader): boolean;
+export declare function rdStr(r: ByteReader): string;
+export declare function rdBinLen(r: ByteReader): number;
+export declare function rdArrayLen(r: ByteReader): number;
+export declare function rdMapLen(r: ByteReader): number;
+export declare function rdNil(r: ByteReader): void;
+//# sourceMappingURL=msgpack.d.ts.map

package/dist/src/brdb/msgpack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"msgpack.d.ts","sourceRoot":"","sources":["../../../src/brdb/msgpack.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAUjD,eAAO,MAAM,KAAK,GAAI,GAAG,UAAU,SAAe,CAAC;AACnD,eAAO,MAAM,MAAM,GAAI,GAAG,UAAU,EAAE,GAAG,OAAO,SAA0B,CAAC;AAI3E,wBAAgB,IAAI,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,QAU5C;AAGD,wBAAgB,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,QAiB9C;AAID,wBAAgB,KAAK,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,QA+B7C;AAID,wBAAgB,KAAK,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,QAM7C;AAGD,wBAAgB,KAAK,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,QAO7C;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,QAe7C;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,QAWrD;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,QASvD;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,QASrD;AAyBD,wBAAgB,KAAK,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAwB3C;AAMD,wBAAgB,MAAM,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAsB5C;AAGD,wBAAgB,KAAK,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAkB3C;AAGD,wBAAgB,KAAK,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAwB3C;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,UAAU,GAAG,OAAO,CAK7C;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAS3C;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAM9C;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAMhD;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAM9C;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI,CAGzC"}

package/dist/src/brdb/pending.d.ts

@@ -0,0 +1,11 @@
+export type PendingEntry = [name: string, node: PendingNode];
+export type PendingNode = {
+    type: 'folder';
+    children: PendingEntry[];
+} | {
+    type: 'file';
+    content: Uint8Array;
+};
+export declare const folder: (children: PendingEntry[]) => PendingNode;
+export declare const file: (content: Uint8Array) => PendingNode;
+//# sourceMappingURL=pending.d.ts.map

package/dist/src/brdb/pending.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending.d.ts","sourceRoot":"","sources":["../../../src/brdb/pending.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AAC7D,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,YAAY,EAAE,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,UAAU,CAAA;CAAE,CAAC;AAE1C,eAAO,MAAM,MAAM,GAAI,UAAU,YAAY,EAAE,KAAG,WAGhD,CAAC;AAEH,eAAO,MAAM,IAAI,GAAI,SAAS,UAAU,KAAG,WAGzC,CAAC"}

package/dist/src/brdb/reader.d.ts

@@ -0,0 +1,176 @@
+import type { Collision, Owner, Vector } from '../brs/types';
+import type { WorldFs } from './fs';
+import { BrdbSchema, BrdbValue } from './schema';
+import { BundleJson } from './world';
+export type { FoundFile, WorldFs } from './fs';
+export declare const MAIN_GRID = 1;
+export interface ChunkCoord {
+    x: number;
+    y: number;
+    z: number;
+}
+export interface BrickChunkRef {
+    index: ChunkCoord;
+    offset: ChunkCoord;
+    size: number;
+    numBricks: number;
+    numComponents: number;
+    numWires: number;
+}
+export interface EntityChunkRef {
+    index: ChunkCoord;
+    numEntities: number;
+}
+export interface EntityChunkIndex {
+    nextPersistentIndex: number;
+    chunks: EntityChunkRef[];
+}
+export interface ComponentInstance {
+    typeName: string;
+    structName: string | null;
+    /** the owning brick's local index within its chunk */
+    brickIndex: number;
+    data: Record<string, BrdbValue> | null;
+}
+export interface WireEndpoint {
+    /** the endpoint brick's local index within its chunk */
+    brickIndex: number;
+    componentType: string;
+    port: string;
+}
+export interface RemoteWireEndpoint extends WireEndpoint {
+    gridId: number;
+    chunk: ChunkCoord;
+}
+export interface WireChunk {
+    /** wires whose source is in the same grid+chunk as the target */
+    local: Array<{
+        source: WireEndpoint;
+        target: WireEndpoint;
+    }>;
+    /** wires whose source lives in another grid or chunk */
+    remote: Array<{
+        source: RemoteWireEndpoint;
+        target: WireEndpoint;
+    }>;
+}
+export interface EntityRecord {
+    typeName: string;
+    className: string | null;
+    persistentIndex: number;
+    ownerIndex: number;
+    originalOwnerIndex: number;
+    location: {
+        X: number;
+        Y: number;
+        Z: number;
+    };
+    rotation: {
+        X: number;
+        Y: number;
+        Z: number;
+        W: number;
+    };
+    frozen: boolean;
+    sleeping: boolean;
+    linearVelocity: {
+        X: number;
+        Y: number;
+        Z: number;
+    };
+    angularVelocity: {
+        X: number;
+        Y: number;
+        Z: number;
+    };
+    colors: Record<string, BrdbValue>;
+    remainingLifeSpan: number;
+    data: Record<string, BrdbValue> | null;
+}
+export interface BrzWorldBrick {
+    asset_name_index: number;
+    size: Vector;
+    position: Vector;
+    direction: number;
+    rotation: number;
+    collision: Collision;
+    visibility: boolean;
+    material_index: number;
+    material_intensity: number;
+    color: [number, number, number];
+    owner_index: number;
+}
+/** Convert one linear-light color channel (0-255) to sRGB. Saves whose
+ * colors are stored linear (bColorsAreLinear true, or the field missing
+ * entirely on older saves) need this on read; new saves store sRGB already
+ * and skip the conversion. Values at or below 0x0F scale into a 15-wide
+ * range instead of 255, matching the low-value storage convention used
+ * throughout the color format. */
+export declare function linearToSrgb(v: number): number;
+/** Reads a .brz or .brdb world lazily through a WorldFs. Schema blobs and
+ * decoded metadata (GlobalData, Owners, Bundle/World JSON) are cached for
+ * the lifetime of the reader; chunk payloads are always decoded fresh. For
+ * a .brz this is safe by construction (the archive never changes), but a
+ * reader built over a live Brdb (Brdb.worldReader()) must not be reused
+ * across a write to that database: construct a new reader afterward so
+ * cached metadata cannot mix with newly written chunk data. */
+export declare class WorldReader {
+    readonly fs: WorldFs;
+    readonly worldId: number;
+    private schemas;
+    private values;
+    constructor(fs: WorldFs, worldId?: number);
+    static from(data: Uint8Array): WorldReader;
+    private path;
+    /** Parse a .schema blob once per revision; later calls return the cached
+     * schema. The public form resolves the schema file's own (latest)
+     * revision. */
+    schema(path: string): BrdbSchema;
+    /** Schema as it existed at `revision` (a created_at timestamp). Schemas
+     * evolve over a world's history; data files must decode with the schema
+     * revision that was live when they were written. */
+    private schemaAt;
+    private decode;
+    private cached;
+    bundle(): BundleJson;
+    environment(): {
+        environment: string;
+    };
+    globalData(): any;
+    owners(): any;
+    /** Basic asset names followed by procedural — decoded brick
+     * asset_name_index values point into this combined list. */
+    brickAssets(): string[];
+    materials(): string[];
+    /** Owner rows 1.. (the PUBLIC row 0 is excluded). */
+    brickOwners(): Owner[];
+    /** Grid ids under Bricks/Grids: 1 = the main grid, ≥2 = entity sub-grids. */
+    gridIds(): number[];
+    brickChunkIndex(gridId?: number): BrickChunkRef[];
+    /** Decode one brick chunk's SoA. Not cached: chunk payloads are the bulk
+     * of an archive and are meant to be streamed, not retained. */
+    brickChunkSoa(gridId: number, chunk: ChunkCoord): any;
+    /** Lazily decode a grid's bricks, one chunk at a time. Positions are
+     * relative to the grid's origin: world origin for the main grid (1),
+     * entity-relative for sub-grids (≥2). */
+    bricks(gridId?: number): Generator<BrzWorldBrick, void, void>;
+    /** Entity chunk registry. */
+    entityChunkIndex(): EntityChunkIndex;
+    /** Decode a component chunk: the SoA plus each instance's trailing data
+     * struct. Instances stream in counter order; a type whose data-struct
+     * slot is missing or "None" contributes no trailing bytes. */
+    componentChunk(gridId: number, chunk: ChunkCoord): {
+        soa: any;
+        components: ComponentInstance[];
+    };
+    /** Decode a wire chunk. Wires live in the TARGET's grid+chunk; local
+     * rows are same-grid-same-chunk sources, remote rows carry the source
+     * grid + chunk. Component/port names resolve through GlobalData. */
+    wireChunk(gridId: number, chunk: ChunkCoord): WireChunk;
+    /** Decode one entity chunk: the SoA plus each entity's trailing data
+     * struct (gated on EntityDataClassNames: absent or "None" = no struct). */
+    entityChunk(chunk: ChunkCoord): EntityRecord[];
+    /** Lazily decode every entity, one chunk at a time. */
+    entities(): Generator<EntityRecord, void, void>;
+}
+//# sourceMappingURL=reader.d.ts.map

package/dist/src/brdb/reader.d.ts.map

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