8bitworkshop/src/common/workertypes.ts

114 lines
2.6 KiB
TypeScript

export type FileData = string | Uint8Array;
export interface SourceLocation {
line: number;
label?: string;
path?: string; // TODO: make mandatory?
start?: number;
end?: number;
}
// actually it's a kind of SourceSnippet .. can have multiple per line
export interface SourceLine extends SourceLocation {
offset:number;
insns?:string;
iscode?:boolean;
cycles?:number;
}
export class SourceFile {
lines: SourceLine[];
text: string;
offset2loc: Map<number,SourceLine>; //{[offset:number]:number};
line2offset: Map<number,number>; //{[line:number]:number};
constructor(lines:SourceLine[], text:string) {
lines = lines || [];
this.lines = lines;
this.text = text;
this.offset2loc = new Map();
this.line2offset = new Map();
for (var info of lines) {
if (info.offset >= 0) {
this.offset2loc[info.offset] = info;
this.line2offset[info.line] = info.offset;
}
}
}
// TODO: smarter about looking for source lines between two addresses
findLineForOffset(PC:number, lookbehind:number) {
if (this.offset2loc) {
for (var i=0; i<=lookbehind; i++) {
var loc = this.offset2loc[PC];
if (loc) {
return loc;
}
PC--;
}
}
return null;
}
lineCount():number { return this.lines.length; }
}
export interface Dependency {
path:string,
filename:string,
link:boolean,
data:FileData // TODO: or binary?
}
export interface WorkerFileUpdate {
path:string,
data:FileData
};
export interface WorkerBuildStep {
path?:string
platform:string
tool:string
mainfile?:boolean
};
export interface WorkerMessage extends WorkerBuildStep {
preload:string,
reset:boolean,
code:string,
updates:WorkerFileUpdate[],
buildsteps:WorkerBuildStep[]
}
export interface WorkerError extends SourceLocation {
msg:string,
}
export interface CodeListing {
lines:SourceLine[],
asmlines?:SourceLine[],
text?:string,
sourcefile?:SourceFile, // not returned by worker
assemblyfile?:SourceFile // not returned by worker
}
export type CodeListingMap = {[path:string]:CodeListing};
// TODO
export type VerilogOutput =
{program_rom_variable:string, program_rom:Uint8Array, code:string, name:string, ports:any[], signals:any[]};
export type WorkerOutput = Uint8Array | VerilogOutput;
export type Segment = {name:string, start:number, size:number, last?:number, type?:string};
export interface WorkerResult {
errors:WorkerError[]
output?:WorkerOutput
listings?:CodeListingMap
symbolmap?:{[sym:string]:number}
params?:{}
segments?:Segment[]
unchanged?:boolean
debuginfo?:{} // optional info
}