@gaialabs/core 0.2.12 → 0.2.14

package/dist/index.d.cts

@@ -255,6 +255,7 @@ declare class DbFile {
   upper?: boolean;
   group?: string;
   scene?: string;
+  base?: number;
   constructor(data: Partial<DbFile>);
 }
 declare class DbFileType {
@@ -265,6 +266,8 @@ declare class DbFileType {
   isBlock: boolean;
   header: number;
   compressed?: boolean;
+  struct?: string;
+  base?: number;
   constructor(data: Partial<DbFileType>);
 }
 //#endregion
@@ -328,70 +331,116 @@ interface ICompressionProvider {
   compact(srcData: Uint8Array, srcPosition?: number, srcLen?: number): Uint8Array;
 }
 //#endregion
-//#region src/types/files.d.ts
+//#region src/database/entrypoints.d.ts
 /**
- * Chunk file for ROM processing
- * Converted from GaiaLib/Types/ChunkFile.cs
+ * Database entry point definition
+ * Converted from GaiaLib/Database/DbEntryPoint.cs
  */
-declare class ChunkFile {
+interface DbEntryPoint {
+  location: number;
+  name: string;
+}
+//#endregion
+//#region src/database/config.d.ts
+/**
+ * Database configuration
+ * Converted from GaiaLib/Database/DbConfig.cs
+ */
+interface DbConfig {
+  sfxLocation: number;
+  sfxCount: number;
+  sfxType: string;
+  sfxPack: string;
+  compression: string;
+  uncompress: boolean;
+  entryPoints: DbEntryPoint[];
+  memoryMode: MemoryMapMode;
+  cpuMode: CpuMode;
+  chipset: number;
+  ramSize: number;
+  defaultBank?: number;
+}
+//#endregion
+//#region src/database/structs.d.ts
+/**
+ * Database structure definition
+ * Converted from GaiaLib/Database/DbStruct.cs
+ */
+declare class DbStruct {
+  name: string;
+  types?: string[];
+  parent?: string;
+  delimiter?: number;
+  discriminator?: number;
+  discriminatorLogic?: string;
+  null?: number;
+  constructor(data: Partial<DbStruct>);
+}
+//#endregion
+//#region src/database/addressingMode.d.ts
+declare class DbAddressingMode {
   name: string;
+  shorthand: string;
+  operands: string[];
   size: number;
-  location: number;
-  type: DbFileType;
-  parts?: AsmBlock[];
-  includes?: Set<string>;
-  includeLookup?: Map<string, AsmBlock>;
-  bank?: number;
-  compressed?: boolean;
-  upper?: boolean;
-  rawData?: Uint8Array | null;
-  textData?: string;
-  transforms?: {
-    key: string;
-    value: string;
-  }[];
-  postProcess?: string;
-  mnemonics: Record<number, string>;
-  group?: string;
-  scene?: string;
-  constructor(name: string, size: number, location: number, type: DbFileType);
+  formatString?: string;
+  parseRegex?: string;
+  instructions: Record<string, number>;
+  constructor(data: Partial<DbAddressingMode>);
 }
-declare function createChunkFileFromDbFile(rom: Uint8Array, compression: ICompressionProvider | undefined, dbFile: DbFile, fileType: DbFileType): ChunkFile;
-declare function createChunkFileFromDbBlock(block: DbBlock, fileType: DbFileType, memoryMode: MemoryMapMode): ChunkFile;
+//#endregion
+//#region src/database/strings.d.ts
 /**
- * Chunk file utilities
+ * Database string command definition
+ * Converted from GaiaLib/Database/DbStringCommand.cs
  */
-declare class ChunkFileUtils {
-  /**
-   * Rebase blocks to a new location
-   */
-  static rebase(chunkFile: ChunkFile, newLocation?: number): void;
-  /**
-   * Calculate the total size of all blocks
-   */
-  static calculateSize(chunkFile: ChunkFile): number;
-  /**
-  * Check if a location is outside this block and return the part (matches C# IsOutside)
-  * Returns [isOutside, part] where part is the part containing the location
-  */
-  static isOutsideWithPart(root: ChunkFile[], block: ChunkFile, location: number): [boolean, ChunkFile | null, AsmBlock | null];
-  /**
-   * Check if a location is inside this block and return the part (matches C# IsInside)
-   * Returns [isInside, part] where part is the part containing the location
-   */
-  static isInsideWithPart(block: ChunkFile, location: number): [boolean, AsmBlock | null];
-  /**
-   * Check if a location is outside this block (shorthand version)
-   */
-  static isOutside(block: ChunkFile, location: number): boolean;
-  /**
-   * Check if a location is inside this block (shorthand version)
-   */
-  static isInside(block: ChunkFile, location: number): boolean;
-  /**
-   * Get all included blocks
-   */
-  static getIncludes(chunkFile: ChunkFile): ChunkFile[];
+declare class DbStringCommand {
+  id: number;
+  name: string;
+  types: string[];
+  delimiter?: number;
+  halt: boolean;
+  dictionary?: DbStringDictionary;
+  constructor(data: Partial<DbStringCommand>);
+}
+/**
+ * Database string layer definition
+ * Converted from GaiaLib/Database/DbStringLayer.cs
+ */
+interface DbStringLayer {
+  base?: number;
+  range?: number;
+  on?: number;
+  shiftBit?: number;
+  map: string[];
+}
+declare class DbStringDictionary {
+  base?: number;
+  command?: number;
+  commandName?: string;
+  name: string;
+  entries: string[];
+  constructor(data: Partial<DbStringDictionary>);
+}
+/**
+ * Database string type definition
+ * Converted from GaiaLib/Database/DbStringType.cs
+ */
+declare class DbStringType {
+  name: string;
+  delimiter: string;
+  terminator: number;
+  commands: Record<string, DbStringCommand>;
+  commandLookup: Record<number, DbStringCommand>;
+  layers: DbStringLayer[];
+  greedyTerminator: boolean;
+  dictionaries: Record<string, DbStringDictionary>;
+  dictionaryLookup: {
+    text: string;
+    id: number;
+  }[];
+  modifiers?: Record<number, Record<string, string>>;
+  constructor(data: Partial<DbStringType>);
 }
 //#endregion
 //#region src/database/cop.d.ts
@@ -405,8 +454,15 @@ declare class CopDef {
   size: number;
   parts: string[];
   halt: boolean;
+  conditions?: CopCondition[];
   constructor(data: Partial<CopDef>);
 }
+interface CopCondition {
+  offset: number;
+  value: number;
+  size: number;
+  parts: string[];
+}
 //#endregion
 //#region src/database/opcode.d.ts
 declare class OpCode {
@@ -416,537 +472,83 @@ declare class OpCode {
   constructor(code: number, mnem: string, mode: string);
 }
 //#endregion
-//#region src/types/assembly.d.ts
+//#region src/database/assets.d.ts
+interface DbAsset {
+  index: number;
+  type: string;
+  file: string;
+  scene: string;
+  meta: any;
+}
+//#endregion
+//#region src/database/scenes.d.ts
+declare class DbScene {
+  name: string;
+  id: number;
+  description?: string;
+  assets: DbAsset[];
+  constructor(data: Partial<DbScene>);
+}
+//#endregion
+//#region src/database/groups.d.ts
+declare class DbGroup {
+  name: string;
+  prefix: string;
+  description?: string;
+  scenes: Record<string, DbScene>;
+  constructor(data: Partial<DbGroup>);
+}
+//#endregion
+//#region src/supabase/types.d.ts
 /**
- * Represents a single assembly operation/instruction
+ * TypeScript interfaces for Supabase API responses
+ * These types represent the structured data returned from ROM database queries
  */
-declare class Op extends OpCode {
-  location: number;
-  operands: unknown[];
-  size: number;
-  copDef?: CopDef;
-  constructor(code: OpCode, location?: number, operands?: unknown[], size?: number);
+interface PlatformData {
+  id: string;
+  name: string;
+  meta: any | null;
+  createdAt: string;
+  updatedAt: string;
+}
+interface BranchBaseData {
+  id: string;
+  name: string | null;
+  version: number | null;
+  isActive?: boolean | null;
+  notes?: string[] | null;
+  createdAt: string;
+  updatedAt: string;
+}
+interface FileBaseData {
+  id: string;
+  name: string;
+  type: string;
+  version: number | null;
+  crc: number | null;
+  meta: any | null;
+  isText: boolean;
+  text: string | null;
+  data: Uint8Array | null;
+  createdAt: string;
+  updatedAt: string;
+}
+interface FileBaseRaw extends Omit<FileBaseData, 'data'> {
+  data: string | null;
 }
 /**
- * Represents a block of assembly code or data
+ * Platform branch information containing instruction set and addressing modes
  */
-declare class AsmBlock {
-  label?: string;
-  location: number;
-  size: number;
-  isString: boolean;
-  objList: any[];
-  structName?: string;
-  bank?: number;
-  includes?: Set<{
-    block: ChunkFile;
-    part: AsmBlock;
-  }>;
-  constructor(location?: number, size?: number, isString?: boolean, label?: string, structName?: string, bank?: number);
+interface PlatformBranchData extends BranchBaseData {
+  platformId: string;
+  addressingModes: any | null;
+  headers: any | null;
+  vectors: any | null;
+  types: any | null;
+  platform: PlatformData;
 }
 /**
- * Database part utilities
- */
-declare class AsmBlockUtils {
-  /**
-   * Check if a location is inside this part
-   */
-  static isInside(part: AsmBlock, location: number): boolean;
-  /**
-   * Check if a location is outside this part
-   */
-  static isOutside(part: AsmBlock, location: number): boolean;
-}
-//#endregion
-//#region src/types/bitstream.d.ts
-/**
- * Bit stream for reading/writing binary data at bit level
- * Converted from GaiaLib/Types/BitStream.cs
- */
-declare class BitStream {
-  private static readonly NIBBLE_MASK;
-  private static readonly NIBBLE_PERFECT_POSITION;
-  private data;
-  private position;
-  private bitFlag;
-  private writeSample;
-  constructor(data: Uint8Array, position?: number);
-  get dataArray(): Uint8Array;
-  get currentPosition(): number;
-  set currentPosition(value: number);
-  /**
-   * Read a byte from the stream
-   * @returns The byte read, or -1 if the end of the data has been reached
-   */
-  readByte(): number;
-  /**
-   * Read a ushort from the stream (ignores the current bit flag)
-   * @returns The short read, or -1 if the end of the data has been reached
-   */
-  readShort(): number;
-  /**
-   * Read a bit from the stream
-   * @returns True if the current bit at bitFlag is set, false otherwise
-   */
-  readBit(): boolean;
-  /**
-   * Read a nibble from the stream
-   * @returns The nibble read, or -1 if the end of the data has been reached
-   */
-  readNibble(): number;
-  /**
-   * Write a bit to the stream
-   * @param set True if the current bit should be set, false otherwise
-   */
-  writeBit(set: boolean): void;
-  /**
-   * Write a byte to the stream
-   * @param value The byte to write
-   */
-  writeByte(value: number): void;
-  /**
-   * Write a nibble to the stream
-   * @param value The nibble to write
-   */
-  writeNibble(value: number): void;
-  flush(): void;
-}
-//#endregion
-//#region src/types/compression-registry.d.ts
-/**
- * Registry for compression providers
- * Allows registration of compression implementations by string ID
- */
-declare class CompressionRegistry {
-  private static providers;
-  /**
-   * Register a compression provider
-   * @param id String identifier for the compression type
-   * @param factory Factory function that creates the compression provider
-   */
-  static register(id: string, factory: () => ICompressionProvider): void;
-  /**
-   * Get a compression provider by ID
-   * @param id String identifier for the compression type
-   * @returns Compression provider instance
-   */
-  static get(id: string): ICompressionProvider;
-  /**
-   * Check if a compression provider is registered
-   * @param id String identifier for the compression type
-   * @returns True if provider is registered
-   */
-  static has(id: string): boolean;
-  /**
-   * Get list of registered provider IDs
-   * @returns Array of registered provider IDs
-   */
-  static getRegisteredIds(): string[];
-  /**
-   * Clear all registered providers (mainly for testing)
-   */
-  static clear(): void;
-}
-//#endregion
-//#region src/types/constants.d.ts
-/**
- * ROM processing constants
- * Converted from GaiaLib/Types/RomProcessingConstants.cs
- */
-declare class RomProcessingConstants {
-  static readonly PAGE_SIZE = 32768;
-  static readonly SNES_HEADER_SIZE = 80;
-  static readonly DICTIONARIES: string[];
-  static readonly DICT_COMMANDS: number[];
-  static readonly END_CHARS: number[];
-  static readonly WHITESPACE: string[];
-  static readonly OPERATORS: string[];
-  static readonly COMMA_SPACE: string[];
-  static readonly ADDRESS_SPACE: string[];
-  static readonly SYMBOL_SPACE: string[];
-  static readonly LABEL_SPACE: string[];
-  static readonly OBJECT_SPACE: string[];
-  static readonly COP_SPLIT_CHARS: string[];
-  static readonly WHITESPACE_REGEX: RegExp;
-  static readonly COMMA_SPACE_REGEX: RegExp;
-  static readonly SYMBOL_SPACE_REGEX: RegExp;
-  static readonly LABEL_SPACE_REGEX: RegExp;
-  static readonly OBJECT_SPACE_REGEX: RegExp;
-  static readonly ADDRESS_SPACE_REGEX: RegExp;
-  static readonly COP_SPLIT_REGEX: RegExp;
-  static readonly COMMA_SPACE_TRIM_REGEX: RegExp;
-  /**
-   * Gets the size of an object for processing purposes
-   * @param obj The object to get the size for
-   * @returns Size in bytes
-   * @throws Error when unable to determine size
-   */
-  static getSize(obj: unknown): number;
-}
-/**
- * BlockReader specific constants
- */
-declare class BlockReaderConstants {
-  static readonly REF_SEARCH_MAX_RANGE = 416;
-  static readonly BANK_MASK_CHECK = 64;
-  static readonly BYTE_DELIMITER_THRESHOLD = 256;
-  static readonly BANK_HIGH_MEMORY_1 = 126;
-  static readonly BANK_HIGH_MEMORY_2 = 127;
-  static readonly POINTER_CHARACTERS: string[];
-  static readonly WIDE_STRING_TYPE = "WideString";
-  static readonly BINARY_TYPE = "Binary";
-  static readonly CODE_TYPE = "Code";
-  static readonly LOCATION_FORMAT = "loc_{0:X6}";
-  static readonly TYPE_NAME_FORMAT = "{0}_{1:X6}";
-  static readonly OFFSET_FORMAT = "+{0:X}";
-  static readonly MARKER_FORMAT = "+M";
-  static readonly NEGATIVE_OFFSET_FORMAT = "-{0:X}";
-  static readonly NEGATIVE_MARKER_FORMAT = "-M";
-}
-//#endregion
-//#region src/types/location.d.ts
-/**
- * Location wrapper for additional metadata
- * Converted from GaiaLib/Types/LocationWrapper.cs
- */
-declare class LocationWrapper {
-  location: number;
-  type: AddressType;
-  constructor(location: number, type: AddressType);
-}
-//#endregion
-//#region src/database/strings.d.ts
-/**
- * Database string command definition
- * Converted from GaiaLib/Database/DbStringCommand.cs
- */
-declare class DbStringCommand {
-  id: number;
-  name: string;
-  types: string[];
-  delimiter?: number;
-  halt: boolean;
-  dictionary?: DbStringDictionary;
-  constructor(data: Partial<DbStringCommand>);
-}
-/**
- * Database string layer definition
- * Converted from GaiaLib/Database/DbStringLayer.cs
- */
-interface DbStringLayer {
-  base?: number;
-  range?: number;
-  on?: number;
-  shiftBit?: number;
-  map: string[];
-}
-declare class DbStringDictionary {
-  command?: number;
-  commandName?: string;
-  name: string;
-  entries: string[];
-  constructor(data: Partial<DbStringDictionary>);
-}
-/**
- * Database string type definition
- * Converted from GaiaLib/Database/DbStringType.cs
- */
-declare class DbStringType {
-  name: string;
-  delimiter: string;
-  terminator: number;
-  commands: Record<string, DbStringCommand>;
-  commandLookup: Record<number, DbStringCommand>;
-  layers: DbStringLayer[];
-  greedyTerminator: boolean;
-  dictionaries: Record<string, DbStringDictionary>;
-  dictionaryLookup: {
-    text: string;
-    id: number;
-  }[];
-  constructor(data: Partial<DbStringType>);
-}
-//#endregion
-//#region src/types/strings.d.ts
-/**
- * String marker for positioning
- * Converted from GaiaLib/Types/StringMarker.cs
- */
-interface StringMarker {
-  offset: number;
-}
-/**
- * String wrapper with type and location information
- * Converted from GaiaLib/Types/StringWrapper.cs
- */
-interface StringWrapper {
-  string: string;
-  type: DbStringType;
-  marker: number;
-  location: number;
-  fixedSize: number;
-}
-/**
- * String entry (commented out in original C# code)
- * Converted from GaiaLib/Types/StringEntry.cs
- */
-interface StringEntry {
-  block: AsmBlock;
-  index: number;
-  size: number;
-  data: Uint8Array;
-}
-/**
- * String size comparer utility
- * Converted from GaiaLib/Types/StringSizeComparer.cs
- */
-declare class StringSizeComparer {
-  /**
-   * Compare two strings by length
-   */
-  static compare(a: string, b: string): number;
-  /**
-   * Compare two StringWrapper objects by string length
-   */
-  static compareWrappers(a: StringWrapper, b: StringWrapper): number;
-}
-//#endregion
-//#region src/types/structs.d.ts
-/**
- * Structure definition
- * Converted from GaiaLib/Types/StructDef.cs
- */
-interface StructDef {
-  name: string;
-  parts: unknown[];
-}
-//#endregion
-//#region src/types/tables.d.ts
-declare class TableEntry {
-  location: number;
-  object: unknown;
-  constructor(location: number);
-}
-//#endregion
-//#region src/types/operands.d.ts
-declare class TypedNumber {
-  value: number;
-  size: number;
-  constructor(value: number, size: number);
-}
-declare class Byte extends TypedNumber {
-  constructor(value: number);
-}
-declare class Word extends TypedNumber {
-  constructor(value: number);
-}
-declare class Long extends TypedNumber {
-  constructor(value: number);
-}
-//#endregion
-//#region src/assembly/Registers.d.ts
-/**
- * Manages the 65816 processor registers and status flags
- */
-declare class Registers {
-  value: Record<string, number>;
-  stack: Stack;
-  mode: MemoryMapMode;
-  constructor(mode: MemoryMapMode);
-}
-//#endregion
-//#region src/rom/extraction/processor.d.ts
-declare class MapExt<K, V> extends Map<K, V> {
-  constructor();
-  tryAdd(key: K, value: V): boolean;
-  setFlag(key: K, flag: number, value?: boolean): void;
-  clearFlag(key: K, flag: number): void;
-}
-/**
- * Manages CPU processor state during ROM analysis
- * Converted from GaiaLib/Rom/Extraction/ProcessorStateManager.cs
- */
-declare class ProcessorStateManager {
-  readonly stackPositions: MapExt<number, number>;
-  private readonly _buckets;
-  get(key: string): MapExt<number, number>;
-  /**
-   * Hydrate processor registers with stored state
-   * Uses Registers from gaia-core/assembly for processor state management
-   */
-  hydrateRegisters(position: number, reg: Registers): void;
-  getStackPosition(location: number): number | undefined;
-  setStackPosition(location: number, value: number): void;
-  tryAddStackPosition(location: number, value: number): boolean;
-}
-//#endregion
-//#region src/rom/extraction/reader.d.ts
-/**
- * Provides low-level ROM data reading functionality
- * Converted from GaiaLib/Rom/Extraction/RomDataReader.cs
- */
-declare class RomDataReader {
-  readonly romData: Uint8Array;
-  position: number;
-  constructor(romData: Uint8Array);
-  readByte(): number;
-  readSByte(): number;
-  readUShort(): number;
-  readShort(): number;
-  readAddress(): number;
-  readInt(): number;
-  peekByte(): number;
-  peekShort(): number;
-  peekAddress(): number;
-}
-//#endregion
-//#region src/database/entrypoints.d.ts
-/**
- * Database entry point definition
- * Converted from GaiaLib/Database/DbEntryPoint.cs
- */
-interface DbEntryPoint {
-  location: number;
-  name: string;
-}
-//#endregion
-//#region src/database/paths.d.ts
-/**
- * Database path configuration
- * Converted from GaiaLib/Database/DbPath.cs
- */
-interface DbPath {
-  folder: string;
-  extension: string;
-}
-/**
- * Creates a default DbPath
- */
-declare function createDbPath(folder?: string, extension?: string): DbPath;
-//#endregion
-//#region src/database/config.d.ts
-/**
- * Database configuration
- * Converted from GaiaLib/Database/DbConfig.cs
- */
-interface DbConfig {
-  sfxLocation: number;
-  sfxCount: number;
-  sfxType: string;
-  sfxPack: string;
-  compression: string;
-  uncompress: boolean;
-  entryPoints: DbEntryPoint[];
-  paths: Record<BinType, DbPath>;
-  memoryMode: MemoryMapMode;
-  cpuMode: CpuMode;
-  chipset: number;
-  ramSize: number;
-}
-//#endregion
-//#region src/database/structs.d.ts
-/**
- * Database structure definition
- * Converted from GaiaLib/Database/DbStruct.cs
- */
-declare class DbStruct {
-  name: string;
-  types?: string[];
-  parent?: string;
-  delimiter?: number;
-  discriminator?: number;
-  constructor(data: Partial<DbStruct>);
-}
-//#endregion
-//#region src/database/addressingMode.d.ts
-declare class DbAddressingMode {
-  name: string;
-  shorthand: string;
-  operands: string[];
-  size: number;
-  formatString?: string;
-  parseRegex?: string;
-  instructions: Record<string, number>;
-  constructor(data: Partial<DbAddressingMode>);
-}
-//#endregion
-//#region src/database/assets.d.ts
-interface DbAsset {
-  index: number;
-  type: string;
-  file: string;
-  scene: string;
-  meta: any;
-}
-//#endregion
-//#region src/database/scenes.d.ts
-declare class DbScene {
-  name: string;
-  id: number;
-  description?: string;
-  assets: DbAsset[];
-  constructor(data: Partial<DbScene>);
-}
-//#endregion
-//#region src/database/groups.d.ts
-declare class DbGroup {
-  name: string;
-  prefix: string;
-  description?: string;
-  scenes: Record<string, DbScene>;
-  constructor(data: Partial<DbGroup>);
-}
-//#endregion
-//#region src/supabase/types.d.ts
-/**
- * TypeScript interfaces for Supabase API responses
- * These types represent the structured data returned from ROM database queries
- */
-interface PlatformData {
-  id: string;
-  name: string;
-  meta: any | null;
-  createdAt: string;
-  updatedAt: string;
-}
-interface BranchBaseData {
-  id: string;
-  name: string | null;
-  version: number | null;
-  isActive?: boolean | null;
-  notes?: string[] | null;
-  createdAt: string;
-  updatedAt: string;
-}
-interface FileBaseData {
-  id: string;
-  name: string;
-  type: string;
-  version: number | null;
-  crc: number | null;
-  meta: any | null;
-  isText: boolean;
-  text: string | null;
-  data: Uint8Array | null;
-  createdAt: string;
-  updatedAt: string;
-}
-interface FileBaseRaw extends Omit<FileBaseData, 'data'> {
-  data: string | null;
-}
-/**
- * Platform branch information containing instruction set and addressing modes
- */
-interface PlatformBranchData extends BranchBaseData {
-  platformId: string;
-  addressingModes: any | null;
-  headers: any | null;
-  vectors: any | null;
-  types: any | null;
-  platform: PlatformData;
-}
-/**
- * Game ROM branch information with platform reference
+ * Game ROM branch information with platform reference
  */
 interface GameRomBranchData extends BranchBaseData {
   gameRomId: string;
@@ -1058,26 +660,125 @@ interface BaseRomFileRaw extends FileBaseRaw {
   baseRomId: string;
 }
 /**
- * Complete ROM payload containing branch data and files
+ * Complete ROM payload containing branch data and files
+ */
+interface BaseRomPayload {
+  baseRomBranch: BaseRomBranchData;
+  files: BaseRomFileData[];
+}
+/**
+ * Options for loading ROM data by name
+ */
+interface FromSupabaseByNameOptions {
+  /**
+   * Name of the game to load
+   * @default 'Illusion of Gaia'
+   */
+  gameName: string;
+  /**
+   * Name of the base ROM to load
+   * @default 'GaiaLabs BaseROM'
+   */
+  baseRomName: string;
+  /**
+   * Name of the branch to load
+   * Set to null to load the main/develop branch
+   * Set to undefined to not filter by branch name
+   */
+  branchName?: string | null;
+  /**
+   * Version of the branch to load
+   * Set to null to load the latest/main version
+   * Set to undefined to not filter by version
+   */
+  branchVersion?: number | null;
+}
+/**
+ * Error codes for Supabase operations
+ */
+declare enum SupabaseErrorCode {
+  BRANCH_NOT_FOUND = "BRANCH_NOT_FOUND",
+  ROM_NOT_FOUND = "ROM_NOT_FOUND",
+  FILES_NOT_FOUND = "FILES_NOT_FOUND",
+  NETWORK_ERROR = "NETWORK_ERROR",
+  INVALID_DATA = "INVALID_DATA",
+  ENVIRONMENT_ERROR = "ENVIRONMENT_ERROR",
+  PERMISSION_ERROR = "PERMISSION_ERROR"
+}
+/**
+ * Custom error class for Supabase operations
+ */
+declare class SupabaseFromError extends Error {
+  readonly code: SupabaseErrorCode;
+  readonly details?: any | undefined;
+  constructor(message: string, code: SupabaseErrorCode, details?: any | undefined);
+}
+/**
+ * Result type for async operations that may fail
+ */
+type SupabaseResult<T> = {
+  data: T;
+  error: null;
+} | {
+  data: null;
+  error: SupabaseFromError;
+};
+/**
+ * Project information
+ */
+interface ProjectData {
+  id: string;
+  name: string;
+  meta: any | null;
+  gameId: string;
+  baseRomId: string;
+  createdAt: string;
+  updatedAt: string;
+}
+/**
+ * Project branch with complete relationship chain
+ */
+interface ProjectBranchData extends BranchBaseData {
+  projectId: string;
+  baseRomBranchId: string;
+  modules: any[];
+  project: ProjectData;
+  baseRomBranch: BaseRomBranchData;
+}
+/**
+ * Project file containing binary data
+ */
+interface ProjectFileData extends FileBaseData {
+  module: string | null;
+  projectId: string;
+}
+interface ProjectBranchFileRaw {
+  id: string;
+  branchId: string;
+  fileId: string;
+  file: ProjectFileRaw;
+}
+/**
+ * Raw ProjectFile data as returned from Supabase (before conversion)
+ */
+interface ProjectFileRaw extends FileBaseRaw {
+  module: string | null;
+  projectId: string;
+}
+/**
+ * Complete Project payload containing branch data and files
  */
-interface BaseRomPayload {
+interface ProjectPayload {
+  projectBranch: ProjectBranchData;
+  projectFiles: ProjectFileData[];
   baseRomBranch: BaseRomBranchData;
-  files: BaseRomFileData[];
+  baseRomFiles: BaseRomFileData[];
 }
 /**
- * Options for loading ROM data by name
+ * Options for loading Project data by name
  */
-interface FromSupabaseByNameOptions {
-  /**
-   * Name of the game to load
-   * @default 'Illusion of Gaia'
-   */
-  gameName: string;
-  /**
-   * Name of the base ROM to load
-   * @default 'GaiaLabs BaseROM'
-   */
-  baseRomName: string;
+interface FromSupabaseByProjectOptions {
+  projectName: string;
   /**
    * Name of the branch to load
    * Set to null to load the main/develop branch
@@ -1092,290 +793,608 @@ interface FromSupabaseByNameOptions {
   branchVersion?: number | null;
 }
 /**
- * Error codes for Supabase operations
+ * Query statistics for performance monitoring
  */
-declare enum SupabaseErrorCode {
-  BRANCH_NOT_FOUND = "BRANCH_NOT_FOUND",
-  ROM_NOT_FOUND = "ROM_NOT_FOUND",
-  FILES_NOT_FOUND = "FILES_NOT_FOUND",
-  NETWORK_ERROR = "NETWORK_ERROR",
-  INVALID_DATA = "INVALID_DATA",
-  ENVIRONMENT_ERROR = "ENVIRONMENT_ERROR",
-  PERMISSION_ERROR = "PERMISSION_ERROR"
+interface QueryStats {
+  branchQueryTime: number;
+  fileQueryTime: number;
+  totalTime: number;
+  fileCount: number;
+}
+//#endregion
+//#region src/database/modules.d.ts
+interface DbGameRomModule {
+  supaProjectFiles?: ProjectFileData[];
+  supaBaseRomFiles?: BaseRomFileData[];
+  mnemonics: Record<number, string>;
+  overrides: Record<number, Record<string, number>>;
+  rewrites: Record<string, number>;
+  blocks: Record<string, Record<string, Partial<DbBlock>>>;
+  files: Record<string, Record<string, Record<string, Partial<DbFile>>>>;
+  config: DbConfig;
+  labels: Record<number, string>;
+  structs: Record<string, DbStruct>;
+  copdef: Record<string, Partial<CopDef>>;
+  strings: Record<string, Partial<DbStringType>>;
+  transforms: Record<string, Partial<DbTransform>[]>;
+  addrModes: Record<string, Partial<DbAddressingMode>>;
+  headers: Partial<DbHeader>[];
+  groups: Record<string, Partial<DbGroup>>;
+  fileTypes: Record<string, Partial<DbFileType>>;
+}
+interface DbBaseRomModule extends DbGameRomModule {
+  baseRomFiles: ChunkFile[];
+}
+interface DbProjectModule extends DbBaseRomModule {
+  projectFiles: ChunkFile[];
+}
+//#endregion
+//#region src/database/header.d.ts
+declare class DbHeader {
+  bank: number;
+  address: number;
+  condition?: string;
+  parts: DbHeaderPart[];
+  constructor(data: Partial<DbHeader>);
+}
+declare class DbHeaderPart {
+  name: string;
+  size: number;
+  type: string;
+  value?: any;
+  constructor(data: Partial<DbHeaderPart>);
 }
+//#endregion
+//#region src/database/root.d.ts
 /**
- * Custom error class for Supabase operations
+ * Main database root class
+ * Converted from GaiaLib/Database/DbRoot.cs
  */
-declare class SupabaseFromError extends Error {
-  readonly code: SupabaseErrorCode;
-  readonly details?: any | undefined;
-  constructor(message: string, code: SupabaseErrorCode, details?: any | undefined);
+interface DbRoot {
+  copDef: Record<number, CopDef>;
+  copLookup: Record<string, CopDef>;
+  mnemonics: Record<number, string>;
+  structs: Record<string, DbStruct>;
+  stringTypes: Record<string, DbStringType>;
+  stringDelimiters: string[];
+  stringDelimiterLookup: Record<string, DbStringType>;
+  headers: DbHeader[];
+  files: DbFile[];
+  config: DbConfig;
+  blocks: DbBlock[];
+  overrides: Record<number, Record<string, any>>;
+  labels: Record<number, string>;
+  rewrites: Record<number, number>;
+  entryPoints: DbEntryPoint[];
+  opCodes: Record<number, OpCode>;
+  opLookup: Record<string, OpCode[]>;
+  addrLookup: Record<string, DbAddressingMode>;
+  compression?: ICompressionProvider;
+  baseRomFiles?: ChunkFile[];
+  projectFiles?: ChunkFile[];
+  groups: Record<string, DbGroup>;
+  scenes: Record<number, DbScene>;
+  fileTypes: Record<string, DbFileType>;
+  fileExtLookup: Record<string, DbFileType>;
 }
 /**
- * Result type for async operations that may fail
+ * Database root utilities
  */
-type SupabaseResult<T> = {
-  data: T;
-  error: null;
-} | {
-  data: null;
-  error: SupabaseFromError;
-};
+declare class DbRootUtils {
+  /**
+   * JSON serialization options
+   */
+  static fromGameModule(module: DbGameRomModule): DbRoot;
+  static applyFolder(root: DbRoot, folderPath: string, sourceFiles?: ChunkFile[], group?: string): Promise<ChunkFile[]>;
+  static extractAllContent(root: DbRoot, romPath: string, outPath: string): Promise<void>;
+  static rebuildAllContent(root: DbRoot, inPath: string[], outPath: string): Promise<ChunkFile[]>;
+}
+//#endregion
+//#region src/database/labels.d.ts
 /**
- * Project information
+ * Database label definition
+ * Converted from GaiaLib/Database/DbLabel.cs
  */
-interface ProjectData {
-  id: string;
+interface DbLabel {
+  location: number;
+  label: string;
+}
+//#endregion
+//#region src/database/mnemonics.d.ts
+/**
+ * Database mnemonic definition
+ * Converted from GaiaLib/Database/DbMnemonic.cs
+ */
+interface DbMnemonic {
+  key: number;
+  value: string;
+  metadata?: string;
+}
+//#endregion
+//#region src/database/overrides.d.ts
+declare class DbOverride {
+  location: number;
+  register: string;
+  value: number;
+  constructor(values: Partial<DbOverride>);
+}
+//#endregion
+//#region src/database/paths.d.ts
+/**
+ * Database path configuration
+ * Converted from GaiaLib/Database/DbPath.cs
+ */
+interface DbPath {
+  folder: string;
+  extension: string;
+}
+/**
+ * Creates a default DbPath
+ */
+declare function createDbPath(folder?: string, extension?: string): DbPath;
+//#endregion
+//#region src/database/rewrites.d.ts
+/**
+ * Database rewrite rule definition
+ * Converted from GaiaLib/Database/DbRewrite.cs
+ */
+interface DbRewrite {
+  location: number;
+  value: number;
+}
+//#endregion
+//#region src/database/sfx.d.ts
+/**
+ * Database sound effect definition
+ * Converted from GaiaLib/Database/DbSfx.cs
+ */
+interface DbSfx {
+  location: number;
+  size: number;
+  names: string[];
+}
+//#endregion
+//#region src/rom/extraction/references.d.ts
+/**
+ * Manages references, chunks, and markers during ROM analysis
+ * Converted from GaiaLib/Rom/Extraction/ReferenceManager.cs
+ */
+declare class ReferenceManager {
+  readonly structTable: Map<number, string>;
+  readonly markerTable: Map<number, number>;
+  readonly nameTable: Map<number, string>;
+  readonly fileTable: Map<number, string>;
+  private readonly root;
+  constructor(root: DbRoot);
+  tryGetStruct(location: number): {
+    found: boolean;
+    chunkType?: string;
+  };
+  tryAddStruct(location: number, chunkType: string): boolean;
+  containsStruct(location: number): boolean;
+  tryGetName(location: number): {
+    found: boolean;
+    referenceName?: string;
+  };
+  tryAddName(location: number, referenceName: string): boolean;
+  tryGetMarker(location: number): {
+    found: boolean;
+    offset?: number;
+  };
+  setMarker(location: number, offset: number): void;
+  createBranchLabel(location: number): string;
+  createTypeName(type: string, location: number): string;
+  createFallbackName(location: number): string;
+  /**
+   * Finds a reference location by its assigned name.
+   */
+  findLocationByName(name: string): number | undefined;
+  resolveName(location: number, type: AddressType, isBranch: boolean): string;
+  findClosestReference(location: number): string | null;
+  private processRewrite;
+  private processClosestMatch;
+}
+//#endregion
+//#region src/types/files.d.ts
+/**
+ * Chunk file for ROM processing
+ * Converted from GaiaLib/Types/ChunkFile.cs
+ */
+declare class ChunkFile {
   name: string;
-  meta: any | null;
-  gameId: string;
-  baseRomId: string;
-  createdAt: string;
-  updatedAt: string;
+  size: number;
+  location: number;
+  type: DbFileType;
+  parts?: AsmBlock[];
+  includes?: Set<string>;
+  includeLookup?: Map<string, AsmBlock>;
+  bank?: number;
+  compressed?: boolean;
+  upper?: boolean;
+  rawData?: Uint8Array | null;
+  textData?: string;
+  transforms?: {
+    key: string;
+    value: string;
+  }[];
+  postProcess?: string;
+  mnemonics: Record<number, string>;
+  group?: string;
+  scene?: string;
+  base?: number;
+  referenceManager?: ReferenceManager;
+  constructor(type: DbFileType, name: string, size?: number, location?: number);
+  enrichWithRawDataFromDbFile(file: DbFile, rom: Uint8Array, compression: ICompressionProvider | undefined): void;
+  enrichWithAsmBlocksFromDbBlock(block: DbBlock, memoryMode: MemoryMapMode): void;
 }
+declare function combineHeader(data: Uint8Array, position: number, length: number, header: Uint8Array | null, type: BinType): Uint8Array;
 /**
- * Project branch with complete relationship chain
+ * Chunk file utilities
  */
-interface ProjectBranchData extends BranchBaseData {
-  projectId: string;
-  baseRomBranchId: string;
-  modules: any[];
-  project: ProjectData;
-  baseRomBranch: BaseRomBranchData;
+declare class ChunkFileUtils {
+  /**
+   * Rebase blocks to a new location
+   */
+  static rebase(chunkFile: ChunkFile, newLocation?: number): void;
+  /**
+   * Calculate the total size of all blocks
+   */
+  static calculateSize(chunkFile: ChunkFile): number;
+  /**
+  * Check if a location is outside this block and return the part (matches C# IsOutside)
+  * Returns [isOutside, part] where part is the part containing the location
+  */
+  static isOutsideWithPart(root: ChunkFile[], block: ChunkFile, location: number): [boolean, ChunkFile | null, AsmBlock | null];
+  /**
+   * Check if a location is inside this block and return the part (matches C# IsInside)
+   * Returns [isInside, part] where part is the part containing the location
+   */
+  static isInsideWithPart(block: ChunkFile, location: number): [boolean, AsmBlock | null];
+  /**
+   * Check if a location is outside this block (shorthand version)
+   */
+  static isOutside(block: ChunkFile, location: number): boolean;
+  /**
+   * Check if a location is inside this block (shorthand version)
+   */
+  static isInside(block: ChunkFile, location: number): boolean;
+  /**
+   * Get all included blocks
+   */
+  static getIncludes(chunkFile: ChunkFile): ChunkFile[];
 }
+//#endregion
+//#region src/types/assembly.d.ts
 /**
- * Project file containing binary data
+ * Represents a single assembly operation/instruction
  */
-interface ProjectFileData extends FileBaseData {
-  module: string | null;
-  projectId: string;
-}
-interface ProjectBranchFileRaw {
-  id: string;
-  branchId: string;
-  fileId: string;
-  file: ProjectFileRaw;
+declare class Op extends OpCode {
+  location: number;
+  operands: unknown[];
+  size: number;
+  copDef?: CopDef;
+  constructor(code: OpCode, location?: number, operands?: unknown[], size?: number);
 }
 /**
- * Raw ProjectFile data as returned from Supabase (before conversion)
+ * Represents a block of assembly code or data
  */
-interface ProjectFileRaw extends FileBaseRaw {
-  module: string | null;
-  projectId: string;
+declare class AsmBlock {
+  label?: string;
+  location: number;
+  size: number;
+  isString: boolean;
+  objList: any[];
+  structName?: string;
+  bank?: number;
+  includes?: Set<{
+    block: ChunkFile;
+    part: AsmBlock;
+  }>;
+  constructor(location?: number, size?: number, isString?: boolean, label?: string, structName?: string, bank?: number);
 }
 /**
- * Complete Project payload containing branch data and files
+ * Database part utilities
  */
-interface ProjectPayload {
-  projectBranch: ProjectBranchData;
-  projectFiles: ProjectFileData[];
-  baseRomBranch: BaseRomBranchData;
-  baseRomFiles: BaseRomFileData[];
+declare class AsmBlockUtils {
+  /**
+   * Check if a location is inside this part
+   */
+  static isInside(part: AsmBlock, location: number): boolean;
+  /**
+   * Check if a location is outside this part
+   */
+  static isOutside(part: AsmBlock, location: number): boolean;
 }
+//#endregion
+//#region src/types/bitstream.d.ts
 /**
- * Options for loading Project data by name
+ * Bit stream for reading/writing binary data at bit level
+ * Converted from GaiaLib/Types/BitStream.cs
  */
-interface FromSupabaseByProjectOptions {
-  projectName: string;
+declare class BitStream {
+  private static readonly NIBBLE_MASK;
+  private static readonly NIBBLE_PERFECT_POSITION;
+  private data;
+  private position;
+  private bitFlag;
+  private writeSample;
+  constructor(data: Uint8Array, position?: number);
+  get dataArray(): Uint8Array;
+  get currentPosition(): number;
+  set currentPosition(value: number);
   /**
-   * Name of the branch to load
-   * Set to null to load the main/develop branch
-   * Set to undefined to not filter by branch name
+   * Read a byte from the stream
+   * @returns The byte read, or -1 if the end of the data has been reached
    */
-  branchName?: string | null;
+  readByte(): number;
   /**
-   * Version of the branch to load
-   * Set to null to load the latest/main version
-   * Set to undefined to not filter by version
+   * Read a ushort from the stream (ignores the current bit flag)
+   * @returns The short read, or -1 if the end of the data has been reached
    */
-  branchVersion?: number | null;
+  readShort(): number;
+  /**
+   * Read a bit from the stream
+   * @returns True if the current bit at bitFlag is set, false otherwise
+   */
+  readBit(): boolean;
+  /**
+   * Read a nibble from the stream
+   * @returns The nibble read, or -1 if the end of the data has been reached
+   */
+  readNibble(): number;
+  /**
+   * Write a bit to the stream
+   * @param set True if the current bit should be set, false otherwise
+   */
+  writeBit(set: boolean): void;
+  /**
+   * Write a byte to the stream
+   * @param value The byte to write
+   */
+  writeByte(value: number): void;
+  /**
+   * Write a nibble to the stream
+   * @param value The nibble to write
+   */
+  writeNibble(value: number): void;
+  flush(): void;
 }
+//#endregion
+//#region src/types/compression-registry.d.ts
 /**
- * Query statistics for performance monitoring
+ * Registry for compression providers
+ * Allows registration of compression implementations by string ID
  */
-interface QueryStats {
-  branchQueryTime: number;
-  fileQueryTime: number;
-  totalTime: number;
-  fileCount: number;
+declare class CompressionRegistry {
+  private static providers;
+  /**
+   * Register a compression provider
+   * @param id String identifier for the compression type
+   * @param factory Factory function that creates the compression provider
+   */
+  static register(id: string, factory: () => ICompressionProvider): void;
+  /**
+   * Get a compression provider by ID
+   * @param id String identifier for the compression type
+   * @returns Compression provider instance
+   */
+  static get(id: string): ICompressionProvider;
+  /**
+   * Check if a compression provider is registered
+   * @param id String identifier for the compression type
+   * @returns True if provider is registered
+   */
+  static has(id: string): boolean;
+  /**
+   * Get list of registered provider IDs
+   * @returns Array of registered provider IDs
+   */
+  static getRegisteredIds(): string[];
+  /**
+   * Clear all registered providers (mainly for testing)
+   */
+  static clear(): void;
 }
 //#endregion
-//#region src/database/modules.d.ts
-interface DbGameRomModule {
-  supaProjectFiles?: ProjectFileData[];
-  supaBaseRomFiles?: BaseRomFileData[];
-  mnemonics: Record<number, string>;
-  overrides: Record<number, Record<string, number>>;
-  rewrites: Record<string, number>;
-  blocks: Record<string, Record<string, Partial<DbBlock>>>;
-  files: Record<string, Record<string, Record<string, Partial<DbFile>>>>;
-  config: DbConfig;
-  labels: Record<number, string>;
-  structs: Record<string, DbStruct>;
-  copdef: Record<string, Partial<CopDef>>;
-  strings: Record<string, Partial<DbStringType>>;
-  transforms: Record<string, Partial<DbTransform>[]>;
-  addrModes: Record<string, Partial<DbAddressingMode>>;
-  headers: Partial<DbHeader>[];
-  groups: Record<string, Partial<DbGroup>>;
-  fileTypes: Record<string, Partial<DbFileType>>;
+//#region src/types/constants.d.ts
+/**
+ * ROM processing constants
+ * Converted from GaiaLib/Types/RomProcessingConstants.cs
+ */
+declare class RomProcessingConstants {
+  static readonly PAGE_SIZE = 32768;
+  static readonly SNES_HEADER_SIZE = 80;
+  static readonly DICTIONARIES: string[];
+  static readonly DICT_COMMANDS: number[];
+  static readonly END_CHARS: number[];
+  static readonly WHITESPACE: string[];
+  static readonly OPERATORS: string[];
+  static readonly COMMA_SPACE: string[];
+  static readonly ADDRESS_SPACE: string[];
+  static readonly SYMBOL_SPACE: string[];
+  static readonly LABEL_SPACE: string[];
+  static readonly OBJECT_SPACE: string[];
+  static readonly COP_SPLIT_CHARS: string[];
+  static readonly WHITESPACE_REGEX: RegExp;
+  static readonly COMMA_SPACE_REGEX: RegExp;
+  static readonly SYMBOL_SPACE_REGEX: RegExp;
+  static readonly LABEL_SPACE_REGEX: RegExp;
+  static readonly OBJECT_SPACE_REGEX: RegExp;
+  static readonly ADDRESS_SPACE_REGEX: RegExp;
+  static readonly COP_SPLIT_REGEX: RegExp;
+  static readonly COMMA_SPACE_TRIM_REGEX: RegExp;
+  /**
+   * Gets the size of an object for processing purposes
+   * @param obj The object to get the size for
+   * @returns Size in bytes
+   * @throws Error when unable to determine size
+   */
+  static getSize(obj: unknown): number;
 }
-interface DbBaseRomModule extends DbGameRomModule {
-  baseRomFiles: ChunkFile[];
+/**
+ * BlockReader specific constants
+ */
+declare class BlockReaderConstants {
+  static readonly REF_SEARCH_MAX_RANGE = 896;
+  static readonly BANK_MASK_CHECK = 64;
+  static readonly BYTE_DELIMITER_THRESHOLD = 256;
+  static readonly BANK_HIGH_MEMORY_1 = 126;
+  static readonly BANK_HIGH_MEMORY_2 = 127;
+  static readonly POINTER_CHARACTERS: string[];
+  static readonly WIDE_STRING_TYPE = "WideString";
+  static readonly BINARY_TYPE = "Binary";
+  static readonly CODE_TYPE = "Code";
+  static readonly LOCATION_FORMAT = "loc_{0:X6}";
+  static readonly TYPE_NAME_FORMAT = "{0}_{1:X6}";
+  static readonly OFFSET_FORMAT = "+{0:X}";
+  static readonly MARKER_FORMAT = "+M";
+  static readonly NEGATIVE_OFFSET_FORMAT = "-{0:X}";
+  static readonly NEGATIVE_MARKER_FORMAT = "-M";
 }
-interface DbProjectModule extends DbBaseRomModule {
-  projectFiles: ChunkFile[];
+//#endregion
+//#region src/types/location.d.ts
+/**
+ * Location wrapper for additional metadata
+ * Converted from GaiaLib/Types/LocationWrapper.cs
+ */
+declare class LocationWrapper {
+  location: number;
+  type: AddressType;
+  constructor(location: number, type: AddressType);
 }
 //#endregion
-//#region src/database/header.d.ts
-declare class DbHeader {
-  bank: number;
-  address: number;
-  condition?: string;
-  parts: DbHeaderPart[];
-  constructor(data: Partial<DbHeader>);
+//#region src/types/strings.d.ts
+/**
+ * String marker for positioning
+ * Converted from GaiaLib/Types/StringMarker.cs
+ */
+interface StringMarker {
+  offset: number;
 }
-declare class DbHeaderPart {
-  name: string;
-  size: number;
-  type: string;
-  value?: any;
-  constructor(data: Partial<DbHeaderPart>);
+/**
+ * String wrapper with type and location information
+ * Converted from GaiaLib/Types/StringWrapper.cs
+ */
+interface StringWrapper {
+  string: string;
+  type: DbStringType;
+  marker: number;
+  location: number;
+  fixedSize: number;
 }
-//#endregion
-//#region src/database/root.d.ts
 /**
- * Main database root class
- * Converted from GaiaLib/Database/DbRoot.cs
+ * String entry (commented out in original C# code)
+ * Converted from GaiaLib/Types/StringEntry.cs
  */
-interface DbRoot {
-  copDef: Record<number, CopDef>;
-  copLookup: Record<string, CopDef>;
-  mnemonics: Record<number, string>;
-  structs: Record<string, DbStruct>;
-  stringTypes: Record<string, DbStringType>;
-  stringDelimiters: string[];
-  stringDelimiterLookup: Record<string, DbStringType>;
-  headers: DbHeader[];
-  files: DbFile[];
-  config: DbConfig;
-  blocks: DbBlock[];
-  overrides: Record<number, Record<string, any>>;
-  labels: Record<number, string>;
-  rewrites: Record<number, number>;
-  entryPoints: DbEntryPoint[];
-  opCodes: Record<number, OpCode>;
-  opLookup: Record<string, OpCode[]>;
-  addrLookup: Record<string, DbAddressingMode>;
-  compression?: ICompressionProvider;
-  baseRomFiles?: ChunkFile[];
-  projectFiles?: ChunkFile[];
-  groups: Record<string, DbGroup>;
-  scenes: Record<number, DbScene>;
-  fileTypes: Record<string, DbFileType>;
-  fileExtLookup: Record<string, DbFileType>;
+interface StringEntry {
+  block: AsmBlock;
+  index: number;
+  size: number;
+  data: Uint8Array;
 }
 /**
- * Database root utilities
+ * String size comparer utility
+ * Converted from GaiaLib/Types/StringSizeComparer.cs
  */
-declare class DbRootUtils {
+declare class StringSizeComparer {
   /**
-   * JSON serialization options
+   * Compare two strings by length
    */
-  static fromGameModule(module: DbGameRomModule): DbRoot;
-  static applyFolder(root: DbRoot, folderPath: string, sourceFiles?: ChunkFile[], group?: string): Promise<ChunkFile[]>;
-  static extractAllContent(root: DbRoot, romPath: string, outPath: string): Promise<void>;
-  static rebuildAllContent(root: DbRoot, inPath: string[], outPath: string): Promise<ChunkFile[]>;
+  static compare(a: string, b: string): number;
+  /**
+   * Compare two StringWrapper objects by string length
+   */
+  static compareWrappers(a: StringWrapper, b: StringWrapper): number;
 }
 //#endregion
-//#region src/database/labels.d.ts
+//#region src/types/structs.d.ts
 /**
- * Database label definition
- * Converted from GaiaLib/Database/DbLabel.cs
+ * Structure definition
+ * Converted from GaiaLib/Types/StructDef.cs
  */
-interface DbLabel {
-  location: number;
-  label: string;
+interface StructDef {
+  name: string;
+  parts: unknown[];
 }
 //#endregion
-//#region src/database/mnemonics.d.ts
-/**
- * Database mnemonic definition
- * Converted from GaiaLib/Database/DbMnemonic.cs
- */
-interface DbMnemonic {
-  key: number;
-  value: string;
-  metadata?: string;
+//#region src/types/tables.d.ts
+declare class TableEntry {
+  location: number;
+  object: unknown;
+  constructor(location: number);
 }
 //#endregion
-//#region src/database/overrides.d.ts
-declare class DbOverride {
-  location: number;
-  register: string;
+//#region src/types/operands.d.ts
+declare class TypedNumber {
   value: number;
-  constructor(values: Partial<DbOverride>);
+  size: number;
+  constructor(value: number, size: number);
+}
+declare class Byte extends TypedNumber {
+  constructor(value: number);
+}
+declare class Word extends TypedNumber {
+  constructor(value: number);
+}
+declare class Long extends TypedNumber {
+  constructor(value: number);
 }
 //#endregion
-//#region src/database/rewrites.d.ts
+//#region src/assembly/Registers.d.ts
 /**
- * Database rewrite rule definition
- * Converted from GaiaLib/Database/DbRewrite.cs
+ * Manages the 65816 processor registers and status flags
  */
-interface DbRewrite {
-  location: number;
-  value: number;
+declare class Registers {
+  value: Record<string, number>;
+  stack: Stack;
+  mode: MemoryMapMode;
+  constructor(mode: MemoryMapMode);
 }
 //#endregion
-//#region src/database/sfx.d.ts
+//#region src/rom/extraction/processor.d.ts
+declare class MapExt<K, V> extends Map<K, V> {
+  constructor();
+  tryAdd(key: K, value: V): boolean;
+  setFlag(key: K, flag: number, value?: boolean): void;
+  clearFlag(key: K, flag: number): void;
+}
 /**
- * Database sound effect definition
- * Converted from GaiaLib/Database/DbSfx.cs
+ * Manages CPU processor state during ROM analysis
+ * Converted from GaiaLib/Rom/Extraction/ProcessorStateManager.cs
  */
-interface DbSfx {
-  location: number;
-  size: number;
-  names: string[];
+declare class ProcessorStateManager {
+  readonly stackPositions: MapExt<number, number>;
+  private readonly _buckets;
+  get(key: string): MapExt<number, number>;
+  /**
+   * Hydrate processor registers with stored state
+   * Uses Registers from gaia-core/assembly for processor state management
+   */
+  hydrateRegisters(position: number, reg: Registers): void;
+  getStackPosition(location: number): number | undefined;
+  setStackPosition(location: number, value: number): void;
+  tryAddStackPosition(location: number, value: number): boolean;
 }
 //#endregion
-//#region src/rom/extraction/references.d.ts
+//#region src/rom/extraction/reader.d.ts
 /**
- * Manages references, chunks, and markers during ROM analysis
- * Converted from GaiaLib/Rom/Extraction/ReferenceManager.cs
+ * Provides low-level ROM data reading functionality
+ * Converted from GaiaLib/Rom/Extraction/RomDataReader.cs
  */
-declare class ReferenceManager {
-  readonly structTable: Map<number, string>;
-  readonly markerTable: Map<number, number>;
-  readonly nameTable: Map<number, string>;
-  private readonly root;
-  constructor(root: DbRoot);
-  tryGetStruct(location: number): {
-    found: boolean;
-    chunkType?: string;
-  };
-  tryAddStruct(location: number, chunkType: string): boolean;
-  containsStruct(location: number): boolean;
-  tryGetName(location: number): {
-    found: boolean;
-    referenceName?: string;
-  };
-  tryAddName(location: number, referenceName: string): boolean;
-  tryGetMarker(location: number): {
-    found: boolean;
-    offset?: number;
-  };
-  setMarker(location: number, offset: number): void;
-  createBranchLabel(location: number): string;
-  createTypeName(type: string, location: number): string;
-  createFallbackName(location: number): string;
-  /**
-   * Finds a reference location by its assigned name.
-   */
-  findLocationByName(name: string): number | undefined;
-  resolveName(location: number, type: AddressType, isBranch: boolean): string;
-  findClosestReference(location: number): string | null;
-  private processRewrite;
-  private processClosestMatch;
+declare class RomDataReader {
+  romData: Uint8Array;
+  position: number;
+  offset: number;
+  constructor(romData: Uint8Array, offset?: number);
+  readByte(): number;
+  readSByte(): number;
+  readUShort(): number;
+  readShort(): number;
+  readAddress(): number;
+  readInt(): number;
+  peekByte(): number;
+  peekShort(): number;
+  peekAddress(): number;
 }
 //#endregion
 //#region src/rom/extraction/strings.d.ts
@@ -1452,10 +1471,10 @@ declare class BlockReader {
   readonly _root: DbRoot;
   readonly _stringReader: StringReader;
   readonly _asmReader: AsmReader;
-  readonly _typeParser: TypeParser;
-  readonly _romDataReader: RomDataReader;
+  _typeParser: TypeParser;
+  _romDataReader: RomDataReader;
   readonly _stateManager: ProcessorStateManager;
-  readonly _referenceManager: ReferenceManager;
+  _referenceManager: ReferenceManager;
   _partEnd: number;
   _currentChunk: ChunkFile | null;
   _currentAsmBlock: AsmBlock | null;
@@ -1468,7 +1487,6 @@ declare class BlockReader {
   /**
    * Processes predefined file references
    */
-  private initializeFileReferences;
   /**
    * Resolves mnemonic for a given address
    */
@@ -1476,7 +1494,6 @@ declare class BlockReader {
   /**
    * Resolves name for a location (delegated to ReferenceManager)
    */
-  resolveName(location: number, type: AddressType, isBranch: boolean): string;
   /**
    * Resolves include for a location
    */
@@ -1505,7 +1522,7 @@ declare class BlockReader {
   /**
    * Processes a single part
    */
-  private processPart;
+  processPart(part: AsmBlock): void;
   /**
    * Processes a continuous entry (same type as previous)
    */
@@ -1768,16 +1785,16 @@ declare class RomWriter {
    * Parse assembly blocks and write binary data to output buffer
    * Converted from ext/GaiaLib/Rom/Rebuild/RomWriter.cs ParseAssembly method
    */
-  private parseAssembly;
+  static parseAssembly(root: DbRoot, blocks: AsmBlock[], fileLookup: Map<string, number>, includeLookup: Map<string, AsmBlock>, outBuffer: Uint8Array, addrOffset?: number): void;
   /**
    * Helper method to find index of any character from an array in a string
    */
-  private indexOfAny;
+  static indexOfAny(str: string, chars: string[]): number;
   /**
    * Helper method to check if an object is a StringMarker
    */
-  private isStringMarker;
-  private isTableEntry;
+  static isStringMarker(obj: unknown): obj is StringMarker;
+  static isTableEntry(obj: unknown): obj is TableEntry;
 }
 //#endregion
 //#region src/rom/rebuild/processor.d.ts
@@ -3159,5 +3176,5 @@ declare const snes: {
 };
 declare const isPlatformNode: string | false;
 //#endregion
-export { Address, AddressSpace, AddressType, AddressingModeHandler, AsmBlock, AsmBlockUtils, AsmReader, Assembler, AssemblerState, BaseRomBranchData, BaseRomBranchFileRaw, BaseRomData, BaseRomFileData, BaseRomFileRaw, BaseRomPayload, BinType, BitStream, BlockReader, BlockReaderConstants, BlockWriter, BranchBaseData, Byte, ChunkFile, ChunkFileUtils, CollaborationConfig, CompressionAlgorithms, CompressionRegistry, CopCommandProcessor, CopDef, CpuMode, Database, DbAddressingMode, DbAsset, DbBaseRomModule, DbBlock, DbConfig, DbEntryPoint, DbFile, DbFileType, DbGameRomModule, DbGroup, DbHeader, DbHeaderPart, DbLabel, DbMnemonic, DbOverride, DbPart, DbPath, DbProjectModule, DbRewrite, DbRoot, DbRootUtils, DbScene, DbSfx, DbStringCommand, DbStringDictionary, DbStringLayer, DbStringType, DbStruct, DbTransform, DeveloperData, DirectoryEntry, FileBaseData, FileBaseRaw, FileReadOptions, FromSupabaseByNameOptions, FromSupabaseByProjectOptions, GameData, GameDeveloperData, GameRomArtifactData, GameRomArtifactRaw, GameRomBranchArtifactRaw, GameRomBranchData, GameRomData, ICompressionProvider, LocationWrapper, Long, MapExt, MemberType, MemoryMapMode, ObjectType, Op, OpCode, OperationContext, PlatformBranchData, PlatformData, PostProcessor, ProcessorStateManager, ProjectBranchData, ProjectBranchFileRaw, ProjectConfig, ProjectData, ProjectFileData, ProjectFileRaw, ProjectPayload, QueryStats, QuintetLZ, ReferenceManager, RegionData, RegisterType, Registers, RomDataReader, RomGenerator, RomLayout, RomProcessingConstants, RomProcessor, RomState, RomStateUtils, RomWriter, SortedMap, SpriteFrame, SpriteGroup, SpriteMap, SpritePart, Stack, StackOperations, StatusFlags, StringEntry, StringMarker, StringProcessor, StringReader, StringSizeComparer, StringWrapper, StructDef, SupabaseErrorCode, SupabaseFromError, SupabaseResult, TableEntry, TransformProcessor, TypeParser, TypedNumber, Word, XformDef, XformType, base64ToUint8Array, binaryToUtf8String, bytesToHex, clamp, crc32_buffer, crc32_text_utf16, crc32_text_utf8, createChunkFileFromDbBlock, createChunkFileFromDbFile, createDbPath, createSupabaseClient, createTempDirectory, decodeBase64, decodeBase64String, decodeDataString, encodeBase64, encodeBase64String, fileExists, fromSupabaseByGameRom, fromSupabaseById, fromSupabaseByName, fromSupabaseByProject, getDirectory, getEnvVar, getNestedProperty, getSupabaseClient, hexToBytes, hexToUint8Array, indexOfAny, isPlatformNode, isValidBase64, listDirectory, readFileAsBinary, readFileAsText, readJsonFile, removeDirectory, resetSupabaseClient, saveFileAsBinary, saveFileAsText, snes, summaryFromSupabaseByProject, uint8ArrayToBase64, validateEnvironmentVariables };
+export { Address, AddressSpace, AddressType, AddressingModeHandler, AsmBlock, AsmBlockUtils, AsmReader, Assembler, AssemblerState, BaseRomBranchData, BaseRomBranchFileRaw, BaseRomData, BaseRomFileData, BaseRomFileRaw, BaseRomPayload, BinType, BitStream, BlockReader, BlockReaderConstants, BlockWriter, BranchBaseData, Byte, ChunkFile, ChunkFileUtils, CollaborationConfig, CompressionAlgorithms, CompressionRegistry, CopCommandProcessor, CopCondition, CopDef, CpuMode, Database, DbAddressingMode, DbAsset, DbBaseRomModule, DbBlock, DbConfig, DbEntryPoint, DbFile, DbFileType, DbGameRomModule, DbGroup, DbHeader, DbHeaderPart, DbLabel, DbMnemonic, DbOverride, DbPart, DbPath, DbProjectModule, DbRewrite, DbRoot, DbRootUtils, DbScene, DbSfx, DbStringCommand, DbStringDictionary, DbStringLayer, DbStringType, DbStruct, DbTransform, DeveloperData, DirectoryEntry, FileBaseData, FileBaseRaw, FileReadOptions, FromSupabaseByNameOptions, FromSupabaseByProjectOptions, GameData, GameDeveloperData, GameRomArtifactData, GameRomArtifactRaw, GameRomBranchArtifactRaw, GameRomBranchData, GameRomData, ICompressionProvider, LocationWrapper, Long, MapExt, MemberType, MemoryMapMode, ObjectType, Op, OpCode, OperationContext, PlatformBranchData, PlatformData, PostProcessor, ProcessorStateManager, ProjectBranchData, ProjectBranchFileRaw, ProjectConfig, ProjectData, ProjectFileData, ProjectFileRaw, ProjectPayload, QueryStats, QuintetLZ, ReferenceManager, RegionData, RegisterType, Registers, RomDataReader, RomGenerator, RomLayout, RomProcessingConstants, RomProcessor, RomState, RomStateUtils, RomWriter, SortedMap, SpriteFrame, SpriteGroup, SpriteMap, SpritePart, Stack, StackOperations, StatusFlags, StringEntry, StringMarker, StringProcessor, StringReader, StringSizeComparer, StringWrapper, StructDef, SupabaseErrorCode, SupabaseFromError, SupabaseResult, TableEntry, TransformProcessor, TypeParser, TypedNumber, Word, XformDef, XformType, base64ToUint8Array, binaryToUtf8String, bytesToHex, clamp, combineHeader, crc32_buffer, crc32_text_utf16, crc32_text_utf8, createDbPath, createSupabaseClient, createTempDirectory, decodeBase64, decodeBase64String, decodeDataString, encodeBase64, encodeBase64String, fileExists, fromSupabaseByGameRom, fromSupabaseById, fromSupabaseByName, fromSupabaseByProject, getDirectory, getEnvVar, getNestedProperty, getSupabaseClient, hexToBytes, hexToUint8Array, indexOfAny, isPlatformNode, isValidBase64, listDirectory, readFileAsBinary, readFileAsText, readJsonFile, removeDirectory, resetSupabaseClient, saveFileAsBinary, saveFileAsText, snes, summaryFromSupabaseByProject, uint8ArrayToBase64, validateEnvironmentVariables };
 //# sourceMappingURL=index.d.cts.map